  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 $








