Re: Move Section 9.27.7 (Data Object Management Functions) to System Information Chapter

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com>
Cc: PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org>
Subject: Re: Move Section 9.27.7 (Data Object Management Functions) to System Information Chapter
Date: 2022-07-14 22:43:24
Message-ID: YtCcDNsKw0AllD3O@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Mon, Apr 25, 2022 at 08:33:47AM -0700, David G. Johnston wrote:
> Hi,
>
> Both the location and name of the linked to section make no sense to me:
>
> https://www.postgresql.org/docs/current/functions-admin.html#
> FUNCTIONS-ADMIN-DBOBJECT
>
> Neither of the tables listed there manage (cause to change) anything.  They are
> pure informational functions - size and path of objects respectively.  It
> belongs in the previous chapter "System Information Functions and Operators"
> with a different name.

So, the section title is:

9.27.7. Database Object Management Functions

I think the idea is that they _help_ to manage database objects by
reporting their size or location. I do think it is in the right
chapter, but maybe needs a better title? I can't think of one.

--
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 Melanie Plageman 2022-07-14 22:44:48 Re: pg_stat_bgwriter.buffers_backend is pretty meaningless (and more?)
Previous Message Bruce Momjian 2022-07-14 22:31:31 Re: [PATCH v1] remove redundant check of item pointer