X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/94b8e5d6c0fff813de5da91558aaebf1df8c816e..94187a80bd60baab4b9c4b949ad820d730578123:/man/mh-alias.man diff --git a/man/mh-alias.man b/man/mh-alias.man index dcb6e212..facea29a 100644 --- 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% -.\" +. .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 @@ -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,30 +40,24 @@ where: .PP .RS 5 .nf -.IR address\-group " := " address\-list +.IR address-group " := " address-list .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 -\*(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 -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 @@ -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 -.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 -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 @@ -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) -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,24 +102,21 @@ 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: