/usr/share/doc/claws-mail/en/claws-mail-manual.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>The Claws Mail User Manual</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"></HEAD
><BODY
CLASS="article"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="ARTICLE"
><DIV
CLASS="TITLEPAGE"
><H1
CLASS="title"
><A
NAME="AEN1"
>The Claws Mail User Manual</A
></H1
><H3
CLASS="corpauthor"
>&#13;	    <A
HREF="http://www.claws-mail.org/"
TARGET="_top"
>The Claws Mail Team</A
>
    </H3
><P
CLASS="copyright"
>Copyright &copy; 2006-2011 The Claws Mail Team.</P
><HR></DIV
><DIV
CLASS="TOC"
><DL
><DT
><B
>Table of Contents</B
></DT
><DT
>1. <A
HREF="#ch_intro"
>Introduction</A
></DT
><DD
><DL
><DT
>1.1. <A
HREF="#intro_what"
>What is Claws Mail?</A
></DT
><DT
>1.2. <A
HREF="#intro_whatnot"
>What Claws Mail is not</A
></DT
><DT
>1.3. <A
HREF="#intro_features"
>Main features</A
></DT
><DT
>1.4. <A
HREF="#intro_history"
>History of Claws Mail</A
></DT
><DT
>1.5. <A
HREF="#intro_information"
>Useful URLs</A
></DT
></DL
></DD
><DT
>2. <A
HREF="#ch_starting"
>Getting started with Claws Mail</A
></DT
><DD
><DL
><DT
>2.1. <A
HREF="#start_wizard"
>The initial wizard</A
></DT
><DT
>2.2. <A
HREF="#start_getting"
>Getting mail</A
></DT
><DT
>2.3. <A
HREF="#start_reading"
>Reading your mail</A
></DT
><DT
>2.4. <A
HREF="#start_writing"
>Writing your first mail</A
></DT
><DT
>2.5. <A
HREF="#start_sending"
>Sending your first mail</A
></DT
></DL
></DD
><DT
>3. <A
HREF="#ch_handling"
>Basic mail handling</A
></DT
><DD
><DL
><DT
>3.1. <A
HREF="#handling_folders"
>Mail folders</A
></DT
><DT
>3.2. <A
HREF="#handling_organisation"
>Folder organisation</A
></DT
><DT
>3.3. <A
HREF="#imap_subscriptions"
>IMAP subscriptions</A
></DT
><DT
>3.4. <A
HREF="#handling_filters"
>Filtering</A
></DT
><DT
>3.5. <A
HREF="#handling_searching"
>Searching</A
></DT
></DL
></DD
><DT
>4. <A
HREF="#ch_account"
>Account customisation</A
></DT
><DD
><DL
><DT
>4.1. <A
HREF="#account_basic"
>Basic preferences</A
></DT
><DT
>4.2. <A
HREF="#account_types"
>Account types</A
></DT
><DD
><DL
><DT
>4.2.1. <A
HREF="#pop3"
>POP3</A
></DT
><DT
>4.2.2. <A
HREF="#imap"
>IMAP</A
></DT
><DT
>4.2.3. <A
HREF="#news"
>News</A
></DT
><DT
>4.2.4. <A
HREF="#local"
>Local</A
></DT
><DT
>4.2.5. <A
HREF="#smtp_only"
>SMTP only</A
></DT
></DL
></DD
><DT
>4.3. <A
HREF="#account_multiple"
>Multiple accounts</A
></DT
><DT
>4.4. <A
HREF="#account_morefilt"
>More filtering</A
></DT
></DL
></DD
><DT
>5. <A
HREF="#ch_addrbook"
>Address book</A
></DT
><DD
><DL
><DT
>5.1. <A
HREF="#addrbk_basic"
>Basic management</A
></DT
><DT
>5.2. <A
HREF="#addrbk_expimp"
>Exporting and importing addresses</A
></DT
><DT
>5.3. <A
HREF="#addrbk_filtering"
>Filtering messages using the address book</A
></DT
><DT
>5.4. <A
HREF="#addrbk_advanced"
>Advanced features</A
></DT
><DD
><DL
><DT
>5.4.1. <A
HREF="#addrbk_adv_ldap"
>Using LDAP servers</A
></DT
><DT
>5.4.2. <A
HREF="#addrbk_adv_jpilot"
>Integration with jPilot</A
></DT
><DT
>5.4.3. <A
HREF="#addrbk_adv_vcard"
>vCard support</A
></DT
></DL
></DD
></DL
></DD
><DT
>6. <A
HREF="#ch_advanced"
>Advanced features</A
></DT
><DD
><DL
><DT
>6.1. <A
HREF="#adv_actions"
>Actions</A
></DT
><DT
>6.2. <A
HREF="#adv_templates"
>Templates</A
></DT
><DT
>6.3. <A
HREF="#adv_processing"
>Processing</A
></DT
><DT
>6.4. <A
HREF="#adv_colour_labels"
>Colour Labels</A
></DT
><DT
>6.5. <A
HREF="#adv_tags"
>Tags</A
></DT
><DT
>6.6. <A
HREF="#adv_ml_support"
>Mailing-List support</A
></DT
><DT
>6.7. <A
HREF="#adv_plugins"
>Plugins</A
></DT
><DT
>6.8. <A
HREF="#deploying"
>Deploying Claws Mail</A
></DT
><DT
>6.9. <A
HREF="#adv_hidden"
>Hidden preferences</A
></DT
><DT
>6.10. <A
HREF="#adv_autofaces"
>Autofaces</A
></DT
></DL
></DD
><DT
>7. <A
HREF="#ch_plugins"
>Extending Claws Mail</A
></DT
><DD
><DL
><DT
>7.1. <A
HREF="#plugins_default"
>Provided plugins</A
></DT
><DT
>7.2. <A
HREF="#plugins_external"
>More plugins</A
></DT
><DT
>7.3. <A
HREF="#plugins_network"
>Network access from the plugins</A
></DT
></DL
></DD
><DT
>A. <A
HREF="#ap_faq"
>The Claws Mail FAQ</A
></DT
><DD
><DL
><DT
>A.1. <A
HREF="#AEN989"
>What are the differences between Claws Mail and Sylpheed?</A
></DT
><DT
>A.2. <A
HREF="#AEN993"
>Does Claws Mail allow me to write HTML styled messages?</A
></DT
><DT
>A.3. <A
HREF="#AEN996"
>How can I submit patches, report bugs, and talk about Claws Mail
	with others?</A
></DT
><DT
>A.4. <A
HREF="#AEN1005"
>Does Claws Mail have an anti-spam feature?</A
></DT
><DT
>A.5. <A
HREF="#AEN1013"
>Does Claws Mail support Return Receipts?</A
></DT
><DT
>A.6. <A
HREF="#AEN1021"
>How can I make Claws Mail notify me when new mail
    arrives?</A
></DT
><DT
>A.7. <A
HREF="#AEN1028"
>Why are special characters (e.g. umlauts) not displayed
    correctly?</A
></DT
><DT
>A.8. <A
HREF="#AEN1032"
>Can I quote just a section of the original message when
    replying?</A
></DT
><DT
>A.9. <A
HREF="#AEN1036"
>Where can I find the answers to more FAQs about
    Claws Mail?</A
></DT
></DL
></DD
><DT
>B. <A
HREF="#ap_keyboard"
>Default keyboard shortcuts</A
></DT
><DD
><DL
><DT
>B.1. <A
HREF="#keyb_general"
>Motivations and general conventions</A
></DT
><DT
>B.2. <A
HREF="#keyb_mail"
>Main window</A
></DT
><DT
>B.3. <A
HREF="#keyb_compose"
>Compose window</A
></DT
></DL
></DD
><DT
>C. <A
HREF="#ap_ack"
>Acknowledgements</A
></DT
><DT
>D. <A
HREF="#ap_glossary"
>Glossary</A
></DT
><DT
>E. <A
HREF="#ap_gpl"
>Gnu General Public License</A
></DT
></DL
></DIV
><FONT
COLOR="RED"
></FONT
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_intro"
>1. Introduction</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="intro_what"
>1.1. What is Claws Mail?</A
></H3
><P
>&#13;	Claws Mail is an email client aiming at being fast, easy-to-use and powerful. It is mostly desktop-independent, but tries to integrate with your desktop as best as possible. The Claws Mail developers try hard to keep it lightweight, so that it should be usable on low-end computers without much memory or CPU power.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="intro_whatnot"
>1.2. What Claws Mail is not</A
></H3
><P
>&#13;	Claws Mail is not a full-featured Personal Information Manager like Evolution or Outlook, although external plugins provide these functionalities. Claws Mail will not let you write and send HTML emails or other kind of annoyances, hence it may not be the software you need in some business environments. 
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="intro_features"
>1.3. Main features</A
></H3
><P
>&#13;	    Claws Mail sports almost everything a perfect email client needs. Mail retrieval over POP3, IMAP4, local mbox, over SSL; support for various authentication schemes. It has multiple accounts and mailboxes, powerful filtering and search functionality, import/export capabilities using a number of formats, support for GnuPG (digital signatures and encryption). It supports plugins, customisable toolbars, spell checking, a number of guards to prevent any data loss, per-folder preferences, and much more. A list of features can be found at <A
HREF="http://www.claws-mail.org/features.php"
TARGET="_top"
>www.claws-mail.org/features.php</A
>.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="intro_history"
>1.4. History of Claws Mail</A
></H3
><P
>&#13;	Claws Mail has existed since April 2001. It was initially named Sylpheed-Claws and changed its name to Claws Mail in November 2006. The primary goal of Sylpheed-Claws was to be a test-bed for potential features of Sylpheed (<A
HREF="http://sylpheed.sraoss.jp/en/"
TARGET="_top"
>sylpheed.sraoss.jp/en/</A
>), so that new features could be tested thoroughly without compromising Sylpheed's stability. Sylpheed-Claws developers regularly synchronised their codebase with Sylpheed's codebase, and Sylpheed's author, Hiroyuki Yamamoto, took back the new features he liked once they were stabilised.
    </P
><P
>&#13;	Originally both Sylpheed and Claws Mail were based on GTK1. The work on the GTK2 versions started in early 2003, and the first modern (GTK2-based) Sylpheed-Claws was released in March 2005. Since about this time, Sylpheed and Sylpheed-Claws' goals started to diverge more, and Sylpheed-Claws became an entity of its own. This is why its name is now Claws Mail.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="intro_information"
>1.5. Useful URLs</A
></H3
><P
>&#13;	    Website: <A
HREF="http://www.claws-mail.org"
TARGET="_top"
>www.claws-mail.org</A
>
    </P
><P
>&#13;	    Latest News: <A
HREF="http://www.claws-mail.org/news.php"
TARGET="_top"
>www.claws-mail.org/news.php</A
>
    </P
><P
>&#13;	    Extra Plugins: <A
HREF="http://www.claws-mail.org/plugins.php"
TARGET="_top"
>www.claws-mail.org/plugins.php</A
>
    </P
><P
>&#13;	    Icon Themes: <A
HREF="http://www.claws-mail.org/themes.php"
TARGET="_top"
>www.claws-mail.org/themes.php</A
>
    </P
><P
>&#13;	    Tools: <A
HREF="http://www.claws-mail.org/tools.php"
TARGET="_top"
>www.claws-mail.org/tools.php</A
>
    </P
><P
>&#13;	    Mailing Lists: <A
HREF="http://www.claws-mail.org/MLs.php"
TARGET="_top"
>www.claws-mail.org/MLs.php</A
>
    </P
><P
>&#13;	Bugtracker: <A
HREF="http://www.thewildbeast.co.uk/claws-mail/bugzilla/"
TARGET="_top"
>www.thewildbeast.co.uk/claws-mail/bugzilla/</A
>
    </P
><P
>&#13;	Source code: <A
HREF="http://sourceforge.net/projects/sylpheed-claws/files/"
TARGET="_top"
>sourceforge.net/projects/sylpheed-claws/files/</A
>
    </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_starting"
>2. Getting started with Claws Mail</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="start_wizard"
>2.1. The initial wizard</A
></H3
><P
>&#13;	The first time that you start Claws Mail, you will be asked a few 
	questions in order to set up an account. These questions are easy to 
	answer and grouped in several short pages.
    </P
><P
>&#13;	First you will be asked to fill in your name, (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>usually 
	guessed from the operating system</I
></SPAN
>), your email address, and 
	the name of your organisation, (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>optional</I
></SPAN
>).
    </P
><P
>&#13;	The following page will allow you to enter details of how to retrieve 
	your mail. The format of the page will be determined by the 
	<SPAN
CLASS="QUOTE"
>"Server type"</SPAN
>:
    </P
><A
NAME="AEN61"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>POP3</DT
><DD
><P
>&#13;	If you choose POP3, you will need to enter the server address, 
	username, and password. The password is optional, if you don't provide 
	it here then you will be prompted for it each time it is needed.
	    </P
></DD
><DT
>IMAP</DT
><DD
><P
>&#13;	If you choose IMAP, you will need to enter the server address, 
	username, password, and IMAP server directory. The password is 
	optional, if you don't provide it here then you will be prompted for it
	each time it is needed. The IMAP server directory is also optional, 
	often it is not needed and can be left empty.
	    </P
></DD
><DT
>Local mbox file</DT
><DD
><P
>&#13;	If you choose Local mbox file, you will need to enter the location of 
	your local mailbox spool file. This location depends on your Operating
	System, but values like <TT
CLASS="filename"
>/var/mail/username</TT
> or
	<TT
CLASS="filename"
>/var/spool/mail/username</TT
> are common, where 
	<TT
CLASS="literal"
>username</TT
> is your system login.
	    </P
></DD
></DL
></DIV
></BLOCKQUOTE
><P
>&#13;	On the next page you will enter the address of your SMTP server, 
	(<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>sometimes referred to as 
	<SPAN
CLASS="QUOTE"
>"Outgoing server"</SPAN
></I
></SPAN
>). You will also be asked 
	whether to authenticate when sending mail; this is often not the case 
	if you're using an ISP to connect to Internet, and often the case if 
	you are configuring a professional account.
    </P
><P
>&#13;	If you chose either POP3 or Local mbox file, the next page  will ask 
	you where you want to save your mail on disk. The default, 
	<SPAN
CLASS="QUOTE"
>"Mail"</SPAN
>, is usually ok and will save your mails in a 
	directory called <TT
CLASS="filename"
>Mail</TT
> in your home directory.
    </P
><P
>&#13;	If Claws Mail is built with support for OpenSSL, you will next see 
	the <SPAN
CLASS="QUOTE"
>"Security"</SPAN
> page, here you will be able to choose to 
	use SSL encryption to send and receive your emails. Most ISPs do not 
	enable this, but many companies do; if you're unsure about it, you can 
	leave them unselected.
    </P
><P
>&#13;	You can now click on the Save button, and start enjoying Claws Mail.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="start_getting"
>2.2. Getting mail</A
></H3
><P
>&#13;	Retrieving your email can be done from the toolbar button named 
	<SPAN
CLASS="QUOTE"
>"Get mail"</SPAN
> or from the <SPAN
CLASS="QUOTE"
>"Receive"</SPAN
> submenu of 
	the <SPAN
CLASS="QUOTE"
>"Message"</SPAN
> menu.
    </P
><P
>&#13;	If you want Claws Mail to check your mail automatically at regular 
	intervals, you can ask it to do so from the 
	<SPAN
CLASS="QUOTE"
>"Mail handling: Receiving"</SPAN
> preference page which you'll 
	find in the <SPAN
CLASS="QUOTE"
>"Configuration/Preferences..."</SPAN
> menu. Just 
	click the 
	<SPAN
CLASS="QUOTE"
>"Automatically check new mail every [...] minute(s)"</SPAN
> 
	checkbox, and set the interval to your liking.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="start_reading"
>2.3. Reading your mail</A
></H3
><P
>&#13;	Once you have retrieved your emails, the Inbox folder will contain 
	them. The total number of emails in a folder is shown at the right of 
	the folder's name, along with the number of unread and new emails in 
	it. To see them, click on the folder row in the folder list, and the 
	list of emails in that folder will be displayed in the Message List 
	pane. You can then select an email using the mouse, or by using the Up 
	and Down keys to navigate through the list, and the Space bar to 
	display and scroll emails. You can use other keys to navigate through 
	emails, like P and N (previous and next).
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="start_writing"
>2.4. Writing your first mail</A
></H3
><P
>&#13;	When clicking on the <SPAN
CLASS="QUOTE"
>"Compose"</SPAN
> button of the toolbar, a 
	composition window will open. This window contains different fields 
	which you should be able to recognise easily: if you have multiple 
	accounts, the From field can be used to select which account you want 
	to use for this email; the To field is for recipient of the email. When
	you fill it in, a second To field will appear, so that you can send the
	email to multiple recipients. You can also change the To field to a Cc 
	field or other types of fields, by using its dropdown menu, or by 
	typing in the field that you require. After that, you will be able to 
	set the subject of your email, then type its body.
    </P
><P
>&#13;	A little note about an email's subject: Claws Mail will ask you for
	confirmation if you attempt to send an email with an empty subject. 
	This is because it can be annoying for the recipient to receive emails 
	without a subject, as it doesn't help in handling email.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="start_sending"
>2.5. Sending your first mail</A
></H3
><P
>&#13;	When you have finished writing your first email, you can either click 
	the <SPAN
CLASS="QUOTE"
>"Send"</SPAN
> button to send your email immediately, or use 
	the <SPAN
CLASS="QUOTE"
>"Send later"</SPAN
> button to queue the message for later 
	sending. When using <SPAN
CLASS="QUOTE"
>"Send"</SPAN
>, the composition window will 
	close itself when the mail has been sent; it will stay open if there is
	an error. When using <SPAN
CLASS="QUOTE"
>"Send later"</SPAN
>, the composition window 
	will immediately close, and your email will be stored in your Queue 
	folder. It will then be sent when you click the <SPAN
CLASS="QUOTE"
>"Send"</SPAN
> 
	button in the main window's toolbar.
    </P
><P
>&#13;	The emails that you send are saved in the Sent folder of your mailbox, 
	so that you can recall what you wrote to whom, or use an already sent 
	email as a template to write another.
    </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_handling"
>3. Basic mail handling</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="handling_folders"
>3.1. Mail folders</A
></H3
><P
>&#13;	If you receive a lot of emails, you will probably soon find that your
	Inbox folder is growing to the point where you have a hard time finding
	an email again, even if you received it just a few days ago. This is why
	Claws Mail, like most good mail clients, provides you with multiple
	possibilities in organising your mails.
    </P
><P
>&#13;	You can create as many folders and subfolders as you need. For example,
	one folder for your family, one folder for friends, folders for
	mailing-lists, archive folders for old mails that you still want to have
	available, etc. To create a new folder, simply right-click on its parent
	folder and choose <SPAN
CLASS="QUOTE"
>"New folder..."</SPAN
> from the drop-down menu.
	If you want to create a folder <SPAN
CLASS="QUOTE"
>"Friends"</SPAN
> inside your Inbox
	folder, for example, just right-click on the Inbox folder, choose
	<SPAN
CLASS="QUOTE"
>"New folder..."</SPAN
>, and type in <SPAN
CLASS="QUOTE"
>"Friends"</SPAN
> in the
	dialogue that appears. Click the OK button, and the new folder is
	created.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="handling_organisation"
>3.2. Folder organisation</A
></H3
><P
>&#13;	Now that you have created folders, you can manipulate them and their
	contents using menu items or drag 'n' drop. Moving one folder into
	another, for example, can be done by right-clicking on the folder you
	want to move, choosing the <SPAN
CLASS="QUOTE"
>"Move folder..."</SPAN
> menu item, and
	selecting the destination folder. This will move the folder, with the
	mail it contains, to a subfolder of the chosen folder. Alternatively,
	you can drag a folder to another one by clicking on it, keeping the
	mouse pressed, moving the mouse cursor over the destination folder and
	releasing the button.
    </P
><P
>&#13;	If you want to remove a folder and the mail it contains, simply
	right-click on the folder and choose <SPAN
CLASS="QUOTE"
>"Delete folder..."</SPAN
>. As
	this is potentially harmful, (the mails in the folder will be deleted
	and not recoverable), you will be asked for confirmation.
    </P
><P
>&#13;	In the same manner that you move a folder to another one, you can move
	emails from one folder to another. The same method applies for this:
	either drag 'n' drop emails to a folder, or choose
	<SPAN
CLASS="QUOTE"
>"Move..."</SPAN
> after right-clicking on the mail. You can select
	multiple emails by using the Control or Shift key while clicking on
	them. You can also copy emails to another folder by pressing the Control
	key when drag'n'dropping, or by choosing <SPAN
CLASS="QUOTE"
>"Copy..."</SPAN
> from the
	email's contextual menu.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="imap_subscriptions"
>3.3. IMAP subscriptions</A
></H3
><P
>&#13;	The IMAP protocol allows one to store a list of subscribed folders. Most
	mail user agents hide the unsubscribed folders away from the GUI, and have
	a little window allowing to subscribe to these unsubscribed folders. In
	Claws Mail, subscriptions are respected by default, and only subscribed
	folders will be displayed. If you want to see all your folders, you can just
	uncheck <SPAN
CLASS="QUOTE"
>"Show subscribed folders only"</SPAN
> in the IMAP mailbox'
	contextual menu or the account preferences. You'll be able to subscribe and 
	unsubscribe folders from this contextual menu too. If the unsubscribed 
	folders are hidden from the list, you will have two ways to subscribe to 
	a folder: either show all folders, subscribe the ones you want, and hide 
	unsubscribed folders again; or, if you know the folder's name, use 
	<SPAN
CLASS="QUOTE"
>"Create new folder"</SPAN
> in its parent's contextual menu.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="handling_filters"
>3.4. Filtering</A
></H3
><P
>&#13;	Once you have a nice folder hierarchy in place, you'll probably want
	Claws Mail to sort your incoming emails automatically, in order to
	avoid having to move messages manually each time they arrive. For this
	you can use the Filtering feature.
    </P
><P
>&#13;	You will find the filtering preferences via the
	<SPAN
CLASS="QUOTE"
>"Configuration"</SPAN
> menu, <SPAN
CLASS="QUOTE"
>"Filtering"</SPAN
> item. From
	this dialogue you will be able to define new rules, modify or delete
	existing rules, re-order the rules, and enable/disable them. Filtering
	rules are defined by five things: the enabled status, a name, an account
	name, a	condition, and an action. All disabled rules are simply ignored.
	The <SPAN
CLASS="QUOTE"
>"Name"</SPAN
> entry is optional, it's there to help you
	identify your rules. An account name can be chosen, which will restrict
	the rule to mail retrieved from the named account only, skipping it for
	mail retrieved from all other accounts. The default value is
	<SPAN
CLASS="QUOTE"
>"All"</SPAN
>, which means that the rule is global and will
	be applied  to all mail, regardless of the account from which it was
	retrieved, (see paragraph below). The condition format is an expression
	defining what Claws Mail should look for when filtering mail, for
	example: <SPAN
CLASS="QUOTE"
>"to matchcase claws-mail-users"</SPAN
> is for messages
	sent to any address containing <SPAN
CLASS="QUOTE"
>"claws-mail-users"</SPAN
>. You can
	easily define conditions by clicking the <SPAN
CLASS="QUOTE"
>"Define..."</SPAN
> button
	at the right of the field. The last part of a filtering rule is the
	action, which instructs Claws Mail what to do with mail matching
	the condition we just defined. For example, <SPAN
CLASS="QUOTE"
>"mark_as_read"</SPAN
>
	marks the mail as read as soon as it arrives in your inbox, or
	<SPAN
CLASS="QUOTE"
>"move #mh/Mailbox/inbox/Friends"</SPAN
> moves the mail to your
	<SPAN
CLASS="QUOTE"
>"Friends"</SPAN
> subfolder. Here, too, a <SPAN
CLASS="QUOTE"
>"Define..."</SPAN
>
	button is available to help you define the action to take.
    </P
><P
>&#13;	Filtering rules can be assigned to a single, specific account. To do
	this select an account from the <SPAN
CLASS="QUOTE"
>"Account"</SPAN
> combo below the 
	<SPAN
CLASS="QUOTE"
>"Name"</SPAN
> entry. When you set a specific account the filtering
	rule will only be applied to messages retrieved from the named account.
	The default value is <SPAN
CLASS="QUOTE"
>"All"</SPAN
>, which means that the rule will
	be applied globally, to messages retrieved from any account. When filtering
	messages manually, if there are any per-account filtering rules defined,
	you will be asked what you wish to do with those rules. Possible choices
	are to skip the rules, or apply these rules regardless of the account to
	which they belong, or use the rules for the currently selected account.
	Caution: if you unset the <SPAN
CLASS="QUOTE"
>"Show this message next time"</SPAN
>
	checkbox and click <SPAN
CLASS="QUOTE"
>"Filter"</SPAN
>, on subsequent manual filtering
	this choice will be applied without any confirmation. Account specific
	rules are only available for filtering, (at incorporation or manually),
	the feature is not available for folder Processing or Pre/Post-Processing. 
	</P
><P
>&#13;	Once you have defined the rule, you can add it to the list of rules with
	the <SPAN
CLASS="QUOTE"
>"Add"</SPAN
> button. Don't forget that the order of the rules
	is important: if Claws Mail finds a rule suitable for an email that
	either moves or deletes the email, it will stop looking for further
	rules for that email. This is why, at the right of the rules list, you
	will find four buttons allowing the re-ordering of rules. The rules can
	also be reordered by drag 'n' drop.
    </P
><P
>&#13;	There is also a quick method of creating filtering rules based on the
	selected message. After selecting a mail of the type you want to filter,
	choose <SPAN
CLASS="QUOTE"
>"Create filter rule..."</SPAN
> from the
	<SPAN
CLASS="QUOTE"
>"Tools"</SPAN
> menu, and choose a type from the submenu:
	<SPAN
CLASS="QUOTE"
>"Automatically"</SPAN
> mainly helps for mailing-lists posts,
	<SPAN
CLASS="QUOTE"
>"by From"</SPAN
> creates a filter based on the sender of the
	email, <SPAN
CLASS="QUOTE"
>"by To"</SPAN
> creates a filter based on the recipient, and
	<SPAN
CLASS="QUOTE"
>"by Subject"</SPAN
> creates a filter based on the subject. Each
	one of these types of filtering has its advantages, it's up to you to
	find out what would be the more practical. Usually,
	<SPAN
CLASS="QUOTE"
>"by From"</SPAN
> is nice to sort out your regular contacts' mails,
	whereas <SPAN
CLASS="QUOTE"
>"by To"</SPAN
> is more useful to sort mails sent to your
	different accounts.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="handling_searching"
>3.5. Searching</A
></H3
><P
>&#13;	There are several methods for searching your emails.
    </P
><P
>&#13;	One of them is relatively standard, and can be found in the
	<SPAN
CLASS="QUOTE"
>"Edit"</SPAN
> menu, it's the <SPAN
CLASS="QUOTE"
>"Search folder..."</SPAN
> item.
	This will open a window where you can specify one or more fields to
	search in: From, To, Subject, and Body. After having specified your
	criteria, click on the <SPAN
CLASS="QUOTE"
>"Back"</SPAN
> or <SPAN
CLASS="QUOTE"
>"Forward"</SPAN
>
	buttons to navigate through the matching emails, or use
	<SPAN
CLASS="QUOTE"
>"Find all"</SPAN
> to select all the matching emails at once. Be
	aware that searching for text in the body of emails is much slower than
	searching in its headers, because the body of emails isn't cached by
	Claws Mail. <SPAN
CLASS="QUOTE"
>"Extended Search"</SPAN
> mode can be turned on by
	clicking the relevant checkbox, thus allowing you to use match expressions
	like those used in <SPAN
CLASS="QUOTE"
>"Filtering"</SPAN
> rules.
    </P
><P
>&#13;	If you're looking at a large email and want to find a particular part
	of it, you can use the <SPAN
CLASS="QUOTE"
>"Find in current message..."</SPAN
> item of
	the <SPAN
CLASS="QUOTE"
>"Edit"</SPAN
> menu. This works like search in a text document.
    </P
><P
>&#13;	The final way of searching for emails is using <SPAN
CLASS="QUOTE"
>"Quick Search"</SPAN
>,
	which you can display or hide by cilicking the little magnifying glass icon
	under the Message List. It is also accessible from the <SPAN
CLASS="QUOTE"
>"Quick Search"</SPAN
>
	item of the <SPAN
CLASS="QUOTE"
>"Edit"</SPAN
> menu. <SPAN
CLASS="QUOTE"
>"Quick Search"</SPAN
> is more
	powerful than the normal search as it can search in standard headers (From,
	To, Subject) or in <SPAN
CLASS="QUOTE"
>"Extended"</SPAN
> mode using just about any
	criteria you can think of. When in <SPAN
CLASS="QUOTE"
>"Extended"</SPAN
> mode, the
	<SPAN
CLASS="QUOTE"
>"Information"</SPAN
> button is visible, enabling you to see the
	search syntax. An <SPAN
CLASS="QUOTE"
>"Edit"</SPAN
> button is also available which
	allows you to quickly create a rule. You can also configure
	<SPAN
CLASS="QUOTE"
>"Quick Search"</SPAN
> to search recursively through subfolders,
	whether it should reset itself when you change folders, and whether to
	use Type-ahead search (this is a search which results update dynamically
	if you pause in the typing).
    </P
><P
>&#13;	When you hit Enter after having specified the search string, the Message
	List will shrink to present you with only the matching messages. If you
	set the search to be recursive, any subfolder of the current one that
	has matching emails will change its icon to a magnifying glass icon.
	This way, you can search in your whole mailbox at once. If the search is
	in Sticky mode, the filter will stay applied when you go to another
	folder. This can be disturbing at first, as you can forget about it, but
	is useful in some cases, for example if you want to search in the body
	of emails and are not sure of which folder contains the searched email:
	a recursive search on the body of emails in a whole mailbox can be
	really slow.
    </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_account"
>4. Account customisation</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="account_basic"
>4.1. Basic preferences</A
></H3
><P
>&#13;	The first tab of the account preferences, <SPAN
CLASS="QUOTE"
>"Basic"</SPAN
>,
	contains, as its name indicates, basic account data. In this tab you can
	specify your name, email address, organization and basic connection
	information.  The name of the account is just the name Claws Mail
	will use when referring to this account, for example, in the account
	switcher at the lower right-hand corner of the main window.  The server
	information lets you specify the receiving protocol to use (which is
	not modifiable for existing accounts), the server(s) used to receive or
	send your emails (usually <TT
CLASS="literal"
>pop.isp.com</TT
> and <TT
CLASS="literal"
>smtp.isp.com</TT
>) and your login on the receiving server.  
    </P
><P
>&#13;	In the <SPAN
CLASS="QUOTE"
>"Receive"</SPAN
> tab you are able to change the default
	behaviour of Claws Mail. For example, leaving messages on the server
	for a while, preventing downloading of mails that are too large, or
	specifying whether you want the filtering rules to apply to this
	account's mails. The <SPAN
CLASS="QUOTE"
>"Receive size limit"</SPAN
> is used to limit
	the time spent downloading large emails. Whenever you receive a mail
	larger than this limit, it will be partially downloaded and you will
	later have the choice to either download it entirely or delete it from
	the server. This choice will be presented to you while viewing the
	email.
    </P
><P
>&#13;	The <SPAN
CLASS="QUOTE"
>"Send"</SPAN
> tab contains preferences for special headers
	that you might want to add to your outgoing emails, like X-Face or Face
	headers, and authentication information for sending emails. Most of the
	time, your ISP allows its subscribers to send email via the SMTP server
	without authenticating, but in some setups, you have to identify
	yourself before sending. There are different possibilities for doing
	that. The best one, when available, is SMTP AUTH. When not available,
	you'll usually use POP-before-SMTP, which connects to the POP server,
	(which is authenticated), disconnects, and sends the mail.
    </P
><P
>&#13;	The <SPAN
CLASS="QUOTE"
>"Compose"</SPAN
> tab holds options for changing the behaviour
	of the Composition window when used with the account. You can specify a
	signature to insert automatically, and set default Cc, Bcc or Reply-To
	addresses.
    </P
><P
>&#13;	In the <SPAN
CLASS="QUOTE"
>"Privacy"</SPAN
> tab you can choose the default level of
	paranoia for your account. You might want all outgoing emails to be
	digitally signed and/or encrypted. Signing all outgoing emails, not only
	important ones, will for example allow you to protect yourself from
	faked mails sent on your behalf to coworkers. This can help solve
	embarrassing situations.
    </P
><P
>&#13;	The <SPAN
CLASS="QUOTE"
>"SSL"</SPAN
> tab is also security related, although this time
	its settings apply to the transport of your emails and not their
	content. Basically, using SSL encrypts the connection between you and
	the server, which prevents people from snooping on your connection and
	being able to read your mails and your password. SSL should be used if
	it is available.
    </P
><P
>&#13;	Finally, the <SPAN
CLASS="QUOTE"
>"Advanced"</SPAN
> tab allows you to specify ports and
	domains if the defaults are not used. Normally you can leave these
	empty. You can also specify folders for sent, queued, draft, and deleted
	messages here.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="account_types"
>4.2. Account types</A
></H3
><P
>&#13;	We saw earlier that once an account is created, you can't change its
	type (protocol) anymore. This is because preferences for these different
	types are not quite the same, most of the POP3 related options are
	irrelevant for IMAP, for example.
    </P
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="pop3"
>4.2.1. POP3</A
></H4
><P
>&#13;	POP3 is one of the two most used protocols and is available at almost
	every ISP on Earth. Its advantage is that it allows you to download
	email to your computer, which means that accessing your mail will be
	really fast once you have it on your hard disk. The disadvantage of POP3
	is that it is more difficult to keep your mail synchronised on multiple
	computers, (you'll have to keep the mail on the server for a few days),
	and you won't be able to easily keep track of which mails you have read,
	or which mails you have replied to, etc., when using another computer.
    </P
><P
>&#13;     Mail received from a POP3 account will be stored in an MH mailbox in the
     folder tree.
    </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="imap"
>4.2.2. IMAP</A
></H4
><P
>&#13;	IMAP is the second most used protocol and its goal is to address the
	shortcomings of POP3. When using IMAP your folder list and your emails
	are all kept on a central server. This slows down navigation a little as
	each mail is downloaded on demand, but when you use another computer, or
	email client, your emails will be in the same state that you left them,
	including their status (read, unread, replied, etc.).
    </P
><P
>&#13;	When you create an IMAP account an IMAP mailbox is created for it in the
	folder tree.
    </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="news"
>4.2.3. News</A
></H4
><P
>&#13;	News (NNTP) is the protocol for sending and receiving USENET articles.
	Messages are held on a central server and downloaded on demand. They
	cannot be deleted by the user.
    </P
><P
>&#13;	When you create a News account a News mailbox is created for it in the
	folder tree.
    </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="local"
>4.2.4. Local</A
></H4
><P
>&#13;	The <SPAN
CLASS="QUOTE"
>"Local mbox file"</SPAN
> type of account can be used if you
	run an SMTP server on your computer and/or want to receive your logs
	easily.
    </P
><P
>&#13;	Mail received from a Local account is stored in an MH mailbox in the
	folder tree.
    </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="smtp_only"
>4.2.5. SMTP only</A
></H4
><P
>&#13;	The account type <SPAN
CLASS="QUOTE"
>"None, (SMTP only)"</SPAN
> is a special type of
	account that won't retrieve any mail, but will allow you to create
	different identities that can be used to send out emails with various
	aliases, for example.
    </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="account_multiple"
>4.3. Multiple accounts</A
></H3
><P
>&#13;	You can easily create multiple accounts in Claws Mail. For POP
	accounts, you can choose to store all email from your different accounts
	in the same folder(s), using the Receive tab preference.  IMAP and News
	accounts each get their own mailbox in the folder tree.
    </P
><P
>&#13;	You can choose which accounts get checked for new mail when using the
	<SPAN
CLASS="QUOTE"
>"Get All"</SPAN
> command (or "Get Mail" in the toolbar) by
	checking the relevant box in the Receive tab of their preferences or
	in the <SPAN
CLASS="QUOTE"
>"G"</SPAN
> column of your accounts list.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="account_morefilt"
>4.4. More filtering</A
></H3
><P
>&#13;	By default filtering rules are global, but they can also be assigned to
	a specific account. When fetching mail, any rules that are assigned to
	a specific account will only be applied to mails that are retrieved from
	that account.   
    </P
><P
>&#13;	Mail from any account can be filtered into another account's folders,
	for example, a mail received by POP3 could be filtered into an IMAP
	account's folder, and vice-versa. This is either a useful feature or an
	annoying one, depending on what you want to achieve. If you'd rather
	avoid that, but still want to automatically sort your incoming mail, the
	best thing to do is to disable Filtering on certain accounts, and use
	Processing rules in the Inbox folders that you specified, as Processing
	rules are automatically applied when entering a folder and can be
	manually applied from a folder's context menu.
    </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_addrbook"
>5. Address book</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="addrbk_basic"
>5.1. Basic management</A
></H3
><P
>&#13;	The address book is accessible via the <SPAN
CLASS="QUOTE"
>"Tools/Address book"</SPAN
> menu. It is arranged in different sections: the <SPAN
CLASS="QUOTE"
>"Address Book"</SPAN
> and its subsections, which contain the contacts that you added locally; the vCard sections, which contain imported vCards; and, if support for them was built into Claws Mail, the LDAP and jPilot sections, containing contacts from your LDAP servers or handheld devices.
    </P
><P
>&#13;	In the <SPAN
CLASS="QUOTE"
>"Address Book"</SPAN
> section, you can create multiple address books; each one is able to contain addresses and/or folders. This can help you in organising your contacts by category. In addition to this, you can create groups of addresses, which can be used from the composition window to send mails to multiple people at once.
	The menus in the address book window allow you to do all of this. For example, you can create a <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Family</I
></SPAN
> folder inside your <SPAN
CLASS="QUOTE"
>"Personal Addresses"</SPAN
> address book, using the <SPAN
CLASS="QUOTE"
>"Book/New folder"</SPAN
> menu when <SPAN
CLASS="QUOTE"
>"Personal Addresses"</SPAN
> is selected, or by right-clicking on it. In the same way, you can add contacts to an address book or folder by using the <SPAN
CLASS="QUOTE"
>"Address"</SPAN
> menu, or by right-clicking an item in the list in the right-hand part of the window.
	When adding a contact, a new window will appear, where you'll be able to specify the details of the contact in the first tab (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Display Name, First Name, ...</I
></SPAN
>), and a list of email addresses in the second tab.
    </P
><P
>&#13;	A simpler way to save your contacts to your address book is to save them when reading one of their emails, using the <SPAN
CLASS="QUOTE"
>"Tools/Add sender to address book"</SPAN
> menu, or by right-clicking on an email address in the message view.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="addrbk_expimp"
>5.2. Exporting and importing addresses</A
></H3
><P
>&#13;	Claws Mail can import address books easily from the majority of email programs. From the <SPAN
CLASS="QUOTE"
>"Tools"</SPAN
> menu in the address book, you will be able to import Pine or Mutt address books. As these formats are not so widespread, you can also import LDIF files. LDIF is a widely-used format, so most other email programs can export their address book to this format.
	Importing an LDIF file is done via <SPAN
CLASS="QUOTE"
>"Tools/Import LDIF file"</SPAN
> and is a three-step operation: select the file to import and an address book name, check the fields you want to import if the defaults do not please you, then use the <SPAN
CLASS="QUOTE"
>"Save"</SPAN
> button.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="addrbk_filtering"
>5.3. Filtering messages using the address book</A
></H3
><P
>&#13;	It is possible to filter messages by matching addresses found in
	headers against the address book, use for this the match type
	<SPAN
CLASS="QUOTE"
>"Found in addressbook"</SPAN
> when defining the condition
	expression of a filtering rule. You have to select the address header
	to match against a part of the address book. The address header can be
	To, From, Cc, Reply-to and Sender (if at least one address in that
	header matches, the rule will be applied). Some special items allow to match
	at least one address found in <SPAN
CLASS="QUOTE"
>"Any"</SPAN
> address header, or to
	match <SPAN
CLASS="QUOTE"
>"All"</SPAN
> addresses found in all address headers. Click
	the <SPAN
CLASS="QUOTE"
>"Select..."</SPAN
> button to choose the address book part to
	search in (either a book or a sub-folder), or select <SPAN
CLASS="QUOTE"
>"Any"</SPAN
>
	to search in the whole address book.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="addrbk_advanced"
>5.4. Advanced features</A
></H3
><DIV
CLASS="section"
><H4
CLASS="section"
><A
NAME="addrbk_adv_ldap"
>5.4.1. Using LDAP servers</A
></H4
><P
>&#13;	      LDAP servers are used to share address books across networks. They are often available in companies. Enabling an LDAP server in Claws Mail is quite straight forward. Choose <SPAN
CLASS="QUOTE"
>"Book/New LDAP server"</SPAN
> in the <SPAN
CLASS="QUOTE"
>"Book"</SPAN
> menu, then choose a name for this LDAP server. Enter the hostname of the server (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>e.g. <SPAN
CLASS="QUOTE"
>"ldap.claws-mail.org"</SPAN
></I
></SPAN
>), its port, if necessary (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>the standard port is 389</I
></SPAN
>). You can then either fill in the <SPAN
CLASS="QUOTE"
>"Search Base"</SPAN
> yourself if you know what to use, or click on <SPAN
CLASS="QUOTE"
>"Check Server"</SPAN
> to have Claws Mail attempt to guess it automatically. If your server requires authentication, you can set it in the <SPAN
CLASS="QUOTE"
>"Extended"</SPAN
> tab.
	When you close this window by clicking <SPAN
CLASS="QUOTE"
>"Ok"</SPAN
>, the server appears in the address book's sources list on the left-hand side. When selecting the server, you will see an empty list of contacts at the right, which can be surprising at first. This is to avoid doing full searches on the server without you explicitly asking for it. You can now search for names using the <SPAN
CLASS="QUOTE"
>"Lookup"</SPAN
> form at the bottom of this list. If you want a full listing, just search for <SPAN
CLASS="QUOTE"
>"*"</SPAN
>.
      </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="addrbk_adv_jpilot"
>5.4.2. Integration with jPilot</A
></H4
><P
>&#13;	Claws Mail can use addresses stored on your handheld device.
      </P
></DIV
><DIV
CLASS="section"
><HR><H4
CLASS="section"
><A
NAME="addrbk_adv_vcard"
>5.4.3. vCard support</A
></H4
><P
>&#13;	Claws Mail can import vCards of your contacts by using <SPAN
CLASS="QUOTE"
>"Book/New vCard"</SPAN
>.
      </P
></DIV
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_advanced"
>6. Advanced features</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="adv_actions"
>6.1. Actions</A
></H3
><P
>&#13;	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, 
	<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>hide</I
></SPAN
> what you mean using ROT-13, apply patches 
	contained in emails directly, and so on. The only limit is your 
	imagination. You can create and configure Actions via the
	<SPAN
CLASS="QUOTE"
>"/Configuration/Actions..."</SPAN
> menu.
    </P
><P
>&#13;        The <SPAN
CLASS="QUOTE"
>"Tools/Actions/"</SPAN
> menu will contain one submenu
	item for each action that you have created. When you have selected
	one or more messages in the Message List, or are viewing a message
	in the Message View, selecting one of these menu items will invoke
	the action, and, depending on how it was defined, will pass the
	message(s) to it.
    </P
><P
>&#13;        Additionally, it is possible to add toolbar entries for your
        actions. To do so, open the <SPAN
CLASS="QUOTE"
>"Configuration/Preferences"</SPAN
>
        menu and select <SPAN
CLASS="QUOTE"
>"Toolbars/Main Window"</SPAN
>.
	Select <SPAN
CLASS="QUOTE"
>"User Action"</SPAN
> in the <SPAN
CLASS="QUOTE"
>"Item type"</SPAN
>
	dropdown menu, then select the Action in the <SPAN
CLASS="QUOTE"
>"Event executed on click"</SPAN
>
	dropdown menu, and click the <SPAN
CLASS="QUOTE"
>"Icon"</SPAN
> button to select the
	icon that you want to use.
    </P
><A
NAME="AEN320"
></A
><BLOCKQUOTE
CLASS="BLOCKQUOTE"
><DIV
CLASS="example"
><A
NAME="AEN321"
></A
><P
><B
>Example 1. Simple <SPAN
CLASS="QUOTE"
>"Open With..."</SPAN
></B
></P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>Menu name: <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Open with/kate</I
></SPAN
> 
	Command Line: <B
CLASS="command"
>kate %p</B
></DT
><DD
><P
>&#13;	Opens the file of the selected decoded MIME part 
	(<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>%p</I
></SPAN
>) with the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>kate</I
></SPAN
> text 
	editor.
	      </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="example"
><A
NAME="AEN333"
></A
><P
><B
>Example 2. Spam management using <A
HREF="http://bogofilter.sourceforge.net/"
TARGET="_top"
>Bogofilter</A
>
	</B
></P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>Menu name: <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Bogofilter/Mark as Ham</I
></SPAN
> 
	Command Line: <B
CLASS="command"
>bogofilter -n -v -B "%f"</B
></DT
><DD
><P
>&#13;	Marks the currently selected mails (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>%f</I
></SPAN
>) as
	<SPAN
CLASS="QUOTE"
>"not spam"</SPAN
> using <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Bogofilter</I
></SPAN
>.
	      </P
></DD
><DT
>Menu name: <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Bogofilter/Mark as Spam</I
></SPAN
> 
	Command Line: <B
CLASS="command"
>bogofilter -s -v -B "%f"</B
></DT
><DD
><P
>&#13;	Marks the currently selected mails (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>%f</I
></SPAN
>) as 
	<SPAN
CLASS="QUOTE"
>"spam"</SPAN
> using <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Bogofilter</I
></SPAN
>.
	      </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="example"
><A
NAME="AEN355"
></A
><P
><B
>Example 3. Search Google using an external script</B
></P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>Menu name: <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>Search/Google</I
></SPAN
> 
	Command Line: <B
CLASS="command"
>|/path/to/google_search.pl</B
></DT
><DD
><P
>&#13;	Searches Google for the currently selected text 
	(<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>|</I
></SPAN
>) using the external script <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
><A
HREF="http://www.claws-mail.org/tools.php"
TARGET="_top"
>google_search.pl</A
></I
></SPAN
>.
	      </P
></DD
></DL
></DIV
></DIV
></BLOCKQUOTE
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_templates"
>6.2. Templates</A
></H3
><P
>&#13;	Templates are used in composition windows, and act as a model for 
	emails. Templates can be filled with static text and dynamic parts, 
	such as the original sender's name (<SPAN
CLASS="QUOTE"
>"Dear %N, ..."</SPAN
>), 
	the date, etc. When applying a template, the dynamic fields will be 
	replaced with the relevant values. You can configure templates via 
	the <SPAN
CLASS="QUOTE"
>"Tools"</SPAN
> menu.
    </P
><P
>&#13;	When applying a template, you will be asked to <SPAN
CLASS="QUOTE"
>"Insert"</SPAN
>
	or <SPAN
CLASS="QUOTE"
>"Replace"</SPAN
>, the difference between replacing and 
	inserting is only concerned with the message body. 
	<SPAN
CLASS="QUOTE"
>"Replace"</SPAN
> will replace the current composition window 
	message body with the body defined in the template, clearing it if 
	the template body is empty. <SPAN
CLASS="QUOTE"
>"Insert"</SPAN
> will insert 
	the template's body, if set, at the current cursor position.
    </P
><P
>&#13;	Whether you choose to Insert or Replace, any To, Cc or Bcc field 
	that is defined in the template will be appended to the compose 
	window's recipients list. If it is defined, the template's Subject 
	will always replace the compose window's Subject.
    </P
><P
>&#13;	Symbols can be used in all parts of the templates and will be 
	substituted with their respective dynamic value if possible, otherwise 
	no value will be used. This often makes more sense if you apply a 
	template when replying or forwarding, otherwise most of the symbols 
	value will be undefined. There is no restriction on which symbols can 
	be used in template parts, even if inserting the body (%M or %Q) may 
	make no sense in common situations.
    </P
><P
>&#13;	When applying a template, the body is processed first, then the To, Cc,
	Bcc and Subject fields follow.
    </P
><P
>&#13;	Further information and examples of usage can be found in the 
	user-contributed FAQ on the Claws Mail website <A
HREF="http://www.claws-mail.org/faq/"
TARGET="_top"
>http://www.claws-mail.org/faq/</A
>.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_processing"
>6.3. Processing</A
></H3
><P
>&#13;	Processing rules are the same as Filtering rules, except that they are 
	applied when entering a folder or when manually applied from a folder's
	context	menu 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, and more. You can set each folder's Processing rules by
	right-clicking on it.
    </P
><P
>&#13;	Processing rules are accompanied by Pre-processing and Post-processing 
	rules. Like Processing rules, they apply when opening a folder or manually
	applying them from a folder's context menu, but like Filtering rules,
	they are shared across all folders. You can configure them from the
	<SPAN
CLASS="QUOTE"
>"Tools"</SPAN
> menu. Pre-processing rules are executed before the
	folder's specific Processing rules, while Post-processing rules are executed
	afterwards.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_colour_labels"
>6.4. Colour Labels</A
></H3
><P
>&#13;	Colour labels can be used to denote a message as having a particular 
	significance. To set a colour label simply right-click a message in the
	Message List and use the <SPAN
CLASS="QUOTE"
>"Color label"</SPAN
> submenu.
    </P
><P
>&#13;	Colour labels are user-configurable. Both the colour and the label can 
	be set by the user. Preferences can be found on the 
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Display/Colors"</SPAN
> page.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_tags"
>6.5. Tags</A
></H3
><P
>&#13;	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.
    </P
><P
>&#13;	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.
    </P
><P
>&#13;	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.
    </P
><P
>&#13;	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.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_ml_support"
>6.6. Mailing-List support</A
></H3
><P
>&#13;	Claws Mail offers mailing-list support from the 
	<SPAN
CLASS="QUOTE"
>"Message/Mailing-List/"</SPAN
> submenu. When you have a 
	mailing-list message selected, the submenu allows you to quickly 
	initiate subscribing, unsubscribing, posting, getting help, contacting 
	the list owner, and viewing the list archive; either by opening a new 
	Compose window with the appropriate address pre-filled, or by opening 
	the URL in your web browser.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_plugins"
>6.7. Plugins</A
></H3
><P
>&#13;	Plugins are the mechanism for extending Claws Mail' capabilities. 
	For example, imagine that you want to store your mails in a remote 
	<ACRONYM
CLASS="acronym"
>SQL</ACRONYM
> database. In most mailers out there this is 
	simply impossible without reworking the internals of the mailer. With 
	Claws Mail you can simply write a plugin to achieve the task.
    </P
><P
>&#13;	This is just an example of the possibilities. A good number of plugins 
	developed for Claws Mail already exist, and more are to come. The 
	<A
HREF="#ch_plugins"
>Extending Claws Mail section</A
> 
	gives details of them.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="deploying"
>6.8. Deploying Claws Mail</A
></H3
><P
>&#13;	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 Claws Mail easily
	over various users of one machine, or even over multiple machines 
	installed via some replication tool.
    </P
><P
>&#13;	The first part consists of creating a wizard configuration template 
	and setting the various default parameters of a new Claws Mail 
	installation.
    </P
><P
></P
><UL
><LI
><P
>&#13;	Start with a user who does not have a <TT
CLASS="filename"
>~/.claws-mail</TT
> directory, ideally a new user.
	</P
></LI
><LI
><P
>&#13;	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.
	</P
></LI
><LI
><P
>&#13;	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.
	</P
></LI
><LI
><P
>&#13;	If needed, and if the deployed Claws Mail will use MH folders, you 
	can create subdirectories in the mailbox.
	</P
></LI
><LI
><P
>&#13;	Next, quit Claws Mail.
	</P
></LI
><LI
><P
>&#13;	Now, edit the newly created wizard template file, 
	<TT
CLASS="filename"
>~/.claws-mail/accountrc.tmpl</TT
>. 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 
	variables; for example, <TT
CLASS="literal"
>smtpauth</TT
>, 
	<TT
CLASS="literal"
>smtpssl</TT
> and <TT
CLASS="literal"
>recvssl</TT
> are booleans,
	either 0 or 1, and <TT
CLASS="literal"
>recvtype</TT
> is an integer value. The
	other fields, like <TT
CLASS="literal"
>name</TT
>, <TT
CLASS="literal"
>email</TT
>, 
	or <TT
CLASS="literal"
>recvuser</TT
>, are parsed by the wizard and the 
	variables they contain are replaced by values. This allows you to 
	specify everything as needed for your site, even if you have strange 
	server names or server logins.
	</P
></LI
><LI
><P
>&#13;	Save this file, and delete both 
	<TT
CLASS="filename"
>~/.claws-mail/accountrc</TT
>, (which contains your 
	dummy account) and 
	<TT
CLASS="filename"
>~/.claws-mail/folderlist.xml</TT
>, (so that the 
	folder tree will be correctly parsed for new users). Recursively copy 
	<TT
CLASS="filename"
>.claws-mail</TT
> to 
	<TT
CLASS="filename"
>/etc/skel/</TT
>; if the deployed 
	Claws Mail will use MH folders, also copy the created 
	<TT
CLASS="filename"
>Mail</TT
> directory. chown all of 
	<TT
CLASS="filename"
>/etc/skel/.claws-mail</TT
> 
	and <TT
CLASS="filename"
>/etc/skel/Mail</TT
> to 
	<TT
CLASS="literal"
>root:root</TT
> for security reasons.
	</P
></LI
><LI
><P
>&#13;	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.
	</P
></LI
><LI
><P
>&#13;	Now, if you're creating a master for a site-wide deployment, you can 
	continue with this process. If you were just doing it for one machine, 
	you're done!
	</P
></LI
></UL
><P
>&#13;    Here are the different variables of the <TT
CLASS="filename"
>accountrc.tmpl</TT
>
    file:
    </P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><TT
CLASS="literal"
>domain</TT
></DT
><DD
><P
>&#13;	Your domain name (example.com). If not set, it'll be extracted from the
	hostname.
	  </P
></DD
><DT
><TT
CLASS="literal"
>name</TT
></DT
><DD
><P
>&#13;	The user's name. If not set, it'll be extracted from Unix login 
	information, which is usually ok.
	  </P
></DD
><DT
><TT
CLASS="literal"
>email</TT
></DT
><DD
><P
>&#13;	The user's email. If not set, it'll be extracted from 
	<TT
CLASS="literal"
>$name</TT
> and <TT
CLASS="literal"
>$domain</TT
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>organization</TT
></DT
><DD
><P
>&#13;	Your organization. If not set, it'll be empty.
	  </P
></DD
><DT
><TT
CLASS="literal"
>smtpserver</TT
></DT
><DD
><P
>&#13;	The SMTP server to use. If not set, it'll be 
	<TT
CLASS="literal"
>smtp.$domain</TT
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>smtpauth</TT
></DT
><DD
><P
>&#13;	0 or 1. Whether to authenticate on the SMTP server. If not set, it'll 
	be 0.
	  </P
></DD
><DT
><TT
CLASS="literal"
>smtpuser</TT
></DT
><DD
><P
>&#13;	The login on the SMTP server. If not set, it'll be empty (same login as
	for reception will be used).
	  </P
></DD
><DT
><TT
CLASS="literal"
>smtppass</TT
></DT
><DD
><P
>&#13;	The password on the SMTP server. If not set, it'll be empty (if 
	<TT
CLASS="literal"
>smtppass</TT
> is empty but <TT
CLASS="literal"
>smtpuser</TT
> is
	not, the user will be asked for the password).
	  </P
></DD
><DT
><TT
CLASS="literal"
>recvtype</TT
></DT
><DD
><P
>&#13;	The type of server to receive from. 0 for POP3, 3 for IMAP4, 5 for a 
	local MBOX file. If not set, it'll be 0 (POP3).
	  </P
></DD
><DT
><TT
CLASS="literal"
>recvserver</TT
></DT
><DD
><P
>&#13;	The reception server. If not set, it'll be 
	<TT
CLASS="literal"
>(pop|imap).$domain</TT
>, depending on 
	<TT
CLASS="literal"
>$recvtype</TT
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>recvuser</TT
></DT
><DD
><P
>&#13;	The login on the reception server. If not set, it'll be extracted from 
	the Unix login information.
	  </P
></DD
><DT
><TT
CLASS="literal"
>recvpass</TT
></DT
><DD
><P
>&#13;	The password on the reception server. If not set, it'll be empty (the 
	user will be asked for it once per session).
	  </P
></DD
><DT
><TT
CLASS="literal"
>imapdir</TT
></DT
><DD
><P
>&#13;	The IMAP subdirectory. If not set, it'll be empty, which is often 
	sufficient.
	  </P
></DD
><DT
><TT
CLASS="literal"
>mboxfile</TT
></DT
><DD
><P
>&#13;	The MBOX file to receive from if <TT
CLASS="literal"
>$recvtype</TT
> is 5. 
	If not set, <TT
CLASS="literal"
>/var/mail/$LOGIN</TT
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>mailbox</TT
></DT
><DD
><P
>&#13;	The MH mailbox to store mail in (for <TT
CLASS="literal"
>$recvtype</TT
> 0 or 
	5). If not set, it'll be <SPAN
CLASS="QUOTE"
>"Mail"</SPAN
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>smtpssl</TT
></DT
><DD
><P
>&#13;	0 or 1. Whether to use SSL for sending mail. If not set, it'll be 0.
	  </P
></DD
><DT
><TT
CLASS="literal"
>recvssl</TT
></DT
><DD
><P
>&#13;	0 or 1. Whether to use SSL for receiving mail. If not set, it'll be 0.
	  </P
></DD
></DL
></DIV
><P
>&#13;	Here are the different variables you can use in the 
	<TT
CLASS="literal"
>domain</TT
>, <TT
CLASS="literal"
>name</TT
>, 
	<TT
CLASS="literal"
>email</TT
>, <TT
CLASS="literal"
>organization</TT
>, 
	<TT
CLASS="literal"
>smtpserver</TT
>, <TT
CLASS="literal"
>smtpuser</TT
>, 
	<TT
CLASS="literal"
>smtppass</TT
>, <TT
CLASS="literal"
>recvserver</TT
>, 
	<TT
CLASS="literal"
>recvuser</TT
>, <TT
CLASS="literal"
>recvpass</TT
>, 
	<TT
CLASS="literal"
>imapdir</TT
>, <TT
CLASS="literal"
>mboxfile</TT
> and 
	<TT
CLASS="literal"
>mailbox</TT
> fields:
    </P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><TT
CLASS="literal"
>$DEFAULTDOMAIN</TT
></DT
><DD
><P
>&#13;	The domain name as extracted from Unix hostname information. 
	Often wrong.
	  </P
></DD
><DT
><TT
CLASS="literal"
>$DOMAIN</TT
></DT
><DD
><P
>&#13;	The domain name as set in the domain variable, the first of the 
	template file.
	  </P
></DD
><DT
><TT
CLASS="literal"
>$USERNAME</TT
></DT
><DD
><P
>The user's real name.</P
></DD
><DT
><TT
CLASS="literal"
>$LOGIN</TT
></DT
><DD
><P
>The user's Unix login.</P
></DD
><DT
><TT
CLASS="literal"
>$NAME_MAIL</TT
></DT
><DD
><P
>&#13;	The user's real name as set in the name variable of the template field,
	in lowercase and with spaces replaced by dots. 
	<SPAN
CLASS="QUOTE"
>"Colin Leroy"</SPAN
> becomes <SPAN
CLASS="QUOTE"
>"colin.leroy"</SPAN
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>$EMAIL</TT
></DT
><DD
><P
>&#13;	The email address as set in the email variable of the template field.
	  </P
></DD
></DL
></DIV
><P
>&#13;	Be sure not to use a variable before defining it.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_hidden"
>6.9. Hidden preferences</A
></H3
><P
>&#13;	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 Claws Mail is not running, in 
	<TT
CLASS="filename"
>~/.claws-mail/clawsrc</TT
>.
    </P
><P
>&#13;	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 <TT
CLASS="filename"
>clawsrc</TT
>. You can read more
	about it on the <A
HREF="http://www.claws-mail.org/clawsker"
TARGET="_top"
>Clawsker
	page</A
>.
    </P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
><TT
CLASS="literal"
>addressbook_use_editaddress_dialog</TT
></DT
><DD
><P
>&#13;	Use a separate dialogue to edit a person's details. 
	'0' will use a form embedded in the addressbook's main window.
	  </P
></DD
><DT
><TT
CLASS="literal"
>bold_unread</TT
></DT
><DD
><P
>&#13;	Show unread messages in the Message List using a bold font.
	  </P
></DD
><DT
><TT
CLASS="literal"
>cache_max_mem_usage</TT
></DT
><DD
><P
>&#13;	The maximum amount of memory to use to cache messages, in kB.
	  </P
></DD
><DT
><TT
CLASS="literal"
>cache_min_keep_time</TT
></DT
><DD
><P
>&#13;	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.
	  </P
></DD
><DT
><TT
CLASS="literal"
>compose_no_markup</TT
></DT
><DD
><P
>&#13;	Don't use bold and italic text in Compose dialogue's account selector.
	  </P
></DD
><DT
><TT
CLASS="literal"
>emphasis_color</TT
></DT
><DD
><P
>&#13;	The colour used for the X-Mailer line when its value is Claws Mail.
	  </P
></DD
><DT
><TT
CLASS="literal"
>enable_dotted_lines</TT
></DT
><DD
><P
>&#13;	Use the <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>old</I
></SPAN
> dotted line look in the main window
	GtkTreeView components, (Folder List and Message List), instead of the
	<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>modern</I
></SPAN
> lineless look.
	  </P
></DD
><DT
><TT
CLASS="literal"
>enable_hscrollbar</TT
></DT
><DD
><P
>&#13;	Enable the horizontal scrollbar in the Message List.
	  </P
></DD
><DT
><TT
CLASS="literal"
>enable_swap_from</TT
></DT
><DD
><P
>&#13;	Display the sender's email address in the To column of the
	Sent folder instead of the recipient's.
	  </P
></DD
><DT
><TT
CLASS="literal"
>folderview_vscrollbar_policy</TT
></DT
><DD
><P
>&#13;	Specify the policy of vertical scrollbar of Folder List.
	'0' is always shown, '1' is automatic, '2' is always hidden.
	  </P
></DD
><DT
><TT
CLASS="literal"
>hover_timeout</TT
></DT
><DD
><P
>&#13;	Time in milliseconds that will cause a folder tree to expand 
	when the mouse cursor is held over it during drag 'n' drop.
	  </P
></DD
><DT
><TT
CLASS="literal"
>live_dangerously</TT
></DT
><DD
><P
>&#13;	Don't ask for confirmation before definitive deletion of emails.
	  </P
></DD
><DT
><TT
CLASS="literal"
>log_error_color</TT
>, <TT
CLASS="literal"
>log_in_color</TT
>, <TT
CLASS="literal"
>log_msg_color</TT
>, <TT
CLASS="literal"
>log_out_color</TT
>, <TT
CLASS="literal"
>log_warn_color</TT
>, <TT
CLASS="literal"
>log_status_ok_color</TT
>, <TT
CLASS="literal"
>log_status_nok_color</TT
>, <TT
CLASS="literal"
>log_status_skip_color</TT
></DT
><DD
><P
>&#13;	The colours used in the log window.
	  </P
></DD
><DT
><TT
CLASS="literal"
>msgview_date_format</TT
></DT
><DD
><P
>&#13;	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.
	  </P
></DD
><DT
><TT
CLASS="literal"
>outgoing_fallback_to_ascii</TT
></DT
><DD
><P
>&#13;	0 or 1. The outgoing encoding of a message will use 7bit US-ASCII
	whenever it is suitable for the message content, ignoring the
	<SPAN
CLASS="QUOTE"
>"Outgoing encoding"</SPAN
> 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.
	  </P
></DD
><DT
><TT
CLASS="literal"
>primary_paste_unselects</TT
></DT
><DD
><P
>&#13;	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.
	  </P
></DD
><DT
><TT
CLASS="literal"
>respect_flowed_format</TT
></DT
><DD
><P
>&#13;	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.
	  </P
></DD
><DT
><TT
CLASS="literal"
>save_parts_readwrite</TT
></DT
><DD
><P
>&#13;	Saves temporary files when opening attachment with write bit set.
	  </P
></DD
><DT
><TT
CLASS="literal"
>show_compose_margin</TT
></DT
><DD
><P
>&#13;	0 or 1. Adds margins to the message text area in the Compose window.
	Default is 0, turned off.
	  </P
></DD
><DT
><TT
CLASS="literal"
>show_inline_attachments</TT
></DT
><DD
><P
>&#13;	0 or 1. Show inline attachments in MimeView.
	Default is 1, turned on.
	  </P
></DD
><DT
><TT
CLASS="literal"
>skip_ssl_cert_check</TT
></DT
><DD
><P
>&#13;	Disables the verification of SSL certificates.
	  </P
></DD
><DT
><TT
CLASS="literal"
>statusbar_update_step</TT
></DT
><DD
><P
>&#13;	Update stepping in progress bars.
	  </P
></DD
><DT
><TT
CLASS="literal"
>stripes_color_offset</TT
></DT
><DD
><P
>&#13;	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.
	</P
></DD
><DT
><TT
CLASS="literal"
>summary_from_show</TT
></DT
><DD
><P
>&#13;	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. 
	</P
></DD
><DT
><TT
CLASS="literal"
>textview_cursor_visible</TT
></DT
><DD
><P
>&#13;	Display the cursor in the message view.
	  </P
></DD
><DT
><TT
CLASS="literal"
>thread_by_subject_max_age</TT
></DT
><DD
><P
>&#13;	Number of days to include a message in a thread when using 
	<SPAN
CLASS="QUOTE"
>"Thread using subject in addition to standard headers"</SPAN
>.
	  </P
></DD
><DT
><TT
CLASS="literal"
>toolbar_detachable</TT
></DT
><DD
><P
>&#13;	Show handles in the toolbars.
	  </P
></DD
><DT
><TT
CLASS="literal"
>two_line_vertical</TT
></DT
><DD
><P
>&#13;	Spread message list information over two lines when using the
	three column layout.
	  </P
></DD
><DT
><TT
CLASS="literal"
>unsafe_ssl_certs</TT
></DT
><DD
><P
>&#13;	Allows Claws to remember multiple SSL certificates for a given 
	server/port. This is disabled by default.
	</P
></DD
><DT
><TT
CLASS="literal"
>use_networkmanager</TT
></DT
><DD
><P
>&#13;	Use NetworkManager to switch offline automatically. This is enabled
	by default.
	</P
></DD
><DT
><TT
CLASS="literal"
>use_stripes_everywhere</TT
></DT
><DD
><P
>&#13;	Enable alternately coloured lines in GtkTreeView components.
	</P
></DD
><DT
><TT
CLASS="literal"
>use_stripes_in_summaries</TT
></DT
><DD
><P
>&#13;	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.
	</P
></DD
><DT
><TT
CLASS="literal"
>utf8_instead_of_locale_for_broken_mail</TT
></DT
><DD
><P
>&#13;	Use UTF-8 encoding for broken mails instead of current locale.
	  </P
></DD
><DT
><TT
CLASS="literal"
>warn_dnd</TT
></DT
><DD
><P
>&#13;	Display a confirmation dialogue on drag 'n' drop of folders.
	  </P
></DD
><DT
><TT
CLASS="literal"
>zero_replacement_char</TT
></DT
><DD
><P
>&#13;	Character to show in Folder List counter columns when a folder contains
	no messages. Default value is 0.
	  </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="adv_autofaces"
>6.10. Autofaces</A
></H3
><P
>&#13;	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
	<TT
CLASS="filename"
>~/.claws-mail/autofaces/</TT
> directory.
    </P
><P
>&#13;	If they exist, the global Face and/or X-Face headers for all
	accounts are taken from the <TT
CLASS="filename"
>face</TT
> and/or
	<TT
CLASS="filename"
>xface</TT
> files respectively. In a similar
	manner, Face and/or X-Face headers for a specific account can
	be provided by <TT
CLASS="filename"
>face.</TT
><SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>accountname</I
></SPAN
>
	and/or <TT
CLASS="filename"
>xface.</TT
><SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>accountname</I
></SPAN
>,
	where <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>accountname</I
></SPAN
> is the name of the account you 
	want this header to be associated with.
   </P
><P
>&#13;	If the name of the account contains characters which may be unsuitable 
	for the underlying filesystem (including spaces) these are replaced by 
	underscores (<SPAN
CLASS="QUOTE"
>"_"</SPAN
>) when searching for the autofaces of 
	that account. For example, if your account is called 
	<SPAN
CLASS="QUOTE"
>"&#60;My Mail&#62;"</SPAN
>, the name for the X-Face filename for
	that account would be
	<TT
CLASS="filename"
>~/.claws-mail/autofaces/xface._My_Mail_</TT
>.
	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). 
    </P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="ch_plugins"
>7. Extending Claws Mail</A
></H2
><DIV
CLASS="section"
><H3
CLASS="section"
><A
NAME="plugins_default"
>7.1. Provided plugins</A
></H3
><P
>&#13;	Claws Mail' capabilities are extended by plugins. It comes with 
	the plugins listed below included, all of which are built automatically
	if the required libraries are present.
    </P
><P
>&#13;	Plugins are installed in <TT
CLASS="filename"
>$PREFIX/lib/claws-mail/plugins/</TT
> and have a suffix of 
	<SPAN
CLASS="QUOTE"
>".so"</SPAN
>. To load a plugin go to 
	<SPAN
CLASS="QUOTE"
>"Configuration/Plugins"</SPAN
> and click the 
	<SPAN
CLASS="QUOTE"
>"Load Plugin"</SPAN
> button. Select the plugin that you want and 
	click <SPAN
CLASS="QUOTE"
>"Open"</SPAN
> button.
    </P
><P
>&#13;	If you don't find the plugin you're looking for, it is possible that 
	your Operating System distribution provides it in a separate package. 
	In this case, search for the plugin in your package manager.
    </P
><P
>&#13;	Some plugins provide the same functionality as others, (for example, the 
	three HTML message viewers). In this case you will have to choose which 
	one to load, as Claws Mail will refuse to load more than one of
	the same type.
    </P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>Bogofilter</DT
><DD
><P
>&#13;	The Bogofilter plugin comes with two major features:
	  </P
><P
>&#13;	The ability to scan incoming mail received from a POP, IMAP or LOCAL 
	account using Bogofilter. It can optionally delete mail identified 
	as spam or save it to a designated folder. Mail scanning can be turned 
	off.
	  </P
><P
>&#13;	The ability for users to teach Bogofilter to recognise spam or ham. 
	You can train Bogofilter by marking messages as spam or ham from the 
	Message List contextual menu, or using the relevant toolbar button in 
	the main window or the message window (see 
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Toolbars"</SPAN
>). Messages 
	marked as spam are optionally saved to a designated folder.
	  </P
><P
>&#13;	Plugin preferences can be found in 
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Plugins/Bogofilter"</SPAN
>.
	  </P
><P
>&#13;	Bogofilter's advantage over Spamassassin is its speed.
	  </P
><P
>&#13;	Bogofilter is available from <A
HREF="http://bogofilter.sourceforge.net/"
TARGET="_top"
>http://bogofilter.sourceforge.net/</A
>. 
	  </P
></DD
><DT
>Dillo HTML Viewer</DT
><DD
><P
>&#13;	Enables the viewing of HTML messages using the Dillo web browser, 
	version 0.7.0 or newer. It uses Dillo's <TT
CLASS="literal"
>--local</TT
> 
	option by default for safe browsing. Preferences can be found in 
	<SPAN
CLASS="QUOTE"
>"/Configuration/Preferences/Plugins/Dillo Browser"</SPAN
>. 
	Dillo is available from <A
HREF="http://www.dillo.org/"
TARGET="_top"
>http://www.dillo.org/</A
>.
	  </P
></DD
><DT
>PGP/Core, PGP/Inline and PGP/MIME</DT
><DD
><P
>&#13;	Handles PGP signed and/or encrypted mails. You can decrypt mails, 
	verify signatures or sign and encrypt your own mails. Uses GnuPG/GPGME,
	<A
HREF="ftp://ftp.gnupg.org/gcrypt/gpgme/"
TARGET="_top"
>ftp://ftp.gnupg.org/gcrypt/gpgme/</A
>.
	  </P
></DD
><DT
>S/MIME</DT
><DD
><P
>&#13;	Handles S/MIME signed and/or encrypted mails. You can decrypt mails, 
	verify signatures or sign and encrypt your own mails. Uses GnuPG/GPGME 
	and GpgSM, <A
HREF="ftp://ftp.gnupg.org/gcrypt/gpgme/"
TARGET="_top"
>ftp://ftp.gnupg.org/gcrypt/gpgme/</A
>.
	  </P
></DD
><DT
>SpamAssassin</DT
><DD
><P
>&#13;	The SpamAssassin plugin comes with two major features:
	  </P
><P
>&#13;	The ability to scan incoming mail received from a POP, IMAP or LOCAL 
	account using SpamAssassin. It can optionally delete mail identified 
	as spam or save it to a designated folder. Mail scanning can be turned 
	off, which is useful if your email is scanned on your server.
	  </P
><P
>&#13;	The ability for users to teach SpamAssassin to recognise spam or ham. 
	You can train SpamAssassin by marking messages as spam or ham from the 
	Message List contextual menu, or using the relevant toolbar button in 
	the main window or the message window (see 
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Toolbars"</SPAN
>). Messages 
	marked as spam are optionally saved to a designated folder.
	  </P
><P
>&#13;	Plugin preferences can be found in 
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Plugins/SpamAssassin"</SPAN
>.
	  </P
><P
>&#13;	SpamAssassin's advantage over Bogofilter is that it's not only a bayesian
	filter, but it also performs various local and network tests to
	determine spaminess.
	  </P
><P
>&#13;	SpamAssassin is available from <A
HREF="http://spamassassin.apache.org/"
TARGET="_top"
>http://spamassassin.apache.org/</A
>. Version 3.1.x or higher is 
	required to use the learning feature in TCP mode.
	  </P
></DD
><DT
>Trayicon</DT
><DD
><P
>&#13;	Places an icon in the system tray that indicates whether you have any 
	new mail. A tooltip also shows the current new, unread and total number
	of messages.
	  </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="plugins_external"
>7.2. More plugins</A
></H3
><P
>&#13;	Other plugins have been written too, which are available as separate 
	downloads. At the time of this writing, there are a number of plugins 
	available at <A
HREF="http://www.claws-mail.org/plugins.php"
TARGET="_top"
>http://www.claws-mail.org/plugins.php</A
>:
    </P
><P
></P
><DIV
CLASS="variablelist"
><DL
><DT
>Acpi Notifier</DT
><DD
><P
>&#13;	Enables new mail notification via the LEDs found on some laptops like 
	Acer, Asus, Fujitsu and IBM laptops.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=acpinotifier"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=acpinotifier</A
>
	  </P
></DD
><DT
>AttachWarner</DT
><DD
><P
> 
	Reminds you about possibly forgotten attachments. Checks for common
	expressions found when attaching a file and warns you if no attachment
	was added to the mail you're sending.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=attachwarner"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=attachwarner</A
>
	  </P
></DD
><DT
>AttRemover</DT
><DD
><P
> 
	Allows you to remove attachments from emails.
	  </P
></DD
><DT
>BSFilter</DT
><DD
><P
> 
	BSFilter is a plugin that is very similar to the Bogofilter plugin but uses
	the bsfilter (<A
HREF="http://bsfilter.org/index-e.html"
TARGET="_top"
>bsfilter.org/index-e.html</A
>)
	bayesian spam filter as a backend. 
	  </P
><P
>&#13;	Like Bogofilter, you have to train it with spam and ham
	messages in order for bsfilter to start recognising spam.
	  </P
><P
>&#13;	Plugin preferences can be found in 
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Plugins/BSFilter"</SPAN
>.
	  </P
></DD
><DT
>CacheSaver</DT
><DD
><P
>&#13;	Saves the caches every 60 seconds (or user-defined period). It helps 
	avoiding the loss of metadata if your computer (<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>or 
	Claws Mail!</I
></SPAN
>) crashes. (NOTE: using this plugin can slow
	down Claws Mail.)
	  </P
></DD
><DT
>Fancy</DT
><DD
><P
>&#13;	Enables the display of HTML messages using the GTK+ port of the
	WebKit library.
	  </P
></DD
><DT
>Fetchinfo</DT
><DD
><P
>&#13;	Inserts headers containing some download information, like UIDL, 
	Claws Mail' account name, POP server, user ID and retrieval time.
	  </P
></DD
><DT
>GtkHtml2 Viewer</DT
><DD
><P
>&#13;	Like Dillo, enables the viewing of HTML messages, but in a nicer way 
	(antialiased fonts).
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=gtkhtml2"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=gtkhtml2</A
>
	  </P
></DD
><DT
>Mail Archiver</DT
><DD
><P
>&#13;	Enables folders and subfolders to be archived in several different
	formats.
	  </P
></DD
><DT
>mailMBOX</DT
><DD
><P
>&#13;	Handles mailboxes in MBox format.
	  </P
></DD
><DT
>NewMail</DT
><DD
><P
>&#13;	Writes a msg header summary to a log file, (Default: 
	<TT
CLASS="filename"
>~/Mail/NewLog</TT
>), on arrival of new mail 
	<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>after</I
></SPAN
> sorting. 
	  </P
></DD
><DT
>Notification</DT
><DD
><P
>&#13;	Provides various ways to notify the user of new and unread email.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=notification"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=notification</A
>
	  </P
></DD
><DT
>Perl</DT
><DD
><P
>&#13;	Intended to extend the filtering possibilities of Claws Mail. It 
	provides a Perl interface to Claws Mail' filtering mechanism, 
	allowing the use of full Perl power in email filters.
	  </P
></DD
><DT
>Python</DT
><DD
><P
>&#13;	This plugin provides Python integration features.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=python"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=python</A
>
	  </P
></DD
><DT
>RSSyl</DT
><DD
><P
>&#13;	Allows you to read your favorite newsfeeds in Claws. RSS 1.0, 2.0 and 
	Atom feeds are currently supported.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=rssyl"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=rssyl</A
>
	  </P
></DD
><DT
>SpamReport</DT
><DD
><P
>&#13;	This plugin reports spam to various places.
	Currently the sites <A
HREF="http://spam-signal.fr"
TARGET="_top"
>spam-signal.fr</A
> and <A
HREF="http://spamcop.net"
TARGET="_top"
>spamcop.net</A
> are supported, and the <A
HREF="http://lists.debian.org"
TARGET="_top"
>Debian lists (lists.debian.org)</A
>
	spam nomination system.
	  </P
></DD
><DT
>SynCE</DT
><DD
><P
>&#13;	Assists in keeping the address book of a Windows CE device (Pocket 
	PC, iPAQ, Smartphone, etc.) in sync with Claws Mail' address book, 
	with respect to email addresses.
	  </P
></DD
><DT
>TNEF parse</DT
><DD
><P
>&#13;	This plugin enables reading <TT
CLASS="literal"
>application/ms-tnef attachments</TT
>.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=tnef_parser"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=tnef_parser</A
>
	  </P
></DD
><DT
>vCalendar</DT
><DD
><P
>&#13;	Enables vCalendar message handling like that produced by Evolution or 
	Outlook, and Webcal subscriptions.
	More information: <A
HREF="http://www.claws-mail.org/plugin.php?plugin=vcalendar"
TARGET="_top"
>&#13;	www.claws-mail.org/plugin.php?plugin=vcalendar</A
>
	  </P
></DD
></DL
></DIV
><P
>&#13;	If you're a developer, writing a plugin to extend Claws Mail' 
	capabilities is probably the best and easiest solution. We will 
	provide hosting to your code, and will be glad to answer your questions
	in the mailing-list or on the IRC channels, 
	<TT
CLASS="literal"
>#claws</TT
> on Freenode or IRCnet.
    </P
></DIV
><DIV
CLASS="section"
><HR><H3
CLASS="section"
><A
NAME="plugins_network"
>7.3. Network access from the plugins</A
></H3
><P
>&#13;	Some of the external plugins, for example RSSyl, vCalendar or GtkHtml 
	Viewer, need Internet access for their operations (retrieving feeds in 
	the case of RSSyl or vCalendar, and fetching images in the case of 
	GtkHtml Viewer). These plugins use the Curl library. Hence, if your 
	Internet access is restricted by a proxy, you will need to tell libCurl
	to use this proxy. This is done by setting an environment variable, 
	<TT
CLASS="literal"
>http_proxy</TT
>. For example, 
<TT
CLASS="literal"
>http_proxy=http://user:passwd@myproxy.example.com:8080</TT
> 
	will tell libCurl to connect to port 8080 of the machine 
	myproxy.example.com, with the user <SPAN
CLASS="QUOTE"
>"user"</SPAN
> and password 
	<SPAN
CLASS="QUOTE"
>"passwd"</SPAN
> to connect to the Internet. 
    </P
><P
>&#13;	You can either set this variable before starting Claws Mail, by 
	using for example 
	<B
CLASS="command"
>http_proxy=http://user:passwd@myproxy.example.com:8080 
	claws-mail</B
>, or set it in your 
	<TT
CLASS="filename"
>~/.bashrc</TT
> file (or your shell equivalent), by 
	adding the following line<A
NAME="AEN984"
HREF="#FTN.AEN984"
><SPAN
CLASS="footnote"
>[1]</SPAN
></A
>: 
<B
CLASS="command"
>export http_proxy=http://user:passwd@myproxy.example.com:8080</B
>
	(you'll have to reconnect to have it taken into account).
    </P
></DIV
></DIV
><DIV
CLASS="appendix"
><HR><H1
CLASS="appendix"
><A
NAME="ap_faq"
>A. The Claws Mail FAQ</A
></H1
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="AEN989"
>A.1. What are the differences between Claws Mail and Sylpheed?</A
></H2
><P
>&#13;	Claws Mail is a fork of Sylpheed, therefore you will find that 
	it has all the features that Sylpheed has and a lot more besides. 
	It also includes some modified dialogues to enhance usability. 
	Further information can be found at 
	<A
HREF="http://www.claws-mail.org/features.php"
TARGET="_top"
>&#13;	http://www.claws-mail.org/features.php</A
>.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN993"
>A.2. Does Claws Mail allow me to write HTML styled messages?</A
></H2
><P
>&#13;	No. A discussion has gone on around this topic, and the outcome was that
	HTML mail is not wanted. If you really need to send HTML, you can of
	course attach a webpage to an email.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN996"
>A.3. How can I submit patches, report bugs, and talk about Claws Mail
	with others?</A
></H2
><P
>&#13;	Patches should be submitted via our Bugzilla, 
	<A
HREF="http://www.thewildbeast.co.uk/claws-mail/bugzilla/"
TARGET="_top"
>&#13;	http://www.thewildbeast.co.uk/claws-mail/bugzilla/</A
>, 
	but please follow the patch guidelines at 
	<A
HREF="http://www.claws-mail.org/devel.php"
TARGET="_top"
>&#13;	http://www.claws-mail.org/devel.php</A
>.
    </P
><P
>&#13;	 Bug reports should be submitted at our Bugzilla, 
	 <A
HREF="http://www.thewildbeast.co.uk/claws-mail/bugzilla/"
TARGET="_top"
>&#13;	http://www.thewildbeast.co.uk/claws-mail/bugzilla/</A
>.
    </P
><P
>&#13;	To talk to others, you should join the Claws Mail users' mailing
	list. Details can be found at 
	<A
HREF="http://www.claws-mail.org/MLs.php"
TARGET="_top"
>&#13;	http://www.claws-mail.org/MLs.php</A
>.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1005"
>A.4. Does Claws Mail have an anti-spam feature?</A
></H2
><P
>&#13;	Yes. It has a SpamAssassin and a Bogofilter plugin. You can find 
	details of it on the
	<A
HREF="#ch_plugins"
>Extending Claws Mail</A
> chapter.
    </P
><P
>&#13;	You can also use other spam filters via the <SPAN
CLASS="QUOTE"
>"Filtering"</SPAN
> and
	<SPAN
CLASS="QUOTE"
>"Actions"</SPAN
> features. Instructions on how to use other antispam
	filters with Claws Mail can be found as a Bogofilter-based example
	on the <A
HREF="http://bogofilter.sourceforge.net/faq.shtml#with-sc"
TARGET="_top"
>&#13;	Bogofilter FAQ</A
>.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1013"
>A.5. Does Claws Mail support Return Receipts?</A
></H2
><P
>&#13;	Yes.
	To request a Return Receipt use <SPAN
CLASS="QUOTE"
>"Options/Request Return 
	Receipt"</SPAN
> in the Compose window. When you receive a message that
	requests a Return Receipt a notification area is shown just above the
	message view. You can either use the <SPAN
CLASS="QUOTE"
>"Send receipt"</SPAN
> button,
	or ignore the request - no receipts are sent automatically.
    </P
><P
>&#13;	If you do not ever want to send Return Receipts then you can use the
	option <SPAN
CLASS="QUOTE"
>"Never send Return Receipts"</SPAN
> in the
	<SPAN
CLASS="QUOTE"
>"Configuration/Preferences/Mail Handling/Sending"</SPAN
> page.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1021"
>A.6. How can I make Claws Mail notify me when new mail
    arrives?</A
></H2
><P
>&#13;	Go to <SPAN
CLASS="QUOTE"
>"Configuration/Preferences"</SPAN
>, in the <SPAN
CLASS="QUOTE"
>"Mail
	Handling/Receiving"</SPAN
> section, use the settings for <SPAN
CLASS="QUOTE"
>"Run
	command"</SPAN
> in the <SPAN
CLASS="QUOTE"
>"After receiving new mail"</SPAN
>
	frame. Alternatively, use the Trayicon plugin.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1028"
>A.7. Why are special characters (e.g. umlauts) not displayed
    correctly?</A
></H2
><P
>&#13;	In most cases, this is caused by emails with broken encodings. You can
	try to force it using the <SPAN
CLASS="QUOTE"
>"View/Character Encoding"</SPAN
>
	submenu.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1032"
>A.8. Can I quote just a section of the original message when
    replying?</A
></H2
><P
>&#13;	Yes, select the section of the message that you want to quote and use
	<SPAN
CLASS="QUOTE"
>"Reply"</SPAN
>.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="AEN1036"
>A.9. Where can I find the answers to more FAQs about
    Claws Mail?</A
></H2
><P
>&#13;	An enlarged, user-contributed FAQ can be found on the Claws Mail
	website, <A
HREF="http://www.claws-mail.org/faq/"
TARGET="_top"
>&#13;	http://www.claws-mail.org/faq/</A
>
    </P
></DIV
></DIV
><DIV
CLASS="appendix"
><HR><H1
CLASS="appendix"
><A
NAME="ap_keyboard"
>B. Default keyboard shortcuts</A
></H1
><DIV
CLASS="section"
><H2
CLASS="section"
><A
NAME="keyb_general"
>B.1. Motivations and general conventions</A
></H2
><P
>&#13;	Although Claws Mail is a graphical application and can mainly be 
	commanded with your mouse, it also requires the frequent use of the 
	keyboard. Composing a mail is the most common of the tasks that 
	require the use of the keyboard. For people who write a lot of mails, 
	having to move hands from keyboard to mouse greatly reduces 
	productivity, so Claws Mail provides keyboard shortcuts to allow 
	faster operation.
    </P
><P
>&#13;	This not only benefits power users by providing keyboard alternatives 
	and keyboard navigation, it also enables people with disabilities, 
	(who may not be able to properly control a pointing device), to use 
	Claws Mail.
    </P
><P
>&#13;	The most general convention is the <CODE
CLASS="option"
>Escape</CODE
> key. Focused 
	dialogues or windows can be closed by hitting the <CODE
CLASS="option"
>Esc</CODE
> 
	key.
    </P
><P
>&#13;	There are other key combinations which are assigned by default to menu 
	items. We won't list these here, as they are already shown on the 
	righthand side of the menus themselves, so you can easily learn them 
	with usage. Furthermore, if you don't like them, these shortcuts can be 
	changed on the fly by focusing on the menu item and pressing the 
	desired key combination.
    </P
><P
>&#13;	In addition to these shortcuts there are others which vary from window 
	to window, which are summarised in the following sections.
    </P
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="keyb_mail"
>B.2. Main window</A
></H2
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN1053"
></A
><TABLE
BORDER="1"
FRAME="hsides"
CLASS="CALSTABLE"
><COL
WIDTH="1*"><COL
WIDTH="4*"><THEAD
><TR
><TH
>Shortcut</TH
><TH
>&nbsp;</TH
></TR
></THEAD
><TBODY
><TR
><TD
><CODE
CLASS="option"
>Ctrl+p</CODE
></TD
><TD
>Print...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+w</CODE
></TD
><TD
>Work offline</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+Shift+s</CODE
></TD
><TD
>Synchronise folders</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+s</CODE
></TD
><TD
>Save as...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+q</CODE
></TD
><TD
>Exit</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+c</CODE
></TD
><TD
>Copy</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+a</CODE
></TD
><TD
>Select all</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+f</CODE
></TD
><TD
>Find in current message...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+f</CODE
></TD
><TD
>Search folder...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+t</CODE
></TD
><TD
>Toggle threaded display</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>n</CODE
></TD
><TD
>Go to next mail in Message List. The <CODE
CLASS="option"
>Down</CODE
> arrow does the same.</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>p</CODE
></TD
><TD
>Go to previous mail. The <CODE
CLASS="option"
>Up</CODE
> arrow is a synonym.</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+n</CODE
></TD
><TD
>Go to next unread mail.</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+p</CODE
></TD
><TD
>Go to previous unread mail.</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>g</CODE
></TD
><TD
>Go to other folder...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+u</CODE
></TD
><TD
>Show message source</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+h</CODE
></TD
><TD
>Show all message headers</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>v</CODE
></TD
><TD
>Toggles the message view panel visibility. When invisible, Message List expands itself to fill the full window height and more summary lines are displayed.</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>/</CODE
></TD
><TD
>Positions the cursor on the Quicksearch field, also opening the Quicksearch panel if needed.</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+Alt+u</CODE
></TD
><TD
>Update summary</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+i</CODE
></TD
><TD
>Get mail from current account</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+i</CODE
></TD
><TD
>Get mail from all accounts</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+m</CODE
></TD
><TD
>Compose a new message</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+r</CODE
></TD
><TD
>Reply</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+r</CODE
></TD
><TD
>Reply to all</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+l</CODE
></TD
><TD
>Reply to mailing list</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+Alt+f</CODE
></TD
><TD
>Forward message</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+o</CODE
></TD
><TD
>Move...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+o</CODE
></TD
><TD
>Copy...</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+d</CODE
></TD
><TD
>Move to trash</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+d</CODE
></TD
><TD
>Empty all Trash folders</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+*</CODE
></TD
><TD
>Mark message</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>u</CODE
></TD
><TD
>Unmark message</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+!</CODE
></TD
><TD
>Mark message as unread</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+a</CODE
></TD
><TD
>Open address book</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>x</CODE
></TD
><TD
>Execute</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+l</CODE
></TD
><TD
>Open log window</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><DIV
CLASS="section"
><HR><H2
CLASS="section"
><A
NAME="keyb_compose"
>B.3. Compose window</A
></H2
><DIV
CLASS="informaltable"
><P
></P
><A
NAME="AEN1214"
></A
><TABLE
BORDER="1"
FRAME="hsides"
CLASS="CALSTABLE"
><COL
WIDTH="1*"><COL
WIDTH="4*"><THEAD
><TR
><TH
>Shortcut</TH
><TH
>&nbsp;</TH
></TR
></THEAD
><TBODY
><TR
><TD
><CODE
CLASS="option"
>Ctrl+Return</CODE
></TD
><TD
>Send</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+s</CODE
></TD
><TD
>Send later</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+m</CODE
></TD
><TD
>Attach file</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+i</CODE
></TD
><TD
>Insert file</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+g</CODE
></TD
><TD
>Insert signature</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+s</CODE
></TD
><TD
>Save</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+w</CODE
></TD
><TD
>Close</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+z</CODE
></TD
><TD
>Undo</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+y</CODE
></TD
><TD
>Redo</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+x</CODE
></TD
><TD
>Cut</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+c</CODE
></TD
><TD
>Copy</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+v</CODE
></TD
><TD
>Paste</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+a</CODE
></TD
><TD
>Select all</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+b</CODE
></TD
><TD
>Move a character backward</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+f</CODE
></TD
><TD
>Move a character forward</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+e</CODE
></TD
><TD
>Move to end of line</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+p</CODE
></TD
><TD
>Move a previous line</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+n</CODE
></TD
><TD
>Move a next line</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+h</CODE
></TD
><TD
>Delete a character backward</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+d</CODE
></TD
><TD
>Delete a character forward</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+u</CODE
></TD
><TD
>Delete line</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+k</CODE
></TD
><TD
>Delete to end of line</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+l</CODE
></TD
><TD
>Wrap current paragraph</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Ctrl+Alt+l</CODE
></TD
><TD
>Wrap all long lines</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+l</CODE
></TD
><TD
>Toggle auto wrapping</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+x</CODE
></TD
><TD
>Edit with external editor</TD
></TR
><TR
><TD
><CODE
CLASS="option"
>Shift+Ctrl+a</CODE
></TD
><TD
>Open address book</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="appendix"
><HR><H1
CLASS="appendix"
><A
NAME="ap_ack"
>C. Acknowledgements</A
></H1
><P
>&#13;	The Claws Mail manual was written by:
    </P
><P
></P
><UL
><LI
><P
>&#13;	<A
HREF="mailto:colin@colino.net"
TARGET="_top"
>Colin Leroy</A
>
    </P
></LI
><LI
><P
>&#13;	<A
HREF="mailto:paul@claws-mail.org"
TARGET="_top"
>Paul Mangan</A
>
    </P
></LI
><LI
><P
>&#13;	<A
HREF="mailto:ricardo@mones.org"
TARGET="_top"
>Ricardo Mones</A
>
    </P
></LI
><LI
><P
>&#13;	<A
HREF="mailto:wwp@claws-mail.org"
TARGET="_top"
>Tristan Chabredier</A
>
    </P
></LI
></UL
><P
>&#13;	Thanks to:
    </P
><P
></P
><UL
><LI
><P
>&#13;    	Hiroyuki Yamamoto for starting Sylpheed, and all past and current 
	contributors.
    </P
></LI
><LI
><P
>&#13;    	Caroline, Clo and Silvia for their tolerance wrt long hacking sessions!
    </P
></LI
><LI
><P
>&#13;	Norman Walsh, for his invaluable technical help and assistance with the
	PDF version of this manual
    </P
></LI
><LI
><P
>&#13;    	...
    </P
></LI
></UL
></DIV
><DIV
CLASS="appendix"
><HR><H1
CLASS="appendix"
><A
NAME="ap_glossary"
>D. Glossary</A
></H1
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>A</B
></P
><DL
><DT
><A
NAME="gt_account"
></A
>Account</DT
><DD
><P
>&#13;	An account represents an identity within Claws Mail. As such only 
	one email address is associated with each account. However, the number 
	of accounts you can setup is unlimited.
      </P
></DD
><DT
><A
NAME="gt_action_rules"
></A
>Action (filtering/processing rules)</DT
><DD
><P
>&#13;	An action is something that is performed on a message when it matches 
	the rule conditions. A typical action is moving the message to a 
	particular folder.  See also <A
HREF="#gt_condition_rules"
><I
CLASS="term"
>&#13;	Condition (filtering/processing rules)
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_actions"
></A
>Actions</DT
><DD
><P
>&#13;	Actions are user-defined commands that can be applied to a message, or 
	part of a message, using a special syntax. They are presented to the 
	user in a customisable menu.
      </P
></DD
><DT
><A
NAME="gt_addressbook"
></A
>Address book</DT
><DD
><P
>&#13;	Storage for names, mail addresses and custom user attributes. Also 
	provides access to <A
HREF="#gt_ldap"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>LDAP</ACRONYM
>
    </I
></A
> servers and <A
HREF="#gt_vcard"
><I
CLASS="term"
>&#13;	vCard
    </I
></A
> files.
      </P
></DD
><DT
><A
NAME="gt_ascii"
></A
><ACRONYM
CLASS="acronym"
>ASCII</ACRONYM
></DT
><DD
><P
>&#13;	American Standard Code for Information Interchange. A standard <A
HREF="#gt_character_encoding"
><I
CLASS="term"
>&#13;	Character encoding
    </I
></A
> using 7 bit. It's defined as an 
	Internet standard in <A
HREF="http://www.ietf.org/rfc/rfc20.txt"
TARGET="_top"
>RFC 20</A
>.
      </P
></DD
><DT
><A
NAME="gt_attachment"
></A
>Attachment</DT
><DD
><P
>&#13;	Additional file(s) included with a mail message. Some attachments can 
	be displayed by Claws Mail, others require external programs. 
	<A
HREF="#gt_plugins"
><I
CLASS="term"
>&#13;	Plugins
    </I
></A
> can provide additional functions for 
	attachments.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>C</B
></P
><DL
><DT
><A
NAME="gt_character_encoding"
></A
>Character encoding</DT
><DD
><P
>&#13;	A map between written symbols, like letters and other symbols, and the 
	numbers used to represent them inside the computer. The most well-known
	character encoding is probably <A
HREF="#gt_ascii"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>ASCII</ACRONYM
>
    </I
></A
>, but it has 
	been superseded by others, such as <A
HREF="#gt_utf8"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>UTF-8</ACRONYM
>    
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_compose"
></A
>Compose</DT
><DD
><P
>&#13;	Create new a message text or a reply to a received mail in the Compose
	window.
      </P
></DD
><DT
><A
NAME="gt_condition_rules"
></A
>Condition (filtering/processing rules)</DT
><DD
><P
>&#13;	The prerequisites that a mail message must fulfil in order for the 
	rule's action to be executed. See also <A
HREF="#gt_action_rules"
><I
CLASS="term"
>&#13;	Action (filtering/processing rules)
    </I
></A
>.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>D</B
></P
><DL
><DT
><A
NAME="gt_digital_signature"
></A
>Digital signature (<ACRONYM
CLASS="acronym"
>GPG</ACRONYM
>)</DT
><DD
><P
>&#13;	A piece of data obtained from merging a message and a cryptographic key
	which ensures message authorship, in a similar way that a hand-written 
	signature does in a document. This piece of data is sent with the m
	essage so the recipient can verify its validity.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>E</B
></P
><DL
><DT
><A
NAME="gt_encryption"
></A
>Encryption (GPG)</DT
><DD
><P
>&#13;	Scrambling a message with a cryptographic key so that only the 
	recipient and ownwer of the key password can unscramble it for reading.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>F</B
></P
><DL
><DT
><A
NAME="gt_face"
></A
>Face</DT
><DD
><P
>&#13;	A more modern implementation of the <A
HREF="#gt_xface"
><I
CLASS="term"
>&#13;	X-Face
    </I
></A
>, it's a
	coloured image (48x48 pixels) included in the message headers.
      </P
></DD
><DT
><A
NAME="gt_filtering_rule"
></A
>Filtering rule</DT
><DD
><P
>&#13;	A <A
HREF="#gt_rule"
><I
CLASS="term"
>&#13;	Rule
    </I
></A
> applied to incoming messages. Filtering 
	rules can be also applied manually to the contents of any folder.
      </P
></DD
><DT
><A
NAME="gt_folder"
></A
>Folder</DT
><DD
><P
>&#13;	A folder is the primary message container. Folders can be local or 
	remote, but they are managed in a uniform way by Claws Mail.
      </P
></DD
><DT
><A
NAME="gt_forward"
></A
>Forward</DT
><DD
><P
>&#13;	To send a copy of a received mail to another recipient, optionally 
	adding your own message.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>H</B
></P
><DL
><DT
><A
NAME="gt_headers"
></A
>Headers</DT
><DD
><P
>&#13;	Machine readable lines which form the first part of a mail message. The
	purpose of headers varies; Typical headers are From and To which state 
	the sender and recipient of the message, others are used by the mail 
	system. Some headers are optional and are used to provide additional 
	information, such as <A
HREF="#gt_xface"
><I
CLASS="term"
>&#13;	X-Face
    </I
></A
> or <A
HREF="#gt_face"
><I
CLASS="term"
>&#13;	Face
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_html"
></A
><ACRONYM
CLASS="acronym"
>HTML</ACRONYM
></DT
><DD
><P
>&#13;	Acronym for Hyper-Text Markup Language. It was the standard language to 
	encode web pages in the beginning of the <A
HREF="#gt_www"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>WWW</ACRONYM
>
    </I
></A
>. 
	Some mail clients use this language to encode the textual body of mails
	in order to craft special effects to text at the cost of multiplying 
	the message size several times. HTML mail is also widely used by 
	spammers to send <A
HREF="#gt_spam"
><I
CLASS="term"
>&#13;	Spam
    </I
></A
>.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>I</B
></P
><DL
><DT
><A
NAME="gt_imap"
></A
><ACRONYM
CLASS="acronym"
>IMAP4</ACRONYM
></DT
><DD
><P
>&#13;	Internet Messaging Access Protocol (version 4). A protocol for 
	accessing email on a remote server from a local client. All messages 
	are stored in the remote server.
      </P
></DD
><DT
><A
NAME="gt_immediate_execution"
></A
>Immediate execution</DT
><DD
><P
>&#13;	When the <SPAN
CLASS="QUOTE"
>"Execute immediately when moving or deleting 
	messages"</SPAN
> option is used, operations 
	performed on messages, (like deletions or movements), are performed 
	immediately. If the option is turned off, all operations performed on 
	messages by the user are only carried out when the 
	<SPAN
CLASS="QUOTE"
>"Execute"</SPAN
> button is pressed.
      </P
></DD
><DT
><A
NAME="gt_isp"
></A
><ACRONYM
CLASS="acronym"
>ISP</ACRONYM
></DT
><DD
><P
>&#13;	Internet Service Provider. A company which provides Internet access to 
	its customers. In the dialup access age these were the big telephony
	companies, with the arrival of broadband access the number of companies 
	and types of services offered has grown exponentially.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>L</B
></P
><DL
><DT
><A
NAME="gt_ldap"
></A
><ACRONYM
CLASS="acronym"
>LDAP</ACRONYM
></DT
><DD
><P
>&#13;	Lightweight Directory Access Protocol. A protocol for accessing 
	information directories such as organisations, individuals, phone 
	numbers, and addresses.
      </P
></DD
><DT
><A
NAME="gt_ldif"
></A
><ACRONYM
CLASS="acronym"
>LDIF</ACRONYM
></DT
><DD
><P
>&#13;	LDAP Data Interchange Format. A text file format widely used for moving
	data between <A
HREF="#gt_ldap"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>LDAP</ACRONYM
>
    </I
></A
> servers and/or other programs.
      </P
></DD
><DT
><A
NAME="gt_local_mbox_file"
></A
>Local mbox file</DT
><DD
><P
>&#13;	A local mailbox spool file in <A
HREF="#gt_mbox"
><I
CLASS="term"
>&#13;	MBox
    </I
></A
> format.      
      </P
></DD
><DT
><A
NAME="gt_log_window"
></A
>Log window</DT
><DD
><P
>&#13;	A special window which records protocol operations in detail that are 
	performed by Claws Mail. It's a useful tool for debugging.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>M</B
></P
><DL
><DT
><A
NAME="gt_mailbox"
></A
>Mailbox</DT
><DD
><P
>&#13;	The root folder of the folder hierarchy.
      </P
></DD
><DT
><A
NAME="gt_maildir"
></A
>Maildir</DT
><DD
><P
>&#13;	A mailbox format in which all mail is kept in separate files. 
	Maildir++ is an extension to the maildir format.
      </P
></DD
><DT
><A
NAME="gt_mailinglist"
></A
>Mailing-List</DT
><DD
><P
>&#13;	Electronic mailing-lists are a special usage of email that allows for 
	widespread distribution of information to many Internet users. They 
	often take the form of discussion lists, like the Claws Mail users'
	list, where a subscriber uses the mailing-list to send messages to all 
	the other subscribers, who may answer in similar fashion.
      </P
></DD
><DT
><A
NAME="gt_mark_message"
></A
>Mark (message)</DT
><DD
><P
>&#13;	An arbitrary indicator that can be set on a message by the user in
	order to draw  attention to the message. Marks are shown in the Mark
	column of the Message List.
      </P
></DD
><DT
><A
NAME="gt_mbox"
></A
>MBox</DT
><DD
><P
>&#13;	A mailbox format in which all mail is concatenated and stored in a 
	single file. The mbox format supported by Claws Mail is 
	<TT
CLASS="literal"
>mboxrd</TT
>.
      </P
></DD
><DT
><A
NAME="gt_message"
></A
>Message</DT
><DD
><P
>&#13;	A message is the basic piece of information handled by Claws Mail. 
	A message is usually an email message, which is stored in <A
HREF="#gt_mh"
><I
CLASS="term"
>&#13;	MH
    </I
></A
> format on disk. Other kinds of messages (and storage
	formats) can be handled through <A
HREF="#gt_plugins"
><I
CLASS="term"
>&#13;	Plugins
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_mh"
></A
>MH</DT
><DD
><P
>&#13;	A mailbox format in which all mail is kept in separate files. This is 
	the default mailbox format used by Claws Mail.
      </P
></DD
><DT
><A
NAME="gt_mime"
></A
><ACRONYM
CLASS="acronym"
>MIME</ACRONYM
></DT
><DD
><P
>&#13;	Multipurpose Internet Mail Extensions. Internet standards for 
	representing binary data in <A
HREF="#gt_ascii"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>ASCII</ACRONYM
>
    </I
></A
> text format, 
	<A
HREF="#gt_headers"
><I
CLASS="term"
>&#13;	Headers
    </I
></A
> encoding and <A
HREF="#gt_attachment"
><I
CLASS="term"
>&#13;	Attachment
    </I
></A
>s.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>N</B
></P
><DL
><DT
><A
NAME="gt_nntp"
></A
><ACRONYM
CLASS="acronym"
>NNTP</ACRONYM
></DT
><DD
><P
>&#13;	Network News Transfer Protocol. The protocol used to post, distribute, 
	and retrieve <A
HREF="#gt_usenet"
><I
CLASS="term"
>&#13;	USENET
    </I
></A
> messages, also called news 
	articles or simply news for short.
      </P
></DD
><DT
><A
NAME="gt_newsgroups"
></A
>Newsgroups</DT
><DD
><P
>&#13;	A set of hierarchical partitions of <A
HREF="#gt_usenet"
><I
CLASS="term"
>&#13;	USENET
    </I
></A
> 
	messages on a <A
HREF="#gt_news_server"
><I
CLASS="term"
>&#13;	News server    
    </I
></A
>. The <A
HREF="#gt_nntp"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>NNTP</ACRONYM
>
    </I
></A
> protocol allows the user to subscribe to one or 
	more newsgroups. New messages posted to the subscribed groups are 
	automatically downloaded on connection.
      </P
></DD
><DT
><A
NAME="gt_news_server"
></A
>News server</DT
><DD
><P
>&#13;	Server which provides access to <A
HREF="#gt_usenet"
><I
CLASS="term"
>&#13;	USENET
    </I
></A
> messages 
	in <A
HREF="#gt_newsgroups"
><I
CLASS="term"
>&#13;	Newsgroups
    </I
></A
> through the <A
HREF="#gt_nntp"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>NNTP</ACRONYM
>
    </I
></A
> protocol.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>P</B
></P
><DL
><DT
><A
NAME="gt_pdf"
></A
><ACRONYM
CLASS="acronym"
>PDF</ACRONYM
></DT
><DD
><P
>&#13;	Portable Document Format. An open binary file format developed by Adobe
	Systems to allow interchanging of printable documents between different
	platforms. Inherits some features from <A
HREF="#gt_postscript"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>PostScript</ACRONYM
>
    </I
></A
>
	but not being a language made it easier to process, especially on 
	desktop computers.
      </P
></DD
><DT
><A
NAME="gt_pgp_inline"
></A
><ACRONYM
CLASS="acronym"
>PGP</ACRONYM
> Inline</DT
><DD
><P
>&#13;	Digital signing method which includes the signature data in the message
	body. Currently deprecated in favour of <A
HREF="#gt_pgp_mime"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>PGP</ACRONYM
> <ACRONYM
CLASS="acronym"
>MIME</ACRONYM
>
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_pgp_mime"
></A
><ACRONYM
CLASS="acronym"
>PGP</ACRONYM
> <ACRONYM
CLASS="acronym"
>MIME</ACRONYM
></DT
><DD
><P
>&#13;	Digital signing method which includes the signature data as a separate 
	<A
HREF="#gt_mime"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>MIME</ACRONYM
>
    </I
></A
> <A
HREF="#gt_attachment"
><I
CLASS="term"
>&#13;	Attachment
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_plugins"
></A
>Plugins</DT
><DD
><P
>&#13;	External modules which can be loaded and used by Claws Mail to 
	extend its functionality. Technically speaking these modules are
	shared libraries which can register one or several functions to be 
	called by Claws Mail when something 
	<SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>interesting</I
></SPAN
> is being done.
      </P
></DD
><DT
><A
NAME="gt_pop3"
></A
><ACRONYM
CLASS="acronym"
>POP3</ACRONYM
></DT
><DD
><P
>&#13;	Post Office Protocol (version 3). A protocol for retrieving email from 
	a remote server. Messages can be automatically removed from server 
	after downloading.
      </P
></DD
><DT
><A
NAME="gt_postscript"
></A
><ACRONYM
CLASS="acronym"
>PostScript</ACRONYM
></DT
><DD
><P
>&#13;	Page description language primarily used and understood by printing 
	devices to generate its output. Was developed by Adobe Systems and 
	is now a widely used standard in the printing industry. As it's a
	fully featured interpreted language it requires some processing power
	to deal with.
      </P
></DD
><DT
><A
NAME="gt_privacy_gpg"
></A
>Privacy (<ACRONYM
CLASS="acronym"
>GPG</ACRONYM
>)</DT
><DD
><P
>&#13;	Privacy provides methods for both signing and encrypting mail messages 
	you send and also for verifying and decrypting signed and encrypted 
	messages that you receive.
      </P
></DD
><DT
><A
NAME="gt_processing_rule"
></A
>Processing rule</DT
><DD
><P
>&#13;	A <A
HREF="#gt_rule"
><I
CLASS="term"
>&#13;	Rule
    </I
></A
> or set of rules belonging to a folder 
	which are executed on entering the folder.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>Q</B
></P
><DL
><DT
><A
NAME="gt_queue"
></A
>Queue</DT
><DD
><P
>&#13;	Temporary storage for messages which are waiting to be sent, either 
	because they couldn't be sent due a network failure or because the 
	user requested them to be sent later.
      </P
></DD
><DT
><A
NAME="gt_quick_search"
></A
>Quick Search</DT
><DD
><P
>&#13;	A powerful way to search for messages using almost any criteria that 
	you can think of.
      </P
></DD
><DT
><A
NAME="gt_quotation"
></A
>Quotation</DT
><DD
><P
>&#13;	When replying to a message the user will often include a quoted section
	of that message to provide the context. The quoted section is shown by 
	the prepending of a common character, usually <SPAN
CLASS="QUOTE"
>"&#62;"</SPAN
>.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>R</B
></P
><DL
><DT
><A
NAME="gt_recursive_quick_search"
></A
>Recursive (Quick Search)</DT
><DD
><P
>&#13;	A recursive <A
HREF="#gt_quick_search"
><I
CLASS="term"
>&#13;	Quick Search
    </I
></A
> will also search in all 
	subfolders of the selected folder.
      </P
></DD
><DT
><A
NAME="gt_redirect"
></A
>Redirect</DT
><DD
><P
>&#13;	To send a copy of a received mail in its original form to another 
	recipient.
      </P
></DD
><DT
><A
NAME="gt_reply"
></A
>Reply</DT
><DD
><P
>&#13;	Answer to a received message. As verb also the act of answering a 
	message.
      </P
></DD
><DT
><A
NAME="gt_rot13"
></A
>ROT-13</DT
><DD
><P
>&#13;	Simple <SPAN
CLASS="emphasis"
><I
CLASS="emphasis"
>encryption</I
></SPAN
> method used since Romans age,
	which uses an alphabet rotated thirteen positions to encode each
	letter of the message. Used sometimes to hide funny messages on mails.
      </P
></DD
><DT
><A
NAME="gt_rule"
></A
>Rule</DT
><DD
><P
>&#13;	Logical structure comprised of one or more conditions (see <A
HREF="#gt_condition_rules"
><I
CLASS="term"
>&#13;	Condition (filtering/processing rules)
    </I
></A
>) and one or more associated actions 
	(see <A
HREF="#gt_action_rules"
><I
CLASS="term"
>&#13;	Action (filtering/processing rules)
    </I
></A
>). Rules are used for filtering 
	mail messages.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>S</B
></P
><DL
><DT
><A
NAME="gt_smtp"
></A
><ACRONYM
CLASS="acronym"
>SMTP</ACRONYM
></DT
><DD
><P
>&#13;	Simple Mail Transfer Protocol. A protocol for sending email to servers.
      </P
></DD
><DT
><A
NAME="gt_smtp_server"
></A
><ACRONYM
CLASS="acronym"
>SMTP</ACRONYM
> server</DT
><DD
><P
>&#13;	A server which receives mail messages from other hosts and/or sends 
	mail messages to other hosts using the <A
HREF="#gt_smtp"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>SMTP</ACRONYM
>
    </I
></A
> 
	protocol.
      </P
></DD
><DT
><A
NAME="gt_source_message"
></A
>Source (message)</DT
><DD
><P
>&#13;	The full text of a message as it is transmitted over the network. This 
	includes all headers, message body and encoded attachments if present.
      </P
></DD
><DT
><A
NAME="gt_spam"
></A
>Spam</DT
><DD
><P
>&#13;	Junk mail, unsolicited commercial emails.
      </P
></DD
><DT
><A
NAME="gt_spell_checking"
></A
>Spell checking</DT
><DD
><P
>&#13;	Automatic verification of spelling while typing or after composition 
	has finished.
      </P
></DD
><DT
><A
NAME="gt_ssl"
></A
><ACRONYM
CLASS="acronym"
>SSL</ACRONYM
></DT
><DD
><P
>&#13;	Secure Sockets Layer. A protocol used to encrypt and protect data sent 
	over a network.
      </P
></DD
><DT
><A
NAME="gt_ssl_certificate"
></A
><ACRONYM
CLASS="acronym"
>SSL</ACRONYM
> certificate</DT
><DD
><P
>&#13;	A certificate installed on a secure server that is used for 
	identification.
      </P
></DD
><DT
><A
NAME="gt_starttls"
></A
>STARTTLS</DT
><DD
><P
>&#13;	STARTTLS (Start Transport Layer Security) is a command used to initiate
	a secure connection between two servers using <A
HREF="#gt_ssl"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>SSL</ACRONYM
>
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_sticky_quick_search"
></A
>Sticky (Quick Search)</DT
><DD
><P
>&#13;	When the sticky option is set on <A
HREF="#gt_quick_search"
><I
CLASS="term"
>&#13;	Quick Search
    </I
></A
> the
	search terms are not cleared when changing folders.
      </P
></DD
><DT
><A
NAME="gt_synchronisation"
></A
>Synchronisation (folder)</DT
><DD
><P
>&#13;	Making the contents of a local folder mirror those of an equivalent 
	remote folder in the associated mail server.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>T</B
></P
><DL
><DT
><A
NAME="gt_tcp"
></A
><ACRONYM
CLASS="acronym"
>TCP</ACRONYM
></DT
><DD
><P
>&#13;	Transmission Control Protocol. The main protocol used in the Internet.
	Allows media-independent reliable connections between two endpoints 
	and is supported by all modern Operating Systems in use.
      </P
></DD
><DT
><A
NAME="gt_themes"
></A
>Themes</DT
><DD
><P
>&#13;	Image sets for changing the appearance of buttons, folders and other 
	graphical elements of Claws Mail.
      </P
></DD
><DT
><A
NAME="gt_thread"
></A
>Thread (messages)</DT
><DD
><P
>&#13;	A set of messages loosely relating to each other. 
      </P
></DD
><DT
><A
NAME="gt_toolbars"
></A
>Toolbars</DT
><DD
><P
>&#13;	Sets of buttons arranged horizontally which provide access to all 
	commonly used functions. Toolbars in Claws Mail can be customised.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>U</B
></P
><DL
><DT
><A
NAME="gt_uidl"
></A
><ACRONYM
CLASS="acronym"
>UIDL</ACRONYM
></DT
><DD
><P
>&#13;	Unique IDentification Listing. A <A
HREF="#gt_pop3"
><I
CLASS="term"
>&#13;	<ACRONYM
CLASS="acronym"
>POP3</ACRONYM
>
    </I
></A
> command
	which allows single message handling by asigning a unique identifier 
	for each message. 
      </P
></DD
><DT
><A
NAME="gt_url"
></A
>URL</DT
><DD
><P
>&#13;	Uniform Resource Locator. A naming scheme for objects (usually files) 
	in a multi-protocol networked environment like current Internet.
	For example, this is the one of the Claws Mail home page: 
	<TT
CLASS="literal"
>http://www.claws-mail.org</TT
>.
      </P
></DD
><DT
><A
NAME="gt_usenet"
></A
>USENET</DT
><DD
><P
>&#13;	User's Network. A bulletin board system of discussion groups, often 
	called <A
HREF="#gt_newsgroups"
><I
CLASS="term"
>&#13;	Newsgroups
    </I
></A
>.
      </P
></DD
><DT
><A
NAME="gt_utf8"
></A
><ACRONYM
CLASS="acronym"
>UTF-8</ACRONYM
></DT
><DD
><P
>&#13;	8-bit Unicode Transformation Format. A variable length character 
	encoding capable of representing any universal character. An Internet 
	standard defined in <A
HREF="http://www.ietf.org/rfc/rfc3629.txt"
TARGET="_top"
>RFC 3629</A
>.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>V</B
></P
><DL
><DT
><A
NAME="gt_vcard"
></A
>vCard</DT
><DD
><P
>&#13;	File format standard for Personal Data Interchange, it can hold 
	information such as address, phone numbers, etc., much like the 
	information usually found in a business card. They are commonly found 
	attached to mail messages.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>W</B
></P
><DL
><DT
><A
NAME="gt_wrapping"
></A
>Wrapping</DT
><DD
><P
>&#13;	Restructuring of the message text based on a user-defined maximum 
	number of characters per line. Wrapping ensures that paragraphs are 
	justified, which means that they are aligned to the left and right 
	margins.
      </P
></DD
><DT
><A
NAME="gt_www"
></A
><ACRONYM
CLASS="acronym"
>WWW</ACRONYM
></DT
><DD
><P
>&#13;	World Wide Web, the hyperlinked network of web pages across the 
	Internet.
      </P
></DD
></DL
></DIV
><P
></P
><DIV
CLASS="variablelist"
><P
><B
>X</B
></P
><DL
><DT
><A
NAME="gt_xface"
></A
>X-Face</DT
><DD
><P
>&#13;	Specially coded black and white image (48x48 pixels) included in the 
	message headers. Capable mailers like Claws Mail and others can 
	decode and show it alongside the message text. Although they are not 
	unique, they can help to quickly identify the message sender. See also 
	<A
HREF="#gt_face"
><I
CLASS="term"
>&#13;	Face
    </I
></A
>.
      </P
></DD
></DL
></DIV
></DIV
><DIV
CLASS="appendix"
><HR><H1
CLASS="appendix"
><A
NAME="ap_gpl"
>E. Gnu General Public License</A
></H1
><P
>See <A
HREF="http://www.gnu.org/licenses/gpl.html"
TARGET="_top"
>http://www.gnu.org/licenses/gpl.html</A
>.
</P
></DIV
></DIV
><H3
CLASS="FOOTNOTES"
>Notes</H3
><TABLE
BORDER="0"
CLASS="FOOTNOTES"
WIDTH="100%"
><TR
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="5%"
><A
NAME="FTN.AEN984"
HREF="#AEN984"
><SPAN
CLASS="footnote"
>[1]</SPAN
></A
></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
WIDTH="95%"
><P
>Other shells may have 
	diferent syntaxes, check your shell's manual page.</P
></TD
></TR
></TABLE
></BODY
></HTML
>
claws-mail-doc 3.8.0-1ubuntu1 / usr / share / doc / claws-mail / en / claws-mail-manual.html
