@@ -61,1 +52,4 @@
+Takes no arguments and pads with nuls.
+.RE
+
 .B -B

@@ -69,0 +61,4 @@
+
+.B -H
+.RS
+Prints diagnostics messages in an alternate manner as described in the

@@ -71,2 +69,4 @@
+.RS
+Skips a number of bytes through the output before starting to write from
 the input. If the input is a stream the bytes are read and discarded. If the
 output is a stream, nul characters are printed.

@@ -80,1 +76,3 @@
-The
+.RS
+Takes one argument of one byte in length and pads the input buffer with
+that byte in the event that a read doesn’t fill the input buffer, and the

@@ -85,0 +92,4 @@
+
+.B -d
+.RS
+Prints all debug information, user-specified or otherwise, before program

@@ -85,0 +98,4 @@
+
+.B -i
+.RS
+Takes a path as an argument to open and use in place of standard input.

@@ -85,0 +103,4 @@
+
+.B -n
+.RS
+Causes dj to exit on two consecutive empty reads instead of one.

@@ -85,0 +111,4 @@
+Does the same as
+.B -i
+but in place of standard output. Dj does not truncate output
+files and instead writes over the bytes in the existing file.

@@ -85,0 +117,4 @@
+.B -s
+.RS
+Takes a numeric argument as the number of bytes to skip into the input
+before starting to read.

@@ -85,0 +125,4 @@
+Suppresses error messages which print when a read or write is partial or
+empty. When
+.B -q
+is specified twice suppresses diagnostic output entirely.

@@ -151,1 +180,3 @@
-use.
+The dd(1p) utility specified in POSIX was the basis of this program.
+
+It includes additional features: typical option formatting, allowing seeks to be

@@ -152,0 +183,4 @@
+specified in bytes rather than in blocks, allowing arbitrary bytes as padding, 
+and printing in a format that’s easy to parse for machines. It also neglects
+character conversion. This may have been the original intent of dd(1p) but it is
+irrelevant to its modern use as a disk utility.

@@ -15,2 +15,2 @@
-False does nothing regardless of operands or standard input.
-False will always return an exit code of 1.
+Do nothing regardless of operands or standard input.
+An exit code of 1 will always be returned.

@@ -20,3 +20,3 @@
 .SH DESCRIPTION
 
-Intcmp compares integers.
+Compare integers.

@@ -33,0 +29,4 @@
+.B -g
+or
+.B -l
+, only adjacent integers in the argument sequence can be equal.

@@ -48,3 +66,3 @@
 There are multiple ways to express compound comparisons; “less than or equal
 to” can be -le or -el, for example.
-.PP
+

@@ -39,2 +28,2 @@
-standard output. Standard output itself can be specified by giving the
-path '-'. Standard error itself can be specified with the
+.RS
+Opens subsequent outputs for appending rather than updating.

@@ -43,2 +33,2 @@
-.PP
-The
+.RS
+Set the output to the standard error.

@@ -61,3 +68,3 @@
 .SH BUGS
 
-Mm does not truncate existing files, which may lead to unexpected results.
+Existing files are not truncated, which may lead to unexpected results.

@@ -67,1 +74,3 @@
-Mm was modeled after the cat and tee utilities specified in POSIX.
+The cat(1p) and tee(1p) programs specified in POSIX provide equivalent
+functionality. The separation of the two sets of functionality into separate
+APIs seemed unncessary.

@@ -25,0 +21,4 @@
+
+The program reads from standard input and writes to standard output, replacing
+non-printing characters with printable equivalents. Control characters print as
+a carat (“^”) followed by the character “@” through “_” corresponding to the

@@ -20,3 +20,2 @@
 
-Str tests each character in an arbitrary quantity of string arguments against
-the function of the same name within ctype(3).
+Test string arguments against each other.

@@ -38,1 +39,3 @@
-('').
+Originally, there was an isvalue type as an extension to ctype.h(3), but it
+was removed in favor of using strcmp(1) to compare strings against the empty
+string ('').

@@ -39,2 +39,2 @@
-Unicode strings may need to be normalized if the intent is to check visual
-similarity and not byte similarity.
+The program will exit unsuccessfully if the given strings are not identical;
+therefore, unicode strings may need to be normalized if the intent is to check

@@ -48,0 +51,4 @@
+.RS
+If the output is a stream, nul bytes are printed. In other words, it does what
+.B -a
+does but with null bytes instead.

@@ -70,2 +71,3 @@
-option skips a number of bytes through the output before starting to write from
+.RS
+Skips a number of bytes through the output before starting to write from
 the input. If the input is a stream the bytes are read and discarded. If the

@@ -85,0 +129,4 @@
+.SH STANDARD INPUT
+
+The standard input shall be used as an input if one or more of the input files
+is “-”.

@@ -39,2 +28,2 @@
-standard output. Standard output itself can be specified by giving the
-path '-'. Standard error itself can be specified with the
+.RS
+Opens outputs for appending rather than updating.

@@ -45,0 +37,4 @@
+.B -i
+.RS
+Opens a path as an input. Without any inputs specified mm will use the
+standard input.

@@ -66,2 +78,3 @@
 
-Mm was modeled after the cat and tee utilities specified in POSIX.
+The cat(1p) and tee(1p) programs specified in POSIX together provide nearly
+equivalent functionality. The separation of the two sets of functionality into

@@ -96,0 +76,4 @@
+
+.B -a
+.RS
+Takes one argument of one byte in length and pads the input buffer with it in

@@ -96,0 +88,4 @@
+
+.B -c
+.RS
+Specifies an amount of reads to make, and if 0 (the default) dj will

@@ -107,4 +147,4 @@
 .R {records read} {ASCII unit separator} {partial records read}
 .R {ASCII record separator} {records written} {ASCII unit separator}
 .R {partial records written} {ASCII group separator} {bytes read}
 .R {ASCII record separator} {bytes written} {ASCII file separator}

@@ -116,3 +157,4 @@
+.RS
 .R {records read} '+' {partial records read} '>' {records written}
 .R '+' {partial records written} ';' {bytes read} '>' {bytes written}
 .R {ASCII line feed}

@@ -20,3 +20,3 @@
 .SH DESCRIPTION
 
-Intcmp compares integers.
+Compare integers to each other.

@@ -65,1 +56,3 @@
-The
+.RS
+Takes a numeric argument as the size in bytes of the input buffer, with the
+default being 1024 bytes or one kibibyte (KiB).

@@ -94,0 +100,4 @@
+If the output is a stream, null bytes are printed. This option is equivalent to
+specifying
+.B -a
+with a null byte instead of a character.

@@ -56,2 +51,2 @@
-.PP
-The
+.RS
+Takes a file path as an argument to open and use as an input.

@@ -69,0 +67,4 @@
+
+.B -o
+.RS
+Takes a file path as an argument to open and use as an output.

@@ -73,2 +81,2 @@
-.PP
-The
+.RS
+Skips a number of bytes through the output before starting to write from

@@ -92,2 +93,2 @@
-.B -q
-is specified a second time. The
+.RS
+Specifies a number of reads to make. If set to zero (the default), reading will

@@ -81,1 +89,4 @@
+of an incomplete read from the input file.
+.RE
+
 .B -c

@@ -96,0 +129,4 @@
+
+.SH STANDARD INPUT
+
+The standard input shall be used as an input if no inputs are specified one or

@@ -106,1 +137,3 @@
-.PP
+On a partial or empty read, a diagnostic message is printed (unless the
+.B -q
+option is specified) and the program exits (unless the

@@ -107,0 +140,4 @@
+.B -n
+option is specified.
+
+By default statistics are printed for input and output to the standard error in

@@ -128,0 +164,4 @@
+If the
+.B -d
+option is specified, debug output will be printed at the beginning of execution.
+This debug information contains information regarding how the program was

@@ -128,2 +179,4 @@
+diagnostic message is printed and the program exits with the appropriate
+sysexits.h(3) status.
 
 .SH BUGS

@@ -96,0 +118,4 @@
+
+.B -n
+.RS
+Retries failed reads once more before exiting.

@@ -136,25 +189,29 @@ expected (the product of the count multiplied by the input block size). If the
 or
 .B -A
 options are used this could make data written nonsensical.

@@ -138,3 +191,3 @@
 options are used this could make data written nonsensical.
-.PP
+
 Many lowercase options have capitalized variants and vice-versa which can be

@@ -148,0 +203,4 @@
+This program was based on the dd(1p) utility as specified in POSIX. While
+character conversion may have been the original intent of dd(1p), it is
+irrelevant to its modern use. Because of this, it eschews character conversion
+and adds typical option formatting, allowing seeks to be specified in bytes

@@ -147,1 +203,3 @@
-features: typical option formatting, allowing seeks to be specified in bytes
+This program was based on the dd(1p) utility as specified in POSIX. While
+character conversion may have been the original intent of dd(1p), it is
+irrelevant to its modern use. Because of this, it eschews character conversion

@@ -149,3 +208,1 @@
-format that's easy to parse for machines. It also neglects character
-conversion, which may be dd's original intent but is irrelevant to its modern
-use.
+format that’s easy to parse for machines.

@@ -158,3 +194,2 @@
 .SH SEE ALSO
-
-dd(1)
+.BR dd (1p)

@@ -58,0 +54,4 @@
+.BR dd (1p)
+utility and is used here to decrease ambiguity.
+
+When seeking or skipping to a byte, writing or reading starts at the byte

@@ -0,0 +24,4 @@
+
+.IP \fB-d\fP
+Sets a delimiter by which the input data will be split into fields. The default
+is an ASCII record separator (␞).

@@ -40,0 +35,4 @@
+.BR ls (1)
+implementation contains a human-readable option (\fB-h\fP) that, when specified,
+makes the tool print size information in a format more immediately readable.
+This functionality is useful not only in the context of

@@ -65,1 +68,3 @@
-test(1p).
+been
+.BR test (1).
+This tool also handles string comparisons and file scrutiny. These parts of its

@@ -22,3 +20,2 @@
 
-Mm catenates input files and writes them to the start of each output file.
-
+Catenate input files and write them to the start of each output file or stream.

@@ -52,3 +41,4 @@
+.\"
 .SH DIAGNOSTICS
 
 If an output can no longer be written mm prints a diagnostic message, ceases

@@ -61,3 +48,1 @@
-.SH BUGS
-
-Mm does not truncate existing files, which may lead to unexpected results.
+When an error is encountered, diagnostic message is printed and the program

@@ -35,1 +28,4 @@
+.SH USAGE
 
+.IP \fB-e\fP
+Prints a currency sign ('$') before each line ending.

@@ -36,3 +39,2 @@
 
-If encountering a syntax error, rpn will exit with the appropriate error code
-as defined by sysexits.h(3) and print an error message.
+In the event of a syntax error, the program will print an

@@ -38,2 +40,3 @@
-as defined by sysexits.h(3) and print an error message.
+In the event of a syntax error, the program will print an
 
+In the event of an error, a debug message will be printed and the program will

@@ -19,3 +17,2 @@
 
-Scrut determines if given files comply with the opted requirements.
-
+Determine if files comply with requirements.

@@ -65,0 +28,4 @@
+.IP \fB-c\fP
+Requires the given files to exist and be character special files.
+.IP \fB-d\fP
+Requires the given files to exist and be directories.

@@ -65,0 +32,4 @@
+.IP \fB-e\fP
+Requires the given files to exist, and is redundant to any other option.
+.IP \fB-f\fP
+Requires the given files to exist and be regular files.

@@ -65,0 +40,4 @@
+.IP \fB-p\fP
+Requires the given files to exist and be named pipes.
+.IP \fB-r\fP
+Requires the given files to exist and be readable.

@@ -65,0 +44,4 @@
+.IP \fB-u\fP
+Requires the given files to exist and have their set user ID flags set.
+.IP \fB-w\fP
+Requires the given files to exist and be writable.

@@ -65,0 +46,4 @@
+.IP \fB-w\fP
+Requires the given files to exist and be writable.
+.IP \fB-x\fP
+Requires the given files to exist and be executable.

@@ -65,2 +51,3 @@
+.SH DIAGNOSTICS
 
-.SH EXIT STATUS
+If the given files comply with the specified requirements, the program will exit

@@ -44,3 +42,2 @@
-.PP
-If a character in a string isn't valid ASCII str will exit unsuccessfully.
 
+If a character in a string isn\(cqt valid ASCII the program will exit

@@ -49,1 +52,3 @@
-test(1p).
+been
+.BR test (1).
+This tool also handles integer comparisons and file scrutiny. These parts of its

@@ -24,1 +24,4 @@
+.SH OPTIONS
 
+.IP \fB-f\fP
+Ignore system call interruptions.

@@ -25,0 +27,4 @@
+Ignore system call interruptions.
+.IP \fB-w\fP
+Configures the word size; that is, the size in bytes of the block size
+on which to operate. By default the word size is 2. The word size must be

@@ -28,2 +38,4 @@
+line:
 
+.RS
 .R printf 'hello world!\n' | swab

@@ -16,2 +13,2 @@
-True will always return an exit code of 0.
-
+Do nothing regardless of operands or standard input.
+An exit code of 0 will always be returned.