Re: pg_checksums docs mentioning online functions

From: Daniel Gustafsson <daniel(at)yesql(dot)se>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: PostgreSQL-documentation <pgsql-docs(at)lists(dot)postgresql(dot)org>
Subject: Re: pg_checksums docs mentioning online functions
Date: 2026-06-04 19:18:34
Message-ID: 3E59EA84-E150-468A-A316-FC99A009D235@yesql.se
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: pgsql-docs

> On 4 Jun 2026, at 20:55, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
>
> Looking at the pg_checksums docs, it says:
>
> pg_checksums checks, enables or disables data checksums in a
> PostgreSQL cluster. The server must be shut down cleanly before
> running pg_checksums.
>
> 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="checksums"/>.
+ </para>
</refsect1>

--
Daniel Gustafsson

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2026-06-04 20:12:26 Re: pg_checksums docs mentioning online functions
Previous Message Bruce Momjian 2026-06-04 18:55:33 pg_checksums docs mentioning online functions