annotate conf/doc/ja-dp.rf @ 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 .\" @(MHWARNING)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
2 .\" written by MH-plus project
bce86c4163a3 Initial revision
kono
parents:
diff changeset
3 .SC DP 8
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 dp \- RFC\-822 形式で日付を解析する
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 @(MHETCPATH)/dp
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 \%[\-width\ columns]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 dates\ ...
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 \%[\-help]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 \fI\dp\fR は、ARPA Internet 標準に従った日付解析を行なうプログラムです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 TOPS\-20 サイトと \fIctime\fR\0(3) を使ういくつかの UNIX サイトによって
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 付けられている様な、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 多くの非標準フォーマットも理解します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 これは、\fIMH\fR がどのように日付を解釈しているかを理解するのに、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 役立ちます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 \fIdp\fR は、引数を一つの日付として扱い、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 RFC\-822 フォーマットでこの日付を表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 それゆえシェルでは、ダブル・クォートでそれぞれの引数を囲むことが、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 通常最も望ましいです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 \fIdp\fR で使われる出力形式を置き換えるためには、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 `\-format\ string' か `\-format\ file' オプションを使います。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 この方法で日付の個々のヘッダー行を簡単に取り出す事が出来ます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 string はフォーマット文字列で、file はフォーマット・ファイルです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30 詳しくは \fImh\-format\fR\0(5) を参照して下さい。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 \fIdp\fR で使われるデフォルトのフォーマット文字列は次の通りです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 .nf
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 %<(nodate{text})error: %{text}%|%(putstr(pretty{text}))%>
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 .fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 これは、もしエラーが発見された時、そのエラーと、`:' とエラーの起きた
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40 日付を返します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41 そうでなければ、日付の RFC\-822 準拠形式を出力します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43 ^$HOME/\&.mh\(ruprofile~^ユーザーのプロファイル
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 無し。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 ap(8)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 \fIStandard for the Format of ARPA Internet Text Messages\fR (RFC\-822)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 `\-format' デフォルトは上述の通り
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 `\-width' デフォルトは端末の幅
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 .Co
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55 無し。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 `\-format' に対する引数は、\fIdp\fR を呼び出すシェルにとって
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 一語として解釈される形でなければなりません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 従って、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 通常、このオプションに対する引数はダブル・クォートで囲まれなければなりません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 .En