Date: Fri, 11 Nov 2011 03:40:06 GMT From: Benjamin Kaduk <kaduk@MIT.EDU> To: freebsd-doc@FreeBSD.org Subject: Re: docs/162438: du(1) man page improvements Message-ID: <201111110340.pAB3e6qg004880@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/162438; it has been noted by GNATS.
From: Benjamin Kaduk <kaduk@MIT.EDU>
To: Alexander Best <arundel@freebsd.org>
Cc: freebsd-doc@freebsd.org, freebsd-gnats-submit@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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201111110340.pAB3e6qg004880>