GNOME Bugzilla – Bug 139417
Documentation build fails when gtkdoc-mkdb exits with status 0
Last modified: 2004-12-22 21:47:04 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 :).
is it still the case ? could you put doc build output in a file and upload it so that those warnings could be fixed ?
It builds fine now. However, I'll upload the WARNING lines I receive while building.
Created attachment 27318 [details] gtkdoc-mkdb warnings
closing this one. most of those WARNINGS are now ignored (on purpose) if there are ERRORS left, please reopen