Skip site navigation (1) Skip section navigation (2)

Building Documentation

From: David Blewett <david(at)dawninglight(dot)net>
To: pgsql-docs(at)postgresql(dot)org
Subject: Building Documentation
Date: 2006-10-06 17:55:06
Message-ID: 4526987A.7020507@dawninglight.net (view raw or flat)
Thread:
Lists: pgsql-docs
-----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-----

Responses

pgsql-docs by date

Next:From: Peter EisentrautDate: 2006-10-06 20:41:05
Subject: Re: Building Documentation
Previous:From: Andrew DunstanDate: 2006-10-06 07:35:55
Subject: Re: timestamptz alias

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group