Received: from localhost (unknown [200.46.204.183])
	by postgresql.org (Postfix) with ESMTP id 9ABC99F9B5D
	for <pgsql-docs-postgresql.org@postgresql.org>;
	Tue,  4 Sep 2007 11:36:58 -0300 (ADT)
Received: from postgresql.org ([200.46.204.71])
	by localhost (mx1.hub.org [200.46.204.183]) (amavisd-maia, port 10024)
	with ESMTP id 48092-08 for <pgsql-docs-postgresql.org@postgresql.org>;
	Tue,  4 Sep 2007 11:36:54 -0300 (ADT)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.5
Received: from lists.commandprompt.com (host-254.commandprompt.net
	[207.173.203.254])
	by postgresql.org (Postfix) with ESMTP id 6FE3F9F9B54
	for <pgsql-docs@postgresql.org>; Tue,  4 Sep 2007 11:36:54 -0300 (ADT)
Received: from perhan.alvh.no-ip.org (190-13-142-51.bk13-dsl.surnet.cl
	[190.13.142.51]) (authenticated bits=0)
	by lists.commandprompt.com (8.13.7/8.13.6) with ESMTP id l84EagAG030136;
	Tue, 4 Sep 2007 07:36:47 -0700
Received: by perhan.alvh.no-ip.org (Postfix, from userid 1000)
	id 593B947C62; Tue,  4 Sep 2007 10:36:40 -0400 (CLT)
Date: Tue, 4 Sep 2007 10:36:40 -0400
From: Alvaro Herrera <alvherre@commandprompt.com>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org,
	Decibel! <decibel@decibel.org>, Oleg Bartunov <oleg@sai.msu.su>,
	Pavel Stehule <pavel.stehule@gmail.com>
Subject: Re: Code examples
Message-ID: <20070904143640.GF6466@alvh.no-ip.org>
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>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <24261.1188915090@sss.pgh.pa.us>
User-Agent: Mutt/1.5.16 (2007-06-11)
X-Virus-Scanned: ClamAV 0.91.1/4150/Tue Sep 4 03:46:54 2007 on
	projects.commandprompt.com
X-Virus-Status: Clean
X-Greylist: Sender succeded SMTP AUTH authentication, not delayed by
	milter-greylist-1.6 (lists.commandprompt.com [192.168.2.159]);
	Tue, 04 Sep 2007 07:36:47 -0700 (PDT)
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Archive-Number: 200709/6
X-Sequence-Number: 4404

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)