Integration of Xirisw Widgets
		      -----------------------------

This directory contains the files required to integrate
the Xirisw widget set into WorkShop Visual 6.0.

Files contained in this directory are as follows:

	README          - These notes.

	Makefile        - creates visu binary with Xirisw
			  widgets integrated.

	Sgm.xdc         - visu_config configuration file for
			  Xirisw widgets. Load this file if your widgets
			  headers are in a directory called Sgm.

	Xirisw.xdc      - visu_config configuration file for
			  Xirisw widgets. Load this file if your widgets
			  headers are in a directory called Xirisw.

	Xirisw_stubs.c  - additional code for the Xirisw widget
			  integration. Works with either Sgm or Xirisw 
			  configuration file.

	bitmaps/*.bm    - bitmap and pixmap files to represent
			  Xirisw widgets on WorkShop Visual
			  widget palette.

	app-defaults/   - Resources for integration.
	visu

Integrating Xirisw widgets
--------------------------

1.  Start visu_config and use the File/Open menu option to load
either the Xirisw.xdc of the Sgm.xdc file.  One of the following families 
will be listed:

	Xirisw
	Sgm

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.  Click on
OK to generate the Xirisw_config.c file.  Repeat this procedure for
the 'Code file' menu option to generate Xirisw_code.c.

Ensure that the header references at the top of the auxilliary 
Xirisw_stubs.c file are correct: generate the stubs file Xirisw_stubs.c
from the 'Stubs file' menu option to correct these if required.

3.  Check that the Makefile has appropriate settings and pathnames
for your system.  Build the WorkShop Visual binary using the following
command:

      make

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

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

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).