  Readme for the XFree86 3.1.1 LinkKit
  The XFree86 Project, Inc.
  7 January 1995

  1.  Readme for the XFree86 3.1.1 LinkKit


     1.	For systems which don't	use gcc-2, you may need	to install
	libgcc.a if the	binary distribution you	are using was built with
	gcc-2.

     2.	Make sure that you have	the XFree86 3.1.1 config files and
	libraries and headers installed	under /usr/X11R6.  For some OSs
	these will be included in the `lib' and	`inc' packages.	 For
	others they are	included in the	`prog' or `dev'	package.  Older
	versions are not compatible.

     3.	Edit the site.def file to define which servers you want	to
	build, and the drivers and extensions you want included.


	o  Set HasGcc and HasGcc2 to match the compiler	you are	using if
	   the defaults	aren't correct.

	o  If the LinkKit was built with gcc-2.x and you are using some
	   other compiler, you must install libgcc.a and set NeedLibGcc
	   to YES.

	o  To build the	256 colour server: set XF86SVGAServer to YES.

	o  To build the	16 colour server: set XF86VGA16Server to YES.

	o  To build the	monochrome server: set XF86MonoServer to YES.

	o  To build the	S3 server: set XF86S3Server to YES.

	o  To build the	Mach8 server: set XF86Mach8Server to YES.

	o  To build the	Mach32 server: set XF86Mach32Server to YES.

	o  To build the	Mach64 server: set XF86Mach64Server to YES.

	o  To build the	P9000 server: set XF86P9000Server to YES.

	o  To build the	AGX server: set	XF86AGXServer to YES.

	o  To build the	ET4000/W32 server: set XF86W32Server to	YES.

	o  To build the	IBM 8514/A server: set XF86I8514Server to YES.

	o  To build the	Xnest server: set XnestServer to YES.

	o  Set XF86SvgaDrivers to the list of drivers you want to
	   include in the SVGA server.

	o  Set XF86Vga16Drivers	to the list of drivers you want	to
	   include in the 16 colour server.

	o  Set XF86Vga2Drivers to the list of drivers you want to
	   include in the monochrome vga server.

	o  Set XF86MonoDrivers to the list of non-vga mono drivers you
	   want	to include in the mono or VGA16	servers	(when building
	   dual-headed servers).


	o  Note: the ordering of drivers determines the	order in which
	   the probing is done.	 The `generic' driver should be	the last
	   one included	in the Mono and	VGA16 and SVGA servers because
	   its probe always succeeds.

	o  To include the PEX extension: set BuildPexExt to YES.

	o  To include the X Image Extension: set BuildXIE to YES.

	o  To include the Low Bandwidth	X extension: set BuildLBX to
	   YES.

	o  To include the Screen Saver extension: set
	   BuildScreenSaverExt to YES.

	o  If you are building more than one Xserver, uncomment	the
	   ServerToInstall line	and set	it to the name of the Xserver
	   you want to be the default server (i.e., the	one that the
	   ``X'' sym-link points to).


     4.	If you are including a driver that it not part of the standard
	distribution, make a directory in drivers/vga256 (drivers/vga2
	if it is for the VGA2 part of the Mono server, drivers/vga16 if
	it is for the 16 colour	server,	or drivers/mono	non-VGA	part of
	the Mono and VGA16 servers) and	copy either the	source or .o
	file and a suitable Imakefile into that	directory.  The	name of
	the directory should be	the same as the	name of	the driver
	(refer to the documentation in the VGADriverDoc	directory for
	more details).

     5.	To build the Makefile, run

	  ./mkmf



     6.	Run `make' to link the server(s) as configured.

     7.	Run `make install' to install the new server(s).

     8.	Run `make clean' to remove the files that were created by this
	procedure.

     9.	If you edit the	site.def file and change the selection of
	servers	being built or the drivers included in them, repeat the
	above procedure.  If changing the selection of Xserver
	extensions being included it is	sufficient to run `make
	Makefile' instead of `./xmkmf'.

     10.
	It is possible to see which drivers are	included in the	Xserver
	by running it with the `-showconfig' flag.  To check which
	extensions are included, start the Xserver and run `xdpyinfo'.


  $XConsortium:	LinkKit.sgml,v 1.2 95/01/16 13:17:43 kaleb Exp $
  Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/LinkKit.sgml,v 3.3 1995/01/28 16:01:36 dawes Exp $








