From: Fujii Masao <fujii@postgresql.org>
Date: Fri, 7 Nov 2025 05:43:24 +0000 (+0900)
Subject: doc: Clarify units for io_combine_limit and io_max_combine_limit.
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b841c91c7b552fee2a0e1a665d7c5e2f28f0e078;p=thirdparty%2Fpostgresql.git

doc: Clarify units for io_combine_limit and io_max_combine_limit.

If these parameters are set without units, the values are interpreted
as blocks. This detail was previously missing from the documentation,
so this commit adds it.

Backpatch to v17 where io_combine_limit was added.

Author: Karina Litskevich <litskevichkarina@gmail.com>
Reviewed-by: Chao Li <lic@highgo.com>
Reviewed-by: Xuneng Zhou <xunengzhou@gmail.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CACiT8iZCDkz1bNYQNQyvGhXWJExSnJULRTYT894u4-Ti7Yh6jw@mail.gmail.com
Backpatch-through: 17
---

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 32ee79e0fa7..0958a89d913 100644
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -2724,6 +2724,8 @@ include_dir 'conf.d'
        <listitem>
         <para>
          Controls the largest I/O size in operations that combine I/O.
+         If this value is specified without units, it is taken as blocks,
+         that is <symbol>BLCKSZ</symbol> bytes, typically 8kB.
          The default is 128kB.
         </para>
        </listitem>