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