Added test case for commit 4318012376e06229307c0ed4f62a00faae9edc63.

[nmh] / man / ali.man

diff --git a/man/ali.man b/man/ali.man
index 7e0c18175fd122ff3c75768b5bd6a47864c7ea32..1bed2722a11c6e50ec3a753b3bea84303980f3ea 100644 (file)
--- a/man/ali.man
+++ b/man/ali.man
@@ -1,69 +1,94 @@
+.TH ALI %manext1% "December 13, 2016" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %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
 .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 [ \-help ] 
+.RB [ \-version ]
+.RB [ \-alias
+.IR aliasfile ]
+.RB [ \-list " | " \-nolist ]
+.RB [ \-user " | " \-nouser ]
+.RI [ aliases " ...]"
+.ad

 .SH DESCRIPTION
 .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,
 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
 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.
 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
 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
 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