Re: Minor Improvements to pg_buffercache documentation

From: Michael Paquier <michael(at)paquier(dot)xyz>
To: Fujii Masao <masao(dot)fujii(at)oss(dot)nttdata(dot)com>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Minor Improvements to pg_buffercache documentation
Date: 2025-07-22 05:10:32
Message-ID: aH8dSGJ_csT2XXAf@paquier.xyz
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Jul 03, 2025 at 01:30:13AM +0900, Fujii Masao wrote:
> 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>

That would be smarter than the current statu-quo of the page,
especially if this page grows more in size in the future.

The other inconsistencies are good catches, by the way!
--
Michael

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Laurenz Albe 2025-07-22 09:02:24 Re: Description of disallowed characters in quoted identifiers is incomplete
Previous Message PG Doc comments form 2025-07-21 19:58:22 Description of disallowed characters in quoted identifiers is incomplete