/[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.1 Revision 1.8
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.1 2004/05/10 20:28:34 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.8 2005/02/14 09:26:19 swift 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="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>
17environment at their fingertips. This HOWTO explains what Xorg is, how to 17environment at their fingertips. This HOWTO explains what Xorg is, how to
18install it and what the various configuration options are. 18install 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/1.0 --> 22<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
23<license/> 23<license/>
24 24
25<version>1.1</version> 25<version>1.7</version>
26<date>May 10, 2004</date> 26<date>2005-02-07</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>
56 56
57<p> 57<p>
58The application that provides Linux users with the ability to run graphical 58The application that provides Linux users with the ability to run graphical
59user interfaces and that uses the X11 standard is Xorg-X11, a fork of 59user interfaces and that uses the X11 standard is Xorg-X11, a fork of
60the XFree86 project. XFree86 has decided to use a license that might not be 60the XFree86 project. XFree86 has decided to use a license that might not be
61compatible with the GPL license; the use of Xorg is therefore recommended. Note 61compatible with the GPL license; the use of Xorg is therefore recommended.
62though that the differences between Xorg and XFree86 are currently very slim; if 62The official Portage tree does not provide an XFree86 package anymore.
63you know one, you know the other. XFree86 versions prior to 4.4 are available
64through Portage as well.
65</p> 63</p>
66 64
67</body> 65</body>
68</section> 66</section>
69<section> 67<section>
122<section> 120<section>
123<title>The xorg.conf File</title> 121<title>The xorg.conf File</title>
124<body> 122<body>
125 123
126<p> 124<p>
127The configurationfile of Xorg is called <path>xorg.conf</path> and it 125The configuration file of Xorg is called <path>xorg.conf</path> and it
128resides in <path>/etc/X11</path>. The Xorg-X11 package provides an example 126resides in <path>/etc/X11</path>. The Xorg-X11 package provides an example
129configuration as <path>/etc/X11/xorg.conf.example</path> which you can use to 127configuration as <path>/etc/X11/xorg.conf.example</path> which you can use to
130create your own configuration. It is heavily commented, but if you are in need 128create your own configuration. It is heavily commented, but if you are in need
131of more documentation regarding the syntax, don't hesitate to read the man page: 129of more documentation regarding the syntax, don't hesitate to read the man page:
132</p> 130</p>
165will have told you that it has written <path>/root/xorg.conf.new</path> ready 163will have told you that it has written <path>/root/xorg.conf.new</path> ready
166for you to test. So let's test :) 164for you to test. So let's test :)
167</p> 165</p>
168 166
169<pre caption="Testing the xorg.conf.new file"> 167<pre caption="Testing the xorg.conf.new file">
170# <i>Xorg -config /root/xorg.conf.new</i> 168# <i>X -config /root/xorg.conf.new</i>
171</pre> 169</pre>
172 170
173<p> 171<p>
174If all goes well, you should see an ugly, loathsome, repulsive, deformed 172If all goes well, you should see an ugly, loathsome, repulsive, deformed
175window manager called <c>twm</c>, probably the smallest window manager 173window manager called <c>twm</c>, probably the smallest window manager
177In the next section we will optimize our <path>xorg.conf</path> so it fits your 175In the next section we will optimize our <path>xorg.conf</path> so it fits your
178hardware. Now go into one of the terminals you see on your screen and type in 176hardware. Now go into one of the terminals you see on your screen and type in
179<c>exit</c> (or press Ctrl-D) until Xorg shuts down. If you are unable to 177<c>exit</c> (or press Ctrl-D) until Xorg shuts down. If you are unable to
180use your mouse to focus the terminals, you can also press Ctrl-Alt-Backspace to 178use your mouse to focus the terminals, you can also press Ctrl-Alt-Backspace to
181kill the X server. 179kill the X server.
180</p>
181
182<p>
183If <c>twm</c> doesn't load, don't worry - it will once you'll start the X server
184through the regular <c>startx</c> command. Verify if your mouse works correctly
185and if the resolution is good. You might not be able to deduce the exact
186resolution, but you should be able to see if it's too low. You can exit any time
187by pressing Ctrl-Alt-Backspace.
182</p> 188</p>
183 189
184</body> 190</body>
185</section> 191</section>
186<section> 192<section>
302<pre caption="Changing the keyboard layout"> 308<pre caption="Changing the keyboard layout">
303Section "InputDevice" 309Section "InputDevice"
304 Identifier "Generic Keyboard" 310 Identifier "Generic Keyboard"
305 Driver "keyboard" 311 Driver "keyboard"
306 Option "CoreKeyboard" 312 Option "CoreKeyboard"
307 Option "XkbRules" "xfree86" 313 Option "XkbRules" "xorg"
308 Option "XkbModel" "pc105" 314 Option "XkbModel" "pc105"
309 <i>Option "XkbLayout" "be"</i> 315 <i>Option "XkbLayout" "be"</i>
310EndSection 316EndSection
311</pre> 317</pre>
312 318
316<title>Configuring your Mouse</title> 322<title>Configuring your Mouse</title>
317<body> 323<body>
318 324
319<p> 325<p>
320If your mouse isn't working, you will first need to find out if it is detected 326If your mouse isn't working, you will first need to find out if it is detected
321by the kernel at all. PS/2 mouses are (device-wise) seen as 327by the kernel at all. PS/2 mice are (device-wise) seen as
322<path>/dev/psaux</path>. Other mouses (like USBs) are seen as 328<path>/dev/psaux</path>. Other mice (like USBs) are seen as
323<path>/dev/input</path> (or <path>/dev/input/mice</path>). In either case you 329<path>/dev/input</path> (or <path>/dev/input/mice</path>). In either case you
324can check if the devices do represent your mouse by checking the output of those 330can check if the devices do represent your mouse by checking the output of those
325files when you move your mouse. To end the session press <c>Ctrl-C</c>. 331files when you move your mouse. To end the session press <c>Ctrl-C</c>.
326</p> 332</p>
327 333

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.8

  ViewVC Help
Powered by ViewVC 1.1.20