I suggest to alter the
pg_restore --help output from
-----------------------------------------
Usage:
pg_restore [OPTION]... [FILE]
General options:
-d, --dbname=NAME output database name
-f, --file=FILENAME output file name
-----------------------------------------------
to:
----------------------------------------------
Usage:
pg_restore [OPTION]... [FILE]
General options:
-d, --dbname=NAME output database name (to restore into a psql
database)
-f, --file=FILENAME output file name (to convert custom/tar to
plain SQL)
-F, --format=c|t specify backup file format (custom or tar,
plain text is not possible) ----------------------------------------------
Reasons:
a) pg_restore may sometimes be used in a "stressed state of mind" where
additional information is essential
b) within win32 there is no man pg_restore possible
c) Not me allown did need some time to understand WHY an "output file
name" makes sense for a resore-utility.
Please find the patch in the upcomming.
Harald
----------------------------------------------
363,365c363,365
< printf(_(" -d, --dbname=NAME output database name\n"));
< printf(_(" -f, --file=FILENAME output file name\n"));
< printf(_(" -F, --format=c|t specify backup file format\n"));
---
> printf(_(" -d, --dbname=NAME output database name (to
restore into a psql database) \n"));
> printf(_(" -f, --file=FILENAME output file name (to convert
custom/tar to plain SQL)\n"));
> printf(_(" -F, --format=c|t specify backup file format
(only custom and tar are allowed, not plain SQL)\n"));
--------------------------------------------------