X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/1691e80890e5d8ba258c51c214a3e91880e1db2b..ec173fd2c:/man/ali.man?ds=sidebyside

diff --git a/man/ali.man b/man/ali.man
index 7e0c1817..5f8ce0d0 100644
--- a/man/ali.man
+++ b/man/ali.man
@@ -1,69 +1,94 @@
-.\"
+.TH ALI %manext1% 2013-12-05 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\" $Id$
-.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
-.TH ALI %manext1% MH.6.8 [%nmhversion%]
+.
 .SH NAME
-ali \- list mail aliases
+ali \- list nmh mail aliases
 .SH SYNOPSIS
-.in +.5i
-.ti -.5i
-ali
-\%[\-alias\ aliasfile]
-\%[\-list] \%[\-nolist]
-\%[\-normalize]
-.br
-\%[\-nonormalize]
-\%[\-user] \%[\-nouser]
-\%[aliases\ ...]
-.br
-\%[\-version]
-\%[\-help] 
-.in -.5i
+.HP 5
+.na
+.B ali
+.RB [ \-help ]
+.RB [ \-version ]
+.RB [ \-alias
+.IR aliasfile ]
+.RB [ \-list " | " \-nolist ]
+.RB [ \-user " | " \-nouser ]
+.RI [ aliases " ...]"
+.ad
 .SH DESCRIPTION
-\fIAli\fR searches the named mail alias files for each of the given
-\fIaliases\fR.  It creates a list of addresses for those \fIaliases\fR,
+.B ali
+searches the named mail alias files for each of the given
+.IR aliases .
+It creates a list of addresses for those
+.IR aliases ,
 and writes that list on standard output.  If no arguments are given,
-\fIali\fR outputs all alias entries.
-
-By default, when an aliases expands to multiple addresses, the addresses
+.B ali
+outputs all alias entries.
+.PP
+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
-`\-list' option is specified, then when an address expands to multiple
+.B \-list
+switch is specified, and an address expands to multiple
 addresses, each address will appear on a separate line.
-
-The switch `\-user' directs \fIali\fR to perform its processing in
+.PP
+The
+.B \-user
+switch directs
+.B ali
+to perform its processing in
 an inverted fashion: instead of listing the addresses that each given
-alias expands to, \fIali\fR will list the aliases that expand to each
-given address.  If the `\-normalize' switch is given, \fIali\fR will
-try to track down the official hostname of the address.
-
-The files specified by the profile entry \*(lqAliasfile:\*(rq and any
-additional alias files given by the `\-alias aliasfile' switch will be
-read.  Each \fIalias\fR is processed as described in \fImh\-alias\fR\0(5).
-.Fi
-^$HOME/\&.mh\(ruprofile~^The user profile
-^/etc/passwd~^List of users
-^/etc/group~^List of groups
-.Pr
-^Path:~^To determine the user's nmh directory
-.Ps
-^Aliasfile:~^For a default alias file
-.Sa
-mh\-alias(5)
-.De
-`\-alias %etcdir%/MailAliases'
-.Ds
-`\-nolist'
-.Ds
-`\-nonormalize'
-.Ds
-`\-nouser'
-.Co
+alias expands to,
+.B ali
+will list the aliases that expand to each
+given address.
+.PP
+The files specified by the profile entry
+.RI \*(lq Aliasfile \*(rq
+and any additional alias files given by the
+.B \-alias
+.I aliasfile
+switch will be read.  Each
+.I alias
+is processed as described in
+.IR mh\-alias (5).
+.SH FILES
+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"
+.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
+.PD 0
+.TP 20
+aliasfile
+%nmhetcdir%/MailAliases
+.TP
+\-nolist
+.TP
+\-nouser
+.PD
+.SH CONTEXT
 None
-.Bu
-The `\-user' option with `\-nonormalize' is not entirely accurate, as it
-does not replace local nicknames for hosts with their official site names.
-.En