8 date 95.12.06.22.48.30; author jromine; state Exp;
13 date 92.02.05.21.00.33; author jromine; state Exp;
18 date 90.04.05.15.07.52; author sources; state Exp;
23 date 90.03.22.11.30.51; author sources; state Exp;
28 date 90.03.20.19.41.27; author sources; state Exp;
33 date 90.03.20.17.35.45; author sources; state Exp;
38 date 89.11.17.15.56.33; author sources; state Exp;
43 date 89.06.02.11.27.08; author sources; state Exp;
54 @fixup some envar references
58 .\" @@(#)$Id: bbc.rf,v 2.5 1992/02/05 21:00:33 jromine Exp jromine $
61 bbc \- check on BBoards
65 \%[\-topics] \%[\-check] \%[\-read]
66 \%[\-quiet] \%[\-verbose]
67 \%[\-archive] \%[\-noarchive]
68 \%[\-protocol] \%[\-noprotocol]
69 \%[\-mshproc\ program]
70 \%[switches\ for\ \fImshproc\fR]
71 \%[\-rcfile rcfile] \%[\-norcfile]
72 \%[\-file\ BBoardsfile] \%[\-user\ BBoardsuser]
75 \%[\-rpop] \%[\-norpop]
83 reading/checking program that interfaces to the BBoard
86 The \fIbbc\fR program has three action switches which direct its operation:
88 The `\-read' switch invokes the \fImsh\fR program on the named
89 \fIBBoards\fR. If you also specify
90 the `\-archive' switch, then \fIbbc\fR will invoke the \fImsh\fR program on
91 the archives of the named \fIBBoards\fR. If no \fIBBoards\fR are given
92 on the command line, and you specified `\-archive',
93 \fIbbc\fR will not read your `bboards' profile entry, but will
94 read the archives of the \*(lqsystem\*(rq \fIBBoard\fR instead.
96 The `\-check' switch types out status information for the named \fIBBoards\fR.
98 can print one of several messages depending on the status of both the
100 and the user's reading habits.
101 As with each of these messages, the number
102 given is the item number of the last item placed in the
104 This number (which is marked in the messages as the \*(lqBBoard\-Id\*(rq) is
105 ever increasing. Hence, when \fIbbc\fR
106 says \*(lqn items\*(rq, it really means that the highest BBoard\-Id is \*(lqn\*(rq.
107 There may, or may not actually be \*(lqn\*(rq items in the BBoard.
108 Some common messages are:
112 \fBBBoard \-\- n items unseen\fR
114 This message tells how many items the user has not yet seen.
115 When invoked with the `\-quiet' switch,
116 this is the only informative line that \fIbbc\fR will possibly print out.
119 \fBBBoard \-\- empty\fR
124 \fBBBoard \-\- n items (none seen)\fR
126 The BBoard has items in it, but the user hasn't seen any.
129 \fBBBoard \-\- n items (all seen)\fR
131 The BBoard is non\-empty, and the user has seen everything in it.
134 \fBBBoard \-\- n items seen out of m\fR
136 The BBoard has at most m\-n items that the user has not seen.
139 The `\-topics' switch directs \fIbbc\fR to print three items about the named
142 the number of items present,
143 and the date and time of the last update.
145 are named, then all BBoards
146 are listed. If the `\-verbose' switch is given, more information is output.
148 The `\-quiet' switch specifies that \fIbbc\fR should be silent if no
149 \fIBBoards\fR are found with new information.
150 The `\-verbose' switch specifies that \fIbbc\fR is to consider you to be
151 interested in \fIBBoards\fR that you've already seen everything in.
153 To override the default \fImshproc\fR and the profile entry,
154 use the `\-mshproc\ program' switch.
155 Any arguments not understood by \fIbbc\fR are passed to this program.
156 The `\-protocol' switch tells \fIbbc\fR that your \fImshproc\fR knows about
157 the special \fIbbc\fR protocol for reporting back information.
158 \fImsh\fR\0(1), the default \fImshproc\fR, knows all about this.
160 The `\-file\ BBoardsfile' switch tells \fIbbc\fR to use a non\-standard
161 \fIBBoards\fR file when performing its calculations.
162 Similarly, the `\-user BBoardsuser' switch tells \fIbbc\fR to use a
163 non\-standard username.
164 Both of these switches are useful for debugging a new \fIBBoards\fR or
168 If the local host is configured as a POP BBoards client,
169 or if the `\-host\ host' switch is given,
170 then \fIbbc\fR will query the POP service host as to the status of the BBoards.
171 The `\-user\ user' switch then takes on a new meaning:
172 it refers to the name of the guest account for BBoards on the service host.
173 The `\-rpop' switch uses the UNIX \fIrPOP\fR
174 (authentication done via trusted connections).
175 In contrast, the `\-norpop' switch uses the ARPA \fIPOP\fR
176 (in which case \fIbbc\fR will prompt for a password,
177 unless the \-user specifies the guest account).
181 If the local host is configured as an NNTP BBoards client,
182 or if the `\-host\ host' switch is given,
183 then \fIbbc\fR will query the NNTP service host
184 as to the status of the BBoards.
185 For NNTP BBoards clients,
186 the `\-user\ user' and the `\-rpop' switches are ignored.
189 The \fI\&.bbrc\fR file in the
190 user's \fB$HOME\fR directory
191 is used to keep track of what messages have been read.
192 The `\-rcfile\ rcfile' switch overrides the use of \fI\&.bbrc\fR for
194 If the value given to the switch is not absolute,
195 (i.e., does not begin with a \fB/\fR\0),
196 it will be presumed to start from the current working directory.
197 If this switch is not given (or the `\-norcfile' switch is given),
198 then \fIbbc\fR consults the envariable \fBMHBBRC\fR,
199 and honors it similarly.
201 ^$HOME/\&.mh\(ruprofile~^The user profile
202 ^$HOME/\&.bbrc~^BBoard \*(lqcurrent\*(rq message information
204 ^Path:~^To determine the user's MH directory
206 ^bboards:~^To specify interesting BBoards
208 ^mshproc:~^Program to read a given BBoard
210 bbl(1), bboards(1), msh(1)
218 `bboards' defaults to \*(lqsystem\*(rq
220 `\-file @@(BBHOME)/BBoards'
224 `\-rpop' unless the guest account for BBoards is used
229 The `\-user' switch takes effect only if followed by the `\-file' switch.
236 @describe .bbrc a little better
241 .\" @@(#)$Id: bbc.rf,v 2.4 1990/04/05 15:07:52 sources Exp jromine $
244 then \fIbbc\fR consults the envariable \fB$MHBBRC\fR,
259 user\-specific BBoards information.
261 If this envariable is not set,
262 then the file \fI\&.bbrc\fR in the user's \fB$HOME\fR directory is used.
265 ^$HOME/\&.bbrc~^BBoard information
271 @put things back, do .NA stuff another way
285 .TH BBC 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
295 @fixup for makewhatis
306 @changes for SUN40 shared libraries and NNTP under bbc