Sender: Gurjeet Singh <singh.gurjeet@gmail.com>
Mime-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain; charset=UTF-8
Date: Sat, 29 Mar 2025 07:56:48 -0700
Message-Id: <D8SU63UEWM2W.2G7T8VNS82WBH@singh.im>
Cc: <pgsql-docs@lists.postgresql.org>
Subject: Re: Creating first database
From: "Gurjeet Singh" <gurjeet@singh.im>
To: "Tom Lane" <tgl@sss.pgh.pa.us>, <postgresql@complexity.com.au>
References: <174322916469.674.13909966511923455324@wrigleys.postgresql.org>
 <2689845.1743256570@sss.pgh.pa.us>
In-Reply-To: <2689845.1743256570@sss.pgh.pa.us>
Archived-At: 
 <https://www.postgresql.org/message-id/D8SU63UEWM2W.2G7T8VNS82WBH%40singh.im>
Precedence: bulk

On Sat Mar 29, 2025 at 6:56 AM PDT, Tom Lane wrote:
> PG Doc comments form <noreply@postgresql.org> writes:
>> In the Getting Started section of the documentation which would be used =
by a
>> new user immediately after installing PostgreSQL, the user is asked to r=
un
>> $ createdb mydb
>> If the database is correctly installed, this first command to be run by =
the
>> new user inevitably fails with the error:
>> createdb: error: connection to server at "localhost" (::1), port 5432
>> failed: FATAL:  password authentication failed for user "Mark"


> We can't really hope to document everything that every packager does
> in the community Postgres documentation, not least because they seldom
> inform us.  I suppose it might be helpful to add something along the
> lines of "if you are using a pre-packaged version of Postgres, please
> consult the packager's documentation".

Given that the 'Installation' subsection, before the 'Creating a
Database' subsection within Getting Started, covers the various way
Postgres may be installed, and covers that environment variables may
need to be tweaked to accommodated the differences, I don't feel the
subsequent sections need to repeat how to deal with different types of
installations.

Best regards,
Gurjeet
https://Gurje.et