[Bug 682077] New: Build manual with xsltproc instead of docbook2html

[GStreamer (bugzilla.gnome.org)]

https://bugzilla.gnome.org/show_bug.cgi?id=682077
  GStreamer | documentation | git

           Summary: Build manual with xsltproc instead of docbook2html
    Classification: Platform
           Product: GStreamer
           Version: git
        OS/Version: All
            Status: UNCONFIRMED
          Severity: enhancement
          Priority: Normal
         Component: documentation
        AssignedTo: gstreamer-bugs at lists.freedesktop.org
        ReportedBy: lrn1986 at gmail.com
         QAContact: gstreamer-bugs at lists.freedesktop.org
     GNOME version: ---


docbook2html is difficult to build (for me), but makefile suggested that
xsltproc can be used instead.

Making it happen involves the following:

1) fix gst-doc.m4 to not to require docbook2html to build html manual

2) fix gst-doc.m4 to not to list fig2dev as a mandatory requirement (detection
code says that without it some images won't be built, but building the manual
should still be possible; also see (5))

3) fix as-docbook.m4 to understand XML_CATALOG_FILES environment variable.
as-docbook.m4 looks for hard-coded /etc/xml/catalog, and if it isn't there,
looks for some hardcoded docbook files. Instead if should honor
XML_CATALOG_FILES, just as libxml2 does. XML_CATALOG_FILES is a space-delimited
list of files.

4) fix manual.mak - remove the comment that suggests xsltproc usage, replace
docbook2html with xsltproc. Remove sed invocation.

5) remove .fig files from the manual. There is only one such file -
state-diagram.fig, and it's not used anyway. Without fig2dev it can't be
converted to png, and makefile if written in a way that makes fig2dev
non-optional. I don't know how to make fig2dev invocation optional in a clean
way, so i think that .fig file should be moved instead

-- 
Configure bugmail: https://bugzilla.gnome.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
You are the assignee for the bug.