Some work has been going on recently to be able to update our
documentation build tool chain. After discussion on pgsql-docs, the
people involved agree that it is time to move forward.
We are now proposing that we change the way the HTML documentation is
built from jade/openjade+docbook-dsssl to xsltproc+docbook-xsl.
If you can build the man pages now (make man, also included in make
world), then you don't need any new tools. The new HTML build will be
using the same tools. Otherwise, follow the documentation to set up
those tools and make that work.
The actual patch to make this change is attached. For the build
process, nothing changes, e.g., 'make' or 'make html' will still have
the same purposes.
For the time being, you will still be able to build the documentation
the old way with 'make oldhtml', but this is mainly so that we can
compare the output and work out any formatting kinks. Before this
patch, you can also build the documentation the new way using 'make
xslthtml', but that will go away.
I will submit a separate patch to the web site team to update the CSS
style sheets for the web site to match the new output.
There are more steps to be done after this, to move over the other
output formats (PDF), adjust the configure script, the documentation,
work out any remaining formatting problems, etc., so now is a good time
to get this rolling so that we have a good chance of reaching a steady
state before the end of the development cycle.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services