From owner-svn-src-all@FreeBSD.ORG Thu Jun 21 16:37:37 2012 Return-Path: Delivered-To: svn-src-all@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 61B78106566C; Thu, 21 Jun 2012 16:37:37 +0000 (UTC) (envelope-from brde@optusnet.com.au) Received: from mail02.syd.optusnet.com.au (mail02.syd.optusnet.com.au [211.29.132.183]) by mx1.freebsd.org (Postfix) with ESMTP id DBA608FC12; Thu, 21 Jun 2012 16:37:36 +0000 (UTC) Received: from c122-106-171-232.carlnfd1.nsw.optusnet.com.au (c122-106-171-232.carlnfd1.nsw.optusnet.com.au [122.106.171.232]) by mail02.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id q5LGbWnU006182 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Fri, 22 Jun 2012 02:37:35 +1000 Date: Fri, 22 Jun 2012 02:37:32 +1000 (EST) From: Bruce Evans X-X-Sender: bde@besplex.bde.org To: Steve Kargl In-Reply-To: <20120621140609.GA7051@troutmask.apl.washington.edu> Message-ID: <20120622021805.H3133@besplex.bde.org> References: <201204221818.q3MIIn4Y051313@svn.freebsd.org> <20120422184553.GA85374@troutmask.apl.washington.edu> <4FE2DF35.5040804@FreeBSD.org> <20120621140609.GA7051@troutmask.apl.washington.edu> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: svn-src-head@FreeBSD.org, svn-src-all@FreeBSD.org, src-committers@FreeBSD.org, Christian Brueffer Subject: Re: svn commit: r234577 - head/usr.bin/stat X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 21 Jun 2012 16:37:37 -0000 On Thu, 21 Jun 2012, Steve Kargl wrote: > On Thu, Jun 21, 2012 at 10:45:41AM +0200, Christian Brueffer wrote: >> On 4/22/12 20:45 , Steve Kargl wrote: >>> On Sun, Apr 22, 2012 at 06:18:49PM +0000, Christian Brueffer wrote: >>>> Author: brueffer >>>> Date: Sun Apr 22 18:18:49 2012 >>>> New Revision: 234577 >>>> URL: http://svn.freebsd.org/changeset/base/234577 >>>> >>>> Log: >>>> Remove duplicate -l description. >>>> >>>> Submitted by: Rainer Hurling >>>> MFC after: 1 week >>> >>> The patch should have also fixed the misordering >>> of the -n, -qi, and -x options. >> >> sorry for the late reply. Could you say more specifically how you >> would arrange the order? From a small sampling of our manpages, it >> seems we don't have "one true" style of ordering options (except from >> alphabetically, see attached patch). >> >> Some manpages order A-Z, then a-z, while others (Apple and OpenBSD seem >> to do this) order AaBb...Zz. I think the latter is more common and correct for FreeBSD too. ps uses it. But ls uses A-Za-z0-9. > Upon further inspection, the order of the description of the > options follows the order of the option in the SYNOPSIS. I > suppose the manpage is fine. No, SYNOPSEs (and usage) normally put options with parameters last. DESCRIPTIONs of options shouldn't do that. For ls, there is only 1 option with a parameter (-D). This is sorted into A-Z in the DESCRIPTION section. For ps, there are many options with parameters. These used to be sorted after the ones without args in the SYNOPSEs, but -O and -o are now unsorted before all other options with parameters. The DESCRIPTION section in ps used to be sorted, but -c was added out of order. stat(1) has a sorted SYNOPSIS, with complications for -f that require grouping it with options that don't take pararmeters. These complications affect the DESCRIPTION section too much. Man pages like chmod(1) don't unsort the DESCRIPTION section for similar things (the SYNOPSIS says [-R [-H | -L | -P][, but the DESCRIPTION uses alphabetical ordering for -HLPR. Bruce