annotate doc/ja-prompter.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 PROMPTER 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 prompter \- プロンプト形式のエディタ
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 prompter
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 \%[\-erase\ chr]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 \%[\-kill\ chr]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 \%[\-prepend] \%[\-noprepend]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 \%[\-rapid] \%[\-norapid]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 \%[\-doteof] \%[\-nodoteof]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 file
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 \%[\-help]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 このプログラムは通常ユーザーが直接起動する事はなく、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 \fIcomp\fR、\fIdist\fR、\fIforw\fR、\fIrepl\fR から、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 file で指定される RFC\-822 形式のドラフトの雛型を
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 操作するエディタとして働きます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 \fIprompter\fR はメッセージを高速に作成する事が出来るエディタです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 特に、遅いネットワーク(2400ボー以下)経由で \fIMH\fR を使う場合には有用です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 これは、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 プロファイル・エントリにオプション等を指定もできる \fIMH\fR プログラムですが、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 ユーザーが直接呼び出す事はありません
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 \fIcomp\fR、\fIdist\fR、\fIforw\fR、そして \fIrepl\fR コマンドが、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 `\-editor\ prompter' で指定された場合や、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 プロファイル・エントリ \*(lqEditor:\ prompter\*(rq による場合や、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 あるいは、\*(lqWhat now?\*(rq で `edit\ prompter' と指定された場合に、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30 \fIprompter\fR をエディタとして呼び出します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 \fIprompter\fR はドラフトの雛型の中に中身が空のヘッダー行を見つけると、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33 そのそれぞれについて、ユーザーに反応を求めるプロンプトを出します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 <RETURN> を打つと、そのヘッダー行をそのまま置いておきます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 また、`\\' を直前に置いた <RETURN> はそのヘッダー行が継続行として、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 次の行に続く事を意味します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 継続行は必ずスペースまたはタブで始まらなければなりません。
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 メッセージ・ボディの始まりは空行かダッシュの行で表されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 もし、ボディが空でなかったら、プロンプト(これはファイルには書き出されない)は
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 \*(lq--------Enter additional text\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 あるいは(`\-prepend' が指定された場合は)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 \*(lq--------Enter initial text\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 となります。メッセージ・ボディの打ち込みは end\-of\-file (通常 CTRL\-D) で
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 終了します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 `\-doteof' オプションをつけると、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 ピリオドだけからなる行も end\-of\-file として認識します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 この時点で、処理は呼び出し元のプログラムに戻されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55 \*(lqWhat now?\*(rq と聞かれた場合は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 これに対する様々なオプションは \fIwhatnow\fR(1) を参照して下さい。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 `\-prepend' オプションを使うと、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 ユーザーは打ち込むテキストをメッセージ・ボディの最初の部分に追加し、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 残りのボディをそれ以下に置くことが出来ます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 これは \fIforw\fR コマンドで有用です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 `\-rapid' オプションを使うと、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 もしドラフトのメッセージ・ボディ部に既にテキストがある場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65 それをユーザーの端末に表示しません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66 これは低速の端末に於いて有用です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68 行編集文字の kill 文字と erase 文字は `\-kill\ chr' と `\-erase\ chr' で
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 指定出来ます。chr は文字または `\\nnn' 形式で、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 \*(lqnnn\*(rq はその文字の八進数の値です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72 ヘッダー行を打ち込み中に割り込み(通常 CTRL\-C)をかけると、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 \fIprompter\fR とそれを呼び出した \fIMH\fR コマンドを終了します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74 メッセージ・ボディを打ち込み中に割り込みをかけると、歴史的な理由により、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 CTRL\-D と同じ扱いをします。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 これは \fIprompter\fR を終了する事を意味します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77
bce86c4163a3 Initial revision
kono
parents:
diff changeset
78 \fIprompter\fR へのオプションでない最初の引数は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
79 ドラフト・ファイルの名前と考えられ、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
80 それ以降のオプションでない引数は無視されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
81 .\" (\fIrepl\fR はエディタを二つのファイル引数と共に呼び出します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
82 .\" ドラフト・ファイル名と返信されるメッセージ・ファイル名です)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
83 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
84 ^$HOME/\&.mh\(ruprofile~^ユーザーのプロファイル
bce86c4163a3 Initial revision
kono
parents:
diff changeset
85 ^/tmp/prompter*~^メッセージの一時コピー
bce86c4163a3 Initial revision
kono
parents:
diff changeset
86 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
87 prompter\-next: \fIprompter\fR を終了した後で、呼び出されるエディタ
bce86c4163a3 Initial revision
kono
parents:
diff changeset
88 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
89 ^Msg\-Protect:~^新しいドラフトを作る際にセットされるモード
bce86c4163a3 Initial revision
kono
parents:
diff changeset
90 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
91 comp(1), dist(1), forw(1), repl(1), whatnow(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
92 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
93 `\-prepend'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
94 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
95 `\-norapid'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
96 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
97 `\-nodoteof'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
98 .Co
bce86c4163a3 Initial revision
kono
parents:
diff changeset
99 無し。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
100 .Hh
bce86c4163a3 Initial revision
kono
parents:
diff changeset
101 `\-rapid' オプションは特に \fIforw\fP コマンドで有用であり、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
102 `\-noprepend' は \fIcomp\ \-use\fP で有用です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
103
bce86c4163a3 Initial revision
kono
parents:
diff changeset
104 ユーザーは \fIprompter\fR を別の名前で(例えば \*(lqrapid\*(rq)リンクを作り、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
105 それのプロファイル・エントリに適切なオプション(例えば \*(lqrapid: -rapid\*(rq)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
106 をつけたいと思うかも知れません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
107 これは異なる \fIMH\fP コマンドに prompter を異なる呼び出し方をさせる事
bce86c4163a3 Initial revision
kono
parents:
diff changeset
108 (例えば、\*(lqforw: -editor rapid\*(rq)を容易にします。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
109 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
110 \fIprompter\fR は \fIstdio\fR\0(3) を使うので、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
111 ヌル文字を含むファイルを編集すると、それが失われてしまいます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
112 .En