From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | Hamid Akhtar <hamid(dot)akhtar(at)gmail(dot)com> |
Cc: | PostgreSQL Hackers <pgsql-hackers(at)lists(dot)postgresql(dot)org> |
Subject: | Re: Improving psql slash usage help message |
Date: | 2020-04-25 20:03:30 |
Message-ID: | CAKFQuwac8=p_MQg74sHUecyLHqB0u2+Sf7g1J2qDuob+dBrKOQ@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Sat, Apr 25, 2020 at 12:29 PM Hamid Akhtar <hamid(dot)akhtar(at)gmail(dot)com>
wrote:
>
> "\dE" displays the list with a "List of relations" heading whereas "\det"
> displays "List of foreign tables". So, to differentiate the two, I suggest
> to change the help message for "\dE" to:
>
> \dE[S+] [PATTERN] list foreign relations
>
> One could argue that both essentially mean the same thing, however,
> considering "\dE+" also outputs size, it makes sense IMHO to make this
> change (as PG documentation: relation is essentially a mathematical term
> for table). Attached is the patch that makes this change.
>
help.c and the documentation need to be synchronized a bit more than this
single issue.
Calling it "foreign relation" for \dE and "foreign table" for \det does
convey that there is a difference - not sure it a huge improvement though.
The "\d[Eimstv]" family of meta-commands should, in the help, probably be
moved together to show the fact that they are basically "list relation
names [of this type only]" while "\det" is "list foreign table info".
David J.
From | Date | Subject | |
---|---|---|---|
Next Message | David Rowley | 2020-04-25 21:41:39 | Re: Binary search in ScalarArrayOpExpr for OR'd constant arrays |
Previous Message | Hamid Akhtar | 2020-04-25 19:29:11 | Improving psql slash usage help message |