This directory contains an X11 device function for S.

The X11 device function works on color and black-and-white Suns.
It also works with Sun server/Vax application and Ardent server/Vax application.

It works partially when new S runs on system V machines.
It does not recognize events which should cause the display to be redrawn
because alarms cause reads/writes/opens/closes/etc
to encounter interrupted system calls.
One idea to cure this is to run the X device
function as its own process, communicating
with S through pipes as old S used to do.

This version of the device function does characters as fonts, and hence
is more capable than the version in the $QPE directory,
which relies only on standard fonts.  However, in order to install
this version, you have to go through some effort to install the fonts.
The fonts occupy about 2Mb in their present ascii form and about 1Mb
when converted to snf form.  You will need
to convert the fonts in the "fonts" directory to snf format in a place where
the X11 server can access them.  The fonts were mechanically created from
the X11 terminal 75dpi fonts.  The Helvetica fonts were modified slightly.

To do the font conversion, run the X11 program bdftosnf to convert each of the
.bdf files into a corresponding .snf file.
	
	mkdir nfonts
	cd fonts
	for i in *.bdf
	do
		j=`basename $i .bdf`
		echo $j
		bdftosnf <$j.bdf >../nfonts/$j.snf
	done
	cd ../nfonts
	mkfontdir .
Mkfontdir creates a fonts.dir file in the nfonts directory.
Next, execute
	xset +fp $SHOME/contributed/X11/nfonts
	xset fp rehash
to get the fonts known by the server.

Finally, make a .Xdefaults file and add its information to the resource
database by means of
	xrdb -merge .Xdefaults

The .Xdefaults file can look like this for a monochrome device:

S.font:helvetica
S.nColors:2
S.color0:white
S.color1:black

For a color device, try using colors.X file.

You might want to add the line
FILE_NAMES_ALIASES
to the fonts.alias file in the font directory (if you can find it!).

There is also an X11 device function available from the S archive
that may be more recent than the one here.
See $SHOME/README for how to access the archive.
