Warning, /pim/kmail/doc/kmail2/menus.docbook is written in an unsupported language. File is not indexed.
0001 <chapter id="menus">
0002
0003 <chapterinfo>
0004 <authorgroup>
0005 <author>
0006 &Daniel.Naber;
0007 &Daniel.Naber.mail;
0008 </author>
0009 <author>
0010 &David.Rugge;
0011 &David.Rugge.mail;
0012 </author>
0013 <author>
0014 &Michel.Boyer;
0015 <email>michel@klaralvdalens-datakonsult.se</email>
0016 </author>
0017 <author>
0018 &Laurent.Montel;
0019 &Laurent.Montel.mail;
0020 </author>
0021 <author>
0022 &Scarlett.Clark;
0023 &Scarlett.Clark.mail;
0024 </author>
0025 <author>
0026 &David.Bryant;
0027 &David.Bryant.mail;
0028 </author>
0029
0030 <!-- TRANS:ROLES_OF_TRANSLATORS -->
0031 </authorgroup>
0032
0033 <date>2021-03-31</date>
0034 <releaseinfo>5.14.2 (Applications 20.04.2)</releaseinfo>
0035 </chapterinfo>
0036
0037 <title>Command and Menu Reference</title>
0038 <para>Each &kmail; specific menu item is discussed below. When there is a keyboard shortcut that
0039 performs a menu item function, the default shortcut is listed with the menu item.</para>
0040
0041 <sect1 id="reader-menu-items">
0042 <title>The &kmail; Reader Window</title>
0043
0044 <sect2 id="reader-file-menu">
0045 <title>File Menu</title>
0046 <screenshot>
0047 <screeninfo>The File Menu</screeninfo>
0048 <mediaobject>
0049 <imageobject>
0050 <imagedata fileref="readerfile.png" format="PNG"/>
0051 </imageobject>
0052 <textobject>
0053 <phrase>The File Menu</phrase>
0054 </textobject>
0055 <caption>
0056 <para>The File Menu</para>
0057 </caption>
0058 </mediaobject>
0059 </screenshot>
0060 <para> </para><!-- add whitespace -->
0061
0062 <variablelist>
0063 <varlistentry id="file-new">
0064 <term><menuchoice><guimenu>File</guimenu><guisubmenu>New ></guisubmenu></menuchoice></term>
0065 <listitem><para>Here you can choose to create one of four new items, as follows:</para>
0066
0067 <variablelist>
0068 <varlistentry id="reader-file-new-newmessage">
0069 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
0070 <guimenu>File</guimenu><guisubmenu>New</guisubmenu>
0071 <guimenuitem>New Message...</guimenuitem></menuchoice></term>
0072 <listitem><para>Compose a new message. This will open a Composer window, where you can write a new
0073 message.</para></listitem>
0074 </varlistentry>
0075
0076 <varlistentry id="reader-file-new-message-from-template">
0077 <term><menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
0078 <guisubmenu>Message from Template ></guisubmenu></menuchoice></term>
0079 <listitem><para>Creates a new message from a selected template. Please see
0080 <link linkend="new-compose-from-templates">Compose From Templates</link> for additional information on
0081 creating templates. If you do not have any templates saved, you will see <menuchoice>
0082 <guimenu>Message</guimenu><guisubmenu>Message from Template ></guisubmenu>
0083 <guimenuitem>(no templates)</guimenuitem></menuchoice>.</para></listitem>
0084 </varlistentry>
0085
0086 <varlistentry id="reader-add-folder">
0087 <term><menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu><guimenuitem>Add
0088 Folder...</guimenuitem></menuchoice></term>
0089 <listitem><para>Creates a new folder. The ensuing dialog will ask you to give the new folder
0090 a name. The new folder will be created as a subfolder of the currently selected folder.</para></listitem>
0091 </varlistentry>
0092
0093 <varlistentry id="reader-new-addressbook-contact">
0094 <term><menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
0095 <guimenuitem>New AddressBook Contact...</guimenuitem></menuchoice></term>
0096 <listitem><para>Launches the <ulink
0097 url="help:/kaddressbook/how-to-add-a-new-contact.html">New Contact</ulink>
0098 dialog, permitting you to add a new entry in &kaddressbook;.</para></listitem>
0099 </varlistentry>
0100 </variablelist>
0101 <para> </para><!-- add whitespace --></listitem>
0102 </varlistentry>
0103
0104 <varlistentry id="reader-file-open">
0105 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut>
0106 <guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice></term>
0107 <listitem><para>Opens saved email messages (.mbox files).</para></listitem>
0108 </varlistentry>
0109
0110 <varlistentry id="reader-open-recent">
0111 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Open Recent</guimenuitem></menuchoice></term>
0112 <listitem><para>Displays a list of recently opened messages. Only those messages that have been saved as
0113 .mbox files and subsequently opened will appear on this list. If no such files exist, this menu item
0114 will be grayed out.</para></listitem>
0115 </varlistentry>
0116
0117 <varlistentry id="reader-file-save-as">
0118 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
0119 <guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice></term>
0120 <listitem><para>Saves the currently displayed message to a <filename role="extension">.mbox</filename> file.
0121 This file includes all the headers and attachments, in &MIME; format. If you want to save it as a different
0122 format (⪚, as a <filename role="extension">.txt</filename> file), uncheck the <guilabel>Automatically select
0123 filename extension (.mbox)</guilabel> box, and add the filename extension before saving the file.</para></listitem>
0124 </varlistentry>
0125
0126 <varlistentry id="reader-file-export-pdf">
0127 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Export to PDF...</guimenuitem></menuchoice></term>
0128 <listitem><para>Exports the currently displayed message as a .pdf file.</para></listitem>
0129 </varlistentry>
0130
0131 <varlistentry id="reader-file-import-messages">
0132 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Import Messages...</guimenuitem></menuchoice></term>
0133 <listitem><para>Starts up the <application>PIM Import Tool</application> program.
0134 This application lets you import messages from several email clients into &kmail;.</para></listitem>
0135 </varlistentry>
0136
0137 <varlistentry id="reader-file-print-preview">
0138 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Print Preview...</guimenuitem></menuchoice></term>
0139 <listitem><para><action>Shows how your email will appear when printed.</action></para>
0140 <note><para>This will only be enabled if a printer has been configured, is online, and is
0141 available for use.</para></note>
0142 <para> </para><!-- add whitespace --></listitem>
0143 </varlistentry>
0144
0145 <varlistentry id="reader-file-print">
0146 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
0147 <guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice></term>
0148 <listitem><para>Displays a dialog that lets you print the currently displayed message.</para></listitem>
0149 </varlistentry>
0150
0151 <varlistentry id="reader-file-expire-all-folders">
0152 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Expire All Folders</guimenuitem></menuchoice></term>
0153 <listitem><para>Deletes old messages from all folders. Deletion will occur according to the rules in each
0154 folder's <link linkend="folders-properties-window">Properties dialog</link> (the default is not to delete old
0155 messages at all).</para>
0156 </listitem>
0157 </varlistentry>
0158
0159 <varlistentry id="reader-empty-all-trash-folders">
0160 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Empty All Trash Folders</guimenuitem></menuchoice></term>
0161 <listitem><para>Use this item to empty all trash folders, &ie;, the local trash folder and all trash folders that
0162 may exist on &IMAP; servers. Messages in Trash will be permanently deleted, and cannot be retrieved.</para></listitem>
0163 </varlistentry>
0164
0165 <varlistentry id="reader-work-offline">
0166 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Work Offline</guimenuitem></menuchoice></term>
0167 <listitem><para>Sets &kmail; to offline mode.
0168 This turns off all network jobs. This is useful when working without a network connection.
0169 When selected, this item will become <menuchoice><guimenu>File</guimenu><guimenuitem>Work
0170 Online</guimenuitem></menuchoice>, which must be selected to go back online (required to send
0171 and receive email).</para></listitem>
0172 </varlistentry>
0173
0174 <varlistentry id="reader-check-mail">
0175 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut>
0176 <guimenu>File</guimenu><guimenuitem>Check Mail</guimenuitem></menuchoice></term>
0177 <listitem><para>Checks for new messages in all your accounts.</para></listitem>
0178 </varlistentry>
0179
0180 <varlistentry id="reader-file-check-mail-in">
0181 <term><menuchoice><guimenu>File</guimenu><guisubmenu>Check Mail In ></guisubmenu></menuchoice></term>
0182 <listitem><para>Checks for new messages from a particular account; your accounts will be listed in a
0183 submenu.</para></listitem>
0184 </varlistentry>
0185
0186 <varlistentry id="reader-send-queued-messages">
0187 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Send Queued Messages</guimenuitem></menuchoice></term>
0188 <listitem><para>Sends the messages that are in your outbox. Messages can end up in your outbox because
0189 of transmission errors, or because you composed and attempted to send a message while offline. If there
0190 are no messages in your outbox, this menu item will be grayed out.</para></listitem>
0191 </varlistentry>
0192
0193 <varlistentry id="reader-send-queued-messages-via">
0194 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Send Queued Messages Via ></guimenuitem></menuchoice></term>
0195 <listitem><para>Sends the messages that are in your outbox via a specific outgoing account.
0196 This allows you to choose which server to use to send your queued messages. Servers must be configured in
0197 the Configure &kmail; dialog, under the <menuchoice><guiicon>Accounts</guiicon><guilabel>Sending</guilabel>
0198 </menuchoice> tab, to be listed here. If there are no messages in the outbox folder, this menu item
0199 will be grayed out.</para></listitem>
0200 </varlistentry>
0201
0202 <varlistentry id="reader-file-delayed">
0203 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Delayed Messages...</guimenuitem></menuchoice></term>
0204 <listitem><para>Starts the <ulink url="help:/akonadi_sendlater_agent">Akonadi Send Later
0205 Agent</ulink> dialog. Any messages queued for later delivery by the composer's <menuchoice>
0206 <guimenu>Message</guimenu><guimenuitem>Send Later</guimenuitem></menuchoice> option will appear in
0207 this dialog box. You can modify and / or delete them. Note that delayed messages are stored in the
0208 drafts folder, not in the outbox folder.</para></listitem>
0209 </varlistentry>
0210
0211 <varlistentry id="reader-file-followup">
0212 <term><menuchoice><guimenu>File</guimenu><guimenuitem>Followup Reminder Messages...</guimenuitem></menuchoice></term>
0213 <listitem><para>Starts the <ulink url="help:/akonadi_followupreminder_agent">Akonadi Followup Reminder
0214 Agent</ulink> dialog. Any followup reminder messages ("todos") created via the composer's <menuchoice>
0215 <guimenu>Options</guimenu><guimenuitem>Create Followup Reminder...</guimenuitem></menuchoice> function will
0216 appear in this dialog box. You can delete those messages with the &RMB; context menu.</para></listitem>
0217 </varlistentry>
0218
0219 <varlistentry id="reader-file-quit">
0220 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
0221 <guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice></term>
0222 <listitem><para>Exits &kmail;.</para></listitem>
0223 </varlistentry>
0224 </variablelist>
0225 <para> </para><!-- add whitespace -->
0226 </sect2>
0227
0228
0229 <sect2 id="reader-edit-menu">
0230 <title>Edit Menu</title>
0231 <screenshot>
0232 <screeninfo>The Edit Menu</screeninfo>
0233 <mediaobject>
0234 <imageobject>
0235 <imagedata fileref="readeredit.png" format="PNG"/>
0236 </imageobject>
0237 <textobject>
0238 <phrase>The Edit Menu</phrase>
0239 </textobject>
0240 <caption>
0241 <para>The Edit Menu</para>
0242 </caption>
0243 </mediaobject>
0244 </screenshot>
0245 <para> </para><!-- add whitespace -->
0246
0247 <para>If the menu item you are looking for is missing, please see <ulink
0248 url="help:/fundamentals/menus.html#menus-edit">Edit Menu</ulink> in &kde; Fundamentals.
0249 The items listed here are &kmail; specific.</para>
0250
0251 <variablelist>
0252
0253 <varlistentry id="reader-edit-copy-folder">
0254 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo></shortcut>
0255 <guimenu>Edit</guimenu><guimenuitem>Copy Folder</guimenuitem></menuchoice></term>
0256 <listitem><para>Creates an "Akonadi" pointer to the entire contents of the currently selected folder, and
0257 copies that pointer to the clipboard. A subsequent paste operation in a text editor will simply paste the
0258 pointer text. A subsequent paste operation in a &kmail; folder (or in the &dolphin; file manager) will
0259 create a second copy of the folder and its contents.</para></listitem>
0260 </varlistentry>
0261
0262 <varlistentry id="reader-edit-cut-folder">
0263 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
0264 <guimenu>Edit</guimenu><guimenuitem>Cut Folder</guimenuitem></menuchoice></term>
0265 <listitem><para>Creates an "Akonadi" pointer to the currently selected folder, and copies that pointer
0266 to the clipboard. A subsequent "paste" operation in a text editor or in &dolphin; will behave exactly like the
0267 preceding <guimenuitem>Copy Folder</guimenuitem> operation. A subsequent paste operation in &kmail; will move
0268 the folder and its contents to a different location (if pasted in some folder other than the originating
0269 folder).</para></listitem>
0270 </varlistentry>
0271
0272 <varlistentry id="reader-edit-copy-message">
0273 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo></shortcut>
0274 <guimenu>Edit</guimenu><guimenuitem>Copy Message</guimenuitem></menuchoice></term>
0275 <listitem><para>Creates an "Akonadi" pointer to the currently selected message(s), and copies that pointer
0276 to the clipboard. A subsequent paste operation in a text editor will simply paste the pointer text. A
0277 subsequent paste operation in a &kmail; folder (or in the &dolphin; file manager) will create a copy of
0278 the message(s), headers and all.</para></listitem>
0279 </varlistentry>
0280
0281 <varlistentry id="reader-edit-cut-message">
0282 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>X</keycap></keycombo></shortcut>
0283 <guimenu>Edit</guimenu><guimenuitem>Cut Message</guimenuitem></menuchoice></term>
0284 <listitem><para>Creates an "Akonadi" pointer to the currently selected message(s), and copies that pointer
0285 to the clipboard. A subsequent "paste" operation in a text editor or in &dolphin; will behave exactly like the
0286 preceding <guimenuitem>Copy Message</guimenuitem> operation. A subsequent paste operation in &kmail; will either
0287 create a second copy of the message(s) (if pasted in the originating folder) or move the message(s) to a different
0288 folder (if pasted in some folder other than the originating folder).</para></listitem>
0289 </varlistentry>
0290
0291 <varlistentry id="reader-edit-paste">
0292 <term><menuchoice><shortcut>&Ctrl;<keycap>V</keycap></shortcut>
0293 <guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice></term>
0294 <listitem><para>Pastes either the entire contents of a folder, or the contents of selected messages, depending
0295 on the operation that preceded the "paste". This operation cannot be used to paste selected text inside the
0296 reader window. If no copy / cut operation is pending, this option will be grayed out.</para></listitem>
0297 </varlistentry>
0298
0299 <varlistentry id="reader-edit-move-to-trash">
0300 <term><menuchoice><shortcut>∇</shortcut>
0301 <guimenu>Edit</guimenu><guimenuitem>Move to Trash</guimenuitem></menuchoice></term>
0302 <listitem><para>Moves the selected messages to the trash folder.
0303 If the selected messages are already in the trash folder, they will be permanently deleted.</para></listitem>
0304 </varlistentry>
0305
0306 <varlistentry id="reader-edit-move-thread-to-trash">
0307 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;∇</keycombo></shortcut>
0308 <guimenu>Edit</guimenu><guimenuitem>Move Thread to Trash</guimenuitem></menuchoice></term>
0309 <listitem><para>Moves the selected thread to the trash folder, ⪚, a conversation in a mailing list.</para></listitem>
0310 </varlistentry>
0311
0312 <varlistentry id="reader-edit-find-in-message">
0313 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
0314 <guimenu>Edit</guimenu><guimenuitem>Find in Message...</guimenuitem></menuchoice></term>
0315 <listitem><para>Searches the current message text for a string entered in
0316 the <guilabel>Find:</guilabel> textbox.</para></listitem>
0317 </varlistentry>
0318
0319 <varlistentry id="reader-edit-select-all-messages">
0320 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
0321 <guimenu>Edit</guimenu><guimenuitem>Select All Messages</guimenuitem></menuchoice></term>
0322 <listitem><para>Selects all messages in the current folder.</para></listitem>
0323 </varlistentry>
0324
0325 <varlistentry id="reader-edit-select-all-text">
0326 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut>
0327 <guimenu>Edit</guimenu><guimenuitem>Select All Text</guimenuitem></menuchoice></term>
0328 <listitem><para>Selects the text of the currently displayed message.</para></listitem>
0329 </varlistentry>
0330
0331 </variablelist>
0332 <para> </para><!-- add whitespace -->
0333 </sect2>
0334
0335
0336 <sect2 id="reader-view-menu">
0337 <title>View Menu</title>
0338 <screenshot>
0339 <screeninfo>The View Menu</screeninfo>
0340 <mediaobject>
0341 <imageobject>
0342 <imagedata fileref="readerview.png" format="PNG"/>
0343 </imageobject>
0344 <textobject>
0345 <phrase>The View Menu</phrase>
0346 </textobject>
0347 <caption>
0348 <para>The View Menu</para>
0349 </caption>
0350 </mediaobject>
0351 </screenshot>
0352 <para> </para><!-- add whitespace -->
0353
0354 <variablelist>
0355 <varlistentry id="reader-view-message-list">
0356 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Message List ></guisubmenu></menuchoice></term>
0357 <listitem><para>This submenu has the following options to change the appearance of the message list.</para>
0358
0359 <variablelist>
0360 <varlistentry id="reader-view-messagelist-sorting">
0361 <term><menuchoice><guisubmenu>Sorting ></guisubmenu></menuchoice></term>
0362 <listitem><para>Contains options to customize your sort order as follows:</para>
0363 <itemizedlist>
0364 <listitem><para><guilabel>Message Sort Order</guilabel> has several options, most of which are self-explanatory.
0365 The following options may not be immediately obvious, and deserve an explanation.</para>
0366 <itemizedlist>
0367 <listitem><para><guilabel>By Smart Sender/Receiver</guilabel> will display the receiver when you are
0368 viewing the sent-mail folder, and will display the sender when you are viewing the inbox.</para></listitem>
0369
0370 <listitem><para><guilabel>By Action Item Status</guilabel> and <guilabel>By Important Status</guilabel>.
0371 These flags need to be set before they can be sorted. Please see <link linkend="reader-mark-messages">Mark
0372 Messages</link> for more information on marking your messages.</para></listitem>
0373 </itemizedlist>
0374 </listitem>
0375
0376 <listitem><para><guilabel>Message Sort Direction</guilabel> and <guilabel>Group Sort Direction</guilabel>
0377 allow you to change the direction in which your messages/groups will be sorted, respectively. Note
0378 that the "Group" options are only available when messages are aggregated into groups.</para></listitem>
0379 <listitem><para><guilabel>Folder always Uses this Sort Order</guilabel> allows you to specify different
0380 sort settings for each folder.</para></listitem>
0381 </itemizedlist>
0382 </listitem>
0383 </varlistentry>
0384
0385 <varlistentry id="reader-view-messagelist-aggregation">
0386 <term><menuchoice><guisubmenu>Aggregation ></guisubmenu></menuchoice></term>
0387 <listitem><para>Lets you select an aggregation option. Please see the <link
0388 linkend="configure-appearance-message-list">Message List Appearance</link> tab (under <menuchoice>
0389 <guimenu>Settings</guimenu><guisubmenu>Configure &kmail;...</guisubmenu></menuchoice>) for more
0390 information on aggregation.</para></listitem>
0391 </varlistentry>
0392
0393 <varlistentry id="reader-view-messagelist-theme">
0394 <term><menuchoice><guisubmenu>Theme ></guisubmenu></menuchoice></term>
0395 <listitem><para>Lets you select a theme. Please see the <link
0396 linkend="configure-appearance-message-list">Message List Appearance</link> tab (under <menuchoice>
0397 <guimenu>Settings</guimenu><guisubmenu>Configure &kmail;...</guisubmenu></menuchoice>) for more
0398 information on themes.</para></listitem>
0399 </varlistentry>
0400
0401 <varlistentry id="reader-view-messagelist-create-new-tab">
0402 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></shortcut>
0403 <guisubmenu>Create New Tab</guisubmenu></menuchoice></term>
0404 <listitem><para>Creates a new tab on the tabbing toolbar. This tab will point to the folder you
0405 are viewing when the option is selected. If the tabbing toolbar is not yet visible, selecting this
0406 option will create it. The tabbing toolbar can be handy if you have many folders, but only a few of
0407 them are regularly accessed.</para></listitem>
0408 </varlistentry>
0409
0410 <varlistentry id="reader-view-messagelist-activate-next-tab">
0411 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&PgDn;</keycombo></shortcut>
0412 <guisubmenu>Activate Next Tab</guisubmenu></menuchoice></term>
0413 <listitem><para>Opens the folder associated with the next tab on the tabbing toolbar.</para></listitem>
0414 </varlistentry>
0415
0416 <varlistentry id="reader-view-messagelist-activate-previous-tab">
0417 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&PgUp;</keycombo></shortcut>
0418 <guisubmenu>Activate Previous Tab</guisubmenu></menuchoice></term>
0419 <listitem><para>Opens the folder associated with the previous tab on the tabbing toolbar.</para></listitem>
0420 </varlistentry>
0421
0422 <varlistentry id="reader-view-messagelist-move-tab-left">
0423 <term><menuchoice><guisubmenu>Move Tab Left</guisubmenu></menuchoice></term>
0424 <listitem><para>Reorders the tabs on the tabbing toolbar by shifting the active tab to the left.
0425 If that tab is already at the extreme left end, it will be moved to the right hand end position.</para></listitem>
0426 </varlistentry>
0427
0428 <varlistentry id="reader-view-messagelist-move-tab-right">
0429 <term><menuchoice><guisubmenu>Move Tab Right</guisubmenu></menuchoice></term>
0430 <listitem><para>Reorders the tabs on the tabbing toolbar by shifting the active tab to the right.
0431 If that tab is already at the extreme right end, it will be moved to the left hand end position.</para></listitem>
0432 </varlistentry>
0433
0434 <varlistentry id="reader-view-messagelist-close-tab">
0435 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo></shortcut>
0436 <guisubmenu>Close Tab</guisubmenu></menuchoice></term>
0437 <listitem><para><action>Closes the currently selected tab.</action></para></listitem>
0438 </varlistentry>
0439 </variablelist>
0440 <para> </para><!-- add whitespace -->
0441 </listitem>
0442 </varlistentry>
0443
0444 <varlistentry id="reader-view-headers">
0445 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Headers ></guisubmenu></menuchoice></term>
0446 <listitem><para>Selects your headers view. Please see <link linkend="using-header-options">Header
0447 Options</link> for details on the available header views.</para></listitem>
0448 </varlistentry>
0449
0450 <varlistentry id="reader-view-attachments">
0451 <term><menuchoice><guimenu>View</guimenu><guimenuitem>Attachments ></guimenuitem></menuchoice></term>
0452 <listitem><para>Changes the way attachments appear in the <guilabel>Message Preview Pane</guilabel>
0453 (independent of the &MIME; Tree). Please see <link linkend="using-attachment-view-options">Attachment
0454 Options</link> for details on viewing attachments.</para></listitem>
0455 </varlistentry>
0456
0457 <varlistentry id="reader-view-expand-thread-or-group">
0458 <term><menuchoice><shortcut><keycap>.</keycap></shortcut>
0459 <guimenu>View</guimenu><guimenuitem>Expand Thread / Group</guimenuitem></menuchoice></term>
0460 <listitem><para>This will display the thread of the current message, &ie;, all messages that
0461 are replies to the current message.</para></listitem>
0462 </varlistentry>
0463
0464 <varlistentry id="reader-view-collapse-thread-or-group">
0465 <term><menuchoice><shortcut><keycap>,</keycap></shortcut>
0466 <guimenu>View</guimenu><guimenuitem>Collapse Thread / Group</guimenuitem></menuchoice></term>
0467 <listitem><para>This will hide the thread of the current message, &ie;, it will hide all
0468 messages that are replies to the current message.</para></listitem>
0469 </varlistentry>
0470
0471 <varlistentry id="reader-view-expand-all-threads">
0472 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo></shortcut>
0473 <guimenu>View</guimenu><guimenuitem>Expand All Threads</guimenuitem></menuchoice></term>
0474 <listitem><para>Expands all threads in the current folder.</para></listitem>
0475 </varlistentry>
0476
0477 <varlistentry id="reader-view-collapse-all-threads">
0478 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo></shortcut>
0479 <guimenu>View</guimenu><guimenuitem>Collapse All Threads</guimenuitem></menuchoice></term>
0480 <listitem><para>Collapses all threads in the current folder.</para></listitem>
0481 </varlistentry>
0482
0483 <varlistentry id="reader-view-save-display-format">
0484 <term><menuchoice><guimenu>View</guimenu><guimenuitem>Save Display Format</guimenuitem></menuchoice></term>
0485 <listitem><para>This option is apparently supposed to save something somewhere, but it's not
0486 yet working correctly.</para></listitem>
0487 </varlistentry>
0488
0489 <varlistentry id="reader-view-restore-display-format">
0490 <term><menuchoice><guimenu>View</guimenu><guimenuitem>Restore Display Format</guimenuitem></menuchoice></term>
0491 <listitem><para>This option is apparently supposed to restore whatever the preceding "Save" option
0492 is supposed to save, but it's not yet working correctly, either.</para></listitem>
0493 </varlistentry>
0494
0495 <varlistentry id="reader-view-disable-emoticon">
0496 <term><menuchoice><guimenu>View</guimenu><guimenuitem>Disable Emoticon</guimenuitem></menuchoice></term>
0497 <listitem><para>Select this option to stop &kmail; from transforming <literal>:-)</literal>
0498 into <inlinemediaobject><imageobject><imagedata fileref="smile.png" format="PNG"/></imageobject>
0499 </inlinemediaobject>.</para></listitem>
0500 </varlistentry>
0501
0502 <varlistentry id="reader-view-use-fixed-font">
0503 <term><menuchoice><shortcut><keycap>X</keycap></shortcut>
0504 <guimenu>View</guimenu><guimenuitem>Use Fixed Font</guimenuitem></menuchoice></term>
0505 <listitem><para>Uses a fixed width (Monospace) font to display the messages in the current folder.
0506 The font to be used can be configured in the <link linkend="configure-appearance-fonts">Fonts</link>
0507 tab on the <guilabel>Appearance</guilabel> page of the &kmail; configuration dialog.</para></listitem>
0508 </varlistentry>
0509
0510 <varlistentry id="reader-view-set-encoding">
0511 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Set Encoding ></guisubmenu></menuchoice></term>
0512 <listitem><para>Lets you choose the character encoding to be used in the Message Pane.
0513 The default, <guilabel>Auto</guilabel>, should work in almost every case.</para></listitem>
0514 </varlistentry>
0515
0516 <varlistentry id="reader-view-zoom">
0517 <term><menuchoice><guimenu>View</guimenu><guisubmenu>Zoom ></guisubmenu></menuchoice></term>
0518 <listitem><para>This option lets you zoom in or out on every message displayed in the preview pane.</para>
0519 <para> </para><!-- add whitespace -->
0520 </listitem>
0521 </varlistentry>
0522 </variablelist>
0523
0524 </sect2>
0525
0526
0527 <sect2 id="reader-go-menu">
0528 <title>Go Menu</title>
0529 <screenshot>
0530 <screeninfo>The Go Menu</screeninfo>
0531 <mediaobject>
0532 <imageobject>
0533 <imagedata fileref="readergo.png" format="PNG"/>
0534 </imageobject>
0535 <textobject>
0536 <phrase>The Go Menu</phrase>
0537 </textobject>
0538 <caption>
0539 <para>The Go Menu</para>
0540 </caption>
0541 </mediaobject>
0542 </screenshot>
0543 <para> </para><!-- add whitespace -->
0544
0545 <variablelist>
0546 <varlistentry id="reader-go-jump-to-folder">
0547 <term><menuchoice><shortcut><keycap>J</keycap></shortcut>
0548 <guimenu>Go</guimenu><guimenuitem>Jump to Folder...</guimenuitem></menuchoice></term>
0549 <listitem><para>Shows a dialog box with a list of all your folders. Click on the folder
0550 you wish to view, and that folder will be opened for display in the message preview pane.</para></listitem>
0551 </varlistentry>
0552
0553 <varlistentry id="reader-go-next-message">
0554 <term><menuchoice><shortcut><keycap>N</keycap></shortcut>
0555 <guimenu>Go</guimenu><guimenuitem>Next Message</guimenuitem></menuchoice></term>
0556 <listitem><para>Selects the next message in the message list.
0557 The keyboard shortcut &Right; also performs this function.</para></listitem>
0558 </varlistentry>
0559
0560 <varlistentry id="reader-go-next-unread-message">
0561 <term><menuchoice><shortcut><keycap>+</keycap></shortcut>
0562 <guimenu>Go</guimenu><guimenuitem>Next Unread Message</guimenuitem></menuchoice></term>
0563 <listitem><para>Selects the next unread message in the message list.
0564 If there are no unread messages below the currently selected message, the behavior depends
0565 on the value of the <xref linkend="configure-misc-folders-go-unread"/> option.</para></listitem>
0566 </varlistentry>
0567
0568 <varlistentry id="reader-go-previous-message">
0569 <term><menuchoice><shortcut><keycap>P</keycap></shortcut>
0570 <guimenu>Go</guimenu><guimenuitem>Previous Message</guimenuitem></menuchoice></term>
0571 <listitem><para>Selects the previous message in the message list.</para></listitem>
0572 </varlistentry>
0573
0574 <varlistentry id="reader-go-previous-unread">
0575 <term><menuchoice><shortcut><keycap>−</keycap></shortcut>
0576 <guimenu>Go</guimenu><guimenuitem>Previous Unread Message</guimenuitem></menuchoice></term>
0577 <listitem><para>Selects the previous unread message in the message list.
0578 If there is no unread message above the currently selected message, then the behavior depends on the value of the
0579 <xref linkend="configure-misc-folders-go-unread"/> option.</para></listitem>
0580 </varlistentry>
0581
0582 <varlistentry id="reader-go-next-unread-folder">
0583 <term><menuchoice><shortcut><keycombo action="simul">&Alt;<keycap>+</keycap></keycombo></shortcut>
0584 <guimenu>Go</guimenu><guimenuitem>Next Unread Folder</guimenuitem></menuchoice></term>
0585 <listitem><para>Jumps to the next folder with unread messages.</para></listitem>
0586 </varlistentry>
0587
0588 <varlistentry id="reader-go-previous-unread-folder">
0589 <term><menuchoice><shortcut><keycombo action="simul">&Alt;<keycap>−</keycap></keycombo></shortcut>
0590 <guimenu>Go</guimenu><guimenuitem>Previous Unread Folder</guimenuitem></menuchoice></term>
0591 <listitem><para>Jumps to the previous folder with unread messages.</para></listitem>
0592 </varlistentry>
0593
0594 <varlistentry id="reader-go-next-unread-text">
0595 <term><menuchoice><shortcut>&Space;</shortcut>
0596 <guimenu>Go</guimenu><guimenuitem>Next Unread Text</guimenuitem></menuchoice></term>
0597 <listitem><para>Scrolls down if you are not yet at the bottom of a message, otherwise jumps to
0598 the next unread message.</para>
0599 <para> </para><!-- add whitespace --></listitem>
0600 </varlistentry>
0601 </variablelist>
0602
0603 </sect2>
0604
0605 <sect2 id="reader-folder-menu">
0606 <title>Folder Menu</title>
0607 <screenshot>
0608 <screeninfo>The Folder Menu</screeninfo>
0609 <mediaobject>
0610 <imageobject>
0611 <imagedata fileref="readerfolder.png" format="PNG"/>
0612 </imageobject>
0613 <textobject>
0614 <phrase>The Folder Menu</phrase>
0615 </textobject>
0616 <caption>
0617 <para>The Folder Menu</para>
0618 </caption>
0619 </mediaobject>
0620 </screenshot>
0621 <para> </para><!-- add whitespace -->
0622
0623 <variablelist>
0624 <varlistentry id="reader-folder-properties">
0625 <term><guimenu>Folder Properties</guimenu></term>
0626 <listitem><para>Opens the <link linkend="folders-properties-window">Folder Properties</link>
0627 dialog that lets you modify the properties of the current folder.</para></listitem>
0628 </varlistentry>
0629
0630 <varlistentry id="reader-folder-add-folder">
0631 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Add Folder...</guimenuitem></menuchoice></term>
0632 <listitem><para>Prompts you for a name, then creates a new folder as a subfolder of the current folder.
0633 This is exactly like <xref linkend="reader-add-folder" />.</para></listitem>
0634 </varlistentry>
0635
0636 <varlistentry id="reader-folder-mark-all-messages-as-read">
0637 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Mark All Messages as Read</guimenuitem></menuchoice></term>
0638 <listitem><para>Sets the status of all unread messages in the current folder to "read".</para></listitem>
0639 </varlistentry>
0640
0641 <varlistentry id="reader-folder-mark-all-messages-as-read-subfolder">
0642 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Mark All Messages as Read
0643 in This Folder and All its Subfolders</guimenuitem></menuchoice></term>
0644 <listitem><para>Sets the status of all unread messages in the current folder (and all its
0645 subfolders) to "read".</para></listitem>
0646 </varlistentry>
0647
0648 <varlistentry id="reader-folder-update-folder">
0649 <term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
0650 <guimenu>Folder</guimenu><guimenuitem>Update Folder</guimenuitem></menuchoice></term>
0651 <listitem><para>Checks whether new mail has arrived in the currently selected folder.</para>
0652 <note><para>This option only works in &IMAP; folders.</para></note>
0653 <para> </para><!-- add whitespace --></listitem>
0654 </varlistentry>
0655
0656 <varlistentry id="reader-folder-update-folder-and-all-its-subfolders">
0657 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo></shortcut>
0658 <guimenu>Folder</guimenu><guimenuitem>Update This Folder and All Its Subfolders</guimenuitem></menuchoice></term>
0659 <listitem><para>Checks whether new mail has arrived in the currently selected folder, or in any
0660 of its subfolders.</para>
0661 <note><para>This option only works in &IMAP; folders.</para></note>
0662 <para> </para><!-- add whitespace --></listitem>
0663 </varlistentry>
0664
0665 <varlistentry id="reader-folder-move-all-messages-to-trash">
0666 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Move All Messages to Trash</guimenuitem></menuchoice></term>
0667 <listitem><para>Moves all of the messages in the selected folder into the trash folder.</para>
0668 <note><para>This is only available if the currently selected folder is not a trash folder. If the
0669 currently selected folder is a trash folder, you will see <guilabel>Empty Trash</guilabel>, instead. Selecting
0670 that option will empty the trash by permanently deleting the messages in the trash folder.</para></note>
0671 <para> </para><!-- add whitespace --></listitem>
0672 </varlistentry>
0673
0674 <varlistentry id="reader-folder-delete-folder">
0675 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Delete Folder</guimenuitem></menuchoice></term>
0676 <listitem><para>Deletes the selected folder and all its contents. A warning message will be displayed.
0677 If the current folder is one of &kmail;'s pre-defined folders (inbox, &etc;), this menu item will
0678 be grayed out.</para></listitem>
0679 </varlistentry>
0680
0681 <varlistentry id="reader-folder-archive-folder">
0682 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Archive Folder...</guimenuitem></menuchoice></term>
0683 <listitem><para>Brings up a dialog so you can create an archive of the currently selected folder. Please see
0684 the <xref linkend="folder-archive" /> section of "Using &kmail;" for details.</para></listitem>
0685 </varlistentry>
0686
0687 <varlistentry id="reader-folder-remove-duplicate-messages">
0688 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo></shortcut>
0689 <guimenu>Folder</guimenu><guimenuitem>Remove Duplicate Messages</guimenuitem></menuchoice></term>
0690 <listitem><para>Searches the folder for duplicate messages and deletes them.</para></listitem>
0691 </varlistentry>
0692
0693 <varlistentry id="reader-folder-remove-duplicate-messages-subfolder">
0694 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Remove Duplicates in This Folder and
0695 All its Subfolder</guimenuitem></menuchoice></term>
0696 <listitem><para>Searches the folder, and its subfolders, for duplicate messages, then deletes the
0697 duplicates.</para></listitem>
0698 </varlistentry>
0699
0700 <varlistentry id="reader-folder-apply-filters-on-folder">
0701 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Apply Filters On Folder ></guimenuitem></menuchoice></term>
0702 <listitem><para>Applies selected filters (All, Spam, or Not Spam) to the currently selected folder.
0703 Please see the <link linkend="filter-dialog-id">Filter dialog</link> for more information on filters.</para></listitem>
0704 </varlistentry>
0705
0706 <varlistentry id="reader-folder-apply-filters-on-subfolders">
0707 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Apply Filters On Folder and All its
0708 Subfolders ></guimenuitem></menuchoice></term>
0709 <listitem><para>Applies selected filters (All, Spam, or Not Spam) to the currently selected folder, and to its subfolders.
0710 Please see the <link linkend="filter-dialog-id">Filter dialog</link> for more information on filters.</para></listitem>
0711 </varlistentry>
0712
0713 <varlistentry id="reader-folder-message-default-format">
0714 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Message Default Format ></guimenuitem></menuchoice></term>
0715 <listitem><para>Here you may select one of three options: <guilabel>Prefer &HTML; to Plain Text</guilabel>,
0716 <guilabel>Prefer Plain Text to &HTML;</guilabel>, or <guilabel>Use Global Setting</guilabel>.</para>
0717 <warning><para>For security reasons, we recommend you only select <guilabel>Prefer &HTML; to Plain Text</guilabel>
0718 in folders which can never contain untrusted messages.</para></warning>
0719 <para> </para><!-- add whitespace --></listitem>
0720 </varlistentry>
0721
0722 <varlistentry id="reader-folder-load-external-references">
0723 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Load External References</guimenuitem></menuchoice></term>
0724 <listitem><para>If you have &HTML; messages enabled (see above), then you will also have the option to have
0725 images and other resources linked from the web downloaded automatically.</para>
0726 <warning><para>This option is only available if <guilabel>Prefer &HTML; to Plain Text</guilabel>
0727 has been selected. If you turn this option on, and later decide to change <guimenuitem>Message Default
0728 Format</guimenuitem>, be sure to clear this checkbox before making the switch. There is a bug in &kmail;
0729 -- if the checkbox on this item has not been cleared, and this option has been grayed out, results are
0730 unpredictable.</para></warning>
0731 <para> </para><!-- add whitespace --></listitem>
0732 </varlistentry>
0733
0734 <varlistentry id="reader-folder-mailing-list-management">
0735 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Mailing List Management...</guimenuitem></menuchoice></term>
0736 <listitem><para>This opens the mailing list management dialog. This option is only available if
0737 the current folder contains messages from a mailing list. Please see the <link
0738 linkend="folders-properties-mailinglist">Mailing List dialog</link> for more
0739 information on mailing lists.</para></listitem>
0740 </varlistentry>
0741
0742 <varlistentry id="reader-folder-assign-shortcut">
0743 <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Assign Shortcut...</guimenuitem></menuchoice></term>
0744 <listitem><para>This lets you assign a keyboard shortcut to the currently selected folder.</para>
0745 <para> </para><!-- add whitespace --></listitem>
0746 </varlistentry>
0747 </variablelist>
0748
0749 </sect2>
0750
0751 <sect2 id="reader-message-menu">
0752 <title>Message Menu</title>
0753 <screenshot>
0754 <screeninfo>The Message Menu</screeninfo>
0755 <mediaobject>
0756 <imageobject>
0757 <imagedata fileref="readermessage.png" format="PNG"/>
0758 </imageobject>
0759 <textobject>
0760 <phrase>The Message Menu</phrase>
0761 </textobject>
0762 <caption>
0763 <para>The Message Menu</para>
0764 </caption>
0765 </mediaobject>
0766 </screenshot>
0767 <para> </para><!-- add whitespace -->
0768
0769 <variablelist>
0770 <varlistentry id="reader-message-new-message">
0771 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
0772 <guimenu>Message</guimenu><guimenuitem>New Message...</guimenuitem></menuchoice></term>
0773 <listitem><para>Opens the <link linkend="the-composer-window">composer window</link>
0774 so you can write a new message.</para></listitem>
0775 </varlistentry>
0776
0777 <varlistentry id="reader-message-new-message-to-mailing-list">
0778 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut>
0779 <guimenu>Message</guimenu><guimenuitem>New Message to Mailing-List...</guimenuitem></menuchoice></term>
0780 <listitem><para>Opens the composer window so you can write a new message.
0781 If the current folder holds a mailing list and has a posting address defined,
0782 that posting address will automatically be entered as the <guilabel>To:</guilabel> address
0783 when the composer window is opened. If the current folder does not contain a mailing list,
0784 this item will be grayed out.</para></listitem>
0785 </varlistentry>
0786
0787 <varlistentry id="reader-message-reply">
0788 <term><menuchoice><shortcut><keycap>R</keycap></shortcut>
0789 <guimenu>Message</guimenu><guimenuitem>Reply...</guimenuitem></menuchoice></term>
0790 <listitem><para>Opens the composer window, inserts quoted text from the currently selected message, and sets the
0791 <guilabel>To:</guilabel> field to either the mailing-list address (if you reply to a mailing-list message),
0792 or to the preferred reply-to address of the sender. If you want to control which address is set in the
0793 <guilabel>To:</guilabel> field, you should use <link linkend="reader-message-reply-special">Reply Special</link>.
0794 The sending identity will automatically be set to the identity to which this message was addressed.</para></listitem>
0795 </varlistentry>
0796
0797 <varlistentry id="reader-message-reply-all">
0798 <term><menuchoice><shortcut><keycap>A</keycap></shortcut>
0799 <guimenu>Message</guimenu><guimenuitem>Reply to All...</guimenuitem></menuchoice></term>
0800 <listitem><para>Opens the composer window, inserts the quoted text of the currently
0801 selected message, and sets the <guilabel>To:</guilabel> field to either the
0802 mailing-list address (when replying to a mailing-list message), or to the
0803 preferred reply-to address of the sender. The <guilabel>Copy to (CC):</guilabel>
0804 field is filled with the addresses of all the other recipients of the currently
0805 selected message, excluding your own address. The sending identity will automatically
0806 be set to the identity to which this message was addressed.</para>
0807 <para> </para><!-- add whitespace --></listitem>
0808 </varlistentry>
0809
0810 <varlistentry id="reader-message-reply-special">
0811 <term><menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>A</keycap></keycombo></shortcut>
0812 <guimenu>Message</guimenu><guisubmenu>Reply Special ></guisubmenu><guimenuitem>Reply to Author...</guimenuitem>
0813 </menuchoice></term>
0814 <listitem><para>Opens the composer window, inserts the quoted text from the currently
0815 selected message, and sets the <guilabel>To:</guilabel> field to the
0816 preferred reply-to address of the sender. The sending identity will automatically be set
0817 to the identity to which this message was addressed.</para></listitem>
0818 </varlistentry>
0819
0820 <varlistentry id="reader-message-reply-special-reply-to-mailinglist">
0821 <term><menuchoice><shortcut><keycap>L</keycap></shortcut>
0822 <guimenu>Message</guimenu><guisubmenu>Reply Special ></guisubmenu><guimenuitem>Reply to Mailing-List...</guimenuitem>
0823 </menuchoice></term>
0824 <listitem><para>Opens the composer window, inserts the quoted text of the currently
0825 selected message, and sets the <guilabel>To:</guilabel> field to the mailing-list address.
0826 If you did not specify a mailing-list address for the currently selected folder and &kmail;
0827 cannot determine the posting address from the currently selected message, the <guilabel>To:</guilabel>
0828 field will be empty. The sending identity will automatically be set to the identity to which this
0829 message was addressed.</para></listitem>
0830 </varlistentry>
0831
0832 <varlistentry id="reader-message-reply-special-reply-without-quote">
0833 <term><menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>R</keycap></keycombo></shortcut>
0834 <guimenu>Message</guimenu><guisubmenu>Reply Special ></guisubmenu><guimenuitem>Reply Without Quote...</guimenuitem>
0835 </menuchoice></term>
0836 <listitem><para>Works just like <guimenuitem>Reply...</guimenuitem>, except that the text of the currently
0837 selected message is not quoted.</para></listitem>
0838 </varlistentry>
0839
0840 <varlistentry id="reader-message-reply-special-reply-with-custom-template">
0841 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Reply Special ></guisubmenu>
0842 <guimenuitem>Reply With Custom Template</guimenuitem></menuchoice></term>
0843 <listitem><para>Works just like <guimenuitem>Reply...</guimenuitem> with an added option: you may select a custom
0844 template configured via <link linkend="configure-composer-custom-templates">Custom Templates</link>.</para></listitem>
0845 </varlistentry>
0846
0847 <varlistentry id="reader-message-reply-special-reply-to-all-with-custom-template">
0848 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Reply Special ></guisubmenu>
0849 <guimenuitem>Reply to All With Custom Template</guimenuitem></menuchoice></term>
0850 <listitem><para>Works just like <guimenuitem>Reply to All...</guimenuitem> with an added option: you may select a custom
0851 template configured via <link linkend="configure-composer-custom-templates">Custom Templates</link>.</para>
0852 <para> </para><!-- add whitespace --></listitem>
0853 </varlistentry>
0854
0855 <varlistentry id="reader-message-forward-as-attachment">
0856 <term><menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>F</keycap></keycombo></shortcut>
0857 <guimenu>Message</guimenu><guisubmenu>Forward ></guisubmenu><guimenuitem>As Attachment</guimenuitem>
0858 </menuchoice></term>
0859 <listitem><para>Forwards the message to a new recipient. The message and its attachments will be attached to the
0860 new message. The original message headers will be included in the forwarded message.</para></listitem>
0861 </varlistentry>
0862
0863 <varlistentry id="reader-message-forward-inline">
0864 <term><menuchoice><shortcut><keycap>F</keycap></shortcut>
0865 <guimenu>Message</guimenu><guisubmenu>Forward ></guisubmenu><guimenuitem>Inline</guimenuitem></menuchoice></term>
0866 <listitem><para>The message's text and some important header fields will be copied to the body of the new message,
0867 with text marking where the forwarded part begins. Attachments will be attached to the new message.</para></listitem>
0868 </varlistentry>
0869
0870 <varlistentry id="reader-message-forward-redirect">
0871 <term><menuchoice><shortcut><keycap>E</keycap></shortcut>
0872 <guimenu>Message</guimenu><guisubmenu>Forward ></guisubmenu><guimenuitem>Redirect</guimenuitem></menuchoice></term>
0873 <listitem><para>This works like "Forward", except that the message stays the same (even the
0874 <guilabel>From:</guilabel> field). The user who redirected the message is identified by
0875 special header fields (<literal>Redirect-From</literal>, <literal>Redirect-Date</literal>,
0876 <literal>Redirect-To</literal>, &etc;).</para></listitem>
0877 </varlistentry>
0878
0879 <varlistentry id="reader-message-forward-with-custom-template">
0880 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Forward ></guisubmenu>
0881 <guimenuitem>With Custom Template</guimenuitem></menuchoice></term>
0882 <listitem><para>Works just like "Forward", but gives you the option to select a
0883 custom template configured via the composer custom templates tab in <link
0884 linkend="configure-composer-custom-templates">Custom Templates</link>.</para>
0885 <para> </para><!-- add whitespace --></listitem>
0886 </varlistentry>
0887
0888 <varlistentry id="reader-message-send-again">
0889 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Again...</guimenuitem></menuchoice></term>
0890 <listitem><para>Opens a composer window with the currently selected message so it can be sent again.</para>
0891 <note><para>This menu item is only available for messages which you have sent or, more precisely, for messages
0892 which have the <guilabel>sent</guilabel> status. If you wish to resend some other message, double-click its
0893 entry in the message list. Or view the message and use the <keycap>T</keycap> shortcut. You may also do this
0894 by adding an <guibutton>Edit as New</guibutton> button to the toolbar.</para></note>
0895 <para> </para><!-- add whitespace --></listitem>
0896 </varlistentry>
0897
0898 <!-- <varlistentry id="reader-message-edit-message">
0899 <term><menuchoice><shortcut><keycap>T</keycap></shortcut>
0900 <guimenu>Message</guimenu><guimenuitem>Edit Message</guimenuitem></menuchoice></term>
0901 <listitem><para>Opens the selected message in a composer window.</para></listitem>
0902 </varlistentry> -->
0903
0904 <varlistentry id="reader-message-mailing-list">
0905 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Mailing List Name: ></guimenuitem></menuchoice></term>
0906
0907 <listitem><para>Offers several options for mailing list messages.</para>
0908 <note><para>The current working folder must be configured as a mailing list for this
0909 option to be available. Please see <link linkend="folders-properties-mailinglist">Folder
0910 Properties Mailing List</link> to learn about setting up mailing lists.</para></note>
0911 <para> </para><!-- add whitespace -->
0912 <para>The following options are available in mailing list folders:</para>
0913
0914 <itemizedlist>
0915 <listitem><para><guimenuitem>Post New Message(email)</guimenuitem> will set the
0916 <guilabel>To:</guilabel> address to the address configured as "Post to List".</para></listitem>
0917 <listitem><para><guimenuitem>Request Help(email)</guimenuitem> will set the
0918 <guilabel>To:</guilabel> address to the address configured in "Post to List" and will place
0919 the word <literal>help</literal> in the <guilabel>Subject:</guilabel> field.</para></listitem>
0920 <listitem><para><guimenuitem>Subscribe to List(web)</guimenuitem> will point your default web browser
0921 to the "subscribe" web site of the configured mailing list.</para></listitem>
0922 <listitem><para><guimenuitem>Subscribe to List(email)</guimenuitem> will set the
0923 <guilabel>To:</guilabel> address to the mailing list subscription address, and place
0924 the word <literal>subscribe</literal> in the <guilabel>Subject:</guilabel> field.</para></listitem>
0925 <listitem><para><guimenuitem>Unsubscribe from List(web)</guimenuitem> will point your default web
0926 browser to the "unsubscribe" web site of the configured mailing list.</para></listitem>
0927 <listitem><para><guimenuitem>Unsubscribe from List(email)</guimenuitem> will set the
0928 <guilabel>To:</guilabel> address to the mailing list subscription address, and place the
0929 word <literal>unsubscribe</literal> in the <guilabel>Subject:</guilabel> field.</para></listitem>
0930 </itemizedlist>
0931
0932 <para> </para><!-- add whitespace --></listitem>
0933 </varlistentry>
0934
0935 <varlistentry id="reader-message-copy-message-to">
0936 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Copy Message To ></guisubmenu></menuchoice></term>
0937 <listitem><para>Copies the selected message(s) to a specified folder. You may choose from recent folders,
0938 local folders, or a specific &IMAP; account folder.</para></listitem>
0939 </varlistentry>
0940
0941 <varlistentry id="reader-message-move-message-to">
0942 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Move Message To ></guisubmenu></menuchoice></term>
0943 <listitem><para>The same as "Copy Message To", above, except this option will permanently move the
0944 selected message(s) to the chosen folder.</para>
0945 <para> </para><!-- add whitespace --></listitem>
0946 </varlistentry>
0947
0948 <varlistentry id="reader-mark-messages">
0949 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Mark Message ></guisubmenu></menuchoice></term>
0950 <listitem><para>Lets you change the status of the selected message to one of the following values:</para>
0951 <informaltable><tgroup cols="3">
0952 <thead><row><entry>Status</entry><entry>Symbol</entry><entry>Meaning</entry></row></thead>
0953
0954 <tbody>
0955 <row>
0956 <entry><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
0957 <guimenuitem>Mark Message as Read</guimenuitem></menuchoice></entry>
0958 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-read.png" format="PNG"/></imageobject>
0959 </inlinemediaobject></entry>
0960 <entry>The message has been read.</entry></row>
0961
0962 <row>
0963 <entry><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></shortcut>
0964 <guimenuitem>Mark Message as Unread</guimenuitem></menuchoice></entry>
0965 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-unread.png" format="PNG"/></imageobject>
0966 </inlinemediaobject></entry>
0967 <entry>The message has not been read yet.</entry></row>
0968
0969 <row>
0970 <entry><guimenuitem>Mark Message as Important</guimenuitem></entry>
0971 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-important.png" format="PNG"/></imageobject>
0972 </inlinemediaobject></entry>
0973 <entry>This status will not automatically be set by &kmail;.
0974 You can use it freely to mark messages that are in some way important to you.</entry></row>
0975
0976 <row>
0977 <entry><guimenuitem>Remove Important Mark</guimenuitem></entry>
0978 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-important.png" format="PNG"/></imageobject>
0979 </inlinemediaobject></entry>
0980 <entry>Removes a previously set important flag from the message.</entry></row>
0981
0982 <row>
0983 <entry><guimenuitem>Mark Message as Action Item</guimenuitem></entry>
0984 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-task.png" format="PNG"/></imageobject>
0985 </inlinemediaobject></entry>
0986 <entry>This status will not automatically be set by &kmail;. Use this to mark messages that are action
0987 items; ⪚, a to-do list.</entry></row>
0988
0989 <row><entry><guimenuitem>Remove Action Item Mark</guimenuitem></entry>
0990 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-task.png" format="PNG"/></imageobject>
0991 </inlinemediaobject></entry>
0992 <entry>Removes a previously set action item mark from the message.</entry></row>
0993 </tbody>
0994
0995 </tgroup></informaltable>
0996 <para> </para><!-- add whitespace --></listitem>
0997 </varlistentry>
0998
0999 <varlistentry id="reader-mark-thread">
1000 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Mark Thread</guisubmenu></menuchoice></term>
1001 <listitem><para>Lets you change the status of all messages in a thread as follows:</para>
1002 <informaltable><tgroup cols="3">
1003 <thead><row><entry>Status</entry><entry>Symbol</entry><entry>Meaning</entry></row></thead>
1004
1005 <tbody>
1006 <row>
1007 <entry><guimenuitem>Mark Thread as Read</guimenuitem></entry>
1008 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-read.png" format="PNG"/></imageobject>
1009 </inlinemediaobject></entry>
1010 <entry>The entire thread has been read.</entry></row>
1011
1012 <row>
1013 <entry><guimenuitem>Mark Thread as Unread</guimenuitem></entry>
1014 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-unread.png" format="PNG"/></imageobject>
1015 </inlinemediaobject></entry>
1016 <entry>The thread has not been read yet.</entry></row>
1017
1018 <row>
1019 <entry><guimenuitem>Mark Thread as Important</guimenuitem></entry>
1020 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-important.png" format="PNG"/></imageobject>
1021 </inlinemediaobject></entry>
1022 <entry>This status will not automatically be set by &kmail;. You can use it freely to mark threads
1023 that are in some way important to you.</entry></row>
1024
1025 <row>
1026 <entry><guimenuitem>Remove Important Thread Mark</guimenuitem></entry>
1027 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-important.png" format="PNG"/></imageobject>
1028 </inlinemediaobject></entry>
1029 <entry>Removes a previously set "important" flag from the thread.</entry></row>
1030
1031 <row>
1032 <entry><guimenuitem>Mark Thread as Action Item</guimenuitem></entry>
1033 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-task.png" format="PNG"/></imageobject>
1034 </inlinemediaobject></entry>
1035 <entry>This status will not automatically be set by &kmail;. Use this to mark threads that are
1036 action items (⪚, a to-do list).</entry></row>
1037
1038 <row>
1039 <entry><guimenuitem>Remove Action Item Thread Mark</guimenuitem></entry>
1040 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-task.png" format="PNG"/></imageobject>
1041 </inlinemediaobject></entry>
1042 <entry>Removes a previously set action item mark from the thread.</entry></row>
1043
1044 <row>
1045 <entry><guimenuitem>Watch Thread</guimenuitem></entry>
1046 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-thread-watch.png" format="PNG"/></imageobject>
1047 </inlinemediaobject></entry>
1048 <entry>Sets the watched thread status, which lets you easily view threads you're interested in by
1049 selecting the <guimenu>Watched</guimenu> status in the drop down box found in the Quick Search Bar.
1050 (Click on the <inlinemediaobject><imageobject><imagedata fileref="view-filter.png" format="PNG"/>
1051 </imageobject></inlinemediaobject> icon to display the filterable categories.)</entry></row>
1052
1053 <row>
1054 <entry><guimenuitem>Ignore Thread</guimenuitem></entry>
1055 <entry><inlinemediaobject><imageobject><imagedata fileref="mail-thread-ignored.png" format="PNG"/></imageobject>
1056 </inlinemediaobject></entry>
1057 <entry>Allows you to ignore entire threads.</entry></row>
1058 </tbody>
1059
1060 </tgroup></informaltable>
1061 <para> </para><!-- add whitespace --></listitem>
1062 </varlistentry>
1063
1064 <varlistentry id="message-create-filter">
1065 <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Create Filter</guisubmenu></menuchoice></term>
1066 <listitem><para>Opens the <link linkend="filter-dialog-id">Filter dialog</link> with a new filter added.
1067 This new filter is based on fields in the current message, depending on the submenu item you select:</para>
1068 <simplelist>
1069 <member>Filter on Subject...</member>
1070 <member>Filter on From...</member>
1071 <member>Filter on To...</member>
1072 <member>Filter on Mailing-List...(currently selected message must be a mailing list for this to be available).</member>
1073 </simplelist></listitem>
1074 </varlistentry>
1075
1076 <varlistentry id="reader-message-apply-filter">
1077 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Apply Filter</guimenuitem></menuchoice></term>
1078 <listitem><para>Lets you <guimenuitem>Apply all Filters</guimenuitem>. If you have spam filtering set up via
1079 the <link linkend="the-anti-spam-wizard">Anti-Spam Wizard</link>, the options <guimenuitem>Classify as
1080 Spam</guimenuitem> and <guimenuitem>Classify as NOT Spam</guimenuitem> will also be available here.</para></listitem>
1081 </varlistentry>
1082
1083 <!-- <varlistentry id="reader-message-create-to-do-reminder">
1084 <term><menuchoice>
1085 <guimenu>Message</guimenu>
1086 <guimenuitem>Create To-do/Reminder</guimenuitem>
1087 </menuchoice></term>
1088 <listitem><para><action>Brings up the &kontact; To-do/Reminder dialog</action> with options to add the selected email as a link, inline, or inline without attachments.</para></listitem>
1089 </varlistentry>
1090
1091 <varlistentry id="reader-message-add-note">
1092 <term><menuchoice>
1093 <guimenu>Message</guimenu>
1094 <guimenuitem>Add Note...</guimenuitem>
1095 </menuchoice></term>
1096 <listitem><para><action>Brings up the &kontact; Note dialog to add a note to the selected email.</action></para></listitem>
1097 </varlistentry> These items have been moved to "Plugins", and can now only be invoked via the Toolbar. @dcb2021086 -->
1098
1099 <varlistentry id="reader-message-viewsource">
1100 <term><menuchoice><shortcut><keycap>V</keycap></shortcut>
1101 <guimenu>Message</guimenu><guimenuitem>View Source</guimenuitem></menuchoice></term>
1102 <listitem><para>Shows the message and its complete headers in plain text format in a new window.
1103 This can help you figure out where a message really came from. </para>
1104 <note><para>You should be aware that it is easy to fake, or spoof, the <literal>From:</literal>
1105 header in a message. You can always find out which mail servers were used to send the message by
1106 examining the <literal>Received:</literal> lines in the message headers.</para></note>
1107 <para> </para></listitem>
1108 </varlistentry>
1109
1110 <varlistentry id="reader-show-message-structure">
1111 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>D</keycap></keycombo></shortcut>
1112 <guimenu>Message</guimenu><guimenuitem>Show Message Structure</guimenuitem></menuchoice></term>
1113 <listitem><para>Displays the structure viewer, an area below the preview pane that lets you
1114 view each &MIME; component of a message separately. This item will only be present if the <link
1115 linkend="configure-plugins-tools">Expert Plugin</link> has been activated.</para>
1116 <para> </para></listitem>
1117 </varlistentry>
1118 </variablelist>
1119
1120 </sect2>
1121
1122 <sect2 id="reader-tools-menu">
1123 <title>Tools Menu</title>
1124 <screenshot>
1125 <screeninfo>The Tools Menu</screeninfo>
1126 <mediaobject>
1127 <imageobject>
1128 <imagedata fileref="readertools.png" format="PNG"/>
1129 </imageobject>
1130 <textobject>
1131 <phrase>The Tools Menu</phrase>
1132 </textobject>
1133 <caption>
1134 <para>The Tools Menu</para>
1135 </caption>
1136 </mediaobject>
1137 </screenshot>
1138 <para> </para><!-- add whitespace -->
1139
1140 <variablelist>
1141
1142 <varlistentry id="reader-tools-find-messages">
1143 <term><menuchoice><shortcut><keycap>S</keycap></shortcut>
1144 <guimenu>Tools</guimenu><guimenuitem>Find Messages...</guimenuitem></menuchoice></term>
1145 <listitem><para>Opens a search window that lets you search for messages with certain characteristics,
1146 ⪚, a certain subject. Please see <link linkend="filter-criteria">Filter Criteria</link>
1147 for details on search options.</para>
1148 <para>Your search results will be displayed in the text area; you may either <guibutton>Open Search
1149 Folder</guibutton> to see a folder containing the messages that were located, or highlight the desired
1150 message and select <guibutton>Open Message</guibutton>. Additional actions are available via a context
1151 menu, which can be activated by clicking the &RMB;.</para></listitem>
1152 </varlistentry>
1153
1154 <varlistentry id="reader-tools-addressbook">
1155 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice></term>
1156 <listitem><para>Starts <ulink url="help:kaddressbook">&kaddressbook;</ulink>, the &kde; email
1157 address / personal contact information management program.</para></listitem>
1158 </varlistentry>
1159
1160 <varlistentry id="reader-tools-certificate-manager">
1161 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Certificate Manager</guimenuitem></menuchoice></term>
1162 <listitem><para>Starts <ulink url="help:kleopatra">&kleopatra;</ulink>, the &kde; certificate manager.</para></listitem>
1163 </varlistentry>
1164
1165 <varlistentry id="reader-tools-edit-out-of-office-replies">
1166 <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Edit "Out of Office" Replies...</guisubmenu></menuchoice></term>
1167 <listitem><para>Launches the <guilabel>Configure "Out of Office" Replies</guilabel> dialog, which allows you
1168 to set up vacation notifications.</para>
1169 <note><para><guilabel>Out of Office reply</guilabel> functionality relies on server-side filtering. To use it
1170 you must configure the <link linkend="receiving-mail">Filtering tab</link> (see options relevant to a &kolab; server)
1171 of your &IMAP; account set-up.</para></note>
1172 <para> </para></listitem>
1173 </varlistentry>
1174
1175 <!-- <varlistentry id="reader-tools-debug-sieve">
1176 <term><menuchoice>
1177 <guimenu>Tools</guimenu>
1178 <guisubmenu>Debug Sieve...</guisubmenu>
1179 </menuchoice></term>
1180 <listitem><para><action>Launch the <guilabel>Sieve Diagnostics</guilabel> dialog.</action> This is useful to debug sieve if you are having problems with it.</para>
1181 <note><para>You must have sieve support on your email server.</para></note></listitem>
1182 </varlistentry> -->
1183
1184 <varlistentry id="reader-tools-filter-log-viewer">
1185 <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Filter Log Viewer...</guisubmenu></menuchoice></term>
1186 <listitem><para>Opens the viewer window for the filter log; there you will find some options to
1187 control the logging of the filtering process. In the log you will find valuable
1188 information about the filter rules used, the result of evaluating those rules, and which
1189 filter actions were applied to a particular message.</para></listitem>
1190 </varlistentry>
1191
1192 <varlistentry id="reader-tools-import-messages">
1193 <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Import from another Email Client...</guisubmenu>
1194 </menuchoice></term>
1195 <listitem><para>Launches the Akonadi Import Wizard dialog, which assists in importing settings and email
1196 from a wide variety of email clients. Please see the <ulink url="help:/importwizard">Import Wizard</ulink>
1197 documentation for details.</para>
1198 <note><para>Close &kmail; before importing data. The wizard may modify &kmail;'s configuration file, and
1199 can cause unpredictable results if you attempt to import data while &kmail; is running.</para></note>
1200 <para> </para></listitem>
1201 </varlistentry>
1202
1203 <varlistentry id="reader-tools-export-data">
1204 <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Import/Export &kmail; Data...</guisubmenu></menuchoice></term>
1205 <listitem><para>Launches the PIM Data Exporter dialog, which assists in exporting your settings and email, or
1206 restoring them from a back up copy. Please see <ulink url="help:/pimdataexporter">Pim Data Exporter</ulink>
1207 for details.</para></listitem>
1208 </varlistentry>
1209
1210 <varlistentry id="reader-tools-activity-log">
1211 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Log Activities...</guimenuitem></menuchoice></term>
1212 <listitem><para>Starts the Activity Logger, which logs certain activities. This option is only available
1213 when the <guilabel>Log Activities</guilabel> plugin has been loaded. Primarily for developers.</para></listitem>
1214 </varlistentry>
1215
1216 <varlistentry id="reader-tools-anti-spam-wizard">
1217 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Anti-Spam Wizard...</guimenuitem></menuchoice></term>
1218 <listitem><para>Launches the Anti-Spam Wizard, which can help you set up spam filtering. Please
1219 see <link linkend="the-anti-spam-wizard">Anti-Spam Wizard</link> for details. This option is
1220 only available when the <guilabel>Antispam</guilabel> plugin has been loaded.</para></listitem>
1221 </varlistentry>
1222
1223 <varlistentry id="reader-tools-anti-virus-wizard">
1224 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Anti-Virus Wizard...</guimenuitem></menuchoice></term>
1225 <listitem><para>Launches the Anti-Virus Wizard, which can help you set up anti-virus scanning. Please
1226 see <link linkend="the-anti-virus-wizard">Anti-Virus Wizard</link> for details. This option is only
1227 available when the <guilabel>Antivirus</guilabel> plugin has been loaded.</para>
1228 <para> </para></listitem>
1229 </varlistentry>
1230 </variablelist>
1231 </sect2>
1232
1233
1234 <sect2 id="reader-settings-menu">
1235 <title>Settings Menu</title>
1236 <screenshot>
1237 <screeninfo>The Settings Menu</screeninfo>
1238 <mediaobject>
1239 <imageobject>
1240 <imagedata fileref="readersettings.png" format="PNG"/>
1241 </imageobject>
1242 <textobject>
1243 <phrase>The Settings Menu</phrase>
1244 </textobject>
1245 <caption>
1246 <para>The Settings Menu</para>
1247 </caption>
1248 </mediaobject>
1249 </screenshot>
1250 <para> </para><!-- add whitespace -->
1251
1252 <para>If the menu item you are looking for is missing, please see <ulink
1253 url="help:/fundamentals/menus.html#menus-settings">Settings Menu</ulink> in &kde;
1254 Fundamentals. The items listed here are &kmail; specific.</para>
1255 <variablelist>
1256
1257 <varlistentry id="reader-settings-show-quick-search-bar">
1258 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
1259 <guimenu>Settings</guimenu><guimenuitem>Show Quick Search bar</guimenuitem></menuchoice></term>
1260 <listitem><para>Enables the Quick Search bar, which lets you quickly search for messages matching
1261 your criteria.</para></listitem>
1262 </varlistentry>
1263
1264 <varlistentry id="reader-settings-configure-filters">
1265 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Filters...</guimenuitem></menuchoice></term>
1266 <listitem><para>Opens the <link linkend="filters">Message Filters</link> dialog.</para></listitem>
1267 </varlistentry>
1268
1269 <varlistentry id="settings-manage-sieve-scripts">
1270 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Manage Sieve Scripts...</guimenuitem></menuchoice></term>
1271 <listitem><para>If your mail server supports sieves (server side filtering), you may
1272 configure those scripts here.</para></listitem>
1273 </varlistentry>
1274
1275 <varlistentry id="settings-add-account">
1276 <term><menuchoice><guimenu>Settings</guimenu><guisubmenu>Add Account...</guisubmenu></menuchoice></term>
1277 <listitem><para>Starts the Account Wizard dialog, which assists in setting up new or additional accounts.
1278 Please see <link linkend="account-wizard">Account Wizard</link> for details.</para></listitem>
1279 </varlistentry>
1280
1281 <varlistentry id="reader-settings-configure-automatic-archiving">
1282 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Automatic
1283 Archiving...</guimenuitem></menuchoice></term>
1284 <listitem><para>Initiates a dialog to set up automatic archiving. See <ulink
1285 url="help:/akonadi_archivemail_agent">Automatic Archiving</ulink> for details.</para></listitem>
1286 </varlistentry>
1287
1288 <!-- <varlistentry id="reader-settings-configure-send-later-agent">
1289 <term><menuchoice>
1290 <guimenu>Settings</guimenu>
1291 <guimenuitem>Configure Send Later Agent...</guimenuitem>
1292 </menuchoice></term>
1293 <listitem><para><action>Brings up a dialog that allows you to modify and remove emails that have been sent using the send later feature.</action>
1294 Please see <ulink url="help:/akonadi_sendlater_agent">Send Later Agent</ulink> for details.</para></listitem>
1295 </varlistentry>
1296 <varlistentry id="reader-settings-configure-folder-archive-agent">
1297 <term><menuchoice>
1298 <guimenu>Settings</guimenu>
1299 <guimenuitem>Configure Folder Archive Agent...</guimenuitem>
1300 </menuchoice></term>
1301 <listitem><para><action>Brings up a dialog that allows you to configure accounts to use the folder archive agent feature with.</action>
1302 Please see <ulink url="help:/akonadi_folderarchive_agent">Folder Archive Agent</ulink> for details.</para></listitem>
1303 </varlistentry>
1304 <varlistentry id="reader-settings-configure-notifications">
1305 <term><menuchoice>
1306 <guimenu>Settings</guimenu>
1307 <guimenuitem>Configure Notifications...</guimenuitem>
1308 </menuchoice></term>
1309 <listitem><para><action>Opens a dialog that lets you configure what happens when new mail arrives,</action> ⪚ play a sound, display a popup, &etc;</para></listitem>
1310 </varlistentry> These three options have been moved to the Plugins Configuration tab. @dcb2021086. -->
1311
1312 <varlistentry id="reader-settings-configure-kmail">
1313 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kmail;...</guimenuitem></menuchoice></term>
1314 <listitem><para>Opens the <link linkend="configure">Configure &kmail;</link> dialog. There are
1315 hundreds of variables to play with. Have fun!</para>
1316 <para> </para></listitem>
1317 </varlistentry>
1318
1319 </variablelist>
1320 </sect2>
1321
1322 <sect2 id="reader-help-menu">
1323 <title>Help Menu</title>
1324 <screenshot>
1325 <screeninfo>The Help Menu</screeninfo>
1326 <mediaobject>
1327 <imageobject>
1328 <imagedata fileref="readerhelp.png" format="PNG"/>
1329 </imageobject>
1330 <textobject>
1331 <phrase>The Help Menu</phrase>
1332 </textobject>
1333 <caption>
1334 <para>The Help Menu</para>
1335 </caption>
1336 </mediaobject>
1337 </screenshot>
1338 <para> </para><!-- add whitespace -->
1339
1340 <para>This is the <ulink url="help:/fundamentals/menus.html#menus-help">Help
1341 Menu</ulink> of the &kde; Fundamentals, with one additional item.</para>
1342
1343 <variablelist>
1344 <varlistentry id="reader-help-intro">
1345 <term><menuchoice><guimenu>Help</guimenu><guimenuitem>&kmail; Introduction</guimenuitem></menuchoice></term>
1346 <listitem><para>Opens the <link linkend="intro">Introduction</link> welcome screen.</para></listitem>
1347 </varlistentry>
1348 </variablelist>
1349 </sect2>
1350 </sect1>
1351
1352 <sect1 id="composer-window-menus">
1353 <title>The &kmail; Composer Window</title>
1354
1355 <sect2 id="composer-file-menu">
1356 <title>Message Menu</title>
1357 <screenshot>
1358 <screeninfo>The Message Menu</screeninfo>
1359 <mediaobject>
1360 <imageobject>
1361 <imagedata fileref="composermessage.png" format="PNG"/>
1362 </imageobject>
1363 <textobject>
1364 <phrase>The Message Menu</phrase>
1365 </textobject>
1366 <caption>
1367 <para>The Message Menu</para>
1368 </caption>
1369 </mediaobject>
1370 </screenshot>
1371 <para> </para><!-- add whitespace -->
1372
1373 <variablelist>
1374 <varlistentry id="composer-message-new-composer">
1375 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
1376 <guimenu>Message</guimenu><guimenuitem>New Composer</guimenuitem></menuchoice></term>
1377 <listitem><para>Opens a new composer window so you can create a message.</para></listitem>
1378 </varlistentry>
1379
1380 <!-- <varlistentry id="composer-message-new-main-window">
1381 <term><menuchoice>
1382 <guimenu>Message</guimenu>
1383 <guimenuitem>New Main Window</guimenuitem>
1384 </menuchoice></term>
1385 <listitem><para><action>Creates a new main window.</action></para></listitem>
1386 </varlistentry>
1387
1388 <varlistentry id="composer-message-new-addressbook-contact">
1389 <term><menuchoice>
1390 <guimenu>Message</guimenu>
1391 <guimenuitem>New AddressBook Contact</guimenuitem>
1392 </menuchoice></term>
1393 <listitem><para><action>Brings up the &kontact; New Contact Dialog</action> to add a new contact your addressbook.</para></listitem>
1394 </varlistentry> Thes options not available in 5.14.2 @dcb2021088. -->
1395
1396 <varlistentry id="composer-message-send-mail">
1397 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Return</keycap></keycombo></shortcut>
1398 <guimenu>Message</guimenu><guimenuitem>Send Mail</guimenuitem></menuchoice></term>
1399 <listitem><para>Sends the message immediately. If you use &SMTP; to send your messages and the &SMTP;
1400 server is not reachable, the message will remain in the outbox and you will get an error message.
1401 After the connection issues have been resolved, you can send the messages in the outbox using <link
1402 linkend="reader-send-queued-messages"><menuchoice><guimenu>File</guimenu><guimenuitem>Send Queued
1403 Messages</guimenuitem></menuchoice></link> (in the reader window).</para></listitem>
1404 </varlistentry>
1405
1406 <varlistentry id="composer-message-send-mail-via">
1407 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Mail Via ></guimenuitem></menuchoice></term>
1408 <listitem><para>Allows you to specify which outgoing mail server will be used to send the message.</para></listitem>
1409 </varlistentry>
1410
1411 <varlistentry id="composer-message-send-later">
1412 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Later</guimenuitem></menuchoice></term>
1413 <listitem><para>Launches the send later dialog. Please see the <ulink url="help:/akonadi_sendlater_agent">Send
1414 Later</ulink> documentation for details.</para></listitem>
1415 </varlistentry>
1416
1417 <varlistentry id="composer-message-send-later-via">
1418 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Later Via ></guimenuitem></menuchoice></term>
1419 <listitem><para>Allows you to specify which outgoing mail server will be used
1420 to send the delayed message.</para></listitem>
1421 </varlistentry>
1422
1423 <varlistentry id="composer-message-save-as-file">
1424 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Save as File</guimenuitem></menuchoice></term>
1425 <listitem><para>Saves the message as a file. Three formats are supported: Rich Text (.html),
1426 plain text (.txt), and Open Document Format (.odt).</para></listitem>
1427 </varlistentry>
1428
1429 <varlistentry id="composer-message-save-as-draft">
1430 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
1431 <guimenu>Message</guimenu><guimenuitem>Save as Draft</guimenuitem></menuchoice></term>
1432 <listitem><para>Saves the message in the <guilabel>drafts</guilabel> folder
1433 so you can finish it later.</para></listitem>
1434 </varlistentry>
1435
1436 <varlistentry id="composer-message-save-as-template">
1437 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Template</guimenuitem></menuchoice></term>
1438 <listitem><para>Lets you save your message as a template. Please see <link
1439 linkend="new-compose-from-templates">Compose from templates</link> for more information.</para></listitem>
1440 </varlistentry>
1441
1442 <varlistentry id="composer-message-insert-text-file">
1443 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Insert Text File...</guimenuitem></menuchoice></term>
1444 <listitem><para>Inserts a text file into the message text, starting at the cursor position.</para></listitem>
1445 </varlistentry>
1446
1447 <varlistentry id="composer-message-insert-recent-text-file">
1448 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Insert Recent Text File ></guimenuitem></menuchoice></term>
1449 <listitem><para>Lets you choose from a list of recently inserted text files, and inserts that file into
1450 your message. Select <guimenuitem>Clear List</guimenuitem> to clear the list.</para></listitem>
1451 </varlistentry>
1452
1453 <varlistentry id="composer-message-print-preview">
1454 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Print Preview</guimenuitem></menuchoice></term>
1455 <listitem><para>Opens a print preview window and displays your message, formatted for printing.</para></listitem>
1456 </varlistentry>
1457
1458 <varlistentry id="composer-message-print">
1459 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
1460 <guimenu>Message</guimenu><guimenuitem>Print...</guimenuitem></menuchoice></term>
1461 <listitem><para>Formats and prints the message you have composed.</para></listitem>
1462 </varlistentry>
1463
1464 <varlistentry id="composer-message-share">
1465 <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Share Mail Text... ></guimenuitem></menuchoice></term>
1466 <listitem><para>Lets you make a second copy of your message somewhere else. Four options are provided:
1467 Nextcloud (an OSS file-sharing app), Pastebin <ulink url="https://pastebin.com">(a freely available web
1468 site)</ulink>, Bluetooth, and Email (opens another composer window, and adds the current message to that new
1469 message, as an attachment). This option is not available unless the <guilabel>Share Text</guilabel>
1470 plugin is active.</para></listitem>
1471 </varlistentry>
1472
1473 <varlistentry id="composer-message-close">
1474 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut>
1475 <guimenu>Message</guimenu><guimenuitem>Close</guimenuitem></menuchoice></term>
1476 <listitem><para>Closes this composer window.</para>
1477 <para> </para></listitem>
1478 </varlistentry>
1479 </variablelist>
1480
1481 </sect2>
1482
1483
1484 <sect2 id="composer-edit-menu">
1485 <title>Edit Menu</title>
1486 <screenshot>
1487 <screeninfo>The Edit Menu</screeninfo>
1488 <mediaobject>
1489 <imageobject>
1490 <imagedata fileref="composeredit.png" format="PNG"/>
1491 </imageobject>
1492 <textobject>
1493 <phrase>The Edit Menu</phrase>
1494 </textobject>
1495 <caption>
1496 <para>The Edit Menu</para>
1497 </caption>
1498 </mediaobject>
1499 </screenshot>
1500 <para> </para><!-- add whitespace -->
1501
1502 <para>If the menu item you are looking for is missing, please see the <ulink
1503 url="help:/fundamentals/menus.html#menus-edit">Edit Menu</ulink> section of the
1504 &kde; Fundamentals Handbook. The items listed here are &kmail; specific.</para>
1505
1506 <variablelist>
1507 <varlistentry id="composer-edit-paste-quotation">
1508 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></shortcut>
1509 <guimenu>Edit</guimenu><guimenuitem>Paste as Quotation</guimenuitem></menuchoice></term>
1510 <listitem><para>Pastes the text from the clipboard and marks it as a quotation (&ie;,
1511 each line preceded by ">" and a space).</para></listitem>
1512 </varlistentry>
1513
1514 <varlistentry id="composer-edit-paste-attachment">
1515 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste as Attachment</guimenuitem></menuchoice></term>
1516 <listitem><para>Pastes a file that has been copied to the clipboard (⪚, by using
1517 the &dolphin; file manager) as an attachment.</para></listitem>
1518 </varlistentry>
1519
1520 <varlistentry id="composer-edit-paste-without-formatting">
1521 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>V</keycap></keycombo></shortcut>
1522 <guimenu>Edit</guimenu><guimenuitem>Paste Without Formatting</guimenuitem></menuchoice></term>
1523 <listitem><para>Pastes data from the clipboard as plain text, with no &HTML; formatting.</para></listitem>
1524 </varlistentry>
1525
1526 <varlistentry id="composer-edit-clean-spaces">
1527 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Clean Spaces</guimenuitem></menuchoice></term>
1528 <listitem><para>This option supposedly replaces multiple adjacent newline characters or spaces with
1529 single line breaks / spaces, but in testing, it apparently does absolutely nothing.</para></listitem>
1530 </varlistentry>
1531
1532 <varlistentry id="composer-edit-add-quote-characters">
1533 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Add Quote Characters</guimenuitem></menuchoice></term>
1534 <listitem><para>Prepends each line of the selected text with the quotation indicator (> and a space, by
1535 default). If no selection is made, adds the indicator to every line in the message.</para></listitem>
1536 </varlistentry>
1537
1538 <varlistentry id="composer-edit-remove-quote-characters">
1539 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Remove Quote Characters</guimenuitem></menuchoice></term>
1540 <listitem><para>Removes the left-most quotation indicator from the selected text.</para></listitem>
1541 </varlistentry>
1542
1543 <varlistentry id="composer-edit-insert-email">
1544 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Insert Email...</guimenuitem></menuchoice></term>
1545 <listitem><para>Displays a list of all the names in your address book, then inserts the chosen email address at
1546 the cursor position (after you make a selection and click the <guibutton>OK</guibutton> button). This option
1547 is only available when the <guimenuitem>Insert Email</guimenuitem> plugin has been loaded.</para></listitem>
1548 </varlistentry>
1549
1550 <varlistentry id="composer-edit-insert-nbsp">
1551 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Space;</keycombo></shortcut>
1552 <guimenu>Edit</guimenu><guimenuitem>Insert Non Breaking Space</guimenuitem></menuchoice></term>
1553 <listitem><para>Inserts a non breaking space at the cursor position. This option is only available
1554 when the <guimenuitem>Insert Non Breaking Space</guimenuitem> plugin has been loaded.</para></listitem>
1555 </varlistentry>
1556
1557 <!-- <varlistentry id="composer-edit-uppercase">
1558 <term><menuchoice>
1559 <guimenu>Edit</guimenu>
1560 <guimenuitem>Uppercase</guimenuitem>
1561 </menuchoice></term>
1562 <listitem><para>Convert the selected text to uppercase.</para></listitem>
1563 </varlistentry>
1564
1565 <varlistentry id="composer-edit-lowercase">
1566 <term><menuchoice>
1567 <guimenu>Edit</guimenu>
1568 <guimenuitem>Lowercase</guimenuitem>
1569 </menuchoice></term>
1570 <listitem><para>Convert the selected text to lowercase.</para></listitem>
1571 </varlistentry> These optons have been consolidated in the "Change Case" plugin. @dcb2021089. -->
1572
1573 <varlistentry id="composer-edit-insert-special-character">
1574 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Insert Special Character...</guimenuitem></menuchoice></term>
1575 <listitem><para>Lets you insert a special character at the cursor position. A large number of Unicode
1576 characters are made available. This option is only provided if the <guimenuitem>Insert Special
1577 Character</guimenuitem> plugin has been activated.</para>
1578
1579 <para>This menu item was moved to the <guimenu>Insert</guimenu> menu in release 5.17. If you have activated
1580 the plugin, and this entry does not appear when &kmail; is restarted, check the <guimenu>Insert</guimenu>
1581 menu.</para></listitem>
1582 </varlistentry>
1583
1584 <varlistentry id="composer-edit-change-case">
1585 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Change Case ></guimenuitem></menuchoice></term>
1586 <listitem><para>Helps you modify the capitalization of the selected text. There are four options:
1587 <guilabel>Uppercase</guilabel> (capitalizes the selected characters), <guilabel>Lowercase</guilabel>
1588 (forces selected text to all lower case), <guilabel>Sentence case</guilabel> (capitalizes the first
1589 letter of the selection and makes the rest lower case), and <guilabel>Reverse Case</guilabel> (converts
1590 capital letters to lower case, and vice versa). This option is only provided if the <guimenuitem>Change
1591 Case</guimenuitem> plugin has been activated. This menu item remains grayed out until some snippet of
1592 text has been selected for modification.</para></listitem>
1593 </varlistentry>
1594
1595 <varlistentry id="composer-edit-zoom">
1596 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Zoom... ></guimenuitem></menuchoice></term>
1597 <listitem><para>Lets you zoom in or zoom out on the message you are composing. This is the same function
1598 appearing as <menuchoice><guimenu>View</guimenu><guisubmenu>Zoom ></guisubmenu></menuchoice> in
1599 the message preview window. This option is not available unless the <guimenuitem>Zoom Text</guimenuitem>
1600 plugin has been loaded.</para></listitem>
1601 </varlistentry>
1602
1603 <varlistentry id="composer-edit-variables">
1604 <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Variables ></guimenuitem></menuchoice></term>
1605 <listitem><para>Lets you insert the contents of a named field at the cursor position. You may choose
1606 among <guilabel>To ></guilabel>, <guilabel>From ></guilabel>, <guilabel>CC ></guilabel>,
1607 <guilabel>Attachment ></guilabel>, <guilabel>Date/Time ></guilabel>, and <guilabel>Misc ></guilabel>
1608 (which has just one associated submenu item, "Subject"). There is one notable quirk: the date/time displayed
1609 in the submenu selections is fixed at the time the Composer window was opened, but the value actually inserted
1610 in a message is taken from the system clock.</para>
1611 <para> </para></listitem>
1612 </varlistentry>
1613
1614 </variablelist>
1615
1616 </sect2>
1617
1618 <sect2 id="composer-view-menu">
1619 <title>View Menu</title>
1620 <screenshot>
1621 <screeninfo>The View Menu</screeninfo>
1622 <mediaobject>
1623 <imageobject>
1624 <imagedata fileref="composerview.png" format="PNG"/>
1625 </imageobject>
1626 <textobject>
1627 <phrase>The View Menu</phrase>
1628 </textobject>
1629 <caption>
1630 <para>The View Menu</para>
1631 </caption>
1632 </mediaobject>
1633 </screenshot>
1634 <para> </para><!-- add whitespace -->
1635
1636 <para>This menu lets you toggle the display of the header fields and a few other items in the
1637 composer window. Selected items will be marked (check box colored in) in the menu.</para>
1638
1639 <para>Several options are available:</para>
1640
1641 <itemizedlist>
1642 <listitem>
1643 <para><guimenuitem>All Fields</guimenuitem>. Displays all six of the following fields.</para>
1644 </listitem>
1645 <listitem>
1646 <para><guimenuitem>Identity</guimenuitem>. If you have defined more than one identity,
1647 this will be a drop down box.</para>
1648 </listitem>
1649 <listitem>
1650 <para><guimenuitem>Dictionary</guimenuitem> used for spell checking. If multiple dictionaries
1651 are installed, this will be a drop down box.</para>
1652 </listitem>
1653 <listitem>
1654 <para><guimenuitem>Sent-Mail Folder</guimenuitem>. The <guilabel> <inlinemediaobject><imageobject>
1655 <imagedata fileref="document-open.png" format="PNG"/></imageobject></inlinemediaobject> </guilabel>
1656 button appearing on the right when this option is checked opens a folder selection dialog.</para>
1657 </listitem>
1658 <listitem>
1659 <para><guimenuitem>Mail Transport</guimenuitem>. If you have created more than one outgoing
1660 account, this will be a drop down box.</para>
1661 </listitem>
1662 <listitem>
1663 <para><guimenuitem>From</guimenuitem>. The contents of this field may vary, depending on the Identity you use.</para>
1664 </listitem>
1665 <listitem>
1666 <para><guimenuitem>Subject</guimenuitem>. Use this field to describe your message, briefly.</para>
1667 </listitem>
1668 </itemizedlist>
1669
1670 <para>The <guilabel>To <inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject>
1671 </inlinemediaobject></guilabel> drop down box is always present at the top of the composer window. Use
1672 it to select <guilabel>CC</guilabel>, <guilabel>BCC</guilabel>, and <guilabel>Reply-To</guilabel>
1673 addresses, as needed. Please see <link linkend="composer-headers">Composer Headers</link> for
1674 further details on message headers.</para>
1675
1676 <para> </para>
1677
1678 <variablelist>
1679 <varlistentry id="composer-view-use-fixed-font">
1680 <term><menuchoice><guimenu>View</guimenu><guimenuitem>Use Fixed Font</guimenuitem></menuchoice></term>
1681 <listitem><para>Uses a fixed width (monospaced) font to display the currently
1682 edited message. The particular font to be used can be configured in the
1683 <guilabel>Appearance</guilabel> section of &kmail;'s configuration dialog.</para></listitem>
1684 </varlistentry>
1685
1686 <varlistentry id="composer-view-snippets">
1687 <term><menuchoice><guimenu>View</guimenu><guimenuitem>Snippets</guimenuitem></menuchoice></term>
1688 <listitem><para>Displays a column on the right hand side of the composer window that allows you to use and create
1689 snippets. Please see <link linkend="setup-text-snippets">Snippets</link> for more information.</para>
1690 <para> </para></listitem>
1691 </varlistentry>
1692
1693 </variablelist>
1694
1695 </sect2>
1696
1697 <sect2 id="composer-options-menu">
1698 <title>Options Menu</title>
1699 <screenshot>
1700 <screeninfo>The Options Menu</screeninfo>
1701 <mediaobject>
1702 <imageobject>
1703 <imagedata fileref="composeroptions.png" format="PNG"/>
1704 </imageobject>
1705 <textobject>
1706 <phrase>The Options Menu</phrase>
1707 </textobject>
1708 <caption>
1709 <para>The Options Menu</para>
1710 </caption>
1711 </mediaobject>
1712 </screenshot>
1713 <para> </para><!-- add whitespace -->
1714
1715 <para>This menu lets you toggle various options for the current message. Selected
1716 items will be marked (check box colored in) in the menu.</para>
1717
1718 <variablelist>
1719
1720 <varlistentry id="composer-options-urgent">
1721 <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Urgent</guimenuitem></menuchoice></term>
1722 <listitem><para>Sets the priority of the message to Urgent by inserting two header lines:
1723 "X-PRIORITY: 2 (High)" and "Priority: urgent". The receiver's email client must provide support
1724 for these headers; otherwise they will have no effect. &kmail; itself does not support priorities
1725 for incoming messages (although you can <link linkend="reader-mark-messages">mark messages</link>
1726 as Important).</para></listitem>
1727 </varlistentry>
1728
1729 <varlistentry id="composer-options-request-mdn">
1730 <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Request Disposition
1731 Notification</guimenuitem></menuchoice></term>
1732 <listitem><para>If you choose this option, &kmail; will
1733 insert a Disposition-Notification-To: header line in the
1734 message, which is a request to receive an email notification
1735 once your message has been downloaded and read by the recipient.
1736 This function must be supported, and enabled by the receiver's
1737 email client; otherwise, it will not work.</para>
1738 <para>See <xref linkend="configure-security-reading-mdns"/>
1739 for background information and several ways to customize the
1740 read receipts that &kmail; itself sends in response to a
1741 received Disposition-Notification-To: header line.</para></listitem>
1742 </varlistentry>
1743
1744 <varlistentry id="composer-options-request-confirm">
1745 <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Request Delivery
1746 Confirmation</guimenuitem></menuchoice></term>
1747 <listitem><para>If you choose this option, &kmail; will
1748 insert a Return-Receipt-To: header line in the message, which
1749 is a request to receive an email notification once your message
1750 has been uploaded by your email server and delivered to the
1751 recipient. This function must be supported by your outgoing
1752 email server; otherwise, it will not work.</para></listitem>
1753 </varlistentry>
1754
1755 <varlistentry id="composer-options-sign-message">
1756 <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Sign Message</guisubmenu></menuchoice></term>
1757 <listitem><para>Digitally signs the message using <application>OpenPGP</application> or an X.509 certificate.
1758 You can learn more about this option in the <link linkend="pgp">chapter on OpenPGP</link>.</para></listitem>
1759 </varlistentry>
1760
1761 <varlistentry id="composer-options-encrypt-message">
1762 <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Encrypt Message</guisubmenu></menuchoice></term>
1763 <listitem><para>Encrypts the message using <application>OpenPGP</application> or an X.509 certificate.
1764 You can learn more about encryption in the <link linkend="pgp">chapter on OpenPGP</link>.</para></listitem>
1765 </varlistentry>
1766
1767 <varlistentry id="composer-options-select-crypto-message-format">
1768 <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Cryptographic Message Format ></guisubmenu></menuchoice></term>
1769 <listitem><para>Lets you choose the cryptographic message format to use when
1770 digitally signing and/or encrypting this message. Please see <link
1771 linkend="cryptographic-message-formats">Cryptographic Message
1772 Formats</link> for more information.</para></listitem>
1773 </varlistentry>
1774
1775 <varlistentry id="composer-options-rich-text-editing">
1776 <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Rich Text Editing</guisubmenu></menuchoice></term>
1777 <listitem><para>Enables Rich Text (&ie;, &HTML;) editing.</para></listitem>
1778 </varlistentry>
1779
1780 <varlistentry id="composer-options-encoding">
1781 <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Encoding ></guisubmenu></menuchoice></term>
1782 <listitem><para>Sets the charset encoding of this message. The chosen encoding will be identified
1783 by a header line in the outgoing message. You can use <guilabel>Auto</guilabel> in almost every
1784 case; &kmail; will notify you if you must select a different encoding manually.</para></listitem>
1785 </varlistentry>
1786
1787 <varlistentry id="composer-options-wordwrap">
1788 <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Wordwrap</guimenuitem></menuchoice></term>
1789 <listitem><para>Toggles the automatic wordwrap feature. You may wish to turn this off when
1790 pasting long lines (⪚, &URL;s) that should not be wrapped.</para></listitem>
1791 </varlistentry>
1792
1793 <varlistentry id="composer-options-automatic-spellchecking">
1794 <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Automatic Spellchecking</guimenuitem></menuchoice></term>
1795 <listitem><para>Toggles automatic spellchecking on or off.</para></listitem>
1796 </varlistentry>
1797
1798 <varlistentry id="composer-options-followup">
1799 <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Create Follow Up Reminder...</guimenuitem></menuchoice></term>
1800 <listitem><para>Initiates a dialog allowing you to add a "To Do" item to your calendar. This item
1801 is grayed out if the <ulink url="help:/akonadi_followupreminder_agent">Followup Reminder Agent</ulink>
1802 plugin has not been activated.</para>
1803 <para> </para></listitem>
1804 </varlistentry>
1805
1806 </variablelist>
1807
1808 </sect2>
1809
1810
1811 <sect2 id="composer-attach-menu">
1812 <title>Attach Menu</title>
1813 <screenshot>
1814 <screeninfo>The Attach Menu</screeninfo>
1815 <mediaobject>
1816 <imageobject>
1817 <imagedata fileref="composerattachmenu.png" format="PNG"/>
1818 </imageobject>
1819 <textobject>
1820 <phrase>The Attach Menu</phrase>
1821 </textobject>
1822 <caption>
1823 <para>The Attach Menu</para>
1824 </caption>
1825 </mediaobject>
1826 </screenshot>
1827 <para> </para><!-- add whitespace -->
1828
1829 <para>This menu lets you select attachment options.</para>
1830
1831 <variablelist>
1832
1833 <varlistentry id="composer-attach-append-signature">
1834 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Append Signature</guimenuitem></menuchoice></term>
1835 <listitem><para>Appends your signature (<quote>footer</quote>) to the end of the message. Please see
1836 <link linkend="configure-identity-signature">Configure Identity Signature</link> for details on
1837 configuring your signature.</para></listitem>
1838 </varlistentry>
1839
1840 <varlistentry id="composer-attach-prepend-signature">
1841 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Prepend Signature</guimenuitem></menuchoice></term>
1842 <listitem><para>Prepends your signature (<quote>header</quote>) at the beginning of the message.</para></listitem>
1843 </varlistentry>
1844
1845 <varlistentry id="composer-attach-cursor-signature">
1846 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Insert Signature At
1847 Cursor Position</guimenuitem></menuchoice></term>
1848 <listitem><para>Inserts your signature at the current cursor location.</para></listitem>
1849 </varlistentry>
1850
1851 <varlistentry id="composer-attach-public-key">
1852 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Attach Public Key...</guimenuitem></menuchoice></term>
1853 <listitem><para>Opens the <guilabel>Attach Public OpenPGP Key</guilabel> dialog. Please see
1854 <link linkend="configure-identity-cryptography-openpgp-sign">Configure Identity Cryptography
1855 OpenPGP Signing</link> for details.</para></listitem>
1856 </varlistentry>
1857
1858 <varlistentry id="composer-attach-attach-my-public-key">
1859 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Attach My Public Key</guimenuitem></menuchoice></term>
1860 <listitem><para>Attaches your <application>GnuPG</application> public key, or your X.509 certificate,
1861 (&ie;, the public key associated with your current identity) to your message.</para>
1862 <para> </para></listitem>
1863 </varlistentry>
1864
1865 <varlistentry id="composer-attach-file">
1866 <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach ></guisubmenu>
1867 <guimenuitem>Attach File...</guimenuitem></menuchoice></term>
1868 <listitem><para>Attaches one or more files to the current message. Attachments are encrypted
1869 by default (if the message is encrypted). Please see <link linkend="cryptographic-message-formats">Cryptographic
1870 Message Formats</link> for more information on encryption and attachments.</para></listitem>
1871 </varlistentry>
1872
1873 <varlistentry id="composer-attach-directory">
1874 <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach ></guisubmenu>
1875 <guimenuitem>Attach Directory...</guimenuitem></menuchoice></term>
1876 <listitem><para>Creates a ZIP archive containing the selected Directory,
1877 and attaches the archive to this message.</para></listitem>
1878 </varlistentry>
1879
1880 <varlistentry id="composer-attach-ownvcard">
1881 <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach ></guisubmenu>
1882 <guimenuitem>Attach Own vCard</guimenuitem></menuchoice></term>
1883 <listitem><para>Attaches your vCard to the current message.</para></listitem>
1884 </varlistentry>
1885
1886 <varlistentry id="composer-attach-vcard">
1887 <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach ></guisubmenu>
1888 <guimenuitem>Attach vCards...</guimenuitem></menuchoice></term>
1889 <listitem><para>Opens a dialog with &kaddressbook; that lets you select one or more
1890 people (&Ctrl; and left-click), and then attaches vCards for all those selected.</para></listitem>
1891 </varlistentry>
1892
1893 <varlistentry id="composer-attach-clipboard">
1894 <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach ></guisubmenu>
1895 <guimenuitem>Attach Text From Clipboard...</guimenuitem></menuchoice></term>
1896 <listitem><para>If the topmost item saved on the clipboard contains at least two bytes,
1897 a file name dialog will open. &kmail; will create an attachment containing the text
1898 from the clipboard, and give the attachment the name you have chosen.</para>
1899 <para> </para></listitem>
1900 </varlistentry>
1901
1902 <varlistentry id="composer-attach-remove-attachment">
1903 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Remove Attachment</guimenuitem></menuchoice></term>
1904 <listitem><para>Removes the selected attachment (selected via the attachment
1905 area beneath the main composer window).</para>
1906 <note><para>This menu item, and the next two, will be grayed out until an attachment is
1907 selected.</para></note></listitem>
1908 </varlistentry>
1909
1910 <varlistentry id="composer-attach-save-attachment">
1911 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Save Attachment As...</guimenuitem></menuchoice></term>
1912 <listitem><para>Saves the attachment selected in the attachment window as a file.</para></listitem>
1913 </varlistentry>
1914
1915 <varlistentry id="composer-attach-attachment-properties">
1916 <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Attachment Properties</guimenuitem></menuchoice></term>
1917 <listitem><para>Displays the <link linkend="attachments">properties of the attachment</link> that has been
1918 selected via the attachment window. It also lets you sign/encrypt the attachment, and alter some of its
1919 other properties (name, description, &MIME; type, &etc;).</para>
1920 <para> </para></listitem>
1921 </varlistentry>
1922
1923 </variablelist>
1924
1925 </sect2>
1926
1927 <sect2 id="composer-tools-menu">
1928 <title>Tools Menu</title>
1929 <screenshot>
1930 <screeninfo>The Tools Menu</screeninfo>
1931 <mediaobject>
1932 <imageobject>
1933 <imagedata fileref="composertools.png" format="PNG"/>
1934 </imageobject>
1935 <textobject>
1936 <phrase>The Tools Menu</phrase>
1937 </textobject>
1938 <caption>
1939 <para>The Tools Menu</para>
1940 </caption>
1941 </mediaobject>
1942 </screenshot>
1943 <para> </para><!-- add whitespace -->
1944
1945 <para>If the menu item you are looking for is missing, please see <ulink url="help:/fundamentals/menus.html#menus-tools">Tools Menu</ulink> of the &kde; Fundamentals.
1946 The items listed here are &kmail; specific.</para>
1947
1948 <variablelist>
1949 <varlistentry id="composer-tools-select-recipients">
1950 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Select Recipients...</guimenuitem></menuchoice></term>
1951 <listitem><para>Opens a <guilabel>Select Recipient</guilabel> dialog, with
1952 the contents of all your address books to select from.</para></listitem>
1953 </varlistentry>
1954
1955 <varlistentry id="composer-tools-addressbook">
1956 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Addressbook...</guimenuitem></menuchoice></term>
1957 <listitem><para>Launches the <ulink url="help:/kaddressbook">&kaddressbook;</ulink> program.</para></listitem>
1958 </varlistentry>
1959
1960 <varlistentry id="composer-tools-save-distribution-list">
1961 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Save Distribution List...</guimenuitem></menuchoice></term>
1962 <listitem><para>Opens a dialog that lets you save groups of contacts as a single named item. Very handy
1963 if you frequently send the same message to all the members of a club, for instance.</para></listitem>
1964 </varlistentry>
1965
1966 <varlistentry id="composer-tools-autocorrect">
1967 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Autocorrect Text ></guimenuitem></menuchoice></term>
1968 <listitem><para>Performs autocorrection. You have two options: scan and autocorrect the
1969 selected text, or apply <link linkend="configure-composer-autocorrection">autocorrection</link> to the whole
1970 message. This menu item will not be present unless the <guilabel>Autocorrection</guilabel> plugin has been
1971 loaded, and it won't work unless the Autocorrection function has been enabled on the Composer configuration
1972 page.</para></listitem>
1973 </varlistentry>
1974
1975 <varlistentry id="composer-tools-translator">
1976 <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>T</keycap></keycombo></shortcut>
1977 <guimenu>Tools</guimenu><guimenuitem>Translator</guimenuitem></menuchoice></term>
1978 <listitem><para>Opens the <link linkend="using-the-translator">translator window</link>.</para></listitem>
1979 </varlistentry>
1980
1981 <varlistentry id="composer-tools-grammarcheck">
1982 <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Check Grammar (Language Tool)</guimenuitem></menuchoice></term>
1983 <listitem><para>Opens the grammar check window and examines your message, highlighting any errors
1984 that are found. This feature does not continuously update the scanned text as you type; you should
1985 first compose your message, then invoke grammar check. This tool is not available unless the
1986 <guilabel>Grammar Check</guilabel> plugin has been activated. Like the Translator function, Grammar Check
1987 passes your message through a server (default server: https://languagetool.org/api/v2) on the internet.</para>
1988 <para> </para></listitem>
1989 </varlistentry>
1990
1991 </variablelist>
1992
1993 </sect2>
1994
1995 <sect2 id="composer-settings-menu">
1996 <title>Settings Menu</title>
1997 <screenshot>
1998 <screeninfo>The Settings Menu</screeninfo>
1999 <mediaobject>
2000 <imageobject>
2001 <imagedata fileref="composersettings.png" format="PNG"/>
2002 </imageobject>
2003 <textobject>
2004 <phrase>The Settings Menu</phrase>
2005 </textobject>
2006 <caption>
2007 <para>The Settings Menu</para>
2008 </caption>
2009 </mediaobject>
2010 </screenshot>
2011 <para> </para><!-- add whitespace -->
2012
2013 <para>If the menu item you seek is missing, please see <ulink url="help:/fundamentals/menus.html#menus-settings">Settings
2014 Menu</ulink> of the &kde; Fundamentals. The items listed here are &kmail; specific.</para>
2015
2016 <variablelist>
2017 <varlistentry id="composer-settings-toolbars">
2018 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Toolbars Shown ></guimenuitem></menuchoice></term>
2019 <listitem><para>Lets you control which toolbars are displayed. You may choose any combination of three options:
2020 Main Toolbar (<guilabel>Send</guilabel>, <guilabel>Queue</guilabel>, <guilabel>Rich Text</guilabel>, &etc;),
2021 HTML Toolbar (<guilabel>Style</guilabel>, <guilabel>Font / Size</guilabel>, &etc;), and
2022 Text Direction (in case you use a right-to-left script). Note that the HTML Toolbar is easily
2023 toggled on and off via the <guibutton>Rich Text</guibutton> button on the Main Toolbar.</para></listitem>
2024 </varlistentry>
2025
2026 <varlistentry id="composer-settings-spellcheck">
2027 <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Spellchecker...</guimenuitem></menuchoice></term>
2028 <listitem><para>Allows you to configure <ulink url="help:/sonnet/">&sonnet;</ulink>, &kde;'s spell
2029 checker.</para><para> </para></listitem>
2030 </varlistentry>
2031
2032 </variablelist>
2033 </sect2>
2034
2035 <sect2 id="composer-help-menu">
2036 <title>Help Menu</title>
2037 <screenshot>
2038 <screeninfo>The Help Menu</screeninfo>
2039 <mediaobject>
2040 <imageobject>
2041 <imagedata fileref="composerhelp.png" format="PNG"/>
2042 </imageobject>
2043 <textobject>
2044 <phrase>The Help Menu</phrase>
2045 </textobject>
2046 <caption>
2047 <para>The Help Menu</para>
2048 </caption>
2049 </mediaobject>
2050 </screenshot>
2051 <para> </para><!-- add whitespace -->
2052
2053 <para>
2054 This is exactly like the <ulink url="help:/fundamentals/menus.html#menus-help">Help
2055 Menu</ulink> of the &kde; Fundamentals.
2056 </para>
2057 </sect2>
2058 </sect1>
2059
2060 </chapter>