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

diff --git a/man/ali.man b/man/ali.man
index 7e0c1817..1b9d670a 100644
--- a/man/ali.man
+++ b/man/ali.man
@@ -1,69 +1,101 @@
+.TH ALI %manext1% "December 4, 2013" "%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
 .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 [ \-alias
+.IR aliasfile ]
+.RB [ \-list " | " \-nolist ]
+.RB [ \-user " | " \-nouser ]
+.RB [ \-version ]
+.RB [ \-help ] 
+.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.
-
+.B ali
+outputs all alias entries.
+.PP
 By default, when an aliases 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
+option is specified, then when 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 switch
+.B \-user
+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
+then it's 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 %etcdir% \*(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
+%etcdir%/MailAliases
+.TP
+\-nolist
+.TP
+\-nouser
+.PD
+.SH CONTEXT
 None
-.Bu
-The `\-user' option with `\-nonormalize' is not entirely accurate, as it
+.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.
-.En