First basic test of extended parameter output: working!

[nmh] / man / ali.man

diff --git a/man/ali.man b/man/ali.man
index 7e0c18175fd122ff3c75768b5bd6a47864c7ea32..1b9d670a3aa69e246eb508b76e920309ccb26483 100644 (file)
--- a/man/ali.man
+++ b/man/ali.man
@@ -1,69 +1,101 @@
+.TH ALI %manext1% "December 4, 2013" "%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 [ \-alias
+.IR aliasfile ]
+.RB [ \-list " | " \-nolist ]
+.RB [ \-user " | " \-nouser ]
+.RB [ \-version ]
+.RB [ \-help ] 
+.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.
-
+.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
 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.
 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
 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
 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.
 does not replace local nicknames for hosts with their official site names.

-.En