Re: Documentation nits

Rich Morin writes:

> PostreSQL 7.1 Administrator's Guide
>
> On page iii (2nd line), something is printing as a square (?).

Could you give some context? I don't have the specific document at hand.

> PostreSQL 7.1 Developer's Guide
>
> The Arabic page numbers do not match the actual page numbers for
> "List of Tables" and "List of Examples".

> PostreSQL 7.1 Programmer's Guide
>
> The Arabic page numbers do not match the actual page numbers for
> "List of Tables" , "List of Figures", and "List of Examples". Also,
> there seem to be two sequences of Arabic page numbers (e.g., the
> Preface is not the first item, yet it is listed as Page "i").

I've found that the Arabic page numbers in the front matter don't work
correctly. I think I have this fixed for the 7.2 release, but it's a
combination of a newer stylesheet release, patches yet to be included in
an even newer stylesheet release, plus the new PG customization layer, so
it might be a bit hard to reproduce for outsiders.

> PostreSQL 7.1 Reference Manual
>
> Certain entries in the Table of Contents are exdented slightly
> (alternatively, the other entries may be indented slightly :-):
>
> CHECKPOINT, RESET, SET, SET CONSTRAINTS, SET TRANSACTION, SHOW,
> createdb, createuser, etc.

I vote for indented. I can see the issue from a theoretical point of
view, but it doesn't appear to happen with the newer toolchain I have
here. Will have to watch this.

> PostreSQL 7.1 User's Guide
>
> The Arabic page numbers do not start with the first page of the
> document; the "Table of Contents" should be on page "iii". Also,
> there seem to be two sequences of Arabic page numbers (e.g., the
> Preface is not the first item, yet it is listed as Page "i").
>
> In Table 3-10, the text is jammed up against the lefthand rules.

Peculiar.

> On page 53 (3rd line), something is printing as a square (?).

Again, some context would help me find this faster.

Thanks for those reports.

--
Peter Eisentraut peter_e(at)gmx(dot)net