X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/db9ac0f7507b4479bdd2a1ee2e22333c4d500a00..a9bb157da7d3cee576e8944eaf8fab2bdbc4be8d:/man/mh-alias.man diff --git a/man/mh-alias.man b/man/mh-alias.man index d765f887..f3c63c7c 100644 --- a/man/mh-alias.man +++ b/man/mh-alias.man @@ -1,7 +1,7 @@ -.TH MH-ALIAS %manext5% "Oct 14, 2012" "%nmhversion%" -.\" +.TH MH-ALIAS %manext5% 2014-04-18 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME mh-alias \- format of nmh alias files .SH DESCRIPTION @@ -13,18 +13,18 @@ alias file takes one of the following forms: .RS 5 .I alias .B : -.I address\-group +.I address-group .RE .sp .RS 5 .I alias .B ; -.I address\-group +.I address-group .RE .sp .RS 5 .B < -.I alias\-file +.I alias-file .RE .sp .RS 5 @@ -40,28 +40,27 @@ where: .PP .RS 5 .nf -.IR address\-group " := " address\-list +.IR address-group " := " address-list .RI " | < " file -.RI " | = " UNIX\-group -.RI " | + " UNIX\-group - | * +.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 -\*(lq\\\*(rq\-terminated +\*(lq\\\*(rq-terminated comment line is a continuation of that comment line. .PP -.I Alias\-file +.I Alias-file and .I file -are UNIX file names. -.I UNIX\-group +are Unix file names. +.I Unix-group is a group name or number from the system's group database. Alias file contents are case-insensitive, with the exception @@ -72,42 +71,32 @@ 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 -.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 -.I address\-list +.I address-list for the alias. .PP If the -.I address\-group +.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 +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 +.I address-list for the alias. .PP In contrast, if the -.I address\-group +.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 +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 +whose group-id is indicated by this group is added to the -.I address\-list +.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 @@ -116,14 +105,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) -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 -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 -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 @@ -138,11 +127,11 @@ Example Alias File .PP .RS 5 .nf -<%etcdir%/BBoardAliases -fred: frated@UCI.example +<%nmhetcdir%/BBoardAliases sgroup: fred, fear, freida +fred: frated@UCI.example b-people: Blind List: bill, betty -UNIX\-committee: