Move README to being a plain old text file.

1 files changed, 103 insertions, 177 deletions

diff --git a/README b/README
index e2061c44..788acdb9 100644
--- a/README
+++ b/README
@@ -1,177 +1,103 @@
-  Information for Intel graphics driver users
-  Eric Anholt
-  2006-08-04
-  ____________________________________________________________
-
-  Table of Contents
-
-
-  1. Introduction
-  2. Supported Hardware
-  3. Features
-  4. Technical Notes
-  5. Configuration
-  6. Driver Options
-  7. Known Limitations
-  8. Author
-
-
-  ______________________________________________________________________
-
-  11..  IInnttrroodduuccttiioonn
-
-  This document provides a brief summary of the Intel graphics support
-  provided by the xf86-video-intel driver.  More information can also be
-  found in the i810(4) manual page.
-
-
-  22..  SSuuppppoorrtteedd HHaarrddwwaarree
-
-
-  +o  i810,
-
-  +o  i810-dc100,
-
-  +o  i810e
-
-  +o  i815
-
-  +o  i830
-
-  +o  i845
-
-  +o  i852
-
-  +o  i855
-
-  +o  i915
-
-  +o  i945
-
-  +o  i965
-
-
-
-  33..  FFeeaattuurreess
-
-
-  +o  Full support for 8, 15, 16, and 24 bit pixel depths.
-
-  +o  Hardware accelerated 2D drawing engine support for 8, 15, 16 and 24
-     bit pixel depths.
-
-  +o  Hardware accelerated 3D drawing using OpenGL and the DRI.
-
-  +o  Hardware cursor support to reduce sprite flicker.
-
-  +o  Textured video XV implementation on i915 through i965.
-
-  +o  Hardware overlay XV implementation up through i945.
-
-  +o  Screen resize and rotation on chipsets up through i945.
-
-  +o  Screen resize on i965.
-
-
-
-  44..  TTeecchhnniiccaall NNootteess
-
-
-  +o  Interlace modes cannot be supported.
-
-  +o  This driver  requires kernel support for AGP, which is included in
-     Linux kernels 2.3.42 and higher, and FreeBSD 4.1 and higher.
-
-
-
-  55..  CCoonnffiigguurraattiioonn
-
-  The driver auto-detects all device information necessary to initialize
-  the card.  The only lines you should need in the "Device" section of
-  your xorg.conf file are:
-
-         Section "Device"
-             Identifier "Intel i810"
-             Driver     "i810"
-         EndSection
-
-
-
-  In order to use most resolutions, it is necessary to install the
-  "agpgart.o" module.  You will probably have to compile the module
-  yourself (see the notes in the module).
-
-
-  66..  DDrriivveerr OOppttiioonnss
-
-  Please refer to the i810(4) manual page for information on
-  configuration options.
-
-
-
-  77..  KKnnoowwnn LLiimmiittaattiioonnss
-
-
-  +o  Many systems with Intel graphics have issues with setting video
-     modes at larger than some small maximum resolution.  This is not
-     fixed in the current release, but is being actively worked on in
-     the modesetting branch.
-
-  +o  Bug #5795: Some systems have issues with VT switching.  This should
-     be fixed with the modesetting brach integration.
-
-  +o  Bug #5817: Hotkey switching from LVDS to CRT breaks CRT output.
-     This is a known issue, but will not be fixed in the current
-     release.
-
-  +o  Bug #6635: Video is output from an incorrect offset in the
-     framebuffer.  This is expected to be fixed with the modesetting
-     branch integration.
-
-  +o  GL_EXT_texture_compression_s3tc is not supported.  We can't support
-     the extension due to patent restrictions on compression, but may be
-     able to support an option for partial extension support in the
-     future.  For now, this prevents Quake4 and some other games from
-     running.
-
-  +o  Some X Test Suite cases sometimes fail due to a timeout. These
-     cases include: Xt8/XtResizeWindow, Xt8/XtQueryGeometry,
-     Xt9/XtAppAddInput, Xt9/XtRemoveInput, Xt9/XtAppAddTimeOut,
-     Xt9/XtRemoveTimeOut, Xt9/XtAddGrab, Xt9/XtRemoveGrab.
-
-  +o  Some X Test Suite cases fail in 64-bit mode: Xlib9/XDrawArc,
-     XDrawImageString, XDrawLine, XDrawRectangle, XDrawSegments,
-     XFillArc, XFillPolygon, XFillRectangle, XPutImage,
-     Xt11/XtVaGetSubresources, XtSetSubvalues, and XtVaSetSubvalues.
-
-  +o  Some GLEAN test cases fail if DRI is enabled: pointAtten,
-     readPixSanity, texCombine, texCube, texEnv, texgen,
-     coloredTexPerf2, and coloredLitPerf2.
-
-
-
-  88..  AAuutthhoorr
-
-
-  +o  Eric Anholt
-
-  +o  Keith Whitwell
-
-  The X11R7.1 version of this driver originally came from XFree86 4.4
-  rc2.
-
-  The XFree86 version of this driver was donated to The XFree86 Project
-  by:
-
-      Precision Insight, Inc.
-      Cedar Park, TX
-      USA
-
-
-
-  The X.Org version of this driver is maintained by Intel Corporation.
-
-  http://www.intellinuxgraphics.org
-
-
-
+Information for Intel graphics driver users
+Eric Anholt
+2006-04-02
+
+This document provides a brief summary of the Intel graphics support provided
+by the xf86-video-intel driver.  More information can also be found in the
+intel(4) manual page.
+
+Supported Hardware:
+	i810,
+  	i810-dc100,
+	i810e
+	i815
+	i830
+	i845
+	i852
+	i855
+	i915
+	i945
+	i965
+
+Features
+- Full support for 8, 15, 16, and 24 bit pixel depths.
+- Hardware accelerated 2D drawing engine support for 8, 15, 16 and 24 bit
+  pixel depths.
+- Hardware accelerated 3D drawing using OpenGL and the DRI.
+- Hardware cursor support to reduce sprite flicker.
+- Textured video XV implementation on i915 through i965.
+- Hardware overlay XV implementation up through i945.
+- Screen resize and rotation.
+
+Technical Notes
+- Interlace modes cannot be supported.
+- This driver  requires kernel support for AGP, which is included in Linux
+  kernels 2.3.42 and higher, and FreeBSD 4.1 and higher.
+- This driver may be built against xserver 1.2.0 or newer.  If built
+  from git source against an older server, a copy of xserver 1.3.0 source is
+  needed to complete the build, which is chosen with the --with-xserver-source
+  argument to ./configure.  The compatibility mode with xserver 1.2.0 will have
+  limited functionality, in particular by not supporting RandR 1.2 or the
+  new Damage 1.1 updated needed for 3D applications to work with display
+  rotation.
+
+Configuration
+
+The driver auto-detects all device information necessary to
+initialize the card.  The only lines you should need in the "Device"
+section of your xorg.conf file are:
+
+       Section "Device"
+           Identifier "intel"
+           Driver     "intel"
+       EndSection
+
+Please refer to the intel(4) manual page for information on configuration
+options.
+
+
+Known Limitations
+- Bug #8534: i830 laptop panels not supported.  The driver
+  will fail to recognize them, and only function through VGA output.  Two
+  partial DVO chip drivers (ivch and ch7017) are included which contain some of
+  the code necessary for i830 laptop panel support, but some I2C debugging will
+  be necessary to get those drivers to attach.
+- No support for "zaphod mode" dualhead.  This is the mode in which two
+  Device sections are placed in the config file, and doesn't support DRI or
+  many other features.  Instead, only "MergedFB-style" dualhead is supported.
+- No support for X Screens larger than 2048 pixels in either direction
+  before the 965.  This reflects hardware limitations in the x direction on
+  those older chips, and limits dualhead functionality.  It may be possible to
+  extend the limit vertically on these older chips.
+- i855 XV may cause hangs.  This was present in the previous release, and no
+  workaround is known.
+- SDVO TV-out cards not supported.  This should be fixed in the next
+  release.
+- Gray output with integrated TV-out and PAL TVs.
+- EXA support unstable on i845.
+
+Common issues not caused by the driver
+- Font sizes (DPI) are wrong.  Some displays incorrectly report their
+  physical size, which is harmless on most OSes that always assume 96dpi
+  displays.  This can be fixed through quirks for specific monitors in the X
+  Server, and the output of xrandr --prop along with a physical measurement of
+  the screen size in a bug report against the server can help get that fixed.
+- gnome-panel is located in the middle of the screen.  gnome-panel places
+  itself within head #0's boundaries, which doesn't work well with a second
+  head covering the same area as head #0 but larger.
+- Older resolution-changing applicationss have poor results in
+  multihead systems.  Previous extensions such as RandR 1.1 exposed only a
+  single output to client programs, and those requests map poorly to multi-head
+  systems.  Currently, those requests map to just one of the outputs in the
+  RandR 1.2 environment, and those applications need to be updated to RandR 1.2
+  API when available for better results.
+
+The X11R6 version of this driver originally came from XFree86 4.4 rc2.
+
+The XFree86 version of this driver was donated to The XFree86 Project by:
+    Precision Insight, Inc.
+    Cedar Park, TX
+    USA
+
+The X.Org version of this driver is maintained by Intel Corporation.
+<http://www.intellinuxgraphics.org>