Integration of Xfe Widgets
		      --------------------------

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

Files contained in this directory are as follows:

	README          - These notes.

	Makefile        - creates visu binary with Xfe widgets
			  integrated.

	Xfe.xdc         - visu_config configuration file for Xfe
			  widgets.

	Xfe_stubs.c     - additional code for the Xfe widget
			  integration.

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

	app-defaults/   - Resources for integration.
	visu

Integrating Xfe widgets
-----------------------

1.  Start visu_config and use the File/Open menu option to load
the Xfe.xdc file.  The following family will be listed:

	Xfe

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 Xfe_config.c file.  Repeat this procedure for
the 'Code file' menu option to generate Xfe_code.c.

3.  Check that the Makefile has appropriate settings and pathnames
for your system.  In particular, you will need to set the
environment variable XFEHOME to point to the root of your Xfe
widget distribution.  This is normally one level above the
directory called Xfe which has the widget sources and headers.
Build the WorkShop Visual binary using the following command:

      make

After the build has successfully completed a 'visu.bin'
executable incorporating the Xfe 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=Xfe)
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).

Notes
-----

The Xfe widget set has been rendered unstable by some suspect
debugging code.  Most of the ChangeManaged printf routines do not
take into account deletion of a child, and hence unless you cut the
printf debugging statements out of your Xfe widget sources, the
integration becomes unstable.

A safe version of these widgets with the debugging statement
problem addressed can be acquired from Imperial Software
Technology, Email support@ist.co.uk.