pgsql: doc: Clarify that \d and \d+ output lists are illustrative, not - Mailing list pgsql-committers

From Fujii Masao
Subject pgsql: doc: Clarify that \d and \d+ output lists are illustrative, not
Date
Msg-id E1vkL32-002kFc-2b@gemulon.postgresql.org
Whole thread Raw
List pgsql-committers
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(-)


pgsql-committers by date:

Previous
From: David Rowley
Date:
Subject: pgsql: Fix possible issue of a WindowFunc being in the wrong WindowClau
Next
From: Peter Eisentraut
Date:
Subject: pgsql: Fix accidentally cast away qualifiers