Re: [PATCH] Document wal_compression=on

Christoph Berg <myon@debian.org>

From: Christoph Berg <myon@debian.org>
To: John Naylor <johncnaylorls@gmail.com>
Cc: PostgreSQL-development <pgsql-hackers@postgresql.org>, Michael Paquier <michael@paquier.xyz>
Date: 2026-06-29T14:16:04Z
Lists: pgsql-hackers
Re: John Naylor
> +        The value <literal>on</literal> is a deprecated alias for
> <literal>pglz</literal>.
> 
> "deprecated" implies we may remove it someday. I don't think we'd gain
> from doing that, but we could instead call 'on' a "historical
> spelling" of 'pglz'.

Or perhaps leave the door open for picking a better default in the future?

     The value <literal>on</literal> is currently an alias for <literal>pglz</literal>.

(I would be fine with either of the 3 variants.)

Maybe we should also update the postgresql.conf.sample:

 #wal_compression = off                  # enables compression of full-page writes;
-                                        # off, pglz, lz4, zstd, or on
+                                        # off, pglz (or on), lz4, or zstd

(Or just delete it there.)

Christoph



Commits

  1. Document wal_compression=on