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 1nkSBz-0001A3-NY for pgsql-docs@arkaria.postgresql.org; Fri, 29 Apr 2022 15:05:59 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1nkSBy-0002A6-3g for pgsql-docs@arkaria.postgresql.org; Fri, 29 Apr 2022 15:05:58 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nkSBx-00029w-ID for pgsql-docs@lists.postgresql.org; Fri, 29 Apr 2022 15:05:57 +0000 Received: from mail-ej1-x633.google.com ([2a00:1450:4864:20::633]) by makus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.92) (envelope-from ) id 1nkSBv-0000jx-C5 for pgsql-docs@lists.postgresql.org; Fri, 29 Apr 2022 15:05:56 +0000 Received: by mail-ej1-x633.google.com with SMTP id i19so15959113eja.11 for ; Fri, 29 Apr 2022 08:05:55 -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 :cc; bh=dFxxUAqy3+GCOaRpvEtSreQ4wyNkfZJr0lhbgPmFy9k=; b=aaf8B6gfc8AO7IRNDBqapj1J5srbM3gZWlo3vgdgdMRO9bFgwVQrL31v0f+snFO0vl asO5NGqv1Wu/f/6zK967Yh7jDcY/HeTwkMtA31cKdTbjuCoDW1/l0K5L5FPB7b0xWUW5 MprWirVb9pU46tQC9Pk/JEICbpFFcbkv0Nr1BBGD6oFPPY2/olFGQHF0zW93D/mQMSu3 2PQrSTEoEfYk86Y33K3caPYAgSHaK6qG0stIMO/mJzcCbV1tj9xI7kW3PT2EPhAAxxXt uRqbj7lwZZQ5/URWOIU5xCNTuZE2A1QA0ofR6suBaccn4pzX/pmprtSQplpPTy+9sGUm 6osA== 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:cc; bh=dFxxUAqy3+GCOaRpvEtSreQ4wyNkfZJr0lhbgPmFy9k=; b=4izbELAUkth+3z+XCu2BKuNMJtW+ji8gI3Rwmo6db9ylAY1MxCQMu0jaU4cF1NCaqe FFYhFMO1GbbyOiP/P5WEvmwpxPBF015cy2Zi75tCh3i1h5nYvQIy2UqS/FFPZjXHauE+ e1oWGt7JMS2G4CfnE5sBLLJc5MM9K+GMOR2fx4KLfxZiRwKTZGLMmuJ+5P4w6q9ibbOE XH8Tlk/oMnkoZmi2NzGuqBVz/O1D4McLNVqPxJwRY1btxfQ+WcWpYL+qOuTrHGtxP+gz UweMSSCr1ImkhpHUrMlkr3ggdEHhQliMAA1V0vqVWfSIWML+btHbRqE91nIIoiQSnLnU P98w== X-Gm-Message-State: AOAM533YSjAFyAg2IZZ2LJnZxwQl0B1P7pCsVI/jhzASde9raOtrOORa Zt7mun/4cYR0R/h+ZoKWOZ39nON5MjIFurfARdg= X-Google-Smtp-Source: ABdhPJyR1EBdML7yU2gZfikFoUq+tZ11nS9hTZ9H98/NWNnUnGeHQGOqF4GbpYAHSZSc+fMjhm7nlmegFube3I6Yv/8= X-Received: by 2002:a17:907:1c29:b0:6f3:9722:3dd1 with SMTP id nc41-20020a1709071c2900b006f397223dd1mr25131729ejc.424.1651244753679; Fri, 29 Apr 2022 08:05:53 -0700 (PDT) MIME-Version: 1.0 References: <202204290909.nuwx32e3jtjh@alvherre.pgsql> <317936.1651241217@sss.pgh.pa.us> In-Reply-To: <317936.1651241217@sss.pgh.pa.us> From: "David G. Johnston" Date: Fri, 29 Apr 2022 08:05:36 -0700 Message-ID: Subject: Re: Documentation Suggestion To: Tom Lane Cc: Alvaro Herrera , jhebert@micron.com, Pg Docs Content-Type: multipart/alternative; boundary="000000000000fafb4e05ddcc605e" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Archived-At: Precedence: bulk --000000000000fafb4e05ddcc605e Content-Type: text/plain; charset="UTF-8" On Fri, Apr 29, 2022 at 7:07 AM Tom Lane wrote: > Alvaro Herrera writes: > > On 2022-Apr-28, David G. Johnston wrote: > > >> The page could use a hyperlink/cross-reference to the pg_hba.conf > >> documentation. > > > That's easily fixed. How about the attached patch? > > That part's OK, but personally I'd only have cited the link once. > > Agreed, one or three, including the local-only option but ignoring the host-only one seems like a mistake. I would just document the -A/--auth-method option, the other two are close enough in space to borrow it just fine. Shall we do a return link from the pg_hba.conf to initdb? The first paragraph already has: "A default pg_hba.conf file is installed when the data directory is initialized by initdb." David J. --000000000000fafb4e05ddcc605e Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Fri, Apr 29, 2022 at 7:07 AM Tom Lane <tgl@sss.pgh.pa.us> wrote:
Alvaro Herrera <alvherre@alvh.no-ip.org> writes:
> On 2022-Apr-28, David G. Johnston wrote:

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

> That's easily fixed.=C2=A0 How about the attached patch?

That part's OK, but personally I'd only have cited the link once.

Agreed, one or three, including the lo= cal-only option but ignoring the host-only one seems like a mistake.
<= div class=3D"gmail_default" style=3D"font-family:arial,helvetica,sans-serif= ">
I would just document the -A/--auth-method option, the other= two are close enough in space to borrow it just fine.

Shall we do a return link from the pg_hba.conf to initdb? The first paragr= aph already has:
"A default pg_hba.conf file is installed when= the data directory is initialized by initdb."

Da= vid J.

--000000000000fafb4e05ddcc605e--