Re: System catalog documentation chapter

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Isaac Morland <isaac(dot)morland(at)gmail(dot)com>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Peter Eisentraut <peter(dot)eisentraut(at)enterprisedb(dot)com>, Peter Smith <smithpb2250(at)gmail(dot)com>, PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: System catalog documentation chapter
Date: 2022-07-21 01:19:17
Message-ID: YtiplSy5jB2zFr6H@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Wed, Jul 20, 2022 at 04:32:46PM -0400, Bruce Momjian wrote:
> On Wed, Jul 20, 2022 at 04:23:21PM -0400, Isaac Morland wrote:
> > Will there be a comprehensive list somewhere? Even if it just lists the views,
> > gives maybe a one-sentence description, and links to the relevant chapter, I
> > would find that helpful sometimes.
>
> I was not planning on that since we don't do that in any other cases I
> can think of.
>
> > I ask because I occasionally find myself wanting a comprehensive list of
> > functions, and as far as I can tell it doesn't exist. I'm hoping to avoid that
> > situation for views.
>
> Well, then we just leave them where the are and link to them from other
> parts of the documentation, which I assume/hope we already do.

People have mentioned the view documentation doesn't belong in the
Internals part. Maybe we can just move it to the Server
Administration part and leave it together.

--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com

Indecision is a decision. Inaction is an action. Mark Batterson

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Paquier 2022-07-21 01:40:31 Re: Refactor to make use of a common function for GetSubscriptionRelations and GetSubscriptionNotReadyRelations.
Previous Message Masahiko Sawada 2022-07-21 01:13:25 Improve description of XLOG_RUNNING_XACTS