/[gentoo]/xml/htdocs/doc/en/xorg-config.xml
Gentoo

Diff of /xml/htdocs/doc/en/xorg-config.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.34 Revision 1.38
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.38 2010/05/23 21:29:35 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">
9 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 9 <mail link="swift"/>
10</author> 10</author>
11<author title="Author"> 11<author title="Author">
12 <mail link="nightmorph"/> 12 <mail link="nightmorph"/>
13</author> 13</author>
14 14
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.28</version>
26<date>2009-12-16</date> 26<date>2010-05-23</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>
217Now it's time to start the Hardware Abstraction Layer (HAL) daemon and set it to
218automatically start each time you boot. This is necessary to get a working X
219environment, otherwise your input devices won't be detected and you'll probably
220just get a blank screen. We'll cover HAL more in the <uri
221link="#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>
227Recent X server versions are designed to work out-of-the-box, with no need to 240Recent X server versions are designed to work out-of-the-box, with no need to
228manually configure Xorg's configuration files. 241manually edit Xorg's configuration files.
229</p> 242</p>
230 243
231<p> 244<p>
232You should first try <uri link="#using_startx">starting X</uri> without creating 245You 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>.
271There are several other HAL policies in <path>/usr/share/hal/fdi/</path> that 284There are several other HAL policies in <path>/usr/share/hal/fdi/</path> that
272may interest you, such as laptop configurations, storage device handling, power 285may interest you, such as laptop configurations, storage device handling, power
273management, and more. Just copy any of the policies to 286management, 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>
291Remember, <e>every</e> time you finish making changes to HAL policy files, you
292need to restart the HAL daemon by running <c>/etc/init.d/hald restart</c>.
293</impo>
276 294
277<p> 295<p>
278You can edit the policy files in <path>/etc/hal/fdi/policy</path> to your 296You can edit the policy files in <path>/etc/hal/fdi/policy</path> to your
279liking. You may want to make a few tweaks or to expose additional 297liking. You may want to make a few tweaks or to expose additional
280functionality. Let's go through an example of tweaking a HAL policy. 298functionality. Let's go through an example of tweaking a HAL policy.
308 &lt;/match&gt; 326 &lt;/match&gt;
309 &lt;/match&gt; 327 &lt;/match&gt;
310</pre> 328</pre>
311 329
312<p> 330<p>
331Once you're done, run <c>/etc/init.d/hald restart</c> so that HAL picks up your
332changes.
333</p>
334
335<p>
313There, now you have a handy way of killing an unresponsive X server. This is 336There, now you have a handy way of killing an unresponsive X server. This is
314useful when programs have frozen your display entirely, or when configuring and 337useful when programs have frozen your display entirely, or when configuring and
315tweaking your Xorg environment. Be careful when killing your desktop with this 338tweaking your Xorg environment. Be careful when killing your desktop with this
316key combination -- most programs really don't like it when you end them this 339key combination -- most programs really don't like it when you end them this
317way, and you may lose some (or all) of what you were working on. 340way, and you may lose some (or all) of what you were working on.
373will have told you that it has written <path>/root/xorg.conf.new</path> ready 396will have told you that it has written <path>/root/xorg.conf.new</path> ready
374for you to test. So let's test. :) 397for you to test. So let's test. :)
375</p> 398</p>
376 399
377<pre caption="Testing the xorg.conf.new file"> 400<pre caption="Testing the xorg.conf.new file">
378# <i>X -config /root/xorg.conf.new</i> 401# <i>X -config -retro /root/xorg.conf.new</i>
379</pre> 402</pre>
380 403
381<p> 404<p>
382If all goes well, you should see a simple black and white pattern. Verify if 405If all goes well, you should see a simple black and white pattern. Verify if
383your mouse works correctly and if the resolution is good. You might not be able 406your mouse works correctly and if the resolution is good. You might not be able
426 <path>/etc/env.d/90xsession</path> to make it a default for all the users on 449 <path>/etc/env.d/90xsession</path> to make it a default for all the users on
427 the system. For example, as root, run <c>echo XSESSION="Xfce4" > 450 the system. For example, as root, run <c>echo XSESSION="Xfce4" >
428 /etc/env.d/90xsession</c>. This will create the <path>90xsession</path> file 451 /etc/env.d/90xsession</c>. This will create the <path>90xsession</path> file
429 and set the default X session to Xfce4. 452 and set the default X session to Xfce4.
430 </li> 453 </li>
431 <li>
432 If all of the above fail, it will fall back to a simple window manager,
433 usually <c>twm</c>.
434 </li>
435</ul> 454</ul>
436 455
437<pre caption="Starting X"> 456<pre caption="Starting X">
438# <i>startx</i> 457$ <i>startx</i>
439</pre> 458</pre>
440 459
441<p> 460<p>
442You can kill the X session using the Ctrl-Alt-Backspace combination. This will 461You can kill the X session by using the Ctrl-Alt-Backspace combination. This
443however make X exit disgracefully -- something that you might not always want. 462will, however, make X exit disgracefully -- something that you might not always
463want.
464</p>
465
466<p>
467If you haven't yet installed a window manager, all you'll see is a black screen.
468Since this can also be a sign that something's wrong, you may want to emerge
469<c>twm</c> and <c>xterm</c> <e>only to test X</e>.
470</p>
471
472<p>
473Once those two programs are installed, run <c>startx</c> again. A few xterm
474windows should appear, making it easier to verify that X is working correctly.
475Once you're satisfied with the results, run <c>emerge --unmerge twm xterm</c> as
476root to get rid of the testing packages. You won't need them once you've setup a
477proper desktop environment.
444</p> 478</p>
445 479
446</body> 480</body>
447</section> 481</section>
448</chapter> 482</chapter>
498 EndSubSection 532 EndSubSection
499EndSection 533EndSection
500</pre> 534</pre>
501 535
502<p> 536<p>
503Run X (<c>startx</c>) to discover it uses the resolution you want. :) 537Run X (<c>startx</c>) to discover it uses the resolution you want.
504</p> 538</p>
505 539
506</body> 540</body>
507</section> 541</section>
508<section> 542<section>
514<path>/usr/share/doc/hal-*/*/use-estonian-layout.fdi.bz2</path> to 548<path>/usr/share/doc/hal-*/*/use-estonian-layout.fdi.bz2</path> to
515<path>/etc/hal/fdi/policy/10-xinput-configuration.fdi</path>: 549<path>/etc/hal/fdi/policy/10-xinput-configuration.fdi</path>:
516</p> 550</p>
517 551
518<pre caption="Using an existing config file"> 552<pre caption="Using an existing config file">
519# <i>bzcat /usr/share/doc/hal-*/*/use-estonian-layout.fdi > /etc/hal/fdi/policy/10-xinput-configuration.fdi</i> 553# <i>bzcat /usr/share/doc/hal-*/*/use-estonian-layout.fdi.bz2 > /etc/hal/fdi/policy/10-xinput-configuration.fdi</i>
520</pre> 554</pre>
521 555
522<p> 556<p>
523Now you can just edit <path>10-xinput-configuration.fdi</path> and change the 557Now you can just edit <path>10-xinput-configuration.fdi</path> and change the
524Estonian keyboard layout (<c>ee</c>) to your own, such as Great Britain 558Estonian keyboard layout (<c>ee</c>) to your own, such as Great Britain

Legend:
Removed from v.1.34  
changed lines
  Added in v.1.38

  ViewVC Help
Powered by ViewVC 1.1.20