<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY legal SYSTEM "legal.xml">
  <!ENTITY appversion "0.3">
  <!ENTITY manrevision "0.3">
  <!ENTITY date "June 2008">
  <!ENTITY app "<application>LottaNZB</application>">
]>

<!-- =============Document Header ============================= -->
<book id="index" lang="en">
  <bookinfo>
    <title>&app; Manual (&manrevision;)</title>      
    
    <copyright>
      <year>2008</year>
      <holder>Sander Tuit</holder>
    </copyright>
    
    <publisher>
      <publishername>LottaNZB development team</publishername>
      <address>
        <email>avirulence@lottanzb.org</email>
      </address>
    </publisher>
    
    &legal;
    
    <authorgroup>
      <author>
        <firstname>Sander</firstname>
        <surname>Tuit</surname>
        <affiliation>
          <orgname>LottaNZB development team</orgname>
          <address>
            <email>avirulence@lottanzb.org</email>
          </address>
        </affiliation>
      </author>
    </authorgroup>
    
    <revhistory>
      <revision>
        <revnumber>LottaNZB User Manual V&manrevision;</revnumber>
        <date>&date;</date>
        <revdescription>
          <para role="author">
            Sander Tuit <email>avirulence@lottanzb.org</email>
          </para>
          <para role="publisher">LottaNZB development team</para>
        </revdescription>
      </revision>
    </revhistory>
    
    <releaseinfo>This manual describes version &appversion; of LottaNZB.</releaseinfo>
    
    <legalnotice>
      <title>Feedback</title>
      <para>To report a bug or make a suggestion regarding &app; or this manual, follow the directions on the
        <ulink url="https://bugs.launchpad.net/lottanzb" type="http">Launchpad bug tracker page</ulink>.
      </para>
    </legalnotice>
  </bookinfo>
  
  <indexterm zone="index">
    <primary>LottaNZB</primary>
  </indexterm>
  
  <!-- ============= Document Body ============================= -->
  <!-- ============= Introduction ============================== -->
  <chapter id="lottanzb-introduction">
    <title>Introduction</title>
    <para>
      &app; is an application for the GNOME desktop that enables you to download binary news from the Usenet.
    </para>
    <para>
      The Usenet is a world-wide distributed Internet discussion system that has been around long before the
      first websites showed up. Beside normal text messages, user may also post files, which are most commonly
      split up into different messages. To simplify the download of such files, the NZB file format was developed by
      the creators of the
      Newzbin.com Usenet Index. Such files contain the information about what is to be downloaded exactly and
      are usually created by Usenet search engines such as the mentioned one.
    </para>
    <para>
      &app; uses <ulink url="http://hellanzb.com/" type="http">HellaNZB</ulink> as its backend to process such
      NZB files and download the files they point to, and finally validate and extract the downloads if necessary.
      But &app; can do even more than that and lets you:
    </para>
    <itemizedlist>
      <listitem>
        <para>Use it as a stand-alone NZB Usenet client or as a front-end for a HellaNZB client running on any computer</para>
      </listitem>
      <listitem>
        <para>Enqueue multiple NZB files directly from within your file manager and web browser at once</para>
      </listitem>
      <listitem>
        <para>Arrange the download queue and add NZB files using drag 'n drop</para>
      </listitem>
      <listitem>
        <para>Define multiple Usenet servers</para>
      </listitem>
      <listitem>
        <para>Limit the bandwidth used to download</para>
      </listitem>
      <listitem>
        <para>Easily configure both HellaNZB and &app; without having manually edit configuration files</para>
      </listitem>
    </itemizedlist>
    <para>
      Thanks to the work of &app; users from different countries, &app; is available in Danish, Dutch, French,
      German and Spanish.
    </para>
  </chapter>
  
  <!-- =========== Getting Started ============================== -->
  <chapter id="lottanzb-getting-started">
    <title>Getting Started</title>
    
    <sect1 id="lottanzb-start">
      <title>How to launch &app;</title>
      <para>
        You can start &app; in the following ways:
      </para>
      <variablelist>
        <varlistentry>
          <term>
            <guimenu>Applications</guimenu> menu
          </term>
          <listitem>
            <para>
              Choose 
              <menuchoice>
                <guisubmenu>Internet</guisubmenu> <guimenuitem>LottaNZB Automated Usenet Client</guimenuitem>
              </menuchoice>.
            </para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Command line</term>
          <listitem>
            <para>
              To start &app; from a command line, type the following command, 
              then press <keycap>Return</keycap>:
            </para>
            <para>
              <command>lottanzb</command>
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect1>
    
    <sect1 id="lottanzb-mode-selection">
      <title>First Start of &app;</title>
      <para>When you start &app; the first time, you will need to configure it.
        You will be asked to select the usage mode that fits you best.
      </para>
      <para>&app; tries to find out which is the most appropriate mode for you
        and displays a hint at the bottom of the window that will help you decide.
        &app; has three usage modes, which are described below.
      </para>
      
      <sect2 id="lottanzb-mode-selection-standalone">
        <title>Stand-alone mode</title>
        <para>If you do not want the HellaNZB daemon to run in the background all the time,
          or if you do not want to set up the daemon yourself, this is probably the best usage mode for you.
          When &app; starts, it automatically launches the HellaNZB daemon and shuts it down when &app; closes.
          When you don't have a clue about what the HellaNZB daemon is, this will also be the best choice for
          you.
        </para>
        <para>If you want to use the stand-alone mode, you need to fill in the address and port
          provided by your Usenet server. Note that the default port is 119. When the server requires
          authentication, you will need to fill in your username and password as well.
          On the bottom of the usage selection window you can fill in the location of the HellaNZB daemon.
          However, this should be detected automatically.
        </para>
        
        <tip>
          <para>This information is necessary to immediately begin downloading. Primarily, this window is only meant to be
            used on first startup of &app;. Later on, you can edit those values in the preferences window,
            where you can even specify multiple servers, enable SSL encryption etc.
          </para>
        </tip>
        
        <figure id="assistant-fig">
          <title>Usage mode selection dialog</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/UsageStandAlone.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Shows the dialog you can set up the stand-alone mode with.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </sect2>
      
      <sect2 id="lottanzb-mode-selection-local">
        <title>Local front-end mode</title>
        <para>If you have already set up the HellaNZB daemon and want to have it running
          in the background all the time, you should choose the local front-end mode.
        </para>
        <para>If you want to use the local front-end usage mode, you just have to select
          the configuration file HellaNZB uses. This is named hellanzb.conf and can usually
          be found in /etc, /usr/etc or ~/.hellanzb.
        </para>
        <note>
          <para>
            You will not be able to change HellaNZB's settings in &app; if you choose this mode.
          </para>
        </note>
        
        <figure id="local-fig">
          <title>Usage mode selection dialog for local front-end</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/UsageLocal.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Shows the dialog you can set up the local front-end mode with.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </sect2>
      
      <sect2 id="lottanzb-mode-selection-remote">
        <title>Remote front-end mode</title>
        <para>If you want to connect to a HellaNZB daemon that runs on another computer,
          you should choose this usage mode. It will not be possible to change settings
          or add NZB files in this mode, but you can monitor the progress of your downloads.
        </para>
        
        <para>If you want to use the remote front-end mode, you should fill in
          the IP address and port of the computer the HellaNZB daemon runs on and
          the XML RPC password for the HellaNZB daemon.
        </para>
        
        <figure id="remote-fig">
          <title>Usage mode selection dialog for remote front-end</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/UsageRemote.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Shows the dialog you can set up the remote front-end mode with.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </sect2>
    </sect1>
    
    <sect1 id="lottanzb-mainwindow">
      <title>Main Window</title>
      <para>When &app; has been set up correctly, &app;'s main window will be displayed.</para>	
      
      <figure id="mainwindow-fig">
        <title>Main window</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/MainWindow.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Shows &app; main window. Contains titlebar, menubar, toolbar, download area, and
                information bar. Menubar contains File, Edit and Help menus.
              </phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>
      
      <para>The &app; window contains the following elements:</para>
      
      <variablelist>
        <varlistentry>
          <term>Menubar.</term>
          <listitem>
            <para>The menus on the menubar contains some commands that can be used to work with &app;.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Toolbar.</term>
          <listitem>
            <para>The toolbar contains some commands that might come in handy.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Infobar.</term>
          <listitem>
            <para>The infobar displays information about items that are currently being downloaded.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>Download area.</term>
          <listitem>
            <para>The download area shows items that are currently being downloaded, that are being
              processed, that are in the queue or that are finished.
            </para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect1>
  </chapter>
  
  <!-- ================ Usage ================================ -->
  <chapter id="lottanzb-usage">
    <title>Usage</title>
    <para>You can use &app; to perform the tasks described in the following sections:</para>
    
    <sect1 id="lottanzb-add-file">
      <title>Downloading an item</title>
      <para>There are several ways to add an item to the download queue:</para>
      
      <sect2 id="lottanzb-add-file-desktop-integration">
        <title>From within your file manager and web browser</title>
        <para>
          When you install &app;, it is registered as an application to handle NZB files. This enables you to
          add NZB files to the download queue just by clicking on them in your file manager. When downloading
          an NZB file, your web browser should give you the possibility to directly pass it over to &app;.
        </para>
        <tip>
          <para>You can even select multiple NZB files in your file manager and enqueue all of them at once.</para>
        </tip>
      </sect2>
      
      <sect2 id="lottanzb-add-file-menu">
        <title>Using the <guimenu>File</guimenu> menu</title>
        
        <para>
          First of all, choose 
          <menuchoice>
            <guimenu>File</guimenu><guimenuitem>Add NZB files</guimenuitem>
          </menuchoice>.
          The <guilabel>Add files</guilabel> dialog (see screenshot below) is displayed. Select the file
          you want to add (it is possible to select multiple files), then edit the name and category
          at the bottom of the dialog and click <guibutton>Add</guibutton>.
        </para>
        
        <figure id="lottanzb-add-file-menu-fig">
          <title>Add files dialog</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/FileAddMenu.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>
                  Shows the <guilabel>Add files</guilabel> menu.
                </phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </sect2>
      
      <sect2 id="lottanzb-add-file-toolbar">
        <title>Using the <guibutton>Add</guibutton> toolbar button</title>
        <para>
          The third way to add NZB files to the queue is to use the <guibutton>Add</guibutton> button in
          the toolbar. This button opens the same <guilabel>Add files</guilabel> dialog as described
          above.
        </para>
      </sect2>
      
      <sect2 id="lottanzb-add-file-dragdrop">
        <title>Using drag 'n drop</title>
        <para>
          Another way to add NZB files to the queue is to drag them from the file manager or desktop
          onto the download queue. The <guilabel>Add files</guilabel> dialog will be opened with the
          dragged file selected. It is also possible to drag 'n drop multiple files onto the download
          queue. The files will then be automatically added to the queue.
        </para>
      </sect2>
      
      <sect2 id="lottanzb-add-file-newzbin">
        <title>Using Newzbin.com</title>
        <para>
          The final way to add NZB files is only accessible when a Newzbin.com account has been set up in
          the <guilabel>Preferences</guilabel> window. If a Newzbin.com account has been set up, it is
          possible to add a download to the download queue by entering the Newzbin.com ID. To do so, go to 
          <menuchoice>
            <guimenu>File</guimenu> <guimenuitem>Add file from Newzbin.com</guimenuitem>
          </menuchoice>. Now, the <guilabel>Add download</guilabel> dialog will be displayed. Fill in the
          Newzbin.com ID, click <guibutton>Add</guibutton> and the download will automatically start. 	   
        </para>
        
        <note>
          <para>
            After hitting <guibutton>Add</guibutton>, it may take several seconds for the download to
            appear in the download queue. This is because &app; needs to download the NZB file from Newzbin.com first.
            So exercise yourself in patience.
          </para>
        </note>
        
        <figure id="newzbin-fig">
          <title>Add a download from Newzbin.com</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/Newzbin.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>
                  Shows the <guilabel>Add download</guilabel> dialog.
                </phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </sect2>
    </sect1>
    
    <!-- <sect1 id="lottanzb-delete-file">
      <title>Deleting an NZB file from the download queue</title>
      <para>
        To delete a file from the download queue, first select it, and then click
        <guibutton>Remove</guibutton>.
      </para>
    </sect1> -->
    
    <sect1 id="lottanzb-monitor">
      <title>Monitoring the download progress</title>
      <para>
        When &app; is running and you have added some files to the download queue,
        the files show up in the <guilabel>download area</guilabel>.
        In the <guilabel>download area</guilabel> you find four columns:
      </para>
      <itemizedlist>
        <listitem>
          <para>
            <guilabel>Name</guilabel>: This column shows the name of the item.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Category</guilabel>: This column shows to which category the item belongs to.
            When the item is downloaded and processed, it will show up in the
            <guilabel>download directory</guilabel> with the category prefixed to its name.
            When the item was added to the download queue by drag 'n drop, it will be in the 'Other'
            category.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Size</guilabel>: This column shows the size of the item.
          </para>
        </listitem>
        <listitem>
          <para>
            <guilabel>Progress</guilabel>: This column shows the progress of the queued item.
            There are five possible states a downloading item can have:
          </para>
          
          <itemizedlist>
            <listitem>
              <para>
                <guilabel>Downloading</guilabel>: When an item is being downloaded,
                the percentage which is downloaded is shown in this column.
                On the screenshot below you can see an item that is being downloaded.
              </para>
              
              <figure id="downloadingmultiple-fig">
                <title>Downloading</title>
                <screenshot>
                  <mediaobject>
                    <imageobject>
                      <imagedata fileref="figures/DownloadingMultiple.png" format="PNG"/>
                    </imageobject>
                    <textobject>
                      <phrase>Shows a file that is currently being downloaded.</phrase>
                    </textobject>
                  </mediaobject>
                </screenshot>
              </figure>
            </listitem>
            <listitem>
              <para>
                <guilabel>Queued</guilabel>: When an item is queued, it waits until
                the current active download is complete and the items above it in the
                queue are downloaded. By clicking <guibutton>Move up/down</guibutton>
                you can change the queue's order. You can also drag 'n drop the items 
                until the queue is correctly ordered. In the screenshot above you can see two queued files.
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Processing</guilabel>: When an item is being processed, it is checked for integrity and when
                found complete, it is extracted and moved to the <guilabel>download directory</guilabel>.
                On the screenshot below you can see an item that is being processed.
              </para>
              
              <figure id="processing-fig">
                <title>Processing</title>
                <screenshot>
                  <mediaobject>
                    <imageobject>
                      <imagedata fileref="figures/Processing.png" format="PNG"/>
                    </imageobject>
                    <textobject>
                      <phrase>Shows a file that is being processed.</phrase>
                    </textobject>
                  </mediaobject>
                </screenshot>
              </figure>
            </listitem>
            <listitem>
              <para>
                <guilabel>Repairing</guilabel>: When an item is being repaired, it means that
                there are some integrity problems with the download. Note that repairing may take some
                time.
              </para>
            </listitem>
            <listitem>
              <para>
                <guilabel>Finished</guilabel>: When an item is finished, it can be removed
                from the <guilabel>download area</guilabel> by clicking the <guibutton>Clear finished</guibutton>
                button.
              </para>
            </listitem>
          </itemizedlist>
        </listitem>
      </itemizedlist>
    </sect1>
    
    <sect1 id="lottanzb-rearranging">
      <title>Rearranging the download queue</title>
      <para>
        There are situations in which you want some items to be downloaded before others.
        There are two ways to accomplish this:
      </para>
      
      <itemizedlist>
        <listitem>
          <para>
            The first way to rearrange queued items is to use the <guibutton>Move up</guibutton> and <guibutton>Move
              down
            </guibutton>
            buttons. First, select the item you want to move up or down and then click the corresponding button in the
            toolbar.
          </para>
        </listitem>
        
        <listitem>
          <para>
            The second way to rearrange queued items it to drag 'n drop. First, select an item you want moved up or
            down and then drag it to the position in queue you want the download to be. The screenshot below shows an
            item (Ubuntu 7.10 DVD) that is being moved to a lower position in the download queue.
          </para>
          
          <figure id="dragdropqueue-fig">
            <title>Rearranging by drag 'n drop</title>
            <screenshot>
              <mediaobject>
                <imageobject>
                  <imagedata fileref="figures/DragDropQueue.png" format="PNG"/>
                </imageobject>
                <textobject>
                  <phrase>Shows a queue item that is being moved.</phrase>
                </textobject>
              </mediaobject>
            </screenshot>
          </figure>
        </listitem>
      </itemizedlist>
    </sect1>
  </chapter>
  
  <!-- ============= Customization ============================= -->
  <chapter id="lottanzb-prefs">
    <title>Settings</title>
    <para>
      To configure &app;, choose 
      <menuchoice>
        <guimenu>Edit</guimenu><guimenuitem>Preferences</guimenuitem>
      </menuchoice>.
      The <guilabel>Preferences</guilabel> dialog contains the following tabbed sections:
    </para>
    
    <sect1 id="lottanzb-prefs-general">
      <title>General settings</title>
      <para>
        Below you can find a screenshot of the <guilabel>general settings</guilabel> tab.
        
        <figure id="preferencesgeneral-fig">
          <title>General settings tab</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/Preferences.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>General settings tab.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </para>
      
      <variablelist>
        <varlistentry>
          <term>
            <guilabel>Download settings</guilabel>
          </term>
          <listitem>
            <itemizedlist>
              <listitem>
                <para>
                  <guilabel>Download directory</guilabel>
                </para>
                <para>
                  When downloaded items have finished processing, they are moved to this directory.
                  Make sure there is enough disk space available at the selected location.
                  To change the download destination directory, click on the directory button and 
                  select one of the locations in the list, or choose <guilabel>Other...</guilabel>.
                </para>
                
              </listitem>
              
              <listitem>
                <para>
                  <guilabel>Maximum download rate</guilabel>
                </para>
                <para>
                  Some people want to have some bandwidth available for checking e-mail and browsing websites. When
                  you do not have enough bandwidth, you can limit the bandwidth the HellaNZB daemon uses.
                </para>
                
                <note>
                  <para>
                    The HellaNZB daemon does not really limit the download speed, but it averages the download speed by
                    stopping with downloading for a second or so, to average the download speed to the value you have
                    filled in here.
                  </para>
                </note>
              </listitem>
              
              <listitem>
                <para>
                  <guilabel>Download PAR recovery files only if necessary</guilabel>
                </para>
                <para>
                  When downloaded items are damaged, they can be repaired by using PAR files when available. If this
                  option is selected, &app; only downloads the recovery files when the downloaded items are damaged.
                  This can significantly decrease the size of the downloaded files.
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
        </varlistentry>
        
        <varlistentry>
          <term>
            <guilabel>Other settings</guilabel>
          </term>
          
          <listitem>
            <itemizedlist>
              <listitem>
                <para>
                  <guilabel>Start in the system tray</guilabel>
                </para>
                <para>
                  When this option is selected, &app; will not show the main window when started, but will only show
                  the system tray icon. By right-clicking the system icon and clicking <guilabel>Show main window</guilabel> you can show the main window. This option come in handy when you want to start &app; when you start your desktop environment, but do not want the main window to show up everytime you log in.
                </para>
              </listitem>
              
              <listitem>
                <para>
                  <guilabel>Use libnotify notifications</guilabel>
                </para>
                <para>
                  When this option is selected, libnotify notifications, which blend in with your Gnome desktop, are
                  displayed for example when downloads are finished.
                </para>
              </listitem>
            </itemizedlist>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect1>
    
    <!-- ============= Customization Subsection ===================== -->
    <sect1 id="lottanzb-prefs-server">
      <title>Server settings</title>
      <para>
        Below, you can find a screenshot of the <guilabel>server settings</guilabel> tab.
        <figure id="preferencesserver-fig">
          <title>Server settings tab</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/PreferencesServer.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Server settings tab.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </para>
      <para>
        As the screenshot above shows, there are three buttons that can be used: 
        <itemizedlist>
          <listitem>
            <para>
              <xref linkend="lottanzb-server-add"/>
            </para>
          </listitem>
          
          <listitem>
            <para>Editing the selected server's settings</para>
          </listitem>
          
          <listitem>
            <para>Deleting the selected server</para>
          </listitem>
        </itemizedlist>
      </para>
      
      <sect3 id="lottanzb-server-add">
        <title>Adding a new Usenet server</title>
        <para>
          When you click the <guilabel>add</guilabel> button in the server preferences tab,
          we get the <guilabel>Add server</guilabel> dialog as depicted on the screenshot below.
          This window is the same as the <guilabel>Edit server</guilabel> dialog.
          
          <figure id="addserverdialog-fig">
            <title>Add/edit server dialog</title>
            <screenshot>
              <mediaobject>
                <imageobject>
                  <imagedata fileref="figures/PreferencesServerEdit.png" format="PNG"/>
                </imageobject>
                <textobject>
                  <phrase>Add/edit server dialog.</phrase>
                </textobject>
              </mediaobject>
            </screenshot>
          </figure>
        </para>
        
        <variablelist>
          <varlistentry>
            <term>
              <guilabel>General</guilabel>
            </term>
            <listitem>
              <para>We need the following options when adding a new Usenet server:</para>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Server name</guilabel>
                  </para>
                  <para>
                    This contains the current servers name. This name is not very important.
                    It just provides a label for the server list. However, note that it should be
                    an unique name.
                  </para>
                </listitem>
                
                <listitem>
                  <para>
                    <guilabel>Address</guilabel>
                  </para>
                  <para>The address of the Usenet server. Note that you should not include the port
                    number.
                  </para>
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Port</guilabel>
                  </para>
                  <para>The port of the Usenet server. The default port for most servers is 119.</para> 
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
          
          <varlistentry>
            <term>
              <guilabel>Authentication</guilabel>
            </term>
            <listitem>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Server requires authentication</guilabel>
                  </para>
                  <para>Enable this option when your Usenet server requires you to log in.</para> 
                </listitem>
                
                <listitem>
                  <para>
                    <guilabel>Username</guilabel>
                  </para>
                  <para>
                    If your Usenet server requires you to log in, you should fill in the user name that was provided.
                  </para>
                  
                </listitem>
                <listitem>
                  <para>
                    <guilabel>Password</guilabel>
                  </para>
                  <para>
                    If your Usenet server requires you to log in, you should fill in the password that was provided.
                  </para>
                  
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
          
          <varlistentry>
            <term>
              <guilabel>Connection settings</guilabel>
            </term>
            <listitem>
              <itemizedlist>
                <listitem>
                  <para>
                    <guilabel>Enable SSL encryption</guilabel>
                  </para>
                  <para>
                    Enable this option if your Usenet server provides SSL encryption. Most Usenet servers provide this
                    as a premium service. If downloading from this server does not work, try to disable this option,
                    since your server most likely does not support SSL encryption.
                  </para>
                  
                </listitem>
                
                <listitem>
                  <para>
                    <guilabel>Maximum number of connections</guilabel>
                  </para>
                  <para>
                    Most Usenet servers have a maximum number of connections that can be used by their customers. You
                    should fill in the maximum number of connections allowed here.
                  </para>
                  
                  <tip>
                    <para>
                      If you have a slow internet connection, you should decrease the number of connections even more
                      to get an optimal download speed.
                    </para>
                  </tip>
                </listitem>
              </itemizedlist>
            </listitem>
          </varlistentry>
        </variablelist>
      </sect3>
    </sect1>
    
    <sect1 id="lottanzb-prefs-newzbin">
      <title>Newzbin settings</title>
      <para>The Newzbin.com website offers nicely categorized NZB files that can be used in &app;. &app; now allows you to add a download by just entering the ID that Newzbin.com provides.</para>
      <para>Newzbin.com has a closed registration system at the moment, which means that you should know someone with an account in order to be able to use this service. Secondly, it's important to know that you need premium credits in order for usage of Newzbin.com.</para>
      <tip>
        <para>If you are looking for a free source of NZB files, please take a look at binsearch.info. This website allows you to search for and create NZB files.</para>
      </tip>
	  <para>
        <figure id="newzbinsetting-fig">
          <title>Newzbin.com settings.</title>
          <screenshot>
            <mediaobject>
              <imageobject>
                <imagedata fileref="figures/PreferencesNewzbin.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase>Newzbin.com settings.</phrase>
              </textobject>
            </mediaobject>
          </screenshot>
        </figure>
      </para>
      <variablelist>
        <varlistentry>
          <term>
            <guilabel>Authentication</guilabel>
          </term>
          <listitem>
            <para>When you enable Newzbin support, you have to fill in the following settings:</para>
            <itemizedlist>
              <listitem>
                <para>
                  <guilabel>Username</guilabel>
                </para>
                <para>The username Newzbin.com provided you with.</para> 
              </listitem>
              
              <listitem>
                <para>
                  <guilabel>Password</guilabel>
                </para>
                <para>The password Newzbin.com provided you with.</para>
              </listitem>
            </itemizedlist>
          </listitem>
          
        </varlistentry>
      </variablelist>
      
    </sect1>
    
    
  </chapter>
  <!-- ============= Bugs ================================== -->
  <!-- This section is optional and is commented out by default. 
      You can use it to describe known bugs and limitations of the 
      program if there are any - please be frank and list all
      problems you know of. 
      
      <chapter id="mayapp-bugs">
      <title>Known Bugs and Limitations</title>
      <para></para>
      </chapter>
    -->
  
  <!-- ============= About ================================== -->
  <chapter id="lottanzb-about">
    <title>About &app;</title>
    <para>
      The first versions of &app; were written by Sander (aVirulence).
      Early 2008, Severin (Lantash) joined the development team, rewriting most of the code
      and making &app; the great application it is now. Somewhat later, Stéphane also joined the 
      team as &app;'s resident tester and translator. After &app; 0.2 had been launched, Andrew joined the team, fixing bugs and implementing new features. To find more information about &app;, please visit the 
      <ulink url="http://www.lottanzb.org" type="http">&app; website</ulink>.
    </para>
    <para>
      To report a bug or make a suggestion regarding this application or
      this manual, visit the  
      <ulink url="https://bugs.launchpad.net/lottanzb" type="http">&app; launchpad page</ulink>.
    </para>
    <para>
      This program is distributed under the terms of the GNU
      General Public license as published by the Free Software
      Foundation; version 3 of the License, A copy of this license can be found at this
      <ulink url="http://www.gnu.org/licenses" type="http">link</ulink>, or in the file
      LICENSE included with the source code of this program.
    </para>
  </chapter>
</book>
