annotate doc/ja-ap.me @ 0:bce86c4163a3

Initial revision
author kono
date Mon, 18 Apr 2005 23:46:02 +0900
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
bce86c4163a3 Initial revision
kono
parents:
diff changeset
1 .\" This file is automatically generated. Do not edit!
bce86c4163a3 Initial revision
kono
parents:
diff changeset
2 .\" written by MH-plus project
bce86c4163a3 Initial revision
kono
parents:
diff changeset
3 .SC AP 8
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 ap \- RFC\-822 形式でアドレスを解析する
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 /usr/local/mh/lib/ap
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 \%[\-form\ formatfile]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 \%[\-format\ string]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 \%[\-normalize] \%[\-nonormalize]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 \%[\-width\ columns]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 addrs\ ...
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 \%[\-help]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 \fIap\fR は、ARPA Internet 標準に従ったアドレス解析を行なうプログラムです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 多くの非標準フォーマットをも理解します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 これは、\fIMH\fR がどのようにアドレスを解釈しているかを理解するのに、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 役立ちます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 \fIap\fR は、引数を一つもしくはそれ以上のアドレスとして扱い、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 RFC\-822 フォーマットでこれらのアドレスを表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 それゆえシェルでは、ダブル・クォートでそれぞれの引数を囲むことが、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 通常最も望ましいです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 \fIap\fR で使われる出力形式を置き換えるためには、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 `\-format\ string' か `\-format\ file' オプションを使います。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 この方法でアドレスの個々のヘッダー行を簡単に取り出す事が出来ます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 string はフォーマット文字列で、file はフォーマット・ファイルです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 詳しくは \fImh\-format\fR\0(5) を参照して下さい。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 標準エスケープに加えて、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 \fIap\fR は次の付加的エスケープをも認識します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33 .sp 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 .nf
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 .ta \w'Escape 'u +\w'Returns 'u
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 \fIエスケープ\fR \fI戻り値\fR \fI説明\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 error string 解析が失敗した時の診断
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 .re
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 .fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41 もし `\-normalize' オプションが指定されると、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 \fIap\fR はアドレスの公式ホスト名を追跡しようとします。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 \fIap\fR で使われるデフォルトのフォーマット文字列は次の通りです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 %<{error}%{error}: %{text}%|%(putstr(proper{text}))%>
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 これは、もしエラーが発見された時、そのエラーと、`:' とエラーの起きた
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 アドレスを返します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 そうでなければ、アドレスの RFC\-822 準拠形式を出力します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 ^$HOME/\&.mh\(ruprofile~^ユーザーのプロファイル
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 ^/usr/local/mh/lib/mtstailor~^テイラー・ファイル
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 無し。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 dp(8),
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 \fIStandard for the Format of ARPA Internet Text Messages\fR (RFC\-822)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62 `\-format' デフォルトは上述の通り
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 `\-normalize'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66 `\-width' デフォルトは端末の幅
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67 .Co
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68 無し。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 `\-format' に対する引数は、\fIap\fR を呼び出すシェルにとって
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71 一語として解釈される形でなければなりません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72 従って、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 通常、このオプションに対する引数はダブル・クォートで囲まれなければなりません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 \fIMH\fR を BERK オプション付で構築したホストでは、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 アドレスの解析は出来ません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77 .En