Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nkAYU-0004Am-Pd for pgsql-docs@arkaria.postgresql.org; Thu, 28 Apr 2022 20:16:02 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1nkAYS-0000ey-Pu for pgsql-docs@arkaria.postgresql.org; Thu, 28 Apr 2022 20:16:00 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nkAYS-0000ep-GX for pgsql-docs@lists.postgresql.org; Thu, 28 Apr 2022 20:16:00 +0000 Received: from mail-ed1-x532.google.com ([2a00:1450:4864:20::532]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1nkAYL-0004s5-7k for pgsql-docs@lists.postgresql.org; Thu, 28 Apr 2022 20:15:59 +0000 Received: by mail-ed1-x532.google.com with SMTP id b24so6767493edu.10 for ; Thu, 28 Apr 2022 13:15:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=MtlTmSeqDfpePKAeBkoXPHJF+oz8Np07MsDVmCKdEaI=; b=g/OLd6sQk8XqONFVqySTZWszlpzfrHWWKZPObaDzsDp5UQfdUTRAWoPKv/0ZUr5Q7p TOg1hAT/SfzLqmw+cc7ZeCVsZzF88+V/PWeJ616iVbZKrNpimChFuceqnbFZmL5YzbUt 69kQc+VvNwj249whjErGk9f4bZ6O+Kx83VMThbba22v5Z3/rRzzD1NuETBzI9CzgMRFm FVHpepg4wwQSW3Z9o940T578erNUFdb3bkZhldflG8FQVHBP4OfBQ6iz8Zf+WaVAkgPp kKZsgOAZagZa1dEMZ6jjE1ApQhcWOHab8b3HNpBP6U2pCaM20/3WXbOYQbtvxtdxQUAP CSLQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=MtlTmSeqDfpePKAeBkoXPHJF+oz8Np07MsDVmCKdEaI=; b=jUe24dyswCELaC+/Bj+a/UOVtvsPKPZZUm+Mk76sMiLggef8VypE6sx/Nmr5mBLylw 71zEGAgI1GOUShuB0Q4D0/dCGQnTn0xBOz3GPlw0xosoPpt6pTMC0mM8Qk0/Eca8aDK0 8fNWYm/bDGvbcAzb4rHK+JBYKthx6PSH9sIQwuHVixT31Xj0+fzBpDuAriFtXEZzXPlP tqSn17/P4ZNSpahof/S/X5Ql/fTtcFi6sxMfPUnAxDHPMswnQo5TZaaWcUItpsGAskPU cPRRofG6Cy6MrFcikOEfacTCBBGwbhNui8ucm6Y2lsmynP5FMN2FNjvmFAwZdE7928Tt Umrw== X-Gm-Message-State: AOAM532lR0+Pzj3qkTp5Ubu5umVO8GAmK/sKQRJk5kgmRgyGyQyIpjR+ s4E8f/y2n/eQVgfipLrmq1P4IcHT+v1vZDGePL4= X-Google-Smtp-Source: ABdhPJxqqgbcSuVhHbqNJ+LVZR8ceyksif8FjjeREAOkaCWSgzHHER11QzQxpjKn3BdbD+bC5TZz43u15HcfVfVPP2w= X-Received: by 2002:a05:6402:5c5:b0:425:e014:f1bc with SMTP id n5-20020a05640205c500b00425e014f1bcmr25627202edx.361.1651176951251; Thu, 28 Apr 2022 13:15:51 -0700 (PDT) MIME-Version: 1.0 References: <165117307860.683.10308862820133754390@wrigleys.postgresql.org> In-Reply-To: <165117307860.683.10308862820133754390@wrigleys.postgresql.org> From: "David G. Johnston" Date: Thu, 28 Apr 2022 13:15:34 -0700 Message-ID: Subject: Re: Documentation Suggestion To: jhebert@micron.com, Pg Docs Content-Type: multipart/alternative; boundary="000000000000a4095a05ddbc97d8" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000a4095a05ddbc97d8 Content-Type: text/plain; charset="UTF-8" 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. --000000000000a4095a05ddbc97d8 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Thu, Apr 28, 2022 at 12:36 PM PG Doc comments form <= noreply@postgresql.org> wr= ote:
The following documentation comment has been l= ogged on the website:

Page: https://www.postgresql.org/docs/11/app-initd= b.html
Description:

Reference:=C2=A0 https://www.postgresql.org/docs/1= 1/app-initdb.html

When installing recently I found the "-A " option of the initdb c= ommand only
accepts lowercase argument.=C2=A0 For example "-A LDAP" is not va= lid 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 i= n 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 s= tated but is the default=C2=A0unless otherwise stated.

The page could use a hyperlink/cross-reference to the pg_hba.conf document= ation.

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

David J.
=

--000000000000a4095a05ddbc97d8--