| 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.12 2005/04/13 16:20:21 neysx 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.28 2009/01/26 08:08:22 nightmorph Exp $ --> |
| 6 | |
4 | |
| 7 | <guide link="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> |
|
|
11 | <author title="Editor"> |
|
|
12 | <mail link="nightmorph"/> |
|
|
13 | </author> |
| 14 | |
14 | |
| 15 | <abstract> |
15 | <abstract> |
| 16 | Xorg is the X Window server which allows users to have a graphical |
16 | Xorg is the X Window server which allows users to have a graphical |
| 17 | environment at their fingertips. This HOWTO explains what Xorg is, how to |
17 | environment at their fingertips. This HOWTO explains what Xorg is, how to |
| 18 | install it and what the various configuration options are. |
18 | install 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/2.0 --> |
22 | <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
| 23 | <license/> |
23 | <license/> |
| 24 | |
24 | |
| 25 | <version>1.10</version> |
25 | <version>1.19</version> |
| 26 | <date>2005-04-11</date> |
26 | <date>2009-01-26</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> |
| … | |
… | |
| 33 | |
33 | |
| 34 | <p> |
34 | <p> |
| 35 | The average user may be frightened at the thought of having to type in commands. |
35 | The average user may be frightened at the thought of having to type in commands. |
| 36 | Why wouldn't he be able to point and click his way through the freedom provided |
36 | Why wouldn't he be able to point and click his way through the freedom provided |
| 37 | by Gentoo (and Linux in general)? Well, *big smile*, of course you are able to |
37 | by Gentoo (and Linux in general)? Well, *big smile*, of course you are able to |
| 38 | do this :-) Linux offers a wide variety of flashy user interfaces and |
38 | do this. :-) Linux offers a wide variety of flashy user interfaces and |
| 39 | environments which you can install on top of your existing installation. |
39 | environments which you can install on top of your existing installation. |
| 40 | </p> |
40 | </p> |
| 41 | |
41 | |
| 42 | <p> |
42 | <p> |
| 43 | This is one of the biggest surprises new users come across: a graphical user |
43 | This is one of the biggest surprises new users come across: a graphical user |
| … | |
… | |
| 46 | a powerful tool that fully enables the graphical abilities of your workstation. |
46 | a powerful tool that fully enables the graphical abilities of your workstation. |
| 47 | </p> |
47 | </p> |
| 48 | |
48 | |
| 49 | <p> |
49 | <p> |
| 50 | As standards are important, a standard for drawing and moving windows on a |
50 | As standards are important, a standard for drawing and moving windows on a |
| 51 | screen, interacting with the user through mouse and keyboard and other basic yet |
51 | screen, interacting with the user through mouse, keyboard and other basic, yet |
| 52 | important aspects has been created and named the <e>X Window System</e>, |
52 | important aspects has been created and named the <e>X Window System</e>, |
| 53 | commonly abbreviated as <e>X11</e> or just <e>X</e>. It is used on Unix, Linux |
53 | commonly abbreviated as <e>X11</e> or just <e>X</e>. It is used on Unix, Linux |
| 54 | and Unix-like operating systems throughout the world. |
54 | and Unix-like operating systems throughout the world. |
| 55 | </p> |
55 | </p> |
| 56 | |
56 | |
| 57 | <p> |
57 | <p> |
| 58 | The application that provides Linux users with the ability to run graphical |
58 | The application that provides Linux users with the ability to run graphical |
| 59 | user interfaces and that uses the X11 standard is Xorg-X11, a fork of |
59 | user interfaces and that uses the X11 standard is Xorg-X11, a fork of |
| 60 | the XFree86 project. XFree86 has decided to use a license that might not be |
60 | the XFree86 project. XFree86 has decided to use a license that might not be |
| 61 | compatible with the GPL license; the use of Xorg is therefore recommended. |
61 | compatible with the GPL license; the use of Xorg is therefore recommended. |
| 62 | The official Portage tree does not provide an XFree86 package anymore. |
62 | The official Portage tree does not provide an XFree86 package anymore. |
| 63 | </p> |
63 | </p> |
| 64 | |
64 | |
| 65 | </body> |
65 | </body> |
| 66 | </section> |
66 | </section> |
| … | |
… | |
| 68 | <title>The X.org Project</title> |
68 | <title>The X.org Project</title> |
| 69 | <body> |
69 | <body> |
| 70 | |
70 | |
| 71 | <p> |
71 | <p> |
| 72 | The <uri link="http://www.x.org">X.org</uri> project created and |
72 | The <uri link="http://www.x.org">X.org</uri> project created and |
| 73 | maintains a freely redistributable open-source implementation of the X11 system. |
73 | maintains a freely redistributable, open-source implementation of the X11 |
| 74 | It is an open source X11-based desktop infrastructure. |
74 | system. It is an open source X11-based desktop infrastructure. |
| 75 | </p> |
75 | </p> |
| 76 | |
76 | |
| 77 | <p> |
77 | <p> |
| 78 | Xorg provides an interface between your hardware and the graphical software |
78 | Xorg provides an interface between your hardware and the graphical software |
| 79 | you want to run. Besides that, Xorg is also fully network-aware, meaning you |
79 | you want to run. Besides that, Xorg is also fully network-aware, meaning you |
| 80 | are able to run an application on one system while viewing it on a different |
80 | are able to run an application on one system while viewing it on a different |
| 81 | one. |
81 | one. |
| 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 | <body> |
91 | <body> |
| 92 | |
92 | |
|
|
93 | <p> |
|
|
94 | Before installing Xorg you have to configure two important variables in the |
|
|
95 | <path>/etc/make.conf</path> file. |
| 93 | <p> |
96 | </p> |
| 94 | Enough chitchat, let's get to business shall we? To install Xorg, you just |
97 | |
| 95 | need to run <c>emerge xorg-x11</c>. Installing Xorg does take a while |
98 | <p> |
| 96 | though, so you might want to grab a snack while you are waiting. |
99 | The first one is <c>VIDEO_CARDS</c>. This is used to set the video drivers that |
|
|
100 | you intend to use and is usually based on the kind and brand of card you have. |
|
|
101 | The most common settings are <c>nvidia</c> for Nvidia cards or <c>fglrx</c> for |
|
|
102 | ATI Radeon cards. Those are the proprietary drivers from Nvidia and ATI |
|
|
103 | respectively. If you would like to use the open source versions, use <c>nv</c> |
|
|
104 | rather than <c>nvidia</c> in the variable, but bear in mind that using this |
|
|
105 | driver means no 3D acceleration at all. The free <c>radeon</c> and |
|
|
106 | <c>radeonhd</c> drivers for ATI cards support 3D acceleration on older Radeons |
|
|
107 | but don't yet support all the features of the newer ones. <c>VIDEO_CARDS</c> may |
|
|
108 | contain more than one driver, in this case list of them should be separated with |
|
|
109 | spaces. |
|
|
110 | </p> |
|
|
111 | |
|
|
112 | <p> |
|
|
113 | The second variable is <c>INPUT_DEVICES</c> and is used to determine which |
|
|
114 | drivers are to be built for input devices. In most cases setting it to |
|
|
115 | <c>keyboard mouse</c> should work just fine. If you use alternative input |
|
|
116 | devices, such as a Synaptics touchpad for a laptop, be sure to add it to |
|
|
117 | <c>INPUT_DEVICES</c>. |
|
|
118 | </p> |
|
|
119 | |
|
|
120 | <p> |
|
|
121 | Now you should decide which drivers you will use and add necessary settings to |
|
|
122 | the <path>/etc/make.conf</path> file: |
|
|
123 | </p> |
|
|
124 | |
|
|
125 | <pre caption="Sample make.conf entries"> |
|
|
126 | <comment>(For mouse and keyboard support)</comment> |
|
|
127 | INPUT_DEVICES="keyboard mouse" |
|
|
128 | <comment>(For Nvidia cards)</comment> |
|
|
129 | VIDEO_CARDS="nvidia" |
|
|
130 | <comment>(OR, for ATI Radeon cards)</comment> |
|
|
131 | VIDEO_CARDS="fglrx" |
|
|
132 | </pre> |
|
|
133 | |
|
|
134 | <p> |
|
|
135 | More instructions on how to configure nVidia and ATI cards can be found in |
|
|
136 | <uri link="/doc/en/nvidia-guide.xml">Gentoo Linux nVidia Guide</uri> and in |
|
|
137 | <uri link="/doc/en/ati-faq.xml">Gentoo Linux ATI FAQ</uri>. If you don't know |
|
|
138 | which drivers you should choose, refer to these guides for more information. |
|
|
139 | </p> |
|
|
140 | |
|
|
141 | <note> |
|
|
142 | If the suggested settings don't work for you, you should run <c>emerge -pv |
|
|
143 | xorg-server</c>, check all the options available and choose those which apply to |
|
|
144 | your system. The example is for the amd64 architecture and |
|
|
145 | <c>xorg-server-1.2</c>. |
|
|
146 | </note> |
|
|
147 | |
|
|
148 | <pre caption="Displaying all the driver options available"> |
|
|
149 | # <i>emerge -pv xorg-server</i> |
|
|
150 | |
|
|
151 | These are the packages that would be merged, in order: |
|
|
152 | |
|
|
153 | Calculating dependencies... done! |
|
|
154 | [ebuild R ] x11-base/xorg-server-1.2.0-r3 USE="dri nptl xorg (-3dfx) -debug |
|
|
155 | -dmx -ipv6 -kdrive -minimal -sdl -xprint" INPUT_DEVICES="keyboard mouse -acecad |
|
|
156 | -aiptek -calcomp -citron -digitaledge -dmc -dynapro -elo2300 -elographics -evdev |
|
|
157 | -fpit -hyperpen -jamstudio -joystick -magellan -microtouch -mutouch -palmax |
|
|
158 | -penmount -spaceorb -summa -synaptics -tek4957 -ur98 -vmmouse -void -wacom" |
|
|
159 | VIDEO_CARDS="nvidia -apm -ark -chips -cirrus -cyrix -dummy -epson -fbdev -fglrx |
|
|
160 | -glint -i128 (-i740) -i810 (-impact) (-imstt) -mach64 -mga -neomagic (-newport) |
|
|
161 | (-nsc) -nv -r128 -radeon -rendition -s3 -s3virge -savage -siliconmotion -sis |
|
|
162 | -sisusb (-sunbw2) (-suncg14) (-suncg3) (-suncg6) (-sunffb) (-sunleo) (-suntcx) |
|
|
163 | -tdfx -tga -trident -tseng -v4l -vesa -vga -via -vmware -voodoo" 0 kB |
|
|
164 | </pre> |
|
|
165 | |
|
|
166 | <p> |
|
|
167 | After setting all the necessary variables you can install the Xorg package. |
| 97 | </p> |
168 | </p> |
| 98 | |
169 | |
| 99 | <pre caption="Installing Xorg"> |
170 | <pre caption="Installing Xorg"> |
| 100 | # <i>emerge xorg-x11</i> |
171 | # <i>emerge xorg-x11</i> |
| 101 | </pre> |
172 | </pre> |
| 102 | |
173 | |
| 103 | <p> |
174 | <p> |
| 104 | When the installation is finished, you might need to reinitialise some |
175 | When the installation is finished, you might need to re-initialise some |
| 105 | environment variables before you continue. Just run <c>env-update</c> followed |
176 | environment variables before you continue. Just run <c>env-update</c> followed |
| 106 | by <c>source /etc/profile</c> and you're all set. This doesn't harm your system |
177 | by <c>source /etc/profile</c> and you're all set. |
| 107 | in any way. |
|
|
| 108 | </p> |
178 | </p> |
| 109 | |
179 | |
| 110 | <pre caption="Reinitialising the environment variables"> |
180 | <pre caption="Re-initialising the environment variables"> |
| 111 | # <i>env-update</i> |
181 | # <i>env-update</i> |
| 112 | # <i>source /etc/profile</i> |
182 | # <i>source /etc/profile</i> |
| 113 | </pre> |
183 | </pre> |
| 114 | |
184 | |
| 115 | </body> |
185 | </body> |
| … | |
… | |
| 143 | <section> |
213 | <section> |
| 144 | <title>Default: Automatic Generation of xorg.conf</title> |
214 | <title>Default: Automatic Generation of xorg.conf</title> |
| 145 | <body> |
215 | <body> |
| 146 | |
216 | |
| 147 | <p> |
217 | <p> |
| 148 | Xorg itself is able to guess most parameters for you. In most cases, you |
218 | Xorg itself is able to guess most parameters for you. In most cases, you |
| 149 | will only have to change some lines to get the resolution you want up and |
219 | will only have to change some lines to get the resolution you want up and |
| 150 | running. If you are interested in more in-depth tweaking, be sure to check the |
220 | running. If you are interested in more in-depth tweaking, be sure to check the |
| 151 | resources at the end of this chapter. But first, let us generate a (hopefully |
221 | resources at the end of this chapter. But first, let us generate a (hopefully |
| 152 | working) Xorg configuration file. |
222 | working) Xorg configuration file. |
| 153 | </p> |
223 | </p> |
| 154 | |
224 | |
| 155 | <pre caption="Generating an xorg.conf file"> |
225 | <pre caption="Generating an xorg.conf file"> |
| 156 | # <i>Xorg -configure</i> |
226 | # <i>Xorg -configure</i> |
| 157 | </pre> |
227 | </pre> |
| … | |
… | |
| 159 | <p> |
229 | <p> |
| 160 | Be sure to read the last lines printed on your screen when Xorg has finished |
230 | Be sure to read the last lines printed on your screen when Xorg has finished |
| 161 | probing your hardware. If it tells you it failed at some point, you're forced to |
231 | probing your hardware. If it tells you it failed at some point, you're forced to |
| 162 | manually write an <path>xorg.conf</path> file. Assuming that it didn't fail, it |
232 | manually write an <path>xorg.conf</path> file. Assuming that it didn't fail, it |
| 163 | will have told you that it has written <path>/root/xorg.conf.new</path> ready |
233 | will have told you that it has written <path>/root/xorg.conf.new</path> ready |
| 164 | for you to test. So let's test :) |
234 | for you to test. So let's test. :) |
| 165 | </p> |
235 | </p> |
| 166 | |
236 | |
| 167 | <pre caption="Testing the xorg.conf.new file"> |
237 | <pre caption="Testing the xorg.conf.new file"> |
| 168 | # <i>X -config /root/xorg.conf.new</i> |
238 | # <i>X -config /root/xorg.conf.new</i> |
| 169 | </pre> |
239 | </pre> |
| 170 | |
240 | |
| 171 | <p> |
241 | <p> |
| 172 | If all goes well, you should see a simple black and white pattern. Verify if |
242 | If all goes well, you should see a simple black and white pattern. Verify if |
| 173 | your mouse works correctly and if the resolution is good. You might not be able |
243 | your mouse works correctly and if the resolution is good. If you received errors |
|
|
244 | about "/dev/mouse", try changing your mouse device to <c>/dev/input/mice</c> in |
|
|
245 | the "InputDevice" section of <path>xorg.conf</path>. You might not be able to |
| 174 | to deduce the exact resolution, but you should be able to see if it's too low. |
246 | deduce the exact resolution, but you should be able to see if it's too low. You |
| 175 | You can exit any time by pressing Ctrl-Alt-Backspace. |
247 | can exit any time by pressing Ctrl-Alt-Backspace. |
| 176 | </p> |
248 | </p> |
| 177 | |
249 | |
| 178 | </body> |
250 | </body> |
| 179 | </section> |
251 | </section> |
| 180 | <section> |
252 | <section> |
| … | |
… | |
| 191 | # <i>xorgconfig</i> |
263 | # <i>xorgconfig</i> |
| 192 | </pre> |
264 | </pre> |
| 193 | |
265 | |
| 194 | <p> |
266 | <p> |
| 195 | Another tool, also provided by Xorg, is <c>xorgcfg</c>, which will first |
267 | Another tool, also provided by Xorg, is <c>xorgcfg</c>, which will first |
| 196 | attempts to run <c>Xorg -configure</c> and then start the X server for more |
268 | attempt to run <c>Xorg -configure</c> and then start the X server for more |
| 197 | final tweaking. |
269 | final tweaking. |
| 198 | </p> |
270 | </p> |
| 199 | |
271 | |
| 200 | <pre caption="Using xorgcfg"> |
272 | <pre caption="Using xorgcfg"> |
| 201 | # <i>xorgcfg</i> |
273 | # <i>xorgcfg</i> |
|
|
274 | <comment>(In case X crashes or the configuration fails, try:)</comment> |
|
|
275 | # <i>xorgcfg -textmode</i> |
| 202 | </pre> |
276 | </pre> |
| 203 | |
277 | |
| 204 | </body> |
278 | </body> |
| 205 | </section> |
279 | </section> |
| 206 | <section> |
280 | <section> |
| … | |
… | |
| 208 | <body> |
282 | <body> |
| 209 | |
283 | |
| 210 | <p> |
284 | <p> |
| 211 | Let us copy over the <path>xorg.conf.new</path> to |
285 | Let 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 |
286 | <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 :) |
287 | <c>X -config</c> -- typing just <c>X</c> or <c>startx</c> is easier. :) |
| 214 | </p> |
288 | </p> |
| 215 | |
289 | |
| 216 | <pre caption="Copying over xorg.conf"> |
290 | <pre caption="Copying over xorg.conf"> |
| 217 | # <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i> |
291 | # <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i> |
| 218 | </pre> |
292 | </pre> |
| … | |
… | |
| 239 | Otherwise, it will read the value of the XSESSION variable and will execute |
313 | 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> |
314 | 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> |
315 | 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). |
316 | to make it a default for all the users on the system). |
| 243 | </li> |
317 | </li> |
| 244 | <li> |
318 | <li> |
| 245 | If all of the above fail, it will fall back to a simple window manager, |
319 | If all of the above fail, it will fall back to a simple window manager, |
| 246 | usually <c>twm</c>. |
320 | usually <c>twm</c>. |
| 247 | </li> |
321 | </li> |
| 248 | </ul> |
322 | </ul> |
| 249 | |
323 | |
| … | |
… | |
| 253 | |
327 | |
| 254 | <p> |
328 | <p> |
| 255 | If you see an ugly, loathsome, repulsive, deformed window manager, that's |
329 | If 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 |
330 | <c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the |
| 257 | upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace |
331 | upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace |
| 258 | combination. This will however make X exit disgracefully - something that you |
332 | combination. This will however make X exit disgracefully -- something that you |
| 259 | might not always want. It doesn't hurt though :) |
333 | might not always want. It doesn't hurt though. :) |
| 260 | </p> |
334 | </p> |
| 261 | |
335 | |
| 262 | </body> |
336 | </body> |
| 263 | </section> |
337 | </section> |
| 264 | </chapter> |
338 | </chapter> |
| … | |
… | |
| 269 | <body> |
343 | <body> |
| 270 | |
344 | |
| 271 | <p> |
345 | <p> |
| 272 | If you feel that the screen resolution is wrong, you will need to check two |
346 | If you feel that the screen resolution is wrong, you will need to check two |
| 273 | sections in your configuration. First of all, you have the <e>Screen</e> section |
347 | sections in your configuration. First of all, you have the <e>Screen</e> section |
| 274 | which lists the resolutions - if any - that your X server will run at. By |
348 | which lists the resolutions, if any that your X server will run at. By |
| 275 | default, this section might not list any resolutions at all. If this is the |
349 | default, this section might not list any resolutions at all. If this is the |
| 276 | case, Xorg will estimate the resolutions based on the information in the |
350 | case, Xorg will estimate the resolutions based on the information in the |
| 277 | second section, <e>Monitor</e>. |
351 | second section, <e>Monitor</e>. |
| 278 | </p> |
352 | </p> |
| 279 | |
353 | |
| … | |
… | |
| 286 | use a tool that searches for your monitor's specs, such as |
360 | use a tool that searches for your monitor's specs, such as |
| 287 | <c>sys-apps/ddcxinfo-knoppix</c>. |
361 | <c>sys-apps/ddcxinfo-knoppix</c>. |
| 288 | </p> |
362 | </p> |
| 289 | |
363 | |
| 290 | <warn> |
364 | <warn> |
| 291 | Do <b>not</b> "just" change the values of these two monitor-related variables |
365 | Do <b>not</b> "just" change the values of these two monitor related variables |
| 292 | without consulting the technical specifications of your monitor. Setting |
366 | without consulting the technical specifications of your monitor. Setting |
| 293 | incorrect values lead to out-of-sync errors at best and smoked up screens at |
367 | incorrect values lead to out-of-sync errors at best and smoked up screens at |
| 294 | worst. |
368 | worst. |
| 295 | </warn> |
369 | </warn> |
| 296 | |
370 | |
| 297 | <p> |
371 | <p> |
| 298 | Now let us change the resolutions. In the next example from |
372 | Now 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 |
373 | <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 |
374 | <c>DefaultDepth</c> so that our X server starts with 24 bits at 1024x768 by |
| 301 | default. Don't mind the given strings - they are examples and will most likely |
375 | default. Don't mind the given strings -- they are examples and will most likely |
| 302 | differ from the settings on your system. |
376 | differ from the settings on your system. |
| 303 | </p> |
377 | </p> |
| 304 | |
378 | |
| 305 | <pre caption="Changing the Screen section in /etc/X11/xorg.conf"> |
379 | <pre caption="Changing the Screen section in /etc/X11/xorg.conf"> |
| 306 | Section "Screen" |
380 | Section "Screen" |
| … | |
… | |
| 315 | EndSubSection |
389 | EndSubSection |
| 316 | EndSection |
390 | EndSection |
| 317 | </pre> |
391 | </pre> |
| 318 | |
392 | |
| 319 | <p> |
393 | <p> |
| 320 | Run X (<c>startx</c>) to discover it uses the resolution you want :) |
394 | Run X (<c>startx</c>) to discover it uses the resolution you want. :) |
| 321 | </p> |
395 | </p> |
| 322 | |
396 | |
| 323 | </body> |
397 | </body> |
| 324 | </section> |
398 | </section> |
| 325 | <section> |
399 | <section> |
| … | |
… | |
| 352 | |
426 | |
| 353 | <p> |
427 | <p> |
| 354 | If your mouse isn't working, you will first need to find out if it is detected |
428 | If your mouse isn't working, you will first need to find out if it is detected |
| 355 | by the kernel at all. Mice are (device-wise) seen as |
429 | by the kernel at all. Mice are (device-wise) seen as |
| 356 | <path>/dev/input/mouse0</path> (or <path>/dev/input/mice</path> if you want to |
430 | <path>/dev/input/mouse0</path> (or <path>/dev/input/mice</path> if you want to |
|
|
431 | use several mice). In some cases <path>/dev/psaux</path> is used. In either |
| 357 | use several mice). In either case you can check if the devices do represent |
432 | case you can check if the devices do represent |
| 358 | your mouse by checking the output of those files when you move your mouse. To |
433 | your mouse by checking the output of those files when you move your mouse. You |
| 359 | end the session press <c>Ctrl-C</c>. |
434 | will usually see some junk on your screen. To end the session press |
|
|
435 | <c>Ctrl-C</c>. |
| 360 | </p> |
436 | </p> |
| 361 | |
437 | |
| 362 | <pre caption="Checking the device files"> |
438 | <pre caption="Checking the device files"> |
| 363 | # <i>cat /dev/input/mouse0</i> |
439 | # <i>cat /dev/input/mouse0</i> |
| 364 | <comment>(Don't forget to press Ctrl-C to end this)</comment> |
440 | <comment>(Don't forget to press Ctrl-C to end this)</comment> |
| … | |
… | |
| 367 | <p> |
443 | <p> |
| 368 | If your mouse isn't detected, verify if all the necessary modules are loaded. |
444 | If your mouse isn't detected, verify if all the necessary modules are loaded. |
| 369 | </p> |
445 | </p> |
| 370 | |
446 | |
| 371 | <p> |
447 | <p> |
| 372 | If your mouse is detected, fill in the device in the appropriate |
448 | If 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 |
449 | <e>InputDevice</e> section. In the next example you'll see we also set two other |
| 374 | options: <c>Protocol</c> (which lists the mouse protocol to be used - most users |
450 | options: <c>Protocol</c> (which lists the mouse protocol to be used -- most |
| 375 | will use PS/2 or IMPS/2) and <c>ZAxisMapping</c> (which allows for the |
451 | users will use PS/2 or IMPS/2) and <c>ZAxisMapping</c> (which allows for the |
| 376 | mousewheel (if applicable) to be used). |
452 | mousewheel (if applicable) to be used). |
| 377 | </p> |
453 | </p> |
| 378 | |
454 | |
| 379 | <pre caption="Changing the mouse settings in Xorg"> |
455 | <pre caption="Changing the mouse settings in Xorg"> |
| 380 | Section "InputDevice" |
456 | Section "InputDevice" |
| … | |
… | |
| 386 | <i>Option "ZAxisMapping" "4 5"</i> |
462 | <i>Option "ZAxisMapping" "4 5"</i> |
| 387 | EndSection |
463 | EndSection |
| 388 | </pre> |
464 | </pre> |
| 389 | |
465 | |
| 390 | <p> |
466 | <p> |
| 391 | Run <c>startx</c> and be happy about the result :) Congratulations, you now |
467 | Run <c>startx</c> and be happy about the result. :) Congratulations, you now |
| 392 | (hopefully) have a working Xorg on your system. The next step is to remove this |
468 | (hopefully) have a working Xorg on your system. The next step is to remove this |
| 393 | ugly lightweight window manager and use a high-feature one (or even a desktop |
469 | ugly lightweight window manager and use a high-feature one (or even a desktop |
| 394 | environment) such as KDE or GNOME, but that's not part of this guide :) |
470 | environment) such as KDE or GNOME, but that's not part of this guide. :) |
| 395 | </p> |
471 | </p> |
| 396 | |
472 | |
| 397 | </body> |
473 | </body> |
| 398 | </section> |
474 | </section> |
| 399 | </chapter> |
475 | </chapter> |
| … | |
… | |
| 402 | <section> |
478 | <section> |
| 403 | <title>Creating and Tweaking xorg.conf</title> |
479 | <title>Creating and Tweaking xorg.conf</title> |
| 404 | <body> |
480 | <body> |
| 405 | |
481 | |
| 406 | <p> |
482 | <p> |
| 407 | First of all, <c>man 5 xorg.conf</c> provides a quick yet complete reference |
483 | First of all, <c>man xorg.conf</c> provides a quick yet complete reference |
| 408 | about the syntaxis used by the configuration file. Be sure to have it open on a |
484 | about the syntax used by the configuration file. Be sure to have it open on a |
| 409 | terminal near you when you edit your configuration file! |
485 | terminal near you when you edit your configuration file! |
| 410 | </p> |
486 | </p> |
| 411 | |
487 | |
| 412 | <p> |
488 | <p> |
| 413 | A second point of resources on your system is the |
489 | Also, be sure to look at <path>/etc/X11/xorg.conf.example</path>; you may wish |
| 414 | <path>/usr/X11R6/lib/X11/doc</path> directory with various <path>README</path>'s |
490 | to copy this and use it as a foundation for writing your own |
| 415 | for individual graphical chipsets. |
491 | <path>xorg.conf</path>. |
|
|
492 | </p> |
|
|
493 | |
|
|
494 | <p> |
|
|
495 | You may find the X.org <uri link="http://www.x.org/wiki/FAQ">FAQ</uri> provided |
|
|
496 | on their website, in addition to their other documentation. |
| 416 | </p> |
497 | </p> |
| 417 | |
498 | |
| 418 | <p> |
499 | <p> |
| 419 | There are also many online resources on editing <path>xorg.conf</path>. We only |
500 | There are also many online resources on editing <path>xorg.conf</path>. We only |
| 420 | list few of them here, be sure to <uri link="http://www.google.com">Google</uri> |
501 | list few of them here, be sure to <uri link="http://www.google.com">Google</uri> |
| 421 | for more :) As <path>xorg.conf</path> and <path>XF86Config</path> (the |
502 | for more. :) As <path>xorg.conf</path> and <path>XF86Config</path> (the |
| 422 | configuration file for the XFree86 project) use the |
503 | configuration file for the XFree86 project) use the |
| 423 | same syntaxis for most configuration options and more information about |
504 | same syntax for most configuration options and more information about |
| 424 | <path>XF86Config</path> is available, we'll list those resources as well. |
505 | <path>XF86Config</path> is available, we'll list those resources as well. |
| 425 | </p> |
506 | </p> |
| 426 | |
507 | |
| 427 | <ul> |
508 | <ul> |
| 428 | <li> |
509 | <li> |
| … | |
… | |
| 436 | </li> |
517 | </li> |
| 437 | </ul> |
518 | </ul> |
| 438 | |
519 | |
| 439 | </body> |
520 | </body> |
| 440 | </section> |
521 | </section> |
|
|
522 | <section> |
|
|
523 | <title>Other resources</title> |
|
|
524 | <body> |
|
|
525 | |
|
|
526 | <p> |
|
|
527 | More information about installing and configuring various graphical desktop |
|
|
528 | environments and applications can be found in the <uri |
|
|
529 | link="/doc/en/?catid=desktop">Gentoo Desktop Documentation Resources</uri> |
|
|
530 | section of our documentation. |
|
|
531 | </p> |
|
|
532 | |
|
|
533 | </body> |
|
|
534 | </section> |
| 441 | </chapter> |
535 | </chapter> |
| 442 | </guide> |
536 | </guide> |