[hackers] [sbase] man pages: improve consistency || Hiltjo Posthuma

From: <git_AT_suckless.org>
Date: Tue, 24 Mar 2015 23:53:33 +0100 (CET)

commit 22f4e05b5b9348d11ff38912374acec4794d4147
Author: Hiltjo Posthuma <hiltjo_AT_codemadness.org>
Date: Sun Feb 1 20:52:28 2015 +0100

    man pages: improve consistency

diff --git a/cal.1 b/cal.1
index 01e9e38..5b33591 100644
--- a/cal.1
+++ b/cal.1
_AT_@ -36,23 +36,23 @@ starting the next day on Sep 14, 1752.
 Output current month. This is the default.
 .It Fl 3
 Output previous, current and next month.
+.It Fl c Ar columns
+Set number of calendars in a row. The default is 3.
+.It Fl f Ar firstday
+Output
+.Ar firstday
+(0 is Sunday, 6 is Saturday) as first day of week.
+.It Fl m
+Output Monday as first day of week.
 .It Fl n Ar nmonths
 Output in total
 .Ar nmonths
 starting from the current month.
+.It Fl s
+Output Sunday as first day of week.
 .It Fl y Ar year
 Output an entire
 .Ar year .
-.It Fl s
-Output Sunday as first day of week.
-.It Fl m
-Output Monday as first day of week.
-.It Fl f Ar firstday
-Output
-.Ar firstday
-(0 is Sunday, 6 is Saturday) as first day of week.
-.It Fl c Ar columns
-Set number of calendars in a row. The default is 3.
 .El
 .Sh SEE ALSO
 .Xr localtime 3
diff --git a/cat.1 b/cat.1
index 27461b9..60b304c 100644
--- a/cat.1
+++ b/cat.1
_AT_@ -20,7 +20,7 @@ reads from stdin.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl u
-Unbuffered output
+Unbuffered output.
 .El
 .Sh STANDARDS
 The
diff --git a/chmod.1 b/chmod.1
index b8351ea..5833af3 100644
--- a/chmod.1
+++ b/chmod.1
_AT_@ -11,7 +11,8 @@
 .Op Ar file ...
 .Sh DESCRIPTION
 .Nm
-changes the file mode of the given files.
+changes the file mode of the given
+.Ar files .
 .Pp
 If
 .Ar mode
diff --git a/chown.1 b/chown.1
index d11e0e9..d27f5cd 100644
--- a/chown.1
+++ b/chown.1
_AT_@ -11,13 +11,14 @@
 .Op Ar file ...
 .Sh DESCRIPTION
 .Nm
-changes the user or group ownership for the given files.
+changes the user or group ownership for the given
+.Ar files .
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl R
-equivalent to \-r.
+Equivalent to \-r.
 .It Fl r
-change directory ownership recursively.
+Change directory ownership recursively.
 .El
 .Sh SEE ALSO
 .Xr chown 2
diff --git a/cols.1 b/cols.1
index c51388f..c027118 100644
--- a/cols.1
+++ b/cols.1
_AT_@ -26,12 +26,16 @@ reads from stdin.
 Set the maximum number of character columns to use
 (unless the input contains lines longer than
 .Ar num
-characters). By default cols tries to figure out the width of the output
+characters). By default
+.Nm cols
+tries to figure out the width of the output
 device. If that fails, it defaults to 65 chars.
 .El
 .Sh HISTORY
 .Nm
-is similar to mc(1) in Plan 9. It was renamed to
+is similar to
+.Xr mc 1
+in Plan 9. It was renamed to
 .Nm
 to avoid the name collision with the popular file manager
 Midnight Commander.
diff --git a/cp.1 b/cp.1
index c52ed42..070ec47 100644
--- a/cp.1
+++ b/cp.1
_AT_@ -15,29 +15,36 @@
 .Op Ar directory
 .Sh DESCRIPTION
 .Nm
-copies a given file, naming it the given name. If multiple files are listed
-they will be copied into the given directory.
+copies a given
+.Ar file ,
+naming it the given
+.Ar name .
+If multiple
+.Ar files
+are listed
+they will be copied into the given
+.Ar directory .
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl a
-preserve mode, timestamp, links and permissions. Implies
+Preserve mode, timestamp, links and permissions. Implies
 .Fl d ,
 .Fl p
 and
 .Fl r .
+.It Fl f
+If an existing destination file cannot be opened, remove it and try again.
 .It Fl P
-don't dereference symbolic links.
+Don't dereference symbolic links.
 .It Fl p
-preserve mode, timestamp and permissions.
-.It Fl f
-if an existing destination file cannot be opened, remove it and try again.
+Preserve mode, timestamp and permissions.
 .It Fl R
-equivalent to -r.
+Equivalent to -r.
 .It Fl r
-copies directories recursively. If this flag is not specified, directories
+Copies directories recursively. If this flag is not specified, directories
 are not copied.
 .It Fl v
-print names of source and destination per file to stdout. In the format:
+Print names of source and destination per file to stdout. In the format:
 "source \-> destination".
 .El
 .Sh SEE ALSO
diff --git a/cut.1 b/cut.1
index 752ad97..a315d1d 100644
--- a/cut.1
+++ b/cut.1
_AT_@ -44,19 +44,19 @@ and is written exactly once.
 .It Fl b Ar list | Fl c Ar list
 .Ar list
 specifies byte | character positions.
-.It Fl n
-Do not split multibyte characters. A character is written when its
-last byte is selected.
+.It Fl d Ar delim
+Use
+.Ar delim
+as field delimiter, which can be an arbitrary string. Default is '\\t'.
 .It Fl f Ar list
 .Ar list
 specifies field numbers. Lines not containing field
 delimiters are passed through, unless
 .Fl s
 is specified.
-.It Fl d Ar delim
-Use
-.Ar delim
-as field delimiter, which can be an arbitrary string. Default is '\et'.
+.It Fl n
+Do not split multibyte characters. A character is written when its
+last byte is selected.
 .It Fl s
 Suppress lines not containing field delimiters.
 .El
diff --git a/dirname.c b/dirname.c
index 3d1d526..c7ead85 100644
--- a/dirname.c
+++ b/dirname.c
_AT_@ -9,7 +9,7 @@
 static void
 usage(void)
 {
- eprintf("usage: %s pathname\n", argv0);
+ eprintf("usage: %s path\n", argv0);
 }
 
 int
diff --git a/du.1 b/du.1
index c4e3f0b..2639fde 100644
--- a/du.1
+++ b/du.1
_AT_@ -24,15 +24,15 @@ is displayed.
 .Bl -tag -width Ds
 .It Fl a
 Display an entry for each file in the file hierarchy.
-.It Fl s
-Display only the grand total for the specified files.
 .It Fl d Ar depth
 Maximum directory depth to print files and directories.
+.It Fl h
+Enable human-readable output.
 .It Fl k
 By default all sizes are reported in 512-byte block counts.
 The
 .Fl k
 option causes the numbers to be reported in kilobyte counts.
-.It Fl h
-Enable human readable output.
+.It Fl s
+Display only the grand total for the specified files.
 .El
diff --git a/grep.1 b/grep.1
index d139885..ef68e16 100644
--- a/grep.1
+++ b/grep.1
_AT_@ -17,7 +17,9 @@ searches the input files for lines that match the
 .Ar pattern ,
 a regular expression as defined in
 .Xr regex 7 .
-By default each matching line is printed to stdout. If no file is given
+By default each matching line is printed to stdout. If no
+.Ar file
+is given
 .Nm
 reads from stdin.
 .Sh OPTIONS
_AT_@ -36,7 +38,7 @@ Print only a count of matching lines.
 Specify a pattern used during the search of the input: an input
 line is selected if it matches any of the specified patterns.
 This option is most useful when multiple -e options are used to
-specify multiple patterns, or when a pattern begins with a dash
+specify multiple patterns, or when a pattern begins with a dash.
 .It Fl f Ar file
 Read one or more patterns from the file named by the pathname file.
 Patterns in file shall be terminated by a <newline>. A null pattern can be
diff --git a/head.1 b/head.1
index dfc8a2d..103ed26 100644
--- a/head.1
+++ b/head.1
_AT_@ -18,7 +18,9 @@ writes
 lines of each
 .Ar file
 to stdout.
-If no file is given
+If no
+.Ar file
+is given
 .Nm
 reads from stdin.
 .Sh OPTIONS
diff --git a/hostname.1 b/hostname.1
index 421a753..28dc4df 100644
--- a/hostname.1
+++ b/hostname.1
_AT_@ -13,6 +13,6 @@ sets the current host name to
 .Ar name .
 If no
 .Ar name
-is given, the current host name is written to stdout.
+is given, the current hostname is written to stdout.
 .Sh SEE ALSO
 .Xr hostname 7
diff --git a/kill.1 b/kill.1
index 8d20e7e..bb11c7a 100644
--- a/kill.1
+++ b/kill.1
_AT_@ -21,13 +21,13 @@
 by default sends a TERM signal to the given processes.
 .Sh OPTIONS
 .Bl -tag -width Ds
-.It Fl s Ar signal_name
-A symbolic signal name specifying the signal to be sent instead of the
-default SIGTERM. Sends the named signal.
 .It Fl l Op Ar exit_status
 Lists available signals. If an
 .Ar exit_status
 is given, only the corresponding signal name will be printed.
+.It Fl s Ar signal_name
+A symbolic signal name specifying the signal to be sent instead of the
+default SIGTERM. Sends the named signal.
 .It Fl signal_name
 A symbolic signal name specifying the signal to be sent instead
 of the default SIGTERM.
diff --git a/nl.1 b/nl.1
index 5239437..06c5aad 100644
--- a/nl.1
+++ b/nl.1
_AT_@ -34,7 +34,7 @@ Only non-empty lines (default).
 Only lines which match
 .Ar expr ,
 a regular expression as defined in
-.Xr regex 7
+.Xr regex 7 .
 .El
 .It Fl i Ar incr
 Defines the increment between numbered lines.
diff --git a/seq.1 b/seq.1
index 2994671..e186e79 100644
--- a/seq.1
+++ b/seq.1
_AT_@ -15,20 +15,22 @@
 .Nm
 will print a sequence of numbers from
 .Ar start
-(default 1) to
+(default: 1) to
 .Ar end ,
 in
 .Ar step
-intervals (default 1).
+intervals (default: 1).
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl f Ar format
-specifies the format used for output lines, as per
+Specifies the format used for output lines, as per
 .Xr printf 3 .
 .It Fl s Ar separator
-specifies the separator to print between output lines
+Specifies the separator to print between output lines.
 .It Fl w
-tells seq to print out lines in equal width
+Tells
+.Nm
+to print out lines in equal width.
 .El
 .Sh SEE ALSO
 .Xr printf 3
diff --git a/sha1sum.1 b/sha1sum.1
index 31e4554..8870a01 100644
--- a/sha1sum.1
+++ b/sha1sum.1
_AT_@ -13,5 +13,5 @@ Print SHA-1 (160-bit) checksums. With no file, read standard input.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl c
-read list of SHA1 checksums from file and check them
+Read list of SHA1 checksums from file and check them.
 .El
diff --git a/sha256sum.1 b/sha256sum.1
index 38ce008..debdf10 100644
--- a/sha256sum.1
+++ b/sha256sum.1
_AT_@ -13,5 +13,5 @@ Print SHA256 (256-bit) checksums. With no file, read standard input.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl c
-read list of SHA256 checksums from file and check them
+Read list of SHA256 checksums from file and check them.
 .El
diff --git a/sha512sum.1 b/sha512sum.1
index e52b851..9a9f75f 100644
--- a/sha512sum.1
+++ b/sha512sum.1
_AT_@ -13,5 +13,5 @@ Print SHA512 (512-bit) checksums. With no file, read standard input.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl c
-read list of SHA512 checksums from file and check them
+Read list of SHA512 checksums from file and check them.
 .El
diff --git a/sort.1 b/sort.1
index 969740c..82dbeb1 100644
--- a/sort.1
+++ b/sort.1
_AT_@ -12,23 +12,29 @@
 .Op Ar file ...
 .Sh DESCRIPTION
 .Nm
-writes the sorted concatenation of the given files to stdout. If no file is
-given, sort reads from stdin.
+writes the sorted concatenation of the given
+.Ar files
+to stdout. If no
+.Ar file
+is given,
+.Nm
+reads from stdin.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl C
-check that the concatenation of the given files is sorted rather than sorting
-them. In this mode, no output is printed to stdout, and the exit status
-indicates the result of the check.
+Check that the concatenation of the given
+.Ar files
+is sorted rather than sorting them. In this mode, no output is printed to
+stdout, and the exit status indicates the result of the check.
 .It Fl b
-skip leading whitespace of columns when sorting.
+Skip leading whitespace of columns when sorting.
 .It Fl c
-the same as
+The same as
 .Fl C
 except that when disorder is detected, a message is printed to stderr
 indicating the location of the disorder.
 .It Fl k Ar key
-specifies a key definition of the form
+Specifies a key definition of the form
 .Sm off
 .Sy S
 .No [.
_AT_@ -74,11 +80,11 @@ that only apply to this key definition.
 .Sy b
 is special in that it only applies to the column that it was specified after.
 .It Fl n
-perform a numeric sort.
+Perform a numeric sort.
 .It Fl r
-reverses the sort.
+Reverses the sort.
 .It Fl t Ar delim
-specifies the field delimiter.
+Specifies the field delimiter.
 .It Fl u
-prints equal lines only once.
+Prints equal lines only once.
 .El
diff --git a/split.1 b/split.1
index cef4c8a..83c39cb 100644
--- a/split.1
+++ b/split.1
_AT_@ -34,7 +34,7 @@ Set the suffix length to
 .Ar len
 characters long.
 .It Fl b Ar bytes[k|m|g]
-start a new file every
+Start a new file every
 .Ar bytes
 bytes. The units k, m, and g are case insensitive, and powers of 2, not 10.
 .It Fl d
diff --git a/sponge.1 b/sponge.1
index 70a9bf5..ee2e56b 100644
--- a/sponge.1
+++ b/sponge.1
_AT_@ -14,5 +14,7 @@ reads stdin completely, then writes the saved contents to
 This makes it possible to easily create pipes which read from and write to
 the same file.
 .Pp
-If the given file is a symbolic link, it writes to the links destination
+If the given
+.Ar file
+is a symbolic link, it writes to the links destination
 instead.
diff --git a/tail.1 b/tail.1
index 5c95444..d561a82 100644
--- a/tail.1
+++ b/tail.1
_AT_@ -18,7 +18,7 @@ reads from stdin.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl n Ar lines
-outputs the given number of lines. If
+Outputs the given number of lines. If
 .Ar lines
 begins with '+' it is used as an offset from the beginning of the file.
 .El
diff --git a/true.1 b/true.1
index 7b40ae0..dade3ee 100644
--- a/true.1
+++ b/true.1
_AT_@ -8,7 +8,7 @@
 .Nm
 .Sh DESCRIPTION
 .Nm
-returns a status code indicating success
+returns a status code indicating success.
 .Sh STANDARDS
 The
 .Nm
diff --git a/uname.1 b/uname.1
index 6fa4685..ec007c2 100644
--- a/uname.1
+++ b/uname.1
_AT_@ -9,24 +9,26 @@
 .Op Fl amnrsv
 .Sh DESCRIPTION
 .Nm
-prints system information. If no flags are given, uname will print only the
+prints system information. If no flags are given,
+.Nm
+will print only the
 name of the operating system as
 .Fl s
 would.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl a
-print all the information below.
+Print all the information below.
 .It Fl m
-print the machine's architecture.
+Print the machine's architecture.
 .It Fl n
-print the system's network name.
+Print the system's network name.
 .It Fl r
-print the operating system's release name.
+Print the operating system's release name.
 .It Fl s
-print the name of the operating system.
+Print the name of the operating system.
 .It Fl v
-print the operating system's version name.
+Print the operating system's version name.
 .El
 .Sh SEE ALSO
 .Xr uname 2
diff --git a/unexpand.1 b/unexpand.1
index ff321bc..506d9ed 100644
--- a/unexpand.1
+++ b/unexpand.1
_AT_@ -11,18 +11,20 @@
 .Op Ar file ...
 .Sh DESCRIPTION
 .Nm
-processes the named files or the standard input, writing the
+processes the named
+.Ar files
+or the standard input, writing the
 standard output with consecutive blanks (spaces and tabs) converted
 into tabs. Backspace characters are preserved into the output and
 decrement the column count for tab calculations.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl a
-convert blanks to tabs everywhere, not just at the start of lines
+Convert blanks to tabs everywhere, not just at the start of lines.
 .It Fl t Ar n
-set tab size to
+Set tab size to
 .Ar n
-spaces (default: 8)
+spaces (default: 8).
 .El
 .Sh SEE ALSO
 .Xr expand 1
diff --git a/uniq.1 b/uniq.1
index 761db4a..433053f 100644
--- a/uniq.1
+++ b/uniq.1
_AT_@ -10,16 +10,22 @@
 .Op Ar file
 .Sh DESCRIPTION
 .Nm
-reads file and writes one copy of a line from each group of consecutive
-duplicate lines to stdout. If no file is given, uniq reads from stdin.
+reads
+.Ar file
+and writes one copy of a line from each group of consecutive
+duplicate lines to stdout. If no
+.Ar file
+is given,
+.Nm
+reads from stdin.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl c
-prefixes each line with a count of its consecutive occurrences in the input.
+Prefixes each line with a count of its consecutive occurrences in the input.
 .It Fl d
-suppresses non-duplicate lines (thus 'uniq -d' prints only duplicates).
+Suppresses non-duplicate lines (thus 'uniq -d' prints only duplicates).
 .It Fl u
-suppresses non-unique lines (thus 'uniq -u' prints only uniques).
+Suppresses non-unique lines (thus 'uniq -u' prints only uniques).
 .El
 .Sh BUGS
 The original sbase implementation of
diff --git a/unlink.1 b/unlink.1
index 8110f48..2830ee2 100644
--- a/unlink.1
+++ b/unlink.1
_AT_@ -12,6 +12,6 @@
 calls the
 .Xr unlink 2
 function on
-.Ar file.
+.Ar file .
 .Sh SEE ALSO
 .Xr unlink 2
diff --git a/uudecode.1 b/uudecode.1
index 791a789..5a0ca70 100644
--- a/uudecode.1
+++ b/uudecode.1
_AT_@ -9,7 +9,9 @@
 .Op Ar file
 .Sh DESCRIPTION
 .Nm
-reads file (or by default, the standard input) and writes a decoded
+reads
+.Ar file
+(or by default, the standard input) and writes a decoded
 version to the file specified in the uuencoded header. In case that
 the file already exists, it is truncated. Otherwise a new file is
 created. After the operation the permissions of the created/accessed
diff --git a/uuencode.1 b/uuencode.1
index b9019f5..c0dd4f4 100644
--- a/uuencode.1
+++ b/uuencode.1
_AT_@ -10,9 +10,13 @@
 .Ar name
 .Sh DESCRIPTION
 .Nm
-reads file (or by default, the standard input) and writes an encoded version
+reads
+.Ar file
+(or by default, the standard input) and writes an encoded version
 to the standard output. The encoding uses only printing ASCII characters and
-includes the mode of the file and the operand name for use by uudecode.
+includes the mode of the file and the operand
+.Ar name
+for use by uudecode.
 .Sh IMPLEMENTATION NOTES
 This version of uuencode does not currently support the base64
 encoding algorithm.
diff --git a/xargs.1 b/xargs.1
index ad7fe7b..eaf5723 100644
--- a/xargs.1
+++ b/xargs.1
_AT_@ -11,12 +11,16 @@
 .Op Fl E Ar eofstr
 .Op Ar cmd Op Ar arg...
 .Sh DESCRIPTION
-xargs reads space, tab, newline and EOF delimited strings from stdin
-and executes the specified cmd with the strings as arguments.
+.Nm
+reads space, tab, newline and EOF delimited strings from stdin
+and executes the specified
+.Ar cmd
+with the strings as
+.Ar arguments .
 .Pp
 Any arguments specified on the command line are given to the command upon
 each invocation, followed by some number of the arguments read from
-stdin. The command is repeatedly executed one or more times until stdin
+stdin. The command is repeatedly executed one or more times until stdin
 is exhausted.
 .Pp
 Spaces, tabs and newlines may be embedded in arguments using single (`'')
_AT_@ -28,12 +32,16 @@ newlines, may be escaped by a backslash.
 .Sh OPTIONS
 .Bl -tag -width Ds
 .It Fl n Ar maxargs
-Use at most maxargs arguments per command line.
+Use at most
+.Ar maxargs
+arguments per command line.
 .It Fl r
 Do not run the command if there are no arguments. Normally the command is
 executed at least once even if there are no arguments.
 .It Fl E Ar eofstr
-Use eofstr as a logical EOF marker.
+Use
+.Ar eofstr
+as a logical EOF marker.
 .El
 .Sh EXIT STATUS
 xargs exits with one of the following values:
Received on Tue Mar 24 2015 - 23:53:33 CET

This archive was generated by hypermail 2.3.0 : Wed Mar 25 2015 - 00:07:35 CET