Re: Add mention to related system catalog functions on Tablespaces documentation pages.

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Add mention to related system catalog functions on Tablespaces documentation pages.
Date: 2024-10-14 23:21:32
Message-ID: Zw2nfPG4ikW-MFDf@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Mon, Oct 14, 2024 at 07:15:50PM -0400, Bruce Momjian wrote:
> On Wed, Sep 11, 2024 at 11:26:50PM +0000, PG Doc comments form wrote:
> > The following documentation comment has been logged on the website:
> >
> > Page: https://www.postgresql.org/docs/16/manage-ag-tablespaces.html
> > Description:
> >
> > The tablespaces documentation page seems to be missing a mention to the
> > following functions:
> > pg_tablespace_databases
> > pg_tablespace_location
> >
> > These are documented in
> > https://www.postgresql.org/docs/current/functions-info.html#FUNCTIONS-INFO-CATALOG,
> > but I think it would be nice to add at least a brief mention (or link) to
> > them in the main tablespace docs. The following query is especially helpful
> > when troubleshooting issues with tablespaces:
> >
> > postgres=# SELECT *, pg_tablespace_location(oid) FROM pg_tablespace;
> >
> > It would be beneficial, in my opinion, to use it as an additional example to
> > the one that is currently shown.
>
> Yes, very good points. I have developed the attached patch which I
> think achieves the goals you mentioned. I plan to apply the patch for
> master/PG 18.
>
> I also removed the unnecessary mention of PG 9.1.
>
> Seems the reply email address is g***(at)gmail(dot)com, which seems like some
> kind of mistake.

Sorry, patch attached. Invalid email address removed.

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

When a patient asks the doctor, "Am I going to die?", he means
"Am I going to die soon?"

Attachment Content-Type Size
tablespace.diff text/x-diff 1.5 KB

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message PG Doc comments form 2024-10-15 10:31:23 CLUSTER command
Previous Message Bruce Momjian 2024-10-14 23:15:50 Re: Add mention to related system catalog functions on Tablespaces documentation pages.