Re: Documentation Suggestion - Mailing list pgsql-docs

From David G. Johnston
Subject Re: Documentation Suggestion
Date
Msg-id CAKFQuwauo=ytCHOfV5udNhnoufPEN6uf9rpYsCauhjPWQry_Fg@mail.gmail.com
Whole thread Raw
In response to Documentation Suggestion  (PG Doc comments form <noreply@postgresql.org>)
Responses Re: Documentation Suggestion  (Alvaro Herrera <alvherre@alvh.no-ip.org>)
List pgsql-docs
On Thu, Apr 28, 2022 at 12:36 PM PG Doc comments form <noreply@postgresql.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.

pgsql-docs by date:

Previous
From: PG Doc comments form
Date:
Subject: Documentation Suggestion
Next
From: Alvaro Herrera
Date:
Subject: Re: Documentation Suggestion