[DOCS] Building Documentation
-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- ---(end of broadcast)--- TIP 4: Have you searched our list archives? http://archives.postgresql.org
Re: [DOCS] Building Documentation
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/ ---(end of broadcast)--- TIP 5: don't forget to increase your free space map settings
Re: [DOCS] Building Documentation
-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- ---(end of broadcast)--- TIP 4: Have you searched our list archives? http://archives.postgresql.org
[DOCS] Added links to the release notes
I have added links from the 8.2 release notes into our documentation. If people have additions/changes, please let me know. -- Bruce Momjian [EMAIL PROTECTED] EnterpriseDBhttp://www.enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ---(end of broadcast)--- TIP 3: Have you checked our extensive FAQ? http://www.postgresql.org/docs/faq
