SliTaz Repositories

     1.1 --- a/en/doc/handbook/index.html	Sat Apr 19 12:48:26 2008 +0100
     1.2 +++ b/en/doc/handbook/index.html	Tue Apr 22 20:46:47 2008 +0000
     1.3 @@ -41,7 +41,7 @@
     1.4  	static IP or PPP dialup connection, Firewall (Iptables).</li>
     1.5  	<li><a href="system-admin.html">System administration</a> - Mount devices,
     1.6  	manage users and groups, adjust system time.</li>
     1.7 -	<li><a href="x-window.html">X Window System</a> - Xvesa server, Slim Login
     1.8 +	<li><a href="x-window.html">X Window System</a> - Xvesa &amp; Xorg server, Slim Login
     1.9  	and Window managers.</li>
    1.10  	<li><a href="gen-livecd.html">Generate a LiveCD flavor</a> - Generate your
    1.11  	own LiveCD flavor using Tazlito.</li>

     2.1 --- a/en/doc/handbook/x-window.html	Sat Apr 19 12:48:26 2008 +0100
     2.2 +++ b/en/doc/handbook/x-window.html	Tue Apr 22 20:46:47 2008 +0000
     2.3 @@ -29,13 +29,14 @@
     2.4  <h2><font color="#df8f06">X Window System</font></h2>
     2.5  
     2.6  <ul>
     2.7 -	<li><a href="#X11">X Window System</a></li>
     2.8 -	<li><a href="#slim">Slim</a> - Simple Login Manager</li>
     2.9 -	<li><a href="#jwm">JWM</a> - Window Manager</li>
    2.10 -	<li><a href="#enlightenment">Enlightenment (e17)</a> - Desktop
    2.11 +	<li><a href="#X11">X Window System.</a></li>
    2.12 +	<li><a href="#slim">Slim</a> - Simple Login Manager.</li>
    2.13 +	<li><a href="#xorg">Xorg</a> - X server.</li>
    2.14 +	<li><a href="#jwm">JWM</a> - Window Manager.</li>
    2.15 +	<li><a href="#enlightenment">Enlightenment (e17).</a> - Desktop
    2.16  	environment.</li>
    2.17  	<li><a href="#openbox">Openbox</a> - Window Manager.</li>
    2.18 -	<li><a href="#fonts">Fonts</a> - System Fonts</li>
    2.19 +	<li><a href="#fonts">Fonts</a> - System Fonts.</li>
    2.20  </ul>
    2.21  
    2.22  <a name="X11"></a>
    2.23 @@ -79,6 +80,101 @@
    2.24  <pre class="script">default_user        hacker
    2.25  </pre>
    2.26  
    2.27 +<a name="xorg"></a>
    2.28 +<h3>Xorg</h3>
    2.29 +<p>
    2.30 +By default SliTaz provides the graphical mini-server Xvesa. Xorg server is available 
    2.31 +in the packages on the mirror. Xorg is a very comprehensive server, but uses a lot more 
    2.32 +resources than Xvesa. If your resolution is supported by the mini-server and you're happy
    2.33 +with the refresh rate, then there's no reason to use Xorg.
    2.34 +</p>
    2.35 +<p>
    2.36 +There is no GUI configuration, it means having to use the command line in console mode. The installation
    2.37 +and configuration of the server is relatively simple and you can always go back and reuse Xvesa at any time.
    2.38 +Xorg is distributed in modular form, which means that you'll need to install the server, a few configuration
    2.39 +files and the right driver for your graphics card. However the <code>xorg-server</code> package has all 
    2.40 +the correct dependancies to work directly with the <code>vesa</code> driver. Minimal install:
    2.41 +</p>
    2.42 +<pre> # tazpkg get-install xorg-server
    2.43 +</pre>
    2.44 +<p>
    2.45 +Once installed, you can go directly to the configuration or you can install the correct driver for your card
    2.46 +(if you know it). Example using the Nvidia driver and listing all available drivers:
    2.47 +</p>
    2.48 +<pre> # tazpkg get-install xorg-xf86-video-nv
    2.49 + List:
    2.50 + # tazpkg search xorg-xf86-video
    2.51 +</pre>
    2.52 +<h4>Automatic configuration of the server</h4>
    2.53 +
    2.54 +<p>To configure the Xorg server you have two options: <code>Xorg -configure</code> 
    2.55 +or the script <code>xorgconfig</code>. It is recommended that you start by using Xorg with 
    2.56 +the <code>-configure</code> option. The automatic configuration of Xorg must be done in console
    2.57 +mode without an X-server running; this is achieved by closing all applications and windows and hitting
    2.58 +the <code>alt-ctrl-del</code> buttons. You should now be in console mode. Now you need to run Xorg with the
    2.59 +<code>-configure</code> option and copy the newly generated file to <code>/etc/X11</code>: 
    2.60 +</p>
    2.61 +<pre> # Xorg -configure
    2.62 + # cp /root/xorg.conf.new /etc/X11/xorg.conf
    2.63 +</pre>
    2.64 +<p>
    2.65 +Finally you then change the configuration of Slim to use Xorg instead of Xvesa and restart the window manager.
    2.66 +</p>
    2.67 +<h4>Using Xorg with Slim</h4>
    2.68 +<p>
    2.69 +In the Slim configuration file (<code>/etc/slim.conf</code>), we need to comment out
    2.70 +(<code>#</code>) the lines pertaining to Xvesa and change Xorg to the <code>default_xserver</code>:
    2.71 +</p>
    2.72 +<pre class="script">default_xserver     /usr/bin/Xorg
    2.73 +#default_xserver     /usr/bin/Xvesa
    2.74 +#xserver_arguments   -ac -shadow dpms +extension Composite -screen 1024x768x24
    2.75 +</pre>
    2.76 +<p>
    2.77 +Now we can start Slim to return us to an X server session. 
    2.78 +Slim works likes a daemon, it can be stopped or started from the console:
    2.79 +</p>
    2.80 +<pre> # /etc/init.d/slim start
    2.81 +</pre>
    2.82 +<h4>xorg.conf - Configuration file</h4>
    2.83 +<p>
    2.84 +Xorg uses the configuration file <code>/etc/X11/xorg.conf</code>, this file can be
    2.85 +automatically generated and edited with your favorite text editor. The file is divided into
    2.86 +several sections, including the specification of paths, modules to be loaded, default screen, 
    2.87 +mouse, keyboard etc. This document provides only a few examples, it is advisable to run
    2.88 +<code>xorgconfig</code> once to generate a complete file to use as an example.
    2.89 +
    2.90 +</p>
    2.91 +<p>
    2.92 +Keyboard (en):
    2.93 +</p>
    2.94 +<pre class="script">Section "InputDevice"
    2.95 +	Identifier  "Keyboard0"
    2.96 +	Driver      "kbd"
    2.97 +	Option      "XkbRules"	"xorg"
    2.98 +	Option      "XkbModel"	"pc105"
    2.99 +	Option      "XkbLayout"	"en"
   2.100 +	Option      "XkbVariant"	"en"
   2.101 +EndSection
   2.102 +</pre>
   2.103 +<p>
   2.104 +Mice with auto detection protocol:
   2.105 +</p>
   2.106 +<pre class="script">Section "InputDevice"
   2.107 +	Identifier  "Mouse0"
   2.108 +	Driver      "mouse"
   2.109 +	Option	    "Protocol" "auto"
   2.110 +	Option	    "Device" "/dev/input/mice"
   2.111 +	Option	    "ZAxisMapping" "4 5 6 7"
   2.112 +EndSection
   2.113 +</pre>
   2.114 +<p>
   2.115 +Composite extensions:
   2.116 +</p>
   2.117 +<pre class="script">Section "Extensions"
   2.118 +	Option      "Composite" "1"
   2.119 +EndSection
   2.120 +</pre>
   2.121 +
   2.122  <a name="jwm"></a>
   2.123  <h3>JWM - Window manager</h3>
   2.124  <p>