$Revision: 1.15 $

Copyright (C) 1994, 1995 Taligent, Inc. All rights reserved.

1.0.0 RELEASE NOTES FOR THE STOCKBROWSER PROGRAM

StockBrowser is provided with the CommonPoint(TM) Application System version
1.0.0 for AIX(R). This program provides exemplary code to support learning
from example.

This code is intended to be used with Chapter 3, "StockBrowser" in 
"Documented Samples," part of the CommonPoint documentation set.


SETTING UP THE PROGRAM

To run StockBrowser (without building it first), use the
TaligentSamples.install script. The script installs a number of sample
binaries and ancillary files into your system.

See $TaligentRoot/TaligentSamples/README.TaligentSamples for instructions.


RUNNING THE PROGRAM

The StockBrowser program contains two document components: Stock Picker
and Stock Viewer. In addition, there are two versions of the Stock Picker:
one provides you with an empty Stock Picker, and the other downloads available
stock information from the Stock Server. 

To run any of the StockBrowser components, first start the CommonPoint
application system:

        cd $TaligentBinaries
        CommonPoint

To run an empty Stock Picker execute the following:

        cd $TaligentBinaries
        EmptyStockPickerApp &

To run a standard Stock Picker, which downloads available stock information
from the Stock Server, execute the following:

        cd $TaligentBinaries
        StandardStockPickerApp &

To run a Stock Viewer, execute the following:

        cd $TaligentBinaries
        StockViewerApp &


BUILDING THE PROGRAM

You can build the program from source code whether or not you have installed
the binaries from $TaligentRoot/TaligentSamples. To build the StockBrowser 
program from source:

1.  Build the AtomicModel enabler. The enabler and its instructions can be
    found at this location:

        $TaligentRoot/TaligentSamples/Supported/Enablers/AtomicModel

2.  Build the TaligentSelectionTool enabler. The enabler and its instructions
    can be found at this location:

        $TaligentRoot/TaligentSamples/Supported/Enablers/TaligentSelectionTool

3.  Run Makeit to build the StockBrowser program. This will copy all
    essential binaries, scripts and export files to the proper directories.

        cd $TaligentRoot/TaligentSamples/Supported/Apps/StockBrowser
        Makeit

4.  Start CommonPoint.

        cd $TaligentBinaries
        CommonPoint

5.  Run Makeit again to build the StockBrowser library archives and the
    Stock Server data files. This copies the archives and data to the
    proper directories.

        cd $TaligentRoot/TaligentSamples/Supported/Apps/StockBrowser
        Makeit Archives


KNOWN DEFECTS IN THE PROGRAM

There is a general problem when returning control to the program after clicking
OK in an alert box. The cursor changes to an I-beam and further input to the
program is disabled. Avoid selecting menu items which open alert boxes, such as
those in the system Document menu.

In the Stock Picker, pasting over an empty selection replaces data if a stock
of the same name already exists.

The Stock Picker view is hardwired to a particular minimum size. Rubber-band
selection may be a little confusing at first because the rubber-band snaps to
the view's bounds. 

The Stock Picker does not warn you if it can't communicate with the Stock
Server and will not add new stocks to the list.

In the Stock Viewer, items in the View menu are not checked when you select
them.

The Stock Viewer does not print properly.

The Stock Viewer behaves strangely when embedded. In particular, an embedded
Stock Viewer will display a "Please Wait" message until a stock is dragged or
copied into it. In addition, the View menu is always disabled.