Re: MySQL-ism help patch for psql - Mailing list pgsql-hackers

From Robert Haas
Subject Re: MySQL-ism help patch for psql
Date
Msg-id 603c8f071001251019y617fdf4na8c083a2525e8448@mail.gmail.com
Whole thread Raw
In response to Re: MySQL-ism help patch for psql  (Baron Schwartz <baron@xaprb.com>)
List pgsql-hackers
On Mon, Jan 25, 2010 at 1:05 PM, Baron Schwartz <baron@xaprb.com> wrote:
> Hi Robert,
>
> On Mon, Jan 25, 2010 at 11:41 AM, Robert Haas <robertmhaas@gmail.com> wrote:
>> Maybe instead of (or in addition to) providing MySQL-specific help, we
>> should find a way to emphasize the "\d" and "\d table" commands,
>
> Right, it's like "cd" and "ls" at the shell prompt.  It's like walking
> into a dark room and not knowing where the light switch is.  I'll
> think of more metaphors later.
>
> What if the text you see upon starting psql says something like "Type
> \dt to ... type \h for more help" ?

Well, we used to display this banner when psql started up:

Welcome to psql 8.3.8, the PostgreSQL interactive terminal.

Type:  \copyright for distribution terms      \h for help with SQL commands      \? for help with psql commands      \g
orterminate with semicolon to execute query      \q to quit 

But it got changed, so now it just tells you to type help and if you
do then you get that banner.  But maybe that's OK.  Since the banner
isn't being printed on every startup, it might be OK for it to be a
bit longer, like, I dunno:

Type:  \copyright for distribution terms      \h for help with SQL commands      \d for a list of tables, views, and
sequencesin the current database      \d name for more details on the named table, view, index, or sequence      \? for
furtherhelp with psql commands      \g or terminate with semicolon to execute query      \q to quit 

That might be just enough of a push to get people pointed in the right
direction.

...Robert


pgsql-hackers by date:

Previous
From: Michael Meskes
Date:
Subject: Re: ECPG patch 4.1, out-of-scope cursor support in native mode
Next
From: Tom Lane
Date:
Subject: Re: Largeobject Access Controls (r2460)