The documentation in the 1.x line needs updating. However, the build process is
not trivial, and took me a while to get running (I'm a new doc committer with
no prior docbook experience).
I am now able to build the documentation on Windows, but the output is less
than ideal in PDF. This needs fixing, probably through tweaking of the
stylesheets.
I will also try to produce the PDF output from a linux setup, which seems to
have better support for docbook.
One thing to consider is also to move the documentation source to docbook 5
(currently version 4.1.2 of the docbook format is specified in the doc source).
The impact of moving to docbook 5 needs to be evaluated, and might solve the
PDF format problem described above.
I'm initially putting this High priority and Bug, but I am not familiar with
the project's "standards" on issues. Please correct if I'm wrong.
Resolving this issue will obviously be useful for the 3.x line documentation
build process.
Original issue reported on code.google.com by rcham...@gmail.com on 25 Oct 2010 at 1:39
Original issue reported on code.google.com by
rcham...@gmail.com
on 25 Oct 2010 at 1:39