ap(8) - f14

1AP(8)                              [nmh-1.3]                             AP(8)
2
3
4

NAME

6       ap - parse addresses 822-style
7

SYNOPSIS

9       /usr/libexec/nmh/ap [-form formatfile] [-format string] [-normalize |
10            -nonormalize] [-width columns] [-version] [-help] addrs ...
11

DESCRIPTION

13       Ap is a program that parses addresses according to  the  ARPA  Internet
14       standard.  It also understands many non-standard formats.  It is useful
15       for seeing how nmh will interpret an address.
16
17       The ap program treats each argument  as  one  or  more  addresses,  and
18       prints  those  addresses  out in the official 822-format.  Hence, it is
19       usually best to enclose each argument in double-quotes for the shell.
20
21       To override the output format used by ap, the -format string or -format
22       file  switches are used.  This permits individual fields of the address
23       to be extracted with ease.  The string is simply a format  string,  and
24       the file is simply a format file.  See mh-format(5) for the details.
25
26       In  addition  to the standard escapes, ap also recognizes the following
27       additional escape:
28
29            Escape  Returns  Description
30            error   string   A diagnostic if the parse failed
31
32       If the -normalize switch is given, ap will try to track down the  offi‐
33       cial hostname of the address.
34
35       Here is the default format string used by ap:
36
37            %<{error}%{error}: %{text}%|%(putstr(proper{text}))%>
38
39       which  says  that if an error was detected, print the error, a `:', and
40       the address in error.  Otherwise, output the 822-proper format  of  the
41       address.
42
43

FILES

45       $HOME/.mh_profile          The user profile
46       /etc/nmh/mts.conf          nmh mts configuration file
47
48

PROFILE COMPONENTS

50       None
51
52

DEFAULTS

58       `-format' defaults as described above
59       `-normalize'
60       `-width' defaults to the width of the terminal
61
62

CONTEXT

64       None
65
66

BUGS

68       The  argument  to  the  -format  switch must be interpreted as a single
69       token by the shell that invokes ap.  Therefore, one must usually  place
70       the argument to this switch inside double-quotes.
71
72
73
74MH.6.8                            1 June 2008                            AP(8)