From e3838bb8a10f45ba7ff12af495317620d2a555ae Mon Sep 17 00:00:00 2001
From: Arvind Kandpal <arvind.kandpal@ksolves.com>
Date: Tue, 3 Nov 2026 11:19:42 +0530
Subject: [PATCH v3] doc: Mention that * does not include system columns

In the SELECT reference page, say in the description of * in the
output list that it does not include system columns, 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, 2 insertions(+), 1 deletion(-)

diff --git a/doc/src/sgml/ref/select.sgml b/doc/src/sgml/ref/select.sgml
index 18392f7caec..9f3580ce49c 100644
--- a/doc/src/sgml/ref/select.sgml
+++ b/doc/src/sgml/ref/select.sgml
@@ -1153,7 +1153,8 @@ EXCLUDE NO OTHERS
    <para>
     Instead of an expression, <literal>*</literal> can be written in
     the output list as a shorthand for all the columns of the selected
-    rows.  Also, you can write <literal><replaceable
+    rows, not including system columns (see <xref
+    linkend="ddl-system-columns"/>).  Also, you can write <literal><replaceable
     class="parameter">table_name</replaceable>.*</literal> as a
     shorthand for the columns coming from just that table.  In these
     cases it is not possible to specify new names with <literal>AS</literal>;
-- 
2.43.0