Move README to being a plain old text file.

3 files changed, 104 insertions, 330 deletions

diff --git a/Makefile.am b/Makefile.am
index 2b6c46aa..8cbe4a9f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -21,9 +21,4 @@
 AUTOMAKE_OPTIONS = foreign
 SUBDIRS = src man
 
-if BUILD_LINUXDOC
-README: README.sgml
-	$(MAKE_TEXT) README.sgml && mv README.txt README
-endif
-
-EXTRA_DIST = README.sgml
+EXTRA_DIST = README
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>
diff --git a/README.sgml b/README.sgml
deleted file mode 100644
index 4a67017f..00000000
--- a/README.sgml
+++ /dev/null
@@ -1,147 +0,0 @@
-<!DOCTYPE linuxdoc PUBLIC "-//XFree86//DTD linuxdoc//EN" [
-<!ENTITY % defs SYSTEM "defs.ent"> %defs;
-]>
-
-<article>
-<title>Information for Intel graphics driver users
-<author>Eric Anholt
-<date>2006-04-02
-<toc>
-
-<sect>Introduction
-<p>
-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
-<htmlurl name="intel(4)" url="intel.4.html"> manual page.
-
-<sect>Supported Hardware
-<p>
-<itemize>
-	<item>i810,
-  	<item>i810-dc100,
-	<item>i810e
-	<item>i815
-	<item>i830
-	<item>i845
-	<item>i852
-	<item>i855
-	<item>i915
-	<item>i945
-	<item>i965
-</itemize>
-
-
-<sect>Features
-<p>
-<itemize>
-  <item>Full support for 8, 15, 16, and 24 bit pixel depths.
-  <item>Hardware accelerated 2D drawing engine support for 8, 15, 16 and
-        24 bit pixel depths.
-  <item>Hardware accelerated 3D drawing using OpenGL and the DRI.
-  <item>Hardware cursor support to reduce sprite flicker.
-  <item>Textured video XV implementation on i915 through i965.
-  <item>Hardware overlay XV implementation up through i945.
-  <item>Screen resize and rotation.
-</itemize>
-
-
-<sect>Technical Notes
-<p>
-<itemize>
-  <item>Interlace modes cannot be supported.
-  <item>This driver  requires kernel support for AGP, which is
-	included in Linux kernels 2.3.42 and higher, and FreeBSD 4.1
-	and higher.
-  <item>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.
-</itemize>
-
-
-<sect>Configuration
-<p>
-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:
-<verb>
-       Section "Device"
-           Identifier "intel"
-           Driver     "intel"
-       EndSection
-</verb>
-
-<sect>Driver Options
-<p>
-Please refer to the <htmlurl name="intel(4)" url="intel.4.html"> manual page
-for information on configuration options.
-
-
-<sect>Known Limitations
-<p>
-<itemize>
-  <item>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.
-  <item>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.
-  <item>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.
-  <item>i855 XV may cause hangs.  This was present in the previous release,
-  and no workaround is known.
-  <item>SDVO TV-out cards not supported.  This should be fixed in the next
-  release.
-  <item>Gray output with integrated TV-out.
-  <item>EXA support unstable on i845.
-</itemize>
-
-<sect>Common issues not caused by the driver
-<itemize>
-  <item>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.
-  <item>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.
-  <item>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.
-  <item>
-</itemize>
-
-<sect>Author
-<p>
-<itemize>
-   <item>Eric Anholt
-   <item>Keith Whitwell
-</itemize>
-
-The X11R&relvers; version of this driver originally came from XFree86 4.4 rc2.
-
-The XFree86 version of this driver was donated to The XFree86 Project by:
-<verb>
-    Precision Insight, Inc.
-    Cedar Park, TX
-    USA
-</verb>
-
-The X.Org version of this driver is maintained by Intel Corporation.
-
-<htmlurl name="http://www.intellinuxgraphics.org"
-          url="http://www.intellinuxgraphics.org">
-
-
-</article>