WorkShop Visual 6.0
			    --------------
		      Integration of Athena Widgets
		      -----------------------------

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

Files contained in this directory are as follows:

	README          - These notes.

	Makefile        - creates visu binary with Athena widgets
			  integrated.

	Athena.xdc      - visu_config configuration file for Athena widgets.
	Athena.X11R6.xdc - alternate configuration file for X11R6 servers.

	Athena_stubs.c  - additional code for the Athena widget integration.

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

	app-defaults/   - Resources for integration.
	visu

Integrating Athena widgets with visu
-----------------------------------------

1.  Start visu_config and use the File/Open menu option to load the
Athena.xdc (or Athena.X11R6.xdc) file.  The following family will be listed:

	Athena
	Composites
	Primitives

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

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 Athena 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=Athena)
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
------

Some Athena libraries lack certain of the Athena widgets: the mailbox,
and various text source/sink widgets for example.

This does affect some X11R6 integrations.

We will address this issue properly in due course. In the meantime,
should your integration fail to compile due to unavailable Athena
widget classes, simply delete the widget class from the config file using 
visu_config then regenerate code and config files. 

Remember to delete the widget classes concerned from BOTH the Athena
family, and the relevent Composite/Primitive families.