From: Kyle Milz <krwmilz@gmail.com>
To: 9front@9front.org
Subject: [9front] man du args table diff
Date: Tue, 2 Nov 2021 10:14:28 -0700 [thread overview]
Message-ID: <YYFx9FyUPkEXDinV@imac.0x30.net> (raw)
[-- 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
reply other threads:[~2021-11-02 19:47 UTC|newest]
Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=YYFx9FyUPkEXDinV@imac.0x30.net \
--to=krwmilz@gmail.com \
--cc=9front@9front.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).