Received: from localhost (unknown [200.46.204.183])
	by postgresql.org (Postfix) with ESMTP id BA4092E0194
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 30 Dec 2007 22:40:12 -0400 (AST)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024)
	with ESMTP id 38900-03 for <pgsql-docs-postgresql.org@postgresql.org>;
	Sun, 30 Dec 2007 22:40:10 -0400 (AST)
Received: from smtp-vbr17.xs4all.nl (smtp-vbr17.xs4all.nl [194.109.24.37])
	by postgresql.org (Postfix) with ESMTP id DFB592E0042
	for <pgsql-docs@postgreSQL.org>; Sun, 30 Dec 2007 22:40:09 -0400 (AST)
Received: from webmail.xs4all.nl (dovemail9.xs4all.nl [194.109.26.11])
	by smtp-vbr17.xs4all.nl (8.13.8/8.13.8) with ESMTP id lBV2e7vt062114
	for <pgsql-docs@postgreSQL.org>; Mon, 31 Dec 2007 03:40:08 +0100 (CET)
	(envelope-from er@xs4all.nl)
Received: from 156.83.0.77 (SquirrelMail authenticated user er)
	by webmail.xs4all.nl with HTTP; Mon, 31 Dec 2007 03:40:08 +0100 (CET)
Message-ID: <6368.156.83.0.77.1199068808.squirrel@webmail.xs4all.nl>
Date: Mon, 31 Dec 2007 03:40:08 +0100 (CET)
Subject: SGML docs and pdf single-quotes
From: "E. Rijkers" <er@xs4all.nl>
To: pgsql-docs@postgreSQL.org
User-Agent: SquirrelMail/1.4.11
MIME-Version: 1.0
Content-Type: text/plain;charset=iso-8859-1
Content-Transfer-Encoding: 8bit
X-Virus-Scanned: by XS4ALL Virus Scanner
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=0.771 tagged_above=0 required=5 tests=AWL=0.770,
	BAYES_50=0.001
X-Spam-Level: 
X-Archive-Number: 200712/60
X-Sequence-Number: 4728

Hi all,

  Using the pdf version of the postgres manual I wonder if
it wouldn't be better to replace single-quotes inside
<programlisting> with &apos; (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