new.c: Order two return statements to match comment.

[nmh] / man / mh-alias.man

diff --git a/man/mh-alias.man b/man/mh-alias.man
index dcb6e2122540fee7d84c821847d842e50fc9ee24..facea29a8ac02eb453fc08541ab9dcb237bac82e 100644 (file)
--- a/man/mh-alias.man
+++ b/man/mh-alias.man
@@ -1,9 +1,9 @@
-.TH MH-ALIAS %manext5% "Apr 18, 2014" "%nmhversion%"
-.\"
+.TH MH-ALIAS %manext5% 2014-04-18 "%nmhversion%"
+.

 .\" %nmhwarning%
 .\" %nmhwarning%

-.\"
+.

 .SH NAME
 .SH NAME

-mh-alias \- format of nmh alias files
+mh-alias \- format of nmh email-address alias files

 .SH DESCRIPTION
 .PP
 Each line of an
 .SH DESCRIPTION
 .PP
 Each line of an


@@ -13,18 +13,18 @@ alias file takes one of the following forms:
 .RS 5
 .I alias
 .B :
 .RS 5
 .I alias
 .B :

-.I address\-group
+.I address-group

 .RE
 .sp
 .RS 5
 .I alias
 .B ;
 .RE
 .sp
 .RS 5
 .I alias
 .B ;

-.I address\-group
+.I address-group

 .RE
 .sp
 .RS 5
 .B <
 .RE
 .sp
 .RS 5
 .B <

-.I alias\-file
+.I alias-file

 .RE
 .sp
 .RS 5
 .RE
 .sp
 .RS 5


@@ -40,30 +40,24 @@ where:
 .PP
 .RS 5
 .nf
 .PP
 .RS 5
 .nf

-.IR address\-group "   := " address\-list
+.IR address-group "    := " address-list

 .RI "                  |  < " file
 .RI "                  |  < " file

-.RI "                  |  = " UNIX\-group
-.RI "                  |  + " UNIX\-group
-                       |  *

 
 

-.IR address\-list "    := " address
-.RI "                  |  " address\-list ", " address
+.IR address-list "     := " address
+.RI "                  |  " address-list ", " address

 .fi
 .RE
 .PP
 Continuation lines end with \*(lq\\\*(rq followed by a newline
 character.  This also applies to comment lines.  Thus, the line following a
 .fi
 .RE
 .PP
 Continuation lines end with \*(lq\\\*(rq followed by a newline
 character.  This also applies to comment lines.  Thus, the line following a

-\*(lq\\\*(rq\-terminated
+\*(lq\\\*(rq-terminated

 comment line is a continuation of
 that comment line.
 .PP
 comment line is a continuation of
 that comment line.
 .PP

-.I Alias\-file
+.I Alias-file

 and
 .I file
 and
 .I file

-are UNIX file names.
-.I UNIX\-group
-is a group name or number from
-the system's group database.
+are Unix file names.

 Alias file contents are case-insensitive, with the exception
 of filesystem path names.
 .PP
 Alias file contents are case-insensitive, with the exception
 of filesystem path names.
 .PP


@@ -72,42 +66,12 @@ read for more alias definitions.  The reading is done recursively, so a
 \*(lq<\*(rq may occur in the beginning of an alias file with the expected results.
 .PP
 If the
 \*(lq<\*(rq may occur in the beginning of an alias file with the expected results.
 .PP
 If the

-.I address\-group
+.I address-group

 starts with a \*(lq<\*(rq, the file named after the
 \*(lq<\*(rq is read and its contents are added to the
 starts with a \*(lq<\*(rq, the file named after the
 \*(lq<\*(rq is read and its contents are added to the

-.I address\-list
+.I address-list

 for the alias.
 .PP
 for the alias.
 .PP

-If the
-.I address\-group
-starts with an \*(lq=\*(rq, the
-system's group database
-is consulted for the UNIX\-group named after the \*(lq=\*(rq.  Each login name
-occurring as a member of the group is added to the
-.I address\-list
-for the alias.
-.PP
-In contrast, if the
-.I address\-group
-starts with a \*(lq+\*(rq, the system's group database
-is consulted to determine the group\-id of the
-UNIX\-group named after the \*(lq+\*(rq.  Each login name occurring in the
-system's password database
-whose group\-id is indicated by this group is
-added to the
-.I address\-list
-for the alias.
-.PP
-If the
-.I address\-group
-is simply \*(lq*\*(rq, the system's password database
-is consulted and all login names with a userid
-greater than some magic number (usually 200) are added to the
-.I address\-list
-for the alias.
-.B
-This feature is obsolescent and will be removed in a future release.
-.PP

 In match, a trailing \*(lq*\*(rq on an alias will match just about anything
 appropriate.
 .PP
 In match, a trailing \*(lq*\*(rq on an alias will match just about anything
 appropriate.
 .PP


@@ -116,14 +80,14 @@ An approximation of the way aliases are resolved at posting time is:
 Build a list of all addresses from the message to be delivered,
 eliminating duplicate addresses.
 .IP 2)
 Build a list of all addresses from the message to be delivered,
 eliminating duplicate addresses.
 .IP 2)

-If this draft originated on the local host, then for those addresses in
-the message that have no host specified, perform alias resolution.
+For those addresses in the message that have no host specified,
+perform alias resolution.

 .IP 3)
 For each line in the alias file, compare \*(lqalias\*(rq against all of
 the existing addresses.  If a match, remove the matched \*(lqalias\*(rq
 .IP 3)
 For each line in the alias file, compare \*(lqalias\*(rq against all of
 the existing addresses.  If a match, remove the matched \*(lqalias\*(rq

-from the address list, and add each new address in the address\-group to
+from the address list, and add each new address in the address-group to

 the address list if it is not already on the list.  The alias itself is
 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
+not usually output, rather the address-group that the alias maps to is

 output instead.  If \*(lqalias\*(rq is terminated with a \*(lq;\*(rq instead of
 a \*(lq:\*(rq, then both the \*(lqalias\*(rq and the address are output in the
 correct format (with the alias quoted if necessary and the address
 output instead.  If \*(lqalias\*(rq is terminated with a \*(lq;\*(rq instead of
 a \*(lq:\*(rq, then both the \*(lqalias\*(rq and the address are output in the
 correct format (with the alias quoted if necessary and the address


@@ -138,24 +102,21 @@ Example Alias File
 .PP
 .RS 5
 .nf
 .PP
 .RS 5
 .nf

-<%etcdir%/BBoardAliases
-fred: frated@UCI.example
+<%nmhetcdir%/BBoardAliases

 sgroup: fred, fear, freida
 sgroup: fred, fear, freida

+fred: frated@UCI.example

 b-people: Blind List: bill, betty
 b-people: Blind List: bill, betty

-UNIX\-committee: <unix.aliases
-staff: =staff
-wheels: +wheel
+Unix\-committee: <unix.aliases

 news.*: news
 .fi
 .RE
 .PP
 The first line says that more aliases should immediately be read from
 the file
 news.*: news
 .fi
 .RE
 .PP
 The first line says that more aliases should immediately be read from
 the file

-.BR %etcdir%/BBoardAliases .
-Following this, \*(lqfred\*(rq
-is defined as an alias for \*(lqfrated@UCI.example\*(rq, and \*(lqsgroup\*(rq
-is defined as an alias for the three names \*(lqfrated@UCI.example\*(rq,
-\*(rqfear\*(rq, and \*(rqfreida\*(rq.
+.BR %nmhetcdir%/BBoardAliases .
+Next, \*(lqsgroup\*(rq is defined as an alias for three names,
+and one of them, \*(lqfred\*(rq,
+is a forward reference to another alias for \*(lqfrated@UCI.example\*(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
 .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


@@ -166,25 +127,24 @@ Note that blind lists are not supported with the
 .B sendmail/pipe
 mail transport method.
 .PP
 .B sendmail/pipe
 mail transport method.
 .PP

-Next, the definition of \*(lqUNIX\-committee\*(rq is given by
+The definition of \*(lqUnix\-committee\*(rq is given by

 reading the file
 .I unix.aliases
 in the user's
 .B nmh
 reading the file
 .I unix.aliases
 in the user's
 .B nmh

-directory,
-\*(lqstaff\*(rq is defined as all users who are listed as members of the
-group \*(lqstaff\*(rq in the
-system's group database, and \*(lqwheels\*(rq
-is defined as all users whose group\-id in
-the system's password database
-is equivalent to the \*(lqwheel\*(rq group.
+directory.
+.PP
+Lastly,
+.RI \*(lqnews. anything \*(rq
+is aliased to \*(lqnews\*(rq;
+the full stop is just another literal character.

 .SH "PROFILE COMPONENTS"
 .TP 20
 Aliasfile:
 Default alias file.
 .SH FILES
 .TP 20
 .SH "PROFILE COMPONENTS"
 .TP 20
 Aliasfile:
 Default alias file.
 .SH FILES
 .TP 20

-%etcdir%/MailAliases
+%nmhetcdir%/MailAliases

 System-wide default alias file.
 .SH "SEE ALSO"
 .IR ali (1),
 System-wide default alias file.
 .SH "SEE ALSO"
 .IR ali (1),


@@ -197,7 +157,7 @@ System-wide default alias file.
 Although the forward-referencing semantics of
 mh\-alias
 files prevent recursion, the
 Although the forward-referencing semantics of
 mh\-alias
 files prevent recursion, the

-.B alias\-file
+.B alias-file

 directive may defeat this.
 Since the number of file descriptors is finite, such
 infinite recursion will terminate with a meaningless diagnostic when
 directive may defeat this.
 Since the number of file descriptors is finite, such
 infinite recursion will terminate with a meaningless diagnostic when