Attachment 249488 Details for Bug 339625 – fix a little typo

[patch] fix a little typo

ati-faq.xml.patch (text/plain), 7.95 KB, created by Enrico Tagliavini on 2010-10-03 22:27:54 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Enrico Tagliavini

Created: 2010-10-03 22:27:54 UTC

Size: 7.95 KB

patch

obsolete

>--- ati-faq.xml.orig	2010-08-02 23:00:10.000000000 +0200
>+++ ati-faq.xml	2010-10-04 00:17:58.349322136 +0200
>@@ -17,6 +17,9 @@
> <author title="Editor">
>   <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
> </author>
>+<author title="Author">
>+  <mail link="enrico.tagliavini@gmail.com">Enrico Tagliavini</mail>
>+</author>
> 
> <abstract>
> This FAQ should help users avoid some common installation and configuration
>@@ -27,12 +30,22 @@
> 
> <license/>
> 
>-<version>3</version>
>-<date>2010-08-02</date>
>+<version>3.1</version>
>+<date>2010-10-03</date>
> 
> <chapter>
> <title>Hardware Support</title>
> <section>
>+<body>
>+
>+<p>
>+This guide is just an addition to the <uri link="/doc/en/xorg-config.xml">Gentoo X Server
>+HowTo</uri> so read it before using this guide
>+</p>
>+
>+</body>
>+</section>
>+<section>
> <title>Is my ATI board supported?</title>
> <body>
> 
>@@ -46,6 +59,10 @@
> GPUs. Older GPUs will use the mature open source xorg-x11 driver.
> </p>
> 
>+<note>
>+To find out what GPU your card is based on you can check <uri>http://en.wikipedia.org/wiki/Comparison_of_ATI_Graphics_Processing_Units</uri>
>+</note>
>+
> <table>
> <tr>
>   <th>GPU</th>
>@@ -133,37 +150,68 @@
> 
> </body>
> </section>
>+</chapter>
>+
>+<chapter>
>+<title>Using the X11 implementation</title>
> <section>
>-<title>I have a laptop. Is my ATI Mobility model supported?</title>
> <body>
> 
> <p>
>-It should be, but you may have a configuration issue due to the OEM PCI id that
>-such chips may have. In such cases, you may have to write the configuration
>-file yourself.
>+Please read the <uri link="/doc/en/xorg-config.xml">Gentoo X Server
>+HowTo</uri> and the <uri link="/doc/en/dri-howto.xml">Hardware Acceleration
>+Guide</uri> for more information on installing drivers for your ATI graphics
>+card.
> </p>
> 
> </body>
> </section>
>-</chapter>
>-
>-<chapter>
>-<title>Installation</title>
> <section>
>-<title>Packages</title>
>+<title>Configuration</title>
> <body>
> 
>+<impo>
>+If you are using radeon driver with KMS be sure fbcon is loaded, otherwise you
>+will get no framebuffer. You also need to disable all framebuffer
>+drivers from the kernel line in GRUB or LILO, like vesafb, uvesafb and
>+radeonfb. Also make sure radeon kernel module
>+is loaded <b>before</b> the X start.
>+</impo>
>+
> <p>
>-There are two ways of getting drivers for your ATI card:
>+You may not need to manually create <path>xorg.conf</path> or modify it. <e>Try
>+running without it first</e>. You can also use the Xorg auto configuration option:
> </p>
> 
>-<ul>
>-  <li>The <c>xorg-x11</c> ebuild provides the X11 implementation</li>
>-    <li>
>-    The <c>ati-drivers</c> ebuild provides the ATI closed source X drivers and
>-    kernel modules
>-  </li>
>-</ul>
>+<pre caption="Autoconfiguring X">
>+# <i>X -configure</i>
>+</pre>
>+
>+<warn>
>+X -configure is known to be broken with some cards, likely from r300 and newer,
>+so don't be surprised if it fails. This option will be removed in future
>+xorg-server versions.
>+</warn>
>+
>+<p>
>+For more information on how to get a basic <c>xorg.conf</c> configuration file,
>+please refer to the <uri link="/doc/en/xorg-config.xml">Gentoo X Server
>+HowTo</uri>.
>+</p>
>+
>+<note>
>+PPC, AMD64, and x86 users can use the <c>xac</c> stand-alone X configuration
>+tool by emerging <c>x11-misc/xac</c>, but isn't required.
>+</note>
>+
>+</body>
>+</section>
>+</chapter>
>+<chapter>
>+<title>Installing the ATI propietary implementation</title>
>+<section>
>+<title>Kernel Setup</title>
>+<body>
> 
> <p>
> If you want to use ATI's <e>internal</e> agpgart support instead of the Linux
>@@ -171,58 +219,135 @@
> configuration) must be built as modules or not at all.
> </p>
> 
>-<note>
>-Please read the <uri link="/doc/en/dri-howto.xml">Hardware Acceleration
>-Guide</uri> for more information on installing drivers for your ATI graphics
>-card.
>-</note>
>+<p>
>+To use <c>ati-drivers</c> you need to do the following changes to your kernel
>+configurations
>+</p>
>+<dl>
>+  <dt><b>Enable</b></dt>
>+  <dd>
>+    <ul>
>+      <li>MTRR</li>
>+      <li>AGP if you have and agp card</li>
>+      <li>PCIEPORTBUS if you have a PCIe card</li>
>+      <li>ACPI</li>
>+      <li>MAGIC_SYSRQ</li>
>+      <li>PCI_MSI</li>
>+      <li>MTRR</li>
>+    </ul>
>+  </dd>
>+  <dt><b>Build as module or disable</b></dt>
>+  <dd>
>+    <ul>
>+      <li>DRM</li>
>+    </ul>
>+  </dd>
>+  <dt><b>Disable</b></dt>
>+  <dd>
>+    <ul>
>+      <li>FB_RADEON</li>
>+      <li>PREEMPT_RCU</li>
>+      <li>LOCKDEP</li>
>+    </ul>
>+  </dd>
>+</dl>
> 
> </body>
> </section>
> <section>
>-<title>Configuration</title>
>+<title>Installing the driver</title>
> <body>
> 
> <p>
>-You may not need to manually create <path>xorg.conf</path> or modify it. Try
>-running without it first. You can also use the Xorg auto configuration option:
>+You can install ati-drivers package in two ways:
> </p>
> 
>-<pre caption="Autoconfiguring X">
>-# <i>X -configure</i>
>+<dl>
>+  <dd>
>+    <ul>
>+      <li>
>+        Add <c>fglrx</c> to <c>VIDEO_CARDS</c> in <c>make.conf</c>,
>+        then run <c>emerge -1N x11-base/xorg-drivers</c>
>+      </li>
>+      <li><c>emerge x11-drivers/ati-drivers</c></li>
>+    </ul>
>+  </dd>
>+</dl>
>+
>+<p>
>+Be sure to autoload the fglrx kernel module: see the
>+<uri link="/doc/en/handbook/handbook-x86.xml?part=1&amp;chap=7#doc_chap5">
>+Kernel configuration</uri> part of the Gentoo Handbook if you are using
>+sys-apps/baselayout-1*. See the <uri link="/doc/en/openrc-migration.xml">
>+openrc migration guide</uri> if you are using sys-apps/baselayout-2*.
>+Of course radeon and drm kernel module must be removed from autoload,
>+since they conflict with fglrx
>+</p>
>+
>+<p>
>+If radeon kernel modules keeps loading you can blacklist it editing
>+<c>/etc/modprobe.d/blacklist.conf</c>
>+</p>
>+<pre caption="/etc/modprobe.d/blacklist.conf">
>+# <i>blacklist radeon</i>
> </pre>
> 
>+</body>
>+</section>
>+<section>
>+<title>Configuration</title>
>+<body>
>+
> <p>
>-For more information on how to get a basic <c>xorg.conf</c> configuration file,
>-please refer to the <uri link="/doc/en/xorg-config.xml">Gentoo X Server
>-HowTo</uri>.
>+You must use an xorg.conf or an xorg.conf.d file with <c>ati-drivers</c>,
>+becouse you must tell xorg to use the fglrx driver. An easy way to do this is
>+using <c>aticonfig</c>:
> </p>
> 
>-<note>
>-PPC, AMD64, and x86 users can use the <c>xac</c> stand-alone X configuration
>-tool by emerging <c>x11-misc/xac</c>, but isn't required.
>-</note>
>+<pre caption="Creating or adjusting an xorg.conf with aticonfig">
>+# <i>aticonfig --initial</i>
>+this will also create a backup of the original xorg.conf file
>+
>+for dual head configuration you can run
>+# <i>aticonfig --initial=dual-head</i>
>+</pre>
> 
> <note>
>-You can use <c>aticonfig</c> if you have installed the <c>ati-drivers</c>
>-package.
>+More options can be set, refer to <c>aticonfig --help</c>
> </note>
> 
>-<impo>
>-If you're using <c>ati-drivers</c>, then you'll need to disable <c>radeonfb</c>
>-(and probably any other framebuffer drivers) in your kernel config, as it
>-conflicts with the built-in framebuffer in <c>ati-drivers</c>.
>-</impo>
>+<p>
>+By building <c>ati-drivers</c> with <c>qt4</c> USE flag, you will be able to
>+use the amdcccle graphic configuration tool to easly configuring the drivers
>+options, and xorg.conf
>+</p>
>+
>+<p>
>+If you wish to do it manually you have to specify <c>Driver "fglrx"</c> in
>+the Device Section. It is suggested to always use aticonfig to tweak the driver
>+config and xorg.conf to <b>avoid</b> conflicting option like:
>+</p>
>+
>+<pre caption="An invalid xorg.conf fglrx options example">
>+Driver "fglrx"
>+Option "Textured2D" "on"
>+Option "TexturedXRender" "on"
>+</pre>
>+
>+<p>
>+which couses an Xorg segmentation fault. It is a good policy to keep the
>+default options with this driver.
>+</p>
> 
> </body>
> </section>
> <section>
>-<title>Switching to OpenGL</title>
>+<title>Switching to ATI OpenGL</title>
> <body>
> 
> <p>
>-Once X is installed, configured, and running, it can use the ATI OpenGL
>-libraries:
>+Once X is installed and configured you must use the ATI OpenGL implementation, you will get a
>+black screen at X startup without this using <c>ati-drivers</c>
> </p>
> 
> <pre caption="Running eselect">

Actions: View | Diff

Attachments on bug 339625: 249480 | 249484 | 249488