2008-04-23 [paul] 3.4.0cvs8
[claws.git] / manual / advanced.xml
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="ch_advanced">
3   <title>Advanced features</title>
4   <section id="adv_actions">
5     <title>Actions</title>
6     <para>
7         Actions allow you to use all the power of the Unix command-line with 
8         your emails. You can define various commands, taking parameters such 
9         as the current email file, a list of emails, the currently selected 
10         text, and so on. In this way, you'll be able to perform various tasks
11         such as editing a raw mail in your text editor, 
12         <emphasis>hide</emphasis> what you mean using ROT-13, apply patches 
13         contained in emails directly, and so on. The only limit is your 
14         imagination. You can create and configure Actions via the
15         <quote>/Configuration/Actions...</quote> menu.
16     </para>
17     <para>
18         The <quote>Tools/Actions/</quote> menu will contain one submenu
19         item for each action that you have created. When you have selected
20         one or more messages in the Message List, or are viewing a message
21         in the Message View, selecting one of these menu items will invoke
22         the action, and, depending on how it was defined, will pass the
23         message(s) to it.
24     </para>
25     <para>
26         Additionally, it is possible to add toolbar entries for your
27         actions. To do so, open the <quote>Configuration/Preferences</quote>
28         menu and select <quote>Customize Toolbars/Main Window</quote>.
29         Select <quote>User Action</quote> in the <quote>Item type</quote>
30         dropdown menu, then select the Action in the <quote>Event executed on click</quote>
31         dropdown menu, and click the <quote>Icon</quote> button to select the
32         icon that you want to use.
33     </para>
34     <blockquote>
35       <example>
36         <title>Simple <quote>Open With...</quote></title>
37         <variablelist>
38           <varlistentry>
39             <term>
40         Menu name: <emphasis>Open with/kate</emphasis> 
41         Command Line: <command>kate %p</command>
42             </term>
43             <listitem>
44               <para>
45         Opens the file of the selected decoded MIME part 
46         (<emphasis>%p</emphasis>) with the <emphasis>kate</emphasis> text 
47         editor.
48               </para>
49             </listitem>
50           </varlistentry>
51         </variablelist>
52       </example>
53       <example>
54         <title>Spam management using <ulink 
55           url="http://bogofilter.sourceforge.net/">Bogofilter</ulink>
56         </title>
57         <variablelist>
58           <varlistentry>
59             <term>
60         Menu name: <emphasis>Bogofilter/Mark as Ham</emphasis> 
61         Command Line: <command>bogofilter -n -v -B "%f"</command>
62             </term>
63             <listitem>
64               <para>
65         Marks the currently selected mails (<emphasis>%f</emphasis>) as
66         <quote>not spam</quote> using <emphasis>Bogofilter</emphasis>.
67               </para>
68             </listitem>
69           </varlistentry>
70           <varlistentry>
71             <term>
72         Menu name: <emphasis>Bogofilter/Mark as Spam</emphasis> 
73         Command Line: <command>bogofilter -s -v -B "%f"</command>
74             </term>
75             <listitem>
76               <para>
77         Marks the currently selected mails (<emphasis>%f</emphasis>) as 
78         <quote>spam</quote> using <emphasis>Bogofilter</emphasis>.
79               </para>
80             </listitem>
81           </varlistentry>
82         </variablelist>
83       </example>
84       <example>
85         <title>Search Google using an external script</title>
86         <variablelist>
87           <varlistentry>
88             <term>
89         Menu name: <emphasis>Search/Google</emphasis> 
90         Command Line: <command>|/path/to/google_search.pl</command>
91             </term>
92             <listitem>
93               <para>
94         Searches Google for the currently selected text 
95         (<emphasis>|</emphasis>) using the external script <emphasis><ulink 
96         url="http://www.claws-mail.org/tools.php"
97         >google_search.pl</ulink></emphasis>.
98               </para>
99             </listitem>
100           </varlistentry>
101         </variablelist>
102       </example>
103     </blockquote>
104   </section>
105   <section id="adv_templates">
106     <title>Templates</title>
107     <para>
108         Templates are used in composition windows, and act as a model for 
109         emails. Templates can be filled with static text and dynamic parts, 
110         such as the original sender's name (<quote>Dear %N, ...</quote>), 
111         the date, etc. When applying a template, the dynamic fields will be 
112         replaced with the relevant values. You can configure templates via 
113         the <quote>Tools</quote> menu.
114     </para><para>
115         When applying a template, you will be asked to <quote>Insert</quote>
116         or <quote>Replace</quote>, the difference between replacing and 
117         inserting is only concerned with the message body. 
118         <quote>Replace</quote> will replace the current composition window 
119         message body with the body defined in the template, clearing it if 
120         the template body is empty. <quote>Insert</quote> will insert 
121         the template's body, if set, at the current cursor position.
122     </para><para>
123         Whether you choose to Insert or Replace, any To, Cc or Bcc field 
124         that is defined in the template will be appended to the compose 
125         window's recipients list. If it is defined, the template's Subject 
126         will always replace the compose window's Subject.
127     </para><para>
128         Symbols can be used in all parts of the templates and will be 
129         substituted with their respective dynamic value if possible, otherwise 
130         no value will be used. This often makes more sense if you apply a 
131         template when replying or forwarding, otherwise most of the symbols 
132         value will be undefined. There is no restriction on which symbols can 
133         be used in template parts, even if inserting the body (%M or %Q) may 
134         make no sense in common situations.
135     </para><para>
136         When applying a template, the body is processed first, then the To, Cc,
137         Bcc and Subject fields follow.
138     </para><para>
139         Further information and examples of usage can be found in the 
140         user-contributed FAQ on the Claws Mail website <ulink 
141         url="http://www.claws-mail.org/faq/"
142         >http://www.claws-mail.org/faq/</ulink>.
143     </para>
144    </section>
145   <section id="adv_processing">
146     <title>Processing</title>
147     <para>
148         Processing rules are the same as Filtering rules, except that they are 
149         applied when entering a folder or when manually applied from a folder's
150         context menu and apply only     to this folder. You can use them to automatically
151         move old mails into an archive folder, or for further dispatching of
152         emails, and more. You can set each folder's Processing rules by
153         right-clicking on it.
154     </para><para>
155         Processing rules are accompanied by Pre-processing and Post-processing 
156         rules. Like Processing rules, they apply when opening a folder or manually
157         applying them from a folder's context menu, but like Filtering rules,
158         they are shared across all folders. You can configure them from the
159         <quote>Tools</quote> menu. Pre-processing rules are executed before the
160         folder's specific Processing rules, while Post-processing rules are executed
161         afterwards.
162     </para>
163   </section>
164   <section id="adv_colour_labels">
165     <title>Colour Labels</title>
166     <para>
167         Colour labels can be used to denote a message as having a particular 
168         significance. To set a colour label simply right-click a message in the
169         Message List and use the <quote>Color label</quote> submenu.
170     </para><para>
171         Colour labels are user-configurable. Both the colour and the label can 
172         be set by the user. Preferences can be found on the 
173         <quote>Configuration/Preferences/Display/Colors</quote> page.
174     </para>
175   </section>
176   <section id="adv_ml_support">
177     <title>Mailing-List support</title>
178     <para>
179         Claws Mail offers mailing-list support from the 
180         <quote>Message/Mailing-List/</quote> submenu. When you have a 
181         mailing-list message selected, the submenu allows you to quickly 
182         initiate subscribing, unsubscribing, posting, getting help, contacting 
183         the list owner, and viewing the list archive; either by opening a new 
184         Compose window with the appropriate address pre-filled, or by opening 
185         the URL in your web browser.
186     </para>
187   </section>
188   <section id="adv_plugins">
189     <title>Plugins</title>
190     <para>
191         Plugins are the mechanism for extending Claws Mail' capabilities. 
192         For example, imagine that you want to store your mails in a remote 
193         <acronym>SQL</acronym> database. In most mailers out there this is 
194         simply impossible without reworking the internals of the mailer. With 
195         Claws Mail you can simply write a plugin to achieve the task.
196     </para><para>
197         This is just an example of the possibilities. A good number of plugins 
198         developed for Claws Mail already exist, and more are to come. The 
199         <link linkend="ch_plugins">Extending Claws Mail section</link> 
200         gives details of them.
201     </para>
202   </section>
203   <section id="deploying">
204     <title>Deploying Claws Mail</title>
205     <para>
206         The initial configuration wizard tries to guess various fields using 
207         information gathered from the system, such as username, hostname, and 
208         more. As it is oriented towards general use, the default values often 
209         have to be fixed. However, this wizard is customisable, in a manner 
210         designed to allow system administrators to deploy Claws Mail easily
211         over various users of one machine, or even over multiple machines 
212         installed via some replication tool.
213     </para><para>
214         The first part consists of creating a wizard configuration template 
215         and setting the various default parameters of a new Claws Mail 
216         installation.
217     </para>
218     <itemizedlist>
219       <listitem>
220         <para>
221         Start with a user who does not have a <filename class="directory"
222         >~/.claws-mail</filename> directory, ideally a new user.
223         </para>
224       </listitem>
225       <listitem>
226         <para>
227         Start Claws Mail and go through the wizard. The values you fill in 
228         will be of no use for the future deployment, so you can click 
229         next-next-next.
230         </para>
231       </listitem>
232       <listitem>
233         <para>
234         Once the wizard is finished and you have Claws Mail' main window 
235         opened, configure the various defaults you want to have in the master. 
236         You can load plugins, add people or LDAP servers in the addressbook, 
237         create filtering rules, and so on.
238         </para>
239       </listitem>
240       <listitem>
241         <para>
242         If needed, and if the deployed Claws Mail will use MH folders, you 
243         can create subdirectories in the mailbox.
244         </para>
245       </listitem>
246       <listitem>
247         <para>
248         Next, quit Claws Mail.
249         </para>
250       </listitem>
251       <listitem>
252         <para>
253         Now, edit the newly created wizard template file, 
254         <filename>~/.claws-mail/accountrc.tmpl</filename>. In this file, 
255         you will see different variables, corresponding to the wizard's fields.
256         You can leave some commented, in which case the usual default will be 
257         used, or specify values or variables. Not all fields can contain 
258         variables; for example, <literal>smtpauth</literal>, 
259         <literal>smtpssl</literal> and <literal>recvssl</literal> are booleans,
260         either 0 or 1, and <literal>recvtype</literal> is an integer value. The
261         other fields, like <literal>name</literal>, <literal>email</literal>, 
262         or <literal>recvuser</literal>, are parsed by the wizard and the 
263         variables they contain are replaced by values. This allows you to 
264         specify everything as needed for your site, even if you have strange 
265         server names or server logins.
266         </para>
267       </listitem>
268       <listitem>
269         <para>
270         Save this file, and delete both 
271         <filename>~/.claws-mail/accountrc</filename>, (which contains your 
272         dummy account) and 
273         <filename>~/.claws-mail/folderlist.xml</filename>, (so that the 
274         folder tree will be correctly parsed for new users). Recursively copy 
275         <filename class="directory">.claws-mail</filename> to 
276         <filename class="directory">/etc/skel/</filename>; if the deployed 
277         Claws Mail will use MH folders, also copy the created 
278         <filename class="directory">Mail</filename> directory. chown all of 
279         <filename class="directory">/etc/skel/.claws-mail</filename> 
280         and <filename class="directory">/etc/skel/Mail</filename> to 
281         <literal>root:root</literal> for security reasons.
282         </para>
283       </listitem>
284       <listitem>
285         <para>
286         Test! Create a new user, login as that user, run Claws Mail. If you
287         filled everything as you wanted, this user will just have to fill in 
288         his passwords.
289         </para>
290       </listitem>
291       <listitem>
292         <para>
293         Now, if you're creating a master for a site-wide deployment, you can 
294         continue with this process. If you were just doing it for one machine, 
295         you're done!
296         </para>
297       </listitem>
298     </itemizedlist>
299     <para>
300     Here are the different variables of the <filename>accountrc.tmpl</filename>
301     file:
302     </para>
303     <variablelist>
304       <varlistentry>
305         <term><literal>domain</literal></term>
306         <listitem>
307           <para>
308         Your domain name (example.com). If not set, it'll be extracted from the
309         hostname.
310           </para>
311         </listitem>
312       </varlistentry>
313       <varlistentry>
314         <term><literal>name</literal></term>
315         <listitem>
316           <para>
317         The user's name. If not set, it'll be extracted from Unix login 
318         information, which is usually ok.
319           </para>
320         </listitem>
321       </varlistentry>
322       <varlistentry>
323         <term><literal>email</literal></term>
324         <listitem>
325           <para>
326         The user's email. If not set, it'll be extracted from 
327         <literal>$name</literal> and <literal>$domain</literal>.
328           </para>
329         </listitem>
330       </varlistentry>
331       <varlistentry>
332         <term><literal>organization</literal></term>
333         <listitem>
334           <para>
335         Your organization. If not set, it'll be empty.
336           </para>
337         </listitem>
338       </varlistentry>
339       <varlistentry>
340         <term><literal>smtpserver</literal></term>
341         <listitem>
342           <para>
343         The SMTP server to use. If not set, it'll be 
344         <literal>smtp.$domain</literal>.
345           </para>
346         </listitem>
347       </varlistentry>
348       <varlistentry>
349         <term><literal>smtpauth</literal></term>
350         <listitem>
351           <para>
352         0 or 1. Whether to authenticate on the SMTP server. If not set, it'll 
353         be 0.
354           </para>
355         </listitem>
356       </varlistentry>
357       <varlistentry>
358         <term><literal>smtpuser</literal></term>
359         <listitem>
360           <para>
361         The login on the SMTP server. If not set, it'll be empty (same login as
362         for reception will be used).
363           </para>
364         </listitem>
365       </varlistentry>
366       <varlistentry>
367         <term><literal>smtppass</literal></term>
368         <listitem>
369           <para>
370         The password on the SMTP server. If not set, it'll be empty (if 
371         <literal>smtppass</literal> is empty but <literal>smtpuser</literal> is
372         not, the user will be asked for the password).
373           </para>
374         </listitem>
375       </varlistentry>
376       <varlistentry>
377         <term><literal>recvtype</literal></term>
378         <listitem>
379           <para>
380         The type of server to receive from. 0 for POP3, 3 for IMAP4, 5 for a 
381         local MBOX file. If not set, it'll be 0 (POP3).
382           </para>
383         </listitem>
384       </varlistentry>
385       <varlistentry>
386         <term><literal>recvserver</literal></term>
387         <listitem>
388           <para>
389         The reception server. If not set, it'll be 
390         <literal>(pop|imap).$domain</literal>, depending on 
391         <literal>$recvtype</literal>.
392           </para>
393         </listitem>
394       </varlistentry>
395       <varlistentry>
396         <term><literal>recvuser</literal></term>
397         <listitem>
398           <para>
399         The login on the reception server. If not set, it'll be extracted from 
400         the Unix login information.
401           </para>
402         </listitem>
403       </varlistentry>
404       <varlistentry>
405         <term><literal>recvpass</literal></term>
406         <listitem>
407           <para>
408         The password on the reception server. If not set, it'll be empty (the 
409         user will be asked for it once per session).
410           </para>
411         </listitem>
412       </varlistentry>
413       <varlistentry>
414         <term><literal>imapdir</literal></term>
415         <listitem>
416           <para>
417         The IMAP subdirectory. If not set, it'll be empty, which is often 
418         sufficient.
419           </para>
420         </listitem>
421       </varlistentry>
422       <varlistentry>
423         <term><literal>mboxfile</literal></term>
424         <listitem>
425           <para>
426         The MBOX file to receive from if <literal>$recvtype</literal> is 5. 
427         If not set, <literal>/var/mail/$LOGIN</literal>.
428           </para>
429         </listitem>
430       </varlistentry>
431       <varlistentry>
432         <term><literal>mailbox</literal></term>
433         <listitem>
434           <para>
435         The MH mailbox to store mail in (for <literal>$recvtype</literal> 0 or 
436         5). If not set, it'll be <quote>Mail</quote>.
437           </para>
438         </listitem>
439       </varlistentry>
440       <varlistentry>
441         <term><literal>smtpssl</literal></term>
442         <listitem>
443           <para>
444         0 or 1. Whether to use SSL for sending mail. If not set, it'll be 0.
445           </para>
446         </listitem>
447       </varlistentry>
448       <varlistentry>
449         <term><literal>recvssl</literal></term>
450         <listitem>
451           <para>
452         0 or 1. Whether to use SSL for receiving mail. If not set, it'll be 0.
453           </para>
454         </listitem>
455       </varlistentry>
456     </variablelist>
457     <para>
458         Here are the different variables you can use in the 
459         <literal>domain</literal>, <literal>name</literal>, 
460         <literal>email</literal>, <literal>organization</literal>, 
461         <literal>smtpserver</literal>, <literal>smtpuser</literal>, 
462         <literal>smtppass</literal>, <literal>recvserver</literal>, 
463         <literal>recvuser</literal>, <literal>recvpass</literal>, 
464         <literal>imapdir</literal>, <literal>mboxfile</literal> and 
465         <literal>mailbox</literal> fields:
466     </para>
467     <variablelist>
468       <varlistentry>
469         <term><literal>$DEFAULTDOMAIN</literal></term>
470         <listitem>
471           <para>
472         The domain name as extracted from Unix hostname information. 
473         Often wrong.
474           </para>
475         </listitem>
476       </varlistentry>
477       <varlistentry>
478         <term><literal>$DOMAIN</literal></term>
479         <listitem>
480           <para>
481         The domain name as set in the domain variable, the first of the 
482         template file.
483           </para>
484         </listitem>
485       </varlistentry>
486       <varlistentry>
487         <term><literal>$USERNAME</literal></term>
488         <listitem>
489           <para>The user's real name.</para>
490         </listitem>
491       </varlistentry>
492       <varlistentry>
493         <term><literal>$LOGIN</literal></term>
494         <listitem>
495           <para>The user's Unix login.</para>
496         </listitem>
497       </varlistentry>
498       <varlistentry>
499         <term><literal>$NAME_MAIL</literal></term>
500         <listitem>
501           <para>
502         The user's real name as set in the name variable of the template field,
503         in lowercase and with spaces replaced by dots. 
504         <quote>Colin Leroy</quote> becomes <quote>colin.leroy</quote>.
505           </para>
506         </listitem>
507       </varlistentry>
508       <varlistentry>
509         <term><literal>$EMAIL</literal></term>
510         <listitem>
511           <para>
512         The email address as set in the email variable of the template field.
513           </para>
514         </listitem>
515       </varlistentry>
516     </variablelist>
517     <para>
518         Be sure not to use a variable before defining it.
519     </para>
520   </section>
521   <section id="adv_hidden">
522     <title>Hidden preferences</title>
523     <para>
524         There are a number of hidden preferences in Claws Mail, preferences
525         that some users who we wanted to please couldn't live without, but 
526         which did not have a place in the GUI in our opinion. You can find the 
527         following, and change them while Claws Mail is not running, in 
528         <filename>~/.claws-mail/clawsrc</filename>.
529     </para>
530     <variablelist>
531       <varlistentry>
532         <term><literal>addressbook_use_editaddress_dialog</literal></term>
533         <listitem>
534           <para>
535         Use a separate dialogue to edit a person's details. 
536         '0' will use a form embedded in the addressbook's main window.
537           </para>
538         </listitem>
539       </varlistentry>
540       <varlistentry>
541         <term><literal>bold_unread</literal></term>
542         <listitem>
543           <para>
544         Show unread messages in the Message List using a bold font.
545           </para>
546         </listitem>
547       </varlistentry>
548       <varlistentry>
549         <term><literal>cache_max_mem_usage</literal></term>
550         <listitem>
551           <para>
552         The maximum amount of memory to use to cache messages, in kB.
553           </para>
554         </listitem>
555       </varlistentry>
556       <varlistentry>
557         <term><literal>cache_min_keep_time</literal></term>
558         <listitem>
559           <para>
560         The minimum time in minutes to keep a cache in memory. Caches more 
561         recent than this time will not be freed, even if the memory usage is 
562         too high.
563           </para>
564         </listitem>
565       </varlistentry>
566       <varlistentry>
567         <term><literal>compose_no_markup</literal></term>
568         <listitem>
569           <para>
570         Don't use bold and italic text in Compose dialogue's account selector.
571           </para>
572         </listitem>
573       </varlistentry>
574       <varlistentry>
575         <term><literal>emphasis_color</literal></term>
576         <listitem>
577           <para>
578         The colour used for the X-Mailer line when its value is Claws Mail.
579           </para>
580         </listitem>
581       </varlistentry>
582       <varlistentry>
583         <term><literal>enable_dotted_lines</literal></term>
584         <listitem>
585           <para>
586         Use the <emphasis>old</emphasis> dotted line look in the main window
587         GtkTreeView components, (Folder List and Message List), instead of the
588         <emphasis>modern</emphasis> lineless look.
589           </para>
590         </listitem>
591       </varlistentry>
592       <varlistentry>
593         <term><literal>enable_hscrollbar</literal></term>
594         <listitem>
595           <para>
596         Enable the horizontal scrollbar in the Message List.
597           </para>
598         </listitem>
599       </varlistentry>
600       <varlistentry>
601         <term><literal>enable_swap_from</literal></term>
602         <listitem>
603           <para>
604         Display the sender's email address in the To column of the
605         Sent folder instead of the recipient's.
606           </para>
607         </listitem>
608       </varlistentry>
609       <varlistentry>
610         <term><literal>folderview_vscrollbar_policy</literal></term>
611         <listitem>
612           <para>
613         Specify the policy of vertical scrollbar of Folder List.
614         '0' is always shown, '1' is automatic, '2' is always hidden.
615           </para>
616         </listitem>
617       </varlistentry>
618       <varlistentry>
619         <term><literal>hover_timeout</literal></term>
620         <listitem>
621           <para>
622         Time in milliseconds that will cause a folder tree to expand 
623         when the mouse cursor is held over it during drag 'n' drop.
624           </para>
625         </listitem>
626       </varlistentry>
627       <varlistentry>
628         <term><literal>live_dangerously</literal></term>
629         <listitem>
630           <para>
631         Don't ask for confirmation before definitive deletion of emails.
632           </para>
633         </listitem>
634       </varlistentry>
635       <varlistentry>
636         <term><literal>log_error_color</literal></term>
637         <term><literal>log_in_color</literal></term>
638         <term><literal>log_msg_color</literal></term>
639         <term><literal>log_out_color</literal></term>
640         <term><literal>log_warn_color</literal></term>
641         <listitem>
642           <para>
643         The colours used in the log window.
644           </para>
645         </listitem>
646       </varlistentry>
647       <varlistentry>
648         <term><literal>respect_flowed_format</literal></term>
649         <listitem>
650           <para>
651         0 or 1. Respect format=flowed on text/plain message parts. This
652         will cause some mails to have long lines, but will fix some URLs
653         that would otherwise be wrapped. Default is 0, turned off.
654           </para>
655         </listitem>
656       </varlistentry>
657       <varlistentry>
658         <term><literal>save_parts_readwrite</literal></term>
659         <listitem>
660           <para>
661         Saves temporary files when opening attachment with write bit set.
662           </para>
663         </listitem>
664       </varlistentry>
665       <varlistentry>
666         <term><literal>skip_ssl_cert_check</literal></term>
667         <listitem>
668           <para>
669         Disables the verification of SSL certificates.
670           </para>
671         </listitem>
672       </varlistentry>
673       <varlistentry>
674         <term><literal>statusbar_update_step</literal></term>
675         <listitem>
676           <para>
677         Update stepping in progress bars.
678           </para>
679         </listitem>
680       </varlistentry>
681       <varlistentry>
682         <term><literal>stripes_color_offset</literal></term>
683         <listitem>
684         <para>
685         Specify the value to use when creating alternately coloured lines in
686         GtkTreeView components. The smaller the value, the less visible the
687         difference in the alternating colours of the lines.
688         </para>
689         </listitem>
690       </varlistentry>
691       <varlistentry>
692         <term><literal>textview_cursor_visible</literal></term>
693         <listitem>
694           <para>
695         Display the cursor in the message view.
696           </para>
697         </listitem>
698       </varlistentry>
699       <varlistentry>
700         <term><literal>thread_by_subject_max_age</literal></term>
701         <listitem>
702           <para>
703         Number of days to include a message in a thread when using 
704         <quote>Thread using subject in addition to standard headers</quote>.
705           </para>
706         </listitem>
707       </varlistentry>
708       <varlistentry>
709         <term><literal>toolbar_detachable</literal></term>
710         <listitem>
711           <para>
712         Show handles in the toolbars.
713           </para>
714         </listitem>
715       </varlistentry>
716       <varlistentry>
717         <term><literal>two_line_vertical</literal></term>
718         <listitem>
719           <para>
720         Spread message list information over two lines when using the
721         three column layout.
722           </para>
723         </listitem>
724       </varlistentry>
725       <varlistentry>
726         <term><literal>unsafe_ssl_certs</literal></term>
727         <listitem>
728         <para>
729         Allows Claws to remember multiple SSL certificates for a given 
730         server/port. This is disabled by default.
731         </para>
732         </listitem>
733       </varlistentry>
734       <varlistentry>
735         <term><literal>use_networkmanager</literal></term>
736         <listitem>
737         <para>
738         Use NetworkManager to switch offline automatically. This is enabled
739         by default.
740         </para>
741         </listitem>
742       </varlistentry>
743       <varlistentry>
744         <term><literal>use_stripes_everywhere</literal></term>
745         <listitem>
746         <para>
747         Enable alternately coloured lines in GtkTreeView components.
748         </para>
749         </listitem>
750       </varlistentry>
751       <varlistentry>
752         <term><literal>use_stripes_in_summaries</literal></term>
753         <listitem>
754         <para>
755         Enable alternately coloured lines in the main window GtkTreeView
756         components, (Folder List and Message List). The only useful way to
757         use this option is to set it to 0 when use_stripes_everywhere is set
758         to 1.
759         </para>
760         </listitem>
761       </varlistentry>
762       <varlistentry>
763         <term><literal>utf8_instead_of_locale_for_broken_mail</literal></term>
764         <listitem>
765           <para>
766         Use UTF-8 encoding for broken mails instead of current locale.
767           </para>
768         </listitem>
769       </varlistentry>
770       <varlistentry>
771         <term><literal>warn_dnd</literal></term>
772         <listitem>
773           <para>
774         Display a confirmation dialogue on drag 'n' drop of folders.
775           </para>
776         </listitem>
777       </varlistentry>
778     </variablelist>
779   </section>
780 </section>
781