/[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.26 Revision 1.28
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.26 2008/05/23 19:40:35 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.28 2009/01/26 08:08:22 nightmorph Exp $ -->
4 4
5<guide link="/doc/en/xorg-config.xml"> 5<guide link="/doc/en/xorg-config.xml">
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>
11<author title="Editor">
12 <mail link="nightmorph"/>
10</author> 13</author>
11 14
12<abstract> 15<abstract>
13Xorg is the X Window server which allows users to have a graphical 16Xorg is the X Window server which allows users to have a graphical
14environment at their fingertips. This HOWTO explains what Xorg is, how to 17environment at their fingertips. This HOWTO explains what Xorg is, how to
17 20
18<!-- 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 -->
19<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 22<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
20<license/> 23<license/>
21 24
22<version>1.17</version> 25<version>1.19</version>
23<date>2007-06-20</date> 26<date>2009-01-26</date>
24 27
25<chapter> 28<chapter>
26<title>What is the X Window Server?</title> 29<title>What is the X Window Server?</title>
27<section> 30<section>
28<title>Graphical vs Command-Line</title> 31<title>Graphical vs Command-Line</title>
83</chapter> 86</chapter>
84 87
85<chapter> 88<chapter>
86<title>Installing Xorg</title> 89<title>Installing Xorg</title>
87<section> 90<section>
88<title>Using emerge</title>
89<body> 91<body>
90
91<p>
92Enough chitchat, let's get to business shall we? To install Xorg, you just
93need to run <c>emerge xorg-x11</c>. Installing Xorg does take a while
94though, so you might want to grab a snack while you are waiting.
95</p>
96 92
97<p> 93<p>
98Before installing Xorg you have to configure two important variables in the 94Before installing Xorg you have to configure two important variables in the
99<path>/etc/make.conf</path> file. 95<path>/etc/make.conf</path> file.
100</p> 96</p>
104you intend to use and is usually based on the kind and brand of card you have. 100you intend to use and is usually based on the kind and brand of card you have.
105The most common settings are <c>nvidia</c> for Nvidia cards or <c>fglrx</c> for 101The most common settings are <c>nvidia</c> for Nvidia cards or <c>fglrx</c> for
106ATI Radeon cards. Those are the proprietary drivers from Nvidia and ATI 102ATI Radeon cards. Those are the proprietary drivers from Nvidia and ATI
107respectively. If you would like to use the open source versions, use <c>nv</c> 103respectively. If you would like to use the open source versions, use <c>nv</c>
108rather than <c>nvidia</c> in the variable, but bear in mind that using this 104rather than <c>nvidia</c> in the variable, but bear in mind that using this
109driver means no 3d acceleration at all. The free <c>radeon</c> driver for ATI 105driver means no 3D acceleration at all. The free <c>radeon</c> and
110cards supports full 3D acceleration on older Radeons but doesn't work at all 106<c>radeonhd</c> drivers for ATI cards support 3D acceleration on older Radeons
111with the newer ones. <c>VIDEO_CARDS</c> may contain more than one driver, in 107but don't yet support all the features of the newer ones. <c>VIDEO_CARDS</c> may
112this case list of them should be separated with spaces. 108contain more than one driver, in this case list of them should be separated with
109spaces.
113</p> 110</p>
114 111
115<p> 112<p>
116The second variable is <c>INPUT_DEVICES</c> and is used to determine which 113The second variable is <c>INPUT_DEVICES</c> and is used to determine which
117drivers are to be built for input devices. In most cases setting it to 114drivers are to be built for input devices. In most cases setting it to
118<c>keyboard mouse</c> should work just fine. 115<c>keyboard mouse</c> should work just fine. If you use alternative input
116devices, such as a Synaptics touchpad for a laptop, be sure to add it to
117<c>INPUT_DEVICES</c>.
119</p> 118</p>
120 119
121<p> 120<p>
122Now you should decide which drivers you will use and add necessary settings to 121Now you should decide which drivers you will use and add necessary settings to
123the <path>/etc/make.conf</path> file: 122the <path>/etc/make.conf</path> file:
131<comment>(OR, for ATI Radeon cards)</comment> 130<comment>(OR, for ATI Radeon cards)</comment>
132VIDEO_CARDS="fglrx" 131VIDEO_CARDS="fglrx"
133</pre> 132</pre>
134 133
135<p> 134<p>
136More instructions on how to configure Nvidia and ATI cards can be found in 135More instructions on how to configure nVidia and ATI cards can be found in
137<uri link="/doc/en/nvidia-guide.xml">Gentoo Linux nVidia Guide</uri> and in 136<uri link="/doc/en/nvidia-guide.xml">Gentoo Linux nVidia Guide</uri> and in
138<uri link="/doc/en/ati-faq.xml">Gentoo Linux ATI FAQ</uri>. If you don't know 137<uri link="/doc/en/ati-faq.xml">Gentoo Linux ATI FAQ</uri>. If you don't know
139which drivers you should choose, refer to these guides for more information. 138which drivers you should choose, refer to these guides for more information.
140</p> 139</p>
141 140
479<section> 478<section>
480<title>Creating and Tweaking xorg.conf</title> 479<title>Creating and Tweaking xorg.conf</title>
481<body> 480<body>
482 481
483<p> 482<p>
484First of all, <c>man 5 xorg.conf</c> provides a quick yet complete reference 483First of all, <c>man xorg.conf</c> provides a quick yet complete reference
485about the syntaxis used by the configuration file. Be sure to have it open on a 484about the syntax used by the configuration file. Be sure to have it open on a
486terminal near you when you edit your configuration file! 485terminal near you when you edit your configuration file!
487</p> 486</p>
488 487
489<p> 488<p>
490A second point of resources on your system is the 489Also, be sure to look at <path>/etc/X11/xorg.conf.example</path>; you may wish
491<path>/usr/X11R6/lib/X11/doc</path> directory with various <path>README</path>s 490to copy this and use it as a foundation for writing your own
492for individual graphical chipsets. 491<path>xorg.conf</path>.
492</p>
493
494<p>
495You may find the X.org <uri link="http://www.x.org/wiki/FAQ">FAQ</uri> provided
496on their website, in addition to their other documentation.
493</p> 497</p>
494 498
495<p> 499<p>
496There are also many online resources on editing <path>xorg.conf</path>. We only 500There are also many online resources on editing <path>xorg.conf</path>. We only
497list few of them here, be sure to <uri link="http://www.google.com">Google</uri> 501list few of them here, be sure to <uri link="http://www.google.com">Google</uri>
518<section> 522<section>
519<title>Other resources</title> 523<title>Other resources</title>
520<body> 524<body>
521 525
522<p> 526<p>
523If you want to update your system from the old monolithic Xorg to the newer, 527More information about installing and configuring various graphical desktop
524modular Xorg 7, you should refer to the <uri 528environments and applications can be found in the <uri
525link="/proj/en/desktop/x/x11/modular-x-howto.xml">Migrating to Modular X 529link="/doc/en/?catid=desktop">Gentoo Desktop Documentation Resources</uri>
526HOWTO</uri>. 530section of our documentation.
527</p>
528
529<p>
530More information about configuring different packages to work in X environment
531can be found in the <uri link="/doc/en/?catid=desktop">Gentoo Desktop
532Documentation Resources</uri> section of our documentation.
533</p> 531</p>
534 532
535</body> 533</body>
536</section> 534</section>
537</chapter> 535</chapter>

Legend:
Removed from v.1.26  
changed lines
  Added in v.1.28

  ViewVC Help
Powered by ViewVC 1.1.20