option sort order in usage/man pages/documentation

Allan Jude allanjude at freebsd.org
Thu Aug 30 14:25:24 UTC 2018


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 at freebsd.org mailing list
> https://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at 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.

-- 
Allan Jude

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 834 bytes
Desc: OpenPGP digital signature
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20180830/9b42aaaf/attachment.sig>


More information about the freebsd-doc mailing list