
Known bugs & problems

1/	The Xsetup utility does not handle:

	o	Option to handle 2 button as 3 button mouse

	o	Graphics Tablets

	o	Multiple screens

	You must edit the /etc/Xaccel.ini file by hand to make these
	features work.	There are many other features, such as using
	a software cursor on a board that normally uses a hardware
	cursor, that must be manually configured.  These are really
	rare tweaks, though!

2/	On some Operating Systems that support the XQUEUE event
	handler, Mouse Systens Corporation 3 button mice are treated
	as if they are two button (middle button doesn't work).	 If
	you have this problem, disable the OS's mouse manager (usually
	'mousemgr') and have the server directly connect to the port
	with the mouse.	 The Server does recognise all three buttons.

	Make sure that the mouse manager is not restarted at boot
	time.  If two processes open the same port for reading, you 
	will not enjoy the results.

3/	24 bit colors may seem blue in some applications.
	We've seen several applications (Mosaic, mpeg_play) where
	ports to Intel UNIX versions do not query the order of color
	bits in the 24 bit representation.  We use the same order as
	the hardware (RAMDAC's use a consistent order on the hardware
	we've seen).  The order assumed by some of these applications
	and the order used by the hardware are different.  Red and
	blue bits are swapped.	So the BSDI Imp on their WWW server 
	becomes blue, instead of red.  The Mosaic spinning globe is 
	ugly... We'll try to propogate some correct code for thse 
	higher color depths, that will work on any 24 bit server.

4/	TrueColor will not work on certain chipsets that claim support
	for 24 bit color.  There are two ways to implement 24 bit
	color support in the graphics hardware.	 Most initial
	implementations by the chipset vendors used a 3 byte (exact
	24 bit) alignment.  This causes a significant performance
	penalty.  Second and subsequent chipset generations now use
	a 4 byte (32 bit) memory alignment, providing a 24 bit frame 
	and a separate 8 bit frame.  The improved alignment has a
	marked effect on performance and the extra 8 bit frame may
	permit some future magic we have in mind.  So, we support the
	32 bit memory access in the newer chipsets, not the exactly
	24 bit frame in the first generation chips.  You may notice
	that the following chips have 24 bit color that we do not
	support:

		ATI MACH32
		Cirrus Logic GD542x
		Oak Technologies OTI087
		S3  801/805
		Trident TVGA8900
		Tseng Labs ET4000
		Western Digital WD90C3x

	The Mach64 supports both the packed (3 byte) and the newer 4
	byte form.  You can support higher resolutions with the 3 byte
	representation.	 ATI quotes maximum resolution for the Mach64
	24 bit mode using the packed representation.  You will not be 
	able to achieve the max resolution quoted by ATI, because of 
	our design choice to achieve performance.

5/	We believe that there is a minor hardware problem with the 
	Number 9 GXE 64Pro.  The very right hand edge of the screen 
	may wrap around to the left hand side of the screen.  We are 
	working with Number 9 to resolve this issue.  The very similar
	Diamond Stealth 64 does not seem to exhibit the problem.

6/	Although we support HighColor (15/16 bit or 32k/64k colors), 
	you may not be able to find a configuration that works.	 Board 
	vendors change the color-lookup-table chips.  We may have a 
	board description that does not match the exact hardware on 
	the board that you have.  It should also be noted that some 
	chips have different frequency limitations, which may prevent 
	operation at some resolutions in higher color modes.

	For example, we know of two versions of the Orchid Fahrenheit
	1280+, which will show bad colors if the wrong RAMDAC type is
	chosen.	 Some vendors work closely with us, so that we can
	support their variations.  Some don't.	If you have a problem
	with a board, less us know, tell us what the RAMDAc is and we
	can probably turn round a usable board configuration file in a
	few days.  Our only problem arises when the RAMDAC is a new
	unsupported design.

	The correct board description can be created by editting the
	xqa file, with knowledge of the chips and frequency limits.
	It is not possible for us to unambiguously identify the RAMDAC
	in use, so we cannot correct the problem in software.

	We have provided some boards with alternate RAMDAC configurations.
	Unfortunately we know of no completely unambiguous mechanism to
	identify the RAMDAC in use.  You'll have to look at the board
	and identify the RAMDAC.  Sorry, that's just the way that the
	boards and chips work...

7/	We have been using very early versions of the new Number 9 128 bit
	engine, the I-128.  Production versions may require the use of a 
	new driver.  If you observe problems, please check the anon-FTP
	and other services for a patch.	 It is quite normal for a new
	chip set to produce many variations of boards that may not be
	usable with this release.  We will issue software that will
	work with new variants soon after they appear.

8/	When running an ISA bus clone of the IBM XGA chipset, we
	recommend that you disable DMA on the graphics board.  You
	should also disable VGA BIOS shadowing and VGA BIOS caching (you
	should not disable the processor or external caches for the
	processor, though, unless you want a *very* slow system).

9/	When running SCO UNIX (Open Server) on a graphics board with
	an S3 chip set without a programmable pixel clock, then the
	use of the Locus Merge 'Zoom' function may hang the Operating
	System.	 The problem is in the Locus Merge handling of the
	chip, rather than the X Server.

	Examples where we ran into that problem were the Actix GE32+ and
	Orchid Farenheit 1280+.

10/	Sometimes, after a resolution switch (<Ctl-Alt-Numeric-'-'> or
	<Ctl-Alt-Numeric-'+'>) or a Virtual Terminal switch, the screen 
	image may have some random pixels incorrectly displayed. This 
	can be fixed with a refresh ('xrefresh') or by moving the 
	cursor around.

	This problem almost exclusively manifests itself on older
	SVGA chips (ET4000, TVGA8900, OTI077, etc.).  Put another way,
	we have yet to see or hear about this problem on the new style 
	high performance graphics chips.

	We recommend that you avoid the problem by not doing screen 
	resolution switches on older SVGA chips.

11/	When using a Trident TVGA8900D in 16 color (4 bit)
	mode, there may be some random pixels (usually in short
	horizontal lines that persist with screen resolution changes).
	When performing heavy drawing (e.g. the xbench, x11perf test
	suites) some parts of the screen (particularly the bottom
	edge of a virtual desktop) may display a narrow fringe of
	twilight zoned colors.	If you can trade screen resolution
	for colors, you may find the 256 color mode (8 bits) to be
	more stable.

12/	We have observed significant problems using Adaptec Bus
	Mastering SCSI Host Bus Adapters with IIT/XTEC (AGX014 and
	AGX015) chipsets (e.g. Boca Vortek, Boca Vortek VL, Reveal
	VC700).	 The boards interfere with each other.	We know of at
	least two instances where previously stable systems had hard
	disks wiped during first boot with these chipsets.  There do
	not appear to be any problems using the chipset with Adaptec
	1520 (non-Bus Mastering) or IDE adapters.  We have no reason
	to believe that the problem is more extensive than just
	Adaptec Bus Mastering adapters and the IIT/XTEC chipsets.

	The problem occurs before UNIX boots, so the Accelerated-X
	server is not even running at this point.

	One workaround we have found is to enable VGA BIOS shadowing,
	and where available enable VGA BIOS caching. Note that this is
	exactly the opposite thing you should do for all other XGA
	clones.
	
-------------------------------------------------------------------------------

Graphics chipsets supported in this release are listed below.  The
chart shows the maximum depth supported on each chipset for each
resolution we support.	Please note that this represents the best
that the chipset can achieve, if not limited by memory or RAMDAC.
If you buy a 1MB board, there's no way to give you 1600x1200 in
TrueColor mode... If you buy the cost reduced version of a board, it
may have a less capable RAMDAC.

Graphics Chip Vendor
  |
  |  Graphics Chip
  |	  |
  |	  |	   640x480
  |	  |	      |	     800x600
  |	  |	      |		|     1024x768
  |	  |	      |		|	  |	1152x900
  |	  |	      |		|	  |	    |	  1280x1024
  |	  |	      |		|	  |	    |	      |	    1600x1200
  |	  |	      |		|	  |	    |	      |		|
------- ----------- --------- --------- --------- --------- --------- -------
       |	   |	     |	       |	 |	   |	     |
ATI	MACH8	    4/8	      4/8	4/8	  4	    4	      -
	MACH32	    4/8/16    4/8/16	4/8/16	  4/8	    4/8	      -
	MACH64	    8/16/32   8/16/32	8/16/32	  8/16/32   8/16      8/16

Cirrus	GD5402	    4/8	      4/8	4	  4	    -	      -
	GD5420	    4/8	      4/8	4/8	  4/8	    -	      -
	GD5422	    4/8/16    4/8/16	4/8	  4/8	    4	      -
	GD5424	    4/8/16    4/8/16	4/8	  4/8	    4	      -
	GD5426	    4/8/16    4/8/16	4/8	  4/8	    4/8	      -
	GD5428	    4/8/16    4/8/16	4/8/16	  4/8	    4/8	      -
	GD5429	    4/8/16    4/8/16	4/8/16	  4/8	    4/8	      -
	GD5430	    4/8/16    4/8/16	4/8/16	  4/8	    4/8	      -
	GD5434	    4/8/16/32 4/8/16/32 4/8/16	  4/8/16    4/8	      -

IBM \	VESA8514    4/8	      4/8	4/8	  -	    -	      -
 8514	82C480	    4/8	      4/8	4/8	  4/8	    4/8	      -
	82C481	    4/8	      4/8	4/8	  4/8	    4/8	      -

IBM	VGA	    4	      -		-	  -	    -	      -

IBM \	XGA	    8/16      8		8	  -	    -	      -
 XGA	XGA-2	    8/16      8		8	  -	    -	      -

IIT	AGX014	    8/16      8		8	  -	    -	      -
	AGX015	    8/16      8/16	8/16	  8	    8	      -

Matrox	MGA-I	    8/16/32   8/16/32	8/16/32	  8/16/32   8/16/32   8
	MGA-II	    8/16/32   8/16/32	8/16/32	  8/16/32   8/16      8/16

Number9	I-128	    8/16/32   8/16/32	8/16/32	  8/16/32   8/16/32   8/16/32

Oak	OTI067	    4/8	      4/8	4	  4	    -	      -
	OTI077	    4/8/16    4/8/16	4/8	  4/8	    4	      -
	OTI087	    4/8/16    4/8/16	4/8	  4/8	    4/8	      -

S3	86C801	    4/8/16    4/8/16	4/8	  4/8	    4/8	      -
	86C805	    4/8/16    4/8/16	4/8	  4/8	    4/8	      -
	86C805i	    4/8/16    4/8/16	4/8	  4/8	    4/8	      -
	86C864	    8/16/32   8/16/32	8/16	  8	    8	      -
	86C911	    4/8/16    4/8/16	4/8	  4	    4	      -
	86C924	    4/8/16    4/8/16	4/8	  4	    4	      -
	86C928	    4/8/16/32 4/8/16/32 4/8/16/32 8/16	    8/16      8
	86C964	    8/16/32   8/16/32	8/16/32	  8/16/32   8/16/32   8/16/32

Trident TVGA8900B   4/8	      4/8	4/8	  4/8	    -	      -
	TVGA8900C   4/8	      4/8	4/8	  4/8	    -	      -
	TVGA8900CL  4/8	      4/8	4/8	  4/8	    -	      -
	TVGA8900D   4/8	      4/8	4/8	  4/8	    -	      -
	TVGA9000    4/8	      4/8	4	  4	    -	      -
	TVGA9000i   4/8	      4/8	4	  4	    -	      -

Tseng	ET3000	    4/8	      4/8	4	  4	    -	      -
	ET4000	    4/8/16    4/8/16	4/8	  4/8	    4	      -
	ET4000/W32  4/8/16    4/8/16	4/8	  4/8	    4/8	      -
	ET4000/W32i 4/8/16    4/8/16	4/8	  4/8	    4/8	      -
	ET4000/W32p 4/8/16/32 4/8/16/32 4/8	  4/8	    4/8	      -

Weitek	P9000	    8/16/32   8/16/32	8/16	  8/16	    8	      8

WDC	PVGA1	    4/8	      4/8	4	  -	    -	      -
	WD90C00	    4/8	      4/8	4	  -	    -	      -
	WD90C11	    4/8	      4/8	4	  -	    -	      -
	WD90C26	    4/8	      -		-	  -	    -	      -
	WD90C30	    4/8/16    4/8/16	4/8	  4/8	    4	      -
	WD90C31	    4/8/16    4/8/16	4/8	  4/8	    4	      -
	WD9500	    4/8	      4/8	4/8	  -	    -	      -
