ap Command

Edit online

Purpose

Parses and reformats addresses.

Syntax

ap [  -formFile | -formatString] [  -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 that is 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.

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

Flags

Table 1. Flags
Item Description
-formFile Reformats the address string that is specified by the Address parameter into the alternative format that is described in the File variable.
-formatString Reformats the address string that is specified by the Address parameter into the alternative format that is 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: Note:
For MH, the name of this flag must be fully spelled out.
-nonormalize Do not attempt to convert local nicknames of hosts to their official hostnames.
-normalize Attempts to convert local nicknames of hosts to their official hostnames. This flag is the default.
-widthNumber 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

Table 2. Files
Item Description
/etc/mh/mtstailor This directory contains the MH tailor file.
$HOME/.mh_profile This directory contains the MH user profile.