[gentoo-commits] gentoo commit in xml/htdocs/doc/en: xorg-config.xml

["Joshua Saddler (nightmorph)" <nightmorph@gentoo.org>]

nightmorph    10/03/16 20:07:44

  Modified:             xorg-config.xml
  Log:
  added the -retro option per bug 267769. also added a bit on installing twm and xterm only for testing purposes, since otherwise startx will just display a black screen. having a few open xterm windows makes it easier to verify that X is setup correctly.

Revision  Changes    Path
1.37                 xml/htdocs/doc/en/xorg-config.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/xorg-config.xml?rev=1.37&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/xorg-config.xml?rev=1.37&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/xorg-config.xml?r1=1.36&r2=1.37

Index: xorg-config.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v
retrieving revision 1.36
retrieving revision 1.37
diff -u -r1.36 -r1.37
--- xorg-config.xml	2 Jan 2010 03:02:40 -0000	1.36
+++ xorg-config.xml	16 Mar 2010 20:07:43 -0000	1.37
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.36 2010/01/02 03:02:40 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/xorg-config.xml,v 1.37 2010/03/16 20:07:43 nightmorph Exp $ -->
 
 <guide>
 <title>The X Server Configuration HOWTO</title>
@@ -22,8 +22,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.26</version>
-<date>2010-01-01</date>
+<version>1.27</version>
+<date>2010-03-16</date>
 
 <chapter>
 <title>What is the X Window Server?</title>
@@ -398,7 +398,7 @@
 </p>
 
 <pre caption="Testing the xorg.conf.new file">
-# <i>X -config /root/xorg.conf.new</i>
+# <i>X -config -retro /root/xorg.conf.new</i>
 </pre>
 
 <p>
@@ -454,12 +454,27 @@
 </ul>
 
 <pre caption="Starting X">
-# <i>startx</i>
+$ <i>startx</i>
 </pre>
 
 <p>
-You can kill the X session using the Ctrl-Alt-Backspace combination. This will
-however make X exit disgracefully -- something that you might not always want.
+You can kill the X session by using the Ctrl-Alt-Backspace combination. This
+will, however, make X exit disgracefully -- something that you might not always
+want.
+</p>
+
+<p>
+If you haven't yet installed a window manager, all you'll see is a black screen.
+Since this can also be a sign that something's wrong, you may want to emerge
+<c>twm</c> and <c>xterm</c> <e>only to test X</e>.
+</p>
+
+<p>
+Once those two programs are installed, run <c>startx</c> again. A few xterm
+windows should appear, making it easier to verify that X is working correctly.
+Once you're satisfied with the results, run <c>emerge --unmerge twm xterm</c> as
+root to get rid of the testing packages. You won't need them once you've setup a
+proper desktop environment.
 </p>
 
 </body>
@@ -519,7 +534,7 @@
 </pre>
 
 <p>
-Run X (<c>startx</c>) to discover it uses the resolution you want. :)
+Run X (<c>startx</c>) to discover it uses the resolution you want.
 </p>
 
 </body>