From owner-svn-src-head@FreeBSD.ORG  Sun Nov  6 22:48:50 2011
Return-Path: <owner-svn-src-head@FreeBSD.ORG>
Delivered-To: svn-src-head@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 1233)
	id 530191065673; Sun,  6 Nov 2011 22:48:50 +0000 (UTC)
Date: Sun, 6 Nov 2011 22:48:50 +0000
From: Alexander Best <arundel@freebsd.org>
To: Ed Schouten <ed@80386.nl>
Message-ID: <20111106224850.GA93068@freebsd.org>
References: <201111060815.pA68FIvC008341@svn.freebsd.org>
	<20111106204619.GA76768@freebsd.org>
	<20111106215630.GQ2258@hoeg.nl>
	<20111106223001.GA91996@freebsd.org>
	<20111106223233.GR2258@hoeg.nl>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20111106223233.GR2258@hoeg.nl>
Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org,
	src-committers@freebsd.org
Subject: Re: svn commit: r227164 - head/usr.bin/du
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
	<svn-src-head.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-head>,
	<mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 06 Nov 2011 22:48:50 -0000

On Sun Nov  6 11, Ed Schouten wrote:
> Hi Alexander,
> 
> * Alexander Best <arundel@freebsd.org>, 20111106 23:30:
> > +The
> > +.Fl a, d
> > +and
> > +.Fl s
> > +options are mutually exclusive.
> > +.Pp
> > +The
> > +.Fl H, L
> > +and
> > +.Fl P
> > +options are mutually exclusive.
> 
> This can already be derived from the SYNOPSIS, right?

partially:


"    du [-A] [-H | -L | -P] [-a | -s | -d depth | -t threshold] [-c] [-l]
        [-h | -k | -m | -B blocksize] [-n] [-x] [-I mask] [file ...]"

1) [-H | -L | -P] is correct
2) [-a | -s | -d depth | -t threshold] is not correct. the -t option can be
   used together with the -a, -s and -d options.
3) [-h | -k | -m | -B blocksize] is not correct. the -B option can be used
   together with the -h, -k and -m options.
   also style(9) describes "|" as "either-or" operator. for the -h, -k and -m
   options this isn't true. they can very well be used in a single command, but
   the last option backs out all the previous ones.

i think the following would be better:

"    du [-Achklmnx] [-H | -L | -P] [-a | -s | -d depth] [-B blocksize]
        [-I mask] [-t threshold] [file ...]"

and the paragraph

"    The -h, -k and -m options all override each other; the last one specified
     determines the block count used."

cheers.
alex

> 
> -- 
>  Ed Schouten <ed@80386.nl>
>  WWW: http://80386.nl/