From 03132da3b65eb44e65fe26267b73c101d6a2113a Mon Sep 17 00:00:00 2001 From: Peter Eisentraut Date: Mon, 18 Jun 2012 02:44:00 +0300 Subject: [PATCH] Make documentation of --help and --version options more consistent Before, some places didn't document the short options (-? and -V), some documented both, some documented nothing, and they were listed in various orders. Now this is hopefully more consistent and complete. --- contrib/oid2name/oid2name.c | 28 ++++----- contrib/pg_archivecleanup/pg_archivecleanup.c | 10 ++-- contrib/pg_standby/pg_standby.c | 4 +- contrib/pg_upgrade/option.c | 2 +- contrib/pgbench/pgbench.c | 12 ++-- contrib/vacuumlo/vacuumlo.c | 21 +++---- doc/src/sgml/oid2name.sgml | 21 +++++++ doc/src/sgml/pgarchivecleanup.sgml | 20 +++++++ doc/src/sgml/pgbench.sgml | 20 +++++++ doc/src/sgml/pgstandby.sgml | 20 +++++++ doc/src/sgml/pgtestfsync.sgml | 20 +++++++ doc/src/sgml/pgtesttiming.sgml | 21 +++++++ doc/src/sgml/ref/createuser.sgml | 32 +++++----- doc/src/sgml/ref/dropdb.sgml | 20 +++---- doc/src/sgml/ref/dropuser.sgml | 20 +++---- doc/src/sgml/ref/ecpg-ref.sgml | 1 + doc/src/sgml/ref/initdb.sgml | 6 ++ doc/src/sgml/ref/pg_basebackup.sgml | 2 +- doc/src/sgml/ref/pg_config-ref.sgml | 11 ++++ doc/src/sgml/ref/pg_ctl-ref.sgml | 21 +++++++ doc/src/sgml/ref/pg_receivexlog.sgml | 2 +- doc/src/sgml/ref/postgres-ref.sgml | 21 +++++++ doc/src/sgml/vacuumlo.sgml | 60 ++++++++++++++----- src/backend/main/main.c | 4 +- src/bin/initdb/initdb.c | 2 +- src/bin/pg_basebackup/pg_basebackup.c | 4 +- src/bin/pg_basebackup/pg_receivexlog.c | 2 +- src/bin/pg_config/pg_config.c | 2 +- src/bin/pg_controldata/pg_controldata.c | 16 ++--- src/bin/pg_ctl/pg_ctl.c | 4 +- src/bin/pg_dump/pg_dump.c | 4 +- src/bin/pg_dump/pg_dumpall.c | 4 +- src/bin/pg_dump/pg_restore.c | 4 +- src/bin/pg_resetxlog/pg_resetxlog.c | 4 +- src/bin/psql/help.c | 4 +- src/bin/scripts/clusterdb.c | 4 +- src/bin/scripts/createdb.c | 4 +- src/bin/scripts/createlang.c | 4 +- src/bin/scripts/createuser.c | 4 +- src/bin/scripts/dropdb.c | 4 +- src/bin/scripts/droplang.c | 4 +- src/bin/scripts/dropuser.c | 4 +- src/bin/scripts/reindexdb.c | 4 +- src/bin/scripts/vacuumdb.c | 4 +- src/interfaces/ecpg/preproc/ecpg.c | 2 +- 45 files changed, 348 insertions(+), 139 deletions(-) diff --git a/contrib/oid2name/oid2name.c b/contrib/oid2name/oid2name.c index c7ba1bd101..e8a389e49e 100644 --- a/contrib/oid2name/oid2name.c +++ b/contrib/oid2name/oid2name.c @@ -179,20 +179,20 @@ help(const char *progname) "Usage:\n" " %s [OPTION]...\n" "\nOptions:\n" - " -d DBNAME database to connect to\n" - " -f FILENODE show info for table with given file node\n" - " -H HOSTNAME database server host or socket directory\n" - " -i show indexes and sequences too\n" - " -o OID show info for table with given OID\n" - " -p PORT database server port number\n" - " -q quiet (don't show headers)\n" - " -s show all tablespaces\n" - " -S show system objects too\n" - " -t TABLE show info for named table\n" - " -U NAME connect as specified database user\n" - " -x extended (show additional columns)\n" - " --help show this help, then exit\n" - " --version output version information, then exit\n" + " -d DBNAME database to connect to\n" + " -f FILENODE show info for table with given file node\n" + " -H HOSTNAME database server host or socket directory\n" + " -i show indexes and sequences too\n" + " -o OID show info for table with given OID\n" + " -p PORT database server port number\n" + " -q quiet (don't show headers)\n" + " -s show all tablespaces\n" + " -S show system objects too\n" + " -t TABLE show info for named table\n" + " -U NAME connect as specified database user\n" + " -V, --version output version information, then exit\n" + " -x extended (show additional columns)\n" + " -?, --help show this help, then exit\n" "\nThe default action is to show all database OIDs.\n\n" "Report bugs to .\n", progname, progname); diff --git a/contrib/pg_archivecleanup/pg_archivecleanup.c b/contrib/pg_archivecleanup/pg_archivecleanup.c index a226101bbc..8f77998de1 100644 --- a/contrib/pg_archivecleanup/pg_archivecleanup.c +++ b/contrib/pg_archivecleanup/pg_archivecleanup.c @@ -249,11 +249,11 @@ usage(void) printf("Usage:\n"); printf(" %s [OPTION]... ARCHIVELOCATION OLDESTKEPTWALFILE\n", progname); printf("\nOptions:\n"); - printf(" -d generate debug output (verbose mode)\n"); - printf(" -n dry run, show the names of the files that would be removed\n"); - printf(" -x EXT clean up files if they have this extension\n"); - printf(" --help show this help, then exit\n"); - printf(" --version output version information, then exit\n"); + printf(" -d generate debug output (verbose mode)\n"); + printf(" -n dry run, show the names of the files that would be removed\n"); + printf(" -V, --version output version information, then exit\n"); + printf(" -x EXT clean up files if they have this extension\n"); + printf(" -?, --help show this help, then exit\n"); printf("\n" "For use as archive_cleanup_command in recovery.conf when standby_mode = on:\n" " archive_cleanup_command = 'pg_archivecleanup [OPTION]... ARCHIVELOCATION %%r'\n" diff --git a/contrib/pg_standby/pg_standby.c b/contrib/pg_standby/pg_standby.c index 57241ff897..84941ede13 100644 --- a/contrib/pg_standby/pg_standby.c +++ b/contrib/pg_standby/pg_standby.c @@ -527,9 +527,9 @@ usage(void) printf(" -s SLEEPTIME seconds to wait between file checks (min=1, max=60,\n" " default=5)\n"); printf(" -t TRIGGERFILE trigger file to initiate failover (no default)\n"); + printf(" -V, --version output version information, then exit\n"); printf(" -w MAXWAITTIME max seconds to wait for a file (0=no limit) (default=0)\n"); - printf(" --help show this help, then exit\n"); - printf(" --version output version information, then exit\n"); + printf(" -?, --help show this help, then exit\n"); printf("\n" "Main intended use as restore_command in recovery.conf:\n" " restore_command = 'pg_standby [OPTION]... ARCHIVELOCATION %%f %%p %%r'\n" diff --git a/contrib/pg_upgrade/option.c b/contrib/pg_upgrade/option.c index ccf00434d3..43394a0fb4 100644 --- a/contrib/pg_upgrade/option.c +++ b/contrib/pg_upgrade/option.c @@ -236,7 +236,7 @@ Options:\n\ -u, --user=NAME cluster superuser (default \"%s\")\n\ -v, --verbose enable verbose internal logging\n\ -V, --version display version information, then exit\n\ - -h, --help show this help, then exit\n\ + -?, -h, --help show this help, then exit\n\ \n\ Before running pg_upgrade you must:\n\ create a new database cluster (using the new version of initdb)\n\ diff --git a/contrib/pgbench/pgbench.c b/contrib/pgbench/pgbench.c index 25fb15a847..f2fdc6c56f 100644 --- a/contrib/pgbench/pgbench.c +++ b/contrib/pgbench/pgbench.c @@ -368,12 +368,12 @@ usage(const char *progname) " -T NUM duration of benchmark test in seconds\n" " -v vacuum all four standard tables before tests\n" "\nCommon options:\n" - " -d print debugging output\n" - " -h HOSTNAME database server host or socket directory\n" - " -p PORT database server port number\n" - " -U USERNAME connect as specified database user\n" - " --help show this help, then exit\n" - " --version output version information, then exit\n" + " -d print debugging output\n" + " -h HOSTNAME database server host or socket directory\n" + " -p PORT database server port number\n" + " -U USERNAME connect as specified database user\n" + " -V, --version output version information, then exit\n" + " -?, --help show this help, then exit\n" "\n" "Report bugs to .\n", progname, progname); diff --git a/contrib/vacuumlo/vacuumlo.c b/contrib/vacuumlo/vacuumlo.c index 958a496b24..7f5287c27a 100644 --- a/contrib/vacuumlo/vacuumlo.c +++ b/contrib/vacuumlo/vacuumlo.c @@ -384,16 +384,17 @@ usage(const char *progname) printf("%s removes unreferenced large objects from databases.\n\n", progname); printf("Usage:\n %s [OPTION]... DBNAME...\n\n", progname); printf("Options:\n"); - printf(" -h HOSTNAME database server host or socket directory\n"); - printf(" -l LIMIT commit after removing each LIMIT large objects\n"); - printf(" -n don't remove large objects, just show what would be done\n"); - printf(" -p PORT database server port\n"); - printf(" -U USERNAME user name to connect as\n"); - printf(" -w never prompt for password\n"); - printf(" -W force password prompt\n"); - printf(" -v write a lot of progress messages\n"); - printf(" --help show this help, then exit\n"); - printf(" --version output version information, then exit\n"); + printf(" -l LIMIT commit after removing each LIMIT large objects\n"); + printf(" -n don't remove large objects, just show what would be done\n"); + printf(" -v write a lot of progress messages\n"); + printf(" -V, --version output version information, then exit\n"); + printf(" -?, --help show this help, then exit\n"); + printf("\nConnection options:\n"); + printf(" -h HOSTNAME database server host or socket directory\n"); + printf(" -p PORT database server port\n"); + printf(" -U USERNAME user name to connect as\n"); + printf(" -w never prompt for password\n"); + printf(" -W force password prompt\n"); printf("\n"); printf("Report bugs to .\n"); } diff --git a/doc/src/sgml/oid2name.sgml b/doc/src/sgml/oid2name.sgml index 30e8bb1972..5e39677496 100644 --- a/doc/src/sgml/oid2name.sgml +++ b/doc/src/sgml/oid2name.sgml @@ -97,12 +97,33 @@ show info for table(s) matching tablename_pattern + + + + + + Print the oid2name version and exit. + + + + display more information about each object shown: tablespace name, schema name, and OID + + + + + + + Show help about oid2name command line + arguments, and exit. + + + diff --git a/doc/src/sgml/pgarchivecleanup.sgml b/doc/src/sgml/pgarchivecleanup.sgml index 44e8bbdfc2..932914bc2f 100644 --- a/doc/src/sgml/pgarchivecleanup.sgml +++ b/doc/src/sgml/pgarchivecleanup.sgml @@ -106,6 +106,16 @@ pg_archivecleanup: removing file "archive/00000001000000370000000E" + + + + + + Print the pg_archivecleanup version and exit. + + + + extension @@ -126,6 +136,16 @@ pg_archivecleanup: removing file "archive/00000001000000370000000E" + + + + + + Show help about pg_archivecleanup command line + arguments, and exit. + + + diff --git a/doc/src/sgml/pgbench.sgml b/doc/src/sgml/pgbench.sgml index 1b0905fa27..4a80b46416 100644 --- a/doc/src/sgml/pgbench.sgml +++ b/doc/src/sgml/pgbench.sgml @@ -453,6 +453,26 @@ pgbench options dbname + + + + + + Print the pgbench version and exit. + + + + + + + + + + Show help about pgbench command line + arguments, and exit. + + + diff --git a/doc/src/sgml/pgstandby.sgml b/doc/src/sgml/pgstandby.sgml index 0fe3f646bc..ca2b5c078d 100644 --- a/doc/src/sgml/pgstandby.sgml +++ b/doc/src/sgml/pgstandby.sgml @@ -198,6 +198,16 @@ restore_command = 'pg_standby archiveDir %f %p %r' + + + + + + Print the pg_standby version and exit. + + + + maxwaittime @@ -211,6 +221,16 @@ restore_command = 'pg_standby archiveDir %f %p %r' + + + + + + Show help about pg_standby command line + arguments, and exit. + + + diff --git a/doc/src/sgml/pgtestfsync.sgml b/doc/src/sgml/pgtestfsync.sgml index d8c0c45808..95ba3b81e0 100644 --- a/doc/src/sgml/pgtestfsync.sgml +++ b/doc/src/sgml/pgtestfsync.sgml @@ -75,6 +75,26 @@ + + + + + + Print the pg_test_fsync version and exit. + + + + + + + + + + Show help about pg_test_fsync command line + arguments, and exit. + + + diff --git a/doc/src/sgml/pgtesttiming.sgml b/doc/src/sgml/pgtesttiming.sgml index 486be83123..f74d63e688 100644 --- a/doc/src/sgml/pgtesttiming.sgml +++ b/doc/src/sgml/pgtesttiming.sgml @@ -56,6 +56,27 @@ + + + + + + Print the pg_test_timing version and exit. + + + + + + + + + + Show help about pg_test_timing command line + arguments, and exit. + + + + diff --git a/doc/src/sgml/ref/createuser.sgml b/doc/src/sgml/ref/createuser.sgml index dedc97f223..2f1ea2fb73 100644 --- a/doc/src/sgml/ref/createuser.sgml +++ b/doc/src/sgml/ref/createuser.sgml @@ -256,13 +256,23 @@ PostgreSQL documentation + + + + + + Print the createuser version and exit. + + + + - The new user will have the REPLICATION privilege, which is - described more fully in the documentation for - . + The new user will have the REPLICATION privilege, + which is described more fully in the documentation for . @@ -271,23 +281,13 @@ PostgreSQL documentation - The new user will not have the REPLICATION privilege, which is - described more fully in the documentation for - . + The new user will not have the REPLICATION + privilege, which is described more fully in the documentation for . - - - - - - Print the createuser version and exit. - - - - diff --git a/doc/src/sgml/ref/dropdb.sgml b/doc/src/sgml/ref/dropdb.sgml index ba781cce52..4593604f3b 100644 --- a/doc/src/sgml/ref/dropdb.sgml +++ b/doc/src/sgml/ref/dropdb.sgml @@ -86,16 +86,6 @@ PostgreSQL documentation - - - - - Do not throw an error if the database does not exist. A notice is issued - in this case. - - - - @@ -106,6 +96,16 @@ PostgreSQL documentation + + + + + Do not throw an error if the database does not exist. A notice is issued + in this case. + + + + diff --git a/doc/src/sgml/ref/dropuser.sgml b/doc/src/sgml/ref/dropuser.sgml index 891bbd6037..180fb0bb62 100644 --- a/doc/src/sgml/ref/dropuser.sgml +++ b/doc/src/sgml/ref/dropuser.sgml @@ -91,16 +91,6 @@ PostgreSQL documentation - - - - - Do not throw an error if the user does not exist. A notice is - issued in this case. - - - - @@ -111,6 +101,16 @@ PostgreSQL documentation + + + + + Do not throw an error if the user does not exist. A notice is + issued in this case. + + + + diff --git a/doc/src/sgml/ref/ecpg-ref.sgml b/doc/src/sgml/ref/ecpg-ref.sgml index 9c13e93a27..edd20dcdd5 100644 --- a/doc/src/sgml/ref/ecpg-ref.sgml +++ b/doc/src/sgml/ref/ecpg-ref.sgml @@ -202,6 +202,7 @@ PostgreSQL documentation + diff --git a/doc/src/sgml/ref/initdb.sgml b/doc/src/sgml/ref/initdb.sgml index b2e94e83d8..11484468dd 100644 --- a/doc/src/sgml/ref/initdb.sgml +++ b/doc/src/sgml/ref/initdb.sgml @@ -326,7 +326,13 @@ PostgreSQL documentation + + + + Other options: + + diff --git a/doc/src/sgml/ref/pg_basebackup.sgml b/doc/src/sgml/ref/pg_basebackup.sgml index d03bedd12a..ebd6e1e9f8 100644 --- a/doc/src/sgml/ref/pg_basebackup.sgml +++ b/doc/src/sgml/ref/pg_basebackup.sgml @@ -431,7 +431,7 @@ PostgreSQL documentation - Other, less commonly used, options are also available: + Other options are also available: diff --git a/doc/src/sgml/ref/pg_config-ref.sgml b/doc/src/sgml/ref/pg_config-ref.sgml index 2246b74df0..5aac38b3ce 100644 --- a/doc/src/sgml/ref/pg_config-ref.sgml +++ b/doc/src/sgml/ref/pg_config-ref.sgml @@ -273,6 +273,17 @@ + + + + + + + Show help about pg_config command line + arguments, and exit. + + + If more than one option is given, the information is printed in that order, diff --git a/doc/src/sgml/ref/pg_ctl-ref.sgml b/doc/src/sgml/ref/pg_ctl-ref.sgml index 1409e0c44e..37826e9c6c 100644 --- a/doc/src/sgml/ref/pg_ctl-ref.sgml +++ b/doc/src/sgml/ref/pg_ctl-ref.sgml @@ -363,6 +363,16 @@ PostgreSQL documentation + + + + + + Print the pg_ctl version and exit. + + + + @@ -388,6 +398,17 @@ PostgreSQL documentation + + + + + + + Show help about pg_ctl command line + arguments, and exit. + + + diff --git a/doc/src/sgml/ref/pg_receivexlog.sgml b/doc/src/sgml/ref/pg_receivexlog.sgml index 5eefefbe87..63cff47880 100644 --- a/doc/src/sgml/ref/pg_receivexlog.sgml +++ b/doc/src/sgml/ref/pg_receivexlog.sgml @@ -211,7 +211,7 @@ PostgreSQL documentation - Other, less commonly used, options are also available: + Other options are also available: diff --git a/doc/src/sgml/ref/postgres-ref.sgml b/doc/src/sgml/ref/postgres-ref.sgml index d8e9825d13..4e5cd02589 100644 --- a/doc/src/sgml/ref/postgres-ref.sgml +++ b/doc/src/sgml/ref/postgres-ref.sgml @@ -345,6 +345,16 @@ PostgreSQL documentation + + + + + + Print the postgres version and exit. + + + + @@ -365,6 +375,17 @@ PostgreSQL documentation + + + + + + + Show help about postgres command line + arguments, and exit. + + + diff --git a/doc/src/sgml/vacuumlo.sgml b/doc/src/sgml/vacuumlo.sgml index 4640744e8b..b9629bf2f5 100644 --- a/doc/src/sgml/vacuumlo.sgml +++ b/doc/src/sgml/vacuumlo.sgml @@ -50,14 +50,10 @@ Options - - - hostname - - Database server's host. - - + + vacuumlo accepts the following command-line arguments: + limit @@ -78,6 +74,48 @@ + + + + Write a lot of progress messages. + + + + + + + + + Print the vacuumlo version and exit. + + + + + + + + + + Show help about vacuumlo command line + arguments, and exit. + + + + + + + + vacuumlo also accepts the following command-line + arguments for connection parameters: + + + + hostname + + Database server's host. + + + port @@ -92,13 +130,6 @@ - - - - Write a lot of progress messages. - - - @@ -133,6 +164,7 @@ + diff --git a/src/backend/main/main.c b/src/backend/main/main.c index 7203481a04..c7d48e95ad 100644 --- a/src/backend/main/main.c +++ b/src/backend/main/main.c @@ -295,10 +295,10 @@ help(const char *progname) printf(_(" -p PORT port number to listen on\n")); printf(_(" -s show statistics after each query\n")); printf(_(" -S WORK-MEM set amount of memory for sorts (in kB)\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" --NAME=VALUE set run-time parameter\n")); printf(_(" --describe-config describe configuration parameters, then exit\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nDeveloper options:\n")); printf(_(" -f s|i|n|m|h forbid use of some plan types\n")); diff --git a/src/bin/initdb/initdb.c b/src/bin/initdb/initdb.c index 3789948cdf..bac8385d39 100644 --- a/src/bin/initdb/initdb.c +++ b/src/bin/initdb/initdb.c @@ -2534,8 +2534,8 @@ usage(const char *progname) printf(_(" -n, --noclean do not clean up after errors\n")); printf(_(" -s, --show show internal settings\n")); printf(_("\nOther options:\n")); - printf(_(" -?, --help show this help, then exit\n")); printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nIf the data directory is not specified, the environment variable PGDATA\n" "is used.\n")); printf(_("\nReport bugs to .\n")); diff --git a/src/bin/pg_basebackup/pg_basebackup.c b/src/bin/pg_basebackup/pg_basebackup.c index 44fd8a969d..bc67a3cb4d 100644 --- a/src/bin/pg_basebackup/pg_basebackup.c +++ b/src/bin/pg_basebackup/pg_basebackup.c @@ -118,8 +118,8 @@ usage(void) printf(_(" -l, --label=LABEL set backup label\n")); printf(_(" -P, --progress show progress information\n")); printf(_(" -v, --verbose output verbose messages\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -s, --statusint=INTERVAL time between status packets sent to server (in seconds)\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); diff --git a/src/bin/pg_basebackup/pg_receivexlog.c b/src/bin/pg_basebackup/pg_receivexlog.c index faa30b2bf0..20adb653cf 100644 --- a/src/bin/pg_basebackup/pg_receivexlog.c +++ b/src/bin/pg_basebackup/pg_receivexlog.c @@ -60,8 +60,8 @@ usage(void) printf(_(" -D, --directory=DIR receive transaction log files into this directory\n")); printf(_(" -n, --noloop do not loop on connection lost\n")); printf(_(" -v, --verbose output verbose messages\n")); - printf(_(" -?, --help show this help, then exit\n")); printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -s, --statusint=INTERVAL time between status packets sent to server (in seconds)\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); diff --git a/src/bin/pg_config/pg_config.c b/src/bin/pg_config/pg_config.c index 6bd3451e4c..b94cf53f54 100644 --- a/src/bin/pg_config/pg_config.c +++ b/src/bin/pg_config/pg_config.c @@ -454,7 +454,7 @@ help(void) printf(_(" --ldflags_sl show LDFLAGS_SL value used when PostgreSQL was built\n")); printf(_(" --libs show LIBS value used when PostgreSQL was built\n")); printf(_(" --version show the PostgreSQL version\n")); - printf(_(" --help show this help, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nWith no arguments, all known items are shown.\n\n")); printf(_("Report bugs to .\n")); } diff --git a/src/bin/pg_controldata/pg_controldata.c b/src/bin/pg_controldata/pg_controldata.c index c00183ab4f..38c263c08b 100644 --- a/src/bin/pg_controldata/pg_controldata.c +++ b/src/bin/pg_controldata/pg_controldata.c @@ -31,17 +31,11 @@ static void usage(const char *progname) { printf(_("%s displays control information of a PostgreSQL database cluster.\n\n"), progname); - printf - ( - _( - "Usage:\n" - " %s [OPTION] [DATADIR]\n\n" - "Options:\n" - " --help show this help, then exit\n" - " --version output version information, then exit\n" - ), - progname - ); + printf(_("Usage:\n")); + printf(_(" %s [OPTION] [DATADIR]\n"), progname); + printf(_("\nOptions:\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nIf no data directory (DATADIR) is specified, " "the environment variable PGDATA\nis used.\n\n")); printf(_("Report bugs to .\n")); diff --git a/src/bin/pg_ctl/pg_ctl.c b/src/bin/pg_ctl/pg_ctl.c index d7b836762d..3826312b8e 100644 --- a/src/bin/pg_ctl/pg_ctl.c +++ b/src/bin/pg_ctl/pg_ctl.c @@ -1768,10 +1768,10 @@ do_help(void) printf(_(" -D, --pgdata=DATADIR location of the database storage area\n")); printf(_(" -s, --silent only print errors, no informational messages\n")); printf(_(" -t, --timeout=SECS seconds to wait when using -w option\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" -w wait until operation completes\n")); printf(_(" -W do not wait until operation completes\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("(The default is to wait for shutdown, but not for start or restart.)\n\n")); printf(_("If the -D option is omitted, the environment variable PGDATA is used.\n")); diff --git a/src/bin/pg_dump/pg_dump.c b/src/bin/pg_dump/pg_dump.c index d9aeee3c8d..4780c37d30 100644 --- a/src/bin/pg_dump/pg_dump.c +++ b/src/bin/pg_dump/pg_dump.c @@ -780,10 +780,10 @@ help(const char *progname) printf(_(" -F, --format=c|d|t|p output file format (custom, directory, tar,\n" " plain text (default))\n")); printf(_(" -v, --verbose verbose mode\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" -Z, --compress=0-9 compression level for compressed formats\n")); printf(_(" --lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nOptions controlling the output content:\n")); printf(_(" -a, --data-only dump only the data, not the schema\n")); diff --git a/src/bin/pg_dump/pg_dumpall.c b/src/bin/pg_dump/pg_dumpall.c index 053e5fd36a..10ce2223df 100644 --- a/src/bin/pg_dump/pg_dumpall.c +++ b/src/bin/pg_dump/pg_dumpall.c @@ -538,9 +538,9 @@ help(void) printf(_("\nGeneral options:\n")); printf(_(" -f, --file=FILENAME output file name\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" --lock-wait-timeout=TIMEOUT fail after waiting TIMEOUT for a table lock\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nOptions controlling the output content:\n")); printf(_(" -a, --data-only dump only the data, not the schema\n")); printf(_(" -c, --clean clean (drop) databases before recreating\n")); diff --git a/src/bin/pg_dump/pg_restore.c b/src/bin/pg_dump/pg_restore.c index f371527193..f6c835be0d 100644 --- a/src/bin/pg_dump/pg_restore.c +++ b/src/bin/pg_dump/pg_restore.c @@ -407,8 +407,8 @@ usage(const char *progname) printf(_(" -F, --format=c|d|t backup file format (should be automatic)\n")); printf(_(" -l, --list print summarized TOC of the archive\n")); printf(_(" -v, --verbose verbose mode\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nOptions controlling the restore:\n")); printf(_(" -a, --data-only restore only the data, no schema\n")); diff --git a/src/bin/pg_resetxlog/pg_resetxlog.c b/src/bin/pg_resetxlog/pg_resetxlog.c index 65ba9103a6..5ecf5c4930 100644 --- a/src/bin/pg_resetxlog/pg_resetxlog.c +++ b/src/bin/pg_resetxlog/pg_resetxlog.c @@ -1035,8 +1035,8 @@ usage(void) printf(_(" -n no update, just show extracted control values (for testing)\n")); printf(_(" -o OID set next OID\n")); printf(_(" -O OFFSET set next multitransaction offset\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" -x XID set next transaction ID\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nReport bugs to .\n")); } diff --git a/src/bin/psql/help.c b/src/bin/psql/help.c index 4a37c3414c..8868d7151c 100644 --- a/src/bin/psql/help.c +++ b/src/bin/psql/help.c @@ -94,11 +94,11 @@ usage(void) printf(_(" -l, --list list available databases, then exit\n")); printf(_(" -v, --set=, --variable=NAME=VALUE\n" " set psql variable NAME to VALUE\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" -X, --no-psqlrc do not read startup file (~/.psqlrc)\n")); printf(_(" -1 (\"one\"), --single-transaction\n" " execute command file as a single transaction\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nInput and output options:\n")); printf(_(" -a, --echo-all echo all input from script\n")); diff --git a/src/bin/scripts/clusterdb.c b/src/bin/scripts/clusterdb.c index 76de70b6ef..05b726d68e 100644 --- a/src/bin/scripts/clusterdb.c +++ b/src/bin/scripts/clusterdb.c @@ -255,8 +255,8 @@ help(const char *progname) printf(_(" -q, --quiet don't write any messages\n")); printf(_(" -t, --table=TABLE cluster specific table only\n")); printf(_(" -v, --verbose write a lot of output\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/createdb.c b/src/bin/scripts/createdb.c index d58c815646..91b1a24fd3 100644 --- a/src/bin/scripts/createdb.c +++ b/src/bin/scripts/createdb.c @@ -260,8 +260,8 @@ help(const char *progname) printf(_(" --lc-ctype=LOCALE LC_CTYPE setting for the database\n")); printf(_(" -O, --owner=OWNER database user to own the new database\n")); printf(_(" -T, --template=TEMPLATE template database to copy\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/createlang.c b/src/bin/scripts/createlang.c index 8268eda6ed..60066af377 100644 --- a/src/bin/scripts/createlang.c +++ b/src/bin/scripts/createlang.c @@ -237,8 +237,8 @@ help(const char *progname) printf(_(" -d, --dbname=DBNAME database to install language in\n")); printf(_(" -e, --echo show the commands being sent to the server\n")); printf(_(" -l, --list show a list of currently installed languages\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/createuser.c b/src/bin/scripts/createuser.c index 20a1a52a3a..db3b5d04d8 100644 --- a/src/bin/scripts/createuser.c +++ b/src/bin/scripts/createuser.c @@ -345,12 +345,12 @@ help(const char *progname) printf(_(" -R, --no-createrole role cannot create roles (default)\n")); printf(_(" -s, --superuser role will be superuser\n")); printf(_(" -S, --no-superuser role will not be superuser (default)\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" --interactive prompt for missing role name and attributes rather\n" " than using defaults\n")); printf(_(" --replication role can initiate replication\n")); printf(_(" --no-replication role cannot initiate replication\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/dropdb.c b/src/bin/scripts/dropdb.c index 10ed67df8b..583655de6a 100644 --- a/src/bin/scripts/dropdb.c +++ b/src/bin/scripts/dropdb.c @@ -157,9 +157,9 @@ help(const char *progname) printf(_("\nOptions:\n")); printf(_(" -e, --echo show the commands being sent to the server\n")); printf(_(" -i, --interactive prompt before deleting anything\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" --if-exists don't report error if database doesn't exist\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/droplang.c b/src/bin/scripts/droplang.c index 74553c19fd..4772dc514e 100644 --- a/src/bin/scripts/droplang.c +++ b/src/bin/scripts/droplang.c @@ -238,8 +238,8 @@ help(const char *progname) printf(_(" -d, --dbname=DBNAME database from which to remove the language\n")); printf(_(" -e, --echo show the commands being sent to the server\n")); printf(_(" -l, --list show a list of currently installed languages\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/dropuser.c b/src/bin/scripts/dropuser.c index 85b73a42ac..d0bf6ff497 100644 --- a/src/bin/scripts/dropuser.c +++ b/src/bin/scripts/dropuser.c @@ -159,9 +159,9 @@ help(const char *progname) printf(_(" -e, --echo show the commands being sent to the server\n")); printf(_(" -i, --interactive prompt before deleting anything, and prompt for\n" " role name if not specified\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" --if-exists don't report error if user doesn't exist\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/reindexdb.c b/src/bin/scripts/reindexdb.c index 35254f20cb..5b56656f00 100644 --- a/src/bin/scripts/reindexdb.c +++ b/src/bin/scripts/reindexdb.c @@ -335,8 +335,8 @@ help(const char *progname) printf(_(" -q, --quiet don't write any messages\n")); printf(_(" -s, --system reindex system catalogs\n")); printf(_(" -t, --table=TABLE reindex specific table only\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -V, --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/bin/scripts/vacuumdb.c b/src/bin/scripts/vacuumdb.c index 6221bdc30d..fbc132caa9 100644 --- a/src/bin/scripts/vacuumdb.c +++ b/src/bin/scripts/vacuumdb.c @@ -350,10 +350,10 @@ help(const char *progname) printf(_(" -q, --quiet don't write any messages\n")); printf(_(" -t, --table='TABLE[(COLUMNS)]' vacuum specific table only\n")); printf(_(" -v, --verbose write a lot of output\n")); + printf(_(" -V, --version output version information, then exit\n")); printf(_(" -z, --analyze update optimizer statistics\n")); printf(_(" -Z, --analyze-only only update optimizer statistics\n")); - printf(_(" --help show this help, then exit\n")); - printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nConnection options:\n")); printf(_(" -h, --host=HOSTNAME database server host or socket directory\n")); printf(_(" -p, --port=PORT database server port\n")); diff --git a/src/interfaces/ecpg/preproc/ecpg.c b/src/interfaces/ecpg/preproc/ecpg.c index 8a4cebc6e2..7e7bae30a0 100644 --- a/src/interfaces/ecpg/preproc/ecpg.c +++ b/src/interfaces/ecpg/preproc/ecpg.c @@ -54,8 +54,8 @@ help(const char *progname) " \"no_indicator\", \"prepare\", \"questionmarks\"\n")); printf(_(" --regression run in regression testing mode\n")); printf(_(" -t turn on autocommit of transactions\n")); - printf(_(" --help show this help, then exit\n")); printf(_(" --version output version information, then exit\n")); + printf(_(" -?, --help show this help, then exit\n")); printf(_("\nIf no output file is specified, the name is formed by adding .c to the\n" "input file name, after stripping off .pgc if present.\n")); printf(_("\nReport bugs to .\n"));