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