Date: Tue, 10 Oct 2023 15:28:31 -0400
From: Bruce Momjian <bruce@momjian.us>
To: maja zaloznik <maja.zaloznik@gmail.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>,
	"David G. Johnston" <david.g.johnston@gmail.com>,
	pgsql-docs@lists.postgresql.org
Subject: Re: Seeming contradiction in 22.1
Message-ID: <ZSWl383HOL6-PTdW@momjian.us>
References: 
 <167931662853.3349090.18217722739345182859@wrigleys.postgresql.org>
 <CAKFQuwbH24u4aZMLpAm93p0kvZ+e8CqjKY-piYW5LyAEfRbXow@mail.gmail.com>
 <CABYHV=W5TKoLMD3Wjrq2foKGSYpf5sQ-HifvdPSxUNY+4NFwcg@mail.gmail.com>
 <CAKFQuwZuNhkxUsFF2BraLiQ3RHehhaNU1Y-1Fvqt8YX=PyHM=w@mail.gmail.com>
 <CABYHV=UTy=_WSnSvMPon-Y5TJhoy2jf10=xeNEGT5NzfjR3zaA@mail.gmail.com>
 <CAKFQuwYdUpjOSUTymjHU9Hp-x50EJKWcQwVtBR4uaJ1TL3sF2Q@mail.gmail.com>
 <1821386.1679584161@sss.pgh.pa.us>
 <CABYHV=VestugS_XWi=Uc7EzygPc1LFYQX=acj_BkxUH_MUDLxA@mail.gmail.com>
 <ZRSooHXRdtyi9gO0@momjian.us>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <ZRSooHXRdtyi9gO0@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/ZSWl383HOL6-PTdW%40momjian.us>
Precedence: bulk

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@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.