                            WorkShop Visual 2.0
                            --------------
            	Integration of Xew EuroBridge Widget Set
            	-----------------------------------------

This directory contains the files required to integrate the Xew public domain
widget set 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 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 with WorkShop Visual
	-------------------------------------------------

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.
