specify option ordering in the DESCRIPTION section;

from guenther@, ok and tweaks jmc@

1 files changed, 5 insertions, 0 deletions

diff --git a/mdoc.7 b/mdoc.7
index 8052e5e6..9304adea 100644
--- a/mdoc.7
+++ b/mdoc.7
@@ -304,6 +304,11 @@ Print verbose information.
 \&.El
 .Ed
 .Pp
+List the options in alphabetical order,
+uppercase before lowercase for each letter and
+with no regard to whether an option takes an argument.
+Put digits in ascending order before all letter options.
+.Pp
 Manuals not documenting a command won't include the above fragment.
 .Pp
 Since the