fsck: mark file descriptor for -C as optional in help text

Also slightly improve the man page.

Signed-off-by: Benno Schulenberg <bensberg@justemail.net>

diff --git a/disk-utils/fsck.8 b/disk-utils/fsck.8
index 344a06fec585c0a698178f28db7f82833a9b6bfe..3bb54d50a9e62b765a32ff24a2829d883fb19a1f 100644 (file)
--- a/disk-utils/fsck.8
+++ b/disk-utils/fsck.8
@@ -12,7 +12,7 @@ fsck \- check and repair a Linux filesystem
 .RI [ fd ]]
 .RB [ \-t
 .IR fstype ]
-.RI [ filesys ...]
+.RI [ filesystem ...]
 .RB [ \-\- ]
 .RI [ fs-specific-options ]
 .SH DESCRIPTION
@@ -66,7 +66,7 @@ Operational error
 Usage or syntax error
 .TP
 .B 32
-Fsck canceled by user request
+Checking canceled by user request
 .TP
 .B 128
 Shared-library error
@@ -225,7 +225,8 @@ with filesystems with the lowest
 .I fs_passno
 number being checked first.
 If there are multiple filesystems with the same pass number,
-fsck will attempt to check them in parallel, although it will avoid running
+.B fsck
+will attempt to check them in parallel, although it will avoid running
 multiple filesystem checks on the same physical disk.
 .sp
 .B fsck
@@ -264,9 +265,9 @@ skip non-existing devices.
 also skips non-existing devices that have the special filesystem type
 .BR auto .
 .TP
-.B \-C\fR [ \fI "fd" \fR ]
+.BR \-C \ [ \fIfd\fR ]
 Display completion/progress bars for those filesystem checkers (currently
-only for ext2 and ext3) which support them.   Fsck will manage the
+only for ext2 and ext3) which support them.  \fBfsck\fR will manage the
 filesystem checkers so that only one of them will display
 a progress bar at a time.  GUI front-ends may specify a file descriptor
 .IR fd ,
@@ -306,7 +307,7 @@ that are executed.
 .B fs-specific-options
 Options which are not understood by
 .B fsck
-are passed to the filesystem-specific checker.  These arguments
+are passed to the filesystem-specific checker.  These options
 .B must
 not take arguments, as there is no
 way for
@@ -319,7 +320,7 @@ Options and arguments which follow the
 are treated as filesystem-specific options to be passed to the
 filesystem-specific checker.
 .IP
-Please note that fsck is not
+Please note that \fBfsck\fR is not
 designed to pass arbitrarily complicated options to filesystem-specific
 checkers.  If you're doing something complicated, please just
 execute the filesystem-specific checker directly.  If you pass

diff --git a/disk-utils/fsck.c b/disk-utils/fsck.c
index 16746ab14f3520e22c0cc5a84af11e8d81501750..e72d78d5bf6623c0ca2dc1a2ea59cbc39c5f6219 100644 (file)
--- a/disk-utils/fsck.c
+++ b/disk-utils/fsck.c
@@ -1296,7 +1296,7 @@ static int check_all(void)
 static void __attribute__((__noreturn__)) usage(void)
 {
        printf(_("\nUsage:\n"
-                " %s [fsck-options] [fs-options] [filesys ...]\n"),
+                " %s [options] [fs-options] [<filesystem>...]\n"),
                program_invocation_short_name);
 
        puts(_( "\nOptions:\n"
@@ -1311,7 +1311,7 @@ static void __attribute__((__noreturn__)) usage(void)
                " -l         lock the device using flock()\n"
                " -N         do not execute, just show what would be done\n"
                " -T         do not show the title on startup\n"
-               " -C <fd>    display progress bar; file descriptor is for GUIs\n"
+               " -C [<fd>]  display progress bar; file descriptor is for GUIs\n"
                " -V         explain what is being done\n"
                " -?         display this help and exit\n\n"
                "See fsck.* commands for fs-options."));