X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/21280aed16e7a74b4c578c328ef76e2a4649985c..25b5d3aa852eb145beea1d3abcbe57e75f2e59a7:/man/mh-alias.man

diff --git a/man/mh-alias.man b/man/mh-alias.man
index e29db4a9..24cf0c20 100644
--- a/man/mh-alias.man
+++ b/man/mh-alias.man
@@ -1,7 +1,7 @@
+.TH MH-ALIAS %manext5% "Oct 14, 2012" "%nmhversion%"
 .\"
 .\" %nmhwarning%
 .\"
-.TH MH-ALIAS %manext5% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
 mh-alias \- alias file for nmh message system
 .SH SYNOPSIS
@@ -146,10 +146,13 @@ the address list if it is not already on the list.  The alias itself is
 not usually output, rather the address\-group that the alias maps to is
 output instead.  If \*(lqalias\*(rq is terminated with a `;' instead of
 a `:', then both the \*(lqalias\*(rq and the address are output in the
-correct format.  (This makes replies possible since
+correct format (with the alias quoted if necessary and the address
+wrapped in <>).
+.PP
+This makes replies possible since
 .B nmh
 aliases
-and personal aliases are unknown to the mail transport system.)
+and personal aliases are unknown to the mail transport system.
 .RE
 .PP
 Since the alias file is read line by line, forward references work, but
@@ -161,7 +164,7 @@ Example Alias File:
 .nf
 <%etcdir%/BBoardAliases
 sgroup: fred, fear, freida
-b-people: Blind List: bill, betty;
+b-people: Blind List: bill, betty
 fred: frated@UCI
 UNIX\-committee: <unix.aliases
 staff: =staff
@@ -181,8 +184,13 @@ is defined as an alias for the three names \*(lqfrated@UCI\*(rq,
 .PP
 The alias \*(lqb-people\*(rq is a blind list which includes the addresses
 \*(lqbill\*(rq and \*(lqbetty\*(rq; the message will be delivered to those
-addresses, but the message header will  show only \*(lqBlind List: ;\*(rq
-(not the addresses).
+addresses, but the message header will show only \*(lqBlind List: ;\*(rq
+(not the addresses).  The alias must not be terminated with, or contain,
+a semicolon; see
+.B Helpful Hints
+below.  Note that blind lists are not supported with the
+.B sendmail/pipe
+mail transport method.
 .PP
 Next, the definition of \*(lqUNIX\-committee\*(rq is given by
 reading the file
@@ -214,9 +222,8 @@ message transport system.  In contrast, once the message transport system
 is given a message to deliver to a list of addresses, for each address
 that appears to be local, a system\-wide alias file is consulted.  These
 aliases are
-.B NOT
+.B not
 expanded into the headers of messages delivered.
-
 .SH "HELPFUL HINTS"
 To use aliasing in
 .B nmh
@@ -251,14 +258,19 @@ Start adding aliases to your
 .RI \*(lq aliases \*(rq
 file as appropriate.
 .RE
-
+.PP
+Earlier versions of this man page showed a semicolon at the end of the
+blind list example.  That caused the preceeding alias to not be
+expanded.  There must not be a semicolon at the end of, or within, the
+address group of a blind list.
+.B post
+will append the semicolon to the blind list name.
 .SH FILES
 .fc ^ ~
 .nf
 .ta \w'%etcdir%/ExtraBigFileName  'u
 ^%etcdir%/MailAliases~^global nmh alias file
 .fi
-
 .SH "PROFILE COMPONENTS"
 .fc ^ ~
 .nf
@@ -266,13 +278,16 @@ file as appropriate.
 .ta \w'ExtraBigProfileName  'u
 ^Aliasfile:~^For a default alias file
 .fi
-
 .SH "SEE ALSO"
-ali(1), send(1), whom(1), group(5), passwd(5), conflict(8), post(8)
-
+.IR ali (1),
+.IR send (1),
+.IR whom (1),
+.IR group (5),
+.IR passwd (5),
+.IR conflict (8),
+.IR post (8)
 .SH CONTEXT
 None
-
 .SH BUGS
 Although the forward-referencing semantics of
 .B mh\-alias
@@ -282,5 +297,3 @@ command may defeat this.
 Since the number of file descriptors is finite (and very limited), such
 infinite recursion will terminate with a meaningless diagnostic when
 all the fds are used up.
-.PP
-Forward references do not work correctly inside blind lists.