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> -- [email protected] mailing list
