From: Alvaro Herrera <alvherre@commandprompt.com>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org, Decibel! <decibel@decibel.org>
Cc: Oleg Bartunov <oleg@sai.msu.su>
Cc: Pavel Stehule <pavel.stehule@gmail.com>
Subject: Re: Code examples
Date: Tue, 4 Sep 2007 10:36:40 -0400
Message-ID: <20070904143640.GF6466@alvh.no-ip.org> (raw)
In-Reply-To: <24261.1188915090@sss.pgh.pa.us>
References: <162867790709021328i7771aa9jfe79268bccbf123d@mail.gmail.com>
<200709040229.29591.peter_e@gmx.net>
<6062.1188866394@sss.pgh.pa.us>
<200709041101.54641.peter_e@gmx.net>
<24261.1188915090@sss.pgh.pa.us>
Tom Lane escribió:
> Peter Eisentraut <peter_e@gmx.net> writes:
> > Am Dienstag, 4. September 2007 02:39 schrieb Tom Lane:
> >> C code that's been hacked until it passes for SGML isn't compilable.
>
> > I don't understand this point. Why would SGML care what the C code looks
> > like?
>
> &, <, and > need to be hacked so that SGML doesn't barf on them.
> Unfortunately, all three symbols are a bit commonplace in C code.
Maybe we could set things up so that there are actual files which are
programatically preprocessed to SGML to be included in the docs? That
way, the docs always reflect the actual file, which by itself is
compilable. The SGML source would only contain something like
<include file="examples/foo.c" /> or something like that.
Is that feasible?
--
Alvaro Herrera http://www.amazon.com/gp/registry/CTMLCN8V17R4
"No necesitamos banderas
No reconocemos fronteras" (Jorge González)
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: pgsql-docs@postgresql.org
Cc: alvherre@commandprompt.com, tgl@sss.pgh.pa.us, peter_e@gmx.net, decibel@decibel.org, oleg@sai.msu.su, pavel.stehule@gmail.com
Subject: Re: Code examples
In-Reply-To: <20070904143640.GF6466@alvh.no-ip.org>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox