docs: remove unnecessary references to the name of each program

docs/swab.1

@@ -1,4 +1,5 @@
 .\" Copyright (c) 2024 DTB <trinity@trinity.moe>
+.\" Copyright (c) 2024 Emma Tebibyte <emma@tebibyte.media>
 .\"
 .\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
 .\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
@@ -20,46 +21,51 @@ swab
 
 .SH USAGE
 
-Swab swaps the latter and former halves of a block of bytes.
+Swap the latter and former halves of a block of bytes.
+
+.SH OPTIONS
+
+.B -f
+.RS
+Ignore system call interruptions.
+.RE
+
+.B -w
+.RS
+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
+cleanly divisible by 2, otherwise the block of bytes being processed can't be
+halved.
+.RE
 
 .SH EXAMPLES
 
 The following sh(1p) line:
 
+.RS
 .R printf 'hello world!\n' | swab
+.RE
 
 Produces the following output:
 
+.RS
 .R ehll oowlr!d
-
-.SH OPTIONS
-
-The
-.B -f
-option ignores system call interruptions.
-.PP
-The
-.B -w
-option 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
-cleanly divisible by 2, otherwise the block of bytes being processed can't be
-halved.
+.RE
 
 .SH DIAGNOSTICS
 
-If an error is encountered in input, output, or invocation, a diagnostic
-message will be written to standard error and swab will exit with the
-appropriate status from sysexits.h(3).
+In the event of an error, a debug message will be printed and the program will
+exit with the appropriate sysexits.h(3) error code.
 
 .SH RATIONALE
 
-Swab was modeled after the
+This program was modeled and named after the
 .R conv=swab
-functionality specified in the POSIX dd utility but additionally allows the
-word size to be configured.
-.PP
-Swab is useful for fixing the endianness of binary files produced on other
-machines.
+functionality specified in the dd(1p) utility. It additionally allows the word
+size to be configured.
+
+This functionality is useful for fixing the endianness of binary files produced
+on other machines.
 
 .SH COPYRIGHT