such as editing a raw mail in your text editor,
<emphasis>hide</emphasis> what you mean using ROT-13, apply patches
contained in emails directly, and so on. The only limit is your
- imagination. You can configure Actions via the <quote>Tools</quote>
- menu.
+ imagination. You can create and configure Actions via the
+ <quote>/Configuration/Actions...</quote> menu.
+ </para>
+ <para>
+ The <quote>Tools/Actions/</quote> 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.
+ </para>
+ <para>
+ Additionally, it is possible to add toolbar entries for your
+ actions. To do so, open the <quote>Configuration/Preferences</quote>
+ menu and select <quote>Toolbars/Main Window</quote>.
+ Select <quote>User Action</quote> in the <quote>Item type</quote>
+ dropdown menu, then select the Action in the <quote>Event executed on click</quote>
+ dropdown menu, and click the <quote>Icon</quote> button to select the
+ icon that you want to use.
</para>
<blockquote>
<example>
<title>Processing</title>
<para>
Processing rules are the same as Filtering rules, except that they are
- applied when entering a folder and apply only to this folder. You can
- use them to automatically move old mails into an archive folder, or for
- further dispatching of emails, and more. You can set each folder's
- Processing rules by right-clicking on it.
+ 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.
</para><para>
Processing rules are accompanied by Pre-processing and Post-processing
- rules. Like Processing rules, they apply only when opening a folder,
- but like Filtering rules, they are shared accross all folders. You can
- configure them from the <quote>Tools</quote> menu. Pre-processing rules
- are executed before the folder's specific Processing rules, while
- Post-processing rules are executed afterwards.
+ 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
+ <quote>Tools</quote> menu. Pre-processing rules are executed before the
+ folder's specific Processing rules, while Post-processing rules are executed
+ afterwards.
</para>
</section>
<section id="adv_colour_labels">
<quote>Configuration/Preferences/Display/Colors</quote> page.
</para>
</section>
+ <section id="adv_tags">
+ <title>Tags</title>
+ <para>
+ Tags are short text notes which may be set on messages. They are useful
+ for classifying messages with your own words. These tags can be used
+ later to find the mails with Quick Search or to manage them with
+ filtering or processing rules, for example.
+ </para><para>
+ Tagged messages are displayed with a yellow background at the top of
+ the Message View. This line shows all tags associated with the
+ message. You can enable the "Tags" column in the Message List, so
+ tagged items can be seen without having to open the message.
+ </para><para>
+ Setting of tags is done by right-clicking on the message in the Message
+ List or by the corresponding option in Message menu. A panel with the
+ existing tags is shown and you can select some of them or just add a
+ new one. Removal of existing tags is also allowed, of course.
+ </para><para>
+ Once tags exist it's even easier, as the context menu allows you to
+ set and unset tags with just one click to the selected messages.
+ Mixed selections of tagged and untagged messages are allowed, and
+ Claws Mail is clever enough to do what you want to do in any case.
+ </para>
+ </section>
<section id="adv_ml_support">
<title>Mailing-List support</title>
<para>
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
- <filename>~/.claws-mail/sylpheedrc</filename>.
+ <filename>~/.claws-mail/clawsrc</filename>.
+ </para>
+ <para>
+ There's a small tool written in Perl-GTK called Clawsker which
+ provides a user-friendly GUI for tweaking these settings instead of
+ direct editing of <filename>clawsrc</filename>. You can read more
+ about it on the <ulink
+ url="http://www.claws-mail.org/clawsker.php">Clawsker page</ulink>.
</para>
<variablelist>
+ <varlistentry>
+ <term><literal>address_search_wildcard</literal></term>
+ <listitem>
+ <para>
+ TAB-address completion in the Compose window and other GUI places will
+ match any part of the string ('1') or just the start of the string ('0').
+ Default value is '1'.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>addressbook_use_editaddress_dialog</literal></term>
+ <listitem>
+ <para>
+ Use a separate dialogue to edit a person's details if set to '1'
+ (default). '0' will use a form embedded in the addressbook's main
+ window.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry>
<term><literal>bold_unread</literal></term>
<listitem>
<para>
- Show unread messages in the Message List using a bold font.
+ Show unread messages in the message list of summary view using a
+ bold font when set to '1' (default). '0' will use normal font.
</para>
</listitem>
</varlistentry>
<term><literal>cache_max_mem_usage</literal></term>
<listitem>
<para>
- The maximum amount of memory to use to cache messages, in kB.
+ The maximum amount of memory to use to cache messages, in kB. It will
+ try to keep the memory usage below this value, but it will always use
+ the assigned amount of memory for speed gain. Default value is '4096'.
</para>
</listitem>
</varlistentry>
<term><literal>cache_min_keep_time</literal></term>
<listitem>
<para>
- 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.
+ The minimum time in minutes to keep a folder cache in memory. Caches
+ more recent than this time will not be freed, even if the memory usage
+ is too high. You should probably set this value higher than your
+ mail check interval. Otherwise the cache will always be freed between
+ checks even if the folder is accessed on every check, which will cause
+ much disk I/O. Default value is '15'.
</para>
</listitem>
</varlistentry>
<term><literal>compose_no_markup</literal></term>
<listitem>
<para>
- Don't use bold and italic text in Compose dialogue's account selector.
+ Don't use bold and italic text in Compose dialogue's account selector
+ if set to '1'. Default value is '0' (use markup).
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>enable_dotted_lines</literal></term>
+ <term><literal>diff_added_color</literal></term>
+ <term><literal>diff_deleted_color</literal></term>
+ <term><literal>diff_hunk_color</literal></term>
<listitem>
<para>
- Use the <emphasis>old</emphasis> dotted line look in the main window
- GtkTreeView components, (Folder List and Message List), instead of the
- <emphasis>modern</emphasis> lineless look.
+ Colors to use when displaying attachments in unified diff format.
+ Default values are '#008b8b' (dark cyan), '#6a5acd' (slate blue) and
+ '#a52a2a' (red brown).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>emphasis_color</literal></term>
+ <listitem>
+ <para>
+ The colour used for the X-Mailer line in Message View when its value
+ is Claws Mail. Default value is '#0000CF' (medium blue).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>enable_avatars</literal></term>
+ <listitem>
+ <para>
+ Enables capture and/or rendering of internal avatars (Face and
+ also X-Face headers if built with compface support).
+ '0' disables both, '1' enables capture only, '2' enables rendering
+ only and '3' enables both. Default value is '3'.
+ </para>
+ <para>
+ Note that external plugins already providing these features may
+ disable partially or completely this to speed up process,
+ regardless of the configured value.
</para>
</listitem>
</varlistentry>
<term><literal>enable_hscrollbar</literal></term>
<listitem>
<para>
- Enable the horizontal scrollbar in the Message List.
+ Enable the horizontal scrollbar in the message list of Summary View
+ if set to '1' (default). Set it to '0' to disable.
</para>
</listitem>
</varlistentry>
<term><literal>enable_swap_from</literal></term>
<listitem>
<para>
- Display the sender's email address in the To column of the
- Sent folder instead of the recipient's.
+ Display the sender's email address in the To column of the
+ Sent folder instead of the recipient's when set to '1'.
+ Default value is '0'.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>folder_search_wildcard</literal></term>
+ <listitem>
+ <para>
+ The type-ahead function in the Select Folder window will match any
+ part of the folder name ('1') or just the start of the folder
+ name ('0'). Default value is '1'.
</para>
</listitem>
</varlistentry>
<term><literal>folderview_vscrollbar_policy</literal></term>
<listitem>
<para>
- Specify the policy of vertical scrollbar of Folder List.
- '0' is always shown, '1' is automatic, '2' is always hidden.
+ Specify the policy of vertical scrollbar of Folder List:
+ '0' is always shown, '1' is automatic and '2' is always hidden.
+ Default value is '0'.
</para>
</listitem>
</varlistentry>
<term><literal>hover_timeout</literal></term>
<listitem>
<para>
- Time in milliseconds that will cause a folder tree to expand
- when the mouse cursor is held over it during drag 'n' drop.
+ Time in milliseconds that will cause a folder tree to expand
+ when the mouse cursor is held over it during drag 'n' drop.
+ Default value is '500'.
</para>
</listitem>
</varlistentry>
<term><literal>live_dangerously</literal></term>
<listitem>
<para>
- Don't ask for confirmation before definitive deletion of emails.
+ Don't ask for confirmation before definitive deletion of emails when
+ set to '1'. Default value is '0'.
</para>
</listitem>
</varlistentry>
<term><literal>log_msg_color</literal></term>
<term><literal>log_out_color</literal></term>
<term><literal>log_warn_color</literal></term>
+ <term><literal>log_status_ok_color</literal></term>
+ <term><literal>log_status_nok_color</literal></term>
+ <term><literal>log_status_skip_color</literal></term>
+ <listitem>
+ <para>
+ The colours used in the log window. Default values are: '#af0000'
+ (dark red), '#000000' (black), '#00af00' (dark lime green),
+ '#0000ef' (blue), '#af0000' (dark red), '#00af00' (dark lime green),
+ '#0000af' (dark blue) and '#aa00aa' (dark magenta).
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>msgview_date_format</literal></term>
<listitem>
<para>
- The colours used in the log window.
+ '0' or '1'. Use the same user-defined date format in the Message
+ View as is used in the Message List. Default is '0', turned off.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>outgoing_fallback_to_ascii</literal></term>
+ <listitem>
+ <para>
+ '0' or '1'. The outgoing encoding of a message will use 7bit US-ASCII
+ whenever it is suitable for the message content, ignoring the
+ <quote>Outgoing encoding</quote> option unless it is necessary. Turning
+ this option off forces the user-defined encoding to be used, regardless
+ of message content. Default is '1', turned on.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>mark_as_read_delay</literal></term>
+ <term><literal>primary_paste_unselects</literal></term>
<listitem>
<para>
- Number of seconds to wait before marking an opened mail as read.
+ '0' or '1'. Causes the primary buffer to be cleared and the insertion
+ point to be repositioned when the middle mouse button is used
+ for pasting text. Default is '0', turned off.
</para>
</listitem>
</varlistentry>
<term><literal>respect_flowed_format</literal></term>
<listitem>
<para>
- 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.
+ '0' or '1'. Respect <literal>format=flowed</literal> on
+ <literal>text/plain</literal> 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.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>save_parts_readwrite</literal></term>
+ <listitem>
+ <para>
+ If set to '1' saves temporary files when opening attachments with
+ write bit set. Default value is '0', temporary files are read only.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>show_compose_margin</literal></term>
+ <listitem>
+ <para>
+ '0' or '1'. Adds margins to the message text area in the Compose window.
+ Default is '0', turned off.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>show_inline_attachments</literal></term>
+ <listitem>
+ <para>
+ '0' or '1'. Show inline attachments in MimeView.
+ Default is '1', turned on.
</para>
</listitem>
</varlistentry>
<term><literal>skip_ssl_cert_check</literal></term>
<listitem>
<para>
- Disables the verification of SSL certificates.
+ Disables the verification of SSL certificates when set to '1'.
+ Default value is '0'.
</para>
</listitem>
</varlistentry>
<term><literal>statusbar_update_step</literal></term>
<listitem>
<para>
- Update stepping in progress bars.
+ Update stepping in progress bars. Default value is '10'.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>stripes_color_offset</literal></term>
<listitem>
- <para>
- 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.
- </para>
+ <para>
+ Specify the value to use when creating alternately coloured lines in
+ <literal>GtkTreeView</literal> components. The smaller the value, the
+ less visible the difference in the alternating colours of the lines.
+ Default value is '4000'.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>summary_from_show</literal></term>
+ <listitem>
+ <para>
+ Controls the data displayed in the From column in the Message List.
+ Default value '0' displays name, '1' displays address and '2' displays
+ both name and address.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>textview_cursor_visible</literal></term>
<listitem>
<para>
- Display the cursor in the message view.
+ Display the cursor in the message view when set to '1'.
+ Default value is '0'.
</para>
</listitem>
</varlistentry>
<term><literal>thread_by_subject_max_age</literal></term>
<listitem>
<para>
- Number of days to include a message in a thread when using
- <quote>Thread using subject in addition to standard headers</quote>.
+ Number of days to include a message in a thread when using
+ <quote>Thread using subject in addition to standard headers</quote>.
+ Default value is '10'.
</para>
</listitem>
</varlistentry>
<term><literal>toolbar_detachable</literal></term>
<listitem>
<para>
- Show handles in the toolbars.
+ Show handles in the toolbars when set to '1'. Default value is '0'.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>type_any_header</literal></term>
+ <listitem>
+ <para>
+ Allows to type any header on the compose window header entries
+ when set to '1'. By default ('0') only the entries available
+ from the combobox can be selected.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>two_line_vertical</literal></term>
+ <listitem>
+ <para>
+ Spread message list information over two lines when using the
+ three column layout when set to '1' (default). Set it to '0'
+ to use only one line.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>unsafe_ssl_certs</literal></term>
+ <listitem>
+ <para>
+ Allows Claws Mail to remember multiple SSL certificates for a given
+ server/port when set to '1'. This is disabled by default ('0').
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>use_networkmanager</literal></term>
+ <listitem>
+ <para>
+ Use NetworkManager to switch offline automatically. This is enabled
+ by default ('1'). Set it to '0' to ignore NetworkManager.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>use_stripes_everywhere</literal></term>
<listitem>
- <para>
- Enable alternately coloured lines in GtkTreeView components.
- </para>
+ <para>
+ Enable alternately coloured lines in <literal>GtkTreeView</literal>
+ components when set to '1' (default). Set it to '0' to disable them.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>use_stripes_in_summaries</literal></term>
<listitem>
- <para>
- 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.
- </para>
+ <para>
+ Enable alternately coloured lines in the main window
+ <literal>GtkTreeView</literal> components, (Folder List and Message
+ List). The only useful way to use this option is to set it to '0'
+ when <literal>use_stripes_everywhere</literal> is set to '1'.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term><literal>utf8_instead_of_locale_for_broken_mail</literal></term>
<listitem>
<para>
- Use UTF-8 encoding for broken mails instead of current locale.
+ Use UTF-8 encoding for broken mails instead of current locale when
+ set to '1'. Default value is '0'.
</para>
</listitem>
</varlistentry>
<term><literal>warn_dnd</literal></term>
<listitem>
<para>
- Display a confirmation dialogue on drag 'n' drop of folders.
+ Display a confirmation dialogue on drag 'n' drop of folders when set
+ to '1' (default). Set to '0' to bypass this confirmation.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>zero_replacement_char</literal></term>
+ <listitem>
+ <para>
+ Character to show in Folder List counter columns when a folder contains
+ no messages. Default value is '0'.
</para>
</listitem>
</varlistentry>
</variablelist>
</section>
+ <section id="adv_autofaces">
+ <title>Autofaces</title>
+ <para>
+ Claws Mail allows setting the Face and X-Face headers directly
+ from files, either globally for all defined accounts
+ or on a per-account basis. These files must be placed in the
+ <filename>~/.claws-mail/autofaces/</filename> directory.
+ </para>
+ <para>
+ If they exist, the global Face and/or X-Face headers for all
+ accounts are taken from the <filename>face</filename> and/or
+ <filename>xface</filename> files respectively. In a similar
+ manner, Face and/or X-Face headers for a specific account can
+ be provided by <filename>face.</filename><emphasis>accountname</emphasis>
+ and/or <filename>xface.</filename><emphasis>accountname</emphasis>,
+ where <emphasis>accountname</emphasis> is the name of the account you
+ want this header to be associated with.
+ </para>
+ <para>
+ If the name of the account contains characters which may be unsuitable
+ for the underlying filesystem (including spaces) these are replaced by
+ underscores (<quote>_</quote>) when searching for the autofaces of
+ that account. For example, if your account is called
+ <quote><My Mail></quote>, the name for the X-Face filename for
+ that account would be
+ <filename>~/.claws-mail/autofaces/xface._My_Mail_</filename>.
+ Be aware that this feature doesn't check the content of the files,
+ or for duplication of headers, (most mailers, including Claws
+ Mail, will ignore duplicates and display the last one only).
+ </para>
+ </section>
</section>