New hooklist to collect avatar data from headers
[claws.git] / manual / advanced.xml
index b958d3c9c5da6e66a5ba692644d28eacd8154f8b..5d4cb6718a4c6aed85cca1cb3873090a0699cd08 100644 (file)
@@ -25,7 +25,7 @@
     <para>
         Additionally, it is possible to add toolbar entries for your
         actions. To do so, open the <quote>Configuration/Preferences</quote>
-        menu and select <quote>Customize Toolbars/Main Window</quote>.
+        menu and select <quote>Toolbars/Main Window</quote>.
        Select <quote>User Action</quote> in the <quote>Item type</quote>
        dropdown menu, then select the Action in the <quote>Event executed on click</quote>
        dropdown menu, and click the <quote>Icon</quote> button to select the
        <quote>Configuration/Preferences/Display/Colors</quote> page.
     </para>
   </section>
+  <section id="adv_tags">
+    <title>Tags</title>
+    <para>
+       Tags are short text notes which may be set on messages. They are useful
+       for classifying messages with your own words. These tags can be used
+       later to find the mails with Quick Search or to manage them with
+       filtering or processing rules, for example.
+    </para><para>
+       Tagged messages are displayed with a yellow background at the top of
+       the Message View. This line shows all tags associated with the
+       message. You can enable the "Tags" column in the Message List, so
+       tagged items can be seen without having to open the message.
+    </para><para>
+       Setting of tags is done by right-clicking on the message in the Message
+       List or by the corresponding option in Message menu. A panel with the
+       existing tags is shown and you can select some of them or just add a
+       new one. Removal of existing tags is also allowed, of course.
+    </para><para>
+       Once tags exist it's even easier, as the context menu allows you to
+       set and unset tags with just one click to the selected messages.
+       Mixed selections of tagged and untagged messages are allowed, and
+       Claws Mail is clever enough to do what you want to do in any case.
+    </para>
+  </section>
   <section id="adv_ml_support">
     <title>Mailing-List support</title>
     <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>.
+       about it on the <ulink 
+       url="http://www.claws-mail.org/clawsker.php">Clawsker page</ulink>.
     </para>
     <variablelist>
+      <varlistentry>
+       <term><literal>address_search_wildcard</literal></term>
+       <listitem>
+         <para>
+       TAB-address completion in the Compose window will match any part of the
+       string (1) or just the start of the string (0).
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>addressbook_use_editaddress_dialog</literal></term>
        <listitem>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>diff_added_color</literal></term>
+       <term><literal>diff_deleted_color</literal></term>
+       <term><literal>diff_hunk_color</literal></term>
+       <listitem>
+         <para>
+       Colors to use when displaying attachments in unified diff format.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>emphasis_color</literal></term>
        <listitem>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>enable_avatars</literal></term>
+       <listitem>
+         <para>
+       Enables capture and/or rendering of internal avatars (Face and
+       also X-Face headers if built with compface support). 
+       '0' disables both, '1' enables capture only, '2' enables rendering
+       only and '3' enables both.
+         </para>
+         <para>
+        Note that external plugins already providing these features may
+       disable partially or completely this to speed up process, regardless
+       of the configured value.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>enable_dotted_lines</literal></term>
        <listitem>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>folder_search_wildcard</literal></term>
+       <listitem>
+         <para>
+       The type-ahead function in the Select Folder window will match any
+       part of the folder name (1) or just the start of the folder name (0).
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>folderview_vscrollbar_policy</literal></term>
        <listitem>
        <term><literal>log_msg_color</literal></term>
        <term><literal>log_out_color</literal></term>
        <term><literal>log_warn_color</literal></term>
+       <term><literal>log_status_ok_color</literal></term>
+       <term><literal>log_status_nok_color</literal></term>
+       <term><literal>log_status_skip_color</literal></term>
        <listitem>
          <para>
        The colours used in the log window.
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>msgview_date_format</literal></term>
+       <listitem>
+         <para>
+       0 or 1. Use the same user-defined date format in the Message
+       View as is used in the Message List. Default is 0, turned off.
+         </para>
+       </listitem>
+      </varlistentry>      
       <varlistentry>
        <term><literal>outgoing_fallback_to_ascii</literal></term>
        <listitem>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>primary_paste_unselects</literal></term>
+       <listitem>
+         <para>
+       0 or 1. Causes the primary buffer to be cleared and the insertion
+       point to be repositioned when the middle mouse button is used
+       for pasting text. Default is 0, turned off.
+         </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>respect_flowed_format</literal></term>
        <listitem>
        Saves temporary files when opening attachment with write bit set.
          </para>
        </listitem>
+      </varlistentry>
+       <varlistentry>
+       <term><literal>show_compose_margin</literal></term>
+       <listitem>
+         <para>
+       0 or 1. Adds margins to the message text area in the Compose window.
+       Default is 0, turned off.
+         </para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+       <term><literal>show_inline_attachments</literal></term>
+       <listitem>
+         <para>
+       0 or 1. Show inline attachments in MimeView.
+       Default is 1, turned on.
+         </para>
+       </listitem>
       </varlistentry>
       <varlistentry>
        <term><literal>skip_ssl_cert_check</literal></term>
        </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>summary_from_show</literal></term>
+       <listitem>
+       <para>
+       Controls the data displayed in the From column in the Message List.
+       Default value 0 displays name, 1 displays address and 2 displays both
+       name and address. 
+       </para>
+       </listitem>
+      </varlistentry>
       <varlistentry>
        <term><literal>textview_cursor_visible</literal></term>
        <listitem>
          </para>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term><literal>zero_replacement_char</literal></term>
+       <listitem>
+         <para>
+       Character to show in Folder List counter columns when a folder contains
+       no messages. Default value is 0.
+         </para>
+       </listitem>
+      </varlistentry>
     </variablelist>
   </section>
   <section id="adv_autofaces">
        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.<emphasis>accountname</emphasis></filename>
-       and/or <filename>xface.<emphasis>accountname</emphasis></filename>,
+       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>