                            WorkShop Visual 2.0
                            --------------
            Integration of SI/ComboBox and SI/NumericText
            ----------------------------------------------

This directory contains the files required to integrate the SI public domain
ComboBox 1.31a of 20/3/1995, and NumericText 1.31a of 20/3/1995 widgets into WorkShop Visual
(version 2.0).

Files contained in this directory are as follows:

        README          - These notes.

        Makefile        - creates an visu binary with the chosen SI widgets
                          integrated.

        SI.xdc          - visu_config configuration file for SI widgets.

        SI_extras.c     - additional code for the SI/table integration.

        app-defaults/   - Resources for widgets in WorkShop Visual integration.

        bitmaps/*.bm    - bitmap files to represent SI/ComboBox and 
                          SI/NumericText widgets on WorkShop Visual widget
                          palette.


	Acquiring the SI Widget Set
	---------------------------

The following contact should work:

	Institut fuer Geometrie und Praktische Mathematik
	RWTH Aachen, Germany
	albrecht@igpm.rwth-aachen.de


	Integrating SI/ComboBox, SI/NumericText with WorkShop Visual
	----------------------------------------------------------

1.  Start visu_config and use the File/Open menu option to load the
SI.xdc file.  Three families will be listed:

        SI/family   - contains SI/ComboBox, SI/NumericText widget classes.

        ComboBox    - contains SI/ComboBox widget class only.

        NumericText - contains SI/NuemricText widget class only.


2. Select the 'Config file' option from the Generate menu. 

	The Generate dialog contains a toggle button for each family. 

	Select one or more of these families depending on the combination of 
	widgets that are to be integrated into WorkShop Visual. 

	Simplest is just to select "SI"

	Click on OK to generate the config.c file. 

	Repeat this procedure for the 'Code file' menu option to generate code.c.

3. Check that the Makefile is configured for your system and that pathnames are correct. 

	Simply type "make".

	After the build has successfully completed a 'visu.bin' executable
	incorporating the required SI widgets will have been created in the
	local directory.

4. This binary may be invoked by setting the environment variable
USER_WIDGETS to the name of this directory (i.e. USER_WIDGETS=SI)
and invoking WorkShop Visual as normal. 

	For this to work, you should install this directory as SI into the 
	user_widgets sub-directory of your WorkShop Visual distribution.

5. This widget integration can be made the default for your site by
moving or copying this directory to 'local' (including any bitmap and
app-defaults sub-directories) within the WorkShop Visual distribution.
