unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



ap(8)									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 opera-
  tion 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)