Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

ap(8mh) [ultrix man page]

ap(8mh) 																   ap(8mh)

Name
       ap - parse addresses RFC 822-style

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

Description
       The  program  parses  addresses	according to the ARPA Internet standard.  It also understands many non-standard formats.  It is useful for
       seeing how MH will interpret an address.

       The 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,  also recognizes the additional escape error, which is a diagnostic that is returned if the parse
       failed.

Options
       -form file
		 Overrides the default output format of The output is formatted according to the instructions in the specified file.  This must be
		 a format file; see

       -format string
		 Overrides  the default output format of The output is formatted according to the instructions in the specified string.  This must
		 be a format string; see

		 The argument to the -format option must be interpreted as a single token by the shell that invokes 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
		 Tells	to  try  to  find  the	official  host name of the address.  This is the default behavior.  It can be suppressed using the
		 -nonormalize option.

       -width columns
		 Specifies the width of the screen in columns.

       The defaults for this command are as follows:

	      -normalize
	      -width defaults to 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
       %<{error}%{error}: %{text}%|%(proper{text})%>
       If an error was detected, this string instructs to print the error, a colon (:), and the address that is in error.  Otherwise,  output  the
       proper RFC 822 format of the address.

Files
       User profile.

       System customization file.

See Also
       mh-format(5mh), dp(8mh)
       Standard for the Format of ARPA Internet Text Messages (RFC 822)

																	   ap(8mh)

Check Out this Related Man Page

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)
Man Page