Doc: add a short summary of available authentication methods.
authorTom Lane <tgl@sss.pgh.pa.us>
Thu, 19 Dec 2019 14:42:39 +0000 (09:42 -0500)
committerTom Lane <tgl@sss.pgh.pa.us>
Thu, 19 Dec 2019 14:42:57 +0000 (09:42 -0500)
commit54fbd155cc6fdbf875185035b3d9823f739b617d
treee98f07f64e7d086c39b175c762a58bb13e115d8b
parent7cdcc747a9fe588f9e9b3a5d3feb650340093fb2
Doc: add a short summary of available authentication methods.

The "auth-methods" <sect1> used to include descriptions of all our
authentication methods.  Commit 56811e573 promoted its child <sect2>'s
to <sect1>'s, which has advantages but also created some issues:
* The auth-methods page itself is essentially empty/useless.
* Links that pointed to "auth-methods" as a placeholder for all
auth methods were rendered a bit nonsensical.
* DocBook no longer provides a subsection table-of-contents here,
which formerly was a useful if terse summary of available auth methods.

To improve matters, add a handwritten list of all the auth methods.

Per gripe from Dave Cramer.  Back-patch to v11 where the previous
commit came in.

Discussion: https://postgr.es/m/CADK3HH+xQLhcPgg=kWqfogtXGGZr-JdSo=x=WQC0PkAVyxUWyQ@mail.gmail.com
doc/src/sgml/client-auth.sgml