Horton

Thread

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.

  1. Minor documentation fixes related to v18

    Fujii Masao <masao.fujii@oss.nttdata.com> — 2025-06-19T10:34:41Z

    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.

Regards,

-- 
Fujii Masao
NTT DATA Japan Corporation

  2. Re: Minor documentation fixes related to v18

    Fujii Masao <masao.fujii@oss.nttdata.com> — 2025-06-24T15:28:56Z

    
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

  3. Re: Minor documentation fixes related to v18

    Fujii Masao <masao.fujii@oss.nttdata.com> — 2025-06-25T00:06:35Z

    
On 2025/06/25 0:28, Fujii Masao wrote:
> 
> 
> 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.

Pushed.

Regards,

-- 
Fujii Masao
NTT DATA Japan Corporation