pg_restore: Improve --help synopsis

petere · petere · commit 15b1b4dd3fcc · 2025-04-29T11:32:49.000+02:00
The --help synopsis should only be one line.  This rephrases the first
line a bit to reflect the new functionality of restoring multiple
databases from pg_dumpall output.  Additional explanations are better
kept in the man page.
diff --git a/src/bin/pg_dump/pg_restore.c b/src/bin/pg_dump/pg_restore.c
@@ -653,8 +653,7 @@ restore_one_database(const char *inputFileSpec, RestoreOptions *opts,
 static void
 usage(const char *progname)
 {
-	printf(_("%s restores a PostgreSQL database from an archive created by pg_dump or pg_dumpall.\n"
-			 "If the archive is created by pg_dumpall, then restores multiple databases also.\n\n"), progname);
+	printf(_("%s restores PostgreSQL databases from archives created by pg_dump or pg_dumpall.\n\n"), progname);
 	printf(_("Usage:\n"));
 	printf(_("  %s [OPTION]... [FILE]\n"), progname);
 

Original file line number	Diff line number	Diff line change
`@@ -653,8 +653,7 @@ restore_one_database(const char inputFileSpec, RestoreOptions opts,`
`653`	`653`	`static void`
`654`	`654`	`usage(const char *progname)`
`655`	`655`	`{`
`656`		`- printf(_("%s restores a PostgreSQL database from an archive created by pg_dump or pg_dumpall.\n"`
`657`		`- "If the archive is created by pg_dumpall, then restores multiple databases also.\n\n"), progname);`
	`656`	`+ printf(_("%s restores PostgreSQL databases from archives created by pg_dump or pg_dumpall.\n\n"), progname);`
`658`	`657`	`printf(_("Usage:\n"));`
`659`	`658`	`printf(_(" %s [OPTION]... [FILE]\n"), progname);`
`660`	`659`