Re: XML documentation question

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Bruce Momjian <bruce(at)momjian(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-26 15:27:27
Message-ID: 14517.1240759647@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

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.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2009-04-26 20:26:08 Re: Splitting up release.sgml
Previous Message Bruce Momjian 2009-04-26 13:14:06 Re: XML documentation question