FILE: CCF/CCFcb/README

                          CCF
            Collaborative Computing Frameworks

                    Emory University
                    Atlanta, GA, USA
                       June 1999

    CCF is a software system that supports collaborative, 
distributed, computer-based problem solving in the natural 
sciences, business, government, and in educational environments.  
The goal is to evolve a virtual environment for distributed 
computation that supports integrated human AV communication, 
high performance heterogeneous computing and distributed data 
management facilities. CCF is a research project at Emory University
involving the Math/Computer Science and Chemistry departments.
Recently, the Computer Science department of the University of
Reading (UK) has joined the project.

DISCLAIMER:

    This is alpha release 2.00 of CCF -- Collaborative 
    Computing Frameworks.

    This software is provided as is with no warranty expressed 
    or implied. We hope you find it useful, but we won't be held 
    responsible for any damage that may occur from reading, 
    compiling, installing, using, or even thinking about it.


LICENSE:

    CCF is Copyright (C) 1996 by Emory University except for the 
    code in directories GSM, LPC, LPC10 in the CCFaudio directory 
    and is distributed under the terms of GNU General Public 
    License (GPL) and the GNU Library General Public License (LPGL). 
    The files COPYING and COPYING.LIB in each directory will tell 
    exact licensing restrictions. 

    This package is free software; you can redistribute it 
    and/or modify it under the terms of the GNU General Public 
    License as published by the Free Software Foundation; either 
    version 2 of the license, or (at your option) any later version.


CREDITS:

    CCF was created by Vaidy Sunderam, Injong Rhee, 
    Alan Krantz, Shun Yan Cheung, Julie Sult, 
    Soeren Olesen, Paul Gray, Phil Hutto, Sarah Chodrow, 
    Michael Hirsch, Ted Goddard, Mic Grigni, N. Balaguru,
    Jim Nettles, Luigi Marzilli, Sue Onuschak, Scott Childs, 
    Kevin Williams.

    The project is internationaly collaborating with Roger Loader
    and James Pascoe of the department of Computer Science at The 
    University of Reading (UK).
    
    The CCF project is sponsored by the U.S. National 
    Science Foundation under the multidisciplinary challenges 
    initiative.   

    CCF currently supports ten platforms: Mandrake Linux 6.5, 
    Red Hat 6.0 and 6.2, SuSe Linux 6.4, TurboLinux 6.0, SunOS-5.7, 
    SunOS-5.6, SunOS-5.5.1 and IRIX 6.2. The SunOS-5.7 version is the 
    most thoroughly tested.

OVERVIEW:

	The clearboard is the tool that allows users to make annotations 
on the ccsm desktop.  The annotations are associated with the ccsm window 
itself rather than with each individual application window. Thus, if 
application windows are moved, the annotations will remain in place.
The clearboard is launched via the "Tools" menu of the ccsm (see the ccsm 
README for more information).

COMMON PROBLEMS:

The polyline and freehand modes of clearboard used a fixed size buffer
of points (currently 256). Once the current annotation exceeds 256 points,
no further points are accepted.

Creating a large number of annotations will slow redisplay considerably
because annotations are realized using the X SHAPE extension.

USING CLEARBOARD:

CCF Clearboard is an annotation tool that allows a user 
to mark an exsisting window with a mark that is a shaped 
window.  CCF Clearboard is exceptionally useful when 
run under the CCF Virtual Desktop ccsm.  Since all 
users see the same desktop (wysiwis), multiplexing 
the marks makes sense.  CCF Clearboard can be run 
standalone, however, it then does not take advantage 
of the cctl transport layer. 

To create a mark using CCF Clearboard, press the "Create Mark" 
button.  This will bring up a pulldown menu for the user 
to select a mark type.  Once a type is selected, the user 
is in drawing mode and the mark type appears in the 
"Create Mark" button.  Drawing mode is denoted by the cursor 
changing to a pencil and the mark type being in the left 
most button.  

NOTE: It is important to note that CCF Clearboard does a 
server grab when it is in drawing mode!!  To get out 
of drawing mode, the user needs to press the right button.  

Once a user is in drawing mode, pressing the left button 
in the clearboard window (the Virtual Desktop when running 
under ccsm) will start the drawing.  For most marks, 
dragging the mouse and releasing the left button will 
create the mark.  For the poly line, each click of the 
left button creates a point and clicking the middle button 
finishes the line.  For a text mark, a click of the left 
button will denote the beginning of the text and a second 
click of the left button will complete the text.