Lists: | pgsql-docs |
---|
From: | "E(dot) Rijkers" <er(at)xs4all(dot)nl> |
---|---|
To: | pgsql-docs(at)postgreSQL(dot)org |
Subject: | SGML docs and pdf single-quotes |
Date: | 2007-12-31 02:40:08 |
Message-ID: | 6368.156.83.0.77.1199068808.squirrel@webmail.xs4all.nl |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Lists: | pgsql-docs |
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 ' (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
From: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
---|---|
To: | "E(dot) Rijkers" <er(at)xs4all(dot)nl> |
Cc: | pgsql-docs(at)postgresql(dot)org |
Subject: | Re: SGML docs and pdf single-quotes |
Date: | 2007-12-31 02:58:17 |
Message-ID: | 19472.1199069897@sss.pgh.pa.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Lists: | pgsql-docs |
"E. Rijkers" <er(at)xs4all(dot)nl> writes:
> Using the pdf version of the postgres manual I wonder if
> it wouldn't be better to replace single-quotes inside
> <programlisting> 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
From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
Cc: | "E(dot) Rijkers" <er(at)xs4all(dot)nl>, pgsql-docs(at)postgresql(dot)org |
Subject: | Re: SGML docs and pdf single-quotes |
Date: | 2008-03-21 20:01:02 |
Message-ID: | 200803212001.m2LK12N21622@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Lists: | pgsql-docs |
Added to TODO:
* Convert single quotes to apostrophes in the PDF documentation
http://archives.postgresql.org/pgsql-docs/2007-12/msg00059.php
---------------------------------------------------------------------------
Tom Lane wrote:
> "E. Rijkers" <er(at)xs4all(dot)nl> writes:
> > Using the pdf version of the postgres manual I wonder if
> > it wouldn't be better to replace single-quotes inside
> > <programlisting> 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
--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://postgres.enterprisedb.com
+ If your life is a hard drive, Christ can be your backup. +