public inbox for [email protected]  

help / color / mirror / Atom feed

From: David Blewett <[email protected]>
To: [email protected]
Subject: Building Documentation
Date: Fri, 06 Oct 2006 13:55:06 -0400
Message-ID: <[email protected]> (raw)

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi All:

I've been trying to build the documentation for PostgreSQL 8.1.4 for the
past few days without much success. First of all, it seems openjade has
some severe performance issues. I ran:

sgml#gmake postgres.rtf

and let it run all night, but nothing had been written to the file. The
CPU had been pegged the entire time. On a different box, I let:

sgml#gmake postgres.dvi

run all night, and it got to 22MB.

After seeing this lackluster performance, I tried using XSLT instead of
DSSSL. I ran:

sgml#gmake postgres.xml
sgml#gmake testxml

This ran through without error in about 10 minutes. I then added:

XSLTPROCFLAGS = -o postgres.fo

to the Makefile, so that xsltproc would dump the XSL:FO file for further
processing. This generates the command line (watch the wrap):
xsltproc -o postgres.fo --stringparam pg.version '8.1.4' stylesheet.xsl
postgres.xml

However, no .fo file is created. The process runs with a lot of "ID
recommended on ...". It runs through the entire document, but no .fo
file is created.

After browsing through the -doc list, I see mentions of moving to the
XML version of DocBook. After the escapades with openjade, I heartily
agree with this decision. Meanwhile, can someone provide me with either
postgres.rtf or postgres.fot from the 8.1 series?

David Blewett

The software versions I'm using are as follows:
openjade:I: "openjade" version "1.3.2"
openjade:I: "OpenSP" version "1.5.2"
Using libxml 20626, libxslt 10117 and libexslt 813
xsltproc was compiled against libxml 20626, libxslt 10117 and libexslt 813
libxslt 10117 was compiled against libxml 20626
libexslt 813 was compiled against libxml 20626
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.3 (MingW32)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFFJph6Zmlc6wNjtLYRAuKPAJ4iYTzGne4n287TCn7a3uTmY07DbwCgiIfW
U3EH7oEDpsAu2dUTwvtySRk=
=NFwW
-----END PGP SIGNATURE-----

view thread (3+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected]
  Subject: Re: Building Documentation
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox