public inbox for [email protected]help / color / mirror / Atom feed
Building Documentation 3+ messages / 2 participants [nested] [flat]
* Building Documentation @ 2006-10-06 17:55 David Blewett <[email protected]> 0 siblings, 1 reply; 3+ messages in thread From: David Blewett @ 2006-10-06 17:55 UTC (permalink / raw) To: 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----- ^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Building Documentation @ 2006-10-06 20:41 Peter Eisentraut <[email protected]> parent: David Blewett <[email protected]> 0 siblings, 1 reply; 3+ messages in thread From: Peter Eisentraut @ 2006-10-06 20:41 UTC (permalink / raw) To: pgsql-docs; +Cc: David Blewett <[email protected]> David Blewett wrote: > xsltproc -o postgres.fo --stringparam pg.version '8.1.4' > stylesheet.xsl postgres.xml > > However, no .fo file is created. That's because the stylesheet you are using is an html stylesheet. > Meanwhile, can someone provide me with > either postgres.rtf or postgres.fot from the 8.1 series? You can build a postgres.fot from the makefile, but maybe you mean postgres.fo, which is not quite the same thing, and there is no readily available support for the latter. -- Peter Eisentraut http://developer.postgresql.org/~petere/ ^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: Building Documentation @ 2006-10-06 21:04 David Blewett <[email protected]> parent: Peter Eisentraut <[email protected]> 0 siblings, 0 replies; 3+ messages in thread From: David Blewett @ 2006-10-06 21:04 UTC (permalink / raw) To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Peter Eisentraut wrote: > > That's because the stylesheet you are using is an html stylesheet. > >> Meanwhile, can someone provide me with >> either postgres.rtf or postgres.fot from the 8.1 series? > > You can build a postgres.fot from the makefile, but maybe you mean > postgres.fo, which is not quite the same thing, and there is no readily > available support for the latter. > Heh, that goes to show how little I know about this whole process. I went ahead and restarted the build process and I'll let it run over the weekend. I also tried the route of using dblatex which will allow me to use latex utilities. So far, the sgml->tex process was quick but the pdflatex process is taking forever. It stopped spewing info to the screen, so it might have hit an infinite loop. If I am able to get something working well, I'll let you know. David -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.3 (MingW32) Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org iD8DBQFFJsTtZmlc6wNjtLYRAo3HAJ0QOokK1Llqj+vmmIQN+/5oMbZ4YwCdFNLt +w16ga7eIDg9Gljng3KuiuM= =YiqV -----END PGP SIGNATURE----- ^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2006-10-06 21:04 UTC | newest] Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2006-10-06 17:55 Building Documentation David Blewett <[email protected]> 2006-10-06 20:41 ` Peter Eisentraut <[email protected]> 2006-10-06 21:04 ` David Blewett <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox