bbl.man

早期freebsd实现

BBL(1)                 BSD Reference Manual                BBL(1)


NNAAMMEE
       bbl - manage a BBoard

SSYYNNOOPPSSIISS
       bbl  [+folder]  [-shell program]  [-verbose]  [-noverbose]
            bboard [-help]

DDEESSCCRRIIPPTTIIOONN
       _b_b_l allows a _B_B_l_e_a_d_e_r to manage a BBoard.  The process  is
       relatively  simple:  a _B_B_l_e_a_d_e_r invokes the _b_b_l program to
       set-up an environment in which the messages  contained  in
       the  BBoard may be accessed as if they were messages in an
       _M_H folder.

       To do this, _b_b_l, _i_n_c_s the _B_B_o_a_r_d to the folder "+bbl", and
       _i_n_c_s the archives for the _B_B_o_a_r_d to the folder "+bbl/arc".
       The _B_B_l_e_a_d_e_r then gets a new shell in  which  _M_H  commands
       (among  others)  may  be  executed.   When the _B_B_l_e_a_d_e_r is
       done, CTRL-D is typed, which terminates  the  shell.   _b_b_l
       then  asks  the  _B_B_l_e_a_d_e_r  as  to how the BBoard should be
       reconstructed.   Usually,  this  results  in  zeroing  the
       existing  _B_B_o_a_r_d file, and  _p_a_c_king the "+bbl" folder into
       the _B_B_o_a_r_d  file.   Similar  actions  are  taken  for  the
       archive.

       The `-shell' switch specifies what process that _b_b_l should
       invoke as your command interpreter.  This need  not  be  a
       rooted  filename.   If  this  switch is not specified, _b_b_l
       looks at the envariable  $$SSHHEELLLL  for  a  value.   If  this
       envariable is not set, then _b_b_l uses your login shell.

       The  `-verbose'  switch directs _b_b_l to type the shell com-
       mands that it executes to get the job done (e.g., _c_h_m_o_d s,
       _i_n_c s, etc.)

       As  _b_b_l  processing is most likely not intuitively obvious
       to most prospective BBoard-leaders, a short diatribe is in
       order.  As pointed out in _B_B_l_e_a_d_e_r(1), a BBoard-leader (of
       the fictitious BBoard "hacks") has three  primary  mainte-
       nance functions:

       RReeaadd tthhee BBBBooaarrdd
            You don't need _b_b_l to do this, use _b_b_c instead.

       RReemmoovvee iinnaapppprroopprriiaattee mmaatteerriiaall
            Do this by running _b_b_l.  An example of this might be:

             1 % bbl hacks
             2 [ Working folder is +bbl, Archive folder is +bbl/arc ]
             3 [ Type CTRL-D to finish ]
             4 % scan



[mh.6]                        MH.6.8                            1








BBL(1)                 BSD Reference Manual                BBL(1)


             5  20 10/14 1345-PDT Silly User        Nonsensical message
             6  21 10/14 1707-PDT Silly User        Another one
             7  22 10/14 2144-PDT Reasonable Person Legit message
             9 % rmm 20 21
            10 % D
            11 Incorporate changes? y
            12 Remove +bbl? y
            13 Update archives? n
            14 Remove +bbl/arc? y
            15 [+inbox now current]
            16 %

            In item 1,  the  BBoard-Leader  invokes  _b_b_l  on  the
            BBoard  called  "hacks".  The _b_b_l program responds by
            typing items 2 and 3 which  tell  the  user  what  _M_H
            folders are being used and that a sub-shell is now in
            use (respectively).  The user does a scan of the +bbl
            folder  (_b_b_l  sets  the  current-folder to be the one
            with the BBoard in it.)  and finds two messages  that
            should be removed (numbers 20 and 21).  The user then
            removes these using the _r_m_m program (item 9) and then
            types  a  CTRL-D to return to _b_b_l (item 10).  At this
            point, _b_b_l asks  how  the  BBoard  should  be  recon-
            structed.   Item  11 asks if the contents of the +bbl
            folder should OVERWRITE the contents of  the  BBoard.
            The  user  responds  `yes', that it should (hence the
            two _r_m_m'd messages disappear).  Next on item 12,  the
            user  is  asked  if the +bbl folder should be killed,
            since the BBoards have been successfully updated, the
            user answers `yes'.  On item 13, the user is asked if
            the archives should be updated.  Since the user  made
            no changes, the answer `no' is made.  (The user could
            have answered `yes' with no disastrous  effects,  but
            knew  that  nothing  had  been updated).  Finally, on
            item 14, the user indicates that  the  +bbl/arc  sub-
            folder should be killed, by answering `yes'.

       AArrcchhiivvee nnoonn--rreecceenntt mmaatteerriiaall
            Do this by running _b_b_l.  An example of this might be:

             1 % bbl hacks
             2 [ Working folder is +bbl, Archive folder is +bbl/arc ]
             3 [ Type CTRL-D to finish ]
             4 % scan
             5  11 10/12 1905-PST Marshall Rose   New MMail/BBck
             6  12 10/12 1916-PST Stephen Willson PATH, nfinger, and ls
             7  13 10/12 2329-PDT G@UCI-20A       833-5122 hours
             8  14 10/13 1045-PDT MELLON@UCI-20B  Reporting line
             9  15 10/13 1112-PST Tim Shimeall    Re: 833-5122 hours
            10  16 10/13 1045-PDT MELLON@UCI-20B  Reporting line
            11  17 10/13 2042-PST Dana Roode      Ucifinger



[mh.6]                        MH.6.8                            2








BBL(1)                 BSD Reference Manual                BBL(1)


            12  18 10/13 2045-PST Dana Roode      Files in /usr/restores
            13  19 10/14 1028-PDT WILLSON@UCI-20B Re: term no pause
            14  20 10/14 1345-PDT Martin Katz     Re: term no pause
            15  21 10/14 1707-PDT SCRIBE@UCI-20A  Scribe Use
            16  22 10/14 2144-PDT GFISHER@UCI-20B New Twemacs
            17  23 10/15 1227-PDT Rob Rittenhouse Re: New Twemacs
            18 % file +bbl/arc -src +bbl 11-12 17-20 21
            19 % D
            20 Incorporate changes? y
            21 Remove +bbl? y
            22 Update archives? y
            23 Remove +bbl/arc? y
            24 [+inbox now current]
            25 %

            The important command given is in item 18,  in  which
            the user _f_i_l_e_s some messages from +bbl into +bbl/arc.
            When CTRL-D is typed, the user directs _b_b_l to  update
            both  the  BBoard  and  its  archives, which does the
            proper action.  As an  alternate  to  this  scenario,
            some creative _B_B_l_e_a_d_e_r_s might use the _p_i_c_k command to
            do all of the work:

                 pick -sequence select -before -12 -datefield BB-Posted -zero
                 pick -sequence select -before -20 -nozero
                 scan select
                 refile select +bbl/arc

            In order to facilitate the use  of  automation  shell
            scripts,  if the standard input for _b_b_l is _n_o_t a tty,
            then _b_b_l will not ask any questions and will  proceed
            as  if the user's answer was "yes" for all questions.
            Hence, _b_b_l may be run under _c_r_o_n (8) to  provide  for
            automatic archiving.

FFIILLEESS
       $HOME/.mh_profile                         The user profile

PPRROOFFIILLEE CCOOMMPPOONNEENNTTSS
       Path:                To determine the user's MH directory
       incproc:             Program to incorporate a mail drop into a folder
       packproc:            Program to pack a folder into a msgbox
       rmfproc:             Program to remove a folder

SSEEEE AALLSSOO
       bbc(1), bbleader(1), bboards(1)

DDEEFFAAUULLTTSS
       `+folder' defaults to "bbl"
       `-nofile'
       `-shell' defaults to $$SSHHEELLLL or your login shell



[mh.6]                        MH.6.8                            3








BBL(1)                 BSD Reference Manual                BBL(1)


CCOONNTTEEXXTT
       None

HHIISSTTOORRYY
       In  the  early days of the UCI BBoards facility, _B_B_l_e_a_d_e_r_s
       actually used to run this program by hand.  Now, this  _b_b_l
       is  often run automatically by the system to perform auto-
       matic archiving.

BBUUGGSS
       Note that _b_b_l executes a lot of _M_H commands, and as  such,
       each  of these commands can and will read your _._m_h___p_r_o_f_i_l_e
       for  defaults.   Please   read   the   BBUUGGSS   section   of
       _m_h_-_p_r_o_f_i_l_e (5) for some hints to help you avoid many silly
       problems.

       Also, _b_b_l is unforgiving in doing exactly what it is told,
       so take special care in answering _b_b_l's questions.




































[mh.6]                        MH.6.8                            4