// $Revision: 1.8 $
Copyright (C) 1994, 1995 Taligent, Inc. All rights reserved.

1.0.0 RELEASE NOTES FOR THE TILES TUTORIAL PROGRAM

The Tiles tutorial program 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 "Programming with the Presentation
Framework: Tutorial," part of the CommonPoint documentation set.  

SETTING UP THE PROGRAM

To run the Tiles Tutorial (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.

BUILDING AND RUNNING THE PROGRAM

The Tiles code is separated into eight directories which parallel the eight 
chapters in the tutorial. Each directory builds a complete Tiles application
containing the cumulative code in each chapter in the tutorial. Each directory
(that is, each version of Tiles) must be built individually because the library 
and package names overlap. 

A ninth directory, ./TilesTutorial/09.Text/Tiles, contains an additional version 
of the Tiles program that provides an editable text label for each tile. When the 
user clicks on a label, a floating text control appears which allows the user to 
enter new text for the label. This version is not covered in the tutorial.
Essentially, each tile stores its label as an instance of TStandardText, and the
TTilesView DrawTile function creates a TTextDisplay to display each label. When
the user clicks on a label, TTilesView creates a TTextControl for the user to enter
the new label in. This new label is applied to all currently selected tiles. See
the code and code comments for more implementation details.

To run any version of Tiles you must first build the version you
want. If you just want to see the complete version of Tiles as covered in the
entire Tutorial, build version 08.DragAndDrop.

To build version 08.DragAndDrop or version 09.Text, you must first build the
TaligentSelectionTool enabler. The enabler and its instructions can be found
at this location:

        $TaligentRoot/TaligentSamples/Supported/Enablers/TaligentSelectionTool

1.  Choose a version and go to the associated directory. For example, to
    build the last version: 

        cd  $TaligentRoot/TaligentSamples/Supported/Apps/TilesTutorial/08.DragAndDrop/Tiles

2.  Create a "fast" make file.  This speeds up the build process.

        Makeit -M -fast makefiles

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

        Makeit

4.  Start CommonPoint.

        cd $TaligentBinaries
        CommonPoint

5. Create and open a new Tiles document using the supplied script which
    invokes RunDocument. You can supply an optional document name.

        TilesTutorialApp <document name>


KNOWN DEFECTS IN THE PROGRAM

No known defects in the program code.

NOTE: There is a discrepancy between the code provided in the directory 
./08.DragAndDrop/Tiles and the documentation in Step 8 of "Programming 
with the Presentation Framework:Tutorial." The code uses the class 
TSimpleDragAndDropItem instead of the class TGeneralDragAndDropItem described 
in the manual.The class TSimpleDragAndDropItem is declared in the file 
SimpleDragAndDropItem.h, provided by the TaligentSelectionTool enabler. The
class TScrapItemOn<AType> is declared in the file ScrapItemOn.h. The directory
$TaligentRoot/TaligentSamples/Supported/Enablers/ScrapItem no longer exists.