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

INDEX
-----
1.1 Does CBB run under tk4.0?

1.2 How can I make the window fit onto my tiny girly-man screen?
    (Asked with an Arnold accent)

1.3 How do I use the text only front end?

1.4 What do I do when I get the following error?


1.1 Does CBB run under tk4.0?
-----------------------------

Yes!!!  The official version of CBB now runs under tk4.0.  In fact, as
of CBB Version 0.61a, tk4.0 will be the preferred platform, although I
will continue to support tk3.6 for as long as is reasonably possible.
I would like to express a deep thanks to Lionel Mallet
(Lionel.Mallet@sophia.inria.fr) who did the initial port of the
relevant files to tk4.0.


1.2 How can I make the window fit onto my tiny screen?
------------------------------------------------------------
With the latest version of cbb this is easy ... just edit your
~/.cbbrc.tcl file!

First, you can make the font smaller.  You could try 7x13bold and 7x13
for starters:

    set fixed_header_font "9x15bold"
    set fixed_font "9x15"

Also, you can reduce the number of lines displayed in the list box:

    set list_height 28


1.3 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 used to 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.


1.4 (a) 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.4 (b) 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 perl back end. Make sure "wrapper.pl"
is in your path and is executable.  Make sure the first line of "wrapper.pl"
points to where perl is installed on your system.  Running wrapper.pl directly
from the command line can often provide useful insight into the problem.


1.4 (c) 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 (d) When I type "make install" I get the following error:
-------------------------------------------------------------

    % make install
    make: Fatal error: Don't know how to make target `install'


Here an overview of the whole installation process:

1.  Get tcl7.3 *and* tk3.6   (version 0.61a and beyond of cbb will support 
                              tcl7.4 and tk4.0)

2.  Build tcl/tk (if they aren't installed):
    - untar each of the two packages and follow their instructions for
      building them.  It will boil down to something like:
    - cd tcl7.3; ./configure; make; make install
    - cd tk3.6; ./configure; make; make install
    
3.  Build perl (if it isn't installed):
    - I haven't built it lately, but follow the instructions

4.  Install CBB
    - untar the distribution
    - cd cbb-0.61a
    - type "make install"

If this doesn't help, make sure you are in the cbb-0.61a directory
when you run "make install".  When you are installing the other 
packages (if they aren't already installed) you must be in their 
respective directories.

If this is all obvious to you, please forgive me.  In that case
it might be useful to see a listing of the cbb directory and
the contents of your Makefile.

