X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/3d7993e40a34f52e2b6394c2f64ef0111ab886f7..5977791e005446f4cd8b2f04bfb14c8cd265df8a:/man/ap.man

diff --git a/man/ap.man b/man/ap.man
index a7d79a74..4dcae699 100644
--- a/man/ap.man
+++ b/man/ap.man
@@ -1,30 +1,28 @@
-.\"
+.TH AP %manext8% 2013-12-05 "%nmhversion%"
+.
 .\" %nmhwarning%
-.\" $Id$
-.\"
-.TH AP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
+.
 .SH NAME
-ap \- parse addresses 822-style
+ap \- nmh parser of RFC 822-style addresses
 .SH SYNOPSIS
 .HP 5
 .na
-.B %libdir%/ap
+.B %nmhlibexecdir%/ap
+.RB [ \-help ]
+.RB [ \-version ]
 .RB [ \-form
 .IR formatfile ]
 .RB [ \-format
 .IR string ]
-.RB [ \-normalize " | " \-nonormalize ]
 .RB [ \-width
 .IR columns ]
-.RB [ \-version ]
-.RB [ \-help ] 
 .I addrs
 \&...
 .ad
 .SH DESCRIPTION
-.B Ap
+.B ap
 is a program that parses addresses according to the ARPA
-Internet standard.  It also understands many non\-standard formats.
+Internet standard.  It also understands many non-standard formats.
 It is useful for seeing how
 .B nmh
 will interpret an address.
@@ -32,8 +30,8 @@ will interpret an address.
 The
 .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.
+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 ,
@@ -46,7 +44,7 @@ or
 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,
@@ -56,18 +54,11 @@ also recognizes the following additional escape:
 .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
 .PP
-If the
-.B \-normalize
-switch is given,
-.B ap
-will try to track down
-the official hostname of the address.
-.PP
 Here is the default format string used by
 .BR ap :
 .PP
@@ -76,40 +67,34 @@ Here is the default format string used by
 .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.
-
 .SH FILES
-.fc ^ ~
-.nf
-.ta \w'/usr/local/nmh/etc/ExtraBigFileName  'u
-^$HOME/\&.mh\(ruprofile~^The user profile
-^%etcdir%/mts.conf~^nmh mts configuration file
-.fi
-
+.PD 0
+.TP 20
+$HOME/.mh_profile
+The user's profile.
+.TP
+%nmhetcdir%/mts.conf
+The mts configuration file.
+.PD
 .SH "PROFILE COMPONENTS"
 None
-
 .SH "SEE ALSO"
-dp(8),
-.I "Standard for the Format of ARPA Internet Text Messages"
-(RFC\-822)
-
+.IR fmttest (1),
+.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
-
+.PD 0
+.TP 20
+-format
+As described above.
+.TP
+\-width
+The width of the terminal.
+.PD
 .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.