From: Laurenz Albe <laurenz.albe@cybertec.at>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: riivo.kolka@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: Not an error but a difficult wording
Date: Thu, 26 Jan 2023 05:49:47 +0100
Message-ID: <a4f3aa1a03eec651be55a6bc68b82a29f3080a16.camel@cybertec.at> (raw)
In-Reply-To: <2873117.1674697141@sss.pgh.pa.us>
References: <167463493588.2667301.13267758265445155872@wrigleys.postgresql.org>
<cd3c9ee208ccf0cc37b5e9ce3c24f79bc229a600.camel@cybertec.at>
<2873117.1674697141@sss.pgh.pa.us>
On Wed, 2023-01-25 at 20:39 -0500, Tom Lane wrote:
> 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 meant "a correct version of what was suggested in the mail", not that
the released text was incorrect.
> 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"?
Both are better; I'd lean towards "with".
Yours,
Laurenz Albe
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: laurenz.albe@cybertec.at, tgl@sss.pgh.pa.us, riivo.kolka@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: Not an error but a difficult wording
In-Reply-To: <a4f3aa1a03eec651be55a6bc68b82a29f3080a16.camel@cybertec.at>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox