2007-04-19 [paul] 2.9.0cvs9
[claws.git] / manual / advanced.xml
index 218199224778a3701cfc98a419b7aef81a8262bf..1da53701afdafd06464554368a6db4929b375c74 100644 (file)
@@ -76,7 +76,7 @@
              <para>
        Searches Google for the currently selected text 
        (<emphasis>|</emphasis>) using the external script <emphasis><ulink 
-       url="http://www.sylpheed-claws.net/tools.php"
+       url="http://www.claws-mail.org/tools.php"
        >google_search.pl</ulink></emphasis>.
              </para>
            </listitem>
        Bcc and Subject fields follow.
     </para><para>
        Further information and examples of usage can be found in the 
-       user-contributed FAQ on the Sylpheed-Claws website <ulink 
-       url="http://www.sylpheed-claws.net/faq/"
-       >http://www.sylpheed-claws.net/faq/</ulink>.
+       user-contributed FAQ on the Claws Mail website <ulink 
+       url="http://www.claws-mail.org/faq/"
+       >http://www.claws-mail.org/faq/</ulink>.
     </para>
    </section>
   <section id="adv_processing">
     </para><para>
        Processing rules are accompanied by Pre-processing and Post-processing 
        rules. Like Processing rules, they apply only when opening a folder, 
-       but like Filtering rules, they are shared accross all folders. You can 
+       but like Filtering rules, they are shared across all folders. You can 
        configure them from the <quote>Tools</quote> menu. Pre-processing rules
        are executed before the folder's specific Processing rules, while 
        Post-processing rules are executed afterwards.
   <section id="adv_ml_support">
     <title>Mailing-List support</title>
     <para>
-       Sylpheed-Claws offers mailing-list support from the 
+       Claws Mail offers mailing-list support from the 
        <quote>Message/Mailing-List/</quote> submenu. When you have a 
        mailing-list message selected, the submenu allows you to quickly 
        initiate subscribing, unsubscribing, posting, getting help, contacting 
   <section id="adv_plugins">
     <title>Plugins</title>
     <para>
-       Plugins are the mechanism for extending Sylpheed-Claws' capabilities. 
+       Plugins are the mechanism for extending Claws Mail' capabilities. 
        For example, imagine that you want to store your mails in a remote 
        <acronym>SQL</acronym> database. In most mailers out there this is 
        simply impossible without reworking the internals of the mailer. With 
-       Sylpheed-Claws you can simply write a plugin to achieve the task.
+       Claws Mail you can simply write a plugin to achieve the task.
     </para><para>
        This is just an example of the possibilities. A good number of plugins 
-       developed for Sylpheed-Claws already exist, and more are to come. The 
-       <link linkend="ch_plugins">Extending Sylpheed-Claws section</link> 
+       developed for Claws Mail already exist, and more are to come. The 
+       <link linkend="ch_plugins">Extending Claws Mail section</link> 
        gives details of them.
     </para>
   </section>
   <section id="deploying">
-    <title>Deploying Sylpheed-Claws</title>
+    <title>Deploying Claws Mail</title>
     <para>
        The initial configuration wizard tries to guess various fields using 
        information gathered from the system, such as username, hostname, and 
        more. As it is oriented towards general use, the default values often 
        have to be fixed. However, this wizard is customisable, in a manner 
-       designed to allow system administrators to deploy Sylpheed-Claws easily
+       designed to allow system administrators to deploy Claws Mail easily
        over various users of one machine, or even over multiple machines 
        installed via some replication tool.
     </para><para>
        The first part consists of creating a wizard configuration template 
-       and setting the various default parameters of a new Sylpheed-Claws 
+       and setting the various default parameters of a new Claws Mail 
        installation.
     </para>
     <itemizedlist>
       <listitem>
         <para>
        Start with a user who does not have a <filename class="directory"
-       >~/.sylpheed-claws</filename> directory, ideally a new user.
+       >~/.claws-mail</filename> directory, ideally a new user.
        </para>
       </listitem>
       <listitem>
        <para>
-       Start Sylpheed-Claws and go through the wizard. The values you fill in 
+       Start Claws Mail and go through the wizard. The values you fill in 
        will be of no use for the future deployment, so you can click 
        next-next-next.
        </para>
       </listitem>
       <listitem>
         <para>
-       Once the wizard is finished and you have Sylpheed-Claws' main window 
+       Once the wizard is finished and you have Claws Mail' main window 
        opened, configure the various defaults you want to have in the master. 
        You can load plugins, add people or LDAP servers in the addressbook, 
        create filtering rules, and so on.
       </listitem>
       <listitem>
        <para>
-       If needed, and if the deployed Sylpheed-Claws will use MH folders, you 
+       If needed, and if the deployed Claws Mail will use MH folders, you 
        can create subdirectories in the mailbox.
        </para>
       </listitem>
       <listitem>
        <para>
-       Next, quit Sylpheed-Claws.
+       Next, quit Claws Mail.
        </para>
       </listitem>
       <listitem>
        <para>
        Now, edit the newly created wizard template file, 
-       <filename>~/.sylpheed-claws/accountrc.tmpl</filename>. In this file, 
+       <filename>~/.claws-mail/accountrc.tmpl</filename>. In this file, 
        you will see different variables, corresponding to the wizard's fields.
        You can leave some commented, in which case the usual default will be 
        used, or specify values or variables. Not all fields can contain 
       <listitem>
        <para>
        Save this file, and delete both 
-       <filename>~/.sylpheed-claws/accountrc</filename>, (which contains your 
+       <filename>~/.claws-mail/accountrc</filename>, (which contains your 
        dummy account) and 
-       <filename>~/.sylpheed-claws/folderlist.xml</filename>, (so that the 
+       <filename>~/.claws-mail/folderlist.xml</filename>, (so that the 
        folder tree will be correctly parsed for new users). Recursively copy 
-       <filename class="directory">.sylpheed-claws</filename> to 
+       <filename class="directory">.claws-mail</filename> to 
        <filename class="directory">/etc/skel/</filename>; if the deployed 
-       Sylpheed-Claws will use MH folders, also copy the created 
+       Claws Mail will use MH folders, also copy the created 
        <filename class="directory">Mail</filename> directory. chown all of 
-       <filename class="directory">/etc/skel/.sylpheed-claws</filename> 
+       <filename class="directory">/etc/skel/.claws-mail</filename> 
        and <filename class="directory">/etc/skel/Mail</filename> to 
        <literal>root:root</literal> for security reasons.
        </para>
       </listitem>
       <listitem>
        <para>
-       Test! Create a new user, login as that user, run Sylpheed-Claws. If you
+       Test! Create a new user, login as that user, run Claws Mail. If you
        filled everything as you wanted, this user will just have to fill in 
        his passwords.
        </para>
   <section id="adv_hidden">
     <title>Hidden preferences</title>
     <para>
-       There are a number of hidden preferences in Sylpheed-Claws, preferences
+       There are a number of hidden preferences in Claws Mail, preferences
        that some users who we wanted to please couldn't live without, but 
        which did not have a place in the GUI in our opinion. You can find the 
-       following, and change them while Sylpheed-Claws is not running in 
-       <filename>~/.sylpheed-claws/sylpheedrc</filename>.
+       following, and change them while Claws Mail is not running, in 
+       <filename>~/.claws-mail/clawsrc</filename>.
     </para>
     <variablelist>
+      <varlistentry>
+       <term><literal>addressbook_use_editaddress_dialog</literal></term>
+       <listitem>
+         <para>
+       Use a separate dialogue to edit a person's details. 
+       '0' will use a form embedded in the addressbook's main window.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>bold_unread</literal></term>
        <listitem>
          <para>
-       Show unread messages using bold font in Message List.
+       Show unread messages in the Message List using a bold font.
          </para>
        </listitem>
       </varlistentry>
        <term><literal>cache_min_keep_time</literal></term>
        <listitem>
          <para>
-       The minimum time to keep a cache in memory, in minutes. Caches more 
+       The minimum time in minutes to keep a cache in memory. Caches more 
        recent than this time will not be freed, even if the memory usage is 
        too high.
          </para>
        </listitem>
       </varlistentry>
       <varlistentry>
-       <term><literal>enable_hscrollbar</literal></term>
+       <term><literal>enable_dotted_lines</literal></term>
        <listitem>
          <para>
-       Enables horizontal scrollbar in Message List.
+       Use the <emphasis>old</emphasis> dotted line look in the main window
+       GtkTreeView components, (Folder List and Message List), instead of the
+       <emphasis>modern</emphasis> lineless look.
          </para>
        </listitem>
       </varlistentry>
       <varlistentry>
-       <term><literal>enable_rules_hint</literal></term>
+       <term><literal>enable_hscrollbar</literal></term>
        <listitem>
          <para>
-       Enable alternate lines in GtkTreeView components.
+       Enable the horizontal scrollbar in the Message List.
          </para>
        </listitem>
       </varlistentry>
        <term><literal>enable_swap_from</literal></term>
        <listitem>
          <para>
-       Display sender's email address in To column in Sent folder instead of 
-       recipient's.
+       Display the sender's email address in the To column of the
+       Sent folder instead of the recipient's.
          </para>
        </listitem>
       </varlistentry>
        <term><literal>folderview_vscrollbar_policy</literal></term>
        <listitem>
          <para>
-       Specify the policy of vertical scroll bar of folder view.
+       Specify the policy of vertical scrollbar of Folder List.
+       '0' is always shown, '1' is automatic, '2' is always hidden.
          </para>
        </listitem>
       </varlistentry>
        <term><literal>hover_timeout</literal></term>
        <listitem>
          <para>
-       Time in milliseconds that will cause a folder tree to expand during 
-       drag 'n' drop when the mouse cursor is held over it.
+       Time in milliseconds that will cause a folder tree to expand 
+       when the mouse cursor is held over it during drag 'n' drop.
          </para>
        </listitem>
       </varlistentry>
        <term><literal>log_warn_color</literal></term>
        <listitem>
          <para>
-       Colours used in log window.
+       The colours used in the log window.
          </para>
        </listitem>
       </varlistentry>
       <varlistentry>
-       <term><literal>mark_as_read_delay</literal></term>
+       <term><literal>respect_flowed_format</literal></term>
        <listitem>
          <para>
-       Seconds to wait before marking a mail as read.
+       0 or 1. Respect format=flowed on text/plain message parts. This
+       will cause some mails to have long lines, but will fix some URLs
+       that would otherwise be wrapped. Default is 0, turned off.
          </para>
        </listitem>
       </varlistentry>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>stripes_color_offset</literal></term>
+       <listitem>
+       <para>
+       Specify the value to use when creating alternately coloured lines in
+       GtkTreeView components. The smaller the value, the less visible the
+       difference in the alternating colours of the lines.
+       </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>textview_cursor_visible</literal></term>
        <listitem>
        <term><literal>toolbar_detachable</literal></term>
        <listitem>
          <para>
-       Hide handles in the toolbars.
+       Show handles in the toolbars.
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>unsafe_ssl_certs</literal></term>
+       <listitem>
+       <para>
+       Allows Claws to remember multiple SSL certificates for a given 
+       server/port. This is disabled by default.
+       </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><literal>use_stripes_everywhere</literal></term>
+       <listitem>
+       <para>
+       Enable alternately coloured lines in GtkTreeView components.
+       </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><literal>use_stripes_in_summaries</literal></term>
+       <listitem>
+       <para>
+       Enable alternately coloured lines in the main window GtkTreeView
+       components, (Folder List and Message List). The only useful way to
+       use this option is to set it to 0 when use_stripes_everywhere is set
+       to 1.
+       </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>utf8_instead_of_locale_for_broken_mail</literal></term>
        <listitem>
        <term><literal>warn_dnd</literal></term>
        <listitem>
          <para>
-       Display a confirmation dialog on drag 'n' drop of folders.
+       Display a confirmation dialogue on drag 'n' drop of folders.
          </para>
        </listitem>
       </varlistentry>