NAME    [Toc]    [Back]

       ap - Parses addresses RFC 822-style

SYNOPSIS    [Toc]    [Back]

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

OPTIONS    [Toc]    [Back]

       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    [Toc]    [Back]

       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  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 columns, where columns is equal to the the width of
       the terminal.

RESTRICTIONS    [Toc]    [Back]

       On systems where MH is configured with  the  BERK  option,
       address parsing is not enabled.

EXAMPLES    [Toc]    [Back]

       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    [Toc]    [Back]

       User profile.  System customization file.

SEE ALSO    [Toc]    [Back]

       Commands: dp(8)

       Files: mh-format(4)

       Standard for the Format of  ARPA  Internet  Text  Messages
       (RFC 822)



                                                            ap(8)