                    Readme for the XFree86 3.1 LinkKit
                    ----------------------------------

0. 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.

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

    - Set HasGcc and HasGcc2 to match the compiler you are using if
      the defaults aren't correct.
    - 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.

    - To build the 256 colour server:   set XF86SVGAServer to YES.
    - To build the 16 colour server:    set XF86VGA16Server to YES.
    - To build the monochrome server:   set XF86MonoServer to YES.
    - To build the S3 server:           set XF86S3Server to YES.
    - To build the Mach8 server:        set XF86Mach8Server to YES.
    - To build the Mach32 server:       set XF86Mach32Server to YES.
    - To build the P9000 server:        set XF86P9000Server to YES.
    - To build the AGX server:          set XF86AGXServer to YES.
    - To build the ET4000/W32 server:   set XF86W32Server to YES.
    - To build the IBM 8514/A server:   set XF86I8514Server to YES.

    - Set XF86SvgaDrivers to the list of drivers you want to include in
      the SVGA server.
    - Set XF86Vga16Drivers to the list of drivers you want to include in
      the 16 colour server.
    - Set XF86Vga2Drivers to the list of drivers you want to include in the
      monochrome vga server.
    - 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).

   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.  The

2. 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).

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: xc/programs/Xserver/hw/xfree86/LinkKit/README,v 3.1 1994/09/25 12:26:24 dawes Exp $
