ap(8mh) 																   ap(8mh)

Name
       ap - parse addresses RFC 822-style

Syntax
       /usr/lib/mh/ap [ -form file ] [ -format string ] [ -help ] [ -[no]normalize ] [ -width columns ] addrs ...

Description
       The  program  parses  addresses	according to the ARPA Internet standard.  It also understands many non-standard formats.  It is useful for
       seeing how MH will interpret an address.

       The 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,  also recognizes the additional escape error, which is a diagnostic that is returned if the parse
       failed.

Options
       -form file
		 Overrides the default output format of The output is formatted according to the instructions in the specified file.  This must be
		 a format file; see

       -format string
		 Overrides  the default output format of The output is formatted according to the instructions in the specified string.  This must
		 be a format string; see

		 The argument to the -format option must be interpreted as a single token by the shell that invokes Therefore, you should  usually
		 place the argument to this option inside double quotes (").

       -help	 Prints a list of the valid options to this command.

       -normalize
       -nonormalize
		 Tells	to  try  to  find  the	official  host name of the address.  This is the default behavior.  It can be suppressed using the
		 -nonormalize option.

       -width columns
		 Specifies the width of the screen in columns.

       The defaults for this command are as follows:

	      -normalize
	      -width defaults to 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
       %<{error}%{error}: %{text}%|%(proper{text})%>
       If an error was detected, this string instructs to print the error, a colon (:), and the address that is in error.  Otherwise,  output  the
       proper RFC 822 format of the address.

Files
       User profile.

       System customization file.

See Also
       mh-format(5mh), dp(8mh)
       Standard for the Format of ARPA Internet Text Messages (RFC 822)

																	   ap(8mh)