pg_resetwal: Regroup --help output
authorPeter Eisentraut <peter@eisentraut.org>
Thu, 28 Sep 2023 09:49:20 +0000 (11:49 +0200)
committerPeter Eisentraut <peter@eisentraut.org>
Thu, 28 Sep 2023 09:49:20 +0000 (11:49 +0200)
Put the options to modify the control values into a separate group.
This matches the outline of the man page.

Reviewed-by: Aleksander Alekseev <aleksander@timescale.com>
Discussion: https://www.postgresql.org/message-id/flat/0f3ab4a1-ae80-56e8-3426-6b4a02507687@eisentraut.org

src/bin/pg_resetwal/pg_resetwal.c

index e344c9284db3971667bde4e6502a911a2dffb41c..12e0869251cf4fd4c116c0c71663e90901614e83 100644 (file)
@@ -1128,24 +1128,29 @@ static void
 usage(void)
 {
    printf(_("%s resets the PostgreSQL write-ahead log.\n\n"), progname);
-   printf(_("Usage:\n  %s [OPTION]... DATADIR\n\n"), progname);
-   printf(_("Options:\n"));
+   printf(_("Usage:\n"));
+   printf(_("  %s [OPTION]... DATADIR\n"), progname);
+
+   printf(_("\nOptions:\n"));
+   printf(_(" [-D, --pgdata=]DATADIR  data directory\n"));
+   printf(_("  -f, --force            force update to be done\n"));
+   printf(_("  -n, --dry-run          no update, just show what would be done\n"));
+   printf(_("  -V, --version          output version information, then exit\n"));
+   printf(_("  -?, --help             show this help, then exit\n"));
+
+   printf(_("\nOptions to override control file values:\n"));
    printf(_("  -c, --commit-timestamp-ids=XID,XID\n"
             "                                   set oldest and newest transactions bearing\n"
             "                                   commit timestamp (zero means no change)\n"));
-   printf(_(" [-D, --pgdata=]DATADIR            data directory\n"));
    printf(_("  -e, --epoch=XIDEPOCH             set next transaction ID epoch\n"));
-   printf(_("  -f, --force                      force update to be done\n"));
    printf(_("  -l, --next-wal-file=WALFILE      set minimum starting location for new WAL\n"));
    printf(_("  -m, --multixact-ids=MXID,MXID    set next and oldest multitransaction ID\n"));
-   printf(_("  -n, --dry-run                    no update, just show what would be done\n"));
    printf(_("  -o, --next-oid=OID               set next OID\n"));
    printf(_("  -O, --multixact-offset=OFFSET    set next multitransaction offset\n"));
    printf(_("  -u, --oldest-transaction-id=XID  set oldest transaction ID\n"));
-   printf(_("  -V, --version                    output version information, then exit\n"));
    printf(_("  -x, --next-transaction-id=XID    set next transaction ID\n"));
    printf(_("      --wal-segsize=SIZE           size of WAL segments, in megabytes\n"));
-   printf(_("  -?, --help                       show this help, then exit\n"));
+
    printf(_("\nReport bugs to <%s>.\n"), PACKAGE_BUGREPORT);
    printf(_("%s home page: <%s>\n"), PACKAGE_NAME, PACKAGE_URL);
 }