Skip to contentSkip to conversation

fdisk: remove angle brackets from usage

PATCH In review Phillip Susi 2 participants 4 messages Nov 18, 2013 – Nov 19, 2013 Util-Linux package

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 fdisk: remove angle brackets from usage

Remove superfluous angle brackets and use square brackets where appropriate to conform to the man page convention.

---
 fdisks/fdisk.c | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)
fdisks/fdisk.c +11 -11
index 874f9d1..3572c64 100644
@@ -50,22 +50,22 @@ static void __attribute__ ((__noreturn__)) usage(FILE *out)
 	fputs(USAGE_HEADER, out);
 
 	fprintf(out,
-	      _(" %1$s [options] <disk>    change partition table\n"
-	        " %1$s [options] -l <disk> list partition table(s)\n"),
+	      _(" %1$s [options] [disk]    change partition table\n"
+	        " %1$s [options] -l [disk] list partition table(s)\n"),
 	       program_invocation_short_name);
 
 	fputs(USAGE_OPTIONS, out);
-	fputs(_(" -b <size>         sector size (512, 1024, 2048 or 4096)\n"), out);
-	fputs(_(" -c[=<mode>]       compatible mode: 'dos' or 'nondos' (default)\n"), out);
+	fputs(_(" -b size           sector size (512, 1024, 2048 or 4096)\n"), out);
+	fputs(_(" -c[=mode]         compatible mode: 'dos' or 'nondos' (default)\n"), out);
 	fputs(_(" -h                print this help text\n"), out);
-	fputs(_(" -c[=<mode>]       compatible mode: 'dos' or 'nondos' (default)\n"), out);
-	fputs(_(" -L[=<when>]       colorize output (auto, always or never)\n"), out);
-	fputs(_(" -t <type>         force fdisk to recognize specified partition table type only\n"), out);
-	fputs(_(" -u[=<unit>]       display units: 'cylinders' or 'sectors' (default)\n"), out);
+	fputs(_(" -c[=mode]         compatible mode: 'dos' or 'nondos' (default)\n"), out);
+	fputs(_(" -L[=when]         colorize output (auto, always or never)\n"), out);
+	fputs(_(" -t type           force fdisk to recognize specified partition table type only\n"), out);
+	fputs(_(" -u[=unit]         display units: 'cylinders' or 'sectors' (default)\n"), out);
 	fputs(_(" -v                print program version\n"), out);
-	fputs(_(" -C <number>       specify the number of cylinders\n"), out);
-	fputs(_(" -H <number>       specify the number of heads\n"), out);
-	fputs(_(" -S <number>       specify the number of sectors per track\n"), out);
+	fputs(_(" -C number         specify the number of cylinders\n"), out);
+	fputs(_(" -H number         specify the number of heads\n"), out);
+	fputs(_(" -S number         specify the number of sectors per track\n"), out);
 
 	fprintf(out, USAGE_MAN_TAIL("fdisk(8)"));
 	exit(out == stderr ? EXIT_FAILURE : EXIT_SUCCESS);
Signature · 1 line
1.8.3.2
maintainer
#1 lore raw
Quoted 2 lines · Phillip Susi

Remove superfluous angle brackets and use square brackets where appropriate to conform to the man page convention.

The angle brackets are expected, see Documentation/howto-usage-function.txt.

Karel

Signature · 2 lines
 Karel Zak  <[email protected]>
 http://karelzak.blogspot.com
#2 lore raw

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Quoted 6 lines · Karel Zak
Quoted 2 lines · Phillip Susi

Remove superfluous angle brackets and use square brackets where appropriate to conform to the man page convention.

The angle brackets are expected, see
Documentation/howto-usage-function.txt.

In that case, then fdisk should have square brackets added around the <disk> since it is an optional argument.

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (MingW32)
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBAgAGBQJSi3ksAAoJEJrBOlT6nu759TsH/2CdeIsN/IV8YgFmxaWDtI2+ cEXaGHsZSOrRJuiAbfQt/ktA5+V7x0VtyUZJanZtpHB3upNB2gz831cP3d2Tbw/z 6G8NFCy/IoJzZANci/5e+bcVch8r4mFHKv8ia8VUEUjbRMDBJxQ8QEKNu2MjuEPk 78GZmtObY6C/hn7Ec4842IXgzsNHozzc8a0ftC7g4zfsNmcUxwmwljuLrDd9ESrd DuZhozwtHfsZrWURnX3gQcI/OvDXexZ8PGMO2Of9xYinw+1gvMkFQgULmwt/6HIO SCaPc9wwNwdFDx45krXy/8dtolvIZ4my16LJTjiGGr/6tBUwkwLwT12dKj2Mbog= =ouFR
-----END PGP SIGNATURE-----

maintainer
#3 lore raw
Quoted 5 lines · Phillip Susi

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Quoted 1 line · Karel Zak

On Mon, Nov 18, 2013 at 02:42:34PM -0500, Phillip Susi wrote:

Quoted 8 lines
Quoted 5 lines
Quoted 2 lines

Remove superfluous angle brackets and use square brackets where appropriate to conform to the man page convention.

The angle brackets are expected, see
Documentation/howto-usage-function.txt.

In that case, then fdisk should have square brackets added around the <disk> since it is an optional argument.

Yes, it's optional for -l. Fixed. Thanks.

Karel

Signature · 2 lines
 Karel Zak  <[email protected]>
 http://karelzak.blogspot.com