Add comments explaining overflow entries in the replication lag tracker.
authorFujii Masao <fujii@postgresql.org>
Thu, 23 Oct 2025 04:24:56 +0000 (13:24 +0900)
committerFujii Masao <fujii@postgresql.org>
Thu, 23 Oct 2025 04:24:56 +0000 (13:24 +0900)
commitabc2b71383b4c49c2fbda74c281d50f3936551b8
treeae755af10e5315bdfbd151ebf8e7f6c21eeb465b
parent20628b62e46e3a2e66c3bb9396720077c7c47018
Add comments explaining overflow entries in the replication lag tracker.

Commit 883a95646a8 introduced overflow entries in the replication lag tracker
to fix an issue where lag columns in pg_stat_replication could stall when
the replay LSN stopped advancing.

This commit adds comments clarifying the purpose and behavior of overflow
entries to improve code readability and understanding.

Since commit 883a95646a8 was recently applied and backpatched to all
supported branches, this follow-up commit is also backpatched accordingly.

Author: Xuneng Zhou <xunengzhou@gmail.com>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CABPTF7VxqQA_DePxyZ7Y8V+ErYyXkmwJ1P6NC+YC+cvxMipWKw@mail.gmail.com
Backpatch-through: 13
src/backend/replication/walsender.c