Re: Seeming contradiction in 22.1

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: maja zaloznik <maja(dot)zaloznik(at)gmail(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Seeming contradiction in 22.1
Date: 2023-10-10 19:28:31
Message-ID: ZSWl383HOL6-PTdW@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wed, Sep 27, 2023 at 06:11:44PM -0400, Bruce Momjian wrote:
> On Thu, Mar 23, 2023 at 05:45:03PM +0100, maja zaloznik wrote:
> > Thanks David, this is very helpful!
> >
> > I would have to agree with Tom, that while technically true, the text could be
> > reworded. namely it was not obvious to me that i had used a 'packager' to
> > install the clusters and therefore was doing something outside the purview of
> > the postgres documentation.
> >
> > To me the last sentence would be clearer if it read something like:
> >
> > "Most packagers will name this role `postgres` by default, but this is not
> > required".
> >
> > That way it avoids the passive tense which leaves some ambiguity as to who or
> > what and when is naming this superuser.
>
> I think the paragraph was trying to do too much so I simplified it,
> patch attached.

Patch applied to PG 16. I didn't go further because this is only a
clarification, rather than missing or incorrect information, and the
patch didn't cleanly apply to PG 15.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Only you can decide what is important to you.

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2023-10-10 19:54:39 Re: Certificate authentication docs in multiple places
Previous Message PG Doc comments form 2023-10-10 17:49:53 Improve documentation for 'recovery_target' option