<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article  PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<article version="5.0" xml:lang="en" xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink">
  <info>
    <title>Salix Start Up Guide</title>
  </info>
  <para><inlinemediaobject><imageobject role="html">
        <imagedata align="left" contentdepth="272" contentwidth="643" fileref="./SalixStartUpGuide_13.37_draft4_html_m40f9ce97.jpg" scalefit="1"/>
      </imageobject>
<imageobject role="fo">
        <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m40f9ce97.jpg" scalefit="1" width="100%"/>
      </imageobject>
</inlinemediaobject></para>
  <para><emphasis>13.37</emphasis></para>
  <para><emphasis role="bold">Start up guide</emphasis></para>
  <anchor xml:id="Table-of-Contents1"/>
  <anchor xml:id="Table-of-Contents1_Head"/>
  <section remap="h2">
    <title><emphasis role="bold">Table of Contents</emphasis></title>
    <para><emphasis role="bold">1</emphasis><link linkend="dbdoclet.1"><emphasis role="bold">Salix OS at a Glance</emphasis></link><emphasis role="bold">4</emphasis></para>
    <para><emphasis role="bold">2</emphasis><link linkend="dbdoclet.2"><emphasis role="bold">Starting Up Salix OS</emphasis></link><emphasis role="bold">7</emphasis></para>
    <para>2.1 <link linkend="dbdoclet.2_1">Introduction</link> 7</para>
    <para>2.2 <link linkend="dbdoclet.2_2">Installing Salix</link> 10</para>
    <para>2.3 <link linkend="dbdoclet.2_3">Installing from a Live CD / USB</link> 13</para>
    <para>2.4 <link linkend="dbdoclet.2_4">Installing from a Salix Installation CD</link> 16</para>
    <para>2.5 <link linkend="dbdoclet.2_5">Installing from a Salix Installation USB</link> 19</para>
    <para><emphasis role="bold">3</emphasis><link linkend="dbdoclet.3"><emphasis role="bold">Your Salix</emphasis></link><emphasis role="bold">20</emphasis></para>
    <para>3.1 <link linkend="dbdoclet.3_1">Package Management</link> 20</para>
    <para>3.2 <link linkend="dbdoclet.3_2">Configuring Your Salix</link> 24</para>
    <para>3.3 <link linkend="dbdoclet.3_3">Salix Tools</link> 27</para>
    <para>3.4 <link linkend="dbdoclet.3_4">Salix Live Tools</link> 32</para>
    <para><emphasis role="bold">4</emphasis><link linkend="dbdoclet.4"><emphasis role="bold">Salix Mini Walkthroughs</emphasis></link><emphasis role="bold">36</emphasis></para>
    <para>4.1 <link linkend="dbdoclet.4_1">Working with the Command Line Interface</link> 36</para>
    <para>4.2 <link linkend="dbdoclet.4_2">Getting started with Salix Ratpoison</link> 42</para>
    <para><emphasis role="bold">5</emphasis><link linkend="dbdoclet.5"><emphasis role="bold">Advanced Live CD Options</emphasis></link><emphasis role="bold">52</emphasis></para>
    <para>5.1 <link linkend="dbdoclet.5_1">Advanced Boot Options</link> 52</para>
    <para>5.2 <link linkend="dbdoclet.5_2">Linux Live Scripts</link> 56</para>
    <para>5.3 <link linkend="dbdoclet.5_3">Personalising a Module</link> 57</para>
    <para><emphasis role="bold">6</emphasis><link linkend="dbdoclet.6"><emphasis role="bold">Support</emphasis></link><emphasis role="bold">60</emphasis></para>
    <para><emphasis role="bold">7</emphasis><link linkend="dbdoclet.7">Appendix</link><emphasis role="bold">63</emphasis></para>
    <section remap="h3">
      <title><emphasis><emphasis role="bold">About this manual</emphasis></emphasis></title>
      <para>The purpose of this manual is to enable you to take full advantage of the many functionalities of Salix OS. The latest version of this document is available from <link xl:href="http://www.salixos.org/wiki/index.php/Salix_Startup_Guide">our website</link>.</para>
    </section>
    <section remap="h2">
      <title><emphasis role="bold">The Salix OS start up guide is released under theCC-BY-SA 3.0license.</emphasis></title>
      <para>Last updated on 7 October 2011 by <emphasis>tsuren</emphasis></para>
      <para><emphasis><emphasis role="bold">Your contribution is important!</emphasis></emphasis></para>
      <para>We would like to improve the quality of the manual and to provide more documents translated in your mother tongue. Your help is always welcome.</para>
      <para>For any comments and submission of articles to be included in the start up guide, please contact <emphasis>tsuren</emphasis> on the forum or write to:</para>
      <para><emphasis><link xl:href="mailto:salix-main@lists.sourceforge.net">salix-main@lists.sourceforge.net</link></emphasis></para>
      <para><emphasis><emphasis role="bold">Acknowledgement</emphasis></emphasis></para>
      <para>My sincere thanks to all the people who have contributed to and worked on this start up guide, including translators.</para>
      <para>Many thanks especially to <emphasis><emphasis role="bold">jrd</emphasis></emphasis>, <emphasis><emphasis role="bold">akuna</emphasis></emphasis>, <emphasis><emphasis role="bold">mimosa</emphasis></emphasis> and <emphasis><emphasis role="bold">maximus</emphasis></emphasis> for their contributions in writing and thorough proof-reading.</para>
    </section>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.1" xreflabel=""/><emphasis role="bold">1. Salix OS at a Glance</emphasis></title>
     <section remap="h2">
      <title>Salix OS is a<link xl:href="http://en.wikipedia.org/wiki/Linux_distro">Linux Distribution</link>based on<link xl:href="http://en.wikipedia.org/wiki/Slackware">Slackware</link>that retains full backwards compatibility with its illustrious parent. However, while the<link xl:href="http://en.wikipedia.org/wiki/KISS_principle">KISS</link>principle that Slackware adheres to refers to the viewpoint of system design, Salix OS also applies it to the viewpoint of the end user.</title>
      <section remap="h3">
        <title>Salix Features</title>
        <itemizedlist><listitem>
            <para> One application per task rationale</para>
          </listitem>
<listitem>
            <para> Fully backwards compatible with Slackware</para>
          </listitem>
<listitem>
            <para> Optimised for desktop usage</para>
          </listitem>
<listitem>
            <para> With Salix tools to assist<link linkend="salix-tools">system management</link></para>
          </listitem>
<listitem>
            <para> High quality package repositories with dependency support</para>
          </listitem>
<listitem>
            <para> Simple &amp; fully localised system administration tools</para>
          </listitem>
<listitem>
            <para> Salix artwork</para>
          </listitem>
<listitem>
            <para> Live CD / USB option</para>
          </listitem>
<listitem>
            <para> Supports 32-bit and 64-bit architectures</para>
          </listitem>
<listitem>
            <para> Comes with a complete development environment</para>
          </listitem>
</itemizedlist>
      </section>
      <section remap="h3">
        <title>Salix Editions</title>
        <para></para>
      </section>
    </section>
    <section remap="h2">
      <title><emphasis role="bold">Salix OS</emphasis>comes in five different editions -<emphasis role="bold">Xfce</emphasis>,<emphasis role="bold">LXDE</emphasis>,<emphasis role="bold">KDE</emphasis>,<emphasis role="bold">Fluxbox</emphasis>and<emphasis role="bold">Ratpoison</emphasis>.</title>
      <para></para>
    </section>
    <section remap="h2">
      <title>The choice is yours: with a<emphasis>streamlined</emphasis>Xfce desktop environment,<emphasis>elegant</emphasis>KDE 4.5.5 accompanied by a very rich collection of KDE centric software,<emphasis>minimalistic</emphasis>Fluxbox window manager, wickedly fast LXDE desktop or &quot;say good-bye to the rodent&quot; Ratpoison, all with the Salix look and feel!</title>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="269" contentwidth="671" fileref="./SalixStartUpGuide_13.37_draft4_html_m2df8c4d5.jpg" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m2df8c4d5.jpg" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para><emphasis role="bold">For a list of applications available in each Edition, please refer to the later section (&quot;List of Applications&quot;)</emphasis></para>
      <section remap="h3">
        <title>Installation Modes</title>
        <para>Salix offers three software installation options: <emphasis role="bold">Full</emphasis>, <emphasis role="bold">Basic</emphasis> and <emphasis role="bold">Core</emphasis>, to meet your demands!</para>
        <informaltable frame="none">
          <tgroup cols="4">
            <colspec colname="c1" colwidth="112"/>
            <colspec colname="c2" colwidth="164"/>
            <colspec colname="c3" colwidth="162"/>
            <colspec colname="c4" colwidth="149"/>
            <tbody>
              <row>
                <entry><para> <emphasis role="bold">Installation Type</emphasis></para></entry>
                <entry><para> <emphasis role="bold">Target Users</emphasis></para></entry>
                <entry><para> <emphasis role="bold">Features</emphasis></para></entry>
                <entry><para> <emphasis role="bold">Examples of Available Applications</emphasis></para></entry>
              </row>
            </tbody>
            <tbody>
              <row>
                <entry><para> Full</para></entry>
                <entry><para> All users</para></entry>
                <entry><para> ▫ Graphical environment</para><para>▫ Full software installation</para></entry>
                <entry><para> ▫ Libreoffice</para><para>▫ Exaile</para><para>▫ Firefox / Midori</para><para>▫ Pidgin</para></entry>
              </row>
              <row>
                <entry><para> Basic</para></entry>
                <entry><para> Advanced users who would like to add their own choice of applications</para></entry>
                <entry><para> ▫ Graphical environment</para><para>▫ Minimum selection of software</para></entry>
                <entry><para> ▫ Firefox / Midori</para><para>▫ Gslapt</para><para>▫ Desktop</para></entry>
              </row>
              <row>
                <entry><para> Core</para></entry>
                <entry><para> Advanced users who would like to run a console system</para><para>Server maintainers</para></entry>
                <entry><para> ▫ No graphical environment</para><para>▫ Minimum number of software essential for a console system</para></entry>
                <entry><para> ▫ vi</para></entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
      </section>
      <section remap="h3">
        <title>Salix Repositories &amp; Package Management</title>
        <itemizedlist><listitem>
            <para> <emphasis role="bold">slapt-get</emphasis>and its graphical interface<emphasis role="bold">Gslapt</emphasis>are used for package management, including<emphasis role="bold">slapt-src</emphasis>and<emphasis role="bold">Sourcery</emphasis>for even wider selection of software to choose from!</para>
          </listitem>
<listitem>
            <para> A wide range of packages from Slackware, Slackbuild and Salix repositories</para>
          </listitem>
<listitem>
            <para> The Salix repositories offer<emphasis role="bold">dependency resolution support</emphasis>and are the<emphasis role="bold">largest</emphasis>third party software package repositories for Slackware offered to date</para>
          </listitem>
<listitem>
            <para> The Salix repositories are offered for both the<emphasis role="bold">32-bit</emphasis>and<emphasis role="bold">64-bit</emphasis>architectures</para>
          </listitem>
</itemizedlist>
      </section>
      <section remap="h3">
        <title>In Short, Salix OS is...</title>
        <para>DBQUOTE<emphasis>Like a bonsai, Salix is small, light &amp; the product of infinite care!DBQUOTE</emphasis></para>
      </section>
    </section>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.2" xreflabel=""/>2. Starting Up  Salix OS</title>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.2_1" xreflabel=""/>2.1 Introduction</title>
      <section remap="h3">
        <title><emphasis>D<inlinemediaobject><imageobject role="html">
                <imagedata align="left" contentdepth="25" contentwidth="46" fileref="./SalixStartUpGuide_13.37_draft4_html_m591e5637.gif" scalefit="1"/>
              </imageobject>
<imageobject role="fo">
                <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m591e5637.gif" scalefit="1" width="100%"/>
              </imageobject>
</inlinemediaobject>ownloading Salix OS</emphasis></title>
        <para>The latest Salix OS or Salix Live releases are freely and easily available as ISO image files from the Salix OS <link xl:href="http://www.salixos.org/wiki/index.php?title=Download">download page</link>.</para>
        <para>An ISO image is an archive file of an optical disc. It can be easily rendered or burned to a DVD or CD by using media authoring or disc burning software. The resulting CD must not contain the .iso file; if it does, you have made a mistake in the process.</para>
        <para><emphasis>It is recommended, if possible, to verify the integrity of your downloaded file by comparing its<link xl:href="http://en.wikipedia.org/wiki/Md5sum">md5sum</link>file with the original one uploaded besides the corresponding ISO image file by Salix OS. This ensures that your downloaded image file matches exactly with the one provided on the Salix OS website, and minimises the possibility of installation errors later on.</emphasis></para>
      </section>
      <section remap="h3">
        <title>What is a Live CD / USB?</title>
        <para>A Live CD is a CD-ROM holding a self-contained bootable and fully functional operating system. It loads into memory using only the data provided on the CD. It will not modify any operating system or data present on its host computer and will leave no trace after shutdown.</para>
        <para>A Live USB flash drive is similar to a Live CD, but it can have the added functionality of automatically and transparently writing changes back to its bootable medium.</para>
        <para>Salix Live is the Live CD version of<link xl:href="http://www.salixos.org/">Salix OS</link>. You can therefore safely use it to &apos;test drive&apos; Salix OS without having to install anything on your computer. You will thus be able to determine whether and to what extent Salix OS iscompatible with your particular hardware configuration and if it suits your personal taste.</para>
        <para>If you are fully satisfied with your Live experience of Salix OS, you can then proceed to install it with the help of the Salix Live Installer.</para>
        <para>Salix Live will also come in handy as a mobile solution if you wish to carry Salix OS everywhere you go, or if you need to perform some basic rescue operation such as fixing an ailing LILO bootloader with Lilo Setup, configuring some partitions with Gparted, etc.</para>
      </section>
      <section remap="h3">
        <title>Creating a Salix Live USB Key</title>
        <orderedlist><listitem>
            <para> Open the .iso file using a software archiver (file-roller, xarchiver, 7-zip, iso-master, …).</para>
          </listitem>
<listitem>
            <para> Extract all files and folders (boot, packages and Salix Live) to your USB root directory.</para>
          </listitem>
<listitem>
            <para> Go to the &quot;boot&quot; directory on the USB key.</para>
          </listitem>
<listitem>
            <para> If you&apos;re running on Unix (Linux, BSD, Mac OS X), just run the file called &quot;install-on-USB.sh&quot;. If you&apos;re on Windows, just run the file called &quot;install-on-USB.cmd&quot; instead.</para>
          </listitem>
</orderedlist>
      </section>
      <section remap="h3">
        <title>Booting from a Salix Installation CD/DVD/USB Key</title>
        <para>Your computer must be set to boot on the optical drive / USB port first before defaulting to the internal hard disk drive.</para>
        <para>If that is not the case, you need to first modify the<link xl:href="http://en.wikipedia.org/wiki/BIOS">BIOS</link>setting, usually by pressing the Del key or the F2 key (or some other key combinations depending on your machine). Once in the BIOS, find the &quot;boot menu&quot; or similar and set the order of the boot devices properly, with your optical drive/USB port in the first position. Save your changes and reboot your computer.</para>
        <para>Insert the Salix OS (Live)CD/DVD or USB key, and start up your computer.</para>
      </section>
      <section remap="h3">
        <title>Salix Live Boot Menu</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="200" contentwidth="390" fileref="./SalixStartUpGuide_13.37_draft4_html_m4f770b90.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m4f770b90.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para> The first screen to greet you will enable you to select your language. Once you have selected your language, simply press on the Enter key to activate your choice.</para>
        <para>On the following menu, you will be given the possibility to change your keyboard map if the default one for your language does not suit you.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="236" contentwidth="391" fileref="./SalixStartUpGuide_13.37_draft4_html_m2a61f76.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m2a61f76.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>You also have the possibility to<link linkend="advanced_boot">modify most default boot settings</link>.</para>
        <para>Simply press Enter on the default menu entry: Start Salix Live and a moment later you will see Salix starting up.</para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="root_pass" xreflabel=""/>Root Password</title>
        <para>For a system wide change, such as installation of an application, you are required to type in the administrator&apos;s password (the &quot;root&quot; or &quot;superuser&quot; password). The password for Salix Live is &quot;<emphasis role="bold">live</emphasis>&quot; for all the Salix Live editions.</para>
        <para><anchor xml:id="live-tools" xreflabel=""/><anchor xml:id="salix-live-installer" xreflabel=""/></para>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.2_2" xreflabel=""/> 2.2 Installing Salix</title>
      <section remap="h3">
        <title>Before starting</title>
        <para>Installing Salix OS on your computer is simple. But before starting, it is wise to check the following points:</para>
        <itemizedlist><listitem>
            <para> Have you backed-up all the important files you have?</para>
          </listitem>
<listitem>
            <para> Check if your computer comes with Linux-friendly/supported hardware@star</para>
          </listitem>
<listitem>
            <para> Recommended running specification (Intel PIII 1 GHz, 512 Mb RAM, 8Gb HD space, or equivalent, though a lower spec machine may run without a problem)</para>
          </listitem>
<listitem>
            <para> At least one separate<link xl:href="http://en.wikipedia.org/wiki/Disk_partitioning">partition</link>dedicated for Salix on your computer</para>
          </listitem>
</itemizedlist>
        <para>@star Although it is possible to install Linux on a Mac computer, you have to install a bootcamp software called rEFIt beforehand. Certain file systems, such as xfs, cannot be used with a Mac.</para>
        <para>The easiest way to check the compatibility of your computer is to use one of the available Salix OS Live editions.</para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="partition-management" xreflabel=""/>Partition Management</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="303" contentwidth="441" fileref="./SalixStartUpGuide_13.37_draft4_html_m4548ab69.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m4548ab69.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Before installing Salix (from the live CD or not), you need to have the necessary partition space available on your system, and if the computer does not have a separate partition for Linux, you must create one before installing Salix OS.</para>
        <para><emphasis>It is advisable to back up any important files before modifying the partition table.</emphasis></para>
        <para>Every Salix Live CD comes with <link xl:href="http://gparted.sourceforge.net/docs/help-manual/C/gparted_manual.html">Gparted</link>, which will enable you to change the partition organisation on a disk device while preserving the contents of the partitions. You may with to use this application to create/re-organise your partition table.</para>
        <para>Alternatively, if you have an unformatted partition, unallocated disk space, or an existing partition you do not use, you can create or rewrite a new partition table using<link xl:href="http://en.wikipedia.org/wiki/Cfdisk">c</link><link xl:href="http://en.wikipedia.org/wiki/Cfdisk">fdisk</link>(which comes with the Salix installation CD).</para>
        <para>Both applications are simple to use and require no further explanation on how to use them, except for a small comment about &quot;partition types&quot;.</para>
        <para>A hard drive space can be divided into no more than four &quot;primary&quot; partitions, which can be problematic if you are hosting more than one operating system on the same hard drive. A hard drive can, however, be divided into three &quot;primary&quot; partitions and one &quot;extended&quot; partition. The extended partition can then be subdivided into &quot;logical&quot; partitions and hence overcome the limitation set by the &quot;primary partition&quot; (i.e. no more than four partitions). In practice, there is no difference between a logical and a primary partition except for that &quot;Windows&quot; OS cannot be installed on a logical partition.</para>
      </section>
      <section remap="h3">
        <title>So what kind of partitions do you need?</title>
        <orderedlist><listitem>
            <para> Salix needs, at the very minimum, one partition which holds the root directory and must be assigned as &quot;/&quot; (without the quotation marks).</para>
          </listitem>
<listitem>
            <para> It is highly recommended to have one swap partition. If you already have another Linux OS running on your machine, its swap partition can be shared, and you do not need to create another. A swap partition size is in essence used as an extra RAM to improve the performance of your machine.If, for example, your machine doesn&apos;t have a lot of physical RAM or you&apos;re performing memory-intensive operations (such as video editing) that use up most or all of the physical RAM. It is normally recommended to have 1.5-2 times the size of your RAM, but for a modern desktop computer with more than a couple Gb of RAM, swap may not be necessary.</para>
          </listitem>
<listitem>
            <para> It is also highly recommended to have one partition to hold your /home directory, where you can store all your personal data such as documents, photos, customised settings for the desktop environment etc.</para>
          </listitem>
<listitem>
            <para> It is optional to have one partition to hold the /usr directory, where application files are stored (similar to the &quot;Program Files&quot; directory in Windows or the &quot;/Apps&quot; in Mac OS X).</para>
          </listitem>
<listitem>
            <para> Optionally you can create one partition to hold the /var directory, where system log files are stored. But unless you are running a server machine, this is probably unnecessary.</para>
            <para>An advantage of having more than one partition to hold separate directories is that you can reformat one partition without affecting others. For example, you can re-install Salix on your machine (and this goes to the partition holding the &quot;/&quot; directory) while leaving the partition holding the /home directory intact.</para>
          </listitem>
</orderedlist>
        <para>Each partition can be formatted intoone of several<link xl:href="http://en.wikipedia.org/wiki/List_of_file_systems">file systems</link>. Unless you have a particular favourite for a reason, we recommend you format your partitions with the ext4 file system.</para>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.2_3" xreflabel=""/> 2.3 Installing from a Live CD / USB</title>
      <para>Salix Live Installer is found on the Desktop of every Live CD and is very easy to use. Contextual help triggered by the position of the mouse will be displayed above the application and will guide you every step of the way.</para>
      <para>You will be greeted by a reminder that all the necessary partitions have to be created first. As we have seen, this can be done simply with the help of<link linkend="gparted">Gparted</link>, which is included in Salix Live and is available directly on the desktop.</para>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="33" contentwidth="78" fileref="./SalixStartUpGuide_13.37_draft4_html_46a995ce.png" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_46a995ce.png" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para>On the left side of the application, you will notice the different sections that must be configured before launching the installation process: Time, Keyboard, Locale, Partitions, Users and Software. Clicking on one of these sections will display the corresponding options that need to be set. As you progress through the configuration process, a check will be displayed beside each completed section. Only when all the sections have been completed will the &quot;Launch Salix Install&quot; button be activated.</para>
      <para>So do take the time to familiarise yourself fully with Salix Live Installer. Undo options are available and none of the settings will be applied until you click on the &quot;Launch Salix Install&quot; button.</para>
      <para>Remember that the existing swap partition will be automatically used by the Live installer without any prompting on your part.</para>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="33" contentwidth="78" fileref="./SalixStartUpGuide_13.37_draft4_html_1289aa62.png" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_1289aa62.png" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para>Salix comes with three different installation modes. The Full installation mode includes a range of useful applications one could need on a daily basis while following the &quot;one application per task&quot; rationale, while the Basic Mode provides a user with a graphical desktop environment, a web browser and <link linkend="gslapt">Gslapt package manager</link>.</para>
      <para>This is ideal for advanced users who would like to have the basic desktop environment installed first, and then to add their own choice of applications. The Core Mode installs the minimum software essential for a console system to start (i.e. a graphical environment is not provided). This is ideal if you are an experienced user and love to customise your installation for any specific purpose, such as a web server, file server and so on.</para>
      <para>Once the installation process is completed, you will be given the choice to launch <link linkend="lilosetup">Lilo Setup</link> to configure your LILO bootloader. Most of the time this is what you will want to do although occasionally, it might be preferable not to, for example if you want to use Grub instead or if you want to simply incorporate Salix into an existing bootloader configuration from another distribution in a multiple boot setup.</para>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="346" contentwidth="439" fileref="./SalixStartUpGuide_13.37_draft4_html_609b5e05.png" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_609b5e05.png" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para>Lilo Setup is also very easy to use. Contextual help triggered by the position of the mouse will also be displayed above the application and will guide you every step of the way.</para>
      <para>Once Lilo is set up, you are good to go! You can re-start your machine, and start enjoying Salix time.</para>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.2_4" xreflabel=""/> 2.4 Installing from a Salix Installation CD</title>
      <para>Installing Salix from a Salix Installation CD is very similar to installing Slackware. Everything will be done efficiently in a semi-graphical command line interface.</para>
      <orderedlist><listitem>
          <para> Select your keymap.</para>
        </listitem>
<listitem>
          <para> If you prefer to let Salix do everything including partition management, just select AUTOPARTITION. Note that this will delete everything on the hard drive.</para>
        </listitem>
<listitem>
          <para> Partition management with cfdisk - you can select the hard drive you would like to modify with the arrow keys and the space key.</para>
        </listitem>
<listitem>
          <para> You can create a new partition by selecting a free disk space and choosing<emphasis role="bold">New</emphasis>. You will be asked to select &quot;primary&quot; partition / &quot;extended&quot; partition first and then set the size. Remember, you can have up to four primary partitions or three primary partition with one extended partition for more partitions. Let&apos;s say we want to create one swap partition and partitions for the &quot;/&quot; and &quot;/home&quot; directories.</para>
          <para>To create a swap partition, for example, select &quot;primary&quot; partition. Hit enter (for the default starting cylinder), and then type in &quot;+1024M&quot; for 1024 Mb. Choose Type to specify the file system type. Enter<emphasis role="bold">82</emphasis>(Linux swap).</para>
          <para>Let&apos;s assume that you have already used up the first three primary partitions, the last one should be made into an &quot;extended&quot; partition as you would still like to create the partitions for &quot;/&quot; and for &quot;/home&quot;.</para>
          <para>To create an extended partition, select &quot;extended&quot; partition. Hit enter and again hit enter for the default value. This will create an extended partition out of the remaining disk space.</para>
          <para>Now select Free disk space from theextended partition, and create<emphasis role="bold">New</emphasis>. Create a &quot;logical&quot; partition as you did for the primary partition. Set the size to &quot;+10240M&quot; for roughly 10 Gb. This will be your partition for the root directory (&quot;/&quot;). Select<emphasis role="bold">Type</emphasis>, and type &quot;<emphasis role="bold">83</emphasis>&quot; (Linux partition).</para>
          <para>Create again a new partition and this time, accept all the default selections. The remaing disk space will be put in this partition. This will be your partition for the &quot;/home&quot; directory. Select<emphasis role="bold">Type</emphasis>, and type &quot;<emphasis role="bold">83</emphasis>&quot;.</para>
          <para>Select<emphasis role="bold">Write</emphasis>, and then<emphasis role="bold">Quit</emphasis>to exit the partition management.</para>
        </listitem>
<listitem>
          <para> Your swap partition will be automatically detected. Say &quot;yes&quot; if the detected partition corresponds to that.</para>
        </listitem>
<listitem>
          <para> You will then be asked to specify the partition for the root &quot;/&quot; directory. Select the partition you have created for the &quot;/&quot;, and continue to format the partition. The ext4 file system is recommended here.</para>
        </listitem>
<listitem>
          <para> If you have other partitions to mount, you can do so. As we have a partition for a &quot;/home&quot; directory, we select the partition and continue. Unless the partition is new or you would like to erase the content of this partition, select not to format.</para>
        </listitem>
<listitem>
          <para> Other partitions such as Windows partitions will be detected automatically. If you would like to make those partitions automatically usable during your Salix session, include them all to mount.</para>
        </listitem>
<listitem>
          <para> The installer will start installing Salix. You will be asked first where the source files are. As you are installing from the CD, select &quot;from the CD&quot;. Everything should be detected automatically.</para>
        </listitem>
<listitem>
          <para> You will be asked to choose an installation mode (<emphasis role="bold">Full</emphasis>,<emphasis role="bold">Basic</emphasis>or<emphasis role="bold">Core</emphasis>).</para>
        </listitem>
<listitem>
          <para> Installation of packages will start.</para>
        </listitem>
<listitem>
          <para> After the installation, LILO set up will start up. Unless you are<emphasis role="bold">not</emphasis>using LILO, choose the default options.</para>
        </listitem>
<listitem>
          <para> You will be asked for some other questions regarding time-zone, user name and root password (superuser / administrator password). When all the basic questions are answered, the machine will restart itself.</para>
        </listitem>
<listitem>
          <para> That&apos;s all. The computer is good to go! Enjoy Salix!</para>
        </listitem>
</orderedlist>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.2_5" xreflabel=""/> 2.5 Installing from a Salix Installation USB</title>
      <para>Installing Salix OS from a USB key is also possible (but consider installing from a Salix Live USB also). The most difficult part is to know the device name of your USB key. You may wish to issue the command &quot;fdisk -l&quot; as root to know which device is used for your USB key.</para>
      <orderedlist><listitem>
          <para> Create your USB stick with <link xl:href="http://unetbootin.sourceforge.net/">unetbootin</link></para>
        </listitem>
<listitem>
          <para> At Salix installation chose &quot;Install from hard disk&quot;</para>
        </listitem>
<listitem>
          <para> Enter the device of your USB stick: This probably is /dev/sdb1 if you only have one hard disk. Please note that a Few sticks are mounted by /dev/sdb instead of /dev/sdb1</para>
        </listitem>
<listitem>
          <para> The next dialog asks where the Salix packages are located on the USB stick. The correct answer here is /salix</para>
        </listitem>
<listitem>
          <para> Installation should continue normally</para>
          <para><anchor xml:id="usb-key" xreflabel=""/>Alternatively, you can mount your USB key first.</para>
        </listitem>
</orderedlist>
      <orderedlist><listitem>
          <para> After starting up the set up screen, select your keyboard type and exit the setup</para>
        </listitem>
<listitem>
          <para> Type &quot;mkdir /salix&quot; (without the quotation marks)</para>
        </listitem>
<listitem>
          <para> Type &quot;mount /dev/sdb /salix&quot; (sdb can be sdb1, depending on the assignment by your machine)</para>
        </listitem>
<listitem>
          <para> Type setup to restart the installation process</para>
        </listitem>
<listitem>
          <para> When asked for the source file, select &quot;from a local directory&quot; and type in &quot;/salix/salix&quot;</para>
        </listitem>
<listitem>
          <para> Installation should continue normally</para>
        </listitem>
</orderedlist>
    </section>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.3" xreflabel=""/>3. Your Salix</title>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.3_1" xreflabel=""/>3.1 Package Management</title>
      <para>Installing applications (which roughly equates to &quot;installing packages&quot; as we say in Linux) is a fundamental part of the Linux experience. Superficially it is just an exercise using package managers such as Gslapt and its command line equivalent, slapt-get, for installing packages created by others. Soon you will start to see some packages you are interested in are not in the common repositories, and you will start creating your own packages. For some, this could be the very first time they see their build scripts working in the terminal, checking for configuration errors and chasing after some missing dependencies to compile a program. Some frustration may hit you initially, but then in good time, you will gather enough experience and as you start to see the inner workings of Linux, you will become more confident.</para>
      <para>You have to be the<link linkend="root_pass">superuser</link>in order to install an application.</para>
      <section remap="h3">
        <title><anchor xml:id="gslapt" xreflabel=""/>Gslapt</title>
        <para>Gslapt is the GUI version of<link linkend="slapt-get">slapt-get</link>. It allows one to search Slackware/Salix mirrors and third party sources for packages.Before use you should first click on the<emphasis role="bold">Update</emphasis>button to ensure that the latest updates from the software repositories are known to Gslapt. The search field is there for you to search for a particular package. You can highlight with your left click and choose to install/uninstall/reinstall packages with a right click. Gslapt detects dependencies and will install all the dependency files for a package automatically. Installation/uninstallation/reinstallation will take place once you click on the<emphasis role="bold">Execute</emphasis>button. You can blacklist packages by adding their names to the blacklist found in &quot;Preferences&quot; under &quot;Edit&quot;.</para>
      </section>
      <section remap="h3">
        <title> </title>
        <para></para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="slapt-get" xreflabel=""/>slapt-get</title>
        <para><link xl:href="http://software.jaos.org/git/slapt-get/plain/FAQ.html">slapt-get</link>is a command line tool for Slackware package management. It allows one to search Slackware/Salix mirrors and third party sources for packages, compare them with installed packages, install new packages, or upgrade all installed packages.</para>
        <para>To use the application, open a Terminal window and issue the command &quot;<emphasis role="bold">slapt-get -u</emphasis>&quot; first to update the package database on your computer. Then &quot;<emphasis role="bold">slapt-get -l</emphasis>&quot; to list all the available packages, &quot;<emphasis role="bold">slapt-get -search [package name]</emphasis>&quot; to search for a package, and &quot;<emphasis role="bold">slapt-get -i [package name]</emphasis>&quot; to install a package. For more command line instructions, please refer to &quot;<emphasis role="bold">slapt-get --help</emphasis>&quot;.</para>
        <para>Here is a little exercise for you. Try installing &quot;w3m&quot; which is a terminal based web browser, by using slapt-get.</para>
      </section>
      <section remap="h3">
        <title>Sourcery</title>
        <para>Sourcery is a new graphical frontend to<link linkend="slapt-src">slapt-src</link>, a utility to build and install packages from source using SlackBuilds and/or SLKBUILDs. Before use, you should first click on the<emphasis role="bold">Update</emphasis>button on the tool bar to ensure that the latest updates from the software repositories are known to Sourcery. The search field is there for you to search for a particular package, and installations, uninstallations or reinstallations of selected packages are done with right clicks on their status boxes.</para>
        <para>Installation/uninstallation/reinstallation will take place once you click on the<emphasis role="bold">Execute</emphasis>button.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="314" contentwidth="382" fileref="./SalixStartUpGuide_13.37_draft4_html_m7b675ef9.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m7b675ef9.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="slapt-src" xreflabel=""/>slapt-src</title>
        <para>slapt-src is a command line tool that makes the process of downloading and building software packages from slackbuilds.org simple and easy. Slackbuilds.org keeps a large collection of build scripts for extra packages that are still not available from the official Salix / Slackware repositories. Thousands of extra packages are now available to users through this tool.</para>
        <para>To use the application, type in &quot;<emphasis role="bold">slapt-src -u</emphasis>&quot; first to update on your computer the list of build scripts available from Slackbuild.org. &quot;slapt-src -l&quot; shows you a list of availablepackages, and as in slapt-get, &quot;<emphasis role="bold">slapt-src -i [package name]</emphasis>&quot; will install a package. For more command lineinstructions, please refer to &quot;<emphasis role="bold">slapt-src -help</emphasis>&quot;.</para>
        <para>Another small exercise for you! Skype is a commonly used software to make voice calls over the Internet. It is not available from the common Salix / Slackware repository, but its build script is available from Slackbuilds.org. Try installing &quot;skype&quot; by using slapt-src. (If you do not wish to install it, you may just want to build the package. Note that the skype is 32-bit only, so if you are running a 64-bit system, please try out some other application).</para>
      </section>
      <section remap="h3">
        <title>spkg</title>
        <para>An alternative way to install a package (which for Salix and many other slackware based distribution ends with the .tgz, .tlz or .txz extension) is to use the command line input &quot;<emphasis role="bold">spkg -i [exact name of a package]</emphasis>&quot;. This is a handy way of installing a package if you have just created your own package or if you have downloaded it from the Internet. Note that the name of the package must be exact to the last extension (as in xxxxx-i486-tt.txz).</para>
        <para>Removing a package is somewhat similar. You can remove a package by issuing &quot;<emphasis role="bold">spkg -d [software name]</emphasis>&quot;, e.g. &quot;<emphasis role="bold">spkg -d skype</emphasis>&quot;.</para>
      </section>
      <section remap="h3">
        <title>Making a Package from a Source File with SLKBUILD</title>
        <para>Installing a software from a source file is in most cases not difficult. You can compile a lot of software generally with the following commands.</para>
        <orderedlist><listitem>
            <para> unpack a source file, move inside the folder</para>
          </listitem>
<listitem>
            <para> type in &quot;./configure&quot; on the terminal</para>
          </listitem>
<listitem>
            <para> type in &quot;make&quot;</para>
          </listitem>
<listitem>
            <para> type in &quot;su&quot;</para>
          </listitem>
<listitem>
            <para> type your root password</para>
          </listitem>
<listitem>
            <para> type in &quot;make install&quot;</para>
          </listitem>
</orderedlist>
        <para>(Make sure to read accompanying files such as &quot;README&quot;, &quot;INSTALL&quot; and so on for installation instructions before compiling. These files may list dependency packages which you need to install prior to the configuration.<emphasis role="bold">./configure --help</emphasis>or<emphasis role="bold">./configure --help=short output</emphasis>should also help you with some configuration options).</para>
        <para>Although you should manage to install the software after the final command, it is essentially<emphasis>untracked</emphasis>and neither Gslapt nor slapt-get can see that the software is installed. A better way is to create a Salix package using SLKBUILD, which is a build script you can prepare before issuing &quot;<emphasis role="bold">slkbuild -X</emphasis>&quot; to create a Salix compatible package. For more on SLKBULD, please consult<link xl:href="http://www.salixos.org/wiki/index.php/Building_packages_with_slkbuild">SLKBUILD</link>.</para>
      </section>
      <section remap="h3">
        <title><emphasis><emphasis role="bold">Salix Packages, that are different from Slackware</emphasis></emphasis></title>
        <para>Although the vast majority of packages found in the Salix repositories are complementary to the Slackwarerepositories, you will find that some packages are present both in the Salix repositories and in the Slackware repositories. These packages have been rebuilt for Salix OS for a number of good reasons, and a list of the packages as well as brief explanations as to why are found in<link xl:href="http://www.salixos.org/wiki/index.php/Packages,_that_are_different_from_Slackware">this wiki entry</link>.</para>
      </section>
      <section remap="h3">
        <title><emphasis>U<inlinemediaobject><imageobject role="html">
                <imagedata align="left" contentdepth="25" contentwidth="46" fileref="./SalixStartUpGuide_13.37_draft4_html_m591e5637.gif" scalefit="1"/>
              </imageobject>
<imageobject role="fo">
                <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m591e5637.gif" scalefit="1" width="100%"/>
              </imageobject>
</inlinemediaobject>pgrading Salix OS to a Newer Version</emphasis></title>
        <para>If you wish to upgrade an older version of Salix OS on your machine to the latest, please refer to the following link for upgrading your Salix OS.</para>
        <itemizedlist><listitem>
            <para> <link xl:href="http://www.salixos.org/wiki/index.php/How_to_upgrade_Salix_13.0_to_13.1">Salix 13.0 to 13.1</link></para>
          </listitem>
<listitem>
            <para> <link xl:href="http://www.salixos.org/wiki/index.php/How_to_upgrade_Salix_13.1_to_13.37">Salix 13.1 to 13.37</link></para>
          </listitem>
</itemizedlist>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.3_2" xreflabel=""/> 3.2 Configuring Your Salix</title>
      <section remap="h3">
        <title>Setting up the Internet</title>
        <para>Network connections are managed by Wicd in Salix. It is an open source wired and wireless network manager for Linux which aims to provide a simple interface to connect to networks with a wide variety of settings.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="280" contentwidth="297" fileref="./SalixStartUpGuide_13.37_draft4_html_m4a3f324d.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m4a3f324d.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>It will connect to wired (Ethernet only, no PPPoE/DSL support yet) and wireless networks.</para>
        <para>Note that<emphasis role="bold">wicd</emphasis>and<emphasis role="bold">wireless</emphasis>must be activated in the<link linkend="startupServices">startup services</link>in order to make wireless networks visible on Wicd.</para>
      </section>
      <section remap="h3">
        <title>Setting up a Printer</title>
        <para>After writing a document, transferring photos from your camera, or creating your own images with GIMP, you would probably like to print them out with your printer. To do this, you need to have a printer already installed on your system. &quot;<emphasis role="bold">Manage Printing</emphasis>&quot;, which is found under &quot;System&quot; in the main application menu, handles the installation and general management of your printers. (Ensure that &quot;CUPS&quot; is enabled in the<link linkend="startupServices">startup services</link>, or Manage Printing will not start properly).</para>
        <para>If you are buying a new printer, it is recommended to check the availability of Linux drivers beforehand from the<link xl:href="http://www.linuxfoundation.org/collaborate/workgroups/openprinting/database/databaseintro">Open Printing database</link>(or search on the Internet). Some companies offer printer drivers for Linux, but this is less common than desired, and often involves a lengthy installation process. For most Linux friendly printers, youhave to install drivers such as gutenprint and HPIJS, both of which are available from the repositories.</para>
        <orderedlist><listitem>
            <para> Select &quot;Add Printers and Classes&quot;</para>
          </listitem>
<listitem>
            <para> Under &quot;Printers&quot;, select &quot;Add Printer&quot;</para>
          </listitem>
<listitem>
            <para> Enter &quot;root&quot; as a username and your superuser password</para>
          </listitem>
<listitem>
            <para> Select your printer description and choose if you would like to share the printer</para>
          </listitem>
<listitem>
            <para> Select the correct driver from the list (Model) - see an example below. This is the important part. Or if you have a<link xl:href="http://en.wikipedia.org/wiki/PostScript_Printer_Description">PPD</link>file instead, you can load it here.</para>
            <informalfigure>
              <mediaobject>
                <imageobject role="html">
                  <imagedata align="left" contentdepth="351" contentwidth="494" fileref="./SalixStartUpGuide_13.37_draft4_html_m16f97de6.png" scalefit="1"/>
                </imageobject>
                <imageobject role="fo">
                  <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m16f97de6.png" scalefit="1" width="100%"/>
                </imageobject>
              </mediaobject>
            </informalfigure>
           </listitem>
<listitem>
            <para> Select Add Printer, and finish the process by configuring details of the printer.</para>
          </listitem>
<listitem>
            <para> Now the printer should be usable on your computer</para>
            <para>For setting up a network printer, please consult the Salix<link xl:href="http://www.salixos.org/wiki/index.php/How_to_share_a_printer_via_CUPS">wiki</link>.</para>
          </listitem>
</orderedlist>
      </section>
      <section remap="h3">
        <title>Salix Codecs Installer</title>
        <para>Salix only includes, by default, software that are legally free to use in any country, and that means that proprietary media formats are not configured &quot;out of the box&quot;. Most commercial DVDs are encrypted, and that means that you need to install certain codecs to view them. This is legally permitted in most countries but not all. Please check and obtain legal advice if you are unsure whether a particular legal restriction applies to a media format and/or packages you wish to use in your country.</para>
        <para>Salix codecs installer can be found under &quot;Multimedia&quot; in the main application menu, and conveniently install those codecs to enhance your viewing experiences.</para>
        <para>For more information on what is actually installed, please see <link xl:href="http://www.salixos.org/wiki/index.php/What_gets_installed_with_the_22Install_multimedia_codecs22_application?">here</link>.</para>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.3_3" xreflabel=""/> 3.3 Salix Tools</title>
      <section remap="h3">
        <title>What are the Salix Tools?</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="333" contentwidth="252" fileref="./SalixStartUpGuide_13.37_draft4_html_3967a40f.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_3967a40f.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Salix tools are a collection of utilities that are designed to manage every aspect of Salix configuration easily. You can find these tools under the System section of the application menu. Of course,system management in Salix OS can also be done the usual (<link xl:href="http://www.slackbook.org/html/book.html">manual</link>) Slackware way.</para>
        <para>Please note that most Salix tools (except Lilo Setup) have an ncurses counterpart which can be used in a non-graphical environment (<link xl:href="http://www.bilbos-stekkie.com/slack_init/en/init.html#SLACK-RUNLEVELS">runlevel 3</link>).</para>
      </section>
      <section remap="h3">
        <title>ALSA Sound Card</title>
        <para>ALSA Sound Card manages the system sound card configuration. It will display available sound cards in your system and let you select the card you want to use in preference. This is particularly useful when you have multiple sound cards in your system, and you would like to assign a sound card for your system other than the one automatically picked during installation/start-up.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="260" contentwidth="399" fileref="./SalixStartUpGuide_13.37_draft4_html_m2ef6b7d6.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m2ef6b7d6.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h3">
        <title>Rebuild Icon Cache</title>
        <para>As the name indicates, Rebuild Icon Cache reconnects some icons that may have become lost after updating your system / installing some new program, and makes them appear again in the application menu.</para>
      </section>
      <section remap="h3">
        <title>Hostnames</title>
        <para>Hostnames manages the host names used by your computer. This tool facilitates defining / overviewing host names used while setting up your machine as a server.</para>
        <section remap="h4">
          <title> </title>
          <para></para>
        </section>
      </section>
      <section remap="h3">
        <title>Dotnew</title>
        <para>Dotnew manages the system configuration upgrades used by Slackware. It will display a possible course of action for each new configuration file found in the system.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="167" contentwidth="386" fileref="./SalixStartUpGuide_13.37_draft4_html_3abe4f1a.jpg" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_3abe4f1a.jpg" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>To execute this utility in runlevel 3, simply type dotnew.</para>
      </section>
      <section remap="h3">
        <title>Keyboard Layout</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="268" contentwidth="276" fileref="./SalixStartUpGuide_13.37_draft4_html_m6e7eada0.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m6e7eada0.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>This utility will configure the keyboard disposition being used both in the graphical and non-graphical environments. Modifications are applied instantly.</para>
        <para>Note that if you would like to activate <link linkend="ibus">Ibus</link> during the start up, you can do so by ticking the optional box.</para>
        <para>To execute this utility in runlevel 3, simply type keyboardsetup.</para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="lilosetup" xreflabel=""/>Lilo Setup</title>
        <para>Lilo Setup will install a new LILO bootloader on your computer.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="332" contentwidth="427" fileref="./SalixStartUpGuide_13.37_draft4_html_1127e4be.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_1127e4be.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>A bootloader is required to load the main operating system of a computer and will initially display a boot menu if several operating systems are available on the same computer.</para>
        <para>It is necessary to (re)configure the bootloader each time you install a new operating system on your computer.</para>
        <para>Lilo Setup can also be useful in the process of a disaster recovery, in which case you may have to launch it from a Live CD if you have lost all other means to boot into your system.</para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="startupServices" xreflabel=""/>Startup Services</title>
        <para>Here you will be able to select the services that should or shouldn&apos;t be activated in the background when your system starts.</para>
        <para>All your modifications will be applied instantly if you press on the OK button and will not necessitate a reboot.</para>
        <para>To execute this utility in runlevel 3, simply type servicesetup.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="41" contentwidth="79" fileref="./SalixStartUpGuide_13.37_draft4_html_m266ffa76.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m266ffa76.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h3">
        <title>System Language</title>
        <para>This utility will configure the language of your system.</para>
        <para>To execute it in runlevel 3, simply type localesetup.</para>
      </section>
      <section remap="h3">
        <title>System Clock</title>
        <para>This utility will configure your computer clock.</para>
        <para>To execute it in runlevel 3, simply type clocksetup.</para>
      </section>
      <section remap="h3">
        <title>Users Profile</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="178" contentwidth="294" fileref="./SalixStartUpGuide_13.37_draft4_html_m11ed8757.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m11ed8757.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>In Unix/Linux, all users and groups of users are given certain<link xl:href="http://en.wikibooks.org/wiki/UNIX_Computing_Security/Access_authorization">permissions and access rights</link>to some part of the system in order to control their ability to access and change it.</para>
        <para>This utility manages the creation, deletion and properties of all the system users and groups of users.</para>
        <para>To execute it in runlevel 3, simply type usersetup.</para>
      </section>
      <section remap="h3">
        <title>Salix-Update-Notifier</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="64" contentwidth="64" fileref="./SalixStartUpGuide_13.37_draft4_html_14cd5caf.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_14cd5caf.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Salix update notifier isa tool that periodically checks for available package updates and informs the user about them with the display of a non-intrusive tray icon, which can be used to launch the upgrade process with Gslapt.</para>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.3_4" xreflabel=""/> 3.4 Salix Live Tools</title>
      <section remap="h3">
        <title>What are the Live Tools?</title>
        <para>Salix Live comes with all the default<link linkend="software">software</link>included in Salix OS.</para>
        <para>However, due to its Live nature it also includes some extra utilities which are either needed or simply very useful in a Live session.</para>
        <para>Some of the Live Tools are graphical utilities that can be accessed directly on the desktop while some Live Tools, reserved for advanced users, can only be executed from the command line (<link xl:href="http://en.wikipedia.org/wiki/Command-line_interface">CLI</link>).</para>
      </section>
      <section remap="h3">
        <title> </title>
        <para></para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="DDE_LINK" xreflabel=""/><anchor xml:id="persistence" xreflabel=""/>The Persistence Wizard</title>
        <para>Even if run from a CD/DVD, Salix Live gives you the possibility to save any of your work or modification performed while in a Live session.</para>
        <para>To do this however, you must first create a special &quot;persistence file&quot; on your hard drive, which will have a predecided fixed-size and will be formatted as a Linux file system.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="159" contentwidth="309" fileref="./SalixStartUpGuide_13.37_draft4_html_522d41e5.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_522d41e5.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para><emphasis role="bold">Important!</emphasis>Once this file has been created, it is necessary to reboot the Live CD. From then on, Salix Live will begin to monitor any changes you perform and will record them in the new persistent file.</para>
        <para>To remove any changes and come back to the default settings, simply delete the persistent file (slxsave.xfs) from the<link xl:href="http://www.linfo.org/mount_point.html">mount point</link>it was initially created on.</para>
      </section>
      <section remap="h3">
        <title><anchor xml:id="gparted" xreflabel=""/>Gparted</title>
        <para>Gparted is included in Salix Live to assist you in<link linkend="partition-management">managing your partitions</link>if it is necessary for you to do so before performing the installation of Salix OS.</para>
      </section>
      <section remap="h3">
        <title>Salix Live Installer</title>
        <para>Salix Live Installer will enable you to<link linkend="salix-live-installer">install Salix OS</link>from the comfort of Salix Live graphical environment.</para>
      </section>
      <section remap="h3">
        <title>LiveClone</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="255" contentwidth="293" fileref="./SalixStartUpGuide_13.37_draft4_html_2a661805.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_2a661805.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>LiveClone generates a Live CD/DVD iso image (which you can burn as an image on a CD/DVD with a CD/DVD burner) or a Live USB key. This means that it creates your customized live environment which will be based either on your SalixLive or your running system. In the case of a Live USBKey generation, you will be offered to make your USB key with &quot;<link linkend="persistence">persistence</link>&quot;.</para>
      </section>
      <section remap="h3">
        <title>Linux Live Scripts</title>
        <para>Like most Live CDs based on Slackware, Salix Live relies on the<link xl:href="http://www.linux-live.org/?howtos">Linux Live Scripts</link>technology. Some of the shell scripts it includes will enable an advanced user to fully<link linkend="linux-live">customize and re-master</link>Salix Live to better suit his or her own needs.</para>
      </section>
      <section remap="h3">
        <title>Salix Live Scripts</title>
        <para>In order to bypass certain limitations or to complement some of the third-party technology it uses, Salix developed its own set of patches and scripts which for the most part need no user interaction while some can be executed, forinstance to facilitate the creation of a<link linkend="usb-key">Salix Live USB Flash Disk</link>.</para>
      </section>
    </section>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.4" xreflabel=""/>4. Salix Mini Walkthroughs</title>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.4_1" xreflabel=""/>4.1 Working with the Command Line Interface</title>
      <para>This section deals with working in a console mode or with a terminal (such as xfce terminal, xterm, konsole and so forth), and serves merely as a light introduction to what we call &quot;command line interface&quot; (CLI). The intended audience here is not seasoned travellers but new journeymen in the land of Linux, who are willing to discover more about what one can do with it. We will go through some examples in this section for you to follow, and hopefully by the end of this walkthrough, you will have no problem working in the &quot;black screen&quot;. For those who would like to know more about CLI, there are a couple of useful resources available on the net, and some are listed in the <link xl:href="http://www.salixos.org/forum/viewtopic.php?f=30&amp;t=852">Salix Forum</link>.</para>
      <para>So why learn CLI commands at all? Graphical user interfaces for applications have been steadily improving in Linux, and are probably now comparable to any OS in their ease of use. On the other hand, where Linux excels in particular is in the area of command line applications, its traditional strength. Without the CLI, you would be effectively missing out on half of what Linux can offer, if not more.</para>
      <para>There is another reason. From time to time, you might have to work in console. For instance, if the machine fails to start up a graphical desktop environment during booting, then you are more or less forced to fix the problem without GUI.</para>
      <para>Of course, there are many other reasons to learn CLI commands, but for now we will start by learning how to move around directories.</para>
      <para>First, open up a terminal or move to a console (you can do this by pressing <emphasis role="bold">Ctrl+Alt+F2</emphasis>, for example. To get back to the graphical desktop, press <emphasis role="bold">Ctrl+Alt+F4</emphasis>, for example. F number keys are used to switch between consoles.)</para>
      <section remap="h3">
        <title>Moving Around - cd</title>
        <para>You should be in your user directory (denoted as &quot;<emphasis role="bold">~</emphasis>&quot;), which is normally the same as <emphasis role="bold">&quot;/home/</emphasis><emphasis role="bold">your user name</emphasis>&quot; (replace the &quot;<emphasis role="bold">your user name</emphasis>&quot; with your own). In Salix, this directory contains &quot;<emphasis role="bold">Desktop</emphasis>&quot;, &quot;<emphasis role="bold">Music</emphasis>&quot;, &quot;<emphasis role="bold">Documents</emphasis>&quot; and so on. To see its content, type &quot;<emphasis role="bold">ls</emphasis>&quot; and press enter. You will see something like this:</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="36" contentwidth="485" fileref="./SalixStartUpGuide_13.37_draft4_html_190dd0b3.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_190dd0b3.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para> Now to move around directories, we use &quot;<emphasis role="bold">cd</emphasis>&quot;. If you just type in &quot;<emphasis role="bold">cd</emphasis>&quot; and enter, nothing will happen. &quot;<emphasis role="bold">cd</emphasis>&quot; must be followed either by a name of a directory which is within the directory you are in or by a full path to the directory you wish to move into. You can also go one directory up by typing &quot;<emphasis role="bold">cd ..</emphasis>&quot; (be careful, there is a space between <emphasis role="bold">cd</emphasis> and <emphasis role="bold">..</emphasis>). Remember on Linux, <emphasis>arguments are separated by spaces</emphasis>. So for now, let&apos;s move to the root directory. The root directory is, as the name suggests, the core of your directories - every directory stems from here. Once you wipe out the root directory, you will not see your machine booting up again.</para>
        <para>To move to the root DBQUOTE<emphasis role="bold">/</emphasis>DBQUOTE, type in DBQUOTE<emphasis role="bold">cd /</emphasis>DBQUOTE.</para>
        <para>Type in DBQUOTE<emphasis role="bold">ls</emphasis>DBQUOTE to see the list of files and directories in the directory. You should see something like &quot;<emphasis role="bold">tmp/</emphasis>&quot;, &quot;<emphasis role="bold">usr/</emphasis>&quot;, &quot;<emphasis role="bold">home/</emphasis>&quot; and so on. OK, not so interesting here. Let us move back to your home directory with &quot;<emphasis role="bold">cd /home/</emphasis><emphasis role="bold">your user name</emphasis>&quot;.</para>
        <para>Now move into the &quot;<emphasis role="bold">Music</emphasis>&quot; directory by issuing &quot;<emphasis role="bold">cd Music</emphasis>&quot;. In fact, you do not have to type to the end. By pressing Tab after the first letter or two, you may complete the rest of the directory name automatically.</para>
      </section>
      <section remap="h3">
        <title>Creating a Folder - mkdir</title>
        <para>You can create a folder by issuing &quot;<emphasis role="bold">mkdir</emphasis><emphasis role="bold">name of a new folder</emphasis>&quot;. For example, let&apos;s say we are going to create a photo folder. &quot;<emphasis role="bold">mkdir</emphasis><emphasis role="bold">photo</emphasis>&quot; will place the new folder in the current directory. You can check this by typing &quot;<emphasis role="bold">ls</emphasis>&quot;.</para>
        <para>Next, let&apos;s create a log file for the photo folder. &quot;<emphasis role="bold">nano</emphasis>&quot; is a command line application for reading and writing texts. To bring up the program, type in &quot;<emphasis role="bold">nano</emphasis>&quot;.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="218" contentwidth="478" fileref="./SalixStartUpGuide_13.37_draft4_html_1cf0fd24.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_1cf0fd24.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para> The application is simple to use, and you can see command options shown at the buttom. Type &quot;<emphasis role="bold">log file created</emphasis>&quot;, and with <emphasis role="bold">Ctrl+x</emphasis>, save the document as &quot;<emphasis role="bold">log</emphasis>&quot; and quit the application.</para>
      </section>
      <section remap="h3">
        <title>Copying &amp; Moving &amp; Removing a File - cp &amp; mv &amp; rm</title>
        <para>DBQUOTE<emphasis role="bold">cp</emphasis>&quot; is perhaps one of the most used commands in a console mode. &quot;<emphasis role="bold">cp</emphasis>&quot; copies a file or files from one location to another. Since we created the file called &quot;<emphasis role="bold">log</emphasis>&quot; and it is currently in the wrong directory, let us move it inside the &quot;<emphasis role="bold">photo</emphasis>&quot; directory. You can do so by issuing &quot;<emphasis role="bold">cp log photo/</emphasis>&quot; but perhaps it is better to call the log file not just &quot;<emphasis role="bold">log</emphasis>&quot; but &quot;<emphasis role="bold">log.txt</emphasis>&quot;, so that it would be obvious to a Windows user that it is a text file. Type in &quot;<emphasis role="bold">cp log photo/log.txt</emphasis>&quot; and enter to execute the command.</para>
        <para>You can go inside the &quot;<emphasis role="bold">photo</emphasis>&quot; directory and check if the copying has been done properly. &quot;<emphasis role="bold">cd photo</emphasis>&quot; and then &quot;<emphasis role="bold">ls</emphasis>&quot;. The file should be there. Let&apos;s add to the log file by saying that it has been moved from &quot;<emphasis role="bold">Music</emphasis>&quot; to &quot;<emphasis role="bold">photo</emphasis>&quot;. Issuing &quot;<emphasis role="bold">nano log.txt</emphasis>&quot; will bring up the text. Add a line to say it has been moved, and then save and quit the application by <emphasis role="bold">Ctrl+x</emphasis>.</para>
        <para>Oh, but we forgot to delete the original &quot;<emphasis role="bold">log</emphasis>&quot; file in the &quot;<emphasis role="bold">Music</emphasis>&quot; folder. Let&apos;s just get back to the &quot;<emphasis role="bold">Music</emphasis>&quot; directory using &quot;<emphasis role="bold">cd ..</emphasis>&quot; and remove the &quot;<emphasis role="bold">log</emphasis>&quot; file by issuing &quot;<emphasis role="bold">rm log</emphasis>&quot;. The &quot;<emphasis role="bold">rm</emphasis>DBQUOTE command removes a file or files. For example, if you would like to remove all photos with .jpg extension but not with .png, you can issue a command something like: &quot;<emphasis role="bold">rm @star.jpg</emphasis>&quot;. This will remove all the files with .jpg extension within the directory you are in. Note that the &quot;<emphasis role="bold">rm</emphasis>&quot; command will not ask you to confirm your order. It will just carry out your instructions without further ado and once a file is removed, it is deleted forever. You cannot recover it from the recycle bin.</para>
        <para>In this example, we used &quot;<emphasis role="bold">cp</emphasis>&quot; to copy the log file and then later on deleted it. Normally, this would be done by issuing a &quot;<emphasis role="bold">mv</emphasis>&quot; command; &quot;<emphasis role="bold">mv log photo/</emphasis>&quot;. You can also use the &quot;<emphasis role="bold">mv</emphasis>&quot; command to rename a file. Let&apos;s say that you did not like the earlier decision to call the log file &quot;<emphasis role="bold">log.txt</emphasis>&quot; and you now want to rename it as &quot;<emphasis role="bold">log</emphasis>&quot; again. Type in &quot;<emphasis role="bold">mv photo/log.txt photo/log</emphasis>&quot; and execute the command. Now the file name has been changed back to &quot;log&quot;.</para>
      </section>
      <section remap="h3">
        <title>Copying &amp; Moving &amp; Removing a Folder - cp &amp; mv &amp; rm</title>
        <para>So now you have the folder called &quot;<emphasis role="bold">photo</emphasis>&quot; and a log file in the &quot;<emphasis role="bold">Music</emphasis>&quot; directory. This is a little strange as we should normally have the folder not in &quot;<emphasis role="bold">Music</emphasis>&quot; but in &quot;<emphasis role="bold">Pictures</emphasis>&quot;. But now you know how to move a file, perhaps the same command will work for moving a folder?</para>
        <para>But... &quot;<emphasis role="bold">cp photo ../Pictures</emphasis>&quot; (remember that <emphasis role="bold">..</emphasis> refers to the folder one level up) will give an error like this.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="35" contentwidth="489" fileref="./SalixStartUpGuide_13.37_draft4_html_m32d8d4a3.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m32d8d4a3.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para> Let&apos;s see what we can do here. The first thing when encountering such a problem is to check the corresponding help file. This can normally be done by issuing a command with an option like &quot;<emphasis role="bold">cp --help</emphasis>&quot;. It is possible that <emphasis role="bold">--help</emphasis> will just be <emphasis role="bold">-h</emphasis>, and there may be no help at all. &quot;<emphasis role="bold">man</emphasis>&quot; is another command if this is the case. &quot;<emphasis role="bold">man cp</emphasis>&quot; will give a more indepth explanation of this command. (To get out of the manual, press &quot;<emphasis role="bold">q</emphasis>&quot;).</para>
        <para>If you read the help carefully, you will see that you need to give an extra option &quot;<emphasis role="bold">-r</emphasis>&quot; if you wish to copy a folder to another location. So now &quot;<emphasis role="bold">cp -r photo ../Pictures</emphasis>&quot; should copy the &quot;<emphasis role="bold">photo</emphasis>&quot; folder inside the correct &quot;<emphasis role="bold">Pictures</emphasis>&quot; directory. After checking that the folder has been safely copied, you can remove the &quot;<emphasis role="bold">photo</emphasis>&quot; folder from the &quot;<emphasis role="bold">Music</emphasis>&quot; directory: &quot;<emphasis role="bold">rm -r photo/</emphasis>&quot;.</para>
      </section>
      <section remap="h3">
        <title>Installing a Program - slapt-get and slapt-src</title>
        <para>Maybe a little bird has told you that there is a wonderful application called &quot;<emphasis role="bold">cowsay</emphasis>&quot; in Linux, and now you would like to see what this program can do.</para>
        <para>In order to install a program, one needs to be logged in as root (= superuser = administrator), because it is a system wide action. Alternatively, you can acquire the superuser rights by issuing &quot;<emphasis role="bold">su</emphasis>&quot;. You will be asked to enter the root password. After providing the correct password, you are now free to do whatever you wish to do on your system (even to make the machine unworkable).</para>
        <para>So &quot;cowsay&quot;. If this is the first time you are installing an application on Salix, the first thing you should do is to update the package database on your computer by executing &quot;<emphasis role="bold">slapt-get -u</emphasis>&quot;. Then to search for an application (in this case, &quot;cowsay&quot;), type in &quot;<emphasis role="bold">slapt-get --search cowsay</emphasis>&quot;. Unfortunately, cowsay is not in the official repositories neither of Salix nor of Slackware. But it is still too early to give up. Slackbuild.org maintains extra packages for Slackware, which of course can be utilised by Salix users.</para>
        <para>Search for &quot;cowsay&quot; with slapt-src by typing &quot;<emphasis role="bold">slapt-src --search cowsay</emphasis>&quot; after first updating the local database with &quot;<emphasis role="bold">slapt-src -u</emphasis>&quot;. You will see that it is available from Slackbuild.org. To install it, execute &quot;<emphasis role="bold">slapt-src -i cowsay</emphasis>&quot;. If you are not sure what this &quot;<emphasis role="bold">-i</emphasis>&quot; is, you can check it with the <emphasis role="bold">--help</emphasis> option. You will see a lot of lines running up the terminal quickly until the application is installed.</para>
        <para>Once it is installed, you might want to test it. First get out of the superuser mode by typing &quot;<emphasis role="bold">exit</emphasis>&quot;. Then type in &quot;<emphasis role="bold">cowsay</emphasis>&quot;. Nothing happens, and in fact, you will see that you are now in a strange mode that you cannot execute any commands. This is because the application is still running, but as you don&apos;t see anything, perhaps it is not running properly. To terminate the process, press &quot;<emphasis role="bold">Ctrl+c</emphasis>&quot;. You will get back the normal input line back on your terminal.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="35" contentwidth="488" fileref="./SalixStartUpGuide_13.37_draft4_html_e331e22.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_e331e22.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para> So what was going wrong? Check &quot;<emphasis role="bold">cowsay</emphasis>&quot; with &quot;<emphasis role="bold">-h</emphasis>&quot;. You will see that you need to type in a <emphasis role="bold">[message]</emphasis>. Try again with &quot;<emphasis role="bold">cowsay Hello Salix!</emphasis>DBQUOTE</para>
        <para>To sum up, we have merely scratched the surface of thepower of the command line. The best way to learn more is by using it, but remember to use the help tools, and consult online documentation such as that listed in the Salix forum.<link xl:href="http://linuxcommand.org/index.php">Linuxcommand.org</link>can be particularly recommended if you wish to gain a comprehensive grounding. Proceed cautiously, but don&apos;t be afraid to experiment.</para>
        <para>A final tip - it can be difficult to copy longer commands accurately. If you select the text with the mouse, in Linux, clicking the middle button or wheel will paste it accurately into the command line or wherever you wish.</para>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.4_2" xreflabel=""/>4.2 Getting started with Salix Ratpoison</title>
      <section remap="h3">
        <title>Overview</title>
        <para>Ratpoison is a tiling window manager, somewhat like<emphasis>xmonad</emphasis>or<emphasis>scrotwm</emphasis>. Its two main features are that applications fill the whole screen, with no bars or buttons; and the user interface can be controlled entirely from the keyboard, with no mouse. If needed, any number of windows may be shown simultaneously, and rearranged at will - whence the term &quot;tiling&quot; WM. All this may take some getting used to, but although - or perhaps because - the interface is so very different from the conventional point-and-click approach, it can quickly become highly intuitive. Learning which actual keys do what takes far less time than might be imagined. Apart from its efficiency and lack of clutter, ratpoison is a good choice for anyone concerned about RSI (cumulative strain from long-term mouse use), or for netbook users, because &quot;every pixel counts&quot;. It is also highly configurable - and fast!</para>
        <para>The applications present for the Ratpoison edition aim to fit in with its minimalist (but not spartan) approach. The majority use vim-style keybindings, even though ratpoison itself does not, so users will need to become comfortable with these if they are not already; cheatsheets are available online to help assimilate them, as well as guides (and manpages) for the individual applications. Common operations use only a small subset of keys, which makes the learning curve smoother: for basic browsing, for instance, all you need to get started is page and history navigation and to know how to open links and tabs or windows. Other functions can be learned by exploration at your own pace. To begin using Vim itself, try running<emphasis role="bold">vimtutor</emphasis>from a terminal, and just follow the instructions.</para>
      </section>
      <section remap="h3">
        <title>Starting Ratpoison and running applications</title>
        <para>When you boot Salix Ratpoison, there is no graphical login screen: when you log in, you enter the linux terminal. Log in as your normal user (not root) and type<emphasis role="bold">startx</emphasis>to start Ratpoison itself.</para>
        <para>You should then see the Salix wallpaper, and a message will appear briefly telling you how to view a list of commands. Type<emphasis role="bold">Ctrl-t</emphasis>(<emphasis role="bold">C-t</emphasis>, in Ratpoison&apos;s own notation) then a question mark; pressing any key takes you back to where you were before. There is nothing to see (apart from thebeautiful Salix wallpaper)! But it&apos;s just as easy to set Ratpoison to work as with any more conventional desktop.</para>
        <para>To select an application from the menu, type<emphasis role="bold">C-t r,</emphasis>and use the arrow keys to navigate(Vim&apos;s<emphasis role="bold">hjkl</emphasis>keys also work). Right arrow (or<emphasis role="bold">l</emphasis>) accesses submenus (such as<emphasis role="bold">DBQUOTE</emphasis>Network&quot;), and left arrow (or<emphasis role="bold">h</emphasis>) goes back up a level. Right arrow or enter runs the application (if you open one by mistake, don&apos;t worry, just type<emphasis role="bold">C-t r</emphasis>again - we will see how to close windows and applications later).</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="67" contentwidth="141" fileref="./SalixStartUpGuide_13.37_draft4_html_3b5af707.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_3b5af707.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Some common options are available directly at the top. The<emphasis>Vimprobable2</emphasis>browser, for instance, can be found under Network but also by just selecting &quot;Browser&quot;. Remember to use the keyboard and not the mouse! A third way to open it bypasses the menu altogether:<emphasis role="bold">C-t v</emphasis>. You can create more shortcuts like this for applications you use a lot by adding them to the configuration file, which we will look at below.</para>
        <para><emphasis>apvlv</emphasis>, under Accessories, can be used to read pdf documents such as this guide. Also under accessories, &apos;Unit conversion&apos; starts the console application units, which will convert between a large range of scales, such as time, weight, or currency, including some quite unusual ones.</para>
      </section>
      <section remap="h3">
        <title>Vimprobable browsing</title>
        <para>Notice that there are no menus, toolbars, buttons, or scrolling - just a line at the bottom containing the URL. To open a different page, type<emphasis role="bold">o</emphasis>, and<emphasis role="bold">:open</emphasis>should appear at the very bottom left of the screen. Type<link xl:href="http://www.nongnu.org/ratpoison/doc/">http://www.nongnu.org/ratpoison/doc/</link>. When the page has loaded, type<emphasis role="bold">f</emphasis>and then select a number to follow a link:</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="53" contentwidth="70" fileref="./SalixStartUpGuide_13.37_draft4_html_23fe0b54.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_23fe0b54.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para><emphasis role="bold">Shift-h</emphasis>takes you back to where you were before.<emphasis role="bold">t</emphasis>works like<emphasis role="bold">o</emphasis>but opens the URL in a new window, as does<emphasis role="bold">shift-f</emphasis>instead of<emphasis role="bold">f</emphasis>. Pressing<emphasis role="bold">TAB</emphasis>after typing the beginning of a URL will suggest completions taken from the history; use<emphasis role="bold">TAB</emphasis>again to move through the choices (<emphasis role="bold">shift-TAB</emphasis>to go back up) and E<emphasis role="bold">nter</emphasis>to select.<emphasis role="bold">O</emphasis>rather than<emphasis role="bold">o</emphasis>(and<emphasis role="bold">T</emphasis>rather than<emphasis role="bold">t</emphasis>) allows you to edit the URL of the current page - try it.<emphasis role="bold">j</emphasis>and<emphasis role="bold">k</emphasis>scroll down and up.<emphasis role="bold">Shift-l</emphasis>moves one page forward in your browsing history.<emphasis role="bold">d</emphasis>closes the current window. For more details, consult<emphasis role="bold">man vimprobable2</emphasis>as well as the Vimprobable website; see also<emphasis role="bold">man vimprobablerc</emphasis>for configuration options. Note that<emphasis role="bold">.</emphasis>and<emphasis role="bold">,</emphasis>are handy alternatives to<emphasis role="bold">f</emphasis>and<emphasis role="bold">shift-f</emphasis>.</para>
        <para>There are no tabs. In the next section, we will see how Ratpoison allows you to use windows to do the work of tabs, but more informatively.</para>
        <para>Note that if the input received by<emphasis role="bold">o</emphasis>or<emphasis role="bold">t</emphasis>can&apos;t be resolved into a URL, it will be sent to a search engine; the default is<emphasis>duckduckgo</emphasis>. If the first item is<emphasis role="bold">i</emphasis>,<emphasis role="bold">s</emphasis>,<emphasis role="bold">w</emphasis>,<emphasis role="bold">wd</emphasis>, or<emphasis role="bold">y</emphasis>, a different search engine is used in each case. These shorcuts are described in the Vimprobable man page, and may also becustomised in the .vimprobablerc configuration file.</para>
        <para>To insert data in forms (for instance, login and password) use tab till the cursor is in the right place. Another<emphasis role="bold">TAB</emphasis>moves to the next field or link; you may then use<emphasis role="bold">ESC</emphasis>to leave insert mode and return to command mode.</para>
        <para>If you find your keystrokes are still being interpreted as browser commands, which may happen as a result of the way certain sites are designed, try<emphasis role="bold">C-z</emphasis>. The converse problem may arise if you have inadvertently passed keystrokes to<emphasis role="bold">o</emphasis>or<emphasis role="bold">t</emphasis>; they will appear at the very bottom right of the browser window. To ignore them and return to command mode, clearing the buffer, press<emphasis role="bold">ESC</emphasis>.</para>
        <para>As described in Vimprobable&apos;s man page, it is necessary to create some files for all its features to work:<emphasis role="bold">touch ~/.config/vimprobable/histor</emphasis>though some of these may already be present.</para>
      </section>
      <section remap="h3">
        <title>Window management</title>
        <para>Let&apos;s now see how ratpoison deals with several open windows.<emphasis role="bold">C-t e</emphasis>reveals all of them:</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="300" contentwidth="403" fileref="./SalixStartUpGuide_13.37_draft4_html_123e223c.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_123e223c.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Notice that each one is associated with a number: typing it focuses on that window and hides all the others. (<emphasis role="bold">C-t w</emphasis>simply provides a list of open windows.)<emphasis role="bold">C-t</emphasis><emphasis role="bold">C-t</emphasis>returns to the previous window. This is very useful indeed for switching rapidly back and forth between two apps - for instance, an editor and a browser - and is an example of how Ratpoison shines ergonomically.<emphasis role="bold">C-t k</emphasis>closes the current window, and<emphasis role="bold">C-t</emphasis><emphasis role="bold">shift-k</emphasis>kills the current application. To see a list of commands, type<emphasis role="bold">C-t</emphasis><emphasis role="bold">?</emphasis>; for further detail, see also<emphasis role="bold">man</emphasis><emphasis role="bold">ratpoison</emphasis>and the online manual, which we opened above with<emphasis>Vimprobable2</emphasis>.</para>
        <para>To work with two or more windows together, Ratpoison allows the user to tile windows.<emphasis role="bold">C-t s</emphasis>splits the screen with the current window above whichever window was last open;<emphasis role="bold">C-t S</emphasis>splits them horizontally. These steps can be repeated to split the focused window further.<emphasis role="bold">C-t TAB</emphasis>(or<emphasis role="bold">C-t</emphasis>and an arrow key) moves the focus around, and<emphasis role="bold">C-t C-[arrow]</emphasis>swaps the tiled windows over.<emphasis role="bold">C-t Q</emphasis>undoes the splitting and allows the currently focused window to fill the screen. In practice, it&apos;s rarely useful to have more than one or two windows visible:</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="270" contentwidth="480" fileref="./SalixStartUpGuide_13.37_draft4_html_60216ca2.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_60216ca2.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h3">
        <title>The console and package management</title>
        <para>To open the command line, type<emphasis role="bold">C-t c</emphasis>. There is no automatic package management in the Ratpoison edition, so you will need to make regular manual checks for updates:</para>
        <para><emphasis role="bold">$su</emphasis> #change to root</para>
        <para><emphasis role="bold">#slapt-get --update</emphasis> #update the package list</para>
        <para><emphasis role="bold">#slapt-get --upgrade</emphasis> #upgrade to reflect any changes</para>
        <para>Apart from the<emphasis>Vimprobable2</emphasis>browser, the default applications include<emphasis>Mutt</emphasis>as the mail client and<emphasis>Gnome Commander</emphasis>as the file manager.<emphasis>Music On Console</emphasis>and<emphasis>Whaaw Media Player</emphasis>are the audio and video players, with<emphasis>GVim</emphasis>as text/code editor.<emphasis>apvlv</emphasis>can be used to view pdf files. As we have just seen, package management is console-based, using<emphasis>slapt-get</emphasis>and<emphasis>slapt-src</emphasis>. Further options are available in the repository.<emphasis>Firefox</emphasis>may be installed adding the<emphasis>pentadactyl</emphasis>or<emphasis>vimperator</emphasis>addon for mouse-free browsing, or alternatively<emphasis>Jumanji</emphasis>,<emphasis>XXXTerm</emphasis>or<emphasis>w3m</emphasis>, abrowser for the command line.<emphasis>Thunderbird</emphasis>can be used with the<emphasis>Muttator</emphasis>addon while<emphasis>Claws-mail</emphasis>works almost entirely from the keyboard;<emphasis>Alpine</emphasis>is a friendly console email client.</para>
        <para>No office suite is included, and in this as in other respects, the user is encouraged to tailor the system by installing their preferred applications. Flash is not included, but is available from the repositories. Screen for managing multiple consoles works well with Ratpoison. Sc is a console-based spreadsheet. For writers,<emphasis>PyRoom</emphasis>is an elegant choice for full-screen, distraction-free writing, and it might be complemented by<emphasis>Antiword</emphasis>to convert proprietary file formats into plain text.</para>
        <para>Note that the<emphasis>Gslapt</emphasis>and<emphasis>Sourcery</emphasis>graphical package management tools (equivalent to<emphasis>slapt-get</emphasis>and<emphasis>slapt-src</emphasis>) may also be used mouse-lessly, though this is perhaps more awkward than working on the command line. In either case, regular manual upgrading will still be necessary.</para>
        <para>As an example, we will install<emphasis>Alpine</emphasis>, derived from the classic<emphasis>Pine</emphasis>mail client.</para>
        <para><emphasis role="bold">#slapt-get -u</emphasis></para>
        <para><emphasis role="bold">#slapt-get -i alpine</emphasis></para>
        <para>Note: To see how to edit Alpine&apos;s configuration file to access mail from one popular provider via smtp, see the page in the<link xl:href="http://www.salixos.org/wiki/index.php/How20to20set20up20Alpine20with20a20Gmail20account">Salix wiki</link>.</para>
        <para>For<emphasis>Mutt</emphasis>, see<link xl:href="http://crunchbanglinux.org/wiki/howto/howto_setup_mutt_with_gmail_imap">this wiki entry</link>.</para>
      </section>
      <section remap="h3">
        <title>Editing the configuration file</title>
        <para>After using<emphasis>Alpine</emphasis>a little, one problem may become apparent. Its shortcut for selecting a file, for example to attach it, is<emphasis role="bold">C-t</emphasis>. But that&apos;s Ratpoison&apos;s escape key combination! In fact, Ratpoison has a solution for such conflicts, referred to somewhat cryptically in the shortcut list as<emphasis>meta</emphasis>:<emphasis role="bold">C-t t</emphasis>should send<emphasis role="bold">C-t</emphasis>to the application in the active window. However, this does not work in the terminal, which does not recognise the character if it receives it in this form.</para>
        <para>Everything in Ratpoison is configurable, and the<emphasis role="bold">C-t</emphasis>combination itself is no exception. A temporary solution is to reassign the binding using Ratpoison&apos;s command input feature.<emphasis role="bold">C-t :</emphasis>conjures up an input line at the top right of the screen. This can be used for passing instructions to Ratpoison. For instance, one way of opening an application in a new console is:</para>
        <para><emphasis role="bold">:exec xterm -e alpine</emphasis></para>
        <para>(that is,<emphasis role="bold">C-t : exec xterm -e alpine</emphasis>) which starts theprogram we just installed. The colon command can be used to pass a number of instructions to Ratpoison; see<emphasis role="bold">man</emphasis><emphasis role="bold">Ratpoison</emphasis>for a full list together with shortcuts where they have been defined. In fact, there is a shortcut for<emphasis role="bold">exec</emphasis>. Just type<emphasis role="bold">C-t !</emphasis><emphasis role="bold">[application]</emphasis>;<emphasis role="bold">C-t C-!</emphasis>opens it in a console.</para>
        <para>To change the<emphasis role="bold">C-t</emphasis>default, do:<emphasis role="bold">:escape Super_L</emphasis>.</para>
        <para>which is the so-called &quot;Windows key&quot; to the left of the keyboard. As well as resolving the conflict with<emphasis>Alpine</emphasis>, this has the great benefit of being just one keystroke. Some functions may not work correctly, in particular the very useful<emphasis role="bold">C-t C-t</emphasis>to go back to where you just were, and performance varies from one keyboard to another, so it&apos;s worth experimenting. Another possibility is the &quot;Menu&quot; key. To return to the default:<emphasis role="bold">:escape C-t</emphasis>.</para>
        <para>To make such a change permanent, edit<emphasis>~/.ratpoisonrc</emphasis>. If you are using Ratpoison, you can open the file now (with<emphasis>GVim</emphasis>or<emphasis>Vim</emphasis>) and tile it horizontally with the window where you are reading this guide (<emphasis role="bold">C-t shift-s</emphasis>). Let&apos;s go through some items in the file.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="35" contentwidth="60" fileref="./SalixStartUpGuide_13.37_draft4_html_m33ed454d.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m33ed454d.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para><emphasis>banish</emphasis>sends the mouse pointer to bottom right (incidentally, you may wish to install<emphasis>unclutter</emphasis>, which makes it fade out altogether after a few seconds&apos; stillness; place the line<emphasis role="bold">unclutter &amp;</emphasis>in your<emphasis>~/.xinitrc</emphasis>to run it automatically when X is started). We&apos;ve seen all but one of the custom keybindings in the &quot;bind&quot; statements. To change the wallpaper, point to a different image. The final item sets up workspaces, which we&apos;ll look at next - including<emphasis role="bold">C-t W</emphasis>.</para>
        <para>Before editing the file, create a backup copy in caseanything goes wrong. To change the<emphasis role="bold">C-t</emphasis>default, simply add a line :</para>
        <para><emphasis role="bold">escape Menu</emphasis># make sure you test your choice first using &apos;<emphasis role="bold">:</emphasis>&apos;</para>
        <para>We&apos;ve seen many of the custom keybindings in the &quot;bind&quot; statements.</para>
        <para>The final item, together with the bindings to function keys, sets up workspaces; we&apos;ll look at these next - including<emphasis role="bold">C-t W</emphasis>.</para>
      </section>
      <section remap="h3">
        <title>Using workspaces</title>
        <para>If you have several terminals open, and various browser windows, and some other applications, the number of windows may become unwieldy. To help with this, Ratpoison allows you to use workspaces. (In the online Ratpoison manual, these are referred to more precisely as &quot;groups&quot;.) You might then put all browser windows in one workspace, so that<emphasis role="bold">C-t e</emphasis>has the same effect as tabs, but withDBQUOTEthumbnails&quot;.</para>
        <para>Managing these is roughly analogous to how windows are managed within each workspace. As we saw,<emphasis role="bold">C-t e</emphasis>shows all windows in the current workspace;<emphasis role="bold">C-t w</emphasis>lists them.<emphasis role="bold">C-t W</emphasis>shows four more workspaces, which were set up in the last line of the configuration file. In a console, type<emphasis role="bold">rpws help</emphasis>.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="28" contentwidth="75" fileref="./SalixStartUpGuide_13.37_draft4_html_m42df6fc7.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m42df6fc7.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>The usage summary you will see may be a little cryptic. Just as &quot;C&quot; means Control, &quot;M&quot; refers to Alt. Use Alt with the function keys to access each workspace. Ctrl-Alt and the arrows move up and down workspaces. The remaining options move the current window to a different workspace.</para>
      </section>
      <section remap="h3">
        <title>Adding an item to the menu</title>
        <para>The directory<emphasis>~/.ratmenu</emphasis>contains the main menu file<emphasis>menu.sh</emphasis>, and the submenus it calls; all these are editable scripts. We will now edit the Network menu using<emphasis>GVim</emphasis>.<emphasis>GVim</emphasis>is in the menu, but try calling it using the colon (<emphasis role="bold">C-t :</emphasis>)</para>
        <para><emphasis role="bold">:exec gvim ~/.ratmenu/network.sh</emphasis></para>
        <para>or simply</para>
        <para><emphasis role="bold">C-t ! gvim ~/.ratmenu/network.sh</emphasis>.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="220" contentwidth="403" fileref="./SalixStartUpGuide_13.37_draft4_html_70fa41c2.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_70fa41c2.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Note that graphical applications are called directly, but command line programs need to be opened inside a terminal.</para>
        <para>Use<emphasis role="bold">j</emphasis>and<emphasis role="bold">k</emphasis>to navigate to where you want to add the entry for<emphasis>Alpine</emphasis>, type<emphasis role="bold">i</emphasis>to insert,<emphasis role="bold">ESC</emphasis>to return to command mode,and<emphasis role="bold">:wq</emphasis>to write and save. Test the change by typing<emphasis role="bold">C-t r</emphasis>- the new item should already appear. If all is well, you may close the editor.</para>
      </section>
      <section remap="h3">
        <title>Summary</title>
        <para>Here is a short list of key bindings common to many of the Salix Ratpoison edition&apos;s applications.</para>
        <informaltable frame="none">
          <tgroup cols="2">
            <colspec colname="c1" colwidth="21"/>
            <colspec colname="c2" colwidth="79"/>
            <tbody>
              <row>
                <entry><para> <emphasis role="bold">Shortcuts</emphasis></para></entry>
                <entry><para> <emphasis role="bold">Description</emphasis></para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">gg</emphasis></para></entry>
                <entry><para> go to the top</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">G</emphasis></para></entry>
                <entry><para> go to the bottom</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">h</emphasis></para></entry>
                <entry><para> left</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">j</emphasis></para></entry>
                <entry><para> down</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">k</emphasis></para></entry>
                <entry><para> up</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">l</emphasis></para></entry>
                <entry><para> right</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">TAB</emphasis></para></entry>
                <entry><para> select form fields, links.C-zto type in some forms</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">o</emphasis></para></entry>
                <entry><para> open</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">t</emphasis></para></entry>
                <entry><para> open in new tab/window</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">f</emphasis></para></entry>
                <entry><para> follow a link</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">d</emphasis></para></entry>
                <entry><para> close/delete</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">H</emphasis></para></entry>
                <entry><para> go back</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">/</emphasis></para></entry>
                <entry><para> search forwards</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">?</emphasis></para></entry>
                <entry><para> search backwards</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">ESC</emphasis></para></entry>
                <entry><para> return to command mode (and clear the buffer of any mistyped keystrokes)</para></entry>
              </row>
              <row>
                <entry><para> <emphasis role="bold">:</emphasis></para></entry>
                <entry><para> pass a non-shortcut command to the application</para></entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
        <para>For a summary of Ratpoison&apos;s own shortcuts, type<emphasis role="bold">C-t ?</emphasis>.</para>
        <para>While what is covered here should be enough to get you started, many more features of the applications and especially Ratpoison itself are described in online manuals, guides and the manpages. Once you are used to the core features and have them at your fingertips, it&apos;s worth digging around further, as well as investigating suitable applications to add to the set. Configuration may be done straightforwardly by editing the files - suggestions may be found online. One of Ratpoison&apos;s principal charms is how easily it can be tailored to fit each user&apos;s needs and taste.</para>
        <para>One miscellaneous item is the mount manager in the System menu, which may also be called from the command line as<emphasis>gmountman</emphasis>. When needed, this deals with the mounting of removable devices, including DVDs. Also,<emphasis>banish</emphasis>may be called at any time by the shortcut<emphasis role="bold">C-t b</emphasis>.</para>
        <para>Remember to check frequently for package updates using<emphasis>slapt-get</emphasis>.</para>
        <para>Finally, to shut down Ratpoison, there is an entry in the Exit submenu, from where it is also possible to reboot or shut down the computer.</para>
      </section>
    </section>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.5" xreflabel=""/>5. Advanced  Live CD Options</title>
    <section remap="h2">
      <title><anchor xml:id="advanced_boot" xreflabel=""/><anchor xml:id="dbdoclet.5_1" xreflabel=""/>5.1 Advanced Boot Options</title>
      <para>By selecting &apos;Change boot options&apos; on the Salix Live Boot menu, you will be offered a choice of supplementary boot options</para>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="382" contentwidth="509" fileref="./SalixStartUpGuide_13.37_draft4_html_m18637ec1.png" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m18637ec1.png" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para>The instructions below the Salix Live Boot menu will give you access to Salix Live &apos;manual&apos; advanced Boot options.</para>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="302" contentwidth="486" fileref="./SalixStartUpGuide_13.37_draft4_html_591e2837.png" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_591e2837.png" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para>Pressing &quot;<emphasis role="bold">c</emphasis>&quot; gives you access to the Grub shell. Type help to view all available commands.</para>
      <para><inlinemediaobject><imageobject role="html">
            <imagedata align="left" contentdepth="274" contentwidth="472" fileref="./SalixStartUpGuide_13.37_draft4_html_29a66be0.png" scalefit="1"/>
          </imageobject>
<imageobject role="fo">
            <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_29a66be0.png" scalefit="1" width="100%"/>
          </imageobject>
</inlinemediaobject></para>
      <para>Pressing &apos;e&apos; while &apos;Start Salix Live&apos; is selected opens up the following display, enabling you to modify some of the booting options, for example, in order to enter a boot parameter. For instance, &quot;nomodeset&quot; for those who use older graphic cards and have problem booting up properly.</para>
      <section remap="h3">
        <title><anchor xml:id="cheatcodes" xreflabel=""/> Boot Parameters</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="127" contentwidth="444" fileref="./SalixStartUpGuide_13.37_draft4_html_mfee8015.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_mfee8015.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Booting parameters or cheatcodes, are used to manipulate the booting process of Linux. Some of them are specific to Linux Live Scripts while some are common to all Linux versions. To enter a cheatcode, you simply have to add it to the &apos;linux&apos; line above (after changes=slxsave.xfs), ensuring a blank space separates it from the previous boot parameter.</para>
      </section>
      <section remap="h3">
        <title>Useful Boot Parameters</title>
        <para>To load in console only without executing Xorg (runlevel 3)</para>
        <para><emphasis><emphasis role="bold">3</emphasis></emphasis></para>
        <para>To load Salix Live from a different location than the boot device:</para>
        <para><emphasis><emphasis role="bold">from=/dev/device/salixlive-version.iso</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">from=path/to/salixlive-version.iso</emphasis></emphasis></para>
        <para><emphasis role="bold">from=path/to/exploded/salixlive-version.iso</emphasis></para>
        <para>To set root&apos;s password to &quot;somepass&quot;, or ask for a new password:</para>
        <para><emphasis><emphasis role="bold">passwd=somepass</emphasis></emphasis></para>
        <para><emphasis role="bold">passwd=ask</emphasis></para>
        <para>To load optional modules from /optional/ directory on the CD:</para>
        <para><emphasis><emphasis role="bold">load=module</emphasis></emphasis></para>
        <para>(You can use the full module name (module.lzm) or you can skip the extension.)</para>
        <para>To safeguard all changes made in a Salix Live session:</para>
        <para><emphasis><emphasis role="bold">changes=file</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">changes=/dev/device</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">changes=/dev/device/file</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">changes=/path/</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">changes=/path/file</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">changes=/dev/device/path/</emphasis></emphasis></para>
        <para>(This cheatcode is already included in Salix Live boot menu and the Persistence Wizard can assist you in creating a persistent file that will be automatically managed by Salix Live.)</para>
        <para>To enable debug mode:</para>
        <para><emphasis><emphasis role="bold">debug</emphasis></emphasis></para>
        <para><emphasis role="bold">(Starts bash several times during boot. Press Ctrl+D to resume booting)</emphasis></para>
      </section>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.5_2" xreflabel=""/> 5.2 Linux Live Scripts</title>
      <para>The Linux Live Scripts come with the following useful commands:</para>
      <para>Adding/Removing modules on the fly:</para>
      <para><emphasis><emphasis role="bold">/usr/bin/activate</emphasis></emphasis></para>
      <para><emphasis><emphasis role="bold">/usr/bin/deactivate</emphasis></emphasis></para>
      <para>Make a module out of a directory:</para>
      <para><emphasis><emphasis role="bold">/usr/bin/dir2lzm</emphasis></emphasis></para>
      <para>Explode a module to a directory</para>
      <para><emphasis><emphasis role="bold">/usr/bin/lzm2dir</emphasis></emphasis></para>
      <para>Make a module out of a package:</para>
      <para><emphasis><emphasis role="bold">/usr/bin/tgz2lzm</emphasis></emphasis></para>
      <para><emphasis><emphasis role="bold">/usr/bin/txz2lzm</emphasis></emphasis></para>
    </section>
    <section remap="h2">
      <title><anchor xml:id="dbdoclet.5_3" xreflabel=""/> 5.3 Personalising a Module</title>
      <section remap="h3">
        <title>Creating a module</title>
        <para>1. Create a working directory</para>
        <para><emphasis><emphasis role="bold">mkdir -p /mnt/hdxx/directory1</emphasis></emphasis></para>
        <para>2. Install all software packages using this directory as root:</para>
        <para><emphasis><emphasis role="bold">installpkg --root=/mnt/hdxx/directory1 packagea-x.x.x.txz</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">installpkg --root=/mnt/hdxx/directory1 packageb-x.x.x.txz</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">installpkg --root=/mnt/hdxx/directory1 packagec-x.x.x.txz</emphasis></emphasis></para>
        <para><emphasis>etc.</emphasis></para>
        <para>3. Remove all unneeded files:</para>
        <para><emphasis><emphasis role="bold">rm -rf /mnt/hdxx/directory1/usr/doc/@star</emphasis></emphasis></para>
        <para>4. Make any modifications you want:</para>
        <para><emphasis><emphasis role="bold">echo &quot;whatever&quot; &gt; /mnt/hdxx/directory1/foo/bar</emphasis></emphasis></para>
        <para>5. Build the module:</para>
        <para><emphasis><emphasis role="bold">cd /mnt/hdxx/</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">dir2lzm directory1 module1.lzm</emphasis></emphasis></para>
      </section>
      <section remap="h3">
        <title>Customizing a module</title>
        <para>You can fully customize the content of a module by removing or adding applications and by deleting, editing or adding new files inside it.</para>
        <para>1. Create a working directory:</para>
        <para><emphasis><emphasis role="bold">mkdir -p /mnt/hdxx/directoryx</emphasis></emphasis></para>
        <para>2. Open up the module you want to customize under the working directory:</para>
        <para><emphasis><emphasis role="bold">lzm2dir /mnt/hdc/salixlive/base/modulex.lzm /mnt/hdxx/directoryx</emphasis></emphasis></para>
        <para>(TIP: You can check that the module contains the unwanted packages by listing the /mnt/hdxx/directoryx/var/log/packages/ directory.)</para>
        <para>3. Remove the packages from the working directory:</para>
        <para><emphasis><emphasis role="bold">ROOT=/mnt/hdxx/directoryx removepkg packagex</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">ROOT=/mnt/hdxx/directoryx removepkg packagey</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">ROOT=/mnt/hdxx/directoryx removepkg packagez</emphasis></emphasis></para>
        <para><emphasis>etc.</emphasis></para>
        <para>4. Install new packages to the working directory:</para>
        <para><emphasis><emphasis role="bold">installpkg --root=/mnt/hdxx/directoryx package1-x.x.x.txz</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">installpkg --root=/mnt/hdxx/directoryx package2-x.x.x.txz</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">installpkg --root=/mnt/hdxx/directoryx package3-x.x.x.txz</emphasis></emphasis></para>
        <para>5. Rebuild the module:</para>
        <para><emphasis><emphasis role="bold">cd /mnt/hdxx/</emphasis></emphasis></para>
        <para><emphasis><emphasis role="bold">dir2lzm directoryx modulex.lzm</emphasis></emphasis></para>
        <para>6. Replace the original module with your new module, rebuild the ISO image and reburn the CD.</para>
      </section>
      <section remap="h3">
        <title>Which module contains application XXX?</title>
        <para>By browsing /mnt/live/memory/images/xxx.lzm/, you can view the contents of each module, therefore you&apos;ll find which module holds a given package in /mnt/live/memory/images/xxx.lzm/var/log/packages/</para>
      </section>
      <section remap="h3">
        <title>Adding files to Salix Live</title>
        <para>Sometimes all you want to do is add a couple files to Salix Live, for example specific configuration files. In that case it is not necessary to create or modify a module.</para>
        <para>Salix Live CD holds a <emphasis>/salixlive/rootcopy/</emphasis> directory. The content of this directory is copied to the root filesystem each time you boot, preserving all directories.</para>
        <para>So, for example, if you wish to just use your own xorg.conf file, create etc/X11/ directories inside of /salixlive/rootcopy and store your xorg.conf in it. Note that you need to recreate the full directory hierarchy for the patches to work as desired.</para>
      </section>
      <section remap="h3">
        <title>Modify Salix Live ISO</title>
        <para>To remaster Salix Live, you could simply use the program Isomaster. You must open an ISO file of Salix Live (for example the one you downloaded) and then add to and/or remove from the modules situated in <emphasis>/salixlive/base</emphasis>, <emphasis>/salixlive/modules</emphasis> or <emphasis>/salixlive/optional</emphasis>. Once you are done, save the modified ISO to your hard drive and use Brasero to burn it on a CD-ROM.</para>
      </section>
    </section>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.6" xreflabel=""/>6. Support</title>
    <para>If you are still quite new to either Salix, Slackware or even Linux in general, then you should first of all take some time to study Salix Startup Guide, as it is specifically intended to be accessible to newcomers. The desktop link, Salix Online, will bring you to the Salix<link xl:href="http://www.salixos.org/wiki/index.php/Home">Homepage</link>. You could also use the<link xl:href="http://webchat.freenode.net/?randomnick=1&amp;channels=salix&amp;prompt=1">IRC link</link>above to be in live communication with members of the community and get instant help if necessary. If you do however, you might want to modify the default<emphasis>qwebircxxx</emphasis>login to something more personal and human readable.</para>
    <para><inlinemediaobject><imageobject role="html">
          <imagedata align="left" contentdepth="326" contentwidth="518" fileref="./SalixStartUpGuide_13.37_draft4_html_2c2d9d6.png" scalefit="1"/>
        </imageobject>
<imageobject role="fo">
          <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_2c2d9d6.png" scalefit="1" width="100%"/>
        </imageobject>
</inlinemediaobject></para>
    <para>We hope that the information here will allow you to get Salix up and running fairly straightforwardly, to begin exploring its potential, and above all to use it for what you want to do. Nonetheless, sometimes you may not know how to do something or be able to make it work.</para>
    <para>While Salix aims to be elegant and intuitive, every operating system has its own characteristics, and if you are new to Linux, the sheer fact that it is different means there will inevitably be a process of adaptation (see Linux is <link xl:href="http://linux.oneandoneis2.org/LNW.htm">Not Windows</link>), even where its very best features are concerned. The only way to climb the learning curve is by trying things out and using them. The more you explore Salix, the quicker you will become familiar with it. However, it is worth emphasising that the default set of applications (they vary depending on the version of Salix you choose, see <link linkend="dbdoclet.6.0.1.List-of-Applications-outline">List of Applications</link>) include many that have a very similar look and feel to those found on other operating systems, such as the office suite LibreOffice, which offers full compatibility with common file formats.</para>
    <para>Our <link xl:href="http://www.salixos.org/wiki/index.php?title=Documentation">Wiki</link> and <link xl:href="http://www.salixos.org/forum/">Forum</link> will be two other important sources of information. The search option of the forum will quickly show you if the question you have in mind has already been posted by a member of the community and if it has been answered. For the same reason, please also search the internet. If you are working on the command line (<link linkend="dbdoclet.4_1">Working with the Command Line Interface</link>), remember to consult <emphasis role="bold">man</emphasis> (and try <emphasis role="bold">man salix</emphasis> for a summary of key points specific to this distribution). There are several online forums devoted to Linux, such as <link xl:href="http://www.linuxquestions.org/">www.linuxquestions.org</link>. It should be noted that each forum has its own subculture, and sometimes explicit posting guidelines. If you post a query to a forum, bear <link xl:href="http://www.sas.upenn.edu/~haroldfs/dravling/grice.html">Paul Grice&apos;s conversational maxims</link> in mind: for instance, be as specific as possible and mention any information you have already found out. To put it another way, remember you are consulting a human community, not an interactive online encyclopedia; it is a conversation, something which can be easily lost sight of online.</para>
    <para>Forums are a concrete example of one of the qualities at the heart of Linux, which is that it is community-based. Rather than being a commercial product, in almost all cases it is developed by enthusiasts collaborating together for the sheer delight of making good software. This community extends out into the users of the distribution on its forums. Even if you just want to use core office, multimedia or network applications productively, over time the power that Linux gives users tends to promote self-reliance and an ability to configure and fix their computer setup independently. The same approach underlies the development of Linux as an operating system ̶ where there is room for improvement, someone will dive in and tinker. The cumulative result is that Linux today is highly usable out of the box.</para>
    <para>The best way to learn Linux is by using it to the full, finding out in the process how to make it do exactly what you want. After a while, though, it may be helpful to supplement this experience with some more systematic background. As mentioned in the section introducing the command line, the <link xl:href="http://www.salixos.org/forum/viewforum.php?f=30&amp;sid=8007ff0fe74d8ba139ecb29032db24d2">Documentation</link> board on the Salix forums contains a useful post on <link xl:href="http://www.salixos.org/forum/viewtopic.php?f=30&amp;t=852">tutorials and guides</link>. Wherever you find problems recur, it may be worth reading up on the underlying issues over time to gain broader knowledge, especially when it comes to general features of Linux that may be unfamiliar to you, such as file permissions.</para>
    <para>Some users may face problems at the very beginning with peripherals or the network. This can seem daunting if you are also adapting to a different operating system at the same time. Explore the options under Menu/System carefully. If difficulties persist, with judicious use of the information and help in the wiki and forums, you should hopefully get the essentials set up as you wish reasonably quickly; then you will be able to take Linux at your own pace.</para>
  </section>
  <section remap="h1">
    <title><anchor xml:id="dbdoclet.7" xreflabel=""/>7. Appendix</title>
    <section remap="h3">
      <title><anchor xml:id="listofapp" xreflabel=""/><anchor xml:id="dbdoclet.6.0.1.List-of-Applications-outline" xreflabel=""/><anchor xml:id="dbdoclet.6.0.1.List-of-Applications-outline.1" xreflabel=""/> List of Applications</title>
      <informaltable frame="none">
        <tgroup cols="6">
          <colspec colname="c1" colwidth="125"/>
          <colspec colname="c2" colwidth="98"/>
          <colspec colname="c3" colwidth="98"/>
          <colspec colname="c4" colwidth="98"/>
          <colspec colname="c5" colwidth="98"/>
          <colspec colname="c6" colwidth="97"/>
          <tbody>
            <row>
              <entry><para> <emphasis role="bold">Salix Edition</emphasis></para></entry>
              <entry><para> <emphasis role="bold">Xfce</emphasis></para></entry>
              <entry><para> <emphasis role="bold">KDE</emphasis></para></entry>
              <entry><para> <emphasis role="bold">Fluxbox</emphasis></para></entry>
              <entry><para> <emphasis role="bold">LXDE</emphasis></para></entry>
              <entry><para> <emphasis role="bold">Ratpoison</emphasis></para></entry>
            </row>
          </tbody>
          <tbody>
            <row>
              <entry><para> <emphasis role="bold">Web Browser</emphasis></para></entry>
              <entry><para> Firefox</para></entry>
              <entry><para> Firefox</para></entry>
              <entry><para> Firefox</para></entry>
              <entry><para> Midori</para></entry>
              <entry><para> Vimprobable2</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Word Processor</emphasis></para></entry>
              <entry><para> LibreOffice Writer</para></entry>
              <entry><para> KWord</para></entry>
              <entry><para> LibreOffice Writer</para></entry>
              <entry><para> AbiWord</para></entry>
              <entry/>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Email Client</emphasis></para></entry>
              <entry><para> Claws-mail</para></entry>
              <entry><para> KMail</para></entry>
              <entry><para> Claws-mail</para></entry>
              <entry><para> Claws-mail</para></entry>
              <entry><para> Mutt</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Picture Viewer</emphasis></para></entry>
              <entry><para> Viewnior</para></entry>
              <entry><para> Gwenview</para></entry>
              <entry><para> Viewnior</para></entry>
              <entry><para> Viewnior</para></entry>
              <entry><para> Viewnior</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Image Editing</emphasis></para></entry>
              <entry><para> GIMP</para></entry>
              <entry><para> Krita</para><para>KolorPaint</para><para>Karbon14</para></entry>
              <entry><para> GIMP</para></entry>
              <entry><para> mtPaint</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Video Editing</emphasis></para></entry>
              <entry><para> PiTiVi</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">File Manager</emphasis></para></entry>
              <entry><para> Thunar</para></entry>
              <entry><para> Dolphin</para></entry>
              <entry><para> PCMan</para></entry>
              <entry><para> PCMan</para></entry>
              <entry><para> Gnome-commander</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Window Manager</emphasis></para></entry>
              <entry><para> Xfce</para></entry>
              <entry><para> KWin</para></entry>
              <entry><para> Fluxbox</para></entry>
              <entry><para> openbox</para></entry>
              <entry><para> Ratpoison</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Instant Messaging</emphasis></para></entry>
              <entry><para> Pidgin</para></entry>
              <entry><para> Kopete</para></entry>
              <entry><para> Pidgin</para></entry>
              <entry><para> Pidgin</para></entry>
              <entry><para> Pidgin</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">VoIP</emphasis></para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Spreadsheet</emphasis></para></entry>
              <entry><para> LibreOffice Calc</para></entry>
              <entry><para> KSpread</para></entry>
              <entry><para> LibreOffice Calc</para></entry>
              <entry><para> Gnumeric</para></entry>
              <entry><para> sc</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Text Editor</emphasis></para></entry>
              <entry><para> Mousepad</para></entry>
              <entry><para> KWriter</para></entry>
              <entry><para> Leafpad</para></entry>
              <entry><para> Leafpad</para></entry>
              <entry><para> gvim</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Integrated Development Environment</emphasis></para></entry>
              <entry><para> Geany</para></entry>
              <entry><para> -</para></entry>
              <entry><para> Geany</para></entry>
              <entry><para> Geany</para></entry>
              <entry><para> gvim</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Pdf Reader</emphasis></para></entry>
              <entry><para> Document Viewer (Evince)</para></entry>
              <entry><para> OKular</para></entry>
              <entry><para> Document Viewer (Evince)</para></entry>
              <entry><para> ePDFViewer</para></entry>
              <entry><para> apvlv</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Multimedia Player</emphasis></para></entry>
              <entry><para> Parole Media Player</para></entry>
              <entry><para> Bangarang</para></entry>
              <entry><para> Whaawmp</para></entry>
              <entry><para> Whaawmp</para></entry>
              <entry><para> Whaawmp</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Music Player</emphasis></para></entry>
              <entry><para> Exaile</para></entry>
              <entry><para> Clementine Music Player</para></entry>
              <entry><para> Exaile</para></entry>
              <entry><para> Exaile</para></entry>
              <entry><para> Music On Console</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Disk Burner</emphasis></para></entry>
              <entry><para> Brasero</para></entry>
              <entry><para> K3b</para></entry>
              <entry><para> Brasero</para></entry>
              <entry><para> Brasero</para></entry>
              <entry><para> bashburn</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">CD Ripper</emphasis></para></entry>
              <entry><para> Asunder CD Ripper</para></entry>
              <entry><para> K3b</para></entry>
              <entry><para> Asunder CD Ripper</para></entry>
              <entry><para> Asunder CD Ripper</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Torrent Client</emphasis></para></entry>
              <entry><para> Transmission</para></entry>
              <entry><para> KTorrent</para></entry>
              <entry><para> Transmission</para></entry>
              <entry><para> Transmission</para></entry>
              <entry><para> rtorrent</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Blogging Client</emphasis></para></entry>
              <entry><para> -</para></entry>
              <entry><para> Blogilo</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Organiser</emphasis></para></entry>
              <entry><para> Orage</para></entry>
              <entry><para> KOrganizer</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">PIM</emphasis></para></entry>
              <entry><para> -</para></entry>
              <entry><para> Akonadi</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Desktop Wiki</emphasis></para></entry>
              <entry><para> zim</para></entry>
              <entry><para> KJots</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Multilingual Input</emphasis></para></entry>
              <entry><para> Ibus</para></entry>
              <entry><para> Ibus</para></entry>
              <entry><para> Ibus</para></entry>
              <entry><para> Ibus</para></entry>
              <entry><para> -</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Terminal Emulator</emphasis></para></entry>
              <entry><para> Xfce Terminal</para></entry>
              <entry><para> Konsole</para></entry>
              <entry><para> urxvt</para></entry>
              <entry><para> LXTerminal</para></entry>
              <entry><para> xterm</para></entry>
            </row>
            <row>
              <entry><para> <emphasis role="bold">Package Management</emphasis></para></entry>
              <entry><para> Gslapt</para><para>Sourcery</para></entry>
              <entry><para> Gslapt</para><para>Sourcery</para></entry>
              <entry><para> Gslapt</para><para>Sourcery</para></entry>
              <entry><para> Gslapt</para><para>Sourcery</para></entry>
              <entry><para> Gslapt</para><para>Sourcery</para></entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </section>
    <section remap="h3">
      <title>Selected Applications found in Salix</title>
      <section remap="h4">
        <title><anchor xml:id="abiword" xreflabel=""/>Abiword</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="319" contentwidth="444" fileref="./SalixStartUpGuide_13.37_draft4_html_m5fb48e46.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m5fb48e46.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>AbiWord is a word processing program suitable for a wide variety of word processing tasks.</para>
      </section>
      <section remap="h4">
        <title>Asunder</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="34" contentwidth="80" fileref="./SalixStartUpGuide_13.37_draft4_html_52bccc42.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_52bccc42.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Asunder is an Audio CD ripper and encoder for Linux. You can use Asunder to save tracks from an Audio CD as any of WAV, MP3, OGG, FLAC, WavPack, Musepack, AAC, and Monkey&apos;s Audio files.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="brasero" xreflabel=""/>Brasero</title>
        <para>Brasero is an application to burn CD/DVD. It is designed to be as simple as possible and has some unique features to enable users to create their discs easily and quickly.</para>
      </section>
      <section remap="h4">
        <title>  Catfish</title>
        <para>Catfish is a handy file searching tool which provides a unified, lightweight and simple interface for different search engines such as find, (s)locate, doodle, tracker and beagle.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="309" contentwidth="419" fileref="./SalixStartUpGuide_13.37_draft4_html_m3b40d09.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m3b40d09.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="claws-mail" xreflabel=""/>Claws-mail</title>
        <para>Claws Mail is an open source email and news client. It offers easy configuration and an abundance of features. It stores mail in the MH mailbox format as well as the Mbox mailbox format via a plugin.</para>
      </section>
      <section remap="h4">
        <title>  Document Viewer (Evince)</title>
        <para>Document Viewer is a a very lightweight, simple PDF document viewer.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="328" contentwidth="450" fileref="./SalixStartUpGuide_13.37_draft4_html_m51364628.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m51364628.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="epdfviewer" xreflabel=""/>ePDFview</title>
        <para>ePDFView is a lightweight PDF document viewer that only uses the GTK+ and Poppler libraries. It opens PDF files, save copies of documents, and has support for printing using CUPS.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="342" contentwidth="381" fileref="./SalixStartUpGuide_13.37_draft4_html_m6f714a64.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m6f714a64.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title>Exaile</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="305" contentwidth="451" fileref="./SalixStartUpGuide_13.37_draft4_html_m7dce7a41.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m7dce7a41.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Exaile is a music manager which incorporates automatic fetching of album art, lyrics fetching, Last.fm scrobbling, support for many portable media players, Internet radio such as Shoutcast, tabbed playlists, etc.</para>
      </section>
      <section remap="h4">
        <title>File Roller</title>
        <para>File Roller is an archive manager. Supported archive types include gzip, bzip, bzip2, compress, lzop, zip, jar, lha, rar, zoo, arj, 7-zip, etc.</para>
      </section>
      <section remap="h4">
        <title>  Firefox</title>
        <para>Mozilla Firefox is a free and open source web browser with tabbed browsing, spell checking, incremental find, private browsing and numerous plugins.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="309" contentwidth="404" fileref="./SalixStartUpGuide_13.37_draft4_html_723b438c.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_723b438c.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="galculator" xreflabel=""/>Galculator</title>
        <para>Galculator is a calculator featuring two user modes: basic and scientific mode. Basic mode is intended for simple computations while Scientific Mode is Galculator&apos;s state of the art.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="geany" xreflabel=""/>Geany</title>
        <para>Geany is a small and lightweight Integrated Development Environment which only has a few dependencies and is independent of any particular Desktop Environment.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="gftp" xreflabel=""/>  gFTP</title>
        <para>gFTP is an FTP client with both a text and a GUI interface. gFTP aims to be simple to use yet powerful.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="227" contentwidth="401" fileref="./SalixStartUpGuide_13.37_draft4_html_30e50154.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_30e50154.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title>Gigolo</title>
        <para>Gigolo is a frontend to easily manage connections to remote filesystems using GIO/GVfs. It allows you to quickly connect/mount a remote filesystem and browse local networks shares.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="gimp" xreflabel=""/>  Gimp</title>
        <para>GIMP (GNU Image Manipulation Program) is an image retouching and editing tool. In addition to offering free form drawing, it can accomplish essential image workflow steps such as resizing, editing, and cropping photos, combining multiple images, converting between different image formats as well as create basic animated images in GIF.</para>
      </section>
      <section remap="h4">
        <title> </title>
        <para></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="gnumeric" xreflabel=""/> Gnumeric</title>
        <para>The goal of Gnumeric is to be the best possible spreadsheet. While not attempting to clone existing applications, Gnumeric can however read files saved with other spreadsheets and offers a customizable feel that attempts to minimize the costs of transition.</para>
      </section>
      <section remap="h4">
        <title>  Gtkman</title>
        <para>GTKMan is a simple manual page viewer. Manual pages are viewed by specifying their name and optionally the section they are in, just as with the original man command. The manual pages are displayed in simple text form using the default system monospace font.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="287" contentwidth="275" fileref="./SalixStartUpGuide_13.37_draft4_html_m76479f8.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m76479f8.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="ibus" xreflabel=""/><anchor xml:id="scim" xreflabel=""/>Ibus</title>
        <para>Ibus is a new generation of input method editors after SCIM. It supports for more than thirty languages (Chinese, Japanese, Korean and other languages) on both qt and non-qt environments. (You may have to go to qtconfig and select &quot;ibus&quot; instead of &quot;xim&quot; in &quot;Interface&quot; -&gt; &quot;Default Input Method&quot;).</para>
      </section>
      <section remap="h4">
        <title>ISO Master</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="271" contentwidth="238" fileref="./SalixStartUpGuide_13.37_draft4_html_m4779bb05.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m4779bb05.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>ISO Master is an application for creating and modifying ISO9660 files (ISO images). Its functionalities include: creating an ISO image from scratch, adding or removing files and directories to/from a CD image, and creating bootable CDs using various boot record types.</para>
      </section>
      <section remap="h4">
        <title>Leafpad</title>
        <para>Leafpad is a very light simple text editor with printing support.</para>
      </section>
      <section remap="h4">
        <title>Meld</title>
        <para>Meld is a visual diff and merge tool. You can compare two or three files and edit them in place (diffs update dynamically). You can compare two or three folders and launch file comparisons. You can browse and view a working copy from popular version control systems such such as CVS, Subversion, Bazaar-ng and Mercurial.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="midori" xreflabel=""/>Midori</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="322" contentwidth="449" fileref="./SalixStartUpGuide_13.37_draft4_html_606a8104.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_606a8104.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Midori (Japanese for green) is a web browser that aims to be lightweight and fast. It uses the WebKit rendering engine.</para>
      </section>
      <section remap="h4">
        <title>Mousepad</title>
        <para>Mousepad is a simple text editor with printing support.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="164" contentwidth="403" fileref="./SalixStartUpGuide_13.37_draft4_html_m1a6aace3.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_m1a6aace3.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title>  </title>
        <para></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="mtpaint" xreflabel=""/> mtPaint</title>
        <para>mtPaint is a painting program designed to easily create pixel art and manipulate digital photos. Due to its efficient design it can run on older PC hardware (e.g. a 200MHz CPU and 16MB of free RAM).</para>
      </section>
      <section remap="h4">
        <title>  LibreOffice</title>
        <para>LibreOffice is the leading open-source office software suite for word processing, spreadsheets, presentations, graphics, databases and more. It is available in many languages and works on all common computers. It stores all your data in an international open standard format and can also read and write files from other common office software packages.</para>
      </section>
      <section remap="h4">
        <title> </title>
        <para></para>
      </section>
      <section remap="h4">
        <title>Orage</title>
        <para>Orage provides a calendar which integrates nicely into the Xfce Desktop Environment. It is highly configurable and supports alerts based on dates. It warns you with pop up or audible alarms. As it is an application for everyday use, it launches itself in the background and can be accessed using the Orage Clock plugin for the panel. Simply click on a date to display or set the agenda for the day.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="parole" xreflabel=""/><anchor xml:id="totem" xreflabel=""/> Parole Media Player</title>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="245" contentwidth="298" fileref="./SalixStartUpGuide_13.37_draft4_html_3e1bb30d.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_3e1bb30d.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
        <para>Parole Media Player is a media player (audio and video) which utilises the GStreamer framework for playback.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="pidgin" xreflabel=""/>Pidgin</title>
        <para>Pidgin is an easy to use and free chat client which lets you log in to accounts on multiple chat networks simultaneously. Pidgin is compatible with numerous chat networks out of the box: AIM, ICQ, Google Talk, Jabber/XMPP, MSN Messenger, Yahoo, etc.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="26" contentwidth="92" fileref="./SalixStartUpGuide_13.37_draft4_html_1b01889f.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_1b01889f.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="pitivi" xreflabel=""/><anchor xml:id="totem1" xreflabel=""/>PiTiVi Video Editor</title>
        <para>PiTiVi is an easy to use video editor. The interface is intuitive to most users. Just by dragging your video clips, you can create your own film clips.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="44" contentwidth="92" fileref="./SalixStartUpGuide_13.37_draft4_html_3e831056.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_3e831056.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="simplescan" xreflabel=""/><anchor xml:id="xsane" xreflabel=""/>Simple Scan</title>
        <para>Simple Scan allows you to scan your documents/photos with your scanner or even with your webcam!</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="transmission" xreflabel=""/>  Transmission</title>
        <para>Transmission is a <link xl:href="http://fr.wikipedia.org/wiki/BitTorrent_(protocole)">BitTorrent</link> client that is simple, lean and powerful.</para>
        <para><inlinemediaobject><imageobject role="html">
              <imagedata align="left" contentdepth="165" contentwidth="358" fileref="./SalixStartUpGuide_13.37_draft4_html_725004eb.png" scalefit="1"/>
            </imageobject>
<imageobject role="fo">
              <imagedata align="left" contentdepth="100%" fileref="./SalixStartUpGuide_13.37_draft4_html_725004eb.png" scalefit="1" width="100%"/>
            </imageobject>
</inlinemediaobject></para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="viewnior" xreflabel=""/><anchor xml:id="ristretto" xreflabel=""/>Viewnior</title>
        <para>Viewnior is a fast and lightweight picture viewer.</para>
      </section>
      <section remap="h4">
        <title><anchor xml:id="whaaw" xreflabel=""/>  Whaaw! MediaPlayer</title>
        <para>Whaaw! Media Player will play any audio/video files which GStreamer can manage. It supports fullscreen mode, seeking, changing video colour settings and more. It is intended to be a basic media player with few dependencies.</para>
      </section>
      <section remap="h4">
        <title>  Zim</title>
        <para>Zim is a bit of everything. In essence, it is a desktop wiki, and it allows you a great deal of flexibility regarding what you can do with it. For instance, one can use it to keep track of TODO lists of ideas, to take notes in a meeting, as a drafting tool for blog entries, mails and so on.</para>
      </section>
    </section>
  </section>
</article>
