X-Git-Url: https://diplodocus.org/git/nmh/blobdiff_plain/f90104a1c52886ee18a4af23b67535530b59f920..a514b8a78c447c8abc69386bee9f2c463b1c9362:/man/ap.man

diff --git a/man/ap.man b/man/ap.man
index ec6808b7..4e0b4f1c 100644
--- a/man/ap.man
+++ b/man/ap.man
@@ -1,23 +1,24 @@
+.TH AP %manext8% "December 4, 2013" "%nmhversion%"
 .\"
 .\" %nmhwarning%
-.\" $Id$
 .\"
-.TH AP %manext8% "%nmhdate%" MH.6.8 [%nmhversion%]
 .SH NAME
-ap \- parse addresses 822-style
+ap \- parse addresses RFC 822-style
 .SH SYNOPSIS
 .HP 5
+.na
 .B %libdir%/ap
 .RB [ \-form
 .IR formatfile ]
 .RB [ \-format
 .IR string ]
-.RB [ \-normalize " | " \-nonormalize ]
 .RB [ \-width
 .IR columns ]
 .RB [ \-version ]
 .RB [ \-help ] 
-.IR addrs " ..."
+.I addrs
+\&...
+.ad
 .SH DESCRIPTION
 .B Ap
 is a program that parses addresses according to the ARPA
@@ -29,19 +30,21 @@ 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 ,
 the
-.BI \-format " string"
+.B \-format
+.I string
 or
-.BI \-format " file"
+.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
-.BR mh\-format (5)
+.IR mh\-format (5)
 for the details.
 .PP
 In addition to the standard escapes,
@@ -49,21 +52,13 @@ In addition to the standard escapes,
 also recognizes the following additional escape:
 .PP
 .RS 5
-.fc ^ ~
 .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
@@ -72,37 +67,33 @@ 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
-
+.PD 0
+.TP 20
+$HOME/\&.mh\(ruprofile
+The user's profile.
+.TP
+%etcdir%/mts.conf
+The mts configuration file.
+.PD
 .SH "PROFILE COMPONENTS"
 None
-
 .SH "SEE ALSO"
-dp(8),
-.IR "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"
-
+.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
-
-.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.