| 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.9 2005/03/25 15:55:32 swift 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.8</version> |
| 26 | <date>2005-02-07</date> |
26 | <date>2005-03-25</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> |
| 172 | If all goes well, you should see an ugly, loathsome, repulsive, deformed |
172 | If all goes well, you should see a simple black and white pattern. Verify if |
| 173 | window manager called <c>twm</c>, probably the smallest window manager |
173 | your mouse works correctly and if the resolution is good. You might not be able |
| 174 | available. Try moving your mouse and see if your keyboard and such is working. |
174 | to deduce the exact resolution, but you should be able to see if it's too low. |
| 175 | In the next section we will optimize our <path>xorg.conf</path> so it fits your |
175 | You can exit any time by pressing Ctrl-Alt-Backspace. |
| 176 | hardware. 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 |
|
|
| 178 | use your mouse to focus the terminals, you can also press Ctrl-Alt-Backspace to |
|
|
| 179 | kill the X server. |
|
|
| 180 | </p> |
|
|
| 181 | |
|
|
| 182 | <p> |
|
|
| 183 | If <c>twm</c> doesn't load, don't worry - it will once you'll start the X server |
|
|
| 184 | through the regular <c>startx</c> command. Verify if your mouse works correctly |
|
|
| 185 | and if the resolution is good. You might not be able to deduce the exact |
|
|
| 186 | resolution, but you should be able to see if it's too low. You can exit any time |
|
|
| 187 | by pressing Ctrl-Alt-Backspace. |
|
|
| 188 | </p> |
176 | </p> |
| 189 | |
177 | |
| 190 | </body> |
178 | </body> |
| 191 | </section> |
179 | </section> |
| 192 | <section> |
180 | <section> |
| … | |
… | |
| 203 | # <i>xorgconfig</i> |
191 | # <i>xorgconfig</i> |
| 204 | </pre> |
192 | </pre> |
| 205 | |
193 | |
| 206 | </body> |
194 | </body> |
| 207 | </section> |
195 | </section> |
|
|
196 | <section> |
|
|
197 | <title>Copying over xorg.conf</title> |
|
|
198 | <body> |
|
|
199 | |
|
|
200 | <p> |
|
|
201 | Let us copy over the <path>xorg.conf.new</path> to |
|
|
202 | <path>/etc/X11/xorg.conf</path> now, so we won't have to continuously run |
|
|
203 | <c>X -config</c> -- typing just <c>X</c> or <c>startx</c> is far more easy :) |
|
|
204 | </p> |
|
|
205 | |
|
|
206 | <pre caption="Copying over xorg.conf"> |
|
|
207 | # <i>cp /root/xorg.conf.new /etc/X11/xorg.conf</i> |
|
|
208 | </pre> |
|
|
209 | |
|
|
210 | </body> |
|
|
211 | </section> |
|
|
212 | <section id="using_startx"> |
|
|
213 | <title>Using startx</title> |
|
|
214 | <body> |
|
|
215 | |
|
|
216 | <p> |
|
|
217 | Now try <c>startx</c> to start up your X server. <c>startx</c> is a script |
|
|
218 | that executes an <e>X session</e>, that is, it starts the X servers and some |
|
|
219 | graphical applications on top of it. It decides which applications to run |
|
|
220 | using the following logic: |
|
|
221 | </p> |
|
|
222 | |
|
|
223 | <ul> |
|
|
224 | <li> |
|
|
225 | If a file named <path>.xinitrc</path> exists in the home directory, it will |
|
|
226 | execute the commands listed there. |
|
|
227 | </li> |
|
|
228 | <li> |
|
|
229 | Otherwise, it will read the value of the XSESSION variable and will execute |
|
|
230 | one of the sessions available in <path>/etc/X11/Sessions/</path> |
|
|
231 | accordingly (you can set the value of XSESSION in <path>/etc/rc.conf</path> |
|
|
232 | to make it a default for all the users on the system). |
|
|
233 | </li> |
|
|
234 | <li> |
|
|
235 | If all of the above fail, it will fall back to a simple window manager, |
|
|
236 | usually <c>twm</c>. |
|
|
237 | </li> |
|
|
238 | </ul> |
|
|
239 | |
|
|
240 | <pre caption="Starting X"> |
|
|
241 | # <i>startx</i> |
|
|
242 | </pre> |
|
|
243 | |
|
|
244 | <p> |
|
|
245 | If you see an ugly, loathsome, repulsive, deformed window manager, that's |
|
|
246 | <c>twm</c>. To finish the twm session, type in <c>exit</c> or Ctrl-D in the |
|
|
247 | upcoming xterms. You can also kill the X session using the Ctrl-Alt-Backspace |
|
|
248 | combination. This will however make X exit disgracefully - something that you |
|
|
249 | might not always want. It doesn't hurt though :) |
|
|
250 | </p> |
|
|
251 | |
|
|
252 | </body> |
|
|
253 | </section> |
| 208 | </chapter> |
254 | </chapter> |
| 209 | <chapter> |
255 | <chapter> |
| 210 | <title>Tweaking xorg.conf</title> |
256 | <title>Tweaking xorg.conf</title> |
| 211 | <section> |
|
|
| 212 | <title>Copying over xorg.conf</title> |
|
|
| 213 | <body> |
|
|
| 214 | |
|
|
| 215 | <p> |
|
|
| 216 | Let 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> |
|
|
| 226 | Now run <c>startx</c> to start up your X server. It will use the freshly copied |
|
|
| 227 | file as its configuration file. To finish the X session, type in <c>exit</c> or |
|
|
| 228 | Ctrl-D in the upcoming xterms. You can also kill the X session using the |
|
|
| 229 | Ctrl-Alt-Backspace combination. This will however make X exit disgracefully - |
|
|
| 230 | something 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> |
257 | <section> |
| 240 | <title>Setting your Resolution</title> |
258 | <title>Setting your Resolution</title> |
| 241 | <body> |
259 | <body> |
| 242 | |
260 | |
| 243 | <p> |
261 | <p> |