| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
2 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.34 2009/12/17 04:41:24 nightmorph Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.35 2009/12/31 01:37:01 nightmorph Exp $ --> |
| 4 | |
4 | |
| 5 | <guide> |
5 | <guide> |
| 6 | <title>The X Server Configuration HOWTO</title> |
6 | <title>The X Server Configuration HOWTO</title> |
| 7 | |
7 | |
| 8 | <author title="Author"> |
8 | <author title="Author"> |
| … | |
… | |
| 20 | |
20 | |
| 21 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
21 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 22 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
22 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 23 | <license/> |
23 | <license/> |
| 24 | |
24 | |
| 25 | <version>1.24</version> |
25 | <version>1.25</version> |
| 26 | <date>2009-12-16</date> |
26 | <date>2009-12-30</date> |
| 27 | |
27 | |
| 28 | <chapter> |
28 | <chapter> |
| 29 | <title>What is the X Window Server?</title> |
29 | <title>What is the X Window Server?</title> |
| 30 | <section> |
30 | <section> |
| 31 | <title>Graphical vs Command-Line</title> |
31 | <title>Graphical vs Command-Line</title> |
| … | |
… | |
| 211 | <pre caption="Re-initialising the environment variables"> |
211 | <pre caption="Re-initialising the environment variables"> |
| 212 | # <i>env-update</i> |
212 | # <i>env-update</i> |
| 213 | # <i>source /etc/profile</i> |
213 | # <i>source /etc/profile</i> |
| 214 | </pre> |
214 | </pre> |
| 215 | |
215 | |
|
|
216 | <p> |
|
|
217 | Now it's time to start the Hardware Abstraction Layer (HAL) daemon and set it to |
|
|
218 | automatically start each time you boot. This is necessary to get a working X |
|
|
219 | environment, otherwise your input devices won't be detected and you'll probably |
|
|
220 | just get a blank screen. We'll cover HAL more in the <uri |
|
|
221 | link="#using_hal">next section</uri>. |
|
|
222 | </p> |
|
|
223 | |
|
|
224 | <pre caption="Starting HAL"> |
|
|
225 | # <i>/etc/init.d/hald start</i> |
|
|
226 | # <i>rc-update add hald default</i> |
|
|
227 | </pre> |
|
|
228 | |
| 216 | </body> |
229 | </body> |
| 217 | </section> |
230 | </section> |
| 218 | </chapter> |
231 | </chapter> |
| 219 | |
232 | |
| 220 | <chapter> |
233 | <chapter> |
| 221 | <title>Configuring Xorg</title> |
234 | <title>Configuring Xorg</title> |
| 222 | <section> |
235 | <section id="using_hal"> |
| 223 | <title>Using HAL</title> |
236 | <title>Using HAL</title> |
| 224 | <body> |
237 | <body> |
| 225 | |
238 | |
| 226 | <p> |
239 | <p> |
| 227 | Recent X server versions are designed to work out-of-the-box, with no need to |
240 | Recent X server versions are designed to work out-of-the-box, with no need to |
| 228 | manually configure Xorg's configuration files. |
241 | manually edit Xorg's configuration files. |
| 229 | </p> |
242 | </p> |
| 230 | |
243 | |
| 231 | <p> |
244 | <p> |
| 232 | You should first try <uri link="#using_startx">starting X</uri> without creating |
245 | You should first try <uri link="#using_startx">starting X</uri> without creating |
| 233 | <path>/etc/X11/xorg.conf</path>. |
246 | <path>/etc/X11/xorg.conf</path>. |
| … | |
… | |
| 271 | There are several other HAL policies in <path>/usr/share/hal/fdi/</path> that |
284 | There are several other HAL policies in <path>/usr/share/hal/fdi/</path> that |
| 272 | may interest you, such as laptop configurations, storage device handling, power |
285 | may interest you, such as laptop configurations, storage device handling, power |
| 273 | management, and more. Just copy any of the policies to |
286 | management, and more. Just copy any of the policies to |
| 274 | <path>/etc/hal/fdi/policy/</path>. |
287 | <path>/etc/hal/fdi/policy/</path>. |
| 275 | </p> |
288 | </p> |
|
|
289 | |
|
|
290 | <impo> |
|
|
291 | Remember, <e>every</e> time you finish making changes to HAL policy files, you |
|
|
292 | need to restart the HAL daemon by running <c>/etc/init.d/hald restart</c>. |
|
|
293 | </impo> |
| 276 | |
294 | |
| 277 | <p> |
295 | <p> |
| 278 | You can edit the policy files in <path>/etc/hal/fdi/policy</path> to your |
296 | You can edit the policy files in <path>/etc/hal/fdi/policy</path> to your |
| 279 | liking. You may want to make a few tweaks or to expose additional |
297 | liking. You may want to make a few tweaks or to expose additional |
| 280 | functionality. Let's go through an example of tweaking a HAL policy. |
298 | functionality. Let's go through an example of tweaking a HAL policy. |
| … | |
… | |
| 306 | string="Linux"> |
324 | string="Linux"> |
| 307 | <merge key="input.x11_driver" type="string">evdev<merge> |
325 | <merge key="input.x11_driver" type="string">evdev<merge> |
| 308 | </match> |
326 | </match> |
| 309 | </match> |
327 | </match> |
| 310 | </pre> |
328 | </pre> |
|
|
329 | |
|
|
330 | <p> |
|
|
331 | Once you're done, run <c>/etc/init.d/hald restart</c> so that HAL picks up your |
|
|
332 | changes. |
|
|
333 | </p> |
| 311 | |
334 | |
| 312 | <p> |
335 | <p> |
| 313 | There, now you have a handy way of killing an unresponsive X server. This is |
336 | There, now you have a handy way of killing an unresponsive X server. This is |
| 314 | useful when programs have frozen your display entirely, or when configuring and |
337 | useful when programs have frozen your display entirely, or when configuring and |
| 315 | tweaking your Xorg environment. Be careful when killing your desktop with this |
338 | tweaking your Xorg environment. Be careful when killing your desktop with this |