Re: Improving psql slash usage help message

Поиск
Список
Период
Сортировка
От Hamid Akhtar
Тема Re: Improving psql slash usage help message
Дата
Msg-id CANugjhup00ijsZ-UPFrqYkNsaPU5xeC9agDabAs6REY2h6-xdA@mail.gmail.com
обсуждение исходный текст
Ответ на Re: Improving psql slash usage help message  ("David G. Johnston" <david.g.johnston@gmail.com>)
Ответы Re: Improving psql slash usage help message
Re: Improving psql slash usage help message
Список pgsql-hackers


On Sun, Apr 26, 2020 at 1:03 AM David G. Johnston <david.g.johnston@gmail.com> wrote:
On Sat, Apr 25, 2020 at 12:29 PM Hamid Akhtar <hamid.akhtar@gmail.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".

I think from a user perspective, grouping these wouldn't be helpful. For example, it may cause FDW related commands to be spread through out the help. Currently, those are nicely grouped together, which makes life relatively easy IMO.
 

David J.



--
Highgo Software (Canada/China/Pakistan)
URL : www.highgo.ca
ADDR: 10318 WHALLEY BLVD, Surrey, BC
CELL:+923335449950  EMAIL: mailto:hamid.akhtar@highgo.ca
SKYPE: engineeredvirus

В списке pgsql-hackers по дате отправления:

Предыдущее
От: Michael Paquier
Дата:
Сообщение: Re: Fix compilation failure against LLVM 11
Следующее
От: Julien Rouhaud
Дата:
Сообщение: Re: WAL usage calculation patch