Thread: pagination in the PostgreSQL 7.2 Programmer's Guide

pagination in the PostgreSQL 7.2 Programmer's Guide

From
Rich Morin
Date:
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?

-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

Re: pagination in the PostgreSQL 7.2 Programmer's Guide

From
Peter Eisentraut
Date:
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


Re: pagination in the PostgreSQL 7.2 Programmer's Guide

From
Rich Morin
Date:
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

Re: pagination in the PostgreSQL 7.2 Programmer's Guide

From
Peter Eisentraut
Date:
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


Re: pagination in the PostgreSQL 7.2 Programmer's Guide

From
Rich Morin
Date:
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

Re: pagination in the PostgreSQL 7.2 Programmer's Guide

From
Peter Eisentraut
Date:
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