1 <chapter id="configure">
6 <firstname>Daniel</firstname>
7 <surname>Naber</surname>
10 </address></affiliation>
13 <firstname>David</firstname>
14 <surname>Rugge</surname>
15 <affiliation><address>
17 </address></affiliation>
20 <firstname>Marc</firstname>
21 <surname>Mutz</surname>
23 <orgname>Klarälvdalens Datakonsult AB</orgname>
30 <firstname>Michel</firstname>
31 <surname>Boyer de la Giroday</surname>
32 <affiliation><address>
33 <email>michel@kdab.net</email>
34 </address></affiliation>
37 <firstname>Laurent</firstname>
38 <surname>Montel</surname>
39 <affiliation><address>
40 <email>montel@kde.org</email>
41 </address></affiliation>
44 <firstname>Scarlett</firstname>
45 <surname>Clark</surname>
46 <affiliation><address>
47 <email>scarlett@scarlettgatelyclark.com</email>
48 </address></affiliation>
50 <!-- TRANS:ROLES_OF_TRANSLATORS -->
52 <date>2013-04-30</date>
53 <releaseinfo>2.1.96 (&kde; 4.11)</releaseinfo>
56 <title>Configure &kmail;</title>
58 <sect1 id="configure-generalinfo">
59 <title>General Information</title>
61 <para>&kmail;'s configuration window enables you to configure &kmail;
62 in many ways. You can reach it via
63 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
64 &kmail;...</guimenuitem></menuchoice>.</para>
66 <para>It is divided into six
67 pages, each of them represented by one of the
68 icons in the list on the left hand side of the dialog. The pages
69 will be described in detail below.</para>
71 <para>The dialog has several buttons:</para>
75 <term><guibutton>Help</guibutton></term>
76 <listitem><para>This will open this manual at the appropriate page.</para></listitem>
79 <term><guibutton>Defaults</guibutton></term>
80 <listitem><para>This will reset the configuration options on the current
81 page back to the default values.</para></listitem>
84 <term><guibutton>Reset</guibutton></term>
85 <listitem><para>This resets all changes you have made since you last saved
86 the settings.</para></listitem>
89 <term><guibutton>OK</guibutton></term>
90 <listitem><para>This saves the settings and closes the configuration dialog.</para></listitem>
93 <term><guibutton>Apply</guibutton></term>
94 <listitem><para>This saves the settings without closing the configuration
95 dialog.</para></listitem>
98 <term><guibutton>Cancel</guibutton></term>
99 <listitem><para>This closes the configuration dialog without saving the
100 changes you have made.</para></listitem>
106 <sect1 id="configure-identity">
107 <title>Identities Page</title>
109 <para>You can find a quick introduction to the
110 <guilabel>Identities</guilabel> page in the <link
111 linkend="getting-started">Getting Started</link> section.</para>
113 <para>This page allows you to create one or more
114 <emphasis>Identities</emphasis>, &ie; combinations of name, email
115 address and other settings. For example, you can create one identity
116 for business communication and one for
117 personal communication. If you have more than one email
118 address, you can create one identity per address. You will then be
119 able to select an identity on a per-message basis.</para>
121 <para>The page consists of a list of identities and buttons to manage
122 them. The identities list will always show at
123 least one identity, which is then the <guilabel>Default</guilabel>
126 <para>To add a new identity to the identity list, click on the
127 <guibutton>Add...</guibutton> button.
128 The <link linkend="configure-identity-newidentitydialog">New identity</link> dialog
129 will then appear.</para>
131 <sect2 id="configure-identity-newidentitydialog">
132 <title>The <guilabel>New Identity</guilabel> Dialog</title>
134 <para>You have to enter the name of the new identity into the
135 <guilabel>New Identity</guilabel> edit field. This will be the name
136 shown in the identity list.</para>
138 <para>You can choose how the new identity should be initialized by
139 checking one of the three radio buttons in the middle of the
145 <term><guilabel>With empty fields</guilabel></term>
147 <para>All fields of the new identity are cleared or preset with
148 standard values.</para>
153 <term><guilabel>Use System Settings values</guilabel></term>
155 <para>Uses the values from <menuchoice><guimenu>Account Details</guimenu>
156 <guimenuitem>Password & User Account</guimenuitem></menuchoice> in the
157 &systemsettings; category <guilabel>Common Appearance and Behavior</guilabel>.</para>
162 <term><guilabel>Duplicate existing identity</guilabel></term>
164 <para>Copies all fields from an existing identity. You can
165 choose which identity to copy from by selecting the corresponding
166 entry in the <guilabel>Existing identities</guilabel> drop down box.</para>
174 <sect2 id="configure-identity-general">
175 <title>General</title>
177 <para>The <guilabel>General</guilabel> tab allows you to specify some
178 basic settings for the currently selected identity.</para>
181 <term><guilabel>Your name</guilabel></term>
183 <para>Enter your full name here (sometimes also called <emphasis>display name</emphasis>).
184 Although this field is not strictly mandatory, it is recommended to enter
185 the correct value here.</para>
189 <term><guilabel>Organization</guilabel></term>
191 <para>Enter your organization here. This field is optional.</para>
195 <term><guilabel>Email address</guilabel></term>
197 <para>Enter your email address here, &ie; something like
198 <userinput>joe@example.com</userinput>.</para>
200 <title>Email address</title>
201 <para>So if your address is <replaceable>Joe User
202 <joe@example.com></replaceable>, you should enter <userinput>Joe
203 User</userinput> into the <guilabel>Your name</guilabel> field and
204 <userinput>joe@example.com</userinput> into the <guilabel>Email
205 address</guilabel> field.</para></example>
209 <term><guilabel>Email aliases</guilabel></term>
211 <para>This field contains alias addresses that should also be
212 considered as belonging to this identity (as opposed to representing
213 a different identity).</para>
215 <title>Email aliases</title>
216 <para>Primary address: first.last@example.org</para>
217 <para>Aliases: first@example.org and last@example.org</para>
225 <sect2 id="configure-identity-cryptography">
231 The <guilabel>Cryptography</guilabel> tab allows you to
232 specify &openpgp; and &smime; keys associated with this
233 identity, as well as choosing the preferred (cryptographic)
234 message format to use.
239 <varlistentry id="configure-identity-cryptography-openpgp-sign">
241 <guilabel>OpenPGP signing key</guilabel>
245 Here you can select the key to be used when
246 &openpgp;-signing messages written with this identity in
250 For brevity, only the short key id of selected keys is
251 shown. Hovering with the mouse over the key list will
252 show more information in a tooltip.
255 To clear the label press the
256 <guibutton>Clear</guibutton> button.
259 To change the selected key, press the
260 <guibutton>Change...</guibutton> button. A dialog
261 listing all secret &openpgp; keys will be shown allowing
262 you to select the one to use.
268 <varlistentry id="configure-identity-cryptography-openpgp-encrypt">
270 <guilabel>OpenPGP encryption key</guilabel>
274 Here you can select the key to &openpgp;-encrypt
275 messages to when this identity and <xref
276 linkend="configure-security-composing-encrypt-to-self"/>
277 are in effect. This key is also used for the <xref
278 linkend="composer-attach-attach-my-public-key"/>
279 function of the <link
280 linkend="the-composer-window">Composer</link>.
283 To change the selected key, press the
284 <guibutton>Change...</guibutton> button. A dialog
285 listing all &openpgp; keys found in your keyring will be
286 shown allowing you to select the one to use.
289 You can clear the list of keys and get more information
290 about them in the same way as described for <xref
291 linkend="configure-identity-cryptography-openpgp-sign"/>.
297 <varlistentry id="configure-identity-cryptography-smime-sign">
299 <guilabel>&smime; signing certificate</guilabel>
303 Here you can select the certificate to be used when
304 &smime;-signing messages written with this identity in
308 To change the selected certificate, press the
309 <guibutton>Change...</guibutton> button. A dialog
310 listing all secret &smime; signing certificates will be
311 shown allowing you to select the one to use.
314 You can clear the list of certificates and get more
315 information about them in the same way as described for
316 <xref linkend="configure-identity-cryptography-openpgp-sign"/>.
322 <varlistentry id="configure-identity-cryptography-smime-encrypt">
324 <guilabel>&smime; encryption certificate</guilabel>
328 Here you can select the certificate to &smime;-encrypt
329 messages when this identity and <xref
330 linkend="configure-security-composing-encrypt-to-self"/>
334 To change the selected certificate, press the
335 <guibutton>Change...</guibutton> button. A dialog
336 listing all &smime; encryption certificates found in
337 your local keybox will be shown allowing you to select
341 You can clear the list of certificates and get more
342 information about them in the same way as described for
343 <xref linkend="configure-identity-cryptography-openpgp-sign"/>.
348 <varlistentry id="configure-identity-cryptography-preferred-format">
350 <guilabel>Crypto</guilabel>
354 Here you can choose which cryptographic message format
355 to use by default with this identity.
358 You can either select any of the four formats supported
359 by &kmail; or leave the option at the recommended
360 default setting of <guilabel>Any</guilabel>, which will
361 choose a suitable format based on the recipients of the
362 message, or might even go so far as to create two copies
363 of the message, one &smime; signed and/or encrypted, the
364 other &openpgp; signed and/or encrypted.
373 <sect2 id="configure-identity-advanced">
374 <title>Advanced</title>
376 <para>The <guilabel>Advanced</guilabel> tab allows you to specify some
377 rarely used or otherwise specialized settings for the currently
378 selected identity.</para>
382 <term><guilabel>Reply-To address</guilabel></term>
384 <para>Enter the address to which replies to your messages should be
385 sent. Only fill out this field if it is different from your normal
386 address (specified using the <guilabel>Name</guilabel> and
387 <guilabel>Email Address</guilabel> on the <link
388 linkend="configure-identity-general"><guilabel>General</guilabel>
389 tab</link>), since replies default to the sender's address
391 <note><para>This field is only useful if you want replies to your mail
392 to go somewhere else than your regular email address, ⪚ if you are
393 using this identity to send messages from an email address that cannot
394 receive messages. Note that
395 some mailing lists overwrite this header field with their post address to
396 make sure that replies go to the list instead of individuals. So the
397 usefulness of this field is very limited and it should only be used in
398 rare cases.</para></note>
403 <term><guilabel>BCC addresses</guilabel></term>
405 <para>Optionally enter addresses separated by a comma to which blind copies of your messages
406 should be sent to. When you compose a message with this identity, the <guilabel>BCC</guilabel>
407 field is filled with these addresses. If you want to send a BCC regardless
408 of this setting, you should look at the <guilabel>Headers</guilabel> tab of the
409 <guilabel>Composer</guilabel> page.</para>
414 <term><guilabel>Dictionary</guilabel></term>
416 <para>Select the default dictionary for current identity.</para>
422 <term><guilabel>Sent-mail folder</guilabel></term>
424 <para>Select the folder into which messages should be filed after sending
425 when using this identity. <acronym>IMAP</acronym> users should consider changing this to an
426 <acronym>IMAP</acronym> folder, so their sent-mail is stored on a server instead of being
427 stored in a local folder. This way they can access these messages from a
428 different location.</para>
430 <tip><para>You can exercise more fine-grained control over where to
431 file sent messages by creating a corresponding <link
432 linkend="filters">message filter</link> that is applied to outgoing
433 messages.</para></tip>
439 <term><guilabel>Drafts folder</guilabel></term>
441 <para>Select the folder into which drafts should be filed when using
442 this identity. <acronym>IMAP</acronym> users should consider changing this to an
443 <acronym>IMAP</acronym> folder, so their drafts are stored on a server instead of being
444 stored in a local folder. This way they can easily continue to work
445 on their drafts at a different location.</para>
449 <!-- Templates folder missing-->
452 <term><guilabel>Outgoing Account</guilabel></term>
454 <para>Select or enter an alternative &SMTP; server to be used when sending
455 messages using this identity.</para>
457 <note><para>You need to configure outgoing mail servers first, before
458 you can choose them from the list. You can do this on the <link
459 linkend="configure-accounts-sending"><guilabel>Sending</guilabel>
460 tab</link> of the <link linkend="configure-accounts">
461 <guilabel>Accounts</guilabel> page</link>.</para></note>
468 <sect2 id="configure-identity-templates">
469 <title>Templates</title>
470 <para>Here you can create and manage templates to use when composing new
471 messages, replies or forwarded messages.</para>
472 <para>The message templates support substitution commands, either simply
473 type them or select them from the <guimenu>Insert Command</guimenu> menu.</para>
474 <para>Templates specified here are identity-specific. They override global
475 templates, but can be overridden by per-folder templates if they are
479 <sect2 id="configure-identity-signature">
480 <title>Signature</title>
482 <para>This tab allows you to specify a signature (sometimes called
483 <quote>footer</quote> or <quote>disclaimer</quote>)
484 to be appended to each message sent using this identity.</para>
486 <note><para>This type of signature has nothing to do with the
487 (digital) signatures for which you can select the keys to use on
488 the <link linkend="configure-identity-cryptography">Cryptography</link>
489 tab. It is just bad wording to call this a signature, but since
490 the term is already used everywhere else, we keep this notation. Just
491 keep in mind that these signatures and digital signatures are two
492 completely different things.</para></note>
494 <para>Check the <guilabel>Enable signature</guilabel> option if you
495 want to be able to append the signature when using this identity. To
496 <emphasis>automatically</emphasis> append it to every new message
497 you also have to select <guilabel>Automatically insert
498 signature</guilabel> in the <guilabel>Composer</guilabel> configuration page.</para>
500 <para>&kmail; can obtain the signature text from various sources. The
501 traditional way on Unix is to read the text from a file called
502 <filename>.signature</filename> in your home folder. This file can
503 be shared between several programs, so you get the same
504 signature in each mail program you use.</para>
506 <para>To read the signature from a text file you select
507 <guilabel>Obtain signature text from</guilabel>-><guilabel>File</guilabel>. Enter the
508 filename in the <guilabel>Specify file</guilabel> edit field or click
509 the button to the right of it to browse your filesystem. If you want
510 to edit the file, click the <guilabel>Edit File</guilabel>
513 <para>&kmail; can also read the signature text from the output of a
514 command. Thus, you can use programs such as
515 <command>fortune</command> to create a new signature text for
516 every message. Everything the program prints onto
517 <acronym>stdout</acronym> is caught and used as the signature
520 <para>To read the text from the output of a command you select
522 Command</guilabel>. Enter the command (preferably with full path) in
523 the <guilabel>Specify command</guilabel> edit field.</para>
525 <para>As a third option, you can enter the signature text directly in
526 &kmail;'s configuration dialog. To do this, select <guilabel>Input
527 Field Below</guilabel> and enter the text
528 into the resultant text box.</para>
530 <note><para>On the Internet, signatures are by convention separated
531 from the body of the message by a line containing only the three
532 character <quote>-- </quote> (dash, dash, space). &kmail; will
533 automatically prepend the signature text with this line if it is not
534 already present in the signature text.</para>
535 <para>If you do not wish the separator to be prepended
536 automatically by &kmail;, simply add it to the signature
537 text yourself.</para>
542 <sect2 id="configure-identity-pictures">
543 <title>Pictures</title>
544 <para>&kmail; can send a small (48x48 pixels), low-quality, monochrome picture
545 with every message. For example, this could be a picture of you or a glyph.
546 It is shown in the recipient's mail client (if supported).</para>
550 <term><guilabel>Send picture with every message</guilabel></term>
552 <para>Check this box if you want &kmail; to add a so-called X-Face header to
553 messages written with this identity. An X-Face is a small (48x48 pixels)
554 black and white image that some mail clients are able to display.</para>
559 <term><guilabel>External Source</guilabel></term>
564 <term><guilabel>Select File</guilabel></term>
566 <para>Use this to select an image file to create the picture from. The image
567 should be of high contrast and nearly quadratic shape. A light background
568 helps improve the result.</para>
573 <term><guilabel>Set From Address Book</guilabel></term>
575 <para>You can use a scaled-down version of the picture you have set in your
576 address book entry.</para>
586 <term><guilabel>Input Field Below</guilabel></term>
588 <para>Use this field to enter an arbitrary X-Face string.
589 Examples are available at <ulink url="http://ace.home.xs4all.nl/X-Faces/"
590 >http://ace.home.xs4all.nl/X-Faces/</ulink>
601 <sect1 id="configure-accounts">
602 <title>Accounts Page</title>
604 <para>You can find a quick introduction to the
605 <guilabel>Accounts</guilabel> page in the <link
606 linkend="setting-up-your-account">Setting up your Account</link>
609 <para>This page allows you to create one or more (incoming and
610 outgoing) <emphasis>accounts</emphasis>, &ie; combinations of mail
611 servers, login information and other settings. Typically, you will
612 create one outgoing (used for sending messages) and one incoming (used to
613 retrieve messages) account. You can create as many accounts as you want, though,
614 and assign each one to different <link
615 linkend="configure-identity">identities</link> or decide on a per-message
618 <sect2 id="configure-accounts-sending">
619 <title>Sending</title>
621 <para>The <guilabel>Sending</guilabel> tab allows you to define new
622 outgoing mail servers and set some common options.</para>
624 <para>For basic information, see <link
625 linkend="sending-mail">Setting up your Account: Sending</link>.</para>
627 <para>When you click <guibutton>Add...</guibutton> or
628 <guibutton>Modify...</guibutton> the <guilabel>Create Outgoing
629 Account</guilabel> or <guilabel>Configure account</guilabel> dialogs
630 will open respectively. For sending via &Sendmail;
632 you can specify a name and the location of the
633 &Sendmail; program. For &SMTP; you
634 can specify <guilabel>Name</guilabel>, <guilabel>Outgoing mail server</guilabel>, and
635 <guilabel>Port</guilabel> of the server. <guilabel>Server requires
636 authentication</guilabel> will enable the <guilabel>Login</guilabel>
637 and <guilabel>Password</guilabel> fields. If you are not sure about the
638 security settings you can make &kmail; test for the best settings by
639 using <guibutton>Auto Detect</guibutton> on the
640 <guilabel>Advanced</guilabel> tab.</para>
642 <para><guilabel>Confirm before send</guilabel> will pop up a
643 confirmation box every time you send a message.</para>
645 <para><guilabel>Send messages in outbox folder</guilabel> lets you specify
646 when queued messages, &ie; messages in the outbox folder pending to be sent,
647 should be sent. You can choose between:</para>
650 <term><guilabel>Never Automatically</guilabel></term>
651 <listitem><para>Queued messages will only be sent if you select
652 <menuchoice><guimenu>File</guimenu><guimenuitem>Send queued messages</guimenuitem></menuchoice>.</para></listitem>
655 <term><guilabel>On Manual Mail Checks</guilabel></term>
656 <listitem><para>Queued messages will be sent after you have manually checked
657 for new mail, ⪚ with <menuchoice><guimenu>File</guimenu><guimenuitem>Check Mail</guimenuitem></menuchoice>. Of course, you can also
658 manually send the queued messages with
659 <menuchoice><guimenu>File</guimenu><guimenuitem>Send queued messages</guimenuitem></menuchoice>.</para></listitem>
662 <term><guilabel>On All Mail Checks</guilabel></term>
663 <listitem><para>Queued messages will be sent after all checks for new mail,
664 &ie; after automatic mail checks as well as after manual mail checks.
665 Of course, you can also manually send the queued messages with
666 <menuchoice><guimenu>File</guimenu><guimenuitem>Send queued messages</guimenuitem></menuchoice>.</para></listitem>
670 <para><guilabel>Default send method</guilabel> lets you define what
671 happens when a message is sent. If <guilabel>Send now</guilabel> is
672 selected, the message is sent to the mail server immediately, while if
673 <guilabel>Send later</guilabel> is selected, the message is queued in
674 the outbox to be sent later with the
675 <menuchoice><guimenu>File</guimenu><guimenuitem>Send
676 Queued Messages</guimenuitem></menuchoice> command or automatically when you
677 check your mail, depending on the setting of
678 <guilabel>Send messages in outbox folder</guilabel> above.</para>
680 <para><guilabel>Default domain</guilabel> lets you specify which domain name
681 should be used to complete email addresses that only consist of the recipient's user
682 name. For example when you set the default domain to <replaceable>kde.org</replaceable>
683 then messages you send to <replaceable>johndoe</replaceable> will be sent to
684 <replaceable>johndoe@kde.org</replaceable>.</para>
688 <sect2 id="configure-accounts-receiving">
689 <title>Receiving</title>
691 <para>For basic information, see <link
692 linkend="receiving-mail">Setting up your Account: Receiving</link>.</para>
694 <para>Using the <guilabel>Retrieval Options</guilabel> popup menu for each resource,
695 lets you specify whether &kmail; should check for new mail immediately after it has
696 been started. You can also select <guilabel>Include in Manual Mail Check</guilabel>
697 and <guilabel>Switch offline on &kmail; Shutdown</guilabel>.
700 <para>With <guilabel>New Mail Notification</guilabel> you can set
701 how &kmail; will notify you if new messages have arrived:
702 <guilabel>Beep</guilabel> will play a short beep sound;
703 if <guilabel>Detailed new mail notification</guilabel> is enabled then
704 &kmail; will show the number of new messages for each folder provided
705 you have chosen to be notified with a dialog. More advanced
706 notification options, like showing a dialog or running a certain command,
707 are available via the <guibutton>Other Actions</guibutton> button.</para>
713 <sect1 id="configure-appearance">
714 <title>Appearance Page</title>
716 <sect2 id="configure-appearance-fonts">
719 <para>This section allows you to change the type, size and character set of the
720 display fonts. <guilabel>Message Body</guilabel> sets the font for
721 the reader pane, <guilabel>Composer</guilabel> sets the font for
722 writing messages in the composer window.<!-- fixme in kmail: better wording? -->
727 <sect2 id="configure-appearance-colors">
728 <title>Colors</title>
730 <para>This section allows you to change the color of the text by double clicking
731 on an item in the listbox.
732 <guilabel>Recycle colors on deep quoting</guilabel> means that even text that is
733 quoted more than three times will appear in color. Note that the
734 <guilabel>Quoted text</guilabel> colors only work in the message reader, not in
735 the composer. If you want folders which are close to their quota
736 (space allotment, usually used on IMAP servers) to be displayed in a different color,
737 you can specify a percentage value as a threshold for this. The color to be used
738 can be configured along with the other custom colors.<!-- TODO --></para>
742 <sect2 id="configure-appearance-layout">
743 <title>Layout</title>
744 <para>This tab lets you configure the layout of the main window.</para>
745 <para>In the <guilabel>Folder List</guilabel> section you can choose between the
746 <guilabel>Long folder list</guilabel> using the full height of the window and
747 the <guilabel>Short folder list</guilabel> with the message preview pane using the
748 bottom part of the window.</para>
749 <para>If you want to have your favorite folders and a quick search field for folders at
750 the top left of the main window select the next two options.</para>
751 <!--Show Favorite Folders View (Never, As Icons, As List) + Show folder quick search field-->
753 <!--Folder Tooltips display additional information like the total number of messages,
754 unread messages and storage size when hoovering a folder with the mouse pointer
756 <para>You can choose where you want the
757 <guilabel>Message Preview Pane</guilabel> or choose not to have
760 <!--this setting is apparently only available via the context menu in the message preview pane?
761 para>The <guilabel>Message Structure Viewer</guilabel> option lets you choose when
762 the structure viewer will be shown: the structure viewer is a part of the main window that
763 lets you access all parts of a message. <guilabel>Show never</guilabel> will
764 disable the structure viewer (note that you can still access attachments as icons),
765 <guilabel>Show always</guilabel> will show the structure viewer even if there is only
766 one plaintext part. <guilabel>Show only for non-plaintext messages</guilabel> will
767 display the structure viewer only if it makes sense, &ie; if the current message
768 has attachments or has &html; parts.</para
769 not in 2.1.0 lueck-->
773 <sect2 id="configure-appearance-message-list">
774 <title>Message List</title>
775 <para>In the <guilabel>General</guilabel> section you can alter the appearance of the Message List pane.</para>
776 <para>Choose to <guilabel>Display tooltips for messages and group headers</guilabel>.
777 Check <guilabel>Hide tab bar when only one tab is open</guilabel> to have more space for
778 the messages in the list.</para>
780 <para>The next options are the settings for <guilabel>Default Aggregation</guilabel> and
781 <guilabel>Default Theme</guilabel> which can be overridden using the <guilabel>Folder
782 Properties</guilabel> dialog for each folder individually.</para>
783 <para>Using the <guibutton>Configure</guibutton> button opens a window to customize the default
784 aggregation or theme to your needs and allows you to add your own.</para>
785 <para>A brief overview of the predefined aggregations and themes:</para>
788 <term>Aggregation</term>
793 <term>Senders/Receivers, Flat</term>
795 This view groups the messages by senders or receivers (depending on the folder type).
796 Messages are not threaded.</para>
800 <term>Activity by Date, Flat</term>
801 <listitem><para>This view uses day-by-day groups. Messages are not threaded. So for example,
802 in <quote>Today</quote> you will simply find all the messages arrived today.
807 <term>Activity by Date, Threaded</term>
808 <listitem><para>This view uses day-by-day groups. Messages are threaded. So for example, in
809 <quote>Today</quote> you will find all the messages arrived today and all the threads.
814 <term>Current Activity, Flat</term>
815 <listitem><para>This view uses smart date range groups. Messages are not threaded. So for
816 example, in <quote>Today</quote> you will simply find all the messages arrived today.
821 <term>Current Activity, Threaded </term>
822 <listitem><para>This view uses smart date range groups. Messages are threaded. So for
823 example, in <quote>Today</quote> you will find all the messages arrived today and all
824 the threads that have been active today.
829 <term>Thread Starters</term>
830 <listitem><para>This view groups the messages in threads and then groups the threads by the
836 <term>Flat Date View</term>
837 <listitem><para>This is a plain and old list of messages sorted by date: no groups and no
843 <term>Standard Mailing List</term>
844 <listitem><para>This is a plain and old mailing list view: no groups and heavy threading.
862 <listitem><para>A fancy multiline and multi-item theme
867 <term>Fancy with Clickable Status</term>
868 <listitem><para>A fancy multiline and multi-item theme with a clickable status column
874 <listitem><para>A simple, backward compatible, single row theme
884 <para>In the <guilabel>Date Display</guilabel> section you can choose between several
885 date formats. The <guilabel>Localized Format</guilabel> is the one you can
886 specify under <guilabel>Country/Region & Language</guilabel> in the &systemsettings;.
887 For the <guilabel>Custom</guilabel> format you can get
888 a description of the possible values by clicking on <guilabel>Custom format
889 information</guilabel> option.</para>
892 <sect2 id="configure-appearance-message-window">
893 <title>Message Window</title>
895 <para>If the <guilabel>Close message window after replying or forwarding</guilabel> option is
896 activated, &kmail; will close the message window after replying to or forwarding the message that
897 is displayed in the window. This only applies to the separate message window, not to the embedded
898 message preview pane.</para>
899 <para>By default, <guilabel>Enable access key</guilabel> is enabled. Access keys allow you to use the keyboard keys for functions which would perhaps normally be done with the mouse, such as following links.
900 For more information on access keys please see <ulink url="http://docs.kde.org/stable/en/applications/konqueror/accesskeys.html">Access keys</ulink>.</para>
901 <para><guilabel>Show HTML status bar</guilabel> activates a bar at the left side of the reader
902 pane that tells you if a message is &html; or not. This is important because
903 &html; messages might imitate the look of a signed and encrypted message, so
904 you should be aware of the fact that you are reading an &html; message. The &html;
905 status bar itself cannot be influenced by the &html; code of the message.</para>
907 <para>Enable <guilabel>Replace smileys by emoticons</guilabel> if you want smileys
908 like <userinput>:-)</userinput> appearing in the message text to be
909 replaced by emoticons (small pictures) such as
910 <inlinemediaobject><imageobject>
911 <imagedata fileref="smile.png" format="PNG"/></imageobject>
912 </inlinemediaobject>.</para>
914 <para>Enable <guilabel>Reduce font size for quoted text</guilabel> to show quoted
915 text with a smaller font.</para>
917 <para>Enable <guilabel>Show expand/collapse quote marks</guilabel> to show
918 different levels of quoted text. Disable to hide
919 the levels of quoted text.</para>
921 <para><guilabel>Fallback character encoding</guilabel>:
922 Some emails, especially those generated automatically, do not specify the
923 character encoding which needs to be used to properly display them. In such
924 cases a fallback character encoding will be used, which you can configure
925 here. Set it to the character encoding most commonly used in your part of
926 the world. As a default the encoding configured for the whole system is used.</para>
928 <para><guilabel>Override character encoding</guilabel>:
929 Changing this from its default <guilabel>Auto</guilabel> will force the use of the specified
930 encoding for all emails, regardless of what they specify themselves.</para>
932 <para><guilabel>Minimum font size:</guilabel> This option allows you to set the smallest size a font will show as.
933 This can be helpful if you have a hard time reading really small fonts.</para>
935 <para>To customize which headers you would like to view in the message window (⪚ subject, from, to, cc, bcc, date), click the <guibutton>Configure Custom Headers</guibutton> button next to <guilabel>Headers:</guilabel>.
936 Add your selection in the dialog that pops up. If you are using fancy headers, you can enable <guilabel>Show spam status in fancy headers</guilabel> here. Please note that if your email provider does not provide <application>Spamassassin</application>
937 services to check your email for spam, you will need to install it on your computer. ⪚ through a package manager (Yast on &SuSE;, &ubuntu; Software Center on &ubuntu; &etc;).
938 For more information see: <link linkend="the-anti-spam-wizard">Anti-Spam Wizard</link> to set up spamassassin with &kmail;.</para>
943 <sect2 id="configure-appearance-systemtray">
944 <title>System Tray</title>
946 <para>If you enable the system tray icon then a small &kmail; icon with the
947 number of unread messages will be shown in the system tray. You can enable
948 &kmail;'s system tray icon with <guilabel>Enable system tray icon</guilabel>,
949 and with <guilabel>System Tray Mode</guilabel>
950 you can specify whether the tray icon should always be shown or only if
951 you have unread messages.</para>
953 <para>If the icon is visible then you can hide &kmail;'s main window by
954 clicking on the icon or by clicking on the window close button. By clicking
955 on the icon you can make &kmail;'s main window visible again.
956 If you click on the icon with the <mousebutton>right</mousebutton>
957 mousebutton then you get a menu with a few useful commands. You can check
958 for new mail, create a new message or quit &kmail;. Additionally, there is
959 the entry <guilabel>New Messages In</guilabel> which lists all folders
960 containing unread messages. If you choose one of those folders then this
961 folder will be selected in &kmail;'s main window.
966 <!-- Message Tags tab missing for 2.1.96 -->
970 <sect1 id="configure-composer">
975 <sect2 id="configure-composer-general">
981 <varlistentry id="configure-composer-general-append-signature">
983 <guilabel>Automatically insert signature</guilabel>
987 If checked, your signature as defined in the <link
988 linkend="configure-identity-signature">identity
989 page</link> is automatically included at the end of
990 all messages you create (&ie; new messages, replies, &etc;).
994 <!-- Insert signature above quoted text + Prepend separator to signature missing -->
995 <varlistentry id="configure-composer-general-smart-quoting">
997 <guilabel>Use smart quoting</guilabel>
1001 If checked, &kmail; will break long lines but will try
1002 to keep the correct quoting (⪚ the <quote>>
1003 </quote> will always be at the start of the line).
1007 <varlistentry id="configure-composer-general-quote-selection-only">
1009 <guilabel>Only quote selected text when replying</guilabel>
1013 If checked, &kmail; will quote only the selected text in the message window,
1014 instead of the complete message, when replying.
1015 With this, it is possible to quickly generate replies that quote only the relevant
1016 paragraph to which you are actually replying, and omits the other paragraphs that are
1017 not relevant to the context.
1021 <varlistentry id="configure-composer-general-strip-signatures">
1023 <guilabel>Remove the signature when replying</guilabel>
1027 If checked, &kmail; will remove the signature from the quoted text
1028 when replying to a message. This is useful since it reduces the amount
1029 of quoted text, which makes it easier to read the reply.
1033 <varlistentry id="configure-composer-general-auto-request-mdns">
1035 <guilabel>Automatically request message disposition notifications</guilabel>
1040 linkend="composer-options-request-mdn"/> will default to
1041 <emphasis>on</emphasis>. Check this option only if you
1042 know what you are doing. &mdn;s are considered a
1043 nuisance (or are simply ignored) by a lot of people. It
1044 is better to decide to request them on a
1045 message-by-message basis.
1049 <!-- Use recent addresses for autocompletion missing -->
1050 <varlistentry id="configure-composer-general-word-wrap">
1052 <guilabel>Word wrap at column</guilabel>
1056 Lets you turn word wrapping on and off in the composer
1057 window and lets you set the column at which words will
1058 be wrapped (you probably should not need to change the
1059 default value, which is <literal>78</literal>).
1063 <!-- not in kmail 2.0.96 varlistentry id="configure-composer-general-too-many-recipients">
1065 <guilabel>Warn if the number of recipients is larger than</guilabel>
1069 If the number of recipients is larger than this value, &kmail; will
1070 warn and ask for a confirmation before sending the mail.
1071 The default is to warn if there are more than <literal>5</literal> recipients.
1072 This warning can be turned off.
1076 <varlistentry id="configure-composer-general-autosave-interval">
1078 <guilabel>Autosave interval</guilabel>
1082 A backup copy of the text in the composer window can be created
1083 regularly. This option lets you specify the interval used to
1084 create the backup. You can disable autosaving by setting it to
1085 the value <literal>0</literal>.
1089 <!-- not in kmail 2.0.96 varlistentry id="configure-composer-general-forwading-type">
1091 <guilabel>Default Forwarding Type</guilabel>
1095 Lets you decide whether you want to forward messages inline or as an attachment by default.
1096 This changes which type of forwarding mechanism is used when you click the toolbar icon or
1097 when you activate the shortcut for forwarding.
1101 <!--missing: Configure Completion Order + Edit Recent Addresses -->
1107 <sect2 id="configure-composer-standard-templates">
1108 <title>Standard Templates</title>
1109 <para>Here you can add, edit, and delete custom message templates to use
1110 when you compose a reply or forwarding message.</para>
1111 <para>Message templates support substitution commands, by simply typing them
1112 or selecting them from the <guimenu>Insert Command</guimenu> menu.</para>
1113 <para>These are global (default) templates. They can be overridden by
1114 per-identity templates or per-folder templates if they are specified.</para>
1117 <sect2 id="configure-composer-custom-templates">
1118 <title>Custom Templates</title>
1119 <para>Here you can add, edit, and delete custom message templates to use
1120 when you compose a reply or forwarding message. Create the custom template
1121 by typing the name into the input box and press the <guiicon>+</guiicon> button.
1122 You can bind a keyboard combination to the template for faster operations.</para>
1123 <!-- To and CC field-->
1124 <para>Message templates support substitution commands, by simply typing them
1125 or selecting them from the <guimenu>Insert Command</guimenu> menu.</para>
1126 <para>There are four types of custom templates: used to <guilabel>Reply</guilabel>,
1127 <guilabel>Reply to All</guilabel>, <guilabel>Forward</guilabel>, and
1128 <guilabel>Universal</guilabel> which can be used for all kinds of operations.
1129 You cannot bind a keyboard shortcut to <guilabel>Universal</guilabel>
1132 <!-- replaced by Standard Templates / Custom Templates tabs, remove it lueck 31.05.2011
1133 <sect2 id="configure-composer-phrases">
1134 <title>Phrases</title>
1136 <para>The <guilabel>Phrases</guilabel> tab lets you define the automatically
1137 generated lines that are added to message replies, forwarded messages, and the
1138 character that is added in front of quoted text.
1139 There are special %-denoted characters that will insert certain
1140 values, which are also displayed at the top of the <guilabel>Phrases</guilabel> section.
1141 You can add reply phrases in languages other than
1142 your default &kde; language using the <guibutton>Add...</guibutton> button.
1143 You can then choose between different languages with the
1144 <guilabel>Language</guilabel> drop down box.
1145 This will only work for languages whose i18n package you have installed.</para>
1148 <sect2 id="configure-composer-subject">
1149 <title>Subject</title>
1151 <para>This section contains a list of prefixes for <quote>Reply</quote> and
1152 <quote>Forward</quote>. If you receive messages that use prefixes different
1153 to the standard ones, you can add them here so &kmail; will recognize
1154 them. This way &kmail; can ignore them for sorting messages and
1155 when setting the subject of a reply or a forwarded messages, and optionally
1156 replace them with <quote>Re:</quote> or <quote>Fwd:</quote>
1157 respectively.</para>
1161 <sect2 id="configure-composer-charset">
1162 <title>Charset</title>
1164 <para>Here you can manage the default charsets used for your own messages.
1165 Every message you send will be checked if it is written in one of the listed
1166 charsets, starting at the top of the list. If it is, this charset will be used.
1167 If it is not, a dialog will show up and tell you that you manually have to choose
1169 <menuchoice><guimenu>Options</guimenu><guisubmenu>Set Encoding</guisubmenu></menuchoice>.
1172 <para>If you select <guilabel>Keep original charset when replying
1173 or forwarding (if possible)</guilabel>, the original message's charset
1174 will be kept, unless there are now characters that cannot be
1175 represented using that charset.</para>
1179 <sect2 id="configure-composer-headers">
1180 <title>Headers</title>
1182 <para>Check the <guilabel>Use custom message-id suffix</guilabel>
1183 checkbox if you want &kmail; to generate Message-Id's with a custom
1184 suffix. Enter the desired suffix in the <guilabel>Custom message-id
1185 suffix</guilabel> field. Please make sure that the suffix that you
1186 specify is world-wide unique. The best thing is to use the name of a
1187 domain which you are the owner of. If you do not check <guilabel>Use
1188 custom Message-Id suffix</guilabel> then &kmail; will automatically
1189 generate the complete Message-Id. If you do not know what this is all
1190 about do not check this option.</para>
1192 <para>The <guilabel>Define custom mime header fields</guilabel> list
1193 sets the headers that &kmail; will use for its outgoing messages. You
1194 can both invent new fields and overwrite existing ones. This feature
1195 is only useful for advanced users.</para>
1199 <sect2 id="configure-composer-attachments">
1200 <title>Attachments</title>
1202 <para>If you have to send attachments with filenames containing non-English
1203 characters to users of
1204 <application>&Microsoft; Outlook</application> or
1205 <application>&Microsoft; Outlook Express</application>
1206 then you might want to check the <guilabel>Outlook-compatible attachment naming</guilabel>
1207 option. &kmail; will then encode the attachment names in a non-standard way that
1208 is understood by <application>&Microsoft; Outlook</application>.
1210 <para>Note that &kmail; will create non-standard compliant messages, and
1211 consequently it is possible that your messages will not be understood by
1212 standard-compliant mail clients. So, unless you have no other choice, you
1213 should not enable this option.</para>
1215 <para>Check the <guilabel>Enable detection of missing attachments</guilabel>
1216 checkbox if you want &kmail; to warn you whenever you are about to send a
1217 message without attachments although the message text contains certain
1218 words which indicate that you wanted to include an attachment. The list
1219 of key words can be modified.</para>
1223 <sect2 id="configure-composer-autocorrection">
1224 <title>Autocorrection</title>
1225 <para>To enable the feature, check the <guilabel>Enable autocorrection</guilabel> option. In the
1226 drop down box choose the language you would like to use. You can import settings from <application>LibreOffice</application> or another &kmail; installation by selecting the
1227 appropriate choice from the <guilabel>Import</guilabel> drop down box. If you need to save your settings for another installation or application, select the <guibutton>Export</guibutton> button.
1230 <variablelist><title>Autocorrect Options</title>
1232 <term><guilabel>Simple Autocorrection</guilabel></term>
1235 This allows you to configure &kmail; to autocorrect various simple corrections.
1236 Check the box next to the autocorrect feature you would like to enable.
1241 <term><guilabel>Custom Quotes</guilabel></term>
1244 You can replace double or single quotes with typographical quotes by checking the appropriate box.
1245 You can also add non breaking space before specific punctuation marks in French text by selecting the option.
1250 <term><guilabel>Advanced Autocorrection</guilabel></term>
1253 You can enter custom automatic word replacement by checking this option. To enter a custom string to replace automatically
1254 enter the word to be replaced in the <guilabel>Find</guilabel> box, and the replacement word in the <guilabel>Replace</guilabel> box and click the <guibutton>Add</guibutton> button.
1255 To remove a custom word replacement string, highlight the string and click <guibutton>Remove</guibutton>.
1260 <term><guilabel>Exceptions</guilabel></term>
1263 This allows you to set exceptions where you would like &kmail; to ignore your autocorrect selections for end of sentence and two uppercase letters. Enter the exception and click <guibutton>Add</guibutton> button.
1264 To remove the exception, highlight the string and click <guibutton>Remove</guibutton> button.
1271 Once you have made all of your autocorrect selections click the <guibutton>Apply</guibutton> button.
1274 <sect2 id="configure-resize-image">
1275 <title>Auto Resize Image</title>
1276 <para>In some circumstances you may need to have &kmail; automatically resize image attachments on outgoing emails. ⪚ Mail server limits. To do so, select <guilabel>Automatically resize images</guilabel>.
1277 There are several options that come with this feature.</para>
1279 <varlistentry><term><guilabel>General</guilabel></term>
1281 <para>Some general options for auto image resizing are as follows: If you need your images to keep the ratio of length and width intact ⪚
1282 Photographs, select <guilabel>Keep ratio</guilabel>. The default behavior is for &kmail; to prompt and ask if you want to resize before resizing, if you want it to resize
1283 without asking, unselect <guilabel>Ask before resizing</guilabel>. &kmail; will save the file in <acronym>JPG</acronym>, if you would rather have them save in
1284 <acronym>PNG</acronym> format, select it from the <guilabel>Write to format</guilabel> drop down box.</para>
1287 <varlistentry><term><guilabel>Image</guilabel></term>
1289 <para> Say you have a relative that can only receive image files of a certain size due to their email providers limits, you can use the <guilabel>Reduce image to maximum dimension:</guilabel> option
1290 to select a size to reduce the image to and enter their email into the filters on the <guilabel>Recipients</guilabel> tab. The recipients tab is discussed in further detail at the end of this section.
1291 If you need a custom size, choose the last option <guilabel>Custom</guilabel> from the width and height drop down boxes, and enter the number in the text box. You can also enlarge images by selecting
1292 <guilabel>Enlarge image to minimum dimension</guilabel>. The last option allows you to skip images of a certain filesize (this will verify image size by width x height only).</para>
1295 <varlistentry><term><guilabel>Filename</guilabel></term>
1298 <varlistentry><term><guilabel>Source filter</guilabel></term>
1299 <listitem><para>If you would like the resizing to be done based on the name of the file, you would select the appropriate filter here. ⪚ You need to send your boss multiple images daily,
1300 and your boss requires them to be the same size. You could name all of your work images work1, work2 &etc; then select <guilabel>Include all files whose names contains one of the patterns</guilabel> and
1301 enter work into the <guilabel>Pattern:</guilabel> text box. You can also exclude files in the same way by selecting
1302 <guilabel>Exclude all files whose names contains one of the patterns</guilabel>. The default behavior is no filtering.</para>
1305 <varlistentry><term><guilabel>Image Format</guilabel></term>
1307 <para> Select <guilabel>Resize all images with one of these formats</guilabel> to set a specific format to resize the image to.</para>
1309 <listitem><para>When this option is enabled you must select the <guibutton>Select Format...</guibutton> button and select a format from the dialog.</para></listitem>
1313 <varlistentry><term><guilabel>Resize filename</guilabel></term>
1315 <para>Select <guilabel>Rename resized images with the following pattern</guilabel> if you would like your resized images to be renamed with a specific pattern. Enter the pattern into the text box. You can use:
1317 <member>%t set current time</member>
1318 <member>%d set current date</member>
1319 <member>%n original filename</member>
1320 <member>%e original extension</member>
1321 <member>%x new extension</member>
1322 </simplelist></para>
1328 <varlistentry><term><guilabel>Recipients</guilabel></term>
1330 <para>This tab is where you would specify recipients that need to have resized images. ⪚ grandma@myfamily.net; boss@mywork.com.
1331 You need to decide if you need multiple or only one, and enter the email(s) into the text box using the <quote>;</quote> as a separator when you have multiple. You can also specify
1332 if you do not want certain recipient(s) images to be resized. The default is no filtering.</para>
1338 <sect2 id="configure-composer-general-external-editor">
1339 <title>External Editor</title>
1342 <term><guilabel>Use external editor instead of composer</guilabel></term>
1344 <para>This selection allows you to use a different editor. Please note that the composer window will still open,
1345 and the external editor will open on top of the composer window. When you are done, save the text and exit the editor.
1346 The text will now appear in the composer window, where you can send it. Note that your editor may not return immediately, you have to use ⪚
1347 <userinput><command> gvim <option>-f</option> <varname>%f</varname></command></userinput> for <application>gvim</application>.</para>
1355 <sect1 id="configure-security">
1356 <title>Security Page</title>
1357 <sect2 id="configure-security-reading">
1358 <title>Reading</title>
1359 <para>On this tab you can configure security-relevant options for
1360 reading messages.</para>
1362 <varlistentry id="configure-security-reading-prefer-html">
1363 <term><guilabel>Prefer HTML to plain text</guilabel></term>
1366 By default &kmail; will show &html; messages in plain text. If you prefer to view messages with
1367 &html; formatting and layout automatically, select this option. However, we recommend leaving this option off,
1368 as security problems with &html; might show up.</para>
1369 <para>You can still easily view messages in &html; format per email by
1370 clicking the plain message/html message toggle bar on the left hand side of the message window. Please see <link linkend="configure-appearance-message-window">Message Window</link>
1371 to enable this feature.</para>
1375 <varlistentry id="configure-security-reading-external-references">
1376 <term><guilabel>Allow messages to load external references from the Internet</guilabel></term>
1378 <para>If checked, &kmail; can load external images, stylesheets &etc; from the Internet
1379 when you look at an &html; message. We strongly recommend to leave this option off (although it has no effect if you only view
1380 plain text messages).</para>
1381 <para>By adding external references to their messages, people sending spam can detect when you have looked at their message, your location, and
1382 alot of other information that gets logged on web servers. Note that this option has no effect on &Java;, JavaScript and Plugins as
1383 these are not supported in &kmail; at all, which is a good thing, as most viruses propagate through these.</para>
1386 <!--http://www.aegiap.eu/kdeblog/2013/04/news-in-kdepim-4-11-scam-detection/-->
1387 <varlistentry id="configure-security-email-scams">
1388 <term><guilabel>Informs if message reading is a suspected email scam</guilabel></term>
1390 <para>With the popularity of email, unfortunately comes the popularity of email scams. Email scams can include emails made to appear as though they come from legitimate companies,
1391 but they really link to malicious web sites requesting your personal information. This can lead to identity theft and worse. By default &kmail; analyzes messages for common scams,
1392 and will inform you if the email is a suspected scam. It is highly advised to keep this feature enabled. If you wish to disable this great feature, uncheck
1393 <guilabel>Informs if message reading is a suspected email scam</guilabel>.</para>
1394 <para>If you have legitimate emails being flagged, ⪚ from trusted friends, you can add their email to the <guilabel>Whitelist:</guilabel> by clicking
1395 the <guibutton>Add...</guibutton> and enter the email into the dialog that pops up. Please note that at this time, only individual emails are supported.</para>
1399 <term><guilabel>Encrypted messages</guilabel></term>
1401 <para>By default, &kmail; will automatically attempt to decrypt encrypted messages when you view them. If you prefer to do it manually, unselect this option.</para>
1405 <term><guilabel>Certificate & Key Bundle Attachments</guilabel></term>
1407 <para>If you would like to have &kmail; to <guilabel>Automatically import keys and certificate</guilabel> from incoming messages for decryption, select this option.</para>
1410 <varlistentry id="configure-security-reading-mdns">
1412 <guilabel>Message Disposition Notifications</guilabel>
1416 &mdn;s are a generalization of what is commonly called a
1417 <quote>read receipt</quote>. The message author requests
1418 a disposition notification to be sent and the receiver's
1419 mail program generates a reply from which the author can
1420 learn what happened to his message. Common disposition
1421 types include <quote>displayed</quote> (&ie; read),
1422 <quote>deleted</quote> and <quote>dispatched</quote>
1426 The following options (listed as <guilabel>Send
1427 policy</guilabel>) are available to control
1428 <emphasis>when</emphasis> &kmail; sends &mdn;s:
1433 <guilabel>Ignore</guilabel> (recommended)
1437 Ignores any request for disposition
1438 notifications. No &mdn; will ever be sent
1445 <guilabel>Ask</guilabel>
1449 Answers requests only after asking the user for
1450 permission. This way, you can send &mdn;s for
1451 selected messages while denying or ignoring them
1458 <guilabel>Deny</guilabel>
1462 Always sends a <quote>denied</quote>
1463 notification. This is only
1464 <emphasis>slightly</emphasis> better than always
1465 sending &mdn;s. The author will still know that
1466 the messages has been acted upon, he just cannot
1467 tell whether it was deleted or read &etc;
1473 <guilabel>Always send</guilabel>
1477 Always sends the requested disposition
1478 notification. That means that the author of the
1479 message gets to know when the message was acted
1480 upon and, in addition, what happened to it
1481 (displayed, deleted, &etc;). This option is
1482 strongly discouraged, but since it makes sense
1483 where privacy is not a concern, ⪚ in customer
1484 relationship management, it has been made
1491 If you are unsure, experiment a while with
1492 <guilabel>Ask</guilabel> and if you find &kmail;s
1493 questions annoying, switch to <guilabel>Ignore</guilabel>.
1496 The following options (listed as <guilabel>Quote
1497 original message</guilabel>) are available to control
1498 <emphasis>how much</emphasis> of the original message
1499 &kmail; sends back in &mdn;s.
1504 <guilabel>Nothing</guilabel>
1508 No parts of the message other than the mandatory
1509 message-id and the original recipient is included
1510 in the &mdn; reply. This preserves enough
1511 information for the sender to find the message in
1512 his sent messages for which this &mdn; was
1519 <guilabel>Full message</guilabel>
1523 Attaches the complete message to the disposition
1524 notification. Usually, this is overkill. It does
1525 not add any valuable information that cannot be
1526 deduced from the message headers alone, but people
1527 sometimes insist on this, since it is much easier
1528 for humans to correlate the content of the message
1529 than just the headers to what they sent earlier.
1535 <guilabel>Only headers</guilabel>
1539 Attaches only the headers to the disposition
1540 notification. This is usually enough to enable
1541 both humans (by subject) and computers (by
1542 message-id) to easily correlate &mdn; and original
1549 If unsure, leave the option at the default.
1556 <guilabel>Do not send MDNs in response to encrypted messages</guilabel>
1560 This option suppresses the sending of &mdn;s if the
1561 message is encrypted (partially or in whole). This
1562 thwarts attempts to use &kmail;'s &mdn; feature as an
1563 <emphasis>oracle</emphasis> to deduce whether you were
1564 able to decrypt the message or not.
1567 Strictly speaking, this option is not needed, since
1568 &kmail; sends &mdn;s regardless of whether the message
1569 could be successfully decrypted or not (the disposition
1570 notification request resides in the unencrypted part of
1571 the message), but it gives the security-conscious user
1572 the choice to either send them always if requested
1573 (option unchecked), or never (option checked).
1576 If unsure, leave the option checked.
1583 <guilabel>Automatically import keys and certificates</guilabel>
1587 If checked, &kmail; automatically imports any attachments
1588 containing &openpgp; keys into your local keyring, and any
1589 attachments containing &smime; keys into your local key
1594 Verifying &smime; signatures always involves importing
1595 the contained certificates. This option thus does not
1596 affect this. It is also unrelated to &gpg;'s
1597 <option>auto-key-retrieve</option> feature, where &gpg;
1598 will try to import unknown keys from a key server.
1606 <sect2 id="configure-security-composing">
1612 On this tab you can configure security-relevant options for
1618 <varlistentry id="configure-security-composing-automatically-sign">
1620 <guilabel>Automatically sign messages</guilabel>
1624 If checked, the <xref
1625 linkend="composer-options-sign-message"/> option in the
1626 composer will default to <emphasis>on</emphasis>.
1629 However, you can still switch it on and off on a
1635 <varlistentry id="configure-security-composing-encrypt-to-self">
1637 <guilabel>When encrypting emails, always also encrypt to the certificate of my own identity</guilabel>
1641 If checked, any message that is encrypted to the
1642 recipients will additionally be encrypted to yourself.
1646 If you uncheck this option, you may not be able to
1647 decrypt the messages written by yourself and encrypted
1648 to other people anymore.
1654 <varlistentry id="configure-security-composing-store-sent-encrypted">
1656 <guilabel>Store sent messages encrypted</guilabel><!--
1659 This option enables a mode of using mail encryption
1660 that is sometimes (misleadingly) called
1661 <quote>transport-only</quote> encryption. In this mode
1662 of operation, the message encryption is stripped off
1663 as soon as the message has reached its
1664 destination. The encryption lasts only while the
1665 message is on its way.
1668 &kmail; supports this mode half-heartedly, since such
1669 functionality should better placed at the mail
1670 <emphasis>server</emphasis> (<acronym>MTA</acronym>)
1671 than at the mail <emphasis>client</emphasis>
1672 (<acronym>MUA</acronym>) level. Thus, future versions
1673 of &kmail; may drop support for this option.
1679 If checked, messages are stored in your
1680 <guilabel>sent-mail</guilabel> folder just as you sent
1681 them (&ie; if they were encrypted, they are also stored
1685 If unchecked, messages will <emphasis>always</emphasis>
1686 be stored unencrypted in your
1687 <guilabel>sent-mail</guilabel> folder, even if they are
1693 <varlistentry id="configure-security-composing-show-encryption-key">
1695 <guilabel>Always show the encryption keys for approval</guilabel>
1699 If checked, every time you encrypt a message, a dialog
1700 will appear that presents you with the encryption keys
1701 that will be used for each recipient. You can then
1702 review the choice of keys, change them, and approve or
1703 cancel the encryption operation. We recommend to keep
1704 this option checked, since it makes the encryption
1705 process more transparent.
1710 <varlistentry id="configure-security-composing-opportunistic-encryption">
1712 <guilabel>Automatically encrypt messages whenever possible</guilabel>
1716 Also called <quote>opportunistic encryption</quote>. If
1717 checked, &kmail; will try to match recipients to
1718 (&openpgp; or &smime;) keys even when you did
1719 <emphasis>not</emphasis> specifically request
1720 encryption. If usable keys are found for all recipients,
1721 &kmail; will ask whether or not you want to encrypt the
1725 It is highly recommended to turn this on, as it makes
1726 encrypting messages really easy to use.
1731 <varlistentry id="configure-security-composing-never-sign-encrypt-drafts">
1733 <guilabel>Never sign/encrypt when saving as draft</guilabel>
1737 If checked, &kmail; will not attempt to sign and/or
1738 encrypt messages that are merely saved to the
1739 <guilabel>drafts</guilabel> folder. This is more
1740 convenient, and does not result in a gross loss of
1741 security, provided the drafts folder is safe. &imap;
1742 users might want this option turned off, if their
1743 <guilabel>drafts</guilabel> folder is on the server.
1752 <sect2 id="configure-security-warnings">
1758 On this tab you can switch security-relevant warnings on and
1764 <varlistentry id="configure-security-warnings-warn-send-unsigned">
1766 <guilabel>Warn when trying to send unsigned messages</guilabel>
1770 If checked, &kmail; will show a warning if for whatever
1771 reason a message would be sent without being digitally
1777 <varlistentry id="configure-security-warnings-warn-send-unencrypted">
1779 <guilabel>Warn when trying to send unencrypted messages</guilabel>
1783 If checked, &kmail; will show a warning if for whatever
1784 reason a message would be sent without being encrypted.
1788 While it is common to sign all outgoing messages,
1789 encrypting them is not. So unless your company has a
1790 policy of never sending any unencrypted messages, it
1791 might be a good idea to keep this option switched off
1793 linkend="configure-security-composing-opportunistic-encryption">opportunistic
1794 encryption</link> to alert you if you
1795 <emphasis>could</emphasis> send encrypted messages,
1796 but did not request it.
1802 <varlistentry id="configure-security-warnings-warn-receiver-email-not-in-cert">
1804 <guilabel>Warn if receiver's email address is not in certificate</guilabel>
1808 If checked, &kmail; will emit a warning if an &smime;
1809 certificate or &openpgp; key will be used for a recipient
1810 whose email address is not listed in the email addresses
1811 stored in the certificate.
1814 Situations in which this warning will trigger include
1815 when configuring your per-identity &openpgp; keys or
1816 &smime; certificates, when encrypting, and when verifying
1817 signatures, if the signature was made with a certificate
1818 that does not include the email address of the sender.
1823 <varlistentry id="configure-security-warnings-warn-near-expire">
1825 <guilabel>Warn if certificates/keys expire soon</guilabel>
1829 If checked, &kmail; will warn when an &smime; certificate
1830 or &openpgp; key is used which will expire soon.
1833 The period in which to warn before key/certificate
1834 expiration can then be configured separately for signing
1835 and encryption keys, as well as (in the case of &smime;),
1836 for end-user certificates, intermediate
1837 <acronym>CA</acronym> certificates and root
1846 <varlistentry id="configure-security-warnings-reenable-all-warnings">
1848 <guilabel>Re-Enable All "Don't Ask Again" Warnings</guilabel>
1852 Apart from the main warnings described above, there are
1853 more warning and information messages, which contain an
1854 option to not show them again. If you would like to
1855 re-enable them after choosing not to show them again,
1856 you can achieve this by pressing this button.<!--
1859 This will re-enable <emphasis>all</emphasis> such
1860 warnings for &kmail;. It does not make much sense to
1861 allow more fine-grained selection of which warnings
1862 to show since you can just check the option to
1863 suppress them again when they next show up.
1874 <sect2 id="configure-security-smime-validation">
1875 <!-- copy of section configuration-smime-validation from kleopatra docbook
1876 keep in sync, both apps have the same page in settings-->
1882 This tab contains selected entries from &gpgsm;'s <!--link
1883 linkend="configure-security-crypto-backends-configure">dynamic
1884 backend configuration dialog</link-->. Please refer
1885 to the &gpgsm; manual for a description of these options.
1890 <varlistentry id="configure-smime-validation-certificate-crls">
1892 <guilabel>Validate certificates using CRLs</guilabel>
1896 If checked, &smime; certificates are validated using
1897 Certificate Revocation Lists (<acronym>CRLs</acronym>).
1902 <varlistentry id="configure-smime-validation-certificate-ocps">
1904 <guilabel>Validate certificates online (OCSP)</guilabel>
1908 If this option is selected, &smime; certificates are validated
1909 using the Online Certificates Status Protocol
1910 (<acronym>OCSP</acronym>).
1913 Fill in the &URL; of the <acronym>OCSP</acronym>
1914 responder in the field reserved at this effect.
1919 <varlistentry id="configure-smime-online-certificate-responder-url">
1921 <guilabel>OCSP responder &URL;</guilabel>
1925 Enter the address of the server for online validation
1926 of certificates. The &URL;
1927 is usually starting with <emphasis>http://</emphasis>.
1932 <varlistentry id="configure-smime-online-certificate-responder-signature">
1934 <guilabel>OCSP responder signature</guilabel>
1938 Select or change and enter the &smime; key to use.
1943 <varlistentry id="configure-smime-online-certificate-responder-ignore">
1945 <guilabel>Ignore service &URL; of certificates</guilabel>
1949 Check this option to skip online validation using the OCSP.
1950 This Option requires <emphasis>dirmngr >= 0.9.0</emphasis>.
1955 <varlistentry id="configure-smime-certificate-validation-policies">
1957 <guilabel>Do not check certificate policies</guilabel>
1961 By default, <guilabel>GnuPG</guilabel> uses the file
1962 <emphasis>~/.gnupg/policies.txt</emphasis> to check if a
1963 certificate policy is allowed. If this option is selected,
1964 policies are not checked.
1969 <varlistentry id="configure-smime-certificate-validation-consult-crls">
1971 <guilabel>Never consult a CRLs</guilabel>
1975 If this option is checked, Certificate Revocation Lists are
1976 never used to validate &smime; certificates.
1981 <varlistentry id="configure-smime-certificate-validation-fetch-issuer">
1983 <guilabel>Fetch missing issuer certificates</guilabel>
1987 Check this option if you want the missing issuer certificates
1988 to be fetched when necessary. This applies to both validation
1989 methods, <acronym>CRLs</acronym> and <acronym>OCSP</acronym>.
1994 <varlistentry id="configure-smime-certificate-http-requests">
1996 <guilabel>Do not perform any &HTTP; requests</guilabel>
2000 Entirely disables the use of &HTTP; for
2006 <varlistentry id="configure-smime-certificate-http-ignore-distribution-point">
2008 <guilabel>Ignore &HTTP; CRL Distribution Point of certificates</guilabel>
2012 When looking for the location of a CRL,
2013 the <quote>to-be-tested</quote> certificate usually contains
2014 what are known as CRL Distribution Point (<acronym>DP</acronym>) entries,
2015 which are &URL;s describing the way to access
2016 the &URL;. The first found <acronym>DP</acronym>
2018 With this option all entries using the &HTTP;
2019 scheme are ignored when looking for a suitable
2020 <acronym>DP</acronym>.
2025 <varlistentry id="configure-smime-certificate-http-proxy">
2027 <guilabel>Use system &HTTP; proxy</guilabel>
2031 If this option is selected, the value of the
2032 &HTTP; proxy shown on the right
2033 (which comes from the environment variable <varname>http_proxy</varname>)
2034 will be used for any &HTTP; request.
2039 <varlistentry id="configure-smime-certificate-http-requests-proxy">
2041 <guilabel>Use this proxy for &HTTP; requests</guilabel>
2045 Enter here the location of your &HTTP; Proxy,
2046 which will be used for all &HTTP; requests
2048 The syntax is <quote>host:port</quote>, for instance
2049 <emphasis>myproxy.nowhere.com:3128</emphasis>.
2054 <varlistentry id="configure-smime-certificate-ldap-requests">
2056 <guilabel>Do not perform any LDAP requests</guilabel>
2060 Entirely disables the use of LDAP for
2066 <varlistentry id="configure-smime-certificate-ldap-distribution-point">
2068 <guilabel>Ignore LDAP CRL Distribution Point of certificates</guilabel>
2072 When looking for the location of a <acronym>CRL</acronym>,
2073 the <quote>to-be-tested</quote> certificate usually contains
2074 what are known as CRL Distribution Point (<acronym>DP</acronym>) entries,
2075 which are &URL;s describing the way to access
2077 The first found <acronym>DP</acronym> entry is used.
2078 With this option all entries using the <acronym>LDAP</acronym>
2079 scheme are ignored when looking for a suitable
2080 <acronym>DP</acronym>.
2085 <varlistentry id="configure-smime-certificate-ldap-proxy-host">
2087 <guilabel>Primary host for LDAP requests</guilabel>
2091 Entering a <acronym>LDAP</acronym> server here will make all
2092 <acronym>LDAP</acronym> requests go to that server first.
2093 More precisely, this setting overrides any specified host
2094 and port part in a <acronym>LDAP</acronym> &URL; and will also
2095 be used if host and port have been omitted from the
2096 &URL;. Other <acronym>LDAP</acronym> servers
2097 will be used only if the connection to the
2098 <emphasis>proxy</emphasis> failed.
2099 The syntax is <acronym>HOST</acronym> or
2100 <acronym>HOST:PORT</acronym>. If <acronym>PORT</acronym> is
2101 omitted, <quote>port 389</quote>
2102 (standard <acronym>LDAP</acronym> port) is used.
2109 </sect1> <!-- configure-security -->
2111 <sect1 id="configure-misc">
2112 <title>Misc Page</title>
2114 <sect2 id="configure-misc-folders">
2115 <title>Folders</title>
2120 <term><guilabel>Ask for confirmation before moving all messages to trash</guilabel></term>
2122 <para>Enable this option if you want to be asked for confirmation whenever
2123 you use <menuchoice><guimenu>Folder</guimenu><guimenuitem>Move All to Trash</guimenuitem></menuchoice>.</para>
2128 <term><guilabel>Exclude important messages from expiry</guilabel></term>
2130 <para>Enable this option if important messages should never be deleted
2131 during message expiration, &ie; during automatic deletion of old
2136 <varlistentry id="configure-misc-folders-go-unread">
2137 <term><guilabel>When trying to find unread messages</guilabel></term>
2139 <para>This option controls what happens if you press one of the shortcuts to
2140 go to the next or previous unread message (⪚ <keycap>Space</keycap>).
2141 If you ask &kmail; to go to the next unread message although there is no
2142 unread message below the currently selected message then the following happens:
2145 <para>If <guilabel>Do not Loop</guilabel> is selected then nothing will happen.
2149 <para>If <guilabel>Loop in Current Folder</guilabel> is selected then &kmail;
2150 will search from the beginning of the current folder for an unread message. If
2151 none is found then nothing happens.</para>
2154 <para>If <guilabel>Loop in All Folders</guilabel> is selected then &kmail;
2155 will first search in the current folder for another unread message. If none
2156 is found then &kmail; will search the next folder containing unread messages.
2160 Correspondingly, if you ask &kmail; to go to the previous unread message.
2167 <term><guilabel>When entering a folder</guilabel></term>
2169 <para>This option controls what happens if you open a folder.
2172 <para>If <guilabel>Jump to First Unread Message</guilabel> is selected then &kmail; will
2173 select the first message it finds that is marked as unread.
2177 <para>If <guilabel>Jump to Last Selected Message</guilabel> is selected then &kmail; will select
2178 the message that was selected when the folder was open the last time.
2182 <para>If <guilabel>Jump to Newest Message</guilabel> is selected then &kmail; will select the newest
2187 <para>If <guilabel>Jump to Oldest Message</guilabel> is selected then &kmail; will select the oldest
2198 <term><guilabel>Mark selected message as read after...</guilabel></term>
2200 <para>When you select a <guilabel>new</guilabel> or
2201 <guilabel>unread</guilabel> message, &kmail; will change the
2202 message's status to <guilabel>read</guilabel> after the number of seconds
2203 entered here. If you disable this option, messages will keep their
2204 <guilabel>new</guilabel> or <guilabel>unread</guilabel> status.</para>
2209 <term><guilabel>Ask for action after dragging messages to another folder</guilabel></term>
2211 <para>When you drag a message to a different folder, a small popup will ask
2212 you if you want to move or copy the message. If you disable this option,
2213 the message will be moved immediately, without a popup.</para>
2217 <!-- not in kmail 2.0.96 varlistentry>
2218 <term><guilabel>By default, message folders on disk are...</guilabel></term>
2220 <para>Here you can set the default <link linkend="folders-format">folder format</link>
2221 that is used when you create a new folder.</para>
2226 <term><guilabel>Open this folder on startup</guilabel></term>
2228 <para>Here you can set the folder that should be selected by default if you
2229 start &kmail;. If you use only &imap; folders then you might want to set
2230 this to your &imap; inbox folder. If you do that, you can collapse the local
2231 folders in the folder list, and then they will stay collapsed when &kmail;
2237 <term><guilabel>Empty trash on program exit</guilabel></term>
2239 <para>The trash folder is cleared of messages when you quit &kmail; if this
2240 option is selected.</para>
2248 <sect2 id="configure-misc-invitation">
2249 <title>Invitations</title>
2254 <term><guilabel>Mangle From:/To: headers in replies to invitations</guilabel></term>
2256 <para>Enable this option to make <application>&Microsoft; Outlook</application> understand your answers to invitations replies.</para>
2260 <term><guilabel>Send invitations in the mail body</guilabel></term>
2262 <para>Invitations are usually sent as attachments to a mail. When this option is enabled, invitation are sent in the text of the mail, which is necessary to send invitations and replies to <application>&Microsoft; Outlook</application>.</para>
2266 <term><guilabel>Exchange compatible invitations naming</guilabel></term>
2268 <para><application>&Microsoft; Outlook</application>, when used in combination with a &Microsoft; Exchange
2269 server, has a problem understanding standards-compliant groupware e-mail.
2270 Enable this option to send groupware invitations in a way that &Microsoft;
2271 Exchange understands. The invitation will be sent as an attachment with name <filename>ical.ics</filename>.</para>
2275 <term><guilabel>Outlook compatible invitation reply comments</guilabel></term>
2277 <para>When the user provides comments when responding to invitations, send the comment in a way that <application>&Microsoft; Outlook</application> understands. If this option is not enabled, the response comments will not be seen in Outlook.</para>
2281 <term><guilabel>Show invitation update differences in the Outlook style</guilabel></term>
2283 <para>When viewing updated invitations, this option enables the differences between the previous
2284 and current invitations to be displayed in a way very much like <application>&Microsoft; Outlook</application>.
2285 This is the default. The user can turn this option off if they want to see the invitation
2286 update differences shown in the <quote>classic</quote> &kmail; style.
2291 <term><guilabel>Automatic invitation sending</guilabel></term>
2293 <para>When this is checked, you will not see the mail composer window. Instead,
2294 all invitation mails are sent automatically. If you want to see the mail
2295 before sending it, you can uncheck this option. However, be aware that the
2296 text in the composer window is in iCalendar syntax, and you should not try
2297 modifying it by hand.</para>
2301 <term><guilabel>Delete invitation emails after the reply to them has been sent</guilabel></term>
2303 <para>When this is checked, received invitation emails that have been replied to
2304 will be moved to the Trash folder, once the reply has been successfully sent.</para>
2312 <sect1 id="configure-non-gui-options">
2313 <title>Options without a user interface representation</title>
2315 Apart from the options presented in the configuration dialog, some options
2316 can only be set directly in the &kmail; configuration file or through KIOSK.
2317 These so called <quote>hidden</quote> configuration options cannot be changed via
2318 the normal &kmail; Settings dialog; they must be made by modifying the
2319 configuration file using a text editor or the <command>kwriteconfig</command>
2324 The &kmail; configuration file is called <filename>kmailrc</filename>
2325 and can be found in your home directory. The location can vary according
2326 to your operating system or distribution, but can always be found by running
2327 the command <userinput><command>kde4-config --path config --locate kmailrc</command></userinput>.
2328 For the remainder of this section, assume that the configuration file is
2329 located in <filename>/path/to/kmailrc</filename>.
2333 Whenever changing these options, make sure to quit &kmail; first before
2334 editing the configuration file. Only restart &kmail; after you have made
2335 <emphasis>and saved</emphasis> the changes to the configuration file.
2341 <term><guilabel>Send Message Distribution Notifications with an empty sender string (SendMDNsWithEmptySender)</guilabel></term>
2344 Send Message Disposition Notifications with an empty sender string. Some servers might be configured to reject
2345 such messages, so if you are experiencing problems sending MDNs, make sure this option is set to false. To
2346 enable this feature, add a line reading:
2348 SendMDNsWithEmptySender=true
2350 to the [MDN] section of the &kmail; configuration file. If there is no such section, simply add <quote>[MDN]</quote> on
2351 a line by itself just above the option.
2353 Note that the default setting of <quote>false</quote> strictly speaking violates Internet standards, but is
2354 set that way for practical reasons, to avoid servers rejecting MDNs that &kmail;
2355 generates because they think they are SPAM.
2358 <prompt>%</prompt> <userinput><command>kwriteconfig</command> <option>--file <replaceable>/path/to/kmailrc</replaceable> --group MDN --key SendMDNsWithEmptySender true</option></userinput>
2364 <term><guilabel>MaximumAttachmentSize</guilabel></term>
2367 This allows the maximum filesize allowed for attachments in the mail
2368 composer to be limited.
2370 To limit attachments to 20 MB in size, for example, add a line reading (under [Composer] section):
2372 <programlisting>MaximumAttachmentSize=20
2375 <prompt>%</prompt> <userinput><command>kwriteconfig</command> <option>--file <replaceable>/path/to/kmailrc</replaceable> --group Composer --key MaximumAttachmentSize 20</option></userinput>
2381 <term><guilabel>CloseDespiteSystemTray</guilabel></term>
2384 This option allows you to configure the application to close fully, even if there
2385 is a system tray icon configured, which would normally keep the application running.
2387 To enable the feature, add a line reading (under [General] section):
2389 <programlisting>CloseDespiteSystemTray=true
2392 <prompt>%</prompt> <userinput><command>kwriteconfig</command>
2393 <option>--file <replaceable>/path/to/kmailrc</replaceable> --group General --key CloseDespiteSystemTray true</option></userinput>
2399 <term><guilabel>CheckOutOfOfficeOnStartup</guilabel></term>
2402 With this option enabled, &kmail; will check on every startup if there is an
2403 active out-of-office configured and show a warning if this is the case.
2405 To disable the feature, add a line reading (under [OutOfOffice] section):
2407 <programlisting>CheckOutOfOfficeOnStartup=false
2410 <prompt>%</prompt> <userinput><command>kwriteconfig</command>
2411 <option>--file <replaceable>/path/to/kmailrc</replaceable> --group OutOfOffice --key CheckOutOfOfficeOnStartup false</option></userinput>
2417 <term><guilabel>Allow out-of-office settings to be adjusted by the user.</guilabel></term>
2420 In case you don't want users to be able to upload their own out-of-office scripts to
2421 the server you can add:
2423 <programlisting>AllowOutOfOfficeSettings=false
2424 </programlisting><para>
2425 to the [OutOfOffice] section of the &kmail; configuration file. If there is no such section, simply add <quote>[OutOfOffice]</quote> on
2426 a line by itself just above the option.
2432 <term><guilabel>Allow out-of-office scripts to be uploaded by the user, but no settings changed.</guilabel></term>
2435 If you want to allow your users to upload their own out-of-office scripts but you do not want them to be
2436 able to change the domain to react to and the react-to-spam setting, you can add:
2438 <programlisting>AllowOutOfOfficeUploadButNoSettings=true
2439 </programlisting><para>
2440 to the [OutOfOffice] section of the &kmail; configuration file. If there is no such section, simply add <quote>[OutOfOffice]</quote> on
2441 a line by itself just above the option.
2447 <term><guilabel>Default domain to limit out-of-office replies to.</guilabel></term>
2450 When editing vacation (out-of-office) scripts, the user can specify a domain to
2451 limit the sending of such replies to. To pre-load this setting with a default
2454 <programlisting>OutOfOfficeDomain=myMailDomain.test
2455 </programlisting><para>
2456 to the [OutOfOffice] section of the &kmail; configuration file. If there is no such section, simply add <quote>[OutOfOffice]</quote> on
2457 a line by itself just above the option.
2459 Applying defaults to the out-of-office configuration dialog via the corresponding
2460 button will restore this domain, in case the user has changed it.
2466 <term><guilabel>Enable sending of out-of-office replies to messages marked as SPAM.</guilabel></term>
2469 By default, out-of-office replies are not sent to messages marked as SPAM. To override this
2472 <programlisting>OutOfOfficeReactToSpam=true
2473 </programlisting><para>
2474 to the [OutOfOffice] section of the &kmail; configuration file. If there is no such section, simply add <quote>[OutOfOffice]</quote> on
2475 a line by itself just above the option.
2477 Applying defaults to the out-of-office configuration dialog via the corresponding
2478 button will restore this setting, in case the user has changed it.
2484 <term><guilabel>disregardUmask</guilabel></term>
2487 In versions prior to 1.9, &kmail; saved all attachments
2488 to disk with permissions set to 600 — only readable or writable
2489 by the owner of the file. In response to user feedback, this was made
2490 configurable in &kmail; version 1.9, with the defaults changed to
2491 honour the umask set on the user account while saving files to disk.
2493 To enable this feature, add a line reading (under [General] section):
2495 <programlisting>disregardUmask=true
2498 <prompt>%</prompt> <userinput><command>kwriteconfig</command> <option>--file <replaceable>/path/to/kmailrc</replaceable> --group General --key disregardUmask true</option></userinput>
2504 <term><guilabel>AutoLostFoundMove</guilabel></term>
2505 <listitem><para>Activate this option to automate the handling of not yet uploaded messages in disconnected IMAP
2506 folders that cannot be uploaded. This can happen if the folder was removed from the server or your access
2507 rights have been restricted. Such messages will automatically be moved to a newly created lost+found folder if
2508 this option is enabled; you will be asked how to proceed every time otherwise.
2514 <term><guilabel>ShowUserAgent</guilabel></term>
2517 Starting in version 1.9, &kmail; can show the User-Agent or X-Mailer value
2518 from the message header when using Fancy Headers (see <menuchoice><guimenu>View</guimenu>
2519 <guisubmenu>Headers</guisubmenu></menuchoice> menu).
2521 To enable this feature, add a line reading (under [Reader] section):
2523 <programlisting>ShowUserAgent=true
2526 <prompt>%</prompt> <userinput><command>kwriteconfig</command> <option>--file <replaceable>/path/to/kmailrc</replaceable> --group Reader --key ShowUserAgent true</option></userinput>