X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fali.man;h=b0d471289638c1ec376c448b1a66f1b44c98e8aa;hp=7e0c18175fd122ff3c75768b5bd6a47864c7ea32;hb=363190329760d38060e89956206583831b0d084d;hpb=1691e80890e5d8ba258c51c214a3e91880e1db2b diff --git a/man/ali.man b/man/ali.man index 7e0c181..b0d4712 100644 --- a/man/ali.man +++ b/man/ali.man @@ -1,69 +1,99 @@ .\" .\" %nmhwarning% -.\" $Id$ .\" -.\" include the -mh macro file -.so %etcdir%/tmac.h -.\" -.TH ALI %manext1% MH.6.8 [%nmhversion%] +.TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME ali \- list mail aliases .SH SYNOPSIS -.in +.5i -.ti -.5i -ali -\%[\-alias\ aliasfile] -\%[\-list] \%[\-nolist] -\%[\-normalize] -.br -\%[\-nonormalize] -\%[\-user] \%[\-nouser] -\%[aliases\ ...] -.br -\%[\-version] -\%[\-help] -.in -.5i +.HP 5 +.na +.B ali +.RB [ \-alias +.IR aliasfile ] +.RB [ \-list " | " \-nolist ] +.RB [ \-normalize " | " \-nonormalize ] +.RB [ \-user " | " \-nouser ] +.RB [ \-version ] +.RB [ \-help ] +.RI [ aliases " ...]" +.ad .SH DESCRIPTION -\fIAli\fR searches the named mail alias files for each of the given -\fIaliases\fR. It creates a list of addresses for those \fIaliases\fR, +.B Ali +searches the named mail alias files for each of the given +.IR aliases . +It creates a list of addresses for those +.IR aliases , and writes that list on standard output. If no arguments are given, -\fIali\fR outputs all alias entries. - +.B ali +outputs all alias entries. +.PP By default, when an aliases expands to multiple addresses, the addresses are separated by commas and printed on as few lines as possible. If the -`\-list' option is specified, then when an address expands to multiple +.B \-list +option is specified, then when an address expands to multiple addresses, each address will appear on a separate line. - -The switch `\-user' directs \fIali\fR to perform its processing in +.PP +The switch +.B \-user +directs +.B ali +to perform its processing in an inverted fashion: instead of listing the addresses that each given -alias expands to, \fIali\fR will list the aliases that expand to each -given address. If the `\-normalize' switch is given, \fIali\fR will +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. +.PP +The files specified by the profile entry +.RI \*(lq Aliasfile \*(rq +and any additional alias files given by the +.B \-alias +.I aliasfile +switch will be read. Each +.I alias +is processed as described in +.BR mh\-alias (5). -The files specified by the profile entry \*(lqAliasfile:\*(rq and any -additional alias files given by the `\-alias aliasfile' switch will be -read. Each \fIalias\fR is processed as described in \fImh\-alias\fR\0(5). -.Fi -^$HOME/\&.mh\(ruprofile~^The user profile +.SH FILES +.fc ^ ~ +.nf +.ta \w'%etcdir%/ExtraBigFileName 'u +^$HOME/.mmh/profile~^The user profile ^/etc/passwd~^List of users ^/etc/group~^List of groups -.Pr -^Path:~^To determine the user's nmh directory -.Ps +.fi + +.SH "PROFILE COMPONENTS" +.fc ^ ~ +.nf +.ta 2.4i +.ta \w'ExtraBigProfileName 'u +^Path:~^To determine the user's mail storage ^Aliasfile:~^For a default alias file -.Sa +.fi + +.SH "SEE ALSO" mh\-alias(5) -.De -`\-alias %etcdir%/MailAliases' -.Ds -`\-nolist' -.Ds -`\-nonormalize' -.Ds -`\-nouser' -.Co + +.SH DEFAULTS +.nf +.RB ` \-nolist ' +.RB ` \-nonormalize ' +.RB ` \-nouser ' +.fi + +.SH CONTEXT None -.Bu -The `\-user' option with `\-nonormalize' is not entirely accurate, as it + +.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. -.En