Chapter 5. Command and Menu Reference

Here you can choose to create one of four new items, as follows:

Opens saved email messages (.mbox files).

Displays a list of recently opened messages. Only those messages that have been saved as .mbox files and subsequently opened will appear on this list. If no such files exist, this menu item will be grayed out.

Saves the currently displayed message to a .mbox file. This file includes all the headers and attachments, in MIME format. If you want to save it as a different format (e.g., as a .txt file), uncheck the Automatically select filename extension (.mbox) box, and add the filename extension before saving the file.

Exports the currently displayed message as a .pdf file.

Starts up the KMailCVT program (aka the Email Import Wizard). This application lets you import messages from several email clients into KMail.

Shows how your email will appear when printed.

Displays a dialog that lets you print the currently displayed message.

Deletes old messages from all folders. Deletion will occur according to the rules in each folder's Properties dialog (the default is not to delete old messages at all).

Use this item to empty all trash folders, i.e., the local trash folder and all trash folders that may exist on IMAP servers. Messages in Trash will be permanently deleted, and cannot be retrieved.

Sets KMail to offline mode. This turns off all network jobs. This is useful when working without a network connection. When selected, this item will become File → Work Online, which must be selected to go back online (required to send and receive email).

Checks for new messages in all your accounts.

Checks for new messages from a particular account; your accounts will be listed in a submenu.

Sends the messages that are in your outbox. Messages can end up in your outbox because of transmission errors, or because you composed and attempted to send a message while offline. If there are no messages in your outbox, this menu item will be grayed out.

Sends the messages that are in your outbox via a specific outgoing account. This allows you to choose which server to use to send your queued messages. Servers must be configured in the Configure KMail dialog, under the Accounts+Sending tab, to be listed here. If there are no messages in the outbox folder, this menu item will be grayed out.

Starts the Akonadi Send Later Agent dialog. Any messages queued for later delivery by the composer's Message → Send Later option will appear in this dialog box. You can modify and / or delete them. Note that delayed messages are stored in the drafts folder, not in the outbox folder.

Starts the Akonadi Followup Reminder Agent dialog. Any followup reminder messages ("todos") created via the composer's Options → Create Followup Reminder... function will appear in this dialog box. You can delete those messages with the right mouse button context menu.

Exits KMail.

Creates an "Akonadi" pointer to the entire contents of the currently selected folder, and copies that pointer to the clipboard. A subsequent paste operation in a text editor will simply paste the pointer text. A subsequent paste operation in a KMail folder (or in the Dolphin file manager) will create a second copy of the folder and its contents.

Creates an "Akonadi" pointer to the currently selected folder, and copies that pointer to the clipboard. A subsequent "paste" operation in a text editor or in Dolphin will behave exactly like the preceding Copy Folder operation. A subsequent paste operation in KMail will move the folder and its contents to a different location (if pasted in some folder other than the originating folder).

Creates an "Akonadi" pointer to the currently selected message(s), and copies that pointer to the clipboard. A subsequent paste operation in a text editor will simply paste the pointer text. A subsequent paste operation in a KMail folder (or in the Dolphin file manager) will create a copy of the message(s), headers and all.

Creates an "Akonadi" pointer to the currently selected message(s), and copies that pointer to the clipboard. A subsequent "paste" operation in a text editor or in Dolphin will behave exactly like the preceding Copy Message operation. A subsequent paste operation in KMail will either create a second copy of the message(s) (if pasted in the originating folder) or move the message(s) to a different folder (if pasted in some folder other than the originating folder).

Pastes either the entire contents of a folder, or the contents of selected messages, depending on the operation that preceded the "paste". This operation cannot be used to paste selected text inside the reader window. If no copy / cut operation is pending, this option will be grayed out.

Moves the selected messages to the trash folder. If the selected messages are already in the trash folder, they will be permanently deleted.

Moves the selected thread to the trash folder, e.g., a conversation in a mailing list.

Searches the current message text for a string entered in the Find: textbox.

Selects all messages in the current folder.

Selects the text of the currently displayed message.

This submenu has the following options to change the appearance of the message list.

Selects your headers view. Please see Header Options for details on the available header views.

Changes the way attachments appear in the Message Preview Pane (independent of the MIME Tree). Please see Attachment Options for details on viewing attachments.

This will display the thread of the current message, i.e., all messages that are replies to the current message.

This will hide the thread of the current message, i.e., it will hide all messages that are replies to the current message.

Expands all threads in the current folder.

Collapses all threads in the current folder.

This option is apparently supposed to save something somewhere, but it's not yet working correctly.

This option is apparently supposed to restore whatever the preceding "Save" option is supposed to save, but it's not yet working correctly, either.

Select this option to stop KMail from transforming :-) into .

Uses a fixed width (Monospace) font to display the messages in the current folder. The font to be used can be configured in the Fonts tab on the Appearance page of the KMail configuration dialog.

Lets you choose the character encoding to be used in the Message Pane. The default, Auto, should work in almost every case.

This option lets you zoom in or out on every message displayed in the preview pane.

Shows a dialog box with a list of all your folders. Click on the folder you wish to view, and that folder will be opened for display in the message preview pane.

Selects the next message in the message list. The keyboard shortcut Right also performs this function.

Selects the next unread message in the message list. If there are no unread messages below the currently selected message, the behavior depends on the value of the When trying to find unread messages option.

Selects the previous message in the message list.

Selects the previous unread message in the message list. If there is no unread message above the currently selected message, then the behavior depends on the value of the When trying to find unread messages option.

Jumps to the next folder with unread messages.

Jumps to the previous folder with unread messages.

Scrolls down if you are not yet at the bottom of a message, otherwise jumps to the next unread message.

Opens the Folder Properties dialog that lets you modify the properties of the current folder.

Prompts you for a name, then creates a new folder as a subfolder of the current folder. This is exactly like File → New → Add Folder....

Sets the status of all unread messages in the current folder to "read".

Sets the status of all unread messages in the current folder (and all its subfolders) to "read".

Checks whether new mail has arrived in the currently selected folder.

Checks whether new mail has arrived in the currently selected folder, or in any of its subfolders.

Moves all of the messages in the selected folder into the trash folder.

Deletes the selected folder and all its contents. A warning message will be displayed. If the current folder is one of KMail's pre-defined folders (inbox, etc.), this menu item will be grayed out.

Brings up a dialog so you can create an archive of the currently selected folder. Please see the Folder → Archive Folder... section of "Using KMail" for details.

Searches the folder for duplicate messages and deletes them.

Searches the folder, and its subfolders, for duplicate messages, then deletes the duplicates.

Applies selected filters (All, Spam, or Not Spam) to the currently selected folder. Please see the Filter dialog for more information on filters.

Applies selected filters (All, Spam, or Not Spam) to the currently selected folder, and to its subfolders. Please see the Filter dialog for more information on filters.

Here you may select one of three options: Prefer HTML to Plain Text, Prefer Plain Text to HTML, or Use Global Setting.

If you have HTML messages enabled (see above), then you will also have the option to have images and other resources linked from the web downloaded automatically.

This opens the mailing list management dialog. This option is only available if the current folder contains messages from a mailing list. Please see the Mailing List dialog for more information on mailing lists.

This lets you assign a keyboard shortcut to the currently selected folder.

Opens the composer window so you can write a new message.

Opens the composer window so you can write a new message. If the current folder holds a mailing list and has a posting address defined, that posting address will automatically be entered as the To: address when the composer window is opened. If the current folder does not contain a mailing list, this item will be grayed out.

Opens the composer window, inserts quoted text from the currently selected message, and sets the To: field to either the mailing-list address (if you reply to a mailing-list message), or to the preferred reply-to address of the sender. If you want to control which address is set in the To: field, you should use Reply Special. The sending identity will automatically be set to the identity to which this message was addressed.

Opens the composer window, inserts the quoted text of the currently selected message, and sets the To: field to either the mailing-list address (when replying to a mailing-list message), or to the preferred reply-to address of the sender. The Copy to (CC): field is filled with the addresses of all the other recipients of the currently selected message, excluding your own address. The sending identity will automatically be set to the identity to which this message was addressed.

Opens the composer window, inserts the quoted text from the currently selected message, and sets the To: field to the preferred reply-to address of the sender. The sending identity will automatically be set to the identity to which this message was addressed.

Opens the composer window, inserts the quoted text of the currently selected message, and sets the To: field to the mailing-list address. If you did not specify a mailing-list address for the currently selected folder and KMail cannot determine the posting address from the currently selected message, the To: field will be empty. The sending identity will automatically be set to the identity to which this message was addressed.

Works just like Reply..., except that the text of the currently selected message is not quoted.

Works just like Reply... with an added option: you may select a custom template configured via Custom Templates.

Works just like Reply to All... with an added option: you may select a custom template configured via Custom Templates.

Forwards the message to a new recipient. The message and its attachments will be attached to the new message. The original message headers will be included in the forwarded message.

The message's text and some important header fields will be copied to the body of the new message, with text marking where the forwarded part begins. Attachments will be attached to the new message.

This works like "Forward", except that the message stays the same (even the From: field). The user who redirected the message is identified by special header fields (Redirect-From, Redirect-Date, Redirect-To, etc.).

Works just like "Forward", but gives you the option to select a custom template configured via the composer custom templates tab in Custom Templates.

Opens a composer window with the currently selected message so it can be sent again.

Offers several options for mailing list messages.

The following options are available in mailing list folders:

Copies the selected message(s) to a specified folder. You may choose from recent folders, local folders, or a specific IMAP account folder.

The same as "Copy Message To", above, except this option will permanently move the selected message(s) to the chosen folder.

Lets you change the status of the selected message to one of the following values:

Status	Symbol	Meaning
Mark Message as Read (Ctrl+R)		The message has been read.
Mark Message as Unread (Ctrl+U)		The message has not been read yet.
Mark Message as Important		This status will not automatically be set by KMail. You can use it freely to mark messages that are in some way important to you.
Remove Important Mark		Removes a previously set important flag from the message.
Mark Message as Action Item		This status will not automatically be set by KMail. Use this to mark messages that are action items; e.g., a to-do list.
Remove Action Item Mark		Removes a previously set action item mark from the message.

Lets you change the status of all messages in a thread as follows:

Status	Symbol	Meaning
Mark Thread as Read		The entire thread has been read.
Mark Thread as Unread		The thread has not been read yet.
Mark Thread as Important		This status will not automatically be set by KMail. You can use it freely to mark threads that are in some way important to you.
Remove Important Thread Mark		Removes a previously set "important" flag from the thread.
Mark Thread as Action Item		This status will not automatically be set by KMail. Use this to mark threads that are action items (e.g., a to-do list).
Remove Action Item Thread Mark		Removes a previously set action item mark from the thread.
Watch Thread		Sets the watched thread status, which lets you easily view threads you're interested in by selecting the Watched status in the drop down box found in the Quick Search Bar. (Click on the icon to display the filterable categories.)
Ignore Thread		Allows you to ignore entire threads.

Opens the Filter dialog with a new filter added. This new filter is based on fields in the current message, depending on the submenu item you select:

Lets you Apply all Filters. If you have spam filtering set up via the Anti-Spam Wizard, the options Classify as Spam and Classify as NOT Spam will also be available here.

Shows the message and its complete headers in plain text format in a new window. This can help you figure out where a message really came from.

Displays the structure viewer, an area below the preview pane that lets you view each MIME component of a message separately. This item will only be present if the Expert Plugin has been activated.

Opens a search window that lets you search for messages with certain characteristics, e.g., a certain subject. Please see Filter Criteria for details on search options.

Your search results will be displayed in the text area; you may either Open Search Folder to see a folder containing the messages that were located, or highlight the desired message and select Open Message. Additional actions are available via a context menu, which can be activated by clicking the right mouse button.

Starts KAddressBook, the KDE email address / personal contact information management program.

Starts Kleopatra, the KDE certificate manager.

Launches the Configure "Out of Office" Replies dialog, which allows you to set up vacation notifications.

Opens the viewer window for the filter log; there you will find some options to control the logging of the filtering process. In the log you will find valuable information about the filter rules used, the result of evaluating those rules, and which filter actions were applied to a particular message.

Launches the Akonadi Import Wizard dialog, which assists in importing settings and email from a wide variety of email clients. Please see the Import Wizard documentation for details.

Launches the PIM Data Exporter dialog, which assists in exporting your settings and email, or restoring them from a back up copy. Please see Pim Data Exporter for details.

Starts the Activity Logger, which logs certain activities. This option is only available when the Log Activities plugin has been loaded. Primarily for developers.

Launches the Anti-Spam Wizard, which can help you set up spam filtering. Please see Anti-Spam Wizard for details. This option is only available when the Antispam plugin has been loaded.

Launches the Anti-Virus Wizard, which can help you set up anti-virus scanning. Please see Anti-Virus Wizard for details. This option is only available when the Antivirus plugin has been loaded.

Enables the Quick Search bar, which lets you quickly search for messages matching your criteria.

Opens the Message Filters dialog.

If your mail server supports sieves (server side filtering), you may configure those scripts here.

Starts the Account Wizard dialog, which assists in setting up new or additional accounts. Please see Account Wizard for details.

Initiates a dialog to set up automatic archiving. See Automatic Archiving for details.

Opens the Configure KMail dialog. There are hundreds of variables to play with. Have fun!

Opens the Introduction welcome screen.