2008-06-22 [mones] 3.4.0cvs105
[claws.git] / manual / advanced.xml
index 3ac4a76228b6ad2fa006550bb3bc441a1154cd96..d0018cbbbbd504b99dab4d6c077d39caff766703 100644 (file)
        following, and change them while Claws Mail is not running, in 
        <filename>~/.claws-mail/clawsrc</filename>.
     </para>
+    <para>
+       There's a small tool written in Perl-GTK called Clawsker which 
+       provides a user-friendly GUI for tweaking these settings instead of
+       direct editing of <filename>clawsrc</filename>. You can read more
+       about it on the <ulink url="http://www.claws-mail.org/clawsker">Clawsker
+       page</ulink>.
+    </para>
     <variablelist>
       <varlistentry>
        <term><literal>addressbook_use_editaddress_dialog</literal></term>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>outgoing_fallback_to_ascii</literal></term>
+       <listitem>
+         <para>
+       0 or 1. The outgoing encoding of a message will use 7bit US-ASCII
+       whenever it is suitable for the message content, ignoring the
+       <quote>Outgoing encoding</quote> option unless it is necessary. Turning
+       this option off forces the user-defined encoding to be used, regardless
+       of message content. Default is 1, turned on.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>respect_flowed_format</literal></term>
        <listitem>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>two_line_vertical</literal></term>
+       <listitem>
+         <para>
+       Spread message list information over two lines when using the
+       three column layout.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>unsafe_ssl_certs</literal></term>
        <listitem>
       </varlistentry>
     </variablelist>
   </section>
+  <section id="adv_autofaces">
+    <title>Autofaces</title>
+    <para>
+       Claws Mail allows setting the Face and X-Face headers directly
+       from files, either globally for all defined accounts 
+       or on a per-account basis. These files must be placed in the
+       <filename>~/.claws-mail/autofaces/</filename> directory.
+    </para>
+    <para>
+       If they exist, the global Face and/or X-Face headers for all
+       accounts are taken from the <filename>face</filename> and/or
+       <filename>xface</filename> files respectively. In a similar
+       manner, Face and/or X-Face headers for a specific account can
+       be provided by <filename>face.</filename><emphasis>accountname</emphasis>
+       and/or <filename>xface.</filename><emphasis>accountname</emphasis>,
+       where <emphasis>accountname</emphasis> is the name of the account you 
+       want this header to be associated with.
+   </para>
+   <para>
+       If the name of the account contains characters which may be unsuitable 
+       for the underlying filesystem (including spaces) these are replaced by 
+       underscores (<quote>_</quote>) when searching for the autofaces of 
+       that account. For example, if your account is called 
+       <quote>&lt;My Mail&gt;</quote>, the name for the X-Face filename for
+       that account would be
+       <filename>~/.claws-mail/autofaces/xface._My_Mail_</filename>.
+       Be aware that this feature doesn't check the content of the files,
+       or for duplication of headers, (most mailers, including Claws 
+       Mail, will ignore duplicates and display the last one only). 
+    </para>
+  </section>
 </section>