157
170
behaviour including managing multiple identities, customizing the
158
171
display for a folder or even implementing auto-archiving based on a
159
172
per-folder basis and much more.
160
</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>
161
The most important navigation keys common to all menus are shown in
162
<a class="xref" href="#tab-keys-nav" title="Table 2.1. Most common navigation keys">Table 2.1, “Most common navigation keys”</a>.
163
</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>
174
Besides an interactive mode, Mutt can also be used as a command-line
175
tool only send messages. It also supports a
176
<code class="literal">mailx(1)</code>-compatible interface, see <a class="xref" href="#tab-commandline-options" title="Table 9.1. Command line options">Table 9.1, “Command line options”</a> for a complete list of command-line
178
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="concept-screens-and-menus"></a>2. Screens and Menus</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-index"></a>2.1. Index</h3></div></div></div><p>
179
The index is the screen that you usually see first when you start
180
Mutt. It gives an overview over your emails in the currently opened
181
mailbox. By default, this is your system mailbox. The information you
182
see in the index is a list of emails, each with its number on the left,
183
its flags (new email, important email, email that has been forwarded or
184
replied to, tagged email, ...), the date when email was sent, its
185
sender, the email size, and the subject. Additionally, the index also
186
shows thread hierarchies: when you reply to an email, and the other
187
person replies back, you can see the other's person email in a
188
"sub-tree" below. This is especially useful for personal email between
189
a group of people or when you've subscribed to mailing lists.
190
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-pager"></a>2.2. Pager</h3></div></div></div><p>
191
The pager is responsible for showing the email content. On the top of
192
the pager you have an overview over the most important email headers
193
like the sender, the recipient, the subject, and much more
194
information. How much information you actually see depends on your
195
configuration, which we'll describe below.
197
Below the headers, you see the email body which usually contains the
198
message. If the email contains any attachments, you will see more
199
information about them below the email body, or, if the attachments are
200
text files, you can view them directly in the pager.
202
To give the user a good overview, it is possible to configure Mutt to
203
show different things in the pager with different colors. Virtually
204
everything that can be described with a regular expression can be
205
colored, e.g. URLs, email addresses or smileys.
206
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-browser"></a>2.3. File Browser</h3></div></div></div><p>
207
The file browser is the interface to the local or remote file
208
system. When selecting a mailbox to open, the browser allows custom
209
sorting of items, limiting the items shown by a regular expression and a
210
freely adjustable format of what to display in which way. It also allows
211
for easy navigation through the file system when selecting file(s) to
212
attach to a message, select multiple files to attach and many more.
213
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-help"></a>2.4. Help</h3></div></div></div><p>
214
The help screen is meant to offer a quick help to the user. It lists the
215
current configuration of key bindings and their associated commands
216
including a short description, and currently unbound functions that
217
still need to be associated with a key binding (or alternatively, they
218
can be called via the Mutt command prompt).
219
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-compose"></a>2.5. Compose Menu</h3></div></div></div><p>
220
The compose menu features a split screen containing the information
221
which really matter before actually sending a message by mail: who gets
222
the message as what (recipients and who gets what kind of
223
copy). Additionally, users may set security options like deciding
224
whether to sign, encrypt or sign and encrypt a message with/for what
225
keys. Also, it's used to attach messages, to re-edit any attachment
226
including the message itself.
227
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-alias"></a>2.6. Alias Menu</h3></div></div></div><p>
228
The alias menu is used to help users finding the recipients of
229
messages. For users who need to contact many people, there's no need to
230
remember addresses or names completely because it allows for searching,
231
too. The alias mechanism and thus the alias menu also features grouping
232
several addresses by a shorter nickname, the actual alias, so that users
233
don't have to select each single recipient manually.
234
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="intro-attach"></a>2.7. Attachment Menu</h3></div></div></div><p>
235
As will be later discussed in detail, Mutt features a good and stable
236
MIME implementation, that is, it supports sending and receiving messages
237
of arbitrary MIME types. The attachment menu displays a message's
238
structure in detail: what content parts are attached to which parent
239
part (which gives a true tree structure), which type is of what type and
240
what size. Single parts may saved, deleted or modified to offer great
241
and easy access to message's internals.
242
</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="menus"></a>3. Moving Around in Menus</h2></div></div></div><p>
243
The most important navigation keys common to line- or entry-based menus
244
are shown in <a class="xref" href="#tab-keys-nav-line" title="Table 2.1. Most common navigation keys in entry-based menus">Table 2.1, “Most common navigation keys in entry-based menus”</a> and in
245
<a class="xref" href="#tab-keys-nav-page" title="Table 2.2. Most common navigation keys in page-based menus">Table 2.2, “Most common navigation keys in page-based menus”</a> for page-based menus.
246
</p><div class="table"><a id="tab-keys-nav-line"></a><p class="title"><b>Table 2.1. Most common navigation keys in entry-based menus</b></p><div class="table-contents"><table summary="Most common navigation keys in entry-based menus" 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 class="table"><a id="tab-keys-nav-page"></a><p class="title"><b>Table 2.2. Most common navigation keys in page-based menus</b></p><div class="table-contents"><table summary="Most common navigation keys in page-based menus" 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 <Return></td><td><code class="literal"><next-line></code></td><td>scroll down one line</td></tr><tr><td><Backspace></td><td><code class="literal"><previous-line></code></td><td>sroll up one line</td></tr><tr><td>K, <Space> or <PageDn></td><td><code class="literal"><next-page></code></td><td>move to the next page</td></tr><tr><td>- or <PageUp></td><td><code class="literal"><previous-page></code></td><td>move the previous page</td></tr><tr><td><Home></td><td><code class="literal"><top></code></td><td>move to the top</td></tr><tr><td><End></td><td><code class="literal"><bottom></code></td><td>move to the bottom</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>4. 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>4.1. Introduction</h3></div></div></div><p>
164
247
Mutt has a built-in line editor for inputting text, e.g. email
165
248
addresses or filenames. The keys used to manipulate text input are
166
very similar to those of Emacs. See <a class="xref" href="#tab-keys-editor" title="Table 2.2. Most common line editor keys">Table 2.2, “Most common line editor keys”</a> for a full
249
very similar to those of Emacs. See <a class="xref" href="#tab-keys-editor" title="Table 2.3. Most common line editor keys">Table 2.3, “Most common line editor keys”</a> for a full
167
250
reference of available functions, their default key bindings, and
168
251
short descriptions.
169
</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>
252
</p><div class="table"><a id="tab-keys-editor"></a><p class="title"><b>Table 2.3. 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>
170
253
You can remap the <span class="emphasis"><em>editor</em></span> functions using the
171
<a class="link" href="#bind" title="5. Changing the default key bindings">bind</a> command. For example, to make
254
<a class="link" href="#bind" title="5. Changing the Default Key Bindings"><span class="command"><strong>bind</strong></span></a> command. For example, to make
172
255
the <Delete> key delete the character in front of
173
256
the cursor rather than under, you could use:
174
257
</p><pre class="screen">
175
258
bind editor <delete> backspace
176
</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>
259
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editing-history"></a>4.2. History</h3></div></div></div><p>
177
260
Mutt maintains a history for the built-in editor. The number of items
178
is controlled by the <a class="link" href="#history" title="3.77. history">$history</a>
261
is controlled by the <a class="link" href="#history" title="3.89. history">$history</a>
179
262
variable and can be made persistent using an external file specified
180
using <a class="link" href="#history-file" title="3.78. history_file">$history_file</a>.
263
using <a class="link" href="#history-file" title="3.90. history_file">$history_file</a>.
181
264
You may cycle through them at an editor prompt by using the
182
265
<code class="literal"><history-up></code> and/or
183
<code class="literal"><history-down></code> commands.
266
<code class="literal"><history-down></code> commands. But notice that Mutt
267
does not remember the currently entered text, it only cycles through
268
history and wraps around at the end or beginning.
185
270
Mutt maintains several distinct history lists, one for each of the
186
271
following categories:
187
</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>
188
Mutt automatically filters out repeated items from the history. It
272
</p><div class="itemizedlist"><ul type="disc"><li><p><code class="literal">.muttrc</code> 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>
273
Mutt automatically filters out consecutively repeated items from the history. It
189
274
also mimics the behavior of some shells by ignoring items starting
190
275
with a space. The latter feature can be useful in macros to not clobber
191
276
the history's valuable entries with unwanted entries.
192
</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>
277
</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>5. Reading Mail</h2></div></div></div><p>
193
278
Similar to many other mail clients, there are two modes in which mail is
194
read in Mutt. The first is the index of messages in the mailbox, which is
195
called the “<span class="quote">index</span>” in Mutt. The second mode is the display of the
279
read in Mutt. The first is a list of messages in the mailbox, which is
280
called the “<span class="quote">index</span>” menu in Mutt. The second mode is the display of the
196
281
message contents. This is called the “<span class="quote">pager.</span>”
198
283
The next few sections describe the functions provided in each of these
200
</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>
285
</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="index-menu"></a>5.1. The Message Index</h3></div></div></div><p>
201
286
Common keys used to navigate through and manage messages in the index
202
are shown in <a class="xref" href="#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
287
are shown in <a class="xref" href="#tab-key-index" title="Table 2.4. Most common message index keys">Table 2.4, “Most common message index keys”</a>. How messages are presented
203
288
in the index menu can be customized using the
204
<a class="link" href="#index-format" title="3.101. index_format">$index_format</a> variable.
205
</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>
289
<a class="link" href="#index-format" title="3.114. index_format">$index_format</a> variable.
290
</p><div class="table"><a id="tab-key-index"></a><p class="title"><b>Table 2.4. 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>
206
291
In addition to who sent the message and the subject, a short summary of
207
292
the disposition of each message is printed beside the message number.
208
Zero or more of the “<span class="quote">flags</span>” in <a class="xref" href="#tab-msg-status-flags" title="Table 2.4. Message status flags">Table 2.4, “Message status flags”</a>
293
Zero or more of the “<span class="quote">flags</span>” in <a class="xref" href="#tab-msg-status-flags" title="Table 2.5. Message status flags">Table 2.5, “Message status flags”</a>
209
294
may appear, some of which can be turned on or off using these functions:
210
295
<code class="literal"><set-flag></code> and
211
296
<code class="literal"><clear-flag></code>
212
297
bound by default to “<span class="quote">w</span>” and “<span class="quote">W</span>” respectively.
214
Furthermore, the flags in <a class="xref" href="#tab-msg-recip-flags" title="Table 2.5. Message recipient flags">Table 2.5, “Message recipient flags”</a> reflect
299
Furthermore, the flags in <a class="xref" href="#tab-msg-recip-flags" title="Table 2.6. Message recipient flags">Table 2.6, “Message recipient flags”</a> reflect
215
300
who the message is addressed to. They can be customized with the
216
<a class="link" href="#to-chars" title="3.290. to_chars">$to_chars</a> variable.
217
</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>
218
By default, Mutt uses its builtin pager to display the contents of messages.
219
The pager is very similar to the Unix program <span class="emphasis"><em>less</em></span> though not nearly as
221
</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>
222
In addition to key bindings in <a class="xref" href="#tab-key-pager" title="Table 2.6. Most common pager keys">Table 2.6, “Most common pager keys”</a>,
301
<a class="link" href="#to-chars" title="3.293. to_chars">$to_chars</a> variable.
302
</p><div class="table"><a id="tab-msg-status-flags"></a><p class="title"><b>Table 2.5. 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.6. 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>5.2. The Pager</h3></div></div></div><p>
303
By default, Mutt uses its builtin pager to display the contents of
304
messages (an external pager such as <code class="literal">less(1)</code> can be
305
configured, see <a class="link" href="#pager" title="3.148. pager">$pager</a> variable).
306
The pager is very similar to the Unix program <code class="literal">less(1)</code>
307
though not nearly as featureful.
308
</p><div class="table"><a id="tab-key-pager"></a><p class="title"><b>Table 2.7. 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>
309
In addition to key bindings in <a class="xref" href="#tab-key-pager" title="Table 2.7. Most common pager keys">Table 2.7, “Most common pager keys”</a>,
223
310
many of the functions from the index menu are also available in
224
311
the pager, such as <code class="literal"><delete-message></code> or <code class="literal"><copy-message></code>
225
312
(this is one advantage over using an external pager to view messages).
385
484
</span></dt><dd><p>
386
485
This function will go to the next line of non-quoted text which comes
387
486
after a line of quoted text in the internal pager.
388
</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>
389
The bindings shown in <a class="xref" href="#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
487
</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>6. 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>6.1. Introduction</h3></div></div></div><p>
488
The bindings shown in <a class="xref" href="#tab-key-send" title="Table 2.11. Most common mail sending keys">Table 2.11, “Most common mail sending keys”</a> are available in the
390
489
<span class="emphasis"><em>index</em></span> and <span class="emphasis"><em>pager</em></span> to start a new message.
391
</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>
490
</p><div class="table"><a id="tab-key-send"></a><p class="title"><b>Table 2.11. 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>
392
491
<span class="emphasis"><em>Bouncing</em></span> a message sends the message as-is to the recipient you
393
492
specify. <span class="emphasis"><em>Forwarding</em></span> a message allows you to add comments or
394
493
modify the message you are forwarding. These items are discussed
395
in greater detail in the next chapter “<span class="quote"><a class="link" href="#forwarding-mail" title="6. Forwarding and Bouncing Mail">Forwarding
494
in greater detail in the next section “<span class="quote"><a class="link" href="#forwarding-mail" title="7. Forwarding and Bouncing Mail">Forwarding
396
495
and Bouncing Mail</a>.</span>”
398
497
Mutt will then enter the <span class="emphasis"><em>compose</em></span> menu and prompt you for the
399
recipients to place on the “<span class="quote">To:</span>” header field. Next, it will ask
498
recipients to place on the “<span class="quote">To:</span>” header field when you hit <code class="literal">m</code> to start a new message. Next, it will ask
400
499
you for the “<span class="quote">Subject:</span>” field for the message, providing a default if
401
you are replying to or forwarding a message. See also
500
you are replying to or forwarding a message. You again
501
have the chance to adjust recipients, subject, and security settings
502
right before actually sending the message. See also
402
503
<a class="link" href="#askcc" title="3.10. askcc">$askcc</a>,
403
504
<a class="link" href="#askbcc" title="3.9. askbcc">$askbcc</a>,
404
<a class="link" href="#autoedit" title="3.17. autoedit">$autoedit</a>,
505
<a class="link" href="#autoedit" title="3.18. autoedit">$autoedit</a>,
405
506
<a class="link" href="#bounce" title="3.21. bounce">$bounce</a>,
406
<a class="link" href="#fast-reply" title="3.55. fast_reply">$fast_reply</a>,
407
and <a class="link" href="#include" title="3.98. include">$include</a>
408
for changing how Mutt asks these questions.
507
<a class="link" href="#fast-reply" title="3.63. fast_reply">$fast_reply</a>,
508
and <a class="link" href="#include" title="3.111. include">$include</a>
509
for changing how and if Mutt asks these questions.
410
Mutt will then automatically start your <a class="link" href="#editor" title="3.51. editor">$editor</a>
411
on the message body. If the <a class="link" href="#edit-headers" title="3.50. edit_headers">$edit_headers</a>
412
variable is set, the headers will be at the top of the message in your editor.
413
Any messages you are replying to will be added in sort order to the message,
511
When replying, Mutt fills these fields with proper values depending on
512
the reply type. The types of replying supported are:
513
</p><div class="variablelist"><dl><dt><span class="term">Simple reply</span></dt><dd><p>
514
Reply to the author directly.
515
</p></dd><dt><span class="term">Group reply</span></dt><dd><p>
516
Reply to the author as well to all recipients except you; this consults
517
<a class="link" href="#alternates" title="11. Alternative Addresses"><span class="command"><strong>alternates</strong></span></a>.
518
</p></dd><dt><span class="term">List reply</span></dt><dd><p>
519
Reply to all mailing list addresses found, either specified via
520
configuration or auto-detected. See <a class="xref" href="#lists" title="12. Mailing Lists">Section 12, “Mailing Lists”</a> for
522
</p></dd></dl></div><p>
523
After getting recipients for new messages, forwards or replies, Mutt
524
will then automatically start your <a class="link" href="#editor" title="3.58. editor">$editor</a> on the message body. If the <a class="link" href="#edit-headers" title="3.57. edit_headers">$edit_headers</a> variable is
525
set, the headers will be at the top of the message in your editor. Any
526
messages you are replying to will be added in sort order to the message,
414
527
with appropriate <a class="link" href="#attribution" title="3.16. attribution">$attribution</a>,
415
<a class="link" href="#indent-string" title="3.100. indent_string">$indent_string</a> and
416
<a class="link" href="#post-indent-string" title="3.223. post_indent_string">$post_indent_string</a>.
417
When forwarding a message, if the <a class="link" href="#mime-forward" title="3.127. mime_forward">$mime_forward</a>
418
variable is unset, a copy of the forwarded message will be included. If
419
you have specified a <a class="link" href="#signature" title="3.263. signature">$signature</a>, it
420
will be appended to the message.
528
<a class="link" href="#indent-string" title="3.113. indent_string">$indent_string</a> and
529
<a class="link" href="#post-indent-string" title="3.194. post_indent_string">$post_indent_string</a>.
530
When forwarding a message, if the <a class="link" href="#mime-forward" title="3.140. mime_forward">$mime_forward</a> variable is
531
unset, a copy of the forwarded message will be included. If you have
532
specified a <a class="link" href="#signature" title="3.235. signature">$signature</a>, it will
533
be appended to the message.
422
535
Once you have finished editing the body of your mail message, you are
423
536
returned to the <span class="emphasis"><em>compose</em></span> menu providing the functions
424
shown in <a class="xref" href="#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
537
shown in <a class="xref" href="#tab-func-compose" title="Table 2.12. Most common compose menu keys">Table 2.12, “Most common compose menu keys”</a> to modify, send or postpone the
426
</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>
539
</p><div class="table"><a id="tab-func-compose"></a><p class="title"><b>Table 2.12. 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>
427
540
The compose menu is also used to edit the attachments for a message which can be either files
428
541
or other messages. The <code class="literal"><attach-message></code> function to will prompt you for a folder to
429
542
attach messages from. You can now tag messages in that folder and they
1518
1620
key with a given e-mail address automatically, either because the
1519
1621
recipient's public key can't be deduced from the destination address,
1520
1622
or because, for some reasons, you need to override the key Mutt would
1521
normally use. The <code class="literal">crypt-hook</code> command provides a
1623
normally use. The <span class="command"><strong>crypt-hook</strong></span> command provides a
1522
1624
method by which you can specify the ID of the public key to be used
1523
1625
when encrypting messages to a certain recipient.
1525
1627
The meaning of <span class="emphasis"><em>keyid</em></span> is to be taken broadly in this context: You
1526
1628
can either put a numerical key ID here, an e-mail address, or even
1527
1629
just a real name.
1528
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="push"></a>22. Adding key sequences to the keyboard buffer</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">push</code>
1630
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="push"></a>22. Adding Key Sequences to the Keyboard Buffer</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">push</code>
1529
1631
<em class="replaceable"><code>string</code></em>
1531
1633
This command adds the named string to the keyboard buffer. The string may
1532
1634
contain control characters, key names and function names like the sequence
1533
string in the <a class="link" href="#macro" title="8. Keyboard macros">macro</a> command. You may use it to
1635
string in the <a class="link" href="#macro" title="8. Keyboard Macros">macro</a> command. You may use it to
1534
1636
automatically run a sequence of commands at startup, or when entering
1535
certain folders. For example, the following command will automatically
1536
collapse all threads when entering a folder:
1537
</p><div class="example"><a id="ex-folder-hook-push"></a><p class="title"><b>Example 3.12. Embedding <code class="literal">push</code> in <code class="literal">folder-hook</code></b></p><div class="example-contents"><pre class="screen">
1637
certain folders. For example, <a class="xref" href="#ex-folder-hook-push" title="Example 3.13. Embedding push in folder-hook">Example 3.13, “Embedding push in folder-hook”</a>
1638
shows how to automatically collapse all threads when entering a folder.
1639
</p><div class="example"><a id="ex-folder-hook-push"></a><p class="title"><b>Example 3.13. Embedding <span class="command">push</span> in <span class="command">folder-hook</span></b></p><div class="example-contents"><pre class="screen">
1538
1640
folder-hook . 'push <collapse-all>'
1539
</pre></div></div><br class="example-break" /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exec"></a>23. Executing functions</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">exec</code>
1641
</pre></div></div><br class="example-break" /></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exec"></a>23. Executing Functions</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">exec</code>
1540
1642
<em class="replaceable"><code>function</code></em>
1542
1644
<em class="replaceable"><code>function</code></em>
1543
1645
...]</p></div><p>
1544
1646
This command can be used to execute any function. Functions are
1545
1647
listed in the <a class="link" href="#functions" title="4. Functions">function reference</a>.
1546
“<span class="quote">exec function</span>” is equivalent to “<span class="quote">push <function></span>”.
1648
“<span class="quote"><span class="command"><strong>exec</strong></span><code class="literal">function</code></span>” is equivalent to
1649
“<span class="quote"><code class="literal">push <function></code></span>”.
1547
1650
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="score-command"></a>24. Message Scoring</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">score</code>
1548
1651
<em class="replaceable"><code>pattern</code></em>
1550
1653
<em class="replaceable"><code>value</code></em>
1551
</p></div><div class="cmdsynopsis"><p><code class="command">unscore</code> {
1654
<br /><code class="command">unscore</code> {
1552
1655
<em class="replaceable"><code>*</code></em>
1554
1657
<em class="replaceable"><code>pattern</code></em>
1555
1658
... }</p></div><p>
1556
The <code class="literal">score</code> commands adds <span class="emphasis"><em>value</em></span> to a message's score if <span class="emphasis"><em>pattern</em></span>
1659
The <span class="command"><strong>score</strong></span> commands adds <span class="emphasis"><em>value</em></span> to a message's score if <span class="emphasis"><em>pattern</em></span>
1557
1660
matches it. <span class="emphasis"><em>pattern</em></span> is a string in the format described in the <a class="link" href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a> section (note: For efficiency reasons, patterns
1558
1661
which scan information not available in the index, such as <code class="literal">˜b</code>,
1559
1662
<code class="literal">˜B</code> or <code class="literal">˜h</code>, may not be used). <span class="emphasis"><em>value</em></span> is a
1560
1663
positive or negative integer. A message's final score is the sum total of all
1561
matching <code class="literal">score</code> entries. However, you may optionally prefix <span class="emphasis"><em>value</em></span> with
1562
an equal sign (=) to cause evaluation to stop at a particular entry if there is
1664
matching <span class="command"><strong>score</strong></span> entries. However, you may optionally prefix <span class="emphasis"><em>value</em></span> with
1665
an equal sign (“<span class="quote">=</span>”) to cause evaluation to stop at a particular entry if there is
1563
1666
a match. Negative final scores are rounded up to 0.
1565
The <code class="literal">unscore</code> command removes score entries from the list. You <span class="bold"><strong>must</strong></span>
1566
specify the same pattern specified in the <code class="literal">score</code> command for it to be
1668
The <span class="command"><strong>unscore</strong></span> command removes score entries from the list. You <span class="emphasis"><em>must</em></span>
1669
specify the same pattern specified in the <span class="command"><strong>score</strong></span> command for it to be
1567
1670
removed. The pattern “<span class="quote">*</span>” is a special token which means to clear the list
1568
1671
of all score entries.
1569
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="spam"></a>25. Spam detection</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">spam</code>
1672
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="spam"></a>25. Spam Detection</h2></div></div></div><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">spam</code>
1570
1673
<em class="replaceable"><code>pattern</code></em>
1572
1675
<em class="replaceable"><code>format</code></em>
1573
</p></div><div class="cmdsynopsis"><p><code class="command">nospam</code> {
1676
<br /><code class="command">nospam</code> {
1574
1677
<em class="replaceable"><code>*</code></em>
1576
1679
<em class="replaceable"><code>pattern</code></em>
1578
1681
Mutt has generalized support for external spam-scoring filters.
1579
By defining your spam patterns with the <code class="literal">spam</code> and <code class="literal">nospam</code>
1682
By defining your spam patterns with the <span class="command"><strong>spam</strong></span> and <code class="literal">nospam</code>
1580
1683
commands, you can <span class="emphasis"><em>limit</em></span>, <span class="emphasis"><em>search</em></span>, and <span class="emphasis"><em>sort</em></span> your
1581
1684
mail based on its spam attributes, as determined by the external
1582
1685
filter. You also can display the spam attributes in your index
1583
display using the <code class="literal">%H</code> selector in the <a class="link" href="#index-format" title="3.101. index_format">$index_format</a> variable. (Tip: try <code class="literal">%?H?[%H] ?</code>
1686
display using the <code class="literal">%H</code> selector in the <a class="link" href="#index-format" title="3.114. index_format">$index_format</a> variable. (Tip: try <code class="literal">%?H?[%H] ?</code>
1584
1687
to display spam tags only when they are defined for a given message.)
1586
1689
Your first step is to define your external filter's spam patterns using
1587
the <code class="literal">spam</code> command. <span class="emphasis"><em>pattern</em></span> should be a regular expression
1690
the <span class="command"><strong>spam</strong></span> command. <span class="emphasis"><em>pattern</em></span> should be a regular expression
1588
1691
that matches a header in a mail message. If any message in the mailbox
1589
1692
matches this regular expression, it will receive a “<span class="quote">spam tag</span>” or
1590
“<span class="quote">spam attribute</span>” (unless it also matches a <code class="literal">nospam</code> pattern -- see
1693
“<span class="quote">spam attribute</span>” (unless it also matches a <span class="command"><strong>nospam</strong></span> pattern — see
1591
1694
below.) The appearance of this attribute is entirely up to you, and is
1592
1695
governed by the <span class="emphasis"><em>format</em></span> parameter. <span class="emphasis"><em>format</em></span> can be any static
1593
1696
text, but it also can include back-references from the <span class="emphasis"><em>pattern</em></span>
1595
1698
sub-expression contained within parentheses.) <code class="literal">%1</code> is replaced with
1596
1699
the first back-reference in the regex, <code class="literal">%2</code> with the second, etc.
1701
To match spam tags, mutt needs the corresponding header information
1702
which is always the case for local and POP folders but not for IMAP in
1703
the default configuration. Depending on the spam header to be analyzed,
1704
<a class="link" href="#imap-headers" title="3.99. imap_headers">$imap_headers</a> may need
1598
1707
If you're using multiple spam filters, a message can have more than
1599
one spam-related header. You can define <code class="literal">spam</code> patterns for each
1708
one spam-related header. You can define <span class="command"><strong>spam</strong></span> patterns for each
1600
1709
filter you use. If a message matches two or more of these patterns, and
1601
the $spam_separator variable is set to a string, then the
1710
the <a class="link" href="#spam-separator" title="3.268. spam_separator">$spam_separator</a> variable is set to a string, then the
1602
1711
message's spam tag will consist of all the <span class="emphasis"><em>format</em></span> strings joined
1603
together, with the value of $spam_separator separating
1712
together, with the value of <a class="link" href="#spam-separator" title="3.268. spam_separator">$spam_separator</a> separating
1606
For example, suppose I use DCC, SpamAssassin, and PureMessage. I might
1607
define these spam settings:
1608
</p><div class="example"><a id="ex-spam"></a><p class="title"><b>Example 3.13. Configuring spam detection</b></p><div class="example-contents"><pre class="screen">
1715
For example, suppose one uses DCC, SpamAssassin, and PureMessage, then
1716
the configuration might look like in <a class="xref" href="#ex-spam" title="Example 3.14. Configuring spam detection">Example 3.14, “Configuring spam detection”</a>.
1717
</p><div class="example"><a id="ex-spam"></a><p class="title"><b>Example 3.14. Configuring spam detection</b></p><div class="example-contents"><pre class="screen">
1609
1718
spam "X-DCC-.*-Metrics:.*(....)=many" "90+/DCC-%1"
1610
1719
spam "X-Spam-Status: Yes" "90+/SA"
1611
1720
spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM"
1612
1721
set spam_separator=", "
1613
1722
</pre></div></div><br class="example-break" /><p>
1614
If I then received a message that DCC registered with “<span class="quote">many</span>” hits
1723
If then a message is received that DCC registered with “<span class="quote">many</span>” hits
1615
1724
under the “<span class="quote">Fuz2</span>” checksum, and that PureMessage registered with a
1616
1725
97% probability of being spam, that message's spam tag would read
1617
1726
<code class="literal">90+/DCC-Fuz2, 97/PM</code>. (The four characters before “<span class="quote">=many</span>” in a
1618
DCC report indicate the checksum used -- in this case, “<span class="quote">Fuz2</span>”.)
1727
DCC report indicate the checksum used — in this case, “<span class="quote">Fuz2</span>”.)
1620
If the $spam_separator variable is unset, then each
1729
If the <a class="link" href="#spam-separator" title="3.268. spam_separator">$spam_separator</a> variable is unset, then each
1621
1730
spam pattern match supersedes the previous one. Instead of getting
1622
1731
joined <span class="emphasis"><em>format</em></span> strings, you'll get only the last one to match.
1624
1733
The spam tag is what will be displayed in the index when you use
1625
<code class="literal">%H</code> in the <code class="literal">$index_format</code> variable. It's also the
1734
<code class="literal">%H</code> in the <a class="link" href="#index-format" title="3.114. index_format">$index_format</a> variable. It's also the
1626
1735
string that the <code class="literal">˜H</code> pattern-matching expression matches against for
1627
1736
<code class="literal"><search></code> and <code class="literal"><limit></code> functions. And it's what sorting by spam
1628
1737
attribute will use as a sort key.
1630
1739
That's a pretty complicated example, and most people's actual
1631
1740
environments will have only one spam filter. The simpler your
1632
configuration, the more effective mutt can be, especially when it comes
1741
configuration, the more effective Mutt can be, especially when it comes
1635
Generally, when you sort by spam tag, mutt will sort <span class="emphasis"><em>lexically</em></span> --
1744
Generally, when you sort by spam tag, Mutt will sort <span class="emphasis"><em>lexically</em></span> —
1636
1745
that is, by ordering strings alphanumerically. However, if a spam tag
1637
begins with a number, mutt will sort numerically first, and lexically
1746
begins with a number, Mutt will sort numerically first, and lexically
1638
1747
only when two numbers are equal in value. (This is like UNIX's
1639
<code class="literal">sort -n</code>.) A message with no spam attributes at all -- that is, one
1640
that didn't match <span class="emphasis"><em>any</em></span> of your <code class="literal">spam</code> patterns -- is sorted at
1748
<code class="literal">sort -n</code>.) A message with no spam attributes at all — that is, one
1749
that didn't match <span class="emphasis"><em>any</em></span> of your <span class="command"><strong>spam</strong></span> patterns — is sorted at
1641
1750
lowest priority. Numbers are sorted next, beginning with 0 and ranging
1642
1751
upward. Finally, non-numeric strings are sorted, with “<span class="quote">a</span>” taking lower
1643
1752
priority than “<span class="quote">z</span>”. Clearly, in general, sorting by spam tags is most
1644
1753
effective when you can coerce your filter to give you a raw number. But
1645
in case you can't, mutt can still do something useful.
1754
in case you can't, Mutt can still do something useful.
1647
The <code class="literal">nospam</code> command can be used to write exceptions to <code class="literal">spam</code>
1648
patterns. If a header pattern matches something in a <code class="literal">spam</code> command,
1756
The <span class="command"><strong>nospam</strong></span> command can be used to write exceptions to <span class="command"><strong>spam</strong></span>
1757
patterns. If a header pattern matches something in a <span class="command"><strong>spam</strong></span> command,
1649
1758
but you nonetheless do not want it to receive a spam tag, you can list a
1650
more precise pattern under a <code class="literal">nospam</code> command.
1759
more precise pattern under a <span class="command"><strong>nospam</strong></span> command.
1652
If the <span class="emphasis"><em>pattern</em></span> given to <code class="literal">nospam</code> is exactly the same as the
1653
<span class="emphasis"><em>pattern</em></span> on an existing <code class="literal">spam</code> list entry, the effect will be to
1761
If the <span class="emphasis"><em>pattern</em></span> given to <span class="command"><strong>nospam</strong></span> is exactly the same as the
1762
<span class="emphasis"><em>pattern</em></span> on an existing <span class="command"><strong>spam</strong></span> list entry, the effect will be to
1654
1763
remove the entry from the spam list, instead of adding an exception.
1655
Likewise, if the <span class="emphasis"><em>pattern</em></span> for a <code class="literal">spam</code> command matches an entry
1656
on the <code class="literal">nospam</code> list, that <code class="literal">nospam</code> entry will be removed. If the
1657
<span class="emphasis"><em>pattern</em></span> for <code class="literal">nospam</code> is “<span class="quote">*</span>”, <span class="emphasis"><em>all entries on both lists</em></span>
1658
will be removed. This might be the default action if you use <code class="literal">spam</code>
1659
and <code class="literal">nospam</code> in conjunction with a <code class="literal">folder-hook</code>.
1764
Likewise, if the <span class="emphasis"><em>pattern</em></span> for a <span class="command"><strong>spam</strong></span> command matches an entry
1765
on the <span class="command"><strong>nospam</strong></span> list, that nospam entry will be removed. If the
1766
<span class="emphasis"><em>pattern</em></span> for <span class="command"><strong>nospam</strong></span> is “<span class="quote">*</span>”, <span class="emphasis"><em>all entries on both lists</em></span>
1767
will be removed. This might be the default action if you use <span class="command"><strong>spam</strong></span>
1768
and <span class="command"><strong>nospam</strong></span> in conjunction with a <span class="command"><strong>folder-hook</strong></span>.
1661
You can have as many <code class="literal">spam</code> or <code class="literal">nospam</code> commands as you like.
1662
You can even do your own primitive spam detection within mutt -- for
1770
You can have as many <span class="command"><strong>spam</strong></span> or <span class="command"><strong>nospam</strong></span> commands as you like.
1771
You can even do your own primitive <span class="command"><strong>spam</strong></span> detection within Mutt — for
1663
1772
example, if you consider all mail from <code class="literal">MAILER-DAEMON</code> to be spam,
1664
you can use a <code class="literal">spam</code> command like this:
1773
you can use a <span class="command"><strong>spam</strong></span> command like this:
1665
1774
</p><pre class="screen">
1666
1775
spam "^From: .*MAILER-DAEMON" "999"
1667
</pre></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="set"></a>26. Setting and Querying Variables</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="set-commands"></a>26.1. Commands</h3></div></div></div><p>
1776
</pre></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="set"></a>26. Setting and Querying Variables</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="var-types"></a>26.1. Variable Types</h3></div></div></div><p>
1777
Mutt supports these types of configuration variables:
1778
</p><div class="variablelist"><dl><dt><span class="term">boolean</span></dt><dd><p>
1779
A boolean expression, either “<span class="quote">yes</span>” or “<span class="quote">no</span>”.
1780
</p></dd><dt><span class="term">number</span></dt><dd><p>
1781
A signed integer number in the range -32768 to 32767.
1782
</p></dd><dt><span class="term">string</span></dt><dd><p>
1784
</p></dd><dt><span class="term">path</span></dt><dd><p>
1785
A specialized string for representing paths including support for
1786
mailbox shortcuts (see <a class="xref" href="#shortcuts" title="7. Mailbox Shortcuts">Section 7, “Mailbox Shortcuts”</a>) as well as tilde
1787
(“<span class="quote">˜</span>”) for a user's home directory and more.
1788
</p></dd><dt><span class="term">quadoption</span></dt><dd><p>
1789
Like a boolean but triggers a prompt when set to “<span class="quote">ask-yes</span>”
1790
or “<span class="quote">ask-no</span>” with “<span class="quote">yes</span>” and “<span class="quote">no</span>”
1791
preselected respectively.
1792
</p></dd><dt><span class="term">sort order</span></dt><dd><p>
1793
A specialized string allowing only particular words as values depending
1795
</p></dd><dt><span class="term">regular expression</span></dt><dd><p>
1796
A regular expression, see <a class="xref" href="#regexp" title="1. Regular Expressions">Section 1, “Regular Expressions”</a> for an introduction.
1797
</p></dd><dt><span class="term">folder magic</span></dt><dd><p>
1798
Specifies the type of folder to use: <span class="emphasis"><em>mbox</em></span>,
1799
<span class="emphasis"><em>mmdf</em></span>, <span class="emphasis"><em>mh</em></span>
1800
or <span class="emphasis"><em>maildir</em></span>.
1801
Currently only used to determine the type for newly created folders.
1802
</p></dd><dt><span class="term">e-mail address</span></dt><dd><p>
1803
An e-mail address either with or without
1804
realname. The older “<span class="quote"><code class="literal">user@example.org (Joe User)</code></span>”
1805
form is supported but strongly deprecated.
1806
</p></dd><dt><span class="term">user-defined</span></dt><dd><p>
1807
Arbitrary text, see <a class="xref" href="#set-myvar" title="26.3. User-Defined Variables">Section 26.3, “User-Defined Variables”</a> for details.
1808
</p></dd></dl></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="set-commands"></a>26.2. Commands</h3></div></div></div><p>
1668
1809
The following commands are available to manipulate and query variables:
1669
1810
</p><p>Usage:</p><div class="cmdsynopsis"><p><code class="command">set</code> {
1670
1811
[ <code class="option">no</code> | <code class="option">inv</code> ]
1671
1812
<em class="replaceable"><code>variable</code></em>
1673
1814
<em class="replaceable"><code>variable=value</code></em>
1674
} [...]</p></div><div class="cmdsynopsis"><p><code class="command">toggle</code>
1675
<em class="replaceable"><code>variable</code></em>
1677
<em class="replaceable"><code>variable</code></em>
1678
...]</p></div><div class="cmdsynopsis"><p><code class="command">unset</code>
1679
<em class="replaceable"><code>variable</code></em>
1681
<em class="replaceable"><code>variable</code></em>
1682
...]</p></div><div class="cmdsynopsis"><p><code class="command">reset</code>
1815
} [...]<br /><code class="command">toggle</code>
1816
<em class="replaceable"><code>variable</code></em>
1818
<em class="replaceable"><code>variable</code></em>
1819
...]<br /><code class="command">unset</code>
1820
<em class="replaceable"><code>variable</code></em>
1822
<em class="replaceable"><code>variable</code></em>
1823
...]<br /><code class="command">reset</code>
1683
1824
<em class="replaceable"><code>variable</code></em>
1685
1826
<em class="replaceable"><code>variable</code></em>
1686
1827
...]</p></div><p>
1687
This command is used to set (and unset) <a class="link" href="#variables" title="3. Configuration variables">configuration variables</a>. There are four basic types of variables:
1828
This command is used to set (and unset) <a class="link" href="#variables" title="3. Configuration Variables">configuration variables</a>. There are four basic types of variables:
1688
1829
boolean, number, string and quadoption. <span class="emphasis"><em>boolean</em></span> variables can be
1689
1830
<span class="emphasis"><em>set</em></span> (true) or <span class="emphasis"><em>unset</em></span> (false). <span class="emphasis"><em>number</em></span> variables can be
1690
1831
assigned a positive integer value.
1808
1949
This command permits you to flush hooks you have previously defined.
1809
1950
You can either remove all hooks by giving the “<span class="quote">*</span>” character as an
1810
1951
argument, or you can remove all hooks of a specific type by saying
1811
something like <code class="literal">unhook send-hook</code>.
1952
something like <code class="literal"><span class="command"><strong>unhook</strong></span> send-hook</code>.
1812
1953
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="formatstrings"></a>29. Format Strings</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="formatstrings-basics"></a>29.1. Basic usage</h3></div></div></div><p>
1813
1954
Format strings are a general concept you'll find in several locations
1814
through the mutt configuration, especially in the
1815
<a class="link" href="#index-format" title="3.101. index_format">$index_format</a>,
1816
<a class="link" href="#pager-format" title="3.140. pager_format">$pager_format</a>,
1817
<a class="link" href="#status-format" title="3.279. status_format">$status_format</a>,
1818
and other “<span class="quote">*_format</span>” variables. These can be very straightforward,
1955
through the Mutt configuration, especially in the
1956
<a class="link" href="#index-format" title="3.114. index_format">$index_format</a>,
1957
<a class="link" href="#pager-format" title="3.150. pager_format">$pager_format</a>,
1958
<a class="link" href="#status-format" title="3.282. status_format">$status_format</a>,
1959
and other related variables. These can be very straightforward,
1819
1960
and it's quite possible you already know how to use them.
1821
1962
The most basic format string element is a percent symbol followed
1822
1963
by another character. For example, <code class="literal">%s</code>
1823
represents a message's Subject: header in the <a class="link" href="#index-format" title="3.101. index_format">$index_format</a> variable. The
1964
represents a message's Subject: header in the <a class="link" href="#index-format" title="3.114. index_format">$index_format</a> variable. The
1824
1965
“<span class="quote">expandos</span>” available are documented with each format variable, but
1825
1966
there are general modifiers available with all formatting expandos,
1826
1967
too. Those are our concern here.
1828
1969
Some of the modifiers are borrowed right out of C (though you might
1829
1970
know them from Perl, Python, shell, or another language). These are
1830
the [-]m.n modifiers, as in <code class="literal">%-12.12s</code>. As with
1971
the <code class="literal">[-]m.n</code> modifiers, as in <code class="literal">%-12.12s</code>. As with
1831
1972
such programming languages, these modifiers allow you to specify the
1832
1973
minimum and maximum size of the resulting string, as well as its
1833
1974
justification. If the “<span class="quote">-</span>” sign follows the percent, the string will
1834
1975
be left-justified instead of right-justified. If there's a number
1835
1976
immediately following that, it's the minimum amount of space the
1836
formatted string will occupy -- if it's naturally smaller than that, it
1977
formatted string will occupy — if it's naturally smaller than that, it
1837
1978
will be padded out with spaces. If a decimal point and another number
1838
follow, that's the maximum space allowable -- the string will not be
1979
follow, that's the maximum space allowable — the string will not be
1839
1980
permitted to exceed that width, no matter its natural size. Each of
1840
1981
these three elements is optional, so that all these are legal format
1842
<code class="literal">%-12s</code>
1843
<code class="literal">%4c</code>
1844
<code class="literal">%.15F</code>
1845
<code class="literal">%-12.15L</code>
1982
strings: <code class="literal">%-12s</code>, <code class="literal">%4c</code>,
1983
<code class="literal">%.15F</code> and <code class="literal">%-12.15L</code>.
1847
1985
Mutt adds some other modifiers to format strings. If you use an equals
1848
1986
symbol (<code class="literal">=</code>) as a numeric prefix (like the minus
1849
1987
above), it will force the string to be centered within its minimum
1850
1988
space range. For example, <code class="literal">%=14y</code> will reserve 14
1851
characters for the %y expansion -- that's the X-Label: header, in
1852
<code class="literal">$index_format</code>. If the expansion
1989
characters for the %y expansion — that's the X-Label: header, in
1990
<a class="link" href="#index-format" title="3.114. index_format">$index_format</a>. If the expansion
1853
1991
results in a string less than 14 characters, it will be centered in a
1854
14-character space. If the X-Label for a message were "test", that
1855
expansion would look like “<span class="quote"> test </span>”.
1992
14-character space. If the X-Label for a message were “<span class="quote">test</span>”, that
1993
expansion would look like “<span class="quote"> test </span>”.
1857
1995
There are two very little-known modifiers that affect the way that an
1858
1996
expando is replaced. If there is an underline (“<span class="quote">_</span>”) character
1859
1997
between any format modifiers (as above) and the expando letter, it will
1860
1998
expands in all lower case. And if you use a colon (“<span class="quote">:</span>”), it will
1861
1999
replace all decimal points with underlines.
1862
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="formatstrings-filters"></a>29.2. Filters</h3></div></div></div><p>
2000
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="formatstrings-conditionals"></a>29.2. Conditionals</h3></div></div></div><p>
2001
Depending on the format string variable, some of its sequences can be
2002
used to optionally print a string if their value is nonzero. For
2003
example, you may only want to see the number of flagged messages if such
2004
messages exist, since zero is not particularly meaningful. To optionally
2005
print a string based upon one of the above sequences, the following
2007
</p><pre class="screen">
2008
%?<sequence_char>?<optional_string>?</pre><p>
2009
where <span class="emphasis"><em>sequence_char</em></span> is an expando, and
2010
<span class="emphasis"><em>optional_string</em></span> is the string you would like printed if
2011
<span class="emphasis"><em>sequence_char</em></span> is nonzero.
2012
<span class="emphasis"><em>optional_string</em></span> may contain other
2013
sequences as well as normal text, but you may not nest optional
2016
Here is an example illustrating how to optionally print the number of
2017
new messages in a mailbox in
2018
<a class="link" href="#status-format" title="3.282. status_format">$status_format</a>:
2019
</p><pre class="screen">
2020
%?n?%n new messages.?</pre><p>
2021
You can also switch between two strings using the following construct:
2022
</p><pre class="screen">
2023
%?<sequence_char>?<if_string>&<else_string>?</pre><p>
2024
If the value of <span class="emphasis"><em>sequence_char</em></span> is
2025
non-zero, <span class="emphasis"><em>if_string</em></span> will be expanded,
2026
otherwise <span class="emphasis"><em>else_string</em></span> will be expanded.
2027
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="formatstrings-filters"></a>29.3. Filters</h3></div></div></div><p>
1863
2028
Any format string ending in a vertical bar (“<span class="quote">|</span>”) will be
1864
2029
expanded and piped through the first word in the string, using spaces
1865
2030
as separator. The string returned will be used for display.
1975
2173
precedence over alternation. A whole subexpression may be enclosed in
1976
2174
parentheses to override these precedence rules.
1977
2175
</p><div class="note"><h3 class="title">Note</h3><p>
1978
If you compile Mutt with the GNU <span class="emphasis"><em>rx</em></span> package, the
2176
If you compile Mutt with the included regular expression engine, the
1979
2177
following operators may also be used in regular expressions as described in <a class="xref" href="#regex-gnu-ext" title="Table 4.3. GNU regular expression extensions">Table 4.3, “GNU regular expression extensions”</a>.
1980
2178
</p></div><div class="table"><a id="regex-gnu-ext"></a><p class="title"><b>Table 4.3. GNU regular expression extensions</b></p><div class="table-contents"><table summary="GNU regular expression extensions" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Expression</th><th>Description</th></tr></thead><tbody><tr><td>\\y</td><td>Matches the empty string at either the beginning or the end of a word</td></tr><tr><td>\\B</td><td>Matches the empty string within a word</td></tr><tr><td>\\<</td><td>Matches the empty string at the beginning of a word</td></tr><tr><td>\\></td><td>Matches the empty string at the end of a word</td></tr><tr><td>\\w</td><td>Matches any word-constituent character (letter, digit, or underscore)</td></tr><tr><td>\\W</td><td>Matches any character that is not word-constituent</td></tr><tr><td>\\`</td><td>Matches the empty string at the beginning of a buffer (string)</td></tr><tr><td>\\'</td><td>Matches the empty string at the end of a buffer</td></tr></tbody></table></div></div><br class="table-break" /><p>
1981
2179
Please note however that these operators are not defined by POSIX, so
1982
2180
they may or may not be available in stock libraries on various systems.
1983
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="patterns"></a>2. Patterns: Searching, Limiting and Tagging</h2></div></div></div><p>
2181
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="patterns"></a>2. Patterns: Searching, Limiting and Tagging</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="patterns-modifier"></a>2.1. Pattern Modifier</h3></div></div></div><p>
1984
2182
Many of Mutt's commands allow you to specify a pattern to match
1985
2183
(<code class="literal">limit</code>, <code class="literal">tag-pattern</code>,
1986
2184
<code class="literal">delete-pattern</code>, etc.). <a class="xref" href="#tab-patterns" title="Table 4.4. Pattern modifiers">Table 4.4, “Pattern modifiers”</a>
1987
2185
shows several ways to select messages.
1988
</p><div class="table"><a id="tab-patterns"></a><p class="title"><b>Table 4.4. Pattern modifiers</b></p><div class="table-contents"><table summary="Pattern modifiers" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Pattern modifier</th><th>Description</th></tr></thead><tbody><tr><td>~A</td><td>all messages</td></tr><tr><td>~b <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the message body</td></tr><tr><td>=b <span class="emphasis"><em>STRING</em></span></td><td>messages which contain <span class="emphasis"><em>STRING</em></span> in the message body. If IMAP is enabled, searches for <span class="emphasis"><em>STRING</em></span> on the server, rather than downloading each message and searching it locally.</td></tr><tr><td>~B <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the whole message</td></tr><tr><td>~c <span class="emphasis"><em>EXPR</em></span></td><td>messages carbon-copied to <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%c <span class="emphasis"><em>GROUP</em></span></td><td>messages carbon-copied to any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~C <span class="emphasis"><em>EXPR</em></span></td><td>messages either to: or cc: <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%C <span class="emphasis"><em>GROUP</em></span></td><td>messages either to: or cc: to any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~d [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with “<span class="quote">date-sent</span>” in a Date range</td></tr><tr><td>~D</td><td>deleted messages</td></tr><tr><td>~e <span class="emphasis"><em>EXPR</em></span></td><td>messages which contains <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">Sender</span>” field</td></tr><tr><td>%e <span class="emphasis"><em>GROUP</em></span></td><td>messages which contain a member of <span class="emphasis"><em>GROUP</em></span> in the “<span class="quote">Sender</span>” field</td></tr><tr><td>~E</td><td>expired messages</td></tr><tr><td>~F</td><td>flagged messages</td></tr><tr><td>~f <span class="emphasis"><em>EXPR</em></span></td><td>messages originating from <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%f <span class="emphasis"><em>GROUP</em></span></td><td>messages originating from any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~g</td><td>cryptographically signed messages</td></tr><tr><td>~G</td><td>cryptographically encrypted messages</td></tr><tr><td>~h <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the message header</td></tr><tr><td>~H <span class="emphasis"><em>EXPR</em></span></td><td>messages with a spam attribute matching <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>~i <span class="emphasis"><em>EXPR</em></span></td><td>messages which match <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">Message-ID</span>” field</td></tr><tr><td>~k</td><td>messages which contain PGP key material</td></tr><tr><td>~L <span class="emphasis"><em>EXPR</em></span></td><td>messages either originated or received by <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%L <span class="emphasis"><em>GROUP</em></span></td><td>message either originated or received by any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~l</td><td>messages addressed to a known mailing list</td></tr><tr><td>~m [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages in the range <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> *)</td></tr><tr><td>~n [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with a score in the range <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> *)</td></tr><tr><td>~N</td><td>new messages</td></tr><tr><td>~O</td><td>old messages</td></tr><tr><td>~p</td><td>messages addressed to you (consults alternates)</td></tr><tr><td>~P</td><td>messages from you (consults alternates)</td></tr><tr><td>~Q</td><td>messages which have been replied to</td></tr><tr><td>~r [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with “<span class="quote">date-received</span>” in a Date range</td></tr><tr><td>~R</td><td>read messages</td></tr><tr><td>~s <span class="emphasis"><em>EXPR</em></span></td><td>messages having <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">Subject</span>” field.</td></tr><tr><td>~S</td><td>superseded messages</td></tr><tr><td>~t <span class="emphasis"><em>EXPR</em></span></td><td>messages addressed to <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>~T</td><td>tagged messages</td></tr><tr><td>~u</td><td>messages addressed to a subscribed mailing list</td></tr><tr><td>~U</td><td>unread messages</td></tr><tr><td>~v</td><td>messages part of a collapsed thread.</td></tr><tr><td>~V</td><td>cryptographically verified messages</td></tr><tr><td>~x <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">References</span>” field</td></tr><tr><td>~X [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> attachments *)</td></tr><tr><td>~y <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">X-Label</span>” field</td></tr><tr><td>~z [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with a size in the range <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> *)</td></tr><tr><td>~=</td><td>duplicated messages (see <a class="link" href="#duplicate-threads" title="3.49. duplicate_threads">$duplicate_threads</a>)</td></tr><tr><td>~$</td><td>unreferenced messages (requires threaded view)</td></tr><tr><td>~(<span class="emphasis"><em>PATTERN</em></span>)</td><td>messages in threads
2186
</p><div class="table"><a id="tab-patterns"></a><p class="title"><b>Table 4.4. Pattern modifiers</b></p><div class="table-contents"><table summary="Pattern modifiers" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Pattern modifier</th><th>Description</th></tr></thead><tbody><tr><td>~A</td><td>all messages</td></tr><tr><td>~b <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the message body</td></tr><tr><td>=b <span class="emphasis"><em>STRING</em></span></td><td>messages which contain <span class="emphasis"><em>STRING</em></span> in the message body. If IMAP is enabled, searches for <span class="emphasis"><em>STRING</em></span> on the server, rather than downloading each message and searching it locally.</td></tr><tr><td>~B <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the whole message</td></tr><tr><td>~c <span class="emphasis"><em>EXPR</em></span></td><td>messages carbon-copied to <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%c <span class="emphasis"><em>GROUP</em></span></td><td>messages carbon-copied to any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~C <span class="emphasis"><em>EXPR</em></span></td><td>messages either to: or cc: <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%C <span class="emphasis"><em>GROUP</em></span></td><td>messages either to: or cc: to any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~d [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with “<span class="quote">date-sent</span>” in a Date range</td></tr><tr><td>~D</td><td>deleted messages</td></tr><tr><td>~e <span class="emphasis"><em>EXPR</em></span></td><td>messages which contains <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">Sender</span>” field</td></tr><tr><td>%e <span class="emphasis"><em>GROUP</em></span></td><td>messages which contain a member of <span class="emphasis"><em>GROUP</em></span> in the “<span class="quote">Sender</span>” field</td></tr><tr><td>~E</td><td>expired messages</td></tr><tr><td>~F</td><td>flagged messages</td></tr><tr><td>~f <span class="emphasis"><em>EXPR</em></span></td><td>messages originating from <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%f <span class="emphasis"><em>GROUP</em></span></td><td>messages originating from any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~g</td><td>cryptographically signed messages</td></tr><tr><td>~G</td><td>cryptographically encrypted messages</td></tr><tr><td>~h <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the message header</td></tr><tr><td>~H <span class="emphasis"><em>EXPR</em></span></td><td>messages with a spam attribute matching <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>~i <span class="emphasis"><em>EXPR</em></span></td><td>messages which match <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">Message-ID</span>” field</td></tr><tr><td>~k</td><td>messages which contain PGP key material</td></tr><tr><td>~L <span class="emphasis"><em>EXPR</em></span></td><td>messages either originated or received by <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>%L <span class="emphasis"><em>GROUP</em></span></td><td>message either originated or received by any member of <span class="emphasis"><em>GROUP</em></span></td></tr><tr><td>~l</td><td>messages addressed to a known mailing list</td></tr><tr><td>~m [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages in the range <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> *)</td></tr><tr><td>~n [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with a score in the range <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> *)</td></tr><tr><td>~N</td><td>new messages</td></tr><tr><td>~O</td><td>old messages</td></tr><tr><td>~p</td><td>messages addressed to you (consults <span class="command"><strong>alternates</strong></span>)</td></tr><tr><td>~P</td><td>messages from you (consults <span class="command"><strong>alternates</strong></span>)</td></tr><tr><td>~Q</td><td>messages which have been replied to</td></tr><tr><td>~r [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with “<span class="quote">date-received</span>” in a Date range</td></tr><tr><td>~R</td><td>read messages</td></tr><tr><td>~s <span class="emphasis"><em>EXPR</em></span></td><td>messages having <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">Subject</span>” field.</td></tr><tr><td>~S</td><td>superseded messages</td></tr><tr><td>~t <span class="emphasis"><em>EXPR</em></span></td><td>messages addressed to <span class="emphasis"><em>EXPR</em></span></td></tr><tr><td>~T</td><td>tagged messages</td></tr><tr><td>~u</td><td>messages addressed to a subscribed mailing list</td></tr><tr><td>~U</td><td>unread messages</td></tr><tr><td>~v</td><td>messages part of a collapsed thread.</td></tr><tr><td>~V</td><td>cryptographically verified messages</td></tr><tr><td>~x <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">References</span>” or “<span class="quote">In-Reply-To</span>” field</td></tr><tr><td>~X [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> attachments *)</td></tr><tr><td>~y <span class="emphasis"><em>EXPR</em></span></td><td>messages which contain <span class="emphasis"><em>EXPR</em></span> in the “<span class="quote">X-Label</span>” field</td></tr><tr><td>~z [<span class="emphasis"><em>MIN</em></span>]-[<span class="emphasis"><em>MAX</em></span>]</td><td>messages with a size in the range <span class="emphasis"><em>MIN</em></span> to <span class="emphasis"><em>MAX</em></span> *) **)</td></tr><tr><td>~=</td><td>duplicated messages (see <a class="link" href="#duplicate-threads" title="3.56. duplicate_threads">$duplicate_threads</a>)</td></tr><tr><td>~$</td><td>unreferenced messages (requires threaded view)</td></tr><tr><td>~(<span class="emphasis"><em>PATTERN</em></span>)</td><td>messages in threads
1989
2187
containing messages matching <span class="emphasis"><em>PATTERN</em></span>, e.g. all
1990
2188
threads containing messages from you: ~(~P)</td></tr></tbody></table></div></div><br class="table-break" /><p>
1991
2189
Where <span class="emphasis"><em>EXPR</em></span> is a
1992
<a class="link" href="#regexp" title="1. Regular Expressions">regular expression</a>. Special attention has to be
1993
made when using regular expressions inside of patterns. Specifically,
2190
<a class="link" href="#regexp" title="1. Regular Expressions">regular expression</a>.
2192
*) The forms “<span class="quote"><[<span class="emphasis"><em>MAX</em></span>]</span>”, “<span class="quote">>[<span class="emphasis"><em>MIN</em></span>]</span>”,
2193
“<span class="quote">[<span class="emphasis"><em>MIN</em></span>]-</span>” and “<span class="quote">-[<span class="emphasis"><em>MAX</em></span>]</span>”
2196
**) The suffixes “<span class="quote">K</span>” and “<span class="quote">M</span>” are allowed to specify kilobyte and megabyte respectively.
2198
Special attention has to be
2199
payed when using regular expressions inside of patterns. Specifically,
1994
2200
Mutt's parser for these patterns will strip one level of backslash (“<span class="quote">\</span>”),
1995
2201
which is normally used for quoting. If it is your intention to use a
1996
2202
backslash in the regular expression, you will need to use two backslashes
1997
instead (“<span class="quote">\\</span>”). You can force mutt to treat <span class="emphasis"><em>EXPR</em></span> as a simple string
2203
instead (“<span class="quote">\\</span>”). You can force Mutt to treat <span class="emphasis"><em>EXPR</em></span> as a simple string
1998
2204
instead of a regular expression by using = instead of ˜ in the
1999
2205
pattern name. For example, <code class="literal">=b *.*</code> will find all messages that contain
2000
2206
the literal string “<span class="quote">*.*</span>”. Simple string matches are less powerful than
2001
2207
regular expressions but can be considerably faster. This is especially
2002
2208
true for IMAP folders, because string matches can be performed on the
2003
2209
server instead of by fetching every message. IMAP treats <code class="literal">=h</code> specially:
2004
it must be of the form "header: substring" and will not partially
2210
it must be of the form “<span class="quote">header: substring</span>” and will not partially
2005
2211
match header names. The substring part may be omitted if you simply
2006
2212
wish to find messages containing a particular header without regard to
2009
*) The forms “<span class="quote"><[<span class="emphasis"><em>MAX</em></span>]</span>”, “<span class="quote">>[<span class="emphasis"><em>MIN</em></span>]</span>”,
2010
“<span class="quote">[<span class="emphasis"><em>MIN</em></span>]-</span>” and “<span class="quote">-[<span class="emphasis"><em>MAX</em></span>]</span>”
2012
</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="patterns-modifier"></a>2.1. Pattern Modifier</h3></div></div></div><div class="note"><h3 class="title">Note</h3><p>
2013
Note that patterns matching 'lists' of addresses (notably c, C, p, P and t)
2215
Patterns matching lists of addresses (notably c, C, p, P and t)
2014
2216
match if there is at least one match in the whole list. If you want to
2015
2217
make sure that all elements of that list match, you need to prefix your
2016
2218
pattern with “<span class="quote">^</span>”.
2017
2219
This example matches all mails which only has recipients from Germany.
2018
</p></div><pre class="screen">
2220
</p><div class="example"><a id="ex-recips"></a><p class="title"><b>Example 4.1. Matching all addresses in address lists</b></p><div class="example-contents"><pre class="screen">
2020
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="simple-patterns"></a>2.2. Simple Patterns</h3></div></div></div><p>
2021
Mutt supports two versions of so called “<span class="quote">simple searches</span>” which are
2222
</pre></div></div><br class="example-break" /></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="simple-searches"></a>2.2. Simple Searches</h3></div></div></div><p>
2223
Mutt supports two versions of so called “<span class="quote">simple searches</span>”. These are
2022
2224
issued if the query entered for searching, limiting and similar
2023
operations does not seem to be a valid pattern (i.e. it does not contain
2225
operations does not seem to contain a valid pattern modifier (i.e. it does not contain
2024
2226
one of these characters: “<span class="quote">˜</span>”, “<span class="quote">=</span>” or “<span class="quote">%</span>”). If the query is
2025
2227
supposed to contain one of these special characters, they must be escaped
2026
2228
by prepending a backslash (“<span class="quote">\</span>”).
2247
2466
The other mechanism for accessing the query function is for address
2248
2467
completion, similar to the alias completion. In any prompt for address
2249
2468
entry, you can use the <code class="literal"><complete-query></code> function (default: ^T) to run a
2250
query based on the current address you have typed. Like aliases, mutt
2469
query based on the current address you have typed. Like aliases, Mutt
2251
2470
will look for what you have typed back to the last space or comma. If
2252
there is a single response for that query, mutt will expand the address
2253
in place. If there are multiple responses, mutt will activate the query
2471
there is a single response for that query, Mutt will expand the address
2472
in place. If there are multiple responses, Mutt will activate the query
2254
2473
menu. At the query menu, you can select one or more addresses to be
2255
2474
added to the prompt.
2256
2475
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="mailbox-formats"></a>6. Mailbox Formats</h2></div></div></div><p>
2257
Mutt supports reading and writing of four different mailbox formats:
2476
Mutt supports reading and writing of four different local mailbox formats:
2258
2477
mbox, MMDF, MH and Maildir. The mailbox type is autodetected, so there
2259
2478
is no need to use a flag for different mailbox types. When creating new
2260
mailboxes, Mutt uses the default specified with the <a class="link" href="#mbox-type" title="3.117. mbox_type">$mbox_type</a> variable.
2479
mailboxes, Mutt uses the default specified with the
2480
<a class="link" href="#mbox-type" title="3.127. mbox_type">$mbox_type</a> variable. A
2481
short description of the formats follows.
2262
<span class="bold"><strong>mbox</strong></span>. This is the most widely used mailbox format for UNIX. All
2483
<span class="emphasis"><em>mbox</em></span>. This is a widely used mailbox format for UNIX. All
2263
2484
messages are stored in a single file. Each message has a line of the form:
2264
2485
</p><pre class="screen">
2265
2486
From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
2267
2488
to denote the start of a new message (this is often referred to as the
2268
“<span class="quote">From_</span>” line).
2270
<span class="bold"><strong>MMDF</strong></span>. This is a variant of the <span class="emphasis"><em>mbox</em></span> format. Each message is
2271
surrounded by lines containing “<span class="quote">^A^A^A^A</span>” (four control-A's).
2273
<span class="bold"><strong>MH</strong></span>. A radical departure from <span class="emphasis"><em>mbox</em></span> and <span class="emphasis"><em>MMDF</em></span>, a mailbox
2489
“<span class="quote">From_</span>” line). The mbox format requires mailbox
2490
locking, is prone to mailbox corruption with concurrently writing
2491
clients or misinterpreted From_ lines. Depending on the
2492
environment, new mail detection can be unreliable. Mbox folders are fast
2493
to open and easy to archive.
2495
<span class="emphasis"><em>MMDF</em></span>. This is a variant of
2496
the <span class="emphasis"><em>mbox</em></span> format. Each message is surrounded by
2497
lines containing “<span class="quote">^A^A^A^A</span>” (four
2498
control-A's). The same problems as for mbox apply (also with finding the
2499
right message separator as four control-A's may appear in message
2502
<span class="emphasis"><em>MH</em></span>. A radical departure from <span class="emphasis"><em>mbox</em></span> and <span class="emphasis"><em>MMDF</em></span>, a mailbox
2274
2503
consists of a directory and each message is stored in a separate file.
2275
2504
The filename indicates the message number (however, this is may not
2276
2505
correspond to the message number Mutt displays). Deleted messages are
2277
renamed with a comma (,) prepended to the filename. Mutt
2506
renamed with a comma (“<span class="quote">,</span>”) prepended to the filename. Mutt
2278
2507
detects this type of mailbox by looking for either <code class="literal">.mh_sequences</code>
2279
or <code class="literal">.xmhcache</code> (needed to distinguish normal directories from MH
2508
or <code class="literal">.xmhcache</code> files (needed to distinguish normal directories from MH
2509
mailboxes). MH is more robust with concurrent clients writing the mailbox,
2510
but still may suffer from lost flags; message corruption is less likely
2511
to occur than with mbox/mmdf. It's usually slower to open compared to
2512
mbox/mmdf since many small files have to be read (Mutt provides
2513
<a class="xref" href="#header-caching" title="7.1. Header Caching">Section 7.1, “Header Caching”</a> to greatly speed this process up).
2514
Depending on the environment, MH is not very disk-space efficient.
2282
<span class="bold"><strong>Maildir</strong></span>. The newest of the mailbox formats, used by the Qmail MTA (a
2516
<span class="emphasis"><em>Maildir</em></span>. The newest of the mailbox formats, used by the Qmail MTA (a
2283
2517
replacement for sendmail). Similar to <span class="emphasis"><em>MH</em></span>, except that it adds three
2284
2518
subdirectories of the mailbox: <span class="emphasis"><em>tmp</em></span>, <span class="emphasis"><em>new</em></span> and <span class="emphasis"><em>cur</em></span>. Filenames
2285
2519
for the messages are chosen in such a way they are unique, even when two
2286
2520
programs are writing the mailbox over NFS, which means that no file locking
2521
is needed and corruption is very unlikely. Maildir maybe
2522
slower to open without caching in Mutt, it too is not very
2523
disk-space efficient depending on the environment. Since no additional
2524
files are used for metadata (which is embedded in the message filenames)
2525
and Maildir is locking-free, it's easy to sync across different machines
2526
using file-level synchronization tools.
2288
2527
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="shortcuts"></a>7. Mailbox Shortcuts</h2></div></div></div><p>
2289
2528
There are a number of built in shortcuts which refer to specific mailboxes.
2290
2529
These shortcuts can be used anywhere you are prompted for a file or mailbox
2530
path or in path-related configuration variables. Note that these only
2531
work at the beginning of a string.
2292
2532
</p><div class="itemizedlist"><ul type="disc"><li><p>
2293
! -- refers to your <a class="link" href="#spoolfile" title="3.277. spoolfile">$spoolfile</a> (incoming) mailbox
2295
> -- refers to your <a class="link" href="#mbox" title="3.116. mbox">$mbox</a> file
2297
< -- refers to your <a class="link" href="#record" title="3.240. record">$record</a> file
2299
^ -- refers to the current mailbox
2301
- or !! -- refers to the file you've last visited
2303
˜ -- refers to your home directory
2305
= or + -- refers to your <a class="link" href="#folder" title="3.58. folder">$folder</a> directory
2307
@<span class="emphasis"><em>alias</em></span> -- refers to the <a class="link" href="#save-hook" title="16. Specify default save mailbox">default save folder</a> as determined by the address of the alias
2308
</p></li></ul></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="using-lists"></a>8. Handling Mailing Lists</h2></div></div></div><p>
2533
! — refers to your <a class="link" href="#spoolfile" title="3.269. spoolfile">$spoolfile</a> (incoming) mailbox
2535
> — refers to your <a class="link" href="#mbox" title="3.126. mbox">$mbox</a> file
2537
< — refers to your <a class="link" href="#record" title="3.211. record">$record</a> file
2539
^ — refers to the current mailbox
2541
- or !! — refers to the file you've last visited
2543
˜ — refers to your home directory
2545
= or + — refers to your <a class="link" href="#folder" title="3.66. folder">$folder</a> directory
2547
@<span class="emphasis"><em>alias</em></span> — refers to the <a class="link" href="#save-hook" title="16. Specify Default Save Mailbox">default save folder</a> as determined by the address of the alias
2548
</p></li></ul></div><p>
2549
For example, to store a copy of outgoing messages in the folder they
2551
a <a class="link" href="#folder-hook" title="7. Setting Variables Based Upon Mailbox"><span class="command"><strong>folder-hook</strong></span></a> can
2552
be used to set <a class="link" href="#record" title="3.211. record">$record</a>:
2553
</p><pre class="screen">
2554
folder-hook . 'set record=^'</pre></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="using-lists"></a>8. Handling Mailing Lists</h2></div></div></div><p>
2309
2555
Mutt has a few configuration options that make dealing with large
2310
2556
amounts of mail easier. The first thing you must do is to let Mutt
2311
2557
know what addresses you consider to be mailing lists (technically
2312
2558
this does not have to be a mailing list, but that is what it is most
2313
2559
often used for), and what lists you are subscribed to. This is
2314
accomplished through the use of the <a class="link" href="#lists" title="12. Mailing lists">lists and subscribe</a> commands in your muttrc.
2560
accomplished through the use of the <a class="link" href="#lists" title="12. Mailing Lists"><span class="command"><strong>lists</strong></span> and <span class="command"><strong>subscribe</strong></span></a> commands in your <code class="literal">.muttrc</code>.
2316
2562
Now that Mutt knows what your mailing lists are, it can do several
2317
2563
things, the first of which is the ability to show the name of a list
2318
2564
through which you received a message (i.e., of a subscribed list) in
2319
2565
the <span class="emphasis"><em>index</em></span> menu display. This is useful to distinguish between
2320
personal and list mail in the same mailbox. In the <a class="link" href="#index-format" title="3.101. index_format">$index_format</a> variable, the escape “<span class="quote">%L</span>”
2321
will return the string “<span class="quote">To <list></span>” when “<span class="quote">list</span>” appears in the
2566
personal and list mail in the same mailbox. In the <a class="link" href="#index-format" title="3.114. index_format">$index_format</a> variable, the expando “<span class="quote">%L</span>”
2567
will print the string “<span class="quote">To <list></span>” when “<span class="quote">list</span>” appears in the
2322
2568
“<span class="quote">To</span>” field, and “<span class="quote">Cc <list></span>” when it appears in the “<span class="quote">Cc</span>”
2323
field (otherwise it returns the name of the author).
2569
field (otherwise it prints the name of the author).
2325
2571
Often times the “<span class="quote">To</span>” and “<span class="quote">Cc</span>” fields in mailing list messages
2326
2572
tend to get quite large. Most people do not bother to remove the
3260
3600
by default because external database libraries are required: one
3261
3601
of tokyocabinet, qdbm, gdbm or bdb must be present.
3263
If enabled, <a class="link" href="#header-cache" title="3.108. header_cache">$header_cache</a> can be
3603
If enabled, <a class="link" href="#header-cache" title="3.79. header_cache">$header_cache</a> can be
3264
3604
used to either point to a file or a directory. If set to point to
3265
3605
a file, one database file for all folders will be used (which may
3266
3606
result in lower performance), but one file per folder if it points
3267
3607
to a directory.
3269
For the one-file-per-folder case, database files for remote folders
3270
will be named according to their URL while database files for local
3271
folders will be named by the MD5 checksums of their path. These database
3272
files may be safely removed if a system is short on space. You
3273
can compute the name of the header cache file for a particular local folder
3274
through a command like the following:
3275
</p><pre class="screen">
3276
$ printf '%s' '/path/to/folder' | md5sum
3278
The <code class="literal">md5sum</code> command may also be
3279
named <code class="literal">md5</code>, depending on your operating system.
3280
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="body-caching"></a>7.2. Body caching</h3></div></div></div><p>
3608
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="body-caching"></a>7.2. Body Caching</h3></div></div></div><p>
3281
3609
Both cache methods can be combined using the same directory for storage
3282
3610
(and for IMAP/POP even provide meaningful file names) which simplifies
3283
3611
manual maintenance tasks.
3285
In addition to caching message headers only, mutt can also cache
3613
In addition to caching message headers only, Mutt can also cache
3286
3614
whole message bodies. This results in faster display of messages
3287
3615
for POP and IMAP folders because messages usually have to be
3288
3616
downloaded only once.
3290
For configuration, the variable <a class="link" href="#message-cachedir" title="3.133. message_cachedir">$message_cachedir</a> must point to a
3291
directory. There, mutt will create a hierarchy of subdirectories
3618
For configuration, the variable <a class="link" href="#message-cachedir" title="3.132. message_cachedir">$message_cachedir</a> must point to a
3619
directory. There, Mutt will create a hierarchy of subdirectories
3292
3620
named like: <code class="literal">proto:user@hostname</code> where
3293
3621
<code class="literal">proto</code> is either “<span class="quote">pop</span>” or “<span class="quote">imap.</span>” Within
3294
there for each folder, mutt stores messages in single files (just
3295
like Maildir) so that with manual symlink creation these cache
3296
directories can be examined with mutt as read-only Maildir folders.
3622
there for each folder, Mutt stores messages in single files.
3298
3623
All files can be removed as needed if the consumed disk space
3299
becomes an issue as mutt will silently fetch missing items again.
3624
becomes an issue as Mutt will silently fetch missing items again.
3300
3625
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maint-cache"></a>7.3. Maintenance</h3></div></div></div><p>
3301
3626
Mutt does not (yet) support maintenance features for header cache
3302
3627
database files so that files have to be removed in case they grow too
3303
3628
big. It depends on the database library used for header caching whether
3304
3629
disk space freed by removing messages is re-used.
3306
For body caches, mutt can keep the local cache in sync with the
3631
For body caches, Mutt can keep the local cache in sync with the
3307
3632
remote mailbox if the
3308
<a class="link" href="#message-cache-clean" title="3.134. message_cache_clean">$message_cache_clean</a>
3633
<a class="link" href="#message-cache-clean" title="3.131. message_cache_clean">$message_cache_clean</a>
3309
3634
variable is set. Cleaning means to remove messages from the cache which
3310
3635
are no longer present in the mailbox which only happens when other mail
3311
clients or instances of mutt using a different body cache location
3636
clients or instances of Mutt using a different body cache location
3312
3637
delete messages (Mutt itself removes deleted messages from the cache
3313
3638
when syncing a mailbox). As cleaning can take a noticeable amount of time,
3314
3639
it should not be set in general but only occasionally.
3315
</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exact-address"></a>8. Exact address generation</h2></div></div></div><p>
3640
</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exact-address"></a>8. Exact Address Generation</h2></div></div></div><p>
3316
3641
Mutt supports the “<span class="quote">Name <user@host></span>” address syntax for reading and
3317
3642
writing messages, the older “<span class="quote">user@host (Name)</span>” syntax is only supported when
3318
3643
reading messages. The <span class="emphasis"><em>--enable-exact-address</em></span>
3319
3644
switch can be given to configure to build it with write-support
3320
3645
for the latter syntax. <code class="literal">EXACT_ADDRESS</code> in the output of
3321
3646
<code class="literal">mutt -v</code> indicates whether it's supported.
3322
</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="tuning"></a>Chapter 7. Performance tuning</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#tuning-mailboxes">1. Reading and writing mailboxes</a></span></dt><dt><span class="sect1"><a href="#tuning-messages">2. Reading messages from remote folders</a></span></dt><dt><span class="sect1"><a href="#tuning-search">3. Searching and limiting</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tuning-mailboxes"></a>1. Reading and writing mailboxes</h2></div></div></div><p>
3647
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="sending-mixmaster"></a>9. Sending Anonymous Messages via Mixmaster</h2></div></div></div><p>
3648
You may also have compiled Mutt to co-operate with Mixmaster, an
3649
anonymous remailer. Mixmaster permits you to send your messages
3650
anonymously using a chain of remailers. Mixmaster support in Mutt is for
3651
mixmaster version 2.04 (beta 45 appears to be the latest) and 2.03.
3652
It does not support earlier versions or the later so-called version 3 betas,
3653
of which the latest appears to be called 2.9b23.
3655
To use it, you'll have to obey certain restrictions. Most
3656
important, you cannot use the <code class="literal">Cc</code> and <code class="literal">Bcc</code> headers. To tell
3657
Mutt to use mixmaster, you have to select a remailer chain, using
3658
the mix function on the compose menu.
3660
The chain selection screen is divided into two parts. In the
3661
(larger) upper part, you get a list of remailers you may use. In
3662
the lower part, you see the currently selected chain of remailers.
3664
You can navigate in the chain using the <code class="literal"><chain-prev></code> and
3665
<code class="literal"><chain-next></code> functions, which are by default bound to the left
3666
and right arrows and to the <code class="literal">h</code> and <code class="literal">l</code> keys (think vi
3667
keyboard bindings). To insert a remailer at the current chain
3668
position, use the <code class="literal"><insert></code> function. To append a remailer behind
3669
the current chain position, use <code class="literal"><select-entry></code> or <code class="literal"><append></code>.
3670
You can also delete entries from the chain, using the corresponding
3671
function. Finally, to abandon your changes, leave the menu, or
3672
<code class="literal"><accept></code> them pressing (by default) the <code class="literal">Return</code> key.
3674
Note that different remailers do have different capabilities,
3675
indicated in the %c entry of the remailer menu lines (see
3676
<a class="link" href="#mix-entry-format" title="3.143. mix_entry_format">$mix_entry_format</a>). Most important is
3677
the “<span class="quote">middleman</span>” capability, indicated by a capital “<span class="quote">M</span>”: This
3678
means that the remailer in question cannot be used as the final
3679
element of a chain, but will only forward messages to other
3680
mixmaster remailers. For details on the other capabilities, please
3681
have a look at the mixmaster documentation.
3682
</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="security"></a>Chapter 7. Security Considerations</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#security-passwords">1. Passwords</a></span></dt><dt><span class="sect1"><a href="#security-tempfiles">2. Temporary Files</a></span></dt><dt><span class="sect1"><a href="#security-leaks">3. Information Leaks</a></span></dt><dd><dl><dt><span class="sect2"><a href="#security-leaks-mid">3.1. Message-Id: headers</a></span></dt><dt><span class="sect2"><a href="#security-leaks-mailto">3.2. mailto:-style Links</a></span></dt></dl></dd><dt><span class="sect1"><a href="#security-external">4. External Applications</a></span></dt></dl></div><p>
3683
First of all, Mutt contains no security holes included by intention but
3684
may contain unknown security holes. As a consequence, please run Mutt
3685
only with as few permissions as possible. Especially, do not run Mutt as
3688
When configuring Mutt, there're some points to note about secure setups
3689
so please read this chapter carefully.
3690
</p><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="security-passwords"></a>1. Passwords</h2></div></div></div><p>
3691
Although Mutt can be told the various passwords for accounts, please
3692
never store passwords in configuration files. Besides the fact that the
3693
system's operator can always read them, you could forget to mask it out
3694
when reporting a bug or asking for help via a mailing list. Even worse,
3695
your mail including your password could be archived by internet search
3696
engines, mail-to-news gateways etc. It may already be too late before
3697
you notice your mistake.
3698
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="security-tempfiles"></a>2. Temporary Files</h2></div></div></div><p>
3699
Mutt uses many temporary files for viewing messages, verifying digital
3700
signatures, etc. As long as being used, these files are visible by other
3701
users and maybe even readable in case of misconfiguration. Also, a
3702
different location for these files may be desired which can be changed
3703
via the <a class="link" href="#tmpdir" title="3.292. tmpdir">$tmpdir</a> variable.
3704
</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="security-leaks"></a>3. Information Leaks</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="security-leaks-mid"></a>3.1. Message-Id: headers</h3></div></div></div><p>
3705
Message-Id: headers contain a local part that is to be created in a
3706
unique fashion. In order to do so, Mutt will “<span class="quote">leak</span>” some
3707
information to the outside world when sending messages: the generation
3708
of this header includes a step counter which is increased (and rotated)
3709
with every message sent. In a longer running mutt session, others can
3710
make assumptions about your mailing habbits depending on the number of
3711
messages sent. If this is not desired, the header can be manually
3712
provided using <a class="link" href="#edit-headers" title="3.57. edit_headers">$edit_headers</a> (though not
3714
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="security-leaks-mailto"></a>3.2. <code class="literal">mailto:</code>-style Links</h3></div></div></div><p>
3715
As Mutt be can be set up to be the mail client to handle
3716
<code class="literal">mailto:</code> style links in websites, there're security
3717
considerations, too. Arbitrary header fields can be embedded in these
3718
links which could override existing header fields or attach arbitrary
3719
files using <a class="link" href="#attach-header" title="6.2.2. Attach: Pseudo Header">the Attach:
3720
psuedoheader</a>. This may be problematic if the <a class="link" href="#edit-headers" title="3.57. edit_headers">$edit-headers</a> variable is
3721
<span class="emphasis"><em>unset</em></span>, i.e. the user doesn't want to see header
3722
fields while editing the message and doesn't pay enough attention to the
3723
compose menu's listing of attachments.
3725
For example, following a link like
3726
</p><pre class="screen">
3727
mailto:joe@host?Attach=~/.gnupg/secring.gpg</pre><p>
3728
will send out the user's private gnupg keyring to
3729
<code class="literal">joe@host</code> if the user doesn't follow the information
3730
on screen carefully enough.
3731
</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="security-external"></a>4. External Applications</h2></div></div></div><p>
3732
Mutt in many places has to rely on external applications or for
3733
convenience supports mechanisms involving external applications.
3735
One of these is the <code class="literal">mailcap</code> mechanism as defined by
3736
RfC1524. Details about a secure use of the mailcap mechanisms is given
3737
in <a class="xref" href="#secure-mailcap" title="3.2. Secure Use of Mailcap">Section 3.2, “Secure Use of Mailcap”</a>.
3739
Besides the mailcap mechanism, Mutt uses a number of other external
3740
utilities for operation, for example to provide crypto support, in
3741
backtick expansion in configuration files or format string filters. The
3742
same security considerations apply for these as for tools involved via
3744
</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="tuning"></a>Chapter 8. Performance Tuning</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#tuning-mailboxes">1. Reading and Writing Mailboxes</a></span></dt><dt><span class="sect1"><a href="#tuning-messages">2. Reading Messages from Remote Folders</a></span></dt><dt><span class="sect1"><a href="#tuning-search">3. Searching and Limiting</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tuning-mailboxes"></a>1. Reading and Writing Mailboxes</h2></div></div></div><p>
3323
3745
Mutt's performance when reading mailboxes can be improved in two ways:
3324
3746
</p><div class="orderedlist"><ol type="1"><li><p>
3325
3747
For remote folders (IMAP and POP) as well as folders using
3326
one-file-per message storage (Maildir and MH), mutt's
3748
one-file-per message storage (Maildir and MH), Mutt's
3327
3749
performance can be greatly improved using
3328
<a class="link" href="#header-caching" title="7.1. Header caching">header caching</a>.
3329
Using a single database per folder may further increase
3750
<a class="link" href="#header-caching" title="7.1. Header Caching">header caching</a>.
3751
using a single database per folder.
3331
3752
</p></li><li><p>
3332
Mutt provides the <a class="link" href="#read-inc" title="3.236. read_inc">$read_inc</a>
3333
and <a class="link" href="#write-inc" title="3.305. write_inc">$write_inc</a>
3753
Mutt provides the <a class="link" href="#read-inc" title="3.207. read_inc">$read_inc</a>
3754
and <a class="link" href="#write-inc" title="3.310. write_inc">$write_inc</a>
3334
3755
variables to specify at which rate to update progress
3335
counters. If these values are too low, mutt may spend more
3756
counters. If these values are too low, Mutt may spend more
3336
3757
time on updating the progress counter than it spends on
3337
3758
actually reading/writing folders.
3339
3760
For example, when opening a maildir folder with a few
3340
3761
thousand messages, the default value for
3341
<a class="link" href="#read-inc" title="3.236. read_inc">$read_inc</a>
3762
<a class="link" href="#read-inc" title="3.207. read_inc">$read_inc</a>
3342
3763
may be too low. It can be tuned on on a folder-basis using
3343
<a class="link" href="#folder-hook" title="7. Setting variables based upon mailbox">folder-hooks</a>:
3764
<a class="link" href="#folder-hook" title="7. Setting Variables Based Upon Mailbox"><span class="command"><strong>folder-hook</strong></span>s</a>:
3344
3765
</p><pre class="screen">
3345
3766
# use very high $read_inc to speed up reading hcache'd maildirs
3346
3767
folder-hook . 'set read_inc=1000'
3519
3948
<em class="replaceable"><code>background</code></em>
3521
3950
<em class="replaceable"><code>pattern</code></em>
3522
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#color" title="9. Using color and mono video attributes">uncolor</a></code>
3951
<br /><code class="command"><a class="link" href="#color" title="9. Using Color and Mono Video Attributes">uncolor</a></code> {
3523
3952
<code class="option">index</code>
3954
<code class="option">header</code>
3956
<code class="option">body</code>
3958
<em class="replaceable"><code>*</code></em>
3960
<em class="replaceable"><code>pattern</code></em>
3961
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#crypt-hook" title="21. Choosing the Cryptographic Key of the Recipient">crypt-hook</a></code>
3962
<em class="replaceable"><code>pattern</code></em>
3525
<em class="replaceable"><code>pattern</code></em>
3526
... </p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#exec" title="23. Executing functions">exec</a></code>
3964
<em class="replaceable"><code>keyid</code></em>
3965
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#exec" title="23. Executing Functions">exec</a></code>
3527
3966
<em class="replaceable"><code>function</code></em>
3529
3968
<em class="replaceable"><code>function</code></em>
3530
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></code>
3531
<em class="replaceable"><code>[!]pattern</code></em>
3533
<em class="replaceable"><code>mailbox</code></em>
3534
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#fcc-save-hook" title="18. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a></code>
3535
<em class="replaceable"><code>[!]pattern</code></em>
3537
<em class="replaceable"><code>mailbox</code></em>
3538
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#folder-hook" title="7. Setting variables based upon mailbox">folder-hook</a></code>
3969
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></code>
3970
<em class="replaceable"><code>[!]pattern</code></em>
3972
<em class="replaceable"><code>mailbox</code></em>
3973
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#fcc-save-hook" title="18. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></code>
3974
<em class="replaceable"><code>[!]pattern</code></em>
3976
<em class="replaceable"><code>mailbox</code></em>
3977
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#folder-hook" title="7. Setting Variables Based Upon Mailbox">folder-hook</a></code>
3539
3978
<em class="replaceable"><code>[!]regexp</code></em>
3541
3980
<em class="replaceable"><code>command</code></em>
3542
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#addrgroup" title="3. Address groups">group</a></code> [
3543
<code class="option">-group</code>
3544
<em class="replaceable"><code>name</code></em>
3546
<code class="option">-rx</code>
3547
<em class="replaceable"><code>expr</code></em>
3549
<code class="option">-addr</code>
3550
<em class="replaceable"><code>expr</code></em>
3551
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#addrgroup" title="3. Address groups">ungroup</a></code> [
3552
<code class="option">-group</code>
3553
<em class="replaceable"><code>name</code></em>
3555
<em class="replaceable"><code>*</code></em>
3557
<code class="option">-rx</code>
3558
<em class="replaceable"><code>expr</code></em>
3560
<code class="option">-addr</code>
3561
<em class="replaceable"><code>expr</code></em>
3562
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#hdr-order">hdr_order</a></code>
3563
<em class="replaceable"><code>header</code></em>
3565
<em class="replaceable"><code>header</code></em>
3566
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#hdr-order">unhdr_order</a></code> {
3567
<em class="replaceable"><code>*</code></em>
3569
<em class="replaceable"><code>header</code></em>
3570
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#ignore" title="10. Message header display">ignore</a></code>
3571
<em class="replaceable"><code>pattern</code></em>
3573
<em class="replaceable"><code>pattern</code></em>
3574
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#ignore" title="10. Message header display">unignore</a></code> {
3575
<em class="replaceable"><code>*</code></em>
3577
<em class="replaceable"><code>pattern</code></em>
3578
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#lists" title="12. Mailing lists">lists</a></code> [
3981
</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#addrgroup" title="3. Address Groups">group</a></code> [
3982
<code class="option">-group</code>
3983
<em class="replaceable"><code>name</code></em>
3985
<code class="option">-rx</code>
3986
<em class="replaceable"><code>expr</code></em>
3988
<code class="option">-addr</code>
3989
<em class="replaceable"><code>expr</code></em>
3990
... }<br /><code class="command"><a class="link" href="#addrgroup" title="3. Address Groups">ungroup</a></code> [
3991
<code class="option">-group</code>
3992
<em class="replaceable"><code>name</code></em>
3994
<em class="replaceable"><code>*</code></em>
3996
<code class="option">-rx</code>
3997
<em class="replaceable"><code>expr</code></em>
3999
<code class="option">-addr</code>
4000
<em class="replaceable"><code>expr</code></em>
4001
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#hdr-order" title="10.2. Ordering Displayed Headers">hdr_order</a></code>
4002
<em class="replaceable"><code>header</code></em>
4004
<em class="replaceable"><code>header</code></em>
4005
...]<br /><code class="command"><a class="link" href="#hdr-order" title="10.2. Ordering Displayed Headers">unhdr_order</a></code> {
4006
<em class="replaceable"><code>*</code></em>
4008
<em class="replaceable"><code>header</code></em>
4009
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#ignore" title="10.1. Selecting Headers">ignore</a></code>
4010
<em class="replaceable"><code>pattern</code></em>
4012
<em class="replaceable"><code>pattern</code></em>
4013
...]<br /><code class="command"><a class="link" href="#ignore" title="10.1. Selecting Headers">unignore</a></code> {
4014
<em class="replaceable"><code>*</code></em>
4016
<em class="replaceable"><code>pattern</code></em>
4017
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#lists" title="12. Mailing Lists">lists</a></code> [
3579
4018
<code class="option">-group</code>
3580
4019
<em class="replaceable"><code>name</code></em>
3582
4021
<em class="replaceable"><code>regexp</code></em>
3584
4023
<em class="replaceable"><code>regexp</code></em>
3585
...]</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#lists" title="12. Mailing lists">unlists</a></code> [
4024
...]<br /><code class="command"><a class="link" href="#lists" title="12. Mailing Lists">unlists</a></code> [
3586
4025
<code class="option">-group</code>
3587
4026
<em class="replaceable"><code>name</code></em>
3589
4028
<em class="replaceable"><code>*</code></em>
3591
4030
<em class="replaceable"><code>regexp</code></em>
3592
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#macro" title="8. Keyboard macros">macro</a></code>
4031
... }</p></div></li><li><div class="cmdsynopsis"><p><code class="command"><a class="link" href="#macro" title="8. Keyboard Macros">macro</a></code>
3593
4032
<em class="replaceable"><code>menu</code></em>
3595
4034
<em class="replaceable"><code>key</code></em>
3998
4453
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="copy"></a>3.35. copy</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
3999
4454
Default: yes</p></div><p>
4000
4455
This variable controls whether or not copies of your outgoing messages
4001
will be saved for later references. Also see <a class="link" href="#record" title="3.240. record">$record</a>,
4002
<a class="link" href="#save-name" title="3.252. save_name">$save_name</a>, <a class="link" href="#force-name" title="3.61. force_name">$force_name</a> and “<span class="quote"><a class="link" href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></span>”.
4003
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.36. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4456
will be saved for later references. Also see <a class="link" href="#record" title="3.211. record">$record</a>,
4457
<a class="link" href="#save-name" title="3.223. save_name">$save_name</a>, <a class="link" href="#force-name" title="3.69. force_name">$force_name</a> and “<span class="quote"><a class="link" href="#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”.
4458
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.36. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4459
Default: no</p></div><p>
4460
Setting this variable will cause Mutt to always attempt to PGP
4461
encrypt outgoing messages. This is probably only useful in
4462
connection to the “<span class="quote"><a class="link" href="#send-hook" title="19. Change Settings Based Upon Message Recipients">send-hook</a></span>” command. It can be overridden
4463
by use of the pgp menu, when encryption is not required or
4464
signing is requested as well. If <a class="link" href="#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
4465
then OpenSSL is used instead to create S/MIME messages and
4466
settings can be overridden by use of the smime menu instead.
4468
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.37. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4469
Default: yes</p></div><p>
4470
This variable controls whether or not mutt may automatically enable
4471
PGP encryption/signing for messages. See also <a class="link" href="#crypt-autoencrypt" title="3.36. crypt_autoencrypt">$crypt_autoencrypt</a>,
4472
<a class="link" href="#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>,
4473
<a class="link" href="#crypt-autosign" title="3.38. crypt_autosign">$crypt_autosign</a>, <a class="link" href="#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a> and <a class="link" href="#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a>.
4474
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.38. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4475
Default: no</p></div><p>
4476
Setting this variable will cause Mutt to always attempt to
4477
cryptographically sign outgoing messages. This can be overridden
4478
by use of the pgp menu, when signing is not required or
4479
encryption is requested as well. If <a class="link" href="#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
4480
then OpenSSL is used instead to create S/MIME messages and settings can
4481
be overridden by use of the smime menu instead of the pgp menu.
4483
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.39. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4484
Default: yes</p></div><p>
4485
This variable controls whether or not mutt may automatically enable
4486
S/MIME encryption/signing for messages. See also <a class="link" href="#crypt-autoencrypt" title="3.36. crypt_autoencrypt">$crypt_autoencrypt</a>,
4487
<a class="link" href="#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>,
4488
<a class="link" href="#crypt-autosign" title="3.38. crypt_autosign">$crypt_autosign</a>, <a class="link" href="#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a> and <a class="link" href="#smime-is-default" title="3.252. smime_is_default">$smime_is_default</a>.
4489
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.40. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4490
Default: yes</p></div><p>
4491
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL encrypt replies to messages which are
4494
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.41. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4495
Default: no</p></div><p>
4496
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages which are
4499
<span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted
4500
<span class="emphasis"><em>and</em></span> signed!
4502
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.42. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4503
Default: no</p></div><p>
4504
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages
4505
which are encrypted. This makes sense in combination with
4506
<a class="link" href="#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>, because it allows you to sign all
4507
messages which are automatically encrypted. This works around
4508
the problem noted in <a class="link" href="#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a>, that mutt is not able
4509
to find out whether an encrypted message is also signed.
4511
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.43. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4512
Default: yes</p></div><p>
4513
If <span class="emphasis"><em>set</em></span>, mutt will include a time stamp in the lines surrounding
4514
PGP or S/MIME output, so spoofing such lines is more difficult.
4515
If you are using colors to mark these lines, and rely on these,
4516
you may <span class="emphasis"><em>unset</em></span> this setting.
4518
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.44. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4004
4519
Default: no</p></div><p>
4005
4520
This variable controls the use of the GPGME-enabled crypto backends.
4006
4521
If it is <span class="emphasis"><em>set</em></span> and Mutt was built with gpgme support, the gpgme code for
4007
4522
S/MIME and PGP will be used instead of the classic code. Note that
4008
4523
you need to set this option in .muttrc; it won't have any effect when
4009
4524
used interactively.
4010
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.37. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4525
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.45. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4011
4526
Default: no</p></div><p>
4012
4527
Controls whether mutt uses PKA
4013
4528
(see http://www.g10code.de/docs/pka-intro.de.pdf) during signature
4014
4529
verification (only supported by the GPGME backend).
4015
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.38. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4016
Default: yes</p></div><p>
4017
This variable controls whether or not mutt may automatically enable
4018
PGP encryption/signing for messages. See also <a class="link" href="#crypt-autoencrypt" title="3.144. crypt_autoencrypt">$crypt_autoencrypt</a>,
4019
<a class="link" href="#crypt-replyencrypt" title="3.146. crypt_replyencrypt">$crypt_replyencrypt</a>,
4020
<a class="link" href="#crypt-autosign" title="3.143. crypt_autosign">$crypt_autosign</a>, <a class="link" href="#crypt-replysign" title="3.147. crypt_replysign">$crypt_replysign</a> and <a class="link" href="#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a>.
4021
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.39. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4022
Default: yes</p></div><p>
4023
This variable controls whether or not mutt may automatically enable
4024
S/MIME encryption/signing for messages. See also <a class="link" href="#crypt-autoencrypt" title="3.144. crypt_autoencrypt">$crypt_autoencrypt</a>,
4025
<a class="link" href="#crypt-replyencrypt" title="3.146. crypt_replyencrypt">$crypt_replyencrypt</a>,
4026
<a class="link" href="#crypt-autosign" title="3.143. crypt_autosign">$crypt_autosign</a>, <a class="link" href="#crypt-replysign" title="3.147. crypt_replysign">$crypt_replysign</a> and <a class="link" href="#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a>.
4027
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.40. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4530
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.46. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
4531
Default: yes</p></div><p>
4532
If <span class="emphasis"><em>“<span class="quote">yes</span>”</em></span>, always attempt to verify PGP or S/MIME signatures.
4533
If <span class="emphasis"><em>“<span class="quote">ask-*</span>”</em></span>, ask whether or not to verify the signature.
4534
If \Fi“<span class="quote">no</span>”, never attempt to verify cryptographic signatures.
4536
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.47. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4028
4537
Default: “<span class="quote"><code class="literal">!%a, %b %d, %Y at %I:%M:%S%p %Z</code></span>”</p></div><p>
4029
4538
This variable controls the format of the date printed by the “<span class="quote">%d</span>”
4030
sequence in <a class="link" href="#index-format" title="3.101. index_format">$index_format</a>. This is passed to the <code class="literal">strftime(3)</code>
4539
sequence in <a class="link" href="#index-format" title="3.114. index_format">$index_format</a>. This is passed to the <code class="literal">strftime(3)</code>
4031
4540
function to process the date, see the man page for the proper syntax.
4033
4542
Unless the first character in the string is a bang (“<span class="quote">!</span>”), the month
4034
4543
and week day names are expanded according to the locale specified in
4035
the variable <a class="link" href="#locale" title="3.104. locale">$locale</a>. If the first character in the string is a
4544
the variable <a class="link" href="#locale" title="3.117. locale">$locale</a>. If the first character in the string is a
4036
4545
bang, the bang is discarded, and the month and week day names in the
4037
4546
rest of the string are expanded in the <span class="emphasis"><em>C</em></span> locale (that is in US
4039
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.41. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4548
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.48. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4040
4549
Default: “<span class="quote"><code class="literal">˜f %s !˜P | (˜P ˜C %s)</code></span>”</p></div><p>
4041
This variable controls how “<span class="quote"><a class="link" href="#message-hook" title="20. Change settings before formatting a message">message-hook</a></span>”, “<span class="quote"><a class="link" href="#reply-hook">reply-hook</a></span>”, “<span class="quote"><a class="link" href="#send-hook" title="19. Change settings based upon message recipients">send-hook</a></span>”,
4042
“<span class="quote"><a class="link" href="#send2-hook">send2-hook</a></span>”, “<span class="quote"><a class="link" href="#save-hook" title="16. Specify default save mailbox">save-hook</a></span>”, and “<span class="quote"><a class="link" href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></span>” will
4550
This variable controls how “<span class="quote"><a class="link" href="#message-hook" title="20. Change Settings Before Formatting a Message">message-hook</a></span>”, “<span class="quote"><a class="link" href="#reply-hook">reply-hook</a></span>”, “<span class="quote"><a class="link" href="#send-hook" title="19. Change Settings Based Upon Message Recipients">send-hook</a></span>”,
4551
“<span class="quote"><a class="link" href="#send2-hook">send2-hook</a></span>”, “<span class="quote"><a class="link" href="#save-hook" title="16. Specify Default Save Mailbox">save-hook</a></span>”, and “<span class="quote"><a class="link" href="#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>” will
4043
4552
be interpreted if they are specified with only a simple regexp,
4044
4553
instead of a matching pattern. The hooks are expanded when they are
4045
4554
declared, so a hook will be interpreted according to the value of this
4105
4613
</p><pre class="screen">
4106
4614
set dsn_return=hdrs
4109
<span class="bold"><strong>Note:</strong></span> when using <a class="link" href="#sendmail" title="3.258. sendmail">$sendmail</a> for delivery, you should not enable
4616
<span class="bold"><strong>Note:</strong></span> when using <a class="link" href="#sendmail" title="3.230. sendmail">$sendmail</a> for delivery, you should not enable
4110
4617
this unless you are either using Sendmail 8.8.x or greater or a MTA
4111
4618
providing a <code class="literal">sendmail(1)</code>-compatible interface supporting the <code class="literal">-R</code> option
4112
4619
for DSN. For SMTP delivery, DSN support is autodetected so that it
4113
4620
depends on the server whether DSN will be used or not.
4114
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.49. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4621
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.56. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4115
4622
Default: yes</p></div><p>
4116
This variable controls whether mutt, when <a class="link" href="#sort" title="3.271. sort">$sort</a> is set to <span class="emphasis"><em>threads</em></span>, threads
4623
This variable controls whether mutt, when <a class="link" href="#sort" title="3.263. sort">$sort</a> is set to <span class="emphasis"><em>threads</em></span>, threads
4117
4624
messages with the same Message-Id together. If it is <span class="emphasis"><em>set</em></span>, it will indicate
4118
4625
that it thinks they are duplicates of each other with an equals sign
4119
4626
in the thread tree.
4120
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.50. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4627
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.57. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4121
4628
Default: no</p></div><p>
4122
4629
This option allows you to edit the header of your outgoing messages
4123
4630
along with the body of your message.
4125
4632
<span class="bold"><strong>Note</strong></span> that changes made to the References: and Date: headers are
4126
4633
ignored for interoperability reasons.
4127
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.51. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4634
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.58. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4128
4635
Default: (empty)</p></div><p>
4129
4636
This variable specifies which editor is used by mutt.
4130
4637
It defaults to the value of the <code class="literal">$VISUAL</code>, or <code class="literal">$EDITOR</code>, environment
4131
4638
variable, or to the string “<span class="quote">vi</span>” if neither of those are set.
4132
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.52. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4639
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.59. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4133
4640
Default: no</p></div><p>
4134
4641
When <span class="emphasis"><em>set</em></span>, mutt will quoted-printable encode messages when
4135
4642
they contain the string “<span class="quote">From </span>” (note the trailing space) in the beginning of a line.
4136
4643
This is useful to avoid the tampering certain mail delivery and transport
4137
4644
agents tend to do with messages (in order to prevent tools from
4138
4645
misinterpreting the line as a mbox message separator).
4139
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.53. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
4646
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.60. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4647
Default: (empty)</p></div><p>
4648
The file which includes random data that is used to initialize SSL
4650
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.61. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
4140
4651
Default: (empty)</p></div><p>
4141
4652
Manually sets the <span class="emphasis"><em>envelope</em></span> sender for outgoing messages.
4142
This value is ignored if <a class="link" href="#use-envelope-from" title="3.294. use_envelope_from">$use_envelope_from</a> is <span class="emphasis"><em>unset</em></span>.
4143
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.54. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4653
This value is ignored if <a class="link" href="#use-envelope-from" title="3.298. use_envelope_from">$use_envelope_from</a> is <span class="emphasis"><em>unset</em></span>.
4654
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.62. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4144
4655
Default: “<span class="quote"><code class="literal">˜</code></span>”</p></div><p>
4145
4656
Escape character to use for functions in the builtin editor.
4146
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.55. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4657
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.63. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4147
4658
Default: no</p></div><p>
4148
4659
When <span class="emphasis"><em>set</em></span>, the initial prompt for recipients and subject are skipped
4149
4660
when replying to messages, and the initial prompt for subject is
4150
4661
skipped when forwarding messages.
4152
<span class="bold"><strong>Note:</strong></span> this variable has no effect when the <a class="link" href="#autoedit" title="3.17. autoedit">$autoedit</a>
4663
<span class="bold"><strong>Note:</strong></span> this variable has no effect when the <a class="link" href="#autoedit" title="3.18. autoedit">$autoedit</a>
4153
4664
variable is <span class="emphasis"><em>set</em></span>.
4154
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.56. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4665
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.64. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
4155
4666
Default: yes</p></div><p>
4156
4667
This variable controls whether or not attachments on outgoing messages
4157
4668
are saved along with the main body of your message.
4158
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.57. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4669
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.65. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4159
4670
Default: no</p></div><p>
4160
4671
When this variable is <span class="emphasis"><em>set</em></span>, FCCs will be stored unencrypted and
4161
4672
unsigned, even when the actual message is encrypted and/or
4164
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.58. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4675
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.66. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4165
4676
Default: “<span class="quote"><code class="literal">˜/Mail</code></span>”</p></div><p>
4166
4677
Specifies the default location of your mailboxes. A “<span class="quote">+</span>” or “<span class="quote">=</span>” at the
4167
4678
beginning of a pathname will be expanded to the value of this
4168
4679
variable. Note that if you change this variable (from the default)
4169
4680
value you need to make sure that the assignment occurs <span class="emphasis"><em>before</em></span>
4170
4681
you use “<span class="quote">+</span>” or “<span class="quote">=</span>” for any other variables since expansion takes place
4171
when handling the “<span class="quote"><a class="link" href="#mailboxes" title="14. Monitoring incoming mail">mailboxes</a></span>” command.
4172
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.59. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4682
when handling the “<span class="quote"><a class="link" href="#mailboxes" title="14. Monitoring Incoming Mail">mailboxes</a></span>” command.
4683
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.67. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4173
4684
Default: “<span class="quote"><code class="literal">%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f</code></span>”</p></div><p>
4174
4685
This variable allows you to customize the file browser display to your
4175
personal taste. This string is similar to <a class="link" href="#index-format" title="3.101. index_format">$index_format</a>, but has
4686
personal taste. This string is similar to <a class="link" href="#index-format" title="3.114. index_format">$index_format</a>, but has
4176
4687
its own set of <code class="literal">printf(3)</code>-like sequences:
4178
</p><div class="variablelist"><dl><dt><span class="term">%C </span></dt><dd><p>current file number
4179
</p></dd><dt><span class="term">%d </span></dt><dd><p>date/time folder was last modified
4180
</p></dd><dt><span class="term">%f </span></dt><dd><p>filename
4181
</p></dd><dt><span class="term">%F </span></dt><dd><p>file permissions
4182
</p></dd><dt><span class="term">%g </span></dt><dd><p>group name (or numeric gid, if missing)
4183
</p></dd><dt><span class="term">%l </span></dt><dd><p>number of hard links
4184
</p></dd><dt><span class="term">%N </span></dt><dd><p>N if folder has new mail, blank otherwise
4185
</p></dd><dt><span class="term">%s </span></dt><dd><p>size in bytes
4186
</p></dd><dt><span class="term">%t </span></dt><dd><p>“<span class="quote">*</span>” if the file is tagged, blank otherwise
4187
</p></dd><dt><span class="term">%u </span></dt><dd><p>owner name (or numeric uid, if missing)
4188
</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character “<span class="quote">X</span>”
4189
</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character “<span class="quote">X</span>”
4190
</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character “<span class="quote">X</span>” as pad
4191
</p></dd></dl></div><p>
4192
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="#index-format" title="3.101. index_format">$index_format</a> documentation.
4193
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.60. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4689
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%C </td><td>current file number
4690
</td></tr><tr><td>%d </td><td>date/time folder was last modified
4691
</td></tr><tr><td>%f </td><td>filename (“<span class="quote">/</span>” is appended to directory names,
4692
“<span class="quote">@</span>” to symbolic links and “<span class="quote">*</span>” to executable
4694
</td></tr><tr><td>%F </td><td>file permissions
4695
</td></tr><tr><td>%g </td><td>group name (or numeric gid, if missing)
4696
</td></tr><tr><td>%l </td><td>number of hard links
4697
</td></tr><tr><td>%N </td><td>N if folder has new mail, blank otherwise
4698
</td></tr><tr><td>%s </td><td>size in bytes
4699
</td></tr><tr><td>%t </td><td>“<span class="quote">*</span>” if the file is tagged, blank otherwise
4700
</td></tr><tr><td>%u </td><td>owner name (or numeric uid, if missing)
4701
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character “<span class="quote">X</span>”
4702
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character “<span class="quote">X</span>”
4703
</td></tr><tr><td>%*X </td><td>soft-fill with character “<span class="quote">X</span>” as pad
4704
</td></tr></tbody></table></div><p>
4705
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="#index-format" title="3.114. index_format">$index_format</a> documentation.
4706
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.68. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4194
4707
Default: yes</p></div><p>
4195
4708
Controls whether or not the “<span class="quote">Mail-Followup-To:</span>” header field is
4196
4709
generated when sending mail. When <span class="emphasis"><em>set</em></span>, Mutt will generate this
4197
4710
field when you are replying to a known mailing list, specified with
4198
the “<span class="quote"><a class="link" href="#subscribe">subscribe</a></span>” or “<span class="quote"><a class="link" href="#lists" title="12. Mailing lists">lists</a></span>” commands.
4711
the “<span class="quote"><a class="link" href="#subscribe">subscribe</a></span>” or “<span class="quote"><a class="link" href="#lists" title="12. Mailing Lists">lists</a></span>” commands.
4200
4713
This field has two purposes. First, preventing you from
4201
4714
receiving duplicate copies of replies to messages which you send
4498
5049
function <code class="literal">printf(3)</code> to format output (see the man page for more details).
4499
5050
The following sequences are defined in Mutt:
4501
</p><div class="variablelist"><dl><dt><span class="term">%a </span></dt><dd><p>address of the author
4502
</p></dd><dt><span class="term">%A </span></dt><dd><p>reply-to address (if present; otherwise: address of author)
4503
</p></dd><dt><span class="term">%b </span></dt><dd><p>filename of the original message folder (think mailbox)
4504
</p></dd><dt><span class="term">%B </span></dt><dd><p>the list to which the letter was sent, or else the folder name (%b).
4505
</p></dd><dt><span class="term">%c </span></dt><dd><p>number of characters (bytes) in the message
4506
</p></dd><dt><span class="term">%C </span></dt><dd><p>current message number
4507
</p></dd><dt><span class="term">%d </span></dt><dd><p>date and time of the message in the format specified by
4508
<a class="link" href="#date-format" title="3.40. date_format">$date_format</a> converted to sender's time zone
4509
</p></dd><dt><span class="term">%D </span></dt><dd><p>date and time of the message in the format specified by
4510
<a class="link" href="#date-format" title="3.40. date_format">$date_format</a> converted to the local time zone
4511
</p></dd><dt><span class="term">%e </span></dt><dd><p>current message number in thread
4512
</p></dd><dt><span class="term">%E </span></dt><dd><p>number of messages in current thread
4513
</p></dd><dt><span class="term">%f </span></dt><dd><p>sender (address + real name), either From: or Return-Path:
4514
</p></dd><dt><span class="term">%F </span></dt><dd><p>author name, or recipient name if the message is from you
4515
</p></dd><dt><span class="term">%H </span></dt><dd><p>spam attribute(s) of this message
4516
</p></dd><dt><span class="term">%i </span></dt><dd><p>message-id of the current message
4517
</p></dd><dt><span class="term">%l </span></dt><dd><p>number of lines in the message (does not work with maildir,
5052
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>address of the author
5053
</td></tr><tr><td>%A </td><td>reply-to address (if present; otherwise: address of author)
5054
</td></tr><tr><td>%b </td><td>filename of the original message folder (think mailbox)
5055
</td></tr><tr><td>%B </td><td>the list to which the letter was sent, or else the folder name (%b).
5056
</td></tr><tr><td>%c </td><td>number of characters (bytes) in the message
5057
</td></tr><tr><td>%C </td><td>current message number
5058
</td></tr><tr><td>%d </td><td>date and time of the message in the format specified by
5059
<a class="link" href="#date-format" title="3.47. date_format">$date_format</a> converted to sender's time zone
5060
</td></tr><tr><td>%D </td><td>date and time of the message in the format specified by
5061
<a class="link" href="#date-format" title="3.47. date_format">$date_format</a> converted to the local time zone
5062
</td></tr><tr><td>%e </td><td>current message number in thread
5063
</td></tr><tr><td>%E </td><td>number of messages in current thread
5064
</td></tr><tr><td>%f </td><td>sender (address + real name), either From: or Return-Path:
5065
</td></tr><tr><td>%F </td><td>author name, or recipient name if the message is from you
5066
</td></tr><tr><td>%H </td><td>spam attribute(s) of this message
5067
</td></tr><tr><td>%i </td><td>message-id of the current message
5068
</td></tr><tr><td>%l </td><td>number of lines in the message (does not work with maildir,
4518
5069
mh, and possibly IMAP folders)
4519
</p></dd><dt><span class="term">%L </span></dt><dd><p>If an address in the “<span class="quote">To:</span>” or “<span class="quote">Cc:</span>” header field matches an address
5070
</td></tr><tr><td>%L </td><td>If an address in the “<span class="quote">To:</span>” or “<span class="quote">Cc:</span>” header field matches an address
4520
5071
defined by the users “<span class="quote"><a class="link" href="#subscribe">subscribe</a></span>” command, this displays
4521
5072
"To <list-name>", otherwise the same as %F.
4522
</p></dd><dt><span class="term">%m </span></dt><dd><p>total number of message in the mailbox
4523
</p></dd><dt><span class="term">%M </span></dt><dd><p>number of hidden messages if the thread is collapsed.
4524
</p></dd><dt><span class="term">%N </span></dt><dd><p>message score
4525
</p></dd><dt><span class="term">%n </span></dt><dd><p>author's real name (or address if missing)
4526
</p></dd><dt><span class="term">%O </span></dt><dd><p>original save folder where mutt would formerly have
5073
</td></tr><tr><td>%m </td><td>total number of message in the mailbox
5074
</td></tr><tr><td>%M </td><td>number of hidden messages if the thread is collapsed.
5075
</td></tr><tr><td>%N </td><td>message score
5076
</td></tr><tr><td>%n </td><td>author's real name (or address if missing)
5077
</td></tr><tr><td>%O </td><td>original save folder where mutt would formerly have
4527
5078
stashed the message: list name or recipient name
4528
5079
if not sent to a list
4529
</p></dd><dt><span class="term">%P </span></dt><dd><p>progress indicator for the builtin pager (how much of the file has been displayed)
4530
</p></dd><dt><span class="term">%s </span></dt><dd><p>subject of the message
4531
</p></dd><dt><span class="term">%S </span></dt><dd><p>status of the message (“<span class="quote">N</span>”/“<span class="quote">D</span>”/“<span class="quote">d</span>”/“<span class="quote">!</span>”/“<span class="quote">r</span>”/*)
4532
</p></dd><dt><span class="term">%t </span></dt><dd><p>“<span class="quote">To:</span>” field (recipients)
4533
</p></dd><dt><span class="term">%T </span></dt><dd><p>the appropriate character from the <a class="link" href="#to-chars" title="3.290. to_chars">$to_chars</a> string
4534
</p></dd><dt><span class="term">%u </span></dt><dd><p>user (login) name of the author
4535
</p></dd><dt><span class="term">%v </span></dt><dd><p>first name of the author, or the recipient if the message is from you
4536
</p></dd><dt><span class="term">%X </span></dt><dd><p>number of attachments
5080
</td></tr><tr><td>%P </td><td>progress indicator for the builtin pager (how much of the file has been displayed)
5081
</td></tr><tr><td>%s </td><td>subject of the message
5082
</td></tr><tr><td>%S </td><td>status of the message (“<span class="quote">N</span>”/“<span class="quote">D</span>”/“<span class="quote">d</span>”/“<span class="quote">!</span>”/“<span class="quote">r</span>”/*)
5083
</td></tr><tr><td>%t </td><td>“<span class="quote">To:</span>” field (recipients)
5084
</td></tr><tr><td>%T </td><td>the appropriate character from the <a class="link" href="#to-chars" title="3.293. to_chars">$to_chars</a> string
5085
</td></tr><tr><td>%u </td><td>user (login) name of the author
5086
</td></tr><tr><td>%v </td><td>first name of the author, or the recipient if the message is from you
5087
</td></tr><tr><td>%X </td><td>number of attachments
4537
5088
(please see the “<span class="quote"><a class="link" href="#attachments" title="6. Attachment Searching and Counting">attachments</a></span>” section for possible speed effects)
4538
</p></dd><dt><span class="term">%y </span></dt><dd><p>“<span class="quote">X-Label:</span>” field, if present
4539
</p></dd><dt><span class="term">%Y </span></dt><dd><p>“<span class="quote">X-Label:</span>” field, if present, and <span class="emphasis"><em>(1)</em></span> not at part of a thread tree,
5089
</td></tr><tr><td>%y </td><td>“<span class="quote">X-Label:</span>” field, if present
5090
</td></tr><tr><td>%Y </td><td>“<span class="quote">X-Label:</span>” field, if present, and <span class="emphasis"><em>(1)</em></span> not at part of a thread tree,
4540
5091
<span class="emphasis"><em>(2)</em></span> at the top of a thread, or <span class="emphasis"><em>(3)</em></span> “<span class="quote">X-Label:</span>” is different from
4541
5092
preceding message's “<span class="quote">X-Label:</span>”.
4542
</p></dd><dt><span class="term">%Z </span></dt><dd><p>message status flags
4543
</p></dd><dt><span class="term">%{fmt} </span></dt><dd><p>the date and time of the message is converted to sender's
4544
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
4545
<code class="literal">strftime(3)</code>; a leading bang disables locales
4546
</p></dd><dt><span class="term">%[fmt] </span></dt><dd><p>the date and time of the message is converted to the local
4547
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
4548
<code class="literal">strftime(3)</code>; a leading bang disables locales
4549
</p></dd><dt><span class="term">%(fmt) </span></dt><dd><p>the local date and time when the message was received.
5093
</td></tr><tr><td>%Z </td><td>message status flags
5094
</td></tr><tr><td>%{fmt} </td><td>the date and time of the message is converted to sender's
5095
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
5096
<code class="literal">strftime(3)</code>; a leading bang disables locales
5097
</td></tr><tr><td>%[fmt] </td><td>the date and time of the message is converted to the local
5098
time zone, and “<span class="quote">fmt</span>” is expanded by the library function
5099
<code class="literal">strftime(3)</code>; a leading bang disables locales
5100
</td></tr><tr><td>%(fmt) </td><td>the local date and time when the message was received.
4550
5101
“<span class="quote">fmt</span>” is expanded by the library function <code class="literal">strftime(3)</code>;
4551
5102
a leading bang disables locales
4552
</p></dd><dt><span class="term">%<fmt> </span></dt><dd><p>the current local time. “<span class="quote">fmt</span>” is expanded by the library
5103
</td></tr><tr><td>%<fmt> </td><td>the current local time. “<span class="quote">fmt</span>” is expanded by the library
4553
5104
function <code class="literal">strftime(3)</code>; a leading bang disables locales.
4554
</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character “<span class="quote">X</span>”
4555
</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character “<span class="quote">X</span>”
4556
</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character “<span class="quote">X</span>” as pad
4557
</p></dd></dl></div><p>
5105
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character “<span class="quote">X</span>”
5106
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character “<span class="quote">X</span>”
5107
</td></tr><tr><td>%*X </td><td>soft-fill with character “<span class="quote">X</span>” as pad
5108
</td></tr></tbody></table></div><p>
4558
5109
“<span class="quote">Soft-fill</span>” deserves some explanation: Normal right-justification
4559
5110
will print everything to the left of the “<span class="quote">%></span>”, displaying padding and
4560
5111
whatever lies to the right only if there's room. By contrast,
4594
5145
<span class="bold"><strong>DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
4595
5146
DOING!</strong></span>
4596
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache"></a>3.108. header_cache</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4597
Default: (empty)</p></div><p>
4598
This variable points to the header cache database.
4599
If pointing to a directory Mutt will contain a header cache
4600
database file per folder, if pointing to a file that file will
4601
be a single global header cache. By default it is <span class="emphasis"><em>unset</em></span> so no header
4602
caching will be used.
4604
Header caching can greatly improve speed when opening POP, IMAP
4605
MH or Maildir folders, see “<span class="quote"><a class="link" href="#caching" title="7. Local caching">caching</a></span>” for details.
4606
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.109. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5147
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.121. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4607
5148
Default: yes</p></div><p>
4608
5149
Check for Maildir unaware programs other than mutt having modified maildir
4609
5150
files when the header cache is in use. This incurs one <code class="literal">stat(2)</code> per
4610
5151
message every time the folder is opened (which can be very slow for NFS
4612
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-pagesize"></a>3.110. header_cache_pagesize</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4613
Default: “<span class="quote"><code class="literal">16384</code></span>”</p></div><p>
4614
When mutt is compiled with either gdbm or bdb4 as the header cache backend,
4615
this option changes the database page size. Too large or too small
4616
values can waste space, memory, or CPU time. The default should be more
4617
or less optimal for most use cases.
4618
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-compress"></a>3.111. header_cache_compress</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4619
Default: yes</p></div><p>
4620
When mutt is compiled with qdbm or tokyocabinet as header cache backend,
4621
this option determines whether the database will be compressed.
4622
Compression results in database files roughly being one fifth
4623
of the usual diskspace, but the uncompression can result in a
4624
slower opening of cached folder(s) which in general is still
4625
much faster than opening non header cached folders.
4626
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.112. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5153
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.122. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4627
5154
Default: no</p></div><p>
4628
5155
If <span class="emphasis"><em>set</em></span>, messages marked as deleted will be saved with the maildir
4629
5156
trashed flag instead of unlinked. <span class="bold"><strong>Note:</strong></span> this only applies
4630
5157
to maildir-style mailboxes. Setting it will have no effect on other
4632
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.113. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5159
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.123. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4633
5160
Default: yes</p></div><p>
4634
5161
Controls whether or not mutt marks <span class="emphasis"><em>new</em></span> <span class="bold"><strong>unread</strong></span>
4635
5162
messages as <span class="emphasis"><em>old</em></span> if you exit a mailbox without reading them.
4636
5163
With this option <span class="emphasis"><em>set</em></span>, the next time you start mutt, the messages
4637
5164
will show up with an “<span class="quote">O</span>” next to them in the index menu,
4638
5165
indicating that they are old.
4639
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.114. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5166
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.124. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4640
5167
Default: yes</p></div><p>
4641
5168
Controls the display of wrapped lines in the internal pager. If set, a
4642
5169
“<span class="quote">+</span>” marker is displayed at the beginning of wrapped lines.
4644
Also see the <a class="link" href="#smart-wrap" title="3.265. smart_wrap">$smart_wrap</a> variable.
4645
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.115. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
5171
Also see the <a class="link" href="#smart-wrap" title="3.238. smart_wrap">$smart_wrap</a> variable.
5172
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.125. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
4646
5173
Default: “<span class="quote"><code class="literal">!^\.[^.]</code></span>”</p></div><p>
4647
5174
A regular expression used in the file browser, optionally preceded by
4648
5175
the <span class="emphasis"><em>not</em></span> operator “<span class="quote">!</span>”. Only files whose names match this mask
4649
5176
will be shown. The match is always case-sensitive.
4650
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.116. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5177
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.126. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4651
5178
Default: “<span class="quote"><code class="literal">˜/mbox</code></span>”</p></div><p>
4652
This specifies the folder into which read mail in your <a class="link" href="#spoolfile" title="3.277. spoolfile">$spoolfile</a>
5179
This specifies the folder into which read mail in your <a class="link" href="#spoolfile" title="3.269. spoolfile">$spoolfile</a>
4653
5180
folder will be appended.
4655
Also see the <a class="link" href="#move" title="3.132. move">$move</a> variable.
4656
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.117. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />
5182
Also see the <a class="link" href="#move" title="3.145. move">$move</a> variable.
5183
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.127. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />
4657
5184
Default: mbox</p></div><p>
4658
5185
The default mailbox type used when creating new folders. May be any of
4659
“<span class="quote">mbox</span>”, “<span class="quote">MMDF</span>”, “<span class="quote">MH</span>” and “<span class="quote">Maildir</span>”.
4660
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="metoo"></a>3.118. metoo</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4661
Default: no</p></div><p>
4662
If <span class="emphasis"><em>unset</em></span>, Mutt will remove your address (see the “<span class="quote"><a class="link" href="#alternates" title="11. Alternative addresses">alternates</a></span>”
4663
command) from the list of recipients when replying to a message.
4664
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.119. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5186
“<span class="quote">mbox</span>”, “<span class="quote">MMDF</span>”, “<span class="quote">MH</span>” and “<span class="quote">Maildir</span>”. This is overriden by the
5187
<code class="literal">-m</code> command-line option.
5188
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.128. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
4665
5189
Default: 0</p></div><p>
4666
5190
This variable controls the number of lines of context that are given
4667
when scrolling through menus. (Similar to <a class="link" href="#pager-context" title="3.139. pager_context">$pager_context</a>.)
4668
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.120. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5191
when scrolling through menus. (Similar to <a class="link" href="#pager-context" title="3.149. pager_context">$pager_context</a>.)
5192
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.129. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4669
5193
Default: yes</p></div><p>
4670
5194
When <span class="emphasis"><em>unset</em></span>, the bottom entry of menus will never scroll up past
4671
5195
the bottom of the screen, unless there are less entries than lines.
4672
5196
When <span class="emphasis"><em>set</em></span>, the bottom entry may move off the bottom.
4673
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.121. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5197
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.130. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4674
5198
Default: no</p></div><p>
4675
5199
When <span class="emphasis"><em>set</em></span>, menus will be scrolled up or down one line when you
4676
5200
attempt to move across a screen boundary. If <span class="emphasis"><em>unset</em></span>, the screen
4677
5201
is cleared and the next or previous page of the menu is displayed
4678
5202
(useful for slow links to avoid many redraws).
4679
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.122. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5203
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.131. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5204
Default: no</p></div><p>
5205
If <span class="emphasis"><em>set</em></span>, mutt will clean out obsolete entries from the message cache when
5206
the mailbox is synchronized. You probably only want to set it
5207
every once in a while, since it can be a little slow
5208
(especially for large folders).
5209
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.132. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5210
Default: (empty)</p></div><p>
5211
Set this to a directory and mutt will cache copies of messages from
5212
your IMAP and POP servers here. You are free to remove entries at any
5215
When setting this variable to a directory, mutt needs to fetch every
5216
remote message only once and can perform regular expression searches
5217
as fast as for local folders.
5219
Also see the <a class="link" href="#message-cache-clean" title="3.131. message_cache_clean">$message_cache_clean</a> variable.
5220
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.133. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5221
Default: “<span class="quote"><code class="literal">%s</code></span>”</p></div><p>
5222
This is the string displayed in the “<span class="quote">attachment</span>” menu for
5223
attachments of type <code class="literal">message/rfc822</code>. For a full listing of defined
5224
<code class="literal">printf(3)</code>-like sequences see the section on <a class="link" href="#index-format" title="3.114. index_format">$index_format</a>.
5225
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.134. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4680
5226
Default: no</p></div><p>
4681
5227
If <span class="emphasis"><em>set</em></span>, forces Mutt to interpret keystrokes with the high bit (bit 8)
4682
5228
set as if the user had pressed the Esc key and whatever key remains
4712
5262
to switch between MIME and not MIME from mail to mail, set this
4713
5263
variable to “<span class="quote">ask-no</span>” or “<span class="quote">ask-yes</span>”.
4715
Also see <a class="link" href="#forward-decode" title="3.62. forward_decode">$forward_decode</a> and <a class="link" href="#mime-forward-decode" title="3.128. mime_forward_decode">$mime_forward_decode</a>.
4716
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.128. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5265
Also see <a class="link" href="#forward-decode" title="3.70. forward_decode">$forward_decode</a> and <a class="link" href="#mime-forward-decode" title="3.141. mime_forward_decode">$mime_forward_decode</a>.
5266
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.141. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4717
5267
Default: no</p></div><p>
4718
5268
Controls the decoding of complex MIME messages into <code class="literal">text/plain</code> when
4719
forwarding a message while <a class="link" href="#mime-forward" title="3.127. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span>. Otherwise
4720
<a class="link" href="#forward-decode" title="3.62. forward_decode">$forward_decode</a> is used instead.
4721
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.129. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5269
forwarding a message while <a class="link" href="#mime-forward" title="3.140. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span>. Otherwise
5270
<a class="link" href="#forward-decode" title="3.70. forward_decode">$forward_decode</a> is used instead.
5271
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.142. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
4722
5272
Default: yes</p></div><p>
4723
5273
When forwarding multiple attachments of a MIME message from the attachment
4724
5274
menu, attachments which cannot be decoded in a reasonable manner will
4725
5275
be attached to the newly composed message if this option is <span class="emphasis"><em>set</em></span>.
4726
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.130. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5276
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.143. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4727
5277
Default: “<span class="quote"><code class="literal">%4n %c %-16s %a</code></span>”</p></div><p>
4728
5278
This variable describes the format of a remailer line on the mixmaster
4729
5279
chain selection screen. The following <code class="literal">printf(3)</code>-like sequences are
4732
</p><div class="variablelist"><dl><dt><span class="term">%n </span></dt><dd><p>The running number on the menu.
4733
</p></dd><dt><span class="term">%c </span></dt><dd><p>Remailer capabilities.
4734
</p></dd><dt><span class="term">%s </span></dt><dd><p>The remailer's short name.
4735
</p></dd><dt><span class="term">%a </span></dt><dd><p>The remailer's e-mail address.
4736
</p></dd></dl></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.131. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5282
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>The running number on the menu.
5283
</td></tr><tr><td>%c </td><td>Remailer capabilities.
5284
</td></tr><tr><td>%s </td><td>The remailer's short name.
5285
</td></tr><tr><td>%a </td><td>The remailer's e-mail address.
5286
</td></tr></tbody></table></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.144. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4737
5287
Default: “<span class="quote"><code class="literal">mixmaster</code></span>”</p></div><p>
4738
5288
This variable contains the path to the Mixmaster binary on your
4739
5289
system. It is used with various sets of parameters to gather the
4740
5290
list of known remailers, and to finally send a message through the
4741
5291
mixmaster chain.
4742
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.132. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5292
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.145. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
4743
5293
Default: no</p></div><p>
4744
5294
Controls whether or not Mutt will move read messages
4745
from your spool mailbox to your <a class="link" href="#mbox" title="3.116. mbox">$mbox</a> mailbox, or as a result of
4746
a “<span class="quote"><a class="link" href="#mbox-hook" title="13. Using Multiple spool mailboxes">mbox-hook</a></span>” command.
4747
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.133. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4748
Default: (empty)</p></div><p>
4749
Set this to a directory and mutt will cache copies of messages from
4750
your IMAP and POP servers here. You are free to remove entries at any
4753
When setting this variable to a directory, mutt needs to fetch every
4754
remote message only once and can perform regular expression searches
4755
as fast as for local folders.
4757
Also see the <a class="link" href="#message-cache-clean" title="3.134. message_cache_clean">$message_cache_clean</a> variable.
4758
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.134. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4759
Default: no</p></div><p>
4760
If <span class="emphasis"><em>set</em></span>, mutt will clean out obsolete entries from the message cache when
4761
the mailbox is synchronized. You probably only want to set it
4762
every once in a while, since it can be a little slow
4763
(especially for large folders).
4764
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.135. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4765
Default: “<span class="quote"><code class="literal">%s</code></span>”</p></div><p>
4766
This is the string displayed in the “<span class="quote">attachment</span>” menu for
4767
attachments of type <code class="literal">message/rfc822</code>. For a full listing of defined
4768
<code class="literal">printf(3)</code>-like sequences see the section on <a class="link" href="#index-format" title="3.101. index_format">$index_format</a>.
4769
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.136. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5295
from your spool mailbox to your <a class="link" href="#mbox" title="3.126. mbox">$mbox</a> mailbox, or as a result of
5296
a “<span class="quote"><a class="link" href="#mbox-hook" title="13. Using Multiple Spool Mailboxes">mbox-hook</a></span>” command.
5297
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.146. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4770
5298
Default: no</p></div><p>
4771
5299
This variable, when <span class="emphasis"><em>set</em></span>, makes the thread tree narrower, allowing
4772
5300
deeper threads to fit on the screen.
4773
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.137. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5301
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.147. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
4774
5302
Default: 10</p></div><p>
4775
5303
Operations that expect to transfer a large amount of data over the
4776
network will update their progress every <a class="link" href="#net-inc" title="3.137. net_inc">$net_inc</a> kilobytes.
5304
network will update their progress every <a class="link" href="#net-inc" title="3.147. net_inc">$net_inc</a> kilobytes.
4777
5305
If set to 0, no progress messages will be displayed.
4779
See also <a class="link" href="#read-inc" title="3.236. read_inc">$read_inc</a>, <a class="link" href="#write-inc" title="3.305. write_inc">$write_inc</a> and <a class="link" href="#net-inc" title="3.137. net_inc">$net_inc</a>.
4780
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.138. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5307
See also <a class="link" href="#read-inc" title="3.207. read_inc">$read_inc</a>, <a class="link" href="#write-inc" title="3.310. write_inc">$write_inc</a> and <a class="link" href="#net-inc" title="3.147. net_inc">$net_inc</a>.
5308
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.148. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />
4781
5309
Default: “<span class="quote"><code class="literal">builtin</code></span>”</p></div><p>
4782
5310
This variable specifies which pager you would like to use to view
4783
5311
messages. The value “<span class="quote">builtin</span>” means to use the builtin pager, otherwise this
4811
5343
for the status bar from the index, so a setting of 6
4812
5344
will only show 5 lines of the actual index. A value of 0 results in
4813
5345
no index being shown. If the number of messages in the current folder
4814
is less than <a class="link" href="#pager-index-lines" title="3.141. pager_index_lines">$pager_index_lines</a>, then the index will only use as
5346
is less than <a class="link" href="#pager-index-lines" title="3.151. pager_index_lines">$pager_index_lines</a>, then the index will only use as
4815
5347
many lines as it needs.
4816
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.142. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5348
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.152. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4817
5349
Default: no</p></div><p>
4818
5350
When <span class="emphasis"><em>set</em></span>, the internal-pager will <span class="bold"><strong>not</strong></span> move to the next message
4819
5351
when you are at the end of a message and invoke the <code class="literal"><next-page></code>
4821
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.143. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4822
Default: no</p></div><p>
4823
Setting this variable will cause Mutt to always attempt to
4824
cryptographically sign outgoing messages. This can be overridden
4825
by use of the pgp menu, when signing is not required or
4826
encryption is requested as well. If <a class="link" href="#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
4827
then OpenSSL is used instead to create S/MIME messages and settings can
4828
be overridden by use of the smime menu instead of the pgp menu.
4830
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.144. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4831
Default: no</p></div><p>
4832
Setting this variable will cause Mutt to always attempt to PGP
4833
encrypt outgoing messages. This is probably only useful in
4834
connection to the “<span class="quote"><a class="link" href="#send-hook" title="19. Change settings based upon message recipients">send-hook</a></span>” command. It can be overridden
4835
by use of the pgp menu, when encryption is not required or
4836
signing is requested as well. If <a class="link" href="#smime-is-default" title="3.152. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
4837
then OpenSSL is used instead to create S/MIME messages and
4838
settings can be overridden by use of the smime menu instead.
4840
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.145. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4841
Default: yes</p></div><p>
4842
Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
4843
the principal key will inherit the subkeys' capabilities. <span class="emphasis"><em>Unset</em></span> this
4844
if you want to play interesting key selection games.
4846
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.146. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4847
Default: yes</p></div><p>
4848
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL encrypt replies to messages which are
4851
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.147. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4852
Default: no</p></div><p>
4853
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages which are
4856
<span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted
4857
<span class="emphasis"><em>and</em></span> signed!
4859
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.148. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4860
Default: no</p></div><p>
4861
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages
4862
which are encrypted. This makes sense in combination with
4863
<a class="link" href="#crypt-replyencrypt" title="3.146. crypt_replyencrypt">$crypt_replyencrypt</a>, because it allows you to sign all
4864
messages which are automatically encrypted. This works around
4865
the problem noted in <a class="link" href="#crypt-replysign" title="3.147. crypt_replysign">$crypt_replysign</a>, that mutt is not able
4866
to find out whether an encrypted message is also signed.
4868
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.149. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4869
Default: yes</p></div><p>
4870
If <span class="emphasis"><em>set</em></span>, mutt will include a time stamp in the lines surrounding
4871
PGP or S/MIME output, so spoofing such lines is more difficult.
4872
If you are using colors to mark these lines, and rely on these,
4873
you may <span class="emphasis"><em>unset</em></span> this setting.
4875
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.150. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4876
Default: no</p></div><p>
4877
If <span class="emphasis"><em>set</em></span>, mutt will use a possibly-running <code class="literal">gpg-agent(1)</code> process.
4879
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.151. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
4880
Default: yes</p></div><p>
4881
If <span class="emphasis"><em>“<span class="quote">yes</span>”</em></span>, always attempt to verify PGP or S/MIME signatures.
4882
If <span class="emphasis"><em>“<span class="quote">ask-*</span>”</em></span>, ask whether or not to verify the signature.
4883
If \Fi“<span class="quote">no</span>”, never attempt to verify cryptographic signatures.
4885
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.152. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4886
Default: no</p></div><p>
4887
The default behaviour of mutt is to use PGP on all auto-sign/encryption
4888
operations. To override and to use OpenSSL instead this must be <span class="emphasis"><em>set</em></span>.
4889
However, this has no effect while replying, since mutt will automatically
4890
select the same application that was used to sign/encrypt the original
4891
message. (Note that this variable can be overridden by unsetting <a class="link" href="#crypt-autosmime" title="3.39. crypt_autosmime">$crypt_autosmime</a>.)
4893
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.153. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4894
Default: yes</p></div><p>
4895
This flag controls whether you want to be asked to enter a label
4896
for a certificate about to be added to the database or not. It is
4897
<span class="emphasis"><em>set</em></span> by default.
4899
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.154. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4900
Default: yes</p></div><p>
4901
If <span class="emphasis"><em>set</em></span> (default) this tells mutt to use the default key for decryption. Otherwise,
4902
if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
4903
to determine the key to use. It will ask you to supply a key, if it can't find one.
4905
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.155. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5353
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.153. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5354
Default: no</p></div><p>
5355
If <span class="emphasis"><em>set</em></span>, mutt will automatically attempt to decrypt traditional PGP
5356
messages whenever the user performs an operation which ordinarily would
5357
result in the contents of the message being operated on. For example,
5358
if the user displays a pgp-traditional message which has not been manually
5359
checked with the <code class="literal"><a class="link" href="#check-traditional-pgp"><check-traditional-pgp></a></code> function, mutt will automatically
5360
check the message for traditional pgp.
5361
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.154. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5362
Default: no</p></div><p>
5363
This option controls whether Mutt generates old-style inline
5364
(traditional) PGP encrypted or signed messages under certain
5365
circumstances. This can be overridden by use of the pgp menu,
5366
when inline is not required.
5368
Note that Mutt might automatically use PGP/MIME for messages
5369
which consist of more than a single MIME part. Mutt can be
5370
configured to ask before sending PGP/MIME messages when inline
5371
(traditional) would not work.
5373
Also see the <a class="link" href="#pgp-mime-auto" title="3.170. pgp_mime_auto">$pgp_mime_auto</a> variable.
5375
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
5376
<span class="bold"><strong>deprecated</strong></span>.
5378
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.155. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5379
Default: yes</p></div><p>
5380
If <span class="emphasis"><em>set</em></span>, mutt will check the exit code of the PGP subprocess when
5381
signing or encrypting. A non-zero exit code means that the
5384
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.156. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5385
Default: (empty)</p></div><p>
5386
This format is used to create an old-style “<span class="quote">clearsigned</span>” PGP
5387
message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>
5388
<span class="bold"><strong>deprecated</strong></span>.
5390
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5391
possible <code class="literal">printf(3)</code>-like sequences.
5393
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.157. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5394
Default: (empty)</p></div><p>
5395
This format strings specifies a command which is used to decode
5396
application/pgp attachments.
5398
The PGP command formats have their own set of <code class="literal">printf(3)</code>-like sequences:
5400
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%p </td><td>Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
5401
string otherwise. Note: This may be used with a %? construct.
5402
</td></tr><tr><td>%f </td><td>Expands to the name of a file containing a message.
5403
</td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
5404
of a <code class="literal">multipart/signed</code> attachment when verifying it.
5405
</td></tr><tr><td>%a </td><td>The value of <a class="link" href="#pgp-sign-as" title="3.174. pgp_sign_as">$pgp_sign_as</a>.
5406
</td></tr><tr><td>%r </td><td>One or more key IDs.
5407
</td></tr></tbody></table></div><p>
5408
For examples on how to configure these formats for the various versions
5409
of PGP which are floating around, see the pgp and gpg sample configuration files in
5410
the <code class="literal">samples/</code> subdirectory which has been installed on your system
5411
alongside the documentation.
5413
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.158. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5414
Default: (empty)</p></div><p>
5415
This command is used to decrypt a PGP encrypted message.
5417
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5418
possible <code class="literal">printf(3)</code>-like sequences.
5420
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.159. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5421
Default: (empty)</p></div><p>
5422
This command is used to encrypt a body part without signing it.
5424
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5425
possible <code class="literal">printf(3)</code>-like sequences.
5427
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.160. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5428
Default: (empty)</p></div><p>
5429
This command is used to both sign and encrypt a body part.
5431
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5432
possible <code class="literal">printf(3)</code>-like sequences.
5434
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.161. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4906
5435
Default: “<span class="quote"><code class="literal">%4n %t%f %4l/0x%k %-4a %2c %u</code></span>”</p></div><p>
4907
5436
This variable allows you to customize the PGP key selection menu to
4908
your personal taste. This string is similar to <a class="link" href="#index-format" title="3.101. index_format">$index_format</a>, but
5437
your personal taste. This string is similar to <a class="link" href="#index-format" title="3.114. index_format">$index_format</a>, but
4909
5438
has its own set of <code class="literal">printf(3)</code>-like sequences:
4911
</p><div class="variablelist"><dl><dt><span class="term">%n </span></dt><dd><p>number
4912
</p></dd><dt><span class="term">%k </span></dt><dd><p>key id
4913
</p></dd><dt><span class="term">%u </span></dt><dd><p>user id
4914
</p></dd><dt><span class="term">%a </span></dt><dd><p>algorithm
4915
</p></dd><dt><span class="term">%l </span></dt><dd><p>key length
4916
</p></dd><dt><span class="term">%f </span></dt><dd><p>flags
4917
</p></dd><dt><span class="term">%c </span></dt><dd><p>capabilities
4918
</p></dd><dt><span class="term">%t </span></dt><dd><p>trust/validity of the key-uid association
4919
</p></dd><dt><span class="term">%[<s>] </span></dt><dd><p>date of the key where <s> is an <code class="literal">strftime(3)</code> expression
4920
</p></dd></dl></div><p>
4922
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.156. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
5440
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>number
5441
</td></tr><tr><td>%k </td><td>key id
5442
</td></tr><tr><td>%u </td><td>user id
5443
</td></tr><tr><td>%a </td><td>algorithm
5444
</td></tr><tr><td>%l </td><td>key length
5445
</td></tr><tr><td>%f </td><td>flags
5446
</td></tr><tr><td>%c </td><td>capabilities
5447
</td></tr><tr><td>%t </td><td>trust/validity of the key-uid association
5448
</td></tr><tr><td>%[<s>] </td><td>date of the key where <s> is an <code class="literal">strftime(3)</code> expression
5449
</td></tr></tbody></table></div><p>
5451
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.162. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5452
Default: (empty)</p></div><p>
5453
This command is used to export a public key from the user's
5456
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5457
possible <code class="literal">printf(3)</code>-like sequences.
5459
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.163. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5460
Default: (empty)</p></div><p>
5461
This command is invoked whenever mutt will need public key information.
5462
Of the sequences supported by <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a>, %r is the only
5463
<code class="literal">printf(3)</code>-like sequence used with this format.
5465
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.164. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
4923
5466
Default: (empty)</p></div><p>
4924
5467
If you assign a text to this variable, then a PGP signature is only
4925
considered verified if the output from <a class="link" href="#pgp-verify-command" title="3.171. pgp_verify_command">$pgp_verify_command</a> contains
5468
considered verified if the output from <a class="link" href="#pgp-verify-command" title="3.180. pgp_verify_command">$pgp_verify_command</a> contains
4926
5469
the text. Use this variable if the exit code from the command is 0
4927
5470
even for bad signatures.
4929
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.157. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5472
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.165. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4930
5473
Default: yes</p></div><p>
4931
If <span class="emphasis"><em>set</em></span>, mutt will check the exit code of the PGP subprocess when
4932
signing or encrypting. A non-zero exit code means that the
4935
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.158. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5474
Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
5475
the principal key will inherit the subkeys' capabilities. <span class="emphasis"><em>Unset</em></span> this
5476
if you want to play interesting key selection games.
5478
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.166. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5479
Default: (empty)</p></div><p>
5480
This command is used to import a key from a message into
5481
the user's public key ring.
5483
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5484
possible <code class="literal">printf(3)</code>-like sequences.
5486
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.167. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5487
Default: (empty)</p></div><p>
5488
This command is used to list the public key ring's contents. The
5489
output format must be analogous to the one used by
5491
</p><pre class="screen">
5492
gpg --list-keys --with-colons.
5494
This format is also generated by the <code class="literal">pgpring</code> utility which comes
5497
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5498
possible <code class="literal">printf(3)</code>-like sequences.
5500
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.168. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5501
Default: (empty)</p></div><p>
5502
This command is used to list the secret key ring's contents. The
5503
output format must be analogous to the one used by:
5505
</p><pre class="screen">
5506
gpg --list-keys --with-colons.
5508
This format is also generated by the <code class="literal">pgpring</code> utility which comes
5511
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5512
possible <code class="literal">printf(3)</code>-like sequences.
5514
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.169. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4936
5515
Default: no</p></div><p>
4937
5516
If <span class="emphasis"><em>set</em></span>, use 64 bit PGP key IDs, if <span class="emphasis"><em>unset</em></span> use the normal 32 bit key IDs.
4939
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.159. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4940
Default: no</p></div><p>
4941
If <span class="emphasis"><em>set</em></span>, signed and encrypted messages will consist of nested
4942
<code class="literal">multipart/signed</code> and <code class="literal">multipart/encrypted</code> body parts.
4944
This is useful for applications like encrypted and signed mailing
4945
lists, where the outer layer (<code class="literal">multipart/encrypted</code>) can be easily
4946
removed, while the inner <code class="literal">multipart/signed</code> part is retained.
4948
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.160. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4949
Default: no</p></div><p>
4950
This option controls whether Mutt generates old-style inline
4951
(traditional) PGP encrypted or signed messages under certain
4952
circumstances. This can be overridden by use of the pgp menu,
4953
when inline is not required.
4955
Note that Mutt might automatically use PGP/MIME for messages
4956
which consist of more than a single MIME part. Mutt can be
4957
configured to ask before sending PGP/MIME messages when inline
4958
(traditional) would not work.
4960
Also see the <a class="link" href="#pgp-mime-auto" title="3.167. pgp_mime_auto">$pgp_mime_auto</a> variable.
5518
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.170. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5519
Default: ask-yes</p></div><p>
5520
This option controls whether Mutt will prompt you for
5521
automatically sending a (signed/encrypted) message using
5522
PGP/MIME when inline (traditional) fails (for any reason).
4962
5524
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
4963
5525
<span class="bold"><strong>deprecated</strong></span>.
4965
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.161. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5527
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.171. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4966
5528
Default: no</p></div><p>
4967
5529
Setting this variable will cause Mutt to always attempt to
4968
5530
create an inline (traditional) message when replying to a
4977
5539
configured to ask before sending PGP/MIME messages when inline
4978
5540
(traditional) would not work.
4980
Also see the <a class="link" href="#pgp-mime-auto" title="3.167. pgp_mime_auto">$pgp_mime_auto</a> variable.
5542
Also see the <a class="link" href="#pgp-mime-auto" title="3.170. pgp_mime_auto">$pgp_mime_auto</a> variable.
4982
5544
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
4983
5545
<span class="bold"><strong>deprecated</strong></span>.
4985
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.162. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5547
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.172. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5548
Default: no</p></div><p>
5549
If <span class="emphasis"><em>set</em></span>, signed and encrypted messages will consist of nested
5550
<code class="literal">multipart/signed</code> and <code class="literal">multipart/encrypted</code> body parts.
5552
This is useful for applications like encrypted and signed mailing
5553
lists, where the outer layer (<code class="literal">multipart/encrypted</code>) can be easily
5554
removed, while the inner <code class="literal">multipart/signed</code> part is retained.
5556
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.173. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4986
5557
Default: yes</p></div><p>
4987
5558
If <span class="emphasis"><em>set</em></span>, mutt will display non-usable keys on the PGP key selection
4988
5559
menu. This includes keys which have been revoked, have expired, or
4989
5560
have been marked as “<span class="quote">disabled</span>” by the user.
4991
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.163. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5562
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.174. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
4992
5563
Default: (empty)</p></div><p>
4993
5564
If you have more than one key pair, this option allows you to specify
4994
5565
which of your private keys to use. It is recommended that you use the
4995
5566
keyid form to specify your key (e.g. <code class="literal">0x00112233</code>).
4997
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.164. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5568
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.175. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5569
Default: (empty)</p></div><p>
5570
This command is used to create the detached PGP signature for a
5571
<code class="literal">multipart/signed</code> PGP/MIME body part.
5573
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5574
possible <code class="literal">printf(3)</code>-like sequences.
5576
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.176. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
5577
Default: address</p></div><p>
5578
Specifies how the entries in the pgp menu are sorted. The
5579
following are legal values:
5581
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>address </td><td>sort alphabetically by user id
5582
</td></tr><tr><td>keyid </td><td>sort alphabetically by key id
5583
</td></tr><tr><td>date </td><td>sort by key creation date
5584
</td></tr><tr><td>trust </td><td>sort by the trust of the key
5585
</td></tr></tbody></table></div><p>
5586
If you prefer reverse order of the above values, prefix it with
5587
“<span class="quote">reverse-</span>”.
5589
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.177. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
4998
5590
Default: yes</p></div><p>
4999
5591
If <span class="emphasis"><em>set</em></span>, Mutt will automatically encode PGP/MIME signed messages as
5000
5592
quoted-printable. Please note that unsetting this variable may
5001
5593
lead to problems with non-verifyable PGP signatures, so only change
5002
5594
this if you know what you are doing.
5004
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.165. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5596
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.178. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5005
5597
Default: 300</p></div><p>
5006
5598
The number of seconds after which a cached passphrase will expire if
5009
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.166. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
5010
Default: address</p></div><p>
5011
Specifies how the entries in the pgp menu are sorted. The
5012
following are legal values:
5014
</p><div class="variablelist"><dl><dt><span class="term">address </span></dt><dd><p>sort alphabetically by user id
5015
</p></dd><dt><span class="term">keyid </span></dt><dd><p>sort alphabetically by key id
5016
</p></dd><dt><span class="term">date </span></dt><dd><p>sort by key creation date
5017
</p></dd><dt><span class="term">trust </span></dt><dd><p>sort by the trust of the key
5018
</p></dd></dl></div><p>
5019
If you prefer reverse order of the above values, prefix it with
5020
“<span class="quote">reverse-</span>”.
5022
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.167. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5023
Default: ask-yes</p></div><p>
5024
This option controls whether Mutt will prompt you for
5025
automatically sending a (signed/encrypted) message using
5026
PGP/MIME when inline (traditional) fails (for any reason).
5028
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
5029
<span class="bold"><strong>deprecated</strong></span>.
5031
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.168. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5601
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.179. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5032
5602
Default: no</p></div><p>
5033
If <span class="emphasis"><em>set</em></span>, mutt will automatically attempt to decrypt traditional PGP
5034
messages whenever the user performs an operation which ordinarily would
5035
result in the contents of the message being operated on. For example,
5036
if the user displays a pgp-traditional message which has not been manually
5037
checked with the <code class="literal"><a class="link" href="#check-traditional-pgp"><check-traditional-pgp></a></code> function, mutt will automatically
5038
check the message for traditional pgp.
5039
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.169. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5040
Default: (empty)</p></div><p>
5041
This format strings specifies a command which is used to decode
5042
application/pgp attachments.
5044
The PGP command formats have their own set of <code class="literal">printf(3)</code>-like sequences:
5046
</p><div class="variablelist"><dl><dt><span class="term">%p </span></dt><dd><p>Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
5047
string otherwise. Note: This may be used with a %? construct.
5048
</p></dd><dt><span class="term">%f </span></dt><dd><p>Expands to the name of a file containing a message.
5049
</p></dd><dt><span class="term">%s </span></dt><dd><p>Expands to the name of a file containing the signature part
5050
of a <code class="literal">multipart/signed</code> attachment when verifying it.
5051
</p></dd><dt><span class="term">%a </span></dt><dd><p>The value of <a class="link" href="#pgp-sign-as" title="3.163. pgp_sign_as">$pgp_sign_as</a>.
5052
</p></dd><dt><span class="term">%r </span></dt><dd><p>One or more key IDs.
5053
</p></dd></dl></div><p>
5054
For examples on how to configure these formats for the various versions
5055
of PGP which are floating around, see the pgp and gpg sample configuration files in
5056
the <code class="literal">samples/</code> subdirectory which has been installed on your system
5057
alongside the documentation.
5059
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.170. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5060
Default: (empty)</p></div><p>
5061
This command is invoked whenever mutt will need public key information.
5062
Of the sequences supported by <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a>, %r is the only
5063
<code class="literal">printf(3)</code>-like sequence used with this format.
5065
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.171. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5603
If <span class="emphasis"><em>set</em></span>, mutt will use a possibly-running <code class="literal">gpg-agent(1)</code> process.
5605
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.180. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5066
5606
Default: (empty)</p></div><p>
5067
5607
This command is used to verify PGP signatures.
5069
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5070
possible <code class="literal">printf(3)</code>-like sequences.
5072
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.172. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5073
Default: (empty)</p></div><p>
5074
This command is used to decrypt a PGP encrypted message.
5076
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5077
possible <code class="literal">printf(3)</code>-like sequences.
5079
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.173. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5080
Default: (empty)</p></div><p>
5081
This format is used to create a old-style “<span class="quote">clearsigned</span>” PGP
5082
message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>
5083
<span class="bold"><strong>deprecated</strong></span>.
5085
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5086
possible <code class="literal">printf(3)</code>-like sequences.
5088
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.174. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5089
Default: (empty)</p></div><p>
5090
This command is used to create the detached PGP signature for a
5091
<code class="literal">multipart/signed</code> PGP/MIME body part.
5093
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5094
possible <code class="literal">printf(3)</code>-like sequences.
5096
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.175. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5097
Default: (empty)</p></div><p>
5098
This command is used to both sign and encrypt a body part.
5100
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5101
possible <code class="literal">printf(3)</code>-like sequences.
5103
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.176. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5104
Default: (empty)</p></div><p>
5105
This command is used to encrypt a body part without signing it.
5107
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5108
possible <code class="literal">printf(3)</code>-like sequences.
5110
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.177. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5111
Default: (empty)</p></div><p>
5112
This command is used to import a key from a message into
5113
the user's public key ring.
5115
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5116
possible <code class="literal">printf(3)</code>-like sequences.
5118
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.178. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5119
Default: (empty)</p></div><p>
5120
This command is used to export a public key from the user's
5123
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5124
possible <code class="literal">printf(3)</code>-like sequences.
5126
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.179. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5609
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5610
possible <code class="literal">printf(3)</code>-like sequences.
5612
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.181. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5127
5613
Default: (empty)</p></div><p>
5128
5614
This command is used to verify key information from the key selection
5131
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5132
possible <code class="literal">printf(3)</code>-like sequences.
5134
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.180. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5135
Default: (empty)</p></div><p>
5136
This command is used to list the secret key ring's contents. The
5137
output format must be analogous to the one used by:
5139
</p><pre class="screen">
5140
gpg --list-keys --with-colons.
5143
This format is also generated by the <code class="literal">pgpring</code> utility which comes
5146
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5147
possible <code class="literal">printf(3)</code>-like sequences.
5149
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.181. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5150
Default: (empty)</p></div><p>
5151
This command is used to list the public key ring's contents. The
5152
output format must be analogous to the one used by
5154
</p><pre class="screen">
5155
gpg --list-keys --with-colons.
5158
This format is also generated by the <code class="literal">pgpring</code> utility which comes
5161
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.169. pgp_decode_command">$pgp_decode_command</a> command for
5162
possible <code class="literal">printf(3)</code>-like sequences.
5164
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decrypt"></a>3.182. forward_decrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5165
Default: yes</p></div><p>
5166
Controls the handling of encrypted messages when forwarding a message.
5167
When <span class="emphasis"><em>set</em></span>, the outer layer of encryption is stripped off. This
5168
variable is only used if <a class="link" href="#mime-forward" title="3.127. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span> and
5169
<a class="link" href="#mime-forward-decode" title="3.128. mime_forward_decode">$mime_forward_decode</a> is <span class="emphasis"><em>unset</em></span>.
5171
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.183. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5172
Default: 300</p></div><p>
5173
The number of seconds after which a cached passphrase will expire if
5176
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.184. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5177
Default: (empty)</p></div><p>
5178
This sets the algorithm that should be used for encryption.
5179
Valid choices are “<span class="quote">des</span>”, “<span class="quote">des3</span>”, “<span class="quote">rc2-40</span>”, “<span class="quote">rc2-64</span>”, “<span class="quote">rc2-128</span>”.
5180
If <span class="emphasis"><em>unset</em></span>, “<span class="quote">3des</span>” (TripleDES) is used.
5182
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.185. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5183
Default: (empty)</p></div><p>
5184
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
5185
storage and retrieval of keys/certs by itself. This is very basic right now,
5186
and stores keys and certificates in two different directories, both
5187
named as the hash-value retrieved from OpenSSL. There is an index file
5188
which contains mailbox-address keyid pair, and which can be manually
5189
edited. This option points to the location of the private keys.
5191
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.186. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5192
Default: (empty)</p></div><p>
5193
This variable contains the name of either a directory, or a file which
5194
contains trusted certificates for use with OpenSSL.
5196
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.187. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5197
Default: (empty)</p></div><p>
5198
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
5199
storage and retrieval of keys by itself. This is very basic right
5200
now, and keys and certificates are stored in two different
5201
directories, both named as the hash-value retrieved from
5202
OpenSSL. There is an index file which contains mailbox-address
5203
keyid pairs, and which can be manually edited. This option points to
5204
the location of the certificates.
5206
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.188. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5207
Default: (empty)</p></div><p>
5208
This format string specifies a command which is used to decrypt
5209
<code class="literal">application/x-pkcs7-mime</code> attachments.
5211
The OpenSSL command formats have their own set of <code class="literal">printf(3)</code>-like sequences
5214
</p><div class="variablelist"><dl><dt><span class="term">%f </span></dt><dd><p>Expands to the name of a file containing a message.
5215
</p></dd><dt><span class="term">%s </span></dt><dd><p>Expands to the name of a file containing the signature part
5216
of a <code class="literal">multipart/signed</code> attachment when verifying it.
5217
</p></dd><dt><span class="term">%k </span></dt><dd><p>The key-pair specified with <a class="link" href="#smime-default-key" title="3.199. smime_default_key">$smime_default_key</a>
5218
</p></dd><dt><span class="term">%c </span></dt><dd><p>One or more certificate IDs.
5219
</p></dd><dt><span class="term">%a </span></dt><dd><p>The algorithm used for encryption.
5220
</p></dd><dt><span class="term">%C </span></dt><dd><p>CA location: Depending on whether <a class="link" href="#smime-ca-location" title="3.186. smime_ca_location">$smime_ca_location</a>
5221
points to a directory or file, this expands to
5222
“<span class="quote">-CApath <a class="link" href="#smime-ca-location" title="3.186. smime_ca_location">$smime_ca_location</a></span>” or “<span class="quote">-CAfile <a class="link" href="#smime-ca-location" title="3.186. smime_ca_location">$smime_ca_location</a></span>”.
5223
</p></dd></dl></div><p>
5224
For examples on how to configure these formats, see the <code class="literal">smime.rc</code> in
5225
the <code class="literal">samples/</code> subdirectory which has been installed on your system
5226
alongside the documentation.
5228
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.189. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5229
Default: (empty)</p></div><p>
5230
This command is used to verify S/MIME signatures of type <code class="literal">multipart/signed</code>.
5232
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5233
possible <code class="literal">printf(3)</code>-like sequences.
5235
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.190. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5236
Default: (empty)</p></div><p>
5237
This command is used to verify S/MIME signatures of type
5238
<code class="literal">application/x-pkcs7-mime</code>.
5240
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5241
possible <code class="literal">printf(3)</code>-like sequences.
5243
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.191. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5244
Default: (empty)</p></div><p>
5245
This command is used to created S/MIME signatures of type
5246
<code class="literal">multipart/signed</code>, which can be read by all mail clients.
5248
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5249
possible <code class="literal">printf(3)</code>-like sequences.
5251
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.192. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5252
Default: (empty)</p></div><p>
5253
This command is used to created S/MIME signatures of type
5254
<code class="literal">application/x-pkcs7-signature</code>, which can only be handled by mail
5255
clients supporting the S/MIME extension.
5257
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5258
possible <code class="literal">printf(3)</code>-like sequences.
5260
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.193. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5261
Default: (empty)</p></div><p>
5262
This command is used to create encrypted S/MIME messages.
5264
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5265
possible <code class="literal">printf(3)</code>-like sequences.
5267
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.194. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5268
Default: (empty)</p></div><p>
5269
This command is used to extract PKCS7 structures of S/MIME signatures,
5270
in order to extract the public X509 certificate(s).
5272
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5273
possible <code class="literal">printf(3)</code>-like sequences.
5275
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.195. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5276
Default: (empty)</p></div><p>
5277
This command is used to extract X509 certificates from a PKCS7 structure.
5279
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5280
possible <code class="literal">printf(3)</code>-like sequences.
5282
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.196. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5283
Default: (empty)</p></div><p>
5284
This command is used to extract only the signers X509 certificate from a S/MIME
5285
signature, so that the certificate's owner may get compared to the
5286
email's “<span class="quote">From:</span>” field.
5288
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5289
possible <code class="literal">printf(3)</code>-like sequences.
5291
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.197. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5292
Default: (empty)</p></div><p>
5293
This command is used to import a certificate via smime_keys.
5295
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5296
possible <code class="literal">printf(3)</code>-like sequences.
5298
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.198. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5299
Default: (empty)</p></div><p>
5300
This command is used to extract the mail address(es) used for storing
5301
X509 certificates, and for verification purposes (to check whether the
5302
certificate was issued for the sender's mailbox).
5304
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.188. smime_decrypt_command">$smime_decrypt_command</a> command for
5305
possible <code class="literal">printf(3)</code>-like sequences.
5307
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.199. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5308
Default: (empty)</p></div><p>
5309
This is the default key-pair to use for signing. This must be set to the
5310
keyid (the hash-value that OpenSSL generates) to work properly
5312
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.200. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5313
Default: (empty)</p></div><p>
5314
The file containing a client certificate and its associated private
5316
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.201. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5317
Default: no</p></div><p>
5318
If this variable is <span class="emphasis"><em>set</em></span>, Mutt will require that all connections
5319
to remote servers be encrypted. Furthermore it will attempt to
5320
negotiate TLS even if the server does not advertise the capability,
5321
since it would otherwise have to abort the connection anyway. This
5322
option supersedes <a class="link" href="#ssl-starttls" title="3.202. ssl_starttls">$ssl_starttls</a>.
5323
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.202. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5324
Default: yes</p></div><p>
5325
If <span class="emphasis"><em>set</em></span> (the default), mutt will attempt to use <code class="literal">STARTTLS</code> on servers
5326
advertising the capability. When <span class="emphasis"><em>unset</em></span>, mutt will not attempt to
5327
use <code class="literal">STARTTLS</code> regardless of the server's capabilities.
5328
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="certificate-file"></a>3.203. certificate_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5329
Default: “<span class="quote"><code class="literal">˜/.mutt_certificates</code></span>”</p></div><p>
5330
This variable specifies the file where the certificates you trust
5331
are saved. When an unknown certificate is encountered, you are asked
5332
if you accept it or not. If you accept it, the certificate can also
5333
be saved in this file and further connections are automatically
5336
You can also manually add CA certificates in this file. Any server
5337
certificate that is signed with one of these CA certificates is
5338
also automatically accepted.
5342
</p><pre class="screen">
5343
set certificate_file=~/.mutt/certificates
5345
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.204. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5346
Default: yes</p></div><p>
5347
If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the
5348
system-wide certificate store when checking if a server certificate
5349
is signed by a trusted CA.
5350
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.205. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5351
Default: (empty)</p></div><p>
5352
The file which includes random data that is used to initialize SSL
5354
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.206. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5355
Default: yes</p></div><p>
5356
This variables specifies whether to attempt to use SSLv2 in the
5357
SSL authentication process.
5358
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.207. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5359
Default: yes</p></div><p>
5360
This variables specifies whether to attempt to use SSLv3 in the
5361
SSL authentication process.
5362
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.208. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5363
Default: yes</p></div><p>
5364
This variables specifies whether to attempt to use TLSv1 in the
5365
SSL authentication process.
5366
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.209. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5367
Default: 0</p></div><p>
5368
This variable specifies the minimum acceptable prime size (in bits)
5369
for use in any Diffie-Hellman key exchange. A value of 0 will use
5370
the default from the GNUTLS library.
5371
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.210. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5372
Default: (empty)</p></div><p>
5373
This variable specifies a file containing trusted CA certificates.
5374
Any server certificate that is signed with one of these CA
5375
certificates is also automatically accepted.
5379
</p><pre class="screen">
5380
set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
5382
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.211. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5383
Default: no</p></div><p>
5384
Used in connection with the <code class="literal"><pipe-message></code> function following
5385
<code class="literal"><tag-prefix></code>. If this variable is <span class="emphasis"><em>unset</em></span>, when piping a list of
5386
tagged messages Mutt will concatenate the messages and will pipe them
5387
all concatenated. When <span class="emphasis"><em>set</em></span>, Mutt will pipe the messages one by one.
5388
In both cases the messages are piped in the current sorted order,
5389
and the <a class="link" href="#pipe-sep" title="3.213. pipe_sep">$pipe_sep</a> separator is added after each message.
5390
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.212. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5617
This is a format string, see the <a class="link" href="#pgp-decode-command" title="3.157. pgp_decode_command">$pgp_decode_command</a> command for
5618
possible <code class="literal">printf(3)</code>-like sequences.
5620
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.182. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5391
5621
Default: no</p></div><p>
5392
5622
Used in connection with the <code class="literal"><pipe-message></code> command. When <span class="emphasis"><em>unset</em></span>,
5393
5623
Mutt will pipe the messages without any preprocessing. When <span class="emphasis"><em>set</em></span>, Mutt
5394
5624
will weed headers and will attempt to decode the messages
5396
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.213. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5626
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.183. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5397
5627
Default: “<span class="quote"><code class="literal">\n</code></span>”</p></div><p>
5398
5628
The separator to add between messages when piping a list of tagged
5399
5629
messages to an external Unix command.
5400
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.214. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5630
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.184. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5631
Default: no</p></div><p>
5632
Used in connection with the <code class="literal"><pipe-message></code> function following
5633
<code class="literal"><tag-prefix></code>. If this variable is <span class="emphasis"><em>unset</em></span>, when piping a list of
5634
tagged messages Mutt will concatenate the messages and will pipe them
5635
all concatenated. When <span class="emphasis"><em>set</em></span>, Mutt will pipe the messages one by one.
5636
In both cases the messages are piped in the current sorted order,
5637
and the <a class="link" href="#pipe-sep" title="3.183. pipe_sep">$pipe_sep</a> separator is added after each message.
5638
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-auth-try-all"></a>3.185. pop_auth_try_all</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5639
Default: yes</p></div><p>
5640
If <span class="emphasis"><em>set</em></span>, Mutt will try all available authentication methods.
5641
When <span class="emphasis"><em>unset</em></span>, Mutt will only fall back to other authentication
5642
methods if the previous methods are unavailable. If a method is
5643
available but authentication fails, Mutt will not connect to the POP server.
5644
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.186. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5401
5645
Default: (empty)</p></div><p>
5402
5646
This is a colon-delimited list of authentication methods mutt may
5403
5647
attempt to use to log in to an POP server, in the order mutt should
5486
5722
</p><pre class="screen">
5487
5723
set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
5488
5724
sleep 20 < /dev/null > /dev/null"
5491
5726
Mailbox “<span class="quote">foo</span>” on “<span class="quote">mailhost.net</span>” can now be reached
5492
5727
as “<span class="quote">{localhost:1234}foo</span>”.
5494
5729
Note: For this example to work, you must be able to log in to the
5495
5730
remote machine without having to enter a password.
5496
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.227. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5731
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.198. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5497
5732
Default: ask-no</p></div><p>
5498
5733
Controls whether or not Mutt really prints messages.
5499
5734
This is set to “<span class="quote">ask-no</span>” by default, because some people
5500
5735
accidentally hit “<span class="quote">p</span>” often.
5501
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.228. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5736
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.199. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5502
5737
Default: “<span class="quote"><code class="literal">lpr</code></span>”</p></div><p>
5503
5738
This specifies the command pipe that should be used to print messages.
5504
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.229. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5739
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.200. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5505
5740
Default: yes</p></div><p>
5506
5741
Used in connection with the <code class="literal"><print-message></code> command. If this
5507
5742
option is <span class="emphasis"><em>set</em></span>, the message is decoded before it is passed to the
5508
external command specified by <a class="link" href="#print-command" title="3.228. print_command">$print_command</a>. If this option
5743
external command specified by <a class="link" href="#print-command" title="3.199. print_command">$print_command</a>. If this option
5509
5744
is <span class="emphasis"><em>unset</em></span>, no processing will be applied to the message when
5510
5745
printing it. The latter setting may be useful if you are using
5511
5746
some advanced printer filter which is able to properly format
5512
5747
e-mail messages for printing.
5513
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.230. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5748
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.201. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5514
5749
Default: no</p></div><p>
5515
5750
Used in connection with the <code class="literal"><print-message></code> command. If this option
5516
is <span class="emphasis"><em>set</em></span>, the command specified by <a class="link" href="#print-command" title="3.228. print_command">$print_command</a> is executed once for
5751
is <span class="emphasis"><em>set</em></span>, the command specified by <a class="link" href="#print-command" title="3.199. print_command">$print_command</a> is executed once for
5517
5752
each message which is to be printed. If this option is <span class="emphasis"><em>unset</em></span>,
5518
the command specified by <a class="link" href="#print-command" title="3.228. print_command">$print_command</a> is executed only once, and
5753
the command specified by <a class="link" href="#print-command" title="3.199. print_command">$print_command</a> is executed only once, and
5519
5754
all the messages are concatenated, with a form feed as the message
5522
5757
Those who use the <code class="literal">enscript</code>(1) program's mail-printing mode will
5523
5758
most likely want to <span class="emphasis"><em>set</em></span> this option.
5524
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.231. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5759
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.202. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5525
5760
Default: yes</p></div><p>
5526
If you use an <span class="emphasis"><em>external</em></span> <a class="link" href="#pager" title="3.138. pager">$pager</a>, setting this variable will
5761
If you use an <span class="emphasis"><em>external</em></span> <a class="link" href="#pager" title="3.148. pager">$pager</a>, setting this variable will
5527
5762
cause Mutt to prompt you for a command when the pager exits rather
5528
5763
than returning to the index menu. If <span class="emphasis"><em>unset</em></span>, Mutt will return to the
5529
5764
index menu when the external pager exits.
5530
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.232. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5765
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.203. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5531
5766
Default: (empty)</p></div><p>
5532
5767
This specifies the command that mutt will use to make external address
5533
5768
queries. The string should contain a “<span class="quote">%s</span>”, which will be substituted
5534
5769
with the query string the user types. See “<span class="quote"><a class="link" href="#query" title="5. External Address Queries">query</a></span>” for more
5536
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.233. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5771
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.204. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5537
5772
Default: “<span class="quote"><code class="literal">%4c %t %-25.25a %-25.25n %?e?(%e)?</code></span>”</p></div><p>
5538
5773
This variable describes the format of the “<span class="quote">query</span>” menu. The
5539
5774
following <code class="literal">printf(3)</code>-style sequences are understood:
5541
</p><div class="variablelist"><dl><dt><span class="term">%a </span></dt><dd><p>destination address
5542
</p></dd><dt><span class="term">%c </span></dt><dd><p>current entry number
5543
</p></dd><dt><span class="term">%e </span></dt><dd><p>extra information *
5544
</p></dd><dt><span class="term">%n </span></dt><dd><p>destination name
5545
</p></dd><dt><span class="term">%t </span></dt><dd><p>“<span class="quote">*</span>” if current entry is tagged, a space otherwise
5546
</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with “<span class="quote">X</span>”
5547
</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with “<span class="quote">X</span>”
5548
</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character “<span class="quote">X</span>” as pad
5549
</p></dd></dl></div><p>
5550
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="#index-format" title="3.101. index_format">$index_format</a> documentation.
5776
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>destination address
5777
</td></tr><tr><td>%c </td><td>current entry number
5778
</td></tr><tr><td>%e </td><td>extra information *
5779
</td></tr><tr><td>%n </td><td>destination name
5780
</td></tr><tr><td>%t </td><td>“<span class="quote">*</span>” if current entry is tagged, a space otherwise
5781
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with “<span class="quote">X</span>”
5782
</td></tr><tr><td>%|X </td><td>pad to the end of the line with “<span class="quote">X</span>”
5783
</td></tr><tr><td>%*X </td><td>soft-fill with character “<span class="quote">X</span>” as pad
5784
</td></tr></tbody></table></div><p>
5785
For an explanation of “<span class="quote">soft-fill</span>”, see the <a class="link" href="#index-format" title="3.114. index_format">$index_format</a> documentation.
5552
* = can be optionally printed if nonzero, see the <a class="link" href="#status-format" title="3.279. status_format">$status_format</a> documentation.
5553
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.234. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5787
* = can be optionally printed if nonzero, see the <a class="link" href="#status-format" title="3.282. status_format">$status_format</a> documentation.
5788
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.205. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
5554
5789
Default: yes</p></div><p>
5555
5790
This variable controls whether “<span class="quote">quit</span>” and “<span class="quote">exit</span>” actually quit
5556
5791
from mutt. If this option is <span class="emphasis"><em>set</em></span>, they do quit, if it is <span class="emphasis"><em>unset</em></span>, they
5557
5792
have no effect, and if it is set to <span class="emphasis"><em>ask-yes</em></span> or <span class="emphasis"><em>ask-no</em></span>, you are
5558
5793
prompted for confirmation when you try to quit.
5559
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.235. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
5794
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.206. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
5560
5795
Default: “<span class="quote"><code class="literal">^([ \t]*[|>:}#])+</code></span>”</p></div><p>
5561
5796
A regular expression used in the internal pager to determine quoted
5562
5797
sections of text in the body of a message. Quoted text may be filtered
5695
5927
Also note that setting this parameter will <span class="emphasis"><em>not</em></span> have the effect
5696
5928
that mutt <span class="emphasis"><em>generates</em></span> this kind of encoding. Instead, mutt will
5697
5929
unconditionally use the encoding specified in RFC2231.
5698
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.249. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5930
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.220. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5699
5931
Default: no</p></div><p>
5700
5932
If <span class="emphasis"><em>set</em></span>, mutt will take the sender's full address when choosing a
5701
default folder for saving a mail. If <a class="link" href="#save-name" title="3.252. save_name">$save_name</a> or <a class="link" href="#force-name" title="3.61. force_name">$force_name</a>
5933
default folder for saving a mail. If <a class="link" href="#save-name" title="3.223. save_name">$save_name</a> or <a class="link" href="#force-name" title="3.69. force_name">$force_name</a>
5702
5934
is <span class="emphasis"><em>set</em></span> too, the selection of the Fcc folder will be changed as well.
5703
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.250. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5935
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.221. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5704
5936
Default: yes</p></div><p>
5705
5937
When <span class="emphasis"><em>unset</em></span>, mailboxes which contain no saved messages will be removed
5706
when closed (the exception is <a class="link" href="#spoolfile" title="3.277. spoolfile">$spoolfile</a> which is never removed).
5938
when closed (the exception is <a class="link" href="#spoolfile" title="3.269. spoolfile">$spoolfile</a> which is never removed).
5707
5939
If <span class="emphasis"><em>set</em></span>, mailboxes are never removed.
5709
5941
<span class="bold"><strong>Note:</strong></span> This only applies to mbox and MMDF folders, Mutt does not
5710
5942
delete MH and Maildir directories.
5711
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.251. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5943
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.222. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5712
5944
Default: 0</p></div><p>
5713
5945
This variable controls the size of the history (per category) saved in the
5714
<a class="link" href="#history-file" title="3.78. history_file">$history_file</a> file.
5715
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.252. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5946
<a class="link" href="#history-file" title="3.90. history_file">$history_file</a> file.
5947
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.223. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5716
5948
Default: no</p></div><p>
5717
5949
This variable controls how copies of outgoing messages are saved.
5718
5950
When <span class="emphasis"><em>set</em></span>, a check is made to see if a mailbox specified by the
5719
5951
recipient address exists (this is done by searching for a mailbox in
5720
the <a class="link" href="#folder" title="3.58. folder">$folder</a> directory with the <span class="emphasis"><em>username</em></span> part of the
5952
the <a class="link" href="#folder" title="3.66. folder">$folder</a> directory with the <span class="emphasis"><em>username</em></span> part of the
5721
5953
recipient address). If the mailbox exists, the outgoing message will
5722
5954
be saved to that mailbox, otherwise the message is saved to the
5723
<a class="link" href="#record" title="3.240. record">$record</a> mailbox.
5955
<a class="link" href="#record" title="3.211. record">$record</a> mailbox.
5725
Also see the <a class="link" href="#force-name" title="3.61. force_name">$force_name</a> variable.
5726
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.253. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5957
Also see the <a class="link" href="#force-name" title="3.69. force_name">$force_name</a> variable.
5958
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.224. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5727
5959
Default: yes</p></div><p>
5728
5960
When this variable is <span class="emphasis"><em>unset</em></span>, scoring is turned off. This can
5729
5961
be useful to selectively disable scoring for certain folders when the
5730
<a class="link" href="#score-threshold-delete" title="3.254. score_threshold_delete">$score_threshold_delete</a> variable and related are used.
5731
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.254. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5962
<a class="link" href="#score-threshold-delete" title="3.225. score_threshold_delete">$score_threshold_delete</a> variable and related are used.
5963
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.225. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5732
5964
Default: -1</p></div><p>
5733
5965
Messages which have been assigned a score equal to or lower than the value
5734
5966
of this variable are automatically marked for deletion by mutt. Since
5735
5967
mutt scores are always greater than or equal to zero, the default setting
5736
5968
of this variable will never mark a message for deletion.
5737
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.255. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5969
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.226. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5738
5970
Default: 9999</p></div><p>
5739
5971
Messages which have been assigned a score greater than or equal to this
5740
5972
variable's value are automatically marked "flagged".
5741
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.256. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5973
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.227. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5742
5974
Default: -1</p></div><p>
5743
5975
Messages which have been assigned a score equal to or lower than the value
5744
5976
of this variable are automatically marked as read by mutt. Since
5745
5977
mutt scores are always greater than or equal to zero, the default setting
5746
5978
of this variable will never mark a message read.
5747
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.257. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5979
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="search-context"></a>3.228. search_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5980
Default: 0</p></div><p>
5981
For the pager, this variable specifies the number of lines shown
5982
before search results. By default, search results will be top-aligned.
5983
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.229. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5748
5984
Default: “<span class="quote"><code class="literal">us-ascii:iso-8859-1:utf-8</code></span>”</p></div><p>
5749
5985
A colon-delimited list of character sets for outgoing messages. Mutt will use the
5750
5986
first character set into which the text can be converted exactly.
5809
6045
will automatically expand it to the value specified by this variable by
5810
6046
replacing “<span class="quote">%s</span>” with the supplied string.
5811
6047
For the default value, “<span class="quote">joe</span>” would be expanded to: “<span class="quote">˜f joe | ˜s joe</span>”.
5812
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.265. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6048
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.237. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6049
Default: 1</p></div><p>
6050
Specifies time, in seconds, to pause while displaying certain informational
6051
messages, while moving from folder to folder and after expunging
6052
messages from the current folder. The default is to pause one second, so
6053
a value of zero for this option suppresses the pause.
6054
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.238. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5813
6055
Default: yes</p></div><p>
5814
6056
Controls the display of lines longer than the screen width in the
5815
6057
internal pager. If <span class="emphasis"><em>set</em></span>, long lines are wrapped at a word boundary. If
5816
6058
<span class="emphasis"><em>unset</em></span>, lines are simply wrapped at the screen edge. Also see the
5817
<a class="link" href="#markers" title="3.114. markers">$markers</a> variable.
5818
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.266. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
6059
<a class="link" href="#markers" title="3.124. markers">$markers</a> variable.
6060
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.239. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
5819
6061
Default: “<span class="quote"><code class="literal">(>From )|(:[-^]?[][)(><}{|/DP])</code></span>”</p></div><p>
5820
6062
The <span class="emphasis"><em>pager</em></span> uses this variable to catch some common false
5821
positives of <a class="link" href="#quote-regexp" title="3.235. quote_regexp">$quote_regexp</a>, most notably smileys and not consider
5822
a line quoted text if it also matches <a class="link" href="#smileys" title="3.266. smileys">$smileys</a>. This mostly
6063
positives of <a class="link" href="#quote-regexp" title="3.206. quote_regexp">$quote_regexp</a>, most notably smileys and not consider
6064
a line quoted text if it also matches <a class="link" href="#smileys" title="3.239. smileys">$smileys</a>. This mostly
5823
6065
happens at the beginning of a line.
5824
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.267. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />
5825
Default: 1</p></div><p>
5826
Specifies time, in seconds, to pause while displaying certain informational
5827
messages, while moving from folder to folder and after expunging
5828
messages from the current folder. The default is to pause one second, so
5829
a value of zero for this option suppresses the pause.
5830
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.268. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6066
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.240. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6067
Default: yes</p></div><p>
6068
This flag controls whether you want to be asked to enter a label
6069
for a certificate about to be added to the database or not. It is
6070
<span class="emphasis"><em>set</em></span> by default.
6072
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.241. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6073
Default: (empty)</p></div><p>
6074
This variable contains the name of either a directory, or a file which
6075
contains trusted certificates for use with OpenSSL.
6077
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.242. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6078
Default: (empty)</p></div><p>
6079
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
6080
storage and retrieval of keys by itself. This is very basic right
6081
now, and keys and certificates are stored in two different
6082
directories, both named as the hash-value retrieved from
6083
OpenSSL. There is an index file which contains mailbox-address
6084
keyid pairs, and which can be manually edited. This option points to
6085
the location of the certificates.
6087
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.243. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6088
Default: (empty)</p></div><p>
6089
This format string specifies a command which is used to decrypt
6090
<code class="literal">application/x-pkcs7-mime</code> attachments.
6092
The OpenSSL command formats have their own set of <code class="literal">printf(3)</code>-like sequences
6095
</p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%f </td><td>Expands to the name of a file containing a message.
6096
</td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
6097
of a <code class="literal">multipart/signed</code> attachment when verifying it.
6098
</td></tr><tr><td>%k </td><td>The key-pair specified with <a class="link" href="#smime-default-key" title="3.245. smime_default_key">$smime_default_key</a>
6099
</td></tr><tr><td>%c </td><td>One or more certificate IDs.
6100
</td></tr><tr><td>%a </td><td>The algorithm used for encryption.
6101
</td></tr><tr><td>%C </td><td>CA location: Depending on whether <a class="link" href="#smime-ca-location" title="3.241. smime_ca_location">$smime_ca_location</a>
6102
points to a directory or file, this expands to
6103
“<span class="quote">-CApath <a class="link" href="#smime-ca-location" title="3.241. smime_ca_location">$smime_ca_location</a></span>” or “<span class="quote">-CAfile <a class="link" href="#smime-ca-location" title="3.241. smime_ca_location">$smime_ca_location</a></span>”.
6104
</td></tr></tbody></table></div><p>
6105
For examples on how to configure these formats, see the <code class="literal">smime.rc</code> in
6106
the <code class="literal">samples/</code> subdirectory which has been installed on your system
6107
alongside the documentation.
6109
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.244. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6110
Default: yes</p></div><p>
6111
If <span class="emphasis"><em>set</em></span> (default) this tells mutt to use the default key for decryption. Otherwise,
6112
if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
6113
to determine the key to use. It will ask you to supply a key, if it can't find one.
6115
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.245. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6116
Default: (empty)</p></div><p>
6117
This is the default key-pair to use for signing. This must be set to the
6118
keyid (the hash-value that OpenSSL generates) to work properly
6120
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.246. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6121
Default: (empty)</p></div><p>
6122
This command is used to create encrypted S/MIME messages.
6124
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6125
possible <code class="literal">printf(3)</code>-like sequences.
6127
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.247. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6128
Default: (empty)</p></div><p>
6129
This sets the algorithm that should be used for encryption.
6130
Valid choices are “<span class="quote">des</span>”, “<span class="quote">des3</span>”, “<span class="quote">rc2-40</span>”, “<span class="quote">rc2-64</span>”, “<span class="quote">rc2-128</span>”.
6131
If <span class="emphasis"><em>unset</em></span>, “<span class="quote">3des</span>” (TripleDES) is used.
6133
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.248. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6134
Default: (empty)</p></div><p>
6135
This command is used to extract X509 certificates from a PKCS7 structure.
6137
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6138
possible <code class="literal">printf(3)</code>-like sequences.
6140
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.249. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6141
Default: (empty)</p></div><p>
6142
This command is used to extract the mail address(es) used for storing
6143
X509 certificates, and for verification purposes (to check whether the
6144
certificate was issued for the sender's mailbox).
6146
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6147
possible <code class="literal">printf(3)</code>-like sequences.
6149
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.250. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6150
Default: (empty)</p></div><p>
6151
This command is used to extract only the signers X509 certificate from a S/MIME
6152
signature, so that the certificate's owner may get compared to the
6153
email's “<span class="quote">From:</span>” field.
6155
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6156
possible <code class="literal">printf(3)</code>-like sequences.
6158
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.251. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6159
Default: (empty)</p></div><p>
6160
This command is used to import a certificate via smime_keys.
6162
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6163
possible <code class="literal">printf(3)</code>-like sequences.
6165
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.252. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6166
Default: no</p></div><p>
6167
The default behaviour of mutt is to use PGP on all auto-sign/encryption
6168
operations. To override and to use OpenSSL instead this must be <span class="emphasis"><em>set</em></span>.
6169
However, this has no effect while replying, since mutt will automatically
6170
select the same application that was used to sign/encrypt the original
6171
message. (Note that this variable can be overridden by unsetting <a class="link" href="#crypt-autosmime" title="3.39. crypt_autosmime">$crypt_autosmime</a>.)
6173
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.253. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6174
Default: (empty)</p></div><p>
6175
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
6176
storage and retrieval of keys/certs by itself. This is very basic right now,
6177
and stores keys and certificates in two different directories, both
6178
named as the hash-value retrieved from OpenSSL. There is an index file
6179
which contains mailbox-address keyid pair, and which can be manually
6180
edited. This option points to the location of the private keys.
6182
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.254. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6183
Default: (empty)</p></div><p>
6184
This command is used to extract PKCS7 structures of S/MIME signatures,
6185
in order to extract the public X509 certificate(s).
6187
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6188
possible <code class="literal">printf(3)</code>-like sequences.
6190
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.255. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6191
Default: (empty)</p></div><p>
6192
This command is used to created S/MIME signatures of type
6193
<code class="literal">multipart/signed</code>, which can be read by all mail clients.
6195
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6196
possible <code class="literal">printf(3)</code>-like sequences.
6198
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.256. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6199
Default: (empty)</p></div><p>
6200
This command is used to created S/MIME signatures of type
6201
<code class="literal">application/x-pkcs7-signature</code>, which can only be handled by mail
6202
clients supporting the S/MIME extension.
6204
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6205
possible <code class="literal">printf(3)</code>-like sequences.
6207
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.257. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6208
Default: 300</p></div><p>
6209
The number of seconds after which a cached passphrase will expire if
6212
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.258. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6213
Default: (empty)</p></div><p>
6214
This command is used to verify S/MIME signatures of type <code class="literal">multipart/signed</code>.
6216
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6217
possible <code class="literal">printf(3)</code>-like sequences.
6219
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.259. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6220
Default: (empty)</p></div><p>
6221
This command is used to verify S/MIME signatures of type
6222
<code class="literal">application/x-pkcs7-mime</code>.
6224
This is a format string, see the <a class="link" href="#smime-decrypt-command" title="3.243. smime_decrypt_command">$smime_decrypt_command</a> command for
6225
possible <code class="literal">printf(3)</code>-like sequences.
6227
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.260. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5831
6228
Default: (empty)</p></div><p>
5832
6229
This is a colon-delimited list of authentication methods mutt may
5833
6230
attempt to use to log in to an SMTP server, in the order mutt should
5923
6317
</p></li></ul></div><p>
5924
6318
You may optionally use the “<span class="quote">reverse-</span>” prefix to specify reverse sorting
5925
6319
order (example: “<span class="quote"><code class="literal">set sort_browser=reverse-date</code></span>”).
5926
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.275. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6320
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.267. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
5927
6321
Default: yes</p></div><p>
5928
6322
This variable is only useful when sorting by threads with
5929
<a class="link" href="#strict-threads" title="3.281. strict_threads">$strict_threads</a> <span class="emphasis"><em>unset</em></span>. In that case, it changes the heuristic
5930
mutt uses to thread messages by subject. With <a class="link" href="#sort-re" title="3.275. sort_re">$sort_re</a> <span class="emphasis"><em>set</em></span>, mutt will
6323
<a class="link" href="#strict-threads" title="3.284. strict_threads">$strict_threads</a> <span class="emphasis"><em>unset</em></span>. In that case, it changes the heuristic
6324
mutt uses to thread messages by subject. With <a class="link" href="#sort-re" title="3.267. sort_re">$sort_re</a> <span class="emphasis"><em>set</em></span>, mutt will
5931
6325
only attach a message as the child of another message by subject if
5932
6326
the subject of the child message starts with a substring matching the
5933
setting of <a class="link" href="#reply-regexp" title="3.241. reply_regexp">$reply_regexp</a>. With <a class="link" href="#sort-re" title="3.275. sort_re">$sort_re</a> <span class="emphasis"><em>unset</em></span>, mutt will attach
6327
setting of <a class="link" href="#reply-regexp" title="3.212. reply_regexp">$reply_regexp</a>. With <a class="link" href="#sort-re" title="3.267. sort_re">$sort_re</a> <span class="emphasis"><em>unset</em></span>, mutt will attach
5934
6328
the message whether or not this is the case, as long as the
5935
non-<a class="link" href="#reply-regexp" title="3.241. reply_regexp">$reply_regexp</a> parts of both messages are identical.
5936
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.276. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6329
non-<a class="link" href="#reply-regexp" title="3.212. reply_regexp">$reply_regexp</a> parts of both messages are identical.
6330
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.268. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5937
6331
Default: “<span class="quote"><code class="literal">,</code></span>”</p></div><p>
5938
6332
This variable controls what happens when multiple spam headers
5939
6333
are matched: if <span class="emphasis"><em>unset</em></span>, each successive header will overwrite any
5940
6334
previous matches value for the spam label. If <span class="emphasis"><em>set</em></span>, each successive
5941
6335
match will append to the previous, using this variable's value as a
5943
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.277. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6337
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.269. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />
5944
6338
Default: (empty)</p></div><p>
5945
6339
If your spool mailbox is in a non-default place where Mutt cannot find
5946
6340
it, you can specify its location with this variable. Mutt will
5947
automatically set this variable to the value of the environment
5948
variable <code class="literal">$MAIL</code> if it is not set.
5949
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.278. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
6341
initially set this variable to the value of the environment
6342
variable <code class="literal">$MAIL</code> or <code class="literal">$MAILDIR</code> if either is defined.
6343
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.270. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6344
Default: (empty)</p></div><p>
6345
This variable specifies a file containing trusted CA certificates.
6346
Any server certificate that is signed with one of these CA
6347
certificates is also automatically accepted.
6351
</p><pre class="screen">
6352
set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
6353
</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.271. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6354
Default: (empty)</p></div><p>
6355
The file containing a client certificate and its associated private
6357
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.272. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6358
Default: no</p></div><p>
6359
If this variable is <span class="emphasis"><em>set</em></span>, Mutt will require that all connections
6360
to remote servers be encrypted. Furthermore it will attempt to
6361
negotiate TLS even if the server does not advertise the capability,
6362
since it would otherwise have to abort the connection anyway. This
6363
option supersedes <a class="link" href="#ssl-starttls" title="3.274. ssl_starttls">$ssl_starttls</a>.
6364
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.273. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6365
Default: 0</p></div><p>
6366
This variable specifies the minimum acceptable prime size (in bits)
6367
for use in any Diffie-Hellman key exchange. A value of 0 will use
6368
the default from the GNUTLS library.
6369
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.274. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
6370
Default: yes</p></div><p>
6371
If <span class="emphasis"><em>set</em></span> (the default), mutt will attempt to use <code class="literal">STARTTLS</code> on servers
6372
advertising the capability. When <span class="emphasis"><em>unset</em></span>, mutt will not attempt to
6373
use <code class="literal">STARTTLS</code> regardless of the server's capabilities.
6374
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.275. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6375
Default: no</p></div><p>
6376
This variable specifies whether to attempt to use SSLv2 in the
6377
SSL authentication process.
6378
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.276. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6379
Default: yes</p></div><p>
6380
This variable specifies whether to attempt to use SSLv3 in the
6381
SSL authentication process.
6382
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.277. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6383
Default: yes</p></div><p>
6384
This variable specifies whether to attempt to use TLSv1 in the
6385
SSL authentication process.
6386
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.278. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6387
Default: yes</p></div><p>
6388
If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the
6389
system-wide certificate store when checking if a server certificate
6390
is signed by a trusted CA.
6391
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-dates"></a>3.279. ssl_verify_dates</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6392
Default: yes</p></div><p>
6393
If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
6394
certificate that is either not yet valid or already expired. You should
6395
only unset this for particular known hosts, using the
6396
<code class="literal"><a class="link" href="#account-hook" title="6. Managing Multiple Accounts"><account-hook></a></code> function.
6397
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-host"></a>3.280. ssl_verify_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6398
Default: yes</p></div><p>
6399
If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
6400
certificate whose host name does not match the host used in your folder
6401
URL. You should only unset this for particular known hosts, using
6402
the <code class="literal"><a class="link" href="#account-hook" title="6. Managing Multiple Accounts"><account-hook></a></code> function.
6403
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.281. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
5950
6404
Default: “<span class="quote"><code class="literal">-*%A</code></span>”</p></div><p>
5951
6405
Controls the characters used by the “<span class="quote">%r</span>” indicator in
5952
<a class="link" href="#status-format" title="3.279. status_format">$status_format</a>. The first character is used when the mailbox is
6406
<a class="link" href="#status-format" title="3.282. status_format">$status_format</a>. The first character is used when the mailbox is
5953
6407
unchanged. The second is used when the mailbox has been changed, and
5954
6408
it needs to be resynchronized. The third is used if the mailbox is in
5955
6409
read-only mode, or if the mailbox will not be written when exiting
6126
6580
</p><pre class="screen">
6127
6581
set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
6130
6583
Note: For this example to work you must be able to log in to the remote
6131
6584
machine without having to enter a password.
6132
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.292. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6586
When set, Mutt uses the tunnel for all remote connections.
6587
Please see “<span class="quote"><a class="link" href="#account-hook" title="6. Managing Multiple Accounts">account-hook</a></span>” in the manual for how to use different
6588
tunnel commands per connection.
6589
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-jump"></a>3.295. uncollapse_jump</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6590
Default: no</p></div><p>
6591
When <span class="emphasis"><em>set</em></span>, Mutt will jump to the next unread message, if any,
6592
when the current thread is <span class="emphasis"><em>un</em></span>collapsed.
6593
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.296. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6133
6594
Default: no</p></div><p>
6134
6595
<span class="bold"><strong>Warning:</strong></span> do not set this variable unless you are using a version
6135
6596
of sendmail which supports the <code class="literal">-B8BITMIME</code> flag (such as sendmail
6136
6597
8.8.x) or you may not be able to send mail.
6138
When <span class="emphasis"><em>set</em></span>, Mutt will invoke <a class="link" href="#sendmail" title="3.258. sendmail">$sendmail</a> with the <code class="literal">-B8BITMIME</code>
6599
When <span class="emphasis"><em>set</em></span>, Mutt will invoke <a class="link" href="#sendmail" title="3.230. sendmail">$sendmail</a> with the <code class="literal">-B8BITMIME</code>
6139
6600
flag when sending 8-bit messages to enable ESMTP negotiation.
6140
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.293. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6601
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.297. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6141
6602
Default: yes</p></div><p>
6142
6603
When <span class="emphasis"><em>set</em></span>, Mutt will qualify all local addresses (ones without the
6143
“<span class="quote">@host</span>” portion) with the value of <a class="link" href="#hostname" title="3.80. hostname">$hostname</a>. If <span class="emphasis"><em>unset</em></span>, no
6604
“<span class="quote">@host</span>” portion) with the value of <a class="link" href="#hostname" title="3.93. hostname">$hostname</a>. If <span class="emphasis"><em>unset</em></span>, no
6144
6605
addresses will be qualified.
6145
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.294. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6606
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.298. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6146
6607
Default: no</p></div><p>
6147
6608
When <span class="emphasis"><em>set</em></span>, mutt will set the <span class="emphasis"><em>envelope</em></span> sender of the message.
6148
If <a class="link" href="#envelope-from-address" title="3.53. envelope_from_address">$envelope_from_address</a> is <span class="emphasis"><em>set</em></span>, it will be used as the sender
6609
If <a class="link" href="#envelope-from-address" title="3.61. envelope_from_address">$envelope_from_address</a> is <span class="emphasis"><em>set</em></span>, it will be used as the sender
6149
6610
address. If <span class="emphasis"><em>unset</em></span>, mutt will attempt to derive the sender from the
6150
6611
“<span class="quote">From:</span>” header.
6152
6613
Note that this information is passed to sendmail command using the
6153
6614
<code class="literal">-f</code> command line switch. Therefore setting this option is not useful
6154
if the <a class="link" href="#sendmail" title="3.258. sendmail">$sendmail</a> variable already contains <code class="literal">-f</code> or if the
6155
executable pointed to by <a class="link" href="#sendmail" title="3.258. sendmail">$sendmail</a> doesn't support the <code class="literal">-f</code> switch.
6156
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.295. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6615
if the <a class="link" href="#sendmail" title="3.230. sendmail">$sendmail</a> variable already contains <code class="literal">-f</code> or if the
6616
executable pointed to by <a class="link" href="#sendmail" title="3.230. sendmail">$sendmail</a> doesn't support the <code class="literal">-f</code> switch.
6617
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.299. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6157
6618
Default: yes</p></div><p>
6158
6619
When <span class="emphasis"><em>set</em></span>, Mutt will generate the “<span class="quote">From:</span>” header field when
6159
6620
sending messages. If <span class="emphasis"><em>unset</em></span>, no “<span class="quote">From:</span>” header field will be
6160
generated unless the user explicitly sets one using the “<span class="quote"><a class="link" href="#my-hdr" title="15. User defined headers">my_hdr</a></span>”
6621
generated unless the user explicitly sets one using the “<span class="quote"><a class="link" href="#my-hdr" title="15. User-Defined Headers">my_hdr</a></span>”
6162
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.296. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6623
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.300. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6163
6624
Default: yes</p></div><p>
6164
6625
When <span class="emphasis"><em>set</em></span>, Mutt will show you international domain names decoded.
6165
6626
Note: You can use IDNs for addresses even if this is <span class="emphasis"><em>unset</em></span>.
6166
6627
This variable only affects decoding.
6167
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.297. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6628
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.301. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6168
6629
Default: yes</p></div><p>
6169
6630
When <span class="emphasis"><em>set</em></span>, Mutt will look for IPv6 addresses of hosts it tries to
6170
6631
contact. If this option is <span class="emphasis"><em>unset</em></span>, Mutt will restrict itself to IPv4 addresses.
6171
6632
Normally, the default should work.
6172
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.298. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6633
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.302. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6173
6634
Default: yes</p></div><p>
6174
6635
When <span class="emphasis"><em>set</em></span>, mutt will add a “<span class="quote">User-Agent:</span>” header to outgoing
6175
6636
messages, indicating which version of mutt was used for composing
6177
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.299. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6638
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.303. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />
6178
6639
Default: (empty)</p></div><p>
6179
6640
Specifies the visual editor to invoke when the “<span class="quote"><code class="literal">˜v</code></span>” command is
6180
6641
given in the builtin editor.
6181
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.300. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6642
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.304. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6182
6643
Default: yes</p></div><p>
6183
6644
Controls whether Mutt will ask you to press a key after an external command
6184
6645
has been invoked by these functions: <code class="literal"><shell-escape></code>,
6192
6653
When <span class="emphasis"><em>set</em></span>, Mutt will always ask for a key. When <span class="emphasis"><em>unset</em></span>, Mutt will wait
6193
6654
for a key only if the external command returned a non-zero status.
6194
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="weed"></a>3.301. weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6655
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="weed"></a>3.305. weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6195
6656
Default: yes</p></div><p>
6196
6657
When <span class="emphasis"><em>set</em></span>, mutt will weed headers when displaying, forwarding,
6197
6658
printing, or replying to messages.
6198
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap"></a>3.302. wrap</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6659
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap"></a>3.306. wrap</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6199
6660
Default: 0</p></div><p>
6200
When set to a positive value, mutt will wrap text at <a class="link" href="#wrap" title="3.302. wrap">$wrap</a> characters.
6201
When set to a negative value, mutt will wrap text so that there are <a class="link" href="#wrap" title="3.302. wrap">$wrap</a>
6661
When set to a positive value, mutt will wrap text at <a class="link" href="#wrap" title="3.306. wrap">$wrap</a> characters.
6662
When set to a negative value, mutt will wrap text so that there are <a class="link" href="#wrap" title="3.306. wrap">$wrap</a>
6202
6663
characters of empty space on the right side of the terminal.
6203
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-search"></a>3.303. wrap_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6664
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-search"></a>3.307. wrap_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6204
6665
Default: yes</p></div><p>
6205
6666
Controls whether searches wrap around the end.
6207
6668
When <span class="emphasis"><em>set</em></span>, searches will wrap around the first (or last) item. When
6208
6669
<span class="emphasis"><em>unset</em></span>, incremental searches will not wrap.
6209
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrapmargin"></a>3.304. wrapmargin</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6670
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrapmargin"></a>3.308. wrapmargin</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6210
6671
Default: 0</p></div><p>
6211
(DEPRECATED) Equivalent to setting <a class="link" href="#wrap" title="3.302. wrap">$wrap</a> with a negative value.
6212
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-inc"></a>3.305. write_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6213
Default: 10</p></div><p>
6214
When writing a mailbox, a message will be printed every
6215
<a class="link" href="#write-inc" title="3.305. write_inc">$write_inc</a> messages to indicate progress. If set to 0, only a
6216
single message will be displayed before writing a mailbox.
6218
Also see the <a class="link" href="#read-inc" title="3.236. read_inc">$read_inc</a>, <a class="link" href="#net-inc" title="3.137. net_inc">$net_inc</a> and <a class="link" href="#time-inc" title="3.287. time_inc">$time_inc</a> variables and the
6219
“<span class="quote"><a class="link" href="#tuning" title="Chapter 7. Performance tuning">tuning</a></span>” section of the manual for performance considerations.
6220
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-bcc"></a>3.306. write_bcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6672
(DEPRECATED) Equivalent to setting <a class="link" href="#wrap" title="3.306. wrap">$wrap</a> with a negative value.
6673
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-bcc"></a>3.309. write_bcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
6221
6674
Default: yes</p></div><p>
6222
6675
Controls whether mutt writes out the “<span class="quote">Bcc:</span>” header when preparing
6223
6676
messages to be sent. Exim users may wish to unset this. If mutt
6224
is set to deliver directly via SMTP (see <a class="link" href="#smtp-url" title="3.270. smtp_url">$smtp_url</a>), this
6677
is set to deliver directly via SMTP (see <a class="link" href="#smtp-url" title="3.262. smtp_url">$smtp_url</a>), this
6225
6678
option does nothing: mutt will never write out the “<span class="quote">Bcc:</span>” header
6680
</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-inc"></a>3.310. write_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
6681
Default: 10</p></div><p>
6682
When writing a mailbox, a message will be printed every
6683
<a class="link" href="#write-inc" title="3.310. write_inc">$write_inc</a> messages to indicate progress. If set to 0, only a
6684
single message will be displayed before writing a mailbox.
6686
Also see the <a class="link" href="#read-inc" title="3.207. read_inc">$read_inc</a>, <a class="link" href="#net-inc" title="3.147. net_inc">$net_inc</a> and <a class="link" href="#time-inc" title="3.290. time_inc">$time_inc</a> variables and the
6687
“<span class="quote"><a class="link" href="#tuning" title="Chapter 8. Performance Tuning">tuning</a></span>” section of the manual for performance considerations.
6227
6688
</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="functions"></a>4. Functions</h2></div></div></div><p>
6228
6689
The following is the list of available functions listed by the mapping
6229
6690
in which they are available. The default key setting is given, and an
6230
6691
explanation of what the function does. The key bindings of these
6231
functions can be changed with the <a class="link" href="#bind" title="5. Changing the default key bindings">bind</a>
6692
functions can be changed with the <a class="link" href="#bind" title="5. Changing the Default Key Bindings">bind</a>
6233
</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="generic_map"></a>4.1. generic menu</h3></div></div></div><p>
6694
</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="generic-map"></a>4.1. Generic Menu</h3></div></div></div><p>
6234
6695
The <span class="emphasis"><em>generic</em></span> menu is not a real menu, but specifies common functions
6235
6696
(such as movement) available in all menus except for <span class="emphasis"><em>pager</em></span> and
6236
6697
<span class="emphasis"><em>editor</em></span>. Changing settings for this menu will affect the default
6237
6698
bindings for all menus (except as noted).
6238
</p><div class="table"><a id="generic_table"></a><p class="title"><b>Table 8.2. Default generic function bindings</b></p><div class="table-contents"><table summary="Default generic function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><top-page></code></td><td>H</td><td>move to the top of the page</td></tr><tr><td><code class="literal"><next-entry></code></td><td>j</td><td>move to the next entry</td></tr><tr><td><code class="literal"><previous-entry></code></td><td>k</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><bottom-page></code></td><td>L</td><td>move to the bottom of the page</td></tr><tr><td><code class="literal"><refresh></code></td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td><code class="literal"><middle-page></code></td><td>M</td><td>move to the middle of the page</td></tr><tr><td><code class="literal"><search-next></code></td><td>n</td><td>search for next match</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><tag-entry></code></td><td>t</td><td>tag the current entry</td></tr><tr><td><code class="literal"><next-page></code></td><td>z</td><td>move to the next page</td></tr><tr><td><code class="literal"><previous-page></code></td><td>Z</td><td>move to the previous page</td></tr><tr><td><code class="literal"><last-entry></code></td><td>*</td><td>move to the last entry</td></tr><tr><td><code class="literal"><first-entry></code></td><td>=</td><td>move to the first entry</td></tr><tr><td><code class="literal"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><next-line></code></td><td>></td><td>scroll down one line</td></tr><tr><td><code class="literal"><previous-line></code></td><td><</td><td>scroll up one line</td></tr><tr><td><code class="literal"><half-up></code></td><td>[</td><td>scroll up 1/2 page</td></tr><tr><td><code class="literal"><half-down></code></td><td>]</td><td>scroll down 1/2 page</td></tr><tr><td><code class="literal"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><tag-prefix></code></td><td>;</td><td>apply next function to tagged messages</td></tr><tr><td><code class="literal"><tag-prefix-cond></code></td><td> </td><td>apply next function ONLY to tagged messages</td></tr><tr><td><code class="literal"><end-cond></code></td><td> </td><td>end of conditional execution (noop)</td></tr><tr><td><code class="literal"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td><code class="literal"><select-entry></code></td><td><Return></td><td>select the current entry</td></tr><tr><td><code class="literal"><search></code></td><td>/</td><td>search for a regular expression</td></tr><tr><td><code class="literal"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</td></tr><tr><td><code class="literal"><jump></code></td><td> </td><td>jump to an index number</td></tr><tr><td><code class="literal"><current-top></code></td><td> </td><td>move entry to top of screen</td></tr><tr><td><code class="literal"><current-middle></code></td><td> </td><td>move entry to middle of screen</td></tr><tr><td><code class="literal"><current-bottom></code></td><td> </td><td>move entry to bottom of screen</td></tr><tr><td><code class="literal"><what-key></code></td><td> </td><td>display the keycode for a key press</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="index_map"></a>4.2. index menu</h3></div></div></div><div class="table"><a id="index_table"></a><p class="title"><b>Table 8.3. Default index function bindings</b></p><div class="table-contents"><table summary="Default index function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><break-thread></code></td><td>#</td><td>break the thread in two</td></tr><tr><td><code class="literal"><change-folder></code></td><td>c</td><td>open a different folder</td></tr><tr><td><code class="literal"><change-folder-readonly></code></td><td>Esc c</td><td>open a different folder in read only mode</td></tr><tr><td><code class="literal"><next-unread-mailbox></code></td><td> </td><td>open next mailbox with new mail</td></tr><tr><td><code class="literal"><collapse-thread></code></td><td>Esc v</td><td>collapse/uncollapse current thread</td></tr><tr><td><code class="literal"><collapse-all></code></td><td>Esc V</td><td>collapse/uncollapse all threads</td></tr><tr><td><code class="literal"><copy-message></code></td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td><code class="literal"><decode-copy></code></td><td>Esc C</td><td>make decoded (text/plain) copy</td></tr><tr><td><code class="literal"><decode-save></code></td><td>Esc s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td><code class="literal"><delete-message></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><delete-pattern></code></td><td>D</td><td>delete messages matching a pattern</td></tr><tr><td><code class="literal"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</td></tr><tr><td><code class="literal"><delete-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</td></tr><tr><td><code class="literal"><edit></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><fetch-mail></code></td><td>G</td><td>retrieve mail from POP server</td></tr><tr><td><code class="literal"><imap-fetch-mail></code></td><td> </td><td>force retrieval of mail from IMAP server</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td>j</td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><limit></code></td><td>l</td><td>show only messages matching a pattern</td></tr><tr><td><code class="literal"><link-threads></code></td><td>&</td><td>link tagged message to the current one</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><toggle-new></code></td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td><code class="literal"><toggle-write></code></td><td>%</td><td>toggle whether the mailbox will be rewritten</td></tr><tr><td><code class="literal"><next-thread></code></td><td>^N</td><td>jump to the next thread</td></tr><tr><td><code class="literal"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</td></tr><tr><td><code class="literal"><query></code></td><td>Q</td><td>query external program for addresses</td></tr><tr><td><code class="literal"><quit></code></td><td>q</td><td>save changes to mailbox and quit</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><show-limit></code></td><td>Esc l</td><td>show currently active limit pattern</td></tr><tr><td><code class="literal"><sort-mailbox></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><print-message></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><previous-thread></code></td><td>^P</td><td>jump to previous thread</td></tr><tr><td><code class="literal"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</td></tr><tr><td><code class="literal"><recall-message></code></td><td>R</td><td>recall a postponed message</td></tr><tr><td><code class="literal"><read-thread></code></td><td>^R</td><td>mark the current thread as read</td></tr><tr><td><code class="literal"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><save-message></code></td><td>s</td><td>save message/attachment to a file</td></tr><tr><td><code class="literal"><tag-pattern></code></td><td>T</td><td>tag messages matching a pattern</td></tr><tr><td><code class="literal"><tag-subthread></code></td><td> </td><td>tag the current subthread</td></tr><tr><td><code class="literal"><tag-thread></code></td><td>Esc t</td><td>tag the current thread</td></tr><tr><td><code class="literal"><untag-pattern></code></td><td>^T</td><td>untag messages matching a pattern</td></tr><tr><td><code class="literal"><undelete-message></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><undelete-pattern></code></td><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td><code class="literal"><undelete-subthread></code></td><td>Esc u</td><td>undelete all messages in subthread</td></tr><tr><td><code class="literal"><undelete-thread></code></td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr><tr><td><code class="literal"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><set-flag></code></td><td>w</td><td>set a status flag on a message</td></tr><tr><td><code class="literal"><clear-flag></code></td><td>W</td><td>clear a status flag from a message</td></tr><tr><td><code class="literal"><display-message></code></td><td><Return></td><td>display a message</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</td></tr><tr><td><code class="literal"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><pipe-message></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><next-new></code></td><td> </td><td>jump to the next new message</td></tr><tr><td><code class="literal"><next-new-then-unread></code></td><td><Tab></td><td>jump to the next new or unread message</td></tr><tr><td><code class="literal"><previous-new></code></td><td> </td><td>jump to the previous new message</td></tr><tr><td><code class="literal"><previous-new-then-unread></code></td><td>Esc <Tab></td><td>jump to the previous new or unread message</td></tr><tr><td><code class="literal"><next-unread></code></td><td> </td><td>jump to the next unread message</td></tr><tr><td><code class="literal"><previous-unread></code></td><td> </td><td>jump to the previous unread message</td></tr><tr><td><code class="literal"><parent-message></code></td><td>P</td><td>jump to parent message in thread</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><decrypt-copy></code></td><td> </td><td>make decrypted copy</td></tr><tr><td><code class="literal"><decrypt-save></code></td><td> </td><td>make decrypted copy and delete</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_map"></a>4.3. pager menu</h3></div></div></div><div class="table"><a id="pager_table"></a><p class="title"><b>Table 8.4. Default pager function bindings</b></p><div class="table-contents"><table summary="Default pager function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><break-thread></code></td><td>#</td><td>break the thread in two</td></tr><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><change-folder></code></td><td>c</td><td>open a different folder</td></tr><tr><td><code class="literal"><change-folder-readonly></code></td><td>Esc c</td><td>open a different folder in read only mode</td></tr><tr><td><code class="literal"><next-unread-mailbox></code></td><td> </td><td>open next mailbox with new mail</td></tr><tr><td><code class="literal"><copy-message></code></td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td><code class="literal"><decode-copy></code></td><td>Esc C</td><td>make decoded (text/plain) copy</td></tr><tr><td><code class="literal"><delete-message></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</td></tr><tr><td><code class="literal"><delete-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</td></tr><tr><td><code class="literal"><edit></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><imap-fetch-mail></code></td><td> </td><td>force retrieval of mail from IMAP server</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td>j</td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><next-entry></code></td><td>J</td><td>move to the next entry</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><previous-entry></code></td><td>K</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><link-threads></code></td><td>&</td><td>link tagged message to the current one</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><redraw-screen></code></td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><mark-as-new></code></td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td><code class="literal"><search-next></code></td><td>n</td><td>search for next match</td></tr><tr><td><code class="literal"><next-thread></code></td><td>^N</td><td>jump to the next thread</td></tr><tr><td><code class="literal"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</td></tr><tr><td><code class="literal"><print-message></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><previous-thread></code></td><td>^P</td><td>jump to previous thread</td></tr><tr><td><code class="literal"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</td></tr><tr><td><code class="literal"><quit></code></td><td>Q</td><td>save changes to mailbox and quit</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><recall-message></code></td><td>R</td><td>recall a postponed message</td></tr><tr><td><code class="literal"><read-thread></code></td><td>^R</td><td>mark the current thread as read</td></tr><tr><td><code class="literal"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><save-message></code></td><td>s</td><td>save message/attachment to a file</td></tr><tr><td><code class="literal"><skip-quoted></code></td><td>S</td><td>skip beyond quoted text</td></tr><tr><td><code class="literal"><decode-save></code></td><td>Esc s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td><code class="literal"><tag-message></code></td><td>t</td><td>tag the current entry</td></tr><tr><td><code class="literal"><toggle-quoted></code></td><td>T</td><td>toggle display of quoted text</td></tr><tr><td><code class="literal"><undelete-message></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><undelete-subthread></code></td><td>Esc u</td><td>undelete all messages in subthread</td></tr><tr><td><code class="literal"><undelete-thread></code></td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr><tr><td><code class="literal"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><search-toggle></code></td><td>\\</td><td>toggle search pattern coloring</td></tr><tr><td><code class="literal"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><next-new></code></td><td> </td><td>jump to the next new message</td></tr><tr><td><code class="literal"><pipe-message></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><next-page></code></td><td><Space></td><td>move to the next page</td></tr><tr><td><code class="literal"><previous-page></code></td><td>-</td><td>move to the previous page</td></tr><tr><td><code class="literal"><top></code></td><td>^</td><td>jump to the top of the message</td></tr><tr><td><code class="literal"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</td></tr><tr><td><code class="literal"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td><code class="literal"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><search></code></td><td>/</td><td>search for a regular expression</td></tr><tr><td><code class="literal"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</td></tr><tr><td><code class="literal"><next-line></code></td><td><Return></td><td>scroll down one line</td></tr><tr><td><code class="literal"><jump></code></td><td> </td><td>jump to an index number</td></tr><tr><td><code class="literal"><next-unread></code></td><td> </td><td>jump to the next unread message</td></tr><tr><td><code class="literal"><previous-new></code></td><td> </td><td>jump to the previous new message</td></tr><tr><td><code class="literal"><previous-unread></code></td><td> </td><td>jump to the previous unread message</td></tr><tr><td><code class="literal"><half-up></code></td><td> </td><td>scroll up 1/2 page</td></tr><tr><td><code class="literal"><half-down></code></td><td> </td><td>scroll down 1/2 page</td></tr><tr><td><code class="literal"><previous-line></code></td><td> </td><td>scroll up one line</td></tr><tr><td><code class="literal"><bottom></code></td><td> </td><td>jump to the bottom of the message</td></tr><tr><td><code class="literal"><parent-message></code></td><td>P</td><td>jump to parent message in thread</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><decrypt-copy></code></td><td> </td><td>make decrypted copy</td></tr><tr><td><code class="literal"><decrypt-save></code></td><td> </td><td>make decrypted copy and delete</td></tr><tr><td><code class="literal"><what-key></code></td><td> </td><td>display the keycode for a key press</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="alias_map"></a>4.4. alias menu</h3></div></div></div><div class="table"><a id="alias_table"></a><p class="title"><b>Table 8.5. Default alias function bindings</b></p><div class="table-contents"><table summary="Default alias function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</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="query_map"></a>4.5. query menu</h3></div></div></div><div class="table"><a id="query_table"></a><p class="title"><b>Table 8.6. Default query function bindings</b></p><div class="table-contents"><table summary="Default query function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><query></code></td><td>Q</td><td>query external program for addresses</td></tr><tr><td><code class="literal"><query-append></code></td><td>A</td><td>append new query results to current results</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="attach_map"></a>4.6. attach menu</h3></div></div></div><div class="table"><a id="attach_table"></a><p class="title"><b>Table 8.7. Default attach function bindings</b></p><div class="table-contents"><table summary="Default attach function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><print-entry></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><save-entry></code></td><td>s</td><td>save message/attachment to a file</td></tr><tr><td><code class="literal"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><view-mailcap></code></td><td>m</td><td>force viewing of attachment using mailcap</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><view-text></code></td><td>T</td><td>view attachment as text</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Return></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><collapse-parts></code></td><td>v</td><td>Toggle display of subparts</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</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="compose_map"></a>4.7. compose menu</h3></div></div></div><div class="table"><a id="compose_table"></a><p class="title"><b>Table 8.8. Default compose function bindings</b></p><div class="table-contents"><table summary="Default compose function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><attach-file></code></td><td>a</td><td>attach file(s) to this message</td></tr><tr><td><code class="literal"><attach-message></code></td><td>A</td><td>attach message(s) to this message</td></tr><tr><td><code class="literal"><edit-bcc></code></td><td>b</td><td>edit the BCC list</td></tr><tr><td><code class="literal"><edit-cc></code></td><td>c</td><td>edit the CC list</td></tr><tr><td><code class="literal"><copy-file></code></td><td>C</td><td>save message/attachment to a file</td></tr><tr><td><code class="literal"><detach-file></code></td><td>D</td><td>delete the current entry</td></tr><tr><td><code class="literal"><toggle-disposition></code></td><td>^D</td><td>toggle disposition between inline/attachment</td></tr><tr><td><code class="literal"><edit-description></code></td><td>d</td><td>edit attachment description</td></tr><tr><td><code class="literal"><edit-message></code></td><td>e</td><td>edit the message</td></tr><tr><td><code class="literal"><edit-headers></code></td><td>E</td><td>edit the message with headers</td></tr><tr><td><code class="literal"><edit-file></code></td><td>^X e</td><td>edit the file to be attached</td></tr><tr><td><code class="literal"><edit-encoding></code></td><td>^E</td><td>edit attachment transfer-encoding</td></tr><tr><td><code class="literal"><edit-from></code></td><td>Esc f</td><td>edit the from field</td></tr><tr><td><code class="literal"><edit-fcc></code></td><td>f</td><td>enter a file to save a copy of this message in</td></tr><tr><td><code class="literal"><filter-entry></code></td><td>F</td><td>filter attachment through a shell command</td></tr><tr><td><code class="literal"><get-attachment></code></td><td>G</td><td>get a temporary copy of an attachment</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><ispell></code></td><td>i</td><td>run ispell on the message</td></tr><tr><td><code class="literal"><print-entry></code></td><td>l</td><td>print the current entry</td></tr><tr><td><code class="literal"><edit-mime></code></td><td>m</td><td>edit attachment using mailcap entry</td></tr><tr><td><code class="literal"><new-mime></code></td><td>n</td><td>compose new attachment using mailcap entry</td></tr><tr><td><code class="literal"><postpone-message></code></td><td>P</td><td>save this message to send later</td></tr><tr><td><code class="literal"><edit-reply-to></code></td><td>r</td><td>edit the Reply-To field</td></tr><tr><td><code class="literal"><rename-file></code></td><td>R</td><td>rename/move an attached file</td></tr><tr><td><code class="literal"><edit-subject></code></td><td>s</td><td>edit the subject of this message</td></tr><tr><td><code class="literal"><edit-to></code></td><td>t</td><td>edit the TO list</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^T</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><write-fcc></code></td><td>w</td><td>write the message to a folder</td></tr><tr><td><code class="literal"><toggle-unlink></code></td><td>u</td><td>toggle whether to delete file after sending it</td></tr><tr><td><code class="literal"><toggle-recode></code></td><td> </td><td>toggle recoding of this attachment</td></tr><tr><td><code class="literal"><update-encoding></code></td><td>U</td><td>update an attachment's encoding info</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Return></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><send-message></code></td><td>y</td><td>send the message</td></tr><tr><td><code class="literal"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><attach-key></code></td><td>Esc k</td><td>attach a PGP public key</td></tr><tr><td><code class="literal"><pgp-menu></code></td><td>p</td><td>show PGP options</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><smime-menu></code></td><td>S</td><td>show S/MIME options</td></tr><tr><td><code class="literal"><mix></code></td><td>M</td><td>send the message through a mixmaster remailer chain</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="postpone_map"></a>4.8. postpone menu</h3></div></div></div><div class="table"><a id="postpone_table"></a><p class="title"><b>Table 8.9. Default postpone function bindings</b></p><div class="table-contents"><table summary="Default postpone function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</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="browser_map"></a>4.9. browser menu</h3></div></div></div><div class="table"><a id="browser_table"></a><p class="title"><b>Table 8.10. Default browser function bindings</b></p><div class="table-contents"><table summary="Default browser function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><change-dir></code></td><td>c</td><td>change directories</td></tr><tr><td><code class="literal"><display-filename></code></td><td>@</td><td>display the currently selected file's name</td></tr><tr><td><code class="literal"><enter-mask></code></td><td>m</td><td>enter a file mask</td></tr><tr><td><code class="literal"><sort></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><select-new></code></td><td>N</td><td>select a new file in this directory</td></tr><tr><td><code class="literal"><check-new></code></td><td> </td><td>check mailboxes for new mail</td></tr><tr><td><code class="literal"><toggle-mailboxes></code></td><td><Tab></td><td>toggle whether to browse mailboxes or all files</td></tr><tr><td><code class="literal"><view-file></code></td><td><Space></td><td>view file</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><create-mailbox></code></td><td>C</td><td>create a new mailbox (IMAP only)</td></tr><tr><td><code class="literal"><delete-mailbox></code></td><td>d</td><td>delete the current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><rename-mailbox></code></td><td>r</td><td>rename the current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><subscribe></code></td><td>s</td><td>subscribe to current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><unsubscribe></code></td><td>u</td><td>unsubscribe from current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><toggle-subscribed></code></td><td>T</td><td>toggle view all/subscribed mailboxes (IMAP only)</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="pgp_map"></a>4.10. pgp menu</h3></div></div></div><div class="table"><a id="pgp_table"></a><p class="title"><b>Table 8.11. Default pgp function bindings</b></p><div class="table-contents"><table summary="Default pgp function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><verify-key></code></td><td>c</td><td>verify a PGP public key</td></tr><tr><td><code class="literal"><view-name></code></td><td>%</td><td>view the key's user id</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="smime_map"></a>4.11. smime menu</h3></div></div></div><div class="table"><a id="smime_table"></a><p class="title"><b>Table 8.12. Default smime function bindings</b></p><div class="table-contents"><table summary="Default smime function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><verify-key></code></td><td>c</td><td>verify a PGP public key</td></tr><tr><td><code class="literal"><view-name></code></td><td>%</td><td>view the key's user id</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="mix_map"></a>4.12. mix menu</h3></div></div></div><div class="table"><a id="mix_table"></a><p class="title"><b>Table 8.13. Default mix function bindings</b></p><div class="table-contents"><table summary="Default mix function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><accept></code></td><td><Return></td><td>Accept the chain constructed</td></tr><tr><td><code class="literal"><append></code></td><td>a</td><td>Append a remailer to the chain</td></tr><tr><td><code class="literal"><insert></code></td><td>i</td><td>Insert a remailer into the chain</td></tr><tr><td><code class="literal"><delete></code></td><td>d</td><td>Delete a remailer from the chain</td></tr><tr><td><code class="literal"><chain-prev></code></td><td><Left></td><td>Select the previous element of the chain</td></tr><tr><td><code class="literal"><chain-next></code></td><td><Right></td><td>Select the next element of the chain</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="editor_map"></a>4.13. editor menu</h3></div></div></div><div class="table"><a id="editor_table"></a><p class="title"><b>Table 8.14. Default editor function bindings</b></p><div class="table-contents"><table summary="Default editor function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><bol></code></td><td>^A</td><td>jump to the beginning of the line</td></tr><tr><td><code class="literal"><backward-char></code></td><td>^B</td><td>move the cursor one character to the left</td></tr><tr><td><code class="literal"><backward-word></code></td><td>Esc b</td><td>move the cursor to the beginning of the word</td></tr><tr><td><code class="literal"><capitalize-word></code></td><td>Esc c</td><td>capitalize the word</td></tr><tr><td><code class="literal"><downcase-word></code></td><td>Esc l</td><td>convert the word to lower case</td></tr><tr><td><code class="literal"><upcase-word></code></td><td>Esc u</td><td>convert the word to upper case</td></tr><tr><td><code class="literal"><delete-char></code></td><td>^D</td><td>delete the char under the cursor</td></tr><tr><td><code class="literal"><eol></code></td><td>^E</td><td>jump to the end of the line</td></tr><tr><td><code class="literal"><forward-char></code></td><td>^F</td><td>move the cursor one character to the right</td></tr><tr><td><code class="literal"><forward-word></code></td><td>Esc f</td><td>move the cursor to the end of the word</td></tr><tr><td><code class="literal"><backspace></code></td><td><Backspace></td><td>delete the char in front of the cursor</td></tr><tr><td><code class="literal"><kill-eol></code></td><td>^K</td><td>delete chars from cursor to end of line</td></tr><tr><td><code class="literal"><kill-eow></code></td><td>Esc d</td><td>delete chars from the cursor to the end of the word</td></tr><tr><td><code class="literal"><kill-line></code></td><td>^U</td><td>delete all chars on the line</td></tr><tr><td><code class="literal"><quote-char></code></td><td>^V</td><td>quote the next typed key</td></tr><tr><td><code class="literal"><kill-word></code></td><td>^W</td><td>delete the word in front of the cursor</td></tr><tr><td><code class="literal"><complete></code></td><td><Tab></td><td>complete filename or alias</td></tr><tr><td><code class="literal"><complete-query></code></td><td>^T</td><td>complete address with query</td></tr><tr><td><code class="literal"><buffy-cycle></code></td><td><Space></td><td>cycle among incoming mailboxes</td></tr><tr><td><code class="literal"><history-up></code></td><td> </td><td>scroll up through the history list</td></tr><tr><td><code class="literal"><history-down></code></td><td> </td><td>scroll down through the history list</td></tr><tr><td><code class="literal"><transpose-chars></code></td><td> </td><td>transpose character under cursor with previous</td></tr></tbody></table></div></div><br class="table-break" /></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="miscellany"></a>Chapter 9. Miscellany</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#acknowledgements">1. Acknowledgements</a></span></dt><dt><span class="sect1"><a href="#about">2. About this document</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="acknowledgements"></a>1. Acknowledgements</h2></div></div></div><p>
6699
</p><div class="table"><a id="generic-table"></a><p class="title"><b>Table 9.2. Default generic Function Bindings</b></p><div class="table-contents"><table summary="Default generic Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><top-page></code></td><td>H</td><td>move to the top of the page</td></tr><tr><td><code class="literal"><next-entry></code></td><td>j</td><td>move to the next entry</td></tr><tr><td><code class="literal"><previous-entry></code></td><td>k</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><bottom-page></code></td><td>L</td><td>move to the bottom of the page</td></tr><tr><td><code class="literal"><refresh></code></td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td><code class="literal"><middle-page></code></td><td>M</td><td>move to the middle of the page</td></tr><tr><td><code class="literal"><search-next></code></td><td>n</td><td>search for next match</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><tag-entry></code></td><td>t</td><td>tag the current entry</td></tr><tr><td><code class="literal"><next-page></code></td><td>z</td><td>move to the next page</td></tr><tr><td><code class="literal"><previous-page></code></td><td>Z</td><td>move to the previous page</td></tr><tr><td><code class="literal"><last-entry></code></td><td>*</td><td>move to the last entry</td></tr><tr><td><code class="literal"><first-entry></code></td><td>=</td><td>move to the first entry</td></tr><tr><td><code class="literal"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><next-line></code></td><td>></td><td>scroll down one line</td></tr><tr><td><code class="literal"><previous-line></code></td><td><</td><td>scroll up one line</td></tr><tr><td><code class="literal"><half-up></code></td><td>[</td><td>scroll up 1/2 page</td></tr><tr><td><code class="literal"><half-down></code></td><td>]</td><td>scroll down 1/2 page</td></tr><tr><td><code class="literal"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><tag-prefix></code></td><td>;</td><td>apply next function to tagged messages</td></tr><tr><td><code class="literal"><tag-prefix-cond></code></td><td> </td><td>apply next function ONLY to tagged messages</td></tr><tr><td><code class="literal"><end-cond></code></td><td> </td><td>end of conditional execution (noop)</td></tr><tr><td><code class="literal"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td><code class="literal"><select-entry></code></td><td><Return></td><td>select the current entry</td></tr><tr><td><code class="literal"><search></code></td><td>/</td><td>search for a regular expression</td></tr><tr><td><code class="literal"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</td></tr><tr><td><code class="literal"><jump></code></td><td> </td><td>jump to an index number</td></tr><tr><td><code class="literal"><current-top></code></td><td> </td><td>move entry to top of screen</td></tr><tr><td><code class="literal"><current-middle></code></td><td> </td><td>move entry to middle of screen</td></tr><tr><td><code class="literal"><current-bottom></code></td><td> </td><td>move entry to bottom of screen</td></tr><tr><td><code class="literal"><what-key></code></td><td> </td><td>display the keycode for a key press</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="index-map"></a>4.2. Index Menu</h3></div></div></div><div class="table"><a id="index-table"></a><p class="title"><b>Table 9.3. Default index Function Bindings</b></p><div class="table-contents"><table summary="Default index Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><break-thread></code></td><td>#</td><td>break the thread in two</td></tr><tr><td><code class="literal"><change-folder></code></td><td>c</td><td>open a different folder</td></tr><tr><td><code class="literal"><change-folder-readonly></code></td><td>Esc c</td><td>open a different folder in read only mode</td></tr><tr><td><code class="literal"><next-unread-mailbox></code></td><td> </td><td>open next mailbox with new mail</td></tr><tr><td><code class="literal"><collapse-thread></code></td><td>Esc v</td><td>collapse/uncollapse current thread</td></tr><tr><td><code class="literal"><collapse-all></code></td><td>Esc V</td><td>collapse/uncollapse all threads</td></tr><tr><td><code class="literal"><copy-message></code></td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td><code class="literal"><decode-copy></code></td><td>Esc C</td><td>make decoded (text/plain) copy</td></tr><tr><td><code class="literal"><decode-save></code></td><td>Esc s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td><code class="literal"><delete-message></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><delete-pattern></code></td><td>D</td><td>delete messages matching a pattern</td></tr><tr><td><code class="literal"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</td></tr><tr><td><code class="literal"><delete-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</td></tr><tr><td><code class="literal"><edit></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><fetch-mail></code></td><td>G</td><td>retrieve mail from POP server</td></tr><tr><td><code class="literal"><imap-fetch-mail></code></td><td> </td><td>force retrieval of mail from IMAP server</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td>j</td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><limit></code></td><td>l</td><td>show only messages matching a pattern</td></tr><tr><td><code class="literal"><link-threads></code></td><td>&</td><td>link tagged message to the current one</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><toggle-new></code></td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td><code class="literal"><toggle-write></code></td><td>%</td><td>toggle whether the mailbox will be rewritten</td></tr><tr><td><code class="literal"><next-thread></code></td><td>^N</td><td>jump to the next thread</td></tr><tr><td><code class="literal"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</td></tr><tr><td><code class="literal"><query></code></td><td>Q</td><td>query external program for addresses</td></tr><tr><td><code class="literal"><quit></code></td><td>q</td><td>save changes to mailbox and quit</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><show-limit></code></td><td>Esc l</td><td>show currently active limit pattern</td></tr><tr><td><code class="literal"><sort-mailbox></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><print-message></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><previous-thread></code></td><td>^P</td><td>jump to previous thread</td></tr><tr><td><code class="literal"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</td></tr><tr><td><code class="literal"><recall-message></code></td><td>R</td><td>recall a postponed message</td></tr><tr><td><code class="literal"><read-thread></code></td><td>^R</td><td>mark the current thread as read</td></tr><tr><td><code class="literal"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><save-message></code></td><td>s</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><tag-pattern></code></td><td>T</td><td>tag messages matching a pattern</td></tr><tr><td><code class="literal"><tag-subthread></code></td><td> </td><td>tag the current subthread</td></tr><tr><td><code class="literal"><tag-thread></code></td><td>Esc t</td><td>tag the current thread</td></tr><tr><td><code class="literal"><untag-pattern></code></td><td>^T</td><td>untag messages matching a pattern</td></tr><tr><td><code class="literal"><undelete-message></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><undelete-pattern></code></td><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td><code class="literal"><undelete-subthread></code></td><td>Esc u</td><td>undelete all messages in subthread</td></tr><tr><td><code class="literal"><undelete-thread></code></td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr><tr><td><code class="literal"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><set-flag></code></td><td>w</td><td>set a status flag on a message</td></tr><tr><td><code class="literal"><clear-flag></code></td><td>W</td><td>clear a status flag from a message</td></tr><tr><td><code class="literal"><display-message></code></td><td><Return></td><td>display a message</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</td></tr><tr><td><code class="literal"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><pipe-message></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><next-new></code></td><td> </td><td>jump to the next new message</td></tr><tr><td><code class="literal"><next-new-then-unread></code></td><td><Tab></td><td>jump to the next new or unread message</td></tr><tr><td><code class="literal"><previous-new></code></td><td> </td><td>jump to the previous new message</td></tr><tr><td><code class="literal"><previous-new-then-unread></code></td><td>Esc <Tab></td><td>jump to the previous new or unread message</td></tr><tr><td><code class="literal"><next-unread></code></td><td> </td><td>jump to the next unread message</td></tr><tr><td><code class="literal"><previous-unread></code></td><td> </td><td>jump to the previous unread message</td></tr><tr><td><code class="literal"><parent-message></code></td><td>P</td><td>jump to parent message in thread</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><decrypt-copy></code></td><td> </td><td>make decrypted copy</td></tr><tr><td><code class="literal"><decrypt-save></code></td><td> </td><td>make decrypted copy and delete</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-map"></a>4.3. Pager Menu</h3></div></div></div><div class="table"><a id="pager-table"></a><p class="title"><b>Table 9.4. Default pager Function Bindings</b></p><div class="table-contents"><table summary="Default pager Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><break-thread></code></td><td>#</td><td>break the thread in two</td></tr><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><change-folder></code></td><td>c</td><td>open a different folder</td></tr><tr><td><code class="literal"><change-folder-readonly></code></td><td>Esc c</td><td>open a different folder in read only mode</td></tr><tr><td><code class="literal"><next-unread-mailbox></code></td><td> </td><td>open next mailbox with new mail</td></tr><tr><td><code class="literal"><copy-message></code></td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td><code class="literal"><decode-copy></code></td><td>Esc C</td><td>make decoded (text/plain) copy</td></tr><tr><td><code class="literal"><delete-message></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</td></tr><tr><td><code class="literal"><delete-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</td></tr><tr><td><code class="literal"><set-flag></code></td><td>w</td><td>set a status flag on a message</td></tr><tr><td><code class="literal"><clear-flag></code></td><td>W</td><td>clear a status flag from a message</td></tr><tr><td><code class="literal"><edit></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><imap-fetch-mail></code></td><td> </td><td>force retrieval of mail from IMAP server</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td>j</td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><next-entry></code></td><td>J</td><td>move to the next entry</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><previous-entry></code></td><td>K</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><link-threads></code></td><td>&</td><td>link tagged message to the current one</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><redraw-screen></code></td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><mark-as-new></code></td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td><code class="literal"><search-next></code></td><td>n</td><td>search for next match</td></tr><tr><td><code class="literal"><next-thread></code></td><td>^N</td><td>jump to the next thread</td></tr><tr><td><code class="literal"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</td></tr><tr><td><code class="literal"><print-message></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><previous-thread></code></td><td>^P</td><td>jump to previous thread</td></tr><tr><td><code class="literal"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</td></tr><tr><td><code class="literal"><quit></code></td><td>Q</td><td>save changes to mailbox and quit</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><recall-message></code></td><td>R</td><td>recall a postponed message</td></tr><tr><td><code class="literal"><read-thread></code></td><td>^R</td><td>mark the current thread as read</td></tr><tr><td><code class="literal"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><save-message></code></td><td>s</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><skip-quoted></code></td><td>S</td><td>skip beyond quoted text</td></tr><tr><td><code class="literal"><decode-save></code></td><td>Esc s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td><code class="literal"><tag-message></code></td><td>t</td><td>tag the current entry</td></tr><tr><td><code class="literal"><toggle-quoted></code></td><td>T</td><td>toggle display of quoted text</td></tr><tr><td><code class="literal"><undelete-message></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><undelete-subthread></code></td><td>Esc u</td><td>undelete all messages in subthread</td></tr><tr><td><code class="literal"><undelete-thread></code></td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr><tr><td><code class="literal"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><search-toggle></code></td><td>\\</td><td>toggle search pattern coloring</td></tr><tr><td><code class="literal"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><next-new></code></td><td> </td><td>jump to the next new message</td></tr><tr><td><code class="literal"><pipe-message></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><next-page></code></td><td><Space></td><td>move to the next page</td></tr><tr><td><code class="literal"><previous-page></code></td><td>-</td><td>move to the previous page</td></tr><tr><td><code class="literal"><top></code></td><td>^</td><td>jump to the top of the message</td></tr><tr><td><code class="literal"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</td></tr><tr><td><code class="literal"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td><code class="literal"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><search></code></td><td>/</td><td>search for a regular expression</td></tr><tr><td><code class="literal"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</td></tr><tr><td><code class="literal"><next-line></code></td><td><Return></td><td>scroll down one line</td></tr><tr><td><code class="literal"><jump></code></td><td> </td><td>jump to an index number</td></tr><tr><td><code class="literal"><next-unread></code></td><td> </td><td>jump to the next unread message</td></tr><tr><td><code class="literal"><previous-new></code></td><td> </td><td>jump to the previous new message</td></tr><tr><td><code class="literal"><previous-unread></code></td><td> </td><td>jump to the previous unread message</td></tr><tr><td><code class="literal"><half-up></code></td><td> </td><td>scroll up 1/2 page</td></tr><tr><td><code class="literal"><half-down></code></td><td> </td><td>scroll down 1/2 page</td></tr><tr><td><code class="literal"><previous-line></code></td><td> </td><td>scroll up one line</td></tr><tr><td><code class="literal"><bottom></code></td><td> </td><td>jump to the bottom of the message</td></tr><tr><td><code class="literal"><parent-message></code></td><td>P</td><td>jump to parent message in thread</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><decrypt-copy></code></td><td> </td><td>make decrypted copy</td></tr><tr><td><code class="literal"><decrypt-save></code></td><td> </td><td>make decrypted copy and delete</td></tr><tr><td><code class="literal"><what-key></code></td><td> </td><td>display the keycode for a key press</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="alias-map"></a>4.4. Alias Menu</h3></div></div></div><div class="table"><a id="alias-table"></a><p class="title"><b>Table 9.5. Default alias Function Bindings</b></p><div class="table-contents"><table summary="Default alias Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</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="query-map"></a>4.5. Query Menu</h3></div></div></div><div class="table"><a id="query-table"></a><p class="title"><b>Table 9.6. Default query Function Bindings</b></p><div class="table-contents"><table summary="Default query Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><query></code></td><td>Q</td><td>query external program for addresses</td></tr><tr><td><code class="literal"><query-append></code></td><td>A</td><td>append new query results to current results</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="attach-map"></a>4.6. Attach Menu</h3></div></div></div><div class="table"><a id="attach-table"></a><p class="title"><b>Table 9.7. Default attach Function Bindings</b></p><div class="table-contents"><table summary="Default attach Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><print-entry></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><save-entry></code></td><td>s</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><view-mailcap></code></td><td>m</td><td>force viewing of attachment using mailcap</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><view-text></code></td><td>T</td><td>view attachment as text</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Return></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><collapse-parts></code></td><td>v</td><td>Toggle display of subparts</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</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="compose-map"></a>4.7. Compose Menu</h3></div></div></div><div class="table"><a id="compose-table"></a><p class="title"><b>Table 9.8. Default compose Function Bindings</b></p><div class="table-contents"><table summary="Default compose Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><attach-file></code></td><td>a</td><td>attach file(s) to this message</td></tr><tr><td><code class="literal"><attach-message></code></td><td>A</td><td>attach message(s) to this message</td></tr><tr><td><code class="literal"><edit-bcc></code></td><td>b</td><td>edit the BCC list</td></tr><tr><td><code class="literal"><edit-cc></code></td><td>c</td><td>edit the CC list</td></tr><tr><td><code class="literal"><copy-file></code></td><td>C</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><detach-file></code></td><td>D</td><td>delete the current entry</td></tr><tr><td><code class="literal"><toggle-disposition></code></td><td>^D</td><td>toggle disposition between inline/attachment</td></tr><tr><td><code class="literal"><edit-description></code></td><td>d</td><td>edit attachment description</td></tr><tr><td><code class="literal"><edit-message></code></td><td>e</td><td>edit the message</td></tr><tr><td><code class="literal"><edit-headers></code></td><td>E</td><td>edit the message with headers</td></tr><tr><td><code class="literal"><edit-file></code></td><td>^X e</td><td>edit the file to be attached</td></tr><tr><td><code class="literal"><edit-encoding></code></td><td>^E</td><td>edit attachment transfer-encoding</td></tr><tr><td><code class="literal"><edit-from></code></td><td>Esc f</td><td>edit the from field</td></tr><tr><td><code class="literal"><edit-fcc></code></td><td>f</td><td>enter a file to save a copy of this message in</td></tr><tr><td><code class="literal"><filter-entry></code></td><td>F</td><td>filter attachment through a shell command</td></tr><tr><td><code class="literal"><get-attachment></code></td><td>G</td><td>get a temporary copy of an attachment</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><ispell></code></td><td>i</td><td>run ispell on the message</td></tr><tr><td><code class="literal"><print-entry></code></td><td>l</td><td>print the current entry</td></tr><tr><td><code class="literal"><edit-mime></code></td><td>m</td><td>edit attachment using mailcap entry</td></tr><tr><td><code class="literal"><new-mime></code></td><td>n</td><td>compose new attachment using mailcap entry</td></tr><tr><td><code class="literal"><postpone-message></code></td><td>P</td><td>save this message to send later</td></tr><tr><td><code class="literal"><edit-reply-to></code></td><td>r</td><td>edit the Reply-To field</td></tr><tr><td><code class="literal"><rename-file></code></td><td>R</td><td>rename/move an attached file</td></tr><tr><td><code class="literal"><edit-subject></code></td><td>s</td><td>edit the subject of this message</td></tr><tr><td><code class="literal"><edit-to></code></td><td>t</td><td>edit the TO list</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^T</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><write-fcc></code></td><td>w</td><td>write the message to a folder</td></tr><tr><td><code class="literal"><toggle-unlink></code></td><td>u</td><td>toggle whether to delete file after sending it</td></tr><tr><td><code class="literal"><toggle-recode></code></td><td> </td><td>toggle recoding of this attachment</td></tr><tr><td><code class="literal"><update-encoding></code></td><td>U</td><td>update an attachment's encoding info</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Return></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><send-message></code></td><td>y</td><td>send the message</td></tr><tr><td><code class="literal"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><attach-key></code></td><td>Esc k</td><td>attach a PGP public key</td></tr><tr><td><code class="literal"><pgp-menu></code></td><td>p</td><td>show PGP options</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><smime-menu></code></td><td>S</td><td>show S/MIME options</td></tr><tr><td><code class="literal"><mix></code></td><td>M</td><td>send the message through a mixmaster remailer chain</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="postpone-map"></a>4.8. Postpone Menu</h3></div></div></div><div class="table"><a id="postpone-table"></a><p class="title"><b>Table 9.9. Default postpone Function Bindings</b></p><div class="table-contents"><table summary="Default postpone Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</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="browser-map"></a>4.9. Browser Menu</h3></div></div></div><div class="table"><a id="browser-table"></a><p class="title"><b>Table 9.10. Default browser Function Bindings</b></p><div class="table-contents"><table summary="Default browser Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><change-dir></code></td><td>c</td><td>change directories</td></tr><tr><td><code class="literal"><display-filename></code></td><td>@</td><td>display the currently selected file's name</td></tr><tr><td><code class="literal"><enter-mask></code></td><td>m</td><td>enter a file mask</td></tr><tr><td><code class="literal"><sort></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><select-new></code></td><td>N</td><td>select a new file in this directory</td></tr><tr><td><code class="literal"><check-new></code></td><td> </td><td>check mailboxes for new mail</td></tr><tr><td><code class="literal"><toggle-mailboxes></code></td><td><Tab></td><td>toggle whether to browse mailboxes or all files</td></tr><tr><td><code class="literal"><view-file></code></td><td><Space></td><td>view file</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><create-mailbox></code></td><td>C</td><td>create a new mailbox (IMAP only)</td></tr><tr><td><code class="literal"><delete-mailbox></code></td><td>d</td><td>delete the current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><rename-mailbox></code></td><td>r</td><td>rename the current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><subscribe></code></td><td>s</td><td>subscribe to current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><unsubscribe></code></td><td>u</td><td>unsubscribe from current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><toggle-subscribed></code></td><td>T</td><td>toggle view all/subscribed mailboxes (IMAP only)</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="pgp-map"></a>4.10. Pgp Menu</h3></div></div></div><div class="table"><a id="pgp-table"></a><p class="title"><b>Table 9.11. Default pgp Function Bindings</b></p><div class="table-contents"><table summary="Default pgp Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><verify-key></code></td><td>c</td><td>verify a PGP public key</td></tr><tr><td><code class="literal"><view-name></code></td><td>%</td><td>view the key's user id</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="smime-map"></a>4.11. Smime Menu</h3></div></div></div><div class="table"><a id="smime-table"></a><p class="title"><b>Table 9.12. Default smime Function Bindings</b></p><div class="table-contents"><table summary="Default smime Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><verify-key></code></td><td>c</td><td>verify a PGP public key</td></tr><tr><td><code class="literal"><view-name></code></td><td>%</td><td>view the key's user id</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="mix-map"></a>4.12. Mix Menu</h3></div></div></div><div class="table"><a id="mix-table"></a><p class="title"><b>Table 9.13. Default mix Function Bindings</b></p><div class="table-contents"><table summary="Default mix Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><accept></code></td><td><Return></td><td>Accept the chain constructed</td></tr><tr><td><code class="literal"><append></code></td><td>a</td><td>Append a remailer to the chain</td></tr><tr><td><code class="literal"><insert></code></td><td>i</td><td>Insert a remailer into the chain</td></tr><tr><td><code class="literal"><delete></code></td><td>d</td><td>Delete a remailer from the chain</td></tr><tr><td><code class="literal"><chain-prev></code></td><td><Left></td><td>Select the previous element of the chain</td></tr><tr><td><code class="literal"><chain-next></code></td><td><Right></td><td>Select the next element of the chain</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="editor-map"></a>4.13. Editor Menu</h3></div></div></div><div class="table"><a id="editor-table"></a><p class="title"><b>Table 9.14. Default editor Function Bindings</b></p><div class="table-contents"><table summary="Default editor Function Bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td><code class="literal"><bol></code></td><td>^A</td><td>jump to the beginning of the line</td></tr><tr><td><code class="literal"><backward-char></code></td><td>^B</td><td>move the cursor one character to the left</td></tr><tr><td><code class="literal"><backward-word></code></td><td>Esc b</td><td>move the cursor to the beginning of the word</td></tr><tr><td><code class="literal"><capitalize-word></code></td><td>Esc c</td><td>capitalize the word</td></tr><tr><td><code class="literal"><downcase-word></code></td><td>Esc l</td><td>convert the word to lower case</td></tr><tr><td><code class="literal"><upcase-word></code></td><td>Esc u</td><td>convert the word to upper case</td></tr><tr><td><code class="literal"><delete-char></code></td><td>^D</td><td>delete the char under the cursor</td></tr><tr><td><code class="literal"><eol></code></td><td>^E</td><td>jump to the end of the line</td></tr><tr><td><code class="literal"><forward-char></code></td><td>^F</td><td>move the cursor one character to the right</td></tr><tr><td><code class="literal"><forward-word></code></td><td>Esc f</td><td>move the cursor to the end of the word</td></tr><tr><td><code class="literal"><backspace></code></td><td><Backspace></td><td>delete the char in front of the cursor</td></tr><tr><td><code class="literal"><kill-eol></code></td><td>^K</td><td>delete chars from cursor to end of line</td></tr><tr><td><code class="literal"><kill-eow></code></td><td>Esc d</td><td>delete chars from the cursor to the end of the word</td></tr><tr><td><code class="literal"><kill-line></code></td><td>^U</td><td>delete all chars on the line</td></tr><tr><td><code class="literal"><quote-char></code></td><td>^V</td><td>quote the next typed key</td></tr><tr><td><code class="literal"><kill-word></code></td><td>^W</td><td>delete the word in front of the cursor</td></tr><tr><td><code class="literal"><complete></code></td><td><Tab></td><td>complete filename or alias</td></tr><tr><td><code class="literal"><complete-query></code></td><td>^T</td><td>complete address with query</td></tr><tr><td><code class="literal"><buffy-cycle></code></td><td><Space></td><td>cycle among incoming mailboxes</td></tr><tr><td><code class="literal"><history-up></code></td><td> </td><td>scroll up through the history list</td></tr><tr><td><code class="literal"><history-down></code></td><td> </td><td>scroll down through the history list</td></tr><tr><td><code class="literal"><transpose-chars></code></td><td> </td><td>transpose character under cursor with previous</td></tr></tbody></table></div></div><br class="table-break" /></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="miscellany"></a>Chapter 10. Miscellany</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#acknowledgements">1. Acknowledgements</a></span></dt><dt><span class="sect1"><a href="#about">2. About This Document</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="acknowledgements"></a>1. Acknowledgements</h2></div></div></div><p>
6239
6700
Kari Hurtta <code class="email"><<a class="email" href="mailto:kari.hurtta@fmi.fi">kari.hurtta@fmi.fi</a>></code>
6240
6701
co-developed the original MIME parsing code back in the ELM-ME days.
6242
6703
The following people have been very helpful to the development of Mutt:
6243
</p><div class="itemizedlist"><ul type="disc"><li><p>Vikas Agnihotri <code class="email"><<a class="email" href="mailto:vikasa@writeme.com">vikasa@writeme.com</a>></code></p></li><li><p>Francois Berjon <code class="email"><<a class="email" href="mailto:Francois.Berjon@aar.alcatel-alsthom.fr">Francois.Berjon@aar.alcatel-alsthom.fr</a>></code></p></li><li><p>Aric Blumer <code class="email"><<a class="email" href="mailto:aric@fore.com">aric@fore.com</a>></code></p></li><li><p>John Capo <code class="email"><<a class="email" href="mailto:jc@irbs.com">jc@irbs.com</a>></code></p></li><li><p>David Champion <code class="email"><<a class="email" href="mailto:dgc@uchicago.edu">dgc@uchicago.edu</a>></code></p></li><li><p>Brendan Cully <code class="email"><<a class="email" href="mailto:brendan@kublai.com">brendan@kublai.com</a>></code></p></li><li><p>Liviu Daia <code class="email"><<a class="email" href="mailto:daia@stoilow.imar.ro">daia@stoilow.imar.ro</a>></code></p></li><li><p>Thomas E. Dickey <code class="email"><<a class="email" href="mailto:dickey@herndon4.his.com">dickey@herndon4.his.com</a>></code></p></li><li><p>David DeSimone <code class="email"><<a class="email" href="mailto:fox@convex.hp.com">fox@convex.hp.com</a>></code></p></li><li><p>Nickolay N. Dudorov <code class="email"><<a class="email" href="mailto:nnd@wint.itfs.nsk.su">nnd@wint.itfs.nsk.su</a>></code></p></li><li><p>Ruslan Ermilov <code class="email"><<a class="email" href="mailto:ru@freebsd.org">ru@freebsd.org</a>></code></p></li><li><p>Edmund Grimley Evans <code class="email"><<a class="email" href="mailto:edmundo@rano.org">edmundo@rano.org</a>></code></p></li><li><p>Michael Finken <code class="email"><<a class="email" href="mailto:finken@conware.de">finken@conware.de</a>></code></p></li><li><p>Sven Guckes <code class="email"><<a class="email" href="mailto:guckes@math.fu-berlin.de">guckes@math.fu-berlin.de</a>></code></p></li><li><p>Lars Hecking <code class="email"><<a class="email" href="mailto:lhecking@nmrc.ie">lhecking@nmrc.ie</a>></code></p></li><li><p>Mark Holloman <code class="email"><<a class="email" href="mailto:holloman@nando.net">holloman@nando.net</a>></code></p></li><li><p>Andreas Holzmann <code class="email"><<a class="email" href="mailto:holzmann@fmi.uni-passau.de">holzmann@fmi.uni-passau.de</a>></code></p></li><li><p>Marco d'Itri <code class="email"><<a class="email" href="mailto:md@linux.it">md@linux.it</a>></code></p></li><li><p>Björn Jacke <code class="email"><<a class="email" href="mailto:bjacke@suse.com">bjacke@suse.com</a>></code></p></li><li><p>Byrial Jensen <code class="email"><<a class="email" href="mailto:byrial@image.dk">byrial@image.dk</a>></code></p></li><li><p>David Jeske <code class="email"><<a class="email" href="mailto:jeske@igcom.net">jeske@igcom.net</a>></code></p></li><li><p>Christophe Kalt <code class="email"><<a class="email" href="mailto:kalt@hugo.int-evry.fr">kalt@hugo.int-evry.fr</a>></code></p></li><li><p>Tommi Komulainen <code class="email"><<a class="email" href="mailto:Tommi.Komulainen@iki.fi">Tommi.Komulainen@iki.fi</a>></code></p></li><li><p>Felix von Leitner (a.k.a “<span class="quote">Fefe</span>”) <code class="email"><<a class="email" href="mailto:leitner@math.fu-berlin.de">leitner@math.fu-berlin.de</a>></code></p></li><li><p>Brandon Long <code class="email"><<a class="email" href="mailto:blong@fiction.net">blong@fiction.net</a>></code></p></li><li><p>Jimmy Mäkelä <code class="email"><<a class="email" href="mailto:jmy@flashback.net">jmy@flashback.net</a>></code></p></li><li><p>Lars Marowsky-Bree <code class="email"><<a class="email" href="mailto:lmb@pointer.in-minden.de">lmb@pointer.in-minden.de</a>></code></p></li><li><p>Thomas “<span class="quote">Mike</span>” Michlmayr <code class="email"><<a class="email" href="mailto:mike@cosy.sbg.ac.at">mike@cosy.sbg.ac.at</a>></code></p></li><li><p>Andrew W. Nosenko <code class="email"><<a class="email" href="mailto:awn@bcs.zp.ua">awn@bcs.zp.ua</a>></code></p></li><li><p>David O'Brien <code class="email"><<a class="email" href="mailto:obrien@Nuxi.cs.ucdavis.edu">obrien@Nuxi.cs.ucdavis.edu</a>></code></p></li><li><p>Clint Olsen <code class="email"><<a class="email" href="mailto:olsenc@ichips.intel.com">olsenc@ichips.intel.com</a>></code></p></li><li><p>Park Myeong Seok <code class="email"><<a class="email" href="mailto:pms@romance.kaist.ac.kr">pms@romance.kaist.ac.kr</a>></code></p></li><li><p>Thomas Parmelan <code class="email"><<a class="email" href="mailto:tom@ankh.fr.eu.org">tom@ankh.fr.eu.org</a>></code></p></li><li><p>Ollivier Robert <code class="email"><<a class="email" href="mailto:roberto@keltia.freenix.fr">roberto@keltia.freenix.fr</a>></code></p></li><li><p>Thomas Roessler <code class="email"><<a class="email" href="mailto:roessler@does-not-exist.org">roessler@does-not-exist.org</a>></code></p></li><li><p>Roland Rosenfeld <code class="email"><<a class="email" href="mailto:roland@spinnaker.de">roland@spinnaker.de</a>></code></p></li><li><p>Rocco Rutte <code class="email"><<a class="email" href="mailto:pdmef@gmx.net">pdmef@gmx.net</a>></code></p></li><li><p>TAKIZAWA Takashi <code class="email"><<a class="email" href="mailto:taki@luna.email.ne.jp">taki@luna.email.ne.jp</a>></code></p></li><li><p>Allain Thivillon <code class="email"><<a class="email" href="mailto:Allain.Thivillon@alma.fr">Allain.Thivillon@alma.fr</a>></code></p></li><li><p>Gero Treuner <code class="email"><<a class="email" href="mailto:gero@70t.de">gero@70t.de</a>></code></p></li><li><p>Vsevolod Volkov <code class="email"><<a class="email" href="mailto:vvv@lucky.net">vvv@lucky.net</a>></code></p></li><li><p>Ken Weinert <code class="email"><<a class="email" href="mailto:kenw@ihs.com">kenw@ihs.com</a>></code></p></li></ul></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="about"></a>2. About this document</h2></div></div></div><p>
6704
</p><div class="itemizedlist"><ul type="disc"><li><p>Vikas Agnihotri <code class="email"><<a class="email" href="mailto:vikasa@writeme.com">vikasa@writeme.com</a>></code></p></li><li><p>Francois Berjon <code class="email"><<a class="email" href="mailto:Francois.Berjon@aar.alcatel-alsthom.fr">Francois.Berjon@aar.alcatel-alsthom.fr</a>></code></p></li><li><p>Aric Blumer <code class="email"><<a class="email" href="mailto:aric@fore.com">aric@fore.com</a>></code></p></li><li><p>John Capo <code class="email"><<a class="email" href="mailto:jc@irbs.com">jc@irbs.com</a>></code></p></li><li><p>David Champion <code class="email"><<a class="email" href="mailto:dgc@uchicago.edu">dgc@uchicago.edu</a>></code></p></li><li><p>Brendan Cully <code class="email"><<a class="email" href="mailto:brendan@kublai.com">brendan@kublai.com</a>></code></p></li><li><p>Liviu Daia <code class="email"><<a class="email" href="mailto:daia@stoilow.imar.ro">daia@stoilow.imar.ro</a>></code></p></li><li><p>Thomas E. Dickey <code class="email"><<a class="email" href="mailto:dickey@herndon4.his.com">dickey@herndon4.his.com</a>></code></p></li><li><p>David DeSimone <code class="email"><<a class="email" href="mailto:fox@convex.hp.com">fox@convex.hp.com</a>></code></p></li><li><p>Nickolay N. Dudorov <code class="email"><<a class="email" href="mailto:nnd@wint.itfs.nsk.su">nnd@wint.itfs.nsk.su</a>></code></p></li><li><p>Ruslan Ermilov <code class="email"><<a class="email" href="mailto:ru@freebsd.org">ru@freebsd.org</a>></code></p></li><li><p>Edmund Grimley Evans <code class="email"><<a class="email" href="mailto:edmundo@rano.org">edmundo@rano.org</a>></code></p></li><li><p>Michael Finken <code class="email"><<a class="email" href="mailto:finken@conware.de">finken@conware.de</a>></code></p></li><li><p>Sven Guckes <code class="email"><<a class="email" href="mailto:guckes@math.fu-berlin.de">guckes@math.fu-berlin.de</a>></code></p></li><li><p>Lars Hecking <code class="email"><<a class="email" href="mailto:lhecking@nmrc.ie">lhecking@nmrc.ie</a>></code></p></li><li><p>Mark Holloman <code class="email"><<a class="email" href="mailto:holloman@nando.net">holloman@nando.net</a>></code></p></li><li><p>Andreas Holzmann <code class="email"><<a class="email" href="mailto:holzmann@fmi.uni-passau.de">holzmann@fmi.uni-passau.de</a>></code></p></li><li><p>Marco d'Itri <code class="email"><<a class="email" href="mailto:md@linux.it">md@linux.it</a>></code></p></li><li><p>Björn Jacke <code class="email"><<a class="email" href="mailto:bjacke@suse.com">bjacke@suse.com</a>></code></p></li><li><p>Byrial Jensen <code class="email"><<a class="email" href="mailto:byrial@image.dk">byrial@image.dk</a>></code></p></li><li><p>David Jeske <code class="email"><<a class="email" href="mailto:jeske@igcom.net">jeske@igcom.net</a>></code></p></li><li><p>Christophe Kalt <code class="email"><<a class="email" href="mailto:kalt@hugo.int-evry.fr">kalt@hugo.int-evry.fr</a>></code></p></li><li><p>Tommi Komulainen <code class="email"><<a class="email" href="mailto:Tommi.Komulainen@iki.fi">Tommi.Komulainen@iki.fi</a>></code></p></li><li><p>Felix von Leitner (a.k.a “<span class="quote">Fefe</span>”) <code class="email"><<a class="email" href="mailto:leitner@math.fu-berlin.de">leitner@math.fu-berlin.de</a>></code></p></li><li><p>Brandon Long <code class="email"><<a class="email" href="mailto:blong@fiction.net">blong@fiction.net</a>></code></p></li><li><p>Jimmy Mäkelä <code class="email"><<a class="email" href="mailto:jmy@flashback.net">jmy@flashback.net</a>></code></p></li><li><p>Lars Marowsky-Bree <code class="email"><<a class="email" href="mailto:lmb@pointer.in-minden.de">lmb@pointer.in-minden.de</a>></code></p></li><li><p>Thomas “<span class="quote">Mike</span>” Michlmayr <code class="email"><<a class="email" href="mailto:mike@cosy.sbg.ac.at">mike@cosy.sbg.ac.at</a>></code></p></li><li><p>Andrew W. Nosenko <code class="email"><<a class="email" href="mailto:awn@bcs.zp.ua">awn@bcs.zp.ua</a>></code></p></li><li><p>David O'Brien <code class="email"><<a class="email" href="mailto:obrien@Nuxi.cs.ucdavis.edu">obrien@Nuxi.cs.ucdavis.edu</a>></code></p></li><li><p>Clint Olsen <code class="email"><<a class="email" href="mailto:olsenc@ichips.intel.com">olsenc@ichips.intel.com</a>></code></p></li><li><p>Park Myeong Seok <code class="email"><<a class="email" href="mailto:pms@romance.kaist.ac.kr">pms@romance.kaist.ac.kr</a>></code></p></li><li><p>Thomas Parmelan <code class="email"><<a class="email" href="mailto:tom@ankh.fr.eu.org">tom@ankh.fr.eu.org</a>></code></p></li><li><p>Ollivier Robert <code class="email"><<a class="email" href="mailto:roberto@keltia.freenix.fr">roberto@keltia.freenix.fr</a>></code></p></li><li><p>Thomas Roessler <code class="email"><<a class="email" href="mailto:roessler@does-not-exist.org">roessler@does-not-exist.org</a>></code></p></li><li><p>Roland Rosenfeld <code class="email"><<a class="email" href="mailto:roland@spinnaker.de">roland@spinnaker.de</a>></code></p></li><li><p>Rocco Rutte <code class="email"><<a class="email" href="mailto:pdmef@gmx.net">pdmef@gmx.net</a>></code></p></li><li><p>TAKIZAWA Takashi <code class="email"><<a class="email" href="mailto:taki@luna.email.ne.jp">taki@luna.email.ne.jp</a>></code></p></li><li><p>Allain Thivillon <code class="email"><<a class="email" href="mailto:Allain.Thivillon@alma.fr">Allain.Thivillon@alma.fr</a>></code></p></li><li><p>Gero Treuner <code class="email"><<a class="email" href="mailto:gero@70t.de">gero@70t.de</a>></code></p></li><li><p>Vsevolod Volkov <code class="email"><<a class="email" href="mailto:vvv@lucky.net">vvv@lucky.net</a>></code></p></li><li><p>Ken Weinert <code class="email"><<a class="email" href="mailto:kenw@ihs.com">kenw@ihs.com</a>></code></p></li></ul></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="about"></a>2. About This Document</h2></div></div></div><p>
6244
6705
This document was written in <a class="ulink" href="http://docbook.sourceforge.net" target="_top">DocBook</a>,
6245
6706
and then rendered using the <a class="ulink" href="http://xmlsoft.org/XSLT/" target="_top">Gnome XSLT toolkit</a>.
6246
6707
</p></div></div></div></body></html>