[DOCS] SGML docs and pdf single-quotes

[E. Rijkers]

Hi all,

  Using the pdf version of the postgres manual I wonder if
it wouldn't be better to replace single-quotes inside
 with ' (apostrophe).

There are two advantages:

  1. it makes it possible to copy-and-paste examples from
the pdf file.

  2. it prevents running together of two (or more)
single-quotes into a single double-quote.

Both problems occur only in pdf, not in html.

A disadvantage is that sgml source files become less
human-readable.

I compiled such a converted pdf with the attached perl
program.

The perl program can easily be made to generate the diffs
for all sgml files;  I'll do that if it is considered
useful. On the other hand, maybe this conversion of  ' to
&apod;  should be built into the xslt processing (to leave
the sgml more readable)?


Erik Rijkers



---(end of broadcast)---
TIP 9: In versions below 8.0, the planner will ignore your desire to
   choose an index scan if your joining column's datatypes do not
   match

Re: [DOCS] SGML docs and pdf single-quotes

[Tom Lane]

"E. Rijkers" <[EMAIL PROTECTED]> writes:
>   Using the pdf version of the postgres manual I wonder if
> it wouldn't be better to replace single-quotes inside
>  with ' (apostrophe).

Having to deal with entity-izing & and < is bad enough;
doing it for ' is something up with which I will not put.

> On the other hand, maybe this conversion of  ' to
> &apod;  should be built into the xslt processing (to leave
> the sgml more readable)?

That would be tolerable.

regards, tom lane

---(end of broadcast)---
TIP 7: You can help support the PostgreSQL project by donating at

http://www.postgresql.org/about/donate