+.TH AP %manext8% "November 6, 2012" "%nmhversion%"
.\"
.\" %nmhwarning%
.\"
-.TH AP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
.SH NAME
ap \- parse addresses 822-style
.SH SYNOPSIS
.B ap
program treats each argument as one or more addresses, and
prints those addresses out in the official 822\-format. Hence, it is
-usually best to enclose each argument in double\-quotes for the shell.
+usually best to enclose each argument in quotes for the shell.
.PP
To override the output format used by
.BR ap ,
switches are used. This permits individual fields of
the address to be extracted with ease. The string is simply a format
string, and the file is simply a format file. See
-.BR mh\-format (5)
+.IR mh\-format (5)
for the details.
.PP
In addition to the standard escapes,
.RS 5
.nf
.ta \w'Escape 'u +\w'Returns 'u
-.I Escape Returns Description
+.I "Escape Returns Description"
error string A diagnostic if the parse failed
.RE
.fi
which says that if an error was detected, print the error, a `:', and
the address in error. Otherwise, output the 822\-proper format of
the address.
-
.SH FILES
.fc ^ ~
.nf
^$HOME/\&.mh\(ruprofile~^The user profile
^%etcdir%/mts.conf~^nmh mts configuration file
.fi
-
.SH "PROFILE COMPONENTS"
None
-
.SH "SEE ALSO"
-dp(8),
-.I "Standard for the Format of ARPA Internet Text Messages"
+.IR dp (8)
+.PP
+.I
+Standard for the Format of ARPA Internet Text Messages
(RFC\-822)
-
.SH DEFAULTS
.nf
.RB ` \-format "' defaults as described above"
.RB ` \-normalize '
.RB ` \-width "' defaults to the width of the terminal"
.fi
-
.SH CONTEXT
None
-
-.SH BUGS
-The argument to the
-.B \-format
-switch must be interpreted as a single token
-by the shell that invokes
-.BR ap .
-Therefore,
-one must usually place the argument to this switch inside double\-quotes.