From 33a92632b78603271f76b446d23379d44ebc1450 Mon Sep 17 00:00:00 2001 From: Fujii Masao Date: Mon, 26 Jan 2026 20:45:05 +0900 Subject: [PATCH] doc: Clarify that \d and \d+ output lists are illustrative, not exhaustive. The psql documentation for the \d and \d+ meta-commands lists objects that may be shown, but previously the wording could be read as exhaustive even though additional objects can also appear in the output. This commit clarifies the description by adding phrasing such as "for example" or "such as", making it clear that the listed objects are illustrative rather than a complete list. While the change is small, it helps avoid potential user confusion. As this is a documentation clarification rather than a bug fix, it is not backpatched. Author: Peter Smith Reviewed-by: Chao Li Reviewed-by: Andreas Karlsson Reviewed-by: Fujii Masao Discussion: https://postgr.es/m/CAHut+Pt1DBtaUqfJftkkaQLJJJenYJBtb6Ec6s6vu82KEMh46A@mail.gmail.com --- doc/src/sgml/ref/psql-ref.sgml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/doc/src/sgml/ref/psql-ref.sgml b/doc/src/sgml/ref/psql-ref.sgml index f56c70263e0..e464e3b13de 100644 --- a/doc/src/sgml/ref/psql-ref.sgml +++ b/doc/src/sgml/ref/psql-ref.sgml @@ -1299,9 +1299,9 @@ SELECT $1 \parse stmt1 pattern, show all columns, their types, the tablespace (if not the default) and any special attributes such as NOT NULL or defaults. - Associated indexes, constraints, rules, and triggers are - also shown. For foreign tables, the associated foreign - server is shown as well. + Associated objects, such as indexes, constraints, rules, triggers, + and publications, are also shown. For foreign tables, + the associated foreign server is shown as well. (Matching the pattern is defined in below.) @@ -1314,8 +1314,8 @@ SELECT $1 \parse stmt1 The command form \d+ is identical, except that - more information is displayed: any comments associated with the - columns of the table are shown, as is the presence of OIDs in the + more information is displayed: for example, any comments associated + with the columns of the table, the presence of OIDs in the table, the view definition if the relation is a view, a non-default replica identity setting and the