			==============================		Updated:
			XGGI Installation Instructions		990516
			==============================

Binary
======

To install the precompiled binary, simply copy it to an apropriate directory
in your path.


Source (fullscr)
================

The "fullsrc" package contains an XFree 3.3.3.1 source tree which is 
heavily stripped down. Basicly the only thing you can build with this
package is XGGI, but the tree is a whole lot smaller than the XFree86
"ServerOnly" package.
If you have this release of XGGI you can just cd into the xc directory
and type 'make World'. If everything goes well you will find an XGGI
binary in xc/programs/Xserver/


Source (normal)
===============

To compile XGGI yourself you need the XFree86 sources. XGGI 1.6.1 has been
tested with XFree versions 3.3.2, 3.3.3 and 3.3.3.1. It may or may not
build with other versions of XFree86. Both the "ServerOnly" and the full
XFree sources can be used to build XGGI.

First you need to copy the ggi directory into it's place in the XFree
source tree: xc/programs/Xserver/hw/ggi, this is done with
cp -r ggi path/to/xc/programs/Xserver/hw/

Then you need to apply the patch XFree3.3.diff to the XFree sources.
This is done with:
patch -p1 < path/to/xggi-1.6.1/XFree3.3.diff
from the xc directory.

Now you should be able to simply 'make World' to build XGGI. After the
build process is done you can find the XGGI binary in xc/programs/Xserver/


Source (both)
=============

By default XGGI doesn't include the PEX, XIE or LBX extensions. If you
want these to be built you can edit xc/config/cf/host.def and simply
comment out the apropriate defines. Note that a server with LBX will
_not_ run multiheaded (PEX and XIE will not cause any problems, they are
just left out because they are big and not commonly used). Also note
that PEX and XIE are not included in the "fullsrc" package, you need to
get the XFree sources and the normal XGGI distribution to build these.

You may also edit the xc/config/cf/xf86site.def and xc/config/cf/host.def
files to tweak other parameters.


IMPORTANT
=========

Be sure to read at least the keyboard section in the README before attempting
to run XGGI!


//Marcus Sundberg 	[marcus@ggi-project.org]
