4241 lines
No EOL
423 KiB
HTML
4241 lines
No EOL
423 KiB
HTML
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Chapter 9. Reference</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><link rel="home" href="index.html" title="The Mutt E-Mail Client" /><link rel="up" href="index.html" title="The Mutt E-Mail Client" /><link rel="prev" href="tuning.html" title="Chapter 8. Performance Tuning" /><link rel="next" href="miscellany.html" title="Chapter 10. Miscellany" /><style xmlns="" type="text/css">
|
||
body { margin-left:2%; margin-right:2%; font-family:serif; }
|
||
.toc, .list-of-tables, .list-of-examples { font-family:sans-serif; }
|
||
h1, h2, h3, h4, h5, h6 { font-family:sans-serif; }
|
||
p { text-align:justify; }
|
||
div.table p.title, div.example p.title { font-size:smaller; font-family:sans-serif; }
|
||
.email, .email a { font-family:monospace; }
|
||
div.table-contents table, div.informaltable table { border-collapse:collapse; border:1px solid #c0c0c0; }
|
||
div.table-contents table td, div.informaltable td, div.table-contents table th, div.informaltable table th { padding:5px; text-align:left; }
|
||
div.table-contents table th, div.informaltable table th {
|
||
font-family:sans-serif;
|
||
background:#d0d0d0;
|
||
font-weight:normal;
|
||
vertical-align:top;
|
||
}
|
||
div.cmdsynopsis { border-left:1px solid #707070; padding-left:5px; }
|
||
li div.cmdsynopsis { border-left:none; padding-left:0px; }
|
||
pre.screen, div.note { background:#f0f0f0; border:1px solid #c0c0c0; padding:5px; margin-left:2%; margin-right:2%; }
|
||
div.example p.title { margin-left:2%; }
|
||
div.note h3 { font-size:small; font-style:italic; font-variant: small-caps; }
|
||
div.note h3:after { content: ":" }
|
||
div.note { margin-bottom: 5px; }
|
||
.command { font-family: monospace; font-weight: normal; }
|
||
.command strong { font-weight: normal; }
|
||
tr { vertical-align: top; }
|
||
.comment { color:#707070; }
|
||
|
||
</style></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 9. Reference</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="tuning.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="miscellany.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="reference"></a>Chapter 9. Reference</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="sect1"><a href="reference.html#commandline">1. Command-Line Options</a></span></dt><dt><span class="sect1"><a href="reference.html#commands">2. Configuration Commands</a></span></dt><dt><span class="sect1"><a href="reference.html#variables">3. Configuration Variables</a></span></dt><dt><span class="sect1"><a href="reference.html#functions">4. Functions</a></span></dt><dd><dl><dt><span class="sect2"><a href="reference.html#generic-map">4.1. Generic Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#index-map">4.2. Index Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#pager-map">4.3. Pager Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#alias-map">4.4. Alias Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#query-map">4.5. Query Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#attachment-map">4.6. Attachment Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#compose-map">4.7. Compose Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#postpone-map">4.8. Postpone Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#browser-map">4.9. Browser Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-map">4.10. Pgp Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-map">4.11. Smime Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#mixmaster-map">4.12. Mixmaster Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#editor-map">4.13. Editor Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#autocrypt-account-map">4.14. Autocrypt Account Menu</a></span></dt><dt><span class="sect2"><a href="reference.html#list-map">4.15. List Menu</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commandline"></a>1. Command-Line Options</h2></div></div></div><p>
|
||
Running <code class="literal">mutt</code> with no arguments will make Mutt attempt
|
||
to read your spool mailbox. However, it is possible to read other
|
||
mailboxes and to send messages from the command line as well.
|
||
</p><div class="table"><a id="tab-commandline-options"></a><p class="title"><strong>Table 9.1. Command line options</strong></p><div class="table-contents"><table class="table" summary="Command line options" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td>-A</td><td>expand an alias</td></tr><tr><td>-a</td><td>attach a file to a message</td></tr><tr><td>-b</td><td>specify a blind carbon-copy (BCC) address</td></tr><tr><td>-c</td><td>specify a carbon-copy (Cc) address</td></tr><tr><td>-d</td><td>log debugging output to ~/.muttdebug0 if
|
||
mutt was compiled with +DEBUG; it can range from -5 to 5 and affects
|
||
verbosity. A value of 0 disables debugging. A value less than zero
|
||
disables automatic log file rotation. A value of 2 is recommended for
|
||
most diagnostics.</td></tr><tr><td>-D</td><td>print the value of all Mutt variables to stdout</td></tr><tr><td>-E</td><td>edit the draft (-H) or include (-i) file</td></tr><tr><td>-e</td><td>specify a config command to be run after initialization files are read</td></tr><tr><td>-f</td><td>specify a mailbox to load</td></tr><tr><td>-F</td><td>specify an alternate file to read initialization commands</td></tr><tr><td>-h</td><td>print help on command line options</td></tr><tr><td>-H</td><td>specify a draft file from which to read a header and body</td></tr><tr><td>-i</td><td>specify a file to include in a message composition</td></tr><tr><td>-m</td><td>specify a default mailbox type</td></tr><tr><td>-n</td><td>do not read the system Muttrc</td></tr><tr><td>-p</td><td>recall a postponed message</td></tr><tr><td>-Q</td><td>query a configuration variable</td></tr><tr><td>-R</td><td>open mailbox in read-only mode</td></tr><tr><td>-s</td><td>specify a subject (enclose in quotes if it contains spaces)</td></tr><tr><td>-v</td><td>show version number and compile-time definitions</td></tr><tr><td>-x</td><td>simulate the mailx(1) compose mode</td></tr><tr><td>-y</td><td>show a menu containing the files specified by the <span class="command"><strong>mailboxes</strong></span> command</td></tr><tr><td>-z</td><td>exit immediately if there are no messages in the mailbox</td></tr><tr><td>-Z</td><td>open the first folder with new message, exit immediately if none</td></tr></tbody></table></div></div><br class="table-break" /><p>
|
||
To read messages in a mailbox
|
||
</p><div class="cmdsynopsis"><p><code class="command">mutt</code> [<code class="option">-nz</code>] [<code class="option">-F</code>
|
||
<em class="replaceable"><code>muttrc</code></em>
|
||
] [<code class="option">-m</code>
|
||
<em class="replaceable"><code>type</code></em>
|
||
] [<code class="option">-f</code>
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
]</p></div><p>
|
||
To compose a new message
|
||
</p><div class="cmdsynopsis"><p><code class="command">mutt</code> [<code class="option">-En</code>] [<code class="option">-F</code>
|
||
<em class="replaceable"><code>muttrc</code></em>
|
||
] [<code class="option">-c</code>
|
||
<em class="replaceable"><code>address</code></em>
|
||
] [<code class="option">-Hi</code>
|
||
<em class="replaceable"><code>filename</code></em>
|
||
] [<code class="option">-s</code>
|
||
<em class="replaceable"><code>subject</code></em>
|
||
] [
|
||
<code class="option">-a</code>
|
||
<em class="replaceable"><code>file</code></em>
|
||
[...]
|
||
--
|
||
]
|
||
<em class="replaceable"><code>address</code></em>
|
||
|
|
||
<em class="replaceable"><code>mailto_url</code></em>
|
||
... </p></div><p>
|
||
Mutt also supports a <span class="quote">“<span class="quote">batch</span>”</span> mode to send prepared
|
||
messages. Simply redirect input from the file you wish to send. For
|
||
example,
|
||
</p><pre class="screen">
|
||
mutt -s "data set for run #2" professor@bigschool.edu < ~/run2.dat</pre><p>
|
||
will send a message to
|
||
<code class="literal"><professor@bigschool.edu></code> with a subject of
|
||
<span class="quote">“<span class="quote">data set for run #2</span>”</span>. In the body of the message will be
|
||
the contents of the file <span class="quote">“<span class="quote">~/run2.dat</span>”</span>.
|
||
</p><p>
|
||
An include file passed with <code class="literal">-i</code> will be used as the
|
||
body of the message. When combined with <code class="literal">-E</code>, the
|
||
include file will be directly edited during message composition. The
|
||
file will be modified regardless of whether the message is sent or
|
||
aborted.
|
||
</p><p>
|
||
A draft file passed with <code class="literal">-H</code> will be used as the
|
||
initial header and body for the message. Multipart messages can be
|
||
used as a draft file, and are processed the same in interactive and
|
||
batch mode; they are not passed through untouched. For example,
|
||
encrypted draft files will be decrypted. When combined with
|
||
<code class="literal">-E</code>, the draft file will be updated to the final
|
||
state of the message after composition, regardless of whether the
|
||
message is sent, aborted, or even postponed. Note that if the message
|
||
is sent encrypted or signed, the draft file will be saved that way
|
||
too.
|
||
</p><p>
|
||
|
||
</p><p>
|
||
All files passed with <code class="literal">-a</code> <span class="emphasis"><em>file</em></span>
|
||
will be attached as a MIME part to the message. To attach a single or
|
||
several files, use <span class="quote">“<span class="quote">--</span>”</span> to separate files and recipient
|
||
addresses:
|
||
</p><pre class="screen">
|
||
mutt -a image.png -- some@one.org</pre><p>
|
||
or
|
||
</p><pre class="screen">
|
||
mutt -a *.png -- some@one.org</pre><div class="note"><h3 class="title">Note</h3><p>
|
||
The <code class="literal">-a</code> option must be last in the option list.
|
||
</p></div><p>
|
||
In addition to accepting a list of email addresses, Mutt also accepts a URL with
|
||
the <code class="literal">mailto:</code> schema as specified in RFC2368. This is useful
|
||
when configuring a web browser to launch Mutt when clicking on mailto links.
|
||
</p><pre class="screen">
|
||
mutt mailto:some@one.org?subject=test&cc=other@one.org</pre></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commands"></a>2. Configuration Commands</h2></div></div></div><p>
|
||
The following are the commands understood by Mutt:
|
||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="optionalfeatures.html#account-hook" title="7. Managing Multiple Accounts">account-hook</a></code>
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
<em class="replaceable"><code>command</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#alias" title="5. Defining/Using Aliases">alias</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...]
|
||
<em class="replaceable"><code>key</code></em>
|
||
|
||
<em class="replaceable"><code>address</code></em>
|
||
[
|
||
<em class="replaceable"><code>address</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#alias" title="5. Defining/Using Aliases">unalias</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...] {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>key</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...]
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
[
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">unalternates</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...] {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="mimesupport.html#alternative-order" title="5. MIME Multipart/Alternative">alternative_order</a></code>
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
[
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
...]<br /><code class="command"><a class="link" href="mimesupport.html#alternative-order" title="5. MIME Multipart/Alternative">unalternative_order</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">attachments</a></code>
|
||
<em class="replaceable"><code>{ + | - }disposition</code></em>
|
||
|
||
<em class="replaceable"><code>mime-type</code></em>
|
||
<br /><code class="command"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">unattachments</a></code>
|
||
<em class="replaceable"><code>{ + | - }disposition</code></em>
|
||
|
||
<em class="replaceable"><code>mime-type</code></em>
|
||
<br /><code class="command"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">attachments</a></code> <code class="option">?</code> <br /><code class="command"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">unattachments</a></code> <code class="option">*</code> </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="mimesupport.html#auto-view" title="4. MIME Autoview">auto_view</a></code>
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
[
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
...]<br /><code class="command"><a class="link" href="mimesupport.html#auto-view" title="4. MIME Autoview">unauto_view</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#bind" title="6. Changing the Default Key Bindings">bind</a></code>
|
||
<em class="replaceable"><code>map</code></em>
|
||
|
||
<em class="replaceable"><code>key</code></em>
|
||
|
||
<em class="replaceable"><code>function</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#cd" title="7. Changing the current working directory">cd</a></code>
|
||
<em class="replaceable"><code>directory</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#charset-hook" title="8. Defining Aliases for Character Sets">charset-hook</a></code>
|
||
<em class="replaceable"><code>alias</code></em>
|
||
|
||
<em class="replaceable"><code>charset</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#charset-hook" title="8. Defining Aliases for Character Sets">iconv-hook</a></code>
|
||
<em class="replaceable"><code>charset</code></em>
|
||
|
||
<em class="replaceable"><code>local-charset</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#color" title="11. Using Color and Mono Video Attributes">color</a></code>
|
||
<em class="replaceable"><code>object</code></em>
|
||
[
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
...]
|
||
<em class="replaceable"><code>foreground</code></em>
|
||
|
||
<em class="replaceable"><code>background</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#color" title="11. Using Color and Mono Video Attributes">color</a></code> {
|
||
<code class="option">header</code>
|
||
|
|
||
<code class="option">body</code>
|
||
} [
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
...]
|
||
<em class="replaceable"><code>foreground</code></em>
|
||
|
||
<em class="replaceable"><code>background</code></em>
|
||
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#color" title="11. Using Color and Mono Video Attributes">color</a></code>
|
||
<code class="option">index</code>
|
||
[
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
...]
|
||
<em class="replaceable"><code>foreground</code></em>
|
||
|
||
<em class="replaceable"><code>background</code></em>
|
||
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#color" title="11. Using Color and Mono Video Attributes">color</a></code>
|
||
<code class="option">compose</code>
|
||
|
||
<em class="replaceable"><code>composeobject</code></em>
|
||
[
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
...]
|
||
<em class="replaceable"><code>foreground</code></em>
|
||
|
||
<em class="replaceable"><code>background</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#color" title="11. Using Color and Mono Video Attributes">uncolor</a></code> {
|
||
<code class="option">index</code>
|
||
|
|
||
<code class="option">header</code>
|
||
|
|
||
<code class="option">body</code>
|
||
} {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#crypt-hook" title="23. Choosing the Cryptographic Key of the Recipient">crypt-hook</a></code>
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
|
||
<em class="replaceable"><code>keyid</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="advancedusage.html#echo" title="17. Echoing Text">echo</a></code>
|
||
<em class="replaceable"><code>message</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#exec" title="26. Executing Functions">exec</a></code>
|
||
<em class="replaceable"><code>function</code></em>
|
||
[
|
||
<em class="replaceable"><code>function</code></em>
|
||
...]</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-hook" title="19. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-save-hook" title="20. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#folder-hook" title="9. Setting Variables Based Upon Mailbox">folder-hook</a></code>
|
||
<em class="replaceable"><code>[!]regexp</code></em>
|
||
|
||
<em class="replaceable"><code>command</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#addrgroup" title="4. Address Groups">group</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...] {
|
||
<code class="option">-rx</code>
|
||
<em class="replaceable"><code>expr</code></em>
|
||
... |
|
||
<code class="option">-addr</code>
|
||
<em class="replaceable"><code>expr</code></em>
|
||
... }<br /><code class="command"><a class="link" href="configuration.html#addrgroup" title="4. Address Groups">ungroup</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...] {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<code class="option">-rx</code>
|
||
<em class="replaceable"><code>expr</code></em>
|
||
... |
|
||
<code class="option">-addr</code>
|
||
<em class="replaceable"><code>expr</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#hdr-order" title="12.3. Ordering Displayed Headers">hdr_order</a></code>
|
||
<em class="replaceable"><code>header</code></em>
|
||
[
|
||
<em class="replaceable"><code>header</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#hdr-order" title="12.3. Ordering Displayed Headers">unhdr_order</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>header</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#ignore" title="12.2. Selecting Headers">ignore</a></code>
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
[
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#ignore" title="12.2. Selecting Headers">unignore</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#index-format-hook" title="24. Dynamically Changing $index_format using Patterns">index-format-hook</a></code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>format-string</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#lists" title="14. Mailing Lists">lists</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
]
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
[
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#lists" title="14. Mailing Lists">unlists</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...] {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#macro" title="10. Keyboard Macros">macro</a></code>
|
||
<em class="replaceable"><code>menu</code></em>
|
||
|
||
<em class="replaceable"><code>key</code></em>
|
||
|
||
<em class="replaceable"><code>sequence</code></em>
|
||
[
|
||
<em class="replaceable"><code>description</code></em>
|
||
]</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mailboxes" title="16. Monitoring Incoming Mail">mailboxes</a></code> [
|
||
[
|
||
<code class="option">-notify</code>
|
||
|
|
||
<code class="option">-nonotify</code>
|
||
]
|
||
[
|
||
<code class="option">-poll</code>
|
||
|
|
||
<code class="option">-nopoll</code>
|
||
]
|
||
[
|
||
<code class="option">-label</code>
|
||
<em class="replaceable"><code>label</code></em>
|
||
|
|
||
<code class="option">-nolabel</code>
|
||
]
|
||
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
|
||
] [...]<br /><code class="command"><a class="link" href="configuration.html#mailboxes" title="16. Monitoring Incoming Mail">unmailboxes</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mailto-allow" title="33. Control allowed header fields in a mailto: URL">mailto_allow</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>header-field</code></em>
|
||
... }<br /><code class="command"><a class="link" href="configuration.html#mailto-allow" title="33. Control allowed header fields in a mailto: URL">unmailto_allow</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>header-field</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mbox-hook" title="15. Using Multiple Spool Mailboxes">mbox-hook</a></code>
|
||
<em class="replaceable"><code>[!]regexp</code></em>
|
||
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#message-hook" title="22. Change Settings Before Formatting a Message">message-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>command</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="mimesupport.html#mime-lookup" title="7. MIME Lookup">mime_lookup</a></code>
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
[
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
...]<br /><code class="command"><a class="link" href="mimesupport.html#mime-lookup" title="7. MIME Lookup">unmime_lookup</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>mimetype</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mono">mono</a></code>
|
||
<em class="replaceable"><code>object</code></em>
|
||
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#mono">mono</a></code> {
|
||
<code class="option">header</code>
|
||
|
|
||
<code class="option">body</code>
|
||
}
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#mono">mono</a></code>
|
||
<code class="option">index</code>
|
||
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#mono">mono</a></code>
|
||
<code class="option">compose</code>
|
||
|
||
<em class="replaceable"><code>composeobject</code></em>
|
||
|
||
<em class="replaceable"><code>attribute</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#mono">unmono</a></code> {
|
||
<code class="option">index</code>
|
||
|
|
||
<code class="option">header</code>
|
||
|
|
||
<code class="option">body</code>
|
||
} {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#my-hdr" title="17. User-Defined Headers">my_hdr</a></code>
|
||
<em class="replaceable"><code>string</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#my-hdr" title="17. User-Defined Headers">unmy_hdr</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>field</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#push" title="25. Adding Key Sequences to the Keyboard Buffer">push</a></code>
|
||
<em class="replaceable"><code>string</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#reply-hook">reply-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>command</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="advancedusage.html#run" title="20.1. Running a command generated by MuttLisp">run</a></code>
|
||
<em class="replaceable"><code>MuttLisp</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#save-hook" title="18. Specify Default Save Mailbox">save-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#score-command" title="27. Message Scoring">score</a></code>
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
|
||
<em class="replaceable"><code>value</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#score-command" title="27. Message Scoring">unscore</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#send-hook" title="21. Change Settings Based Upon Message Recipients">send-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>command</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#send2-hook">send2-hook</a></code>
|
||
<em class="replaceable"><code>[!]pattern</code></em>
|
||
|
||
<em class="replaceable"><code>command</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#set" title="29. Setting and Querying Variables">set</a></code> {
|
||
[ <code class="option">no</code> | <code class="option">inv</code> ]
|
||
<em class="replaceable"><code>variable</code></em>
|
||
|
|
||
<em class="replaceable"><code>variable=value</code></em>
|
||
} [...]<br /><code class="command"><a class="link" href="configuration.html#set" title="29. Setting and Querying Variables">toggle</a></code>
|
||
<em class="replaceable"><code>variable</code></em>
|
||
[
|
||
<em class="replaceable"><code>variable</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#set" title="29. Setting and Querying Variables">unset</a></code>
|
||
<em class="replaceable"><code>variable</code></em>
|
||
[
|
||
<em class="replaceable"><code>variable</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#set" title="29. Setting and Querying Variables">reset</a></code>
|
||
<em class="replaceable"><code>variable</code></em>
|
||
[
|
||
<em class="replaceable"><code>variable</code></em>
|
||
...]</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="advancedusage.html#setenv" title="7. Managing the Environment">setenv</a></code>
|
||
<em class="replaceable"><code>[?]variable</code></em>
|
||
[
|
||
<em class="replaceable"><code>value</code></em>
|
||
]<br /><code class="command"><a class="link" href="advancedusage.html#setenv" title="7. Managing the Environment">unsetenv</a></code>
|
||
<em class="replaceable"><code>variable</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="optionalfeatures.html#sidebar-whitelist" title="11.4. Commands">sidebar_whitelist</a></code>
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
[
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
...]<br /><code class="command"><a class="link" href="optionalfeatures.html#sidebar-whitelist" title="11.4. Commands">unsidebar_whitelist</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>mailbox</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#source" title="30. Reading Initialization Commands From Another File">source</a></code>
|
||
<em class="replaceable"><code>filename</code></em>
|
||
</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#spam" title="28. Spam Detection">spam</a></code>
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
|
||
<em class="replaceable"><code>format</code></em>
|
||
<br /><code class="command"><a class="link" href="configuration.html#spam" title="28. Spam Detection">nospam</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
}</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="advancedusage.html#display-munging" title="12. Display Munging">subjectrx</a></code>
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
|
||
<em class="replaceable"><code>replacement</code></em>
|
||
<br /><code class="command"><a class="link" href="advancedusage.html#display-munging" title="12. Display Munging">unsubjectrx</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>pattern</code></em>
|
||
}</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#subscribe">subscribe</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...]
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
[
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
...]<br /><code class="command"><a class="link" href="configuration.html#subscribe">unsubscribe</a></code> [
|
||
<code class="option">-group</code>
|
||
<em class="replaceable"><code>name</code></em>
|
||
...] {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>regexp</code></em>
|
||
... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#unhook" title="31. Removing Hooks">unhook</a></code> {
|
||
<em class="replaceable"><code>*</code></em>
|
||
|
|
||
<em class="replaceable"><code>hook-type</code></em>
|
||
}</p></div></li></ul></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="variables"></a>3. Configuration Variables</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="abort-noattach"></a>3.1. abort_noattach</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: no</p></div><p>
|
||
When the body of the message matches <a class="link" href="reference.html#abort-noattach-regexp" title="3.2. abort_noattach_regexp">$abort_noattach_regexp</a> and
|
||
there are no attachments, this quadoption controls whether to
|
||
abort sending the message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="abort-noattach-regexp"></a>3.2. abort_noattach_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">attach</code></span>”</span></p></div><p>
|
||
Specifies a regular expression to match against the body of the
|
||
message, to determine if an attachment was mentioned but
|
||
mistakenly forgotten. If it matches, <a class="link" href="reference.html#abort-noattach" title="3.1. abort_noattach">$abort_noattach</a> will be
|
||
consulted to determine if message sending will be aborted.
|
||
</p><p>
|
||
Like other regular expressions in Mutt, the search is case
|
||
sensitive if the pattern contains at least one upper case letter,
|
||
and case insensitive otherwise.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="abort-nosubject"></a>3.3. abort_nosubject</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
If set to <span class="emphasis"><em>yes</em></span>, when composing messages and no subject is given
|
||
at the subject prompt, composition will be aborted. If set to
|
||
<span class="emphasis"><em>no</em></span>, composing messages with no subject given at the subject
|
||
prompt will never be aborted.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="abort-unmodified"></a>3.4. abort_unmodified</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
If set to <span class="emphasis"><em>yes</em></span>, composition will automatically abort after
|
||
editing the message body if no changes are made to the file (this
|
||
check only happens after the <span class="emphasis"><em>first</em></span> edit of the file). When set
|
||
to <span class="emphasis"><em>no</em></span>, composition will never be aborted.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="alias-file"></a>3.5. alias_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/.muttrc</code></span>”</span></p></div><p>
|
||
The default file in which to save aliases created by the
|
||
<code class="literal"><a class="link" href="gettingstarted.html#create-alias"><create-alias></a></code> function. Entries added to this file are
|
||
encoded in the character set specified by <a class="link" href="reference.html#config-charset" title="3.47. config_charset">$config_charset</a> if it
|
||
is <span class="emphasis"><em>set</em></span> or the current character set otherwise.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> Mutt will not automatically source this file; you must
|
||
explicitly use the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#source" title="30. Reading Initialization Commands From Another File">source</a></span>”</span> command for it to be executed in case
|
||
this option points to a dedicated alias file.
|
||
</p><p>
|
||
The default for this option is the currently used muttrc file, or
|
||
<span class="quote">“<span class="quote">~/.muttrc</span>”</span> if no user muttrc was found.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="alias-format"></a>3.6. alias_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%4n %2f %t %-10a %r</code></span>”</span></p></div><p>
|
||
Specifies the format of the data displayed for the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alias" title="5. Defining/Using Aliases">alias</a></span>”</span> menu. The
|
||
following <code class="literal">printf(3)</code>-style sequences are available:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>alias name
|
||
</td></tr><tr><td>%f </td><td>flags - currently, a <span class="quote">“<span class="quote">d</span>”</span> for an alias marked for deletion
|
||
</td></tr><tr><td>%n </td><td>index number
|
||
</td></tr><tr><td>%r </td><td>address which alias expands to
|
||
</td></tr><tr><td>%t </td><td>character which indicates if the alias is tagged for inclusion
|
||
</td></tr></tbody></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="allow-8bit"></a>3.7. allow_8bit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls whether 8-bit data is converted to 7-bit using either Quoted-
|
||
Printable or Base64 encoding when sending mail.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="allow-ansi"></a>3.8. allow_ansi</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether ANSI color codes in messages (and color tags in
|
||
rich text messages) are to be interpreted.
|
||
Messages containing these codes are rare, but if this option is <span class="emphasis"><em>set</em></span>,
|
||
their text will be colored accordingly. Note that this may override
|
||
your color choices, and even present a security problem, since a
|
||
message could include a line like
|
||
|
||
</p><pre class="screen">
|
||
[-- PGP output follows ...
|
||
</pre><p>
|
||
and give it the same color as your attachment color (see also
|
||
<a class="link" href="reference.html#crypt-timestamp" title="3.70. crypt_timestamp">$crypt_timestamp</a>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="arrow-cursor"></a>3.9. arrow_cursor</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, an arrow (<span class="quote">“<span class="quote">-></span>”</span>) will be used to indicate the current entry
|
||
in menus instead of highlighting the whole line. On slow network or modem
|
||
links this will make response faster because there is less that has to
|
||
be redrawn on the screen when moving to the next or previous entries
|
||
in the menu.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ascii-chars"></a>3.10. ascii_chars</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will use plain ASCII characters when displaying thread
|
||
and attachment trees, instead of the default <span class="emphasis"><em>ACS</em></span> characters.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="askbcc"></a>3.11. askbcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will prompt you for blind-carbon-copy (Bcc) recipients
|
||
before editing an outgoing message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="askcc"></a>3.12. askcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will prompt you for carbon-copy (Cc) recipients before
|
||
editing the body of an outgoing message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="assumed-charset"></a>3.13. assumed_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable is a colon-separated list of character encoding
|
||
schemes for messages without character encoding indication.
|
||
Header field values and message body content without character encoding
|
||
indication would be assumed that they are written in one of this list.
|
||
By default, all the header fields and message body without any charset
|
||
indication are assumed to be in <span class="quote">“<span class="quote">us-ascii</span>”</span>.
|
||
</p><p>
|
||
For example, Japanese users might prefer this:
|
||
|
||
</p><pre class="screen">
|
||
set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
|
||
</pre><p>
|
||
However, only the first content is valid for the message body.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attach-charset"></a>3.14. attach_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable is a colon-separated list of character encoding
|
||
schemes for text file attachments. Mutt uses this setting to guess
|
||
which encoding files being attached are encoded in to convert them to
|
||
a proper character set given in <a class="link" href="reference.html#send-charset" title="3.302. send_charset">$send_charset</a>.
|
||
</p><p>
|
||
If <span class="emphasis"><em>unset</em></span>, the value of <a class="link" href="reference.html#charset" title="3.41. charset">$charset</a> will be used instead.
|
||
For example, the following configuration would work for Japanese
|
||
text handling:
|
||
|
||
</p><pre class="screen">
|
||
set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
|
||
</pre><p>
|
||
Note: for Japanese users, <span class="quote">“<span class="quote">iso-2022-*</span>”</span> must be put at the head
|
||
of the value as shown above if included.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attach-format"></a>3.15. attach_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] </code></span>”</span></p></div><p>
|
||
This variable describes the format of the <span class="quote">“<span class="quote">attachment</span>”</span> menu. The
|
||
following <code class="literal">printf(3)</code>-style sequences are understood:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%C </td><td>charset
|
||
</td></tr><tr><td>%c </td><td>requires charset conversion (<span class="quote">“<span class="quote">n</span>”</span> or <span class="quote">“<span class="quote">c</span>”</span>)
|
||
</td></tr><tr><td>%D </td><td>deleted flag
|
||
</td></tr><tr><td>%d </td><td>description (if none, falls back to %F)
|
||
</td></tr><tr><td>%e </td><td>MIME content-transfer-encoding
|
||
</td></tr><tr><td>%F </td><td>filename in content-disposition header (if none, falls back to %f)
|
||
</td></tr><tr><td>%f </td><td>filename
|
||
</td></tr><tr><td>%I </td><td>disposition (<span class="quote">“<span class="quote">I</span>”</span> for inline, <span class="quote">“<span class="quote">A</span>”</span> for attachment)
|
||
</td></tr><tr><td>%m </td><td>major MIME type
|
||
</td></tr><tr><td>%M </td><td>MIME subtype
|
||
</td></tr><tr><td>%n </td><td>attachment number
|
||
</td></tr><tr><td>%Q </td><td><span class="quote">“<span class="quote">Q</span>”</span>, if MIME part qualifies for attachment counting
|
||
</td></tr><tr><td>%s </td><td>size (see <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>)
|
||
</td></tr><tr><td>%t </td><td>tagged flag
|
||
</td></tr><tr><td>%T </td><td>graphic tree characters
|
||
</td></tr><tr><td>%u </td><td>unlink (=to delete) flag
|
||
</td></tr><tr><td>%X </td><td>number of qualifying MIME parts in this part and its children
|
||
(please see the <span class="quote">“<span class="quote"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">attachments</a></span>”</span> section for possible speed effects)
|
||
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
|
||
</td></tr></tbody></table></div><p>
|
||
For an explanation of <span class="quote">“<span class="quote">soft-fill</span>”</span>, see the <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a> documentation.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attach-save-charset-convert"></a>3.16. attach_save_charset_convert</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
When saving received text-type attachments, this quadoption
|
||
prompts to convert the character set if the encoding of the
|
||
attachment (or <a class="link" href="reference.html#assumed-charset" title="3.13. assumed_charset">$assumed_charset</a> if none is specified) differs
|
||
from <a class="link" href="reference.html#charset" title="3.41. charset">charset</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attach-save-dir"></a>3.17. attach_save_dir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
The default directory to save attachments from the <span class="quote">“<span class="quote">attachment</span>”</span> menu.
|
||
If it doesn't exist, Mutt will prompt to create the directory before
|
||
saving.
|
||
</p><p>
|
||
If the path is invalid (e.g. not a directory, or cannot be
|
||
chdir'ed to), Mutt will fall back to using the current directory.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attach-sep"></a>3.18. attach_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">\n</code></span>”</span></p></div><p>
|
||
The separator to add between attachments when operating (saving,
|
||
printing, piping, etc) on a list of tagged attachments.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attach-split"></a>3.19. attach_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If this variable is <span class="emphasis"><em>unset</em></span>, when operating (saving, printing, piping,
|
||
etc) on a list of tagged attachments, Mutt will concatenate the
|
||
attachments and will operate on them as a single attachment. The
|
||
<a class="link" href="reference.html#attach-sep" title="3.18. attach_sep">$attach_sep</a> separator is added after each attachment. When <span class="emphasis"><em>set</em></span>,
|
||
Mutt will operate on the attachments one by one.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attribution"></a>3.20. attribution</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">On %d, %n wrote:</code></span>”</span></p></div><p>
|
||
This is the string that will precede a message which has been included
|
||
in a reply. For a full listing of defined <code class="literal">printf(3)</code>-like sequences see
|
||
the section on <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="attribution-locale"></a>3.21. attribution_locale</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
The locale used by <code class="literal">strftime(3)</code> to format dates in the
|
||
<a class="link" href="reference.html#attribution" title="3.20. attribution">attribution</a> string. Legal values are the strings your system
|
||
accepts for the locale environment variable <code class="literal">$LC_TIME</code>.
|
||
</p><p>
|
||
This variable is to allow the attribution date format to be
|
||
customized by recipient or folder using hooks. By default, Mutt
|
||
will use your locale environment, so there is no need to set
|
||
this except to override that default.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="auto-subscribe"></a>3.22. auto_subscribe</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt assumes the presence of a List-Post header
|
||
means the recipient is subscribed to the list. Unless the mailing list
|
||
is in the <span class="quote">“<span class="quote">unsubscribe</span>”</span> or <span class="quote">“<span class="quote">unlist</span>”</span> lists, it will be added
|
||
to the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>”</span> list. Parsing and checking these things slows
|
||
header reading down, so this option is disabled by default.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="auto-tag"></a>3.23. auto_tag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, functions in the <span class="emphasis"><em>index</em></span> menu which affect a message
|
||
will be applied to all tagged messages (if there are any). When
|
||
unset, you must first use the <code class="literal"><tag-prefix></code> function (bound to <span class="quote">“<span class="quote">;</span>”</span>
|
||
by default) to make the next function apply to all tagged messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="autocrypt"></a>3.24. autocrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, enables autocrypt, which provides
|
||
passive encryption protection with keys exchanged via headers.
|
||
See <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#autocryptdoc" title="13. Autocrypt">autocryptdoc</a></span>”</span> for more details.
|
||
(Autocrypt only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="autocrypt-acct-format"></a>3.25. autocrypt_acct_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%4n %-30a %20p %10s</code></span>”</span></p></div><p>
|
||
This variable describes the format of the <span class="quote">“<span class="quote">autocrypt account</span>”</span> menu.
|
||
The following <code class="literal">printf(3)</code>-style sequences are understood
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>email address
|
||
</td></tr><tr><td>%k </td><td>gpg keyid
|
||
</td></tr><tr><td>%n </td><td>current entry number
|
||
</td></tr><tr><td>%p </td><td>prefer-encrypt flag
|
||
</td></tr><tr><td>%s </td><td>status flag (active/inactive)
|
||
</td></tr></tbody></table></div><p>
|
||
(Autocrypt only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="autocrypt-dir"></a>3.26. autocrypt_dir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/.mutt/autocrypt</code></span>”</span></p></div><p>
|
||
This variable sets where autocrypt files are stored, including the GPG
|
||
keyring and sqlite database. See <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#autocryptdoc" title="13. Autocrypt">autocryptdoc</a></span>”</span> for more details.
|
||
(Autocrypt only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="autocrypt-reply"></a>3.27. autocrypt_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, replying to an autocrypt email automatically
|
||
enables autocrypt in the reply. You may want to unset this if you're using
|
||
the same key for autocrypt as normal web-of-trust, so that autocrypt
|
||
isn't forced on for all encrypted replies.
|
||
(Autocrypt only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="autoedit"></a>3.28. autoedit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span> along with <a class="link" href="reference.html#edit-headers" title="3.84. edit_headers">$edit_headers</a>, Mutt will skip the initial
|
||
send-menu (prompting for subject and recipients) and allow you to
|
||
immediately begin editing the body of your
|
||
message. The send-menu may still be accessed once you have finished
|
||
editing the body of your message.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> when this option is <span class="emphasis"><em>set</em></span>, you cannot use send-hooks that depend
|
||
on the recipients when composing a new (non-reply) message, as the initial
|
||
list of recipients is empty.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#fast-reply" title="3.91. fast_reply">$fast_reply</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="background-edit"></a>3.29. background_edit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will run <a class="link" href="reference.html#editor" title="3.85. editor">$editor</a> in the background during
|
||
message composition. A landing page will display, waiting for
|
||
the <a class="link" href="reference.html#editor" title="3.85. editor">$editor</a> to exit. The landing page may be exited, allowing
|
||
perusal of the mailbox, or even for other messages to be
|
||
composed. Backgrounded sessions may be returned to via the
|
||
<code class="literal"><background-compose-menu></code> function.
|
||
</p><p>
|
||
For background editing to work properly, <a class="link" href="reference.html#editor" title="3.85. editor">$editor</a> must be set to
|
||
an editor that does not try to use the Mutt terminal: for example
|
||
a graphical editor, or a script launching (and waiting for) the
|
||
editor in another Gnu Screen window.
|
||
</p><p>
|
||
For more details, see <span class="quote">“<span class="quote"><a class="link" href="gettingstarted.html#bgedit" title="6.5. Background Editing">bgedit</a></span>”</span> ("Background Editing" in the manual).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="background-confirm-quit"></a>3.30. background_confirm_quit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, if there are any background edit sessions, you
|
||
will be prompted to confirm exiting Mutt, in addition to the
|
||
<a class="link" href="reference.html#quit" title="3.273. quit">$quit</a> prompt.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="background-format"></a>3.31. background_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%10S %7p %s</code></span>”</span></p></div><p>
|
||
This variable describes the format of the <span class="quote">“<span class="quote">background compose</span>”</span>
|
||
menu. The following <code class="literal">printf(3)</code>-style sequences are
|
||
understood:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%i </td><td>parent message id (for replies and forwarded messages)
|
||
</td></tr><tr><td>%n </td><td>the running number on the menu
|
||
</td></tr><tr><td>%p </td><td>pid of the <a class="link" href="reference.html#editor" title="3.85. editor">$editor</a> process
|
||
</td></tr><tr><td>%r </td><td>comma separated list of <span class="quote">“<span class="quote">To:</span>”</span> recipients
|
||
</td></tr><tr><td>%R </td><td>comma separated list of <span class="quote">“<span class="quote">Cc:</span>”</span> recipients
|
||
</td></tr><tr><td>%s </td><td>subject of the message
|
||
</td></tr><tr><td>%S </td><td>status of the <a class="link" href="reference.html#editor" title="3.85. editor">$editor</a> process: running/finished
|
||
</td></tr></tbody></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="beep"></a>3.32. beep</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, mutt will beep when an error occurs.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="beep-new"></a>3.33. beep_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, mutt will beep whenever it prints a message
|
||
notifying you of new mail. This is independent of the setting of the
|
||
<a class="link" href="reference.html#beep" title="3.32. beep">$beep</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="bounce"></a>3.34. bounce</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
Controls whether you will be asked to confirm bouncing messages.
|
||
If set to <span class="emphasis"><em>yes</em></span> you don't get asked if you want to bounce a
|
||
message. Setting this variable to <span class="emphasis"><em>no</em></span> is not generally useful,
|
||
and thus not recommended, because you are unable to bounce messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="bounce-delivered"></a>3.35. bounce_delivered</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, mutt will include Delivered-To headers when
|
||
bouncing messages. Postfix users may wish to <span class="emphasis"><em>unset</em></span> this variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="braille-friendly"></a>3.36. braille_friendly</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, mutt will place the cursor at the beginning
|
||
of the current line in menus, even when the <a class="link" href="reference.html#arrow-cursor" title="3.9. arrow_cursor">$arrow_cursor</a> variable
|
||
is <span class="emphasis"><em>unset</em></span>, making it easier for blind persons using Braille displays to
|
||
follow these menus. The option is <span class="emphasis"><em>unset</em></span> by default because many
|
||
visual terminals don't permit making the cursor invisible.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="browser-abbreviate-mailboxes"></a>3.37. browser_abbreviate_mailboxes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, mutt will abbreviate mailbox
|
||
names in the browser mailbox list, using '~' and '='
|
||
shortcuts.
|
||
</p><p>
|
||
The default <code class="literal">"alpha"</code> setting of <a class="link" href="reference.html#sort-browser" title="3.365. sort_browser">$sort_browser</a> uses
|
||
locale-based sorting (using <code class="literal">strcoll(3)</code>), which ignores some
|
||
punctuation. This can lead to some situations where the order
|
||
doesn't make intuitive sense. In those cases, it may be
|
||
desirable to <span class="emphasis"><em>unset</em></span> this variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="browser-sticky-cursor"></a>3.38. browser_sticky_cursor</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, the browser will attempt to keep
|
||
the cursor on the same mailbox when performing various functions.
|
||
These include moving up a directory, toggling between mailboxes
|
||
and directory listing, creating/renaming a mailbox, toggling
|
||
subscribed mailboxes, and entering a new mask.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="certificate-file"></a>3.39. certificate_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/.mutt_certificates</code></span>”</span></p></div><p>
|
||
This variable specifies the file where the certificates you trust
|
||
are saved. When an unknown certificate is encountered, you are asked
|
||
if you accept it or not. If you accept it, the certificate can also
|
||
be saved in this file and further connections are automatically
|
||
accepted.
|
||
</p><p>
|
||
You can also manually add CA certificates in this file. Any server
|
||
certificate that is signed with one of these CA certificates is
|
||
also automatically accepted.
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set certificate_file=~/.mutt/certificates
|
||
</pre><p>
|
||
(OpenSSL and GnuTLS only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="change-folder-next"></a>3.40. change_folder_next</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, the <code class="literal"><change-folder></code> function
|
||
mailbox suggestion will start at the next folder in your <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mailboxes" title="16. Monitoring Incoming Mail">mailboxes</a></span>”</span>
|
||
list, instead of starting at the first folder in the list.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="charset"></a>3.41. charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Character set your terminal uses to display and enter textual data.
|
||
It is also the fallback for <a class="link" href="reference.html#send-charset" title="3.302. send_charset">$send_charset</a>.
|
||
</p><p>
|
||
Upon startup Mutt tries to derive this value from environment variables
|
||
such as <code class="literal">$LC_CTYPE</code> or <code class="literal">$LANG</code>.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> It should only be set in case Mutt isn't able to determine the
|
||
character set used correctly.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="check-mbox-size"></a>3.42. check_mbox_size</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, mutt will use file size attribute instead of
|
||
access time when checking for new mail in mbox and mmdf folders.
|
||
</p><p>
|
||
This variable is <span class="emphasis"><em>unset</em></span> by default and should only be enabled when
|
||
new mail detection for these folder types is unreliable or doesn't work.
|
||
</p><p>
|
||
Note that enabling this variable should happen before any <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mailboxes" title="16. Monitoring Incoming Mail">mailboxes</a></span>”</span>
|
||
directives occur in configuration files regarding mbox or mmdf folders
|
||
because mutt needs to determine the initial new mail status of such a
|
||
mailbox by performing a fast mailbox scan when it is defined.
|
||
Afterwards the new mail status is tracked by file size changes.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="check-new"></a>3.43. check_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
<span class="bold"><strong>Note:</strong></span> this option only affects <span class="emphasis"><em>maildir</em></span> and <span class="emphasis"><em>MH</em></span> style
|
||
mailboxes.
|
||
</p><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will check for new mail delivered while the
|
||
mailbox is open. Especially with MH mailboxes, this operation can
|
||
take quite some time since it involves scanning the directory and
|
||
checking each file to see if it has already been looked at. If
|
||
this variable is <span class="emphasis"><em>unset</em></span>, no check for new mail is performed
|
||
while the mailbox is open.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="collapse-unread"></a>3.44. collapse_unread</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>unset</em></span>, Mutt will not collapse a thread if it contains any
|
||
unread messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="compose-confirm-detach-first"></a>3.45. compose_confirm_detach_first</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will prompt for confirmation when trying to
|
||
use <code class="literal"><detach-file></code> on the first entry in the compose menu.
|
||
This is to help prevent irreversible loss of the typed message by
|
||
accidentally hitting 'D' in the menu.
|
||
</p><p>
|
||
Note: Mutt only prompts for the first entry. It doesn't keep
|
||
track of which message is the typed message if the entries are
|
||
reordered, or if the first entry was already deleted.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="compose-format"></a>3.46. compose_format</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-</code></span>”</span></p></div><p>
|
||
Controls the format of the status line displayed in the <span class="quote">“<span class="quote">compose</span>”</span>
|
||
menu. This string is similar to <a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a>, but has its own
|
||
set of <code class="literal">printf(3)</code>-like sequences:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>total number of attachments
|
||
</td></tr><tr><td>%h </td><td>local hostname
|
||
</td></tr><tr><td>%l </td><td>approximate size (in bytes) of the current message (see <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>)
|
||
</td></tr><tr><td>%v </td><td>Mutt version string
|
||
</td></tr></tbody></table></div><p>
|
||
See the text describing the <a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a> option for more
|
||
information on how to set <a class="link" href="reference.html#compose-format" title="3.46. compose_format">$compose_format</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="config-charset"></a>3.47. config_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
When defined, Mutt will recode commands in rc files from this
|
||
encoding to the current character set as specified by <a class="link" href="reference.html#charset" title="3.41. charset">$charset</a>
|
||
and aliases written to <a class="link" href="reference.html#alias-file" title="3.5. alias_file">$alias_file</a> from the current character set.
|
||
</p><p>
|
||
Please note that if setting <a class="link" href="reference.html#charset" title="3.41. charset">$charset</a> it must be done before
|
||
setting <a class="link" href="reference.html#config-charset" title="3.47. config_charset">$config_charset</a>.
|
||
</p><p>
|
||
Recoding should be avoided as it may render unconvertable
|
||
characters as question marks which can lead to undesired
|
||
side effects (for example in regular expressions).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="confirmappend"></a>3.48. confirmappend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will prompt for confirmation when appending messages to
|
||
an existing mailbox.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="confirmcreate"></a>3.49. confirmcreate</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will prompt for confirmation when saving messages to a
|
||
mailbox which does not yet exist before creating it.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="connect-timeout"></a>3.50. connect_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 30</p></div><p>
|
||
Causes Mutt to timeout a network connection (for IMAP, POP or SMTP) after this
|
||
many seconds if the connection is not able to be established. A negative
|
||
value causes Mutt to wait indefinitely for the connection attempt to succeed.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="content-type"></a>3.51. content_type</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">text/plain</code></span>”</span></p></div><p>
|
||
Sets the default Content-Type for the body of newly composed messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="copy"></a>3.52. copy</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether or not copies of your outgoing messages
|
||
will be saved for later references. Also see <a class="link" href="reference.html#record" title="3.279. record">$record</a>,
|
||
<a class="link" href="reference.html#save-name" title="3.296. save_name">$save_name</a>, <a class="link" href="reference.html#force-name" title="3.100. force_name">$force_name</a> and <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="19. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="copy-decode-weed"></a>3.53. copy_decode_weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether Mutt will weed headers when invoking the
|
||
<code class="literal"><decode-copy></code> or <code class="literal"><decode-save></code> functions.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="count-alternatives"></a>3.54. count_alternatives</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will recurse inside multipart/alternatives while
|
||
performing attachment searching and counting (see <a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">attachments</a>).
|
||
</p><p>
|
||
Traditionally, multipart/alternative parts have simply represented
|
||
different encodings of the main content of the email. Unfortunately,
|
||
some mail clients have started to place email attachments inside
|
||
one of alternatives. Setting this will allow Mutt to find
|
||
and count matching attachments hidden there, and include them
|
||
in the index via %X or through ~X pattern matching.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="cursor-overlay"></a>3.55. cursor_overlay</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will overlay the indicator, tree,
|
||
sidebar_highlight, and sidebar_indicator colors onto the currently
|
||
selected line. This will allow <code class="literal">default</code> colors in those
|
||
to be overridden, and for attributes to be merged between
|
||
the layers.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.56. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Setting this variable will cause Mutt to always attempt to PGP
|
||
encrypt outgoing messages. This is probably only useful in
|
||
connection to the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#send-hook" title="21. Change Settings Based Upon Message Recipients">send-hook</a></span>”</span> command. It can be overridden
|
||
by use of the pgp menu, when encryption is not required or
|
||
signing is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.344. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
|
||
then OpenSSL is used instead to create S/MIME messages and
|
||
settings can be overridden by use of the smime menu instead.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.57. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether or not mutt may automatically enable
|
||
PGP encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.56. crypt_autoencrypt">$crypt_autoencrypt</a>,
|
||
<a class="link" href="reference.html#crypt-replyencrypt" title="3.67. crypt_replyencrypt">$crypt_replyencrypt</a>,
|
||
<a class="link" href="reference.html#crypt-autosign" title="3.58. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.68. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.344. smime_is_default">$smime_is_default</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.58. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Setting this variable will cause Mutt to always attempt to
|
||
cryptographically sign outgoing messages. This can be overridden
|
||
by use of the pgp menu, when signing is not required or
|
||
encryption is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.344. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
|
||
then OpenSSL is used instead to create S/MIME messages and settings can
|
||
be overridden by use of the smime menu instead of the pgp menu.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.59. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether or not mutt may automatically enable
|
||
S/MIME encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.56. crypt_autoencrypt">$crypt_autoencrypt</a>,
|
||
<a class="link" href="reference.html#crypt-replyencrypt" title="3.67. crypt_replyencrypt">$crypt_replyencrypt</a>,
|
||
<a class="link" href="reference.html#crypt-autosign" title="3.58. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.68. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.344. smime_is_default">$smime_is_default</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-confirmhook"></a>3.60. crypt_confirmhook</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If set, then you will be prompted for confirmation of keys when using
|
||
the <span class="emphasis"><em>crypt-hook</em></span> command. If unset, no such confirmation prompt will
|
||
be presented. This is generally considered unsafe, especially where
|
||
typos are concerned.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-opportunistic-encrypt"></a>3.61. crypt_opportunistic_encrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Setting this variable will cause Mutt to automatically enable and
|
||
disable encryption, based on whether all message recipient keys
|
||
can be located by Mutt.
|
||
</p><p>
|
||
When this option is enabled, Mutt will enable/disable encryption
|
||
each time the TO, CC, and BCC lists are edited. If
|
||
<a class="link" href="reference.html#edit-headers" title="3.84. edit_headers">$edit_headers</a> is set, Mutt will also do so each time the message
|
||
is edited.
|
||
</p><p>
|
||
While this is set, encryption can't be manually enabled/disabled.
|
||
The pgp or smime menus provide a selection to temporarily disable
|
||
this option for the current message.
|
||
</p><p>
|
||
If <a class="link" href="reference.html#crypt-autoencrypt" title="3.56. crypt_autoencrypt">$crypt_autoencrypt</a> or <a class="link" href="reference.html#crypt-replyencrypt" title="3.67. crypt_replyencrypt">$crypt_replyencrypt</a> enable encryption for
|
||
a message, this option will be disabled for that message. It can
|
||
be manually re-enabled in the pgp or smime menus.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-opportunistic-encrypt-strong-keys"></a>3.62. crypt_opportunistic_encrypt_strong_keys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When set, this modifies the behavior of <a class="link" href="reference.html#crypt-opportunistic-encrypt" title="3.61. crypt_opportunistic_encrypt">$crypt_opportunistic_encrypt</a>
|
||
to only search for "strong keys", that is, keys with full validity
|
||
according to the web-of-trust algorithm. A key with marginal or no
|
||
validity will not enable opportunistic encryption.
|
||
</p><p>
|
||
For S/MIME, the behavior depends on the backend. Classic S/MIME will
|
||
filter for certificates with the 't' (trusted) flag in the .index file.
|
||
The GPGME backend will use the same filters as with OpenPGP, and depends
|
||
on GPGME's logic for assigning the GPGME_VALIDITY_FULL and
|
||
GPGME_VALIDITY_ULTIMATE validity flag.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-protected-headers-read"></a>3.63. crypt_protected_headers_read</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When set, Mutt will display protected headers in the pager,
|
||
and will update the index and header cache with revised headers.
|
||
Protected headers are stored inside the encrypted or signed part of an
|
||
an email, to prevent disclosure or tampering.
|
||
For more information see https://github.com/autocrypt/protected-headers.
|
||
Currently Mutt only supports the Subject header.
|
||
</p><p>
|
||
Encrypted messages using protected headers often substitute the exposed
|
||
Subject header with a dummy value (see <a class="link" href="reference.html#crypt-protected-headers-subject" title="3.65. crypt_protected_headers_subject">$crypt_protected_headers_subject</a>).
|
||
Mutt will update its concept of the correct subject <span class="bold"><strong>after</strong></span> the
|
||
message is opened, i.e. via the <code class="literal"><display-message></code> function.
|
||
If you reply to a message before opening it, Mutt will end up using
|
||
the dummy Subject header, so be sure to open such a message first.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-protected-headers-save"></a>3.64. crypt_protected_headers_save</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <a class="link" href="reference.html#crypt-protected-headers-read" title="3.63. crypt_protected_headers_read">$crypt_protected_headers_read</a> is set, and a message with a
|
||
protected Subject is opened, Mutt will save the updated Subject
|
||
into the header cache by default. This allows searching/limiting
|
||
based on the protected Subject header if the mailbox is
|
||
re-opened, without having to re-open the message each time.
|
||
However, for mbox/mh mailbox types, or if header caching is not
|
||
set up, you would need to re-open the message each time the
|
||
mailbox was reopened before you could see or search/limit on the
|
||
protected subject again.
|
||
</p><p>
|
||
When this variable is set, Mutt additionally saves the protected
|
||
Subject back <span class="bold"><strong>in the clear-text message headers</strong></span>. This
|
||
provides better usability, but with the tradeoff of reduced
|
||
security. The protected Subject header, which may have
|
||
previously been encrypted, is now stored in clear-text in the
|
||
message headers. Copying the message elsewhere, via Mutt or
|
||
external tools, could expose this previously encrypted data.
|
||
Please make sure you understand the consequences of this before
|
||
you enable this variable.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-protected-headers-subject"></a>3.65. crypt_protected_headers_subject</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">...</code></span>”</span></p></div><p>
|
||
When <a class="link" href="reference.html#crypt-protected-headers-write" title="3.66. crypt_protected_headers_write">$crypt_protected_headers_write</a> is set, and the message is marked
|
||
for encryption, this will be substituted into the Subject field in the
|
||
message headers.
|
||
To prevent a subject from being substituted, unset this variable, or set it
|
||
to the empty string.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-protected-headers-write"></a>3.66. crypt_protected_headers_write</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When set, Mutt will generate protected headers for signed and
|
||
encrypted emails.
|
||
Protected headers are stored inside the encrypted or signed part of an
|
||
an email, to prevent disclosure or tampering.
|
||
For more information see https://github.com/autocrypt/protected-headers.
|
||
Currently Mutt only supports the Subject header.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.67. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL encrypt replies to messages which are
|
||
encrypted.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.68. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages which are
|
||
signed.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted
|
||
<span class="emphasis"><em>and</em></span> signed!
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.69. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages
|
||
which are encrypted. This makes sense in combination with
|
||
<a class="link" href="reference.html#crypt-replyencrypt" title="3.67. crypt_replyencrypt">$crypt_replyencrypt</a>, because it allows you to sign all
|
||
messages which are automatically encrypted. This works around
|
||
the problem noted in <a class="link" href="reference.html#crypt-replysign" title="3.68. crypt_replysign">$crypt_replysign</a>, that mutt is not able
|
||
to find out whether an encrypted message is also signed.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.70. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will include a time stamp in the lines surrounding
|
||
PGP or S/MIME output, so spoofing such lines is more difficult.
|
||
If you are using colors to mark these lines, and rely on these,
|
||
you may <span class="emphasis"><em>unset</em></span> this setting.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.71. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This variable controls the use of the GPGME-enabled crypto backends.
|
||
If it is <span class="emphasis"><em>set</em></span> and Mutt was built with gpgme support, the gpgme code for
|
||
S/MIME and PGP will be used instead of the classic code. Note that
|
||
you need to set this option in .muttrc; it won't have any effect when
|
||
used interactively.
|
||
</p><p>
|
||
Note that the GPGME backend does not support creating old-style inline
|
||
(traditional) PGP encrypted or signed messages (see <a class="link" href="reference.html#pgp-autoinline" title="3.213. pgp_autoinline">$pgp_autoinline</a>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.72. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether mutt uses PKA
|
||
(see http://www.g10code.de/docs/pka-intro.de.pdf) during signature
|
||
verification (only supported by the GPGME backend).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.73. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em><span class="quote">“<span class="quote">yes</span>”</span></em></span>, always attempt to verify PGP or S/MIME signatures.
|
||
If <span class="emphasis"><em><span class="quote">“<span class="quote">ask-*</span>”</span></em></span>, ask whether or not to verify the signature.
|
||
If <span class="emphasis"><em><span class="quote">“<span class="quote">no</span>”</span></em></span>, never attempt to verify cryptographic signatures.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.74. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">!%a, %b %d, %Y at %I:%M:%S%p %Z</code></span>”</span></p></div><p>
|
||
This variable controls the format of the date printed by the <span class="quote">“<span class="quote">%d</span>”</span>
|
||
sequence in <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>. This is passed to the <code class="literal">strftime(3)</code>
|
||
function to process the date, see the man page for the proper syntax.
|
||
</p><p>
|
||
Unless the first character in the string is a bang (<span class="quote">“<span class="quote">!</span>”</span>), the month
|
||
and week day names are expanded according to the locale.
|
||
If the first character in the string is a
|
||
bang, the bang is discarded, and the month and week day names in the
|
||
rest of the string are expanded in the <span class="emphasis"><em>C</em></span> locale (that is in US
|
||
English).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.75. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~f %s !~P | (~P ~C %s)</code></span>”</span></p></div><p>
|
||
This variable controls how <span class="quote">“<span class="quote"><a class="link" href="configuration.html#message-hook" title="22. Change Settings Before Formatting a Message">message-hook</a></span>”</span>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#reply-hook">reply-hook</a></span>”</span>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#send-hook" title="21. Change Settings Based Upon Message Recipients">send-hook</a></span>”</span>,
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#send2-hook">send2-hook</a></span>”</span>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#save-hook" title="18. Specify Default Save Mailbox">save-hook</a></span>”</span>, and <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="19. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span> will
|
||
be interpreted if they are specified with only a simple regexp,
|
||
instead of a matching pattern. The hooks are expanded when they are
|
||
declared, so a hook will be interpreted according to the value of this
|
||
variable at the time the hook is declared.
|
||
</p><p>
|
||
The default value matches
|
||
if the message is either from a user matching the regular expression
|
||
given, or if it is from you (if the from address matches
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></span>”</span>) and is to or cc'ed to a user matching the given
|
||
regular expression.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="delete"></a>3.76. delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
Controls whether or not messages are really deleted when closing or
|
||
synchronizing a mailbox. If set to <span class="emphasis"><em>yes</em></span>, messages marked for
|
||
deleting will automatically be purged without prompting. If set to
|
||
<span class="emphasis"><em>no</em></span>, messages marked for deletion will be kept in the mailbox.
|
||
</p><p>
|
||
This option is ignored for maildir-style mailboxes when <a class="link" href="reference.html#maildir-trash" title="3.172. maildir_trash">$maildir_trash</a>
|
||
is set.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="delete-untag"></a>3.77. delete_untag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If this option is <span class="emphasis"><em>set</em></span>, mutt will untag messages when marking them
|
||
for deletion. This applies when you either explicitly delete a message,
|
||
or when you save it to another folder.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="digest-collapse"></a>3.78. digest_collapse</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If this option is <span class="emphasis"><em>set</em></span>, mutt's received-attachments menu will not show the subparts of
|
||
individual messages in a multipart/digest. To see these subparts, press <span class="quote">“<span class="quote">v</span>”</span> on that menu.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="display-filter"></a>3.79. display_filter</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
When set, specifies a command used to filter messages. When a message
|
||
is viewed it is passed as standard input to <a class="link" href="reference.html#display-filter" title="3.79. display_filter">$display_filter</a>, and the
|
||
filtered message is read from the standard output.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="dotlock-program"></a>3.80. dotlock_program</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">/usr/local/bin/mutt_dotlock</code></span>”</span></p></div><p>
|
||
Contains the path of the <code class="literal">mutt_dotlock(1)</code> binary to be used by
|
||
mutt.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-notify"></a>3.81. dsn_notify</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable sets the request for when notification is returned. The
|
||
string consists of a comma separated list (no spaces!) of one or more
|
||
of the following: <span class="emphasis"><em>never</em></span>, to never request notification,
|
||
<span class="emphasis"><em>failure</em></span>, to request notification on transmission failure,
|
||
<span class="emphasis"><em>delay</em></span>, to be notified of message delays, <span class="emphasis"><em>success</em></span>, to be
|
||
notified of successful transmission.
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set dsn_notify="failure,delay"
|
||
</pre><p>
|
||
<span class="bold"><strong>Note:</strong></span> when using <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a> for delivery, you should not enable
|
||
this unless you are either using Sendmail 8.8.x or greater or a MTA
|
||
providing a <code class="literal">sendmail(1)</code>-compatible interface supporting the <code class="literal">-N</code> option
|
||
for DSN. For SMTP delivery, DSN support is auto-detected so that it
|
||
depends on the server whether DSN will be used or not.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-return"></a>3.82. dsn_return</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable controls how much of your message is returned in DSN
|
||
messages. It may be set to either <span class="emphasis"><em>hdrs</em></span> to return just the
|
||
message header, or <span class="emphasis"><em>full</em></span> to return the full message.
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set dsn_return=hdrs
|
||
</pre><p>
|
||
<span class="bold"><strong>Note:</strong></span> when using <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a> for delivery, you should not enable
|
||
this unless you are either using Sendmail 8.8.x or greater or a MTA
|
||
providing a <code class="literal">sendmail(1)</code>-compatible interface supporting the <code class="literal">-R</code> option
|
||
for DSN. For SMTP delivery, DSN support is auto-detected so that it
|
||
depends on the server whether DSN will be used or not.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.83. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether mutt, when <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a> is set to <span class="emphasis"><em>threads</em></span>, threads
|
||
messages with the same Message-Id together. If it is <span class="emphasis"><em>set</em></span>, it will indicate
|
||
that it thinks they are duplicates of each other with an equals sign
|
||
in the thread tree.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.84. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This option allows you to edit the header of your outgoing messages
|
||
along with the body of your message.
|
||
</p><p>
|
||
Although the compose menu may have localized header labels, the
|
||
labels passed to your editor will be standard RFC 2822 headers,
|
||
(e.g. To:, Cc:, Subject:). Headers added in your editor must
|
||
also be RFC 2822 headers, or one of the pseudo headers listed in
|
||
<span class="quote">“<span class="quote"><a class="link" href="gettingstarted.html#edit-header" title="6.2. Editing the Message Header">edit-header</a></span>”</span>. Mutt will not understand localized header
|
||
labels, just as it would not when parsing an actual email.
|
||
</p><p>
|
||
<span class="bold"><strong>Note</strong></span> that changes made to the References: and Date: headers are
|
||
ignored for interoperability reasons.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.85. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable specifies which editor is used by mutt.
|
||
It defaults to the value of the <code class="literal">$VISUAL</code>, or <code class="literal">$EDITOR</code>, environment
|
||
variable, or to the string <span class="quote">“<span class="quote">vi</span>”</span> if neither of those are set.
|
||
</p><p>
|
||
The <code class="literal"><a class="link" href="reference.html#editor" title="3.85. editor">$editor</a></code> string may contain a <span class="emphasis"><em>%s</em></span> escape, which will be replaced by the name
|
||
of the file to be edited. If the <span class="emphasis"><em>%s</em></span> escape does not appear in <code class="literal"><a class="link" href="reference.html#editor" title="3.85. editor">$editor</a></code>, a
|
||
space and the name to be edited are appended.
|
||
</p><p>
|
||
The resulting string is then executed by running
|
||
|
||
</p><pre class="screen">
|
||
sh -c 'string'
|
||
</pre><p>
|
||
where <span class="emphasis"><em>string</em></span> is the expansion of <code class="literal"><a class="link" href="reference.html#editor" title="3.85. editor">$editor</a></code> described above.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.86. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will quoted-printable encode messages when
|
||
they contain the string <span class="quote">“<span class="quote">From </span>”</span> (note the trailing space) in the beginning of a line.
|
||
This is useful to avoid the tampering certain mail delivery and transport
|
||
agents tend to do with messages (in order to prevent tools from
|
||
misinterpreting the line as a mbox message separator).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.87. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
The file which includes random data that is used to initialize SSL
|
||
library functions. (OpenSSL only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.88. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
|
||
Default: (empty)</p></div><p>
|
||
Manually sets the <span class="emphasis"><em>envelope</em></span> sender for outgoing messages.
|
||
This value is ignored if <a class="link" href="reference.html#use-envelope-from" title="3.411. use_envelope_from">$use_envelope_from</a> is <span class="emphasis"><em>unset</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="error-history"></a>3.89. error_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 30</p></div><p>
|
||
This variable controls the size (in number of strings remembered)
|
||
of the error messages displayed by mutt. These can be shown with
|
||
the <code class="literal"><error-history></code> function. The history is cleared each
|
||
time this variable is set.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.90. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~</code></span>”</span></p></div><p>
|
||
Escape character to use for functions in the built-in editor.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.91. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, the initial prompt for recipients and subject are skipped
|
||
when replying to messages, and the initial prompt for subject is
|
||
skipped when forwarding messages.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> this variable has no effect when the <a class="link" href="reference.html#autoedit" title="3.28. autoedit">$autoedit</a>
|
||
variable is <span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.92. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether or not attachments on outgoing messages
|
||
are saved along with the main body of your message.
|
||
</p><p>
|
||
Note: <a class="link" href="reference.html#fcc-before-send" title="3.93. fcc_before_send">$fcc_before_send</a> forces the default (set) behavior of this option.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-before-send"></a>3.93. fcc_before_send</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, FCCs will occur before sending
|
||
the message. Before sending, the message cannot be manipulated,
|
||
so it will be stored the exact same as sent:
|
||
<a class="link" href="reference.html#fcc-attach" title="3.92. fcc_attach">$fcc_attach</a> and <a class="link" href="reference.html#fcc-clear" title="3.94. fcc_clear">$fcc_clear</a> will be ignored (using their default
|
||
values).
|
||
</p><p>
|
||
When <span class="emphasis"><em>unset</em></span>, the default, FCCs will occur after sending.
|
||
Variables <a class="link" href="reference.html#fcc-attach" title="3.92. fcc_attach">$fcc_attach</a> and <a class="link" href="reference.html#fcc-clear" title="3.94. fcc_clear">$fcc_clear</a> will be respected, allowing
|
||
it to be stored without attachments or encryption/signing if
|
||
desired.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.94. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, FCCs will be stored unencrypted and
|
||
unsigned, even when the actual message is encrypted and/or
|
||
signed.
|
||
</p><p>
|
||
Note: <a class="link" href="reference.html#fcc-before-send" title="3.93. fcc_before_send">$fcc_before_send</a> forces the default (unset) behavior of this option.
|
||
(PGP only)
|
||
</p><p>
|
||
See also <a class="link" href="reference.html#pgp-self-encrypt" title="3.235. pgp_self_encrypt">$pgp_self_encrypt</a>, <a class="link" href="reference.html#smime-self-encrypt" title="3.348. smime_self_encrypt">$smime_self_encrypt</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-delimiter"></a>3.95. fcc_delimiter</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
When specified, this allows the ability to Fcc to more than one
|
||
mailbox. The fcc value will be split by this delimiter and Mutt
|
||
will evaluate each part as a mailbox separately.
|
||
</p><p>
|
||
See <a class="link" href="reference.html#record" title="3.279. record">$record</a>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="19. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span>, and <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-save-hook" title="20. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="flag-safe"></a>3.96. flag_safe</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If set, flagged messages cannot be deleted.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.97. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/Mail</code></span>”</span></p></div><p>
|
||
Specifies the default location of your mailboxes. A <span class="quote">“<span class="quote">+</span>”</span> or <span class="quote">“<span class="quote">=</span>”</span> at the
|
||
beginning of a pathname will be expanded to the value of this
|
||
variable. Note that if you change this variable (from the default)
|
||
value you need to make sure that the assignment occurs <span class="emphasis"><em>before</em></span>
|
||
you use <span class="quote">“<span class="quote">+</span>”</span> or <span class="quote">“<span class="quote">=</span>”</span> for any other variables since expansion takes place
|
||
when handling the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mailboxes" title="16. Monitoring Incoming Mail">mailboxes</a></span>”</span> command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.98. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f</code></span>”</span></p></div><p>
|
||
This variable allows you to customize the file browser display to your
|
||
personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>, but has
|
||
its own set of <code class="literal">printf(3)</code>-like sequences:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%C </td><td>current file number
|
||
</td></tr><tr><td>%d </td><td>date/time folder was last modified
|
||
</td></tr><tr><td>%D </td><td>date/time folder was last modified using <a class="link" href="reference.html#date-format" title="3.74. date_format">$date_format</a>.
|
||
</td></tr><tr><td>%f </td><td>filename (<span class="quote">“<span class="quote">/</span>”</span> is appended to directory names,
|
||
<span class="quote">“<span class="quote">@</span>”</span> to symbolic links and <span class="quote">“<span class="quote">*</span>”</span> to executable
|
||
files)
|
||
</td></tr><tr><td>%F </td><td>file permissions
|
||
</td></tr><tr><td>%g </td><td>group name (or numeric gid, if missing)
|
||
</td></tr><tr><td>%l </td><td>number of hard links
|
||
</td></tr><tr><td>%m </td><td>number of messages in the mailbox *
|
||
</td></tr><tr><td>%n </td><td>number of unread messages in the mailbox *
|
||
</td></tr><tr><td>%N </td><td>N if mailbox has new mail, blank otherwise
|
||
</td></tr><tr><td>%s </td><td>size in bytes (see <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>)
|
||
</td></tr><tr><td>%t </td><td><span class="quote">“<span class="quote">*</span>”</span> if the file is tagged, blank otherwise
|
||
</td></tr><tr><td>%u </td><td>owner name (or numeric uid, if missing)
|
||
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
|
||
</td></tr></tbody></table></div><p>
|
||
For an explanation of <span class="quote">“<span class="quote">soft-fill</span>”</span>, see the <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a> documentation.
|
||
</p><p>
|
||
* = can be optionally printed if nonzero
|
||
</p><p>
|
||
%m, %n, and %N only work for monitored mailboxes.
|
||
%m requires <a class="link" href="reference.html#mail-check-stats" title="3.167. mail_check_stats">$mail_check_stats</a> to be set.
|
||
%n requires <a class="link" href="reference.html#mail-check-stats" title="3.167. mail_check_stats">$mail_check_stats</a> to be set (except for IMAP mailboxes).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.99. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls whether or not the <span class="quote">“<span class="quote">Mail-Followup-To:</span>”</span> header field is
|
||
generated when sending mail. When <span class="emphasis"><em>set</em></span>, Mutt will generate this
|
||
field when you are replying to a known mailing list, specified with
|
||
the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>”</span> or <span class="quote">“<span class="quote"><a class="link" href="configuration.html#lists" title="14. Mailing Lists">lists</a></span>”</span> commands.
|
||
</p><p>
|
||
This field has two purposes. First, preventing you from
|
||
receiving duplicate copies of replies to messages which you send
|
||
to mailing lists, and second, ensuring that you do get a reply
|
||
separately for any messages sent to known lists to which you are
|
||
not subscribed.
|
||
</p><p>
|
||
The header will contain only the list's address
|
||
for subscribed lists, and both the list address and your own
|
||
email address for unsubscribed lists. Without this header, a
|
||
group reply to your message sent to a subscribed list will be
|
||
sent to both the list and your address, resulting in two copies
|
||
of the same email for you.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="force-name"></a>3.100. force_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This variable is similar to <a class="link" href="reference.html#save-name" title="3.296. save_name">$save_name</a>, except that Mutt will
|
||
store a copy of your outgoing message by the username of the address
|
||
you are sending to even if that mailbox does not exist.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#record" title="3.279. record">$record</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-attachments"></a>3.101. forward_attachments</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
When forwarding inline (i.e. <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> <span class="emphasis"><em>unset</em></span> or
|
||
answered with <span class="quote">“<span class="quote">no</span>”</span> and <a class="link" href="reference.html#forward-decode" title="3.104. forward_decode">$forward_decode</a> <span class="emphasis"><em>set</em></span>), attachments
|
||
which cannot be decoded in a reasonable manner will be attached
|
||
to the newly composed message if this quadoption is <span class="emphasis"><em>set</em></span> or
|
||
answered with <span class="quote">“<span class="quote">yes</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-attribution-intro"></a>3.102. forward_attribution_intro</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">----- Forwarded message from %f -----</code></span>”</span></p></div><p>
|
||
This is the string that will precede a message which has been forwarded
|
||
in the main body of a message (when <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> is unset).
|
||
For a full listing of defined <code class="literal">printf(3)</code>-like sequences see
|
||
the section on <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>. See also <a class="link" href="reference.html#attribution-locale" title="3.21. attribution_locale">$attribution_locale</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-attribution-trailer"></a>3.103. forward_attribution_trailer</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">----- End forwarded message -----</code></span>”</span></p></div><p>
|
||
This is the string that will follow a message which has been forwarded
|
||
in the main body of a message (when <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> is unset).
|
||
For a full listing of defined <code class="literal">printf(3)</code>-like sequences see
|
||
the section on <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>. See also <a class="link" href="reference.html#attribution-locale" title="3.21. attribution_locale">$attribution_locale</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decode"></a>3.104. forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls the decoding of complex MIME messages into <code class="literal">text/plain</code> when
|
||
forwarding a message. The message header is also RFC2047 decoded.
|
||
This variable is only used, if <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> is <span class="emphasis"><em>unset</em></span>,
|
||
otherwise <a class="link" href="reference.html#mime-forward-decode" title="3.194. mime_forward_decode">$mime_forward_decode</a> is used instead.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decrypt"></a>3.105. forward_decrypt</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
This quadoption controls the handling of encrypted messages when
|
||
forwarding or attaching a message. When set to or answered
|
||
<span class="quote">“<span class="quote">yes</span>”</span>, the outer layer of encryption is stripped off.
|
||
</p><p>
|
||
This variable is used if <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span> and
|
||
<a class="link" href="reference.html#mime-forward-decode" title="3.194. mime_forward_decode">$mime_forward_decode</a> is <span class="emphasis"><em>unset</em></span>. It is also used when
|
||
attaching a message via <code class="literal"><attach-message></code> in the compose
|
||
menu. (PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-edit"></a>3.106. forward_edit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
This quadoption controls whether or not the user is automatically
|
||
placed in the editor when forwarding messages. For those who always want
|
||
to forward with no modification, use a setting of <span class="quote">“<span class="quote">no</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-format"></a>3.107. forward_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">[%a: %s]</code></span>”</span></p></div><p>
|
||
This variable controls the default subject when forwarding a message.
|
||
It uses the same format sequences as the <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="forward-quote"></a>3.108. forward_quote</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, forwarded messages included in the main body of the
|
||
message (when <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> is <span class="emphasis"><em>unset</em></span>) will be quoted using
|
||
<a class="link" href="reference.html#indent-string" title="3.160. indent_string">$indent_string</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="from"></a>3.109. from</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
|
||
Default: (empty)</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, this variable contains a default from address. It
|
||
can be overridden using <span class="quote">“<span class="quote"><a class="link" href="configuration.html#my-hdr" title="17. User-Defined Headers">my_hdr</a></span>”</span> (including from a <span class="quote">“<span class="quote"><a class="link" href="configuration.html#send-hook" title="21. Change Settings Based Upon Message Recipients">send-hook</a></span>”</span>) and
|
||
<a class="link" href="reference.html#reverse-name" title="3.290. reverse_name">$reverse_name</a>. This variable is ignored if <a class="link" href="reference.html#use-from" title="3.412. use_from">$use_from</a> is <span class="emphasis"><em>unset</em></span>.
|
||
</p><p>
|
||
This setting defaults to the contents of the environment variable <code class="literal">$EMAIL</code>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="gecos-mask"></a>3.110. gecos_mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">^[^,]*</code></span>”</span></p></div><p>
|
||
A regular expression used by mutt to parse the GECOS field of a password
|
||
entry when expanding the alias. The default value
|
||
will return the string up to the first <span class="quote">“<span class="quote">,</span>”</span> encountered.
|
||
If the GECOS field contains a string like <span class="quote">“<span class="quote">lastname, firstname</span>”</span> then you
|
||
should set it to <span class="quote">“<span class="quote"><code class="literal">.*</code></span>”</span>.
|
||
</p><p>
|
||
This can be useful if you see the following behavior: you address an e-mail
|
||
to user ID <span class="quote">“<span class="quote">stevef</span>”</span> whose full name is <span class="quote">“<span class="quote">Steve Franklin</span>”</span>. If mutt expands
|
||
<span class="quote">“<span class="quote">stevef</span>”</span> to <span class="quote">“<span class="quote">"Franklin" stevef@foo.bar</span>”</span> then you should set the <a class="link" href="reference.html#gecos-mask" title="3.110. gecos_mask">$gecos_mask</a> to
|
||
a regular expression that will match the whole name so mutt will expand
|
||
<span class="quote">“<span class="quote">Franklin</span>”</span> to <span class="quote">“<span class="quote">Franklin, Steve</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hdrs"></a>3.111. hdrs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>unset</em></span>, the header fields normally added by the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#my-hdr" title="17. User-Defined Headers">my_hdr</a></span>”</span>
|
||
command are not created. This variable <span class="emphasis"><em>must</em></span> be unset before
|
||
composing a new message or replying in order to take effect. If <span class="emphasis"><em>set</em></span>,
|
||
the user defined header fields are added to every new message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="header"></a>3.112. header</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, this variable causes Mutt to include the header
|
||
of the message you are replying to into the edit buffer.
|
||
The <a class="link" href="reference.html#weed" title="3.417. weed">$weed</a> setting applies.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache"></a>3.113. header_cache</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable points to the header cache database.
|
||
If pointing to a directory Mutt will contain a header cache
|
||
database file per folder, if pointing to a file that file will
|
||
be a single global header cache. By default it is <span class="emphasis"><em>unset</em></span> so no header
|
||
caching will be used. If pointing to a directory, it must be
|
||
created in advance.
|
||
</p><p>
|
||
Header caching can greatly improve speed when opening POP, IMAP
|
||
MH or Maildir folders, see <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#caching" title="8. Local Caching">caching</a></span>”</span> for details.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-compress"></a>3.114. header_cache_compress</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When mutt is compiled with qdbm, tokyocabinet, or kyotocabinet as header
|
||
cache backend, this option determines whether the database will be compressed.
|
||
Compression results in database files roughly being one fifth
|
||
of the usual diskspace, but the decompression can result in a
|
||
slower opening of cached folder(s) which in general is still
|
||
much faster than opening non header cached folders.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-pagesize"></a>3.115. header_cache_pagesize</h3></div></div></div><div class="literallayout"><p>Type: number (long)<br />
|
||
Default: 16384</p></div><p>
|
||
When mutt is compiled with either gdbm or bdb4 as the header cache backend,
|
||
this option changes the database page size. Too large or too small
|
||
values can waste space, memory, or CPU time. The default should be more
|
||
or less optimal for most use cases.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="header-color-partial"></a>3.116. header_color_partial</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, color header regexps behave like color body regexps:
|
||
color is applied to the exact text matched by the regexp. When
|
||
<span class="emphasis"><em>unset</em></span>, color is applied to the entire header.
|
||
</p><p>
|
||
One use of this option might be to apply color to just the header labels.
|
||
</p><p>
|
||
See <span class="quote">“<span class="quote"><a class="link" href="configuration.html#color" title="11. Using Color and Mono Video Attributes">color</a></span>”</span> for more details.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="help"></a>3.117. help</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, help lines describing the bindings for the major functions
|
||
provided by each menu are displayed on the first line of the screen.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> The binding will not be displayed correctly if the
|
||
function is bound to a sequence rather than a single keystroke. Also,
|
||
the help line may not be updated if a binding is changed while Mutt is
|
||
running. Since this variable is primarily aimed at new users, neither
|
||
of these should present a major problem.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hidden-host"></a>3.118. hidden_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will skip the host name part of <a class="link" href="reference.html#hostname" title="3.129. hostname">$hostname</a> variable
|
||
when adding the domain part to addresses. This variable does not
|
||
affect the generation of Message-IDs, and it will not lead to the
|
||
cut-off of first-level domains.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hide-limited"></a>3.119. hide_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of messages that are hidden
|
||
by limiting, in the thread tree.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hide-missing"></a>3.120. hide_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of missing messages in the
|
||
thread tree.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hide-thread-subject"></a>3.121. hide_thread_subject</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will not show the subject of messages in the thread
|
||
tree that have the same subject as their parent or closest previously
|
||
displayed sibling.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-limited"></a>3.122. hide_top_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of messages that are hidden
|
||
by limiting, at the top of threads in the thread tree. Note that when
|
||
<a class="link" href="reference.html#hide-limited" title="3.119. hide_limited">$hide_limited</a> is <span class="emphasis"><em>set</em></span>, this option will have no effect.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-missing"></a>3.123. hide_top_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of missing messages at the
|
||
top of threads in the thread tree. Note that when <a class="link" href="reference.html#hide-missing" title="3.120. hide_missing">$hide_missing</a> is
|
||
<span class="emphasis"><em>set</em></span>, this option will have no effect.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="history"></a>3.124. history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 10</p></div><p>
|
||
This variable controls the size (in number of strings remembered) of
|
||
the string history buffer per category. The buffer is cleared each time the
|
||
variable is set.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="history-file"></a>3.125. history_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/.mutthistory</code></span>”</span></p></div><p>
|
||
The file in which Mutt will save its history.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#save-history" title="3.295. save_history">$save_history</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="history-remove-dups"></a>3.126. history_remove_dups</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, all of the string history will be scanned for duplicates
|
||
when a new entry is added. Duplicate entries in the <a class="link" href="reference.html#history-file" title="3.125. history_file">$history_file</a> will
|
||
also be removed when it is periodically compacted.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="honor-disposition"></a>3.127. honor_disposition</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will not display attachments with a
|
||
disposition of <span class="quote">“<span class="quote">attachment</span>”</span> inline even if it could
|
||
render the part to plain text. These MIME parts can only
|
||
be viewed from the attachment menu.
|
||
</p><p>
|
||
If <span class="emphasis"><em>unset</em></span>, Mutt will render all MIME parts it can
|
||
properly transform to plain text.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="honor-followup-to"></a>3.128. honor_followup_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether or not a Mail-Followup-To header is
|
||
honored when group-replying to a message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="hostname"></a>3.129. hostname</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Specifies the fully-qualified hostname of the system mutt is running on
|
||
containing the host's name and the DNS domain it belongs to. It is used
|
||
as the domain part (after <span class="quote">“<span class="quote">@</span>”</span>) for local email addresses as well as
|
||
Message-Id headers.
|
||
</p><p>
|
||
Its value is determined at startup as follows: the node's
|
||
hostname is first determined by the <code class="literal">uname(3)</code> function. The
|
||
domain is then looked up using the <code class="literal">gethostname(2)</code> and
|
||
<code class="literal">getaddrinfo(3)</code> functions. If those calls are unable to
|
||
determine the domain, the full value returned by uname is used.
|
||
Optionally, Mutt can be compiled with a fixed domain name in
|
||
which case a detected one is not used.
|
||
</p><p>
|
||
Starting in Mutt 2.0, the operations described in the previous
|
||
paragraph are performed after the muttrc is processed, instead of
|
||
beforehand. This way, if the DNS operations are creating delays
|
||
at startup, you can avoid those by manually setting the value in
|
||
your muttrc.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#use-domain" title="3.410. use_domain">$use_domain</a> and <a class="link" href="reference.html#hidden-host" title="3.118. hidden_host">$hidden_host</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idn-decode"></a>3.130. idn_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will show you international domain names decoded.
|
||
Note: You can use IDNs for addresses even if this is <span class="emphasis"><em>unset</em></span>.
|
||
This variable only affects decoding. (IDN only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idn-encode"></a>3.131. idn_encode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will encode international domain names using
|
||
IDN. Unset this if your SMTP server can handle newer (RFC 6531)
|
||
UTF-8 encoded domains. (IDN only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-linear-white-space"></a>3.132. ignore_linear_white_space</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This option replaces linear-white-space between encoded-word
|
||
and text to a single space to prevent the display of MIME-encoded
|
||
<span class="quote">“<span class="quote">Subject:</span>”</span> field from being divided into multiple lines.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-list-reply-to"></a>3.133. ignore_list_reply_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Affects the behavior of the <code class="literal"><reply></code> function when replying to
|
||
messages from mailing lists (as defined by the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>”</span> or
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#lists" title="14. Mailing Lists">lists</a></span>”</span> commands). When <span class="emphasis"><em>set</em></span>, if the <span class="quote">“<span class="quote">Reply-To:</span>”</span> field is
|
||
set to the same value as the <span class="quote">“<span class="quote">To:</span>”</span> field, Mutt assumes that the
|
||
<span class="quote">“<span class="quote">Reply-To:</span>”</span> field was set by the mailing list to automate responses
|
||
to the list, and will ignore this field. To direct a response to the
|
||
mailing list when this option is <span class="emphasis"><em>set</em></span>, use the <code class="literal"><a class="link" href="gettingstarted.html#list-reply"><list-reply></a></code>
|
||
function; <code class="literal"><group-reply></code> will reply to both the sender and the
|
||
list.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-authenticators"></a>3.134. imap_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This is a colon-delimited list of authentication methods mutt may
|
||
attempt to use to log in to an IMAP server, in the order mutt should
|
||
try them. Authentication methods are either <span class="quote">“<span class="quote">login</span>”</span> or the right
|
||
side of an IMAP <span class="quote">“<span class="quote">AUTH=xxx</span>”</span> capability string, e.g. <span class="quote">“<span class="quote">digest-md5</span>”</span>, <span class="quote">“<span class="quote">gssapi</span>”</span>
|
||
or <span class="quote">“<span class="quote">cram-md5</span>”</span>. This option is case-insensitive. If it's
|
||
<span class="emphasis"><em>unset</em></span> (the default) mutt will try all available methods,
|
||
in order from most-secure to least-secure.
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set imap_authenticators="gssapi:cram-md5:login"
|
||
</pre><p>
|
||
<span class="bold"><strong>Note:</strong></span> Mutt will only fall back to other authentication methods if
|
||
the previous methods are unavailable. If a method is available but
|
||
authentication fails, mutt will not connect to the IMAP server.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-check-subscribed"></a>3.135. imap_check_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will fetch the set of subscribed folders from
|
||
your server on connection, and add them to the set of mailboxes
|
||
it polls for new mail just as if you had issued individual <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mailboxes" title="16. Monitoring Incoming Mail">mailboxes</a></span>”</span>
|
||
commands.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-condstore"></a>3.136. imap_condstore</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will use the CONDSTORE extension (RFC 7162)
|
||
if advertised by the server. Mutt's current implementation is basic,
|
||
used only for initial message fetching and flag updates.
|
||
</p><p>
|
||
For some IMAP servers, enabling this will slightly speed up
|
||
downloading initial messages. Unfortunately, Gmail is not one
|
||
those, and displays worse performance when enabled. Your
|
||
mileage may vary.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-deflate"></a>3.137. imap_deflate</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will use the COMPRESS=DEFLATE extension (RFC
|
||
4978) if advertised by the server.
|
||
</p><p>
|
||
In general a good compression efficiency can be achieved, which
|
||
speeds up reading large mailboxes also on fairly good connections.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-delim-chars"></a>3.138. imap_delim_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">/.</code></span>”</span></p></div><p>
|
||
This contains the list of characters which you would like to treat
|
||
as folder separators for displaying IMAP paths. In particular it
|
||
helps in using the <span class="quote">“<span class="quote">=</span>”</span> shortcut for your <span class="emphasis"><em>folder</em></span> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-fetch-chunk-size"></a>3.139. imap_fetch_chunk_size</h3></div></div></div><div class="literallayout"><p>Type: number (long)<br />
|
||
Default: 0</p></div><p>
|
||
When set to a value greater than 0, new headers will be
|
||
downloaded in groups of this many headers per request. If you
|
||
have a very large mailbox, this might prevent a timeout and
|
||
disconnect when opening the mailbox, by sending a FETCH per set
|
||
of this many headers, instead of a single FETCH for all new
|
||
headers.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-headers"></a>3.140. imap_headers</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Mutt requests these header fields in addition to the default headers
|
||
(<span class="quote">“<span class="quote">Date:</span>”</span>, <span class="quote">“<span class="quote">From:</span>”</span>, <span class="quote">“<span class="quote">Sender:</span>”</span>, <span class="quote">“<span class="quote">Subject:</span>”</span>, <span class="quote">“<span class="quote">To:</span>”</span>, <span class="quote">“<span class="quote">Cc:</span>”</span>, <span class="quote">“<span class="quote">Message-Id:</span>”</span>,
|
||
<span class="quote">“<span class="quote">References:</span>”</span>, <span class="quote">“<span class="quote">Content-Type:</span>”</span>, <span class="quote">“<span class="quote">Content-Description:</span>”</span>, <span class="quote">“<span class="quote">In-Reply-To:</span>”</span>,
|
||
<span class="quote">“<span class="quote">Reply-To:</span>”</span>, <span class="quote">“<span class="quote">Lines:</span>”</span>, <span class="quote">“<span class="quote">List-Post:</span>”</span>, <span class="quote">“<span class="quote">X-Label:</span>”</span>) from IMAP
|
||
servers before displaying the index menu. You may want to add more
|
||
headers for spam detection.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> This is a space separated list, items should be uppercase
|
||
and not contain the colon, e.g. <span class="quote">“<span class="quote">X-BOGOSITY X-SPAM-STATUS</span>”</span> for the
|
||
<span class="quote">“<span class="quote">X-Bogosity:</span>”</span> and <span class="quote">“<span class="quote">X-Spam-Status:</span>”</span> header fields.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-idle"></a>3.141. imap_idle</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will attempt to use the IMAP IDLE extension
|
||
to check for new mail in the current mailbox. Some servers
|
||
(dovecot was the inspiration for this option) react badly
|
||
to mutt's implementation. If your connection seems to freeze
|
||
up periodically, try unsetting this.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-keepalive"></a>3.142. imap_keepalive</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 300</p></div><p>
|
||
This variable specifies the maximum amount of time in seconds that mutt
|
||
will wait before polling open IMAP connections, to prevent the server
|
||
from closing them before mutt has finished with them. The default is
|
||
well within the RFC-specified minimum amount of time (30 minutes) before
|
||
a server is allowed to do this, but in practice the RFC does get
|
||
violated every now and then. Reduce this number if you find yourself
|
||
getting disconnected from your IMAP server due to inactivity.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-list-subscribed"></a>3.143. imap_list_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This variable configures whether IMAP folder browsing will look for
|
||
only subscribed folders or all folders. This can be toggled in the
|
||
IMAP browser with the <code class="literal"><toggle-subscribed></code> function.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-login"></a>3.144. imap_login</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Your login name on the IMAP server.
|
||
</p><p>
|
||
This variable defaults to the value of <a class="link" href="reference.html#imap-user" title="3.155. imap_user">$imap_user</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-oauth-refresh-command"></a>3.145. imap_oauth_refresh_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
The command to run to generate an OAUTH refresh token for
|
||
authorizing your connection to your IMAP server. This command will be
|
||
run on every connection attempt that uses the OAUTHBEARER authentication
|
||
mechanism. See <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#oauth" title="6. OAUTHBEARER Support">oauth</a></span>”</span> for details.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-pass"></a>3.146. imap_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Specifies the password for your IMAP account. If <span class="emphasis"><em>unset</em></span>, Mutt will
|
||
prompt you for your password when you invoke the <code class="literal"><imap-fetch-mail></code> function
|
||
or try to open an IMAP folder.
|
||
</p><p>
|
||
<span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a
|
||
fairly secure machine, because the superuser can read your muttrc even
|
||
if you are the only one who can read the file.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-passive"></a>3.147. imap_passive</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will not open new IMAP connections to check for new
|
||
mail. Mutt will only check for new mail over existing IMAP
|
||
connections. This is useful if you don't want to be prompted for
|
||
user/password pairs on mutt invocation, or if opening the connection
|
||
is slow.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-peek"></a>3.148. imap_peek</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will avoid implicitly marking your mail as read whenever
|
||
you fetch a message from the server. This is generally a good thing,
|
||
but can make closing an IMAP folder somewhat slower. This option
|
||
exists to appease speed freaks.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-pipeline-depth"></a>3.149. imap_pipeline_depth</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 15</p></div><p>
|
||
Controls the number of IMAP commands that may be queued up before they
|
||
are sent to the server. A deeper pipeline reduces the amount of time
|
||
mutt must wait for the server, and can make IMAP servers feel much
|
||
more responsive. But not all servers correctly handle pipelined commands,
|
||
so if you have problems you might want to try setting this variable to 0.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> Changes to this variable have no effect on open connections.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-poll-timeout"></a>3.150. imap_poll_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 15</p></div><p>
|
||
This variable specifies the maximum amount of time in seconds
|
||
that mutt will wait for a response when polling IMAP connections
|
||
for new mail, before timing out and closing the connection. Set
|
||
to 0 to disable timing out.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-qresync"></a>3.151. imap_qresync</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will use the QRESYNC extension (RFC 7162)
|
||
if advertised by the server. Mutt's current implementation is basic,
|
||
used only for initial message fetching and flag updates.
|
||
</p><p>
|
||
Note: this feature is currently experimental. If you experience
|
||
strange behavior, such as duplicate or missing messages please
|
||
file a bug report to let us know.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-reconnect-sleep"></a>3.152. imap_reconnect_sleep</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 5</p></div><p>
|
||
When mutt fails to reconnect to a lost IMAP server connection, it
|
||
will sleep this many seconds before trying again.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-reconnect-tries"></a>3.153. imap_reconnect_tries</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 3</p></div><p>
|
||
When mutt loses its connection with the IMAP server, it will try
|
||
to reconnect this many times before giving up and closing the
|
||
connection.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-servernoise"></a>3.154. imap_servernoise</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will display warning messages from the IMAP
|
||
server as error messages. Since these messages are often
|
||
harmless, or generated due to configuration problems on the
|
||
server which are out of the users' hands, you may wish to suppress
|
||
them at some point.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="imap-user"></a>3.155. imap_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
The name of the user whose mail you intend to access on the IMAP
|
||
server.
|
||
</p><p>
|
||
This variable defaults to your user name on the local machine.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="implicit-autoview"></a>3.156. implicit_autoview</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If set to <span class="quote">“<span class="quote">yes</span>”</span>, mutt will look for a mailcap entry with the
|
||
<span class="quote">“<span class="quote"><code class="literal">copiousoutput</code></span>”</span> flag set for <span class="emphasis"><em>every</em></span> MIME attachment it doesn't have
|
||
an internal viewer defined for. If such an entry is found, mutt will
|
||
use the viewer defined in that entry to convert the body part to text
|
||
form.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="include"></a>3.157. include</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
Controls whether or not a copy of the message(s) you are replying to
|
||
is included in your reply.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="include-encrypted"></a>3.158. include_encrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether or not Mutt includes separately encrypted attachment
|
||
contents when replying.
|
||
</p><p>
|
||
This variable was added to prevent accidental exposure of encrypted
|
||
contents when replying to an attacker. If a previously encrypted message
|
||
were attached by the attacker, they could trick an unwary recipient into
|
||
decrypting and including the message in their reply.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="include-onlyfirst"></a>3.159. include_onlyfirst</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether or not Mutt includes only the first attachment
|
||
of the message you are replying.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="indent-string"></a>3.160. indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">> </code></span>”</span></p></div><p>
|
||
Specifies the string to prepend to each line of text quoted in a
|
||
message to which you are replying. You are strongly encouraged not to
|
||
change this value, as it tends to agitate the more fanatical netizens.
|
||
</p><p>
|
||
The value of this option is ignored if <a class="link" href="reference.html#text-flowed" title="3.393. text_flowed">$text_flowed</a> is set, because
|
||
the quoting mechanism is strictly defined for format=flowed.
|
||
</p><p>
|
||
This option is a format string, please see the description of
|
||
<a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a> for supported <code class="literal">printf(3)</code>-style sequences.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="index-format"></a>3.161. index_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s</code></span>”</span></p></div><p>
|
||
This variable allows you to customize the message index display to
|
||
your personal taste.
|
||
</p><p>
|
||
<span class="quote">“<span class="quote">Format strings</span>”</span> are similar to the strings used in the C
|
||
function <code class="literal">printf(3)</code> to format output (see the man page for more details).
|
||
For an explanation of the %? construct, see the <a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a> description.
|
||
The following sequences are defined in Mutt:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>address of the author
|
||
</td></tr><tr><td>%A </td><td>reply-to address (if present; otherwise: address of author)
|
||
</td></tr><tr><td>%b </td><td>filename of the original message folder (think mailbox)
|
||
</td></tr><tr><td>%B </td><td>the list to which the letter was sent, or else the folder name (%b).
|
||
</td></tr><tr><td>%c </td><td>number of characters (bytes) in the message (see <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>)
|
||
</td></tr><tr><td>%C </td><td>current message number
|
||
</td></tr><tr><td>%d </td><td>date and time of the message in the format specified by
|
||
<a class="link" href="reference.html#date-format" title="3.74. date_format">$date_format</a> converted to sender's time zone
|
||
</td></tr><tr><td>%D </td><td>date and time of the message in the format specified by
|
||
<a class="link" href="reference.html#date-format" title="3.74. date_format">$date_format</a> converted to the local time zone
|
||
</td></tr><tr><td>%e </td><td>current message number in thread
|
||
</td></tr><tr><td>%E </td><td>number of messages in current thread
|
||
</td></tr><tr><td>%f </td><td>sender (address + real name), either From: or Return-Path:
|
||
</td></tr><tr><td>%F </td><td>author name, or recipient name if the message is from you
|
||
</td></tr><tr><td>%H </td><td>spam attribute(s) of this message
|
||
</td></tr><tr><td>%i </td><td>message-id of the current message
|
||
</td></tr><tr><td>%l </td><td>number of lines in the unprocessed message (may not work with
|
||
maildir, mh, and IMAP folders)
|
||
</td></tr><tr><td>%L </td><td>If an address in the <span class="quote">“<span class="quote">To:</span>”</span> or <span class="quote">“<span class="quote">Cc:</span>”</span> header field matches an address
|
||
defined by the users <span class="quote">“<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>”</span> command, this displays
|
||
"To <list-name>", otherwise the same as %F.
|
||
</td></tr><tr><td>%m </td><td>total number of message in the mailbox
|
||
</td></tr><tr><td>%M </td><td>number of hidden messages if the thread is collapsed.
|
||
</td></tr><tr><td>%N </td><td>message score
|
||
</td></tr><tr><td>%n </td><td>author's real name (or address if missing)
|
||
</td></tr><tr><td>%O </td><td>original save folder where mutt would formerly have
|
||
stashed the message: list name or recipient name
|
||
if not sent to a list
|
||
</td></tr><tr><td>%P </td><td>progress indicator for the built-in pager (how much of the file has been displayed)
|
||
</td></tr><tr><td>%r </td><td>comma separated list of <span class="quote">“<span class="quote">To:</span>”</span> recipients
|
||
</td></tr><tr><td>%R </td><td>comma separated list of <span class="quote">“<span class="quote">Cc:</span>”</span> recipients
|
||
</td></tr><tr><td>%s </td><td>subject of the message
|
||
</td></tr><tr><td>%S </td><td>single character status of the message (<span class="quote">“<span class="quote">N</span>”</span>/<span class="quote">“<span class="quote">O</span>”</span>/<span class="quote">“<span class="quote">D</span>”</span>/<span class="quote">“<span class="quote">d</span>”</span>/<span class="quote">“<span class="quote">!</span>”</span>/<span class="quote">“<span class="quote">r</span>”</span>/<span class="quote">“<span class="quote">*</span>”</span>)
|
||
</td></tr><tr><td>%t </td><td><span class="quote">“<span class="quote">To:</span>”</span> field (recipients)
|
||
</td></tr><tr><td>%T </td><td>the appropriate character from the <a class="link" href="reference.html#to-chars" title="3.400. to_chars">$to_chars</a> string
|
||
</td></tr><tr><td>%u </td><td>user (login) name of the author
|
||
</td></tr><tr><td>%v </td><td>first name of the author, or the recipient if the message is from you
|
||
</td></tr><tr><td>%X </td><td>number of attachments
|
||
(please see the <span class="quote">“<span class="quote"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">attachments</a></span>”</span> section for possible speed effects)
|
||
</td></tr><tr><td>%y </td><td><span class="quote">“<span class="quote">X-Label:</span>”</span> field, if present
|
||
</td></tr><tr><td>%Y </td><td><span class="quote">“<span class="quote">X-Label:</span>”</span> field, if present, and <span class="emphasis"><em>(1)</em></span> not at part of a thread tree,
|
||
<span class="emphasis"><em>(2)</em></span> at the top of a thread, or <span class="emphasis"><em>(3)</em></span> <span class="quote">“<span class="quote">X-Label:</span>”</span> is different from
|
||
preceding message's <span class="quote">“<span class="quote">X-Label:</span>”</span>.
|
||
</td></tr><tr><td>%Z </td><td>a three character set of message status flags.
|
||
the first character is new/read/replied flags (<span class="quote">“<span class="quote">n</span>”</span>/<span class="quote">“<span class="quote">o</span>”</span>/<span class="quote">“<span class="quote">r</span>”</span>/<span class="quote">“<span class="quote">O</span>”</span>/<span class="quote">“<span class="quote">N</span>”</span>).
|
||
the second is deleted or encryption flags (<span class="quote">“<span class="quote">D</span>”</span>/<span class="quote">“<span class="quote">d</span>”</span>/<span class="quote">“<span class="quote">S</span>”</span>/<span class="quote">“<span class="quote">P</span>”</span>/<span class="quote">“<span class="quote">s</span>”</span>/<span class="quote">“<span class="quote">K</span>”</span>).
|
||
the third is either tagged/flagged (<span class="quote">“<span class="quote">*</span>”</span>/<span class="quote">“<span class="quote">!</span>”</span>), or one of the characters
|
||
listed in <a class="link" href="reference.html#to-chars" title="3.400. to_chars">$to_chars</a>.
|
||
</td></tr><tr><td>%@name@ </td><td>insert and evaluate format-string from the matching
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#index-format-hook" title="24. Dynamically Changing $index_format using Patterns">index-format-hook</a></span>”</span> command
|
||
</td></tr><tr><td>%{fmt} </td><td>the date and time of the message is converted to sender's
|
||
time zone, and <span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library function
|
||
<code class="literal">strftime(3)</code>; a leading bang disables locales
|
||
</td></tr><tr><td>%[fmt] </td><td>the date and time of the message is converted to the local
|
||
time zone, and <span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library function
|
||
<code class="literal">strftime(3)</code>; a leading bang disables locales
|
||
</td></tr><tr><td>%(fmt) </td><td>the local date and time when the message was received.
|
||
<span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library function <code class="literal">strftime(3)</code>;
|
||
a leading bang disables locales
|
||
</td></tr><tr><td>%<fmt> </td><td>the current local time. <span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library
|
||
function <code class="literal">strftime(3)</code>; a leading bang disables locales.
|
||
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with character <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%|X </td><td>pad to the end of the line with character <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
|
||
</td></tr></tbody></table></div><p>
|
||
Note that for mbox/mmdf, <span class="quote">“<span class="quote">%l</span>”</span> applies to the unprocessed message, and
|
||
for maildir/mh, the value comes from the <span class="quote">“<span class="quote">Lines:</span>”</span> header field when
|
||
present (the meaning is normally the same). Thus the value depends on
|
||
the encodings used in the different parts of the message and has little
|
||
meaning in practice.
|
||
</p><p>
|
||
<span class="quote">“<span class="quote">Soft-fill</span>”</span> deserves some explanation: Normal right-justification
|
||
will print everything to the left of the <span class="quote">“<span class="quote">%></span>”</span>, displaying padding and
|
||
whatever lies to the right only if there's room. By contrast,
|
||
soft-fill gives priority to the right-hand side, guaranteeing space
|
||
to display it and showing padding only if there's still room. If
|
||
necessary, soft-fill will eat text leftwards to make room for
|
||
rightward text.
|
||
</p><p>
|
||
Note that these expandos are supported in
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#save-hook" title="18. Specify Default Save Mailbox">save-hook</a></span>”</span>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="19. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-save-hook" title="20. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></span>”</span>, and
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#index-format-hook" title="24. Dynamically Changing $index_format using Patterns">index-format-hook</a></span>”</span>.
|
||
</p><p>
|
||
They are also supported in the configuration variables <a class="link" href="reference.html#attribution" title="3.20. attribution">$attribution</a>,
|
||
<a class="link" href="reference.html#forward-attribution-intro" title="3.102. forward_attribution_intro">$forward_attribution_intro</a>, <a class="link" href="reference.html#forward-attribution-trailer" title="3.103. forward_attribution_trailer">$forward_attribution_trailer</a>,
|
||
<a class="link" href="reference.html#forward-format" title="3.107. forward_format">$forward_format</a>, <a class="link" href="reference.html#indent-string" title="3.160. indent_string">$indent_string</a>, <a class="link" href="reference.html#message-format" title="3.185. message_format">$message_format</a>, <a class="link" href="reference.html#pager-format" title="3.207. pager_format">$pager_format</a>,
|
||
and <a class="link" href="reference.html#post-indent-string" title="3.259. post_indent_string">$post_indent_string</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ispell"></a>3.162. ispell</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">ispell</code></span>”</span></p></div><p>
|
||
How to invoke ispell (GNU's spell-checking software).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="keep-flagged"></a>3.163. keep_flagged</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, read messages marked as flagged will not be moved
|
||
from your spool mailbox to your <a class="link" href="reference.html#mbox" title="3.178. mbox">$mbox</a> mailbox, or as a result of
|
||
a <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mbox-hook" title="15. Using Multiple Spool Mailboxes">mbox-hook</a></span>”</span> command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="local-date-header"></a>3.164. local_date_header</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, the date in the Date header of emails that you send will be in
|
||
your local timezone. If unset a UTC date will be used instead to avoid
|
||
leaking information about your current location.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check"></a>3.165. mail_check</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 5</p></div><p>
|
||
This variable configures how often (in seconds) mutt should look for
|
||
new mail. Also see the <a class="link" href="reference.html#timeout" title="3.398. timeout">$timeout</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check-recent"></a>3.166. mail_check_recent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will only notify you about new mail that has been received
|
||
since the last time you opened the mailbox. When <span class="emphasis"><em>unset</em></span>, Mutt will notify you
|
||
if any new mail exists in the mailbox, regardless of whether you have visited it
|
||
recently.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check-stats"></a>3.167. mail_check_stats</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will periodically calculate message
|
||
statistics of a mailbox while polling for new mail. It will
|
||
check for unread, flagged, and total message counts.
|
||
(Note: IMAP mailboxes only support unread and total counts).
|
||
</p><p>
|
||
Because this operation is more performance intensive, it defaults
|
||
to <span class="emphasis"><em>unset</em></span>, and has a separate option,
|
||
<a class="link" href="reference.html#mail-check-stats-interval" title="3.168. mail_check_stats_interval">$mail_check_stats_interval</a>, to control how often to update these
|
||
counts.
|
||
</p><p>
|
||
Message statistics can also be explicitly calculated by invoking the
|
||
<code class="literal"><check-stats></code>
|
||
function.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check-stats-interval"></a>3.168. mail_check_stats_interval</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 60</p></div><p>
|
||
When <a class="link" href="reference.html#mail-check-stats" title="3.167. mail_check_stats">$mail_check_stats</a> is <span class="emphasis"><em>set</em></span>, this variable configures
|
||
how often (in seconds) mutt will update message counts.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-path"></a>3.169. mailcap_path</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable specifies which files to consult when attempting to
|
||
display MIME bodies not directly supported by Mutt. The default value
|
||
is generated during startup: see the <span class="quote">“<span class="quote"><a class="link" href="mimesupport.html#mailcap" title="3. MIME Viewer Configuration with Mailcap">mailcap</a></span>”</span> section of the manual.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-sanitize"></a>3.170. mailcap_sanitize</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will restrict possible characters in mailcap % expandos
|
||
to a well-defined set of safe characters. This is the safe setting,
|
||
but we are not sure it doesn't break some more advanced MIME stuff.
|
||
</p><p>
|
||
<span class="bold"><strong>DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
|
||
DOING!</strong></span>
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.171. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Check for Maildir unaware programs other than mutt having modified maildir
|
||
files when the header cache is in use. This incurs one <code class="literal">stat(2)</code> per
|
||
message every time the folder is opened (which can be very slow for NFS
|
||
folders).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.172. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, messages marked as deleted will be saved with the maildir
|
||
trashed flag instead of unlinked. <span class="bold"><strong>Note:</strong></span> this only applies
|
||
to maildir-style mailboxes. Setting it will have no effect on other
|
||
mailbox types.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-check-cur"></a>3.173. maildir_check_cur</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will poll both the new and cur directories of
|
||
a maildir folder for new messages. This might be useful if other
|
||
programs interacting with the folder (e.g. dovecot) are moving new
|
||
messages to the cur directory. Note that setting this option may
|
||
slow down polling for new messages in large folders, since mutt has
|
||
to scan all cur messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mark-macro-prefix"></a>3.174. mark_macro_prefix</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">'</code></span>”</span></p></div><p>
|
||
Prefix for macros created using mark-message. A new macro
|
||
automatically generated with <span class="emphasis"><em><mark-message>a</em></span> will be composed
|
||
from this prefix and the letter <span class="emphasis"><em>a</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.175. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls whether or not mutt marks <span class="emphasis"><em>new</em></span> <span class="bold"><strong>unread</strong></span>
|
||
messages as <span class="emphasis"><em>old</em></span> if you exit a mailbox without reading them.
|
||
With this option <span class="emphasis"><em>set</em></span>, the next time you start mutt, the messages
|
||
will show up with an <span class="quote">“<span class="quote">O</span>”</span> next to them in the index menu,
|
||
indicating that they are old.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.176. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls the display of wrapped lines in the internal pager. If set, a
|
||
<span class="quote">“<span class="quote">+</span>”</span> marker is displayed at the beginning of wrapped lines.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#smart-wrap" title="3.330. smart_wrap">$smart_wrap</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.177. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">!^\\.[^.]</code></span>”</span></p></div><p>
|
||
A regular expression used in the file browser, optionally preceded by
|
||
the <span class="emphasis"><em>not</em></span> operator <span class="quote">“<span class="quote">!</span>”</span>. Only files whose names match this mask
|
||
will be shown. The match is always case-sensitive.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.178. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/mbox</code></span>”</span></p></div><p>
|
||
This specifies the folder into which read mail in your <a class="link" href="reference.html#spoolfile" title="3.370. spoolfile">$spoolfile</a>
|
||
folder will be appended.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#move" title="3.200. move">$move</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.179. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />
|
||
Default: mbox</p></div><p>
|
||
The default mailbox type used when creating new folders. May be any of
|
||
<span class="quote">“<span class="quote">mbox</span>”</span>, <span class="quote">“<span class="quote">MMDF</span>”</span>, <span class="quote">“<span class="quote">MH</span>”</span> and <span class="quote">“<span class="quote">Maildir</span>”</span>. This is overridden by the
|
||
<code class="literal">-m</code> command-line option.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.180. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
This variable controls the number of lines of context that are given
|
||
when scrolling through menus. (Similar to <a class="link" href="reference.html#pager-context" title="3.206. pager_context">$pager_context</a>.)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.181. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>unset</em></span>, the bottom entry of menus will never scroll up past
|
||
the bottom of the screen, unless there are less entries than lines.
|
||
When <span class="emphasis"><em>set</em></span>, the bottom entry may move off the bottom.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.182. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, menus will be scrolled up or down one line when you
|
||
attempt to move across a screen boundary. If <span class="emphasis"><em>unset</em></span>, the screen
|
||
is cleared and the next or previous page of the menu is displayed
|
||
(useful for slow links to avoid many redraws).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.183. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will clean out obsolete entries from the message cache when
|
||
the mailbox is synchronized. You probably only want to set it
|
||
every once in a while, since it can be a little slow
|
||
(especially for large folders).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.184. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
Set this to a directory and mutt will cache copies of messages from
|
||
your IMAP and POP servers here. You are free to remove entries at any
|
||
time.
|
||
</p><p>
|
||
When setting this variable to a directory, mutt needs to fetch every
|
||
remote message only once and can perform regular expression searches
|
||
as fast as for local folders.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#message-cache-clean" title="3.183. message_cache_clean">$message_cache_clean</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.185. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%s</code></span>”</span></p></div><p>
|
||
This is the string displayed in the <span class="quote">“<span class="quote">attachment</span>”</span> menu for
|
||
attachments of type <code class="literal">message/rfc822</code>. For a full listing of defined
|
||
<code class="literal">printf(3)</code>-like sequences see the section on <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="message-id-format"></a>3.186. message_id_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal"><%z@%f></code></span>”</span></p></div><p>
|
||
This variable describes the format of the Message-ID generated
|
||
when sending messages. Mutt 2.0 introduced a more compact
|
||
format, but this variable allows the ability to choose your own
|
||
format. The value may end in <span class="quote">“<span class="quote">|</span>”</span> to invoke an external filter.
|
||
See <a class="link" href="configuration.html#formatstrings-filters" title="32.3. Filters">formatstrings-filters</a>.
|
||
</p><p>
|
||
Please note that the Message-ID value follows a strict syntax,
|
||
and you are responsible for ensuring correctness if you change
|
||
this from the default. In particular, the value must follow the
|
||
syntax in RFC 5322: <span class="quote">“<span class="quote"><code class="literal">"<" id-left "@" id-right ">"</code></span>”</span>. No
|
||
spaces are allowed, and <code class="literal">id-left</code> should follow the
|
||
dot-atom-text syntax in the RFC. The <code class="literal">id-right</code> should
|
||
generally be left at %f.
|
||
</p><p>
|
||
The old Message-ID format can be used by setting this to:
|
||
<span class="quote">“<span class="quote"><code class="literal"><%Y%02m%02d%02H%02M%02S.G%c%p@%f></code></span>”</span>
|
||
</p><p>
|
||
The following <code class="literal">printf(3)</code>-style sequences are understood:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%c </td><td>step counter looping from <span class="quote">“<span class="quote">A</span>”</span> to <span class="quote">“<span class="quote">Z</span>”</span>
|
||
</td></tr><tr><td>%d </td><td>current day of the month (GMT)
|
||
</td></tr><tr><td>%f </td><td><a class="link" href="reference.html#hostname" title="3.129. hostname">$hostname</a>
|
||
</td></tr><tr><td>%H </td><td>current hour using a 24-hour clock (GMT)
|
||
</td></tr><tr><td>%m </td><td>current month number (GMT)
|
||
</td></tr><tr><td>%M </td><td>current minute of the hour (GMT)
|
||
</td></tr><tr><td>%p </td><td>pid of the running mutt process
|
||
</td></tr><tr><td>%r </td><td>3 bytes of pseudorandom data encoded in Base64
|
||
</td></tr><tr><td>%S </td><td>current second of the minute (GMT)
|
||
</td></tr><tr><td>%x </td><td>1 byte of pseudorandom data hex encoded (example: '1b')
|
||
</td></tr><tr><td>%Y </td><td>current year using 4 digits (GMT)
|
||
</td></tr><tr><td>%z </td><td>4 byte timestamp + 8 bytes of pseudorandom data encoded in Base64
|
||
</td></tr></tbody></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.187. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, forces Mutt to interpret keystrokes with the high bit (bit 8)
|
||
set as if the user had pressed the Esc key and whatever key remains
|
||
after having the high bit removed. For example, if the key pressed
|
||
has an ASCII value of <code class="literal">0xf8</code>, then this is treated as if the user had
|
||
pressed Esc then <span class="quote">“<span class="quote">x</span>”</span>. This is because the result of removing the
|
||
high bit from <code class="literal">0xf8</code> is <code class="literal">0x78</code>, which is the ASCII character
|
||
<span class="quote">“<span class="quote">x</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="metoo"></a>3.188. metoo</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>unset</em></span>, Mutt will remove your address (see the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></span>”</span>
|
||
command) from the list of recipients when replying to a message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mh-purge"></a>3.189. mh_purge</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>unset</em></span>, mutt will mimic mh's behavior and rename deleted messages
|
||
to <span class="emphasis"><em>,<old file name></em></span> in mh folders instead of really deleting
|
||
them. This leaves the message on disk but makes programs reading the folder
|
||
ignore it. If the variable is <span class="emphasis"><em>set</em></span>, the message files will simply be
|
||
deleted.
|
||
</p><p>
|
||
This option is similar to <a class="link" href="reference.html#maildir-trash" title="3.172. maildir_trash">$maildir_trash</a> for Maildir folders.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-flagged"></a>3.190. mh_seq_flagged</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">flagged</code></span>”</span></p></div><p>
|
||
The name of the MH sequence used for flagged messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-replied"></a>3.191. mh_seq_replied</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">replied</code></span>”</span></p></div><p>
|
||
The name of the MH sequence used to tag replied messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-unseen"></a>3.192. mh_seq_unseen</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">unseen</code></span>”</span></p></div><p>
|
||
The name of the MH sequence used for unseen messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward"></a>3.193. mime_forward</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, the message you are forwarding will be attached as a
|
||
separate <code class="literal">message/rfc822</code> MIME part instead of included in the main body of the
|
||
message. This is useful for forwarding MIME messages so the receiver
|
||
can properly view the message as it was delivered to you. If you like
|
||
to switch between MIME and not MIME from mail to mail, set this
|
||
variable to <span class="quote">“<span class="quote">ask-no</span>”</span> or <span class="quote">“<span class="quote">ask-yes</span>”</span>.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#forward-decode" title="3.104. forward_decode">$forward_decode</a> and <a class="link" href="reference.html#mime-forward-decode" title="3.194. mime_forward_decode">$mime_forward_decode</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.194. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls the decoding of complex MIME messages into <code class="literal">text/plain</code> when
|
||
forwarding a message while <a class="link" href="reference.html#mime-forward" title="3.193. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span>. Otherwise
|
||
<a class="link" href="reference.html#forward-decode" title="3.104. forward_decode">$forward_decode</a> is used instead.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.195. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
When forwarding multiple attachments of a MIME message from the attachment
|
||
menu, attachments which cannot be decoded in a reasonable manner will
|
||
be attached to the newly composed message if this option is <span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mime-type-query-command"></a>3.196. mime_type_query_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This specifies a command to run, to determine the mime type of a
|
||
new attachment when composing a message. Unless
|
||
<a class="link" href="reference.html#mime-type-query-first" title="3.197. mime_type_query_first">$mime_type_query_first</a> is set, this will only be run if the
|
||
attachment's extension is not found in the mime.types file.
|
||
</p><p>
|
||
The string may contain a <span class="quote">“<span class="quote">%s</span>”</span>, which will be substituted with the
|
||
attachment filename. Mutt will add quotes around the string substituted
|
||
for <span class="quote">“<span class="quote">%s</span>”</span> automatically according to shell quoting rules, so you should
|
||
avoid adding your own. If no <span class="quote">“<span class="quote">%s</span>”</span> is found in the string, Mutt will
|
||
append the attachment filename to the end of the string.
|
||
</p><p>
|
||
The command should output a single line containing the
|
||
attachment's mime type.
|
||
</p><p>
|
||
Suggested values are <span class="quote">“<span class="quote">xdg-mime query filetype</span>”</span> or
|
||
<span class="quote">“<span class="quote">file -bi</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mime-type-query-first"></a>3.197. mime_type_query_first</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, the <a class="link" href="reference.html#mime-type-query-command" title="3.196. mime_type_query_command">$mime_type_query_command</a> will be run before the
|
||
mime.types lookup.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.198. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%4n %c %-16s %a</code></span>”</span></p></div><p>
|
||
This variable describes the format of a remailer line on the mixmaster
|
||
chain selection screen. The following <code class="literal">printf(3)</code>-like sequences are
|
||
supported:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>The running number on the menu.
|
||
</td></tr><tr><td>%c </td><td>Remailer capabilities.
|
||
</td></tr><tr><td>%s </td><td>The remailer's short name.
|
||
</td></tr><tr><td>%a </td><td>The remailer's e-mail address.
|
||
</td></tr></tbody></table></div><p>
|
||
(Mixmaster only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.199. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">mixmaster</code></span>”</span></p></div><p>
|
||
This variable contains the path to the Mixmaster binary on your
|
||
system. It is used with various sets of parameters to gather the
|
||
list of known remailers, and to finally send a message through the
|
||
mixmaster chain. (Mixmaster only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.200. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: no</p></div><p>
|
||
Controls whether or not Mutt will move read messages
|
||
from your spool mailbox to your <a class="link" href="reference.html#mbox" title="3.178. mbox">$mbox</a> mailbox, or as a result of
|
||
a <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mbox-hook" title="15. Using Multiple Spool Mailboxes">mbox-hook</a></span>”</span> command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="muttlisp-inline-eval"></a>3.201. muttlisp_inline_eval</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will evaluate bare parenthesis arguments to commands
|
||
as MuttLisp expressions.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.202. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This variable, when <span class="emphasis"><em>set</em></span>, makes the thread tree narrower, allowing
|
||
deeper threads to fit on the screen.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.203. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 10</p></div><p>
|
||
Operations that expect to transfer a large amount of data over the
|
||
network will update their progress every <a class="link" href="reference.html#net-inc" title="3.203. net_inc">$net_inc</a> kilobytes.
|
||
If set to 0, no progress messages will be displayed.
|
||
</p><p>
|
||
See also <a class="link" href="reference.html#read-inc" title="3.275. read_inc">$read_inc</a>, <a class="link" href="reference.html#write-inc" title="3.423. write_inc">$write_inc</a> and <a class="link" href="reference.html#net-inc" title="3.203. net_inc">$net_inc</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="new-mail-command"></a>3.204. new_mail_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will call this command after a new message is received.
|
||
See the <a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a> documentation for the values that can be formatted
|
||
into this command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.205. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">builtin</code></span>”</span></p></div><p>
|
||
This variable specifies which pager you would like to use to view
|
||
messages. The value <span class="quote">“<span class="quote">builtin</span>”</span> means to use the built-in pager, otherwise this
|
||
variable should specify the pathname of the external pager you would
|
||
like to use.
|
||
</p><p>
|
||
The string may contain a <span class="quote">“<span class="quote">%s</span>”</span>, which will be substituted with
|
||
the generated message filename. Mutt will add quotes around the
|
||
string substituted for <span class="quote">“<span class="quote">%s</span>”</span> automatically according to shell
|
||
quoting rules, so you should avoid adding your own. If no <span class="quote">“<span class="quote">%s</span>”</span>
|
||
is found in the string, Mutt will append the message filename to
|
||
the end of the string.
|
||
</p><p>
|
||
Using an external pager may have some disadvantages: Additional
|
||
keystrokes are necessary because you can't call mutt functions
|
||
directly from the pager, and screen resizes cause lines longer than
|
||
the screen width to be badly formatted in the help menu.
|
||
</p><p>
|
||
When using an external pager, also see <a class="link" href="reference.html#prompt-after" title="3.270. prompt_after">$prompt_after</a> which defaults
|
||
<span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pager-context"></a>3.206. pager_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
This variable controls the number of lines of context that are given
|
||
when displaying the next or previous page in the internal pager. By
|
||
default, Mutt will display the line after the last one on the screen
|
||
at the top of the next page (0 lines of context).
|
||
</p><p>
|
||
This variable also specifies the amount of context given for search
|
||
results. If positive, this many lines will be given before a match,
|
||
if 0, the match will be top-aligned.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pager-format"></a>3.207. pager_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">-%Z- %C/%m: %-20.20n %s%* -- (%P)</code></span>”</span></p></div><p>
|
||
This variable controls the format of the one-line message <span class="quote">“<span class="quote">status</span>”</span>
|
||
displayed before each message in either the internal or an external
|
||
pager. The valid sequences are listed in the <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>
|
||
section.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pager-index-lines"></a>3.208. pager_index_lines</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
Determines the number of lines of a mini-index which is shown when in
|
||
the pager. The current message, unless near the top or bottom of the
|
||
folder, will be roughly one third of the way down this mini-index,
|
||
giving the reader the context of a few messages before and after the
|
||
message. This is useful, for example, to determine how many messages
|
||
remain to be read in the current thread. One of the lines is reserved
|
||
for the status bar from the index, so a setting of 6
|
||
will only show 5 lines of the actual index. A value of 0 results in
|
||
no index being shown. If the number of messages in the current folder
|
||
is less than <a class="link" href="reference.html#pager-index-lines" title="3.208. pager_index_lines">$pager_index_lines</a>, then the index will only use as
|
||
many lines as it needs.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pager-skip-quoted-context"></a>3.209. pager_skip_quoted_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
Determines the number of lines of context to show before the
|
||
unquoted text when using <code class="literal"><a class="link" href="gettingstarted.html#skip-quoted"><skip-quoted></a></code>. When set to a
|
||
positive number at most that many lines of the previous quote are
|
||
displayed. If the previous quote is shorter the whole quote is
|
||
displayed.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.210. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, the internal-pager will <span class="bold"><strong>not</strong></span> move to the next message
|
||
when you are at the end of a message and invoke the <code class="literal"><next-page></code>
|
||
function.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pattern-format"></a>3.211. pattern_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%2n %-15e %d</code></span>”</span></p></div><p>
|
||
This variable describes the format of the <span class="quote">“<span class="quote">pattern completion</span>”</span> menu. The
|
||
following <code class="literal">printf(3)</code>-style sequences are understood:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%d </td><td>pattern description
|
||
</td></tr><tr><td>%e </td><td>pattern expression
|
||
</td></tr><tr><td>%n </td><td>index number
|
||
</td></tr></tbody></table></div><p>
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.212. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will automatically attempt to decrypt traditional PGP
|
||
messages whenever the user performs an operation which ordinarily would
|
||
result in the contents of the message being operated on. For example,
|
||
if the user displays a pgp-traditional message which has not been manually
|
||
checked with the <code class="literal"><a class="link" href="gettingstarted.html#check-traditional-pgp"><check-traditional-pgp></a></code> function, mutt will automatically
|
||
check the message for traditional pgp.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.213. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This option controls whether Mutt generates old-style inline
|
||
(traditional) PGP encrypted or signed messages under certain
|
||
circumstances. This can be overridden by use of the pgp menu,
|
||
when inline is not required. The GPGME backend does not support
|
||
this option.
|
||
</p><p>
|
||
Note that Mutt might automatically use PGP/MIME for messages
|
||
which consist of more than a single MIME part. Mutt can be
|
||
configured to ask before sending PGP/MIME messages when inline
|
||
(traditional) would not work.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.232. pgp_mime_auto">$pgp_mime_auto</a> variable.
|
||
</p><p>
|
||
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
|
||
<span class="bold"><strong>deprecated</strong></span>.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.214. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will check the exit code of the PGP subprocess when
|
||
signing or encrypting. A non-zero exit code means that the
|
||
subprocess failed.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-gpg-decrypt-status-fd"></a>3.215. pgp_check_gpg_decrypt_status_fd</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will check the status file descriptor output
|
||
of <a class="link" href="reference.html#pgp-decrypt-command" title="3.218. pgp_decrypt_command">$pgp_decrypt_command</a> and <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> for GnuPG status codes
|
||
indicating successful decryption. This will check for the presence of
|
||
DECRYPTION_OKAY, absence of DECRYPTION_FAILED, and that all
|
||
PLAINTEXT occurs between the BEGIN_DECRYPTION and END_DECRYPTION
|
||
status codes.
|
||
</p><p>
|
||
If <span class="emphasis"><em>unset</em></span>, mutt will instead match the status fd output
|
||
against <a class="link" href="reference.html#pgp-decryption-okay" title="3.219. pgp_decryption_okay">$pgp_decryption_okay</a>.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.216. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This format is used to create an old-style <span class="quote">“<span class="quote">clearsigned</span>”</span> PGP
|
||
message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>
|
||
<span class="bold"><strong>deprecated</strong></span>.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.217. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This format strings specifies a command which is used to decode
|
||
application/pgp attachments.
|
||
</p><p>
|
||
The PGP command formats have their own set of <code class="literal">printf(3)</code>-like sequences:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" 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
|
||
string otherwise. Note: This may be used with a %? construct.
|
||
</td></tr><tr><td>%f </td><td>Expands to the name of a file containing a message.
|
||
</td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
|
||
of a <code class="literal">multipart/signed</code> attachment when verifying it.
|
||
</td></tr><tr><td>%a </td><td>The value of <a class="link" href="reference.html#pgp-sign-as" title="3.237. pgp_sign_as">$pgp_sign_as</a> if set, otherwise the value
|
||
of <a class="link" href="reference.html#pgp-default-key" title="3.220. pgp_default_key">$pgp_default_key</a>.
|
||
</td></tr><tr><td>%r </td><td>One or more key IDs (or fingerprints if available).
|
||
</td></tr></tbody></table></div><p>
|
||
For examples on how to configure these formats for the various versions
|
||
of PGP which are floating around, see the pgp and gpg sample configuration files in
|
||
the <code class="literal">samples/</code> subdirectory which has been installed on your system
|
||
alongside the documentation.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.218. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to decrypt a PGP encrypted message.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decryption-okay"></a>3.219. pgp_decryption_okay</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: (empty)</p></div><p>
|
||
If you assign text to this variable, then an encrypted PGP
|
||
message is only considered successfully decrypted if the output
|
||
from <a class="link" href="reference.html#pgp-decrypt-command" title="3.218. pgp_decrypt_command">$pgp_decrypt_command</a> contains the text. This is used to
|
||
protect against a spoofed encrypted message, with multipart/encrypted
|
||
headers but containing a block that is not actually encrypted.
|
||
(e.g. simply signed and ascii armored text).
|
||
</p><p>
|
||
Note that if <a class="link" href="reference.html#pgp-check-gpg-decrypt-status-fd" title="3.215. pgp_check_gpg_decrypt_status_fd">$pgp_check_gpg_decrypt_status_fd</a> is set, this variable
|
||
is ignored.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-default-key"></a>3.220. pgp_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This is the default key-pair to use for PGP operations. It will be
|
||
used for encryption (see <a class="link" href="reference.html#postpone-encrypt" title="3.262. postpone_encrypt">$postpone_encrypt</a> and <a class="link" href="reference.html#pgp-self-encrypt" title="3.235. pgp_self_encrypt">$pgp_self_encrypt</a>).
|
||
</p><p>
|
||
It will also be used for signing unless <a class="link" href="reference.html#pgp-sign-as" title="3.237. pgp_sign_as">$pgp_sign_as</a> is set.
|
||
</p><p>
|
||
The (now deprecated) <span class="emphasis"><em>pgp_self_encrypt_as</em></span> is an alias for this
|
||
variable, and should no longer be used.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.221. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to encrypt a body part without signing it.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.222. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to both sign and encrypt a body part.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.223. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%4n %t%f %4l/0x%k %-4a %2c %u</code></span>”</span></p></div><p>
|
||
This variable allows you to customize the PGP key selection menu to
|
||
your personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>, but
|
||
has its own set of <code class="literal">printf(3)</code>-like sequences:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>number
|
||
</td></tr><tr><td>%k </td><td>key id
|
||
</td></tr><tr><td>%u </td><td>user id
|
||
</td></tr><tr><td>%a </td><td>algorithm
|
||
</td></tr><tr><td>%l </td><td>key length
|
||
</td></tr><tr><td>%f </td><td>flags
|
||
</td></tr><tr><td>%c </td><td>capabilities
|
||
</td></tr><tr><td>%t </td><td>trust/validity of the key-uid association
|
||
</td></tr><tr><td>%[<s>] </td><td>date of the key where <s> is an <code class="literal">strftime(3)</code> expression
|
||
</td></tr></tbody></table></div><p>
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.224. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to export a public key from the user's
|
||
key ring.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.225. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is invoked whenever Mutt needs to fetch the public key associated with
|
||
an email address. Of the sequences supported by <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a>, %r is
|
||
the only <code class="literal">printf(3)</code>-like sequence used with this format. Note that
|
||
in this case, %r expands to the email address, not the public key ID (the key ID is
|
||
unknown, which is why Mutt is invoking this command).
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.226. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: (empty)</p></div><p>
|
||
If you assign a text to this variable, then a PGP signature is only
|
||
considered verified if the output from <a class="link" href="reference.html#pgp-verify-command" title="3.243. pgp_verify_command">$pgp_verify_command</a> contains
|
||
the text. Use this variable if the exit code from the command is 0
|
||
even for bad signatures.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.227. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
|
||
the principal key will inherit the subkeys' capabilities. <span class="emphasis"><em>Unset</em></span> this
|
||
if you want to play interesting key selection games.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.228. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to import a key from a message into
|
||
the user's public key ring.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.229. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to list the public key ring's contents. The
|
||
output format must be analogous to the one used by
|
||
|
||
</p><pre class="screen">
|
||
gpg --list-keys --with-colons --with-fingerprint
|
||
</pre><p>
|
||
This format is also generated by the <code class="literal">mutt_pgpring</code> utility which comes
|
||
with mutt.
|
||
</p><p>
|
||
Note: gpg's <code class="literal">fixed-list-mode</code> option should not be used. It
|
||
produces a different date format which may result in mutt showing
|
||
incorrect key generation dates.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
Note that in this case, %r expands to the search string, which is a list of
|
||
one or more quoted values such as email address, name, or keyid.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.230. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to list the secret key ring's contents. The
|
||
output format must be analogous to the one used by:
|
||
|
||
</p><pre class="screen">
|
||
gpg --list-keys --with-colons --with-fingerprint
|
||
</pre><p>
|
||
This format is also generated by the <code class="literal">mutt_pgpring</code> utility which comes
|
||
with mutt.
|
||
</p><p>
|
||
Note: gpg's <code class="literal">fixed-list-mode</code> option should not be used. It
|
||
produces a different date format which may result in mutt showing
|
||
incorrect key generation dates.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
Note that in this case, %r expands to the search string, which is a list of
|
||
one or more quoted values such as email address, name, or keyid.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.231. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
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.
|
||
NOTE: Internally, Mutt has transitioned to using fingerprints (or long key IDs
|
||
as a fallback). This option now only controls the display of key IDs
|
||
in the key selection menu and a few other places.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.232. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
This option controls whether Mutt will prompt you for
|
||
automatically sending a (signed/encrypted) message using
|
||
PGP/MIME when inline (traditional) fails (for any reason).
|
||
</p><p>
|
||
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
|
||
<span class="bold"><strong>deprecated</strong></span>.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.233. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Setting this variable will cause Mutt to always attempt to
|
||
create an inline (traditional) message when replying to a
|
||
message which is PGP encrypted/signed inline. This can be
|
||
overridden by use of the pgp menu, when inline is not
|
||
required. This option does not automatically detect if the
|
||
(replied-to) message is inline; instead it relies on Mutt
|
||
internals for previously checked/flagged messages.
|
||
</p><p>
|
||
Note that Mutt might automatically use PGP/MIME for messages
|
||
which consist of more than a single MIME part. Mutt can be
|
||
configured to ask before sending PGP/MIME messages when inline
|
||
(traditional) would not work.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.232. pgp_mime_auto">$pgp_mime_auto</a> variable.
|
||
</p><p>
|
||
Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
|
||
<span class="bold"><strong>deprecated</strong></span>.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.234. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, signed and encrypted messages will consist of nested
|
||
<code class="literal">multipart/signed</code> and <code class="literal">multipart/encrypted</code> body parts.
|
||
</p><p>
|
||
This is useful for applications like encrypted and signed mailing
|
||
lists, where the outer layer (<code class="literal">multipart/encrypted</code>) can be easily
|
||
removed, while the inner <code class="literal">multipart/signed</code> part is retained.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-self-encrypt"></a>3.235. pgp_self_encrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, PGP encrypted messages will also be encrypted
|
||
using the key in <a class="link" href="reference.html#pgp-default-key" title="3.220. pgp_default_key">$pgp_default_key</a>.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.236. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will display non-usable keys on the PGP key selection
|
||
menu. This includes keys which have been revoked, have expired, or
|
||
have been marked as <span class="quote">“<span class="quote">disabled</span>”</span> by the user.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.237. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
If you have a different key pair to use for signing, you should
|
||
set this to the signing key. Most people will only need to set
|
||
<a class="link" href="reference.html#pgp-default-key" title="3.220. pgp_default_key">$pgp_default_key</a>. It is recommended that you use the keyid form
|
||
to specify your key (e.g. <code class="literal">0x00112233</code>).
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.238. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to create the detached PGP signature for a
|
||
<code class="literal">multipart/signed</code> PGP/MIME body part.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.239. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: address</p></div><p>
|
||
Specifies how the entries in the pgp menu are sorted. The
|
||
following are legal values:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>address </td><td>sort alphabetically by user id
|
||
</td></tr><tr><td>keyid </td><td>sort alphabetically by key id
|
||
</td></tr><tr><td>date </td><td>sort by key creation date
|
||
</td></tr><tr><td>trust </td><td>sort by the trust of the key
|
||
</td></tr></tbody></table></div><p>
|
||
If you prefer reverse order of the above values, prefix it with
|
||
<span class="quote">“<span class="quote">reverse-</span>”</span>.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.240. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will automatically encode PGP/MIME signed messages as
|
||
quoted-printable. Please note that unsetting this variable may
|
||
lead to problems with non-verifyable PGP signatures, so only change
|
||
this if you know what you are doing.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.241. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number (long)<br />
|
||
Default: 300</p></div><p>
|
||
The number of seconds after which a cached passphrase will expire if
|
||
not used.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.242. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt expects a <code class="literal">gpg-agent(1)</code> process will handle
|
||
private key passphrase prompts. If <span class="emphasis"><em>unset</em></span>, mutt will prompt
|
||
for the passphrase and pass it via stdin to the pgp command.
|
||
</p><p>
|
||
Note that as of version 2.1, GnuPG automatically spawns an agent
|
||
and requires the agent be used for passphrase management. Since
|
||
that version is increasingly prevalent, this variable now
|
||
defaults <span class="emphasis"><em>set</em></span>.
|
||
</p><p>
|
||
Mutt works with a GUI or curses pinentry program. A TTY pinentry
|
||
should not be used.
|
||
</p><p>
|
||
If you are using an older version of GnuPG without an agent running,
|
||
or another encryption program without an agent, you will need to
|
||
<span class="emphasis"><em>unset</em></span> this variable.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.243. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to verify PGP signatures.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.244. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to verify key information from the key selection
|
||
menu.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.217. pgp_decode_command">$pgp_decode_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(PGP only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.245. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Used in connection with the <code class="literal"><pipe-message></code> function. When <span class="emphasis"><em>unset</em></span>,
|
||
Mutt will pipe the messages without any preprocessing. When <span class="emphasis"><em>set</em></span>, Mutt
|
||
will attempt to decode the messages first.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#pipe-decode-weed" title="3.246. pipe_decode_weed">$pipe_decode_weed</a>, which controls whether headers will
|
||
be weeded when this is <span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode-weed"></a>3.246. pipe_decode_weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
For <code class="literal"><pipe-message></code>, when <a class="link" href="reference.html#pipe-decode" title="3.245. pipe_decode">$pipe_decode</a> is set, this further
|
||
controls whether Mutt will weed headers.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.247. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">\n</code></span>”</span></p></div><p>
|
||
The separator to add between messages when piping a list of tagged
|
||
messages to an external Unix command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.248. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Used in connection with the <code class="literal"><pipe-message></code> function following
|
||
<code class="literal"><tag-prefix></code>. If this variable is <span class="emphasis"><em>unset</em></span>, when piping a list of
|
||
tagged messages Mutt will concatenate the messages and will pipe them
|
||
all concatenated. When <span class="emphasis"><em>set</em></span>, Mutt will pipe the messages one by one.
|
||
In both cases the messages are piped in the current sorted order,
|
||
and the <a class="link" href="reference.html#pipe-sep" title="3.247. pipe_sep">$pipe_sep</a> separator is added after each message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-auth-try-all"></a>3.249. pop_auth_try_all</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will try all available authentication methods.
|
||
When <span class="emphasis"><em>unset</em></span>, Mutt will only fall back to other authentication
|
||
methods if the previous methods are unavailable. If a method is
|
||
available but authentication fails, Mutt will not connect to the POP server.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.250. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This is a colon-delimited list of authentication methods mutt may
|
||
attempt to use to log in to an POP server, in the order mutt should
|
||
try them. Authentication methods are either <span class="quote">“<span class="quote">user</span>”</span>, <span class="quote">“<span class="quote">apop</span>”</span> or any
|
||
SASL mechanism, e.g. <span class="quote">“<span class="quote">digest-md5</span>”</span>, <span class="quote">“<span class="quote">gssapi</span>”</span> or <span class="quote">“<span class="quote">cram-md5</span>”</span>.
|
||
This option is case-insensitive. If this option is <span class="emphasis"><em>unset</em></span>
|
||
(the default) mutt will try all available methods, in order from
|
||
most-secure to least-secure.
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set pop_authenticators="digest-md5:apop:user"
|
||
</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-checkinterval"></a>3.251. pop_checkinterval</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 60</p></div><p>
|
||
This variable configures how often (in seconds) mutt should look for
|
||
new mail in the currently selected mailbox if it is a POP mailbox.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-delete"></a>3.252. pop_delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will delete successfully downloaded messages from the POP
|
||
server when using the <code class="literal"><a class="link" href="optionalfeatures.html#fetch-mail"><fetch-mail></a></code> function. When <span class="emphasis"><em>unset</em></span>, Mutt will
|
||
download messages but also leave them on the POP server.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-host"></a>3.253. pop_host</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
The name of your POP server for the <code class="literal"><a class="link" href="optionalfeatures.html#fetch-mail"><fetch-mail></a></code> function. You
|
||
can also specify an alternative port, username and password, i.e.:
|
||
|
||
</p><pre class="screen">
|
||
[pop[s]://][username[:password]@]popserver[:port]
|
||
</pre><p>
|
||
where <span class="quote">“<span class="quote">[...]</span>”</span> denotes an optional part.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-last"></a>3.254. pop_last</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If this variable is <span class="emphasis"><em>set</em></span>, mutt will try to use the <span class="quote">“<span class="quote"><code class="literal">LAST</code></span>”</span> POP command
|
||
for retrieving only unread messages from the POP server when using
|
||
the <code class="literal"><a class="link" href="optionalfeatures.html#fetch-mail"><fetch-mail></a></code> function.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-oauth-refresh-command"></a>3.255. pop_oauth_refresh_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
The command to run to generate an OAUTH refresh token for
|
||
authorizing your connection to your POP server. This command will be
|
||
run on every connection attempt that uses the OAUTHBEARER authentication
|
||
mechanism. See <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#oauth" title="6. OAUTHBEARER Support">oauth</a></span>”</span> for details.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-pass"></a>3.256. pop_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Specifies the password for your POP account. If <span class="emphasis"><em>unset</em></span>, Mutt will
|
||
prompt you for your password when you open a POP mailbox.
|
||
</p><p>
|
||
<span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a
|
||
fairly secure machine, because the superuser can read your muttrc
|
||
even if you are the only one who can read the file.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-reconnect"></a>3.257. pop_reconnect</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
Controls whether or not Mutt will try to reconnect to the POP server if
|
||
the connection is lost.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="pop-user"></a>3.258. pop_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Your login name on the POP server.
|
||
</p><p>
|
||
This variable defaults to your user name on the local machine.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="post-indent-string"></a>3.259. post_indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Similar to the <a class="link" href="reference.html#attribution" title="3.20. attribution">$attribution</a> variable, Mutt will append this
|
||
string after the inclusion of a message which is being replied to.
|
||
For a full listing of defined <code class="literal">printf(3)</code>-like sequences see
|
||
the section on <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="postpone"></a>3.260. postpone</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
Controls whether or not messages are saved in the <a class="link" href="reference.html#postponed" title="3.261. postponed">$postponed</a>
|
||
mailbox when you elect not to send immediately.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#recall" title="3.278. recall">$recall</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="postponed"></a>3.261. postponed</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/postponed</code></span>”</span></p></div><p>
|
||
Mutt allows you to indefinitely <span class="quote">“<span class="quote"><a class="link" href="reference.html#postpone" title="3.260. postpone">postpone</a> sending a message</span>”</span> which
|
||
you are editing. When you choose to postpone a message, Mutt saves it
|
||
in the mailbox specified by this variable.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#postpone" title="3.260. postpone">$postpone</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="postpone-encrypt"></a>3.262. postpone_encrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, postponed messages that are marked for encryption will be
|
||
self-encrypted. Mutt will first try to encrypt using the value specified
|
||
in <a class="link" href="reference.html#pgp-default-key" title="3.220. pgp_default_key">$pgp_default_key</a> or <a class="link" href="reference.html#smime-default-key" title="3.337. smime_default_key">$smime_default_key</a>. If those are not
|
||
set, it will try the deprecated <a class="link" href="reference.html#postpone-encrypt-as" title="3.263. postpone_encrypt_as">$postpone_encrypt_as</a>.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="postpone-encrypt-as"></a>3.263. postpone_encrypt_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This is a deprecated fall-back variable for <a class="link" href="reference.html#postpone-encrypt" title="3.262. postpone_encrypt">$postpone_encrypt</a>.
|
||
Please use <a class="link" href="reference.html#pgp-default-key" title="3.220. pgp_default_key">$pgp_default_key</a> or <a class="link" href="reference.html#smime-default-key" title="3.337. smime_default_key">$smime_default_key</a>.
|
||
(Crypto only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="preconnect"></a>3.264. preconnect</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, a shell command to be executed if mutt fails to establish
|
||
a connection to the server. This is useful for setting up secure
|
||
connections, e.g. with <code class="literal">ssh(1)</code>. If the command returns a nonzero
|
||
status, mutt gives up opening the server. Example:
|
||
|
||
</p><pre class="screen">
|
||
set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
|
||
sleep 20 < /dev/null > /dev/null"
|
||
</pre><p>
|
||
Mailbox <span class="quote">“<span class="quote">foo</span>”</span> on <span class="quote">“<span class="quote">mailhost.net</span>”</span> can now be reached
|
||
as <span class="quote">“<span class="quote">{localhost:1234}foo</span>”</span>.
|
||
</p><p>
|
||
Note: For this example to work, you must be able to log in to the
|
||
remote machine without having to enter a password.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.265. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-no</p></div><p>
|
||
Controls whether or not Mutt really prints messages.
|
||
This is set to <span class="quote">“<span class="quote">ask-no</span>”</span> by default, because some people
|
||
accidentally hit <span class="quote">“<span class="quote">p</span>”</span> often.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.266. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">lpr</code></span>”</span></p></div><p>
|
||
This specifies the command pipe that should be used to print messages.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.267. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Used in connection with the <code class="literal"><print-message></code> function. If this
|
||
option is <span class="emphasis"><em>set</em></span>, the message is decoded before it is passed to the
|
||
external command specified by <a class="link" href="reference.html#print-command" title="3.266. print_command">$print_command</a>. If this option
|
||
is <span class="emphasis"><em>unset</em></span>, no processing will be applied to the message when
|
||
printing it. The latter setting may be useful if you are using
|
||
some advanced printer filter which is able to properly format
|
||
e-mail messages for printing.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#print-decode-weed" title="3.268. print_decode_weed">$print_decode_weed</a>, which controls whether headers will
|
||
be weeded when this is <span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode-weed"></a>3.268. print_decode_weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
For <code class="literal"><print-message></code>, when <a class="link" href="reference.html#print-decode" title="3.267. print_decode">$print_decode</a> is set, this
|
||
further controls whether Mutt will weed headers.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.269. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Used in connection with the <code class="literal"><print-message></code> function. If this option
|
||
is <span class="emphasis"><em>set</em></span>, the command specified by <a class="link" href="reference.html#print-command" title="3.266. print_command">$print_command</a> is executed once for
|
||
each message which is to be printed. If this option is <span class="emphasis"><em>unset</em></span>,
|
||
the command specified by <a class="link" href="reference.html#print-command" title="3.266. print_command">$print_command</a> is executed only once, and
|
||
all the messages are concatenated, with a form feed as the message
|
||
separator.
|
||
</p><p>
|
||
Those who use the <code class="literal">enscript</code>(1) program's mail-printing mode will
|
||
most likely want to <span class="emphasis"><em>set</em></span> this option.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.270. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If you use an <span class="emphasis"><em>external</em></span> <a class="link" href="reference.html#pager" title="3.205. pager">$pager</a>, setting this variable will
|
||
cause Mutt to prompt you for a command when the pager exits rather
|
||
than returning to the index menu. If <span class="emphasis"><em>unset</em></span>, Mutt will return to the
|
||
index menu when the external pager exits.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.271. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This specifies the command Mutt will use to make external address
|
||
queries. The string may contain a <span class="quote">“<span class="quote">%s</span>”</span>, which will be substituted
|
||
with the query string the user types. Mutt will add quotes around the
|
||
string substituted for <span class="quote">“<span class="quote">%s</span>”</span> automatically according to shell quoting
|
||
rules, so you should avoid adding your own. If no <span class="quote">“<span class="quote">%s</span>”</span> is found in
|
||
the string, Mutt will append the user's query to the end of the string.
|
||
See <span class="quote">“<span class="quote"><a class="link" href="advancedusage.html#query" title="8. External Address Queries">query</a></span>”</span> for more information.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.272. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%4c %t %-25.25a %-25.25n %?e?(%e)?</code></span>”</span></p></div><p>
|
||
This variable describes the format of the <span class="quote">“<span class="quote">query</span>”</span> menu. The
|
||
following <code class="literal">printf(3)</code>-style sequences are understood:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>destination address
|
||
</td></tr><tr><td>%c </td><td>current entry number
|
||
</td></tr><tr><td>%e </td><td>extra information *
|
||
</td></tr><tr><td>%n </td><td>destination name
|
||
</td></tr><tr><td>%t </td><td><span class="quote">“<span class="quote">*</span>”</span> if current entry is tagged, a space otherwise
|
||
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%|X </td><td>pad to the end of the line with <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
|
||
</td></tr></tbody></table></div><p>
|
||
For an explanation of <span class="quote">“<span class="quote">soft-fill</span>”</span>, see the <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a> documentation.
|
||
</p><p>
|
||
* = can be optionally printed if nonzero, see the <a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a> documentation.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.273. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
This variable controls whether <span class="quote">“<span class="quote">quit</span>”</span> and <span class="quote">“<span class="quote">exit</span>”</span> actually quit
|
||
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
|
||
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
|
||
prompted for confirmation when you try to quit.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.274. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">^([ \t]*[|>:}#])+</code></span>”</span></p></div><p>
|
||
A regular expression used in the internal pager to determine quoted
|
||
sections of text in the body of a message. Quoted text may be filtered
|
||
out using the <code class="literal"><toggle-quoted></code> command, or colored according to the
|
||
<span class="quote">“<span class="quote">color quoted</span>”</span> family of directives.
|
||
</p><p>
|
||
Higher levels of quoting may be colored differently (<span class="quote">“<span class="quote">color quoted1</span>”</span>,
|
||
<span class="quote">“<span class="quote">color quoted2</span>”</span>, etc.). The quoting level is determined by removing
|
||
the last character from the matched text and recursively reapplying
|
||
the regular expression until it fails to produce a match.
|
||
</p><p>
|
||
Match detection may be overridden by the <a class="link" href="reference.html#smileys" title="3.331. smileys">$smileys</a> regular expression.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="read-inc"></a>3.275. read_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 10</p></div><p>
|
||
If set to a value greater than 0, Mutt will display which message it
|
||
is currently on when reading a mailbox or when performing search actions
|
||
such as search and limit. The message is printed after
|
||
this many messages have been read or searched (e.g., if set to 25, Mutt will
|
||
print a message when it is at message 25, and then again when it gets
|
||
to message 50). This variable is meant to indicate progress when
|
||
reading or searching large mailboxes which may take some time.
|
||
When set to 0, only a single message will appear before the reading
|
||
the mailbox.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#write-inc" title="3.423. write_inc">$write_inc</a>, <a class="link" href="reference.html#net-inc" title="3.203. net_inc">$net_inc</a> and <a class="link" href="reference.html#time-inc" title="3.397. time_inc">$time_inc</a> variables and the
|
||
<span class="quote">“<span class="quote"><a class="link" href="tuning.html" title="Chapter 8. Performance Tuning">tuning</a></span>”</span> section of the manual for performance considerations.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="read-only"></a>3.276. read_only</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, all folders are opened in read-only mode.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="realname"></a>3.277. realname</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable specifies what <span class="quote">“<span class="quote">real</span>”</span> or <span class="quote">“<span class="quote">personal</span>”</span> name should be used
|
||
when sending messages.
|
||
</p><p>
|
||
By default, this is the GECOS field from <code class="literal">/etc/passwd</code>. Note that this
|
||
variable will <span class="emphasis"><em>not</em></span> be used when the user has set a real name
|
||
in the <a class="link" href="reference.html#from" title="3.109. from">$from</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="recall"></a>3.278. recall</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
Controls whether or not Mutt recalls postponed messages
|
||
when composing a new message.
|
||
</p><p>
|
||
Setting this variable to <span class="emphasis"><em>yes</em></span> is not generally useful, and thus not
|
||
recommended. Note that the <code class="literal"><recall-message></code> function can be used
|
||
to manually recall postponed messages.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#postponed" title="3.261. postponed">$postponed</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="record"></a>3.279. record</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/sent</code></span>”</span></p></div><p>
|
||
This specifies the file into which your outgoing messages should be
|
||
appended. (This is meant as the primary method for saving a copy of
|
||
your messages, but another way to do this is using the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#my-hdr" title="17. User-Defined Headers">my_hdr</a></span>”</span>
|
||
command to create a <span class="quote">“<span class="quote">Bcc:</span>”</span> field with your email address in it.)
|
||
</p><p>
|
||
The value of <span class="emphasis"><em><a class="link" href="reference.html#record" title="3.279. record">$record</a></em></span> is overridden by the <a class="link" href="reference.html#force-name" title="3.100. force_name">$force_name</a> and
|
||
<a class="link" href="reference.html#save-name" title="3.296. save_name">$save_name</a> variables, and the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="19. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span> command. Also see <a class="link" href="reference.html#copy" title="3.52. copy">$copy</a>
|
||
and <a class="link" href="reference.html#write-bcc" title="3.422. write_bcc">$write_bcc</a>.
|
||
</p><p>
|
||
Multiple mailboxes may be specified if <a class="link" href="reference.html#fcc-delimiter" title="3.95. fcc_delimiter">$fcc_delimiter</a> is
|
||
set to a string delimiter.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reflow-space-quotes"></a>3.280. reflow_space_quotes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This option controls how quotes from format=flowed messages are displayed
|
||
in the pager and when replying (with <a class="link" href="reference.html#text-flowed" title="3.393. text_flowed">$text_flowed</a> <span class="emphasis"><em>unset</em></span>).
|
||
When set, this option adds spaces after each level of quote marks, turning
|
||
">>>foo" into "> > > foo".
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> If <a class="link" href="reference.html#reflow-text" title="3.281. reflow_text">$reflow_text</a> is <span class="emphasis"><em>unset</em></span>, this option has no effect.
|
||
Also, this option does not affect replies when <a class="link" href="reference.html#text-flowed" title="3.393. text_flowed">$text_flowed</a> is <span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reflow-text"></a>3.281. reflow_text</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will reformat paragraphs in text/plain
|
||
parts marked format=flowed. If <span class="emphasis"><em>unset</em></span>, Mutt will display paragraphs
|
||
unaltered from how they appear in the message body. See RFC3676 for
|
||
details on the <span class="emphasis"><em>format=flowed</em></span> format.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#reflow-wrap" title="3.282. reflow_wrap">$reflow_wrap</a>, and <a class="link" href="reference.html#wrap" title="3.418. wrap">$wrap</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reflow-wrap"></a>3.282. reflow_wrap</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 78</p></div><p>
|
||
This variable controls the maximum paragraph width when reformatting text/plain
|
||
parts when <a class="link" href="reference.html#reflow-text" title="3.281. reflow_text">$reflow_text</a> is <span class="emphasis"><em>set</em></span>. When the value is 0, paragraphs will
|
||
be wrapped at the terminal's right margin. A positive value sets the
|
||
paragraph width relative to the left margin. A negative value set the
|
||
paragraph width relative to the right margin.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#wrap" title="3.418. wrap">$wrap</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reply-regexp"></a>3.283. reply_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">^(re)(\\[[0-9]+\\])*:[ \t]*</code></span>”</span></p></div><p>
|
||
A regular expression used to recognize reply messages when
|
||
threading and replying. The default value corresponds to the
|
||
standard Latin "Re:" prefix.
|
||
</p><p>
|
||
This value may have been localized by the translator for your
|
||
locale, adding other prefixes that are common in the locale. You
|
||
can add your own prefixes by appending inside <code class="literal">"^(re)"</code>. For
|
||
example: <code class="literal">"^(re|se)"</code> or <code class="literal">"^(re|aw|se)"</code>.
|
||
</p><p>
|
||
The second parenthesized expression matches zero or more
|
||
bracketed numbers following the prefix, such as <code class="literal">"Re[1]: "</code>.
|
||
The initial <code class="literal">"\\["</code> means a literal left-bracket character.
|
||
Note the backslash must be doubled when used inside a double
|
||
quoted string in the muttrc. <code class="literal">"[0-9]+"</code> means one or more
|
||
numbers. <code class="literal">"\\]"</code> means a literal right-bracket. Finally the
|
||
whole parenthesized expression has a <code class="literal">"*"</code> suffix, meaning it
|
||
can occur zero or more times.
|
||
</p><p>
|
||
The last part matches a colon followed by an optional space or
|
||
tab. Note <code class="literal">"\t"</code> is converted to a literal tab inside a
|
||
double quoted string. If you use a single quoted string, you
|
||
would have to type an actual tab character, and would need to
|
||
convert the double-backslashes to single backslashes.
|
||
</p><p>
|
||
Note: the result of this regexp match against the subject is
|
||
stored in the header cache. Mutt isn't smart enough to
|
||
invalidate a header cache entry based on changing <a class="link" href="reference.html#reply-regexp" title="3.283. reply_regexp">$reply_regexp</a>,
|
||
so if you aren't seeing correct values in the index, try
|
||
temporarily turning off the header cache. If that fixes the
|
||
problem, then once the variable is set to your liking, remove
|
||
your stale header cache files and turn the header cache back on.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reply-self"></a>3.284. reply_self</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>unset</em></span> and you are replying to a message sent by you, Mutt will
|
||
assume that you want to reply to the recipients of that message rather
|
||
than to yourself.
|
||
</p><p>
|
||
Also see the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></span>”</span> command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reply-to"></a>3.285. reply_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: ask-yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, when replying to a message, Mutt will use the address listed
|
||
in the Reply-to: header as the recipient of the reply. If <span class="emphasis"><em>unset</em></span>,
|
||
it will use the address in the From: header field instead. This
|
||
option is useful for reading a mailing list that sets the Reply-To:
|
||
header field to the list address and you want to send a private
|
||
message to the author of a message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="resolve"></a>3.286. resolve</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, the cursor will be automatically advanced to the next
|
||
(possibly undeleted) message whenever a command that modifies the
|
||
current message is executed.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="resume-draft-files"></a>3.287. resume_draft_files</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, draft files (specified by <code class="literal">-H</code> on the command
|
||
line) are processed similarly to when resuming a postponed
|
||
message. Recipients are not prompted for; send-hooks are not
|
||
evaluated; no alias expansion takes place; user-defined headers
|
||
and signatures are not added to the message.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="resume-edited-draft-files"></a>3.288. resume_edited_draft_files</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, draft files previously edited (via <code class="literal">-E -H</code> on
|
||
the command line) will have <a class="link" href="reference.html#resume-draft-files" title="3.287. resume_draft_files">$resume_draft_files</a> automatically
|
||
set when they are used as a draft file again.
|
||
</p><p>
|
||
The first time a draft file is saved, mutt will add a header,
|
||
X-Mutt-Resume-Draft to the saved file. The next time the draft
|
||
file is read in, if mutt sees the header, it will set
|
||
<a class="link" href="reference.html#resume-draft-files" title="3.287. resume_draft_files">$resume_draft_files</a>.
|
||
</p><p>
|
||
This option is designed to prevent multiple signatures,
|
||
user-defined headers, and other processing effects from being
|
||
made multiple times to the draft file.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-alias"></a>3.289. reverse_alias</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This variable controls whether or not Mutt will display the <span class="quote">“<span class="quote">personal</span>”</span>
|
||
name from your aliases in the index menu if it finds an alias that
|
||
matches the message's sender. For example, if you have the following
|
||
alias:
|
||
|
||
</p><pre class="screen">
|
||
alias juser abd30425@somewhere.net (Joe User)
|
||
</pre><p>
|
||
and then you receive mail which contains the following header:
|
||
|
||
</p><pre class="screen">
|
||
From: abd30425@somewhere.net
|
||
</pre><p>
|
||
It would be displayed in the index menu as <span class="quote">“<span class="quote">Joe User</span>”</span> instead of
|
||
<span class="quote">“<span class="quote">abd30425@somewhere.net.</span>”</span> This is useful when the person's e-mail
|
||
address is not human friendly.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-name"></a>3.290. reverse_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
It may sometimes arrive that you receive mail to a certain machine,
|
||
move the messages to another machine, and reply to some the messages
|
||
from there. If this variable is <span class="emphasis"><em>set</em></span>, the default <span class="emphasis"><em>From:</em></span> line of
|
||
the reply messages is built using the address where you received the
|
||
messages you are replying to <span class="bold"><strong>if</strong></span> that address matches your
|
||
<span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></span>”</span>. If the variable is <span class="emphasis"><em>unset</em></span>, or the address that would be
|
||
used doesn't match your <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></span>”</span>, the <span class="emphasis"><em>From:</em></span> line will use
|
||
your address on the current machine.
|
||
</p><p>
|
||
Also see the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="13. Alternative Addresses">alternates</a></span>”</span> command and <a class="link" href="reference.html#reverse-realname" title="3.291. reverse_realname">$reverse_realname</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-realname"></a>3.291. reverse_realname</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This variable fine-tunes the behavior of the <a class="link" href="reference.html#reverse-name" title="3.290. reverse_name">$reverse_name</a> feature.
|
||
</p><p>
|
||
When it is <span class="emphasis"><em>unset</em></span>, Mutt will remove the real name part of a
|
||
matching address. This allows the use of the email address
|
||
without having to also use what the sender put in the real name
|
||
field.
|
||
</p><p>
|
||
When it is <span class="emphasis"><em>set</em></span>, Mutt will use the matching address as-is.
|
||
</p><p>
|
||
In either case, a missing real name will be filled in afterwards
|
||
using the value of <a class="link" href="reference.html#realname" title="3.277. realname">$realname</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="rfc2047-parameters"></a>3.292. rfc2047_parameters</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span>, Mutt will decode RFC2047-encoded MIME
|
||
parameters. You want to set this variable when mutt suggests you
|
||
to save attachments to files named like:
|
||
|
||
</p><pre class="screen">
|
||
=?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
|
||
</pre><p>
|
||
When this variable is <span class="emphasis"><em>set</em></span> interactively, the change won't be
|
||
active until you change folders.
|
||
</p><p>
|
||
Note that this use of RFC2047's encoding is explicitly
|
||
prohibited by the standard, but nevertheless encountered in the
|
||
wild.
|
||
</p><p>
|
||
Also note that setting this parameter will <span class="emphasis"><em>not</em></span> have the effect
|
||
that mutt <span class="emphasis"><em>generates</em></span> this kind of encoding. Instead, mutt will
|
||
unconditionally use the encoding specified in RFC2231.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.293. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, mutt will take the sender's full address when choosing a
|
||
default folder for saving a mail. If <a class="link" href="reference.html#save-name" title="3.296. save_name">$save_name</a> or <a class="link" href="reference.html#force-name" title="3.100. force_name">$force_name</a>
|
||
is <span class="emphasis"><em>set</em></span> too, the selection of the Fcc folder will be changed as well.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.294. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>unset</em></span>, mailboxes which contain no saved messages will be removed
|
||
when closed (the exception is <a class="link" href="reference.html#spoolfile" title="3.370. spoolfile">$spoolfile</a> which is never removed).
|
||
If <span class="emphasis"><em>set</em></span>, mailboxes are never removed.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> This only applies to mbox and MMDF folders, Mutt does not
|
||
delete MH and Maildir directories.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.295. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
This variable controls the size of the history (per category) saved in the
|
||
<a class="link" href="reference.html#history-file" title="3.125. history_file">$history_file</a> file.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.296. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This variable controls how copies of outgoing messages are saved.
|
||
When <span class="emphasis"><em>set</em></span>, a check is made to see if a mailbox specified by the
|
||
recipient address exists (this is done by searching for a mailbox in
|
||
the <a class="link" href="reference.html#folder" title="3.97. folder">$folder</a> directory with the <span class="emphasis"><em>username</em></span> part of the
|
||
recipient address). If the mailbox exists, the outgoing message will
|
||
be saved to that mailbox, otherwise the message is saved to the
|
||
<a class="link" href="reference.html#record" title="3.279. record">$record</a> mailbox.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#force-name" title="3.100. force_name">$force_name</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.297. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When this variable is <span class="emphasis"><em>unset</em></span>, scoring is turned off. This can
|
||
be useful to selectively disable scoring for certain folders when the
|
||
<a class="link" href="reference.html#score-threshold-delete" title="3.298. score_threshold_delete">$score_threshold_delete</a> variable and related are used.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.298. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: -1</p></div><p>
|
||
Messages which have been assigned a score equal to or lower than the value
|
||
of this variable are automatically marked for deletion by mutt. Since
|
||
mutt scores are always greater than or equal to zero, the default setting
|
||
of this variable will never mark a message for deletion.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.299. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 9999</p></div><p>
|
||
Messages which have been assigned a score greater than or equal to this
|
||
variable's value are automatically marked "flagged".
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.300. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: -1</p></div><p>
|
||
Messages which have been assigned a score equal to or lower than the value
|
||
of this variable are automatically marked as read by mutt. Since
|
||
mutt scores are always greater than or equal to zero, the default setting
|
||
of this variable will never mark a message read.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="search-context"></a>3.301. search_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
For the pager, this variable specifies the number of lines shown
|
||
before search results. By default, search results will be top-aligned.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.302. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">us-ascii:iso-8859-1:utf-8</code></span>”</span></p></div><p>
|
||
A colon-delimited list of character sets for outgoing messages. Mutt will use the
|
||
first character set into which the text can be converted exactly.
|
||
If your <a class="link" href="reference.html#charset" title="3.41. charset">$charset</a> is not <span class="quote">“<span class="quote">iso-8859-1</span>”</span> and recipients may not
|
||
understand <span class="quote">“<span class="quote">UTF-8</span>”</span>, it is advisable to include in the list an
|
||
appropriate widely used standard character set (such as
|
||
<span class="quote">“<span class="quote">iso-8859-2</span>”</span>, <span class="quote">“<span class="quote">koi8-r</span>”</span> or <span class="quote">“<span class="quote">iso-2022-jp</span>”</span>) either instead of or after
|
||
<span class="quote">“<span class="quote">iso-8859-1</span>”</span>.
|
||
</p><p>
|
||
In case the text cannot be converted into one of these exactly,
|
||
mutt uses <a class="link" href="reference.html#charset" title="3.41. charset">$charset</a> as a fallback.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="send-multipart-alternative"></a>3.303. send_multipart_alternative</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, Mutt will generate a multipart/alternative
|
||
container and an alternative part using the filter script specified in
|
||
<a class="link" href="reference.html#send-multipart-alternative-filter" title="3.304. send_multipart_alternative_filter">$send_multipart_alternative_filter</a>.
|
||
See the section <span class="quote">“<span class="quote">MIME Multipart/Alternative</span>”</span> (<a class="link" href="mimesupport.html#alternative-order" title="5. MIME Multipart/Alternative">alternative-order</a>).
|
||
</p><p>
|
||
Note that enabling multipart/alternative is not compatible with inline
|
||
PGP encryption. Mutt will prompt to use PGP/MIME in that case.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="send-multipart-alternative-filter"></a>3.304. send_multipart_alternative_filter</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This specifies a filter script, which will convert the main
|
||
(composed) message of the email to an alternative format. The
|
||
message will be piped to the filter's stdin. The expected output
|
||
of the filter is the generated mime type, e.g. text/html,
|
||
followed by a blank line, and then the converted content.
|
||
See the section <span class="quote">“<span class="quote">MIME Multipart/Alternative</span>”</span> (<a class="link" href="mimesupport.html#alternative-order" title="5. MIME Multipart/Alternative">alternative-order</a>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail"></a>3.305. sendmail</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">/usr/bin/sendmail -oem -oi</code></span>”</span></p></div><p>
|
||
Specifies the program and arguments used to deliver mail sent by Mutt.
|
||
Mutt expects that the specified program interprets additional
|
||
arguments as recipient addresses. Mutt appends all recipients after
|
||
adding a <code class="literal">--</code> delimiter (if not already present). Additional
|
||
flags, such as for <a class="link" href="reference.html#use-8bitmime" title="3.409. use_8bitmime">$use_8bitmime</a>, <a class="link" href="reference.html#use-envelope-from" title="3.411. use_envelope_from">$use_envelope_from</a>,
|
||
<a class="link" href="reference.html#dsn-notify" title="3.81. dsn_notify">$dsn_notify</a>, or <a class="link" href="reference.html#dsn-return" title="3.82. dsn_return">$dsn_return</a> will be added before the delimiter.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> This command is invoked differently from most other
|
||
commands in Mutt. It is tokenized by space, and invoked directly
|
||
via <code class="literal">execvp(3)</code> with an array of arguments - so commands or
|
||
arguments with spaces in them are not supported. The shell is
|
||
not used to run the command, so shell quoting is also not
|
||
supported.
|
||
</p><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="reference.html#write-bcc" title="3.422. write_bcc">$write_bcc</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail-wait"></a>3.306. sendmail_wait</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
Specifies the number of seconds to wait for the <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a> process
|
||
to finish before giving up and putting delivery in the background.
|
||
</p><p>
|
||
Mutt interprets the value of this variable as follows:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>>0 </td><td>number of seconds to wait for sendmail to finish before continuing
|
||
</td></tr><tr><td>0 </td><td>wait forever for sendmail to finish
|
||
</td></tr><tr><td><0 </td><td>always put sendmail in the background without waiting
|
||
</td></tr></tbody></table></div><p>
|
||
Note that if you specify a value other than 0, the output of the child
|
||
process will be put in a temporary file. If there is some error, you
|
||
will be informed as to where to find the output.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="shell"></a>3.307. shell</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
Command to use when spawning a subshell. By default, the user's login
|
||
shell from <code class="literal">/etc/passwd</code> is used.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-delim-chars"></a>3.308. sidebar_delim_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">/.</code></span>”</span></p></div><p>
|
||
This contains the list of characters which you would like to treat
|
||
as folder separators for displaying paths in the sidebar.
|
||
</p><p>
|
||
Local mail is often arranged in directories: `dir1/dir2/mailbox'.
|
||
|
||
</p><pre class="screen">
|
||
set sidebar_delim_chars='/'
|
||
</pre><p>
|
||
IMAP mailboxes are often named: `folder1.folder2.mailbox'.
|
||
|
||
</p><pre class="screen">
|
||
set sidebar_delim_chars='.'
|
||
</pre><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="reference.html#sidebar-short-path" title="3.316. sidebar_short_path">$sidebar_short_path</a>, <a class="link" href="reference.html#sidebar-folder-indent" title="3.310. sidebar_folder_indent">$sidebar_folder_indent</a>, <a class="link" href="reference.html#sidebar-indent-string" title="3.312. sidebar_indent_string">$sidebar_indent_string</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-divider-char"></a>3.309. sidebar_divider_char</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">|</code></span>”</span></p></div><p>
|
||
This specifies the characters to be drawn between the sidebar (when
|
||
visible) and the other Mutt panels. ASCII and Unicode line-drawing
|
||
characters are supported.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-folder-indent"></a>3.310. sidebar_folder_indent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Set this to indent mailboxes in the sidebar.
|
||
</p><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="reference.html#sidebar-short-path" title="3.316. sidebar_short_path">$sidebar_short_path</a>, <a class="link" href="reference.html#sidebar-indent-string" title="3.312. sidebar_indent_string">$sidebar_indent_string</a>, <a class="link" href="reference.html#sidebar-delim-chars" title="3.308. sidebar_delim_chars">$sidebar_delim_chars</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-format"></a>3.311. sidebar_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">%B%* %n</code></span>”</span></p></div><p>
|
||
This variable allows you to customize the sidebar display. This string is
|
||
similar to <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>, but has its own set of <code class="literal">printf(3)</code>-like
|
||
sequences:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%B </td><td>Name of the mailbox
|
||
</td></tr><tr><td>%S </td><td>* Size of mailbox (total number of messages)
|
||
</td></tr><tr><td>%N </td><td>* Number of unread messages in the mailbox
|
||
</td></tr><tr><td>%n </td><td>N if mailbox has new mail, blank otherwise
|
||
</td></tr><tr><td>%F </td><td>* Number of Flagged messages in the mailbox
|
||
</td></tr><tr><td>%! </td><td><span class="quote">“<span class="quote">!</span>”</span> : one flagged message;
|
||
<span class="quote">“<span class="quote">!!</span>”</span> : two flagged messages;
|
||
<span class="quote">“<span class="quote">n!</span>”</span> : n flagged messages (for n > 2).
|
||
Otherwise prints nothing.
|
||
</td></tr><tr><td>%d </td><td>* @ Number of deleted messages
|
||
</td></tr><tr><td>%L </td><td>* @ Number of messages after limiting
|
||
</td></tr><tr><td>%t </td><td>* @ Number of tagged messages
|
||
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%|X </td><td>pad to the end of the line with <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
|
||
</td></tr></tbody></table></div><p>
|
||
* = Can be optionally printed if nonzero
|
||
@ = Only applicable to the current folder
|
||
</p><p>
|
||
In order to use %S, %N, %F, and %!, <a class="link" href="reference.html#mail-check-stats" title="3.167. mail_check_stats">$mail_check_stats</a> must
|
||
be <span class="emphasis"><em>set</em></span>. When thus set, a suggested value for this option is
|
||
"%B%?F? [%F]?%* %?N?%N/?%S".
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-indent-string"></a>3.312. sidebar_indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal"> </code></span>”</span></p></div><p>
|
||
This specifies the string that is used to indent mailboxes in the sidebar.
|
||
It defaults to two spaces.
|
||
</p><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="reference.html#sidebar-short-path" title="3.316. sidebar_short_path">$sidebar_short_path</a>, <a class="link" href="reference.html#sidebar-folder-indent" title="3.310. sidebar_folder_indent">$sidebar_folder_indent</a>, <a class="link" href="reference.html#sidebar-delim-chars" title="3.308. sidebar_delim_chars">$sidebar_delim_chars</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-new-mail-only"></a>3.313. sidebar_new_mail_only</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When set, the sidebar will only display mailboxes containing new, or
|
||
flagged, mail.
|
||
</p><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="optionalfeatures.html#sidebar-whitelist" title="11.4. Commands">sidebar_whitelist</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-next-new-wrap"></a>3.314. sidebar_next_new_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When set, the <code class="literal"><sidebar-next-new></code> command will not stop and the end of
|
||
the list of mailboxes, but wrap around to the beginning. The
|
||
<code class="literal"><sidebar-prev-new></code> command is similarly affected, wrapping around to
|
||
the end of the list.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-relative-shortpath-indent"></a>3.315. sidebar_relative_shortpath_indent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When set, this option changes how <a class="link" href="reference.html#sidebar-short-path" title="3.316. sidebar_short_path">$sidebar_short_path</a> and
|
||
<a class="link" href="reference.html#sidebar-folder-indent" title="3.310. sidebar_folder_indent">$sidebar_folder_indent</a> perform shortening and indentation: both
|
||
will look at the previous sidebar entries and shorten/indent
|
||
relative to the most recent parent.
|
||
</p><p>
|
||
An example of this option set/unset for mailboxes listed in this
|
||
order, with <a class="link" href="reference.html#sidebar-short-path" title="3.316. sidebar_short_path">$sidebar_short_path</a>=yes,
|
||
<a class="link" href="reference.html#sidebar-folder-indent" title="3.310. sidebar_folder_indent">$sidebar_folder_indent</a>=yes, and <a class="link" href="reference.html#sidebar-indent-string" title="3.312. sidebar_indent_string">$sidebar_indent_string</a>="→":
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td><span class="bold"><strong>mailbox</strong></span> </td><td><span class="bold"><strong>set</strong></span> </td><td><span class="bold"><strong>unset</strong></span>
|
||
</td></tr><tr><td><code class="literal">=a.b</code> </td><td><code class="literal">=a.b</code> </td><td><code class="literal">→b</code>
|
||
</td></tr><tr><td><code class="literal">=a.b.c.d</code> </td><td><code class="literal">→c.d</code> </td><td><code class="literal">→→→d</code>
|
||
</td></tr><tr><td><code class="literal">=a.b.e</code> </td><td><code class="literal">→e</code> </td><td><code class="literal">→→e</code>
|
||
</td></tr></tbody></table></div><p>
|
||
The second line illustrates most clearly. With this option set,
|
||
<code class="literal">=a.b.c.d</code> is shortened relative to <code class="literal">=a.b</code>, becoming
|
||
<code class="literal">c.d</code>; it is also indented one place relative to <code class="literal">=a.b</code>.
|
||
With this option unset <code class="literal">=a.b.c.d</code> is always shortened to the
|
||
last part of the mailbox, <code class="literal">d</code> and is indented three places,
|
||
with respect to <a class="link" href="reference.html#folder" title="3.97. folder">$folder</a> (represented by '=').
|
||
</p><p>
|
||
When set, the third line will also be indented and shortened
|
||
relative to the first line.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-short-path"></a>3.316. sidebar_short_path</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
By default the sidebar will show the mailbox's path, relative to the
|
||
<a class="link" href="reference.html#folder" title="3.97. folder">$folder</a> variable. Setting <code class="literal">sidebar_shortpath=yes</code> will shorten the
|
||
names relative to the previous name. Here's an example:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td><span class="bold"><strong>shortpath=no</strong></span> </td><td><span class="bold"><strong>shortpath=yes</strong></span> </td><td><span class="bold"><strong>shortpath=yes, folderindent=yes, indentstr=".."</strong></span>
|
||
</td></tr><tr><td><code class="literal">fruit</code> </td><td><code class="literal">fruit</code> </td><td><code class="literal">fruit</code>
|
||
</td></tr><tr><td><code class="literal">fruit.apple</code> </td><td><code class="literal">apple</code> </td><td><code class="literal">..apple</code>
|
||
</td></tr><tr><td><code class="literal">fruit.banana</code> </td><td><code class="literal">banana</code> </td><td><code class="literal">..banana</code>
|
||
</td></tr><tr><td><code class="literal">fruit.cherry</code> </td><td><code class="literal">cherry</code> </td><td><code class="literal">..cherry</code>
|
||
</td></tr></tbody></table></div><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="reference.html#sidebar-delim-chars" title="3.308. sidebar_delim_chars">$sidebar_delim_chars</a>, <a class="link" href="reference.html#sidebar-folder-indent" title="3.310. sidebar_folder_indent">$sidebar_folder_indent</a>, <a class="link" href="reference.html#sidebar-indent-string" title="3.312. sidebar_indent_string">$sidebar_indent_string</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-sort-method"></a>3.317. sidebar_sort_method</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: unsorted</p></div><p>
|
||
Specifies how to sort mailbox entries in the sidebar. By default, the
|
||
entries are sorted alphabetically. Valid values:
|
||
|
||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>alpha (alphabetically)
|
||
</p></li><li class="listitem"><p>count (all message count)
|
||
</p></li><li class="listitem"><p>flagged (flagged message count)
|
||
</p></li><li class="listitem"><p>name (alphabetically)
|
||
</p></li><li class="listitem"><p>new (unread message count)
|
||
</p></li><li class="listitem"><p>path (alphabetically)
|
||
</p></li><li class="listitem"><p>unread (unread message count)
|
||
</p></li><li class="listitem"><p>unsorted
|
||
</p></li></ul></div><p>
|
||
You may optionally use the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix to specify reverse sorting
|
||
order (example: <span class="quote">“<span class="quote"><code class="literal">set sidebar_sort_method=reverse-alpha</code></span>”</span>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-use-mailbox-shortcuts"></a>3.318. sidebar_use_mailbox_shortcuts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When set, sidebar mailboxes will be displayed with mailbox shortcut prefixes
|
||
"=" or "~".
|
||
</p><p>
|
||
When unset, the sidebar will trim off a matching <a class="link" href="reference.html#folder" title="3.97. folder">$folder</a> prefix
|
||
but otherwise not use mailbox shortcuts.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-visible"></a>3.319. sidebar_visible</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This specifies whether or not to show sidebar. The sidebar shows a list of
|
||
all your mailboxes.
|
||
</p><p>
|
||
<span class="bold"><strong>See also:</strong></span> <a class="link" href="reference.html#sidebar-format" title="3.311. sidebar_format">$sidebar_format</a>, <a class="link" href="reference.html#sidebar-width" title="3.320. sidebar_width">$sidebar_width</a>
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sidebar-width"></a>3.320. sidebar_width</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 30</p></div><p>
|
||
This controls the width of the sidebar. It is measured in screen columns.
|
||
For example: sidebar_width=20 could display 20 ASCII characters, or 10
|
||
Chinese characters.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sig-dashes"></a>3.321. sig_dashes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, a line containing <span class="quote">“<span class="quote">-- </span>”</span> (note the trailing space) will be inserted before your
|
||
<a class="link" href="reference.html#signature" title="3.323. signature">$signature</a>. It is <span class="bold"><strong>strongly</strong></span> recommended that you not <span class="emphasis"><em>unset</em></span>
|
||
this variable unless your signature contains just your name. The
|
||
reason for this is because many software packages use <span class="quote">“<span class="quote">-- \n</span>”</span> to
|
||
detect your signature. For example, Mutt has the ability to highlight
|
||
the signature in a different color in the built-in pager.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sig-on-top"></a>3.322. sig_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, the signature will be included before any quoted or forwarded
|
||
text. It is <span class="bold"><strong>strongly</strong></span> recommended that you do not set this variable
|
||
unless you really know what you are doing, and are prepared to take
|
||
some heat from netiquette guardians.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="signature"></a>3.323. signature</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~/.signature</code></span>”</span></p></div><p>
|
||
Specifies the filename of your signature, which is appended to all
|
||
outgoing messages. If the filename ends with a pipe (<span class="quote">“<span class="quote">|</span>”</span>), it is
|
||
assumed that filename is a shell command and input should be read from
|
||
its standard output.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="simple-search"></a>3.324. simple_search</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">~f %s | ~s %s</code></span>”</span></p></div><p>
|
||
Specifies how Mutt should expand a simple search into a real search
|
||
pattern. A simple search is one that does not contain any of the <span class="quote">“<span class="quote">~</span>”</span> pattern
|
||
modifiers. See <span class="quote">“<span class="quote"><a class="link" href="advancedusage.html#patterns" title="3. Patterns: Searching, Limiting and Tagging">patterns</a></span>”</span> for more information on search patterns.
|
||
</p><p>
|
||
For example, if you simply type <span class="quote">“<span class="quote">joe</span>”</span> at a search or limit prompt, Mutt
|
||
will automatically expand it to the value specified by this variable by
|
||
replacing <span class="quote">“<span class="quote">%s</span>”</span> with the supplied string.
|
||
For the default value, <span class="quote">“<span class="quote">joe</span>”</span> would be expanded to: <span class="quote">“<span class="quote">~f joe | ~s joe</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="size-show-bytes"></a>3.325. size_show_bytes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, message sizes will display bytes for values less than
|
||
1 kilobyte. See <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="size-show-fractions"></a>3.326. size_show_fractions</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, message sizes will be displayed with a single decimal value
|
||
for sizes from 0 to 10 kilobytes and 1 to 10 megabytes.
|
||
See <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="size-show-mb"></a>3.327. size_show_mb</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, message sizes will display megabytes for values greater than
|
||
or equal to 1 megabyte. See <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="size-units-on-left"></a>3.328. size_units_on_left</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, message sizes units will be displayed to the left of the number.
|
||
See <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.329. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 1</p></div><p>
|
||
Specifies time, in seconds, to pause while displaying certain informational
|
||
messages, while moving from folder to folder and after expunging
|
||
messages from the current folder. The default is to pause one second, so
|
||
a value of zero for this option suppresses the pause.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.330. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls the display of lines longer than the screen width in the
|
||
internal pager. If <span class="emphasis"><em>set</em></span>, long lines are wrapped at a word boundary. If
|
||
<span class="emphasis"><em>unset</em></span>, lines are simply wrapped at the screen edge. Also see the
|
||
<a class="link" href="reference.html#markers" title="3.176. markers">$markers</a> variable.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.331. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">(>From )|(:[-^]?[][)(><}{|/DP])</code></span>”</span></p></div><p>
|
||
The <span class="emphasis"><em>pager</em></span> uses this variable to catch some common false
|
||
positives of <a class="link" href="reference.html#quote-regexp" title="3.274. quote_regexp">$quote_regexp</a>, most notably smileys and not consider
|
||
a line quoted text if it also matches <a class="link" href="reference.html#smileys" title="3.331. smileys">$smileys</a>. This mostly
|
||
happens at the beginning of a line.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.332. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This flag controls whether you want to be asked to enter a label
|
||
for a certificate about to be added to the database or not. It is
|
||
<span class="emphasis"><em>set</em></span> by default.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.333. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable contains the name of either a directory, or a file which
|
||
contains trusted certificates for use with OpenSSL.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.334. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
|
||
storage and retrieval of keys by itself. This is very basic right
|
||
now, and keys and certificates are stored in two different
|
||
directories, both named as the hash-value retrieved from
|
||
OpenSSL. There is an index file which contains mailbox-address
|
||
keyid pairs, and which can be manually edited. This option points to
|
||
the location of the certificates.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.335. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This format string specifies a command which is used to decrypt
|
||
<code class="literal">application/x-pkcs7-mime</code> attachments.
|
||
</p><p>
|
||
The OpenSSL command formats have their own set of <code class="literal">printf(3)</code>-like sequences
|
||
similar to PGP's:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%f </td><td>Expands to the name of a file containing a message.
|
||
</td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
|
||
of a <code class="literal">multipart/signed</code> attachment when verifying it.
|
||
</td></tr><tr><td>%k </td><td>The key-pair specified with <a class="link" href="reference.html#smime-default-key" title="3.337. smime_default_key">$smime_default_key</a>
|
||
</td></tr><tr><td>%c </td><td>One or more certificate IDs.
|
||
</td></tr><tr><td>%a </td><td>The algorithm used for encryption.
|
||
</td></tr><tr><td>%d </td><td>The message digest algorithm specified with <a class="link" href="reference.html#smime-sign-digest-alg" title="3.351. smime_sign_digest_alg">$smime_sign_digest_alg</a>.
|
||
</td></tr><tr><td>%C </td><td>CA location: Depending on whether <a class="link" href="reference.html#smime-ca-location" title="3.333. smime_ca_location">$smime_ca_location</a>
|
||
points to a directory or file, this expands to
|
||
<span class="quote">“<span class="quote">-CApath <a class="link" href="reference.html#smime-ca-location" title="3.333. smime_ca_location">$smime_ca_location</a></span>”</span> or <span class="quote">“<span class="quote">-CAfile <a class="link" href="reference.html#smime-ca-location" title="3.333. smime_ca_location">$smime_ca_location</a></span>”</span>.
|
||
</td></tr></tbody></table></div><p>
|
||
For examples on how to configure these formats, see the <code class="literal">smime.rc</code> in
|
||
the <code class="literal">samples/</code> subdirectory which has been installed on your system
|
||
alongside the documentation.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.336. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> (default) this tells mutt to use the default key for decryption. Otherwise,
|
||
if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
|
||
to determine the key to use. It will ask you to supply a key, if it can't find one.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.337. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This is the default key-pair to use for S/MIME operations, and must be
|
||
set to the keyid (the hash-value that OpenSSL generates) to work properly.
|
||
</p><p>
|
||
It will be used for encryption (see <a class="link" href="reference.html#postpone-encrypt" title="3.262. postpone_encrypt">$postpone_encrypt</a> and
|
||
<a class="link" href="reference.html#smime-self-encrypt" title="3.348. smime_self_encrypt">$smime_self_encrypt</a>). If GPGME is enabled, this is the key id displayed
|
||
by gpgsm.
|
||
</p><p>
|
||
It will be used for decryption unless <a class="link" href="reference.html#smime-decrypt-use-default-key" title="3.336. smime_decrypt_use_default_key">$smime_decrypt_use_default_key</a>
|
||
is <span class="emphasis"><em>unset</em></span>.
|
||
</p><p>
|
||
It will also be used for signing unless <a class="link" href="reference.html#smime-sign-as" title="3.349. smime_sign_as">$smime_sign_as</a> is set.
|
||
</p><p>
|
||
The (now deprecated) <span class="emphasis"><em>smime_self_encrypt_as</em></span> is an alias for this
|
||
variable, and should no longer be used.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.338. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to create encrypted S/MIME messages.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.339. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">aes256</code></span>”</span></p></div><p>
|
||
This sets the algorithm that should be used for encryption.
|
||
Valid choices are <span class="quote">“<span class="quote">aes128</span>”</span>, <span class="quote">“<span class="quote">aes192</span>”</span>, <span class="quote">“<span class="quote">aes256</span>”</span>, <span class="quote">“<span class="quote">des</span>”</span>, <span class="quote">“<span class="quote">des3</span>”</span>, <span class="quote">“<span class="quote">rc2-40</span>”</span>, <span class="quote">“<span class="quote">rc2-64</span>”</span>, <span class="quote">“<span class="quote">rc2-128</span>”</span>.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.340. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to extract X509 certificates from a PKCS7 structure.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.341. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to extract the mail address(es) used for storing
|
||
X509 certificates, and for verification purposes (to check whether the
|
||
certificate was issued for the sender's mailbox).
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.342. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to extract only the signers X509 certificate from a S/MIME
|
||
signature, so that the certificate's owner may get compared to the
|
||
email's <span class="quote">“<span class="quote">From:</span>”</span> field.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.343. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to import a certificate via smime_keys.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.344. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
The default behavior of mutt is to use PGP on all auto-sign/encryption
|
||
operations. To override and to use OpenSSL instead this must be <span class="emphasis"><em>set</em></span>.
|
||
However, this has no effect while replying, since mutt will automatically
|
||
select the same application that was used to sign/encrypt the original
|
||
message. (Note that this variable can be overridden by unsetting <a class="link" href="reference.html#crypt-autosmime" title="3.59. crypt_autosmime">$crypt_autosmime</a>.)
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.345. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
|
||
storage and retrieval of keys/certs by itself. This is very basic right now,
|
||
and stores keys and certificates in two different directories, both
|
||
named as the hash-value retrieved from OpenSSL. There is an index file
|
||
which contains mailbox-address keyid pair, and which can be manually
|
||
edited. This option points to the location of the private keys.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pkcs7-default-smime-type"></a>3.346. smime_pkcs7_default_smime_type</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">signed</code></span>”</span></p></div><p>
|
||
The application/pkcs7-mime <span class="quote">“<span class="quote">.p7m</span>”</span> type can contain EnvelopedData
|
||
(encrypted) or SignedData. Senders should add a <span class="quote">“<span class="quote">smime-type</span>”</span>
|
||
parameter to the content type, to help receiving MUAs correctly
|
||
handle the data. Unfortunately, some clients (e.g. Outlook)
|
||
don't add this parameter.
|
||
</p><p>
|
||
This option is used to determine which type to assume when the
|
||
<span class="quote">“<span class="quote">smime-type</span>”</span> parameter is missing for <span class="quote">“<span class="quote">.p7m</span>”</span> file types.
|
||
</p><p>
|
||
Accepted values are <span class="quote">“<span class="quote">enveloped</span>”</span> and <span class="quote">“<span class="quote">signed</span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.347. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to extract PKCS7 structures of S/MIME signatures,
|
||
in order to extract the public X509 certificate(s).
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-self-encrypt"></a>3.348. smime_self_encrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, S/MIME encrypted messages will also be encrypted
|
||
using the certificate in <a class="link" href="reference.html#smime-default-key" title="3.337. smime_default_key">$smime_default_key</a>.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-as"></a>3.349. smime_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
If you have a separate key to use for signing, you should set this
|
||
to the signing key. Most people will only need to set <a class="link" href="reference.html#smime-default-key" title="3.337. smime_default_key">$smime_default_key</a>.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.350. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to created S/MIME signatures of type
|
||
<code class="literal">multipart/signed</code>, which can be read by all mail clients.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences. NOTE: %c and %k will default
|
||
to <a class="link" href="reference.html#smime-sign-as" title="3.349. smime_sign_as">$smime_sign_as</a> if set, otherwise <a class="link" href="reference.html#smime-default-key" title="3.337. smime_default_key">$smime_default_key</a>.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-digest-alg"></a>3.351. smime_sign_digest_alg</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">sha256</code></span>”</span></p></div><p>
|
||
This sets the algorithm that should be used for the signature message digest.
|
||
Valid choices are <span class="quote">“<span class="quote">md5</span>”</span>, <span class="quote">“<span class="quote">sha1</span>”</span>, <span class="quote">“<span class="quote">sha224</span>”</span>, <span class="quote">“<span class="quote">sha256</span>”</span>, <span class="quote">“<span class="quote">sha384</span>”</span>, <span class="quote">“<span class="quote">sha512</span>”</span>.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.352. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to created S/MIME signatures of type
|
||
<code class="literal">application/x-pkcs7-signature</code>, which can only be handled by mail
|
||
clients supporting the S/MIME extension.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.353. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number (long)<br />
|
||
Default: 300</p></div><p>
|
||
The number of seconds after which a cached passphrase will expire if
|
||
not used.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.354. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to verify S/MIME signatures of type <code class="literal">multipart/signed</code>.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.355. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This command is used to verify S/MIME signatures of type
|
||
<code class="literal">application/x-pkcs7-mime</code>.
|
||
</p><p>
|
||
This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.335. smime_decrypt_command">$smime_decrypt_command</a> command for
|
||
possible <code class="literal">printf(3)</code>-like sequences.
|
||
(S/MIME only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.356. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
This is a colon-delimited list of authentication methods mutt may
|
||
attempt to use to log in to an SMTP server, in the order mutt should
|
||
try them. Authentication methods are any SASL mechanism, e.g.
|
||
<span class="quote">“<span class="quote">digest-md5</span>”</span>, <span class="quote">“<span class="quote">gssapi</span>”</span> or <span class="quote">“<span class="quote">cram-md5</span>”</span>.
|
||
This option is case-insensitive. If it is <span class="quote">“<span class="quote">unset</span>”</span>
|
||
(the default) mutt will try all available methods, in order from
|
||
most-secure to least-secure.
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set smtp_authenticators="digest-md5:cram-md5"
|
||
</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-oauth-refresh-command"></a>3.357. smtp_oauth_refresh_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
The command to run to generate an OAUTH refresh token for
|
||
authorizing your connection to your SMTP server. This command will be
|
||
run on every connection attempt that uses the OAUTHBEARER authentication
|
||
mechanism. See <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#oauth" title="6. OAUTHBEARER Support">oauth</a></span>”</span> for details.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-pass"></a>3.358. smtp_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Specifies the password for your SMTP account. If <span class="emphasis"><em>unset</em></span>, Mutt will
|
||
prompt you for your password when you first send mail via SMTP.
|
||
See <a class="link" href="reference.html#smtp-url" title="3.359. smtp_url">$smtp_url</a> to configure mutt to send mail via SMTP.
|
||
</p><p>
|
||
<span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a
|
||
fairly secure machine, because the superuser can read your muttrc even
|
||
if you are the only one who can read the file.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-url"></a>3.359. smtp_url</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Defines the SMTP smarthost where sent messages should relayed for
|
||
delivery. This should take the form of an SMTP URL, e.g.:
|
||
|
||
</p><pre class="screen">
|
||
smtp[s]://[user[:pass]@]host[:port]
|
||
</pre><p>
|
||
where <span class="quote">“<span class="quote">[...]</span>”</span> denotes an optional part.
|
||
Setting this variable overrides the value of the <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a>
|
||
variable.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#write-bcc" title="3.422. write_bcc">$write_bcc</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="socket-receive-timeout"></a>3.360. socket_receive_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
Causes Mutt to timeout any socket read operation (e.g. SSL_read) after
|
||
this many seconds. A zero (default) or negative value causes Mutt to wait
|
||
indefinitely for the read to complete.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="socket-send-timeout"></a>3.361. socket_send_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
Causes Mutt to timeout any socket write operation (e.g. SSL_write) after
|
||
this many seconds. A zero (default) or negative value causes Mutt to wait
|
||
indefinitely for the write to complete.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort"></a>3.362. sort</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: date</p></div><p>
|
||
Specifies how to sort messages in the <span class="quote">“<span class="quote">index</span>”</span> menu. Valid values
|
||
are:
|
||
|
||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>date or date-sent
|
||
</p></li><li class="listitem"><p>date-received
|
||
</p></li><li class="listitem"><p>from
|
||
</p></li><li class="listitem"><p>mailbox-order (unsorted)
|
||
</p></li><li class="listitem"><p>score
|
||
</p></li><li class="listitem"><p>size
|
||
</p></li><li class="listitem"><p>spam
|
||
</p></li><li class="listitem"><p>subject
|
||
</p></li><li class="listitem"><p>threads
|
||
</p></li><li class="listitem"><p>to
|
||
</p></li></ul></div><p>
|
||
You may optionally use the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix to specify reverse sorting
|
||
order (example: <span class="quote">“<span class="quote"><code class="literal">set sort=reverse-date-sent</code></span>”</span>).
|
||
</p><p>
|
||
For values except <span class="quote">“<span class="quote">threads</span>”</span>, this provides the primary sort
|
||
method. When two message sort values are equal, <a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a> will
|
||
be used for a secondary sort.
|
||
</p><p>
|
||
When set to <span class="quote">“<span class="quote">threads</span>”</span>, Mutt threads messages in the index. It
|
||
uses the variable <a class="link" href="reference.html#sort-thread-groups" title="3.368. sort_thread_groups">$sort_thread_groups</a> to sort between threads
|
||
(at the top/root level), and <a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a> to sort sub-threads and
|
||
children.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort-alias"></a>3.363. sort_alias</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: alias</p></div><p>
|
||
Specifies how the entries in the <span class="quote">“<span class="quote">alias</span>”</span> menu are sorted. The
|
||
following are legal values:
|
||
|
||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>address (sort alphabetically by email address)
|
||
</p></li><li class="listitem"><p>alias (sort alphabetically by alias name)
|
||
</p></li><li class="listitem"><p>unsorted (leave in order specified in .muttrc)
|
||
</p></li></ul></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort-aux"></a>3.364. sort_aux</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: date</p></div><p>
|
||
For non-threaded mode, this provides a secondary sort for
|
||
messages in the <span class="quote">“<span class="quote">index</span>”</span> menu, used when the <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a> value is
|
||
equal for two messages.
|
||
</p><p>
|
||
When sorting by threads, this variable controls how the branches
|
||
of the thread trees are sorted. This can be set to any value
|
||
that <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a> can, except <span class="quote">“<span class="quote">threads</span>”</span> (in that case, mutt will just
|
||
use <span class="quote">“<span class="quote">date-sent</span>”</span>). You can also specify the <span class="quote">“<span class="quote">last-</span>”</span> prefix in
|
||
addition to the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix, but <span class="quote">“<span class="quote">last-</span>”</span> must come
|
||
after <span class="quote">“<span class="quote">reverse-</span>”</span>. The <span class="quote">“<span class="quote">last-</span>”</span> prefix causes messages to be
|
||
sorted against its siblings by which has the last descendant,
|
||
using the rest of <a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a> as an ordering. For instance,
|
||
|
||
</p><pre class="screen">
|
||
set sort_aux=last-date-received
|
||
</pre><p>
|
||
would mean that if a new message is received in a sub-thread,
|
||
that sub-thread becomes the last one displayed.
|
||
</p><p>
|
||
Note: For reversed-threads <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a>
|
||
order, <a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a> is reversed again (which is not the right thing to do,
|
||
but kept to not break any existing configuration setting).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort-browser"></a>3.365. sort_browser</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: alpha</p></div><p>
|
||
Specifies how to sort entries in the file browser. By default, the
|
||
entries are sorted alphabetically. Valid values:
|
||
|
||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>alpha (alphabetically)
|
||
</p></li><li class="listitem"><p>count
|
||
</p></li><li class="listitem"><p>date
|
||
</p></li><li class="listitem"><p>size
|
||
</p></li><li class="listitem"><p>unread
|
||
</p></li><li class="listitem"><p>unsorted
|
||
</p></li></ul></div><p>
|
||
You may optionally use the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix to specify reverse sorting
|
||
order (example: <span class="quote">“<span class="quote"><code class="literal">set sort_browser=reverse-date</code></span>”</span>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort-browser-mailboxes"></a>3.366. sort_browser_mailboxes</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: unsorted</p></div><p>
|
||
Specifies how to sort entries in the mailbox browser. By default, the
|
||
entries are unsorted, displayed in the same order as listed
|
||
in the <span class="quote">“<span class="quote">mailboxes</span>”</span> command. Valid values:
|
||
|
||
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>alpha (alphabetically)
|
||
</p></li><li class="listitem"><p>count
|
||
</p></li><li class="listitem"><p>date
|
||
</p></li><li class="listitem"><p>size
|
||
</p></li><li class="listitem"><p>unread
|
||
</p></li><li class="listitem"><p>unsorted
|
||
</p></li></ul></div><p>
|
||
You may optionally use the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix to specify reverse sorting
|
||
order (example: <span class="quote">“<span class="quote"><code class="literal">set sort_browser_mailboxes=reverse-alpha</code></span>”</span>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.367. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
This variable is only useful when sorting by threads with
|
||
<a class="link" href="reference.html#strict-threads" title="3.391. strict_threads">$strict_threads</a> <span class="emphasis"><em>unset</em></span>. In that case, it changes the heuristic
|
||
mutt uses to thread messages by subject. With <a class="link" href="reference.html#sort-re" title="3.367. sort_re">$sort_re</a> <span class="emphasis"><em>set</em></span>, mutt will
|
||
only attach a message as the child of another message by subject if
|
||
the subject of the child message starts with a substring matching the
|
||
setting of <a class="link" href="reference.html#reply-regexp" title="3.283. reply_regexp">$reply_regexp</a>. With <a class="link" href="reference.html#sort-re" title="3.367. sort_re">$sort_re</a> <span class="emphasis"><em>unset</em></span>, mutt will attach
|
||
the message whether or not this is the case, as long as the
|
||
non-<a class="link" href="reference.html#reply-regexp" title="3.283. reply_regexp">$reply_regexp</a> parts of both messages are identical.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sort-thread-groups"></a>3.368. sort_thread_groups</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
|
||
Default: aux</p></div><p>
|
||
When sorting by threads, this variable controls how threads are
|
||
sorted in relation to other threads (at the top/root level).
|
||
This can be set to any value that <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a> can, except <span class="quote">“<span class="quote">threads</span>”</span>.
|
||
You can also specify the <span class="quote">“<span class="quote">last-</span>”</span> prefix in addition to the
|
||
<span class="quote">“<span class="quote">reverse-</span>”</span> prefix, but <span class="quote">“<span class="quote">last-</span>”</span> must come after <span class="quote">“<span class="quote">reverse-</span>”</span>.
|
||
The <span class="quote">“<span class="quote">last-</span>”</span> prefix causes messages to be sorted against its
|
||
siblings by which has the last descendant, using the rest of
|
||
<a class="link" href="reference.html#sort-thread-groups" title="3.368. sort_thread_groups">$sort_thread_groups</a> as an ordering.
|
||
</p><p>
|
||
For backward compatibility, the default value is <span class="quote">“<span class="quote">aux</span>”</span>, which
|
||
means to use <a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a> for top-level thread sorting too. The
|
||
value <span class="quote">“<span class="quote">aux</span>”</span> does not respect <span class="quote">“<span class="quote">last-</span>”</span> or <span class="quote">“<span class="quote">reverse-</span>”</span>
|
||
prefixes, it simply delegates sorting directly to <a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a>.
|
||
</p><p>
|
||
Note: For reversed-threads <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a> order, <a class="link" href="reference.html#sort-thread-groups" title="3.368. sort_thread_groups">$sort_thread_groups</a> is
|
||
reversed again (which is not the right thing to do, but kept to
|
||
not break any existing configuration setting).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.369. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">,</code></span>”</span></p></div><p>
|
||
This variable controls what happens when multiple spam headers
|
||
are matched: if <span class="emphasis"><em>unset</em></span>, each successive header will overwrite any
|
||
previous matches value for the spam label. If <span class="emphasis"><em>set</em></span>, each successive
|
||
match will append to the previous, using this variable's value as a
|
||
separator.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.370. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
If your default mailbox or spool file is in a non-default place where Mutt
|
||
cannot find it, you can specify its location with this variable. Mutt will
|
||
initially set this variable to the value of the environment
|
||
variable <code class="literal">$MAIL</code> or <code class="literal">$MAILDIR</code> if either is defined.
|
||
</p><p>
|
||
Note: Despite the name, this can refer to a local or remote mailbox, e.g.,
|
||
"+INBOX".
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.371. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable specifies a file containing trusted CA certificates.
|
||
Any server certificate that is signed with one of these CA
|
||
certificates is also automatically accepted. (GnuTLS only)
|
||
</p><p>
|
||
Example:
|
||
|
||
</p><pre class="screen">
|
||
set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
|
||
</pre></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.372. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
The file containing a client certificate and its associated private
|
||
key.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.373. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If this variable is <span class="emphasis"><em>set</em></span>, Mutt will require that all connections
|
||
to remote servers be encrypted. Furthermore it will attempt to
|
||
negotiate TLS even if the server does not advertise the capability,
|
||
since it would otherwise have to abort the connection anyway. This
|
||
option supersedes <a class="link" href="reference.html#ssl-starttls" title="3.375. ssl_starttls">$ssl_starttls</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.374. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
This variable specifies the minimum acceptable prime size (in bits)
|
||
for use in any Diffie-Hellman key exchange. A value of 0 will use
|
||
the default from the GNUTLS library. (GnuTLS only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.375. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> (the default), mutt will attempt to use <code class="literal">STARTTLS</code> on servers
|
||
advertising the capability. When <span class="emphasis"><em>unset</em></span>, mutt will not attempt to
|
||
use <code class="literal">STARTTLS</code> regardless of the server's capabilities.
|
||
</p><p>
|
||
<span class="bold"><strong>Note</strong></span> that <code class="literal">STARTTLS</code> is subject to many kinds of
|
||
attacks, including the ability of a machine-in-the-middle to
|
||
suppress the advertising of support. Setting <a class="link" href="reference.html#ssl-force-tls" title="3.373. ssl_force_tls">$ssl_force_tls</a> is
|
||
recommended if you rely on <code class="literal">STARTTLS</code>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.376. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> , Mutt will use SSLv2 when communicating with servers that
|
||
request it. <span class="bold"><strong>N.B. As of 2011, SSLv2 is considered insecure, and using
|
||
is inadvisable. See https://tools.ietf.org/html/rfc6176 .</strong></span>
|
||
(OpenSSL only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.377. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> , Mutt will use SSLv3 when communicating with servers that
|
||
request it. <span class="bold"><strong>N.B. As of 2015, SSLv3 is considered insecure, and using
|
||
it is inadvisable. See https://tools.ietf.org/html/rfc7525 .</strong></span>
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.378. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> , Mutt will use TLSv1.0 when communicating with servers that
|
||
request it. <span class="bold"><strong>N.B. As of 2015, TLSv1.0 is considered insecure, and using
|
||
it is inadvisable. See https://tools.ietf.org/html/rfc7525 .</strong></span>
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1-1"></a>3.379. ssl_use_tlsv1_1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> , Mutt will use TLSv1.1 when communicating with servers that
|
||
request it. <span class="bold"><strong>N.B. As of 2015, TLSv1.1 is considered insecure, and using
|
||
it is inadvisable. See https://tools.ietf.org/html/rfc7525 .</strong></span>
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1-2"></a>3.380. ssl_use_tlsv1_2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> , Mutt will use TLSv1.2 when communicating with servers that
|
||
request it.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1-3"></a>3.381. ssl_use_tlsv1_3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> , Mutt will use TLSv1.3 when communicating with servers that
|
||
request it.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.382. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the
|
||
system-wide certificate store when checking if a server certificate
|
||
is signed by a trusted CA. (OpenSSL only)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-dates"></a>3.383. ssl_verify_dates</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
|
||
certificate that is either not yet valid or already expired. You should
|
||
only unset this for particular known hosts, using the
|
||
<code class="literal"><a class="link" href="optionalfeatures.html#account-hook" title="7. Managing Multiple Accounts"><account-hook></a></code> function.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-host"></a>3.384. ssl_verify_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
|
||
certificate whose host name does not match the host used in your folder
|
||
URL. You should only unset this for particular known hosts, using
|
||
the <code class="literal"><a class="link" href="optionalfeatures.html#account-hook" title="7. Managing Multiple Accounts"><account-hook></a></code> function.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-host-override"></a>3.385. ssl_verify_host_override</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Defines an alternate host name to verify the server certificate against.
|
||
This should not be set unless you are sure what you are doing, but it
|
||
might be useful for connection to a .onion host without a properly
|
||
configured host name in the certificate. See <a class="link" href="reference.html#ssl-verify-host" title="3.384. ssl_verify_host">$ssl_verify_host</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-partial-chains"></a>3.386. ssl_verify_partial_chains</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
This option should not be changed from the default unless you understand
|
||
what you are doing.
|
||
</p><p>
|
||
Setting this variable to <span class="emphasis"><em>yes</em></span> will permit verifying partial
|
||
certification chains, i. e. a certificate chain where not the root,
|
||
but an intermediate certificate CA, or the host certificate, are
|
||
marked trusted (in <a class="link" href="reference.html#certificate-file" title="3.39. certificate_file">$certificate_file</a>), without marking the root
|
||
signing CA as trusted.
|
||
</p><p>
|
||
(OpenSSL 1.0.2b and newer only).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ciphers"></a>3.387. ssl_ciphers</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Contains a colon-separated list of ciphers to use when using SSL.
|
||
For OpenSSL, see ciphers(1) for the syntax of the string.
|
||
</p><p>
|
||
For GnuTLS, this option will be used in place of "NORMAL" at the
|
||
start of the priority string. See gnutls_priority_init(3) for the
|
||
syntax and more details. (Note: GnuTLS version 2.1.7 or higher is
|
||
required.)
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.388. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">-*%A</code></span>”</span></p></div><p>
|
||
Controls the characters used by the <span class="quote">“<span class="quote">%r</span>”</span> indicator in
|
||
<a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a>. The first character is used when the mailbox is
|
||
unchanged. The second is used when the mailbox has been changed, and
|
||
it needs to be resynchronized. The third is used if the mailbox is in
|
||
read-only mode, or if the mailbox will not be written when exiting
|
||
that mailbox (You can toggle whether to write changes to a mailbox
|
||
with the <code class="literal"><toggle-write></code> operation, bound by default to <span class="quote">“<span class="quote">%</span>”</span>). The fourth
|
||
is used to indicate that the current folder has been opened in attach-
|
||
message mode (Certain operations like composing a new mail, replying,
|
||
forwarding, etc. are not permitted in this mode).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="status-format"></a>3.389. status_format</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?B? Back:%B?%?l? %l?]---(%s/%?T?%T/?%S)-%>-(%P)---</code></span>”</span></p></div><p>
|
||
Controls the format of the status line displayed in the <span class="quote">“<span class="quote">index</span>”</span>
|
||
menu. This string is similar to <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a>, but has its own
|
||
set of <code class="literal">printf(3)</code>-like sequences:
|
||
|
||
</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%b </td><td>number of mailboxes with new mail *
|
||
</td></tr><tr><td>%B </td><td>number of backgrounded editing sessions *
|
||
</td></tr><tr><td>%d </td><td>number of deleted messages *
|
||
</td></tr><tr><td>%f </td><td>the full pathname of the current mailbox
|
||
</td></tr><tr><td>%F </td><td>number of flagged messages *
|
||
</td></tr><tr><td>%h </td><td>local hostname
|
||
</td></tr><tr><td>%l </td><td>size (in bytes) of the current mailbox (see <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>) *
|
||
</td></tr><tr><td>%L </td><td>size (in bytes) of the messages shown
|
||
(i.e., which match the current limit) (see <a class="link" href="configuration.html#formatstrings-size" title="32.5. Bytes size display">formatstrings-size</a>) *
|
||
</td></tr><tr><td>%m </td><td>the number of messages in the mailbox *
|
||
</td></tr><tr><td>%M </td><td>the number of messages shown (i.e., which match the current limit) *
|
||
</td></tr><tr><td>%n </td><td>number of new messages in the mailbox *
|
||
</td></tr><tr><td>%o </td><td>number of old unread messages *
|
||
</td></tr><tr><td>%p </td><td>number of postponed messages *
|
||
</td></tr><tr><td>%P </td><td>percentage of the way through the index
|
||
</td></tr><tr><td>%r </td><td>modified/read-only/won't-write/attach-message indicator,
|
||
according to <a class="link" href="reference.html#status-chars" title="3.388. status_chars">$status_chars</a>
|
||
</td></tr><tr><td>%R </td><td>number of read messages *
|
||
</td></tr><tr><td>%s </td><td>current sorting mode (<a class="link" href="reference.html#sort" title="3.362. sort">$sort</a>)
|
||
</td></tr><tr><td>%S </td><td>current aux sorting method (<a class="link" href="reference.html#sort-aux" title="3.364. sort_aux">$sort_aux</a>)
|
||
</td></tr><tr><td>%t </td><td>number of tagged messages *
|
||
</td></tr><tr><td>%T </td><td>current thread group sorting method (<a class="link" href="reference.html#sort-thread-groups" title="3.368. sort_thread_groups">$sort_thread_groups</a>) *
|
||
</td></tr><tr><td>%u </td><td>number of unread messages *
|
||
</td></tr><tr><td>%v </td><td>Mutt version string
|
||
</td></tr><tr><td>%V </td><td>currently active limit pattern, if any *
|
||
</td></tr><tr><td>%>X </td><td>right justify the rest of the string and pad with <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%|X </td><td>pad to the end of the line with <span class="quote">“<span class="quote">X</span>”</span>
|
||
</td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
|
||
</td></tr></tbody></table></div><p>
|
||
For an explanation of <span class="quote">“<span class="quote">soft-fill</span>”</span>, see the <a class="link" href="reference.html#index-format" title="3.161. index_format">$index_format</a> documentation.
|
||
</p><p>
|
||
* = can be optionally printed if nonzero
|
||
</p><p>
|
||
Some of the above sequences can be used to optionally print a string
|
||
if their value is nonzero. For example, you may only want to see the
|
||
number of flagged messages if such messages exist, since zero is not
|
||
particularly meaningful. To optionally print a string based upon one
|
||
of the above sequences, the following construct is used:
|
||
</p><p>
|
||
<code class="literal">%?<sequence_char>?<optional_string>?</code>
|
||
</p><p>
|
||
where <span class="emphasis"><em>sequence_char</em></span> is a character from the table above, and
|
||
<span class="emphasis"><em>optional_string</em></span> is the string you would like printed if
|
||
<span class="emphasis"><em>sequence_char</em></span> is nonzero. <span class="emphasis"><em>optional_string</em></span> <span class="bold"><strong>may</strong></span> contain
|
||
other sequences as well as normal text, but you may <span class="bold"><strong>not</strong></span> nest
|
||
optional strings.
|
||
</p><p>
|
||
Here is an example illustrating how to optionally print the number of
|
||
new messages in a mailbox:
|
||
</p><p>
|
||
<code class="literal">%?n?%n new messages.?</code>
|
||
</p><p>
|
||
You can also switch between two strings using the following construct:
|
||
</p><p>
|
||
<code class="literal">%?<sequence_char>?<if_string>&<else_string>?</code>
|
||
</p><p>
|
||
If the value of <span class="emphasis"><em>sequence_char</em></span> is non-zero, <span class="emphasis"><em>if_string</em></span> will
|
||
be expanded, otherwise <span class="emphasis"><em>else_string</em></span> will be expanded.
|
||
</p><p>
|
||
You can force the result of any <code class="literal">printf(3)</code>-like sequence to be lowercase
|
||
by prefixing the sequence character with an underscore (<span class="quote">“<span class="quote">_</span>”</span>) sign.
|
||
For example, if you want to display the local hostname in lowercase,
|
||
you would use: <span class="quote">“<span class="quote"><code class="literal">%_h</code></span>”</span>.
|
||
</p><p>
|
||
If you prefix the sequence character with a colon (<span class="quote">“<span class="quote">:</span>”</span>) character, mutt
|
||
will replace any dots in the expansion by underscores. This might be helpful
|
||
with IMAP folders that don't like dots in folder names.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="status-on-top"></a>3.390. status_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Setting this variable causes the <span class="quote">“<span class="quote">status bar</span>”</span> to be displayed on
|
||
the first line of the screen rather than near the bottom. If <a class="link" href="reference.html#help" title="3.117. help">$help</a>
|
||
is <span class="emphasis"><em>set</em></span>, too it'll be placed at the bottom.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="strict-threads"></a>3.391. strict_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
If <span class="emphasis"><em>set</em></span>, threading will only make use of the <span class="quote">“<span class="quote">In-Reply-To</span>”</span> and
|
||
<span class="quote">“<span class="quote">References:</span>”</span> fields when you <a class="link" href="reference.html#sort" title="3.362. sort">$sort</a> by message threads. By
|
||
default, messages with the same subject are grouped together in
|
||
<span class="quote">“<span class="quote">pseudo threads.</span>”</span>. This may not always be desirable, such as in a
|
||
personal mailbox where you might have several unrelated messages with
|
||
the subjects like <span class="quote">“<span class="quote">hi</span>”</span> which will get grouped together. See also
|
||
<a class="link" href="reference.html#sort-re" title="3.367. sort_re">$sort_re</a> for a less drastic way of controlling this
|
||
behavior.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="suspend"></a>3.392. suspend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>unset</em></span>, mutt won't stop when the user presses the terminal's
|
||
<span class="emphasis"><em>susp</em></span> key, usually <span class="quote">“<span class="quote">^Z</span>”</span>. This is useful if you run mutt
|
||
inside an xterm using a command like <span class="quote">“<span class="quote"><code class="literal">xterm -e mutt</code></span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="text-flowed"></a>3.393. text_flowed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will generate <span class="quote">“<span class="quote">format=flowed</span>”</span> bodies with a content type
|
||
of <span class="quote">“<span class="quote"><code class="literal">text/plain; format=flowed</code></span>”</span>.
|
||
This format is easier to handle for some mailing software, and generally
|
||
just looks like ordinary text. To actually make use of this format's
|
||
features, you'll need support in your editor.
|
||
</p><p>
|
||
The option only controls newly composed messages. Postponed messages,
|
||
resent messages, and draft messages (via -H on the command line) will
|
||
use the content-type of the source message.
|
||
</p><p>
|
||
Note that <a class="link" href="reference.html#indent-string" title="3.160. indent_string">$indent_string</a> is ignored when this option is <span class="emphasis"><em>set</em></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="thorough-search"></a>3.394. thorough_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Affects the <code class="literal">~b</code>, <code class="literal">~B</code>, and <code class="literal">~h</code> search operations described in
|
||
section <span class="quote">“<span class="quote"><a class="link" href="advancedusage.html#patterns" title="3. Patterns: Searching, Limiting and Tagging">patterns</a></span>”</span>. If <span class="emphasis"><em>set</em></span>, the headers and body/attachments of
|
||
messages to be searched are decoded before searching. If <span class="emphasis"><em>unset</em></span>,
|
||
messages are searched as they appear in the folder.
|
||
</p><p>
|
||
Users searching attachments or for non-ASCII characters should <span class="emphasis"><em>set</em></span>
|
||
this value because decoding also includes MIME parsing/decoding and possible
|
||
character set conversions. Otherwise mutt will attempt to match against the
|
||
raw message received (for example quoted-printable encoded or with encoded
|
||
headers) which may lead to incorrect search results.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="thread-received"></a>3.395. thread_received</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt uses the date received rather than the date sent
|
||
to thread messages by subject.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="tilde"></a>3.396. tilde</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, the internal-pager will pad blank lines to the bottom of the
|
||
screen with a tilde (<span class="quote">“<span class="quote">~</span>”</span>).
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="time-inc"></a>3.397. time_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
Along with <a class="link" href="reference.html#read-inc" title="3.275. read_inc">$read_inc</a>, <a class="link" href="reference.html#write-inc" title="3.423. write_inc">$write_inc</a>, and <a class="link" href="reference.html#net-inc" title="3.203. net_inc">$net_inc</a>, this
|
||
variable controls the frequency with which progress updates are
|
||
displayed. It suppresses updates less than <a class="link" href="reference.html#time-inc" title="3.397. time_inc">$time_inc</a> milliseconds
|
||
apart. This can improve throughput on systems with slow terminals,
|
||
or when running mutt on a remote system.
|
||
</p><p>
|
||
Also see the <span class="quote">“<span class="quote"><a class="link" href="tuning.html" title="Chapter 8. Performance Tuning">tuning</a></span>”</span> section of the manual for performance considerations.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="timeout"></a>3.398. timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 600</p></div><p>
|
||
When Mutt is waiting for user input either idling in menus or
|
||
in an interactive prompt, Mutt would block until input is
|
||
present. Depending on the context, this would prevent certain
|
||
operations from working, like checking for new mail or keeping
|
||
an IMAP connection alive.
|
||
</p><p>
|
||
This variable controls how many seconds Mutt will at most wait
|
||
until it aborts waiting for input, performs these operations and
|
||
continues to wait for input.
|
||
</p><p>
|
||
A value of zero or less will cause Mutt to never time out.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="tmpdir"></a>3.399. tmpdir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
This variable allows you to specify where Mutt will place its
|
||
temporary files needed for displaying and composing messages. If
|
||
this variable is not set, the environment variable <code class="literal">$TMPDIR</code> is
|
||
used. If <code class="literal">$TMPDIR</code> is not set then <span class="quote">“<span class="quote"><code class="literal">/tmp</code></span>”</span> is used.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="to-chars"></a>3.400. to_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal"> +TCFL</code></span>”</span></p></div><p>
|
||
Controls the character used to indicate mail addressed to you. The
|
||
first character is the one used when the mail is <span class="emphasis"><em>not</em></span> addressed to your
|
||
address. The second is used when you are the only
|
||
recipient of the message. The third is when your address
|
||
appears in the <span class="quote">“<span class="quote">To:</span>”</span> header field, but you are not the only recipient of
|
||
the message. The fourth character is used when your
|
||
address is specified in the <span class="quote">“<span class="quote">Cc:</span>”</span> header field, but you are not the only
|
||
recipient. The fifth character is used to indicate mail that was sent
|
||
by <span class="emphasis"><em>you</em></span>. The sixth character is used to indicate when a mail
|
||
was sent to a mailing-list you subscribe to.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="trash"></a>3.401. trash</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
If set, this variable specifies the path of the trash folder where the
|
||
mails marked for deletion will be moved, instead of being irremediably
|
||
purged.
|
||
</p><p>
|
||
NOTE: When you delete a message in the trash folder, it is really
|
||
deleted, so that you have a way to clean the trash.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ts-icon-format"></a>3.402. ts_icon_format</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">M%?n?AIL&ail?</code></span>”</span></p></div><p>
|
||
Controls the format of the icon title, as long as <span class="quote">“<span class="quote"><a class="link" href="reference.html#ts-enabled" title="3.403. ts_enabled">$ts_enabled</a></span>”</span> is set.
|
||
This string is identical in formatting to the one used by
|
||
<span class="quote">“<span class="quote"><a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a></span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ts-enabled"></a>3.403. ts_enabled</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether mutt tries to set the terminal status line and icon name.
|
||
Most terminal emulators emulate the status line in the window title.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="ts-status-format"></a>3.404. ts_status_format</h3></div></div></div><div class="literallayout"><p>Type: string (localized)<br />
|
||
Default: <span class="quote">“<span class="quote"><code class="literal">Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?</code></span>”</span></p></div><p>
|
||
Controls the format of the terminal status line (or window title),
|
||
provided that <span class="quote">“<span class="quote"><a class="link" href="reference.html#ts-enabled" title="3.403. ts_enabled">$ts_enabled</a></span>”</span> has been set. This string is identical in
|
||
formatting to the one used by <span class="quote">“<span class="quote"><a class="link" href="reference.html#status-format" title="3.389. status_format">$status_format</a></span>”</span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="tunnel"></a>3.405. tunnel</h3></div></div></div><div class="literallayout"><p>Type: string<br />
|
||
Default: (empty)</p></div><p>
|
||
Setting this variable will cause mutt to open a pipe to a command
|
||
instead of a raw socket. You may be able to use this to set up
|
||
preauthenticated connections to your IMAP/POP3/SMTP server. Example:
|
||
|
||
</p><pre class="screen">
|
||
set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
|
||
</pre><p>
|
||
Note: For this example to work you must be able to log in to the remote
|
||
machine without having to enter a password.
|
||
</p><p>
|
||
When set, Mutt uses the tunnel for all remote connections.
|
||
Please see <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#account-hook" title="7. Managing Multiple Accounts">account-hook</a></span>”</span> in the manual for how to use different
|
||
tunnel commands per connection.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="tunnel-is-secure"></a>3.406. tunnel_is_secure</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will assume the <a class="link" href="reference.html#tunnel" title="3.405. tunnel">$tunnel</a> connection does not need
|
||
STARTTLS to be enabled. It will also allow IMAP PREAUTH server
|
||
responses inside a <a class="link" href="reference.html#tunnel" title="3.405. tunnel">tunnel</a> to proceed. This is appropriate if <a class="link" href="reference.html#tunnel" title="3.405. tunnel">$tunnel</a>
|
||
uses ssh or directly invokes the server locally.
|
||
</p><p>
|
||
When <span class="emphasis"><em>unset</em></span>, Mutt will negotiate STARTTLS according to the
|
||
<a class="link" href="reference.html#ssl-starttls" title="3.375. ssl_starttls">ssl_starttls</a> and <a class="link" href="reference.html#ssl-force-tls" title="3.373. ssl_force_tls">ssl_force_tls</a> variables. If <a class="link" href="reference.html#ssl-force-tls" title="3.373. ssl_force_tls">ssl_force_tls</a> is
|
||
set, Mutt will abort connecting if an IMAP server responds with PREAUTH.
|
||
This setting is appropriate if <a class="link" href="reference.html#tunnel" title="3.405. tunnel">$tunnel</a> does not provide security and
|
||
could be tampered with by attackers.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-jump"></a>3.407. uncollapse_jump</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will jump to the next unread message, if any,
|
||
when the current thread is <span class="emphasis"><em>un</em></span>collapsed.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-new"></a>3.408. uncollapse_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will automatically uncollapse any collapsed
|
||
thread that receives a newly delivered message. When
|
||
<span class="emphasis"><em>unset</em></span>, collapsed threads will remain collapsed. The
|
||
presence of the newly delivered message will still affect index
|
||
sorting, though.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.409. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
<span class="bold"><strong>Warning:</strong></span> do not set this variable unless you are using a version
|
||
of sendmail which supports the <code class="literal">-B8BITMIME</code> flag (such as sendmail
|
||
8.8.x) or you may not be able to send mail.
|
||
</p><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will invoke <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a> with the <code class="literal">-B8BITMIME</code>
|
||
flag when sending 8-bit messages to enable ESMTP negotiation.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.410. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will qualify all local addresses (ones without the
|
||
<span class="quote">“<span class="quote">@host</span>”</span> portion) with the value of <a class="link" href="reference.html#hostname" title="3.129. hostname">$hostname</a>. If <span class="emphasis"><em>unset</em></span>, no
|
||
addresses will be qualified.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.411. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will set the <span class="emphasis"><em>envelope</em></span> sender of the message.
|
||
If <a class="link" href="reference.html#envelope-from-address" title="3.88. envelope_from_address">$envelope_from_address</a> is <span class="emphasis"><em>set</em></span>, it will be used as the sender
|
||
address. If <span class="emphasis"><em>unset</em></span>, mutt will attempt to derive the sender from the
|
||
<span class="quote">“<span class="quote">From:</span>”</span> header.
|
||
</p><p>
|
||
Note that this information is passed to sendmail command using the
|
||
<code class="literal">-f</code> command line switch. Therefore setting this option is not useful
|
||
if the <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a> variable already contains <code class="literal">-f</code> or if the
|
||
executable pointed to by <a class="link" href="reference.html#sendmail" title="3.305. sendmail">$sendmail</a> doesn't support the <code class="literal">-f</code> switch.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.412. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will generate the <span class="quote">“<span class="quote">From:</span>”</span> header field when
|
||
sending messages. If <span class="emphasis"><em>unset</em></span>, no <span class="quote">“<span class="quote">From:</span>”</span> header field will be
|
||
generated unless the user explicitly sets one using the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#my-hdr" title="17. User-Defined Headers">my_hdr</a></span>”</span>
|
||
command.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.413. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, Mutt will look for IPv6 addresses of hosts it tries to
|
||
contact. If this option is <span class="emphasis"><em>unset</em></span>, Mutt will restrict itself to IPv4 addresses.
|
||
Normally, the default should work.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.414. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will add a <span class="quote">“<span class="quote">User-Agent:</span>”</span> header to outgoing
|
||
messages, indicating which version of mutt was used for composing
|
||
them.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.415. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />
|
||
Default: (empty)</p></div><p>
|
||
Specifies the visual editor to invoke when the <span class="quote">“<span class="quote"><code class="literal">~v</code></span>”</span> command is
|
||
given in the built-in editor.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.416. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls whether Mutt will ask you to press a key after an external command
|
||
has been invoked by these functions: <code class="literal"><shell-escape></code>,
|
||
<code class="literal"><pipe-message></code>, <code class="literal"><pipe-entry></code>, <code class="literal"><print-message></code>,
|
||
and <code class="literal"><print-entry></code> commands.
|
||
</p><p>
|
||
It is also used when viewing attachments with <span class="quote">“<span class="quote"><a class="link" href="mimesupport.html#auto-view" title="4. MIME Autoview">auto_view</a></span>”</span>, provided
|
||
that the corresponding mailcap entry has a <span class="emphasis"><em>needsterminal</em></span> flag,
|
||
and the external program is interactive.
|
||
</p><p>
|
||
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
|
||
for a key only if the external command returned a non-zero status.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="weed"></a>3.417. weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
When <span class="emphasis"><em>set</em></span>, mutt will weed headers when displaying, forwarding,
|
||
or replying to messages.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#copy-decode-weed" title="3.53. copy_decode_weed">$copy_decode_weed</a>, <a class="link" href="reference.html#pipe-decode-weed" title="3.246. pipe_decode_weed">$pipe_decode_weed</a>, <a class="link" href="reference.html#print-decode-weed" title="3.268. print_decode_weed">$print_decode_weed</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="wrap"></a>3.418. wrap</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
When set to a positive value, mutt will wrap text at <a class="link" href="reference.html#wrap" title="3.418. wrap">$wrap</a> characters.
|
||
When set to a negative value, mutt will wrap text so that there are <a class="link" href="reference.html#wrap" title="3.418. wrap">$wrap</a>
|
||
characters of empty space on the right side of the terminal. Setting it
|
||
to zero makes mutt wrap at the terminal width.
|
||
</p><p>
|
||
Also see <a class="link" href="reference.html#reflow-wrap" title="3.282. reflow_wrap">$reflow_wrap</a>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-headers"></a>3.419. wrap_headers</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 78</p></div><p>
|
||
This option specifies the number of characters to use for wrapping
|
||
an outgoing message's headers. Allowed values are between 78 and 998
|
||
inclusive.
|
||
</p><p>
|
||
<span class="bold"><strong>Note:</strong></span> This option usually shouldn't be changed. RFC5233
|
||
recommends a line length of 78 (the default), so <span class="bold"><strong>please only change
|
||
this setting when you know what you're doing</strong></span>.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-search"></a>3.420. wrap_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: yes</p></div><p>
|
||
Controls whether searches wrap around the end.
|
||
</p><p>
|
||
When <span class="emphasis"><em>set</em></span>, searches will wrap around the first (or last) item. When
|
||
<span class="emphasis"><em>unset</em></span>, incremental searches will not wrap.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="wrapmargin"></a>3.421. wrapmargin</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 0</p></div><p>
|
||
(DEPRECATED) Equivalent to setting <a class="link" href="reference.html#wrap" title="3.418. wrap">$wrap</a> with a negative value.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="write-bcc"></a>3.422. write_bcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
|
||
Default: no</p></div><p>
|
||
Controls whether mutt writes out the <span class="quote">“<span class="quote">Bcc:</span>”</span> header when
|
||
preparing messages to be sent. Some MTAs, such as Exim and
|
||
Courier, do not strip the <span class="quote">“<span class="quote">Bcc:</span>”</span> header; so it is advisable to
|
||
leave this unset unless you have a particular need for the header
|
||
to be in the sent message.
|
||
</p><p>
|
||
If mutt is set to deliver directly via SMTP (see <a class="link" href="reference.html#smtp-url" title="3.359. smtp_url">$smtp_url</a>),
|
||
this option does nothing: mutt will never write out the <span class="quote">“<span class="quote">Bcc:</span>”</span>
|
||
header in this case.
|
||
</p><p>
|
||
Note this option only affects the sending of messages. Fcc'ed
|
||
copies of a message will always contain the <span class="quote">“<span class="quote">Bcc:</span>”</span> header if
|
||
one exists.
|
||
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="write-inc"></a>3.423. write_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
|
||
Default: 10</p></div><p>
|
||
When writing a mailbox, a message will be printed every
|
||
<a class="link" href="reference.html#write-inc" title="3.423. write_inc">$write_inc</a> messages to indicate progress. If set to 0, only a
|
||
single message will be displayed before writing a mailbox.
|
||
</p><p>
|
||
Also see the <a class="link" href="reference.html#read-inc" title="3.275. read_inc">$read_inc</a>, <a class="link" href="reference.html#net-inc" title="3.203. net_inc">$net_inc</a> and <a class="link" href="reference.html#time-inc" title="3.397. time_inc">$time_inc</a> variables and the
|
||
<span class="quote">“<span class="quote"><a class="link" href="tuning.html" title="Chapter 8. Performance Tuning">tuning</a></span>”</span> section of the manual for performance considerations.
|
||
</p></div></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="functions"></a>4. Functions</h2></div></div></div><p>
|
||
The following is the list of available functions listed by the mapping
|
||
in which they are available. The default key setting is given, and an
|
||
explanation of what the function does. The key bindings of these
|
||
functions can be changed with the <a class="link" href="configuration.html#bind" title="6. Changing the Default Key Bindings">bind</a>
|
||
command.
|
||
</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="generic-map"></a>4.1. Generic Menu</h3></div></div></div><p>
|
||
The <span class="emphasis"><em>generic</em></span> menu is not a real menu, but specifies common functions
|
||
(such as movement) available in all menus except for <span class="emphasis"><em>pager</em></span> and
|
||
<span class="emphasis"><em>editor</em></span>. Changing settings for this menu will affect the default
|
||
bindings for all menus (except as noted).
|
||
</p><div class="table"><a id="tab-generic-bindings"></a><p class="title"><strong>Table 9.2. Default Generic Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Generic Menu 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"><bottom-page></code></td><td>L</td><td>move to the bottom of the page</td></tr><tr><td><code class="literal"><check-stats></code></td><td> </td><td>calculate message statistics for all mailboxes</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"><current-middle></code></td><td> </td><td>move entry to middle of screen</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"><end-cond></code></td><td> </td><td>end of conditional execution (noop)</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"><error-history></code></td><td> </td><td>display recent history of error messages</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><first-entry></code></td><td><Home></td><td>move to the first 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"><half-down></code></td><td>]</td><td>scroll down 1/2 page</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"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><jump></code></td><td>1</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>2</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>3</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>4</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>5</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>6</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>7</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>8</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>9</td><td>jump to an index number</td></tr><tr><td><code class="literal"><last-entry></code></td><td><End></td><td>move to the last entry</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"><middle-page></code></td><td>M</td><td>move to the middle of the page</td></tr><tr><td><code class="literal"><next-entry></code></td><td><Down></td><td>move to the next entry</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"><next-line></code></td><td>></td><td>scroll down one line</td></tr><tr><td><code class="literal"><next-page></code></td><td><Pagedown></td><td>move to the next page</td></tr><tr><td><code class="literal"><next-page></code></td><td><Right></td><td>move to the next page</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-entry></code></td><td><Up></td><td>move to the previous 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"><previous-line></code></td><td><</td><td>scroll up one line</td></tr><tr><td><code class="literal"><previous-page></code></td><td><Left></td><td>move to the previous page</td></tr><tr><td><code class="literal"><previous-page></code></td><td><Pageup></td><td>move to the previous 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"><refresh></code></td><td>^L</td><td>clear and redraw the screen</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-next></code></td><td>n</td><td>search for next match</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"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><select-entry></code></td><td><Enter></td><td>select the current entry</td></tr><tr><td><code class="literal"><select-entry></code></td><td><Keypadenter></td><td>select the current entry</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"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</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"><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"><top-page></code></td><td>H</td><td>move to the top of the page</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"><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="tab-index-bindings"></a><p class="title"><strong>Table 9.3. Default Index Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Index Menu 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"><autocrypt-acct-menu></code></td><td>A</td><td>manage autocrypt accounts</td></tr><tr><td><code class="literal"><background-compose-menu></code></td><td>B</td><td>list and select backgrounded compose sessions</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"><browse-mailboxes></code></td><td>y</td><td>select a new mailbox from the browser</td></tr><tr><td><code class="literal"><browse-mailboxes-readonly></code></td><td> </td><td>select a new mailbox from the browser in read only mode</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"><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"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</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"><collapse-all></code></td><td>Esc V</td><td>collapse/uncollapse all threads</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"><compose-to-sender></code></td><td> </td><td>compose new message to the current message sender</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"><create-alias></code></td><td>a</td><td>create an alias from a message sender</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"><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"><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-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</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"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><display-message></code></td><td><Enter></td><td>display a message</td></tr><tr><td><code class="literal"><display-message></code></td><td><Keypadenter></td><td>display 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"><display-message></code></td><td><Space></td><td>display a message</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></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-label></code></td><td>Y</td><td>add, change, or delete a message's label</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"><exit></code></td><td>x</td><td>exit this menu</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"><fetch-mail></code></td><td>G</td><td>retrieve mail from POP server</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"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</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"><group-chat-reply></code></td><td> </td><td>reply to all recipients preserving To/Cc</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"><imap-logout-all></code></td><td> </td><td>logout from all IMAP servers</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-action></code></td><td>Esc L</td><td>perform mailing list action</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"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><mark-message></code></td><td>~</td><td>create a hotkey macro for the current 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"><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"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</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-undeleted></code></td><td><Down></td><td>move to the next undeleted message</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-unread></code></td><td> </td><td>jump to the next unread message</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"><parent-message></code></td><td>P</td><td>jump to parent message in thread</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"><previous-entry></code></td><td>K</td><td>move to the previous entry</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"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</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-undeleted></code></td><td><Up></td><td>move to the previous 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"><previous-unread></code></td><td> </td><td>jump to the previous unread message</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"><purge-message></code></td><td> </td><td>delete the current entry, bypassing the trash folder</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"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</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"><recall-message></code></td><td>R</td><td>recall a postponed message</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"><root-message></code></td><td> </td><td>jump to root message in thread</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"><set-flag></code></td><td>w</td><td>set a status flag on 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"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><sidebar-first></code></td><td> </td><td>move the highlight to the first mailbox</td></tr><tr><td><code class="literal"><sidebar-last></code></td><td> </td><td>move the highlight to the last mailbox</td></tr><tr><td><code class="literal"><sidebar-next></code></td><td> </td><td>move the highlight to next mailbox</td></tr><tr><td><code class="literal"><sidebar-next-new></code></td><td> </td><td>move the highlight to next mailbox with new mail</td></tr><tr><td><code class="literal"><sidebar-open></code></td><td> </td><td>open highlighted mailbox</td></tr><tr><td><code class="literal"><sidebar-page-down></code></td><td> </td><td>scroll the sidebar down 1 page</td></tr><tr><td><code class="literal"><sidebar-page-up></code></td><td> </td><td>scroll the sidebar up 1 page</td></tr><tr><td><code class="literal"><sidebar-prev></code></td><td> </td><td>move the highlight to previous mailbox</td></tr><tr><td><code class="literal"><sidebar-prev-new></code></td><td> </td><td>move the highlight to previous mailbox with new mail</td></tr><tr><td><code class="literal"><sidebar-toggle-visible></code></td><td> </td><td>make the sidebar (in)visible</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"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</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"><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"><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"><untag-pattern></code></td><td>^T</td><td>untag messages matching a pattern</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><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="tab-pager-bindings"></a><p class="title"><strong>Table 9.4. Default Pager Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Pager Menu 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"><background-compose-menu></code></td><td>B</td><td>list and select backgrounded compose sessions</td></tr><tr><td><code class="literal"><bottom></code></td><td><End></td><td>jump to the bottom of the message</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"><browse-mailboxes></code></td><td>y</td><td>select a new mailbox from the browser</td></tr><tr><td><code class="literal"><browse-mailboxes-readonly></code></td><td> </td><td>select a new mailbox from the browser in read only mode</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"><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"><check-stats></code></td><td> </td><td>calculate message statistics for all mailboxes</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"><clear-flag></code></td><td>W</td><td>clear a status flag from a message</td></tr><tr><td><code class="literal"><compose-to-sender></code></td><td> </td><td>compose new message to the current message sender</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"><create-alias></code></td><td>a</td><td>create an alias from a message sender</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"><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"><delete-message></code></td><td>d</td><td>delete the current entry</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"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</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"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</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-label></code></td><td>Y</td><td>add, change, or delete a message's label</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"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><error-history></code></td><td> </td><td>display recent history of error messages</td></tr><tr><td><code class="literal"><exit></code></td><td>i</td><td>exit this menu</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><exit></code></td><td>x</td><td>exit this menu</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"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</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"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><group-chat-reply></code></td><td> </td><td>reply to all recipients preserving To/Cc</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"><half-down></code></td><td> </td><td>scroll down 1/2 page</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"><help></code></td><td>?</td><td>this screen</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"><imap-logout-all></code></td><td> </td><td>logout from all IMAP servers</td></tr><tr><td><code class="literal"><jump></code></td><td>1</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>2</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>3</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>4</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>5</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>6</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>7</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>8</td><td>jump to an index number</td></tr><tr><td><code class="literal"><jump></code></td><td>9</td><td>jump to an index number</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-action></code></td><td>Esc L</td><td>perform mailing list action</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"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</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"><next-entry></code></td><td>J</td><td>move to the next entry</td></tr><tr><td><code class="literal"><next-line></code></td><td><Enter></td><td>scroll down one line</td></tr><tr><td><code class="literal"><next-line></code></td><td><Keypadenter></td><td>scroll down one line</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"><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"><next-page></code></td><td><Pagedown></td><td>move to the next page</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"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</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-undeleted></code></td><td><Down></td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td><Right></td><td>move to the next undeleted message</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-unread></code></td><td> </td><td>jump to the next unread message</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"><parent-message></code></td><td>P</td><td>jump to parent message in thread</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"><previous-entry></code></td><td>K</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><previous-line></code></td><td><Backspace></td><td>scroll up one line</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> </td><td>jump to the previous new or unread message</td></tr><tr><td><code class="literal"><previous-page></code></td><td><Pageup></td><td>move to the previous 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"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</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-undeleted></code></td><td><Left></td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td><Up></td><td>move to the previous 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"><previous-unread></code></td><td> </td><td>jump to the previous unread message</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"><purge-message></code></td><td> </td><td>delete the current entry, bypassing the trash folder</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"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</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"><recall-message></code></td><td>R</td><td>recall a postponed message</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"><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"><root-message></code></td><td> </td><td>jump to root message in thread</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"><search></code></td><td>/</td><td>search for a regular expression</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"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</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-toggle></code></td><td>\\</td><td>toggle search pattern coloring</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"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</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"><sidebar-first></code></td><td> </td><td>move the highlight to the first mailbox</td></tr><tr><td><code class="literal"><sidebar-last></code></td><td> </td><td>move the highlight to the last mailbox</td></tr><tr><td><code class="literal"><sidebar-next></code></td><td> </td><td>move the highlight to next mailbox</td></tr><tr><td><code class="literal"><sidebar-next-new></code></td><td> </td><td>move the highlight to next mailbox with new mail</td></tr><tr><td><code class="literal"><sidebar-open></code></td><td> </td><td>open highlighted mailbox</td></tr><tr><td><code class="literal"><sidebar-page-down></code></td><td> </td><td>scroll the sidebar down 1 page</td></tr><tr><td><code class="literal"><sidebar-page-up></code></td><td> </td><td>scroll the sidebar up 1 page</td></tr><tr><td><code class="literal"><sidebar-prev></code></td><td> </td><td>move the highlight to previous mailbox</td></tr><tr><td><code class="literal"><sidebar-prev-new></code></td><td> </td><td>move the highlight to previous mailbox with new mail</td></tr><tr><td><code class="literal"><sidebar-toggle-visible></code></td><td> </td><td>make the sidebar (in)visible</td></tr><tr><td><code class="literal"><skip-headers></code></td><td>H</td><td>skip beyond headers</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"><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"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</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"><toggle-write></code></td><td>%</td><td>toggle whether the mailbox will be rewritten</td></tr><tr><td><code class="literal"><top></code></td><td><Home></td><td>jump to the top of the message</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"><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"><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"><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="tab-alias-bindings"></a><p class="title"><strong>Table 9.5. Default Alias Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Alias Menu 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"><tag-entry></code></td><td><Space></td><td>tag 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"><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="tab-query-bindings"></a><p class="title"><strong>Table 9.6. Default Query Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Query Menu 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"><div class="titlepage"><div><div><h3 class="title"><a id="attachment-map"></a>4.6. Attachment Menu</h3></div></div></div><div class="table"><a id="tab-attachment-bindings"></a><p class="title"><strong>Table 9.7. Default Attachment Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Attachment Menu 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"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</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"><compose-to-sender></code></td><td> </td><td>compose new message to the current message sender</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"><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"><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"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><group-chat-reply></code></td><td> </td><td>reply to all recipients preserving To/Cc</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"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</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"><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"><save-entry></code></td><td>s</td><td>save message/attachment to a mailbox/file</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"><view-attach></code></td><td><Enter></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Keypadenter></td><td>view attachment using mailcap entry if necessary</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"><view-mailcap></code></td><td>m</td><td>force viewing of attachment using mailcap</td></tr><tr><td><code class="literal"><view-pager></code></td><td> </td><td>view attachment in pager using copiousoutput mailcap entry</td></tr><tr><td><code class="literal"><view-text></code></td><td>T</td><td>view attachment as text</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><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="tab-compose-bindings"></a><p class="title"><strong>Table 9.8. Default Compose Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Compose Menu 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-key></code></td><td>Esc k</td><td>attach a PGP public key</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"><autocrypt-menu></code></td><td>o</td><td>show autocrypt compose menu options</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"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</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"><edit-description></code></td><td>d</td><td>edit attachment description</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-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"><edit-file></code></td><td>^X e</td><td>edit the file to be attached</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-headers></code></td><td>E</td><td>edit the message with headers</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-mime></code></td><td>m</td><td>edit attachment using mailcap entry</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"><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"><filter-entry></code></td><td>F</td><td>filter attachment through a shell command</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"><get-attachment></code></td><td>G</td><td>get a temporary copy of an attachment</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"><mix></code></td><td>M</td><td>send the message through a mixmaster remailer chain</td></tr><tr><td><code class="literal"><move-down></code></td><td> </td><td>move attachment down in compose menu list</td></tr><tr><td><code class="literal"><move-up></code></td><td> </td><td>move attachment up in compose menu list</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"><pgp-menu></code></td><td>p</td><td>show PGP options</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"><postpone-message></code></td><td>P</td><td>save this message to send later</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"><rename-attachment></code></td><td>^O</td><td>send attachment with a different name</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"><send-message></code></td><td>y</td><td>send the message</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"><tag-entry></code></td><td>T</td><td>tag 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"><toggle-recode></code></td><td> </td><td>toggle recoding of this attachment</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"><update-encoding></code></td><td>U</td><td>update an attachment's encoding info</td></tr><tr><td><code class="literal"><view-alt></code></td><td>v</td><td>view multipart/alternative</td></tr><tr><td><code class="literal"><view-alt-mailcap></code></td><td>V</td><td>view multipart/alternative using mailcap</td></tr><tr><td><code class="literal"><view-alt-pager></code></td><td> </td><td>view multipart/alternative in pager using copiousoutput mailcap entry</td></tr><tr><td><code class="literal"><view-alt-text></code></td><td>Esc v</td><td>view multipart/alternative as text</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Enter></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Keypadenter></td><td>view attachment using mailcap entry if necessary</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"><view-mailcap></code></td><td> </td><td>force viewing of attachment using mailcap</td></tr><tr><td><code class="literal"><view-pager></code></td><td> </td><td>view attachment in pager using copiousoutput mailcap entry</td></tr><tr><td><code class="literal"><view-text></code></td><td> </td><td>view attachment as text</td></tr><tr><td><code class="literal"><write-fcc></code></td><td>w</td><td>write the message to a folder</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><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="tab-postpone-bindings"></a><p class="title"><strong>Table 9.9. Default Postpone Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Postpone Menu 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"><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="tab-browser-bindings"></a><p class="title"><strong>Table 9.10. Default Browser Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Browser Menu 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"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><change-dir></code></td><td>c</td><td>change directories</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"><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"><descend-directory></code></td><td> </td><td>descend into a directory</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"><rename-mailbox></code></td><td>r</td><td>rename the current mailbox (IMAP only)</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"><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"><subscribe></code></td><td>s</td><td>subscribe to current mailbox (IMAP only)</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"><toggle-subscribed></code></td><td>T</td><td>toggle view all/subscribed mailboxes (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"><view-file></code></td><td><Space></td><td>view file</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><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="tab-pgp-bindings"></a><p class="title"><strong>Table 9.11. Default Pgp Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Pgp Menu 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"><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="tab-smime-bindings"></a><p class="title"><strong>Table 9.12. Default Smime Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Smime Menu 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"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster-map"></a>4.12. Mixmaster Menu</h3></div></div></div><div class="table"><a id="tab-mixmaster-bindings"></a><p class="title"><strong>Table 9.13. Default Mixmaster Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Mixmaster Menu 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><Enter></td><td>accept the chain constructed</td></tr><tr><td><code class="literal"><accept></code></td><td><Keypadenter></td><td>accept the chain constructed</td></tr><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"><chain-next></code></td><td><Right></td><td>select the next element of the chain</td></tr><tr><td><code class="literal"><chain-next></code></td><td>l</td><td>select the next element of 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-prev></code></td><td>h</td><td>select the previous element of 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"><insert></code></td><td>i</td><td>insert a remailer into the chain</td></tr><tr><td><code class="literal"><select-entry></code></td><td><Space></td><td>select the current entry</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><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="tab-editor-bindings"></a><p class="title"><strong>Table 9.14. Default Editor Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Editor Menu 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"><backspace></code></td><td><Backspace></td><td>delete the char in front of the cursor</td></tr><tr><td><code class="literal"><backspace></code></td><td><Delete></td><td>delete the char in front of the cursor</td></tr><tr><td><code class="literal"><backward-char></code></td><td><Left></td><td>move the cursor one character to the left</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"><bol></code></td><td><Home></td><td>jump to the beginning of the line</td></tr><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"><buffy-cycle></code></td><td><Space></td><td>cycle among incoming mailboxes</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"><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"><delete-char></code></td><td>^D</td><td>delete the char under the cursor</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"><eol></code></td><td><End></td><td>jump to the end of the line</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><Right></td><td>move the cursor one character to the right</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"><history-down></code></td><td><Down></td><td>scroll down through the history list</td></tr><tr><td><code class="literal"><history-down></code></td><td>^N</td><td>scroll down through the history list</td></tr><tr><td><code class="literal"><history-search></code></td><td>^R</td><td>search through the history list</td></tr><tr><td><code class="literal"><history-up></code></td><td><Up></td><td>scroll up through the history list</td></tr><tr><td><code class="literal"><history-up></code></td><td>^P</td><td>scroll up through the history list</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"><kill-word></code></td><td>^W</td><td>delete the word in front of the cursor</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"><transpose-chars></code></td><td> </td><td>transpose character under cursor with previous</td></tr><tr><td><code class="literal"><upcase-word></code></td><td>Esc u</td><td>convert the word to upper case</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="autocrypt-account-map"></a>4.14. Autocrypt Account Menu</h3></div></div></div><div class="table"><a id="tab-autocrypt-account-bindings"></a><p class="title"><strong>Table 9.15. Default Autocrypt Account Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default Autocrypt Account Menu 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-account></code></td><td>c</td><td>create a new autocrypt account</td></tr><tr><td><code class="literal"><delete-account></code></td><td>D</td><td>delete the current account</td></tr><tr><td><code class="literal"><toggle-active></code></td><td>a</td><td>toggle the current account active/inactive</td></tr><tr><td><code class="literal"><toggle-prefer-encrypt></code></td><td>p</td><td>toggle the current account prefer-encrypt flag</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="list-map"></a>4.15. List Menu</h3></div></div></div><div class="table"><a id="tab-list-bindings"></a><p class="title"><strong>Table 9.16. Default List Menu Bindings</strong></p><div class="table-contents"><table class="table" summary="Default List Menu 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"><list-archive></code></td><td>a</td><td>retrieve list archive information</td></tr><tr><td><code class="literal"><list-help></code></td><td>h</td><td>retrieve list help</td></tr><tr><td><code class="literal"><list-owner></code></td><td>o</td><td>contact list owner</td></tr><tr><td><code class="literal"><list-post></code></td><td>p</td><td>post to mailing list</td></tr><tr><td><code class="literal"><list-subscribe></code></td><td>s</td><td>subscribe to mailing list</td></tr><tr><td><code class="literal"><list-unsubscribe></code></td><td>u</td><td>unsubscribe from mailing list</td></tr></tbody></table></div></div><br class="table-break" /></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="tuning.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="miscellany.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 8. Performance Tuning </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 10. Miscellany</td></tr></table></div></body></html> |