2005-11-18 [colin] 1.9.100cvs22
[claws.git] / manual / advanced.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="ch_advanced">
3 <title>Advanced features</title>
4
5   <section id="adv_actions">
6     <title>Actions</title>
7     <para>
8     Actions allow you to use all the power of the Unix command-line with your emails. You can define various commands, taking parameters such as the current email file, a list of emails, the currently selected text, and so on. In this way, you'll be able to perform various tasks such as editing a raw mail in your text editor, "hide" what you mean using ROT-13, apply patches contained in emails directly, and so on. The only limit is your imagination. You can configure Actions via the Tools menu.
9     </para>
10   </section>
11
12   <section id="adv_templates">
13     <title>Templates</title>
14     <para>
15     Templates are used in Composition windows, and are a sort of "model" letters. Templates can be filled with static text and dynamic parts, such as the original sender's name ("Dear %N, ..."), the date, ... When applying a template, the dynamic fields will be replaced with the relevant values. You can configure templates via the Tools menu.
16     </para>
17   </section>
18
19   <section id="adv_processing">
20     <title>Processing</title>
21     <para>
22     Processing rules are the same as Filtering rules, except that they are applied when entering a folder and apply only to this folder. You can use them to automatically move old mails into an archive folder, or for further dispatching of emails. You can set each folder's Processing rules by right-clicking on it.
23     </para>
24     <para>
25     Processing rules are accompanied by Preprocessing and Postprocessing rules. Like Processing rules, they apply only when opening a folder, but like Filtering rules, they are shared accross all folders. You can configure them from the Tools menu.
26     </para>
27   </section>
28
29   <section id="adv_plugins">
30     <title>Plugins</title>
31     <para>
32       Plugins are the mechanism of extending Sylpheed-Claws capabilities. Imagine 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 it. With Sylpheed-Claws you can simply write a plugin to achieve the task.
33     </para>
34     <para>
35       This is only an example of the possibilities. Already exist a good number of plugins developed for Sylpheed-Claws, and more are to come. The <link linkend="ch_plugins">Extending Sylpheed-Claws section</link> is devoted to all of them.
36     </para>
37   </section>
38
39   <section id="adv_hidden">
40     <title>Hidden preferences</title>
41     <para>
42     There are a number of hidden preferences in Sylpheed-Claws, preferences that some users we wanted to please couldn't live without, but which did not had a place in the GUI in our opinions. You can find the following, and change them while Sylpheed-Claws is not running in ~/.sylpheed-claws/sylpheedrc.
43     <itemizedlist>
44       <listitem><para>bold_unread
45       show unread messages using bold font in summary view
46       </para></listitem>
47       <listitem><para>color_new
48       color (as hex triplet) of folder name when indicating new messages
49       </para></listitem>
50       <listitem><para>cache_max_mem_usage
51       the maximum amount of memory to use to cache messages, in kB.
52       </para></listitem>
53       <listitem><para>cache_min_keep_time
54       the minimum time to keep a cache in memory, in minutes. Caches more recent than this time will not be freed, even if the memory usage is too high.
55       </para></listitem>
56       <listitem><para>enable_hscrollbar
57       enables horizontal scrollbar in summaryview
58       </para></listitem>
59       <listitem><para>enable_rules_hint
60       enable alternate lines in GtkTreeViews
61       </para></listitem>
62       <listitem><para>enable_swap_from
63       display sender's email address in To column in Sent folder instead of recipient's
64       </para></listitem>
65       <listitem><para>folderview_vscrollbar_policy
66       specify the policy of vertical scroll bar of folder view
67       </para></listitem>
68       <listitem><para>hover_timeout
69       time in milliseconds that will cause a folder tree to expand during drag n drop when the mouse cover is held over it
70       </para></listitem>
71       <listitem><para>statusbar_update_step
72       update stepping in progress bars
73       </para></listitem>
74       <listitem><para>textview_cursor_visible
75       display the cursor in the message view
76       </para></listitem>
77       <listitem><para>thread_by_subject_max_age
78       number of days to include a message in a thread when using 'Thread using subject in addition to standard headers'
79       </para></listitem>
80       <listitem><para>toolbar_detachable
81       hide handles in the toolbars
82       </para></listitem>
83       <listitem><para>utf8_instead_of_locale_for_broken_mail
84       use UTF-8 encoding for broken mails instead of current locale
85       </para></listitem>
86       <listitem><para>warn_dnd
87       display a confirmation dialog on drag n drop of folders
88       </para></listitem>
89     </itemizedlist>
90     
91     </para>
92   </section>
93   
94 </section>
95