Problem building the documentation

Started by Bruce Momjianabout 16 years ago8 messagesdocs
Jump to latest
#1Bruce Momjian
bruce@momjian.us

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.
<to be read again>
\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 <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#2Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#1)
Re: Problem building the documentation

Bruce Momjian <bruce@momjian.us> 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

#3Bruce Momjian
bruce@momjian.us
In reply to: Tom Lane (#2)
Re: Problem building the documentation

Tom Lane wrote:

Bruce Momjian <bruce@momjian.us> 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 <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#4Tom Lane
tgl@sss.pgh.pa.us
In reply to: Bruce Momjian (#3)
Re: Problem building the documentation

Bruce Momjian <bruce@momjian.us> 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

#5Peter Eisentraut
peter_e@gmx.net
In reply to: Bruce Momjian (#1)
Re: 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.

#6Bruce Momjian
bruce@momjian.us
In reply to: Peter Eisentraut (#5)
Re: 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 <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +

#7Devrim GÜNDÜZ
devrim@gunduz.org
In reply to: Bruce Momjian (#6)
Re: 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

#8Bruce Momjian
bruce@momjian.us
In reply to: Devrim GÜNDÜZ (#7)
Re: 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 <bruce@momjian.us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ If your life is a hard drive, Christ can be your backup. +