Date: Thu, 30 Aug 2018 10:25:21 -0400 From: Allan Jude <allanjude@freebsd.org> To: freebsd-doc@freebsd.org Subject: Re: option sort order in usage/man pages/documentation Message-ID: <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org> In-Reply-To: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> References: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net>
next in thread | previous in thread | raw e-mail | index | archive | help
This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --bppRONjffFAGcZPZqO3cnpBdgXmW0LnEM Content-Type: multipart/mixed; boundary="qSoA2YSHgUZfS6LROsA1Rl57JijeQ6DWB"; protected-headers="v1" From: Allan Jude <allanjude@freebsd.org> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec>