Date: Mon, 8 Jan 2024 16:26:22 -0500
From: Bruce Momjian <bruce@momjian.us>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: "David G. Johnston" <david.g.johnston@gmail.com>,
	PostgreSQL-documentation <pgsql-docs@postgresql.org>,
	=?utf-8?Q?=C3=81lvaro?= Herrera <alvherre@alvh.no-ip.org>
Subject: Re: initdb username doc bug
Message-ID: <ZZxofrDqv4XIlflL@momjian.us>
References: <ZZoTBSdKeBG_HZ7A@momjian.us>
 <CAKFQuwZqMqbPbvVYD2oozzMAKpBrCnOiFZusC1n2kAdVYqCqxg@mail.gmail.com>
 <ZZoYeObU1BgMNDNs@momjian.us>
 <CAKFQuwZtQBubJGYew4vnX1ehNXQ4E1E1ZKbNDN7Vpgp5Niksyg@mail.gmail.com>
 <CAKFQuwadqy=7mhh8usoV=yNvrsEg48tUhB31PAPsVFW7vqfeLA@mail.gmail.com>
 <1491857.1704601634@sss.pgh.pa.us>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="Ypbdvn8mZDMsJ3sl"
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <1491857.1704601634@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/ZZxofrDqv4XIlflL%40momjian.us>
Precedence: bulk


--Ypbdvn8mZDMsJ3sl
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit

On Sat, Jan  6, 2024 at 11:27:14PM -0500, Tom Lane wrote:
> "David G. Johnston" <david.g.johnston@gmail.com> writes:
> > Or just the bit more verbose “user running the initdb command” and don’t
> > bother giving it a label, which is basically the approach used in the
> > description for initdb anyway.
> 
> Or if you want a few more words, "name of the operating-system user
> running initdb".  I don't like "installation user", that's just about
> as vague as could be.

Agreed, updated patch attached.

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Only you can decide what is important to you.

--Ypbdvn8mZDMsJ3sl
Content-Type: text/x-diff; charset=us-ascii
Content-Disposition: attachment; filename="initdb.diff"

diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index d43c91575c..cd75cae10e 100644
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -417,10 +417,10 @@ PostgreSQL documentation
       <term><option>--username=<replaceable class="parameter">username</replaceable></option></term>
       <listitem>
        <para>
-        Selects the user name of the
+        Sets the user name of the
         <glossterm linkend="glossary-bootstrap-superuser">bootstrap superuser</glossterm>.
-        This defaults to the name of the
-        <glossterm linkend="glossary-cluster-owner">cluster owner</glossterm>.
+        This defaults to the name of the operating-system user running
+        <command>initdb</command>.
        </para>
       </listitem>
      </varlistentry>

--Ypbdvn8mZDMsJ3sl--