Daniel
Naber

    daniel.naber@t-online.de

David
Rugge

    davidrugge@mediaone.net

2002-10-03
1.5

# Menu Entries

Each 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 Main Window

### File Menu

File New Window...

  Creates a new main window.

&Ctrl;S File Save As...

  Saves the currently displayed message to a text file, including all the headers and attachments.

&Ctrl;P File Print...

  Display a dialog that lets you prints the currently displayed message.

File Compact All Folders

  Will compact all folders, &ie; it will really move and delete the messages on disk according to how you have moved and deleted them in &kmail;.

File Expire All Folders

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

&Ctrl;L File Check Mail

  Checks for new messages in all your accounts, except those that have Exclude from "Check Mail" enabled.

File Check Mail In

  Submenu that lets you check for new messages from a particular account.

File Send Queued Messages

  Sends the messages that are in your outbox.

&Ctrl;Q File Quit

  Closes the current main window or exits &kmail; if there is only this one window.

### Edit Menu

&Ctrl;Z Edit Undo

  Revoke you last move or delete action. Note that you cannot undo a deletion in the trash.

&Ctrl;C Edit Copy

  Copies selected text to the clipboard.

T Edit Edit Message

  Edits the selected message if it is editable. Only messages in the outbox and drafts folder can be edited.

D Edit Move To Trash

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

&Shift;Delete Edit Delete

  Deletes the selected messages. There is no way to recover the messages once they are deleted with this command.

&Ctrl;F Edit Find In Message...

  Lets you search for a string in the currently displayed message.

K Edit Select All Messages

  Selects all messages in the current folder.

&Ctrl;A Edit Select Message Text

  Selects the text of the currently displayed message.

### View Menu

View Headers

  Changes the number of headers that are displayed and the format of the headers in the Message pane.

View Attachments

  Changes the way that attachments appear in the Message pane (independent of the MIME Tree). With Icons all attachments appear as icons at the bottom of the message. Smart will show attachments as icons, unless their content disposition is inline. You can activate inline content disposition in your own messages when you select Suggest automatic display in the attachment's properties dialog. Inline shows the contents of the attachments at the bottom of the message. Attachments that cannot be displayed, &eg; compressed files, will still be shown as an icon. Hide will not show attachments.

View Unread Column

  Display a column in the list of folders which shows the number of unread messages per folder.

View Total Column

  Display a column in the list of folders which shows the number of messages per folder.

. View Expand Thread

  If Folder Thread Messages is activated, this will display the thread of the current message, &ie; all messages that are replies to the current message.

, View Collapse Thread

  If Folder Thread Messages is activated, 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.

V View View Source

  Shows the message and its complete headers in plain text format in a new window. This can be useful to find out the origin of a mail. You should know that it is easy to fake the `From:` header of a mail, but one can still find out which mail servers have been used to send the message by looking at the `Received:` lines in the header.

View Use Fixed Font

  Uses a fixed width (monospaced) font to display the messages in the current folder. The font to be used can be configured in the Appearance section of &kmail;'s configuration dialog.

Message Set Encoding

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

### Go Menu

N Go Next Message

  Selects the next message in the Headers pane. The keyboard shortcut Right Arrow also performs this action.

+ Go Next Unread Message

  Selects the next unread message in the Headers pane.

P Go Previous Message

  Selects the previous message in the Headers pane.

- Go Previous Unread Message

  Selects the previous unread message in the Headers pane.

&Ctrl;+ Go Next Unread Folder

  Jumps to the the next folder with unread messages.

&Ctrl;- Go Previous Unread Folder

  Jumps to the the previous folder with unread messages.

Space Go Next Unread Text

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

### Folder Menu

Folder New Folder...

  Opens the Folder Properties dialog that lets you create a new folder.

Folder Mark All Messages as Read

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

Folder Compact

  Compacts the folder file to reduce its disk space usage. Use this command if your mailboxes seem to be much larger than they ought to be.

Folder Expire

  Delete old messages from the current folder, according to the rules in the folder's Properties dialog (the default is not to delete old messages at all).

Folder Move All Messages to Trash

  Moves all of the messages in the selected folder into the trash folder. If the selected folder is the trash folder, the messages are permanently deleted.

Folder Delete Folder

  Removes the selected folder and all its contents, including sub folders.

  Note that there is no way to access the contents of a folder after it has been removed.

Folder Prefer HTML to Plain Text

  This will show HTML messages using HTML rendering. For security reasons, we recommend to only activate this for trusted messages.

Folder Thread Messages

  Shows the messages in the Header pane in a tree-like list, with replies showing up directly under the message they reply to.

Folder Properties...

  Opens up the Properties dialog which lets you change the settings for the selected folder.

### Message Menu

&Ctrl;N Message New Message...

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

Message New Message to Mailing-List...

  Opens the composer window so you can write a new mail. If the current folder holds a mailing list and has a Post Address defined, this address will be default To: address.

R Message Reply...

  Opens up the composer window with the contents of the selected message's Reply-To field in the To: field. By default this will automatically set your identity to the one which this message was sent to.

A Message Reply All...

  Opens up the composer window and copies the contents of the selected message's Reply-To: and To: fields into the To: field, and the CC: field into the CC: field of the composer window.

L Message Reply Mailing-List...

  Opens up the composer with the To: field set to the mailing list address. Of course this will only work if you configured the current folder to be associated with a mailing list. Otherwise the To: field will be empty.

&Shift;R Message Reply Without Quote...

  Opens up the composer to reply but does not quote the text of the original message.

Message Forward...

  Forwards the message to a new recipient. Using Inline, the message's text and some important header fields will be copied to the body of the new message with a text marking the forwarded part. Attachments will be forwarded as attachments of the new message. Using As Attachment the message and its attachments will become an attachment of the new message. The original message headers will be included in the forwarded message, too. Redirect works like forward, except that the message stays the same (even the From: field). The user who redirected the message is added in special header fields (`Redirect-From`, `Redirect-Date`, `Redirect-To`, &etc;).

Message Bounce...

  Sends the message back to the sender with a notice that it cannot be delivered. This is nearly exactly the message you get from a mail relay if the user does not exist. Some people use this option to reply to spam.

Message Send Again...

  Opens a composer window with this message so it can be sent again.

Message Copy To

  Copies all of the the selected messages to a certain folder.

Message Move To

  Moves all of the selected messages to a certain folder.

Message Mark Message

  Allows you to change the status of the selected message to one of the following states (more than one status per message is currently not supported):

  Status | Symbol | Meaning
  --- | --- | ---
  New | Red dot | The message has been received for the first time, and is unread.
  Unread | Green dot | The message has already been retrieved off the server at least once, but has not yet been read.
  Read | Dash | The message has been read.
  Replied | Blue u-turn arrow | A reply to this message has been sent.
  Forwarded | Blue arrow | The message has been forwarded to someone else.
  Queued | Envelope | The message has been queued in the outbox to be sent later.
  Sent | Angled envelope | The message has been sent.
  Important | Flag | 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.

Message Mark Thread

  Allows you to change the status of all messages in a thread. The possible states are the same as for Message Mark Message.

&Ctrl;J Message Apply Filters

  Applies your filters to the selected messages.

### Tools Menu

S Tools Find Messages...

  Opens up a search window that lets you search for messages with certain characteristics, &eg; a certain subject. Start the search by entering some values and press Search. Click on one of the resulting messages and it will appear in the Message pane.

Tools Address Book

  Starts up &kaddressbook;.

Tools Import...

  Starts up kmailcvt (which is part of kdenetwork). This application lets you import messages from several proprietary email clients to &kmail;.

Tools Create Filter

  Opens up the Filter dialog with a new filter added. This new filter is based on fields of the current mail, depending on which sub menu you select.

### Settings Menu

Settings Show Toolbar

  If enabled, the Toolbar is visible (the Toolbar is the one with the icon to compose a new message &etc;).

Settings Show Statusbar

  If enabled, the Statusbar is visible (the Statusbar is the small one on the bottom which shows useful short messages and link targets).

Settings Configure Shortcuts...

  Opens a window that lets you configure the keyboard shortcuts for many menu commands.

Settings Configure Toolbars...

  Opens a window that lets you choose which icons are visible in the toolbar.

Settings Configure Notifications...

  Opens a window that lets you configure what happens when new mail arrives, like playing a sound.

Settings Configure &kmail;...

  Opens the Configure window.

Settings Configure Filters...

  Opens the Message Filters window.

Settings Configure POP Filters...

  Opens the Configure Pop Filters window.

### Help Menu

These are the &kde; standard items for the Help menu:

&help.menu.documentation;

Additionally &kmail; offers these items:

Help &kmail; Introduction

  This displays the welcome screen, which lists the most imortant differences between your version of &kmail; and the previous one.

Help Tip of the Day

  This displays a dialog with useful hints for using &kmail;.

## The Composer Window

### Message Menu

&Ctrl;N Message New Composer...

  Opens up a new composer window.

Message New Main Window...

  Creates a new main window.

&Ctrl;Return Message Send

  Sends the message immediately. If you use SMTP to send your messages and the SMTP server is not reachable, the message will be put into the outbox and you will get an error message. You can then later send the messages in the outbox using File Send Queued.

Message Queue

  Queues the message in the outbox for sending it later using File Send Queued.

Message Save in Drafts Folder

  Save the message in the drafts folder so you can later edit and send it.

Messages Insert File...

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

&Ctrl;P Message Print...

  Prints the current text.

&Ctrl;W Message Close

  Closes this composer window.

### Edit Menu

&Ctrl;Z Edit Undo

  Undo your steps in editing the current message.

&Ctrl;&Shift;Z Edit Redo

  Redo your steps in editing the current message.

&Ctrl;X Edit Cut

  Cutting text works as with most editors: the selected text is removed and put into the clipboard. Note that you can also select text and drag it to a new position.

&Ctrl;C Edit Copy

  Copying text works as with most editors: the selected text is copied to the clipboard. Note that you can also select text while holding the &Ctrl; key, and drag it to a new position to copy it.

&Ctrl;V Edit Paste

  Pasting works the same as with most editors: the text from the clipboard is pasted at the current cursor position.

&Ctrl;A Edit Select All

  Selects all of the text in your message.

&Ctrl;F Edit Find...

  Opens a dialog to search for strings in the current message.

&Ctrl;R Edit Replace...

  Opens a dialog that lets you replace strings in your message with other strings.

Edit Clean Spaces

  This replaces multiple line breaks resp. spaces with single line breaks resp. spaces. It works on the current selection or on the complete message if there is no selection.

### View Menu

This menu lets you toggle the display of the header fields and other options in this composer window.

Options available are:

- All Fields

- Identity

- Sent-Mail folder

- Mail Transport

- From

- Reply To

- To

- CC

- BCC

- Subject

Currently visible items have a checkmark shown next to their name in the menu.

View Use Fixed Font

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

### Options Menu

Options Urgent

  Sets the priority of the message to Urgent. The receiver's email client has to support this or it will have no effect. &kmail; itself does not support priorities for incoming messages.

Options Confirm Delivery

  If you choose this option, you request a confirmation email once your message is successfully delivered to its destination mail server. This has to be also supported from the receiver's side in order to work.

Options Confirm Read

  If you choose this option, you request a confirmation email once your message is downloaded and read by its recipient. This has to be supported and enabled by the receiver's email client in order to work.

Options Sign Message

  Digitally sign the message using OpenPGP. You can learn more about this in the chapter on OpenPGP.

Options Encrypt Message

  Encrypt the message using OpenPGP. You can learn more about this in the chapter on OpenPGP.

Options Select Crypto Module

  This entry will only be visible if you have installed at least one crypto plugin. It allows you to choose which plugin you want to use for encryption/signing or if you want to use the built-in OpenPGP encryption/signing.

Options Set Encoding

  Set the charset encoding of this message. The chosen encoding will appear in the header of the outgoing mail. You can use Auto for almost all cases, &kmail; will tell you if you need to select a different encoding manually.

Options Wordwrap

  Toggle the automatic wordwrap. It may be useful to turn it off if you want to paste long lines that should not wrap.

### Attach Menu

This menu lets you select attachment options.

Attach Append Signature

  Appends your signature (footer) to the end of the message.

Attach Attach Public Key...

  Attaches the corresponding PGP/GnuPG key to your message.

Attach Attach My Public Key

  Attaches your PGP/GnuPG public key to your message.

Attach Attach File...

  Attaches one or more files to the current message.

Attach Remove Attachment

  Removes the attachment that is selected in the attachment part of the composer.

Attach Save Attachment As...

  Saves the attachment that is selected in the attachment window to a file.

Attach Attachment Properties...

  Displays the properties of the attachment that is selected in the attachment window.

### Tools Menu

Tools Spelling...

  Uses &kspell; to check the spelling in the body of your message. Note that you have to configure &kspell; with Settings Spellchecker... if you use it for the first time.

Tools Addressbook...

  Opens up &kaddressbook;.

### Settings Menu

Settings Show Toolbar

  If enabled, the Toolbar is visible (the Toolbar is the one with the icon to send the message &etc;).

Settings Show Statusbar

  If enabled, the Statusbar is visible (the Statusbar is the small one at the bottom which shows useful short messages).

Settings Configure Shortcuts...

  Opens a window that lets you configure the keyboard shortcuts for many menu command.

Settings Configure Toolbars...

  Opens a window that allows you to decide which icons appear in the toolbar.

Settings Configure &kmail;...

  Opens &kmail;'s configuration dialog.

Settings Spellchecker...

  Allows you to configure &kspell;, &kde;'s spellchecker.

### Help Menu

The entries in this menu have the same meaning as the entries in the Mailreader's help menu.

## Section Authors

This section written by: Daniel Naber daniel.naber@t-online.de and David Rugge davidrugge@mediaone.net.