Re: Documentation nits

At 5:13 PM +0100 11/15/01, Peter Eisentraut wrote:
>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.

It is a ToC entry, looking like

"12.1.7. The #random# test ... 76"

where the '#'s actually show up as squares. Looking at page 76 (and some
surrounding pages), I see a number of other instances where these little
squares show up, as:

73 There is a #parallel# and a #sequential# mode ...

74 When a test is reported as #failed#, ...

75 Some of the queries in the #timestamp# test ...

76 ... thereby eliminate the bogus #failure# in future releases.
So, to eliminate bogus test #failures# for a particular ...

Evidently, the square is an indication that some bit of markup hasn't
been translated properly.

>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.

Well, in my case, I only care whether the PostScript files you generate
are clean. OTOH, the Arabic page numbers in the front matter work
correctly on most of the PostgreSQL docs, so that should give you a hint
as to the underlying nature of the problem in these documents...

>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.

As long as the entries line up, I don't think anyone will care whether
they are an "en" one way or the other (:-).

>> On page 53 (3rd line), something is printing as a square (?).
>
>Again, some context would help me find this faster.

This problem seems to be pandemic. Hmmmm. As an experiment, I took
the Administrator's Guide and distilled it into PDF. Looking at one
of the instances in question (page 57, section 5.3, "#Cyrillic recode
support#"), I see no squares, but I DO see that the spaces around the
text are wider than normal. I then told Acrobat to print out the page;
the squares didn't show up there, either. OK; let's look at the raw
PostScript:

...
2193 6403 M (described ) 567 X GR
0.0000 0.0000 0.0000 1.0000 SET_CMYK GS n
2763 6403 M (as ) 151 X GR
0.0000 0.0000 0.0000 1.0000 SET_CMYK GS n
2917 6403 M (\223Cyrillic ) 461 X GR
^^^^
0.0000 0.0000 0.0000 1.0000 SET_CMYK GS n
3381 6403 M (recode ) 405 X GR
0.0000 0.0000 0.0000 1.0000 SET_CMYK GS n
3789 6403 M (support\224 ) 450 X GR
^^^^
0.0000 0.0000 0.0000 1.0000 SET_CMYK GS n
4242 6403 M (which ) 374 X GR
0.0000 0.0000 0.0000 1.0000 SET_CMYK GS
...

I dunno what \223 and \224 are supposed to be...

-r
--
email: rdm(at)cfcl(dot)com; phone: +1 650-873-7841
http://www.cfcl.com/rdm - home page, resume, etc.
http://www.cfcl.com/Meta/md_fb.html - The FreeBSD Browser
http://www.ptf.com/tdc - Prime Time Freeware's Darwin Collection