pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedauthentication methods sections
3+ messages / 2 participants
[nested] [flat]
* authentication methods sections
@ 2018-04-12 00:37 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 1 reply; 3+ messages in thread
From: Peter Eisentraut @ 2018-04-12 00:37 UTC (permalink / raw)
To: pgsql-docs
I find that the section authentication methods
<https://www.postgresql.org/docs/devel/static/auth-methods.html; is
becoming harder to read and navigate, because we keep adding
authentication methods and more information about them, and it's all on
one HTML page. I propose to move those sections up one level in the
hierarchy so they end up on separate HTML pages.
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
Attachments:
0001-doc-Restructure-authentication-methods-sections.patch (text/plain, 4.2K) download
From ef0ffbfae26a344310cd710c1249b0a8018bccee Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <peter_e@gmx.net>
Date: Wed, 11 Apr 2018 20:33:53 -0400
Subject: [PATCH] doc: Restructure authentication methods sections
Move the authentication methods sections up to sect1, so they are easier
to navigate in HTML.
---
doc/src/sgml/client-auth.sgml | 48 +++++++++++++++++------------------
1 file changed, 24 insertions(+), 24 deletions(-)
diff --git a/doc/src/sgml/client-auth.sgml b/doc/src/sgml/client-auth.sgml
index 53832d08e2..656d5f9417 100644
--- a/doc/src/sgml/client-auth.sgml
+++ b/doc/src/sgml/client-auth.sgml
@@ -859,10 +859,11 @@ <title>An Example <filename>pg_ident.conf</filename> File</title>
<sect1 id="auth-methods">
<title>Authentication Methods</title>
<para>
- The following subsections describe the authentication methods in more detail.
+ The following sections describe the authentication methods in more detail.
</para>
+ </sect1>
- <sect2 id="auth-trust">
+ <sect1 id="auth-trust">
<title>Trust Authentication</title>
<para>
@@ -908,9 +909,9 @@ <title>Trust Authentication</title>
for any TCP/IP connections other than those from <systemitem>localhost</systemitem> (127.0.0.1).
</para>
- </sect2>
+ </sect1>
- <sect2 id="auth-password">
+ <sect1 id="auth-password">
<title>Password Authentication</title>
<indexterm>
@@ -1038,9 +1039,9 @@ <title>Password Authentication</title>
and change the authentication method specifications
in <filename>pg_hba.conf</filename> to <literal>scram-sha-256</literal>.
</para>
- </sect2>
+ </sect1>
- <sect2 id="gssapi-auth">
+ <sect1 id="gssapi-auth">
<title>GSSAPI Authentication</title>
<indexterm zone="gssapi-auth">
@@ -1192,9 +1193,9 @@ <title>GSSAPI Authentication</title>
</varlistentry>
</variablelist>
</para>
- </sect2>
+ </sect1>
- <sect2 id="sspi-auth">
+ <sect1 id="sspi-auth">
<title>SSPI Authentication</title>
<indexterm zone="sspi-auth">
@@ -1310,9 +1311,9 @@ <title>SSPI Authentication</title>
</varlistentry>
</variablelist>
</para>
- </sect2>
+ </sect1>
- <sect2 id="auth-ident">
+ <sect1 id="auth-ident">
<title>Ident Authentication</title>
<indexterm>
@@ -1391,9 +1392,9 @@ <title>Ident Authentication</title>
since <productname>PostgreSQL</productname> does not have any way to decrypt the
returned string to determine the actual user name.
</para>
- </sect2>
+ </sect1>
- <sect2 id="auth-peer">
+ <sect1 id="auth-peer">
<title>Peer Authentication</title>
<indexterm>
@@ -1432,9 +1433,9 @@ <title>Peer Authentication</title>
and <systemitem class="osname">Solaris</systemitem>.
</para>
- </sect2>
+ </sect1>
- <sect2 id="auth-ldap">
+ <sect1 id="auth-ldap">
<title>LDAP Authentication</title>
<indexterm zone="auth-ldap">
@@ -1723,9 +1724,9 @@ <title>LDAP Authentication</title>
</para>
</tip>
- </sect2>
+ </sect1>
- <sect2 id="auth-radius">
+ <sect1 id="auth-radius">
<title>RADIUS Authentication</title>
<indexterm zone="auth-radius">
@@ -1824,9 +1825,9 @@ <title>RADIUS Authentication</title>
</variablelist>
</para>
- </sect2>
+ </sect1>
- <sect2 id="auth-cert">
+ <sect1 id="auth-cert">
<title>Certificate Authentication</title>
<indexterm zone="auth-cert">
@@ -1870,9 +1871,9 @@ <title>Certificate Authentication</title>
is a check that the <literal>cn</literal> attribute matches the database
user name.
</para>
- </sect2>
+ </sect1>
- <sect2 id="auth-pam">
+ <sect1 id="auth-pam">
<title>PAM Authentication</title>
<indexterm zone="auth-pam">
@@ -1928,9 +1929,9 @@ <title>PAM Authentication</title>
LDAP or other authentication methods.
</para>
</note>
- </sect2>
+ </sect1>
- <sect2 id="auth-bsd">
+ <sect1 id="auth-bsd">
<title>BSD Authentication</title>
<indexterm zone="auth-bsd">
@@ -1963,8 +1964,7 @@ <title>BSD Authentication</title>
exists by default on OpenBSD systems.
</para>
</note>
- </sect2>
- </sect1>
+ </sect1>
<sect1 id="client-authentication-problems">
<title>Authentication Problems</title>
--
2.17.0
* Re: authentication methods sections
@ 2018-04-14 21:20 Magnus Hagander <magnus@hagander.net>
parent: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
0 siblings, 1 reply; 3+ messages in thread
From: Magnus Hagander @ 2018-04-14 21:20 UTC (permalink / raw)
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>; +Cc: pgsql-docs
On Thu, Apr 12, 2018 at 2:37 AM, Peter Eisentraut <
peter.eisentraut@2ndquadrant.com> wrote:
> I find that the section authentication methods
> <https://www.postgresql.org/docs/devel/static/auth-methods.html; is
> becoming harder to read and navigate, because we keep adding
> authentication methods and more information about them, and it's all on
> one HTML page. I propose to move those sections up one level in the
> hierarchy so they end up on separate HTML pages.
>
+1, that definitely seems like a good idea.
--
Magnus Hagander
Me: https://www.hagander.net/ <http://www.hagander.net/;
Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/;
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: authentication methods sections
@ 2018-04-21 14:21 Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
parent: Magnus Hagander <magnus@hagander.net>
0 siblings, 0 replies; 3+ messages in thread
From: Peter Eisentraut @ 2018-04-21 14:21 UTC (permalink / raw)
To: Magnus Hagander <magnus@hagander.net>; +Cc: pgsql-docs
On 4/14/18 17:20, Magnus Hagander wrote:
> On Thu, Apr 12, 2018 at 2:37 AM, Peter Eisentraut
> <peter.eisentraut@2ndquadrant.com
> <mailto:peter.eisentraut@2ndquadrant.com>> wrote:
>
> I find that the section authentication methods
> <https://www.postgresql.org/docs/devel/static/auth-methods.html
> <https://www.postgresql.org/docs/devel/static/auth-methods.html>; is
> becoming harder to read and navigate, because we keep adding
> authentication methods and more information about them, and it's all on
> one HTML page. I propose to move those sections up one level in the
> hierarchy so they end up on separate HTML pages.
>
>
> +1, that definitely seems like a good idea.
pushed
--
Peter Eisentraut http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2018-04-21 14:21 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2018-04-12 00:37 authentication methods sections Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
2018-04-14 21:20 ` Magnus Hagander <magnus@hagander.net>
2018-04-21 14:21 ` Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox