Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jUHUS-0000v3-LR for pgsql-docs@arkaria.postgresql.org; Thu, 30 Apr 2020 22:17:08 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1jUHUR-0004Sp-9O for pgsql-docs@arkaria.postgresql.org; Thu, 30 Apr 2020 22:17:07 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jUHUR-0004Si-3p for pgsql-docs@lists.postgresql.org; Thu, 30 Apr 2020 22:17:07 +0000 Received: from momjian.us ([72.94.173.45]) by magus.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jUHUK-0004RD-9F for pgsql-docs@lists.postgresql.org; Thu, 30 Apr 2020 22:17:06 +0000 Received: from bruce by momjian.us with local (Exim 4.92) (envelope-from ) id 1jUHUI-0000jP-7H; Thu, 30 Apr 2020 18:16:58 -0400 Date: Thu, 30 Apr 2020 18:16:58 -0400 From: Bruce Momjian To: grgbnc@gmail.com, pgsql-docs@lists.postgresql.org Subject: Re: adding a TOC to the psql reference page Message-ID: <20200430221658.GA31271@momjian.us> References: <158827968914.671.12883635848515477474@wrigleys.postgresql.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <158827968914.671.12883635848515477474@wrigleys.postgresql.org> User-Agent: Mutt/1.10.1 (2018-07-13) List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk On Thu, Apr 30, 2020 at 08:48:09PM +0000, PG Doc comments form wrote: > The following documentation comment has been logged on the website: > > Page: https://www.postgresql.org/docs/12/app-psql.html > Description: > > 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, in > order to: > > - allow for easier browsing > > - allow to reference individual psql options, meta-commands, variables, > prompts and environment variables by using their respective id attribute 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? -- Bruce Momjian https://momjian.us EnterpriseDB https://enterprisedb.com + As you are, so once was I. As I am, so you will be. + + Ancient Roman grave inscription +