#643 gtkdoc does not build documentation - missing stylesheets?

[Alon Bar-Lev]

Problem in gp-documentation.m4, incorrect if.
Thanks!

[Alon Bar-Lev]

Logged In: YES
user_id=1157530
Originator: YES

--- gp-documentation.m4.org 2007-01-25 00:22:42.000000000 +0200
+++ gp-documentation.m4 2007-01-25 00:24:26.000000000 +0200
@@ -76,7 +76,7 @@ AC_ARG_ENABLE([docs],
try_gtkdoc=true
fi
])
-if $try_gtkdoc; then
+if x$try_gtkdoc = xtrue; then
AC_PATH_PROG([GTKDOC],[gtkdoc-mkdb])
if test -n "${GTKDOC}"; then
have_gtkdoc=true

[Alon Bar-Lev]

Logged In: YES
user_id=1157530
Originator: YES

--- gp-documentation.m4.org 2007-01-25 00:22:42.000000000 +0200
+++ gp-documentation.m4 2007-01-25 00:24:26.000000000 +0200
@@ -76,7 +76,7 @@ AC_ARG_ENABLE([docs],
try_gtkdoc=true
fi
])
-if $try_gtkdoc; then
+if test x$try_gtkdoc = xtrue; then
AC_PATH_PROG([GTKDOC],[gtkdoc-mkdb])
if test -n "${GTKDOC}"; then
have_gtkdoc=true

[Marcus Meissner]

Logged In: YES
user_id=48092
Originator: NO

well,
it should just run the false or true in $try_gtkdoc, no need
for an extra test here.

do you really see it getting enabled? because I do not see it.

[Alon Bar-Lev]

Logged In: YES
user_id=1157530
Originator: YES

Yes I am sure...

Maybe my fix is not the problem... You have a very complex autoconf configuration...
Maybe the problem is with:
AM_CONDITIONAL([ENABLE_GTK_DOC], [$have_gtkdoc])

Attached is my config.log.

Thanks!
File Added: config.log

[Alon Bar-Lev]

config.log

[Alon Bar-Lev]

Logged In: YES
user_id=1157530
Originator: YES

Just to make sure...
The --disable-docs should affect the creation of /usr/local/share/doc/libgphoto2/apidocs.html directory and contents, right?

[Marcus Meissner]

Logged In: YES
user_id=48092
Originator: NO

apidocs.html is generated by doxygen...

but yes, it seems to generate them as soon as "doxygen" and "dot" are present,
while it should also honor the docs option perhaps

[Alon Bar-Lev]

Logged In: YES
user_id=1157530
Originator: YES

Also gtk-docs fails...
Making all in doc
make[4]: Entering directory
`/var/tmp/portage/media-libs/libgphoto2-2.3.1-r1/work/libgphoto2-2.3.1/libgphoto2_port/doc'
cd . && gtkdoc-scan --module=gphoto2-port --source-dir=../libgphoto2_port
cd . && gtkdoc-mkdb --module=gphoto2-port --source-dir=../libgphoto2_port
if ! test -d html ; then mkdir html ; fi
cd html && gtkdoc-mkhtml gphoto2-port .././gphoto2-port-api.sgml
File doesn't exist: ./tmpl/gphoto2-port.sgml
WARNING: No declaration found for: GPPortPrivateLibrary
WARNING: No declaration found for: GPPortPrivateCore
...
WARNING: No declaration found for: CSIZE
WARNING: No declaration found for: CSTOPB
/usr/bin/openjade:.././sgml/gphoto2-port-log.sgml:43:10:E: end tag for
"REFSECT1" which is not finished
/usr/bin/openjade:.././sgml/gphoto2-port-result.sgml:43:10:E: end tag for
"REFSECT1" which is not finished
/usr/bin/openjade:.././sgml/gphoto2-port-info-list.sgml:43:10:E: end tag for
"REFSECT1" which is not finished
/usr/bin/openjade:.././sgml/gphoto2-port.sgml:43:10:E: end tag for "REFSECT1"
which is not finished
/usr/bin/openjade:.././sgml/gphoto2-port-library.sgml:43:10:E: end tag for
"REFSECT1" which is not finished
make[4]: *** [html] Error 1
make[4]: Leaving directory
`/var/tmp/portage/media-libs/libgphoto2-2.3.1-r1/work/libgphoto2-2.3.1/libgphoto2_port/doc'
make[3]: *** [all-recursive] Error 1
make[3]: Leaving directory
`/var/tmp/portage/media-libs/libgphoto2-2.3.1-r1/work/libgphoto2-2.3.1/libgphoto2_port'
make[2]: *** [all] Error 2
make[2]: Leaving directory
`/var/tmp/portage/media-libs/libgphoto2-2.3.1-r1/work/libgphoto2-2.3.1/libgphoto2_port'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory
`/var/tmp/portage/media-libs/libgphoto2-2.3.1-r1/work/libgphoto2-2.3.1'
make: *** [all] Error 2

---

So I had to put GTKDOC=/bin/true at configure.

BTW: Is there any reason to use gtk-doc when you have doxygen?

[Alon Bar-Lev]

Logged In: YES
user_id=1157530
Originator: YES

Well... the GTKDOC magic did not work... So I use --disable-docs and sice doxygen works anyway, I leave its output of doc is requested.
Still don't understand the difference between the gtk-doc and doxygen...

[Marcus Meissner]

Logged In: YES
user_id=48092
Originator: NO

gtkdoc fails for me too and I was not able to get it to work. (same error)

[Hans Ulrich Niedermann]

Logged In: YES
user_id=59853
Originator: NO

gtk-doc is deprecated in the gphoto code.

Someone has to go through the gtk-doc content files though and extract meaningful documentation for conversion into doxygen format.