MANTICORE, INC. X5 V2.0

This README file contains instructions for compiling Manticore's X5.

The main directory consists of the following file:

	README		This file.

	Makefile	Instructions for make program.

	X		X server.

	XMenu		X Menu library.

	Xlib		X application library.

	bitmap		Simple bitmap editor application program.

	bitmaps		Source for frequently used bitmaps.

	cursors		Source for frequently used cursors.

	doc		Documentation for X library.

	font		X font files.

	include		Local includes.

	keycomp		Key map compiler.

	libdbm		Support library for X server.

	libgen		Generalized Device library for X server.

	libcompat	4.2 BSD compatibility library.

	man		Manual pages for X utilities.

	pikapix		X application for recoloring pictures.

	rgb		Color database compiler.

	uwm		X window manager.

	xclock		X clock application.

	xfd		X font display application.

	xgedit		X simple line drawing application.

	xinit		X invocation application.

	xload		X load average display application.

	xpr		X bitmap printing application.

	xrefresh	X application for refreshing the screen.

	xset		X application to set server globals.

	xsetroot	X application to set root window globals.

	xterm		X terminal emulator.

	xwd		X window dumper application.

	xwininfo	X window information display application.

	xwud		X window un-dumper application.

	Toolkit		X toolkits from DEC, HP, and UC Berkeley.

	driver		Sample X I/O driver.

	copyright	Manticore copyright notice.

	xtrek		Trek game which uses X.

	xcons		X program to print console messages.

	xcolors		X color pallet program.

	showimg		X picture display.

	install		4.2 BSD style install program.

	Xconninfo	Communication information file.

	xfifo		X server communications program.

COMPILING X

The Makefile contains instructions for making the user level parts of X.
Here are the various things that can be done with make:

To make X type:

	$ make

To install X type:

	$ su
	# make install
	# make includes

To clean all object modules and program binaries out of the X directory
type:

	$ make clean

To clean all X related files off the system

	$su
	# make remove

To make a distribution tape of the X binaries.

	$ make obj.dist.tape

COMPILING THE DRIVER SOURCES

There is an example driver. This driver works with a Hercules compatible
graphics card, a Logitec serial mouse communicating over com 1 or com 2,
and the standard PC-AT keyboard. The driver was written to work with
the Intel 386 version of ATT Unix 5.3 with Interactive Systems drivers running
in a 386 PC. Substantial modifications will need to be made for other
systems.

The example driver resides in the driver directory. The files in this directory
consist of the following:

	io		I/O driver source directory
	io/her		Example driver for Hercules graphics adapter.
	systems		Example system file for mkunix.
	master.d	Example module config files for mkunix.
	Makefile	make control file for building the driver.

To compile the drivers type the following:

	$ cd driver
	$ make compile

To install the driver object files and header files in /etc/atconf:

	$ cd driver
	$ su
	# make install

To construct a Unix kernel containing the new drivers:

	$ cd driver
	$ su
	# make unix

To clean out the driver directory structure:

	$ cd driver
	$ make clean

To construct the entries in the /dev directory needed for X:

	$ cd driver
	$ su
	# make devices

COMPILING THE DEMOS

There is a set of demo programs which can be used to demonstrate X and
as tests while X is being ported. Since 'bounce' uses very few features
of X it is traditionally the first program to be run on a new port of X.
To compile the demos:

	$ cd demo
	$ make

RUNNING X

Once everything is compiled and installed you can run X.

First you should change your .profile file as follows:

	1) Add /usr/new to the path list.
	2) Add a new environnment variable by insterting the following:

		DISPLAY="unix:0"

	3) Modify the line that sets up the TERM environment variable to:

		if [ "$TERM" = "" ] ; set TERM = AT386 ; export TERM ; fi

	4) If the file /etc/profile sets the TERM variable then modify the
	   file as in 3 above.

To make the changes take affect type:
	
	. .profile

To start up X type:

	$ xinit

X should write a pattern on the screen, display the mouse cursor, and then
open a window which is running a shell.

To leave X just exit from the shell in the first window that X started. All
other windows will be deleted and X will stop.
