1 |
scarabeus 10/04/09 10:06:25 |
2 |
|
3 |
Added: xorg-server-1.8-upgrade-guide.xml |
4 |
Log: |
5 |
Add WIP xorg-server-1.8 guilde. |
6 |
|
7 |
Revision Changes Path |
8 |
1.1 xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.8-upgrade-guide.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.8-upgrade-guide.xml?rev=1.1&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.8-upgrade-guide.xml?rev=1.1&content-type=text/plain |
12 |
|
13 |
Index: xorg-server-1.8-upgrade-guide.xml |
14 |
=================================================================== |
15 |
<?xml version="1.0" encoding="UTF-8"?> |
16 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/x/x11/xorg-server-1.8-upgrade-guide.xml,v 1.1 2010/04/09 10:06:24 scarabeus Exp $ --> |
17 |
|
18 |
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
19 |
|
20 |
<guide link="/proj/en/desktop/x/x11/xorg-server-1.8-upgrade-guide.xml"> |
21 |
<title>Xorg-server 1.8 Upgrade Guide</title> |
22 |
|
23 |
<author title="Author"> |
24 |
<mail link="scarabeus"/> |
25 |
</author> |
26 |
|
27 |
<abstract> |
28 |
This guide shows you how to upgrade X.org server to version 1.8. |
29 |
</abstract> |
30 |
|
31 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
32 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
33 |
<license/> |
34 |
|
35 |
<version>1</version> |
36 |
<date>2010-04-09</date> |
37 |
|
38 |
<chapter> |
39 |
<title>Features changes</title> |
40 |
<section> |
41 |
<body> |
42 |
|
43 |
<!-- DELETE ME --> |
44 |
<warn> |
45 |
THIS GUIDE IS IN-PROGRESS. PLEASE NOTE THAT SOME SECTIONS MIGHT BE COMPLETELY |
46 |
DIFFERENT IN FINAL VERSION. |
47 |
</warn> |
48 |
|
49 |
<ul> |
50 |
<li> |
51 |
Xorg can detect input devices using udev, deprecating its HAL support. |
52 |
Users are strongly encouraged to migrate to Udev. |
53 |
</li> |
54 |
<li> |
55 |
Xorg's configuration is now much more flexible thanks to generic match |
56 |
options and multiple-file merging capabilities |
57 |
<path>/etc/X11/xorg.conf.d/</path>. |
58 |
</li> |
59 |
</ul> |
60 |
|
61 |
</body> |
62 |
</section> |
63 |
</chapter> |
64 |
|
65 |
<chapter> |
66 |
<title>Migrating to Udev hotplugging</title> |
67 |
<section> |
68 |
<title>Match rules usage</title> |
69 |
<body> |
70 |
|
71 |
<p> |
72 |
With the hal <c>.fdi</c> files gone most of us would not like to write |
73 |
the Udev rules. Xorg now supports similar functionality written into the |
74 |
<path>xorg.conf</path> or <path>xorg.conf.d</path> files. |
75 |
</p> |
76 |
|
77 |
<warn> |
78 |
Config is stored in <path>xorg.conf</path> or <path>xorg.conf.d</path> |
79 |
files but the detection is done by udev. So make sure you turn that useflag on. |
80 |
</warn> |
81 |
|
82 |
<p> |
83 |
New section called <c>InputClass</c> is introduced. They are quite similar |
84 |
to <c>InputDevice</c> sections but can match (configure) multiple devices. |
85 |
</p> |
86 |
|
87 |
<p> |
88 |
The InputClass work on match principle, where the following match rules |
89 |
are at your disposal (names are quite self-explaining): |
90 |
</p> |
91 |
|
92 |
<ul> |
93 |
<li>MatchProduct</li> |
94 |
<li>MatchVendor</li> |
95 |
<li>MatchDevicePath</li> |
96 |
<li>MatchIsKeyboard</li> |
97 |
<li>MatchIsPointer</li> |
98 |
<li>MatchIsJoystick</li> |
99 |
<li>MatchIsTablet</li> |
100 |
<li>MatchIsTouchpad</li> |
101 |
<li>MatchIsTouchscreen</li> |
102 |
</ul> |
103 |
|
104 |
<note> |
105 |
MatchDevicePath uses fnmatch(3) when available, so you can use a wildcard |
106 |
pattern: <c>Option "MatchDevicePath" /dev/input/event*</c> |
107 |
</note> |
108 |
|
109 |
</body> |
110 |
</section> |
111 |
|
112 |
<section> |
113 |
<title>Examples</title> |
114 |
<body> |
115 |
|
116 |
<pre caption="Configuring all touchpads to use synaptics driver"> |
117 |
Section "InputClass" |
118 |
Identifier "synaptics-all" |
119 |
Driver "synaptics" |
120 |
Option "RTCornerButton" "2" |
121 |
Option "HorizEdgeScroll" "true" |
122 |
|
123 |
MatchIsTouchpad "on" |
124 |
EndSection |
125 |
</pre> |
126 |
|
127 |
<pre caption="Configuring all keyboards to use specified config"> |
128 |
Section "InputClass" |
129 |
Identifier "keyboard-all" |
130 |
Driver "evdev" |
131 |
Option "XkbLayout" "us,cz" |
132 |
Option "XkbVariant" ",qwerty" |
133 |
Option "XkbOptions" "grp:alt_shift_toggle,grp:switch,compose:rwin,terminate:ctrl_alt_bksp" |
134 |
|
135 |
MatchIsKeyboard "on" |
136 |
EndSection |
137 |
</pre> |
138 |
|
139 |
<pre caption="Configuring all mice to use specified config"> |
140 |
Section "InputClass" |
141 |
Identifier "mouse-all" |
142 |
Driver "evdev" |
143 |
|
144 |
MatchIsPointer "on" |
145 |
EndSection |
146 |
</pre> |
147 |
|
148 |
</body> |
149 |
</section> |
150 |
|
151 |
<section> |
152 |
<title>Disabling hotplugging (no Udev or HAL)</title> |
153 |
<body> |
154 |
|
155 |
<p> |
156 |
If you don't want to use Udev or HAL, you can either build <c>xorg-server</c> |
157 |
with <c>USE="-udev -hal"</c>. You can alternatively turn AutoAddDevices option |
158 |
off in the ServerFlags section of your <path>xorg.conf</path> or in some file |
159 |
stored in <path>/etc/X11/xorg.conf.d/</path>. |
160 |
</p> |
161 |
|
162 |
<pre caption="Turning AutoAddDevices off"> |
163 |
Option "AutoAddDevices" "false" |
164 |
</pre> |
165 |
|
166 |
<p> |
167 |
Both options will allow the X server to use the legacy <c>mouse</c> and |
168 |
<c>kbd</c> drivers. |
169 |
</p> |
170 |
|
171 |
</body> |
172 |
</section> |
173 |
|
174 |
</chapter> |
175 |
|
176 |
<chapter> |
177 |
<title>Usage of xorg.conf.d</title> |
178 |
<section> |
179 |
<title>Separating xorg.conf apart</title> |
180 |
<body> |
181 |
|
182 |
<p> |
183 |
The <path>xorg.conf.d</path> is additional folder where user can store his |
184 |
adjustments for the <path>xorg.conf</path> without need of touching the |
185 |
<path>xorg.conf</path> itself. |
186 |
</p> |
187 |
|
188 |
<p> |
189 |
The order of inheritance is quite simple. The <path>xorg.conf</path> (if |
190 |
exists) is loaded, then the <path>xorg.conf.d/**.conf</path> files are |
191 |
parsed as well. |
192 |
</p> |
193 |
|
194 |
<pre caption="example folder listing for xorg.conf.d"> |
195 |
scarab@ugly-elf: /etc/X11/xorg.conf.d $ ls |
196 |
50-ati.conf 96-synaptics.conf 97-evdev.conf |
197 |
</pre> |
198 |
|
199 |
<pre caption="example content of 96-synaptics.conf"> |
200 |
Section "InputDevice" |
201 |
Identifier "touchpad" |
202 |
Driver "synaptics" |
203 |
Option "AutoServerLayout" "on" |
204 |
EndSection |
205 |
</pre> |
206 |
|
207 |
<p> |
208 |
As you can see the code is same as for xorg.conf itself. Only one addition |
209 |
is the <c>"AutoServerLayout" option</c>. With this option enabled the device |
210 |
does not need to be refferenced in <c>ServerLayout section</c>. |
211 |
</p> |
212 |
|
213 |
<note> |
214 |
The InputClass section is automaticaly using the AutoServerLayout option so |
215 |
you don't have to specify it in there. |
216 |
</note> |
217 |
|
218 |
</body> |
219 |
</section> |
220 |
</chapter> |
221 |
|
222 |
<chapter> |
223 |
<title>Known Quirks</title> |
224 |
|
225 |
<section> |
226 |
<title>Lenovo HDAPS sensor</title> |
227 |
<body> |
228 |
|
229 |
<p> |
230 |
For more info see <uri |
231 |
link="http://bugs.freedesktop.org/show_bug.cgi?id=22442">upstream bug</uri>. |
232 |
</p> |
233 |
|
234 |
<pre caption="Disabling HDAPS accelerometer driver"> |
235 |
Section "InputClass" |
236 |
Identifier "ThinkPad HDAPS blacklist" |
237 |
MatchProduct "ThinkPad HDAPS accelerometer data" |
238 |
Option "Ignore" "on" |
239 |
EndSection |
240 |
</pre> |
241 |
|
242 |
</body> |
243 |
</section> |
244 |
|
245 |
</chapter> |
246 |
|
247 |
</guide> |