From: Tom Lane <tgl@sss.pgh.pa.us>
To: Laurenz Albe <laurenz.albe@cybertec.at>
cc: riivo.kolka@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Not an error but a difficult wording
In-reply-to: <cd3c9ee208ccf0cc37b5e9ce3c24f79bc229a600.camel@cybertec.at>
References: 
 <167463493588.2667301.13267758265445155872@wrigleys.postgresql.org>
 <cd3c9ee208ccf0cc37b5e9ce3c24f79bc229a600.camel@cybertec.at>
Comments: In-reply-to Laurenz Albe <laurenz.albe@cybertec.at>
	message dated "Wed, 25 Jan 2023 23:21:13 +0100"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <2873116.1674697141.1@sss.pgh.pa.us>
Date: Wed, 25 Jan 2023 20:39:01 -0500
Message-ID: <2873117.1674697141@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/2873117.1674697141%40sss.pgh.pa.us>
Precedence: bulk

Laurenz Albe <laurenz.albe@cybertec.at> writes:
> On Wed, 2023-01-25 at 08:22 +0000, PG Doc comments form wrote:
>> Maybe this would be better? (I don't know the comma rules)
>> "because the files(,?) that are generated/processed by these tools(,?) are
>> already included in the tarball"

> +1

> Correct English would be:

>   These tools are not needed to build from a distribution tarball, because
>   the files generated by these tools are included in the tarball.

The existing wording is not incorrect AFAICS, but I agree it's a bit
awkward.  I'd modify one word in your version:

  These tools are not needed to build from a distribution tarball, because
  the files generated using these tools are included in the tarball.

Or possibly "with" instead of "using"?

			regards, tom lane