/[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.22
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.22 2007/06/09 12:40:12 jkt 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
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.16</version>
26<date>2005-09-09</date> 26<date>2007-06-09</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>
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. The free <c>radeon</c> driver for ATI
113cards supports full 3D acceleration on older Radeons but doesn't work at all
114with the newer ones. <c>VIDEO_CARDS</c> may contain more than one driver, in
115this case list of them should be separated with spaces.
116</p>
117
118<p>
119The second variable is <c>INPUT_DEVICES</c> and is used to determine which
120drivers are to be built for input devices. In most cases setting it to
121<c>keyboard mouse</c> should work just fine.
122</p>
123
124<p>
125Now you should decide which drivers you will use and add necessary settings to
126the <path>/etc/make.conf</path> file:
127</p>
128
129<pre caption="Sample make.conf entries">
130<comment>(For mouse and keyboard support)</comment>
131INPUT_DEVICES="keyboard mouse"
132<comment>(For Nvidia cards)</comment>
133VIDEO_CARDS="nvidia"
134<comment>(OR, for ATI Radeon cards)</comment>
135VIDEO_CARDS="fglrx"
136</pre>
137
138<p>
139More instructions on how to configure Nvidia and ATI cards can be found in
140<uri link="/doc/en/nvidia-guide.xml">Gentoo Linux nVidia Guide</uri> and in
141<uri link="/doc/en/ati-faq.xml">Gentoo Linux ATI FAQ</uri>. If you don't know
142which drivers you should choose, refer to these guides for more information.
143</p>
144
145<note>
146If the suggested settings don't work for you, you should run <c>emerge -pv
147xorg-x11</c>, check all the options available and choose those which
148apply to your system. In different versions of Xorg and on different
149architectures displaying these variables can be done with <c>emerge -pv
150xorg-server</c> command rather than the one above. The example is for x86
151architecture and xorg-x11-7.0.
152</note>
153
154<pre caption="Displaying all the driver options available">
155# <i>emerge -pv xorg-x11</i>
156
157These are the packages that would be merged, in order:
158
159Calculating dependencies... done!
160[ebuild R ] x11-base/xorg-x11-7.0-r1 USE="-3dfx" INPUT_DEVICES="keyboard
161mouse -acecad -aiptek -calcomp -citron -digitaledge -dmc -dynapro -elo2300
162-elographics -evdev -fpit -hyperpen -jamstudio -joystick -magellan -magictouch
163-microtouch -mutouch -palmax -penmount -spaceorb -summa -synaptics -tek4957
164-ur98 -vmmouse -void -wacom" VIDEO_CARDS="nvidia -apm -ark -chips -cirrus
165-cyrix -dummy -fbdev -fglrx -glint -i128 -i740 -i810 -imstt -mach64 -mga
166-neomagic -nsc -nv -r128 -radeon -rendition -s3 -s3virge -savage -siliconmotion
167-sis -sisusb -tdfx -tga -trident -tseng -v4l -vesa -vga -via -vmware -voodoo" 0
168kB
169</pre>
170
171<p>
172After setting all the necessary variables you can install the Xorg package.
173</p>
174
100<pre caption="Installing Xorg"> 175<pre caption="Installing Xorg">
101# <i>emerge xorg-x11</i> 176# <i>emerge xorg-x11</i>
102</pre> 177</pre>
103 178
104<p> 179<p>
105When the installation is finished, you might need to reinitialise some 180When the installation is finished, you might need to re-initialise some
106environment variables before you continue. Just run <c>env-update</c> followed 181environment 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 182by <c>source /etc/profile</c> and you're all set.
108in any way.
109</p> 183</p>
110 184
111<pre caption="Reinitialising the environment variables"> 185<pre caption="Re-initialising the environment variables">
112# <i>env-update</i> 186# <i>env-update</i>
113# <i>source /etc/profile</i> 187# <i>source /etc/profile</i>
114</pre> 188</pre>
115 189
116</body> 190</body>
168<pre caption="Testing the xorg.conf.new file"> 242<pre caption="Testing the xorg.conf.new file">
169# <i>X -config /root/xorg.conf.new</i> 243# <i>X -config /root/xorg.conf.new</i>
170</pre> 244</pre>
171 245
172<p> 246<p>
173If all goes well, you should see a simple black and white pattern. Verify if 247If all goes well, you should see a simple black and white pattern. Verify if
174your mouse works correctly and if the resolution is good. You might not be able 248your mouse works correctly and if the resolution is good. If you received errors
249about "/dev/mouse", try changing your mouse device to <c>/dev/input/mice</c> in
250the "InputDevice" section of <path>xorg.conf</path>. You might not be able to
175to deduce the exact resolution, but you should be able to see if it's too low. 251deduce the exact resolution, but you should be able to see if it's too low. You
176You can exit any time by pressing Ctrl-Alt-Backspace. 252can exit any time by pressing Ctrl-Alt-Backspace.
177</p> 253</p>
178 254
179</body> 255</body>
180</section> 256</section>
181<section> 257<section>
441 </li> 517 </li>
442</ul> 518</ul>
443 519
444</body> 520</body>
445</section> 521</section>
522<section>
523<title>Other resources</title>
524<body>
525
526<p>
527If you want to update your system from the old monolithic Xorg to the newer,
528modular Xorg 7, you should refer to the <uri
529link="/proj/en/desktop/x/x11/modular-x-howto.xml">Migrating to Modular X
530HOWTO</uri>.
531</p>
532
533<p>
534More information about configuring different packages to work in X environment
535can be found in the <uri link="/doc/en/?catid=desktop">Gentoo Desktop
536Documentation Resources</uri> section of our documentation.
537</p>
538
539</body>
540</section>
446</chapter> 541</chapter>
447</guide> 542</guide>

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

  ViewVC Help
Powered by ViewVC 1.1.20