Re: XML documentation question - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: XML documentation question
Date
Msg-id 200904271720.n3RHKT506782@momjian.us
Whole thread Raw
In response to Re: XML documentation question  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: XML documentation question
Re: XML documentation question
List pgsql-docs
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. +

pgsql-docs by date:

Previous
From: David Fetter
Date:
Subject: Re: [COMMITTERS] pgsql: Proofreading adjustments for first two parts of documentation
Next
From: Tom Lane
Date:
Subject: Re: XML documentation question