Content-Type: text/plain;
	charset=us-ascii
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3776.700.51.11.12\))
Subject: Re: pg_checksums docs mentioning online functions
From: Daniel Gustafsson <daniel@yesql.se>
In-Reply-To: <aiHKJWa1k28fFTqf@momjian.us>
Date: Thu, 4 Jun 2026 21:18:34 +0200
Cc: PostgreSQL-documentation <pgsql-docs@lists.postgresql.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <3E59EA84-E150-468A-A316-FC99A009D235@yesql.se>
References: <aiHKJWa1k28fFTqf@momjian.us>
To: Bruce Momjian <bruce@momjian.us>
Archived-At: 
 <https://www.postgresql.org/message-id/3E59EA84-E150-468A-A316-FC99A009D235%40yesql.se>
Precedence: bulk

> On 4 Jun 2026, at 20:55, Bruce Momjian <bruce@momjian.us> wrote:
>=20
> Looking at the pg_checksums docs, it says:
>=20
> pg_checksums checks, enables or disables data checksums in a
> PostgreSQL cluster. The server must be shut down cleanly before
> running pg_checksums.
>=20
> Do we want to mention the new functions here that can change the
> checksum status without being shut down?

Not sure, but perhaps a link back to the main data checksums section =
(which
documents the online operation among other things) would be in order?
Something like:

--- a/doc/src/sgml/ref/pg_checksums.sgml
+++ b/doc/src/sgml/ref/pg_checksums.sgml
@@ -57,6 +57,10 @@ PostgreSQL documentation
    rewritten in-place.
    Disabling checksums only updates the file =
<filename>pg_control</filename>.
   </para>
+
+  <para>
+   For more information on data checksums, see <xref =
linkend=3D"checksums"/>.
+  </para>
  </refsect1>

--
Daniel Gustafsson