osf1 man page for ap

ap(8)							      System Manager's Manual							     ap(8)

NAME
       ap - 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
       specified string.  This must be a format string; see mh-format(4).

	      The argument to the -format option must be interpreted as a single 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 suppressed using
	      the -nonormalize option.	Specifies the width of the screen in columns.

DESCRIPTION
       The ap program parses addresses according to the ARPA Internet standard.  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 usu-
       ally 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 columns, 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)