Re: XML documentation question - Mailing list pgsql-docs

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

            regards, tom lane

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: XML documentation question
Next
From: Tom Lane
Date:
Subject: Re: Splitting up release.sgml