Warning, /pim/kmail/doc/kmail2/menus.docbook is written in an unsupported language. File is not indexed.

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