Index for Section 8

Alphabetical listing for A

Bottom of page

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
  -form file
      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).

  -format string
      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 (").

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

  -normalize

  -nonormalize
      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.

  -width columns
      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 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
  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
  $HOME/.mh_profile
      User profile.

  /usr/lib/mh/mtstailor
      System customization file.

SEE ALSO
  Commands: dp(8)

  Files: mh-format(4)

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

Index for Section 8

Alphabetical listing for A

Top of page