doc: Improve description of wal_compression
authorMichael Paquier <michael@paquier.xyz>
Thu, 21 Aug 2025 04:25:50 +0000 (13:25 +0900)
committerMichael Paquier <michael@paquier.xyz>
Thu, 21 Aug 2025 04:25:50 +0000 (13:25 +0900)
commit859444465f7404a652cc28b1a4d74563d8707e56
tree9f81ac4eb8d7aa0aff77517e3ee121cc2188eb7d
parent906b68217a1e756a49acd0864773680d1eb8a10d
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 <mrdrivingduck@gmail.com>
Reviewed-by: Andrey Borodin <x4mmm@yandex-team.ru>
Reviewed-by: Xuneng Zhou <xunengzhou@gmail.com>
Discussion: https://postgr.es/m/CAPsk3_CtAYa_fy4p6=x7qtoutrdKvg1kGk46D5fsE=sMt2546g@mail.gmail.com
Backpatch-through: 13
doc/src/sgml/config.sgml