From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
cc: grgbnc@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: adding a TOC to the psql reference page
In-reply-to: <20200430221658.GA31271@momjian.us>
References: <158827968914.671.12883635848515477474@wrigleys.postgresql.org>
 <20200430221658.GA31271@momjian.us>
Comments: In-reply-to Bruce Momjian <bruce@momjian.us>
	message dated "Thu, 30 Apr 2020 18:16:58 -0400"
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <23332.1588285292.1@sss.pgh.pa.us>
Date: Thu, 30 Apr 2020 18:21:32 -0400
Message-ID: <23333.1588285292@sss.pgh.pa.us>
Precedence: bulk

Bruce Momjian <bruce@momjian.us> writes:
> On Thu, Apr 30, 2020 at 08:48:09PM +0000, PG Doc comments form wrote:
>> Since https://www.postgresql.org/docs/current/app-psql.html is quite long,
>> it would be nice to add a detailed table of contents at its beginning,

> Yes, I can see the value in that, but I don't think we do that for any
> other SQL comments.  Would doing it just for psql make sense?

psql's reference page is so much longer than any other command's that
I think this is perfectly reasonable.  However, we do have to worry
about what will happen in man-page-format output.

			regards, tom lane