[DOCS] Building PDF documentation
I have determined that the HTML documentation must be built before any of the PDF makefile targets are valid, so I have applied the attached documentation patch to mention this. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + Index: doc/src/sgml/docguide.sgml === RCS file: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v retrieving revision 1.78 diff -c -c -r1.78 docguide.sgml *** doc/src/sgml/docguide.sgml 9 Aug 2009 22:47:59 - 1.78 --- doc/src/sgml/docguide.sgml 22 Jan 2010 15:48:19 - *** *** 590,596 If you want to use JadeTex to produce a ! printable rendition of the documentation, you can use one of the following commands: --- 590,597 If you want to use JadeTex to produce a ! printable rendition of the documentation, you must first build the ! HTML output as outlined above, then you can use one of the following commands: -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
[DOCS] Problem building the documentation
In building the US PDF documentation I am getting this error from LaTeX:
LaTeX Warning: Reference `RELEASE-8-2-7' on page xxxii undefined on
input line
37586.
LaTeX Warning: Reference `101577' on page xxxii undefined on input line
37612.
[32.0.18
pdfTeX error (ext4): link annotations can't be nested.
\endgroup
l.37619 {start}}
\Link%
! ==> Fatal error occurred, the output PDF file not finished!
Transcript written on postgres-US.log.
gmake: *** [postgres-US.pdf] Error 1
gmake: *** Deleting file `postgres-US.pdf'
rm postgres-US.tex-pdf
The problem is related to the release-8.2.sgml file, but if I make that
file zero-length, it fails on release-8.1.sgml. I see this failure
building the current PDF docs and in the 8.4 PDF docs.
I did a web search for the error message and it seems to relate to links
crossing page boundaries or something. I don't see any unusual
constructs on the SGML files.
I used to be able to build the PDF documentation. I am curious what
changes others have made to allow PDF documentation builds.
--
Bruce Momjian http://momjian.us
EnterpriseDB http://enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +
--
Sent via pgsql-docs mailing list ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
Bruce Momjian writes: > I have determined that the HTML documentation must be built before any > of the PDF makefile targets are valid, so I have applied the attached > documentation patch to mention this. Really? It seems to work for me without that. What do you observe to go wrong? regards, tom lane -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Problem building the documentation
Bruce Momjian writes: > I used to be able to build the PDF documentation. I am curious what > changes others have made to allow PDF documentation builds. All the 8.4.x releases have built as PDF for me, using the current docbook/tex tool chain on Fedora 11; and in fact I don't remember ever seeing a failure like the one you quote. I wonder if you are using out-of-date doc tools. regards, tom lane -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
Tom Lane wrote: > Bruce Momjian writes: > > I have determined that the HTML documentation must be built before any > > of the PDF makefile targets are valid, so I have applied the attached > > documentation patch to mention this. > > Really? It seems to work for me without that. What do you observe > to go wrong? Sure, here it is: $ gmake clean rm -f INSTALL HISTORY regress_README rm -f INSTALL.html HISTORY.html regress_README.html rm -f *.rtf *.tex-ps *.tex-pdf *.dvi *.aux *.log *.ps *.pdf *.out *.fot rm -f HTML.index bookindex.sgml version.sgml features-supported.sgml features-unsupported.sgml rm -f postgres.xml htmlhelp.hhp toc.hhc index.hhk *.fo rm -f *.texixml *.texi *.info db2texi.refs $ gmake postgres.pdf Makefile:172: *** Invalid target; use postgres-A4.pdf or postgres-US.pdf as targets. Stop. $ gmake postgres-A4.pdf gmake: *** No rule to make target `postgres-A4.pdf'. Stop. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Problem building the documentation
Tom Lane wrote: > Bruce Momjian writes: > > I used to be able to build the PDF documentation. I am curious what > > changes others have made to allow PDF documentation builds. > > All the 8.4.x releases have built as PDF for me, using the current > docbook/tex tool chain on Fedora 11; and in fact I don't remember > ever seeing a failure like the one you quote. I wonder if you are > using out-of-date doc tools. My version is: openjade:I: "openjade" version "1.3.2" openjade:I: "OpenSP" version "1.5" Is there some other version I should check. I used to be able to build the PDF docs, so has anything changed that would have broken my tools? -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
Bruce Momjian writes: > Tom Lane wrote: >> Really? It seems to work for me without that. What do you observe >> to go wrong? > $ gmake postgres-A4.pdf > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. Works for me ... sure you've got a clean copy of the makefile? regards, tom lane -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Problem building the documentation
Bruce Momjian writes: > My version is: > openjade:I: "openjade" version "1.3.2" > openjade:I: "OpenSP" version "1.5" > Is there some other version I should check. I used to be able to build > the PDF docs, so has anything changed that would have broken my tools? Dunno, here are some relevant package versions from my F11 box: texlive-2007-46.fc11.x86_64 texlive-dvips-2007-46.fc11.x86_64 texlive-latex-2007-46.fc11.x86_64 texlive-texmf-2007-34.fc11.noarch texlive-texmf-dvips-2007-34.fc11.noarch texlive-texmf-errata-2007-6.fc11.noarch texlive-texmf-errata-dvips-2007-6.fc11.noarch texlive-texmf-errata-fonts-2007-6.fc11.noarch texlive-texmf-errata-latex-2007-6.fc11.noarch texlive-texmf-fonts-2007-34.fc11.noarch texlive-texmf-latex-2007-34.fc11.noarch texlive-utils-2007-46.fc11.x86_64 jadetex-3.13-5.fc11.noarch openjade-1.3.2-34.fc11.x86_64 opensp-1.5.2-11.fc11.x86_64 docbook-dtds-1.0-47.fc11.noarch docbook-simple-1.1-5.fc11.noarch docbook-slides-3.4.0-6.fc11.noarch docbook-style-dsssl-1.79-6.fc11.noarch docbook-style-xsl-1.75.2-1.fc11.noarch docbook-utils-0.6.14-17.fc11.noarch docbook-utils-pdf-0.6.14-17.fc11.noarch docbook2X-0.8.8-4.fc11.x86_64 regards, tom lane -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
Tom Lane wrote: > Bruce Momjian writes: > > Tom Lane wrote: > >> Really? It seems to work for me without that. What do you observe > >> to go wrong? > > > $ gmake postgres-A4.pdf > > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. > > Works for me ... sure you've got a clean copy of the makefile? Wow, that is odd then. I pulled down a new copy of CVS, ran configure, and got the same result: $ gmake postgres.pdf Makefile:172: *** Invalid target; use postgres-A4.pdf or postgres-US.pdf as targets. Stop. $ gmake postgres-A4.pdf gmake: *** No rule to make target `postgres-A4.pdf'. Stop. My gmake is version 3.78.1. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
Bruce Momjian writes: > Wow, that is odd then. I pulled down a new copy of CVS, ran configure, > and got the same result: > $ gmake postgres.pdf > Makefile:172: *** Invalid target; use postgres-A4.pdf or > postgres-US.pdf as targets. Stop. > $ gmake postgres-A4.pdf > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. > My gmake is version 3.78.1. Hmm. Might be time to get something a shade less creaky. It works for me with gmake 3.79.1, released in 2000. regards, tom lane -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Problem building the documentation
On fre, 2010-01-22 at 11:16 -0500, Bruce Momjian wrote: > [32.0.18 > pdfTeX error (ext4): link annotations can't be nested. A random web search suggests that a newer TeX might be a good try. -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
On fre, 2010-01-22 at 12:12 -0500, Tom Lane wrote: > Bruce Momjian writes: > > Wow, that is odd then. I pulled down a new copy of CVS, ran configure, > > and got the same result: > > > $ gmake postgres.pdf > > Makefile:172: *** Invalid target; use postgres-A4.pdf or > > postgres-US.pdf as targets. Stop. > > $ gmake postgres-A4.pdf > > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. > > > My gmake is version 3.78.1. > > Hmm. Might be time to get something a shade less creaky. It works for > me with gmake 3.79.1, released in 2000. Bruce and I had a chat about this and agreed to raise the "recommended" make version to 3.79.1, rather than hunting down this issue. -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Building PDF documentation
Peter Eisentraut wrote: > On fre, 2010-01-22 at 12:12 -0500, Tom Lane wrote: > > Bruce Momjian writes: > > > Wow, that is odd then. I pulled down a new copy of CVS, ran configure, > > > and got the same result: > > > > > $ gmake postgres.pdf > > > Makefile:172: *** Invalid target; use postgres-A4.pdf or > > > postgres-US.pdf as targets. Stop. > > > $ gmake postgres-A4.pdf > > > gmake: *** No rule to make target `postgres-A4.pdf'. Stop. > > > > > My gmake is version 3.78.1. > > > > Hmm. Might be time to get something a shade less creaky. It works for > > me with gmake 3.79.1, released in 2000. > > Bruce and I had a chat about this and agreed to raise the "recommended" > make version to 3.79.1, rather than hunting down this issue. Agreed. I have reverted the doc mention about HTML being required first, and bumped up the required gmake version to 3.79.1; patch attached. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + Index: doc/src/sgml/docguide.sgml === RCS file: /cvsroot/pgsql/doc/src/sgml/docguide.sgml,v retrieving revision 1.79 diff -c -c -r1.79 docguide.sgml *** doc/src/sgml/docguide.sgml 22 Jan 2010 15:49:29 - 1.79 --- doc/src/sgml/docguide.sgml 22 Jan 2010 22:48:55 - *** *** 590,597 If you want to use JadeTex to produce a ! printable rendition of the documentation, you must first build the ! HTML output as outlined above, then you can use one of the following commands: --- 590,596 If you want to use JadeTex to produce a ! printable rendition of the documentation, you can use one of the following commands: Index: doc/src/sgml/installation.sgml === RCS file: /cvsroot/pgsql/doc/src/sgml/installation.sgml,v retrieving revision 1.338 diff -c -c -r1.338 installation.sgml *** doc/src/sgml/installation.sgml 16 Jan 2010 20:38:54 - 1.338 --- doc/src/sgml/installation.sgml 22 Jan 2010 22:48:58 - *** *** 79,85 gmake --version ! It is recommended to use version 3.76.1 or later. --- 79,85 gmake --version ! It is recommended to use version 3.79.1 or later. -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Problem building the documentation
Peter Eisentraut wrote: > On fre, 2010-01-22 at 11:16 -0500, Bruce Momjian wrote: > > [32.0.18 > > pdfTeX error (ext4): link annotations can't be nested. > > A random web search suggests that a newer TeX might be a good try. OK, thanks. I didn't know there were newer TeX versions. Is their a PDF build of our development docs available somewhere? That is what started all this. :-| -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] Problem building the documentation
On Fri, 2010-01-22 at 17:51 -0500, Bruce Momjian wrote: > > OK, thanks. I didn't know there were newer TeX versions. Is their a > PDF build of our development docs available somewhere? I'm building PDF docs regularly for each alpha release. http://www.postgresql.org/developer/alpha Hope this helps. -- Devrim GÜNDÜZ, RHCE Command Prompt - http://www.CommandPrompt.com devrim~gunduz.org, devrim~PostgreSQL.org, devrim.gunduz~linux.org.tr http://www.gunduz.org Twitter: http://twitter.com/devrimgunduz signature.asc Description: This is a digitally signed message part
Re: [DOCS] Problem building the documentation
Devrim G?ND?Z wrote: -- Start of PGP signed section. > On Fri, 2010-01-22 at 17:51 -0500, Bruce Momjian wrote: > > > > OK, thanks. I didn't know there were newer TeX versions. Is their a > > PDF build of our development docs available somewhere? > > I'm building PDF docs regularly for each alpha release. > > http://www.postgresql.org/developer/alpha Ah, thanks. I didn't realize we had separate links for the PDFs. -- Bruce Momjian http://momjian.us EnterpriseDB http://enterprisedb.com + If your life is a hard drive, Christ can be your backup. + -- Sent via pgsql-docs mailing list ([email protected]) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
