diff options
Diffstat (limited to 'doc/kmail/configure.docbook')
| -rw-r--r-- | doc/kmail/configure.docbook | 205 |
1 files changed, 178 insertions, 27 deletions
diff --git a/doc/kmail/configure.docbook b/doc/kmail/configure.docbook index a66665ad3..7643b3562 100644 --- a/doc/kmail/configure.docbook +++ b/doc/kmail/configure.docbook @@ -648,7 +648,7 @@ so you can choose a monospaced font for the date field for better readability.</ quoted more than three times will appear in color. Note that the <guilabel>Quoted text</guilabel> colors only work in the message reader, not in the composer. If you want folders which are close to their quota -(space alotment, usually used on IMAP servers) to be displayed in a different color, +(space allotment, usually used on IMAP servers) to be displayed in a different color, you can specify a percentage value as a threshold for this. The color to be used can be configured along with the other custom colors.<!-- TODO --></para> @@ -657,6 +657,11 @@ can be configured along with the other custom colors.<!-- TODO --></para> <sect2 id="configure-appearance-layout"> <title>Layout</title> +<para>If the <guilabel>Close message window after replying or forwarding</guilabel> option is +activated, KMail will close the message window after replying to or forwarding the message that +is displayed in the window. This only applies to the separate message window, not to the embedded +message preview pane.</para> + <para><guilabel>Show HTML status bar</guilabel> activates a bar at the left side of the reader pane that tells you if a message is &html; or not. This is important because &html; messages might imitate the look of a signed and encrypted message, so @@ -777,6 +782,32 @@ folder will be selected in &kmail;'s main window. </para> </listitem> </varlistentry> + <varlistentry id="configure-composer-general-quote-selection-only"> + <term> + <guilabel>Only quote selected text when repyling</guilabel> + </term> + <listitem> + <para> + If checked, &kmail; will quote only the selected text in the message window, + instead of the complete message, when replying. + With this, it is possible to quickly generate replies that quote only the relevant + paragraph to which you are actually replying, and omits the other paragraphs that are + not relevant to the context. + </para> + </listitem> + </varlistentry> + <varlistentry id="configure-composer-general-strip-signatures"> + <term> + <guilabel>Remove the signature when replying</guilabel> + </term> + <listitem> + <para> + If checked, &kmail; will remove the signature from the quoted text + when replying to a message. This is useful since it reduces the amount + of quoted text, which makes it easier to read the reply. + </para> + </listitem> + </varlistentry> <varlistentry id="configure-composer-general-auto-request-mdns"> <term> <guilabel>Automatically request message disposition notifications</guilabel> @@ -806,6 +837,19 @@ folder will be selected in &kmail;'s main window. </para> </listitem> </varlistentry> + <varlistentry id="configure-composer-general-too-many-recipients"> + <term> + <guilabel>Warn if the number of recipients is larger than</guilabel> + </term> + <listitem> + <para> + If the number of recipients is larger than this value, KMail will + warn and ask for a confirmation before sending the mail. + The default is to warn if there are more than <literal>5</literal> recipients. + This warning can be turned off. + </para> + </listitem> + </varlistentry> <varlistentry id="configure-composer-general-autosave-interval"> <term> <guilabel>Autosave interval</guilabel> @@ -819,6 +863,18 @@ folder will be selected in &kmail;'s main window. </para> </listitem> </varlistentry> + <varlistentry id="configure-composer-general-forwading-type"> + <term> + <guilabel>Default Forwarding Type</guilabel> + </term> + <listitem> + <para> + Lets you decide whether you want to forward messages inline or as an attachment by default. + This changes which type of forwarding mechanism is used when you click the toolbar icon or + when you activate the shortcut for forwarding. + </para> + </listitem> + </varlistentry> <varlistentry id="configure-composer-general-external-editor"> <term> <guilabel>External Editor</guilabel> @@ -1102,7 +1158,7 @@ of key words can be modified.</para> <para> Attaches the complete message to the disposition notification. Usually, this is overkill. It does - not add any valueable information that cannot be + not add any valuable information that cannot be deduced from the message headers alone, but people sometimes insist on this, since it is much easier for humans to correlate the content of the message @@ -1276,7 +1332,7 @@ of key words can be modified.</para> </term> <listitem> <para> - If checked, everytime you encrypt a message, a dialog + If checked, every time you encrypt a message, a dialog will appear that presents you with the encryption keys that will be used for each recipient. You can then review the choice of keys, change them, and approve or @@ -1335,7 +1391,7 @@ of key words can be modified.</para> </title> <para> - On this tab you can switch security-relavant warnings on and + On this tab you can switch security-relevant warnings on and off. </para> @@ -1386,7 +1442,7 @@ of key words can be modified.</para> <listitem> <para> If checked, &kmail; will emit a warning if an &smime; - certifciate or &openpgp; key will be used for a recipient + certificate or &openpgp; key will be used for a recipient whose email address is not listed in the email addresses stored in the certificate. </para> @@ -1698,7 +1754,7 @@ of key words can be modified.</para> backends. Below each backend entry, you can see what protocols (&openpgp; and/or &smime;) the backend supports. If a protocol is not listed, the backend does not support it. If it is - listed, but greyed out, the backend supports the protocol, but + listed, but grayed out, the backend supports the protocol, but some required programs were not found, or other errors occurred during initialization. If you press <guibutton>Rescan</guibutton>, a dialog box will appear that @@ -1793,12 +1849,39 @@ Correspondingly, if you ask &kmail; to go to the previous unread message. </varlistentry> <varlistentry> -<term><guilabel>Jump to first unread message when entering a folder</guilabel></term> + +<term><guilabel>When entering a folder</guilabel></term> +<listitem> +<para>This option controls what happens if you open a folder. +<itemizedlist> +<listitem> +<para>If <guilabel>Jump to First New Message</guilabel> is selected then &kmail; will select the +first message it finds that is marked as new. +</para> +</listitem> +<listitem> +<para>If <guilabel>Jump to First Unread or New Message</guilabel> is selected then &kmail; will +select the first message it finds that is marked either as new or as unread. +</para> +</listitem> +<listitem> +<para>If <guilabel>Jump to Last Selected Message</guilabel> is selected then &kmail; will select +the message that was selected when the folder was open the last time. +</para> +</listitem> +<listitem> +<para>If <guilabel>Jump to Newest Message</guilabel> is selected then &kmail; will select the newest +message by date. +</para> +</listitem> <listitem> -<para>If this option is enabled &kmail; will go to the first unread message -when you enter a folder; if it is not enabled, &kmail; will go to first -new message or, if there is no new message, to the message -that was selected when you last left the folder.</para> +<para>If <guilabel>Jump to Oldest Message</guilabel> is selected then &kmail; will select the oldest +message by date. +</para> +</listitem> +</itemizedlist> + +</para> </listitem> </varlistentry> @@ -1908,6 +1991,21 @@ option is selected.</para> <para>Invitations use to be send as attachments to a mail. By enabling this option, you let the invitation mails to be sent in the text of the mail, which is necessary to send invitations and replies to Microsoft Outlook(tm).</para> </listitem> </varlistentry> +<varlistentry> +<term><guilabel>Exchange compatible invitations naming</guilabel></term> +<listitem> +<para>Microsoft Outlook, when used in combination with a Microsoft Exchange +server, has a problem understanding standards-compliant groupware e-mail. +Enable this option to send groupware invitations in a way that Microsoft +Exchange understands. The invitation will be sent as an attachment with name <filename>ical.ics</filename>.</para> +</listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Outlook compatible invitation reply comments</guilabel></term> +<listitem> +<para>When the user provides comments when responding to invitations, send the comment in way that Microsoft Outlook(tm) understands. If this option is not enabled, the response comments will not be seen in Outlook.</para> +</listitem> +</varlistentry> </variablelist> </sect2> @@ -1934,7 +2032,7 @@ SendMDNsWithEmptySender=true to the [MDN] section of the kmail configuration file. If there is no such section, simply add "[MDN]" on a line by itself just above the option. -Note that the default setting of "false" strictly speaking violates internet standards, but is +Note that the default setting of "false" strictly speaking violates Internet standards, but is set that way for practical reasons, to avoid servers rejecting MDNs that KMail generates because they think they are SPAM. </para> @@ -1956,20 +2054,6 @@ The option is enabled by default. To disable the feature, add a line reading (un </varlistentry> <varlistentry> -<term><guilabel>ForwardingInlineByDefault</guilabel></term> -<listitem> -<para> -This option allows you to make inline forwarding the default forwarding method instead -of forwarding as attachement. - -To enable the feature, add a line reading (under [Composer] section): -</para> -<programlisting>ForwardingInlineByDefault=true -</programlisting> -</listitem> -</varlistentry> - -<varlistentry> <term><guilabel>MaximumAttachmentSize</guilabel></term> <listitem> <para> @@ -2011,6 +2095,73 @@ To disable the feature, add a line reading (under [OutOfOffice] section): </listitem> </varlistentry> +<varlistentry> +<term><guilabel>Allow out-of-office settings to be adjusted by the user.</guilabel></term> +<listitem> +<para> +In case you don't want users to be able to upload their own out-of-office scripts to +the server you can add: +</para> +<programlisting>AllowOutOfOfficeSettings=false +</programlisting><para> +to the [OutOfOffice] section of the kmail configuration file. If there is no such section, simply add "[OutOfOffice]" on +a line by itself just above the option. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Allow out-of-office scripts to be uploaded by the user, but no settings changed.</guilabel></term> +<listitem> +<para> +If you want to allow your users to upload their own out-of-office scripts but you do not want them to be +able to change the domain to react to and the react-to-spam setting, you can add: +</para> +<programlisting>AllowOutOfOfficeUploadButNoSettings=true +</programlisting><para> +to the [OutOfOffice] section of the kmail configuration file. If there is no such section, simply add "[OutOfOffice]" on +a line by itself just above the option. +</para> +</listitem> +</varlistentry> + + +<varlistentry> +<term><guilabel>Default domain to limit out-of-office replies to.</guilabel></term> +<listitem> +<para> +When editing vacation (out-of-office) scripts, the user can specify a domain to +limit the sending of such replies to. To pre-load this setting with a default +value, add +</para> +<programlisting>OutOfOfficeDomain=myMailDomain.test +</programlisting><para> +to the [OutOfOffice] section of the kmail configuration file. If there is no such section, simply add "[OutOfOffice]" on +a line by itself just above the option. + +Applying defaults to the out-of-office configuration dialog via the corresponding +button will restore this domain, in case the user has changed it. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Enable sending of out-of-office replies to messages marked as SPAM.</guilabel></term> +<listitem> +<para> +By default, out-of-office replies are not sent to messages marked as SPAM. To override this +behavior, add +</para> +<programlisting>OutOfOfficeReactToSpam=true +</programlisting><para> +to the [OutOfOffice] section of the kmail configuration file. If there is no such section, simply add "[OutOfOffice]" on +a line by itself just above the option. + +Applying defaults to the out-of-office configuration dialog via the corresponding +button will restore this setting, in case the user has changed it. +</para> +</listitem> +</varlistentry> <varlistentry> <term><guilabel>disregardUmask</guilabel></term> @@ -2030,7 +2181,7 @@ To enable the feature, add a line reading (under [General] section): <listitem><para>Activate this option to automate the handling of not yet uploaded messages in disconnected IMAP folders that can not be uploaded. This can happen if the folder was removed from the server or your access rights have been restricted. Such messages will automatically moved to a newly created lost+found folder if -this option is enabled, you will be ask how to proceed everytime otherwise. +this option is enabled, you will be ask how to proceed every time otherwise. To enable the feature, add a line reading: </para> |