public inbox for [email protected]  
help / color / mirror / Atom feed
From: Magnus Hagander <[email protected]>
To: Tom Lane <[email protected]>
Cc: Dave Cramer <[email protected]>
Cc: Peter Eisentraut <[email protected]>
Cc: PostgreSQL-development <[email protected]>
Cc: PostgreSQL WWW <[email protected]>
Subject: Re: client auth docs seem to have devolved
Date: Tue, 17 Dec 2019 20:58:46 +0100
Message-ID: <CABUevEyd0VPGGy+6HS5O6ZGY7FmmqiC+B9BRG=VvwPK_5ieC0g@mail.gmail.com> (raw)
In-Reply-To: <[email protected]>
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>
	<[email protected]>

On Tue, Dec 17, 2019 at 5:01 PM Tom Lane <[email protected]> wrote:

> Magnus Hagander <[email protected]> writes:
> > This was changed by Peter in
> > commit 56811e57323faa453947eb82f007e323a952e1a1 along with the
> > restructuring. It used to say "the following subsections". So techically
> I
> > think that change is correct, but that doesn't necessarily make it
> helpful.
>
> > But based on how it actually renders, since that section doesn't contain
> > any actual useful info, we should perhaps just remove section 20.3
> > completely. Peter, thoughts?
>
> Then, URLs pointing to that page (such as Dave evidently has bookmarked)
> would break entirely, which doesn't seem like an improvement.
>

Ugh, that's a good point of course. Didn't think of that.


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?

-- 
 Magnus Hagander
 Me: https://www.hagander.net/ <http://www.hagander.net/;
 Work: https://www.redpill-linpro.com/ <http://www.redpill-linpro.com/;


view thread (11+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected], [email protected], [email protected], [email protected]
  Subject: Re: client auth docs seem to have devolved
  In-Reply-To: <CABUevEyd0VPGGy+6HS5O6ZGY7FmmqiC+B9BRG=VvwPK_5ieC0g@mail.gmail.com>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox