GNOME Bugzilla – Bug 138836
docs build but won't install
Last modified: 2004-12-22 21:47:04 UTC
./autogen.sh ./configure ... make make install docs are built but they are not installed (gentoo) same for 'alley_cat' from #gstreamer chan (sourcemage) we both have gtk-doc 1.2 (and this one is stricter than 1.1 so it might be the root of the problem) attaching configure/make output once it is finished
Created attachment 26246 [details] configure ; make ; make install output related to docs as you'll see, gstreamer C doc is rebuilt a second time at "make install" time but nothing got installed
Created attachment 26248 [details] full compressed output
configure says it won't build docs because i don't have fig2dev but gst-doc.m4 want them absolutely : test "x$HAVE_FIG2DEV_PNG" = "xtrue"; then (line 88) test "x$HAVE_FIG2DEV_EPS" = "xtrue" && \ (line 100) that should explain the following lines : configure: Will not output HTML documentation configure: Will not output PS documentation configure: Will not output PDF documentation but not why they don't install
Created attachment 26262 [details] [review] patch to fix documentation installation The problem is that the gtkdoc output for doc/gst and doc/libs is only installed when DOC_HTML is true. This is wrong, as the build of those only requires gtkdoc, and for tarballs even that isn't needed as the html files are included. The .devhelp files should also be included in dist, so gtkdoc isn't needed at all and you still get the documentation installed correctly when building from a tarball. This patch adds .devhelp files to dist for doc/gst and doc/libs and makes them installable without gtkdoc or docbook2html installed.
thanks for this patch, it installs gst-doc generated API docs and they are available to devhelp. got another problem when docs/faq/ tries to build and fails : Making all in docs make[2]: Entering directory `/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs' Making all in faq make[3]: Entering directory `/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq' make[4]: Entering directory `/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq' make[4]: AVERTISSEMENT: serveur de tâches n'est pas disponible: utilisation de -j1. Ajouter « + » à la règle parent du make. make[4]: Entering directory `/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq' make[4]: AVERTISSEMENT: serveur de tâches n'est pas disponible: utilisation de -j1. Ajouter « + » à la règle parent du make. cd build && xmllint -noout -valid faq.xml cd build && xmllint -noout -valid faq.xml make[4]: Leaving directory `/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq' *** Generating PS output *** cd build && docbook2ps -o .. faq.xml make[4]: Leaving directory `/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq' *** Generating HTML output *** Using catalogs: /usr/share/sgml/docbook/sgml-dtd-4.1/catalog, /usr/share/sgml/docbook/sgml-dtd-4.0/catalog, /usr/share/sgml/docbook/sgml-dtd-3.0/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.78/catalog, /usr/share/sgml/docbook/sgml-dtd-3.1/catalog, /usr/share/sgml/docbook/sgml-dtd-4.2/catalog, /usr/share/sgml/sgml-iso-entities-8879.1986/catalog, /usr/share/sgml/xml-iso-entities-8879.1986/catalog, /usr/share/sgml/opensp-1.5/OpenSP/catalog, /usr/share/sgml/openjade-1.3.2/catalog, /usr/share/sgml/openjade-1.3.2/dsssl/catalog Using stylesheet: /usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#print Working on: /usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq/build/faq.xml Using catalogs: /usr/share/sgml/docbook/sgml-dtd-4.1/catalog, /usr/share/sgml/docbook/sgml-dtd-4.0/catalog, /usr/share/sgml/docbook/sgml-dtd-3.0/catalog, /usr/share/sgml/docbook/dsssl-stylesheets-1.78/catalog, /usr/share/sgml/docbook/sgml-dtd-3.1/catalog, /usr/share/sgml/docbook/sgml-dtd-4.2/catalog, /usr/share/sgml/sgml-iso-entities-8879.1986/catalog, /usr/share/sgml/xml-iso-entities-8879.1986/catalog, /usr/share/sgml/opensp-1.5/OpenSP/catalog, /usr/share/sgml/openjade-1.3.2/catalog, /usr/share/sgml/openjade-1.3.2/dsssl/catalog Using stylesheet: /usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html Working on: /usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq/build/faq.xml jade:/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq/build/faq.xml:22:0:E: URL not supported by this version jade:/usr/portage/tmp/portage/gstreamer-0.8.9/work/gstreamer/docs/faq/build/faq.xml:22:0:E: URL not supported by this version jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblink.dsl:200:1:E: XRef LinkEnd to missing ID 'title-general' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblink.dsl:200:1:E: XRef LinkEnd to missing ID 'title-getting' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblink.dsl:200:1:E: XRef LinkEnd to missing ID 'title-cvs' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblink.dsl:200:1:E: XRef LinkEnd to missing ID 'troubleshooting-segfault' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/print/dblists.dsl:155:18:E: 1st argument for primitive "string=?" of wrong type: "#f" not a string make[3]: *** [faq.ps] Erreur 8 make[3]: *** Attente des tâches non terminées.... jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/html/dblink.dsl:203:1:E: XRef LinkEnd to missing ID 'title-general' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/html/dblink.dsl:203:1:E: XRef LinkEnd to missing ID 'title-getting' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/html/dblink.dsl:203:1:E: XRef LinkEnd to missing ID 'title-cvs' jade:/usr/share/sgml/docbook/dsssl-stylesheets-1.78/html/dblink.dsl:203:1:E: XRef LinkEnd to missing ID 'troubleshooting-segfault' make[3]: *** [html/index.html] Erreur 8 then it stops (it did the same with the default versions of docbook* which were in gentoo (dsssl 1.77, tools 1.62)
patch that fixes part 1 commited to CVS
closing this one as mixing 2 issues in a single bug is bad practice reopening a new bug with issue 2 (faq, manual & pwg build breaks on docbook2ps) soon