I've added a minimal example to the top of mh-alias.man.
(I have no idea to what "In match, a trailing "*" on an alias will
match just about anything appropriate." applies. I actually don't
know what it means, either.)
diff --git a/man/mh-alias.man b/man/mh-alias.man
index 9a7776eb..a42b5fe8 100644
--- a/man/mh-alias.man
+++ b/man/mh-alias.man
@@ -1,4 +1,4 @@
-.TH MH-ALIAS %manext5% "November 15, 2014" "%nmhversion%"
+.TH MH-ALIAS %manext5% "March 20, 2017" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
@@ -6,6 +6,22 @@
mh-alias \- format of nmh alias files
.SH DESCRIPTION
.PP
+In its simplest form, an
+.B nmh
+alias file can contain lines like the following:
+.PP
+.RS 5
+.I auser
+.B :
+.I \*(lqA. B. User\*(rq <auser(_at_)example(_dot_)com>
+.RE
+.sp
+.RS 5
+.I cuser
+.B :
+.I C User <cuser(_at_)example(_dot_)com>
+.RE
+.PP
Each line of an
.B nmh
alias file takes one of the following forms:
_______________________________________________
Nmh-workers mailing list
Nmh-workers(_at_)nongnu(_dot_)org
https://lists.nongnu.org/mailman/listinfo/nmh-workers