Date: Mon, 27 Apr 2009 16:00:11 -0400
From: Alvaro Herrera <alvherre@commandprompt.com>
To: Bruce Momjian <bruce@momjian.us>
Cc: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org,
	Tom Lane <tgl@sss.pgh.pa.us>
Subject: Re: XML documentation question
Message-ID: <20090427200011.GD10358@alvh.no-ip.org>
References: <200904272148.09286.peter_e@gmx.net>
	<200904271852.n3RIqmO00786@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <200904271852.n3RIqmO00786@momjian.us>
User-Agent: Mutt/1.5.18 (2008-05-17)

Bruce Momjian wrote:
> Peter Eisentraut wrote:
> > On Monday 27 April 2009 20:20:29 Bruce Momjian wrote:
> > > I updated the text to:
> > >
> > >     The following functions return XML Schema documents similar to the
> > >     mappings produced by the corresponding functions above:
> 
> OK, that is what is in our SGML now.
> 
> > Sorry, that is completely wrong.
> 
> You did just email "sounds good", but were mistaken, right?

But that was to Tom proposal, which is completely different (yes -- one
word can change the meaning of a sentence).

I agree the paragraph (even with Tom's rework) is a bit confusing to the
uninitiated.  Maybe the subsection could be reflowed so that each
function is described along the corresponding XML Schema function (to
table_to_xml and table_to_xmlschema, later query_to_xml and
query_to_xmlschema and so on).

-- 
Alvaro Herrera                                http://www.CommandPrompt.com/
PostgreSQL Replication, Consulting, Custom Development, 24x7 support