Re: XML documentation question

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, pgsql-docs(at)postgresql(dot)org
Subject: Re: XML documentation question
Date: 2009-04-27 17:20:29
Message-ID: 200904271720.n3RHKT506782@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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. +

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2009-04-27 17:55:35 Re: XML documentation question
Previous Message David Fetter 2009-04-27 17:10:27 Re: [COMMITTERS] pgsql: Proofreading adjustments for first two parts of documentation