[Bug 682077] New: Build manual with xsltproc instead of docbook2html
GStreamer (bugzilla.gnome.org)
bugzilla at gnome.org
Fri Aug 17 02:31:36 PDT 2012
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.
More information about the gstreamer-bugs
mailing list