From 3f134ce7001b8d526b0bb0b8362a24d0966bb732 Mon Sep 17 00:00:00 2001 From: Michael Paquier Date: Thu, 21 Aug 2025 13:25:58 +0900 Subject: [PATCH] doc: Improve description of wal_compression The description of this GUC provides a list of the situations where full-page writes are generated. However, it is not completely exact, mentioning only the cases where full_page_writes=on or base backups. It is possible to generate full-page writes in more situations than these two, making the description confusing as it implies that no other cases exist. The description is slightly reworded to take into account that other cases are possible, without mentioning them directly to minimize the maintenance burden should FPWs be generated in more contexts in the future. Author: Jingtang Zhang Reviewed-by: Andrey Borodin Reviewed-by: Xuneng Zhou Discussion: https://postgr.es/m/CAPsk3_CtAYa_fy4p6=x7qtoutrdKvg1kGk46D5fsE=sMt2546g@mail.gmail.com Backpatch-through: 13 --- doc/src/sgml/config.sgml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index a77b6b43fb0..76078335438 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -2981,8 +2981,9 @@ include_dir 'conf.d' When this parameter is on, the PostgreSQL - server compresses a full page image written to WAL when - is on or during a base backup. + server compresses a full page image written to WAL (e.g. when + is on, during a base backup, + etc.). A compressed page image will be decompressed during WAL replay. The default value is off. Only superusers can change this setting. -- 2.47.3