~ubuntu-dev/ubuntu/lucid/mutt/lucid-201002110857

<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 2. Getting Started</title><meta name="generator" content="DocBook XSL Stylesheets V1.71.1" /><link rel="start" href="index.html" title="The Mutt E-Mail Client" /><link rel="up" href="index.html" title="The Mutt E-Mail Client" /><link rel="prev" href="intro.html" title="Chapter 1. Introduction" /><link rel="next" href="configuration.html" title="Chapter 3. Configuration" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Getting Started</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="intro.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="gettingstarted"></a>Chapter 2. Getting Started</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="gettingstarted.html#menus">1. Moving Around in Menus</a></span></dt><dt><span class="sect1"><a href="gettingstarted.html#editing">2. Editing Input Fields</a></span></dt><dd><dl><dt><span class="sect2"><a href="gettingstarted.html#editing-intro">2.1. Introduction</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#editing-history">2.2. History</a></span></dt></dl></dd><dt><span class="sect1"><a href="gettingstarted.html#reading">3. Reading Mail - The Index and Pager</a></span></dt><dd><dl><dt><span class="sect2"><a href="gettingstarted.html#id462615">3.1. The Message Index</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#id463158">3.2. The Pager</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#threads">3.3. Threaded Mode</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#id463814">3.4. Miscellaneous Functions</a></span></dt></dl></dd><dt><span class="sect1"><a href="gettingstarted.html#sending">4. Sending Mail</a></span></dt><dd><dl><dt><span class="sect2"><a href="gettingstarted.html#id464797">4.1. Editing the message header</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#id464885">4.2. Using Mutt with PGP</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#id465129">4.3. Sending anonymous messages via mixmaster.</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#id465253">4.4. Sending format=flowed messages</a></span></dt></dl></dd><dt><span class="sect1"><a href="gettingstarted.html#forwarding-mail">5. Forwarding and Bouncing Mail</a></span></dt><dt><span class="sect1"><a href="gettingstarted.html#postponing-mail">6. Postponing Mail</a></span></dt></dl></div><p>

body { margin-left:2%; margin-right:2%; font-family:serif; }

.toc, .list-of-tables, .list-of-examples { font-family:sans-serif; }

h1, h2, h3, h4, h5, h6 { font-family:sans-serif; }

em.replaceable code { font-family:sans-serif; }

p { text-align:justify; }

div.table p.title, div.example p.title { font-size:smaller; font-family:sans-serif; }

.email, .email a { font-family:monospace; }

div.table-contents table { border-collapse:collapse; border:1px solid #c0c0c0; }

div.table-contents table td, div.table-contents table th { padding:5px; text-align:left; }

div.table-contents table th {

font-family:sans-serif;

background:#d0d0d0;

font-weight:normal;

vertical-align:top;

}

pre.screen, div.note { background:#f0f0f0; border:1px solid #c0c0c0; padding:5px; }

div.note h3 { font-size:small; font-style:italic; font-variant: small-caps; }

div.note h3:after { content: ":" }

div.note { margin-bottom: 5px; }

</style></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 2. Getting Started</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="intro.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr></table><hr /></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="gettingstarted"></a>Chapter 2. Getting Started</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="gettingstarted.html#core-concepts">1. Core concepts</a></span></dt><dt><span class="sect1"><a href="gettingstarted.html#menus">2. Moving Around in Menus</a></span></dt><dt><span class="sect1"><a href="gettingstarted.html#editing">3. Editing Input Fields</a></span></dt><dd><dl><dt><span class="sect2"><a href="gettingstarted.html#editing-intro">3.1. Introduction</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#editing-history">3.2. History</a></span></dt></dl></dd><dt><span class="sect1"><a href="gettingstarted.html#reading">4. Reading Mail - The Index and Pager</a></span></dt><dd><dl><dt><span class="sect2"><a href="gettingstarted.html#index-menu">4.1. The Message Index</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#pager-menu">4.2. The Pager</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#threads">4.3. Threaded Mode</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#reading-misc">4.4. Miscellaneous Functions</a></span></dt></dl></dd><dt><span class="sect1"><a href="gettingstarted.html#sending">5. Sending Mail</a></span></dt><dd><dl><dt><span class="sect2"><a href="gettingstarted.html#sending-intro">5.1. Introduction</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#edit-header">5.2. Editing the message header</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#sending-crypto">5.3. Sending cryptographically signed/encrypted messages</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#sending-mixmaster">5.4. Sending anonymous messages via mixmaster</a></span></dt><dt><span class="sect2"><a href="gettingstarted.html#ff">5.5. Sending format=flowed messages</a></span></dt></dl></dd><dt><span class="sect1"><a href="gettingstarted.html#forwarding-mail">6. Forwarding and Bouncing Mail</a></span></dt><dt><span class="sect1"><a href="gettingstarted.html#postponing-mail">7. Postponing Mail</a></span></dt></dl></div><p>

This section is intended as a brief overview of how to use Mutt. There are

many other features which are described elsewhere in the manual. There

is even more information available in the Mutt FAQ and various web

pages. See the <a href="http://www.mutt.org/mutt/" target="_top">Mutt Page</a> for more details.

pages. See the <a class="ulink" href="http://www.mutt.org/" target="_top">Mutt homepage</a> for more details.

</p><p>

The keybindings described in this section are the defaults as distributed.

Your local system administrator may have altered the defaults for your site.

You can always type ``?'' in any menu to display the current bindings.

</p><p>

The first thing you need to do is invoke mutt, simply by typing mutt

at the command line. There are various command-line options, see

either the mutt man page or the <a href="reference.html#commandline" title="1. Command line options">reference</a>.

</p><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="menus"></a>1. Moving Around in Menus</h2></div></div></div><p>

Information is presented in menus, very similar to ELM, see <a href="gettingstarted.html#tab-keys-nav" title="Table 2.1. Most common navigation keys">Table 2.1, “Most common navigation keys”</a>

for common keys used to navigate menus in Mutt.

</p><p>

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="editing"></a>2. Editing Input Fields</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editing-intro"></a>2.1. Introduction</h3></div></div></div><p>

You can always type “<span class="quote">?</span>” in any menu to display the current bindings.

</p><p>

The first thing you need to do is invoke mutt, simply by typing <code class="literal">mutt</code>

at the command line. There are various command-line options, see

either the mutt man page or the <a class="link" href="reference.html#commandline" title="1. Command line options">reference</a>.

</p><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="core-concepts"></a>1. Core concepts</h2></div></div></div><p>

Mutt is a text-based application which interacts with users through

different menus which are mostly line-/entry-based or page-based. A

line-based menu is the so-called “<span class="quote">index</span>” menu (listing all messages of

the currently opened folder) or the “<span class="quote">alias</span>” menu (allowing you to

select recipients from a list). Examples for page-based menus are the

“<span class="quote">pager</span>” (showing one message at a time) or the “<span class="quote">help</span>” menu listing

all available key bindings.

</p><p>

The user interface consists of a context sensitive help line at the top,

the menu's contents followed by a context sensitive status line and

finally the command line. The command line is used to display

informational and error messages as well as for prompts and for entering

interactive commands.

</p><p>

Because Mutt allows for customizing almost all key bindings, there are

so-called “<span class="quote">functions</span>” which can be executed manually (using the

command line) or in macros. Macros allow the user to bind a sequence of

commands to a single key or a short key sequence instead of repeating a

sequence of actions over and over.

</p><p>

Many commands (such as saving or copying a message to another folder)

can be applied to a single message or a set of messages (so-called

“<span class="quote">tagged</span>” messages). To help selecting messages, Mutt provides a rich

set of message patterns (such as recipients, sender, body contents, date

sent/received, etc.) which can be combined into complex expressions

using the boolean <span class="emphasis"><em>and</em></span> and <span class="emphasis"><em>or</em></span>

operations as well as negating. These patterns can also be used to (for

example) search for messages or to limit the index to show only matching

messages.

</p><p>

Mutt supports a “<span class="quote">hook</span>” concept which allows the user to execute

arbitrary configuration commands and functions in certain situations

such as entering a folder, starting a new message or replying to an

existing one. These hooks can be used to highly customize Mutt's

behaviour including managing multiple identities, customizing the

display for a folder or even implementing auto-archiving based on a

per-folder basis and much more.

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="menus"></a>2. Moving Around in Menus</h2></div></div></div><p>

The most important navigation keys common to all menus are shown in

<a class="xref" href="gettingstarted.html#tab-keys-nav" title="Table 2.1. Most common navigation keys">Table 2.1, “Most common navigation keys”</a>.

</p><div class="table"><a id="tab-keys-nav"></a><p class="title"><b>Table 2.1. Most common navigation keys</b></p><div class="table-contents"><table summary="Most common navigation keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>j or <Down></td><td><code class="literal"><next-entry></code></td><td>move to the next entry</td></tr><tr><td>k or <Up></td><td><code class="literal"><previous-entry></code></td><td>move to the previous entry</td></tr><tr><td>z or <PageDn></td><td><code class="literal"><page-down></code></td><td>go to the next page</td></tr><tr><td>Z or <PageUp></td><td><code class="literal"><page-up></code></td><td>go to the previous page</td></tr><tr><td>= or <Home></td><td><code class="literal"><first-entry></code></td><td>jump to the first entry</td></tr><tr><td>* or <End></td><td><code class="literal"><last-entry></code></td><td>jump to the last entry</td></tr><tr><td>q</td><td><code class="literal"><quit></code></td><td>exit the current menu</td></tr><tr><td>?</td><td><code class="literal"><help></code></td><td>list all keybindings for the current menu</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="editing"></a>3. Editing Input Fields</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editing-intro"></a>3.1. Introduction</h3></div></div></div><p>

Mutt has a built-in line editor for inputting text, e.g. email

addresses or filenames. The keys used to manipulate text input are

very similar to those of Emacs. See <a href="gettingstarted.html#tab-keys-editor" title="Table 2.2. Most common line editor keys">Table 2.2, “Most common line editor keys”</a> for a full

very similar to those of Emacs. See <a class="xref" href="gettingstarted.html#tab-keys-editor" title="Table 2.2. Most common line editor keys">Table 2.2, “Most common line editor keys”</a> for a full

reference of available functions, their default key bindings, and

short descriptions.

</p><p>

</p><div class="table"><a id="tab-keys-editor"></a><p class="title"><b>Table 2.2. Most common line editor keys</b></p><div class="table-contents"><table summary="Most common line editor keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>^A or <Home></td><td>bol</td><td>move to the start of the line</td></tr><tr><td>^B or <Left></td><td>backward-char</td><td>move back one char</td></tr><tr><td>Esc B</td><td>backward-word</td><td>move back one word</td></tr><tr><td>^D or <Delete></td><td>delete-char</td><td>delete the char under the cursor</td></tr><tr><td>^E or <End></td><td>eol</td><td>move to the end of the line</td></tr><tr><td>^F or <Right></td><td>forward-char</td><td>move forward one char</td></tr><tr><td>Esc F</td><td>forward-word</td><td>move forward one word</td></tr><tr><td><Tab></td><td>complete</td><td>complete filename or alias</td></tr><tr><td>^T</td><td>complete-query</td><td>complete address with query</td></tr><tr><td>^K</td><td>kill-eol</td><td>delete to the end of the line</td></tr><tr><td>ESC d</td><td>kill-eow</td><td>delete to the end ot the word</td></tr><tr><td>^W</td><td>kill-word</td><td>kill the word in front of the cursor</td></tr><tr><td>^U</td><td>kill-line</td><td>delete entire line</td></tr><tr><td>^V</td><td>quote-char</td><td>quote the next typed key</td></tr><tr><td><Up></td><td>history-up</td><td>recall previous string from history</td></tr><tr><td><Down></td><td>history-down</td><td>recall next string from history</td></tr><tr><td><BackSpace></td><td>backspace</td><td>kill the char in front of the cursor</td></tr><tr><td>Esc u</td><td>upcase-word</td><td>convert word to upper case</td></tr><tr><td>Esc l</td><td>downcase-word</td><td>convert word to lower case</td></tr><tr><td>Esc c</td><td>capitalize-word</td><td>capitalize the word</td></tr><tr><td>^G</td><td>n/a</td><td>abort</td></tr><tr><td><Return></td><td>n/a</td><td>finish editing</td></tr></tbody></table></div></div><p><br class="table-break" />

</p><p>

</p><div class="table"><a id="tab-keys-editor"></a><p class="title"><b>Table 2.2. Most common line editor keys</b></p><div class="table-contents"><table summary="Most common line editor keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>^A or <Home></td><td><code class="literal"><bol></code></td><td>move to the start of the line</td></tr><tr><td>^B or <Left></td><td><code class="literal"><backward-char></code></td><td>move back one char</td></tr><tr><td>Esc B</td><td><code class="literal"><backward-word></code></td><td>move back one word</td></tr><tr><td>^D or <Delete></td><td><code class="literal"><delete-char></code></td><td>delete the char under the cursor</td></tr><tr><td>^E or <End></td><td><code class="literal"><eol></code></td><td>move to the end of the line</td></tr><tr><td>^F or <Right></td><td><code class="literal"><forward-char></code></td><td>move forward one char</td></tr><tr><td>Esc F</td><td><code class="literal"><forward-word></code></td><td>move forward one word</td></tr><tr><td><Tab></td><td><code class="literal"><complete></code></td><td>complete filename or alias</td></tr><tr><td>^T</td><td><code class="literal"><complete-query></code></td><td>complete address with query</td></tr><tr><td>^K</td><td><code class="literal"><kill-eol></code></td><td>delete to the end of the line</td></tr><tr><td>Esc d</td><td><code class="literal"><kill-eow></code></td><td>delete to the end of the word</td></tr><tr><td>^W</td><td><code class="literal"><kill-word></code></td><td>kill the word in front of the cursor</td></tr><tr><td>^U</td><td><code class="literal"><kill-line></code></td><td>delete entire line</td></tr><tr><td>^V</td><td><code class="literal"><quote-char></code></td><td>quote the next typed key</td></tr><tr><td><Up></td><td><code class="literal"><history-up></code></td><td>recall previous string from history</td></tr><tr><td><Down></td><td><code class="literal"><history-down></code></td><td>recall next string from history</td></tr><tr><td><BackSpace></td><td><code class="literal"><backspace></code></td><td>kill the char in front of the cursor</td></tr><tr><td>Esc u</td><td><code class="literal"><upcase-word></code></td><td>convert word to upper case</td></tr><tr><td>Esc l</td><td><code class="literal"><downcase-word></code></td><td>convert word to lower case</td></tr><tr><td>Esc c</td><td><code class="literal"><capitalize-word></code></td><td>capitalize the word</td></tr><tr><td>^G</td><td>n/a</td><td>abort</td></tr><tr><td><Return></td><td>n/a</td><td>finish editing</td></tr></tbody></table></div></div><br class="table-break" /><p>

You can remap the <span class="emphasis"><em>editor</em></span> functions using the

<a href="configuration.html#bind" title="4. Changing the default key bindings">bind</a> command. For example, to make

the <span class="emphasis"><em>Delete</em></span> key delete the character in front of

the cursor rather than under, you could use

<a class="link" href="configuration.html#bind" title="5. Changing the default key bindings">bind</a> command. For example, to make

the <Delete> key delete the character in front of

the cursor rather than under, you could use:

</p><pre class="screen">

bind editor <delete> backspace

</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editing-history"></a>2.2. History</h3></div></div></div><p>

The number of items in the built-in editor's history is controlled by

the <a href="reference.html#history" title="3.77. history">$history</a> variable. You may

cycle through them at an editor prompt by using the

<code class="literal">history-up</code> and/or <code class="literal">history-down</code>

commands.

</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editing-history"></a>3.2. History</h3></div></div></div><p>

Mutt maintains a history for the built-in editor. The number of items

is controlled by the <a class="link" href="reference.html#history" title="3.77. history">$history</a>

variable and can be made persistent using an external file specified

using <a class="link" href="reference.html#history-file" title="3.78. history_file">$history_file</a>.

You may cycle through them at an editor prompt by using the

<code class="literal"><history-up></code> and/or

<code class="literal"><history-down></code> commands.

</p><p>

100

Mutt maintains several distinct history lists, one for each of the

101

following categories:

</p><p>

102

</p><div class="itemizedlist"><ul type="disc"><li><p>muttrc commands</p></li><li><p>addresses and aliases</p></li><li><p>shell commands</p></li><li><p>filenames</p></li><li><p>patterns</p></li><li><p>everything else</p></li></ul></div><p>

</p><p>

103

Mutt automatically filters out repeated items from the history. It

104

also mimics the behavior of some shells by ignoring items starting

with a space.

</p><p>

The latter feature can be useful in macros to not clobber the history's

valuable entries with unwanted entries.

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="reading"></a>3. Reading Mail - The Index and Pager</h2></div></div></div><p>

105

with a space. The latter feature can be useful in macros to not clobber

106

the history's valuable entries with unwanted entries.

107

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="reading"></a>4. Reading Mail - The Index and Pager</h2></div></div></div><p>

108

Similar to many other mail clients, there are two modes in which mail is

109

read in Mutt. The first is the index of messages in the mailbox, which is

called the ``index'' in Mutt. The second mode is the display of the

message contents. This is called the ``pager.''

110

called the “<span class="quote">index</span>” in Mutt. The second mode is the display of the

111

message contents. This is called the “<span class="quote">pager.</span>”

112

</p><p>

113

The next few sections describe the functions provided in each of these

114

modes.

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id462615"></a>3.1. The Message Index</h3></div></div></div><p>

115

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="index-menu"></a>4.1. The Message Index</h3></div></div></div><p>

116

Common keys used to navigate through and manage messages in the index

are shown in <a href="gettingstarted.html#tab-key-index" title="Table 2.3. Most common message index keys">Table 2.3, “Most common message index keys”</a>.

</p><p>

</p><div class="table"><a id="tab-key-index"></a><p class="title"><b>Table 2.3. Most common message index keys</b></p><div class="table-contents"><table summary="Most common message index keys" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Key</th><th>Description</th></tr></thead><tbody><tr><td>c</td><td>change to a different mailbox</td></tr><tr><td>ESC c</td><td>change to a folder in read-only mode</td></tr><tr><td>C</td><td>copy the current message to another mailbox</td></tr><tr><td>ESC C</td><td>decode a message and copy it to a folder</td></tr><tr><td>ESC s</td><td>decode a message and save it to a folder</td></tr><tr><td>D</td><td>delete messages matching a pattern</td></tr><tr><td>d</td><td>delete the current message</td></tr><tr><td>F</td><td>mark as important</td></tr><tr><td>l</td><td>show messages matching a pattern</td></tr><tr><td>N</td><td>mark message as new</td></tr><tr><td>o</td><td>change the current sort method</td></tr><tr><td>O</td><td>reverse sort the mailbox</td></tr><tr><td>q</td><td>save changes and exit</td></tr><tr><td>s</td><td>save-message</td></tr><tr><td>T</td><td>tag messages matching a pattern</td></tr><tr><td>t</td><td>toggle the tag on a message</td></tr><tr><td>ESC t</td><td>toggle tag on entire message thread</td></tr><tr><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td>u</td><td>undelete-message</td></tr><tr><td>v</td><td>view-attachments</td></tr><tr><td>x</td><td>abort changes and exit</td></tr><tr><td><Return></td><td>display-message</td></tr><tr><td><Tab></td><td>jump to the next new or unread message</td></tr><tr><td>@</td><td>show the author's full e-mail address</td></tr><tr><td>$</td><td>save changes to mailbox</td></tr><tr><td>/</td><td>search</td></tr><tr><td>ESC /</td><td>search-reverse</td></tr><tr><td>^L</td><td>clear and redraw the screen</td></tr><tr><td>^T</td><td>untag messages matching a pattern</td></tr></tbody></table></div></div><p><br class="table-break" />

</p><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id462869"></a>3.1.1. Status Flags</h4></div></div></div><p>

117

are shown in <a class="xref" href="gettingstarted.html#tab-key-index" title="Table 2.3. Most common message index keys">Table 2.3, “Most common message index keys”</a>. How messages are presented

118

in the index menu can be customized using the

119

<a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a> variable.

120

</p><div class="table"><a id="tab-key-index"></a><p class="title"><b>Table 2.3. Most common message index keys</b></p><div class="table-contents"><table summary="Most common message index keys" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Key</th><th>Description</th></tr></thead><tbody><tr><td>c</td><td>change to a different mailbox</td></tr><tr><td>Esc c</td><td>change to a folder in read-only mode</td></tr><tr><td>C</td><td>copy the current message to another mailbox</td></tr><tr><td>Esc C</td><td>decode a message and copy it to a folder</td></tr><tr><td>Esc s</td><td>decode a message and save it to a folder</td></tr><tr><td>D</td><td>delete messages matching a pattern</td></tr><tr><td>d</td><td>delete the current message</td></tr><tr><td>F</td><td>mark as important</td></tr><tr><td>l</td><td>show messages matching a pattern</td></tr><tr><td>N</td><td>mark message as new</td></tr><tr><td>o</td><td>change the current sort method</td></tr><tr><td>O</td><td>reverse sort the mailbox</td></tr><tr><td>q</td><td>save changes and exit</td></tr><tr><td>s</td><td>save-message</td></tr><tr><td>T</td><td>tag messages matching a pattern</td></tr><tr><td>t</td><td>toggle the tag on a message</td></tr><tr><td>Esc t</td><td>toggle tag on entire message thread</td></tr><tr><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td>u</td><td>undelete-message</td></tr><tr><td>v</td><td>view-attachments</td></tr><tr><td>x</td><td>abort changes and exit</td></tr><tr><td><Return></td><td>display-message</td></tr><tr><td><Tab></td><td>jump to the next new or unread message</td></tr><tr><td>@</td><td>show the author's full e-mail address</td></tr><tr><td>$</td><td>save changes to mailbox</td></tr><tr><td>/</td><td>search</td></tr><tr><td>Esc /</td><td>search-reverse</td></tr><tr><td>^L</td><td>clear and redraw the screen</td></tr><tr><td>^T</td><td>untag messages matching a pattern</td></tr></tbody></table></div></div><br class="table-break" /><p>

121

In addition to who sent the message and the subject, a short summary of

122

the disposition of each message is printed beside the message number.

Zero or more of the following ``flags'' may appear, which mean:

</p><p>

</p><div class="variablelist"><dl><dt><span class="term">D</span></dt><dd><p>

message is deleted (is marked for deletion)

</p></dd><dt><span class="term">d</span></dt><dd><p>

message have attachments marked for deletion

</p></dd><dt><span class="term">K</span></dt><dd><p>

contains a PGP public key

</p></dd><dt><span class="term">N</span></dt><dd><p>

message is new

</p></dd><dt><span class="term">O</span></dt><dd><p>

message is old

</p></dd><dt><span class="term">P</span></dt><dd><p>

message is PGP encrypted

</p></dd><dt><span class="term">r</span></dt><dd><p>

message has been replied to

</p></dd><dt><span class="term">S</span></dt><dd><p>

message is signed, and the signature is successfully verified

</p></dd><dt><span class="term">s</span></dt><dd><p>

message is signed

</p></dd><dt><span class="term">!</span></dt><dd><p>

message is flagged

</p></dd><dt><span class="term">*</span></dt><dd><p>

message is tagged

100

</p></dd></dl></div><p>

101

</p><p>

102

Some of the status flags can be turned on or off using

103

104

</p><div class="itemizedlist"><ul type="disc"><li><p>

105

<span class="bold"><strong>set-flag</strong></span> (default: w)

106

</p></li><li><p>

107

<span class="bold"><strong>clear-flag</strong></span> (default: W)

108

</p></li></ul></div><p>

109

110

</p><p>

111

Furthermore, the following flags reflect who the message is addressed

112

to. They can be customized with the

113

<a href="reference.html#to-chars" title="3.289. to_chars">$to_chars</a> variable.

114

</p><p>

115

</p><div class="variablelist"><dl><dt><span class="term">+</span></dt><dd><p>

116

message is to you and you only

117

</p></dd><dt><span class="term">T</span></dt><dd><p>

118

message is to you, but also to or cc'ed to others

119

</p></dd><dt><span class="term">C</span></dt><dd><p>

120

message is cc'ed to you

121

</p></dd><dt><span class="term">F</span></dt><dd><p>

122

message is from you

123

</p></dd><dt><span class="term">L</span></dt><dd><p>

124

message is sent to a subscribed mailing list

125

</p></dd></dl></div><p>

126

</p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id463158"></a>3.2. The Pager</h3></div></div></div><p>

127

By default, Mutt uses its builtin pager to display the body of messages.

123

Zero or more of the “<span class="quote">flags</span>” in <a class="xref" href="gettingstarted.html#tab-msg-status-flags" title="Table 2.4. Message status flags">Table 2.4, “Message status flags”</a>

124

may appear, some of which can be turned on or off using these functions:

125

<code class="literal"><set-flag></code> and

126

127

bound by default to “<span class="quote">w</span>” and “<span class="quote">W</span>” respectively.

128

</p><p>

129

Furthermore, the flags in <a class="xref" href="gettingstarted.html#tab-msg-recip-flags" title="Table 2.5. Message recipient flags">Table 2.5, “Message recipient flags”</a> reflect

130

who the message is addressed to. They can be customized with the

131

<a class="link" href="reference.html#to-chars" title="3.290. to_chars">$to_chars</a> variable.

132

</p><div class="table"><a id="tab-msg-status-flags"></a><p class="title"><b>Table 2.4. Message status flags</b></p><div class="table-contents"><table summary="Message status flags" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Flag</th><th>Description</th></tr></thead><tbody><tr><td>D</td><td>message is deleted (is marked for deletion)</td></tr><tr><td>d</td><td>message has attachments marked for deletion</td></tr><tr><td>K</td><td>contains a PGP public key</td></tr><tr><td>N</td><td>message is new</td></tr><tr><td>O</td><td>message is old</td></tr><tr><td>P</td><td>message is PGP encrypted</td></tr><tr><td>r</td><td>message has been replied to</td></tr><tr><td>S</td><td>message is signed, and the signature is successfully verified</td></tr><tr><td>s</td><td>message is signed</td></tr><tr><td>!</td><td>message is flagged</td></tr><tr><td>*</td><td>message is tagged</td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="tab-msg-recip-flags"></a><p class="title"><b>Table 2.5. Message recipient flags</b></p><div class="table-contents"><table summary="Message recipient flags" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Flag</th><th>Description</th></tr></thead><tbody><tr><td>+</td><td>message is to you and you only</td></tr><tr><td>T</td><td>message is to you, but also to or cc'ed to others</td></tr><tr><td>C</td><td>message is cc'ed to you</td></tr><tr><td>F</td><td>message is from you</td></tr><tr><td>L</td><td>message is sent to a subscribed mailing list</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-menu"></a>4.2. The Pager</h3></div></div></div><p>

133

By default, Mutt uses its builtin pager to display the contents of messages.

128

134

The pager is very similar to the Unix program <span class="emphasis"><em>less</em></span> though not nearly as

129

135

featureful.

130

</p><p>

131

132

</p><div class="table"><a id="tab-key-pager"></a><p class="title"><b>Table 2.4. Most common pager keys</b></p><div class="table-contents"><table summary="Most common pager keys" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Key</th><th>Description</th></tr></thead><tbody><tr><td><Return></td><td>go down one line</td></tr><tr><td><Space></td><td>display the next page (or next message if at the end of a message)</td></tr><tr><td>-</td><td>go back to the previous page</td></tr><tr><td>n</td><td>search for next match</td></tr><tr><td>S</td><td>skip beyond quoted text</td></tr><tr><td>T</td><td>toggle display of quoted text</td></tr><tr><td>?</td><td>show keybindings</td></tr><tr><td>/</td><td>search for a regular expression (pattern)</td></tr><tr><td>ESC /</td><td>search backwards for a regular expression</td></tr><tr><td>\</td><td>toggle search pattern coloring</td></tr><tr><td>^</td><td>jump to the top of the message</td></tr></tbody></table></div></div><p><br class="table-break" />

133

134

</p><p>

135

In addition to key bindings in <a href="gettingstarted.html#tab-key-pager" title="Table 2.4. Most common pager keys">Table 2.4, “Most common pager keys”</a>,

136

many of the functions from the <span class="emphasis"><em>index</em></span> are available in

137

the pager, such as <span class="emphasis"><em>delete-message</em></span> or <span class="emphasis"><em>copy-message</em></span> (this is one

138

advantage over using an external pager to view messages).

136

</p><div class="table"><a id="tab-key-pager"></a><p class="title"><b>Table 2.6. Most common pager keys</b></p><div class="table-contents"><table summary="Most common pager keys" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Key</th><th>Description</th></tr></thead><tbody><tr><td><Return></td><td>go down one line</td></tr><tr><td><Space></td><td>display the next page (or next message if at the end of a message)</td></tr><tr><td>-</td><td>go back to the previous page</td></tr><tr><td>n</td><td>search for next match</td></tr><tr><td>S</td><td>skip beyond quoted text</td></tr><tr><td>T</td><td>toggle display of quoted text</td></tr><tr><td>?</td><td>show keybindings</td></tr><tr><td>/</td><td>regular expression search</td></tr><tr><td>Esc /</td><td>backward regular expression search</td></tr><tr><td>\</td><td>toggle highlighting of search matches</td></tr><tr><td>^</td><td>jump to the top of the message</td></tr></tbody></table></div></div><br class="table-break" /><p>

137

In addition to key bindings in <a class="xref" href="gettingstarted.html#tab-key-pager" title="Table 2.6. Most common pager keys">Table 2.6, “Most common pager keys”</a>,

138

many of the functions from the index menu are also available in

139

the pager, such as <code class="literal"><delete-message></code> or <code class="literal"><copy-message></code>

140

(this is one advantage over using an external pager to view messages).

139

141

</p><p>

140

142

Also, the internal pager supports a couple other advanced features. For

141

one, it will accept and translate the ``standard'' nroff sequences for

143

one, it will accept and translate the “<span class="quote">standard</span>” nroff sequences for

142

144

bold and underline. These sequences are a series of either the letter,

143

145

backspace (^H), the letter again for bold or the letter, backspace,

144

``_'' for denoting underline. Mutt will attempt to display these

146

“<span class="quote">_</span>” for denoting underline. Mutt will attempt to display these

145

147

in bold and underline respectively if your terminal supports them. If

146

not, you can use the bold and underline <a href="configuration.html#color" title="8. Using color and mono video attributes">color</a>

148

not, you can use the bold and underline <a class="link" href="configuration.html#color" title="9. Using color and mono video attributes">color</a>

147

149

objects to specify a color or mono attribute for them.

148

150

</p><p>

149

151

Additionally, the internal pager supports the ANSI escape sequences for

150

152

character attributes. Mutt translates them into the correct color and

151

character settings. The sequences Mutt supports are

152

'\e[<span class="emphasis"><em>Ps</em></span>;<span class="emphasis"><em>Ps</em></span>;..<span class="emphasis"><em>Ps</em></span>;m'

153

character settings. The sequences Mutt supports are:

154

</p><pre class="screen">

155

\e[<span class="emphasis"><em>Ps</em></span>;<span class="emphasis"><em>Ps</em></span>;..<span class="emphasis"><em>Ps</em></span>;m

156

</pre><p>

153

157

where <span class="emphasis"><em>Ps</em></span> can be one of the codes shown in

154

<a href="gettingstarted.html#tab-ansi-esc" title="Table 2.5. ANSI escape sequences">Table 2.5, “ANSI escape sequences”</a>.

155

</p><div class="table"><a id="tab-ansi-esc"></a><p class="title"><b>Table 2.5. ANSI escape sequences</b></p><div class="table-contents"><table summary="ANSI escape sequences" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Escape code</th><th>Description</th></tr></thead><tbody><tr><td>0</td><td>All Attributes Off</td></tr><tr><td>1</td><td>Bold on</td></tr><tr><td>4</td><td>Underline on</td></tr><tr><td>5</td><td>Blink on</td></tr><tr><td>7</td><td>Reverse video on</td></tr><tr><td>3<span class="emphasis"><em><color></em></span></td><td>Foreground color is <span class="emphasis"><em><color></em></span> (see <a href="gettingstarted.html#tab-color" title="Table 2.6. Color sequences">Table 2.6, “Color sequences”</a>)</td></tr><tr><td>4<span class="emphasis"><em><color></em></span></td><td>Background color is <span class="emphasis"><em><color></em></span> (see <a href="gettingstarted.html#tab-color" title="Table 2.6. Color sequences">Table 2.6, “Color sequences”</a>)</td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="tab-color"></a><p class="title"><b>Table 2.6. Color sequences</b></p><div class="table-contents"><table summary="Color sequences" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Color code</th><th>Color</th></tr></thead><tbody><tr><td>0</td><td>Black</td></tr><tr><td>1</td><td>Red</td></tr><tr><td>2</td><td>Green</td></tr><tr><td>3</td><td>Yellow</td></tr><tr><td>4</td><td>Blue</td></tr><tr><td>5</td><td>Magenta</td></tr><tr><td>6</td><td>Cyan</td></tr><tr><td>7</td><td>White</td></tr></tbody></table></div></div><br class="table-break" /><p>

156

Mutt uses these attributes for handling text/enriched messages, and they

157

can also be used by an external <a href="mimesupport.html#auto-view" title="4. MIME Autoview">autoview</a>

158

script for highlighting purposes. <span class="bold"><strong>Note:</strong></span> If you change the colors for your

158

<a class="xref" href="gettingstarted.html#tab-ansi-esc" title="Table 2.7. ANSI escape sequences">Table 2.7, “ANSI escape sequences”</a>.

159

</p><div class="table"><a id="tab-ansi-esc"></a><p class="title"><b>Table 2.7. ANSI escape sequences</b></p><div class="table-contents"><table summary="ANSI escape sequences" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Escape code</th><th>Description</th></tr></thead><tbody><tr><td>0</td><td>All attributes off</td></tr><tr><td>1</td><td>Bold on</td></tr><tr><td>4</td><td>Underline on</td></tr><tr><td>5</td><td>Blink on</td></tr><tr><td>7</td><td>Reverse video on</td></tr><tr><td>3<span class="emphasis"><em><color></em></span></td><td>Foreground color is <span class="emphasis"><em><color></em></span> (see <a class="xref" href="gettingstarted.html#tab-color" title="Table 2.8. Color sequences">Table 2.8, “Color sequences”</a>)</td></tr><tr><td>4<span class="emphasis"><em><color></em></span></td><td>Background color is <span class="emphasis"><em><color></em></span> (see <a class="xref" href="gettingstarted.html#tab-color" title="Table 2.8. Color sequences">Table 2.8, “Color sequences”</a>)</td></tr></tbody></table></div></div><br class="table-break" /><div class="table"><a id="tab-color"></a><p class="title"><b>Table 2.8. Color sequences</b></p><div class="table-contents"><table summary="Color sequences" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Color code</th><th>Color</th></tr></thead><tbody><tr><td>0</td><td>Black</td></tr><tr><td>1</td><td>Red</td></tr><tr><td>2</td><td>Green</td></tr><tr><td>3</td><td>Yellow</td></tr><tr><td>4</td><td>Blue</td></tr><tr><td>5</td><td>Magenta</td></tr><tr><td>6</td><td>Cyan</td></tr><tr><td>7</td><td>White</td></tr></tbody></table></div></div><br class="table-break" /><p>

160

Mutt uses these attributes for handling <code class="literal">text/enriched</code>

161

messages, and they can also be used by an external

162

<a class="link" href="mimesupport.html#auto-view" title="4. MIME Autoview">autoview</a> script for highlighting

163

purposes.

164

</p><div class="note"><h3 class="title">Note</h3><p>

165

If you change the colors for your

159

166

display, for example by changing the color associated with color2 for

160

167

your xterm, then that color will be used instead of green.

161

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="threads"></a>3.3. Threaded Mode</h3></div></div></div><p>

162

When the mailbox is <a href="reference.html#sort" title="3.270. sort">sorted</a> by <span class="emphasis"><em>threads</em></span>, there are

168

</p></div><div class="note"><h3 class="title">Note</h3><p>

169

Note that the search commands in the pager take regular expressions,

170

which are not quite the same as the more

171

complex <a class="link" href="advancedusage.html#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a> used by the search

172

command in the index. This is because the pager only performs simple

173

text search, whereas the index provides boolean filtering on several

174

aspects of messages.

175

</p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="threads"></a>4.3. Threaded Mode</h3></div></div></div><p>

176

When the mailbox is <a class="link" href="reference.html#sort" title="3.271. sort">sorted</a> by <span class="emphasis"><em>threads</em></span>, there are

163

177

a few additional functions available in the <span class="emphasis"><em>index</em></span> and <span class="emphasis"><em>pager</em></span> modes

164

as shown in <a href="gettingstarted.html#tab-key-threads" title="Table 2.7. Most common thread mode keys">Table 2.7, “Most common thread mode keys”</a>.

165

</p><p>

166

167

</p><div class="table"><a id="tab-key-threads"></a><p class="title"><b>Table 2.7. Most common thread mode keys</b></p><div class="table-contents"><table summary="Most common thread mode keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>^D</td><td>delete-thread</td><td>delete all messages in the current thread</td></tr><tr><td>^U</td><td>undelete-thread</td><td>undelete all messages in the current thread</td></tr><tr><td>^N</td><td>next-thread</td><td>jump to the start of the next thread</td></tr><tr><td>^P</td><td>previous-thread</td><td>jump to the start of the previous thread</td></tr><tr><td>^R</td><td>read-thread</td><td>mark the current thread as read</td></tr><tr><td>ESC d</td><td>delete-subthread</td><td>delete all messages in the current subthread</td></tr><tr><td>ESC u</td><td>undelete-subthread</td><td>undelete all messages in the current subthread</td></tr><tr><td>ESC n</td><td>next-subthread</td><td>jump to the start of the next subthread</td></tr><tr><td>ESC p</td><td>previous-subthread</td><td>jump to the start of the previous subthread</td></tr><tr><td>ESC r</td><td>read-subthread</td><td>mark the current subthread as read</td></tr><tr><td>ESC t</td><td>tag-thread</td><td>toggle the tag on the current thread</td></tr><tr><td>ESC v</td><td>collapse-thread</td><td>toggle collapse for the current thread</td></tr><tr><td>ESC V</td><td>collapse-all</td><td>toggle collapse for all threads</td></tr><tr><td>P</td><td>parent-message</td><td>jump to parent message in thread</td></tr></tbody></table></div></div><p><br class="table-break" />

168

169

</p><p>

170

<span class="bold"><strong>Note:</strong></span> Collapsing a thread displays only the first message

178

as shown in <a class="xref" href="gettingstarted.html#tab-key-threads" title="Table 2.9. Most common thread mode keys">Table 2.9, “Most common thread mode keys”</a>.

179

</p><div class="table"><a id="tab-key-threads"></a><p class="title"><b>Table 2.9. Most common thread mode keys</b></p><div class="table-contents"><table summary="Most common thread mode keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>^D</td><td><code class="literal"><delete-thread></code></td><td>delete all messages in the current thread</td></tr><tr><td>^U</td><td><code class="literal"><undelete-thread></code></td><td>undelete all messages in the current thread</td></tr><tr><td>^N</td><td><code class="literal"><next-thread></code></td><td>jump to the start of the next thread</td></tr><tr><td>^P</td><td><code class="literal"><previous-thread></code></td><td>jump to the start of the previous thread</td></tr><tr><td>^R</td><td><code class="literal"><read-thread></code></td><td>mark the current thread as read</td></tr><tr><td>Esc d</td><td><code class="literal"><delete-subthread></code></td><td>delete all messages in the current subthread</td></tr><tr><td>Esc u</td><td><code class="literal"><undelete-subthread></code></td><td>undelete all messages in the current subthread</td></tr><tr><td>Esc n</td><td><code class="literal"><next-subthread></code></td><td>jump to the start of the next subthread</td></tr><tr><td>Esc p</td><td><code class="literal"><previous-subthread></code></td><td>jump to the start of the previous subthread</td></tr><tr><td>Esc r</td><td><code class="literal"><read-subthread></code></td><td>mark the current subthread as read</td></tr><tr><td>Esc t</td><td><code class="literal"><tag-thread></code></td><td>toggle the tag on the current thread</td></tr><tr><td>Esc v</td><td><code class="literal"><collapse-thread></code></td><td>toggle collapse for the current thread</td></tr><tr><td>Esc V</td><td><code class="literal"><collapse-all></code></td><td>toggle collapse for all threads</td></tr><tr><td>P</td><td><code class="literal"><parent-message></code></td><td>jump to parent message in thread</td></tr></tbody></table></div></div><br class="table-break" /><div class="note"><h3 class="title">Note</h3><p>

180

Collapsing a thread displays only the first message

171

181

in the thread and hides the others. This is useful when threads

172

182

contain so many messages that you can only see a handful of threads on

173

the screen. See %M in <a href="reference.html#index-format" title="3.100. index_format">$index_format</a>.

174

For example, you could use "%?M?(#%03M)&(%4l)?" in <a href="reference.html#index-format" title="3.100. index_format">$index_format</a> to optionally

183

the screen. See %M in <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a>.

184

For example, you could use "%?M?(#%03M)&(%4l)?" in <a class="link" href="reference.html#index-format" title="3.101. index_format">$index_format</a> to optionally

175

185

display the number of hidden messages if the thread is collapsed.

176

</p><p>

177

See also: <a href="reference.html#strict-threads" title="3.280. strict_threads">$strict_threads</a>.

178

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id463814"></a>3.4. Miscellaneous Functions</h3></div></div></div><p>

179

<span class="bold"><strong>create-alias</strong></span><a id="create-alias"></a> (default: a)

180

181

</p><p>

186

</p></div><p>

187

See also: <a class="link" href="reference.html#strict-threads" title="3.281. strict_threads">$strict_threads</a>.

188

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reading-misc"></a>4.4. Miscellaneous Functions</h3></div></div></div><p>

189

In addition, the <span class="emphasis"><em>index</em></span> and <span class="emphasis"><em>pager</em></span>

190

menus have these interesting functions:

191

</p><div class="variablelist"><dl><dt><span class="term">

192

<code class="literal"><create-alias></code><a id="create-alias"></a> (default: a)

193

</span></dt><dd><p>

182

194

Creates a new alias based upon the current message (or prompts for a

183

new one). Once editing is complete, an <a href="configuration.html#alias" title="3. Defining/Using aliases">alias</a>

184

command is added to the file specified by the <a href="reference.html#alias-file" title="3.3. alias_file">$alias_file</a> variable for future use. <span class="bold"><strong>Note:</strong></span>

185

Specifying an <a href="reference.html#alias-file" title="3.3. alias_file">$alias_file</a>

186

does not add the aliases specified there-in, you must also <a href="configuration.html#source" title="27. Reading initialization commands from another file">source</a> the file.

187

</p><p>

188

<span class="bold"><strong>check-traditional-pgp</strong></span><a id="check-traditional-pgp"></a> (default: ESC P)

189

190

</p><p>

195

new one). Once editing is complete, an <a class="link" href="configuration.html#alias" title="4. Defining/Using aliases">alias</a>

196

command is added to the file specified by

197

the <a class="link" href="reference.html#alias-file" title="3.3. alias_file">$alias_file</a> variable

198

for future use

199

</p><div class="note"><h3 class="title">Note</h3><p>

200

Mutt does not read the <a class="link" href="reference.html#alias-file" title="3.3. alias_file">$alias_file</a>

201

upon startup so you must explicitly <a class="link" href="configuration.html#source" title="27. Reading initialization commands from another file">source</a> the file.

202

</p></div></dd><dt><span class="term">

203

<code class="literal"><check-traditional-pgp></code><a id="check-traditional-pgp"></a> (default: Esc P)

204

</span></dt><dd><p>

191

205

This function will search the current message for content signed or

192

encrypted with PGP the "traditional" way, that is, without proper

206

encrypted with PGP the “<span class="quote">traditional</span>” way, that is, without proper

193

207

MIME tagging. Technically, this function will temporarily change

194

208

the MIME content types of the body parts containing PGP data; this

195

is similar to the <a href="gettingstarted.html#edit-type">edit-type</a> function's

209

is similar to the <a class="link" href="gettingstarted.html#edit-type"><code class="literal"><edit-type></code></a> function's

196

210

effect.

197

</p><p>

198

<span class="bold"><strong>display-toggle-weed</strong></span><a id="display-toggle-weed"></a> (default: h)

199

200

</p><p>

201

Toggles the weeding of message header fields specified by <a href="configuration.html#ignore" title="9. Ignoring (weeding) unwanted message headers">ignore</a> commands.

202

</p><p>

203

<span class="bold"><strong>edit</strong></span><a id="edit"></a> (default: e)

204

205

</p><p>

206

This command (available in the ``index'' and ``pager'') allows you to

211

</p></dd><dt><span class="term">

212

<code class="literal"><edit></code><a id="edit"></a> (default: e)

213

</span></dt><dd><p>

214

This command (available in the index and pager) allows you to

207

215

edit the raw current message as it's present in the mail folder.

208

216

After you have finished editing, the changed message will be

209

217

appended to the current folder, and the original message will be

210

marked for deletion.

211

</p><p>

212

213

214

(default: ^E on the attachment menu, and in the pager and index menus; ^T on the

215

compose menu)

216

</p><p>

218

marked for deletion; if the message is unchanged it won't be replaced.

219

</p></dd><dt><span class="term">

220

<code class="literal"><edit-type></code><a id="edit-type"></a> (default:

221

^E on the attachment menu, and in the pager and index menus;

222

^T on the compose menu)

223

</span></dt><dd><p>

217

224

This command is used to temporarily edit an attachment's content

218

225

type to fix, for instance, bogus character set parameters. When

219

226

invoked from the index or from the pager, you'll have the

220

227

opportunity to edit the top-level attachment's content type. On the

221

<a href="mimesupport.html#attach-menu" title="1.2. The Attachment Menu">attachment menu</a>, you can change any

228

<a class="link" href="mimesupport.html#attach-menu" title="1.2. The Attachment Menu">attachment menu</a>, you can change any

222

229

attachment's content type. These changes are not persistent, and get

223

230

lost upon changing folders.

224

231

</p><p>

225

Note that this command is also available on the <a href="mimesupport.html#compose-menu" title="1.3. The Compose Menu">compose

232

Note that this command is also available on the <a class="link" href="mimesupport.html#compose-menu" title="1.3. The Compose Menu">compose

226

233

menu</a>. There, it's used to fine-tune the properties of attachments you are going

227

234

to send.

228

</p><p>

229

<span class="bold"><strong>enter-command</strong></span><a id="enter-command"></a> (default: ``:'')

230

231

</p><p>

235

</p></dd><dt><span class="term">

236

<code class="literal"><enter-command></code><a id="enter-command"></a> (default: “<span class="quote">:</span>”)

237

</span></dt><dd><p>

232

238

This command is used to execute any command you would normally put in a

233

239

configuration file. A common use is to check the settings of variables, or

234

in conjunction with <a href="configuration.html#macro" title="7. Keyboard macros">macros</a> to change settings on the

240

in conjunction with <a class="link" href="configuration.html#macro" title="8. Keyboard macros">macros</a> to change settings on the

235

241

fly.

236

</p><p>

237

<span class="bold"><strong>extract-keys</strong></span><a id="extract-keys"></a> (default: ^K)

238

239

</p><p>

242

</p></dd><dt><span class="term">

243

<code class="literal"><extract-keys></code><a id="extract-keys"></a> (default: ^K)

244

</span></dt><dd><p>

240

245

This command extracts PGP public keys from the current or tagged

241

246

message(s) and adds them to your PGP public key ring.

242

</p><p>

243

<span class="bold"><strong>forget-passphrase</strong></span><a id="forget-passphrase"></a> (default:

247

</p></dd><dt><span class="term">

248

<code class="literal"><forget-passphrase></code><a id="forget-passphrase"></a> (default:

244

249

^F)

245

246

</p><p>

250

</span></dt><dd><p>

247

251

This command wipes the passphrase(s) from memory. It is useful, if

248

252

you misspelled the passphrase.

249

</p><p>

250

<span class="bold"><strong>list-reply</strong></span><a id="list-reply"></a> (default: L)

251

252

</p><p>

253

</p></dd><dt><span class="term">

254

<code class="literal"><list-reply></code><a id="list-reply"></a> (default: L)

255

</span></dt><dd><p>

253

256

Reply to the current or tagged message(s) by extracting any addresses which

254

match the regular expressions given by the <a href="configuration.html#lists" title="11. Mailing lists">lists or subscribe</a>

257

match the regular expressions given by the <a class="link" href="configuration.html#lists" title="12. Mailing lists">lists or subscribe</a>

255

258

commands, but also honor any <code class="literal">Mail-Followup-To</code> header(s) if the

256

<a href="reference.html#honor-followup-to" title="3.79. honor_followup_to">$honor_followup_to</a>

259

<a class="link" href="reference.html#honor-followup-to" title="3.79. honor_followup_to">$honor_followup_to</a>

257

260

configuration variable is set. Using this when replying to messages posted

258

261

to mailing lists helps avoid duplicate copies being sent to the author of

259

262

the message you are replying to.

260

</p><p>

261

<span class="bold"><strong>pipe-message</strong></span><a id="pipe-message"></a> (default: |)

262

263

</p><p>

263

</p></dd><dt><span class="term">

264

<code class="literal"><pipe-message></code><a id="pipe-message"></a> (default: |)

265

</span></dt><dd><p>

264

266

Asks for an external Unix command and pipes the current or

265

tagged message(s) to it. The variables <a href="reference.html#pipe-decode" title="3.211. pipe_decode">$pipe_decode</a>, <a href="reference.html#pipe-split" title="3.210. pipe_split">$pipe_split</a>,

266

<a href="reference.html#pipe-sep" title="3.212. pipe_sep">$pipe_sep</a> and <a href="reference.html#wait-key" title="3.299. wait_key">$wait_key</a> control the exact behavior of this function.

267

</p><p>

268

<span class="bold"><strong>resend-message</strong></span><a id="resend-message"></a> (default: ESC e)

269

270

</p><p>

271

With resend-message, mutt takes the current message as a template for a

267

tagged message(s) to it. The variables <a class="link" href="reference.html#pipe-decode" title="3.212. pipe_decode">$pipe_decode</a>, <a class="link" href="reference.html#pipe-split" title="3.211. pipe_split">$pipe_split</a>,

268

<a class="link" href="reference.html#pipe-sep" title="3.213. pipe_sep">$pipe_sep</a> and <a class="link" href="reference.html#wait-key" title="3.300. wait_key">$wait_key</a> control the exact behavior of this function.

269

</p></dd><dt><span class="term">

270

<code class="literal"><resend-message></code><a id="resend-message"></a> (default: Esc e)

271

</span></dt><dd><p>

272

Mutt takes the current message as a template for a

272

273

new message. This function is best described as "recall from arbitrary

273

274

folders". It can conveniently be used to forward MIME messages while

274

275

preserving the original mail structure. Note that the amount of headers

275

included here depends on the value of the <a href="reference.html#weed" title="3.300. weed">$weed</a>

276

included here depends on the value of the <a class="link" href="reference.html#weed" title="3.301. weed">$weed</a>

276

277

variable.

277

278

</p><p>

278

279

This function is also available from the attachment menu. You can use this

279

280

to easily resend a message which was included with a bounce message

280

as a message/rfc822 body part.

281

</p><p>

282

<span class="bold"><strong>shell-escape</strong></span><a id="shell-escape"></a> (default: !)

283

284

</p><p>

285

Asks for an external Unix command and executes it. The <a href="reference.html#wait-key" title="3.299. wait_key">$wait_key</a> can be used to control

281

as a <code class="literal">message/rfc822</code> body part.

282

</p></dd><dt><span class="term">

283

<code class="literal"><shell-escape></code><a id="shell-escape"></a> (default: !)

284

</span></dt><dd><p>

285

Asks for an external Unix command and executes it. The <a class="link" href="reference.html#wait-key" title="3.300. wait_key">$wait_key</a> can be used to control

286

whether Mutt will wait for a key to be pressed when the command returns

287

(presumably to let the user read the output of the command), based on

288

the return status of the named command.

289

</p><p>

290

<span class="bold"><strong>toggle-quoted</strong></span><a id="toggle-quoted"></a> (default: T)

291

292

</p><p>

293

The <span class="emphasis"><em>pager</em></span> uses the <a href="reference.html#quote-regexp" title="3.234. quote_regexp">$quote_regexp</a> variable to detect quoted text when

288

the return status of the named command. If no command is given, an

289

interactive shell is executed.

290

</p></dd><dt><span class="term">

291

<code class="literal"><toggle-quoted></code><a id="toggle-quoted"></a> (default: T)

292

</span></dt><dd><p>

293

The pager uses the <a class="link" href="reference.html#quote-regexp" title="3.235. quote_regexp">$quote_regexp</a> variable to detect quoted text when

294

displaying the body of the message. This function toggles the display

295

of the quoted material in the message. It is particularly useful when

296

are interested in just the response and there is a large amount of

296

being interested in just the response and there is a large amount of

297

quoted text in the way.

298

</p><p>

299

<span class="bold"><strong>skip-quoted</strong></span><a id="skip-quoted"></a> (default: S)

300

301

</p><p>

302

This function will go to the next line of non-quoted text which come

298

</p></dd><dt><span class="term">

299

<code class="literal"><skip-quoted></code><a id="skip-quoted"></a> (default: S)

300

</span></dt><dd><p>

301

This function will go to the next line of non-quoted text which comes

303

302

after a line of quoted text in the internal pager.

304

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sending"></a>4. Sending Mail</h2></div></div></div><p>

305

The bindings shown in <a href="gettingstarted.html#tab-key-send" title="Table 2.8. Most common mail sending keys">Table 2.8, “Most common mail sending keys”</a> are available in the

306

<span class="emphasis"><em>index</em></span> for sending messages.

307

</p><p>

308

309

</p><div class="table"><a id="tab-key-send"></a><p class="title"><b>Table 2.8. Most common mail sending keys</b></p><div class="table-contents"><table summary="Most common mail sending keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>m</td><td>compose</td><td>compose a new message</td></tr><tr><td>r</td><td>reply</td><td>reply to sender</td></tr><tr><td>g</td><td>group-reply</td><td>reply to all recipients</td></tr><tr><td>L</td><td>list-reply</td><td>reply to mailing list address</td></tr><tr><td>f</td><td>forward</td><td>forward message</td></tr><tr><td>b</td><td>bounce</td><td>bounce (remail) message</td></tr><tr><td>ESC k</td><td>mail-key</td><td>mail a PGP public key to someone</td></tr></tbody></table></div></div><p><br class="table-break" />

310

311

</p><p>

312

Bouncing a message sends the message as is to the recipient you

313

specify. Forwarding a message allows you to add comments or

303

</p></dd></dl></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sending"></a>5. Sending Mail</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sending-intro"></a>5.1. Introduction</h3></div></div></div><p>

304

The bindings shown in <a class="xref" href="gettingstarted.html#tab-key-send" title="Table 2.10. Most common mail sending keys">Table 2.10, “Most common mail sending keys”</a> are available in the

305

<span class="emphasis"><em>index</em></span> and <span class="emphasis"><em>pager</em></span> to start a new message.

306

</p><div class="table"><a id="tab-key-send"></a><p class="title"><b>Table 2.10. Most common mail sending keys</b></p><div class="table-contents"><table summary="Most common mail sending keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>m</td><td><code class="literal"><compose></code></td><td>compose a new message</td></tr><tr><td>r</td><td><code class="literal"><reply></code></td><td>reply to sender</td></tr><tr><td>g</td><td><code class="literal"><group-reply></code></td><td>reply to all recipients</td></tr><tr><td>L</td><td><code class="literal"><list-reply></code></td><td>reply to mailing list address</td></tr><tr><td>f</td><td><code class="literal"><forward></code></td><td>forward message</td></tr><tr><td>b</td><td><code class="literal"><bounce></code></td><td>bounce (remail) message</td></tr><tr><td>Esc k</td><td><code class="literal"><mail-key></code></td><td>mail a PGP public key to someone</td></tr></tbody></table></div></div><br class="table-break" /><p>

307

<span class="emphasis"><em>Bouncing</em></span> a message sends the message as-is to the recipient you

308

specify. <span class="emphasis"><em>Forwarding</em></span> a message allows you to add comments or

314

309

modify the message you are forwarding. These items are discussed

315

in greater detail in the next chapter ``<a href="gettingstarted.html#forwarding-mail" title="5. Forwarding and Bouncing Mail">Forwarding

316

and Bouncing Mail</a>.''

310

in greater detail in the next chapter “<span class="quote"><a class="link" href="gettingstarted.html#forwarding-mail" title="6. Forwarding and Bouncing Mail">Forwarding

311

and Bouncing Mail</a>.</span>”

317

312

</p><p>

318

313

Mutt will then enter the <span class="emphasis"><em>compose</em></span> menu and prompt you for the

319

recipients to place on the ``To:'' header field. Next, it will ask

320

you for the ``Subject:'' field for the message, providing a default if

314

recipients to place on the “<span class="quote">To:</span>” header field. Next, it will ask

315

you for the “<span class="quote">Subject:</span>” field for the message, providing a default if

321

316

you are replying to or forwarding a message. See also

322

<a href="reference.html#askcc" title="3.10. askcc">$askcc</a>,

323

<a href="reference.html#askbcc" title="3.9. askbcc">$askbcc</a>,

324

<a href="reference.html#autoedit" title="3.17. autoedit">$autoedit</a>,

325

<a href="reference.html#bounce" title="3.21. bounce">$bounce</a>,

326

<a href="reference.html#fast-reply" title="3.55. fast_reply">$fast_reply</a>,

327

and <a href="reference.html#include" title="3.97. include">$include</a>

317

<a class="link" href="reference.html#askcc" title="3.10. askcc">$askcc</a>,

318

<a class="link" href="reference.html#askbcc" title="3.9. askbcc">$askbcc</a>,

319

<a class="link" href="reference.html#autoedit" title="3.17. autoedit">$autoedit</a>,

320

<a class="link" href="reference.html#bounce" title="3.21. bounce">$bounce</a>,

321

<a class="link" href="reference.html#fast-reply" title="3.55. fast_reply">$fast_reply</a>,

322

and <a class="link" href="reference.html#include" title="3.98. include">$include</a>

328

323

for changing how Mutt asks these questions.

329

324

</p><p>

330

Mutt will then automatically start your <a href="reference.html#editor" title="3.51. editor">$editor</a> on the message body. If the <a href="reference.html#edit-headers" title="3.50. edit_headers">$edit_headers</a> variable is set, the headers will be at

331

the top of the message in your editor. Any messages you are replying

332

to will be added in sort order to the message, with appropriate <a href="reference.html#attribution" title="3.16. attribution">$attribution</a>, <a href="reference.html#indent-string" title="3.99. indent_string">$indent_string</a> and <a href="reference.html#post-indent-string" title="3.222. post_indent_string">$post_indent_string</a>. When forwarding a

333

message, if the <a href="reference.html#mime-forward" title="3.126. mime_forward">$mime_forward</a>

325

Mutt will then automatically start your <a class="link" href="reference.html#editor" title="3.51. editor">$editor</a>

326

on the message body. If the <a class="link" href="reference.html#edit-headers" title="3.50. edit_headers">$edit_headers</a>

327

variable is set, the headers will be at the top of the message in your editor.

328

Any messages you are replying to will be added in sort order to the message,

329

with appropriate <a class="link" href="reference.html#attribution" title="3.16. attribution">$attribution</a>,

330

<a class="link" href="reference.html#indent-string" title="3.100. indent_string">$indent_string</a> and

331

<a class="link" href="reference.html#post-indent-string" title="3.223. post_indent_string">$post_indent_string</a>.

332

When forwarding a message, if the <a class="link" href="reference.html#mime-forward" title="3.127. mime_forward">$mime_forward</a>

334

333

variable is unset, a copy of the forwarded message will be included. If

335

you have specified a <a href="reference.html#signature" title="3.262. signature">$signature</a>, it

334

you have specified a <a class="link" href="reference.html#signature" title="3.263. signature">$signature</a>, it

336

335

will be appended to the message.

337

336

</p><p>

338

337

Once you have finished editing the body of your mail message, you are

339

338

returned to the <span class="emphasis"><em>compose</em></span> menu providing the functions

340

show in <a href="gettingstarted.html#tab-func-compose" title="Table 2.9. Most common compose menu keys">Table 2.9, “Most common compose menu keys”</a>.

341

</p><p>

342

343

</p><div class="table"><a id="tab-func-compose"></a><p class="title"><b>Table 2.9. Most common compose menu keys</b></p><div class="table-contents"><table summary="Most common compose menu keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>a</td><td>attach-file</td><td>attach a file</td></tr><tr><td>A</td><td>attach-message</td><td>attach message(s) to the message</td></tr><tr><td>ESC k</td><td>attach-key</td><td>attach a PGP public key</td></tr><tr><td>d</td><td>edit-description</td><td>edit description on attachment</td></tr><tr><td>D</td><td>detach-file</td><td>detach a file</td></tr><tr><td>t</td><td>edit-to</td><td>edit the To field</td></tr><tr><td>ESC f</td><td>edit-from</td><td>edit the From field</td></tr><tr><td>r</td><td>edit-reply-to</td><td>edit the Reply-To field</td></tr><tr><td>c</td><td>edit-cc</td><td>edit the Cc field</td></tr><tr><td>b</td><td>edit-bcc</td><td>edit the Bcc field</td></tr><tr><td>y</td><td>send-message</td><td>send the message</td></tr><tr><td>s</td><td>edit-subject</td><td>edit the Subject</td></tr><tr><td>S</td><td>smime-menu</td><td>select S/MIME options</td></tr><tr><td>f</td><td>edit-fcc</td><td>specify an ``Fcc'' mailbox</td></tr><tr><td>p</td><td>pgp-menu</td><td>select PGP options</td></tr><tr><td>P</td><td>postpone-message</td><td>postpone this message until later</td></tr><tr><td>q</td><td>quit</td><td>quit (abort) sending the message</td></tr><tr><td>w</td><td>write-fcc</td><td>write the message to a folder</td></tr><tr><td>i</td><td>ispell</td><td>check spelling (if available on your system)</td></tr><tr><td>^F</td><td>forget-passphrase</td><td>wipe passphrase(s) from memory</td></tr></tbody></table></div></div><p><br class="table-break" />

344

345

</p><p>

346

<span class="bold"><strong>Note:</strong></span> The attach-message function will prompt you for a folder to

339

shown in <a class="xref" href="gettingstarted.html#tab-func-compose" title="Table 2.11. Most common compose menu keys">Table 2.11, “Most common compose menu keys”</a> to modify, send or postpone the

340

message.

341

</p><div class="table"><a id="tab-func-compose"></a><p class="title"><b>Table 2.11. Most common compose menu keys</b></p><div class="table-contents"><table summary="Most common compose menu keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>a</td><td><code class="literal"><attach-file></code></td><td>attach a file</td></tr><tr><td>A</td><td><code class="literal"><attach-message></code></td><td>attach message(s) to the message</td></tr><tr><td>Esc k</td><td><code class="literal"><attach-key></code></td><td>attach a PGP public key</td></tr><tr><td>d</td><td><code class="literal"><edit-description></code></td><td>edit description on attachment</td></tr><tr><td>D</td><td><code class="literal"><detach-file></code></td><td>detach a file</td></tr><tr><td>t</td><td><code class="literal"><edit-to></code></td><td>edit the To field</td></tr><tr><td>Esc f</td><td><code class="literal"><edit-from></code></td><td>edit the From field</td></tr><tr><td>r</td><td><code class="literal"><edit-reply-to></code></td><td>edit the Reply-To field</td></tr><tr><td>c</td><td><code class="literal"><edit-cc></code></td><td>edit the Cc field</td></tr><tr><td>b</td><td><code class="literal"><edit-bcc></code></td><td>edit the Bcc field</td></tr><tr><td>y</td><td><code class="literal"><send-message></code></td><td>send the message</td></tr><tr><td>s</td><td><code class="literal"><edit-subject></code></td><td>edit the Subject</td></tr><tr><td>S</td><td><code class="literal"><smime-menu></code></td><td>select S/MIME options</td></tr><tr><td>f</td><td><code class="literal"><edit-fcc></code></td><td>specify an “<span class="quote">Fcc</span>” mailbox</td></tr><tr><td>p</td><td><code class="literal"><pgp-menu></code></td><td>select PGP options</td></tr><tr><td>P</td><td><code class="literal"><postpone-message></code></td><td>postpone this message until later</td></tr><tr><td>q</td><td><code class="literal"><quit></code></td><td>quit (abort) sending the message</td></tr><tr><td>w</td><td><code class="literal"><write-fcc></code></td><td>write the message to a folder</td></tr><tr><td>i</td><td><code class="literal"><ispell></code></td><td>check spelling (if available on your system)</td></tr><tr><td>^F</td><td><code class="literal"><forget-passphrase></code></td><td>wipe passphrase(s) from memory</td></tr></tbody></table></div></div><br class="table-break" /><p>

342

The compose menu is also used to edit the attachments for a message which can be either files

343

or other messages. The <code class="literal"><attach-message></code> function to will prompt you for a folder to

347

344

attach messages from. You can now tag messages in that folder and they

348

will be attached to the message you are sending. Note that certain

345

will be attached to the message you are sending.

346

</p><div class="note"><h3 class="title">Note</h3><p>

347

Note that certain

349

348

operations like composing a new mail, replying, forwarding, etc. are

350

not permitted when you are in that folder. The %r in <a href="reference.html#status-format" title="3.278. status_format">$status_format</a> will change to

351

a 'A' to indicate that you are in attach-message mode.

352

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id464797"></a>4.1. Editing the message header</h3></div></div></div><p>

353

When editing the header of your outgoing message, there are a couple of

354

special features available.

355

</p><p>

349

not permitted when you are in that folder. The %r in

350

<a class="link" href="reference.html#status-format" title="3.279. status_format">$status_format</a> will change to

351

a “<span class="quote">A</span>” to indicate that you are in attach-message mode.

352

</p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-header"></a>5.2. Editing the message header</h3></div></div></div><p>

353

When editing the header because of <a class="link" href="reference.html#edit-headers" title="3.50. edit_headers">$edit_headers</a>

354

being set, there are a several pseudo headers available which

355

will not be included in sent messages.

356

</p><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="fcc-header"></a>5.2.1. Fcc: pseudo header</h4></div></div></div><p>

356

357

If you specify

357

358

359

<code class="literal">Fcc:</code> <span class="emphasis"><em>filename</em></span>

359

360

Mutt will pick up <span class="emphasis"><em>filename</em></span>

361

just as if you had used the <span class="emphasis"><em>edit-fcc</em></span> function in the <span class="emphasis"><em>compose</em></span> menu.

362

</p><p>

361

as a header, Mutt will pick up <span class="emphasis"><em>filename</em></span>

362

just as if you had used the <code class="literal"><edit-fcc></code> function in the <span class="emphasis"><em>compose</em></span> menu.

363

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="attach-header"></a>5.2.2. Attach: pseudo header</h4></div></div></div><p>

363

364

You can also attach files to your message by specifying

364

365

366

<code class="literal">Attach:</code> <span class="emphasis"><em>filename</em></span> [ <span class="emphasis"><em>description</em></span> ]

366

367

368

where <span class="emphasis"><em>filename</em></span> is the file to attach and <span class="emphasis"><em>description</em></span> is an

368

369

optional string to use as the description of the attached file.

369

</p><p>

370

When replying to messages, if you remove the <span class="emphasis"><em>In-Reply-To:</em></span> field from

371

the header field, Mutt will not generate a <span class="emphasis"><em>References:</em></span> field, which

372

allows you to create a new message thread.

373

</p><p>

374

Also see <a href="reference.html#edit-headers" title="3.50. edit_headers">$edit_headers</a>.

375

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id464885"></a>4.2. Using Mutt with PGP</h3></div></div></div><p>

376

If you want to use PGP, you can specify

377

</p><p>

378

<code class="literal">Pgp:</code> [ <code class="literal">E</code> | <code class="literal">S</code> | <code class="literal">S</code><span class="emphasis"><em><id></em></span> ]

370

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="pgp-header"></a>5.2.3. Pgp: pseudo header</h4></div></div></div><p>

371

If you want to use PGP, you can specify

372

</p><p>

373

<code class="literal">Pgp:</code> [ <code class="literal">E</code> | <code class="literal">S</code> | <code class="literal">S</code><span class="emphasis"><em><id></em></span> ]

379

374

380

375

</p><p>

381

``E'' encrypts, ``S'' signs and

382

``S<id>'' signs with the given key, setting <a href="reference.html#pgp-sign-as" title="3.162. pgp_sign_as">$pgp_sign_as</a> permanently.

383

</p><p>

384

If you have told mutt to PGP encrypt a message, it will guide you

376

“<span class="quote">E</span>” selects encryption, “<span class="quote">S</span>” selects signing and

377

“<span class="quote">S<id></span>” selects signing with the given key, setting

378

379

permanently.

380

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="in-reply-to-header"></a>5.2.4. In-Reply-To: header</h4></div></div></div><p>

381

When replying to messages, the <span class="emphasis"><em>In-Reply-To:</em></span> header contains the

382

Message-Id of the message(s) you reply to. If you remove its value, Mutt will not generate a

383

<span class="emphasis"><em>References:</em></span> field, which allows you to create a new message thread, for example

384

to create a new message to a mailing list without having to enter the mailing list's address.

385

</p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sending-crypto"></a>5.3. Sending cryptographically signed/encrypted messages</h3></div></div></div><p>

386

If you have told mutt to PGP or S/MIME encrypt a message, it will guide you

385

387

through a key selection process when you try to send the message.

386

388

Mutt will not ask you any questions about keys which have a

387

389

certified user ID matching one of the message recipients' mail

396

398

return to the compose screen.

397

399

</p><p>

398

400

Once you have successfully finished the key selection, the message

399

will be encrypted using the selected public keys, and sent out.

401

will be encrypted using the selected public keys when sent out.

400

402

</p><p>

401

Most fields of the entries in the key selection menu (see also <a href="reference.html#pgp-entry-format" title="3.154. pgp_entry_format">$pgp_entry_format</a>)

402

have obvious meanings. But some explanations on the capabilities, flags,

403

Most fields of the entries in the key selection menu (see also <a class="link" href="reference.html#pgp-entry-format" title="3.155. pgp_entry_format">$pgp_entry_format</a>)

404

have obvious meanings. But some explanations on the capabilities, flags,

403

405

and validity fields are in order.

404

406

</p><p>

405

407

The flags sequence (%f) will expand to one of the flags in

406

<a href="gettingstarted.html#tab-pgp-menuflags" title="Table 2.10. PGP key menu flags">Table 2.10, “PGP key menu flags”</a>.

407

408

</p><div class="table"><a id="tab-pgp-menuflags"></a><p class="title"><b>Table 2.10. PGP key menu flags</b></p><div class="table-contents"><table summary="PGP key menu flags" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Flag</th><th>Description</th></tr></thead><tbody><tr><td>R</td><td>The key has been revoked and can't be used.</td></tr><tr><td>X</td><td>The key is expired and can't be used.</td></tr><tr><td>d</td><td>You have marked the key as disabled.</td></tr><tr><td>c</td><td>There are unknown critical self-signature packets.</td></tr></tbody></table></div></div><p><br class="table-break" />

409

410

</p><p>

408

<a class="xref" href="gettingstarted.html#tab-pgp-menuflags" title="Table 2.12. PGP key menu flags">Table 2.12, “PGP key menu flags”</a>.

409

</p><div class="table"><a id="tab-pgp-menuflags"></a><p class="title"><b>Table 2.12. PGP key menu flags</b></p><div class="table-contents"><table summary="PGP key menu flags" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Flag</th><th>Description</th></tr></thead><tbody><tr><td>R</td><td>The key has been revoked and can't be used.</td></tr><tr><td>X</td><td>The key is expired and can't be used.</td></tr><tr><td>d</td><td>You have marked the key as disabled.</td></tr><tr><td>c</td><td>There are unknown critical self-signature packets.</td></tr></tbody></table></div></div><br class="table-break" /><p>

411

410

The capabilities field (%c) expands to a two-character sequence

412

411

representing a key's capabilities. The first character gives

413

the key's encryption capabilities: A minus sign (<span class="bold"><strong>-</strong></span>) means

414

that the key cannot be used for encryption. A dot (<span class="bold"><strong>.</strong></span>) means that

415

it's marked as a signature key in one of the user IDs, but may

416

also be used for encryption. The letter <span class="bold"><strong>e</strong></span> indicates that

412

the key's encryption capabilities: A minus sign (“<span class="quote">-</span>”) means

413

that the key cannot be used for encryption. A dot (“<span class="quote">.</span>”) means that

414

it's marked as a signature key in one of the user IDs, but may

415

also be used for encryption. The letter “<span class="quote">e</span>” indicates that

417

416

this key can be used for encryption.

418

417

</p><p>

419

The second character indicates the key's signing capabilities. Once

420

again, a ``<span class="bold"><strong>-</strong></span>'' implies ``not for signing'', ``<span class="bold"><strong>.</strong></span>'' implies

418

The second character indicates the key's signing capabilities. Once

419

again, a “<span class="quote">-</span>” implies “<span class="quote">not for signing</span>”, “<span class="quote">.</span>” implies

421

420

that the key is marked as an encryption key in one of the user-ids, and

422

``<span class="bold"><strong>s</strong></span>'' denotes a key which can be used for signing.

421

“<span class="quote">s</span>” denotes a key which can be used for signing.

423

422

</p><p>

424

423

Finally, the validity field (%t) indicates how well-certified a user-id

425

is. A question mark (<span class="bold"><strong>?</strong></span>) indicates undefined validity, a minus

426

character (<span class="bold"><strong>-</strong></span>) marks an untrusted association, a space character

427

means a partially trusted association, and a plus character (<span class="bold"><strong>+</strong></span>)

424

is. A question mark (“<span class="quote">?</span>”) indicates undefined validity, a minus

425

character (“<span class="quote">-</span>”) marks an untrusted association, a space character

426

means a partially trusted association, and a plus character (“<span class="quote">+</span>”)

428

427

indicates complete validity.

429

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id465129"></a>4.3. Sending anonymous messages via mixmaster.</h3></div></div></div><p>

430

You may also have configured mutt to co-operate with Mixmaster, an

428

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sending-mixmaster"></a>5.4. Sending anonymous messages via mixmaster</h3></div></div></div><p>

429

You may also have compiled mutt to co-operate with Mixmaster, an

431

430

anonymous remailer. Mixmaster permits you to send your messages

432

anonymously using a chain of remailers. Mixmaster support in mutt is for

433

mixmaster version 2.04 (beta 45 appears to be the latest) and 2.03.

434

It does not support earlier versions or the later so-called version 3 betas,

431

anonymously using a chain of remailers. Mixmaster support in mutt is for

432

mixmaster version 2.04 (beta 45 appears to be the latest) and 2.03.

433

It does not support earlier versions or the later so-called version 3 betas,

435

434

of which the latest appears to be called 2.9b23.

436

435

</p><p>

437

436

To use it, you'll have to obey certain restrictions. Most

443

442

(larger) upper part, you get a list of remailers you may use. In

444

443

the lower part, you see the currently selected chain of remailers.

445

444

</p><p>

446

You can navigate in the chain using the <code class="literal">chain-prev</code> and

447

<code class="literal">chain-next</code> functions, which are by default bound to the left

445

You can navigate in the chain using the <code class="literal"><chain-prev></code> and

446

<code class="literal"><chain-next></code> functions, which are by default bound to the left

448

447

and right arrows and to the <code class="literal">h</code> and <code class="literal">l</code> keys (think vi

449

448

keyboard bindings). To insert a remailer at the current chain

450

position, use the <code class="literal">insert</code> function. To append a remailer behind

451

the current chain position, use <code class="literal">select-entry</code> or <code class="literal">append</code>.

449

position, use the <code class="literal"><insert></code> function. To append a remailer behind

450

the current chain position, use <code class="literal"><select-entry></code> or <code class="literal"><append></code>.

452

451

You can also delete entries from the chain, using the corresponding

453

452

function. Finally, to abandon your changes, leave the menu, or

454

<code class="literal">accept</code> them pressing (by default) the <code class="literal">Return</code> key.

453

<code class="literal"><accept></code> them pressing (by default) the <code class="literal">Return</code> key.

455

454

</p><p>

456

455

Note that different remailers do have different capabilities,

457

456

indicated in the %c entry of the remailer menu lines (see

458

<a href="reference.html#mix-entry-format" title="3.129. mix_entry_format">$mix_entry_format</a>). Most important is

459

the ``middleman'' capability, indicated by a capital ``M'': This

457

<a class="link" href="reference.html#mix-entry-format" title="3.130. mix_entry_format">$mix_entry_format</a>). Most important is

458

the “<span class="quote">middleman</span>” capability, indicated by a capital “<span class="quote">M</span>”: This

460

459

means that the remailer in question cannot be used as the final

461

460

element of a chain, but will only forward messages to other

462

461

mixmaster remailers. For details on the other capabilities, please

463

462

have a look at the mixmaster documentation.

464

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id465253"></a>4.4. Sending format=flowed messages</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id465259"></a>4.4.1. Concept</h4></div></div></div><p>

463

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ff"></a>5.5. Sending format=flowed messages</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="ff-concept"></a>5.5.1. Concept</h4></div></div></div><p>

465

464

<code class="literal">format=flowed</code>-style messages (or <code class="literal">f=f</code>

466

465

for short) are <code class="literal">text/plain</code> messages that consist of paragraphs which a receiver's

467

466

mail client may reformat to its own needs which mostly means to

468

467

customize line lengths regardless of what the sender sent. Technically this is

469

achieved by letting lines of a ``flowable'' paragraph end in spaces.

468

achieved by letting lines of a “<span class="quote">flowable</span>” paragraph end in spaces

469

except for the last line.

470

</p><p>

471

While for text-mode clients like mutt it's the best way to assume only a

472

standard 80x25 character cell terminal, it may be desired to let the

473

receiver decide completely how to view a message.

474

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id465297"></a>4.4.2. Mutt support</h4></div></div></div><p>

474

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="ff-support"></a>5.5.2. Mutt support</h4></div></div></div><p>

475

Mutt only supports setting the required <code class="literal">format=flowed</code>

476

MIME parameter on outgoing messages if the <a href="reference.html#text-flowed" title="3.282. text_flowed">$text_flowed</a> variable is set. It does not add the

477

trailing spaces nor does it provide any other feature related to

478

composing <code class="literal">f=f</code> messages (like reformatting

479

non-<code class="literal">f=f</code> parts of a reply to <code class="literal">f=f</code>

480

before calling the editor).

476

MIME parameter on outgoing messages if the <a class="link" href="reference.html#text-flowed" title="3.283. text_flowed">$text_flowed</a>

477

variable is set, specifically it does not add the

478

trailing spaces.

481

479

</p><p>

482

480

After editing the initial message text and before entering

483

481

the compose menu, mutt properly space-stuffes the message.

484

482

<span class="emphasis"><em>Space-stuffing</em></span> is required by RfC3676 defining

485

483

<code class="literal">format=flowed</code> and means to prepend a space to:

486

</p><div class="itemizedlist"><ul type="disc"><li><p>all lines starting with a space</p></li><li><p>lines starting with the word ``<code class="literal">From</code>''

487

followed by space</p></li><li><p>all lines starting with ``<code class="literal">></code>'' which

488

is not intended to be a quote character</p></li></ul></div><p>

489

All leading spaces are to be removed by receiving clients to restore

490

the original message.

491

</p><p>

492

<span class="bold"><strong>Note</strong></span> that mutt only support space-stuffing

484

</p><div class="itemizedlist"><ul type="disc"><li><p>all lines starting with a space</p></li><li><p>lines starting with the word “<span class="quote"><code class="literal">From</code></span>”

485

followed by space</p></li><li><p>all lines starting with “<span class="quote"><code class="literal">></code></span>” which

486

is not intended to be a quote character</p></li></ul></div><div class="note"><h3 class="title">Note</h3><p>

487

Mutt only supports space-stuffing

493

488

for the first two types of lines but not for the third: It is impossible to

494

489

safely detect whether a leading <code class="literal">></code> character starts a

495

quote or not.

496

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id465411"></a>4.4.3. Editor considerations</h4></div></div></div><p>

490

quote or not. Furthermore, Mutt only applies space-stuffing

491

<span class="emphasis"><em>once</em></span> after the initial edit is finished.

492

</p></div><p>

493

All leading spaces are to be removed by receiving clients to restore

494

the original message prior to further processing.

495

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="ff-editor"></a>5.5.3. Editor considerations</h4></div></div></div><p>

497

496

As mutt provides no additional features to compose <code class="literal">f=f</code>

498

497

messages, it's completely up to the user and his editor to produce

499

498

proper messages. Please consider your editor's documentation if you

507

506

flag for its <code class="literal">formatoptions</code> setting to assist in

508

507

creating <code class="literal">f=f</code> messages, see <code class="literal">:help

509

508

fo-table</code> for details.

510

</p></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="forwarding-mail"></a>5. Forwarding and Bouncing Mail</h2></div></div></div><p>

509

</p></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="forwarding-mail"></a>6. Forwarding and Bouncing Mail</h2></div></div></div><p>

511

510

Bouncing and forwarding let you send an existing message to recipients

512

that you specify. Bouncing a message uses the <a href="reference.html#sendmail" title="3.257. sendmail">$sendmail</a> command to send a copy to alternative addresses as if

513

they were the message's original recipients. Forwarding a message, on

514

the other hand, allows you to modify the message before it is resent

515

(for example, by adding your own comments). The default key bindings

516

are shown in <a href="gettingstarted.html#tab-key-fwd" title="Table 2.11. Message forwarding/bouncing keys">Table 2.11, “Message forwarding/bouncing keys”</a>.

517

</p><p>

518

519

</p><div class="table"><a id="tab-key-fwd"></a><p class="title"><b>Table 2.11. Message forwarding/bouncing keys</b></p><div class="table-contents"><table summary="Message forwarding/bouncing keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>f</td><td>forward</td><td>forward message</td></tr><tr><td>b</td><td>bounce</td><td>bounce (remail) message</td></tr></tbody></table></div></div><p><br class="table-break" />

520

511

that you specify. Bouncing a message sends a verbatim copy of a message

512

to alternative addresses as if they were the message's original

513

recipients specified in the Bcc header.

514

Forwarding a message, on the other hand, allows you to modify the message

515

before it is resent (for example, by adding your own comments). Bouncing

516

is done using the <code class="literal"><bounce></code> function and forwarding

517

using the <code class="literal"><forward></code> function bound to “<span class="quote">b</span>” and “<span class="quote">f</span>”

518

respectively.

521

519

</p><p>

522

520

Forwarding can be done by including the original message in the new

523

521

message's body (surrounded by indicating lines) or including it as a MIME

524

attachment, depending on the value of the <a href="reference.html#mime-forward" title="3.126. mime_forward">$mime_forward</a> variable. Decoding of attachments,

525

like in the pager, can be controlled by the <a href="reference.html#forward-decode" title="3.62. forward_decode">$forward_decode</a> and <a href="reference.html#mime-forward-decode" title="3.127. mime_forward_decode">$mime_forward_decode</a> variables,

522

attachment, depending on the value of the <a class="link" href="reference.html#mime-forward" title="3.127. mime_forward">$mime_forward</a> variable. Decoding of attachments,

523

like in the pager, can be controlled by the <a class="link" href="reference.html#forward-decode" title="3.62. forward_decode">$forward_decode</a> and <a class="link" href="reference.html#mime-forward-decode" title="3.128. mime_forward_decode">$mime_forward_decode</a> variables,

526

524

respectively. The desired forwarding format may depend on the content,

527

525

therefore <span class="emphasis"><em>$mime_forward</em></span> is a quadoption which, for

528

example, can be set to ``ask-no''.

526

example, can be set to “<span class="quote">ask-no</span>”.

529

527

</p><p>

530

528

The inclusion of headers is controlled by the current setting of the

531

<a href="reference.html#weed" title="3.300. weed">$weed</a> variable, unless <a href="reference.html#mime-forward" title="3.126. mime_forward">$mime_forward</a> is set.

529

<a class="link" href="reference.html#weed" title="3.301. weed">$weed</a> variable, unless <a class="link" href="reference.html#mime-forward" title="3.127. mime_forward">$mime_forward</a> is set.

532

530

</p><p>

533

531

Editing the message to forward follows the same procedure as sending or

534

532

replying to a message does.

535

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="postponing-mail"></a>6. Postponing Mail</h2></div></div></div><p>

533

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="postponing-mail"></a>7. Postponing Mail</h2></div></div></div><p>

536

534

At times it is desirable to delay sending a message that you have

537

already begun to compose. When the <span class="emphasis"><em>postpone-message</em></span> function is

535

already begun to compose. When the <code class="literal"><postpone-message></code> function is

538

536

used in the <span class="emphasis"><em>compose</em></span> menu, the body of your message and attachments

539

are stored in the mailbox specified by the <a href="reference.html#postponed" title="3.224. postponed">$postponed</a> variable. This means that you can recall the

537

are stored in the mailbox specified by the <a class="link" href="reference.html#postponed" title="3.225. postponed">$postponed</a> variable. This means that you can recall the

540

538

message even if you exit Mutt and then restart it at a later time.

541

539

</p><p>

542

540

Once a message is postponed, there are several ways to resume it. From the

543

command line you can use the ``-p'' option, or if you <span class="emphasis"><em>compose</em></span> a new

541

command line you can use the “<span class="quote">-p</span>” option, or if you compose a new

544

542

message from the <span class="emphasis"><em>index</em></span> or <span class="emphasis"><em>pager</em></span> you will be prompted if postponed

545

543

messages exist. If multiple messages are currently postponed, the

546

544

<span class="emphasis"><em>postponed</em></span> menu will pop up and you can select which message you would

547

545

like to resume.

548

</p><p>

549

<span class="bold"><strong>Note:</strong></span> If you postpone a reply to a message, the reply setting of

546

</p><div class="note"><h3 class="title">Note</h3><p>

547

If you postpone a reply to a message, the reply setting of

550

548

the message is only updated when you actually finish the message and

551

549

send it. Also, you must be in the same folder with the message you

552

550

replied to for the status of the message to be updated.

553

</p><p>

554

See also the <a href="reference.html#postpone" title="3.223. postpone">$postpone</a> quad-option.

551

</p></div><p>

552

See also the <a class="link" href="reference.html#postpone" title="3.224. postpone">$postpone</a> quad-option.

555

553

</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="intro.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="configuration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 1. Introduction </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3. Configuration</td></tr></table></div></body></html>

Older »