From: Tom Lane <tgl@sss.pgh.pa.us>
To: Magnus Hagander <magnus@hagander.net>
cc: Dave Cramer <davecramer@gmail.com>,
        Peter Eisentraut <peter.eisentraut@2ndquadrant.com>,
        PostgreSQL-development <pgsql-hackers@postgresql.org>,
        PostgreSQL WWW <pgsql-www@postgresql.org>
Subject: Re: client auth docs seem to have devolved
In-reply-to: 
 <CABUevEyd0VPGGy+6HS5O6ZGY7FmmqiC+B9BRG=VvwPK_5ieC0g@mail.gmail.com>
References: 
 <CADK3HH+xQLhcPgg=kWqfogtXGGZr-JdSo=x=WQC0PkAVyxUWyQ@mail.gmail.com>
 <CABUevEzWhRtMVSOyM=YkpMR9FZV3E3w2OjcFScKAjHbu3=io7g@mail.gmail.com>
 <CADK3HH++WrDDfE2q9+qpuaaq-SJfbvC5csP-qFtf_JuTpffeEw@mail.gmail.com>
 <CABUevEzOcEBRLug3gTpAEhvSRjqyNLsk7QY70JbM-OStj=5cYA@mail.gmail.com>
 <13336.1576598463@sss.pgh.pa.us>
 <CABUevEyd0VPGGy+6HS5O6ZGY7FmmqiC+B9BRG=VvwPK_5ieC0g@mail.gmail.com>
Comments: In-reply-to Magnus Hagander <magnus@hagander.net>
	message dated "Tue, 17 Dec 2019 20:58:46 +0100"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <14824.1576615354.1@sss.pgh.pa.us>
Date: Tue, 17 Dec 2019 15:42:34 -0500
Message-ID: <14825.1576615354@sss.pgh.pa.us>
Precedence: bulk

Magnus Hagander <magnus@hagander.net> writes:
> On Tue, Dec 17, 2019 at 5:01 PM Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> I suggest changing the sect1's contents to be a list of available auth
>> methods, linked to their subsections.  That would provide approximately
>> the same quality-of-use as the subsection TOC that used to be there.

> Yeah, that sounds better. Is there some docbook magic that can do that for
> us?

I was just intending to do it the hard way, since even if such magic
exists, it'd probably only regurgitate the section titles.  It seems
more useful to allow for some descriptive text along with that.
(Not a lot, but maybe a full sentence for each one.)

			regards, tom lane