After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 138836 - docs build but won't install
docs build but won't install
Status: RESOLVED FIXED
Product: GStreamer
Classification: Platform
Component: gstreamer (core)
git master
Other Linux
: Normal normal
: 0.8.2
Assigned To: Thomas Vander Stichele
GStreamer Maintainers
Depends on:
Blocks:
 
 
Reported: 2004-04-02 09:54 UTC by Stephane Loeuillet
Modified: 2004-12-22 21:47 UTC
See Also:
GNOME target: 2.6.next
GNOME version: 2.5/2.6


Attachments
configure ; make ; make install output related to docs (25.49 KB, text/plain)
2004-04-02 10:13 UTC, Stephane Loeuillet
  Details
full compressed output (23.03 KB, application/x-bzip)
2004-04-02 10:20 UTC, Stephane Loeuillet
  Details
patch to fix documentation installation (2.13 KB, patch)
2004-04-02 17:04 UTC, Arwed v. Merkatz
none Details | Review

Description Stephane Loeuillet 2004-04-02 09:54:17 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
Comment 1 Stephane Loeuillet 2004-04-02 10:13:36 UTC
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
Comment 2 Stephane Loeuillet 2004-04-02 10:20:45 UTC
Created attachment 26248 [details]
full compressed output
Comment 3 Stephane Loeuillet 2004-04-02 10:43:57 UTC
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
Comment 4 Arwed v. Merkatz 2004-04-02 17:04:46 UTC
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.
Comment 5 Stephane Loeuillet 2004-04-02 23:26:26 UTC
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)
Comment 6 Stephane Loeuillet 2004-05-02 15:12:39 UTC
patch that fixes part 1 commited to CVS
Comment 7 Stephane Loeuillet 2004-05-02 15:22:35 UTC
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