From owner-freebsd-doc@FreeBSD.ORG Fri Nov 11 03:30:09 2011 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id BCEE61065670; Fri, 11 Nov 2011 03:30:09 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-7.mit.edu (DMZ-MAILSEC-SCANNER-7.MIT.EDU [18.7.68.36]) by mx1.freebsd.org (Postfix) with ESMTP id 34A008FC0A; Fri, 11 Nov 2011 03:30:08 +0000 (UTC) X-AuditID: 12074424-b7ef76d0000008dc-0b-4ebc96c03726 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-7.mit.edu (Symantec Messaging Gateway) with SMTP id C6.70.02268.0C69CBE4; Thu, 10 Nov 2011 22:30:08 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH.MIT.EDU [18.7.22.103]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id pAB3U8tY016115; Thu, 10 Nov 2011 22:30:08 -0500 Received: from multics.mit.edu (MULTICS.MIT.EDU [18.187.1.73]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.6/8.12.4) with ESMTP id pAB3U6Il022784 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 10 Nov 2011 22:30:07 -0500 (EST) Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id pAB3U5pY027687; Thu, 10 Nov 2011 22:30:05 -0500 (EST) Date: Thu, 10 Nov 2011 22:30:05 -0500 (EST) From: Benjamin Kaduk To: Alexander Best In-Reply-To: <20111110213850.GA91336@freebsd.org> Message-ID: References: <201111101423.pAAENpbt038506@red.freebsd.org> <20111110213850.GA91336@freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrHIsWRmVeSWpSXmKPExsUixCmqrXtg2h4/g70bBS3aP89jsjh1povV ouXJanYHZo8Zn+azBDBGcdmkpOZklqUW6dslcGXsun2IueCuSMW13bvYGhibBboYOTkkBEwk Lny4xQxhi0lcuLeerYuRi0NIYB+jxMr+HYwQzgZGiWWv5rBDOAeYJHb/PcQC4TQwSsw685a1 i5GDg0VAW2L3XEuQUWwCKhIz32xkA7FFBDQktjU8BlvBLGAr0bF1OTuILSxgKnH7+mSwOKeA ocTWQ9/A6nkF7CV+NmyD2jyJUWLP4qdMIAlRAR2J1funsEAUCUqcnPmEBWKopcS/tb9YJzAK zkKSmoUktYCRaRWjbEpulW5uYmZOcWqybnFyYl5eapGuuV5uZoleakrpJkZQsLK7qOxgbD6k dIhRgINRiYeX889uPyHWxLLiytxDjJIcTEqivLyT9/gJ8SXlp1RmJBZnxBeV5qQWH2KU4GBW EuGVzQPK8aYkVlalFuXDpKQ5WJTEeW12OvgJCaQnlqRmp6YWpBbBZGU4OJQkeG9NBWoULEpN T61Iy8wpQUgzcXCCDOcBGs42DWR4cUFibnFmOkT+FKOilDjvc5BmAZBERmkeXC8smbxiFAd6 RZj3HEgVDzARwXW/AhrMBDR4s/tukMEliQgpqQbG/dMr1t7fp/syIvP4jyOZBodYOEoUFufu ZhNd3vHqBeP8q0u1V73cd1xL9cOyj99vV7l4OFhNver5eb7U0wO6T5sEV119ZBN45ee/hZv4 rh/lXunUsv/c/47GYLOFVaVpSZwmD34trNSOfD89mJ29dfl1t48JbpG3VPP+2234yS10vvxE aVnRciWW4oxEQy3mouJEAGQK6cIBAwAA Cc: freebsd-doc@freebsd.org, freebsd-gnats-submit@freebsd.org Subject: Re: docs/162438: du(1) man page improvements X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 Nov 2011 03:30:09 -0000 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.