proposal: psql –help reflecting service or URI usage

[Paul Förster]

Hi,

I'd like to propose a patch to psql --help output:

Currently it is:

Usage:
  psql [OPTION]... [DBNAME [USERNAME]]

...

Connection options:
  -h, --host=HOSTNAME      database server host or socket directory (default: 
"local socket")
  -p, --port=PORT          database server port (default: "5432")
  -U, --username=USERNAME  database user name (default: "paul")
  -w, --no-password        never prompt for password
  -W, --password           force password prompt (should happen automatically)

I'd like to change it to the following to reflect the psql ability to process a 
service name or a PostgreSQL URI:

Usage:
  psql [OPTION]... [DBNAME [USERNAME]|service|uri]

...

Connection options:
  -h, --host=HOSTNAME      database server host or socket directory (default: 
"local socket")
  -p, --port=PORT          database server port (default: "5432")
  -U, --username=USERNAME  database user name (default: "paul")
  -w, --no-password        never prompt for password
  -W, --password           force password prompt (should happen automatically)
  service=name             service name as definited in pg_service.conf
  uri                      connection URI (postgresql://...)

...

Attached is a patch for src/bin/psql/help.c for this. The file 
doc/src/sgml/ref/psql-ref.sgml does not seem to need any changes for this.

Any thoughts on this?

psql-help.c.patch
Description: Binary data

Cheers,
Paul