Remove unused variable, and make sure we free c_dispo_type.

[nmh] / man / ap.man

diff --git a/man/ap.man b/man/ap.man
index d4c24a9e86024d9b03c0b756ca101924f1c11fc1..4e0b4f1c7545a08f8374225307367183b5bb46e7 100644 (file)
--- a/man/ap.man
+++ b/man/ap.man
@@ -1,84 +1,99 @@
+.TH AP %manext8% "December 4, 2013" "%nmhversion%"

 .\"
 .\" %nmhwarning%
 .\"
 .\" %nmhwarning%

-.\" $Id$

 .\"
 .\"

-.\" include the -mh macro file
-.so %etcdir%/tmac.h
-.\"
-.TH AP %manext8% MH.6.8 [%nmhversion%]

 .SH NAME
 .SH NAME

-ap \- parse addresses 822-style
+ap \- parse addresses RFC 822-style

 .SH SYNOPSIS
 .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
 .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.
 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
 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.
 for the details.

-
+.PP

 In addition to the standard escapes,
 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
 .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
 error  string  A diagnostic if the parse failed

-.re
+.RE

 .fi
 .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}))%>
 %<{error}%{error}: %{text}%|%(putstr(proper{text}))%>

-
+.RE
+.PP

 which says that if an error was detected, print the error, a `:', and
 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.
 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
 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
 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