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.
--
Bruce Momjian <br...@momjian.us> https://momjian.us
EDB https://enterprisedb.com
Only you can decide what is important to you.
diff --git a/doc/src/sgml/user-manag.sgml b/doc/src/sgml/user-manag.sgml
new file mode 100644
index 27c1f3d..92a299d
*** a/doc/src/sgml/user-manag.sgml
--- b/doc/src/sgml/user-manag.sgml
*************** SELECT rolname FROM pg_roles WHERE rolca
*** 103,113 ****
<para>
In order to bootstrap the database system, a freshly initialized
system always contains one predefined login-capable role. This role
! is always a <quote>superuser</quote>, and by default it will have
the same name as the operating system user that initialized the
! database cluster, unless another name is specified while
! running <command>initdb</command>.
! It is common, but not required, to arrange for this role to be named
<literal>postgres</literal>. In order to create more roles you
first have to connect as this initial role.
</para>
--- 103,112 ----
<para>
In order to bootstrap the database system, a freshly initialized
system always contains one predefined login-capable role. This role
! is always a <quote>superuser</quote>, and it will have
the same name as the operating system user that initialized the
! database cluster with <command>initdb</command> unless a different name
! is specified. This role is often named
<literal>postgres</literal>. In order to create more roles you
first have to connect as this initial role.
</para>
