			     MKXCONFIG
			-------------------
Author: Sean Walton
Copyright 1994, all rights reserved
Copy, modify and [fold, spindel and mutilate] allowed by GPL.

"mkxconfig" is supposed to remove from the user the headache of 
trying to build the Xconfig file.  I went through the "Hitchhiker's
Guide to X386/XFree86 Video Timing" and developed a pretty reliable
tool which creates the ModeDB.  So far, it has been received with
great favor.  Please keep in mind that playing with video timings is
VERY HAZARDOUS to your monitor's health.  Use of this program is YOUR
RESPONSIBILITY.  IT IS INADVISABLE TO USE THIS PROGRAM ON A NON-
MULTISYNC MONITOR!
    When you run this program (WHILE NOT IN X), it will ask you a few 
questions in order to make a "clean Xconfig" in your home directory.  
Then, `X -probeonly' is called and the results parsed.  The data received 
is used to complete the Xconfig construction.  When `X probeonly' is
called, your screen will blank briefly.  You may hear some clicking 
sounds from your monitor.  This is okay, as long as the probe returns 
within a minute.  If it takes longer than one minute, RESET YOUR 
COMPUTER!
    Once completed, note the clocks within the Xconfig.  You need to
test the resolutions.  If any display is unstable or smeared, SWITCH
TO ANOTHER RESOLUTION _QUICKLY_ or KILL X.  Bring up X with `startx';
if the first resolution is not stable, immediately kill X, edit Xconfig
and remove the first quoted entry in the Modes list (go back into X).
Switch from resolution to resolution using the alt-ctrl-+ or alt-ctrl--,
using the numeric keypad.
    Some of the displays may look shifted left or right or extra small.
That's okay.  This can be fixed using the monitor's controls.  Many
monitors allow programming some registers to recognize the resolutions.
The resolutions you want to find are the ones that are unstable or 
smeared.
    The reason you have to do this is because sometimes the probe lies.
It has reported on some (all?) cards I've tested that a clock is
available, when that's not true.  For instance, my home machine
supports 75MHz.  `X -probeonly' reports that 80MHz is the highest 
allowed.  While my display comes up fine in that resolution, the
picture slowly begins to jitter--not good.  Anyway, I just removed that
entry from my Xconfig.
    Once verified, move the Xconfig into /etc or /usr/X11/lib/X11.

Currently, VGA256 works well.  Due to unavailability, VGA16 and VGAMONO
are not tested.  But they should work (in theory...hmmm?).  I've added
support for accelerator cards (S3, Mach32, Mach8 and 8514).  I sat
down at my friend's Mach32 machine and got it to work.  That leaves
three more to do.  I'll keep trying to find a Linux box with those
cards.
