docs, src: fixing man page and usage text readability

This commit is contained in:
Emma Tebibyte 2024-06-29 05:28:23 -06:00
parent e341c38cd6
commit 07a12ba81c
Signed by untrusted user: emma
GPG Key ID: 06FA419A1698C270
5 changed files with 20 additions and 20 deletions

View File

@ -15,13 +15,13 @@ dj
.RB [ -a\ byte ]
.RB [ -c\ count ]
.RB [ -i\ input_file ]
.RB [ -b\ input_block_size ]
.RB [ -s\ input_offset ]
.RB [ -i\ file ]
.RB [ -b\ block_size ]
.RB [ -s\ offset ]
.RB [ -o\ output_file ]
.RB [ -B\ output_block_size ]
.RB [ -S\ output_offset ]
.RB [ -o\ file ]
.RB [ -B\ block_size ]
.RB [ -S\ offset ]
.\"
.SH DESCRIPTION
@ -39,25 +39,25 @@ immediately subsequent to the specified byte.
.\"
.SH OPTIONS
.IP \fB-i\fP
.IP \fB-i\fP\ \fIfile\fP
Takes a file path as an argument and opens it for use as an input.
.IP \fB-b\fP
.IP \fB-b\fP\ \fIblock_size\fP
Takes a numeric argument as the size in bytes of the input buffer, the default
being 1024.
.IP \fB-s\fP
.IP \fB-s\fP\ \fIoffset\fP
Takes a numeric argument as the number of bytes to skip into the input
before starting to read. If the standard input is used, bytes read to this point
are discarded.
.IP \fB-o\fP
.IP \fB-o\fP\ \fIfile\fP
Takes a file path as an argument and opens it for use as an output.
.IP \fB-B\fP
.IP \fB-B\fP\ \fIblock_size\fP
Does the same as
.B -b
but for the output buffer.
.IP \fB-S\fP
.IP \fB-S\fP\ \fIoffset\fP
Seeks a number of bytes through the output before starting to write from
the input. If the output is a stream, null characters are printed.
.IP \fB-a\fP
.IP \fB-a\fP\ \fIbyte\fP
Accepts a single literal byte with which the input buffer is padded in the event
of an incomplete read from the input file.
.IP \fB-A\fP
@ -65,7 +65,7 @@ Specifying this option pads the input buffer with null bytes in the event of an
incomplete read. This is equivalent to specifying
.B -a
with a null byte instead of a character.
.IP \fB-c\fP
.IP \fB-c\fP\ \fIcount\fP
Specifies a number of reads to make. The default is 0, in which case the
input is read until a partial or empty read is made.
.IP \fB-d\fP

View File

@ -22,7 +22,7 @@ Performs operations on specified fields in data read from the standard input.
.\"
.SH OPTIONS
.IP \fB-d\fP
.IP \fB-d\fP\ \fIdelimiter\fP
Sets a delimiter by which the input data will be split into fields. The default
is an ASCII record separator.
.\"

View File

@ -24,10 +24,10 @@ Catenate input files and write them to the start of each output file or stream.
Opens subsequent outputs for appending rather than updating.
.IP \fB-e\fP
Use the standard error as an output.
.IP \fB-i\fP
.IP \fB-i\fP\ \fIinput\fP
Opens a path as an input. If one or more of the input files is \(lq-\(rq or if
no inputs are specified, the standard input shall be used.
.IP \fB-o\fP
.IP \fB-o\fP\ \fIoutput\fP
Opens a path as an output. If one or more of the output files is \(lq-\(rq or if
no outputs are specified, the standard output shall be used.
.IP \fB-u\fP

View File

@ -22,7 +22,7 @@ Swap the latter and former halves of a block of bytes.
.IP \fB-f\fP
Ignore SIGINT signal.
.IP \fB-w\fP
.IP \fB-w\fP\ \fIword_size\fP
Configures the word size; that is, the size in bytes of the block size on which
to operate. The default word size is 2. The word size must be cleanly divisible
by 2, otherwise the block of bytes being processed can\(cqt be halved.

View File

@ -314,8 +314,8 @@ static int
usage(void){
fprintf(stderr, "Usage: %s [-AdfHqQ] [-a byte] [-c count]\n"
"\t[-i input_file] [-b input_block_size] [-s input_offset]\n"
"\t[-o output_file] [-B output_block_size] [-S output_offset]\n",
"\t[-i file] [-b block_size] [-s offset]\n"
"\t[-o file] [-B block_size] [-S offset]\n",
program_name);
return EX_USAGE;