pagination in the PostgreSQL 7.2 Programmer's Guide

Rich Morin writes:

The TOC in the PostgreSQL 7.2 Programmer's Guide lists:

I. Client Interfaces ........................................1
1. libpq - C library ...................................1

Looking at the document itself, however, I note that these are on
two separate pages. The first of these pages has NO page number;
the second is numbered "1", as indicated in the TOC.

None of the other documents follow this practice. Wazzup?

This is a bug in the stylesheet. It seems that a fix isn't trivial.

--
Peter Eisentraut peter_e@gmx.net

At 11:42 PM -0500 3/10/02, Peter Eisentraut wrote:

Rich Morin writes:

The TOC in the PostgreSQL 7.2 Programmer's Guide lists:

I. Client Interfaces ........................................1
1. libpq - C library ...................................1

Looking at the document itself, however, I note that these are on
two separate pages. The first of these pages has NO page number;
the second is numbered "1", as indicated in the TOC.

None of the other documents follow this practice. Wazzup?

This is a bug in the stylesheet. It seems that a fix isn't trivial.

That's unfortunate. I can work around it for the DOSSIER volume, but
I was really hoping for a fix.

If someone works on the stylesheet, BTW, they might also want to force
the start of each chapter onto an odd page.

-r
--
email: rdm@cfcl.com; phone: +1 650-873-7841
http://www.cfcl.com/rdm - my home page, resume, etc.
http://www.cfcl.com/Meta - The FreeBSD Browser, Meta Project, etc.
http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series
http://www.ptf.com/tdc - Prime Time Freeware's Darwin Collection

Rich Morin writes:

If someone works on the stylesheet, BTW, they might also want to force
the start of each chapter onto an odd page.

The rendition you are looking at is built in one-sided mode. You can also
build the docs in two-sided mode, in which case you get components
starting on the right-hand page, page header and footer alignment
alternating between left and right, and all the other things you'd expect.

--
Peter Eisentraut peter_e@gmx.net

At 12:14 AM -0500 3/11/02, Peter Eisentraut wrote:

Rich Morin writes:

If someone works on the stylesheet, BTW, they might also want to force
the start of each chapter onto an odd page.

The rendition you are looking at is built in one-sided mode. You can also
build the docs in two-sided mode, in which case you get components
starting on the right-hand page, page header and footer alignment
alternating between left and right, and all the other things you'd expect.

Seems reasonable; let's try it...

Judging from .../INSTALL, I should use gmake.

Looks like .../doc/src is the key directory.

Whoops! No READMEs in sight...

Hmmm. Nothing in .../doc/src/Makefile about "two-sided mode".

Aha. I see .../doc/src/sgml/Makefile, but nothing there, either.

% grep 'two-sided' *
% (ulp)

Would some assistance be too much to ask for? I'm not expert in (g)make,
PostgreSQL, SGML, or (*)TeX*, but I don't really think I should have to
be, in order to generate the needed PostScript files. If someone would
give me a bit of hand-holding, I _promise_ to keep good notes! Hey; I'll
even give you an acknowledgement if you like!

-r
--
email: rdm@cfcl.com; phone: +1 650-873-7841
http://www.cfcl.com/rdm - my home page, resume, etc.
http://www.cfcl.com/Meta - The FreeBSD Browser, Meta Project, etc.
http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series
http://www.ptf.com/tdc - Prime Time Freeware's Darwin Collection

Rich Morin writes:

Would some assistance be too much to ask for? I'm not expert in (g)make,
PostgreSQL, SGML, or (*)TeX*, but I don't really think I should have to
be, in order to generate the needed PostScript files.

I guess what I was saying is that it's theoretically possible but no one
has ever done it before. Actually, it turns out to be quite easy:

make user.html # (to build the index)
make user.pdf JADEFLAGS='-V %two-side%' # (or user.ps)

The result looks correct, but you better check it thoroughly.

--
Peter Eisentraut peter_e@gmx.net