Re: Minor documentation fixes related to v18

Fujii Masao <masao.fujii@oss.nttdata.com>

From: Fujii Masao <masao.fujii@oss.nttdata.com>
To: pgsql-docs@lists.postgresql.org
Date: 2025-06-24T15:28:56Z
Lists: pgsql-docs

On 2025/06/19 19:34, Fujii Masao wrote:
> Hi,
> 
> I'd like to propose three minor documentation fixes related to parameters
> introduced in v18. Since they align with new content in that version,
> I'm thinking to apply them to v18. Thoughts?
> 
> 0001:
> For parameters that exist as both configuration and storage options,
> the documentation usually includes secondary index entries to help users
> find them easily. However, such entries were missing for vacuum_truncate
> and vacuum_max_eager_freeze_failure_rate. This patch adds the appropriate
> index terms.
> 
> 0002:
> The description of track_cost_delay_timing lists where cost-based vacuum
> delay timing information is shown when the setting is enabled. Although
> this information also appears in ANALYZE VERBOSE output, that wasn't
> mentioned. This patch adds it to the list.
> 
> 0003:
> The io_workers parameter was documented with the type "int", but
> the standard format in our docs is "integer". This patch updates it
> for consistency with other GUC parameter descriptions.

These patches are straightforward fixes. Unless there are any objections,
I'll go ahead and commit them.

Regards,

-- 
Fujii Masao
NTT DATA Japan Corporation




Commits

  1. doc: Fix type description of io_workers GUC for consistency.

  2. doc: Mention ANALYZE VERBOSE in track_cost_delay_timing description.

  3. doc: Add secondary index entries for vacuum-related parameters.