summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Makefile.am7
-rw-r--r--README280
-rw-r--r--README.sgml147
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>