sbr/vector.c: Zero the growth with memset(3), not loop.

[nmh] / man / ali.man

diff --git a/man/ali.man b/man/ali.man
index c0e4abc39db67602a414f5be2c254b3b9b4a1bab..5f8ce0d0ee08819463698eb9d2a9d45de33e956c 100644 (file)
--- a/man/ali.man
+++ b/man/ali.man
@@ -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


@@ -57,38 +51,44 @@ and any additional alias files given by the
 switch will be read.  Each
 .I alias
 is processed as described in
 switch will be read.  Each
 .I alias
 is processed as described in

-.BR mh\-alias (5).
+.IR mh\-alias (5).

 .SH FILES
 .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.