@@ -213,24 +213,26 @@ parseCommandLine(int argc, char *argv[])
213213static void
214214usage (void )
215215{
216- printf (_ ("\nUsage: pg_upgrade [OPTIONS]...\n\
216+ printf (_ ("pg_upgrade upgrades a PostgreSQL cluster to a different major version.\n\
217+ \nUsage:\n\
218+ pg_upgrade [OPTIONS]...\n\
217219\n\
218220Options:\n\
219- -b, --old-bindir=old_bindir old cluster executable directory\n\
220- -B, --new-bindir=new_bindir new cluster executable directory\n\
221- -c, --check check clusters only, don't change any data\n\
222- -d, --old-datadir=old_datadir old cluster data directory\n\
223- -D, --new-datadir=new_datadir new cluster data directory\n\
224- -g, --debug enable debugging\n\
225- -G, --debugfile=debug_filename output debugging activity to file\n\
226- -k, --link link instead of copying files to new cluster\n\
227- -l, --logfile=log_filename log session activity to file\n\
228- -p, --old-port=old_portnum old cluster port number (default %d)\n\
229- -P, --new-port=new_portnum new cluster port number (default %d)\n\
230- -u, --user=username clusters superuser (default \"%s\")\n\
231- -v, --verbose enable verbose output\n\
232- -V, --version display version information, then exit\n\
233- -h, --help show this help, then exit\n\
221+ -b, --old-bindir=OLDBINDIR old cluster executable directory\n\
222+ -B, --new-bindir=NEWBINDIR new cluster executable directory\n\
223+ -c, --check check clusters only, don't change any data\n\
224+ -d, --old-datadir=OLDDATADIR old cluster data directory\n\
225+ -D, --new-datadir=NEWDATADIR new cluster data directory\n\
226+ -g, --debug enable debugging\n\
227+ -G, --debugfile=FILENAME output debugging activity to file\n\
228+ -k, --link link instead of copying files to new cluster\n\
229+ -l, --logfile=FILENAME log session activity to file\n\
230+ -p, --old-port=OLDPORT old cluster port number (default %d)\n\
231+ -P, --new-port=NEWPORT new cluster port number (default %d)\n\
232+ -u, --user=NAME clusters superuser (default \"%s\")\n\
233+ -v, --verbose enable verbose output\n\
234+ -V, --version display version information, then exit\n\
235+ -h, --help show this help, then exit\n\
234236\n\
235237Before running pg_upgrade you must:\n\
236238 create a new database cluster (using the new version of initdb)\n\
@@ -240,8 +242,8 @@ Before running pg_upgrade you must:\n\
240242When you run pg_upgrade, you must provide the following information:\n\
241243 the data directory for the old cluster (-d OLDDATADIR)\n\
242244 the data directory for the new cluster (-D NEWDATADIR)\n\
243- the' bin' directory for the old version (-b OLDBINDIR)\n\
244- the' bin' directory for the new version (-B NEWBINDIR)\n\
245+ the\" bin\" directory for the old version (-b OLDBINDIR)\n\
246+ the\" bin\" directory for the new version (-B NEWBINDIR)\n\
245247\n\
246248For example:\n\
247249 pg_upgrade -d oldCluster/data -D newCluster/data -b oldCluster/bin -B newCluster/bin\n\