Integration of Xew EuroBridge Widget Set
	      ----------------------------------------

This directory contains the files required to integrate the Xew
public domain widget set into WorkShop Visual (version 6.0).

Files contained in this directory are as follows:

	README          - These notes.

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

	Xew.xdc         - visu_config configuration file for Xew
			  widgets.

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

	bitmaps/*.bm    - bitmap files to represent Xew on the
			  WorkShop Visual widget palette.


Acquiring the Xew Eurobridge Widgets
------------------------------------

These may be acquired from:

	http://www.vtt.fi/tte/EuroBridge/Xew/

Alternatively:

	ftp.x.org

Required packages:

	Xew-4.0.tar.gz    - Xew source code (including simple test
			    progs) which unpacks into Xew-4.0/Xew and
			    Xew-4.0/demo directories.

Recommended optionals:

	Xew-4.0-Xp.tar.gz - X Print Server prototype code modified
			    for Xew
	jpegsrc.v5.tar.Z  - Independent JPEG group JPEG library (v5
			    or later)

Optional addons:

	Xew-4.0.ps.gz     - The Widget Set programmers reference
	tiff.v3.2.tar.Z   - Sam Leffler's TIFF library (tifflib-3.2beta?)
	urt-3.1b.tar.Z    - Utah Raster Toolkit

An Xew mailing list has been setup at

	xew-list@hemuli.tte.vtt.fi

Send join/remove requests to 

	xew-list-request@hemuli.tte.vtt.fi


Integrating the Xew widgets
---------------------------

1.  Start visu_config and use the File/Open menu option to load
the Xew.xdc file.


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

	Click on OK to generate the XEW_config.c file. 

	Repeat this procedure for the 'Code file' menu option to
	generate XEW_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 Xew
	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=Xew)
and invoking WorkShop Visual as normal. 

	For this to work, you should install this directory as Xew
	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.