/[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.10 Revision 1.16
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.10 2005/04/09 11:30:48 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.16 2005/09/09 05:57:43 fox2mike Exp $ -->
4 4
5<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 5<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
6 6
7<guide link="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>
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.0 --> 22<!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
23<license/> 23<license/>
24 24
25<version>1.9</version> 25<version>1.12</version>
26<date>2005-04-09</date> 26<date>2005-09-09</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>
46a powerful tool that fully enables the graphical abilities of your workstation. 46a powerful tool that fully enables the graphical abilities of your workstation.
47</p> 47</p>
48 48
49<p> 49<p>
50As standards are important, a standard for drawing and moving windows on a 50As standards are important, a standard for drawing and moving windows on a
51screen, interacting with the user through mouse and keyboard and other basic yet 51screen, interacting with the user through mouse, keyboard and other basic, yet
52important aspects has been created and named the <e>X Window System</e>, 52important aspects has been created and named the <e>X Window System</e>,
53commonly abbreviated as <e>X11</e> or just <e>X</e>. It is used on Unix, Linux 53commonly abbreviated as <e>X11</e> or just <e>X</e>. It is used on Unix, Linux
54and Unix-like operating systems throughout the world. 54and Unix-like operating systems throughout the world.
55</p> 55</p>
56 56
68<title>The X.org Project</title> 68<title>The X.org Project</title>
69<body> 69<body>
70 70
71<p> 71<p>
72The <uri link="http://www.x.org">X.org</uri> project created and 72The <uri link="http://www.x.org">X.org</uri> project created and
73maintains a freely redistributable open-source implementation of the X11 system. 73maintains a freely redistributable, open-source implementation of the X11
74It is an open source X11-based desktop infrastructure. 74system. It is an open source X11-based desktop infrastructure.
75</p> 75</p>
76 76
77<p> 77<p>
78Xorg provides an interface between your hardware and the graphical software 78Xorg provides an interface between your hardware and the graphical software
79you want to run. Besides that, Xorg is also fully network-aware, meaning you 79you want to run. Besides that, Xorg is also fully network-aware, meaning you
82</p> 82</p>
83 83
84</body> 84</body>
85</section> 85</section>
86</chapter> 86</chapter>
87
87<chapter> 88<chapter>
88<title>Installing Xorg</title> 89<title>Installing Xorg</title>
89<section> 90<section>
90<title>Using emerge</title> 91<title>Using emerge</title>
91<body> 92<body>
191# <i>xorgconfig</i> 192# <i>xorgconfig</i>
192</pre> 193</pre>
193 194
194<p> 195<p>
195Another tool, also provided by Xorg, is <c>xorgcfg</c>, which will first 196Another tool, also provided by Xorg, is <c>xorgcfg</c>, which will first
196attempts to run <c>Xorg -configure</c> and then start the X server for more 197attempt to run <c>Xorg -configure</c> and then start the X server for more
197final tweaking. 198final tweaking.
198</p> 199</p>
199 200
200<pre caption="Using xorgcfg"> 201<pre caption="Using xorgcfg">
201# <i>xorgcfg</i> 202# <i>xorgcfg</i>
203<comment>(In case X crashes or the configuration fails, try:)</comment>
204# <i>xorgcfg -textmode</i>
202</pre> 205</pre>
203 206
204</body> 207</body>
205</section> 208</section>
206<section> 209<section>
253 256
254<p> 257<p>
255If you see an ugly, loathsome, repulsive, deformed window manager, that's 258If you see an ugly, loathsome, repulsive, deformed window manager, that's
256<c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the 259<c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the
257upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace 260upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace
258combination. This will however make X exit disgracefully - something that you 261combination. This will however make X exit disgracefully -- something that you
259might not always want. It doesn't hurt though :) 262might not always want. It doesn't hurt though :)
260</p> 263</p>
261 264
262</body> 265</body>
263</section> 266</section>
269<body> 272<body>
270 273
271<p> 274<p>
272If you feel that the screen resolution is wrong, you will need to check two 275If you feel that the screen resolution is wrong, you will need to check two
273sections in your configuration. First of all, you have the <e>Screen</e> section 276sections in your configuration. First of all, you have the <e>Screen</e> section
274which lists the resolutions - if any - that your X server will run at. By 277which lists the resolutions, if any that your X server will run at. By
275default, this section might not list any resolutions at all. If this is the 278default, this section might not list any resolutions at all. If this is the
276case, Xorg will estimate the resolutions based on the information in the 279case, Xorg will estimate the resolutions based on the information in the
277second section, <e>Monitor</e>. 280second section, <e>Monitor</e>.
278</p> 281</p>
279 282
286use a tool that searches for your monitor's specs, such as 289use a tool that searches for your monitor's specs, such as
287<c>sys-apps/ddcxinfo-knoppix</c>. 290<c>sys-apps/ddcxinfo-knoppix</c>.
288</p> 291</p>
289 292
290<warn> 293<warn>
291Do <b>not</b> "just" change the values of these two monitor-related variables 294Do <b>not</b> "just" change the values of these two monitor related variables
292without consulting the technical specifications of your monitor. Setting 295without consulting the technical specifications of your monitor. Setting
293incorrect values lead to out-of-sync errors at best and smoked up screens at 296incorrect values lead to out-of-sync errors at best and smoked up screens at
294worst. 297worst.
295</warn> 298</warn>
296 299
297<p> 300<p>
298Now let us change the resolutions. In the next example from 301Now let us change the resolutions. In the next example from
299<path>/etc/X11/xorg.conf</path> we add the <c>Modes</c> lines and the 302<path>/etc/X11/xorg.conf</path> we add the <c>Modes</c> lines and the
300<c>DefaultDepth</c> so that our X server starts with 24 bits at 1024x768 by 303<c>DefaultDepth</c> so that our X server starts with 24 bits at 1024x768 by
301default. Don't mind the given strings - they are examples and will most likely 304default. Don't mind the given strings -- they are examples and will most likely
302differ from the settings on your system. 305differ from the settings on your system.
303</p> 306</p>
304 307
305<pre caption="Changing the Screen section in /etc/X11/xorg.conf"> 308<pre caption="Changing the Screen section in /etc/X11/xorg.conf">
306Section "Screen" 309Section "Screen"
350<title>Configuring your Mouse</title> 353<title>Configuring your Mouse</title>
351<body> 354<body>
352 355
353<p> 356<p>
354If your mouse isn't working, you will first need to find out if it is detected 357If your mouse isn't working, you will first need to find out if it is detected
355by the kernel at all. PS/2 mice are (device-wise) seen as 358by the kernel at all. Mice are (device-wise) seen as
356<path>/dev/psaux</path>. Other mice (like USBs) are seen as
357<path>/dev/input</path> (or <path>/dev/input/mice</path>). In either case you 359<path>/dev/input/mouse0</path> (or <path>/dev/input/mice</path> if you want to
358can check if the devices do represent your mouse by checking the output of those 360use several mice). In some cases <path>/dev/psaux</path> is used. In either
359files when you move your mouse. To end the session press <c>Ctrl-C</c>. 361case you can check if the devices do represent
362your mouse by checking the output of those files when you move your mouse. To
363end the session press <c>Ctrl-C</c>.
360</p> 364</p>
361 365
362<pre caption="Checking the device files"> 366<pre caption="Checking the device files">
363# <i>cat /dev/input</i> 367# <i>cat /dev/input/mouse0</i>
364<comment>(Don't forget to press Ctrl-C to end this)</comment> 368<comment>(Don't forget to press Ctrl-C to end this)</comment>
365</pre> 369</pre>
366 370
367<p> 371<p>
368If your mouse isn't detected, verify if all the necessary modules are loaded. 372If your mouse isn't detected, verify if all the necessary modules are loaded.
369</p> 373</p>
370 374
371<p> 375<p>
372If your mouse is detected, fill in the device in the appropriate 376If your mouse is detected, fill in the device in the appropriate
373<e>InputDevice</e> section. In the next example you'll see we also set two other 377<e>InputDevice</e> section. In the next example you'll see we also set two other
374options: <c>Protocol</c> (which lists the mouse protocol to be used - most users 378options: <c>Protocol</c> (which lists the mouse protocol to be used -- most
375will use PS/2 or IMPS/2) and <c>ZAxisMapping</c> (which allows for the 379users will use PS/2 or IMPS/2) and <c>ZAxisMapping</c> (which allows for the
376mousewheel (if applicable) to be used). 380mousewheel (if applicable) to be used).
377</p> 381</p>
378 382
379<pre caption="Changing the mouse settings in Xorg"> 383<pre caption="Changing the mouse settings in Xorg">
380Section "InputDevice" 384Section "InputDevice"
381 Identifier "TouchPad Mouse" 385 Identifier "TouchPad Mouse"
382 Driver "mouse" 386 Driver "mouse"
383 Option "CorePointer" 387 Option "CorePointer"
384 <i>Option "Device" "/dev/psaux"</i> 388 <i>Option "Device" "/dev/input/mouse0"</i>
385 <i>Option "Protocol" "IMPS/2"</i> 389 <i>Option "Protocol" "IMPS/2"</i>
386 <i>Option "ZAxisMapping" "4 5"</i> 390 <i>Option "ZAxisMapping" "4 5"</i>
387EndSection 391EndSection
388</pre> 392</pre>
389 393

Legend:
Removed from v.1.10  
changed lines
  Added in v.1.16

  ViewVC Help
Powered by ViewVC 1.1.20