Horton

Re: doc: Improve description of io_combine_limit and io_max_combine_limit GUCs

Karina Litskevich <litskevichkarina@gmail.com>

View thread View on postgr.es
From: Karina Litskevich <litskevichkarina@gmail.com>
To: Fujii Masao <masao.fujii@gmail.com>
Cc: Chao Li <li.evan.chao@gmail.com>, Postgres hackers <pgsql-hackers@lists.postgresql.org>
Date: 2025-10-31T14:45:07Z
Lists: pgsql-hackers 
On Thu, Oct 30, 2025 at 4:31 PM Fujii Masao <masao.fujii@gmail.com> wrote:
>
> I also noticed another issue in the io_max_combine_limit docs.
> Since its context is PGC_POSTMASTER, shouldn't the following
> description be updated to say "This parameter can only be set at server start"?
>
>          This parameter can only be set in
>          the <filename>postgresql.conf</filename> file or on the server
>          command line.
>

Nice catch! I am going to check if there are other GUCs with
PGC_POSTMASTER and wrong documentation. I'll come back with an
updated version of the patch.

Best regards,
Karina Litskevich
Postgres Professional: http://postgrespro.com/

Commits

  1. doc: Fix descriptions of some PGC_POSTMASTER parameters.

  2. doc: Clarify units for io_combine_limit and io_max_combine_limit.