Fix GiST README's explanation of the NSN cross-check.
authorHeikki Linnakangas <heikki.linnakangas@iki.fi>
Tue, 19 Sep 2023 08:53:51 +0000 (11:53 +0300)
committerHeikki Linnakangas <heikki.linnakangas@iki.fi>
Tue, 19 Sep 2023 08:53:51 +0000 (11:53 +0300)
The text got the condition backwards, it's "NSN > LSN", not "NSN < LSN".
While we're at it, expand it a little for clarity.

Reviewed-by: Daniel Gustafsson
Discussion: https://www.postgresql.org/message-id/4cb46e18-e688-524a-0f73-b1f03ed5d6ee@iki.fi

src/backend/access/gist/README

index efb2730e181488b041cc786181a8e43bbe5f039f..8015ff19f05bc04748cb4205b677bac5ac42fab6 100644 (file)
@@ -271,10 +271,10 @@ should be visited too. When split inserts the downlink to the parent, it
 clears the F_FOLLOW_RIGHT flag in the child, and sets the NSN field in the
 child page header to match the LSN of the insertion on the parent. If the
 F_FOLLOW_RIGHT flag is not set, a scan compares the NSN on the child and the
-LSN it saw in the parent. If NSN < LSN, the scan looked at the parent page
-before the downlink was inserted, so it should follow the rightlink. Otherwise
-the scan saw the downlink in the parent page, and will/did follow that as
-usual.
+LSN it saw in the parent. If the child's NSN is greater than the LSN seen on
+the parent, the scan looked at the parent page before the downlink was
+inserted, so it should follow the rightlink. Otherwise the scan saw the
+downlink in the parent page, and will/did follow that as usual.
 
 A scan can't normally see a page with the F_FOLLOW_RIGHT flag set, because
 a page split keeps the child pages locked until the downlink has been inserted