Minor Improvements to pg_buffercache documentation
Fujii Masao <masao.fujii@oss.nttdata.com>
From: Fujii Masao <masao.fujii@oss.nttdata.com>
To: pgsql-docs@lists.postgresql.org
Date: 2025-07-02T16:30:13Z
Lists: pgsql-docs
Attachments
- v1-0001-doc-Add-missing-index-entries-and-fix-title-forma.patch (text/plain) patch v1-0001
Hi,
While reading commit 8eede2c7200 and the pg_buffercache docs,
I noticed a few minor issues:
- There are missing index entries for pg_buffercache_numa() and
pg_buffercache_usage_counts(), even though other functions have them.
- The section titles for pg_buffercache_evict_relation and
pg_buffercache_evict_all are missing parentheses, unlike the others.
The attached patch addresses these points by:
- Adding index entries for pg_buffercache_numa() and
pg_buffercache_usage_counts().
- Making the function section titles consistent by including parentheses
where they were missing.
Also, a quick note on pg_buffercache_numa_pages(): although there's
an index entry for pg_buffercache_pages(), I didn't add one for
pg_buffercache_numa_pages() because both functions are typically accessed
via views, not directly. Regarding those functions, it seems enough to
have index entries for the views. So, it might make more sense to remove
the existing index entry for pg_buffercache_pages() for consistency.
BTW, all current index entries point to the top of the pg_buffercache
docs. Would it be better if each entry pointed directly to its relevant
section using a zone attribute like this?
- <indexterm>
+ <indexterm zone="pgbuffercache-summary">
<primary>pg_buffercache_summary</primary>
</indexterm>
Thought?
Regards,
--
Fujii Masao
NTT DATA Japan Corporation
Commits
-
doc: Add missing index entries and fix title formatting in pg_buffercache docs.
- a8acfb133cf9 18.0 landed
- 086b9a33aafe 19 (unreleased) landed
-
doc: pg_buffercache documentation wordsmithing
- 8eede2c7200f 19 (unreleased) cited