diff --git a/docs/swab.1 b/docs/swab.1 index b1a0834..90b50b0 100644 --- a/docs/swab.1 +++ b/docs/swab.1 @@ -23,9 +23,9 @@ Swap the latter and former halves of a block of bytes. .\" .SH OPTIONS -.IP -f +.IP \fB-f\fP Ignore system call interruptions. -.IP -w +.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 cleanly divisible by 2, otherwise the block of bytes being processed can't be @@ -33,7 +33,9 @@ halved. .\" .SH EXAMPLES -The following sh(1p) line: +The following +.Br sh (1p) +line: .RS .R printf 'hello world!\n' | swab @@ -48,12 +50,16 @@ Produces the following output: .SH DIAGNOSTICS 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. +exit with the appropriate +.BR sysexits.h (3) +error code. .\" .SH RATIONALE This program was modeled and named after the conv=swab functionality specified -in the dd(1p) utility. It additionally allows the word size to be configured. +in the +.BR 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.