]> diplodocus.org Git - nmh/blobdiff - man/ali.man
Simplified m_strn() per Ralph's suggestions.
[nmh] / man / ali.man
index 9d9deaf75d9f74439e8e6db2692a02a6c8f60f1b..5f8ce0d0ee08819463698eb9d2a9d45de33e956c 100644 (file)
@@ -1,24 +1,23 @@
-.TH ALI %manext1% "%nmhdate%" MH.6.8 [%nmhversion%]
-.\"
+.TH ALI %manext1% 2013-12-05 "%nmhversion%"
+.
 .\" %nmhwarning%
 .\" %nmhwarning%
-.\"
+.
 .SH NAME
 .SH NAME
-ali \- list mail aliases
+ali \- list nmh mail aliases
 .SH SYNOPSIS
 .HP 5
 .na
 .B ali
 .SH SYNOPSIS
 .HP 5
 .na
 .B ali
+.RB [ \-help ]
+.RB [ \-version ]
 .RB [ \-alias
 .IR aliasfile ]
 .RB [ \-list " | " \-nolist ]
 .RB [ \-alias
 .IR aliasfile ]
 .RB [ \-list " | " \-nolist ]
-.RB [ \-normalize " | " \-nonormalize ]
 .RB [ \-user " | " \-nouser ]
 .RB [ \-user " | " \-nouser ]
-.RB [ \-version ]
-.RB [ \-help ] 
 .RI [ aliases " ...]"
 .ad
 .SH DESCRIPTION
 .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
 searches the named mail alias files for each of the given
 .IR aliases .
 It creates a list of addresses for those
@@ -27,27 +26,22 @@ and writes that list on standard output.  If no arguments are given,
 .B ali
 outputs all alias entries.
 .PP
 .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
 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
 addresses, each address will appear on a separate line.
 .PP
-The switch
+The
 .B \-user
 .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
 .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
 .PP
 The files specified by the profile entry
 .RI \*(lq Aliasfile \*(rq
@@ -59,36 +53,42 @@ switch will be read.  Each
 is processed as described in
 .IR mh\-alias (5).
 .SH FILES
 is processed as described in
 .IR mh\-alias (5).
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'%etcdir%/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"
 .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"
 .IR mh\-alias (5)
 .SH DEFAULTS
 .SH "SEE ALSO"
 .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 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.