A question about wording in messages

From: Kyotaro Horiguchi <horikyota(dot)ntt(at)gmail(dot)com>
To: pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: A question about wording in messages
Date: 2022-09-14 02:15:07
Message-ID: 20220914.111507.13049297635620898.horikyota.ntt@gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

I saw the following message recently modified.

> This controls the maximum distance we can read ahead in the WAL to prefetch referenced data blocks.

Maybe the "we" means "PostgreSQL program and you" but I see it
somewhat out of place.

I found other three uses of "we" in backend.

> client sent proto_version=%d but we only support protocol %d or lower
> client sent proto_version=%d but we only support protocol %d or higher
> System allows %d, we need at least %d.

This is a little different from the first one. In the three above,
"we" suggests "The developers and maybe the PostgreSQL program".

Is it the right word choice as error messages? I'm not confident on
the precise wording, but I think something like the following are
appropriate here.

> This controls the maximum distance to read ahead in the WAL to prefetch referenced data blocks.
> client sent proto_version=%d but only protocols %d or lower are supported
> client sent proto_version=%d but only protocols %d or higher are supported
> System allows %d, at least %d needed.

Thoughts?

regards.

--
Kyotaro Horiguchi
NTT Open Source Software Center

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2022-09-14 02:38:46 Re: A question about wording in messages
Previous Message Andrew Dunstan 2022-09-14 02:05:20 Re: pgsql: Fix perltidy breaking perlcritic