Updated man pages to remove dependence on tmac.h and have a more modern look
[mmh] / man / ali.man
1 .\"
2 .\" %nmhwarning%
3 .\" $Id$
4 .\"
5 .TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
6 .SH NAME
7 ali \- list mail aliases
8 .SH SYNOPSIS
9 .B ali
10 .RB [ \-alias
11 .IR aliasfile ]
12 .RB [ \-list " | " \-nolist ]
13 .RB [ \-normalize " | " \-nonormalize ]
14 .RB [ \-user " | " \-nouser ]
15 .RB [ \-version ]
16 .RB [ \-help ] 
17 .RI [ aliases " ...]"
18 .SH DESCRIPTION
19 .B Ali
20 searches the named mail alias files for each of the given
21 .IR aliases .
22 It creates a list of addresses for those
23 .IR aliases ,
24 and writes that list on standard output.  If no arguments are given,
25 .B ali
26 outputs all alias entries.
27 .PP
28 By default, when an aliases expands to multiple addresses, the addresses
29 are separated by commas and printed on as few lines as possible.  If the
30 .B \-list
31 option is specified, then when an address expands to multiple
32 addresses, each address will appear on a separate line.
33 .PP
34 The switch
35 .B \-user
36 directs
37 .B ali
38 to perform its processing in
39 an inverted fashion: instead of listing the addresses that each given
40 alias expands to,
41 .B ali
42 will list the aliases that expand to each
43 given address.  If the
44 .B \-normalize
45 switch is given,
46 .B ali
47 will
48 try to track down the official hostname of the address.
49 .PP
50 The files specified by the profile entry \*(lqAliasfile:\*(rq and any
51 additional alias files given by the
52 .RB ` \-alias
53 .IR aliasfile '
54 switch will be read.  Each
55 .I alias
56 is processed as described in
57 .BR mh\-alias (5).
58
59 .SH FILES
60 .fc ^ ~
61 .nf
62 .ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
63 ^$HOME/\&.mh\(ruprofile~^The user profile
64 ^/etc/passwd~^List of users
65 ^/etc/group~^List of groups
66
67 .SH "PROFILE COMPONENTS"
68 .fc ^ ~
69 .nf
70 .ta 2.4i
71 .ta \w'ExtraBigProfileName  'u
72 ^Path:~^To determine the user's nmh directory
73 ^Aliasfile:~^For a default alias file
74
75 .SH "SEE ALSO"
76 mh\-alias(5)
77
78 .SH "DEFAULTS"
79 .nf
80 .RB ` \-alias " %etcdir%/MailAliases'"
81 .RB ` \-nolist '
82 .RB ` \-nonormalize '
83 .RB ` \-nouser '
84
85 .SH CONTEXT
86 None
87
88 .SH BUGS
89 The
90 .B \-user
91 option with
92 .B \-nonormalize
93 is not entirely accurate, as it
94 does not replace local nicknames for hosts with their official site names.