Re: XML documentation question

[Bruce Momjian <bruce(at)momjian(dot)us>]

Tom Lane wrote:
> Bruce Momjian <bruce(at)momjian(dot)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(at)momjian(dot)us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

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