Move README to being a plain old text file.

This commit is contained in:
Eric Anholt
2007-04-02 18:20:33 -07:00
parent 9b78208f1e
commit eb45315b07
3 changed files with 104 additions and 330 deletions

View File

@@ -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

280
README
View File

@@ -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>

View File

@@ -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>