public inbox for [email protected]  

help / color / mirror / Atom feed

From: David G. Johnston <[email protected]>
To: [email protected]
To: Pg Docs <[email protected]>
Subject: Re: Documentation Suggestion
Date: Thu, 28 Apr 2022 13:15:34 -0700
Message-ID: <CAKFQuwauo=ytCHOfV5udNhnoufPEN6uf9rpYsCauhjPWQry_Fg@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>

On Thu, Apr 28, 2022 at 12:36 PM PG Doc comments form <
[email protected]> wrote:

> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/11/app-initdb.html
> Description:
>
> Reference:  https://www.postgresql.org/docs/11/app-initdb.html
>
> When installing recently I found the "-A " option of the initdb command
> only
> accepts lowercase argument.  For example "-A LDAP" is not valid and must be
> "-A ldap" otherwise the following error is returned:
> initdb: invalid authentication method "LDAP" for "local" connections
>
> It may be worth adding a note to the above documentation that states all
> option values must be specified in lowercase.
>

The -A option will accept any of the option names that are specified in the
documentation for pg_hba.conf

It just so happens that all of those names, at present, consist of all
lower-case characters.

That matching is case-sensitive is not specifically stated but is the
default unless otherwise stated.

The page could use a hyperlink/cross-reference to the pg_hba.conf
documentation.

But we don't go out of our way anywhere else to be so explicit about this
kind of requirement and don't see a point of making this instance an
exception.

David J.

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: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: Documentation Suggestion
  In-Reply-To: <CAKFQuwauo=ytCHOfV5udNhnoufPEN6uf9rpYsCauhjPWQry_Fg@mail.gmail.com>

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

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