home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / unix / riscbsd / 1_1_contri / usd / 08_mh / bbl_me < prev    next >
Encoding:
Text File  |  1986-04-15  |  6.7 KB  |  201 lines
  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
  201.