Re: Documentation Suggestion

From: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
To: jhebert(at)micron(dot)com, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: Documentation Suggestion
Date: 2022-04-28 20:15:34
Message-ID: CAKFQuwauo=ytCHOfV5udNhnoufPEN6uf9rpYsCauhjPWQry_Fg@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Apr 28, 2022 at 12:36 PM PG Doc comments form <
noreply(at)postgresql(dot)org> 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.

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2022-04-29 09:09:14 Re: Documentation Suggestion
Previous Message PG Doc comments form 2022-04-28 19:11:18 Documentation Suggestion