9front - general discussion about 9front
 help / color / mirror / Atom feed
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).