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

From Bruce Momjian
Subject Re: System catalog documentation chapter
Date
Msg-id Ys3k/4nWw9n3LgqH@momjian.us
Whole thread Raw
In response to Re: System catalog documentation chapter  (Peter Eisentraut <peter.eisentraut@enterprisedb.com>)
Responses Re: System catalog documentation chapter
List pgsql-hackers
On Tue, Jul 12, 2022 at 08:56:36PM +0200, Peter Eisentraut wrote:
> On 08.07.22 21:32, Bruce Momjian wrote:
> > On Fri, Jul  8, 2022 at 12:07:45PM -0400, Bruce Momjian wrote:
> > > On Fri, Jul  8, 2022 at 11:49:47AM -0400, Tom Lane wrote:
> > > > Bruce Momjian <bruce@momjian.us> writes:
> > > > > Agreed. I don't want to break links into the documentation in final
> > > > > released versions, so head and PG15 seem wise.
> > > > 
> > > > I would not expect this to change the doc URLs for any individual
> > > > catalogs or views --- if it does, I won't be happy.
> > > 
> > > Good point --- I thought the chapter was in the URL, but I now see it is
> > > just the section heading:
> > > 
> > >     https://www.postgresql.org/docs/devel/view-pg-available-extensions.html
> > > 
> > > so I guess we can backpatch this with no issues.
> > 
> > Attached is a patch to accomplish this.  Its output can be seen here:
> > 
> >     https://momjian.us/tmp/pgsql/internals.html
> 
> 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?

-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

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




pgsql-hackers by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: System catalog documentation chapter
Next
From: Tom Lane
Date:
Subject: Re: System catalog documentation chapter