pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: Jürgen Purtz <juergen@purtz.de>
Cc: Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: TOC: List of Figures
Date: Sun, 07 Jul 2019 14:37:58 -0400
Message-ID: <30333.1562524678@sss.pgh.pa.us> (raw)
In-Reply-To: <304820c6-2ef5-0fdd-4610-1a09b970d9ef@2ndquadrant.com>
References: <e9e5faa4-e920-3253-f6bb-794109e228a1@purtz.de>
	<304820c6-2ef5-0fdd-4610-1a09b970d9ef@2ndquadrant.com>

Peter Eisentraut <peter.eisentraut@2ndquadrant.com> writes:
> On 2019-07-02 10:13, Jürgen Purtz wrote:
>> After the integration of figures into the documentation it may be 
>> helpful to extent the TOC with a 'List of Figures'. Any opinion?
>> 
>> If yes: The same for 'List of Tables' and 'List of Examples'?

> I have never found these useful.  What would you use them for?  Who goes
> to the documentation (or any other book-like material) thinking, I'm in
> the mood to look at some tables today, let's see what's in them.

+1.  I have a vague recollection that we once had such lists in the
TOC (because that was the default behavior for whatever toolchain we
were then using) and later took them out precisely because they were
useless.  Not sure how a list of figures would be any more useful.

			regards, tom lane





view thread (14+ messages)  latest in thread

Message-ID: <30333.1562524678@sss.pgh.pa.us>
Permalink:  ../30333.1562524678@sss.pgh.pa.us/
Also on:    postgresql.org/message-id/30333.1562524678@sss.pgh.pa.us

 · 

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: pgsql-docs@postgresql.org
  Cc: tgl@sss.pgh.pa.us, peter.eisentraut@2ndquadrant.com, juergen@purtz.de, pgsql-docs@lists.postgresql.org
  Subject: Re: TOC: List of Figures
  In-Reply-To: <30333.1562524678@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