ap Command

Purpose

Parses and reformats addresses.

Syntax

ap-form File | -format String ] [  -normalize | -nonormalize ] [  -width Number ] Address

Description

The ap command parses and reformats addresses. The ap command is not started by the user. The ap command is called by other programs. The command is typically called by its full path name, /usr/lib/mh/ap.

The ap command parses each string specified by the address parameter and attempts to reformat it. The default output format for the ap command is the ARPA RFC 822 standard. When the default format is used, the ap command displays an error message for each string it is unable to parse.

Alternate file and string formats are specified by using the -form and -format flags.

Flags

Item Description
-form File Reformats the address string specified by the Address parameter into the alternate format described in the File variable.
-format String Reformats the address string specified by the Address parameter into the alternate format specified by the String variable. The default format string follows:
%<{error}%{error}:%{Address}%:%(putstr(proper{
   Address}))%>
-help Lists the command syntax, available switches (toggles), and version information.
Note: For MH, the name of this flag must be fully spelled out.
-nonormalize Does not attempt to convert local nicknames of hosts to their official host names.
-normalize Attempts to convert local nicknames of hosts to their official host names. This flag is the default.
-width Number Sets the maximum number of columns the ap command uses to display dates and error messages. The default is the width of the display.

Files

Item Description
/etc/mh/mtstailor Contains the MH tailor file.
$HOME/.mh_profile Contains the MH user profile.