Re: PGDOCS - "System Catalogs" table-of-contents page structure

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Peter Smith <smithpb2250(at)gmail(dot)com>
Cc: pgsql-hackers(at)lists(dot)postgresql(dot)org
Subject: Re: PGDOCS - "System Catalogs" table-of-contents page structure
Date: 2022-06-09 00:00:31
Message-ID: 1796986.1654732831@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Peter Smith <smithpb2250(at)gmail(dot)com> writes:
> e.g.2 What I thought it should look like:

> Chapter 53. "System Catalogs and Views" <-- chapter name change
> ======
> 53.1. System Catalogs <-- heading name change
> 53.1.1. pg_aggregate
> 53.1.2. pg_am
> 53.1.3. pg_amop
> 53.1.4. pg_amproc

Then the catalog descriptions would not be on separate pages.

> OTOH it looks like this table of contents page has been this way
> forever (20+ years?). It is hard to believe nobody else suggested
> modifying it in all that time, so perhaps there is some reason for it
> being like it is?

Perhaps that it's just fine as-is.

regards, tom lane

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Peter Smith 2022-06-09 00:29:39 Re: PGDOCS - "System Catalogs" table-of-contents page structure
Previous Message Jacob Champion 2022-06-08 23:53:08 Re: [PATCH] Expose port->authn_id to extensions and triggers