Skip site navigation (1) Skip section navigation (2)

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 (view raw or flat)
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

pgsql-docs by date

Next:From: Tom LaneDate: 2009-04-27 17:55:35
Subject: Re: XML documentation question
Previous:From: David FetterDate: 2009-04-27 17:10:27
Subject: Re: [COMMITTERS] pgsql: Proofreading adjustments for first twoparts of documentation

Privacy Policy | About PostgreSQL
Copyright © 1996-2014 The PostgreSQL Global Development Group