From 854ef5beb6212ffa49bc81b8c61c9724aa913c4b Mon Sep 17 00:00:00 2001
From: Arvind Kandpal <arvind.kandpal@ksolves.com>
Date: Wed, 28 Oct 2026 13:38:26 +0530
Subject: [PATCH v2] doc: Mention that * does not include system columns

Update the SELECT reference page to say that * and table_name.* in
the output list do not include system columns, which must be listed
by name, and link to the System Columns section.

Discussion: https://postgr.es/m/178782026936.2606573.10270614257871556098@wrigleys.postgresql.org
---
 doc/src/sgml/ref/select.sgml | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml
index 18392f7caec..d1964463da6 100644
--- a/doc/src/sgml/ref/select.sgml
+++ b/doc/src/sgml/ref/select.sgml
@@ -1158,6 +1158,9 @@ EXCLUDE NO OTHERS
     shorthand for the columns coming from just that table.  In these
     cases it is not possible to specify new names with <literal>AS</literal>;
     the output column names will be the same as the table columns' names.
+    Neither form includes system columns; they must be listed by name,
+    as in <literal>SELECT ctid, * FROM t</literal>.  (See <xref
+    linkend="ddl-system-columns"/>.)
    </para>
 
    <para>
-- 
2.43.0