| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | |
|
|
| 3 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.22 2007/06/09 12:40:12 jkt Exp $ --> |
|
|
| 4 | |
|
|
| 5 | <!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.24 2007/10/18 18:16:02 nightmorph Exp $ --> |
| 6 | |
4 | |
| 7 | <guide link="/doc/en/xorg-config.xml"> |
5 | <guide link="/doc/en/xorg-config.xml"> |
| 8 | |
|
|
| 9 | <title>The X Server Configuration HOWTO</title> |
6 | <title>The X Server Configuration HOWTO</title> |
| 10 | |
7 | |
| 11 | <author title="Author"> |
8 | <author title="Author"> |
| 12 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
9 | <mail link="swift@gentoo.org">Sven Vermeulen</mail> |
| 13 | </author> |
10 | </author> |
| … | |
… | |
| 20 | |
17 | |
| 21 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
18 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 22 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
19 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 23 | <license/> |
20 | <license/> |
| 24 | |
21 | |
| 25 | <version>1.16</version> |
22 | <version>1.17</version> |
| 26 | <date>2007-06-09</date> |
23 | <date>2007-06-20</date> |
| 27 | |
24 | |
| 28 | <chapter> |
25 | <chapter> |
| 29 | <title>What is the X Window Server?</title> |
26 | <title>What is the X Window Server?</title> |
| 30 | <section> |
27 | <section> |
| 31 | <title>Graphical vs Command-Line</title> |
28 | <title>Graphical vs Command-Line</title> |
| … | |
… | |
| 142 | which drivers you should choose, refer to these guides for more information. |
139 | which drivers you should choose, refer to these guides for more information. |
| 143 | </p> |
140 | </p> |
| 144 | |
141 | |
| 145 | <note> |
142 | <note> |
| 146 | If the suggested settings don't work for you, you should run <c>emerge -pv |
143 | If the suggested settings don't work for you, you should run <c>emerge -pv |
| 147 | xorg-x11</c>, check all the options available and choose those which |
144 | xorg-server</c>, check all the options available and choose those which apply to |
| 148 | apply to your system. In different versions of Xorg and on different |
145 | your system. The example is for the amd64 architecture and |
| 149 | architectures displaying these variables can be done with <c>emerge -pv |
146 | <c>xorg-server-1.2</c>. |
| 150 | xorg-server</c> command rather than the one above. The example is for x86 |
|
|
| 151 | architecture and xorg-x11-7.0. |
|
|
| 152 | </note> |
147 | </note> |
| 153 | |
148 | |
| 154 | <pre caption="Displaying all the driver options available"> |
149 | <pre caption="Displaying all the driver options available"> |
| 155 | # <i>emerge -pv xorg-x11</i> |
150 | # <i>emerge -pv xorg-server</i> |
| 156 | |
151 | |
| 157 | These are the packages that would be merged, in order: |
152 | These are the packages that would be merged, in order: |
| 158 | |
153 | |
| 159 | Calculating dependencies... done! |
154 | Calculating dependencies... done! |
| 160 | [ebuild R ] x11-base/xorg-x11-7.0-r1 USE="-3dfx" INPUT_DEVICES="keyboard |
155 | [ebuild R ] x11-base/xorg-server-1.2.0-r3 USE="dri nptl xorg (-3dfx) -debug |
|
|
156 | -dmx -ipv6 -kdrive -minimal -sdl -xprint" INPUT_DEVICES="keyboard mouse -acecad |
| 161 | mouse -acecad -aiptek -calcomp -citron -digitaledge -dmc -dynapro -elo2300 |
157 | -aiptek -calcomp -citron -digitaledge -dmc -dynapro -elo2300 -elographics -evdev |
| 162 | -elographics -evdev -fpit -hyperpen -jamstudio -joystick -magellan -magictouch |
158 | -fpit -hyperpen -jamstudio -joystick -magellan -microtouch -mutouch -palmax |
| 163 | -microtouch -mutouch -palmax -penmount -spaceorb -summa -synaptics -tek4957 |
159 | -penmount -spaceorb -summa -synaptics -tek4957 -ur98 -vmmouse -void -wacom" |
| 164 | -ur98 -vmmouse -void -wacom" VIDEO_CARDS="nvidia -apm -ark -chips -cirrus |
160 | VIDEO_CARDS="nvidia -apm -ark -chips -cirrus -cyrix -dummy -epson -fbdev -fglrx |
| 165 | -cyrix -dummy -fbdev -fglrx -glint -i128 -i740 -i810 -imstt -mach64 -mga |
161 | -glint -i128 (-i740) -i810 (-impact) (-imstt) -mach64 -mga -neomagic (-newport) |
| 166 | -neomagic -nsc -nv -r128 -radeon -rendition -s3 -s3virge -savage -siliconmotion |
162 | (-nsc) -nv -r128 -radeon -rendition -s3 -s3virge -savage -siliconmotion -sis |
|
|
163 | -sisusb (-sunbw2) (-suncg14) (-suncg3) (-suncg6) (-sunffb) (-sunleo) (-suntcx) |
| 167 | -sis -sisusb -tdfx -tga -trident -tseng -v4l -vesa -vga -via -vmware -voodoo" 0 |
164 | -tdfx -tga -trident -tseng -v4l -vesa -vga -via -vmware -voodoo" 0 kB |
| 168 | kB |
|
|
| 169 | </pre> |
165 | </pre> |
| 170 | |
166 | |
| 171 | <p> |
167 | <p> |
| 172 | After setting all the necessary variables you can install the Xorg package. |
168 | After setting all the necessary variables you can install the Xorg package. |
| 173 | </p> |
169 | </p> |
| … | |
… | |
| 234 | <p> |
230 | <p> |
| 235 | Be sure to read the last lines printed on your screen when Xorg has finished |
231 | Be sure to read the last lines printed on your screen when Xorg has finished |
| 236 | probing your hardware. If it tells you it failed at some point, you're forced to |
232 | probing your hardware. If it tells you it failed at some point, you're forced to |
| 237 | manually write an <path>xorg.conf</path> file. Assuming that it didn't fail, it |
233 | manually write an <path>xorg.conf</path> file. Assuming that it didn't fail, it |
| 238 | will have told you that it has written <path>/root/xorg.conf.new</path> ready |
234 | will have told you that it has written <path>/root/xorg.conf.new</path> ready |
| 239 | for you to test. So let's test :) |
235 | for you to test. So let's test. :) |
| 240 | </p> |
236 | </p> |
| 241 | |
237 | |
| 242 | <pre caption="Testing the xorg.conf.new file"> |
238 | <pre caption="Testing the xorg.conf.new file"> |
| 243 | # <i>X -config /root/xorg.conf.new</i> |
239 | # <i>X -config /root/xorg.conf.new</i> |
| 244 | </pre> |
240 | </pre> |
| … | |
… | |
| 287 | <body> |
283 | <body> |
| 288 | |
284 | |
| 289 | <p> |
285 | <p> |
| 290 | Let us copy over the <path>xorg.conf.new</path> to |
286 | Let us copy over the <path>xorg.conf.new</path> to |
| 291 | <path>/etc/X11/xorg.conf</path> now, so we won't have to continuously run |
287 | <path>/etc/X11/xorg.conf</path> now, so we won't have to continuously run |
| 292 | <c>X -config</c> -- typing just <c>X</c> or <c>startx</c> is far more easy :) |
288 | <c>X -config</c> -- typing just <c>X</c> or <c>startx</c> is easier. :) |
| 293 | </p> |
289 | </p> |
| 294 | |
290 | |
| 295 | <pre caption="Copying over xorg.conf"> |
291 | <pre caption="Copying over xorg.conf"> |
| 296 | # <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i> |
292 | # <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i> |
| 297 | </pre> |
293 | </pre> |
| … | |
… | |
| 318 | Otherwise, it will read the value of the XSESSION variable and will execute |
314 | Otherwise, it will read the value of the XSESSION variable and will execute |
| 319 | one of the sessions available in <path>/etc/X11/Sessions/</path> |
315 | one of the sessions available in <path>/etc/X11/Sessions/</path> |
| 320 | accordingly (you can set the value of XSESSION in <path>/etc/rc.conf</path> |
316 | accordingly (you can set the value of XSESSION in <path>/etc/rc.conf</path> |
| 321 | to make it a default for all the users on the system). |
317 | to make it a default for all the users on the system). |
| 322 | </li> |
318 | </li> |
| 323 | <li> |
319 | <li> |
| 324 | If all of the above fail, it will fall back to a simple window manager, |
320 | If all of the above fail, it will fall back to a simple window manager, |
| 325 | usually <c>twm</c>. |
321 | usually <c>twm</c>. |
| 326 | </li> |
322 | </li> |
| 327 | </ul> |
323 | </ul> |
| 328 | |
324 | |
| … | |
… | |
| 333 | <p> |
329 | <p> |
| 334 | If you see an ugly, loathsome, repulsive, deformed window manager, that's |
330 | If you see an ugly, loathsome, repulsive, deformed window manager, that's |
| 335 | <c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the |
331 | <c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the |
| 336 | upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace |
332 | upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace |
| 337 | combination. This will however make X exit disgracefully -- something that you |
333 | combination. This will however make X exit disgracefully -- something that you |
| 338 | might not always want. It doesn't hurt though :) |
334 | might not always want. It doesn't hurt though. :) |
| 339 | </p> |
335 | </p> |
| 340 | |
336 | |
| 341 | </body> |
337 | </body> |
| 342 | </section> |
338 | </section> |
| 343 | </chapter> |
339 | </chapter> |
| … | |
… | |
| 394 | EndSubSection |
390 | EndSubSection |
| 395 | EndSection |
391 | EndSection |
| 396 | </pre> |
392 | </pre> |
| 397 | |
393 | |
| 398 | <p> |
394 | <p> |
| 399 | Run X (<c>startx</c>) to discover it uses the resolution you want :) |
395 | Run X (<c>startx</c>) to discover it uses the resolution you want. :) |
| 400 | </p> |
396 | </p> |
| 401 | |
397 | |
| 402 | </body> |
398 | </body> |
| 403 | </section> |
399 | </section> |
| 404 | <section> |
400 | <section> |
| … | |
… | |
| 470 | |
466 | |
| 471 | <p> |
467 | <p> |
| 472 | Run <c>startx</c> and be happy about the result :) Congratulations, you now |
468 | Run <c>startx</c> and be happy about the result :) Congratulations, you now |
| 473 | (hopefully) have a working Xorg on your system. The next step is to remove this |
469 | (hopefully) have a working Xorg on your system. The next step is to remove this |
| 474 | ugly lightweight window manager and use a high-feature one (or even a desktop |
470 | ugly lightweight window manager and use a high-feature one (or even a desktop |
| 475 | environment) such as KDE or GNOME, but that's not part of this guide :) |
471 | environment) such as KDE or GNOME, but that's not part of this guide. :) |
| 476 | </p> |
472 | </p> |
| 477 | |
473 | |
| 478 | </body> |
474 | </body> |
| 479 | </section> |
475 | </section> |
| 480 | </chapter> |
476 | </chapter> |
| … | |
… | |
| 499 | <p> |
495 | <p> |
| 500 | There are also many online resources on editing <path>xorg.conf</path>. We only |
496 | There are also many online resources on editing <path>xorg.conf</path>. We only |
| 501 | list few of them here, be sure to <uri link="http://www.google.com">Google</uri> |
497 | list few of them here, be sure to <uri link="http://www.google.com">Google</uri> |
| 502 | for more :) As <path>xorg.conf</path> and <path>XF86Config</path> (the |
498 | for more :) As <path>xorg.conf</path> and <path>XF86Config</path> (the |
| 503 | configuration file for the XFree86 project) use the |
499 | configuration file for the XFree86 project) use the |
| 504 | same syntaxis for most configuration options and more information about |
500 | same syntax for most configuration options and more information about |
| 505 | <path>XF86Config</path> is available, we'll list those resources as well. |
501 | <path>XF86Config</path> is available, we'll list those resources as well. |
| 506 | </p> |
502 | </p> |
| 507 | |
503 | |
| 508 | <ul> |
504 | <ul> |
| 509 | <li> |
505 | <li> |
Parent Directory
| 
Revision Log
| 
Patch