]> diplodocus.org Git - nmh/blobdiff - man/ali.man
aliasbr.c: Remove duplicate prototypes. Others in aliasbr.h.
[nmh] / man / ali.man
index 49a0a888b184b74dd4cd0982cce317e3865b1314..5f8ce0d0ee08819463698eb9d2a9d45de33e956c 100644 (file)
@@ -1,23 +1,23 @@
-.\"
+.TH ALI %manext1% 2013-12-05 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\" $Id$
-.\"
-.TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
+.
 .SH NAME
-ali \- list mail aliases
+ali \- list nmh mail aliases
 .SH SYNOPSIS
 .HP 5
+.na
 .B ali
+.RB [ \-help ]
+.RB [ \-version ]
 .RB [ \-alias
 .IR aliasfile ]
 .RB [ \-list " | " \-nolist ]
-.RB [ \-normalize " | " \-nonormalize ]
 .RB [ \-user " | " \-nouser ]
-.RB [ \-version ]
-.RB [ \-help ] 
 .RI [ aliases " ...]"
+.ad
 .SH DESCRIPTION
-.B Ali
+.B ali
 searches the named mail alias files for each of the given
 .IR aliases .
 It creates a list of addresses for those
@@ -26,27 +26,22 @@ and writes that list on standard output.  If no arguments are given,
 .B ali
 outputs all alias entries.
 .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
 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.
+given address.
 .PP
 The files specified by the profile entry
 .RI \*(lq Aliasfile \*(rq
@@ -56,44 +51,44 @@ and any additional alias files given by the
 switch will be read.  Each
 .I alias
 is processed as described in
-.BR mh\-alias (5).
-
+.IR mh\-alias (5).
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-^/etc/passwd~^List of users
-^/etc/group~^List of groups
-.fi
-
+Alias files are looked up in multiple locations: if the pathname is
+absolute or starts with
+.RI \*(lq . \*(rq
+or
+.RI \*(lq .. \*(rq
+it is accessed directly; otherwise tilde expansion is done on
+usernames, then files are searched for in the user's
+.I Mail
+directory as specified in their profile.  If not found there, the directory
+.RI \*(lq %nmhetcdir% \*(rq
+is checked.
+.PP
+.TP 20
+$HOME/.mh_profile
+The user's profile.
 .SH "PROFILE COMPONENTS"
-.fc ^ ~
-.nf
-.ta 2.4i
-.ta \w'ExtraBigProfileName  'u
-^Path:~^To determine the user's nmh directory
-^Aliasfile:~^For a default alias file
-.fi
-
+.PP
+.PD 0
+.TP 20
+Path:
+To determine the user's nmh directory
+.TP
+Aliasfile:
+For a default alias file
+.PD
 .SH "SEE ALSO"
-mh\-alias(5)
-
+.IR mh\-alias (5)
 .SH DEFAULTS
-.nf
-.RB ` aliasfiles "' defaults to %etcdir%/MailAliases"
-.RB ` \-nolist '
-.RB ` \-nonormalize '
-.RB ` \-nouser '
-.fi
-
+.PD 0
+.TP 20
+aliasfile
+%nmhetcdir%/MailAliases
+.TP
+\-nolist
+.TP
+\-nouser
+.PD
 .SH CONTEXT
 None
-
-.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.