FREQUENTLY ASKED QUESTIONS
==========================


1.1 When I run cbb I get the following error:
---------------------------------------------

    Loading the category file /usr/home/default.cat
    Reading result
    Got result: ok
    invalid command name "getclock"
        while executing
    "getclock"
        invoked from within
    "fmtclock [getclock]..."
        invoked from within
    "set nicedate [fmtclock [getclock]..."
        invoked from within

    [the rest is ommited, but you get the picture]

Note, you should not encounter this problem with CBB 0.53 and beyond.
As of this version, the tclX dependency has been removed.

You are trying to run cbb with "wish" instead of "wishx".  You need 
to install Extended Tcl (tclX/wishx)

   ftp.neosoft.com:/pub/tcl/distrib/tclX7.3b.tar.gz
   harbor.ecn.purdue.edu:tcl/extensions/tclX7.3b.tar.gz


1.2 When I run cbb I get the following error:
---------------------------------------------

    error flushing "file6": Broken pipe
        while executing
    "flush $eng"
        invoked from within
    "if { $clean == 1 } {
            # clear our list box
            .trans.list delete 0 end

    [the rest is ommited, but you get the picture]

"cbb" is having a problem starting its engine. :)  Make sure "engine.pl"
is in your path and is executable.  Make sure the first line of "engine.pl"
points to where perl is installed on your system.  Running engine.pl directly
from the command line can often provide useful insight into the problem.


1.3 When I run cbb I get the following error:
---------------------------------------------

    tkerror failed to handle background error.
        Original error: no more colors left in colormap; changing screen's color model to monochrome
        Error in tkerror: invalid command name: "tkerror"
    wrong # args: should be "expr expression"
        while executing
    "expr $argc > 1"
        invoked from within
    "if { [expr $argc > 1] } {
       puts "Usage:  [file tail $argv0]  \[ file_name \]"
       exit
    }"
        (file "/usr/u/kiru/tools/cbb" line 32)
        invoked from within
    "source /usr/u/kiru/tools/cbb"

This sounds like your colormap is full.  Do you have a gif/jpg displayed
in your root window?  Can you run any other Tk applications?  I would
try finding out which progrom is consuming all the color map entries.  If
you have xv displaying a picture in your root window, try running
"xsetroot -solid steelblue" (or your favorite color) then try running cbb
again.


1.4 How can I make the window fit on my laptop ... ???
------------------------------------------------------

The easiest way to control the height of the window is to modify the line
that reads:

    set list_height 28

This controls the height of the listbox, and therefore the height of the
overall window.  (As of 10/18/94 this is line number 76.)
I recommend keeping this number "even" (not odd) because each transaction
requires 2 lines.


1.5 How do I use the text only front end?
-----------------------------------------

Currently the text front end is more of a separate entity than a front
end.  The graphical and text versions do share the same file formats
though.  If you only want the text part, you can toss everything except
for the cbbsh subdirectory.  Everything you need is self contained in
there.  Look at the cbbtxt.tex file for instructions on how to install.

