Re: Building PDFs error: \pdfendlink ended up in different nesting level than \pd

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Josh Kupershmidt <schmiddy(at)gmail(dot)com>
Cc: pgsql-docs <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Building PDFs error: \pdfendlink ended up in different nesting level than \pd
Date: 2011-01-28 17:11:51
Message-ID: 21027.1296234711@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

I wrote:
Josh Kupershmidt <schmiddy(at)gmail(dot)com> writes:
>> I looked around line 1390679 of postgres-US.tex-pdf, where I saw this
>> snippet from seg.sgml:
>> (spaces around the range operator are ignored)

The nearest preceding candidate for a split link seems to be the
reference to table F-25 in the opening paragraph of section F.36.2
(attached PNG shows what it looks like when I build HEAD in US page
size). Since that sentence is rather badly in need of copy-editing
anyway, I'll go see if I can fix it. However, it's rather disturbing
that in my build the problem seems to be more than half a dozen lines
away from a page boundary. I could believe a line or two discrepancy
between different toolchains, but this seems like a lot.

> Something we might consider doing to try to make this more stable is to
> see if we can force more page breaks in the PDF output. That would
> isolate each chapter or section from changes in others.

In my build, the entire contrib manual is potentially interdependent,
because the sub-sections of Appendix F don't start new pages. This
seems bad. What is even more curious is that it looks like the function
"man pages" within the dblink section *do* get forced page breaks.
That is inconsistent to say the least. How much control do we have over
this type of formatting decision?

regards, tom lane

Attachment Content-Type Size
image/png 17.1 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2011-01-28 20:43:59 Re: Problem with documentation of upgrades
Previous Message Tom Lane 2011-01-28 15:11:16 Re: Building PDFs error: \pdfendlink ended up in different nesting level than \pd