ap(8)ap(8)NAMEap - Parses addresses RFC 822-style
SYNOPSIS
/usr/lib/mh/ap [-form file] [-format string] [-help] [-[no]normalize]
[-width columns] addrs...
OPTIONS
Overrides the default output format of ap. The output is formatted
according to the instructions in the specified file. This must be a
format file; see mh-format(4). Overrides the default output format of
ap. The output is formatted according to the instructions in the spec‐
ified string. This must be a format string; see mh-format(4).
The argument to the -format option must be interpreted as a sin‐
gle token by the shell that invokes ap. Therefore, you should
usually place the argument to this option inside double quotes
("). Prints a list of the valid options to this command. The
-normalize option tells ap to try to find the official host name
of the address. This is the default behavior, which can be sup‐
pressed using the -nonormalize option. Specifies the width of
the screen in columns.
DESCRIPTION
The ap program parses addresses according to the ARPA Internet stan‐
dard. It also understands many nonstandard formats. It is useful for
seeing how MH will interpret an address.
The ap program treats each argument as one or more addresses, and
prints those addresses in the official RFC 822 format. Hence, it is
usually best to enclose each argument in double quotes (") for the
shell.
In addition to the standard escapes, ap also recognizes the additional
escape error, which is a diagnostic that is returned if the parsing
operation failed.
The default settings for the ap command are -normalize and -width col‐
umns, where columns is equal to the the width of the terminal.
RESTRICTIONS
On systems where MH is configured with the BERK option, address parsing
is not enabled.
EXAMPLES
This is the default format string used by ap:
%<{error}%{error}: %{text}%|%(proper{text})%>
If an error was detected, the preceding string instructs ap to print
the error, a colon (:), and the address that is in error. Otherwise,
the ap command output is the proper RFC 822 format of the address.
FILES
User profile. System customization file.
SEE ALSO
Commands: dp(8)
Files: mh-format(4)
Standard for the Format of ARPA Internet Text Messages (RFC 822)
ap(8)