From: Bruce Momjian <bruce@momjian.us>
Message-Id: <200904271720.n3RHKT506782@momjian.us>
Subject: Re: XML documentation question
In-Reply-To: <14517.1240759647@sss.pgh.pa.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Date: Mon, 27 Apr 2009 13:20:29 -0400 (EDT)
CC: Peter Eisentraut <peter_e@gmx.net>, pgsql-docs@postgresql.org
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"

Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > Peter Eisentraut wrote:
> >> On Friday 24 April 2009 15:48:52 Bruce Momjian wrote:
> >>> Apologies, I quoted the wrong section;  I meant to ask about this
> >>> sentence:
> >>> 
> >>> The following functions return XML Schema documents describing the
> >>> mappings made by the data mappings produced by the corresponding
> >>> functions above.
> >> 
> >> I don't know what is unclear about this.
> 
> > The "mappings made by" and "mappings produced by" seem redundant, and
> > hence confusing.
> 
> Couldn't the sentence be trimmed to just
> 
> 	The following functions return XML Schema documents describing the
> 	mappings produced by the corresponding functions above.
> 
> If that phrasing is wrong for some reason, then I agree with Bruce that
> the sentence needs a complete rewrite.

I updated the text to:

    The following functions return XML Schema documents similar to the
    mappings produced by the corresponding functions above:

-- 
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + If your life is a hard drive, Christ can be your backup. +