From owner-freebsd-doc@FreeBSD.ORG Fri Nov 11 03:40:06 2011 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id DCFB6106564A for ; Fri, 11 Nov 2011 03:40:06 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B38558FC0A for ; Fri, 11 Nov 2011 03:40:06 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.4/8.14.4) with ESMTP id pAB3e6uH004881 for ; Fri, 11 Nov 2011 03:40:06 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.4/8.14.4/Submit) id pAB3e6qg004880; Fri, 11 Nov 2011 03:40:06 GMT (envelope-from gnats) Date: Fri, 11 Nov 2011 03:40:06 GMT Message-Id: <201111110340.pAB3e6qg004880@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Benjamin Kaduk Cc: Subject: Re: docs/162438: du(1) man page improvements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Benjamin Kaduk List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Nov 2011 03:40:06 -0000 The following reply was made to PR docs/162438; it has been noted by GNATS. From: Benjamin Kaduk To: Alexander Best 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.