X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmh-alias.man5;h=e05358a18a08320507783e653dad518c70945e83;hp=c8368bebb1cb007c444c12b81cd8420ab34f33e8;hb=57abb238e16c26d285904e51b7568be3c45d8614;hpb=5aaedc4256d58afe2481d667afdcb5162a914ba9 diff --git a/man/mh-alias.man5 b/man/mh-alias.man5 index c8368be..e05358a 100644 --- a/man/mh-alias.man5 +++ b/man/mh-alias.man5 @@ -4,10 +4,6 @@ .TH MH-ALIAS %manext5% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME mh-alias \- alias file for nmh message system -.SH SYNOPSIS -any -.B nmh -command .SH DESCRIPTION This describes .B nmh @@ -15,6 +11,7 @@ personal alias files. It does .B not describe aliases files used by the message transport system. +.PP Each line of the alias file has the format: .PP .RS 5 @@ -57,14 +54,14 @@ where: Continuation lines in alias files end with `\\' followed by the newline character. .PP -.RI \*(lq Alias\-file \*(rq +.RI ` Alias\-file ' and -.RI \*(lq file \*(rq +.RI ` file ' are UNIX file names. .I UNIX\-group is a group name (or number) from .IR /etc/group . -An address is a \*(lqsimple\*(rq +An address is a `simple' Internet\-style address. Througout this file, case is ignored, except for file names. .PP @@ -98,18 +95,10 @@ UNIX\-group named after the `+'. Each login name occurring in the file 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 `*', then the file -.I /etc/passwd -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. +for the alias. I.e. only those users that have this group as their +initial login group are added. .PP -In match, a trailing \*(lq*\*(rq on an alias will match just about anything +In match, a trailing `*' on an alias will match just about anything appropriate. (See example below.) .PP An approximation of the way aliases are resolved at posting time is @@ -125,13 +114,13 @@ If this draft originated on the local host, then for those addresses in the message that have no host specified, perform alias resolution. .PP .IP 3) 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 +For each line in the alias file, compare `alias' against all of +the existing addresses. If a match, remove the matched `alias' 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 -output instead. If \*(lqalias\*(rq is terminated with a `;' instead of -a `:', then both the \*(lqalias\*(rq and the address are output in the +output instead. If `alias' is terminated with a `;' instead of +a `:', then both the `alias' and the address are output in the correct format. (This makes replies possible since personal .B nmh aliases are unknown to the mail transport system.) @@ -151,7 +140,6 @@ fred: frated@UCI UNIX\-committee: \*(rq are defined to be \*(lqnews\*(rq. +Finally, all aliases of the form +`news.' are defined to be `news'. .PP The key thing to understand about aliasing in .B nmh @@ -212,27 +197,25 @@ quickly, do the following: In your .IR .mmh/profile , choose a name for your alias file, say -.RI \*(lq aliases \*(rq, +.RI ` aliases ', and add the line: .PP .RS 5 .nf Aliasfile: aliases -.\" ali: \-alias aliases -.\" send: \-alias aliases .fi .RE .PP .IP 2) 3 Create the file -.RI \*(lq aliases \*(rq +.RI ` aliases ' in your .B mmh directory. .PP .IP 3) 3 Start adding aliases to your -.RI \*(lq aliases \*(rq +.RI ` aliases ' file as appropriate. .RE @@ -248,16 +231,20 @@ None .fi .SH "SEE ALSO" -ali(1), send(1), group(5), passwd(5), conflict(8), post(8) +ali(1), send(1), group(5), passwd(5), post(8) .SH CONTEXT None +.SH HISTORY +An address group named `*', meaning everyone on the system, had been +supported in nmh. It is not anymore in mmh. + .SH BUGS Although the forward-referencing semantics of .B mh\-alias files prevent recursion, the -.RI \*(lq< " alias\-file" \*(rq +.RI `< " alias\-file" ' 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