public inbox for [email protected]  
help / color / mirror / Atom feed
From: E. Rijkers <[email protected]>
To: [email protected]
Subject: SGML docs and pdf single-quotes
Date: Mon, 31 Dec 2007 03:40:08 +0100 (CET)
Message-ID: <[email protected]> (raw)

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





view thread (3+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected]
  Subject: Re: SGML docs and pdf single-quotes
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox