+.TH AP %manext8% "December 4, 2013" "%nmhversion%"
.\"
.\" %nmhwarning%
-.\" $Id$
.\"
-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
-.TH AP %manext8% MH.6.8 [%nmhversion%]
.SH NAME
-ap \- parse addresses 822-style
+ap \- parse addresses RFC 822-style
.SH SYNOPSIS
-.in +.5i
-.ti -.5i
-%libdir%/ap
-\%[\-form\ formatfile]
-.br
-\%[\-format\ string]
-\%[\-normalize] \%[\-nonormalize]
-.br
-\%[\-width\ columns]
-addrs\ ...
-.br
-\%[\-version]
-\%[\-help]
-.in -.5i
+.HP 5
+.na
+.B %libdir%/ap
+.RB [ \-form
+.IR formatfile ]
+.RB [ \-format
+.IR string ]
+.RB [ \-width
+.IR columns ]
+.RB [ \-version ]
+.RB [ \-help ]
+.I addrs
+\&...
+.ad
.SH DESCRIPTION
-\fIAp\fR is a program that parses addresses according to the ARPA
+.B Ap
+is a program that parses addresses according to the ARPA
Internet standard. It also understands many non\-standard formats.
-It is useful for seeing how \fInmh\fR will interpret an address.
-
-The \fIap\fR 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.
-
-To override the output format used by \fIap\fR, the `\-format\ string' or
-`\-format\ file' switches are used. This permits individual fields of
+It is useful for seeing how
+.B nmh
+will interpret an address.
+.PP
+The
+.B ap
+program treats each argument as one or more addresses, and
+prints those addresses out in the official RFC 822 format. Hence, it is
+usually best to enclose each argument in quotes for the shell.
+.PP
+To override the output format used by
+.BR ap ,
+the
+.B \-format
+.I string
+or
+.B \-format
+.I file
+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 \fImh\-format\fR\0(5)
+string, and the file is simply a format file. See
+.IR mh\-format (5)
for the details.
-
+.PP
In addition to the standard escapes,
-\fIap\fR also recognizes the following additional escape:
-.sp 1
+.B ap
+also recognizes the following additional escape:
+.PP
+.RS 5
.nf
.ta \w'Escape 'u +\w'Returns 'u
-\fIEscape\fR \fIReturns\fR \fIDescription\fR
+.I "Escape Returns Description"
error string A diagnostic if the parse failed
-.re
+.RE
.fi
-
-If the `\-normalize' switch is given, \fIap\fR will try to track down
-the official hostname of the address.
-
-Here is the default format string used by \fIap\fR:
-
-.ti +.5i
+.PP
+Here is the default format string used by
+.BR ap :
+.PP
+.RS 5
%<{error}%{error}: %{text}%|%(putstr(proper{text}))%>
-
+.RE
+.PP
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 in error. Otherwise, output the RFC 822\-proper format of
the address.
-.Fi
-^$HOME/\&.mh\(ruprofile~^The user profile
-^%etcdir%/mts.conf~^nmh mts configuration file
-.Pr
+.SH FILES
+.PD 0
+.TP 20
+$HOME/\&.mh\(ruprofile
+The user's profile.
+.TP
+%etcdir%/mts.conf
+The mts configuration file.
+.PD
+.SH "PROFILE COMPONENTS"
None
-.Sa
-dp(8),
-.br
-\fIStandard for the Format of ARPA Internet Text Messages\fR (RFC\-822)
-.De
-`\-format' defaults as described above
-.Ds
-`\-normalize'
-.Ds
-`\-width' defaults to the width of the terminal
-.Co
+.SH "SEE ALSO"
+.IR dp (8)
+.PP
+.I
+Standard for the Format of ARPA Internet Text Messages
+(RFC 822)
+.SH DEFAULTS
+.PD 0
+.TP 20
+-format
+As described above.
+.TP
+\-width
+The width of the terminal.
+.PD
+.SH CONTEXT
None
-.Bu
-The argument to the `\-format' switch must be interpreted as a single token
-by the shell that invokes \fIap\fR.
-Therefore,
-one must usually place the argument to this switch inside double\-quotes.
-.En
projects / nmh / blobdiff