Quick Reference:

To create custom versions of WorkShop Visual that include extra
widgets, you should follow these steps. The example will produce a
WorkShop Visual that includes the Athena Widget Set.

1) cd to $VISUROOT/user_widgets/Athena
2) Read the README for full details
3) Generate code and config.c files using visu_config
4) Type "make" to create visu.bin
5) Run WorkShop Visual as normal, but set the environment variable
   USER_WIDGETS to the string "Athena" (ie the name of the directory)
6) To make this integration the site default make a symbolic link in
   $VISUROOT/user_widgets called "local" pointing to "Athena".
7) To integrate any of the other standard widget sets (e.g. XRT) simply
   repeat the steps above using the appropriate sub-directory rather than
   "Athena".

Details:

This is the root of the user widgets hierarchy. The obj directory
contains a .o file to link with third party widget libraries. Third party
widgets are provided in the other directories. See the Makefiles and READMEs for
details of building them and integrating them with the .o file.

Combining two or more distinct additional widget sets is not catered for
automatically but it can be done locally by creating a new, suitably named,
sub-directory here and combining .xdc files, source code, resource
files and Makefiles manually. So long as a runnable binary is produced
and the app-defaults sub-directory contains a suitable resource file all
should be well.

Once a binary has been produced by the Makefile in a user widget directory
it can be selected in preference to the default by setting the environment
variable USER_WIDGETS to the name of the directory (e.g. USER_WIDGETS=Athena).
It is picked up automatically via the startup command you normally invoke
from your shell via PATH.

A site default can be set up in a directory called 'local'. If a binary exists
in here it is run as the site default. It must have at least an app-defaults
sub-directory with a suitable resource file that references the real one in
../../lib/locale/C/app-defaults. For different locales replace the /C/ by
something appropriate. See the structure of the provided
directories for more information.
