From owner-svn-src-all@FreeBSD.ORG  Fri Mar  7 09:19:38 2014
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 93B6F32A;
 Fri,  7 Mar 2014 09:19:38 +0000 (UTC)
Received: from cyrus.watson.org (cyrus.watson.org [198.74.231.69])
 by mx1.freebsd.org (Postfix) with ESMTP id 6E3AA25D;
 Fri,  7 Mar 2014 09:19:38 +0000 (UTC)
Received: from fledge.watson.org (fledge.watson.org [198.74.231.63])
 by cyrus.watson.org (Postfix) with ESMTPS id B1B0B46B49;
 Fri,  7 Mar 2014 04:19:37 -0500 (EST)
Date: Fri, 7 Mar 2014 09:19:37 +0000 (GMT)
From: Robert Watson <rwatson@FreeBSD.org>
X-X-Sender: robert@fledge.watson.org
To: Bruce Evans <brde@optusnet.com.au>
Subject: Re: svn commit: r262882 - head/tools/tools/net80211/wlanstats
In-Reply-To: <20140307132653.O3656@besplex.bde.org>
Message-ID: <alpine.BSF.2.00.1403070917470.35474@fledge.watson.org>
References: <201403070123.s271Nn1b019719@svn.freebsd.org>
 <20140307020210.GA38155@FreeBSD.org> <20140307132653.O3656@besplex.bde.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
Cc: svn-src-head@freebsd.org, Alexey Dokuchaev <danfe@freebsd.org>,
 src-committers@freebsd.org, Eitan Adler <eadler@freebsd.org>,
 svn-src-all@freebsd.org
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
 user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all/>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
 <mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 07 Mar 2014 09:19:38 -0000

On Fri, 7 Mar 2014, Bruce Evans wrote:

>>> Log:
>>>   wlanstats: add help
>>>
>>>   - add a help (-h) flag
>>>   - move usage into itsown function
>> 
>> it looks like the only change now is that usage info always go to stdout, 
>> and exit code differs.  i don't think it should be mfced.
>
> It also removes the double printing of the program name (correct) and the 
> printing of "usage: ", and has mounds of style bugs.
>
> gnu utilities have a --help flag that causes similar behaviour (printing to 
> stdout and exiting with status 0), but they still print error messages about 
> usage to stderr.

They can also return a non-zero status if printing the man pages encounters 
problems.  This leads to some curious text in the GNU info page for 'true' 
explaining that it can sometimes return false.

Robert