Doc: update pg_list.h header comments to include XidLists.

I realize that the XidList infrastructure is rather incomplete,
but failing to mention it in adjacent comments takes that a bit
too far.

diff --git a/src/include/nodes/pg_list.h b/src/include/nodes/pg_list.h
index dc991626ba0726ab2a298d32920a77f54fad8286..57eb8458dcf9a7b69a07db9696e564fe90e3327a 100644 (file)
--- a/src/include/nodes/pg_list.h
+++ b/src/include/nodes/pg_list.h
@@ -15,16 +15,18 @@
  * Non-empty lists have a header, which will not be relocated as long as the
  * list remains non-empty, and an expansible data array.
  *
- * We support three types of lists:
+ * We support four types of lists:
  *
  * T_List: lists of pointers
  *     (in practice usually pointers to Nodes, but not always;
  *     declared as "void *" to minimize casting annoyances)
  * T_IntList: lists of integers
  * T_OidList: lists of Oids
+ * T_XidList: lists of TransactionIds
+ *     (the XidList infrastructure is less complete than the other cases)
  *
- * (At the moment, ints and Oids are the same size, but they may not
- * always be so; try to be careful to maintain the distinction.)
+ * (At the moment, ints, Oids, and XIDs are the same size, but they may not
+ * always be so; be careful to use the appropriate list type for your data.)
  *
  *
  * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
@@ -50,7 +52,7 @@ typedef union ListCell
 
 typedef struct List
 {
-   NodeTag     type;           /* T_List, T_IntList, or T_OidList */
+   NodeTag     type;           /* T_List, T_IntList, T_OidList, or T_XidList */
    int         length;         /* number of elements currently present */
    int         max_length;     /* allocated length of elements[] */
    ListCell   *elements;       /* re-allocatable array of cells */