/[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.8 Revision 1.12
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.8 2005/02/14 09:26:19 swift Exp $ --> 3<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.12 2005/04/13 16:20:21 neysx 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="xorg-config.xml">
8 8
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.7</version> 25<version>1.10</version>
26<date>2005-02-07</date> 26<date>2005-04-11</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>
167<pre caption="Testing the xorg.conf.new file"> 167<pre caption="Testing the xorg.conf.new file">
168# <i>X -config /root/xorg.conf.new</i> 168# <i>X -config /root/xorg.conf.new</i>
169</pre> 169</pre>
170 170
171<p> 171<p>
172If all goes well, you should see an ugly, loathsome, repulsive, deformed 172If all goes well, you should see a simple black and white pattern. Verify if
173window manager called <c>twm</c>, probably the smallest window manager 173your mouse works correctly and if the resolution is good. You might not be able
174available. Try moving your mouse and see if your keyboard and such is working. 174to deduce the exact resolution, but you should be able to see if it's too low.
175In the next section we will optimize our <path>xorg.conf</path> so it fits your 175You can exit any time by pressing Ctrl-Alt-Backspace.
176hardware. Now go into one of the terminals you see on your screen and type in
177<c>exit</c> (or press Ctrl-D) until Xorg shuts down. If you are unable to
178use your mouse to focus the terminals, you can also press Ctrl-Alt-Backspace to
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.
188</p> 176</p>
189 177
190</body> 178</body>
191</section> 179</section>
192<section> 180<section>
201 189
202<pre caption="Semi-Automatic Generation of xorg.conf"> 190<pre caption="Semi-Automatic Generation of xorg.conf">
203# <i>xorgconfig</i> 191# <i>xorgconfig</i>
204</pre> 192</pre>
205 193
194<p>
195Another 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
197final tweaking.
198</p>
199
200<pre caption="Using xorgcfg">
201# <i>xorgcfg</i>
202</pre>
203
204</body>
205</section>
206<section>
207<title>Copying over xorg.conf</title>
208<body>
209
210<p>
211Let us copy over the <path>xorg.conf.new</path> to
212<path>/etc/X11/xorg.conf</path> now, so we won't have to continuously run
213<c>X -config</c> -- typing just <c>X</c> or <c>startx</c> is far more easy :)
214</p>
215
216<pre caption="Copying over xorg.conf">
217# <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i>
218</pre>
219
220</body>
221</section>
222<section id="using_startx">
223<title>Using startx</title>
224<body>
225
226<p>
227Now try <c>startx</c> to start up your X server. <c>startx</c> is a script
228that executes an <e>X session</e>, that is, it starts the X servers and some
229graphical applications on top of it. It decides which applications to run
230using the following logic:
231</p>
232
233<ul>
234 <li>
235 If a file named <path>.xinitrc</path> exists in the home directory, it will
236 execute the commands listed there.
237 </li>
238 <li>
239 Otherwise, it will read the value of the XSESSION variable and will execute
240 one of the sessions available in <path>/etc/X11/Sessions/</path>
241 accordingly (you can set the value of XSESSION in <path>/etc/rc.conf</path>
242 to make it a default for all the users on the system).
243 </li>
244<li>
245 If all of the above fail, it will fall back to a simple window manager,
246 usually <c>twm</c>.
247 </li>
248</ul>
249
250<pre caption="Starting X">
251# <i>startx</i>
252</pre>
253
254<p>
255If 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
257upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace
258combination. This will however make X exit disgracefully - something that you
259might not always want. It doesn't hurt though :)
260</p>
261
206</body> 262</body>
207</section> 263</section>
208</chapter> 264</chapter>
209<chapter> 265<chapter>
210<title>Tweaking xorg.conf</title> 266<title>Tweaking xorg.conf</title>
211<section>
212<title>Copying over xorg.conf</title>
213<body>
214
215<p>
216Let us first copy over the <path>xorg.conf.new</path> to
217<path>/etc/X11/xorg.conf</path> so we won't have to continuously run <c>Xorg
218-config</c> -- typing <c>startx</c> is far more easy :)
219</p>
220
221<pre caption="Copying over xorg.conf">
222# <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i>
223</pre>
224
225<p>
226Now run <c>startx</c> to start up your X server. It will use the freshly copied
227file as its configuration file. To finish the X session, type in <c>exit</c> or
228Ctrl-D in the upcoming xterms. You can also kill the X session using the
229Ctrl-Alt-Backspace combination. This will however make X exit disgracefully -
230something that you might not always want. It doesn't hurt though :)
231</p>
232
233<pre caption="Starting X">
234# <i>startx</i>
235</pre>
236
237</body>
238</section>
239<section> 267<section>
240<title>Setting your Resolution</title> 268<title>Setting your Resolution</title>
241<body> 269<body>
242 270
243<p> 271<p>
322<title>Configuring your Mouse</title> 350<title>Configuring your Mouse</title>
323<body> 351<body>
324 352
325<p> 353<p>
326If your mouse isn't working, you will first need to find out if it is detected 354If your mouse isn't working, you will first need to find out if it is detected
327by the kernel at all. PS/2 mice are (device-wise) seen as 355by the kernel at all. Mice are (device-wise) seen as
328<path>/dev/psaux</path>. Other mice (like USBs) are seen as
329<path>/dev/input</path> (or <path>/dev/input/mice</path>). In either case you 356<path>/dev/input/mouse0</path> (or <path>/dev/input/mice</path> if you want to
330can check if the devices do represent your mouse by checking the output of those 357use several mice). In either case you can check if the devices do represent
331files when you move your mouse. To end the session press <c>Ctrl-C</c>. 358your mouse by checking the output of those files when you move your mouse. To
359end the session press <c>Ctrl-C</c>.
332</p> 360</p>
333 361
334<pre caption="Checking the device files"> 362<pre caption="Checking the device files">
335# <i>cat /dev/input</i> 363# <i>cat /dev/input/mouse0</i>
336<comment>(Don't forget to press Ctrl-C to end this)</comment> 364<comment>(Don't forget to press Ctrl-C to end this)</comment>
337</pre> 365</pre>
338 366
339<p> 367<p>
340If your mouse isn't detected, verify if all the necessary modules are loaded. 368If your mouse isn't detected, verify if all the necessary modules are loaded.
351<pre caption="Changing the mouse settings in Xorg"> 379<pre caption="Changing the mouse settings in Xorg">
352Section "InputDevice" 380Section "InputDevice"
353 Identifier "TouchPad Mouse" 381 Identifier "TouchPad Mouse"
354 Driver "mouse" 382 Driver "mouse"
355 Option "CorePointer" 383 Option "CorePointer"
356 <i>Option "Device" "/dev/psaux"</i> 384 <i>Option "Device" "/dev/input/mouse0"</i>
357 <i>Option "Protocol" "IMPS/2"</i> 385 <i>Option "Protocol" "IMPS/2"</i>
358 <i>Option "ZAxisMapping" "4 5"</i> 386 <i>Option "ZAxisMapping" "4 5"</i>
359EndSection 387EndSection
360</pre> 388</pre>
361 389

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

  ViewVC Help
Powered by ViewVC 1.1.20