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
From ef0ffbfae26a344310cd710c1249b0a8018bccee Mon Sep 17 00:00:00 2001
From: Peter Eisentraut <pete...@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

Reply via email to