<chapter id="menus">

<chapterinfo>
<authorgroup>
<author>
&Daniel.Naber;
&Daniel.Naber.mail;
</author>
<author>
&David.Rugge;
&David.Rugge.mail;
</author>
<author>
&Michel.Boyer;
<email>michel@klaralvdalens-datakonsult.se</email>
</author>
<author>
&Laurent.Montel;
&Laurent.Montel.mail;
</author>
<author>
&Scarlett.Clark;
&Scarlett.Clark.mail;
</author>
<author>
&David.Bryant;
&David.Bryant.mail;
</author>

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

<date>2021-03-31</date>
<releaseinfo>5.14.2 (Applications 20.04.2)</releaseinfo>
</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>
<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 -->

<variablelist>
<varlistentry id="file-new">
  <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>
</varlistentry>

<varlistentry id="reader-file-open">
  <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>
</varlistentry>

<varlistentry id="reader-open-recent">
  <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>
</varlistentry>

<varlistentry id="reader-file-save-as">
  <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>
</varlistentry>

<varlistentry id="reader-file-import-messages">
  <term><menuchoice><guimenu>File</guimenu><guimenuitem>Import Messages...</guimenuitem></menuchoice></term>
  <listitem><para>Starts up the <application>PIM Import Tool</application> program.
  This application lets you import messages from several email clients into &kmail;.</para></listitem>
</varlistentry>

<varlistentry id="reader-file-print-preview">
  <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>
</varlistentry>

<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>
</varlistentry>

<varlistentry id="reader-file-expire-all-folders">
  <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>
</listitem>
</varlistentry>

<varlistentry id="reader-empty-all-trash-folders">
  <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>
</varlistentry>

<varlistentry id="reader-work-offline">
  <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>
</varlistentry>

<varlistentry id="reader-check-mail">
  <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>
</varlistentry>

<varlistentry id="reader-file-check-mail-in">
  <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>
</varlistentry>

<varlistentry id="reader-send-queued-messages">
  <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>
</varlistentry>

<varlistentry id="reader-send-queued-messages-via">
  <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>
</varlistentry>

<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>

<varlistentry id="reader-file-quit">
  <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>
</varlistentry>
</variablelist>
<para>&nbsp;</para><!-- add whitespace -->
</sect2>


<sect2 id="reader-edit-menu">
<title>Edit Menu</title>
<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.
  The items listed here are &kmail; specific.</para>

<variablelist>
    
<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>

<varlistentry id="reader-edit-move-to-trash">
  <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>
</varlistentry>

<varlistentry id="reader-edit-move-thread-to-trash">
  <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>
</varlistentry>

<varlistentry id="reader-edit-find-in-message">
  <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>
</varlistentry>

<varlistentry id="reader-edit-select-all-messages">
  <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>
</varlistentry>

<varlistentry id="reader-edit-select-all-text">
  <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>
</varlistentry>

</variablelist>
<para>&nbsp;</para><!-- add whitespace -->
</sect2>


<sect2 id="reader-view-menu">
<title>View Menu</title>
<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 -->

<variablelist>
<varlistentry id="reader-view-message-list">
  <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>
</varlistentry>

<varlistentry id="reader-view-headers">
  <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>
</varlistentry>

<varlistentry id="reader-view-attachments">
  <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>
</varlistentry>

<varlistentry id="reader-view-expand-thread-or-group">
  <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>
</varlistentry>

<varlistentry id="reader-view-collapse-thread-or-group">
  <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>
</varlistentry>

<varlistentry id="reader-view-expand-all-threads">
  <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>
</varlistentry>

<varlistentry id="reader-view-collapse-all-threads">
  <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>
</varlistentry>

<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>
</varlistentry>

<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>
</varlistentry>

<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>

<varlistentry id="reader-view-use-fixed-font">
  <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>
</varlistentry>

<varlistentry id="reader-view-set-encoding">
  <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>
</varlistentry>

<varlistentry id="reader-view-zoom">
  <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>
</varlistentry>
</variablelist>

</sect2>


<sect2 id="reader-go-menu">
<title>Go Menu</title>
<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 -->

<variablelist>
<varlistentry id="reader-go-jump-to-folder">
  <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>
</varlistentry>

<varlistentry id="reader-go-next-message">
  <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>
</varlistentry>

<varlistentry id="reader-go-next-unread-message">
  <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>
</varlistentry>

<varlistentry id="reader-go-previous-message">
  <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>
</varlistentry>

<varlistentry id="reader-go-previous-unread">
  <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>
</varlistentry>

<varlistentry id="reader-go-next-unread-folder">
  <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>
</varlistentry>

<varlistentry id="reader-go-previous-unread-folder">
  <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>
</varlistentry>

<varlistentry id="reader-go-next-unread-text">
  <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>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reader-folder-menu">
<title>Folder Menu</title>
<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 -->

<variablelist>
<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>

<varlistentry id="reader-folder-add-folder">
  <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>
</varlistentry>

<varlistentry id="reader-folder-mark-all-messages-as-read">
  <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>
</varlistentry>

<varlistentry id="reader-folder-update-folder">
  <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>
</varlistentry>

<varlistentry id="reader-folder-update-folder-and-all-its-subfolders">
  <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>
</varlistentry>

<varlistentry id="reader-folder-move-all-messages-to-trash">
  <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>
</varlistentry>

<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>
</varlistentry>

<varlistentry id="reader-folder-archive-folder">
  <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>
</varlistentry>

<varlistentry id="reader-folder-remove-duplicate-messages">
  <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>
</varlistentry>

<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>
</varlistentry>

<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>
</varlistentry>

<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>

<varlistentry id="reader-folder-load-external-references">
  <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>
</varlistentry>

<varlistentry id="reader-folder-mailing-list-management">
  <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>
</varlistentry>

<varlistentry id="reader-folder-assign-shortcut">
  <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>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="reader-message-menu">
<title>Message Menu</title>
<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 -->

<variablelist>
<varlistentry id="reader-message-new-message">
  <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>
</varlistentry>

<varlistentry id="reader-message-new-message-to-mailing-list">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply-all">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply-special">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply-special-reply-to-mailinglist">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply-special-reply-without-quote">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply-special-reply-with-custom-template">
  <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>
</varlistentry>

<varlistentry id="reader-message-reply-special-reply-to-all-with-custom-template">
  <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>
</varlistentry>

<varlistentry id="reader-message-forward-as-attachment">
  <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>
</varlistentry>

<varlistentry id="reader-message-forward-inline">
  <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>
</varlistentry>

<varlistentry id="reader-message-forward-redirect">
  <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>
</varlistentry>

<varlistentry id="reader-message-forward-with-custom-template">
  <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>
</varlistentry>

<varlistentry id="reader-message-send-again">
  <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>
</varlistentry>

<!-- <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> -->

<varlistentry id="reader-message-mailing-list">
  <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>
</varlistentry>

<varlistentry id="reader-message-copy-message-to">
  <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>
</varlistentry>

<varlistentry id="reader-message-move-message-to">
  <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>
</varlistentry>

<varlistentry id="reader-mark-messages">
  <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>
</varlistentry>

<varlistentry id="reader-mark-thread">
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Mark Thread</guisubmenu></menuchoice></term>
  <listitem><para>Lets you change the status of all messages in a thread as follows:</para>
  <informaltable><tgroup cols="3">
    <thead><row><entry>Status</entry><entry>Symbol</entry><entry>Meaning</entry></row></thead>
    
    <tbody>
    <row>
    <entry><guimenuitem>Mark Thread as Read</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-read.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>The entire thread has been read.</entry></row>

    <row>
    <entry><guimenuitem>Mark Thread as Unread</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-mark-unread.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>The thread has not been read yet.</entry></row>

    <row>
    <entry><guimenuitem>Mark Thread 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 threads
    that are in some way important to you.</entry></row>
    
    <row>
    <entry><guimenuitem>Remove Important Thread 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 thread.</entry></row>

    <row>
    <entry><guimenuitem>Mark Thread 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 threads that are
    action items (&eg;, a to-do list).</entry></row>
    
    <row>
    <entry><guimenuitem>Remove Action Item Thread 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 thread.</entry></row>

    <row>
    <entry><guimenuitem>Watch Thread</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-thread-watch.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>Sets the watched thread status, which lets you easily view threads you're interested in by
    selecting the <guimenu>Watched</guimenu> status in the drop down box found in the Quick Search Bar.
    (Click on the <inlinemediaobject><imageobject><imagedata fileref="view-filter.png" format="PNG"/>
    </imageobject></inlinemediaobject> icon to display the filterable categories.)</entry></row>
    
    <row>
    <entry><guimenuitem>Ignore Thread</guimenuitem></entry>
    <entry><inlinemediaobject><imageobject><imagedata fileref="mail-thread-ignored.png" format="PNG"/></imageobject>
    </inlinemediaobject></entry>
    <entry>Allows you to ignore entire threads.</entry></row>
    </tbody>
    
  </tgroup></informaltable>
  <para>&nbsp;</para><!-- add whitespace --></listitem>
</varlistentry>

<varlistentry id="message-create-filter">
  <term><menuchoice><guimenu>Message</guimenu><guisubmenu>Create Filter</guisubmenu></menuchoice></term>
  <listitem><para>Opens the <link linkend="filter-dialog-id">Filter dialog</link> with a new filter added.
  This new filter is based on fields in the current message, depending on the submenu item you select:</para>
  <simplelist>
    <member>Filter on Subject...</member>
    <member>Filter on From...</member>
    <member>Filter on To...</member>
    <member>Filter on Mailing-List...(currently selected message must be a mailing list for this to be available).</member>
  </simplelist></listitem>
</varlistentry>

<varlistentry id="reader-message-apply-filter">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Apply Filter</guimenuitem></menuchoice></term>
  <listitem><para>Lets you <guimenuitem>Apply all Filters</guimenuitem>. If you have spam filtering set up via
  the <link linkend="the-anti-spam-wizard">Anti-Spam Wizard</link>, the options <guimenuitem>Classify as
  Spam</guimenuitem> and <guimenuitem>Classify as NOT Spam</guimenuitem> will also be available here.</para></listitem>
</varlistentry>

<!-- <varlistentry id="reader-message-create-to-do-reminder">
<term><menuchoice>
<guimenu>Message</guimenu>
<guimenuitem>Create To-do/Reminder</guimenuitem>
</menuchoice></term>
<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>
</varlistentry>

<varlistentry id="reader-message-add-note">
<term><menuchoice>
<guimenu>Message</guimenu>
<guimenuitem>Add Note...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Brings up the &kontact; Note dialog to add a note to the selected email.</action></para></listitem>
</varlistentry>  These items have been moved to "Plugins", and can now only be invoked via the Toolbar. @dcb2021086 -->

<varlistentry id="reader-message-viewsource">
  <term><menuchoice><shortcut><keycap>V</keycap></shortcut>
  <guimenu>Message</guimenu><guimenuitem>View Source</guimenuitem></menuchoice></term>
  <listitem><para>Shows the message and its complete headers in plain text format in a new window.
  This can help you figure out where a message really came from. </para>
  <note><para>You should be aware that it is easy to fake, or spoof, the <literal>From:</literal>
  header in a message. You can always find out which mail servers were used to send the message by
  examining the <literal>Received:</literal> lines in the message headers.</para></note>
  <para>&nbsp;</para></listitem>
</varlistentry>

<varlistentry id="reader-show-message-structure">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>D</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Show Message Structure</guimenuitem></menuchoice></term>
  <listitem><para>Displays the structure viewer, an area below the preview pane that lets you
  view each &MIME; component of a message separately. This item will only be present if the <link
  linkend="configure-plugins-tools">Expert Plugin</link> has been activated.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>
</variablelist> 

</sect2>

<sect2 id="reader-tools-menu">
<title>Tools Menu</title>
<screenshot>
<screeninfo>The Tools Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readertools.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Tools Menu</phrase>
    </textobject>
    <caption>
      <para>The Tools Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<variablelist>

<varlistentry id="reader-tools-find-messages">
  <term><menuchoice><shortcut><keycap>S</keycap></shortcut>
  <guimenu>Tools</guimenu><guimenuitem>Find Messages...</guimenuitem></menuchoice></term>
  <listitem><para>Opens a search window that lets you search for messages with certain characteristics,
  &eg;, a certain subject. Please see <link linkend="filter-criteria">Filter Criteria</link>
  for details on search options.</para>
  <para>Your search results will be displayed in the text area; you may either <guibutton>Open Search
  Folder</guibutton> to see a folder containing the messages that were located, or highlight the desired
  message and select <guibutton>Open Message</guibutton>. Additional actions are available via a context
  menu, which can be activated by clicking the &RMB;.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-addressbook">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Address Book</guimenuitem></menuchoice></term>
  <listitem><para>Starts <ulink url="help:kaddressbook">&kaddressbook;</ulink>, the &kde; email
  address / personal contact information management program.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-certificate-manager">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Certificate Manager</guimenuitem></menuchoice></term>
  <listitem><para>Starts <ulink url="help:kleopatra">&kleopatra;</ulink>, the &kde; certificate manager.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-edit-out-of-office-replies">
  <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Edit "Out of Office" Replies...</guisubmenu></menuchoice></term>
  <listitem><para>Launches the <guilabel>Configure "Out of Office" Replies</guilabel> dialog, which allows you
  to set up vacation notifications.</para>
  <note><para><guilabel>Out of Office reply</guilabel> functionality relies on server-side filtering. To use it
  you must configure the <link linkend="receiving-mail">Filtering tab</link> (see options relevant to a &kolab; server)
  of your &IMAP; account set-up.</para></note>
  <para>&nbsp;</para></listitem>
</varlistentry>

<!-- <varlistentry id="reader-tools-debug-sieve">
<term><menuchoice>
<guimenu>Tools</guimenu>
<guisubmenu>Debug Sieve...</guisubmenu>
</menuchoice></term>
<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>
<note><para>You must have sieve support on your email server.</para></note></listitem>
</varlistentry> -->

<varlistentry id="reader-tools-filter-log-viewer">
  <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Filter Log Viewer...</guisubmenu></menuchoice></term>
  <listitem><para>Opens the viewer window for the filter log; there you will find some options to
   control the logging of the filtering process. In the log you will find valuable
   information about the filter rules used, the result of evaluating those rules, and which
   filter actions were applied to a particular message.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-import-messages">
  <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Import from another Email Client...</guisubmenu>
  </menuchoice></term>
  <listitem><para>Launches the Akonadi Import Wizard dialog, which assists in importing settings and email
  from a wide variety of email clients. Please see the <ulink url="help:/importwizard">Import Wizard</ulink>
  documentation for details.</para>
  <note><para>Close &kmail; before importing data. The wizard may modify &kmail;'s configuration file, and
  can cause unpredictable results if you attempt to import data while &kmail; is running.</para></note>
  <para>&nbsp;</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-export-data">
  <term><menuchoice><guimenu>Tools</guimenu><guisubmenu>Import/Export &kmail; Data...</guisubmenu></menuchoice></term>
  <listitem><para>Launches the PIM Data Exporter dialog, which assists in exporting your settings and email, or
  restoring them from a back up copy. Please see <ulink url="help:/pimdataexporter">Pim Data Exporter</ulink>
  for details.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-activity-log">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Log Activities...</guimenuitem></menuchoice></term>
  <listitem><para>Starts the Activity Logger, which logs certain activities. This option is only available
  when the <guilabel>Log Activities</guilabel> plugin has been loaded. Primarily for developers.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-anti-spam-wizard">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Anti-Spam Wizard...</guimenuitem></menuchoice></term>
  <listitem><para>Launches the Anti-Spam Wizard, which can help you set up spam filtering. Please
  see <link linkend="the-anti-spam-wizard">Anti-Spam Wizard</link> for details. This option is
  only available when the <guilabel>Antispam</guilabel> plugin has been loaded.</para></listitem>
</varlistentry>

<varlistentry id="reader-tools-anti-virus-wizard">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Anti-Virus Wizard...</guimenuitem></menuchoice></term>
  <listitem><para>Launches the Anti-Virus Wizard, which can help you set up anti-virus scanning. Please
  see <link linkend="the-anti-virus-wizard">Anti-Virus Wizard</link> for details. This option is only
  available when the <guilabel>Antivirus</guilabel> plugin has been loaded.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>
</variablelist>
</sect2>


<sect2 id="reader-settings-menu">
<title>Settings Menu</title>
<screenshot>
<screeninfo>The Settings Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readersettings.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Settings Menu</phrase>
    </textobject>
    <caption>
      <para>The Settings 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-settings">Settings Menu</ulink> in &kde;
Fundamentals. The items listed here are &kmail; specific.</para>
<variablelist>

<varlistentry id="reader-settings-show-quick-search-bar">
<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut>
<guimenu>Settings</guimenu><guimenuitem>Show Quick Search bar</guimenuitem></menuchoice></term>
<listitem><para>Enables the Quick Search bar, which lets you quickly search for messages matching
your criteria.</para></listitem>
</varlistentry>

<varlistentry id="reader-settings-configure-filters">
  <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Filters...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the <link linkend="filters">Message Filters</link> dialog.</para></listitem>
</varlistentry>

<varlistentry id="settings-manage-sieve-scripts">
  <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Manage Sieve Scripts...</guimenuitem></menuchoice></term>
  <listitem><para>If your mail server supports sieves (server side filtering), you may
  configure those scripts here.</para></listitem>
</varlistentry>

<varlistentry id="settings-add-account">
  <term><menuchoice><guimenu>Settings</guimenu><guisubmenu>Add Account...</guisubmenu></menuchoice></term>
  <listitem><para>Starts the Account Wizard dialog, which assists in setting up new or additional accounts.
  Please see <link linkend="account-wizard">Account Wizard</link> for details.</para></listitem>
</varlistentry>

<varlistentry id="reader-settings-configure-automatic-archiving">
  <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Automatic
  Archiving...</guimenuitem></menuchoice></term>
  <listitem><para>Initiates a dialog to set up automatic archiving. See <ulink
  url="help:/akonadi_archivemail_agent">Automatic Archiving</ulink> for details.</para></listitem>
</varlistentry>

<!-- <varlistentry id="reader-settings-configure-send-later-agent">
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Send Later Agent...</guimenuitem>
</menuchoice></term>
<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>
 Please see <ulink url="help:/akonadi_sendlater_agent">Send Later Agent</ulink> for details.</para></listitem>
</varlistentry>
<varlistentry id="reader-settings-configure-folder-archive-agent">
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Folder Archive Agent...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Brings up a dialog that allows you to configure accounts to use the folder archive agent feature with.</action>
 Please see <ulink url="help:/akonadi_folderarchive_agent">Folder Archive Agent</ulink> for details.</para></listitem>
</varlistentry>
<varlistentry id="reader-settings-configure-notifications">
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Configure Notifications...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog that lets you configure what happens when new mail arrives,</action> &eg; play a sound, display a popup, &etc;</para></listitem>
</varlistentry> These three options have been moved to the Plugins Configuration tab. @dcb2021086.  -->

<varlistentry id="reader-settings-configure-kmail">
  <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &kmail;...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the <link linkend="configure">Configure &kmail;</link> dialog. There are
  hundreds of variables to play with. Have fun!</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="reader-help-menu">
<title>Help Menu</title>
<screenshot>
<screeninfo>The Help Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="readerhelp.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Help Menu</phrase>
    </textobject>
    <caption>
      <para>The Help Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<para>This is the <ulink url="help:/fundamentals/menus.html#menus-help">Help
Menu</ulink> of the &kde; Fundamentals, with one additional item.</para>

<variablelist>
<varlistentry id="reader-help-intro">
  <term><menuchoice><guimenu>Help</guimenu><guimenuitem>&kmail; Introduction</guimenuitem></menuchoice></term>
  <listitem><para>Opens the <link linkend="intro">Introduction</link> welcome screen.</para></listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>

<sect1 id="composer-window-menus">
<title>The &kmail; Composer Window</title>

<sect2 id="composer-file-menu">
<title>Message Menu</title>
<screenshot>
<screeninfo>The Message Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composermessage.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 -->

<variablelist>
<varlistentry id="composer-message-new-composer">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>New Composer</guimenuitem></menuchoice></term>
  <listitem><para>Opens a new composer window so you can create a message.</para></listitem>
</varlistentry>

<!-- <varlistentry id="composer-message-new-main-window">
<term><menuchoice>
<guimenu>Message</guimenu>
<guimenuitem>New Main Window</guimenuitem>
</menuchoice></term>
<listitem><para><action>Creates a new main window.</action></para></listitem>
</varlistentry>

<varlistentry id="composer-message-new-addressbook-contact">
<term><menuchoice>
<guimenu>Message</guimenu>
<guimenuitem>New AddressBook Contact</guimenuitem>
</menuchoice></term>
<listitem><para><action>Brings up the &kontact; New Contact Dialog</action> to add a new contact your addressbook.</para></listitem>
</varlistentry> Thes options not available in 5.14.2 @dcb2021088. -->

<varlistentry id="composer-message-send-mail">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>Return</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Send Mail</guimenuitem></menuchoice></term>
  <listitem><para>Sends the message immediately. If you use &SMTP; to send your messages and the &SMTP;
  server is not reachable, the message will remain in the outbox and you will get an error message.
  After the connection issues have been resolved, you can send the messages in the outbox using <link
  linkend="reader-send-queued-messages"><menuchoice><guimenu>File</guimenu><guimenuitem>Send Queued
  Messages</guimenuitem></menuchoice></link> (in the reader window).</para></listitem>
</varlistentry>

<varlistentry id="composer-message-send-mail-via">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Mail Via &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Allows you to specify which outgoing mail server will be used to send the message.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-send-later">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Later</guimenuitem></menuchoice></term>
  <listitem><para>Launches the send later dialog. Please see the <ulink url="help:/akonadi_sendlater_agent">Send
  Later</ulink> documentation for details.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-send-later-via">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Send Later Via &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Allows you to specify which outgoing mail server will be used
  to send the delayed message.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-save-as-file">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Save as File</guimenuitem></menuchoice></term>
  <listitem><para>Saves the message as a file. Three formats are supported: Rich Text (.html),
  plain text (.txt), and Open Document Format (.odt).</para></listitem>
</varlistentry>

<varlistentry id="composer-message-save-as-draft">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Save as Draft</guimenuitem></menuchoice></term>
  <listitem><para>Saves the message in the <guilabel>drafts</guilabel> folder
  so you can finish it later.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-save-as-template">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Save as Template</guimenuitem></menuchoice></term>
  <listitem><para>Lets you save your message as a template. Please see <link
  linkend="new-compose-from-templates">Compose from templates</link> for more information.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-insert-text-file">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Insert Text File...</guimenuitem></menuchoice></term>
  <listitem><para>Inserts a text file into the message text, starting at the cursor position.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-insert-recent-text-file">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Insert Recent Text File &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Lets you choose from a list of recently inserted text files, and inserts that file into
  your message. Select <guimenuitem>Clear List</guimenuitem> to clear the list.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-print-preview">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Print Preview</guimenuitem></menuchoice></term>
  <listitem><para>Opens a print preview window and displays your message, formatted for printing.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-print">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Print...</guimenuitem></menuchoice></term>
  <listitem><para>Formats and prints the message you have composed.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-share">
  <term><menuchoice><guimenu>Message</guimenu><guimenuitem>Share Mail Text... &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Lets you make a second copy of your message somewhere else. Four options are provided:
  Nextcloud (an OSS file-sharing app), Pastebin <ulink url="https://pastebin.com">(a freely available web
  site)</ulink>, Bluetooth, and Email (opens another composer window, and adds the current message to that new
  message, as an attachment). This option is not available unless the <guilabel>Share Text</guilabel>
  plugin is active.</para></listitem>
</varlistentry>

<varlistentry id="composer-message-close">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut>
  <guimenu>Message</guimenu><guimenuitem>Close</guimenuitem></menuchoice></term>
  <listitem><para>Closes this composer window.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>
</variablelist>

</sect2>


<sect2 id="composer-edit-menu">
<title>Edit Menu</title>
<screenshot>
<screeninfo>The Edit Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composeredit.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 the <ulink
url="help:/fundamentals/menus.html#menus-edit">Edit Menu</ulink> section of the
&kde; Fundamentals Handbook. The items listed here are &kmail; specific.</para>

<variablelist>
<varlistentry id="composer-edit-paste-quotation">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Paste as Quotation</guimenuitem></menuchoice></term>
  <listitem><para>Pastes the text from the clipboard and marks it as a quotation (&ie;,
  each line preceded by "&gt;" and a space).</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-paste-attachment">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Paste as Attachment</guimenuitem></menuchoice></term>
  <listitem><para>Pastes a file that has been copied to the clipboard (&eg;, by using
  the &dolphin; file manager) as an attachment.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-paste-without-formatting">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>V</keycap></keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Paste Without Formatting</guimenuitem></menuchoice></term>
  <listitem><para>Pastes data from the clipboard as plain text, with no &HTML; formatting.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-clean-spaces">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Clean Spaces</guimenuitem></menuchoice></term>
  <listitem><para>This option supposedly replaces multiple adjacent newline characters or spaces with
  single line breaks / spaces, but in testing, it apparently does absolutely nothing.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-add-quote-characters">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Add Quote Characters</guimenuitem></menuchoice></term>
  <listitem><para>Prepends each line of the selected text with the quotation indicator (&gt; and a space, by
  default). If no selection is made, adds the indicator to every line in the message.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-remove-quote-characters">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Remove Quote Characters</guimenuitem></menuchoice></term>
  <listitem><para>Removes the left-most quotation indicator from the selected text.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-insert-email">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Insert Email...</guimenuitem></menuchoice></term>
  <listitem><para>Displays a list of all the names in your address book, then inserts the chosen email address at
  the cursor position (after you make a selection and click the <guibutton>OK</guibutton> button). This option
  is only available when the <guimenuitem>Insert Email</guimenuitem> plugin has been loaded.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-insert-nbsp">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Space;</keycombo></shortcut>
  <guimenu>Edit</guimenu><guimenuitem>Insert  Non Breaking Space</guimenuitem></menuchoice></term>
  <listitem><para>Inserts a non breaking space at the cursor position. This option is only available
  when the <guimenuitem>Insert Non Breaking Space</guimenuitem> plugin has been loaded.</para></listitem>
</varlistentry>

<!-- <varlistentry id="composer-edit-uppercase">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Uppercase</guimenuitem>
</menuchoice></term>
<listitem><para>Convert the selected text to uppercase.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-lowercase">
<term><menuchoice>
<guimenu>Edit</guimenu>
<guimenuitem>Lowercase</guimenuitem>
</menuchoice></term>
<listitem><para>Convert the selected text to lowercase.</para></listitem>
</varlistentry> These optons have been consolidated in the "Change Case" plugin. @dcb2021089. -->

<varlistentry id="composer-edit-insert-special-character">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Insert Special Character...</guimenuitem></menuchoice></term>
  <listitem><para>Lets you insert a special character at the cursor position. A large number of Unicode
  characters are made available. This option is only provided if the <guimenuitem>Insert Special
  Character</guimenuitem> plugin has been activated.</para>
  
  <para>This menu item was moved to the <guimenu>Insert</guimenu> menu in release 5.17. If you have activated
  the plugin, and this entry does not appear when &kmail; is restarted, check the <guimenu>Insert</guimenu>
  menu.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-change-case">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Change Case &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Helps you modify the capitalization of the selected text. There are four options:
  <guilabel>Uppercase</guilabel> (capitalizes the selected characters), <guilabel>Lowercase</guilabel>
  (forces selected text to all lower case), <guilabel>Sentence case</guilabel> (capitalizes the first
  letter of the selection and makes the rest lower case), and <guilabel>Reverse Case</guilabel> (converts
  capital letters to lower case, and vice versa). This option is only provided if the <guimenuitem>Change
  Case</guimenuitem> plugin has been activated. This menu item remains grayed out until some snippet of
  text has been selected for modification.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-zoom">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Zoom... &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Lets you zoom in or zoom out on the message you are composing. This is the same function
  appearing as <menuchoice><guimenu>View</guimenu><guisubmenu>Zoom &gt;</guisubmenu></menuchoice> in
  the message preview window. This option is not available unless the <guimenuitem>Zoom Text</guimenuitem>
  plugin has been loaded.</para></listitem>
</varlistentry>

<varlistentry id="composer-edit-variables">
  <term><menuchoice><guimenu>Edit</guimenu><guimenuitem>Variables &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Lets you insert the contents of a named field at the cursor position. You may choose
  among <guilabel>To &gt;</guilabel>, <guilabel>From &gt;</guilabel>, <guilabel>CC &gt;</guilabel>,
  <guilabel>Attachment &gt;</guilabel>, <guilabel>Date/Time &gt;</guilabel>, and <guilabel>Misc &gt;</guilabel>
  (which has just one associated submenu item, "Subject"). There is one notable quirk: the date/time displayed
  in the submenu selections is fixed at the time the Composer window was opened, but the value actually inserted
  in a message is taken from the system clock.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="composer-view-menu">
<title>View Menu</title>
<screenshot>
<screeninfo>The View Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composerview.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 -->

<para>This menu lets you toggle the display of the header fields and a few other items in the
composer window. Selected items will be marked (check box colored in) in the menu.</para>

<para>Several options are available:</para>

<itemizedlist>
  <listitem>
    <para><guimenuitem>All Fields</guimenuitem>. Displays all six of the following fields.</para>
  </listitem>
  <listitem>
    <para><guimenuitem>Identity</guimenuitem>. If you have defined more than one identity,
    this will be a drop down box.</para>
  </listitem>
  <listitem>
    <para><guimenuitem>Dictionary</guimenuitem> used for spell checking. If multiple dictionaries
    are installed, this will be a drop down box.</para>
  </listitem>
  <listitem>
    <para><guimenuitem>Sent-Mail Folder</guimenuitem>. The <guilabel>&nbsp;<inlinemediaobject><imageobject>
    <imagedata fileref="document-open.png" format="PNG"/></imageobject></inlinemediaobject>&nbsp;</guilabel>
    button appearing on the right when this option is checked opens a folder selection dialog.</para>
  </listitem>
  <listitem>
    <para><guimenuitem>Mail Transport</guimenuitem>. If you have created more than one outgoing
    account, this will be a drop down box.</para>
  </listitem>
  <listitem>
    <para><guimenuitem>From</guimenuitem>. The contents of this field may vary, depending on the Identity you use.</para>
  </listitem>
  <listitem>
    <para><guimenuitem>Subject</guimenuitem>. Use this field to describe your message, briefly.</para>
  </listitem>
</itemizedlist>

<para>The <guilabel>To <inlinemediaobject><imageobject><imagedata fileref="go-down.png" format="PNG"/></imageobject>
  </inlinemediaobject></guilabel> drop down box is always present at the top of the composer window. Use
  it to select <guilabel>CC</guilabel>, <guilabel>BCC</guilabel>, and <guilabel>Reply-To</guilabel>
  addresses, as needed. Please see <link linkend="composer-headers">Composer Headers</link> for
  further details on message headers.</para>
  
<para>&nbsp;</para>

<variablelist>
<varlistentry id="composer-view-use-fixed-font">
  <term><menuchoice><guimenu>View</guimenu><guimenuitem>Use Fixed Font</guimenuitem></menuchoice></term>
  <listitem><para>Uses a fixed width (monospaced) font to display the currently
  edited message. The particular font to be used can be configured in the
  <guilabel>Appearance</guilabel> section of &kmail;'s configuration dialog.</para></listitem>
</varlistentry>

<varlistentry id="composer-view-snippets">
  <term><menuchoice><guimenu>View</guimenu><guimenuitem>Snippets</guimenuitem></menuchoice></term>
  <listitem><para>Displays a column on the right hand side of the composer window that allows you to use and create
  snippets. Please see <link linkend="setup-text-snippets">Snippets</link> for more information.</para>
  <para>&nbsp;</para></listitem>
  </varlistentry>
  
</variablelist>

</sect2>

<sect2 id="composer-options-menu">
<title>Options Menu</title>
<screenshot>
<screeninfo>The Options Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composeroptions.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Options Menu</phrase>
    </textobject>
    <caption>
      <para>The Options Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<para>This menu lets you toggle various options for the current message. Selected
items will be marked (check box colored in) in the menu.</para>

<variablelist>

<varlistentry id="composer-options-urgent">
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Urgent</guimenuitem></menuchoice></term>
  <listitem><para>Sets the priority of the message to Urgent by inserting two header lines:
  "X-PRIORITY: 2 (High)" and "Priority: urgent". The receiver's email client must provide support
  for these headers; otherwise they will have no effect. &kmail; itself does not support priorities
  for incoming messages (although you can <link linkend="reader-mark-messages">mark messages</link>
  as Important).</para></listitem>
</varlistentry>

<varlistentry id="composer-options-request-mdn">
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Request Disposition
  Notification</guimenuitem></menuchoice></term>
  <listitem><para>If you choose this option, &kmail; will
  insert a Disposition-Notification-To: header line in the
  message, which is a request to receive an email notification
  once your message has been downloaded and read by the recipient.
  This function must be supported, and enabled by the receiver's
  email client; otherwise, it will not work.</para>
  <para>See <xref linkend="configure-security-reading-mdns"/>
  for background information and several ways to customize the
  read receipts that &kmail; itself sends in response to a
  received Disposition-Notification-To: header line.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-request-confirm">
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Request Delivery
  Confirmation</guimenuitem></menuchoice></term>
  <listitem><para>If you choose this option, &kmail; will
  insert a Return-Receipt-To: header line in the message, which
  is a request to receive an email notification once your message
  has been uploaded by your email server and delivered to the
  recipient. This function must be supported by your outgoing
  email server; otherwise, it will not work.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-sign-message">
  <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Sign Message</guisubmenu></menuchoice></term>
  <listitem><para>Digitally signs the message using <application>OpenPGP</application> or an X.509 certificate.
  You can learn more about this option in the <link linkend="pgp">chapter on OpenPGP</link>.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-encrypt-message">
  <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Encrypt Message</guisubmenu></menuchoice></term>
  <listitem><para>Encrypts the message using <application>OpenPGP</application> or an X.509 certificate.
  You can learn more about encryption in the <link linkend="pgp">chapter on OpenPGP</link>.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-select-crypto-message-format">
  <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Cryptographic Message Format &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Lets you choose the cryptographic message format to use when
  digitally signing and/or encrypting this message. Please see <link 
  linkend="cryptographic-message-formats">Cryptographic Message
  Formats</link> for more information.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-rich-text-editing">
  <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Rich Text Editing</guisubmenu></menuchoice></term>
  <listitem><para>Enables Rich Text (&ie;, &HTML;) editing.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-encoding">
  <term><menuchoice><guimenu>Options</guimenu><guisubmenu>Encoding &gt;</guisubmenu></menuchoice></term>
  <listitem><para>Sets the charset encoding of this message. The chosen encoding will be identified
  by a header line in the outgoing message. You can use <guilabel>Auto</guilabel> in almost every
  case; &kmail; will notify you if you must select a different encoding manually.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-wordwrap">
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Wordwrap</guimenuitem></menuchoice></term>
  <listitem><para>Toggles the automatic wordwrap feature. You may wish to turn this off when
  pasting long lines (&eg;, &URL;s) that should not be wrapped.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-automatic-spellchecking">
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Automatic Spellchecking</guimenuitem></menuchoice></term>
  <listitem><para>Toggles automatic spellchecking on or off.</para></listitem>
</varlistentry>

<varlistentry id="composer-options-followup">
  <term><menuchoice><guimenu>Options</guimenu><guimenuitem>Create Follow Up Reminder...</guimenuitem></menuchoice></term>
  <listitem><para>Initiates a dialog allowing you to add a "To Do" item to your calendar. This item
  is grayed out if the <ulink url="help:/akonadi_followupreminder_agent">Followup Reminder Agent</ulink>
  plugin has not been activated.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

</variablelist>

</sect2>


<sect2 id="composer-attach-menu">
<title>Attach Menu</title>
<screenshot>
<screeninfo>The Attach Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composerattachmenu.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Attach Menu</phrase>
    </textobject>
    <caption>
      <para>The Attach Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<para>This menu lets you select attachment options.</para>

<variablelist>

<varlistentry id="composer-attach-append-signature">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Append Signature</guimenuitem></menuchoice></term>
  <listitem><para>Appends your signature (<quote>footer</quote>) to the end of the message. Please see
  <link linkend="configure-identity-signature">Configure Identity Signature</link> for details on
  configuring your signature.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-prepend-signature">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Prepend Signature</guimenuitem></menuchoice></term>
  <listitem><para>Prepends your signature (<quote>header</quote>) at the beginning of the message.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-cursor-signature">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Insert Signature At
  Cursor Position</guimenuitem></menuchoice></term>
  <listitem><para>Inserts your signature at the current cursor location.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-public-key">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Attach Public Key...</guimenuitem></menuchoice></term>
  <listitem><para>Opens the <guilabel>Attach Public OpenPGP Key</guilabel> dialog. Please see
  <link linkend="configure-identity-cryptography-openpgp-sign">Configure Identity Cryptography
  OpenPGP Signing</link> for details.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-attach-my-public-key">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Attach My Public Key</guimenuitem></menuchoice></term>
  <listitem><para>Attaches your <application>GnuPG</application> public key, or your X.509 certificate,
  (&ie;, the public key associated with your current identity) to your message.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-file">
  <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach &gt;</guisubmenu>
  <guimenuitem>Attach File...</guimenuitem></menuchoice></term>
  <listitem><para>Attaches one or more files to the current message. Attachments are encrypted
  by default (if the message is encrypted). Please see <link linkend="cryptographic-message-formats">Cryptographic
  Message Formats</link> for more information on encryption and attachments.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-directory">
  <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach &gt;</guisubmenu>
  <guimenuitem>Attach Directory...</guimenuitem></menuchoice></term>
  <listitem><para>Creates a ZIP archive containing the selected Directory,
  and attaches the archive to this message.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-ownvcard">
  <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach &gt;</guisubmenu>
  <guimenuitem>Attach Own vCard</guimenuitem></menuchoice></term>
  <listitem><para>Attaches your vCard to the current message.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-vcard">
  <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach &gt;</guisubmenu>
  <guimenuitem>Attach vCards...</guimenuitem></menuchoice></term>
  <listitem><para>Opens a dialog with &kaddressbook; that lets you select one or more
  people (&Ctrl; and left-click), and then attaches vCards for all those selected.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-clipboard">
  <term><menuchoice><guimenu>Attach</guimenu><guisubmenu>Attach &gt;</guisubmenu>
  <guimenuitem>Attach Text From Clipboard...</guimenuitem></menuchoice></term>
  <listitem><para>If the topmost item saved on the clipboard contains at least two bytes,
  a file name dialog will open. &kmail; will create an attachment containing the text
  from the clipboard, and give the attachment the name you have chosen.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-remove-attachment">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Remove Attachment</guimenuitem></menuchoice></term>
  <listitem><para>Removes the selected attachment (selected via the attachment
  area beneath the main composer window).</para>
  <note><para>This menu item, and the next two, will be grayed out until an attachment is
  selected.</para></note></listitem>
</varlistentry>

<varlistentry id="composer-attach-save-attachment">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Save Attachment As...</guimenuitem></menuchoice></term>
  <listitem><para>Saves the attachment selected in the attachment window as a file.</para></listitem>
</varlistentry>

<varlistentry id="composer-attach-attachment-properties">
  <term><menuchoice><guimenu>Attach</guimenu><guimenuitem>Attachment Properties</guimenuitem></menuchoice></term>
  <listitem><para>Displays the <link linkend="attachments">properties of the attachment</link> that has been
  selected via the attachment window. It also lets you sign/encrypt the attachment, and alter some of its
  other properties (name, description, &MIME; type, &etc;).</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="composer-tools-menu">
<title>Tools Menu</title>
<screenshot>
<screeninfo>The Tools Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composertools.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Tools Menu</phrase>
    </textobject>
    <caption>
      <para>The Tools 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-tools">Tools Menu</ulink> of the &kde; Fundamentals.
  The items listed here are &kmail; specific.</para>
  
<variablelist>
  <varlistentry id="composer-tools-select-recipients">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Select Recipients...</guimenuitem></menuchoice></term>
  <listitem><para>Opens a <guilabel>Select Recipient</guilabel> dialog, with 
  the contents of all your address books to select from.</para></listitem>
</varlistentry>

<varlistentry id="composer-tools-addressbook">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Addressbook...</guimenuitem></menuchoice></term>
  <listitem><para>Launches the <ulink url="help:/kaddressbook">&kaddressbook;</ulink> program.</para></listitem>
</varlistentry>

<varlistentry id="composer-tools-save-distribution-list">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Save Distribution List...</guimenuitem></menuchoice></term>
  <listitem><para>Opens a dialog that lets you save groups of contacts as a single named item. Very handy
  if you frequently send the same message to all the members of a club, for instance.</para></listitem>
</varlistentry>

<varlistentry id="composer-tools-autocorrect">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Autocorrect Text &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Performs autocorrection. You have two options: scan and autocorrect the
  selected text, or apply <link linkend="configure-composer-autocorrection">autocorrection</link> to the whole
  message. This menu item will not be present unless the <guilabel>Autocorrection</guilabel> plugin has been
  loaded, and it won't work unless the Autocorrection function has been enabled on the Composer configuration
  page.</para></listitem>
</varlistentry>

<varlistentry id="composer-tools-translator">
  <term><menuchoice><shortcut><keycombo action="simul">&Ctrl;&Alt;<keycap>T</keycap></keycombo></shortcut>
  <guimenu>Tools</guimenu><guimenuitem>Translator</guimenuitem></menuchoice></term>
  <listitem><para>Opens the <link linkend="using-the-translator">translator window</link>.</para></listitem>
</varlistentry>

<varlistentry id="composer-tools-grammarcheck">
  <term><menuchoice><guimenu>Tools</guimenu><guimenuitem>Check Grammar (Language Tool)</guimenuitem></menuchoice></term>
  <listitem><para>Opens the grammar check window and examines your message, highlighting any errors
  that are found. This feature does not continuously update the scanned text as you type; you should
  first compose your message, then invoke grammar check. This tool is not available unless the
  <guilabel>Grammar Check</guilabel> plugin has been activated. Like the Translator function, Grammar Check
  passes your message through a server (default server: https://languagetool.org/api/v2) on the internet.</para>
  <para>&nbsp;</para></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="composer-settings-menu">
<title>Settings Menu</title>
<screenshot>
<screeninfo>The Settings Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composersettings.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Settings Menu</phrase>
    </textobject>
    <caption>
      <para>The Settings Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<para>If the menu item you seek is missing, please see <ulink url="help:/fundamentals/menus.html#menus-settings">Settings
  Menu</ulink> of the &kde; Fundamentals. The items listed here are &kmail; specific.</para>
  
<variablelist>
<varlistentry id="composer-settings-toolbars">
  <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Toolbars Shown &gt;</guimenuitem></menuchoice></term>
  <listitem><para>Lets you control which toolbars are displayed. You may choose any combination of three options:
  Main Toolbar (<guilabel>Send</guilabel>, <guilabel>Queue</guilabel>, <guilabel>Rich Text</guilabel>, &etc;),
  HTML Toolbar (<guilabel>Style</guilabel>, <guilabel>Font / Size</guilabel>, &etc;), and
  Text Direction (in case you use a right-to-left script). Note that the HTML Toolbar is easily
  toggled on and off via the <guibutton>Rich Text</guibutton> button on the Main Toolbar.</para></listitem>
</varlistentry>

<varlistentry id="composer-settings-spellcheck">
  <term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Spellchecker...</guimenuitem></menuchoice></term>
  <listitem><para>Allows you to configure <ulink url="help:/sonnet/">&sonnet;</ulink>, &kde;'s spell
  checker.</para><para>&nbsp;</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="composer-help-menu">
<title>Help Menu</title>
<screenshot>
<screeninfo>The Help Menu</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="composerhelp.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase>The Help Menu</phrase>
    </textobject>
    <caption>
      <para>The Help Menu</para>
    </caption>
  </mediaobject>
</screenshot>
<para>&nbsp;</para><!-- add whitespace -->

<para>
  This is exactly like the <ulink url="help:/fundamentals/menus.html#menus-help">Help
  Menu</ulink> of the &kde; Fundamentals.
</para>
</sect2>
</sect1>

</chapter>
