                      Readme for the Xfree86 LinkKit
                      ------------------------------

0. If you are using a Binary Link Kit distributed as part of a binary
   distribution (for SYSV), you may need to install libsdbm.a.  For
   systems which don't use gcc as their native C compiler, you may also
   need to install libgcc.a.  Refer to the README supplied with the binary
   distribution you are using for more details.

1. Edit the site.def file to define which servers you want to build, and
   the drivers and font renderers you want included.

    - Set HasGcc and HasGcc2 to match the compiler you are using if
      the defaults aren't correct.
    - If the linkkit was build with gcc-2.x and you are using some other
      compiler, you must install libgcc.a and set NeedLibGcc to YES.
    - To build the 256 colour server, set X386Server to YES.
    - To build the monochrome server, set X386MonoServer to YES.
    - Set X386Vga256Drivers to the list of drivers you want to include in
      the 256 colour server.
    - Set X386Vga2Drivers to the list of drivers you want to include in
      the monochrome vga server.  The vga2 driver can be disabled by
      defining this list to be empty.
    - Set X386Hga2Drivers to hga6845 to enable the hga2 driver in the
      monochrome server. The hga2 driver can be disabled by defining this
      to be empty.
    - Set FontRenderers to the list of font renderers you want to include
      in the server.
    - If the linkkit you have includes PEX support, this may be enabled by
      setting BuildPexExt to YES.

   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
   monochrome server because its probe always succeeds for VGA cards.

2. If you are including a driver that it not part of the standard
   distribution, make a directory in drivers/vga256 (or drivers/vga2 if it
   is for the monochrome server) 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).  If you
   are adding an additional font renderer, put the library in renderers/.

3. To build the Makefile, run

     ./mkmf

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

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

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

7. It is possible to see which drivers are included in the server by
   running it with the '-showconfig' flag.



$XFree86: mit/server/ddx/x386/LinkKit/README,v 1.1 1993/05/28 16:25:19 dawes Exp $
