GNOME Bugzilla – Bug 131600
include doc/reference the gtk-doc generation stuff
Last modified: 2017-12-22 12:47:23 UTC
This bugreport is a reminder: The CVS tree has a directory reference under the directory doc, doc/reference. In this the directory is the programmers documentation generated by the gtk-doc-tools. I did disable it is an easy workaround for problems due the inmature shipping of the gtk-doc generating. When does other problems are fixed or we have a more mature gtk-doc is should be included again.
Created attachment 23404 [details] [review] how the disabling was done
If you wonder why disable and not fixing, then read bug 125646, bug 125736, bug 131188 and last but not least bug 125785
FYI gtk-doc is released.
For Your Interest: gtk-doc 1.2 is released http://ftp.gnome.org/pub/GNOME/sources/gtk-doc/1.2/
Assigning this bug to me. (leave the conglomerate-auto as assignee, I'm subscribed to it)
The 'how the disabling was done'-patch was used to restore configure.in and the patch is now obsolete. For including the gtk-doc generation stuff, you have to change doc/Makefile.am and ./configure --enable-gtk-doc=yes
That wouldn't work for the tarball builders. Besides that they don't have the doc/reference directory, they also have a malformed configure.in
Created attachment 27411 [details] [review] the modification of the configure.in That patch is here just for documentation. (revert it on closing this bug)
On Fri, Jun 18, 2004 at 02:42:38AM +0400, Nickolay V. Shmyrev wrote more then: > > I have question to you, mostly related to docbook usage in conglomerate. > I've noticed that when running ./configure --help, docbook-related > options listed twice. That is because there is duplicated check for > docbook in configure.in > > All those code: > > ------------------------------------------------------- > GTK_DOC_CHECK > > AC_ARG_WITH(html-dir, [ --with-html-dir=PATH path to installed docs ]) > > if test "x$with_html_dir" = "x" ; then > HTML_DIR='${datadir}/gtk-doc/html' > else > HTML_DIR=$with_html_dir > fi > > AC_SUBST(HTML_DIR) > > gtk_doc_min_version=1.0 > AC_MSG_CHECKING([gtk-doc version >= $gtk_doc_min_version]) > if pkg-config --atleast-version=$gtk_doc_min_version gtk-doc; then > AC_MSG_RESULT(yes) > GTKDOC=true > else > AC_MSG_RESULT(no) > GTKDOC=false > fi > > dnl Let people enable the gtk-doc stuff. > AC_ARG_ENABLE(gtk-doc, [ --enable-gtk-doc Use gtk-doc to build documentation [default= > AM_CONDITIONAL(ENABLE_GTK_DOC, test x$enable_gtk_doc = xyes) > > ------------------------------------------------------- > > can be replaced with simple > > > ------------------------------------------------------- > GTK_DOC_CHECK([1.0]) > ------------------------------------------------------- > > And that would be equivalent since GTK_DOC_CHECK is the macros doing the > same > as all checks above. To prevent the double text in configure --help I have disable the GTK_DOC_CHECK marco. Right I don't have time to check if GTK_DOC_CHECK default behaviour is _disable_ gtk-doc generation at `make dist` time.
Conglomerate is not under active development anymore. It is currently unlikely that there will be any further Conglomerate development. Closing this report as WONTFIX as part of Bugzilla Housekeeping (bug 685689) to reflect reality. Please feel free to reopen this bug report in the future if anyone takes the responsibility for active development again.