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