Date: Thu, 30 Aug 2018 19:24:29 -0500 From: Benjamin Kaduk <kaduk@mit.edu> To: Allan Jude <allanjude@freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: option sort order in usage/man pages/documentation Message-ID: <20180831002429.GK15624@kduck.kaduk.org> In-Reply-To: <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org> References: <9e434314-485d-6dd2-c7af-17ca0c49313c@yuripv.net> <8bb7a5c9-ab7a-38d3-b9c3-316e71a4deec@freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
[-- Attachment #1 --] On Thu, Aug 30, 2018 at 10:25:21AM -0400, Allan Jude wrote: > On 2018-08-30 03:50, Yuri Pankov wrote: > > Hi, > > > > 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. 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 [-- Attachment #2 --] -----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-----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20180831002429.GK15624>