From: Tom Lane <tgl@sss.pgh.pa.us>
To: Bruce Momjian <bruce@momjian.us>
Cc: grgbnc@gmail.com
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: adding a TOC to the psql reference page
Date: Thu, 30 Apr 2020 18:21:32 -0400
Message-ID: <23333.1588285292@sss.pgh.pa.us> (raw)
In-Reply-To: <20200430221658.GA31271@momjian.us>
References: <158827968914.671.12883635848515477474@wrigleys.postgresql.org>
<20200430221658.GA31271@momjian.us>
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
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: pgsql-docs@postgresql.org
Cc: tgl@sss.pgh.pa.us, bruce@momjian.us, grgbnc@gmail.com, pgsql-docs@lists.postgresql.org
Subject: Re: adding a TOC to the psql reference page
In-Reply-To: <23333.1588285292@sss.pgh.pa.us>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox