10 date 90.04.05.15.11.17; author sources; state Exp;
15 date 90.03.22.11.30.53; author sources; state Exp;
20 date 90.03.20.19.41.29; author sources; state Exp;
25 date 90.03.20.17.35.47; author sources; state Exp;
30 date 90.03.20.17.20.30; author sources; state Exp;
48 bbl \- manage a BBoard
53 \%[\-verbose] \%[\-noverbose]
57 \fIbbl\fR allows a \fIBBleader\fR to manage a BBoard.
58 The process is relatively simple: a \fIBBleader\fR
59 invokes the \fIbbl\fR program to set\-up an environment in which the messages
60 contained in the BBoard
61 may be accessed as if they were messages in an \fIMH\fR folder.
63 To do this, \fIbbl\fR, \fIincs\fR the \fIBBoard\fR
64 to the folder \*(lq+bbl\*(rq, and \fIincs\fR the archives for the \fIBBoard\fR
65 to the folder \*(lq+bbl/arc\*(rq. The \fIBBleader\fR
66 then gets a new shell in which \fIMH\fR
67 commands (among others) may be executed. When the \fIBBleader\fR
68 is done, CTRL\-D is typed, which terminates the shell. \fIbbl\fR then
69 asks the \fIBBleader\fR
71 should be reconstructed.
72 Usually, this results in zeroing the existing \fIBBoard\fR
73 file, and \fIpack\fRing the \*(lq+bbl\*(rq folder into the \fIBBoard\fR
74 file. Similar actions are taken for the archive.
76 The `\-shell' switch specifies what process that \fIbbl\fR should invoke
77 as your command interpreter. This need not be a rooted filename.
78 If this switch is not specified,
79 \fIbbl\fR looks at the envariable \fB$SHELL\fR for a value.
80 If this envariable is not set, then \fIbbl\fR uses your login shell.
82 The `\-verbose' switch directs \fIbbl\fR to type the shell commands that it
83 executes to get the job done (e.g., \fIchmod\fR\0s, \fIinc\fR\0s, etc.)
85 As \fIbbl\fR processing is most likely not intuitively obvious to most
86 prospective BBoard\-leaders, a short diatribe is in order. As pointed out in
88 a BBoard\-leader (of the fictitious BBoard \*(lqhacks\*(rq)
89 has three primary maintenance functions:
95 You don't need \fIbbl\fR
96 to do this, use \fIbbc\fR instead.
99 \fBRemove inappropriate material\fR
101 Do this by running \fIbbl\fR.
102 An example of this might be:
106 \02 [ Working folder is +bbl, Archive folder is +bbl/arc ]
107 \03 [ Type CTRL\-D to finish ]
109 .ta \w'\05 'u +\w'20 'u +\w'10/14 'u +\w'1345-PDT 'u +\w'Reasonable Person 'u
110 \05 20 10/14 1345-PDT Silly User Nonsensical message
111 \06 21 10/14 1707-PDT Silly User Another one
112 \07 22 10/14 2144-PDT Reasonable Person Legit message
116 \11 Incorporate changes? y
118 \13 Update archives? n
119 \14 Remove +bbl/arc? y
120 \15 [+inbox now current]
124 In item 1, the BBoard\-Leader invokes \fIbbl\fR
125 on the BBoard called \*(lqhacks\*(rq. The \fIbbl\fR
126 program responds by typing items 2 and 3 which tell the user what \fIMH\fR
127 folders are being used and that a sub\-shell is now in use (respectively).
128 The user does a scan of the +bbl folder
129 (\fIbbl\fR sets the current\-folder to be the one with the BBoard in it.)
130 and finds two messages that should be removed (numbers 20 and 21).
131 The user then removes these using the \fIrmm\fR
132 program (item 9) and then types a CTRL\-D to return to
136 asks how the BBoard should be reconstructed. Item 11 asks if the contents of
137 the +bbl folder should OVERWRITE the contents of the BBoard. The user
139 that it should (hence the two \fIrmm\fR'd messages disappear).
141 the user is asked if the +bbl folder should be killed, since the BBoards
142 have been successfully updated, the user answers `yes'.
143 On item 13, the user is
144 asked if the archives should be updated. Since the user made no changes, the
145 answer `no' is made. (The user could have answered `yes' with no disastrous
146 effects, but knew that nothing had been updated). Finally, on item 14, the
147 user indicates that the +bbl/arc subfolder should be killed, by answering
151 \fBArchive non\-recent material\fR
153 Do this by running \fIbbl\fR.
154 An example of this might be:
158 \02 [ Working folder is +bbl, Archive folder is +bbl/arc ]
159 \03 [ Type CTRL\-D to finish ]
161 .ta \w'\05 'u +\w'20 'u +\w'10/14 'u +\w'1345-PDT 'u +\w'GFISHER@@UCI-20B 'u
162 \05 11 10/12 1905-PST Marshall Rose New MMail/BBck
163 \06 12 10/12 1916-PST Stephen Willson PATH, nfinger, and ls
164 \07 13 10/12 2329-PDT G@@UCI-20A 833-5122 hours
165 \08 14 10/13 1045-PDT MELLON@@UCI-20B Reporting line
166 \09 15 10/13 1112-PST Tim Shimeall Re: 833-5122 hours
167 \10 16 10/13 1045-PDT MELLON@@UCI-20B Reporting line
168 \11 17 10/13 2042-PST Dana Roode Ucifinger
169 \12 18 10/13 2045-PST Dana Roode Files in /usr/restores
170 \13 19 10/14 1028-PDT WILLSON@@UCI-20B Re: term no pause
171 \14 20 10/14 1345-PDT Martin Katz Re: term no pause
172 \15 21 10/14 1707-PDT SCRIBE@@UCI-20A Scribe Use
173 \16 22 10/14 2144-PDT GFISHER@@UCI-20B New Twemacs
174 \17 23 10/15 1227-PDT Rob Rittenhouse Re: New Twemacs
176 \18 % file +bbl/arc \-src +bbl 11\-12 17\-20 21
178 \20 Incorporate changes? y
180 \22 Update archives? y
181 \23 Remove +bbl/arc? y
182 \24 [+inbox now current]
186 The important command given is in item 18, in which the user \fIfiles\fR
187 some messages from +bbl into +bbl/arc. When CTRL\-D is typed, the user
189 to update both the BBoard and its archives, which does the proper action.
190 As an alternate to this scenario,
191 some creative \fIBBleaders\fR might use the \fIpick\fR command to do all of
196 pick \-sequence select \-before \-12 \-datefield BB-Posted \-zero
197 pick \-sequence select \-before \-20 \-nozero
199 refile select +bbl/arc
203 In order to facilitate the use of automation shell scripts,
204 if the standard input for \fIbbl\fR is \fInot\fR a tty,
205 then \fIbbl\fR will not ask any questions and will proceed as if
206 the user's answer was \*(lqyes\*(rq for all questions.
207 Hence, \fIbbl\fR may be run under \fIcron\fR\0(8) to provide for
211 ^$HOME/\&.mh\(ruprofile~^The user profile
213 ^Path:~^To determine the user's MH directory
215 ^incproc:~^Program to incorporate a mail drop into a folder
217 ^packproc:~^Program to pack a folder into a msgbox
219 ^rmfproc:~^Program to remove a folder
221 bbc(1), bbleader(1), bboards(1)
223 `+folder' defaults to \*(lqbbl\*(rq
227 `\-shell' defaults to \fB$SHELL\fR or your login shell
231 In the early days of the UCI BBoards facility,
232 \fIBBleaders\fR actually used to run this program by hand.
233 Now, this \fIbbl\fR is often run automatically by the system to perform
236 Note that \fIbbl\fR executes a lot of \fIMH\fR
237 commands, and as such, each of these commands can and will read
238 your \fI\&.mh\(ruprofile\fR for defaults.
239 Please read the \fBBUGS\fR section of \fImh\-profile\fR\0(5)
240 for some hints to help you avoid many silly problems.
242 Also, \fIbbl\fR is unforgiving in doing exactly what it is told,
243 so take special care in answering \fIbbl\fR's questions.
250 @put things back, do .NA stuff another way
264 .TH BBL 1 @@(MHCENTERFOOT) @@(MHLEFTFOOT)
274 @fixup for makewhatis