add irc channel to README
[mmh] / man / ali.man1
index 480c363..e6750cc 100644 (file)
@@ -8,12 +8,12 @@ ali \- list mail aliases
 .HP 5
 .na
 .B ali
-.RB [ \-alias
-.IR aliasfile ]
+.RB [ \-file
+.IR aliasfile ]...
 .RB [ \-list " | " \-nolist ]
 .RB [ \-normalize " | " \-nonormalize ]
 .RB [ \-user " | " \-nouser ]
-.RB [ \-version ]
+.RB [ \-Version ]
 .RB [ \-help ]
 .RI [ aliases " ...]"
 .ad
@@ -28,15 +28,15 @@ and writes that list on standard output.  If no arguments are given,
 outputs all alias entries.
 This can be used to check the format of the alias file for validity.
 .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
@@ -50,16 +50,23 @@ switch is given,
 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
+If no
+.B \-file
+.I aliasfile
+is given, then the default alias files, as specified by the profile entry
+.RI ` Aliasfile ',
+will be read.
+If any alias files are given by
+.B \-file
 .I aliasfile
-switch will be read.  Each
+switches, these will be read instead of the default alias files.
+Either the default alias files are read or the ones given at the
+command line, never both.
+.PP
+Each
 .I alias
 is processed as described in
 .BR mh\-alias (5).
-
 .SH FILES
 .fc ^ ~
 .nf
@@ -68,29 +75,24 @@ is processed as described in
 ^/etc/passwd~^List of users
 ^/etc/group~^List of groups
 .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
+^Aliasfile:~^For default alias files
 .fi
-
 .SH "SEE ALSO"
 mh\-alias(5)
-
 .SH DEFAULTS
 .nf
 .RB ` \-nolist '
 .RB ` \-nonormalize '
 .RB ` \-nouser '
 .fi
-
 .SH CONTEXT
 None
-
 .SH BUGS
 The
 .B \-user