docs/162438: du(1) man page improvements
kaduk at MIT.EDU
Fri Nov 11 03:30:09 UTC 2011
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,
> 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 .
> -.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:
(Just stuff you reordered, I know, but while we're here ...)
> +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
> is to count files with multiple hard links only once.
More information about the freebsd-doc