Document that WAIT FOR LSN is timeline-blind

Alexander Korotkov <akorotkov@postgresql.org>

Commit: 21d290161b11adc92a49da8e71fda69c20032618
Author: Alexander Korotkov <akorotkov@postgresql.org>
Date: 2026-05-03T13:22:02Z
Document that WAIT FOR LSN is timeline-blind

WAIT FOR LSN compares only the numeric LSN and has no notion of which
timeline a WAL record belongs to.  There are many possible scenarios when
timeline-switching can break read-your-writes consistency.  The proper
analysis and timeline support is possible in the next major release.  Yet
just document the current behaviour.

Reported-by: Xuneng Zhou <xunengzhou@gmail.com>
Author: Alexander Korotkov <aekorotkov@gmail.com>

Files

PathChange+/−
doc/src/sgml/ref/wait_for.sgml modified +14 −0