docs/162438: du(1) man page improvements

[Benjamin Kaduk]

On Thu, 10 Nov 2011, Alexander Best wrote:

> here's an updated version of the patch. could you check, if i missed anything?
>
> i didn't include .Pq macros, since i find "(" and ")" much easier to 
> handle and believe macros should only be used in places, where it's 
> really necessary to do so.

That's fair.  I think there is reason to prefer .Dq to literal '"', 
though, which I missed the first time around -- it uses "pretty" quotes, 
i.e.
.Dq text
becomes
``text''

> diff --git a/usr.bin/du/du.1 b/usr.bin/du/du.1
> index ef8b5ac..3846f6b 100644
> --- a/usr.bin/du/du.1
> +++ b/usr.bin/du/du.1
> @@ -79,48 +78,30 @@ is rounded up to the next multiple of 512.
>  .It Fl H
>  Symbolic links on the command line are followed, symbolic links in file
>  hierarchies are not followed.
> -.It Fl L
> -Symbolic links on the command line and in file hierarchies are followed.
>  .It Fl I Ar mask
>  Ignore files and directories matching the specified
>  .Ar mask .
> +.It Fl L
> +Symbolic links on the command line and in file hierarchies are followed.
>  .It Fl P
>  No symbolic links are followed.
>  This is the default.
>  .It Fl a
>  Display an entry for each file in a file hierarchy.
> -.It Fl h
> -"Human-readable" output.
> -Use unit suffixes: Byte, Kilobyte, Megabyte,
> -Gigabyte, Terabyte and Petabyte.
> -.It Fl r
> -Generate messages about directories that cannot be read, files
> -that cannot be opened, and so on.
> -This is the default case.
> -This option exists solely for conformance with
> -.St -xpg4 .
> -.It Fl s
> -Display an entry for each specified file.
> -(Equivalent to
> -.Fl d Li 0 )
> -.It Fl t Ar threshold
> -Display only entries for which size exceeds
> -.Ar threshold .
> -If
> -.Ar threshold
> -is negative, display only entries for which size is less than the absolute
> -value of
> -.Ar threshold .
> +.It Fl c
> +Display a grand total.
>  .It Fl d Ar depth
>  Display an entry for all files and directories
>  .Ar depth
>  directories deep.
> -.It Fl c
> -Display a grand total.
> +.It Fl h
> +"Human-readable" output.

So this would become:
.Dq Human-readable
output.
(Just stuff you reordered, I know, but while we're here ...)

-Ben


> +Use unit suffixes: Byte, Kilobyte, Megabyte,
> +Gigabyte, Terabyte and Petabyte.
>  .It Fl k
>  Display block counts in 1024-byte (1-Kbyte) blocks.
>  .It Fl l
> -If a file has multiple hard links, count its size many times.
> +If a file has multiple hard links, count its size multiple times.
>  The default behavior of
>  .Nm
>  is to count files with multiple hard links only once.