/[gentoo]/xml/htdocs/doc/en/xorg-config.xml

Diff of /xml/htdocs/doc/en/xorg-config.xml

Parent Directory | 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>
16	Xorg is the X Window server which allows users to have a graphical	16	Xorg is the X Window server which allows users to have a graphical
17	environment at their fingertips. This HOWTO explains what Xorg is, how to	17	environment at their fingertips. This HOWTO explains what Xorg is, how to
18	install it and what the various configuration options are.	18	install 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>
35	The average user may be frightened at the thought of having to type in commands.	35	The average user may be frightened at the thought of having to type in commands.
36	Why wouldn't he be able to point and click his way through the freedom provided	36	Why wouldn't he be able to point and click his way through the freedom provided
37	by Gentoo (and Linux in general)? Well, big smile, of course you are able to	37	by Gentoo (and Linux in general)? Well, big smile, of course you are able to
38	do this :-) Linux offers a wide variety of flashy user interfaces and	38	do this :-) Linux offers a wide variety of flashy user interfaces and
39	environments which you can install on top of your existing installation.	39	environments 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>
95	Enough chitchat, let's get to business shall we? To install Xorg, you just	95	Enough chitchat, let's get to business shall we? To install Xorg, you just
96	need to run <c>emerge xorg-x11</c>. Installing Xorg does take a while	96	need to run <c>emerge xorg-x11</c>. Installing Xorg does take a while
97	though, so you might want to grab a snack while you are waiting.	97	though, so you might want to grab a snack while you are waiting.
98	</p>	98	</p>
99		99
		100	<p>
		101	Before installing Xorg you have to configure two important variables in the
		102	<path>/etc/make.conf</path> file.
		103	</p>
		104
		105	<p>
		106	The first one is <c>VIDEO_CARDS</c>. This is used to set the video drivers that
		107	you intend to use and is usually based on the kind and brand of card you have.
		108	The most common settings are <c>nvidia</c> for Nvidia cards or <c>fglrx</c> for
		109	ATI Radeon cards. Those are the proprietary drivers from Nvidia and ATI
		110	respectively. If you would like to use the open source versions, use <c>nv</c>
		111	rather than <c>nvidia</c> in the variable, but bear in mind that using this
		112	driver means no 3d acceleration at all. Use <c>radeon</c> in case you have an
		113	ATI card for the same. <c>VIDEO_CARDS</c> may contain more than one driver, in
		114	this case list of them should be separated with spaces.
		115	</p>
		116
		117	<p>
		118	The second variable is <c>INPUT_DEVICES</c> and is used to determine which
		119	drivers 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>
		124	Now you should decide which drivers you will use and add necessary settings to
		125	the <path>/etc/make.conf</path> file:
		126	</p>
		127
		128	<pre caption="Sample make.conf entries">
		129	<comment>(For mouse and keyboard support)</comment>
		130	INPUT_DEVICES="keyboard mouse"
		131	<comment>(For Nvidia cards)</comment>
		132	VIDEO_CARDS="nvidia"
		133	<comment>(OR, for ATI Radeon cards)</comment>
		134	VIDEO_CARDS="fglrx"
		135	</pre>
		136
		137	<p>
		138	More 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
		141	which drivers you should choose, refer to these guides for more information.
		142	</p>
		143
		144	<note>
		145	If the suggested settings don't work for you, you should run <c>emerge -pv
		146	xorg-x11</c>, check all the options available and choose those which
		147	apply to your system. In different versions of Xorg and on different
		148	architectures displaying these variables can be done with <c>emerge -pv
		149	xorg-server</c> command rather than the one above. The example is for x86
		150	architecture 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
		156	These are the packages that would be merged, in order:
		157
		158	Calculating dependencies... done!
		159	[ebuild R ] x11-base/xorg-x11-7.0-r1 USE="-3dfx" INPUT_DEVICES="keyboard
		160	mouse -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
		167	kB
		168	</pre>
		169
		170	<p>
		171	After 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>
105	When the installation is finished, you might need to reinitialise some	179	When the installation is finished, you might need to re-initialise some
106	environment variables before you continue. Just run <c>env-update</c> followed	180	environment variables before you continue. Just run <c>env-update</c> followed
107	by <c>source /etc/profile</c> and you're all set. This doesn't harm your system	181	by <c>source /etc/profile</c> and you're all set.
108	in 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>
126	The configuration file of Xorg is called <path>xorg.conf</path> and it	199	The 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>
		524	If you want to update your system from the old monolithic Xorg to the newer,
		525	modular Xorg 7, you should refer to the <uri
		526	link="/proj/en/desktop/x/x11/modular-x-howto.xml">Migrating to Modular X
		527	HOWTO</uri>.
		528	</p>
		529
		530	<p>
		531	More information about configuring different packages to work in X environment
		532	can be found in the <uri link="/doc/en/?catid=desktop">Gentoo Desktop
		533	Documentation 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
 Legend:



Removed from v.1.17
 


changed lines


 
Added in v.1.18
-Removed from v.1.17
+Added in v.1.18

	ViewVC Help
Powered by ViewVC 1.1.20