docs/162438: du(1) man page improvements

[Benjamin Kaduk]

The following reply was made to PR docs/162438; it has been noted by GNATS.

From: Benjamin Kaduk <kaduk at MIT.EDU>
To: Alexander Best <arundel at freebsd.org>
Cc: freebsd-doc at freebsd.org, freebsd-gnats-submit at freebsd.org
Subject: Re: docs/162438: du(1) man page improvements
Date: Thu, 10 Nov 2011 22:30:05 -0500 (EST)

 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.