Commit | Line | Data |
---|---|---|
ad787160 C |
1 | .\" @(MHWARNING) |
2 | .\" @(#)$Id: bbc.rf,v 2.5 1992/02/05 21:00:33 jromine Exp $ | |
29a3a89d C |
3 | .SC BBC 1 |
4 | .NA | |
5 | bbc \- check on BBoards | |
6 | .SY | |
7 | bbc | |
8 | \%[bboards\ ...] | |
9 | \%[\-topics] \%[\-check] \%[\-read] | |
10 | \%[\-quiet] \%[\-verbose] | |
11 | \%[\-archive] \%[\-noarchive] | |
12 | \%[\-protocol] \%[\-noprotocol] | |
13 | \%[\-mshproc\ program] | |
14 | \%[switches\ for\ \fImshproc\fR] | |
15 | \%[\-rcfile rcfile] \%[\-norcfile] | |
16 | \%[\-file\ BBoardsfile] \%[\-user\ BBoardsuser] | |
ad787160 C |
17 | @BEGIN: BPOP |
18 | \%[\-host\ host] | |
19 | \%[\-rpop] \%[\-norpop] | |
20 | @END: BPOP | |
21 | @BEGIN: NNTP | |
22 | \%[\-host\ host] | |
23 | @END: NNTP | |
29a3a89d C |
24 | \%[\-help] |
25 | .DE | |
26 | \fIbbc\fR is a BBoard | |
27 | reading/checking program that interfaces to the BBoard | |
28 | channel. | |
29 | ||
30 | The \fIbbc\fR program has three action switches which direct its operation: | |
31 | ||
32 | The `\-read' switch invokes the \fImsh\fR program on the named | |
33 | \fIBBoards\fR. If you also specify | |
34 | the `\-archive' switch, then \fIbbc\fR will invoke the \fImsh\fR program on | |
35 | the archives of the named \fIBBoards\fR. If no \fIBBoards\fR are given | |
36 | on the command line, and you specified `\-archive', | |
37 | \fIbbc\fR will not read your `bboards' profile entry, but will | |
38 | read the archives of the \*(lqsystem\*(rq \fIBBoard\fR instead. | |
39 | ||
40 | The `\-check' switch types out status information for the named \fIBBoards\fR. | |
41 | \fIbbc\fR | |
42 | can print one of several messages depending on the status of both the | |
43 | BBoard | |
44 | and the user's reading habits. | |
45 | As with each of these messages, the number | |
46 | given is the item number of the last item placed in the | |
47 | BBoard. | |
48 | This number (which is marked in the messages as the \*(lqBBoard\-Id\*(rq) is | |
49 | ever increasing. Hence, when \fIbbc\fR | |
50 | says \*(lqn items\*(rq, it really means that the highest BBoard\-Id is \*(lqn\*(rq. | |
51 | There may, or may not actually be \*(lqn\*(rq items in the BBoard. | |
52 | Some common messages are: | |
53 | .in +1i | |
54 | ||
55 | .ti -.5i | |
56 | \fBBBoard \-\- n items unseen\fR | |
57 | .br | |
58 | This message tells how many items the user has not yet seen. | |
59 | When invoked with the `\-quiet' switch, | |
60 | this is the only informative line that \fIbbc\fR will possibly print out. | |
61 | ||
62 | .ti -.5i | |
63 | \fBBBoard \-\- empty\fR | |
64 | .br | |
65 | The BBoard is empty. | |
66 | ||
67 | .ti -.5i | |
68 | \fBBBoard \-\- n items (none seen)\fR | |
69 | .br | |
70 | The BBoard has items in it, but the user hasn't seen any. | |
71 | ||
72 | .ti -.5i | |
73 | \fBBBoard \-\- n items (all seen)\fR | |
74 | .br | |
75 | The BBoard is non\-empty, and the user has seen everything in it. | |
76 | ||
77 | .ti -.5i | |
78 | \fBBBoard \-\- n items seen out of m\fR | |
79 | .br | |
80 | The BBoard has at most m\-n items that the user has not seen. | |
81 | .in -1i | |
82 | ||
83 | The `\-topics' switch directs \fIbbc\fR to print three items about the named | |
84 | \fIBBoards\fR: | |
85 | it's official name, | |
86 | the number of items present, | |
87 | and the date and time of the last update. | |
88 | If no \fIBBoards\fR | |
89 | are named, then all BBoards | |
90 | are listed. If the `\-verbose' switch is given, more information is output. | |
91 | ||
92 | The `\-quiet' switch specifies that \fIbbc\fR should be silent if no | |
93 | \fIBBoards\fR are found with new information. | |
94 | The `\-verbose' switch specifies that \fIbbc\fR is to consider you to be | |
95 | interested in \fIBBoards\fR that you've already seen everything in. | |
96 | ||
97 | To override the default \fImshproc\fR and the profile entry, | |
98 | use the `\-mshproc\ program' switch. | |
99 | Any arguments not understood by \fIbbc\fR are passed to this program. | |
100 | The `\-protocol' switch tells \fIbbc\fR that your \fImshproc\fR knows about | |
101 | the special \fIbbc\fR protocol for reporting back information. | |
102 | \fImsh\fR\0(1), the default \fImshproc\fR, knows all about this. | |
103 | ||
104 | The `\-file\ BBoardsfile' switch tells \fIbbc\fR to use a non\-standard | |
105 | \fIBBoards\fR file when performing its calculations. | |
106 | Similarly, the `\-user BBoardsuser' switch tells \fIbbc\fR to use a | |
107 | non\-standard username. | |
108 | Both of these switches are useful for debugging a new \fIBBoards\fR or | |
109 | \fIPOP\fR file. | |
ad787160 | 110 | @BEGIN: BPOP |
29a3a89d | 111 | |
ad787160 C |
112 | If the local host is configured as a POP BBoards client, |
113 | or if the `\-host\ host' switch is given, | |
114 | then \fIbbc\fR will query the POP service host as to the status of the BBoards. | |
115 | The `\-user\ user' switch then takes on a new meaning: | |
116 | it refers to the name of the guest account for BBoards on the service host. | |
117 | The `\-rpop' switch uses the UNIX \fIrPOP\fR | |
118 | (authentication done via trusted connections). | |
119 | In contrast, the `\-norpop' switch uses the ARPA \fIPOP\fR | |
120 | (in which case \fIbbc\fR will prompt for a password, | |
121 | unless the \-user specifies the guest account). | |
122 | @END: BPOP | |
123 | @BEGIN: NNTP | |
124 | ||
125 | If the local host is configured as an NNTP BBoards client, | |
126 | or if the `\-host\ host' switch is given, | |
127 | then \fIbbc\fR will query the NNTP service host | |
128 | as to the status of the BBoards. | |
129 | For NNTP BBoards clients, | |
130 | the `\-user\ user' and the `\-rpop' switches are ignored. | |
131 | @END: NNTP | |
132 | ||
133 | The \fI\&.bbrc\fR file in the | |
134 | user's \fB$HOME\fR directory | |
135 | is used to keep track of what messages have been read. | |
29a3a89d | 136 | The `\-rcfile\ rcfile' switch overrides the use of \fI\&.bbrc\fR for |
ad787160 | 137 | this purpose. |
29a3a89d C |
138 | If the value given to the switch is not absolute, |
139 | (i.e., does not begin with a \fB/\fR\0), | |
140 | it will be presumed to start from the current working directory. | |
141 | If this switch is not given (or the `\-norcfile' switch is given), | |
ad787160 | 142 | then \fIbbc\fR consults the envariable \fB$MHBBRC\fR, |
29a3a89d | 143 | and honors it similarly. |
29a3a89d C |
144 | .Fi |
145 | ^$HOME/\&.mh\(ruprofile~^The user profile | |
ad787160 | 146 | ^$HOME/\&.bbrc~^BBoard \*(lqcurrent\*(rq message information |
29a3a89d C |
147 | .Pr |
148 | ^Path:~^To determine the user's MH directory | |
149 | .Ps | |
150 | ^bboards:~^To specify interesting BBoards | |
151 | .Ps | |
152 | ^mshproc:~^Program to read a given BBoard | |
153 | .Sa | |
154 | bbl(1), bboards(1), msh(1) | |
155 | .De | |
156 | `\-read' | |
157 | .Ds | |
158 | `\-noarchive' | |
159 | .Ds | |
160 | `\-protocol' | |
161 | .Ds | |
162 | `bboards' defaults to \*(lqsystem\*(rq | |
163 | .Ds | |
ad787160 | 164 | `\-file @(BBHOME)/BBoards' |
29a3a89d C |
165 | .Ds |
166 | `\-user bboards' | |
ad787160 C |
167 | @BEGIN: BPOP |
168 | `\-rpop' unless the guest account for BBoards is used | |
169 | @END: BPOP | |
29a3a89d C |
170 | .Co |
171 | None | |
172 | .Bu | |
173 | The `\-user' switch takes effect only if followed by the `\-file' switch. | |
174 | .En |