Re: Various typo fixes

From: Justin Pryzby <pryzby(at)telsasoft(dot)com>
To: Michael Paquier <michael(at)paquier(dot)xyz>
Cc: Daniel Gustafsson <daniel(at)yesql(dot)se>, Thom Brown <thom(at)linux(dot)com>, pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: Re: Various typo fixes
Date: 2023-04-12 03:44:43
Message-ID: ZDYpK5cWZdz7fiD1@telsasoft.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Wed, Apr 12, 2023 at 12:28:25PM +0900, Michael Paquier wrote:
> On Tue, Apr 11, 2023 at 11:12:58PM +0200, Daniel Gustafsson wrote:
> > > On 11 Apr 2023, at 16:53, Justin Pryzby <pryzby(at)telsasoft(dot)com> wrote:
> >
> > > I think "logical" should be a <literal> here.
> >
> > Agree, it should in order to be consistent.
>
> Indeed.
>
> + to the wal_level parameter change on the primary won't be decoded.
>
> This wal_level should also have a markup.
>
> Number of uses of logical slots in this database that have been
> - canceled due to old snapshots or a too low <xref linkend="guc-wal-level"/>
> + canceled due to old snapshots or too low a <xref linkend="guc-wal-level"/>
>
> This sounds a bit strange to me. A too low wal_level would be a cause
> for a cancel, hence shouldn't this be "canceled due to old snapshots
> or due to a too low guc-wal-level?

That's the same as the original language which Thom and I are requesting
to change, (but you added another "due to").

"a too low" is poor english. It's good enough for a code comment, but
this is a user-facing doc.

It could be "an inadequate wal-level" or "a prohibitively low
wal-level", but Thom's language is better. "too low a wal-level" means
the same thing as "too low of a wal-level" (which would also be fine).

--
Justin

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2023-04-12 04:00:15 Re: longfin missing gssapi_ext.h
Previous Message Michael Paquier 2023-04-12 03:28:25 Re: Various typo fixes