suse man page for ap

AP(8)                                                                [nmh-1.5]                                                               AP(8)

NAME
       ap - parse addresses 822-style

SYNOPSIS
       /usr/lib/mh/ap [-form formatfile] [-format string] [-normalize | -nonormalize] [-width columns] [-version] [-help] addrs ...

DESCRIPTION
       Ap  is a program that parses addresses according to the ARPA Internet standard.  It also understands many non-standard formats.  It is use-
       ful for seeing how nmh will interpret an address.

       The ap program treats each argument as one or more addresses, and prints those addresses out in the official 822-format.  Hence, it is usu-
       ally best to enclose each argument in quotes for the shell.

       To  override  the  output  format  used by ap, the -format string or -format file switches are used.  This permits individual fields of the
       address to be extracted with ease.  The string is simply a format string, and the file is simply a format file.  See mh-format(5)  for  the
       details.

       In addition to the standard escapes, ap also recognizes the following additional escape:

            Escape  Returns  Description
            error   string   A diagnostic if the parse failed

       If the -normalize switch is given, ap will try to track down the official hostname of the address.

       Here is the default format string used by ap:

            %<{error}%{error}: %{text}%|%(putstr(proper{text}))%>

       which says that if an error was detected, print the error, a `:', and the address in error.  Otherwise, output the 822-proper format of the
       address.

FILES
       $HOME/.mh_profile          The user profile
       /etc/nmh/mts.conf          nmh mts configuration file

PROFILE COMPONENTS
       None

SEE ALSO
       dp(8), Standard for the Format of ARPA Internet Text Messages (RFC-822)

DEFAULTS
       `-format' defaults as described above
       `-normalize'
       `-width' defaults to the width of the terminal

CONTEXT
       None

BUGS
       The argument to the -format switch must be interpreted as a single token by the shell that invokes ap.  Therefore, one must  usually  place
       the argument to this switch inside quotes.

MH.6.8                                                             11 June 2012                                                              AP(8)