Message-ID: <cd3c9ee208ccf0cc37b5e9ce3c24f79bc229a600.camel@cybertec.at>
Subject: Re: Not an error but a difficult wording
From: Laurenz Albe <laurenz.albe@cybertec.at>
To: riivo.kolka@gmail.com, pgsql-docs@lists.postgresql.org
Date: Wed, 25 Jan 2023 23:21:13 +0100
In-Reply-To: 
 <167463493588.2667301.13267758265445155872@wrigleys.postgresql.org>
References: 
	<167463493588.2667301.13267758265445155872@wrigleys.postgresql.org>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
User-Agent: Evolution 3.46.3 (3.46.3-1.fc37) 
MIME-Version: 1.0
Archived-At: 
 <https://www.postgresql.org/message-id/cd3c9ee208ccf0cc37b5e9ce3c24f79bc229a600.camel%40cybertec.at>
Precedence: bulk

On Wed, 2023-01-25 at 08:22 +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
>=20
> Page: https://www.postgresql.org/docs/15/sourcerepo.html
> Description:
>=20
> https://www.postgresql.org/docs/current/sourcerepo.html
>=20
> I was convinced that there was a missing word or something in=20
> "because the files that these tools are used to build are included in the
> tarball"
> I had to read this several times, until I saw that it was actually
> correct.
>=20
> Maybe this would be better? (I don't know the comma rules)
> "because the files(,?) that are generated/processed by these tools(,?) ar=
e
> 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.

Yours,
Laurenz Albe