add irc channel to README

[mmh] / man / ali.man1

diff --git a/man/ali.man1 b/man/ali.man1
index b0d4712..e6750cc 100644 (file)
--- a/man/ali.man1
+++ b/man/ali.man1
@@ -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
@@ -26,16 +26,17 @@ It creates a list of addresses for those
 and writes that list on standard output.  If no arguments are given,
 .B ali
 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
@@ -49,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
@@ -67,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