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