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"));
--------------------------------------------------
begin:vcard
fn:Harald Armin Massa
n:Massa;Harald Armin
org:GHUM Harald Massa
adr;quoted-printable;quoted-printable:;;Reinsburgstra=C3=9Fe 202b;Stuttgart;Baden-W=C3=BCrttemberg;70197;Deutschland
email;internet:[EMAIL PROTECTED]
title:Chef
tel;work:0711/6587982
tel;home:0711/6571322
tel;cell:0173/9409607
x-mozilla-html:FALSE
url:http://www.ghum.de
version:2.1
end:vcard

---------------------------(end of broadcast)---------------------------
TIP 4: Don't 'kill -9' the postmaster

Reply via email to