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