/[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
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>
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>
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