On Thu, Sep 17, 2026 at 10:53 PM Sami Imseih <[email protected]> wrote: > > > > Done in v6. > > > > Xuneng, Sami, do you think v6 is good enough? > > I think the user-facing documentation can be simplified considerably while > preserving the important information. I prefer the below changes on top > of v6: > > 1/ State directly that WAIT cannot be executed while the current transaction > holds a snapshot. > 2/ Clarify that WAIT itself does not acquire a snapshot. > 3/ Explain that it can therefore be executed before the first snapshot-taking > statement in a REPEATABLE READ or SERIALIZABLE transaction. > 4/ Briefly explain why holding a snapshot can prevent a standby wait from > completing. >
Yeah, I think we can simplify and consolidate them. I proposed a reorganization earlier but it did not do simplification [1]. The underlying motivation for those constraints stay the same -- to avoid deadlock/hang while waiting. So I would prefer a small opening para for consolidation. As for simplification, personally, I am OK with a detailed explanation because it helps curious users to learn with the cost of loading some extra bytes. However, the length of the note part does seem disproportional to that of usage of this command. [1] https://www.postgresql.org/message-id/cabptf7umsuo5hwfbz+wcjqtafsfmwadbyronhwttg5rq56j...@mail.gmail.com -- Regards, Xuneng Zhou HighGo Software Co., Ltd.
