Re: Reword messages using "as" instead of "because"

From: Amit Kapila <amit(dot)kapila16(at)gmail(dot)com>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: "Zhijie Hou (Fujitsu)" <houzj(dot)fnst(at)fujitsu(dot)com>, Kyotaro Horiguchi <horikyota(dot)ntt(at)gmail(dot)com>, "pgsql-hackers(at)lists(dot)postgresql(dot)org" <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Reword messages using "as" instead of "because"
Date: 2025-09-19 03:26:10
Message-ID: CAA4eK1JGqOVrqSUc_zT3gn-vPBSxxr4Y7YveGhVW+yaoEoOxVQ@mail.gmail.com
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Thu, Sep 18, 2025 at 5:41 PM Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
>
> Amit Kapila <amit(dot)kapila16(at)gmail(dot)com> writes:
> > Yeah, this sounds clear but shall we consider using
> > max_retention_duration like: "Retention is re-enabled because the
> > apply process has caught up with the publisher within the configured
> > max_retention_duration.". We can have a single message if we don't
> > want to specify the value of max_retention_duration or simply skip
> > adding max_retention_duration.
>
> That wording sounds good to me. I think you could leave out
> the mention of max_retention_duration, but I won't fight if
> people prefer to include it.
>

We have a similar message for stop retention. I feel it would be good
to mention that as a reason, so users can increase it. I could think
of two alternatives for stop message based on above suggestion:
"Retention is stopped because the apply process has not caught up with
the publisher within the configured max_retention_duration."
"Retention is stopped because the apply process could not catch up
with the publisher within the configured max_retention_duration."

Do you have any preference? The first one resembles a similar resume
message and second is probably what I would have used if there was no
corresponding resume message.

--
With Regards,
Amit Kapila.

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Tom Lane 2025-09-19 03:43:34 Re: Reword messages using "as" instead of "because"
Previous Message jian he 2025-09-19 03:08:55 Doc: add XML ID attributes to <varlistentry> tags for create_foreign_table, alter_foreign_table