X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/95e9c4e6befb17ca3e691c26f024fb55eeae5e31..94187a80bd60baab4b9c4b949ad820d730578123:/man/ali.man diff --git a/man/ali.man b/man/ali.man index 9d9deaf7..5f8ce0d0 100644 --- a/man/ali.man +++ b/man/ali.man @@ -1,24 +1,23 @@ -.TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] -.\" +.TH ALI %manext1% 2013-12-05 "%nmhversion%" +. .\" %nmhwarning% -.\" +. .SH NAME -ali \- list mail aliases +ali \- list nmh mail aliases .SH SYNOPSIS .HP 5 .na .B ali +.RB [ \-help ] +.RB [ \-version ] .RB [ \-alias .IR aliasfile ] .RB [ \-list " | " \-nolist ] -.RB [ \-normalize " | " \-nonormalize ] .RB [ \-user " | " \-nouser ] -.RB [ \-version ] -.RB [ \-help ] .RI [ aliases " ...]" .ad .SH DESCRIPTION -.B Ali +.B ali searches the named mail alias files for each of the given .IR aliases . It creates a list of addresses for those @@ -27,27 +26,22 @@ and writes that list on standard output. If no arguments are given, .B ali outputs all alias entries. .PP -By default, when an aliases expands to multiple addresses, the addresses +By default, when an alias expands to multiple addresses, the addresses are separated by commas and printed on as few lines as possible. If the .B \-list -option is specified, then when an address expands to multiple +switch is specified, and an address expands to multiple addresses, each address will appear on a separate line. .PP -The switch +The .B \-user -directs +switch directs .B ali to perform its processing in an inverted fashion: instead of listing the addresses that each given alias expands to, .B ali will list the aliases that expand to each -given address. If the -.B \-normalize -switch is given, -.B ali -will -try to track down the official hostname of the address. +given address. .PP The files specified by the profile entry .RI \*(lq Aliasfile \*(rq @@ -59,36 +53,42 @@ switch will be read. Each is processed as described in .IR mh\-alias (5). .SH FILES -.fc ^ ~ -.nf -.ta \w'%etcdir%/ExtraBigFileName 'u -^$HOME/\&.mh\(ruprofile~^The user profile -^/etc/passwd~^List of users -^/etc/group~^List of groups -.fi +Alias files are looked up in multiple locations: if the pathname is +absolute or starts with +.RI \*(lq . \*(rq +or +.RI \*(lq .. \*(rq +it is accessed directly; otherwise tilde expansion is done on +usernames, then files are searched for in the user's +.I Mail +directory as specified in their profile. If not found there, the directory +.RI \*(lq %nmhetcdir% \*(rq +is checked. +.PP +.TP 20 +$HOME/.mh_profile +The user's profile. .SH "PROFILE COMPONENTS" -.fc ^ ~ -.nf -.ta 2.4i -.ta \w'ExtraBigProfileName 'u -^Path:~^To determine the user's nmh directory -^Aliasfile:~^For a default alias file -.fi +.PP +.PD 0 +.TP 20 +Path: +To determine the user's nmh directory +.TP +Aliasfile: +For a default alias file +.PD .SH "SEE ALSO" .IR mh\-alias (5) .SH DEFAULTS -.nf -.RB ` aliasfiles "' defaults to %etcdir%/MailAliases" -.RB ` \-nolist ' -.RB ` \-nonormalize ' -.RB ` \-nouser ' -.fi +.PD 0 +.TP 20 +aliasfile +%nmhetcdir%/MailAliases +.TP +\-nolist +.TP +\-nouser +.PD .SH CONTEXT None -.SH BUGS -The -.B \-user -option with -.B \-nonormalize -is not entirely accurate, as it -does not replace local nicknames for hosts with their official site names.