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