[Gstreamer-bugs] [Bug 139417] New: - Documentation build fails when gtkdoc-mkdb exits with status 0

[bugzilla-daemon at widget.gnome.org]

http://bugzilla.gnome.org/show_bug.cgi?id=139417

           Summary: Documentation build fails when gtkdoc-mkdb exits with
                    status 0
           Product: GStreamer
           Version: HEAD CVS
          Platform: Other
        OS/Version: Linux
            Status: UNCONFIRMED
          Severity: trivial
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-maint at bugzilla.gnome.org
        ReportedBy: adamh at densi.com
         QAContact: gstreamer-maint at bugzilla.gnome.org


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 :).


------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.
You are the QA contact for the bug, or are watching the QA contact.