pg.ddx.io  pgsql-committers@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Fujii Masao <fujii@postgresql.org>
To: pgsql-committers@lists.postgresql.org
Subject: pgsql: doc: Clarify that \d and \d+ output lists are illustrative, not
Date: Mon, 26 Jan 2026 11:46:25 +0000
Message-ID: <E1vkL32-002kFc-2b@gemulon.postgresql.org> (raw)

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 <smithpb2250@gmail.com>
Reviewed-by: Chao Li <li.evan.chao@gmail.com>
Reviewed-by: Andreas Karlsson <andreas@proxel.se>
Reviewed-by: Fujii Masao <masao.fujii@gmail.com>
Discussion: https://postgr.es/m/CAHut+Pt1DBtaUqfJftkkaQLJJJenYJBtb6Ec6s6vu82KEMh46A@mail.gmail.com

Branch
------
master

Details
-------
https://git.postgresql.org/pg/commitdiff/33a92632b78603271f76b446d23379d44ebc1450

Modified Files
--------------
doc/src/sgml/ref/psql-ref.sgml | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)



Message-ID: <E1vkL32-002kFc-2b@gemulon.postgresql.org>
Permalink:  ../E1vkL32-002kFc-2b@gemulon.postgresql.org/
Also on:    postgresql.org/message-id/E1vkL32-002kFc-2b@gemulon.postgresql.org

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-committers@postgresql.org
  Cc: fujii@postgresql.org, pgsql-committers@lists.postgresql.org
  Subject: Re: pgsql: doc: Clarify that \d and \d+ output lists are illustrative, not
  In-Reply-To: <E1vkL32-002kFc-2b@gemulon.postgresql.org>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox