Return to bbl.me CVS log

Up to [CSRG BSD Unix] / 43BSDReno / share / doc / usd / 08.mh

Annotation of 43BSDReno/share/doc/usd/08.mh/bbl.me, revision 1.1

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.