# Command and Menu Reference

Each &kmail; specific menu item is discussed below. When there is a keyboard shortcut that performs a menu item function, the default shortcut is listed with the menu item.

## The &kmail; Reader Window

### File Menu

The File Menu The File Menu

The File Menu

File New >

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

  &Ctrl;N File New New Message...

- Compose a new message. This will open a Composer window, where you can write a new message.

File New Message from Template >

- Creates a new message from a selected template. Please see Compose From Templates for additional information on creating templates. If you do not have any templates saved, you will see Message Message from Template > (no templates).

File New Add Folder...

- Creates a new folder. The ensuing dialog will ask you to give the new folder a name. The new folder will be created as a subfolder of the currently selected folder.

File New New AddressBook Contact...

- Launches the New Contact dialog, permitting you to add a new entry in &kaddressbook;.

&Ctrl;O File Open...

- Opens saved email messages (.mbox files).

File Open Recent

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

&Ctrl;S File Save As...

- 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 (⪚, as a `.txt` file), uncheck the Automatically select filename extension (.mbox) box, and add the filename extension before saving the file.

File Export to PDF...

- Exports the currently displayed message as a .pdf file.

File Import Messages...

- Starts up the PIM Import Tool program. This application lets you import messages from several email clients into &kmail;.

File Print Preview...

- Shows how your email will appear when printed.

  This will only be enabled if a printer has been configured, is online, and is available for use.

&Ctrl;P File Print...

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

File Expire All Folders

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

File Empty All Trash Folders

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

File Work Offline

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

&Ctrl;L File Check Mail

- Checks for new messages in all your accounts.

File Check Mail In >

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

File Send Queued Messages

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

File Send Queued Messages Via >

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

File Delayed Messages...

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

File Followup Reminder Messages...

- 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 &RMB; context menu.

&Ctrl;Q File Quit

- Exits &kmail;.

### Edit Menu

The Edit Menu The Edit Menu

The Edit Menu

If the menu item you are looking for is missing, please see Edit Menu in &kde; Fundamentals. The items listed here are &kmail; specific.

&Ctrl;&Shift;C Edit Copy Folder

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

&Ctrl;X Edit Cut Folder

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

&Ctrl;&Alt;C Edit Copy Message

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

&Ctrl;&Alt;X Edit Cut Message

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

&Ctrl;V Edit Paste

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

∇ Edit Move to Trash

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

&Ctrl;∇ Edit Move Thread to Trash

- Moves the selected thread to the trash folder, ⪚, a conversation in a mailing list.

&Ctrl;F Edit Find in Message...

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

&Ctrl;A Edit Select All Messages

- Selects all messages in the current folder.

&Ctrl;T Edit Select All Text

- Selects the text of the currently displayed message.

### View Menu

The View Menu The View Menu

The View Menu

View Message List >

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

  Sorting >

- Contains options to customize your sort order as follows:

  - Message Sort Order has several options, most of which are self-explanatory. The following options may not be immediately obvious, and deserve an explanation.

    - By Smart Sender/Receiver will display the receiver when you are viewing the sent-mail folder, and will display the sender when you are viewing the inbox.

    - By Action Item Status and By Important Status. These flags need to be set before they can be sorted. Please see Mark Messages for more information on marking your messages.

  - Message Sort Direction and Group Sort Direction allow you to change the direction in which your messages/groups will be sorted, respectively. Note that the "Group" options are only available when messages are aggregated into groups.

  - Folder always Uses this Sort Order allows you to specify different sort settings for each folder.

Aggregation >

- Lets you select an aggregation option. Please see the Message List Appearance tab (under Settings Configure &kmail;...) for more information on aggregation.

Theme >

- Lets you select a theme. Please see the Message List Appearance tab (under Settings Configure &kmail;...) for more information on themes.

&Ctrl;&Shift;O Create New Tab

- Creates a new tab on the tabbing toolbar. This tab will point to the folder you are viewing when the option is selected. If the tabbing toolbar is not yet visible, selecting this option will create it. The tabbing toolbar can be handy if you have many folders, but only a few of them are regularly accessed.

&Ctrl;&PgDn; Activate Next Tab

- Opens the folder associated with the next tab on the tabbing toolbar.

&Ctrl;&PgUp; Activate Previous Tab

- Opens the folder associated with the previous tab on the tabbing toolbar.

Move Tab Left

- Reorders the tabs on the tabbing toolbar by shifting the active tab to the left. If that tab is already at the extreme left end, it will be moved to the right hand end position.

Move Tab Right

- Reorders the tabs on the tabbing toolbar by shifting the active tab to the right. If that tab is already at the extreme right end, it will be moved to the left hand end position.

&Ctrl;&Shift;W Close Tab

- Closes the currently selected tab.

View Headers >

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

View Attachments >

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

. View Expand Thread / Group

- This will display the thread of the current message, &ie;, all messages that are replies to the current message.

, View Collapse Thread / Group

- This will hide the thread of the current message, &ie;, it will hide all messages that are replies to the current message.

&Ctrl;. View Expand All Threads

- Expands all threads in the current folder.

&Ctrl;, View Collapse All Threads

- Collapses all threads in the current folder.

View Save Display Format

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

View Restore Display Format

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

View Disable Emoticon

- Select this option to stop &kmail; from transforming `:-)` into .

X View Use Fixed Font

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

View Set Encoding >

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

View Zoom >

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

### Go Menu

The Go Menu The Go Menu

The Go Menu

J Go Jump to Folder...

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

N Go Next Message

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

+ Go Next Unread Message

- 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 configure-misc-folders-go-unread option.

P Go Previous Message

- Selects the previous message in the message list.

− Go Previous Unread Message

- 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 configure-misc-folders-go-unread option.

&Alt;+ Go Next Unread Folder

- Jumps to the next folder with unread messages.

&Alt;− Go Previous Unread Folder

- Jumps to the previous folder with unread messages.

&Space; Go Next Unread Text

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

### Folder Menu

The Folder Menu The Folder Menu

The Folder Menu

Folder Properties

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

Folder Add Folder...

- Prompts you for a name, then creates a new folder as a subfolder of the current folder. This is exactly like reader-add-folder.

Folder Mark All Messages as Read

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

Folder Mark All Messages as Read in This Folder and All its Subfolders

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

F5 Folder Update Folder

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

  This option only works in &IMAP; folders.

&Ctrl;F5 Folder Update This Folder and All Its Subfolders

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

  This option only works in &IMAP; folders.

Folder Move All Messages to Trash

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

  This is only available if the currently selected folder is not a trash folder. If the currently selected folder is a trash folder, you will see Empty Trash, instead. Selecting that option will empty the trash by permanently deleting the messages in the trash folder.

Folder Delete 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.

Folder Archive Folder...

- Brings up a dialog so you can create an archive of the currently selected folder. Please see the folder-archive section of "Using &kmail;" for details.

&Ctrl;* Folder Remove Duplicate Messages

- Searches the folder for duplicate messages and deletes them.

Folder Remove Duplicates in This Folder and All its Subfolder

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

Folder Apply Filters On Folder >

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

Folder Apply Filters On Folder and All its Subfolders >

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

Folder Message Default Format >

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

  For security reasons, we recommend you only select Prefer &HTML; to Plain Text in folders which can never contain untrusted messages.

Folder Load External References

- 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 option is only available if Prefer &HTML; to Plain Text has been selected. If you turn this option on, and later decide to change Message Default Format, be sure to clear this checkbox before making the switch. There is a bug in &kmail; -- if the checkbox on this item has not been cleared, and this option has been grayed out, results are unpredictable.

Folder Mailing List Management...

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

Folder Assign Shortcut...

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

### Message Menu

The Message Menu The Message Menu

The Message Menu

&Ctrl;N Message New Message...

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

&Ctrl;&Shift;N Message New Message to Mailing-List...

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

R Message Reply...

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

A Message Reply to All...

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

&Shift;A Message Reply Special >Reply to Author...

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

L Message Reply Special >Reply to Mailing-List...

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

&Shift;R Message Reply Special >Reply Without Quote...

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

Message Reply Special > Reply With Custom Template

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

Message Reply Special > Reply to All With Custom Template

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

&Shift;F Message Forward >As Attachment

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

F Message Forward >Inline

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

E Message Forward >Redirect

- 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;).

Message Forward > With Custom Template

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

Message Send Again...

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

  This menu item is only available for messages which you have sent or, more precisely, for messages which have the sent status. If you wish to resend some other message, double-click its entry in the message list. Or view the message and use the T shortcut. You may also do this by adding an Edit as New button to the toolbar.

Message Mailing List Name: >

- Offers several options for mailing list messages.

  The current working folder must be configured as a mailing list for this option to be available. Please see Folder Properties Mailing List to learn about setting up mailing lists.

  The following options are available in mailing list folders:

  - Post New Message(email) will set the To: address to the address configured as "Post to List".

  - Request Help(email) will set the To: address to the address configured in "Post to List" and will place the word `help` in the Subject: field.

  - Subscribe to List(web) will point your default web browser to the "subscribe" web site of the configured mailing list.

  - Subscribe to List(email) will set the To: address to the mailing list subscription address, and place the word `subscribe` in the Subject: field.

  - Unsubscribe from List(web) will point your default web browser to the "unsubscribe" web site of the configured mailing list.

  - Unsubscribe from List(email) will set the To: address to the mailing list subscription address, and place the word `unsubscribe` in the Subject: field.

Message Copy Message To >

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

Message Move Message To >

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

Message Mark Message >

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

  Status | Symbol | Meaning
  &Ctrl;R Mark Message as Read |  | The message has been read.
  &Ctrl;U Mark Message as Unread |  | 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; ⪚, a to-do list.
  Remove Action Item Mark |  | Removes a previously set action item mark from the message.

Message Mark Thread

- 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 (⪚, 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.

Message Create Filter

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

  - Filter on Subject...
  - Filter on From...
  - Filter on To...
  - Filter on Mailing-List...(currently selected message must be a mailing list for this to be available).

Message Apply Filter

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

V Message View Source

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

  You should be aware that it is easy to fake, or spoof, the `From:` header in a message. You can always find out which mail servers were used to send the message by examining the `Received:` lines in the message headers.

&Ctrl;&Alt;D Message Show Message Structure

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

### Tools Menu

The Tools Menu The Tools Menu

The Tools Menu

S Tools Find Messages...

- Opens a search window that lets you search for messages with certain characteristics, ⪚, 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 &RMB;.

Tools Address Book

- Starts &kaddressbook;, the &kde; email address / personal contact information management program.

Tools Certificate Manager

- Starts &kleopatra;, the &kde; certificate manager.

Tools Edit "Out of Office" Replies...

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

  Out of Office reply functionality relies on server-side filtering. To use it you must configure the Filtering tab (see options relevant to a &kolab; server) of your &IMAP; account set-up.

Tools Filter Log Viewer...

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

Tools Import from another Email Client...

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

  Close &kmail; before importing data. The wizard may modify &kmail;'s configuration file, and can cause unpredictable results if you attempt to import data while &kmail; is running.

Tools Import/Export &kmail; Data...

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

Tools Log Activities...

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

Tools Anti-Spam Wizard...

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

Tools Anti-Virus Wizard...

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

### Settings Menu

The Settings Menu The Settings Menu

The Settings Menu

If the menu item you are looking for is missing, please see Settings Menu in &kde; Fundamentals. The items listed here are &kmail; specific.

&Ctrl;H Settings Show Quick Search bar

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

Settings Configure Filters...

- Opens the Message Filters dialog.

Settings Manage Sieve Scripts...

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

Settings Add Account...

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

Settings Configure Automatic Archiving...

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

Settings Configure &kmail;...

- Opens the Configure &kmail; dialog. There are hundreds of variables to play with. Have fun!

### Help Menu

The Help Menu The Help Menu

The Help Menu

This is the Help Menu of the &kde; Fundamentals, with one additional item.

Help&kmail; Introduction

- Opens the Introduction welcome screen.

## The &kmail; Composer Window

### Message Menu

The Message Menu The Message Menu

The Message Menu

&Ctrl;N Message New Composer

- Opens a new composer window so you can create a message.

&Ctrl;Return Message Send Mail

- Sends the message immediately. If you use &SMTP; to send your messages and the &SMTP; server is not reachable, the message will remain in the outbox and you will get an error message. After the connection issues have been resolved, you can send the messages in the outbox using File Send Queued Messages (in the reader window).

Message Send Mail Via >

- Allows you to specify which outgoing mail server will be used to send the message.

Message Send Later

- Launches the send later dialog. Please see the Send Later documentation for details.

Message Send Later Via >

- Allows you to specify which outgoing mail server will be used to send the delayed message.

Message Save as File

- Saves the message as a file. Three formats are supported: Rich Text (.html), plain text (.txt), and Open Document Format (.odt).

&Ctrl;S Message Save as Draft

- Saves the message in the drafts folder so you can finish it later.

Message Save as Template

- Lets you save your message as a template. Please see Compose from templates for more information.

Message Insert Text File...

- Inserts a text file into the message text, starting at the cursor position.

Message Insert Recent Text File >

- Lets you choose from a list of recently inserted text files, and inserts that file into your message. Select Clear List to clear the list.

Message Print Preview

- Opens a print preview window and displays your message, formatted for printing.

&Ctrl;P Message Print...

- Formats and prints the message you have composed.

Message Share Mail Text... >

- Lets you make a second copy of your message somewhere else. Four options are provided: Nextcloud (an OSS file-sharing app), Pastebin (a freely available web site), Bluetooth, and Email (opens another composer window, and adds the current message to that new message, as an attachment). This option is not available unless the Share Text plugin is active.

&Ctrl;W Message Close

- Closes this composer window.

### Edit Menu

The Edit Menu The Edit Menu

The Edit Menu

If the menu item you are looking for is missing, please see the Edit Menu section of the &kde; Fundamentals Handbook. The items listed here are &kmail; specific.

&Ctrl;&Shift;O Edit Paste as Quotation

- Pastes the text from the clipboard and marks it as a quotation (&ie;, each line preceded by ">" and a space).

Edit Paste as Attachment

- Pastes a file that has been copied to the clipboard (⪚, by using the &dolphin; file manager) as an attachment.

&Ctrl;&Shift;V Edit Paste Without Formatting

- Pastes data from the clipboard as plain text, with no &HTML; formatting.

Edit Clean Spaces

- This option supposedly replaces multiple adjacent newline characters or spaces with single line breaks / spaces, but in testing, it apparently does absolutely nothing.

Edit Add Quote Characters

- Prepends each line of the selected text with the quotation indicator (> and a space, by default). If no selection is made, adds the indicator to every line in the message.

Edit Remove Quote Characters

- Removes the left-most quotation indicator from the selected text.

Edit Insert Email...

- Displays a list of all the names in your address book, then inserts the chosen email address at the cursor position (after you make a selection and click the OK button). This option is only available when the Insert Email plugin has been loaded.

&Ctrl;&Space; Edit Insert Non Breaking Space

- Inserts a non breaking space at the cursor position. This option is only available when the Insert Non Breaking Space plugin has been loaded.

Edit Insert Special Character...

- Lets you insert a special character at the cursor position. A large number of Unicode characters are made available. This option is only provided if the Insert Special Character plugin has been activated.

  This menu item was moved to the Insert menu in release 5.17. If you have activated the plugin, and this entry does not appear when &kmail; is restarted, check the Insert menu.

Edit Change Case >

- Helps you modify the capitalization of the selected text. There are four options: Uppercase (capitalizes the selected characters), Lowercase (forces selected text to all lower case), Sentence case (capitalizes the first letter of the selection and makes the rest lower case), and Reverse Case (converts capital letters to lower case, and vice versa). This option is only provided if the Change Case plugin has been activated. This menu item remains grayed out until some snippet of text has been selected for modification.

Edit Zoom... >

- Lets you zoom in or zoom out on the message you are composing. This is the same function appearing as View Zoom > in the message preview window. This option is not available unless the Zoom Text plugin has been loaded.

Edit Variables >

- Lets you insert the contents of a named field at the cursor position. You may choose among To >, From >, CC >, Attachment >, Date/Time >, and Misc > (which has just one associated submenu item, "Subject"). There is one notable quirk: the date/time displayed in the submenu selections is fixed at the time the Composer window was opened, but the value actually inserted in a message is taken from the system clock.

### View Menu

The View Menu The View Menu

The View Menu

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

Several options are available:

- All Fields. Displays all six of the following fields.

- Identity. If you have defined more than one identity, this will be a drop down box.

- Dictionary used for spell checking. If multiple dictionaries are installed, this will be a drop down box.

- Sent-Mail Folder. The button appearing on the right when this option is checked opens a folder selection dialog.

- Mail Transport. If you have created more than one outgoing account, this will be a drop down box.

- From. The contents of this field may vary, depending on the Identity you use.

- Subject. Use this field to describe your message, briefly.

The To drop down box is always present at the top of the composer window. Use it to select CC, BCC, and Reply-To addresses, as needed. Please see Composer Headers for further details on message headers.

View Use Fixed Font

- Uses a fixed width (monospaced) font to display the currently edited message. The particular font to be used can be configured in the Appearance section of &kmail;'s configuration dialog.

View Snippets

- Displays a column on the right hand side of the composer window that allows you to use and create snippets. Please see Snippets for more information.

### Options Menu

The Options Menu The Options Menu

The Options Menu

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

Options Urgent

- Sets the priority of the message to Urgent by inserting two header lines: "X-PRIORITY: 2 (High)" and "Priority: urgent". The receiver's email client must provide support for these headers; otherwise they will have no effect. &kmail; itself does not support priorities for incoming messages (although you can mark messages as Important).

Options Request Disposition Notification

- If you choose this option, &kmail; will insert a Disposition-Notification-To: header line in the message, which is a request to receive an email notification once your message has been downloaded and read by the recipient. This function must be supported, and enabled by the receiver's email client; otherwise, it will not work.

  See configure-security-reading-mdns for background information and several ways to customize the read receipts that &kmail; itself sends in response to a received Disposition-Notification-To: header line.

Options Request Delivery Confirmation

- If you choose this option, &kmail; will insert a Return-Receipt-To: header line in the message, which is a request to receive an email notification once your message has been uploaded by your email server and delivered to the recipient. This function must be supported by your outgoing email server; otherwise, it will not work.

Options Sign Message

- Digitally signs the message using OpenPGP or an X.509 certificate. You can learn more about this option in the chapter on OpenPGP.

Options Encrypt Message

- Encrypts the message using OpenPGP or an X.509 certificate. You can learn more about encryption in the chapter on OpenPGP.

Options Cryptographic Message Format >

- Lets you choose the cryptographic message format to use when digitally signing and/or encrypting this message. Please see Cryptographic Message Formats for more information.

Options Rich Text Editing

- Enables Rich Text (&ie;, &HTML;) editing.

Options Encoding >

- Sets the charset encoding of this message. The chosen encoding will be identified by a header line in the outgoing message. You can use Auto in almost every case; &kmail; will notify you if you must select a different encoding manually.

Options Wordwrap

- Toggles the automatic wordwrap feature. You may wish to turn this off when pasting long lines (⪚, &URL;s) that should not be wrapped.

Options Automatic Spellchecking

- Toggles automatic spellchecking on or off.

Options Create Follow Up Reminder...

- Initiates a dialog allowing you to add a "To Do" item to your calendar. This item is grayed out if the Followup Reminder Agent plugin has not been activated.

### Attach Menu

The Attach Menu The Attach Menu

The Attach Menu

This menu lets you select attachment options.

Attach Append Signature

- Appends your signature (footer) to the end of the message. Please see Configure Identity Signature for details on configuring your signature.

Attach Prepend Signature

- Prepends your signature (header) at the beginning of the message.

Attach Insert Signature At Cursor Position

- Inserts your signature at the current cursor location.

Attach Attach Public Key...

- Opens the Attach Public OpenPGP Key dialog. Please see Configure Identity Cryptography OpenPGP Signing for details.

Attach Attach My Public Key

- Attaches your GnuPG public key, or your X.509 certificate, (&ie;, the public key associated with your current identity) to your message.

Attach Attach > Attach File...

- Attaches one or more files to the current message. Attachments are encrypted by default (if the message is encrypted). Please see Cryptographic Message Formats for more information on encryption and attachments.

Attach Attach > Attach Directory...

- Creates a ZIP archive containing the selected Directory, and attaches the archive to this message.

Attach Attach > Attach Own vCard

- Attaches your vCard to the current message.

Attach Attach > Attach vCards...

- Opens a dialog with &kaddressbook; that lets you select one or more people (&Ctrl; and left-click), and then attaches vCards for all those selected.

Attach Attach > Attach Text From Clipboard...

- If the topmost item saved on the clipboard contains at least two bytes, a file name dialog will open. &kmail; will create an attachment containing the text from the clipboard, and give the attachment the name you have chosen.

Attach Remove Attachment

- Removes the selected attachment (selected via the attachment area beneath the main composer window).

  This menu item, and the next two, will be grayed out until an attachment is selected.

Attach Save Attachment As...

- Saves the attachment selected in the attachment window as a file.

Attach Attachment Properties

- Displays the properties of the attachment that has been selected via the attachment window. It also lets you sign/encrypt the attachment, and alter some of its other properties (name, description, &MIME; type, &etc;).

### Tools Menu

The Tools Menu The Tools Menu

The Tools Menu

If the menu item you are looking for is missing, please see Tools Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

Tools Select Recipients...

- Opens a Select Recipient dialog, with the contents of all your address books to select from.

Tools Addressbook...

- Launches the &kaddressbook; program.

Tools Save Distribution List...

- Opens a dialog that lets you save groups of contacts as a single named item. Very handy if you frequently send the same message to all the members of a club, for instance.

Tools Autocorrect Text >

- Performs autocorrection. You have two options: scan and autocorrect the selected text, or apply autocorrection to the whole message. This menu item will not be present unless the Autocorrection plugin has been loaded, and it won't work unless the Autocorrection function has been enabled on the Composer configuration page.

&Ctrl;&Alt;T Tools Translator

- Opens the translator window.

Tools Check Grammar (Language Tool)

- Opens the grammar check window and examines your message, highlighting any errors that are found. This feature does not continuously update the scanned text as you type; you should first compose your message, then invoke grammar check. This tool is not available unless the Grammar Check plugin has been activated. Like the Translator function, Grammar Check passes your message through a server (default server: https://languagetool.org/api/v2) on the internet.

### Settings Menu

The Settings Menu The Settings Menu

The Settings Menu

If the menu item you seek is missing, please see Settings Menu of the &kde; Fundamentals. The items listed here are &kmail; specific.

Settings Toolbars Shown >

- Lets you control which toolbars are displayed. You may choose any combination of three options: Main Toolbar (Send, Queue, Rich Text, &etc;), HTML Toolbar (Style, Font / Size, &etc;), and Text Direction (in case you use a right-to-left script). Note that the HTML Toolbar is easily toggled on and off via the Rich Text button on the Main Toolbar.

Settings Spellchecker...

- Allows you to configure &sonnet;, &kde;'s spell checker.

### Help Menu

The Help Menu The Help Menu

The Help Menu

This is exactly like the Help Menu of the &kde; Fundamentals.