From owner-freebsd-doc@freebsd.org Thu Aug 30 14:25:23 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 B95CC10A0009 for ; Thu, 30 Aug 2018 14:25:23 +0000 (UTC) (envelope-from allanjude@freebsd.org) Received: from mx1.scaleengine.net (mx1.scaleengine.net [209.51.186.6]) (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 52C0783350 for ; Thu, 30 Aug 2018 14:25:23 +0000 (UTC) (envelope-from allanjude@freebsd.org) Received: from [10.1.1.2] (Seawolf.HML3.ScaleEngine.net [209.51.186.28]) (Authenticated sender: allanjude.freebsd@scaleengine.com) by mx1.scaleengine.net (Postfix) with ESMTPSA id DE2D61DB30 for ; Thu, 30 Aug 2018 14:25:22 +0000 (UTC) Subject: Re: option sort order in usage/man pages/documentation To: freebsd-doc@freebsd.org References: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> From: Allan Jude Openpgp: preference=signencrypt Autocrypt: addr=allanjude@freebsd.org; prefer-encrypt=mutual; keydata= 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 kiYh4ZtPB4Q= Message-ID: <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org> Date: Thu, 30 Aug 2018 10:25:21 -0400 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 MIME-Version: 1.0 In-Reply-To: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="bppRONjffFAGcZPZqO3cnpBdgXmW0LnEM" 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: Thu, 30 Aug 2018 14:25:24 -0000 This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --bppRONjffFAGcZPZqO3cnpBdgXmW0LnEM Content-Type: multipart/mixed; boundary="qSoA2YSHgUZfS6LROsA1Rl57JijeQ6DWB"; protected-headers="v1" From: Allan Jude To: freebsd-doc@freebsd.org Message-ID: <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org> Subject: Re: option sort order in usage/man pages/documentation References: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> In-Reply-To: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> --qSoA2YSHgUZfS6LROsA1Rl57JijeQ6DWB Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable 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" 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. 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. --=20 Allan Jude --qSoA2YSHgUZfS6LROsA1Rl57JijeQ6DWB-- --bppRONjffFAGcZPZqO3cnpBdgXmW0LnEM Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.22 (MingW32) iQIcBAEBAgAGBQJbh/5SAAoJEBmVNT4SmAt+jW8P/js7zW+Hh5No0JmZjnP9Wnub WyP+oEBJilSTFVbyE9QpWqSJK9ib6GZCWioR+AwMkOFYAykqGgXIjEj0dmjkElHF YlRF+rgCz4R7YS+WsFBtZBHo9Be5gkaPfTlUsxC5xQ87l6aX5bRdjvLOWlso/iwd 72VYheo2akkpaR7yEYYlpGEjcKcD9XoLF+q0dUzlXCfmC6/BfiAg4/63SgzBDtOs A8VMqqO8O5MRR2quj/P25+0OHPXpNixO0gkBrmdq1TlKCykt2KKQ3nrQoPmvdlhv +Hk/yvIliQCn2KkuDOwrYQWhZzoggAl5SRUFT9VpVBWHaoQrRCwWbsspwwdjwVUA 1MPK0lvQYCFvsgoeFOxvDt5tWR5KOZEol1ncdS+jN0q2llw3hXNirnZoeByy+hqx e6K2BXiFsO9AA4Cv/QomAV9rn2Uz7D0bSDtRrXpiMNZOn0R/08CCwHtAKKWuex/+ s41SugS0/UH3mQbX3YJI9c1YdTGQkzxTf43GwyGaoJ5yvWdGm4axUkup0e9AMxs4 2SGgbljK2147vCRwt9/wPdf5n0MH6xBy6jPSGcTlB5BmAENENrgbFU5uIdAr49vI LxcWjZDjx4ptRcQqQF0DdvulrDZUdvxirwcaPo8/DTPvzm7ePgRBAnEu43cfDU53 PIcV3hh4nsckmscIVKYh =Met+ -----END PGP SIGNATURE----- --bppRONjffFAGcZPZqO3cnpBdgXmW0LnEM--