[9front] sysinfo(1): use tag paragraph for option descriptions

[9front] sysinfo(1): use tag paragraph for option descriptions

[Kyle Milz]

[-- Attachment #1: sysinfo_options_table.diff --]
[-- Type: text/plain, Size: 1632 bytes --]

hi,

diff below modifies the sysinfo(1) manual to use .TP tag paragraphs
for its options descriptions. it also modifies the descriptions
slightly, attempting imperative mood.

also while here use the .BI macro for the option that takes a parameter.
this makes no difference when viewing the manual on the terminal,
but does have a difference in, say,  proof mode. i think this better
conveys that the parameter is a variable, and not, say, a literal.

the quote character in .BI is necessary otherwise no whitespace
is left between the option and its parameter in terminal viewing mode.


kyle

diff cd7480f68f3496b84ae25f916c2d700fc5afb42f uncommitted
--- a/sys/man/1/sysinfo
+++ b/sys/man/1/sysinfo
@@ -4,7 +4,7 @@
 .SH SYNOPSIS
 .B sysinfo
 [
-.B -e e-mail
+.BI -e " e-mail
 ]
 [
 .B -p
@@ -16,22 +16,24 @@
 executes a number of commands that report information
 about the hardware and software configuration of
 the running system, concatenating the output to
-stdout.
-.PP
-The
+stdout. Its options are:
+.TP
 .B -p
-flag causes the output to be posted at a website
-archive,
+Post output to a website archive,
 .B http://sysinfo.9front.org,
 which in turn forwards the message to a
 mailing list,
 .B 9front-sysinfo@9front.org.
 A URL pointing to the archived output is returned.
-The
-.B -e
-flag causes a reply-to e-mail address to be included
-in the message (the e-mail address is not divulged
+.TP
+.BI -e " e-mail
+Include a reply-to
+.I e-mail
+address in the message (the
+.I e-mail
+address is not divulged
 to the mailing list).
+.PP
 These flags are useful for reporting new installs to the
 development team.
 .PP