Re: adding a TOC to the psql reference page

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: grgbnc(at)gmail(dot)com, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: adding a TOC to the psql reference page
Date: 2020-04-30 22:21:32
Message-ID: 23333.1588285292@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Bruce Momjian <bruce(at)momjian(dot)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

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message David G. Johnston 2020-04-30 22:26:32 Re: adding a TOC to the psql reference page
Previous Message Bruce Momjian 2020-04-30 22:16:58 Re: adding a TOC to the psql reference page