Bug 661924 – --enable-gtk-doc produces incomplete docs

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 661924 - --enable-gtk-doc produces incomplete docs


Summary:	--enable-gtk-doc produces incomplete docs


Status:	RESOLVED OBSOLETE

Product:	gnome-desktop
Classification:	Core
Component:	docs
Version:	3.2.x
Hardware:	Other Linux

Importance:	Normal normal
Target Milestone:	---
Assigned To:	Desktop Maintainers
QA Contact:	Desktop Maintainers

URL:
Whiteboard:

Depends on:
Blocks:

Reported:	2011-10-16 18:29 UTC by Michael Biebl
Modified:	2018-09-21 16:31 UTC

See Also:
GNOME target:	---
GNOME version:	---

Attachments
build log (163.24 KB, text/x-log) 2011-10-16 18:30 UTC, Michael Biebl	Details
gtk-doc files from "make install" (17.44 KB, application/x-gzip) 2011-10-16 18:30 UTC, Michael Biebl	Details

Description Michael Biebl 2011-10-16 18:29:09 UTC

I tried building the gtk-doc API documentation with gtk-doc-tools 1.18

During the build I get a lot of error messages about missing references and files, like
warning: failed to load external entity "../xml/gnome-rr-screen.xml"
../gnome-desktop3-docs.sgml:25: element include: XInclude error : could not load ../xml/gnome-rr-screen.xml, and no fallback was found
warning: failed to load external entity "../xml/gnome-rr-output.xml"
../gnome-desktop3-docs.sgml:26: element include: XInclude error : could not load ../xml/gnome-rr-output.xml, and no fallback was found

A complete log is attached.

While checking the resulting output, quite a few files were missing in /usr/share/gtk-doc, like gnome-desktop3-gnome-rr-crtc.html
I tar'ed up the /usr/share/gtk-doc directory.

Comment 1 Michael Biebl 2011-10-16 18:30:21 UTC

Created attachment 199135 [details]
build log

Comment 2 Michael Biebl 2011-10-16 18:30:51 UTC

Created attachment 199136 [details]
gtk-doc files from "make install"

Comment 3 Vincent Untz 2011-10-17 06:12:05 UTC

Generally speaking, gnome-desktop has nearly no api doc, which is a shame :/

Comment 4 GNOME Infrastructure Team 2018-09-21 16:31:27 UTC

-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/gnome-desktop/issues/37.