annotate conf/doc/ja-show.rf @ 12:441a2190cfae

Lion fix
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Sat, 21 Apr 2012 13:10:49 +0900
parents bce86c4163a3
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 SHOW 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 show \- メッセージを表示する
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 show
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 \%[+folder] \%[msgs]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 \%[\-draft]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 \%[\-header] \%[\-noheader]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 \%[\-showproc\ program] \%[\-noshowproc]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 \%[switches\ for\ \fIshowproc\fR]
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 \fIshow\fR は、指定されたメッセージそれぞれを標準出力(端末など)へ表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 通常、メッセージは整形されずにあるがままを表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 表示には \fIshowproc\fR で指定されたプログラムが呼び出され、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 \fIshow\fR 自身が認識しないオプションは全てこのプログラムへ引き渡されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 デフォルトのプログラムは
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 \fImore\fR\0(1) (またはオプション MORE で指定されたプログラム)です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 このデフォルトや \fIshowproc\fR の指定を変えたい場合は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 `\-showproc\ program' オプションを指定して下さい。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 例えば、`\-show\ pr' はメッセージを表示するために \fIpr\fR\0(1) プログラムを
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 呼び出します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 メッセージをもっと統一的な形式で表示させるために、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 \fIMH\fR コマンドの \fImhl\fR を \fIshowproc\fR として使うことが出来ます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 通常、このプログラムはユーザの \&.mh\(ruprofile の中で、\fIshowproc\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 コンポーネントとして指定されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 詳細は \fImhl\fR\0(1) を参照して下さい。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30 もし、`\-noshowproc' オプションが指定された場合は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 \fIshowproc\fR の代わりに `/bin/cat' が使われます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32 @BEGIN: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 プロファイルの \fImhnproc\fR エントリに
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 マルチメディア・メッセージを処理するためのプログラムを指定出来ます
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 (デフォルトは、この目的に適した \fImhn\fR\0(1) プログラムです)。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 もし、`\-noshowproc' オプションが指定されず、かつ、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 指定メッセージのうち一つ以上がマルチメディア・メッセージを含む場合は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 \fIshowproc\fR ではなく、代わりに \fImhnproc\fR が起動されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40 環境変数 \fBNOMHNPROC\fR がセットされてる場合には、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41 \fImhnproc\fR の使用は抑制されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 テキスト・メッセージを表示する際にも、その含まれる文字コードによっては、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43 \fImhnproc\fR が呼び出されるかも知れません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 不必要に \fImhnproc\fR が呼び出されるのを防ぐためには、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 環境変数 \fBMM_CHARSET\fP に端末の文字コードをセットしておくといいでしょう。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 @BEGIN: JAPAN
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 なお、日本語環境では特別な場合を除いて、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 \fBMM_CHARSET\fP に ISO\-2022\-JP をなどを指定する必要はありません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 @END: JAPAN
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 @END: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 `\-header' オプションを付けると、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 表示されるメッセージの一行説明が表示されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 この説明には、フォルダ名とメッセージ番号が含まれます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 もし `msgs' が全く指定されなかった場合は、カレント・メッセージが使われます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 もし、複数のメッセージが指定された場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 \fImore\fR はそれぞれのメッセージを表示する前に <RETURN> キー入力を待ちます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 \fImore\fR はそれぞれのメッセージを一ページずつ表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 一つのページが終わったら、\fImore\fR はベルを鳴らし、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 <SPACE> または <RETURN> キーの入力を待ちます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62 もし <RETURN> キーが入力されると、\fImore\fR は次の行を表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 同様に <SPACE> キーだと、次の一画面を表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 \fImore\fR を終了するためには \*(lqq\*(rq を入力します。
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
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 \*(lqshow \-draft\*(rq は <mh\-dir>/draft が存在する場合にそれを表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71 もしプロファイルに \*(lqUnseen\-Sequence\*(rq エントリが存在し、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72 かつ空でない場合、\fIshow\fR は表示されたそれぞれのメッセージを、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 そのプロファイル・エントリで指定されたシーケンスから削除します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74 これは `msgs' や `msg' の引数を取る全ての \fIMH\fR コマンドで
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 サポートされている \*(lqPrevious\-Sequence\*(rq エントリと似ています。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77 ^$HOME/\&.mh\(ruprofile~^ユーザーのプロファイル
bce86c4163a3 Initial revision
kono
parents:
diff changeset
78 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
79 ^Path:~^ユーザーの MH ディレクトリを決める
bce86c4163a3 Initial revision
kono
parents:
diff changeset
80 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
81 ^Current\-Folder:~^デフォルトのカレント・フォルダを示す
bce86c4163a3 Initial revision
kono
parents:
diff changeset
82 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
83 ^Unseen\-Sequence:~^未読メッセージを表すシーケンス名を示す
bce86c4163a3 Initial revision
kono
parents:
diff changeset
84 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
85 ^showproc:~^メッセージを表示するためのプログラム
bce86c4163a3 Initial revision
kono
parents:
diff changeset
86 @BEGIN: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
87 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
88 ^mhnproc:~^マルチメディア・メッセージを表示するためのプログラム
bce86c4163a3 Initial revision
kono
parents:
diff changeset
89 @END: MIME
bce86c4163a3 Initial revision
kono
parents:
diff changeset
90 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
91 mhl(1), more(1), next(1), pick(1), prev(1), scan(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
92 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
93 `+folder' デフォルトはカレント・フォルダ
bce86c4163a3 Initial revision
kono
parents:
diff changeset
94 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
95 `msgs' デフォルトは cur
bce86c4163a3 Initial revision
kono
parents:
diff changeset
96 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
97 `\-header'
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 最後に表示されたメッセージがカレント・メッセージになります。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
101 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
102 `msgs' が複数に展開される場合は `\-header' オプションは効きません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
103 この問題は \fIshowproc\fR が \fImhl\fR である場合は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
104 \fImhl\fR フォーマット・ファイル中で \*(lqmessagename\*(rq フィールドを
bce86c4163a3 Initial revision
kono
parents:
diff changeset
105 参照する事によって、避ける事が出来ます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
106
bce86c4163a3 Initial revision
kono
parents:
diff changeset
107 \fIshow\fR はメッセージを表示する前にユーザのコンテクストを更新します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
108 例えば、\fIshow\fR はユーザが実際にそのメッセージを見る前に
bce86c4163a3 Initial revision
kono
parents:
diff changeset
109 そのメッセージを既読にします。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
110 一般的にこれは、ユーザがメッセージの未読処理を信用し、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
111 未読メッセージ群を見ている途中で \fIshow\fR を中断してしまう場合を除いて、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
112 特に問題ではありません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
113
bce86c4163a3 Initial revision
kono
parents:
diff changeset
114 もし \fIshowproc\fR が \fImhl\fR の場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
115 \fIshow\fR は \fImhl\fR プログラムを実際に走らせずに、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
116 内蔵の \fImhl\fR ルーチンを使います。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
117 従って、もし自分で独自の \fIshowproc\fR を指定する場合に、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
118 それに \fImhl\fR という名前をつけてはなりません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
119 \fIshow\fR はそれを起動しないからです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
120
bce86c4163a3 Initial revision
kono
parents:
diff changeset
121 もし \fImore\fR\0(1) が showproc である場合(デフォルト)、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
122 \fIshow\fR を次のように、その標準出力のみを他のプロセスにパイプして
bce86c4163a3 Initial revision
kono
parents:
diff changeset
123 バックグラウンドで走らせるのは避けた方がいいでしょう。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
124
bce86c4163a3 Initial revision
kono
parents:
diff changeset
125 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
126 show | imprint &
bce86c4163a3 Initial revision
kono
parents:
diff changeset
127
bce86c4163a3 Initial revision
kono
parents:
diff changeset
128 \fImore\fR のバグのため、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
129 show は \*(lqtty input\*(rq 状態に陥ってしまいます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
130 この問題を避けるためには、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
131 \fIshow\fR のエラー出力もリダイレクトするといいでしょう。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
132 \fIcsh\fR のユーザーなら、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
133
bce86c4163a3 Initial revision
kono
parents:
diff changeset
134 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
135 show |& imprint &
bce86c4163a3 Initial revision
kono
parents:
diff changeset
136
bce86c4163a3 Initial revision
kono
parents:
diff changeset
137 \fIsh\fR のユーザーなら、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
138
bce86c4163a3 Initial revision
kono
parents:
diff changeset
139 .ti +.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
140 show 2>&1 | imprint &
bce86c4163a3 Initial revision
kono
parents:
diff changeset
141
bce86c4163a3 Initial revision
kono
parents:
diff changeset
142 とします。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
143 .En