From: SourceForge.net <no...@so...> - 2007-04-20 14:59:18
|
Bugs item #1643870, was opened at 2007-01-24 22:05 Message generated for change (Comment added) made by hun You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=108874&aid=1643870&group_id=8874 Please note that this message will contain a full copy of the comment thread, including the initial issue submission, for this request, not just the latest update. Category: libgphoto2 Group: None Status: Open Resolution: None Priority: 5 Private: No Submitted By: Alon Bar-Lev (alonbl) Assigned to: Hans Ulrich Niedermann (hun) Summary: gtkdoc does not build documentation - missing stylesheets? Initial Comment: Problem in gp-documentation.m4, incorrect if. Thanks! ---------------------------------------------------------------------- >Comment By: Hans Ulrich Niedermann (hun) Date: 2007-04-20 16:59 Message: 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. ---------------------------------------------------------------------- Comment By: Marcus Meissner (marcusmeissner) Date: 2007-02-03 09:10 Message: 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) ---------------------------------------------------------------------- Comment By: Alon Bar-Lev (alonbl) Date: 2007-01-30 21:00 Message: 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... ---------------------------------------------------------------------- Comment By: Alon Bar-Lev (alonbl) Date: 2007-01-30 20:24 Message: 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? ---------------------------------------------------------------------- Comment By: Marcus Meissner (marcusmeissner) Date: 2007-01-29 15:52 Message: 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 ---------------------------------------------------------------------- Comment By: Alon Bar-Lev (alonbl) Date: 2007-01-29 15:36 Message: 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? ---------------------------------------------------------------------- Comment By: Alon Bar-Lev (alonbl) Date: 2007-01-29 15:28 Message: 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 ---------------------------------------------------------------------- Comment By: Marcus Meissner (marcusmeissner) Date: 2007-01-29 14:39 Message: 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. ---------------------------------------------------------------------- Comment By: Alon Bar-Lev (alonbl) Date: 2007-01-24 23:24 Message: 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 ---------------------------------------------------------------------- Comment By: Alon Bar-Lev (alonbl) Date: 2007-01-24 23:23 Message: 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 ---------------------------------------------------------------------- You can respond by visiting: https://sourceforge.net/tracker/?func=detail&atid=108874&aid=1643870&group_id=8874 |