pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Bruce Momjian <bruce@momjian.us>
To: PostgreSQL-documentation <pgsql-docs@postgresql.org>
Cc: Álvaro Herrera <alvherre@alvh.no-ip.org>
Subject: initdb username doc bug
Date: Sat, 6 Jan 2024 21:57:09 -0500
Message-ID: <ZZoTBSdKeBG_HZ7A@momjian.us> (raw)

This commit:

	commit 910cab820d
	Author: Alvaro Herrera <alvherre@alvh.no-ip.org>
	Date:   Fri Nov 18 11:59:26 2022 +0100
	
	    Add glossary entries related to superusers
	
	    Extracted from a more ambitious patch.
	
	    Author: David G. Johnston <david.g.johnston@gmail.com>
	    Discussion: https://postgr.es/m/CAKFQuwZC4K0XYBm0bwBMDOZySBqhOSekDhLuaw4vPi+ozi8gqQ@mail.gmail.com

used this text for the --username option:

       -U username
       --username=username
           Selects the user name of the bootstrap superuser. This defaults
           to the name of the cluster owner.

This seems wrong since the cluster owner doesn't exist until the cluster
is created.  The text exists in PG 16 and master.  The attached patch
fixes this.

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

  Only you can decide what is important to you.

Attachments:

  [text/x-diff] initdb.diff (764B, ../ZZoTBSdKeBG_HZ7A@momjian.us/2-initdb.diff)
  download | inline diff:
diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml
index d43c91575c..17363c63b7 100644
--- a/doc/src/sgml/ref/initdb.sgml
+++ b/doc/src/sgml/ref/initdb.sgml
@@ -417,10 +417,9 @@ 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 installation user.
        </para>
       </listitem>
      </varlistentry>

view thread (12+ messages)  latest in thread

Message-ID: <ZZoTBSdKeBG_HZ7A@momjian.us>
Permalink:  ../ZZoTBSdKeBG_HZ7A@momjian.us/
Also on:    postgresql.org/message-id/ZZoTBSdKeBG_HZ7A@momjian.us

 ·  · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: bruce@momjian.us, alvherre@alvh.no-ip.org
  Subject: Re: initdb username doc bug
  In-Reply-To: <ZZoTBSdKeBG_HZ7A@momjian.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox