SliTaz Repositories

     1.1 --- a/en/doc/handbook/x-window.html	Fri Apr 11 21:57:21 2008 +0000
     1.2 +++ b/en/doc/handbook/x-window.html	Sat Apr 26 23:25:13 2008 +0000
     1.3 @@ -29,13 +29,14 @@
     1.4  <h2><font color="#df8f06">X Window System</font></h2>
     1.5  
     1.6  <ul>
     1.7 -	<li><a href="#X11">X Window System</a></li>
     1.8 -	<li><a href="#slim">Slim</a> - Simple Login Manager</li>
     1.9 -	<li><a href="#jwm">JWM</a> - Window Manager</li>
    1.10 -	<li><a href="#enlightenment">Enlightenment (e17)</a> - Desktop
    1.11 +	<li><a href="#X11">X Window System.</a></li>
    1.12 +	<li><a href="#slim">Slim</a> - Simple Login Manager.</li>
    1.13 +	<li><a href="#xorg">Xorg</a> - X server.</li>
    1.14 +	<li><a href="#jwm">JWM</a> - Window Manager.</li>
    1.15 +	<li><a href="#enlightenment">Enlightenment (e17).</a> - Desktop
    1.16  	environment.</li>
    1.17  	<li><a href="#openbox">Openbox</a> - Window Manager.</li>
    1.18 -	<li><a href="#fonts">Fonts</a> - System Fonts</li>
    1.19 +	<li><a href="#fonts">Fonts</a> - System Fonts.</li>
    1.20  </ul>
    1.21  
    1.22  <a name="X11"></a>
    1.23 @@ -79,6 +80,101 @@
    1.24  <pre class="script">default_user        hacker
    1.25  </pre>
    1.26  
    1.27 +<a name="xorg"></a>
    1.28 +<h3>Xorg</h3>
    1.29 +<p>
    1.30 +By default SliTaz provides the graphical mini-server Xvesa. Xorg server is available 
    1.31 +in the packages on the mirror. Xorg is a very comprehensive server, but uses a lot more 
    1.32 +resources than Xvesa. If your resolution is supported by the mini-server and you're happy
    1.33 +with the refresh rate, then there's no reason to use Xorg.
    1.34 +</p>
    1.35 +<p>
    1.36 +There is no GUI configuration, it means having to use the command line in console mode. The installation
    1.37 +and configuration of the server is relatively simple and you can always go back and reuse Xvesa at any time.
    1.38 +Xorg is distributed in modular form, which means that you'll need to install the server, a few configuration
    1.39 +files and the right driver for your graphics card. However the <code>xorg-server</code> package has all 
    1.40 +the correct dependancies to work directly with the <code>vesa</code> driver. Minimal install:
    1.41 +</p>
    1.42 +<pre> # tazpkg get-install xorg-server
    1.43 +</pre>
    1.44 +<p>
    1.45 +Once installed, you can go directly to the configuration or you can install the correct driver for your card
    1.46 +(if you know it). Example using the Nvidia driver and listing all available drivers:
    1.47 +</p>
    1.48 +<pre> # tazpkg get-install xorg-xf86-video-nv
    1.49 + List:
    1.50 + # tazpkg search xorg-xf86-video
    1.51 +</pre>
    1.52 +<h4>Automatic configuration of the server</h4>
    1.53 +
    1.54 +<p>To configure the Xorg server you have two options: <code>Xorg -configure</code> 
    1.55 +or the script <code>xorgconfig</code>. It is recommended that you start by using Xorg with 
    1.56 +the <code>-configure</code> option. The automatic configuration of Xorg must be done in console
    1.57 +mode without an X-server running; this is achieved by closing all applications and windows and hitting
    1.58 +the <code>alt-ctrl-del</code> buttons. You should now be in console mode. Now you need to run Xorg with the
    1.59 +<code>-configure</code> option and copy the newly generated file to <code>/etc/X11</code>: 
    1.60 +</p>
    1.61 +<pre> # Xorg -configure
    1.62 + # cp /root/xorg.conf.new /etc/X11/xorg.conf
    1.63 +</pre>
    1.64 +<p>
    1.65 +Finally you then change the configuration of Slim to use Xorg instead of Xvesa and restart the window manager.
    1.66 +</p>
    1.67 +<h4>Using Xorg with Slim</h4>
    1.68 +<p>
    1.69 +In the Slim configuration file (<code>/etc/slim.conf</code>), we need to comment out
    1.70 +(<code>#</code>) the lines pertaining to Xvesa and change Xorg to the <code>default_xserver</code>:
    1.71 +</p>
    1.72 +<pre class="script">default_xserver     /usr/bin/Xorg
    1.73 +#default_xserver     /usr/bin/Xvesa
    1.74 +#xserver_arguments   -ac -shadow dpms +extension Composite -screen 1024x768x24
    1.75 +</pre>
    1.76 +<p>
    1.77 +Now we can start Slim to return us to an X server session. 
    1.78 +Slim works likes a daemon, it can be stopped or started from the console:
    1.79 +</p>
    1.80 +<pre> # /etc/init.d/slim start
    1.81 +</pre>
    1.82 +<h4>xorg.conf - Configuration file</h4>
    1.83 +<p>
    1.84 +Xorg uses the configuration file <code>/etc/X11/xorg.conf</code>, this file can be
    1.85 +automatically generated and edited with your favorite text editor. The file is divided into
    1.86 +several sections, including the specification of paths, modules to be loaded, default screen, 
    1.87 +mouse, keyboard etc. This document provides only a few examples, it is advisable to run
    1.88 +<code>xorgconfig</code> once to generate a complete file to use as an example.
    1.89 +
    1.90 +</p>
    1.91 +<p>
    1.92 +Keyboard (en):
    1.93 +</p>
    1.94 +<pre class="script">Section "InputDevice"
    1.95 +	Identifier  "Keyboard0"
    1.96 +	Driver      "kbd"
    1.97 +	Option      "XkbRules"	"xorg"
    1.98 +	Option      "XkbModel"	"pc105"
    1.99 +	Option      "XkbLayout"	"en"
   1.100 +	Option      "XkbVariant"	"en"
   1.101 +EndSection
   1.102 +</pre>
   1.103 +<p>
   1.104 +Mice with auto detection protocol:
   1.105 +</p>
   1.106 +<pre class="script">Section "InputDevice"
   1.107 +	Identifier  "Mouse0"
   1.108 +	Driver      "mouse"
   1.109 +	Option	    "Protocol" "auto"
   1.110 +	Option	    "Device" "/dev/input/mice"
   1.111 +	Option	    "ZAxisMapping" "4 5 6 7"
   1.112 +EndSection
   1.113 +</pre>
   1.114 +<p>
   1.115 +Composite extensions:
   1.116 +</p>
   1.117 +<pre class="script">Section "Extensions"
   1.118 +	Option      "Composite" "1"
   1.119 +EndSection
   1.120 +</pre>
   1.121 +
   1.122  <a name="jwm"></a>
   1.123  <h3>JWM - Window manager</h3>
   1.124  <p>