Re: Documentation Suggestion - Mailing list pgsql-docs

From Alvaro Herrera
Subject Re: Documentation Suggestion
Date
Msg-id 202204290909.nuwx32e3jtjh@alvherre.pgsql
Whole thread Raw
In response to Re: Documentation Suggestion  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: Documentation Suggestion  (Peter Eisentraut <peter.eisentraut@enterprisedb.com>)
Re: Documentation Suggestion  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On 2022-Apr-28, David G. Johnston wrote:

> 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.

Maybe we could add a <para> in the Options section before the item list,
along the lines of "be mindful that arguments to options --auth,
--auth-local, --encoding, --locale (and all --lc-* options) are
case-sensitive".

(The point here, I suppose, is that LDAP being an acronym is typically
spelled uppercase, so our use of lowercase is a bit odd.)

Maybe there are other places where this is relevant as well?

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

That's easily fixed.  How about the attached patch?

-- 
Álvaro Herrera         PostgreSQL Developer  —  https://www.EnterpriseDB.com/
"El destino baraja y nosotros jugamos" (A. Schopenhauer)

Attachment

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: Documentation Suggestion
Next
From: Peter Eisentraut
Date:
Subject: Re: Documentation Suggestion