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>
<para>
Searches Google for the currently selected text
(<emphasis>|</emphasis>) using the external script <emphasis><ulink
- url="http://www.sylpheed-claws.net/tools.php"
+ url="http://www.claws-mail.org/tools.php"
>google_search.pl</ulink></emphasis>.
</para>
</listitem>
Bcc and Subject fields follow.
</para><para>
Further information and examples of usage can be found in the
- user-contributed FAQ on the
Sylpheed-Claws website <ulink
- url="http://www.sylpheed-claws.net/faq/"
- >http://www.sylpheed-claws.net/faq/</ulink>.
+ user-contributed FAQ on the
Claws Mail website <ulink
+ url="http://www.claws-mail.org/faq/"
+ >http://www.claws-mail.org/faq/</ulink>.
</para>
</section>
<section id="adv_processing">
<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>
- Sylpheed-Claws offers mailing-list support from the
+ Claws Mail offers mailing-list support from the
<quote>Message/Mailing-List/</quote> submenu. When you have a
mailing-list message selected, the submenu allows you to quickly
initiate subscribing, unsubscribing, posting, getting help, contacting
<section id="adv_plugins">
<title>Plugins</title>
<para>
- Plugins are the mechanism for extending Sylpheed-Claws' capabilities.
+ Plugins are the mechanism for extending Claws Mail' capabilities.
For example, imagine that you want to store your mails in a remote
<acronym>SQL</acronym> database. In most mailers out there this is
simply impossible without reworking the internals of the mailer. With
- Sylpheed-Claws you can simply write a plugin to achieve the task.
+ Claws Mail you can simply write a plugin to achieve the task.
</para><para>
This is just an example of the possibilities. A good number of plugins
- developed for Sylpheed-Claws already exist, and more are to come. The
- <link linkend="ch_plugins">Extending Sylpheed-Claws section</link>
+ developed for Claws Mail already exist, and more are to come. The
+ <link linkend="ch_plugins">Extending Claws Mail section</link>
gives details of them.
</para>
</section>
<section id="deploying">
- <title>Deploying Sylpheed-Claws</title>
+ <title>Deploying Claws Mail</title>
<para>
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 Sylpheed-Claws easily
+ 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.
</para><para>
The first part consists of creating a wizard configuration template
- and setting the various default parameters of a new Sylpheed-Claws
+ and setting the various default parameters of a new Claws Mail
installation.
</para>
<itemizedlist>
<listitem>
<para>
Start with a user who does not have a <filename class="directory"
- >~/.sylpheed-claws</filename> directory, ideally a new user.
+ >~/.claws-mail</filename> directory, ideally a new user.
</para>
</listitem>
<listitem>
<para>
- Start Sylpheed-Claws and go through the wizard. The values you fill in
+ 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.
</para>
</listitem>
<listitem>
<para>
- Once the wizard is finished and you have Sylpheed-Claws' main window
+ 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.
</listitem>
<listitem>
<para>
- If needed, and if the deployed Sylpheed-Claws will use MH folders, you
+ If needed, and if the deployed Claws Mail will use MH folders, you
can create subdirectories in the mailbox.
</para>
</listitem>
<listitem>
<para>
- Next, quit Sylpheed-Claws.
+ Next, quit Claws Mail.
</para>
</listitem>
<listitem>
<para>
Now, edit the newly created wizard template file,
- <filename>~/.sylpheed-claws/accountrc.tmpl</filename>. In this file,
+ <filename>~/.claws-mail/accountrc.tmpl</filename>. 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
<listitem>
<para>
Save this file, and delete both
- <filename>~/.sylpheed-claws/accountrc</filename>, (which contains your
+ <filename>~/.claws-mail/accountrc</filename>, (which contains your
dummy account) and
- <filename>~/.sylpheed-claws/folderlist.xml</filename>, (so that the
+ <filename>~/.claws-mail/folderlist.xml</filename>, (so that the
folder tree will be correctly parsed for new users). Recursively copy
- <filename class="directory">.sylpheed-claws</filename> to
+ <filename class="directory">.claws-mail</filename> to
<filename class="directory">/etc/skel/</filename>; if the deployed
- Sylpheed-Claws will use MH folders, also copy the created
+ Claws Mail will use MH folders, also copy the created
<filename class="directory">Mail</filename> directory. chown all of
- <filename class="directory">/etc/skel/.sylpheed-claws</filename>
+ <filename class="directory">/etc/skel/.claws-mail</filename>
and <filename class="directory">/etc/skel/Mail</filename> to
<literal>root:root</literal> for security reasons.
</para>
</listitem>
<listitem>
<para>
- Test! Create a new user, login as that user, run Sylpheed-Claws. If you
+ 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.
</para>
<section id="adv_hidden">
<title>Hidden preferences</title>
<para>
- There are a number of hidden preferences in Sylpheed-Claws, preferences
+ 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 Sylpheed-Claws is not running, in
- <filename>~/.sylpheed-claws/sylpheedrc</filename>.
+ following, and change them while Claws Mail is not running, in
+ <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>
+ <varlistentry>
+ <term><literal>default_header_color</literal></term>
+ <term><literal>default_header_bgcolor</literal></term>
<listitem>
<para>
- Use the <emphasis>old</emphasis> dotted line look for the Folder List and
- Message List instead of the <emphasis>modern</emphasis> lineless look.
+ Foreground and background colors to use for the Compose window's header
+ entry values. Default values are '#000000' (black) and '#f5f6be' (pale
+ yellow), respectively.
</para>
</listitem>
</varlistentry>
- <varlistentry>
- <term><literal>enable_hscrollbar</literal></term>
+ <varlistentry>
+ <term><literal>diff_added_color</literal></term>
+ <term><literal>diff_deleted_color</literal></term>
+ <term><literal>diff_hunk_color</literal></term>
<listitem>
<para>
- Enable the horizontal scrollbar in the Message List.
+ Colors to use when displaying attachments in unified diff format.
+ Default values are '#008b8b' (dark cyan), '#6a5acd' (slate blue) and
+ '#a52a2a' (red brown) respectively.
</para>
</listitem>
</varlistentry>
<varlistentry>
- <term><literal>use_stripes_everywhere</literal></term>
+ <term><literal>emphasis_color</literal></term>
<listitem>
<para>
- Enable alternately coloured lines in GtkTreeView components.
+ 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>use_stripes_in_summaries</literal></term>
+ <term><literal>enable_avatars</literal></term>
<listitem>
<para>
- Enable alternately coloured lines in main window's GtkTreeView components
- (folder list and messages list). The only useful way to use this option is
- to set it to 0 when use_stripes_everywhere is set to 1.
+ 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>
<varlistentry>
- <term><literal>stripes_color_offset</literal></term>
+ <term><literal>enable_hscrollbar</literal></term>
<listitem>
<para>
- Specify the value to use to create alternate colors in summaries. The
- more little it is, the less the difference will be visible.
+ 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>
+ <varlistentry>
+ <term><literal>hide_timezone</literal></term>
+ <listitem>
+ <para>
+ If enabled ('1') the timezone in date headers is set to the
+ unknown timezone value, as specified in section 3 of the RFC
+ 5322. 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) respectively.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>master_passphrase_pbkdf2_rounds</literal></term>
+ <listitem>
+ <para>
+ Number of rounds (or iterations) to use in PBKDF2 function when
+ computing next master passphrase key derivation. Currently stored master
+ passphrase KD is not affected by changing this preference.
+ Default value is '50000'.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>msgview_date_format</literal></term>
+ <listitem>
+ <para>
+ '0' or '1'. Use the same user-defined date format in the Message
+ View as is used in the Message List. Default is '0', turned off.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>next_on_delete</literal></term>
+ <listitem>
+ <para>
+ '0' or '1'. Controls the message selection after deleting, moving, or
+ trashing a message. Default is '0', select previous message.
+ </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>primary_paste_unselects</literal></term>
+ <listitem>
+ <para>
+ '0' or '1'. Causes the primary buffer to be cleared and the insertion
+ point to be repositioned when the middle mouse button is used
+ for pasting text. Default is '0', turned off.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>qs_active_color</literal></term>
+ <term><literal>qs_active_bgcolor</literal></term>
+ <term><literal>qs_error_color</literal></term>
+ <term><literal>qs_error_bgcolor</literal></term>
+ <listitem>
+ <para>
+ Foreground and background colors to use in the QuickSearch field when
+ the search is active and when there is a syntax error.
+ Default values are '#000000' (black), '#f5f6be' (pale yellow), '#000000'
+ (black), and '#ff7070' (pale red), respectively.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><literal>respect_flowed_format</literal></term>
<listitem>
<para>
- The colours used in the log window.
+ '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>mark_as_read_delay</literal></term>
+ <term><literal>rewrite_first_from</literal></term>
<listitem>
<para>
- Number of seconds to wait before marking an opened mail as read.
+ '0' or '1'. This works around a limitation of some servers with
+ 'overly-liberal parsers'. When this is turned on and the Content-
+ Transfer-Encoding is set to 8bit or 7bit, in a message body starting with
+ 'From ' the 'From ' will become '=46rom ' and the Content-Transfer-Encoding
+ will be changed to Quoted-Printable. When it is turned off no such modification
+ will be made but it is very likely that an MTA will convert the 'From ' to
+ '>From '. See RFC 4155 for further details. Default value is '1', turned on.
+ </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
+ <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>tags_color</literal></term>
+ <term><literal>tags_bgcolor</literal></term>
+ <listitem>
+ <para>
+ Foreground and background colors to use when displaying tags.
+ Default values are '#000000' (black) and '#f5f6be' (pale yellow),
+ respectively.
</para>
</listitem>
</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 <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
+ <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>
<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>warn_sending_many_recipients_num</literal></term>
+ <listitem>
+ <para>
+ Display a confirmation dialogue when sending a message to a number
+ of recipients larger than the value of this preference. 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>
projects / claws.git / blobdiff