/[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.17 Revision 1.18
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2 2
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.17 2005/09/09 06:01:15 fox2mike Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.18 2006/07/13 04:29:16 rane Exp $ -->
4 4
5<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 5<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
6 6
7<guide link="/doc/en/xorg-config.xml"> 7<guide link="/doc/en/xorg-config.xml">
8 8
9<title>The X Server Configuration HOWTO</title> 9<title>The X Server Configuration HOWTO</title>
10 10
11<author title="Author"> 11<author title="Author">
12 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 12 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
13</author> 13</author>
14 14
15<abstract> 15<abstract>
16Xorg 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
17environment at their fingertips. This HOWTO explains what Xorg is, how to 17environment at their fingertips. This HOWTO explains what Xorg is, how to
18install it and what the various configuration options are. 18install 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.13</version> 25<version>1.14</version>
26<date>2005-09-09</date> 26<date>2006-07-13</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>
35The average user may be frightened at the thought of having to type in commands. 35The average user may be frightened at the thought of having to type in commands.
36Why wouldn't he be able to point and click his way through the freedom provided 36Why wouldn't he be able to point and click his way through the freedom provided
37by Gentoo (and Linux in general)? Well, *big smile*, of course you are able to 37by Gentoo (and Linux in general)? Well, *big smile*, of course you are able to
38do this :-) Linux offers a wide variety of flashy user interfaces and 38do this :-) Linux offers a wide variety of flashy user interfaces and
39environments which you can install on top of your existing installation. 39environments which you can install on top of your existing installation.
40</p> 40</p>
41 41
85</section> 85</section>
86</chapter> 86</chapter>
87 87
88<chapter> 88<chapter>
89<title>Installing Xorg</title> 89<title>Installing Xorg</title>
90<section> 90<section>
91<title>Using emerge</title> 91<title>Using emerge</title>
92<body> 92<body>
93 93
94<p> 94<p>
95Enough chitchat, let's get to business shall we? To install Xorg, you just 95Enough chitchat, let's get to business shall we? To install Xorg, you just
96need to run <c>emerge xorg-x11</c>. Installing Xorg does take a while 96need to run <c>emerge xorg-x11</c>. Installing Xorg does take a while
97though, so you might want to grab a snack while you are waiting. 97though, so you might want to grab a snack while you are waiting.
98</p> 98</p>
99 99
100<p>
101Before installing Xorg you have to configure two important variables in the
102<path>/etc/make.conf</path> file.
103</p>
104
105<p>
106The first one is <c>VIDEO_CARDS</c>. This is used to set the video drivers that
107you intend to use and is usually based on the kind and brand of card you have.
108The most common settings are <c>nvidia</c> for Nvidia cards or <c>fglrx</c> for
109ATI Radeon cards. Those are the proprietary drivers from Nvidia and ATI
110respectively. If you would like to use the open source versions, use <c>nv</c>
111rather than <c>nvidia</c> in the variable, but bear in mind that using this
112driver means no 3d acceleration at all. Use <c>radeon</c> in case you have an
113ATI card for the same. <c>VIDEO_CARDS</c> may contain more than one driver, in
114this case list of them should be separated with spaces.
115</p>
116
117<p>
118The second variable is <c>INPUT_DEVICES</c> and is used to determine which
119drivers are to be built for input devices. In most cases setting it to
120<c>keyboard mouse</c> should work just fine.
121</p>
122
123<p>
124Now you should decide which drivers you will use and add necessary settings to
125the <path>/etc/make.conf</path> file:
126</p>
127
128<pre caption="Sample make.conf entries">
129<comment>(For mouse and keyboard support)</comment>
130INPUT_DEVICES="keyboard mouse"
131<comment>(For Nvidia cards)</comment>
132VIDEO_CARDS="nvidia"
133<comment>(OR, for ATI Radeon cards)</comment>
134VIDEO_CARDS="fglrx"
135</pre>
136
137<p>
138More instructions on how to configure Nvidia and ATI cards can be found in
139<uri link="/doc/en/nvidia-guide.xml">Gentoo Linux nVidia Guide</uri> and in
140<uri link="/doc/en/ati-faq.xml">Gentoo Linux ATI FAQ</uri>. If you don't know
141which drivers you should choose, refer to these guides for more information.
142</p>
143
144<note>
145If the suggested settings don't work for you, you should run <c>emerge -pv
146xorg-x11</c>, check all the options available and choose those which
147apply to your system. In different versions of Xorg and on different
148architectures displaying these variables can be done with <c>emerge -pv
149xorg-server</c> command rather than the one above. The example is for x86
150architecture and xorg-x11-7.0.
151</note>
152
153<pre caption="Displaying all the driver options available">
154# <i>emerge -pv xorg-x11</i>
155
156These are the packages that would be merged, in order:
157
158Calculating dependencies... done!
159[ebuild R ] x11-base/xorg-x11-7.0-r1 USE="-3dfx" INPUT_DEVICES="keyboard
160mouse -acecad -aiptek -calcomp -citron -digitaledge -dmc -dynapro -elo2300
161-elographics -evdev -fpit -hyperpen -jamstudio -joystick -magellan -magictouch
162-microtouch -mutouch -palmax -penmount -spaceorb -summa -synaptics -tek4957
163-ur98 -vmmouse -void -wacom" VIDEO_CARDS="nvidia -apm -ark -chips -cirrus
164-cyrix -dummy -fbdev -fglrx -glint -i128 -i740 -i810 -imstt -mach64 -mga
165-neomagic -nsc -nv -r128 -radeon -rendition -s3 -s3virge -savage -siliconmotion
166-sis -sisusb -tdfx -tga -trident -tseng -v4l -vesa -vga -via -vmware -voodoo" 0
167kB
168</pre>
169
170<p>
171After setting all the necessary variables you can install the Xorg package.
172</p>
173
100<pre caption="Installing Xorg"> 174<pre caption="Installing Xorg">
101# <i>emerge xorg-x11</i> 175# <i>emerge xorg-x11</i>
102</pre> 176</pre>
103 177
104<p> 178<p>
105When the installation is finished, you might need to reinitialise some 179When the installation is finished, you might need to re-initialise some
106environment variables before you continue. Just run <c>env-update</c> followed 180environment variables before you continue. Just run <c>env-update</c> followed
107by <c>source /etc/profile</c> and you're all set. This doesn't harm your system 181by <c>source /etc/profile</c> and you're all set.
108in any way.
109</p> 182</p>
110 183
111<pre caption="Reinitialising the environment variables"> 184<pre caption="Re-initialising the environment variables">
112# <i>env-update</i> 185# <i>env-update</i>
113# <i>source /etc/profile</i> 186# <i>source /etc/profile</i>
114</pre> 187</pre>
115 188
116</body> 189</body>
117</section> 190</section>
118</chapter> 191</chapter>
119<chapter> 192<chapter>
120<title>Configuring Xorg</title> 193<title>Configuring Xorg</title>
121<section> 194<section>
122<title>The xorg.conf File</title> 195<title>The xorg.conf File</title>
123<body> 196<body>
124 197
125<p> 198<p>
126The configuration file of Xorg is called <path>xorg.conf</path> and it 199The configuration file of Xorg is called <path>xorg.conf</path> and it
431 504
432<ul> 505<ul>
433 <li> 506 <li>
434 <uri link="http://tldp.org/HOWTO/XFree-Local-multi-user-HOWTO/">The XFree 507 <uri link="http://tldp.org/HOWTO/XFree-Local-multi-user-HOWTO/">The XFree
435 Local Multi-User HOWTO</uri> 508 Local Multi-User HOWTO</uri>
436 </li> 509 </li>
437 <li> 510 <li>
438 <uri 511 <uri
439 link="http://www-106.ibm.com/developerworks/edu/os-dw-linuxxwin-i.html">An 512 link="http://www-106.ibm.com/developerworks/edu/os-dw-linuxxwin-i.html">An
440 Introduction to XFree 4.x</uri> by Chris Houser 513 Introduction to XFree 4.x</uri> by Chris Houser
441 </li> 514 </li>
442</ul> 515</ul>
443 516
444</body> 517</body>
445</section> 518</section>
519<section>
520<title>Other resources</title>
521<body>
522
523<p>
524If you want to update your system from the old monolithic Xorg to the newer,
525modular Xorg 7, you should refer to the <uri
526link="/proj/en/desktop/x/x11/modular-x-howto.xml">Migrating to Modular X
527HOWTO</uri>.
528</p>
529
530<p>
531More information about configuring different packages to work in X environment
532can be found in the <uri link="/doc/en/?catid=desktop">Gentoo Desktop
533Documentation Resources</uri> section of our documentation.
534</p>
535
536</body>
537</section>
446</chapter> 538</chapter>
447</guide> 539</guide>

Legend:
Removed from v.1.17  
changed lines
  Added in v.1.18

  ViewVC Help
Powered by ViewVC 1.1.20