0
|
1 .\" @(MHWARNING)
|
|
2 .\" @(#)$Id$
|
|
3 .SC BBL 1
|
|
4 .NA
|
|
5 bbl \- manage a BBoard
|
|
6 .SY
|
|
7 bbl
|
|
8 \%[+folder]
|
|
9 \%[\-shell\ program]
|
|
10 \%[\-verbose] \%[\-noverbose]
|
|
11 bboard
|
|
12 \%[\-help]
|
|
13 .DE
|
|
14 \fIbbl\fR allows a \fIBBleader\fR to manage a BBoard.
|
|
15 The process is relatively simple: a \fIBBleader\fR
|
|
16 invokes the \fIbbl\fR program to set\-up an environment in which the messages
|
|
17 contained in the BBoard
|
|
18 may be accessed as if they were messages in an \fIMH\fR folder.
|
|
19
|
|
20 To do this, \fIbbl\fR, \fIincs\fR the \fIBBoard\fR
|
|
21 to the folder \*(lq+bbl\*(rq, and \fIincs\fR the archives for the \fIBBoard\fR
|
|
22 to the folder \*(lq+bbl/arc\*(rq. The \fIBBleader\fR
|
|
23 then gets a new shell in which \fIMH\fR
|
|
24 commands (among others) may be executed. When the \fIBBleader\fR
|
|
25 is done, CTRL\-D is typed, which terminates the shell. \fIbbl\fR then
|
|
26 asks the \fIBBleader\fR
|
|
27 as to how the BBoard
|
|
28 should be reconstructed.
|
|
29 Usually, this results in zeroing the existing \fIBBoard\fR
|
|
30 file, and \fIpack\fRing the \*(lq+bbl\*(rq folder into the \fIBBoard\fR
|
|
31 file. Similar actions are taken for the archive.
|
|
32
|
|
33 The `\-shell' switch specifies what process that \fIbbl\fR should invoke
|
|
34 as your command interpreter. This need not be a rooted filename.
|
|
35 If this switch is not specified,
|
|
36 \fIbbl\fR looks at the envariable \fB$SHELL\fR for a value.
|
|
37 If this envariable is not set, then \fIbbl\fR uses your login shell.
|
|
38
|
|
39 The `\-verbose' switch directs \fIbbl\fR to type the shell commands that it
|
|
40 executes to get the job done (e.g., \fIchmod\fR\0s, \fIinc\fR\0s, etc.)
|
|
41
|
|
42 As \fIbbl\fR processing is most likely not intuitively obvious to most
|
|
43 prospective BBoard\-leaders, a short diatribe is in order. As pointed out in
|
|
44 \fIBBleader\fR(1),
|
|
45 a BBoard\-leader (of the fictitious BBoard \*(lqhacks\*(rq)
|
|
46 has three primary maintenance functions:
|
|
47 .in +.5i
|
|
48
|
|
49 .ti -.5i
|
|
50 \fBRead the BBoard\fR
|
|
51 .br
|
|
52 You don't need \fIbbl\fR
|
|
53 to do this, use \fIbbc\fR instead.
|
|
54
|
|
55 .ti -.5i
|
|
56 \fBRemove inappropriate material\fR
|
|
57 .br
|
|
58 Do this by running \fIbbl\fR.
|
|
59 An example of this might be:
|
|
60 .sp
|
|
61 .nf
|
|
62 \01 % bbl hacks
|
|
63 \02 [ Working folder is +bbl, Archive folder is +bbl/arc ]
|
|
64 \03 [ Type CTRL\-D to finish ]
|
|
65 \04 % scan
|
|
66 .ta \w'\05 'u +\w'20 'u +\w'10/14 'u +\w'1345-PDT 'u +\w'Reasonable Person 'u
|
|
67 \05 20 10/14 1345-PDT Silly User Nonsensical message
|
|
68 \06 21 10/14 1707-PDT Silly User Another one
|
|
69 \07 22 10/14 2144-PDT Reasonable Person Legit message
|
|
70 .re
|
|
71 \09 % rmm 20 21
|
|
72 \10 % \^D
|
|
73 \11 Incorporate changes? y
|
|
74 \12 Remove +bbl? y
|
|
75 \13 Update archives? n
|
|
76 \14 Remove +bbl/arc? y
|
|
77 \15 [+inbox now current]
|
|
78 \16 %
|
|
79 .fi
|
|
80 .sp
|
|
81 In item 1, the BBoard\-Leader invokes \fIbbl\fR
|
|
82 on the BBoard called \*(lqhacks\*(rq. The \fIbbl\fR
|
|
83 program responds by typing items 2 and 3 which tell the user what \fIMH\fR
|
|
84 folders are being used and that a sub\-shell is now in use (respectively).
|
|
85 The user does a scan of the +bbl folder
|
|
86 (\fIbbl\fR sets the current\-folder to be the one with the BBoard in it.)
|
|
87 and finds two messages that should be removed (numbers 20 and 21).
|
|
88 The user then removes these using the \fIrmm\fR
|
|
89 program (item 9) and then types a CTRL\-D to return to
|
|
90 \fIbbl\fR (item 10).
|
|
91 At this point,
|
|
92 \fIbbl\fR
|
|
93 asks how the BBoard should be reconstructed. Item 11 asks if the contents of
|
|
94 the +bbl folder should OVERWRITE the contents of the BBoard. The user
|
|
95 responds `yes',
|
|
96 that it should (hence the two \fIrmm\fR'd messages disappear).
|
|
97 Next on item 12,
|
|
98 the user is asked if the +bbl folder should be killed, since the BBoards
|
|
99 have been successfully updated, the user answers `yes'.
|
|
100 On item 13, the user is
|
|
101 asked if the archives should be updated. Since the user made no changes, the
|
|
102 answer `no' is made. (The user could have answered `yes' with no disastrous
|
|
103 effects, but knew that nothing had been updated). Finally, on item 14, the
|
|
104 user indicates that the +bbl/arc subfolder should be killed, by answering
|
|
105 `yes'.
|
|
106
|
|
107 .ti -.5i
|
|
108 \fBArchive non\-recent material\fR
|
|
109 .br
|
|
110 Do this by running \fIbbl\fR.
|
|
111 An example of this might be:
|
|
112 .sp
|
|
113 .nf
|
|
114 \01 % bbl hacks
|
|
115 \02 [ Working folder is +bbl, Archive folder is +bbl/arc ]
|
|
116 \03 [ Type CTRL\-D to finish ]
|
|
117 \04 % scan
|
|
118 .ta \w'\05 'u +\w'20 'u +\w'10/14 'u +\w'1345-PDT 'u +\w'GFISHER@UCI-20B 'u
|
|
119 \05 11 10/12 1905-PST Marshall Rose New MMail/BBck
|
|
120 \06 12 10/12 1916-PST Stephen Willson PATH, nfinger, and ls
|
|
121 \07 13 10/12 2329-PDT G@UCI-20A 833-5122 hours
|
|
122 \08 14 10/13 1045-PDT MELLON@UCI-20B Reporting line
|
|
123 \09 15 10/13 1112-PST Tim Shimeall Re: 833-5122 hours
|
|
124 \10 16 10/13 1045-PDT MELLON@UCI-20B Reporting line
|
|
125 \11 17 10/13 2042-PST Dana Roode Ucifinger
|
|
126 \12 18 10/13 2045-PST Dana Roode Files in /usr/restores
|
|
127 \13 19 10/14 1028-PDT WILLSON@UCI-20B Re: term no pause
|
|
128 \14 20 10/14 1345-PDT Martin Katz Re: term no pause
|
|
129 \15 21 10/14 1707-PDT SCRIBE@UCI-20A Scribe Use
|
|
130 \16 22 10/14 2144-PDT GFISHER@UCI-20B New Twemacs
|
|
131 \17 23 10/15 1227-PDT Rob Rittenhouse Re: New Twemacs
|
|
132 .re
|
|
133 \18 % file +bbl/arc \-src +bbl 11\-12 17\-20 21
|
|
134 \19 % ^D
|
|
135 \20 Incorporate changes? y
|
|
136 \21 Remove +bbl? y
|
|
137 \22 Update archives? y
|
|
138 \23 Remove +bbl/arc? y
|
|
139 \24 [+inbox now current]
|
|
140 \25 %
|
|
141 .fi
|
|
142 .sp
|
|
143 The important command given is in item 18, in which the user \fIfiles\fR
|
|
144 some messages from +bbl into +bbl/arc. When CTRL\-D is typed, the user
|
|
145 directs \fIbbl\fR
|
|
146 to update both the BBoard and its archives, which does the proper action.
|
|
147 As an alternate to this scenario,
|
|
148 some creative \fIBBleaders\fR might use the \fIpick\fR command to do all of
|
|
149 the work:
|
|
150
|
|
151 .in +.5i
|
|
152 .nf
|
|
153 pick \-sequence select \-before \-12 \-datefield BB-Posted \-zero
|
|
154 pick \-sequence select \-before \-20 \-nozero
|
|
155 scan select
|
|
156 refile select +bbl/arc
|
|
157 .fi
|
|
158 .in -.5i
|
|
159
|
|
160 In order to facilitate the use of automation shell scripts,
|
|
161 if the standard input for \fIbbl\fR is \fInot\fR a tty,
|
|
162 then \fIbbl\fR will not ask any questions and will proceed as if
|
|
163 the user's answer was \*(lqyes\*(rq for all questions.
|
|
164 Hence, \fIbbl\fR may be run under \fIcron\fR\0(8) to provide for
|
|
165 automatic archiving.
|
|
166 .in -.5i
|
|
167 .Fi
|
|
168 ^$HOME/\&.mh\(ruprofile~^The user profile
|
|
169 .Pr
|
|
170 ^Path:~^To determine the user's MH directory
|
|
171 .Ps
|
|
172 ^incproc:~^Program to incorporate a mail drop into a folder
|
|
173 .Ps
|
|
174 ^packproc:~^Program to pack a folder into a msgbox
|
|
175 .Ps
|
|
176 ^rmfproc:~^Program to remove a folder
|
|
177 .Sa
|
|
178 bbc(1), bbleader(1), bboards(1)
|
|
179 .De
|
|
180 `+folder' defaults to \*(lqbbl\*(rq
|
|
181 .Ds
|
|
182 `\-nofile'
|
|
183 .Ds
|
|
184 `\-shell' defaults to \fB$SHELL\fR or your login shell
|
|
185 .Co
|
|
186 None
|
|
187 .Hi
|
|
188 In the early days of the UCI BBoards facility,
|
|
189 \fIBBleaders\fR actually used to run this program by hand.
|
|
190 Now, this \fIbbl\fR is often run automatically by the system to perform
|
|
191 automatic archiving.
|
|
192 .Bu
|
|
193 Note that \fIbbl\fR executes a lot of \fIMH\fR
|
|
194 commands, and as such, each of these commands can and will read
|
|
195 your \fI\&.mh\(ruprofile\fR for defaults.
|
|
196 Please read the \fBBUGS\fR section of \fImh\-profile\fR\0(5)
|
|
197 for some hints to help you avoid many silly problems.
|
|
198
|
|
199 Also, \fIbbl\fR is unforgiving in doing exactly what it is told,
|
|
200 so take special care in answering \fIbbl\fR's questions.
|
|
201 .En
|