docs: formatting

This commit is contained in:
Emma Tebibyte 2024-06-04 16:11:33 -06:00
parent 896b251434
commit f4cad598c4
Signed by untrusted user: emma
GPG Key ID: 06FA419A1698C270
8 changed files with 57 additions and 44 deletions

View File

@ -32,7 +32,7 @@ It may help to think of the -e, -g, and -l options as equivalent to the
infix algebraic \(lq=\(rq, \(lq>\(rq, and \(lq<\(rq operators respectively, with infix algebraic \(lq=\(rq, \(lq>\(rq, and \(lq<\(rq operators respectively, with
each option putting its symbol between every given integer. The following each option putting its symbol between every given integer. The following
example is equivalent to evaluating \(lq1 < 2 < 3\(rq: example is equivalent to evaluating \(lq1 < 2 < 3\(rq:
\"
.RS .RS
.R intcmp -l 1 2 3 .R intcmp -l 1 2 3
.RE .RE

View File

@ -22,21 +22,21 @@ Catenate input files and write them to the start of each output file or stream.
.\" .\"
.SH OPTIONS .SH OPTIONS
.IP -a .IP \fB-a\fP
Opens subsequent outputs for appending rather than updating. Opens subsequent outputs for appending rather than updating.
.IP -e .IP \fB-e\fP
Use the standard error as an output. Use the standard error as an output.
.IP -i .IP \fB-i\fP
Opens a path as an input. Without any inputs specified mm will use the Opens a path as an input. Without any inputs specified mm will use the
standard input. The standard input shall be used as an input if one or more of standard input. The standard input shall be used as an input if one or more of
the input files is “-”. the input files is \(lq-\(rq.
.IP -o .IP \fB-o\fP
Opens a path as an output. Without any outputs specified mm will use the Opens a path as an output. Without any outputs specified mm will use the
standard output. The standard output shall be used as an output if one or more standard output. The standard output shall be used as an output if one or more
of the output files is “-”. of the output files is \(lq-\(rq.
.IP -u .IP \fB-u\fP
Ensures neither input or output will be buffered. Ensures neither input or output will be buffered.
.IP -n .IP \fB-n\fP
Causes SIGINT signals to be ignored. Causes SIGINT signals to be ignored.
.\" .\"
.SH DIAGNOSTICS .SH DIAGNOSTICS
@ -66,7 +66,7 @@ unncessary.
.\" .\"
.SH COPYRIGHT .SH COPYRIGHT
Copyright (c) 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later Copyright \(co 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/agpl.html>. <https://gnu.org/licenses/agpl.html>.
.\" .\"
.SH SEE ALSO .SH SEE ALSO

View File

@ -27,9 +27,9 @@ high bit set.
.\" .\"
.SH USAGE .SH USAGE
.IP -e .IP \fB-e\fP
Prints a currency sign ('$') before each line ending. Prints a currency sign ('$') before each line ending.
.IP -t .IP \fB-t\fP
Prints tab characters as '^I' rather than a literal horizontal tab. Prints tab characters as '^I' rather than a literal horizontal tab.
.\" .\"
.SH DIAGNOSTICS .SH DIAGNOSTICS
@ -69,7 +69,6 @@ Copyright © 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later
.\" .\"
.SH SEE ALSO .SH SEE ALSO
.BR cat (1p), .BR cat (1p),
.BR cat-v (1) .BR cat-v (1),
.I UNIX Style, or cat -v Considered Harmful .I UNIX Style, or cat -v Considered Harmful
by Rob Pike by Rob Pike

View File

@ -26,7 +26,8 @@ Upon evaluation, the program will print the resulting number on the stack to the
standard output. Any further specified numbers will be placed at the end of the standard output. Any further specified numbers will be placed at the end of the
stack. stack.
For information on for reverse polish notation syntax, see rpn(7). For information on for reverse polish notation syntax, see
.BR rpn (7).
.\" .\"
.SH STANDARD INPUT .SH STANDARD INPUT
@ -40,7 +41,7 @@ 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 In the event of an error, a debug message will be printed and the program will
exit with the appropriate exit with the appropriate
.BR sysexits.h(3) .BR sysexits.h (3)
error code. error code.
.\" .\"
.SH CAVEATS .SH CAVEATS
@ -80,5 +81,5 @@ Copyright (c) 2024 Emma Tebibyte. License AGPLv3+: GNU AGPL version 3 or later
.SH SEE ALSO .SH SEE ALSO
.BR bc (1p), .BR bc (1p),
.BR dc (1), .BR dc (1),
.BR rpn(7), .BR rpn (7),
.I IEEE 754 .I IEEE 754

View File

@ -10,7 +10,7 @@ scrut \(en scrutinize file properties
.SH SYNOPSIS .SH SYNOPSIS
scrut scrut
.RB ( -bcdefgkprsuwxLS ) .RB ( -LSbcdefgkprsuwx )
.RB [ file... ] .RB [ file... ]
.\" .\"
.SH DESCRIPTION .SH DESCRIPTION
@ -19,33 +19,33 @@ Determine if files comply with requirements.
.\" .\"
.SH OPTIONS .SH OPTIONS
.IP -L .IP \fB-L\fB
Requires the given files to exist and be symbolic links. Requires the given files to exist and be symbolic links.
.IP -S .IP \fB-S\fP
Requires the given files to exist and be sockets. Requires the given files to exist and be sockets.
.IP -b .IP \fB-b\fP
Requires the given files to exist and be block special files. Requires the given files to exist and be block special files.
.IP -c .IP \fB-c\fP
Requires the given files to exist and be character special files. Requires the given files to exist and be character special files.
.IP -d .IP \fB-d\fP
Requires the given files to exist and be directories. Requires the given files to exist and be directories.
.IP -e .IP \fB-e\fP
Requires the given files to exist, and is redundant to any other option. Requires the given files to exist, and is redundant to any other option.
.IP -e .IP \fB-f\fP
Requires the given files to exist and be regular files. Requires the given files to exist and be regular files.
.IP -g .IP \fB-g\fP
Requires the given files to exist and have their set group ID flags set. Requires the given files to exist and have their set group ID flags set.
.IP -k .IP \fB-k\fP
Requires the given files to exist and have their sticky bit set. Requires the given files to exist and have their sticky bit set.
.IP -p .IP \fB-p\fP
Requires the given files to exist and be named pipes. Requires the given files to exist and be named pipes.
.IP -r .IP \fB-r\fP
Requires the given files to exist and be readable. Requires the given files to exist and be readable.
.IP -u .IP \fB-u\fP
Requires the given files to exist and have their set user ID flags set. Requires the given files to exist and have their set user ID flags set.
.IP -w .IP \fB-w\fP
Requires the given files to exist and be writable. Requires the given files to exist and be writable.
.IP -x .IP \fB-x\fP
Requires the given files to exist and be executable. Requires the given files to exist and be executable.
.\" .\"
.SH DIAGNOSTICS .SH DIAGNOSTICS

View File

@ -31,14 +31,17 @@ An empty string will cause an unsuccessful exit as none of its contents pass any
tests. tests.
When invoked incorrectly, a debug message will be printed and the program will When invoked incorrectly, 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 CAVEATS .SH CAVEATS
Theres no way of knowing which argument failed the test without re-testing There\(cqs no way of knowing which argument failed the test without re-testing
arguments individually. arguments individually.
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
unsuccessfully.
.\" .\"
.SH AUTHOR .SH AUTHOR
@ -48,7 +51,7 @@ Written by DTB
.\" .\"
.SH COPYRIGHT .SH COPYRIGHT
Copyright © 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later Copyright \(co 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/gpl.html>. <https://gnu.org/licenses/gpl.html>.
.\" .\"
.SH SEE ALSO .SH SEE ALSO

View File

@ -21,9 +21,19 @@ Check whether string arguments are the same.
.SH DIAGNOSTICS .SH DIAGNOSTICS
The program will exit successfully if the strings are identical. Otherwise, it The program will exit successfully if the strings are identical. Otherwise, it
exits with the value 1 if an earlier string has a greater byte value than a will exit with an error code of 1 if a string passed has a lesser byte value
later string (e.g. strcmp b a) and 255 if an earlier string has a lesser byte than one of the prior strings:
value (e.g. strcmp a b).
.RS
.R strcmp b a
.RE
and with an error code of 255 if it has a greater byte value than one of the
prior strings:
.RS
.R strcmp a b
.RE
When invoked incorrectly, a debug message will be printed and the program will When invoked incorrectly, a debug message will be printed and the program will
exit with the appropriate exit with the appropriate
@ -44,7 +54,7 @@ been
This tool also handles integer comparisons and file scrutiny. These parts of its This tool also handles integer comparisons and file scrutiny. These parts of its
functionality have been broken out into multiple utilities. functionality have been broken out into multiple utilities.
This programs functionality may be performed on a POSIX-compliant system with This program\(cqs functionality may be performed on a POSIX-compliant system with
.BR test (1p). .BR test (1p).
.\" .\"
.SH AUTHOR .SH AUTHOR
@ -55,7 +65,7 @@ Written by DTB
.\" .\"
.SH COPYRIGHT .SH COPYRIGHT
Copyright © 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later Copyright \(co 2023 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/gpl.html>. <https://gnu.org/licenses/gpl.html>.
.\" .\"
.SH SEE ALSO .SH SEE ALSO

View File

@ -17,7 +17,7 @@ swab
.B word size .B word size
.R ]) .R ])
.\" .\"
.SH USAGE .SH DESCRIPTION
Swap the latter and former halves of a block of bytes. Swap the latter and former halves of a block of bytes.
.\" .\"
@ -28,7 +28,7 @@ Ignore system call interruptions.
.IP \fB-w\fP .IP \fB-w\fP
Configures the word size; that is, the size in bytes of the block size 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 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 cleanly divisible by 2, otherwise the block of bytes being processed can\(cqt be
halved. halved.
.\" .\"
.SH EXAMPLES .SH EXAMPLES
@ -66,7 +66,7 @@ on other machines.
.\" .\"
.SH COPYRIGHT .SH COPYRIGHT
Copyright (c) 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later Copyright \(co 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later
<https://gnu.org/licenses/agpl.html>. <https://gnu.org/licenses/agpl.html>.
.\" .\"
.SH SEE ALSO .SH SEE ALSO