A question about wording in messages

Поиск
Список
Период
Сортировка
От Kyotaro Horiguchi
Тема A question about wording in messages
Дата
Msg-id 20220914.111507.13049297635620898.horikyota.ntt@gmail.com
обсуждение исходный текст
Ответы Re: A question about wording in messages  (Tom Lane <tgl@sss.pgh.pa.us>)
Re: A question about wording in messages  (Amit Kapila <amit.kapila16@gmail.com>)
Список 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



В списке pgsql-hackers по дате отправления:

Предыдущее
От: Ranier Vilela
Дата:
Сообщение: Re: Fix possible bogus array out of bonds (src/backend/access/brin/brin_minmax_multi.c)
Следующее
От: Tom Lane
Дата:
Сообщение: Re: A question about wording in messages