Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
AP(8)			     System Manager's Manual			   AP(8)

NAME
     ap - nmh parser of RFC 822-style addresses

SYNOPSIS
     /usr/local/libexec/nmh/ap [-help] [-version] [-form formatfile] [-format
	  string] [-width columns] addrs ...

DESCRIPTION
     ap  is a program that parses addresses according to the ARPA Internet stan-
     dard.  It also understands many non-standard formats.   It  is  useful  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 RFC 822 format.  Hence, it  is  usually
     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 addi-
     tional escape:

	  Escape  Returns  Description
	  error   string   A diagnostic if the parse failed

     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 RFC 822-proper format of	the  ad-
     dress.

FILES
     $HOME/.mh_profile	 The user's profile.
     /usr/local/etc/nmh/mts.conf
			 The mts configuration file.

PROFILE COMPONENTS
     None

SEE ALSO
     fmttest(1), dp(8)

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

DEFAULTS
     -format		 As described above.
     -width		 The width of the terminal.

CONTEXT
     None

nmh-1.8+dev			   2013-12-05				   AP(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ap&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help