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 139417 - Documentation build fails when gtkdoc-mkdb exits with status 0
Documentation build fails when gtkdoc-mkdb exits with status 0
Status: RESOLVED FIXED
Product: GStreamer
Classification: Platform
Component: documentation
git master
Other Linux
: Normal trivial
: NONE
Assigned To: GStreamer Maintainers
GStreamer Maintainers
Depends on:
Blocks:
 
 
Reported: 2004-04-07 21:02 UTC by Adam Hooper
Modified: 2004-12-22 21:47 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
gtkdoc-mkdb warnings (2.71 KB, text/plain)
2004-05-03 02:11 UTC, Adam Hooper
Details

Description Adam Hooper 2004-04-07 21:02:26 UTC
When building gstreamer, gtkdoc-mkdb is called in doc/gst/. For me it emits
numerous WARNINGs and even ERRORs regarding malformed comment blocks. However,
that doesn't change the fact that the documentation still *would* build and
would look fine, *if* there weren't a silent failure.

Line 209 of doc/gst/Makefile.am: @if grep "WARNING:" sgml-build.log > /dev/null;
then exit 1; fi

Obviously the docs should be perfect, but imperfection shouldn't make the build
fail -- especially when gtkdoc-mkdb returns an exit code of 0. Not to mention,
it's hypocritical that it would fail on WARNINGs but succeed on ERRORs. I
suggest removing the line entirely, so that gstreamer will actually build for me :).
Comment 1 Stephane Loeuillet 2004-05-02 16:44:15 UTC
is it still the case ?

could you put doc build output in a file and upload it so that those warnings
could be fixed ?
Comment 2 Adam Hooper 2004-05-03 02:10:53 UTC
It builds fine now.

However, I'll upload the WARNING lines I receive while building.
Comment 3 Adam Hooper 2004-05-03 02:11:40 UTC
Created attachment 27318 [details]
gtkdoc-mkdb warnings
Comment 4 Stephane Loeuillet 2004-11-24 19:44:02 UTC
closing this one. most of those WARNINGS are now ignored (on purpose)
if there are ERRORS left, please reopen