From 5482ed74d2468a15e2183effc796364584986750 Mon Sep 17 00:00:00 2001
From: Daniel Gustafsson <dgustafsson@postgresql.org>
Date: Sat, 5 Sep 2026 20:42:18 +0200
Subject: [PATCH v1 3/5] doc: Documentation fixups for online checksums

The documentation for the checksums progress reporting had accidentally
omitted the work "fork" and for th blocks_* columns.  The values are per
fork but the documentation made it seem they were per relation.

Found by Noah using AI assisted review with GPT.  Backpatch to v19
where the online checksums feature was introduced.

Reported-by: Noah Misch <noah@leadboat.com>
Discussion: https://postgr.es/m/...
Backpatch-through: 19
---
 doc/src/sgml/func/func-admin.sgml | 4 +++-
 doc/src/sgml/monitoring.sgml      | 4 ++--
 2 files changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/src/sgml/func/func-admin.sgml b/doc/src/sgml/func/func-admin.sgml
index 16e62a93acb..7cf3a88b03f 100644
--- a/doc/src/sgml/func/func-admin.sgml
+++ b/doc/src/sgml/func/func-admin.sgml
@@ -3159,7 +3159,7 @@ SELECT convert_from(pg_read_binary_file('file_in_utf8.txt'), 'UTF8');
         <indexterm>
          <primary>pg_enable_data_checksums</primary>
         </indexterm>
-        <function>pg_enable_data_checksums</function> ( <optional><parameter>cost_delay</parameter> <type>int</type>, <parameter>cost_limit</parameter> <type>int</type></optional> )
+        <function>pg_enable_data_checksums</function> ( <optional><parameter>cost_delay</parameter> <type>int</type> <optional>, <parameter>cost_limit</parameter> <type>int</type></optional></optional> )
         <returnvalue>void</returnvalue>
        </para>
        <para>
@@ -3175,6 +3175,8 @@ SELECT convert_from(pg_read_binary_file('file_in_utf8.txt'), 'UTF8');
         If <parameter>cost_delay</parameter> and <parameter>cost_limit</parameter> are
         specified, the process is throttled using the same principles as
         <link linkend="runtime-config-resource-vacuum-cost">Cost-based Vacuum Delay</link>.
+        <parameter>cost_delay</paraneter> defaults to 0,
+        <parameter>cost_limit</parameter> defaults to 100.
        </para>
        <para>
         This function is restricted to superusers.
diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml
index b403fb990a7..4d46327a102 100644
--- a/doc/src/sgml/monitoring.sgml
+++ b/doc/src/sgml/monitoring.sgml
@@ -8320,7 +8320,7 @@ FROM pg_stat_get_backend_idset() AS backendid;
         <structfield>blocks_total</structfield> <type>bigint</type>
        </para>
        <para>
-        The number of blocks in the current relation which will be processed,
+        The number of blocks in the current relation fork which will be processed,
         or <literal>NULL</literal> if the worker process hasn't
         calculated the number of blocks yet. The launcher process has
         this set to <literal>NULL</literal>.
@@ -8334,7 +8334,7 @@ FROM pg_stat_get_backend_idset() AS backendid;
         <structfield>blocks_done</structfield> <type>bigint</type>
        </para>
        <para>
-        The number of blocks in the current relation which have been processed.
+        The number of blocks in the current relation fork which have been processed.
         The launcher process has this set to <literal>NULL</literal>.
        </para>
       </entry>
-- 
2.39.3 (Apple Git-146)