menus.docbook 90.2 KB
Newer Older
1
2
3
4
5
<chapter id="menus">

<chapterinfo>
<authorgroup>
<author>
6
&Daniel.Naber;
7
8
9
&Daniel.Naber.mail;
</author>
<author>
10
&David.Rugge;
11
12
13
&David.Rugge.mail;
</author>
<author>
14
&Michel.Boyer;
15
16
17
<email>michel@klaralvdalens-datakonsult.se</email>
</author>
<author>
18
&Laurent.Montel;
19
20
21
&Laurent.Montel.mail;
</author>
<author>
22
&Scarlett.Clark;
23
24
&Scarlett.Clark.mail;
</author>
25
26
27
28
<author>
&David.Bryant;
&David.Bryant.mail;
</author>
29
30
31

<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
32

33
<date>2021-03-31</date>
34
<releaseinfo>5.14.2 (Applications 20.04.2)</releaseinfo>
35
36
37
38
39
40
41
42
43
44
45
</chapterinfo>

<title>Command and Menu Reference</title>
<para>Each &kmail; specific menu item is discussed below. When there is a keyboard shortcut that
performs a menu item function, the default shortcut is listed with the menu item.</para>

<sect1 id="reader-menu-items">
<title>The &kmail; Reader Window</title>

<sect2 id="reader-file-menu">
<title>File Menu</title>
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
<screenshot>
<screeninfo>The File Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readerfile.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The File Menu</phrase>
    </textobject>
    <caption>
      <para>The File Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

62
63
<variablelist>
<varlistentry id="file-new">
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
  <term><menuchoice><guimenu>File</guimenu><guisubmenu>New &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Here you can choose to create one of four new items, as follows:</para>

    <variablelist>
    <varlistentry id="reader-file-new-newmessage">
      <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
      <guimenu>File</guimenu><guisubmenu>New</guisubmenu>
      <guimenuitem>New Message...</guimenuitem></menuchoice></term>
      <listitem><para>Compose a new message. This will open a Composer window, where you can write a new
      message.</para></listitem>
    </varlistentry>

    <varlistentry id="reader-file-new-message-from-template">
      <term><menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
      <guisubmenu>Message from Template &gt;</guisubmenu></menuchoice></term>
      <listitem><para>Creates a new message from a selected template. Please see
      <link linkend="new-compose-from-templates">Compose From Templates</link> for additional information on
      creating templates. If you do not have any templates saved, you will see <menuchoice>
      <guimenu>Message</guimenu><guisubmenu>Message from Template &gt;</guisubmenu>
      <guimenuitem>(no templates)</guimenuitem></menuchoice>.</para></listitem>
    </varlistentry>

    <varlistentry id="reader-add-folder">
      <term><menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu><guimenuitem>Add
      Folder...</guimenuitem></menuchoice></term>
      <listitem><para>Creates a new folder. The ensuing dialog will ask you to give the new folder
      a name. The new folder will be created as a subfolder of the currently selected folder.</para></listitem>
    </varlistentry>

    <varlistentry id="reader-new-addressbook-contact">
      <term><menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
      <guimenuitem>New AddressBook Contact...</guimenuitem></menuchoice></term>
      <listitem><para>Launches the <ulink
      url="help:/kaddressbook/how-to-add-a-new-contact.html">New Contact</ulink>
      dialog, permitting you to add a new entry in &kaddressbook;.</para></listitem>
    </varlistentry>
    </variablelist>
    <para>&nbsp;</para><!-- add whitespace --></listitem>
102
</varlistentry>
103

104
<varlistentry id="reader-file-open">
105
106
107
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut>
  <guimenu>File</guimenu><guimenuitem>Open...</guimenuitem></menuchoice></term>
  <listitem><para>Opens saved email messages (.mbox files).</para></listitem>
108
</varlistentry>
109

110
<varlistentry id="reader-open-recent">
111
112
113
114
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Open Recent</guimenuitem></menuchoice></term>
  <listitem><para>Displays a list of recently opened messages. Only those messages that have been saved as
  .mbox files and subsequently opened will appear on this list. If no such files exist, this menu item
  will be grayed out.</para></listitem>
115
</varlistentry>
116

117
<varlistentry id="reader-file-save-as">
118
119
120
121
122
123
124
125
126
127
128
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
  <guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem></menuchoice></term>
  <listitem><para>Saves the currently displayed message to a <filename role="extension">.mbox</filename> file.
  This file includes all the headers and attachments, in &MIME; format. If you want to save it as a different
  format (&eg;, as a <filename role="extension">.txt</filename> file), uncheck the <guilabel>Automatically select
  filename extension (.mbox)</guilabel> box, and add the filename extension before saving the file.</para></listitem>
</varlistentry>

<varlistentry id="reader-file-export-pdf">
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Export to PDF...</guimenuitem></menuchoice></term>
  <listitem><para>Exports the currently displayed message as a .pdf file.</para></listitem>
129
</varlistentry>
130

131
<varlistentry id="reader-file-import-messages">
132
133
134
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Import Messages...</guimenuitem></menuchoice></term>
  <listitem><para>Starts up the <application>KMailCVT</application> program (aka the Email Import Wizard).
  This application lets you import messages from several email clients into &kmail;.</para></listitem>
135
</varlistentry>
136

137
<varlistentry id="reader-file-print-preview">
138
139
140
141
142
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Print Preview...</guimenuitem></menuchoice></term>
  <listitem><para><action>Shows how your email will appear when printed.</action></para>
  <note><para>This will only be enabled if a printer has been configured, is online, and is
  available for use.</para></note>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
143
</varlistentry>
144
145
146
147
148

<varlistentry id="reader-file-print">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
  <guimenu>File</guimenu><guimenuitem>Print...</guimenuitem></menuchoice></term>
  <listitem><para>Displays a dialog that lets you print the currently displayed message.</para></listitem>
149
</varlistentry>
150

151
<varlistentry id="reader-file-expire-all-folders">
152
153
154
155
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Expire All Folders</guimenuitem></menuchoice></term>
  <listitem><para>Deletes old messages from all folders. Deletion will occur according to the rules in each
  folder's <link linkend="folders-properties-window">Properties dialog</link> (the default is not to delete old
  messages at all).</para>
156
157
</listitem>
</varlistentry>
158

159
<varlistentry id="reader-empty-all-trash-folders">
160
161
162
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Empty All Trash Folders</guimenuitem></menuchoice></term>
  <listitem><para>Use this item to empty all trash folders, &ie;, the local trash folder and all trash folders that
  may exist on &IMAP; servers. Messages in Trash will be permanently deleted, and cannot be retrieved.</para></listitem>
163
</varlistentry>
164

165
<varlistentry id="reader-work-offline">
166
167
168
169
170
171
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Work Offline</guimenuitem></menuchoice></term>
  <listitem><para>Sets &kmail; to offline mode.
  This turns off all network jobs. This is useful when working without a network connection.
  When selected, this item will become <menuchoice><guimenu>File</guimenu><guimenuitem>Work
  Online</guimenuitem></menuchoice>, which must be selected to go back online (required to send
  and receive email).</para></listitem>
172
</varlistentry>
173

174
<varlistentry id="reader-check-mail">
175
176
177
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut>
  <guimenu>File</guimenu><guimenuitem>Check Mail</guimenuitem></menuchoice></term>
  <listitem><para>Checks for new messages in all your accounts.</para></listitem>
178
</varlistentry>
179

180
<varlistentry id="reader-file-check-mail-in">
181
182
183
  <term><menuchoice><guimenu>File</guimenu><guisubmenu>Check Mail In &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Checks for new messages from a particular account; your accounts will be listed in a
  submenu.</para></listitem>
184
</varlistentry>
185

186
<varlistentry id="reader-send-queued-messages">
187
188
189
190
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Send Queued Messages</guimenuitem></menuchoice></term>
  <listitem><para>Sends the messages that are in your outbox. Messages can end up in your outbox because
  of transmission errors, or because you composed and attempted to send a message while offline. If there
  are no messages in your outbox, this menu item will be grayed out.</para></listitem>
191
</varlistentry>
192

193
<varlistentry id="reader-send-queued-messages-via">
194
195
196
197
198
199
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Send Queued Messages Via &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Sends the messages that are in your outbox via a specific outgoing account.
  This allows you to choose which server to use to send your queued messages. Servers must be configured in
  the Configure &kmail; dialog, under the <menuchoice><guiicon>Accounts</guiicon><guilabel>Sending</guilabel>
  </menuchoice> tab, to be listed here. If there are no messages in the outbox folder, this menu item
  will be grayed out.</para></listitem>
200
</varlistentry>
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218

<varlistentry id="reader-file-delayed">
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Delayed Messages...</guimenuitem></menuchoice></term>
  <listitem><para>Starts the <ulink url="help:/akonadi_sendlater_agent">Akonadi Send Later
  Agent</ulink> dialog. Any messages queued for later delivery by the composer's <menuchoice>
  <guimenu>Message</guimenu><guimenuitem>Send Later</guimenuitem></menuchoice> option will appear in
  this dialog box. You can modify and / or delete them. Note that delayed messages are stored in the
  drafts folder, not in the outbox folder.</para></listitem>
</varlistentry>

<varlistentry id="reader-file-followup">
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Followup Reminder Messages...</guimenuitem></menuchoice></term>
  <listitem><para>Starts the <ulink url="help:/akonadi_followupreminder_agent">Akonadi Followup Reminder
  Agent</ulink> dialog. Any followup reminder messages ("todos") created via the composer's <menuchoice>
  <guimenu>Options</guimenu><guimenuitem>Create Followup Reminder...</guimenuitem></menuchoice> function will
  appear in this dialog box. You can delete those messages with the &RMB; context menu.</para></listitem>
</varlistentry>

219
<varlistentry id="reader-file-quit">
220
221
222
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
  <guimenu>File</guimenu><guimenuitem>Quit</guimenuitem></menuchoice></term>
  <listitem><para>Exits &kmail;.</para></listitem>
223
224
</varlistentry>
</variablelist>
225
<para>&nbsp;</para><!-- add whitespace -->
226
227
228
229
230
</sect2>


<sect2 id="reader-edit-menu">
<title>Edit Menu</title>
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
<screenshot>
<screeninfo>The Edit Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readeredit.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Edit Menu</phrase>
    </textobject>
    <caption>
      <para>The Edit Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<para>If the menu item you are looking for is missing, please see <ulink
  url="help:/fundamentals/menus.html#menus-edit">Edit Menu</ulink> in &kde; Fundamentals.
249
  The items listed here are &kmail; specific.</para>
250

251
<variablelist>
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
    
<varlistentry id="reader-edit-copy-folder">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>C</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Copy Folder</guimenuitem></menuchoice></term>
  <listitem><para>Creates an "Akonadi" pointer to the entire contents of the currently selected folder, and
  copies that pointer to the clipboard. A subsequent paste operation in a text editor will simply paste the
  pointer text. A subsequent paste operation in a &kmail; folder (or in the &dolphin; file manager) will
  create a second copy of the folder and its contents.</para></listitem>
</varlistentry>

<varlistentry id="reader-edit-cut-folder">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Cut Folder</guimenuitem></menuchoice></term>
  <listitem><para>Creates an "Akonadi" pointer to the currently selected folder, and copies that pointer
  to the clipboard. A subsequent "paste" operation in a text editor or in &dolphin; will behave exactly like the
  preceding <guimenuitem>Copy Folder</guimenuitem> operation. A subsequent paste operation in &kmail; will move
  the folder and its contents to a different location (if pasted in some folder other than the originating
  folder).</para></listitem>
</varlistentry>

<varlistentry id="reader-edit-copy-message">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>C</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Copy Message</guimenuitem></menuchoice></term>
  <listitem><para>Creates an "Akonadi" pointer to the currently selected message(s), and copies that pointer
  to the clipboard. A subsequent paste operation in a text editor will simply paste the pointer text. A
  subsequent paste operation in a &kmail; folder (or in the &dolphin; file manager) will create a copy of
  the message(s), headers and all.</para></listitem>
</varlistentry>

<varlistentry id="reader-edit-cut-message">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>X</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Cut Message</guimenuitem></menuchoice></term>
  <listitem><para>Creates an "Akonadi" pointer to the currently selected message(s), and copies that pointer
  to the clipboard. A subsequent "paste" operation in a text editor or in &dolphin; will behave exactly like the
  preceding <guimenuitem>Copy Message</guimenuitem> operation. A subsequent paste operation in &kmail; will either
  create a second copy of the message(s) (if pasted in the originating folder) or move the message(s) to a different
  folder (if pasted in some folder other than the originating folder).</para></listitem>
</varlistentry>

<varlistentry id="reader-edit-paste">
  <term><menuchoice><shortcut>&Ctrl;<keycap>V</keycap></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem></menuchoice></term>
  <listitem><para>Pastes either the entire contents of a folder, or the contents of selected messages, depending
  on the operation that preceded the "paste". This operation cannot be used to paste selected text inside the
  reader window. If no copy / cut operation is pending, this option will be grayed out.</para></listitem>
</varlistentry>

299
<varlistentry id="reader-edit-move-to-trash">
300
301
302
303
  <term><menuchoice><shortcut>&Del;</shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Move to Trash</guimenuitem></menuchoice></term>
  <listitem><para>Moves the selected messages to the trash folder.
  If the selected messages are already in the trash folder, they will be permanently deleted.</para></listitem>
304
</varlistentry>
305

306
<varlistentry id="reader-edit-move-thread-to-trash">
307
308
309
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Del;</keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Move Thread to Trash</guimenuitem></menuchoice></term>
  <listitem><para>Moves the selected thread to the trash folder, &eg;, a conversation in a mailing list.</para></listitem>
310
</varlistentry>
311

312
<varlistentry id="reader-edit-find-in-message">
313
314
315
316
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Find in Message...</guimenuitem></menuchoice></term>
  <listitem><para>Searches the current message text for a string entered in
  the <guilabel>Find:</guilabel> textbox.</para></listitem>
317
</varlistentry>
318

319
<varlistentry id="reader-edit-select-all-messages">
320
321
322
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Select All Messages</guimenuitem></menuchoice></term>
  <listitem><para>Selects all messages in the current folder.</para></listitem>
323
</varlistentry>
324

325
<varlistentry id="reader-edit-select-all-text">
326
327
328
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Select All Text</guimenuitem></menuchoice></term>
  <listitem><para>Selects the text of the currently displayed message.</para></listitem>
329
</varlistentry>
330

331
</variablelist>
332
<para>&nbsp;</para><!-- add whitespace -->
333
334
335
336
337
</sect2>


<sect2 id="reader-view-menu">
<title>View Menu</title>
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
<screenshot>
<screeninfo>The View Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readerview.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The View Menu</phrase>
    </textobject>
    <caption>
      <para>The View Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->
353
354
355

<variablelist>
<varlistentry id="reader-view-message-list">
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
  <term><menuchoice><guimenu>View</guimenu><guisubmenu>Message List &gt;</guisubmenu></menuchoice></term>
  <listitem><para>This submenu has the following options to change the appearance of the message list.</para>
    
    <variablelist>
    <varlistentry id="reader-view-messagelist-sorting">
      <term><menuchoice><guisubmenu>Sorting &gt;</guisubmenu></menuchoice></term>
      <listitem><para>Contains options to customize your sort order as follows:</para>
        <itemizedlist>
        <listitem><para><guilabel>Message Sort Order</guilabel> has several options, most of which are self-explanatory.
        The following options may not be immediately obvious, and deserve an explanation.</para>
          <itemizedlist>
            <listitem><para><guilabel>By Smart Sender/Receiver</guilabel> will display the receiver when you are
            viewing the sent-mail folder, and will display the sender when you are viewing the inbox.</para></listitem>
    
            <listitem><para><guilabel>By Action Item Status</guilabel> and <guilabel>By Important Status</guilabel>.
            These flags need to be set before they can be sorted. Please see <link linkend="reader-mark-messages">Mark
            Messages</link> for more information on marking your messages.</para></listitem>
          </itemizedlist>
        </listitem>
        
        <listitem><para><guilabel>Message Sort Direction</guilabel> and <guilabel>Group Sort Direction</guilabel>
        allow you to change the direction in which your messages/groups will be sorted, respectively. Note
        that the "Group" options are only available when messages are aggregated into groups.</para></listitem>
        <listitem><para><guilabel>Folder always Uses this Sort Order</guilabel> allows you to specify different
        sort settings for each folder.</para></listitem>
        </itemizedlist>
      </listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-aggregation">
      <term><menuchoice><guisubmenu>Aggregation &gt;</guisubmenu></menuchoice></term>
      <listitem><para>Lets you select an aggregation option. Please see the <link
      linkend="configure-appearance-message-list">Message List Appearance</link> tab (under <menuchoice>
      <guimenu>Settings</guimenu><guisubmenu>Configure &kmail;...</guisubmenu></menuchoice>) for more
      information on aggregation.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-theme">
      <term><menuchoice><guisubmenu>Theme &gt;</guisubmenu></menuchoice></term>
      <listitem><para>Lets you select a theme. Please see the <link
      linkend="configure-appearance-message-list">Message List Appearance</link> tab (under <menuchoice>
      <guimenu>Settings</guimenu><guisubmenu>Configure &kmail;...</guisubmenu></menuchoice>) for more
      information on themes.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-create-new-tab">
      <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></shortcut>
      <guisubmenu>Create New Tab</guisubmenu></menuchoice></term>
      <listitem><para>Creates a new tab on the tabbing toolbar. This tab will point to the folder you
      are viewing when the option is selected. If the tabbing toolbar is not yet visible, selecting this
      option will create it. The tabbing toolbar can be handy if you have many folders, but only a few of
      them are regularly accessed.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-activate-next-tab">
      <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&PgDn;</keycombo></shortcut>
      <guisubmenu>Activate Next Tab</guisubmenu></menuchoice></term>
      <listitem><para>Opens the folder associated with the next tab on the tabbing toolbar.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-activate-previous-tab">
      <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&PgUp;</keycombo></shortcut>
      <guisubmenu>Activate Previous Tab</guisubmenu></menuchoice></term>
      <listitem><para>Opens the folder associated with the previous tab on the tabbing toolbar.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-move-tab-left">
      <term><menuchoice><guisubmenu>Move Tab Left</guisubmenu></menuchoice></term>
      <listitem><para>Reorders the tabs on the tabbing toolbar by shifting the active tab to the left.
      If that tab is already at the extreme left end, it will be moved to the right hand end position.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-move-tab-right">
      <term><menuchoice><guisubmenu>Move Tab Right</guisubmenu></menuchoice></term>
      <listitem><para>Reorders the tabs on the tabbing toolbar by shifting the active tab to the right.
      If that tab is already at the extreme right end, it will be moved to the left hand end position.</para></listitem>
    </varlistentry>
    
    <varlistentry id="reader-view-messagelist-close-tab">
      <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>W</keycap></keycombo></shortcut>
      <guisubmenu>Close Tab</guisubmenu></menuchoice></term>
      <listitem><para><action>Closes the currently selected tab.</action></para></listitem>
    </varlistentry>
    </variablelist>
    <para>&nbsp;</para><!-- add whitespace -->
  </listitem>
442
</varlistentry>
443

444
<varlistentry id="reader-view-headers">
445
446
447
  <term><menuchoice><guimenu>View</guimenu><guisubmenu>Headers &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Selects your headers view. Please see <link linkend="using-header-options">Header
  Options</link> for details on the available header views.</para></listitem>
448
</varlistentry>
449

450
<varlistentry id="reader-view-attachments">
451
452
453
454
  <term><menuchoice><guimenu>View</guimenu><guimenuitem>Attachments &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Changes the way attachments appear in the <guilabel>Message Preview Pane</guilabel>
  (independent of the &MIME; Tree). Please see <link linkend="using-attachment-view-options">Attachment
  Options</link> for details on viewing attachments.</para></listitem>
455
</varlistentry>
456

457
<varlistentry id="reader-view-expand-thread-or-group">
458
459
460
461
  <term><menuchoice><shortcut><keycap>.</keycap></shortcut>
  <guimenu>View</guimenu><guimenuitem>Expand Thread / Group</guimenuitem></menuchoice></term>
  <listitem><para>This will display the thread of the current message, &ie;, all messages that
  are replies to the current message.</para></listitem>
462
</varlistentry>
463

464
<varlistentry id="reader-view-collapse-thread-or-group">
465
466
467
468
  <term><menuchoice><shortcut><keycap>,</keycap></shortcut>
  <guimenu>View</guimenu><guimenuitem>Collapse Thread / Group</guimenuitem></menuchoice></term>
  <listitem><para>This will hide the thread of the current message, &ie;, it will hide all
  messages that are replies to the current message.</para></listitem>
469
</varlistentry>
470

471
<varlistentry id="reader-view-expand-all-threads">
472
473
474
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo></shortcut>
  <guimenu>View</guimenu><guimenuitem>Expand All Threads</guimenuitem></menuchoice></term>
  <listitem><para>Expands all threads in the current folder.</para></listitem>
475
</varlistentry>
476

477
<varlistentry id="reader-view-collapse-all-threads">
478
479
480
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>,</keycap></keycombo></shortcut>
  <guimenu>View</guimenu><guimenuitem>Collapse All Threads</guimenuitem></menuchoice></term>
  <listitem><para>Collapses all threads in the current folder.</para></listitem>
481
</varlistentry>
482
483
484
485
486

<varlistentry id="reader-view-save-display-format">
  <term><menuchoice><guimenu>View</guimenu><guimenuitem>Save Display Format</guimenuitem></menuchoice></term>
  <listitem><para>This option is apparently supposed to save something somewhere, but it's not
  yet working correctly.</para></listitem>
487
</varlistentry>
488
489
490
491
492

<varlistentry id="reader-view-restore-display-format">
  <term><menuchoice><guimenu>View</guimenu><guimenuitem>Restore Display Format</guimenuitem></menuchoice></term>
  <listitem><para>This option is apparently supposed to restore whatever the preceding "Save" option
  is supposed to save, but it's not yet working correctly, either.</para></listitem>
493
</varlistentry>
494
495
496
497
498
499
500
501

<varlistentry id="reader-view-disable-emoticon">
  <term><menuchoice><guimenu>View</guimenu><guimenuitem>Disable Emoticon</guimenuitem></menuchoice></term>
  <listitem><para>Select this option to stop &kmail; from transforming <literal>:-)</literal>
  into <inlinemediaobject><imageobject><imagedata fileref="smile.png" format="PNG"/></imageobject>
  </inlinemediaobject>.</para></listitem>
</varlistentry>

502
<varlistentry id="reader-view-use-fixed-font">
503
504
505
506
507
  <term><menuchoice><shortcut><keycap>X</keycap></shortcut>
  <guimenu>View</guimenu><guimenuitem>Use Fixed Font</guimenuitem></menuchoice></term>
  <listitem><para>Uses a fixed width (Monospace) font to display the messages in the current folder.
  The font to be used can be configured in the <link linkend="configure-appearance-fonts">Fonts</link>
  tab on the <guilabel>Appearance</guilabel> page of the &kmail; configuration dialog.</para></listitem>
508
</varlistentry>
509

510
<varlistentry id="reader-view-set-encoding">
511
512
513
  <term><menuchoice><guimenu>View</guimenu><guisubmenu>Set Encoding &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Lets you choose the character encoding to be used in the Message Pane.
  The default, <guilabel>Auto</guilabel>, should work in almost every case.</para></listitem>
514
</varlistentry>
515

516
<varlistentry id="reader-view-zoom">
517
518
519
520
  <term><menuchoice><guimenu>View</guimenu><guisubmenu>Zoom &gt;</guisubmenu></menuchoice></term>
  <listitem><para>This option lets you zoom in or out on every message displayed in the preview pane.</para>
  <para>&nbsp;</para><!-- add whitespace -->
  </listitem>
521
522
523
524
525
526
527
528
</varlistentry>
</variablelist>

</sect2>


<sect2 id="reader-go-menu">
<title>Go Menu</title>
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
<screenshot>
<screeninfo>The Go Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readergo.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Go Menu</phrase>
    </textobject>
    <caption>
      <para>The Go Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->
544
545
546

<variablelist>
<varlistentry id="reader-go-jump-to-folder">
547
548
549
550
  <term><menuchoice><shortcut><keycap>J</keycap></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Jump to Folder...</guimenuitem></menuchoice></term>
  <listitem><para>Shows a dialog box with a list of all your folders. Click on the folder
  you wish to view, and that folder will be opened for display in the message preview pane.</para></listitem>
551
</varlistentry>
552

553
<varlistentry id="reader-go-next-message">
554
555
556
557
  <term><menuchoice><shortcut><keycap>N</keycap></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Next Message</guimenuitem></menuchoice></term>
  <listitem><para>Selects the next message in the message list.
  The keyboard shortcut &Right; also performs this function.</para></listitem>
558
</varlistentry>
559

560
<varlistentry id="reader-go-next-unread-message">
561
562
563
564
565
  <term><menuchoice><shortcut><keycap>&plus;</keycap></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Next Unread Message</guimenuitem></menuchoice></term>
  <listitem><para>Selects the next unread message in the message list.
  If there are no unread messages below the currently selected message, the behavior depends
  on the value of the <xref linkend="configure-misc-folders-go-unread"/> option.</para></listitem>
566
</varlistentry>
567

568
<varlistentry id="reader-go-previous-message">
569
570
571
  <term><menuchoice><shortcut><keycap>P</keycap></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Previous Message</guimenuitem></menuchoice></term>
  <listitem><para>Selects the previous message in the message list.</para></listitem>
572
</varlistentry>
573

574
<varlistentry id="reader-go-previous-unread">
575
576
577
578
579
  <term><menuchoice><shortcut><keycap>&minus;</keycap></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Previous Unread Message</guimenuitem></menuchoice></term>
  <listitem><para>Selects the previous unread message in the message list.
  If there is no unread message above the currently selected message, then the behavior depends on the value of the
  <xref linkend="configure-misc-folders-go-unread"/> option.</para></listitem>
580
</varlistentry>
581

582
<varlistentry id="reader-go-next-unread-folder">
583
584
585
  <term><menuchoice><shortcut><keycombo action="simul">&Alt;<keycap>&plus;</keycap></keycombo></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Next Unread Folder</guimenuitem></menuchoice></term>
  <listitem><para>Jumps to the next folder with unread messages.</para></listitem>
586
</varlistentry>
587

588
<varlistentry id="reader-go-previous-unread-folder">
589
590
591
  <term><menuchoice><shortcut><keycombo action="simul">&Alt;<keycap>&minus;</keycap></keycombo></shortcut>
  <guimenu>Go</guimenu><guimenuitem>Previous Unread Folder</guimenuitem></menuchoice></term>
  <listitem><para>Jumps to the previous folder with unread messages.</para></listitem>
592
</varlistentry>
593

594
<varlistentry id="reader-go-next-unread-text">
595
596
597
598
599
  <term><menuchoice><shortcut>&Space;</shortcut>
  <guimenu>Go</guimenu><guimenuitem>Next Unread Text</guimenuitem></menuchoice></term>
  <listitem><para>Scrolls down if you are not yet at the bottom of a message, otherwise jumps to
  the next unread message.</para>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
600
601
602
603
604
605
606
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reader-folder-menu">
<title>Folder Menu</title>
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
<screenshot>
<screeninfo>The Folder Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readerfolder.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Folder Menu</phrase>
    </textobject>
    <caption>
      <para>The Folder Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

623
<variablelist>
624
625
626
627
628
629
<varlistentry id="reader-folder-properties">
  <term><guimenu>Folder Properties</guimenu></term>
  <listitem><para>Opens the <link linkend="folders-properties-window">Folder Properties</link>
  dialog that lets you modify the properties of the current folder.</para></listitem>
</varlistentry>

630
<varlistentry id="reader-folder-add-folder">
631
632
633
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Add Folder...</guimenuitem></menuchoice></term>
  <listitem><para>Prompts you for a name, then creates a new folder as a subfolder of the current folder.
  This is exactly like <xref linkend="reader-add-folder" />.</para></listitem>
634
</varlistentry>
635

636
<varlistentry id="reader-folder-mark-all-messages-as-read">
637
638
639
640
641
642
643
644
645
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Mark All Messages as Read</guimenuitem></menuchoice></term>
  <listitem><para>Sets the status of all unread messages in the current folder to "read".</para></listitem>
</varlistentry>

<varlistentry id="reader-folder-mark-all-messages-as-read-subfolder">
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Mark All Messages as Read
  in This Folder and All its Subfolders</guimenuitem></menuchoice></term>
  <listitem><para>Sets the status of all unread messages in the current folder (and all its
  subfolders) to "read".</para></listitem>
646
</varlistentry>
647

648
<varlistentry id="reader-folder-update-folder">
649
650
651
652
653
  <term><menuchoice><shortcut><keycap>F5</keycap></shortcut>
  <guimenu>Folder</guimenu><guimenuitem>Update Folder</guimenuitem></menuchoice></term>
  <listitem><para>Checks whether new mail has arrived in the currently selected folder.</para>
  <note><para>This option only works in &IMAP; folders.</para></note>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
654
</varlistentry>
655

656
<varlistentry id="reader-folder-update-folder-and-all-its-subfolders">
657
658
659
660
661
662
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>F5</keycap></keycombo></shortcut>
  <guimenu>Folder</guimenu><guimenuitem>Update This Folder and All Its Subfolders</guimenuitem></menuchoice></term>
  <listitem><para>Checks whether new mail has arrived in the currently selected folder, or in any
  of its subfolders.</para>
  <note><para>This option only works in &IMAP; folders.</para></note>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
663
</varlistentry>
664

665
<varlistentry id="reader-folder-move-all-messages-to-trash">
666
667
668
669
670
671
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Move All Messages to Trash</guimenuitem></menuchoice></term>
  <listitem><para>Moves all of the messages in the selected folder into the trash folder.</para>
  <note><para>This is only available if the currently selected folder is not a trash folder. If the
  currently selected folder is a trash folder, you will see <guilabel>Empty Trash</guilabel>, instead. Selecting
  that option will empty the trash by permanently deleting the messages in the trash folder.</para></note>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
672
</varlistentry>
673
674
675
676
677
678

<varlistentry id="reader-folder-delete-folder">
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Delete Folder</guimenuitem></menuchoice></term>
  <listitem><para>Deletes the selected folder and all its contents. A warning message will be displayed.
  If the current folder is one of &kmail;'s pre-defined folders (inbox, &etc;), this menu item will
  be grayed out.</para></listitem>
679
</varlistentry>
680

681
<varlistentry id="reader-folder-archive-folder">
682
683
684
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Archive Folder...</guimenuitem></menuchoice></term>
  <listitem><para>Brings up a dialog so you can create an archive of the currently selected folder. Please see
  the <xref linkend="folder-archive" /> section of "Using &kmail;" for details.</para></listitem>
685
</varlistentry>
686

687
<varlistentry id="reader-folder-remove-duplicate-messages">
688
689
690
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>*</keycap></keycombo></shortcut>
  <guimenu>Folder</guimenu><guimenuitem>Remove Duplicate Messages</guimenuitem></menuchoice></term>
  <listitem><para>Searches the folder for duplicate messages and deletes them.</para></listitem>
691
</varlistentry>
692
693
694
695
696
697

<varlistentry id="reader-folder-remove-duplicate-messages-subfolder">
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Remove Duplicates in This Folder and
  All its Subfolder</guimenuitem></menuchoice></term>
  <listitem><para>Searches the folder, and its subfolders, for duplicate messages, then deletes the
  duplicates.</para></listitem>
698
</varlistentry>
699
700
701
702
703

<varlistentry id="reader-folder-apply-filters-on-folder">
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Apply Filters On Folder &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Applies selected filters (All, Spam, or Not Spam) to the currently selected folder.
  Please see the <link linkend="filter-dialog-id">Filter dialog</link> for more information on filters.</para></listitem>
704
</varlistentry>
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721

<varlistentry id="reader-folder-apply-filters-on-subfolders">
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Apply Filters On Folder and All its
  Subfolders &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Applies selected filters (All, Spam, or Not Spam) to the currently selected folder, and to its subfolders.
  Please see the <link linkend="filter-dialog-id">Filter dialog</link> for more information on filters.</para></listitem>
</varlistentry>

<varlistentry id="reader-folder-message-default-format">
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Message Default Format &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Here you may select one of three options: <guilabel>Prefer &HTML; to Plain Text</guilabel>,
  <guilabel>Prefer Plain Text to &HTML;</guilabel>, or <guilabel>Use Global Setting</guilabel>.</para>
  <warning><para>For security reasons, we recommend you only select <guilabel>Prefer &HTML; to Plain Text</guilabel>
  in folders which can never contain untrusted messages.</para></warning>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
</varlistentry>

722
<varlistentry id="reader-folder-load-external-references">
723
724
725
726
727
728
729
730
731
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Load External References</guimenuitem></menuchoice></term>
  <listitem><para>If you have &HTML; messages enabled (see above), then you will also have the option to have
  images and other resources linked from the web downloaded automatically.</para>
  <warning><para>This option is only available if <guilabel>Prefer &HTML; to Plain Text</guilabel>
  has been selected. If you turn this option on, and later decide to change <guimenuitem>Message Default
  Format</guimenuitem>, be sure to clear this checkbox before making the switch. There is a bug in &kmail;
  -- if the checkbox on this item has not been cleared, and this option has been grayed out, results are
  unpredictable.</para></warning>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
732
</varlistentry>
733

734
<varlistentry id="reader-folder-mailing-list-management">
735
736
737
738
739
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Mailing List Management...</guimenuitem></menuchoice></term>
  <listitem><para>This opens the mailing list management dialog. This option is only available if
  the current folder contains messages from a mailing list. Please see the <link 
  linkend="folders-properties-mailinglist">Mailing List dialog</link> for more
  information on mailing lists.</para></listitem>
740
</varlistentry>
741

742
<varlistentry id="reader-folder-assign-shortcut">
743
744
745
  <term><menuchoice><guimenu>Folder</guimenu><guimenuitem>Assign Shortcut...</guimenuitem></menuchoice></term>
  <listitem><para>This lets you assign a keyboard shortcut to the currently selected folder.</para>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
746
747
748
749
750
751
752
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reader-message-menu">
<title>Message Menu</title>
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
<screenshot>
<screeninfo>The Message Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readermessage.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Message Menu</phrase>
    </textobject>
    <caption>
      <para>The Message Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->
768
769
770

<variablelist>
<varlistentry id="reader-message-new-message">
771
772
773
774
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>New Message...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the <link linkend="the-composer-window">composer window</link>
  so you can write a new message.</para></listitem>
775
</varlistentry>
776

777
<varlistentry id="reader-message-new-message-to-mailing-list">
778
779
780
781
782
783
784
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>N</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>New Message to Mailing-List...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the composer window so you can write a new message.
  If the current folder holds a mailing list and has a posting address defined,
  that posting address will automatically be entered as the <guilabel>To:</guilabel> address
  when the composer window is opened. If the current folder does not contain a mailing list,
  this item will be grayed out.</para></listitem>
785
</varlistentry>
786

787
<varlistentry id="reader-message-reply">
788
789
790
791
792
793
794
  <term><menuchoice><shortcut><keycap>R</keycap></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Reply...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the composer window, inserts quoted text from the currently selected message, and sets the
  <guilabel>To:</guilabel> field to either the mailing-list address (if you reply to a mailing-list message),
  or to the preferred reply-to address of the sender. If you want to control which address is set in the
  <guilabel>To:</guilabel> field, you should use <link linkend="reader-message-reply-special">Reply Special</link>.
  The sending identity will automatically be set to the identity to which this message was addressed.</para></listitem>
795
</varlistentry>
796

797
<varlistentry id="reader-message-reply-all">
798
799
800
801
802
803
804
805
806
807
  <term><menuchoice><shortcut><keycap>A</keycap></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Reply to All...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the composer window, inserts the quoted text of the currently
  selected message, and sets the <guilabel>To:</guilabel> field to either the
  mailing-list address (when replying to a mailing-list message), or to the
  preferred reply-to address of the sender. The <guilabel>Copy to (CC):</guilabel>
  field is filled with the addresses of all the other recipients of the currently
  selected message, excluding your own address. The sending identity will automatically
  be set to the identity to which this message was addressed.</para>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
808
</varlistentry>
809

810
<varlistentry id="reader-message-reply-special">
811
812
813
814
815
816
817
  <term><menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>A</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guisubmenu>Reply Special &gt;</guisubmenu><guimenuitem>Reply to Author...</guimenuitem>
  </menuchoice></term>
  <listitem><para>Opens the composer window, inserts the quoted text from the currently
  selected message, and sets the <guilabel>To:</guilabel> field to the
  preferred reply-to address of the sender. The sending identity will automatically be set
  to the identity to which this message was addressed.</para></listitem>
818
</varlistentry>
819

820
<varlistentry id="reader-message-reply-special-reply-to-mailinglist">
821
822
823
824
825
826
827
828
829
  <term><menuchoice><shortcut><keycap>L</keycap></shortcut>
  <guimenu>Message</guimenu><guisubmenu>Reply Special &gt;</guisubmenu><guimenuitem>Reply to Mailing-List...</guimenuitem>
  </menuchoice></term>
  <listitem><para>Opens the composer window, inserts the quoted text of the currently
  selected message, and sets the <guilabel>To:</guilabel> field to the mailing-list address.
  If you did not specify a mailing-list address for the currently selected folder and &kmail;
  cannot determine the posting address from the currently selected message, the <guilabel>To:</guilabel>
  field will be empty. The sending identity will automatically be set to the identity to which this
  message was addressed.</para></listitem>
830
</varlistentry>
831

832
<varlistentry id="reader-message-reply-special-reply-without-quote">
833
834
835
836
837
  <term><menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>R</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guisubmenu>Reply Special &gt;</guisubmenu><guimenuitem>Reply Without Quote...</guimenuitem>
  </menuchoice></term>
  <listitem><para>Works just like <guimenuitem>Reply...</guimenuitem>, except that the text of the currently
  selected message is not quoted.</para></listitem>
838
</varlistentry>
839

840
<varlistentry id="reader-message-reply-special-reply-with-custom-template">
841
842
843
844
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Reply Special &gt;</guisubmenu>
  <guimenuitem>Reply With Custom Template</guimenuitem></menuchoice></term>
  <listitem><para>Works just like <guimenuitem>Reply...</guimenuitem> with an added option: you may select a custom
  template configured via <link linkend="configure-composer-custom-templates">Custom Templates</link>.</para></listitem>
845
</varlistentry>
846

847
<varlistentry id="reader-message-reply-special-reply-to-all-with-custom-template">
848
849
850
851
852
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Reply Special &gt;</guisubmenu>
  <guimenuitem>Reply to All With Custom Template</guimenuitem></menuchoice></term>
  <listitem><para>Works just like <guimenuitem>Reply to All...</guimenuitem> with an added option: you may select a custom
  template configured via <link linkend="configure-composer-custom-templates">Custom Templates</link>.</para>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
853
</varlistentry>
854

855
<varlistentry id="reader-message-forward-as-attachment">
856
857
858
859
860
  <term><menuchoice><shortcut><keycombo action="simul">&Shift;<keycap>F</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guisubmenu>Forward &gt;</guisubmenu><guimenuitem>As Attachment</guimenuitem>
  </menuchoice></term>
  <listitem><para>Forwards the message to a new recipient. The message and its attachments will be attached to the
  new message. The original message headers will be included in the forwarded message.</para></listitem>
861
</varlistentry>
862

863
<varlistentry id="reader-message-forward-inline">
864
865
866
867
  <term><menuchoice><shortcut><keycap>F</keycap></shortcut>
  <guimenu>Message</guimenu><guisubmenu>Forward &gt;</guisubmenu><guimenuitem>Inline</guimenuitem></menuchoice></term>
  <listitem><para>The message's text and some important header fields will be copied to the body of the new message,
  with text marking where the forwarded part begins. Attachments will be attached to the new message.</para></listitem>
868
</varlistentry>
869

870
<varlistentry id="reader-message-forward-redirect">
871
872
873
874
875
876
  <term><menuchoice><shortcut><keycap>E</keycap></shortcut>
  <guimenu>Message</guimenu><guisubmenu>Forward &gt;</guisubmenu><guimenuitem>Redirect</guimenuitem></menuchoice></term>
  <listitem><para>This works like "Forward", except that the message stays the same (even the
  <guilabel>From:</guilabel> field). The user who redirected the message is identified by
  special header fields (<literal>Redirect-From</literal>, <literal>Redirect-Date</literal>,
  <literal>Redirect-To</literal>, &etc;).</para></listitem>
877
</varlistentry>
878

879
<varlistentry id="reader-message-forward-with-custom-template">
880
881
882
883
884
885
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Forward &gt;</guisubmenu>
  <guimenuitem>With Custom Template</guimenuitem></menuchoice></term>
  <listitem><para>Works just like "Forward", but gives you the option to select a
  custom template configured via the composer custom templates tab in <link
  linkend="configure-composer-custom-templates">Custom Templates</link>.</para>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
886
</varlistentry>
887

888
<varlistentry id="reader-message-send-again">
889
890
891
892
893
894
895
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Again...</guimenuitem></menuchoice></term>
  <listitem><para>Opens a composer window with the currently selected message so it can be sent again.</para>
  <note><para>This menu item is only available for messages which you have sent or, more precisely, for messages
  which have the <guilabel>sent</guilabel> status. If you wish to resend some other message, double-click its
  entry in the message list. Or view the message and use the <keycap>T</keycap> shortcut. You may also do this
  by adding an <guibutton>Edit as New</guibutton> button to the toolbar.</para></note>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
896
</varlistentry>
897
898
899
900
901
902
903

<!-- <varlistentry id="reader-message-edit-message">
<term><menuchoice><shortcut><keycap>T</keycap></shortcut>
<guimenu>Message</guimenu><guimenuitem>Edit Message</guimenuitem></menuchoice></term>
<listitem><para>Opens the selected message in a composer window.</para></listitem>
</varlistentry> -->

904
<varlistentry id="reader-message-mailing-list">
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Mailing List Name: &gt;</guimenuitem></menuchoice></term>
  
  <listitem><para>Offers several options for mailing list messages.</para>
  <note><para>The current working folder must be configured as a mailing list for this
  option to be available. Please see <link linkend="folders-properties-mailinglist">Folder
  Properties Mailing List</link> to learn about setting up mailing lists.</para></note>
  <para>&nbsp;</para><!-- add whitespace -->
  <para>The following options are available in mailing list folders:</para>
  
  <itemizedlist>
    <listitem><para><guimenuitem>Post New Message(email)</guimenuitem> will set the
    <guilabel>To:</guilabel> address to the address configured as "Post to List".</para></listitem>
    <listitem><para><guimenuitem>Request Help(email)</guimenuitem> will set the
    <guilabel>To:</guilabel> address to the address configured in "Post to List" and will place
    the word <literal>help</literal> in the <guilabel>Subject:</guilabel> field.</para></listitem>
    <listitem><para><guimenuitem>Subscribe to List(web)</guimenuitem> will point your default web browser
    to the "subscribe" web site of the configured mailing list.</para></listitem>
    <listitem><para><guimenuitem>Subscribe to List(email)</guimenuitem> will set the
    <guilabel>To:</guilabel> address to the mailing list subscription address, and place
    the word <literal>subscribe</literal> in the <guilabel>Subject:</guilabel> field.</para></listitem>
    <listitem><para><guimenuitem>Unsubscribe from List(web)</guimenuitem> will point your default web
    browser to the "unsubscribe" web site of the configured mailing list.</para></listitem>
    <listitem><para><guimenuitem>Unsubscribe from List(email)</guimenuitem> will set the
    <guilabel>To:</guilabel> address to the mailing list subscription address, and place the
    word <literal>unsubscribe</literal> in the <guilabel>Subject:</guilabel> field.</para></listitem>
  </itemizedlist>
  
  <para>&nbsp;</para><!-- add whitespace --></listitem>
933
</varlistentry>
934

935
<varlistentry id="reader-message-copy-message-to">
936
937
938
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Copy Message To &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Copies the selected message(s) to a specified folder. You may choose from recent folders,
  local folders, or a specific &IMAP; account folder.</para></listitem>
939
</varlistentry>
940

941
<varlistentry id="reader-message-move-message-to">
942
943
944
945
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Move Message To &gt;</guisubmenu></menuchoice></term>
  <listitem><para>The same as "Copy Message To", above, except this option will permanently move the
  selected message(s) to the chosen folder.</para>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
946
</varlistentry>
947

948
<varlistentry id="reader-mark-messages">
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Mark Message &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Lets you change the status of the selected message to one of the following values:</para>
  <informaltable><tgroup cols="3">
    <thead><row><entry>Status</entry><entry>Symbol</entry><entry>Meaning</entry></row></thead>

    <tbody>
    <row>
    <entry><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
    <guimenuitem>Mark Message as Read</guimenuitem></menuchoice></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-read.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>The message has been read.</entry></row>

    <row>
    <entry><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></shortcut>
    <guimenuitem>Mark Message as Unread</guimenuitem></menuchoice></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-unread.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>The message has not been read yet.</entry></row>

    <row>
    <entry><guimenuitem>Mark Message as Important</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-important.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>This status will not automatically be set by &kmail;.
    You can use it freely to mark messages that are in some way important to you.</entry></row>
 
    <row>
    <entry><guimenuitem>Remove Important Mark</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-important.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>Removes a previously set important flag from the message.</entry></row>

    <row>
    <entry><guimenuitem>Mark Message as Action Item</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-task.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>This status will not automatically be set by &kmail;. Use this to mark messages that are action
    items; &eg;, a to-do list.</entry></row>

    <row><entry><guimenuitem>Remove Action Item Mark</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-task.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>Removes a previously set action item mark from the message.</entry></row>
    </tbody>

  </tgroup></informaltable>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
997
</varlistentry>
998

999
<varlistentry id="reader-mark-thread">
1000
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Mark Thread</guisubmenu></menuchoice></term>