From owner-freebsd-doc@freebsd.org Fri Aug 31 00:29:47 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 5098BEFCE7F for ; Fri, 31 Aug 2018 00:29:47 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-5.mit.edu (dmz-mailsec-scanner-5.mit.edu [18.7.68.34]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id BE2407943C; Fri, 31 Aug 2018 00:29:46 +0000 (UTC) (envelope-from kaduk@mit.edu) X-AuditID: 12074422-917ff70000003b75-78-5b888ac4d60a Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) (using TLS with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by dmz-mailsec-scanner-5.mit.edu (Symantec Messaging Gateway) with SMTP id 0A.B5.15221.5CA888B5; Thu, 30 Aug 2018 20:24:38 -0400 (EDT) Received: from outgoing.mit.edu (OUTGOING-AUTH-1.MIT.EDU [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id w7V0OX0c006263; Thu, 30 Aug 2018 20:24:34 -0400 Received: from kduck.kaduk.org (24-107-191-124.dhcp.stls.mo.charter.com [24.107.191.124]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id w7V0OTkI031871 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 30 Aug 2018 20:24:32 -0400 Date: Thu, 30 Aug 2018 19:24:29 -0500 From: Benjamin Kaduk To: Allan Jude Cc: freebsd-doc@freebsd.org Subject: Re: option sort order in usage/man pages/documentation Message-ID: <20180831002429.GK15624@kduck.kaduk.org> References: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="EVF5PPMfhYS0aIcm" Content-Disposition: inline In-Reply-To: <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org> User-Agent: Mutt/1.9.1 (2017-09-22) X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFtrAKsWRmVeSWpSXmKPExsUixG6nonusqyPaoGGRpMWmixfYLE6d6WJ1 YPKY8Wk+SwBjFJdNSmpOZllqkb5dAlfG6bmLmAs2CFa0z5JsYGzl72Lk5JAQMJG4d+Y5excj F4eQwGImia2PNrJAOBsZJSa+escIUiUkcJVJ4vQ9AxCbRUBVYu2Nh2BxNgEViYbuy8wgtoiA msSNntVgNrOAtETj0VYWEFtYwF7i0r7ZrF2MHBy8QNt+T82EGFkk8X7VX7ByXgFBiZMzn7BA tJZJnLmyDawcZMzyfxwgYU6gKb1Lp7GC2KICyhJ7+w6xT2AUmIWkexaS7lkI3RBhLYkb/14y YQhrSyxb+JoZwraVWLfuPcsCRvZVjLIpuVW6uYmZOcWpybrFyYl5ealFuqZ6uZkleqkppZsY wUHvorSDceI/r0OMAhyMSjy8DO/bo4VYE8uKK3MPMUpyMCmJ8r526IgW4kvKT6nMSCzOiC8q zUktPsSoArTr0YbVFxilWPLy81KVRHg5M4DqeFMSK6tSi/JhyqQ5WJTEeZ3OtUYLCaQnlqRm p6YWpBbBZGU4OJQkeKWBUS8kWJSanlqRlplTgpBm4uA8xCjBwQM0XBSkhre4IDG3ODMdIn+K 0Zjj3dGpk5g5/rwHkkJgd0iJ867vBCoVACnNKM2DmwZKaBLZ+2teMYoDPSrM2wNSxQNMhnDz XgGtYgJa1XWvBWRVSSJCSqqBcYruD+GYPTsPLXpVySEQ+4JNW/N4+06zM3+2FxvJ1s32nJQ+ o8Pt5Z2Q6B3yEf8VVz/d/tl6yYb70fbaN9rTfz0L9diubvjpvdje5ReP8JxadvL8iq3M7Iti BeMCrO2D/otZ7elRWfMl2vHL3H2rWfZaLONZ9/xQ+M880aJjm14Iik7WVDPepa7EUpyRaKjF XFScCABinGnDQwMAAA== X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 31 Aug 2018 00:29:47 -0000 --EVF5PPMfhYS0aIcm Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Thu, Aug 30, 2018 at 10:25:21AM -0400, Allan Jude wrote: > On 2018-08-30 03:50, Yuri Pankov wrote: > > Hi, > >=20 > > I'm working on some man page updates, and, thinking about consistency, > > been wondering if there's any policy set on the order of options that > > one should use in usage messages/man pages/other documentation, i.e. is > > it 'ABCabc', 'AaBbCc', or 'aAbBcC' (or anything else really, I hope > > 'unsorted' isn't possible answer here). > > _______________________________________________ > > freebsd-doc@freebsd.org mailing list > > https://lists.freebsd.org/mailman/listinfo/freebsd-doc > > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@freebsd.org" >=20 > It has definitely been policy to sort them alphabetically, but I don't > know that that much attention has ever been paid to sorting upper and > lower case characters. >=20 > ABCabc is right out, but I don't know what the right answer is between > the other two. I would say humans sort lowercase first, but by ASCII the > uppercase is first. POSIX locale collation behavior is probably going to be the default winner in this question. Though I think there are some cases where it is better to group related options than to globally do everything alphabetically. -Ben --EVF5PPMfhYS0aIcm Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQG3BAABCgAdFiEE2WGV4E2ARf9BYP0XKNmm82TrdRIFAluIirgACgkQKNmm82Tr dRJUxQweOVijRsxJfNocYHWXjT/mybHj+40qbtiA2d+uJFLZuCDeDbi8IjwNwVjh V/Y461IsAFDJKNZcBijAm5NhxnbHSbZjKzybLKfbsEFbM1esa4tDaMKLXtpY6Nzy 67wIoB1yhEwOq32z2o3QXGs/7P0Fkvjpqazh8zNBoSvLN+tGi8SNvqkRmQZW7xWA m5Ir43F2daKVBv0Z623EBt2l80JO2monjBpdboaal2+YnEzu9IekV2HWbpMZP5Ia mUPRoklyoarcAt/6LNcvw9vz9ALSWOnN0ITzXLq7ubsRf0CYc2VAl80y8M4ivNlV hxIlO9nmYsqw6gvAU0HQd/Wr51pln+N2HrkF2164IifAO5SkkPduFDijTE8jhJ1d F49Vw3s+k1YgKBURbJxu5+SOzkT1b2B0g+HP2fhgyLKR2LyuPZUKxDZ7b8WgYA+g obZTk+0u4Cv7I5e245HKjikyuDQkU3fe/hEJkDGIky1uGv43wI8BaLRwYTm63t6C GNYGoOb72vQ88Q== =rEfb -----END PGP SIGNATURE----- --EVF5PPMfhYS0aIcm--