Compiling the Xew sample programs
---------------------------------
This directory (demo) has been unpacked along with Xew.

1. Making test programs

You may have to edit the Imakefile to your local conventions. Note
that this program uses Athena Widgets.

	cd demo
	cp Imakefile.dist Imakefile
		- edit your local changes to Imakefile.
	xmkmf
	make

If you don't have 'imake', you can try to compile with following
(after tailoring some paths to the local environment):

gcc -c -O2 -Wall -g -I../Xew viewer.c
gcc -o viewer viewer.o -O2 -Wall -g  -L../Xew -lXew -lXaw -lXmu -lXt -lXext -lX11

*NOTE*	The Imakefile.dist is initially assuming that neither
	TIFF, JPEG nor RLE support has been compiled in.

2. Testing the widgets

The test programs do attempt to use fallback resources (fallback.c),
but it is recommended that you start from resources as defined in file
"Demo.ad", for simple tests

	setenv XENVIRONMENT Demo.ad

The subdirectory (demo/Text/...) contains some sample text files which
demonstrate the capabilities of the XeText widget.

simple files(s)
---------------
This should pop a separate shell/popup shell for each file.

viewer file(s)
--------------
Same as simple, but the file(s) are shown in single paned widget which
can be panned via athena panner/porthole widgets (X11R5) or athena
viewport (X11R4).

The control left mouse button (Ctrl, Btn3Up) is bound to a code that
pops up control panel(s) for changing some of the resources associated
with the widget. It will control the widget on top of which the button
was released last.

audio [audiofilename]
---------------------
This works only on Sun SPARC's (assumes existence of /dev/audio and
8KHz u-law audio stream).

texted [textfilename]
---------------------
A test program for the TextEd widget class.

This is not intended to be a text editor program. A real text editor
to 'texted' is has approximately the same relation as high level
programming language has to machine language.

But, this is probably the most complex of the example programs at this
point. Selecting 'inset' from the file menu, one can add other Xew
widgets into the text stream.

Control left mouse button (Ctrl, Btn3up) will pop up resource control
panels about the inset widgets.

xaudio from Andrew Brooks (arb@comp.lancs.ac.uk)
------------------------------------------------
This program has nothing to do with Xew widgets. It provides a simple
control panel for controlling the audio play volume on Sun
environment. This is included just because the XeAudio widget does not
contain such controls (it is actually open question whether widget
should have such).

frame [-path [objects]+ [-end] ]+
---------------------------------
This program is a basic test program for the XeFrame widget. The
parameters are a list of -path and and file specifications, the -path
can be one of -d0, -d90, -d180 or -d270. These specify the layout path
for the frame and each following objects until -end will be the
children of the created frame widget. For example

	./frame -d0 fig1.gif -d270 text1.txt fig2.gif -end text2.txt

will create a horizontal frame that contains three objects: fig1.gif,
another frame and test2.txt. The inside frame is has 270 as layout
path and contains two objects: text1.txt and fig2.gif.

tagged
------
	* THIS PROGRAM IS NOT COMPLETE AND BARELY WORK. IT IS MY
	* TEST PROGRAM FOR THE TAGGED SUPPORT OF XeText WHICH IS STILL
	* BEING WORKED ON.

rtf2Xew [filename.rtf]
----------------------
A simple filter that reads RTF and produces a text stream containing
control sequences suitable for XeText content. [Not much of RTF is
realized, but something...]

For a real RTF viewer one would have to make an application that would
be directly feeding the widgets (XeText, XeFrame, XeRaster etc) from
the RTF stream.

