annotate conf/doc/ja-bbc.rf @ 17:76d91e545ea8 default tip

addrsbr and dtimep fix
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 24 Nov 2014 14:49:25 +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 BBC 1
bce86c4163a3 Initial revision
kono
parents:
diff changeset
4 .NA
bce86c4163a3 Initial revision
kono
parents:
diff changeset
5 bbc \- 電子掲示板をチェックする
bce86c4163a3 Initial revision
kono
parents:
diff changeset
6 .SY
bce86c4163a3 Initial revision
kono
parents:
diff changeset
7 bbc
bce86c4163a3 Initial revision
kono
parents:
diff changeset
8 \%[bboards\ ...]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
9 \%[\-topics] \%[\-check] \%[\-read]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
10 \%[\-quiet] \%[\-verbose]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
11 \%[\-archive] \%[\-noarchive]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
12 \%[\-protocol] \%[\-noprotocol]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
13 \%[\-mshproc\ program]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
14 \%[switches\ for\ \fImshproc\fR]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
15 \%[\-rcfile rcfile] \%[\-norcfile]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
16 \%[\-file\ BBoardsfile] \%[\-user\ BBoardsuser]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
17 @BEGIN: BPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
18 \%[\-host\ host]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
19 \%[\-rpop] \%[\-norpop]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
20 @END: BPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
21 @BEGIN: NNTP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
22 \%[\-host\ host]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
23 @END: NNTP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
24 \%[\-help]
bce86c4163a3 Initial revision
kono
parents:
diff changeset
25 .DE
bce86c4163a3 Initial revision
kono
parents:
diff changeset
26 \fIbbc\fR は電子掲示板を
bce86c4163a3 Initial revision
kono
parents:
diff changeset
27 読んだりチェックしたりするプログラムです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
28 (なお、BBoards システムではなく、NetNews システムを使用している場合は、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
29 以下の「電子掲示板」は全て「ニュース・グループ」と読み換え下さい。)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
30
bce86c4163a3 Initial revision
kono
parents:
diff changeset
31 \fIbbc\fR プログラムには、その行動に応じて三つのオプションがあります。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
32
bce86c4163a3 Initial revision
kono
parents:
diff changeset
33 `\-read' オプションは、指定の電子掲示板に対して、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
34 \fImsh\fR プログラムを呼び出します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
35 もし、`\-archive' オプションも同時に指定した場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
36 \fIbbc\fR は指定の電子掲示板のアーカイヴに対して \fImsh\fR プログラムを
bce86c4163a3 Initial revision
kono
parents:
diff changeset
37 呼び出します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
38 もし、電子掲示板が指定されておらず、`\-archive' が指定された場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
39 \fIbbc\fR はプロファイルの `bboards' エントリは読まずに、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
40 代わりに電子掲示板 \*(lqsystem\*(rq のアーカイヴを読みます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
41
bce86c4163a3 Initial revision
kono
parents:
diff changeset
42 `\-check' オプションは指定の電子掲示板の状態を調べます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
43 \fIbbc\fR は、電子掲示板と、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
44 ユーザーがどの電子掲示板を読むように設定しているかの状態に依存して、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
45 いくつかの報告のうちの一つを表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
46 これらの報告それぞれについて、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
47 表示される数字は電子掲示板での最後の記事の記事番号です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
48 この番号(メッセージ内に \*(lqBBoard\-Id\*(rq という形式で記されている)は
bce86c4163a3 Initial revision
kono
parents:
diff changeset
49 絶えず増加しています。従って、\fIbbc\fR が \*(lqn items\*(rq といった場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
50 それは最大の BBoard\-Id が \*(lqn\*(rq である事を意味します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
51 電子掲示板内には実際には \*(lqn\*(rq 個の記事があるかも知れないし、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
52 ないかも知れません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
53 いくつかの共通の報告は次の通りです。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
54 .in +1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
55
bce86c4163a3 Initial revision
kono
parents:
diff changeset
56 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
57 \fBBBoard \-\- n items unseen\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
58 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
59 これは、ユーザーがいくつの記事をまだ見ていないかを示しています。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
60 `\-quiet' オプションを付けて起動された場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
61 \fIbbc\fR が表示する唯一の報告です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
62
bce86c4163a3 Initial revision
kono
parents:
diff changeset
63 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
64 \fBBBoard \-\- empty\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
65 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
66 電子掲示板は空です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
67
bce86c4163a3 Initial revision
kono
parents:
diff changeset
68 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
69 \fBBBoard \-\- n items (none seen)\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
70 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
71 電子掲示板には記事がありますが、ユーザーはまだ何も見ていません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
72
bce86c4163a3 Initial revision
kono
parents:
diff changeset
73 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
74 \fBBBoard \-\- n items (all seen)\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
75 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
76 電子掲示板には記事があり、ユーザーはその全てを見ています。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
77
bce86c4163a3 Initial revision
kono
parents:
diff changeset
78 .ti -.5i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
79 \fBBBoard \-\- n items seen out of m\fR
bce86c4163a3 Initial revision
kono
parents:
diff changeset
80 .br
bce86c4163a3 Initial revision
kono
parents:
diff changeset
81 電子掲示板には、ユーザーが見ていない記事が、多くとも m\-n 個あります。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
82
bce86c4163a3 Initial revision
kono
parents:
diff changeset
83 .in -1i
bce86c4163a3 Initial revision
kono
parents:
diff changeset
84
bce86c4163a3 Initial revision
kono
parents:
diff changeset
85 `\-topics' オプションは、指定の電子掲示板に関する三つの情報を表示します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
86 すなわち、その正式名(official name)、いくつの記事が存在するか、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
87 そして最終更新日時です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
88 もし、電子掲示板が全く指定されなかった場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
89 全ての電子掲示板に関して表示されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
90 もし、`\-verbose' オプションが指定されれば、もっと多くの情報が表示されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
91
bce86c4163a3 Initial revision
kono
parents:
diff changeset
92 `\-quiet' オプションをつけると、\fIbbc\fR は新しい記事がある電子掲示板が
bce86c4163a3 Initial revision
kono
parents:
diff changeset
93 ない場合は何も表示しません。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
94 `\-verbose' オプションをつけると、\fIbbc\fR は、あなたが
bce86c4163a3 Initial revision
kono
parents:
diff changeset
95 既に全記事を見た電子掲示板に対しても興味を示している、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
96 と考えます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
97
bce86c4163a3 Initial revision
kono
parents:
diff changeset
98 デフォルトの \fImshproc\fR とプロファイル・エントリを置き換えるためには
bce86c4163a3 Initial revision
kono
parents:
diff changeset
99 `\-mshproc\ program' オプションが使えます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
100 \fIbbc\fR が認識できない引数は全てこのプログラムに引き渡されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
101 `\-protocol' オプションをつけると、\fIbbc\fR は、\fImshproc\fR が、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
102 \fIbbc\fR に情報を送り返して来るための特別なプロトコルを知っている、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
103 とみなします。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
104 標準の \fImshproc\fR である \fImsh\fR\0(1) はこのプロトコルは全て知っています。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
105
bce86c4163a3 Initial revision
kono
parents:
diff changeset
106 `\-file\ BBoardsfile' オプションをつけると、\fIbbc\fR はその処理をする際に、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
107 非標準の電子掲示板ファイルを使います。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
108 同様に、`\-user BBoardsuser' オプションをつけると、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
109 \fIbbc\fR は非標準のユーザー名を使います。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
110 これら両方のオプションは新しい電子掲示板や
bce86c4163a3 Initial revision
kono
parents:
diff changeset
111 \fIPOP\fR ファイルをデバッグする際に有用です。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
112 @BEGIN: BPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
113
bce86c4163a3 Initial revision
kono
parents:
diff changeset
114 もし、ローカルホストが POP 電子掲示板クライアントとして設定されている場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
115 もしくは `\-host\ host' オプションが指定された場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
116 \fIbbc\fR は電子掲示板の状態を POP サーバーに聞きに行きます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
117 `\-user\ user' オプションには新しい意味があります。すなわち、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
118 それはサーバーの電子掲示板に関するゲスト・アカウントの名前を意味します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
119 `\-rpop' オプションは UNIX の \fIrPOP\fR を使います
bce86c4163a3 Initial revision
kono
parents:
diff changeset
120 (信頼される接続を通して認証が行なわれる)。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
121 それに対して、`\-norpop' オプションは ARPA \fIPOP\fR を使います
bce86c4163a3 Initial revision
kono
parents:
diff changeset
122 (この場合、\fIbbc\fR は \-user がゲスト・アカウントでない限り、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
123 パスワードを聞いて来ます)。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
124 @END: BPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
125 @BEGIN: NNTP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
126
bce86c4163a3 Initial revision
kono
parents:
diff changeset
127 もし、ローカルホストが NNTP クライアントとして設定されている場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
128 もしくは `\-host\ host' オプションが指定された場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
129 \fIbbc\fR は電子掲示板の状態を NNTP サーバーに聞きに行きます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
130 NNTP クライアントの場合、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
131 `\-user\ user' や `\-rpop' オプションは無視されます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
132 @END: NNTP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
133
bce86c4163a3 Initial revision
kono
parents:
diff changeset
134 ユーザーの \fB$HOME\fR ディレクトリにある \fI\&.bbrc\fR ファイルは
bce86c4163a3 Initial revision
kono
parents:
diff changeset
135 どの記事を読んだかの形跡を保存するために使われます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
136 `\-rcfile\ rcfile' オプションでこの目的に使う \fI\&.bbrc\fR を置き換えます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
137 もし、オプションで指定された値が絶対パスでない場合
bce86c4163a3 Initial revision
kono
parents:
diff changeset
138 (すなわち、\fB/\fR で始まってない場合)、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
139 それはカレント・ディレクトリからの相対パスと考えられます。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
140 もし、このオプションが指定されない場合
bce86c4163a3 Initial revision
kono
parents:
diff changeset
141 (あるいは `\-norcfile' オプションが指定された場合)、
bce86c4163a3 Initial revision
kono
parents:
diff changeset
142 \fIbbc\fR は環境変数 \fBMHBBRC\fR を見て、それを尊重します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
143 .Fi
bce86c4163a3 Initial revision
kono
parents:
diff changeset
144 ^$HOME/\&.mh\(ruprofile~^ユーザーのプロファイル
bce86c4163a3 Initial revision
kono
parents:
diff changeset
145 ^$HOME/\&.bbrc~^電子掲示板のカレント・メッセージ情報
bce86c4163a3 Initial revision
kono
parents:
diff changeset
146 .Pr
bce86c4163a3 Initial revision
kono
parents:
diff changeset
147 ^Path:~^ユーザーの MH ディレクトリを決める
bce86c4163a3 Initial revision
kono
parents:
diff changeset
148 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
149 ^bboards:~^興味のある電子掲示板を指定する
bce86c4163a3 Initial revision
kono
parents:
diff changeset
150 .Ps
bce86c4163a3 Initial revision
kono
parents:
diff changeset
151 ^mshproc:~^与えられた電子掲示板を読むためのプログラム
bce86c4163a3 Initial revision
kono
parents:
diff changeset
152 .Sa
bce86c4163a3 Initial revision
kono
parents:
diff changeset
153 bbl(1), bboards(1), msh(1)
bce86c4163a3 Initial revision
kono
parents:
diff changeset
154 .De
bce86c4163a3 Initial revision
kono
parents:
diff changeset
155 `\-read'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
156 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
157 `\-noarchive'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
158 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
159 `\-protocol'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
160 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
161 `bboards' デフォルトは \*(lqsystem\*(rq
bce86c4163a3 Initial revision
kono
parents:
diff changeset
162 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
163 `\-file @(BBHOME)/BBoards'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
164 .Ds
bce86c4163a3 Initial revision
kono
parents:
diff changeset
165 `\-user bboards'
bce86c4163a3 Initial revision
kono
parents:
diff changeset
166 @BEGIN: BPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
167 `\-rpop' 電子掲示板に対するゲスト・アカウントが使われない場合
bce86c4163a3 Initial revision
kono
parents:
diff changeset
168 @END: BPOP
bce86c4163a3 Initial revision
kono
parents:
diff changeset
169 .Co
bce86c4163a3 Initial revision
kono
parents:
diff changeset
170 無し。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
171 .Bu
bce86c4163a3 Initial revision
kono
parents:
diff changeset
172 `\-user' オプションは `\-file' オプションに続く場合だけ機能します。
bce86c4163a3 Initial revision
kono
parents:
diff changeset
173 .En