| 1 |
remi 09/03/30 14:31:09 |
| 2 |
|
| 3 |
Modified: index.xml |
| 4 |
Added: xorg-server-1.5-upgrade-guide.xml |
| 5 |
Log: |
| 6 |
add the xorg 1.5 upgrade guide |
| 7 |
|
| 8 |
Revision Changes Path |
| 9 |
1.25 xml/htdocs/proj/en/desktop/x/x11/index.xml |
| 10 |
|
| 11 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/index.xml?rev=1.25&view=markup |
| 12 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/index.xml?rev=1.25&content-type=text/plain |
| 13 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/index.xml?r1=1.24&r2=1.25 |
| 14 |
|
| 15 |
Index: index.xml |
| 16 |
=================================================================== |
| 17 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/x/x11/index.xml,v |
| 18 |
retrieving revision 1.24 |
| 19 |
retrieving revision 1.25 |
| 20 |
diff -u -r1.24 -r1.25 |
| 21 |
--- index.xml 24 Mar 2009 23:11:42 -0000 1.24 |
| 22 |
+++ index.xml 30 Mar 2009 14:31:09 -0000 1.25 |
| 23 |
@@ -6,7 +6,7 @@ |
| 24 |
<project> |
| 25 |
<name>x11</name> |
| 26 |
<longname>X11 Team</longname> |
| 27 |
-<date>23 Nov 2008</date> |
| 28 |
+<date>30 Mar 2009</date> |
| 29 |
<author title="Author">Donnie Berkholz</author> |
| 30 |
|
| 31 |
<description> |
| 32 |
@@ -37,6 +37,10 @@ |
| 33 |
X Maintenance Guide |
| 34 |
</resource> |
| 35 |
|
| 36 |
+<resource link="xorg-server-1.5-upgrade-guide.xml"> |
| 37 |
+ Xorg Server 1.5 Upgrade Guide |
| 38 |
+</resource> |
| 39 |
+ |
| 40 |
<resource link="modular-x-howto.xml"> |
| 41 |
Migrating to Modular X HOWTO |
| 42 |
</resource> |
| 43 |
|
| 44 |
|
| 45 |
|
| 46 |
1.1 xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.5-upgrade-guide.xml |
| 47 |
|
| 48 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.5-upgrade-guide.xml?rev=1.1&view=markup |
| 49 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.5-upgrade-guide.xml?rev=1.1&content-type=text/plain |
| 50 |
|
| 51 |
Index: xorg-server-1.5-upgrade-guide.xml |
| 52 |
=================================================================== |
| 53 |
<?xml version="1.0" encoding="UTF-8"?> |
| 54 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.5-upgrade-guide.xml,v 1.1 2009/03/30 14:31:09 remi Exp $ --> |
| 55 |
|
| 56 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 57 |
|
| 58 |
<guide link="/proj/en/desktop/x/x11/upgrading-to-xorg-1.5.xml"> |
| 59 |
<title>Xorg 1.5 Upgrade Guide</title> |
| 60 |
|
| 61 |
<author title="Author"> |
| 62 |
<mail link="remi"/> |
| 63 |
</author> |
| 64 |
|
| 65 |
<abstract> |
| 66 |
This guide shows you how to upgrade X.org to 1.5 version.. |
| 67 |
</abstract> |
| 68 |
|
| 69 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
| 70 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 71 |
<license/> |
| 72 |
|
| 73 |
<version>1</version> |
| 74 |
<date>2009-03-30</date> |
| 75 |
|
| 76 |
<chapter> |
| 77 |
<title>Ebuild changes</title> |
| 78 |
<section> |
| 79 |
<body> |
| 80 |
|
| 81 |
<ul> |
| 82 |
<li> |
| 83 |
<c>x11-misc/xkbdata</c> is now completely deprecated. If you were not using |
| 84 |
its replacement (<c>x11-misc/xkeyboard-config</c>), Portage may ask you to |
| 85 |
remove it before proceeding with the update. |
| 86 |
</li> |
| 87 |
<li> |
| 88 |
X now no longer forces a double hidden build of <c>media-libs/mesa</c>. |
| 89 |
Mesa now builds the software renderer (swrast) and whatever hardware driver |
| 90 |
you've chosen with the <c>VIDEO_CARDS</c> variable. |
| 91 |
</li> |
| 92 |
<li> |
| 93 |
Due to the above change, the <c>dri</c> USE flag was dropped. Xorg will now |
| 94 |
always have OpenGL support unless <c>USE=minimal</c> is set. |
| 95 |
</li> |
| 96 |
<li> |
| 97 |
XPrint has been removed in Xorg 1.6 and newer, but we've decided to drop it |
| 98 |
as well from 1.5. XPrint support has been removed from all X libraries. |
| 99 |
</li> |
| 100 |
<li> |
| 101 |
Xorg now supports HAL to automatically hot-plug input devices, see the |
| 102 |
section below to properly configure it. |
| 103 |
</li> |
| 104 |
<li> |
| 105 |
The "synaptics" driver is now provided by |
| 106 |
<c>x11-drivers/xf86-input-synaptics</c> |
| 107 |
</li> |
| 108 |
</ul> |
| 109 |
|
| 110 |
</body> |
| 111 |
</section> |
| 112 |
</chapter> |
| 113 |
|
| 114 |
<chapter> |
| 115 |
<title>Configuring Input</title> |
| 116 |
<section> |
| 117 |
<title>With HAL (with xf86-input-evdev)</title> |
| 118 |
<body> |
| 119 |
|
| 120 |
<p> |
| 121 |
In a nutshell, HAL allows to set the exact same properties as |
| 122 |
<path>xorg.conf</path> does but with a lot more flexibility: you can now have |
| 123 |
per-device layouts for instance. All of this is provided by the |
| 124 |
<c>xf86-input-evdev</c> driver. |
| 125 |
</p> |
| 126 |
|
| 127 |
<p> |
| 128 |
First, make sure you've built xorg-server with <c>INPUT_DRIVER="evdev"</c>. |
| 129 |
</p> |
| 130 |
|
| 131 |
<p> |
| 132 |
Then, we can configure HAL to correctly report the keyboard's layout. HAL ships |
| 133 |
with device rules that are kept in <path>/usr/share/hal</path>. |
| 134 |
</p> |
| 135 |
|
| 136 |
<impo> |
| 137 |
Do <e>not</e> edit those, they will be overwritten during the next HAL update. |
| 138 |
You can instead add your own rules into <path>/etc/hal/fdi/policy</path>. |
| 139 |
</impo> |
| 140 |
|
| 141 |
<p> |
| 142 |
Sample configuration FDI files are available |
| 143 |
<path>/usr/share/doc/hal-*/*.fdi*</path>. Pick the one that best fits your |
| 144 |
current configuration and copy it to <path>/etc/hal/fdi/policy</path>. |
| 145 |
</p> |
| 146 |
|
| 147 |
<p> |
| 148 |
For example, if you just want a basic configuration for a non-US keyboard |
| 149 |
layout, copy the content of |
| 150 |
<path>/usr/share/doc/hal-*/use-estonian-layout.fdi.bz2</path> into |
| 151 |
<path>/etc/hal/fdi/policy/10-xinput-configuration.fdi</path> (using |
| 152 |
<c>bzcat</c>) and edit it to match the keyboard layout you wish to use. |
| 153 |
</p> |
| 154 |
|
| 155 |
<p> |
| 156 |
Don't forget to read <c>man evdev</c> to see the driver's capabilities and |
| 157 |
options (especially mouse wheel emulation, middle mouse button emulation, ...). |
| 158 |
</p> |
| 159 |
|
| 160 |
<note> |
| 161 |
Current HAL versions are not (yet) able to pick up FDI file changes on their |
| 162 |
own. You'll have to restart HAL's init script to see your changes. To make sure |
| 163 |
everything is correct, use the <c>lshal</c> utility to display HAL's device tree |
| 164 |
and search for "input". The content of your HAL rules should show up in lshal's |
| 165 |
output. |
| 166 |
</note> |
| 167 |
|
| 168 |
</body> |
| 169 |
</section> |
| 170 |
<section> |
| 171 |
<title>With HAL and other drivers (xf86-input-synaptics, linuxwacom, ...)</title> |
| 172 |
<body> |
| 173 |
|
| 174 |
<p> |
| 175 |
By default, HAL will tell the X server to use the <c>evdev</c> driver to access |
| 176 |
all input devices. However this can be changed to any input driver you wish. |
| 177 |
</p> |
| 178 |
|
| 179 |
<p> |
| 180 |
You can therefore put all your input device configuration into HAL even if you |
| 181 |
use other input drivers such as <c>synaptics</c> or <c>linuxwacom</c>. |
| 182 |
</p> |
| 183 |
|
| 184 |
<p> |
| 185 |
More information on how to configure those drivers can be found here: |
| 186 |
</p> |
| 187 |
|
| 188 |
<ul> |
| 189 |
<li> |
| 190 |
<uri>http://cgit.freedesktop.org/xorg/xserver/tree/config/x11-input.fdi</uri> |
| 191 |
</li> |
| 192 |
<li> |
| 193 |
<uri>http://cgit.freedesktop.org/xorg/driver/xf86-input-synaptics/tree/fdi/11-x11-synaptics.fdi</uri> |
| 194 |
</li> |
| 195 |
<li> |
| 196 |
<uri>http://cvs.fedoraproject.org/viewvc/rpms/linuxwacom/F-10/10-linuxwacom.fdi?view=markup</uri> |
| 197 |
</li> |
| 198 |
</ul> |
| 199 |
|
| 200 |
</body> |
| 201 |
</section> |
| 202 |
<section> |
| 203 |
<title>Without HAL</title> |
| 204 |
<body> |
| 205 |
|
| 206 |
<p> |
| 207 |
If you don't want to use HAL, you can either build <c>xorg-server</c> with |
| 208 |
<c>USE="-hal"</c> or you can turn AutoAddDevices option off in the |
| 209 |
ServerFlags section of your <path>xorg.conf</path>. |
| 210 |
</p> |
| 211 |
|
| 212 |
<pre caption="Turning AutoAddDevices off"> |
| 213 |
Option "AutoAddDevices" "false" |
| 214 |
</pre> |
| 215 |
|
| 216 |
<p> |
| 217 |
Both options will allow the X server to use the legacy <c>mouse</c> and |
| 218 |
<c>kbd</c> drivers. |
| 219 |
</p> |
| 220 |
|
| 221 |
</body> |
| 222 |
</section> |
| 223 |
</chapter> |
| 224 |
|
| 225 |
<chapter> |
| 226 |
<title>Configuring the graphics card</title> |
| 227 |
<section> |
| 228 |
<body> |
| 229 |
|
| 230 |
<p> |
| 231 |
The "Device" section in your xorg.conf should mostly work unchanged. |
| 232 |
</p> |
| 233 |
|
| 234 |
<p> |
| 235 |
However, if you have any issues, here's a few steps you can try: |
| 236 |
</p> |
| 237 |
|
| 238 |
<ul> |
| 239 |
<li> |
| 240 |
Try commenting out all "Options" in the "Device", "Screen" and "Monitor" |
| 241 |
sections in your xorg.conf |
| 242 |
</li> |
| 243 |
<li> |
| 244 |
Even better, try running Xorg without <e>any</e> <path>xorg.conf</path> (you |
| 245 |
can rename it to <path>xorg.conf.old</path>) |
| 246 |
</li> |
| 247 |
</ul> |
| 248 |
|
| 249 |
<p> |
| 250 |
Xorg drivers are now much better at actually detecting what kind of hardware you |
| 251 |
have and (except for a <e>few</e> special cases) the default settings should be |
| 252 |
kept. |
| 253 |
</p> |
| 254 |
|
| 255 |
</body> |
| 256 |
</section> |
| 257 |
</chapter> |
| 258 |
|
| 259 |
<chapter> |
| 260 |
<title>Miscellaneous Options</title> |
| 261 |
<section> |
| 262 |
<body> |
| 263 |
|
| 264 |
<p> |
| 265 |
The old font handling was shaken quite a bit in our version of 1.5.3. The |
| 266 |
<c>freetype</c> module is now useless since the server uses <c>libXfont</c> to |
| 267 |
load whatever fonts you might have for legacy applications. |
| 268 |
</p> |
| 269 |
|
| 270 |
<p> |
| 271 |
As for legacy fonts themselves, they are now nearly useless as we provide a |
| 272 |
built-in "fixed" font which all legacy applications and toolkits should be able |
| 273 |
to use. Beware though that this font is extremely ugly. |
| 274 |
</p> |
| 275 |
|
| 276 |
<p> |
| 277 |
Xdmx is broken. Don't use it unless you know what you're doing. |
| 278 |
</p> |
| 279 |
|
| 280 |
</body> |
| 281 |
</section> |
| 282 |
</chapter> |
| 283 |
</guide> |
Archives