Re: Not an error but a difficult wording

Laurenz Albe <laurenz.albe@cybertec.at>

From: Laurenz Albe <laurenz.albe@cybertec.at>
To: riivo.kolka@gmail.com, pgsql-docs@lists.postgresql.org
Date: 2023-01-25T22:21:13Z
Lists: pgsql-docs
On Wed, 2023-01-25 at 08:22 +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/15/sourcerepo.html
> Description:
> 
> https://www.postgresql.org/docs/current/sourcerepo.html
> 
> I was convinced that there was a missing word or something in 
> "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.
> 
> 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.

Yours,
Laurenz Albe



Commits

  1. Doc: use less-awkward phrasing.