/[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.28 Revision 1.31
1<?xml version='1.0' encoding='UTF-8'?> 1<?xml version='1.0' encoding='UTF-8'?>
2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 2<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.28 2009/01/26 08:08:22 nightmorph Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.31 2009/10/02 07:37:57 nightmorph Exp $ -->
4 4
5<guide link="/doc/en/xorg-config.xml"> 5<guide link="/doc/en/xorg-config.xml">
6<title>The X Server Configuration HOWTO</title> 6<title>The X Server Configuration HOWTO</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="swift@gentoo.org">Sven Vermeulen</mail> 9 <mail link="swift@gentoo.org">Sven Vermeulen</mail>
10</author> 10</author>
11<author title="Editor"> 11<author title="Author">
12 <mail link="nightmorph"/> 12 <mail link="nightmorph"/>
13</author> 13</author>
14 14
15<abstract> 15<abstract>
16Xorg is the X Window server which allows users to have a graphical 16Xorg is the X Window server which allows users to have a graphical
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.19</version> 25<version>1.22</version>
26<date>2009-01-26</date> 26<date>2009-10-02</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>
166<p> 166<p>
167After setting all the necessary variables you can install the Xorg package. 167After setting all the necessary variables you can install the Xorg package.
168</p> 168</p>
169 169
170<pre caption="Installing Xorg"> 170<pre caption="Installing Xorg">
171# <i>emerge xorg-x11</i> 171# <i>emerge xorg-server</i>
172</pre> 172</pre>
173
174<note>
175You could install the <c>xorg-x11</c> metapackage instead of the more
176lightweight xorg-server. Functionally, <c>xorg-x11</c> and <c>xorg-server</c>
177are the same. However, <c>xorg-x11</c> brings in many more packages that
178you probably don't need, such as a huge assortment of fonts in many different
179languages. They're not necessary for a working desktop.
180</note>
173 181
174<p> 182<p>
175When the installation is finished, you might need to re-initialise some 183When the installation is finished, you might need to re-initialise some
176environment variables before you continue. Just run <c>env-update</c> followed 184environment variables before you continue. Just run <c>env-update</c> followed
177by <c>source /etc/profile</c> and you're all set. 185by <c>source /etc/profile</c> and you're all set.
190<section> 198<section>
191<title>The xorg.conf File</title> 199<title>The xorg.conf File</title>
192<body> 200<body>
193 201
194<p> 202<p>
195The configuration file of Xorg is called <path>xorg.conf</path> and it 203The configuration file of Xorg is called <path>xorg.conf</path> and it resides
196resides in <path>/etc/X11</path>. The Xorg-X11 package provides an example 204in <path>/etc/X11</path>. Xorg provides an example configuration as
197configuration as <path>/etc/X11/xorg.conf.example</path> which you can use to 205<path>/etc/X11/xorg.conf.example</path> which you can use to create your own
198create your own configuration. It is heavily commented, but if you are in need 206configuration. It is heavily commented, but if you are in need of more
199of more documentation regarding the syntax, don't hesitate to read the man page: 207documentation regarding the syntax, don't hesitate to read the man page:
200</p> 208</p>
201 209
202<pre caption="Reading the xorg.conf man page"> 210<pre caption="Reading the xorg.conf man page">
203# <i>man 5 xorg.conf</i> 211# <i>man 5 xorg.conf</i>
204</pre> 212</pre>
310 execute the commands listed there. 318 execute the commands listed there.
311 </li> 319 </li>
312 <li> 320 <li>
313 Otherwise, it will read the value of the XSESSION variable and will execute 321 Otherwise, it will read the value of the XSESSION variable and will execute
314 one of the sessions available in <path>/etc/X11/Sessions/</path> 322 one of the sessions available in <path>/etc/X11/Sessions/</path>
315 accordingly (you can set the value of XSESSION in <path>/etc/rc.conf</path> 323 accordingly. You can set the value of XSESSION in
316 to make it a default for all the users on the system). 324 <path>/etc/env.d/90xsession</path> to make it a default for all the users on
325 the system. For example, as root, run <c>echo XSESSION="Xfce4" >
326 /etc/env.d/90xsession</c>. This will create the <path>90xsession</path> file
327 and set the default X session to Xfce4.
317 </li> 328 </li>
318 <li> 329 <li>
319 If all of the above fail, it will fall back to a simple window manager, 330 If all of the above fail, it will fall back to a simple window manager,
320 usually <c>twm</c>. 331 usually <c>twm</c>.
321 </li> 332 </li>
528environments and applications can be found in the <uri 539environments and applications can be found in the <uri
529link="/doc/en/?catid=desktop">Gentoo Desktop Documentation Resources</uri> 540link="/doc/en/?catid=desktop">Gentoo Desktop Documentation Resources</uri>
530section of our documentation. 541section of our documentation.
531</p> 542</p>
532 543
544<p>
545If you're upgrading to xorg-server-1.5 from an earlier version, then be sure to
546read the <uri
547link="/proj/en/desktop/x/x11/xorg-server-1.5-upgrade-guide.xml">migration
548guide</uri>.
549</p>
550
533</body> 551</body>
534</section> 552</section>
535</chapter> 553</chapter>
536</guide> 554</guide>

Legend:
Removed from v.1.28  
changed lines
  Added in v.1.31

  ViewVC Help
Powered by ViewVC 1.1.20