From: Peter Geoghegan <pg@bowt.ie>
Date: Tue, 11 Apr 2023 00:55:23 +0000 (-0700)
Subject: Clarify nbtree posting list update desc issue.
X-Git-Url: http://git.postgresql.org/gitweb/?a=commitdiff_plain;h=26e65ebdb295fc88988655dbbf30c9fd020e2e07;p=postgresql-pgindent.git

Clarify nbtree posting list update desc issue.

Per complaint from Melanie Plageman.

Follow-up to commit 5d6728e5.

Reported-By: Melanie Plageman <melanieplageman@gmail.com>
Discussion: https://postgr.es/m/20230411002315.oyaicmcqrq2hb3ek@liskov
---

diff --git a/src/backend/access/rmgrdesc/nbtdesc.c b/src/backend/access/rmgrdesc/nbtdesc.c
index 0db3274dc5..c50d5547de 100644
--- a/src/backend/access/rmgrdesc/nbtdesc.c
+++ b/src/backend/access/rmgrdesc/nbtdesc.c
@@ -223,6 +223,11 @@ delvacuum_desc(StringInfo buf, char *block_data,
 		Assert(OffsetNumberIsValid(off));
 		Assert(updates->ndeletedtids > 0);
 
+		/*
+		 * "ptid" is the symbol name used when building each xl_btree_update's
+		 * array of offsets into a posting list tuple's ItemPointerData array.
+		 * xl_btree_update describes a subset of the existing TIDs to delete.
+		 */
 		appendStringInfo(buf, "{ off: %u, nptids: %u, ptids: [",
 						 off, updates->ndeletedtids);
 		for (int p = 0; p < updates->ndeletedtids; p++)