The man pages had -verbose and -help listed at the end of the synopsis.
This put them after mandatory arguments in some cases, e.g. post(8).
Put then at the front, swapping the order so -help is first, as novices
will want to know -help exists early on, and others can simply skip over
them rather than encounter them at the end when they're trying to track
the combinations of what they've read so far.
.HP 5
.na
.B ali
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-alias
.IR aliasfile ]
.RB [ \-list " | " \-nolist ]
.RB [ \-user " | " \-nouser ]
-.RB [ \-version ]
-.RB [ \-help ]
.RI [ aliases " ...]"
.ad
.SH DESCRIPTION
.HP 5
.na
.B anno
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-component
.RB [ \-number
.IR [ num|all ]]
.RB [ \-preserve " | " \-nopreserve ]
-.RB [ \-version ]
-.RB [ \-help ]
.RB [ \-text
.IR body ]
.ad
.HP 5
.na
.B %nmhlibexecdir%/ap
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-form
.IR formatfile ]
.RB [ \-format
.IR string ]
.RB [ \-width
.IR columns ]
-.RB [ \-version ]
-.RB [ \-help ]
.I addrs
\&...
.ad
.HP 5
.na
.B burst
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-inplace " | " \-noinplace ]
.RB [ \-automime ]
.RB [ \-quiet " | " \-noquiet ]
.RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Burst
.HP 5
.na
.B comp
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msg ]
.RB [ \-form
.IR program ]
.RB [ \-nowhatnowproc ]
.RB [ \-build ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Comp
.HP 5
.na
.B dist
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msg ]
.RB [ \-form
.RB [ \-nowhatnowproc ]
.RB [ \-atfile ]
.RB [ \-noatfile ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Dist
.HP 5
.na
.B %nmhlibexecdir%/dp
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-form
.IR formatfile ]
.RB [ \-format
.IR string ]
.RB [ \-width
.IR columns ]
-.RB [ \-version ]
-.RB [ \-help ]
.I dates
\&...
.ad
.HP 5
.na
.B flist
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder1
.RI [ +folder2
\&...]]
.RB [ \-recurse " | " \-norecurse ]
.RB [ \-fast " | " \-nofast ]
.RB [ \-alpha " | " \-noalpha ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
.HP 5
.B flists
.HP 5
.na
.B %nmhlibexecdir%/fmtdump
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-form
.IR formatfile ]
.RB [ \-format
.IR string ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Fmtdump
.HP 5
.na
.B folder
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msg ]
.RB [ \-all " | " \-noall ]
.RB [ \-pack " | " \-nopack ]
.RB [ \-print ]
.RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
.HP 5
.B folders
.HP 5
.na
.B forw
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-annotate " | " \-noannotate ]
.RB [ \-build ]
.RB [ \-file
.IR msgfile ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
.HP 5
.B forw
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-digest
.IR number ]
[other\ switches\ for\
.BR forw ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Forw
.HP 5
.na
.B inc
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RB [ \-audit
.IR audit\-file ]
.RB [ \-initialtls ]
.RB [ \-notls ]
.RB [ \-snoop ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Inc
.HP 5
.na
.B %nmhlibexecdir%/install\-mh
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-auto ]
.RB [ \-check ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Install\-mh
.HP 5
.na
.B mark
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-sequence
.RB [ \-list ]
.RB [ \-public " | " \-nopublic ]
.RB [ \-zero " | " \-nozero ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B %nmhlibexecdir%/mkstemp
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-directory
.IR directory ]
.RB [ \-prefix
.IR prefix ]
.RB [ \-suffix
.IR suffix ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B mkstemp
.na
.HP 5
.B mhbuild
+.RB [ \-help ]
+.RB [ \-version ]
.I file
.RB [ \-auto " | " \-noauto ]
.RB [ \-list " | " \-nolist ]
.RB [ \-maxunencoded
.IR line\-length ]
.RB [ \-dist ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B mhfixmsg
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs " | "
.IR "absolute pathname" " | "
.RB [ \-normmproc ]
.RB [ \-changecur " | " \-nochangecur ]
.RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B mhfixmsg
.HP 5
.na
.B mhical
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-form
.IR formatfile ]
.RB [ \-format
.IR outfile ]
.RB [ \-unfold ]
.RB [ \-debug ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B mhical
.HP 5
.na
.B %nmhlibexecdir%/mhl
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-bell " | " \-nobell ]
.RB [ \-clear " | " \-noclear ]
.RB [ \-folder
.RB [ \-nofmtproc ]
.RI [ files
.IR \&... ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Mhl
.HP 5
.na
.B mhlist
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-file
.RB [ \-changecur " | " \-nochangecur ]
.RB [ \-verbose " | " \-noverbose ]
.RB [ \-disposition " | " \-nodisposition ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B mhlogin
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-user
.IR username ]
.RB [ \-saslmech
.RB [ \-browser
.IR command ]
.RB [ \-snoop ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Mhlogin
.HP 5
.na
.B mhmail
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-to ]
.RI addrs
\&...
.I send
\&...]]
.RB [ \-send " | " \-nosend ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
.HP 5
.B mhmail
.HP 5
.na
.B mhn
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-file
.RB [ \-wcache
.IR policy ]
.RB [ \-check " | " \-nocheck ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
.HP 5
.B mhn
.HP 5
.na
.B mhparam
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ components ]
.RB [ \-all ]
.RB [ \-component " | " \-nocomponent ]
-.RB [ \-version ]
-.RB [ \-help ]
.RB [ \-debug ]
.ad
.SH DESCRIPTION
.HP 5
.na
.B mhpath
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B mhpath
.HP 5
.na
.B mhshow
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-file
.RB [ \-wcache
.IR policy ]
.RB [ \-check " | " \-nocheck ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B mhstore
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-file
.IR policy ]
.RB [ \-check " | " \-nocheck ]
.RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B msgchk
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-date " | " \-nodate ]
.RB [ \-notify
all/mail/nomail ]
.RB [ \-snoop ]
.RI [ users
\&... ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B new
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ sequences ]
.RB [ \-mode
.IR mode ]
.RB [ \-folders
.IR foldersfile ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
.HP 5
.B fnext
.HP 5
.na
.B next
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RB [\-showproc
.IR program ]
.I showproc
or
.IR showmimeproc ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Next
.HP 5
.na
.B packf
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-file
.IR name ]
.RB [ \-mbox ]
.RB [ \-mmdf ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Packf
.HP 5
.na
.B pick
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-reverse
.RB [ \-zero " | " \-nozero ]
.RB [ \-list " | " \-nolist ]
.RB [ \-debug ]
-.RB [ \-version ]
-.RB [ \-help ]
.PP
typical usage:
.PP
.HP 5
.na
.B %nmhlibexecdir%/post
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-alias
.IR aliasfile ]
.RB [ \-filter
.RB [ \-initialtls ]
.RB [ \-notls ]
.I file
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Post
.HP 5
.na
.B prev
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RB [\-showproc
.IR program ]
.I showproc
or
.IR showmimeproc ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Prev
.HP 5
.na
.B prompter
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-erase
.IR chr ]
.RB [ \-kill
.RB [ \-rapid " | " \-norapid ]
.RB [ \-doteof " | " \-nodoteof ]
.I file
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Prompter
.HP 5
.na
.B %nmhlibexecdir%/rcvdist
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-form
.IR formfile ]
[switches\ for
.IR postproc ]
.I address1
\&...
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B %nmhlibexecdir%/rcvpack
+.RB [ \-help ]
+.RB [ \-version ]
.I file
.RB [ \-mbox ]
.RB [ \-mmdf ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B %nmhlibexecdir%/rcvstore
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RB [ \-create " | " \-nocreate ]
.RB [ \-unseen " | " \-nounseen ]
.I name
\&...]
.RB [ \-public " | " \-nopublic ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Rcvstore
.HP 5
.na
.B %nmhlibexecdir%/rcvtty
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ command ]
.RB [ \-form
.IR formatfile ]
.RB [ \-bell " | " \-nobell ]
.RB [ \-newline " | " \-nonewline ]
.RB [ \-biff ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
The
.HP 5
.na
.B refile
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ msgs ]
.RB [ \-draft ]
.RB [ \-link " | " \-nolink ]
.RB [ \-normmproc ]
.I +folder1
\&...
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Refile
.HP 5
.na
.B repl
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msg ]
.RB [ \-annotate " | " \-noannotate ]
.RB [ \-build ]
.RB [ \-file
.IR msgfile ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Repl
.HP 5
.na
.B rmf
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RB [ \-interactive " | " \-nointeractive ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Rmf
.HP 5
.na
.B rmm
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-unlink " | " \-nounlink ]
.RB [ \-rmmproc
.IR program ]
.RB [ \-normmproc ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
By default,
.HP 5
.na
.B scan
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-clear " | " \-noclear ]
.RB [ \-reverse " | " \-noreverse ]
.RB [ \-file
.IR filename ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Scan
.HP 5
.na
.B send
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-alias
.IR aliasfile ]
.RB [ \-draft ]
.IR columns ]
.RB [ file
\&...]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Send
.HP 5
.na
.B sendfiles
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ -compress
.IR bzip2 " | " compress " | " gzip " | " lzma " | " none ]
.br
.RB [ \-from
.IR sender ]
.RI [ "\-delay n" " | " \-n ]
-.RB [ \-version ]
-.RB [ \-help ]
.br
.B \-to
.I recipient
.HP 5
.na
.B show
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-draft ]
.I showproc
or
.IR showmimeproc ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Show
.HP 5
.na
.B %nmhlibexecdir%/slocal
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-addr
.IR address ]
.RB [ \-info
.RB [ \-verbose " | " \-noverbose ]
.RB [ \-suppressdup " | " \-nosuppressdup ]
.RB [ \-debug ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Slocal
.HP 5
.na
.B sortm
+.RB [ \-help ]
+.RB [ \-version ]
.RI [ +folder ]
.RI [ msgs ]
.RB [ \-all " | " \-noall ]
.RB [ \-nolimit ]
.RB [ \-check " | " \-nocheck ]
.RB [ \-verbose " | " \-noverbose ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Sortm
.HP 5
.na
.B whatnow
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-draftfolder
.IR +folder ]
.RB [ \-draftmessage
.RB [ \-prompt
.IR string ]
.RI [ file ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Whatnow
.HP 5
.na
.B whom
+.RB [ \-help ]
+.RB [ \-version ]
.RB [ \-alias
.IR aliasfile ]
.RB [ \-check " | " \-nocheck ]
.RB [ \-notls ]
.RI [ file ]
.RB [ \-draft ]
-.RB [ \-version ]
-.RB [ \-help ]
.ad
.SH DESCRIPTION
.B Whom