From: Benno Schulenberg Date: Tue, 25 Mar 2025 10:43:02 +0000 (+0100) Subject: mkfs.cramfs: reduce the synopsis to the standard, succinct form X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=6d9b61a40e1d47176cf11366826a0dee93f2d0e0;p=thirdparty%2Futil-linux.git mkfs.cramfs: reduce the synopsis to the standard, succinct form The old synopsis was 1) incomplete (mentioning -h and -v, but not -V and -E and -z, for example), and 2) overlong, being wider than 80 columns. So, change the synposis to what most other utilities nowadays use: " [options] ..." -- this makes it much clearer what the two required arguments are. Also, reshuffle the descriptions of the two arguments, to not hide them among the options. And remove the description of option -s, as listing an option that does nothing is not helpful. Signed-off-by: Benno Schulenberg --- diff --git a/disk-utils/mkfs.cramfs.c b/disk-utils/mkfs.cramfs.c index 51fa2122a..74f51a280 100644 --- a/disk-utils/mkfs.cramfs.c +++ b/disk-utils/mkfs.cramfs.c @@ -128,10 +128,15 @@ struct entry { static void __attribute__((__noreturn__)) usage(void) { fputs(USAGE_HEADER, stdout); - fprintf(stdout, _(" %s [-h] [-v] [-b blksize] [-e edition] [-N endian] [-i file] [-n name] dirname outfile\n"), - program_invocation_short_name); + fprintf(stdout, _(" %s [options] dirname outfile\n"), program_invocation_short_name); + + fputs(USAGE_SEPARATOR, stdout); + fputsln(_("Make a compressed ROM file system."), stdout); + fputs(USAGE_SEPARATOR, stdout); - fputsln(_("Make compressed ROM file system."), stdout); + fputsln(_( " dirname root of the filesystem to be compressed"), stdout); + fputsln(_( " outfile output file"), stdout); + fputs(USAGE_OPTIONS, stdout); fputsln(_( " -v be verbose"), stdout); fputsln(_( " -E make all warnings errors (non-zero exit status)"), stdout); @@ -141,14 +146,12 @@ static void __attribute__((__noreturn__)) usage(void) fputsln(_( " -i file insert a file image into the filesystem"), stdout); fputsln(_( " -n name set name of cramfs filesystem"), stdout); fprintf(stdout, _(" -p pad by %d bytes for boot code\n"), PAD_SIZE); - fputsln(_( " -s sort directory entries (old option, ignored)"), stdout); fputsln(_( " -z make explicit holes"), stdout); fputsln(_( " -l[=] use exclusive device lock (yes, no or nonblock)"), stdout); - fputs(USAGE_SEPARATOR, stdout); - fputsln(_( " dirname root of the filesystem to be compressed"), stdout); - fputsln(_( " outfile output file"), stdout); + fputs(USAGE_SEPARATOR, stdout); fprintf(stdout, USAGE_HELP_OPTIONS(16)); + fprintf(stdout, USAGE_MAN_TAIL("mkfs.cramfs(8)")); exit(MKFS_EX_OK); }