[9front] man du args table diff

[9front] man du args table diff

[Kyle Milz]

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

hi,

i think it is clearer when argument descriptions are listed
in table form vs paragraph form. diff below converts most
of du's arguments to a table. -b is still hanging out in the
first paragraph, i'll get to that if this diff is ok.

i left the -s description as is, its not great but not incorrect
either.

the only semantic description change intended is -n 'it sets' to
'this implies'.


kyle

diff ca73f673473457152d6f1b2e9030495f8dec5c49 uncommitted
--- a/sys/man/1/du
+++ b/sys/man/1/du
@@ -35,24 +35,22 @@
 The count for a directory includes the counts of the
 contained files and directories.
 .PP
-The
+The options are:
+.TP
 .B -a
-option prints the number of blocks
+Print the number of blocks
 for every file in a directory.
 Normally counts are printed only for contained directories.
-.PP
-The
+.TP
 .B -f
-option suppresses the printing of warning messages.
-.PP
-The
+Suppress the printing of warning messages.
+.TP
 .B -n
-option prints the size in bytes and the name of each file; it sets
+Print the size in bytes and the name of each file; this implies
 .BR -a .
-.PP
-The
+.TP
 .B -t
-option prints, in the format of
+Print, in the format of
 .B du
 .BR -n ,
 the modified time of
@@ -60,48 +58,34 @@
 If the options
 .B -tu
 are specified then the accessed time is printed.
-.PP
-The
+.TP
 .B -q
-option prints, in the format of
+Print, in the format of
 .B du
 .BR -n ,
 the QID path of
 each file rather than the size.
-.PP
-The
+.TP
 .B -s
-option causes
-.I du
-to descend the hierarchy as always, but to print only a summary line
-for each
+Descend the hierarchy as always, but print only a summary line for each
 .IR file .
-.PP
-The
+.TP
 .B -e
-option causes
-.I du
-to print values (sizes, times or QID paths)
+Print values (sizes, times or QID paths)
 in `scientific notation' via
 .IR print (2)'s
 .BR %g .
-.PP
-The
+.TP
 .B -h
-option causes
-.I du
-to print values (sizes, times or QID paths)
+Print values (sizes, times or QID paths)
 in scientific notation,
 scaled to less than 1024, and with a suitable SI prefix
 (e.g.,
 .L G
 for binary gigabytes).
-.PP
-The
+.TP
 .B -p
-option causes
-.I du
-to print values (sizes, times or QID paths)
+Print values (sizes, times or QID paths)
 in units of
 .IR SI-prefix .
 Case is ignored when looking up