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

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

pgsql-docs by date

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

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