Re: System catalog documentation chapter - Mailing list pgsql-hackers

From Tom Lane
Subject Re: System catalog documentation chapter
Date
Msg-id 1869011.1657661055@sss.pgh.pa.us
Whole thread Raw
In response to Re: System catalog documentation chapter  (Bruce Momjian <bruce@momjian.us>)
List pgsql-hackers
Bruce Momjian <bruce@momjian.us> writes:
> On Tue, Jul 12, 2022 at 08:56:36PM +0200, Peter Eisentraut wrote:
>> views.sgml is a pretty generic name for a chapter that just contains system
>> views.

> Yes, I struggled with that.  What made me choose "views" is that the
> current name was catalogs.sgml, not syscatalogs.sgml.  If is acceptable
> to use catalogs.sgml and sysviews.sgml?

"catalogs" isn't too confusable with user-defined objects, so I think
that name is fine --- and anyway it has decades of history so changing
it seems unwise.

We seem to have been trending towards less-abbreviated .sgml file names
over time, so personally I'd go for system-views.sgml.

            regards, tom lane



pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: System catalog documentation chapter
Next
From: Tom Lane
Date:
Subject: Re: Extending outfuncs support to utility statements