public inbox for [email protected]help / color / mirror / Atom feed
SGML docs and pdf single-quotes 3+ messages / 3 participants [nested] [flat]
* SGML docs and pdf single-quotes @ 2007-12-31 02:40 E. Rijkers <[email protected]> 2007-12-31 02:58 ` Re: SGML docs and pdf single-quotes Tom Lane <[email protected]> 0 siblings, 1 reply; 3+ messages in thread From: E. Rijkers @ 2007-12-31 02:40 UTC (permalink / raw) To: 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 ^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: SGML docs and pdf single-quotes 2007-12-31 02:40 SGML docs and pdf single-quotes E. Rijkers <[email protected]> @ 2007-12-31 02:58 ` Tom Lane <[email protected]> 2008-03-21 20:01 ` Re: SGML docs and pdf single-quotes Bruce Momjian <[email protected]> 0 siblings, 1 reply; 3+ messages in thread From: Tom Lane @ 2007-12-31 02:58 UTC (permalink / raw) To: E. Rijkers <[email protected]>; +Cc: pgsql-docs "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 > <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 ^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: SGML docs and pdf single-quotes 2007-12-31 02:40 SGML docs and pdf single-quotes E. Rijkers <[email protected]> 2007-12-31 02:58 ` Re: SGML docs and pdf single-quotes Tom Lane <[email protected]> @ 2008-03-21 20:01 ` Bruce Momjian <[email protected]> 0 siblings, 0 replies; 3+ messages in thread From: Bruce Momjian @ 2008-03-21 20:01 UTC (permalink / raw) To: Tom Lane <[email protected]>; +Cc: E. Rijkers <[email protected]>; 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" <[email protected]> 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 <[email protected]> http://momjian.us EnterpriseDB http://postgres.enterprisedb.com + If your life is a hard drive, Christ can be your backup. + ^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2008-03-21 20:01 UTC | newest] Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2007-12-31 02:40 SGML docs and pdf single-quotes E. Rijkers <[email protected]> 2007-12-31 02:58 ` Tom Lane <[email protected]> 2008-03-21 20:01 ` Bruce Momjian <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox