Re: Move Section 9.27.7 (Data Object Management Functions) to System Information Chapter - Mailing list pgsql-hackers

From Bruce Momjian
Subject Re: Move Section 9.27.7 (Data Object Management Functions) to System Information Chapter
Date
Msg-id YtCcDNsKw0AllD3O@momjian.us
Whole thread Raw
In response to Move Section 9.27.7 (Data Object Management Functions) to System Information Chapter  ("David G. Johnston" <david.g.johnston@gmail.com>)
Responses Re: Move Section 9.27.7 (Data Object Management Functions) to System Information Chapter
List 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@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: [PATCH v1] remove redundant check of item pointer
Next
From: Melanie Plageman
Date:
Subject: Re: pg_stat_bgwriter.buffers_backend is pretty meaningless (and more?)