This document describes the procedure for installing the DOME source code
library.

Note: The DOME Library requires the use of the ObjectShare, Inc.'s
VisualWorks Smalltalk tool suite.  A free non-commercial version of
VisualWorks is available for Intel Windows NT/'95, Power Mac, and Linux
Platforms.  Commercial versions of VisualWorks are available for Windows,
Power Mac, and most UNIX operating systems.  ObjectShare, Inc. can be
reached at: www.objectshare.com.


Introduction
------------

The DOME library is distributed as a collection of parcels which are easily
loaded via the parcel loading mechanism of VisualWorks.  All of the parcels
are located in the directory named "parcels".


Installation Steps
------------------

To load and use the DOME library:

 o It is recommended that the DOME library be loaded into a new image.

 o Move the directory called "tools" to the same directory from which
   VisualWorks is started from.  Many portions of the DOME library depend
   on finding files contained in the tools directory.  If DOME is unable to
   find the tools directory when it starts up then the DOME Launcher will
   display a message to that effect.

 o Add the DOME parcels directory to the VisualWorks' Parcel Path.  From
   the VisualWorks Launcher select the File->Settings menu entry.  Go to
   the Parcel Path tab in the Settings dialog and add the DOME library
   parcels directory to the list.

 o Load the DOME parcel by selecting the Tools->Load Parcel Named... menu
   entry from the VisualWorks Launcher.  Enter "DOME" into the dialog and
   press return.  This will load all of the required parcels.

 o The VisualWorks Launcher is extended with a Tools->DOME menu.  The
   "Launcher" sub-menu entry opens a DOME Launcher window.

 o The ObjectShare UIPainter parcel should be loaded so new cursors and
   icons may be created within the DOME Tool Specification tool.  It is
   fine to have the ClassNameChooser and ClassReporter classes be loaded at
   a later time if so prompted.

 o If running under Windows then the help facility and the alter shell
   command require a fix to work correctly.  Refer to the Known Defects on
   Windows Platform section below for a workaround.

 o The ObjectShare FlyByHelp parcel may be loaded to make bubble help
   available.  If running under Windows then the FlyByhelp requires a fix
   to work correctly.  Refer to the Known Defects on Windows Platform
   section below for a workaround.

 o The MultiLayerTabControl parcel may be loaded to have a more
   user-friendly notebook like widget.  This parcel depends upon the
   ObjectShare/ICC TabControl and TabControlDemo parcels.


Known Defects on Windows Platform
---------------------------------

 o Win32SystemSupport needs to have libraryFiles set to 'kernel32.dll' for
   the Windows related methods to work correctly.  The help facility and
   the Alter shell command require this fix to work correctly.

   To fix this problem browse the Win32SystemSupport class.  Modify the
   libraryFiles value of the class definition to be 'kernel32.dll' and
   accept the change.

 o If the FlyByHelp parcel is loaded then sliders fail to have their range
   set correctly.  The Win3LookPolicy>>slider:into: method is implemented
   incorrectly in that the rangemap: message must occur after the fly by
   help code. Refer to the following code fragment for the proper ordering
   of the statements.

	component controller helpField: spec helpField.
	component controller receiver: (spec getPerformerIn: builder).
	component rangeMap: spec rangeMap.


Parcel List
-----------

Base System

 o emapps - Envy support.

 o T-gen - T-gen parser/scanner generator.  Refer to the parcel's comment
   and notice for details about its authorship and availability.

 o DoMESystem - The DOME library.  The DoMESystem parcel can be loaded
   instead of the DOME parcel to get only the core DOME library
   functionality.

Additional Notations

 o ColbertSystem
 o DFDSystem
 o IDEF0System
 o MultiPageSystem
 o PaperOutlineSystem
 o PetriNetSystem   
 o STDSystem

Additional Windows Capabilities

 o WindowsExtensions - This parcel contains interfaces for using the File
   Dialog Box available under Windows.  Refer to the parcel's comment for
   details about its authorship and availability.

Full System  

 o DOME - This is an empty parcel that has its prerequisites set to all of
   the previously mentioned parcels.

Additional Capability

 o MultiLayerTabControl - This parcel replaces the usages of the
   VisualWorks Notebook widget with the much more user friendly ICC
   TabControl widget.  This parcel is dependent upon the ICC TabControl and
   TabControlDemo parcels.  DOME uses a notebook widget in the preferences
   dialog as well as in the property editor.


For Additional Assistance
-------------------------

For additional assistance, see the DOME web pages at

www.htc.honeywell.com/dome


Acknowledgements
----------------

In addition to the freely available t-gen (T-gen parcel) and file dialog
box (WindowsExtensions) libraries, the DOME library makes use of the
HyperText capabilities of Smallwalker.  Due to slight modification of the
SmallWalker HyperText capabilities the SmallWalker classes included in the
DOME library have been renamed to have a SW prefix so that Smallwalker can
still be loaded without conflict.  Refer to the class comment of any of
these SW prefixed classes for details about its authorship and
availability.