[gentoo-doc-cvs] cvs commit: xorg-config.xml

[Lukasz Damentko]

rane        06/07/13 04:29:16

  Modified:             xorg-config.xml
  Log:
  #139583, update for modular xorg (VIDEO_CARDS, INPUT_DEVICES)

Revision  Changes    Path
1.18                 xml/htdocs/doc/en/xorg-config.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/xorg-config.xml?rev=1.18&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/xorg-config.xml?rev=1.18&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/xorg-config.xml.diff?r1=1.17&r2=1.18&cvsroot=gentoo

Index: xorg-config.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- xorg-config.xml	9 Sep 2005 06:01:15 -0000	1.17
+++ xorg-config.xml	13 Jul 2006 04:29:16 -0000	1.18
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.17 2005/09/09 06:01:15 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.18 2006/07/13 04:29:16 rane Exp $ -->
 
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
@@ -22,8 +22,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.13</version>
-<date>2005-09-09</date>
+<version>1.14</version>
+<date>2006-07-13</date>
 
 <chapter>
 <title>What is the X Window Server?</title>
@@ -97,18 +97,91 @@
 though, so you might want to grab a snack while you are waiting.
 </p>
 
+<p>
+Before installing Xorg you have to configure two important variables in the
+<path>/etc/make.conf</path> file.
+</p>
+
+<p>
+The first one is <c>VIDEO_CARDS</c>. This is used to set the video drivers that
+you intend to use and is usually based on the kind and brand of card you have.
+The most common settings are <c>nvidia</c> for Nvidia cards or <c>fglrx</c> for
+ATI Radeon cards. Those are the proprietary drivers from Nvidia and ATI
+respectively. If you would like to use the open source versions, use <c>nv</c>
+rather than <c>nvidia</c> in the variable, but bear in mind that using this
+driver means no 3d acceleration at all. Use <c>radeon</c> in case you have an
+ATI card for the same. <c>VIDEO_CARDS</c> may contain more than one driver, in
+this case list of them should be separated with spaces.
+</p>
+
+<p>
+The second variable is <c>INPUT_DEVICES</c> and is used to determine which
+drivers are to be built for input devices. In most cases setting it to
+<c>keyboard mouse</c> should work just fine.
+</p>
+
+<p>
+Now you should decide which drivers you will use and add necessary settings to
+the <path>/etc/make.conf</path> file:
+</p>
+
+<pre caption="Sample make.conf entries">
+<comment>(For mouse and keyboard support)</comment>
+INPUT_DEVICES="keyboard mouse"
+<comment>(For Nvidia cards)</comment>
+VIDEO_CARDS="nvidia"
+<comment>(OR, for ATI Radeon cards)</comment>
+VIDEO_CARDS="fglrx"
+</pre>
+
+<p>
+More instructions on how to configure Nvidia and ATI cards can be found in
+<uri link="/doc/en/nvidia-guide.xml">Gentoo Linux nVidia Guide</uri> and in
+<uri link="/doc/en/ati-faq.xml">Gentoo Linux ATI FAQ</uri>. If you don't know
+which drivers you should choose, refer to these guides for more information.
+</p>
+
+<note>
+If the suggested settings don't work for you, you should run <c>emerge -pv
+xorg-x11</c>, check all the options available and choose those which
+apply to your system. In different versions of Xorg and on different
+architectures displaying these variables can be done with <c>emerge -pv
+xorg-server</c> command rather than the one above. The example is for x86
+architecture and xorg-x11-7.0.
+</note>
+
+<pre caption="Displaying all the driver options available">
+# <i>emerge -pv xorg-x11</i>
+
+These are the packages that would be merged, in order:
+
+Calculating dependencies... done!
+[ebuild   R   ] x11-base/xorg-x11-7.0-r1  USE="-3dfx" INPUT_DEVICES="keyboard
+mouse -acecad -aiptek -calcomp -citron -digitaledge -dmc -dynapro -elo2300
+-elographics -evdev -fpit -hyperpen -jamstudio -joystick -magellan -magictouch
+-microtouch -mutouch -palmax -penmount -spaceorb -summa -synaptics -tek4957
+-ur98 -vmmouse -void -wacom" VIDEO_CARDS="nvidia -apm -ark -chips -cirrus
+-cyrix -dummy -fbdev -fglrx -glint -i128 -i740 -i810 -imstt -mach64 -mga
+-neomagic -nsc -nv -r128 -radeon -rendition -s3 -s3virge -savage -siliconmotion
+-sis -sisusb -tdfx -tga -trident -tseng -v4l -vesa -vga -via -vmware -voodoo" 0
+kB
+</pre>
+
+<p>
+After setting all the necessary variables you can install the Xorg package.
+</p>
+
 <pre caption="Installing Xorg">
 # <i>emerge xorg-x11</i>
 </pre>
 
 <p>
-When the installation is finished, you might need to reinitialise some
+When the installation is finished, you might need to re-initialise some
 environment variables before you continue. Just run <c>env-update</c> followed
-by <c>source /etc/profile</c> and you're all set. This doesn't harm your system
-in any way.
+by <c>source /etc/profile</c> and you're all set.
 </p>
 
-<pre caption="Reinitialising the environment variables">
+<pre caption="Re-initialising the environment variables">
 # <i>env-update</i>
 # <i>source /etc/profile</i>
 </pre>
@@ -443,5 +516,24 @@
 
 </body>
 </section>
+<section>
+<title>Other resources</title>
+<body>
+
+<p>
+If you want to update your system from the old monolithic Xorg to the newer,
+modular Xorg 7, you should refer to the <uri
+link="/proj/en/desktop/x/x11/modular-x-howto.xml">Migrating to Modular X
+HOWTO</uri>.
+</p>
+
+<p>
+More information about configuring different packages to work in X environment
+can be found in the <uri link="/doc/en/?catid=desktop">Gentoo Desktop
+Documentation Resources</uri> section of our documentation.
+</p>
+
+</body>
+</section>
 </chapter>
 </guide>



-- 
gentoo-doc-cvs@g.o mailing list