| 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.33 2009/12/17 04:37:10 nightmorph Exp $ --> |
3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.34 2009/12/17 04:41:24 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@gentoo.org">Sven Vermeulen</mail> |
| 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 | |
| 15 | <abstract> |
15 | <abstract> |
| 16 | Xorg is the X Window server which allows users to have a graphical |
16 | Xorg is the X Window server which allows users to have a graphical |
| 17 | environment at their fingertips. This HOWTO explains what Xorg is, how to |
17 | environment at their fingertips. This HOWTO explains what Xorg is, how to |
| 18 | install it and what the various configuration options are. |
18 | install it and what the various configuration options are. |
| 19 | </abstract> |
19 | </abstract> |
| 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.23</version> |
25 | <version>1.24</version> |
| 26 | <date>2009-12-08</date> |
26 | <date>2009-12-16</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> |
| 32 | <body> |
32 | <body> |
| 33 | |
33 | |
| 34 | <p> |
34 | <p> |
| 35 | The average user may be frightened at the thought of having to type in commands. |
35 | The average user may be frightened at the thought of having to type in commands. |
| 36 | Why wouldn't he be able to point and click his way through the freedom provided |
36 | Why wouldn't he be able to point and click his way through the freedom provided |
| 37 | by Gentoo (and Linux in general)? Well, *big smile*, of course you are able to |
37 | by Gentoo (and Linux in general)? Well, *big smile*, of course you are able to |
| 38 | do this. :-) Linux offers a wide variety of flashy user interfaces and |
38 | do this. :-) Linux offers a wide variety of flashy user interfaces and |
| 39 | environments which you can install on top of your existing installation. |
39 | environments which you can install on top of your existing installation. |
| 40 | </p> |
40 | </p> |
| 41 | |
41 | |
| … | |
… | |
| 427 | the system. For example, as root, run <c>echo XSESSION="Xfce4" > |
427 | 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 |
428 | /etc/env.d/90xsession</c>. This will create the <path>90xsession</path> file |
| 429 | and set the default X session to Xfce4. |
429 | and set the default X session to Xfce4. |
| 430 | </li> |
430 | </li> |
| 431 | <li> |
431 | <li> |
| 432 | If all of the above fail, it will fall back to a simple window manager, |
432 | If all of the above fail, it will fall back to a simple window manager, |
| 433 | usually <c>twm</c>. |
433 | usually <c>twm</c>. |
| 434 | </li> |
434 | </li> |
| 435 | </ul> |
435 | </ul> |
| 436 | |
436 | |
| 437 | <pre caption="Starting X"> |
437 | <pre caption="Starting X"> |
| 438 | # <i>startx</i> |
438 | # <i>startx</i> |
| 439 | </pre> |
439 | </pre> |
| 440 | |
440 | |
| 441 | <p> |
441 | <p> |
| 442 | If you see an ugly, loathsome, repulsive, deformed window manager, that's |
442 | You can kill the X session using the Ctrl-Alt-Backspace combination. This will |
| 443 | <c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the |
443 | however make X exit disgracefully -- something that you might not always want. |
| 444 | upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace |
|
|
| 445 | combination. This will however make X exit disgracefully -- something that you |
|
|
| 446 | might not always want. |
|
|
| 447 | </p> |
444 | </p> |
| 448 | |
445 | |
| 449 | </body> |
446 | </body> |
| 450 | </section> |
447 | </section> |
| 451 | </chapter> |
448 | </chapter> |
| 452 | |
449 | |
| 453 | <chapter> |
450 | <chapter> |
| 454 | <title>Tweaking X settings</title> |
451 | <title>Tweaking X settings</title> |
| 455 | <section> |
452 | <section> |
| 456 | <title>Setting your Resolution</title> |
453 | <title>Setting your Resolution</title> |
| 457 | <body> |
454 | <body> |
| 458 | |
455 | |
| 459 | <p> |
456 | <p> |
| 460 | If you feel that the screen resolution is wrong, you will need to check two |
457 | If you feel that the screen resolution is wrong, you will need to check two |
| 461 | sections in your <path>xorg.conf</path> configuration. First of all, you have |
458 | sections in your <path>xorg.conf</path> configuration. First of all, you have |
| … | |
… | |
| 529 | </p> |
526 | </p> |
| 530 | |
527 | |
| 531 | <p> |
528 | <p> |
| 532 | When you're finished, run <c>/etc/init.d/hald restart</c> as root to make sure |
529 | When you're finished, run <c>/etc/init.d/hald restart</c> as root to make sure |
| 533 | that HAL picks up your configuration file changes. |
530 | that HAL picks up your configuration file changes. |
| 534 | </p> |
531 | </p> |
| 535 | |
532 | |
| 536 | </body> |
533 | </body> |
| 537 | </section> |
534 | </section> |
| 538 | <section> |
535 | <section> |
| 539 | <title>Finishing up</title> |
536 | <title>Finishing up</title> |
| 540 | <body> |
537 | <body> |
| 541 | |
538 | |
| 542 | <p> |
539 | <p> |
| 543 | Run <c>startx</c> and be happy about the result. Congratulations, you now |
540 | Run <c>startx</c> and be happy about the result. Congratulations, you now |
| 544 | (hopefully) have a working Xorg on your system. The next step is to remove this |
541 | (hopefully) have a working Xorg on your system. The next step is to install a |
| 545 | ugly lightweight window manager (twm) and use a high-feature one (or even a |
542 | useful window manager (or even a desktop environment) such as KDE or GNOME, but |
| 546 | desktop environment) such as KDE or GNOME, but that's not part of this guide. |
543 | that's not part of this guide. |
| 547 | </p> |
544 | </p> |
| 548 | |
545 | |
| 549 | </body> |
546 | </body> |
| 550 | </section> |
547 | </section> |
| 551 | </chapter> |
548 | </chapter> |
| 552 | |
549 | |
| 553 | <chapter> |
550 | <chapter> |
| 554 | <title>Resources</title> |
551 | <title>Resources</title> |
| 555 | <section> |
552 | <section> |
| 556 | <title>Creating and Tweaking xorg.conf</title> |
553 | <title>Creating and Tweaking xorg.conf</title> |
| 557 | <body> |
554 | <body> |
| 558 | |
555 | |
| 559 | <p> |
556 | <p> |
| 560 | First of all, <c>man xorg.conf</c> and <c>man evdev</c> provide quick yet |
557 | First of all, <c>man xorg.conf</c> and <c>man evdev</c> provide quick yet |
| 561 | complete references about the syntax used by these configuration files. Be sure |
558 | complete references about the syntax used by these configuration files. Be sure |