1 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <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 V1.75.2" /><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">
4 body { margin-left:2%; margin-right:2%; font-family:serif; }
5 .toc, .list-of-tables, .list-of-examples { font-family:sans-serif; }
6 h1, h2, h3, h4, h5, h6 { font-family:sans-serif; }
7 p { text-align:justify; }
8 div.table p.title, div.example p.title { font-size:smaller; font-family:sans-serif; }
9 .email, .email a { font-family:monospace; }
10 div.table-contents table, div.informaltable table { border-collapse:collapse; border:1px solid #c0c0c0; }
11 div.table-contents table td, div.informaltable td, div.table-contents table th, div.informaltable table th { padding:5px; text-align:left; }
12 div.table-contents table th, div.informaltable table th {
13 font-family:sans-serif;
18 div.cmdsynopsis { border-left:1px solid #707070; padding-left:5px; }
19 li div.cmdsynopsis { border-left:none; padding-left:0px; }
20 pre.screen, div.note { background:#f0f0f0; border:1px solid #c0c0c0; padding:5px; margin-left:2%; margin-right:2%; }
21 div.example p.title { margin-left:2%; }
22 div.note h3 { font-size:small; font-style:italic; font-variant: small-caps; }
23 div.note h3:after { content: ":" }
24 div.note { margin-bottom: 5px; }
25 .command { font-family: monospace; font-weight: normal; }
26 .command strong { font-weight: normal; }
27 tr { vertical-align: top; }
28 .comment { color:#707070; }
30 </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" title="Chapter 9. Reference"><div class="titlepage"><div><div><h2 class="title"><a id="reference"></a>Chapter 9. Reference</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><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><dd><dl><dt><span class="sect2"><a href="reference.html#abort-nosubject">3.1. abort_nosubject</a></span></dt><dt><span class="sect2"><a href="reference.html#abort-unmodified">3.2. abort_unmodified</a></span></dt><dt><span class="sect2"><a href="reference.html#alias-file">3.3. alias_file</a></span></dt><dt><span class="sect2"><a href="reference.html#alias-format">3.4. alias_format</a></span></dt><dt><span class="sect2"><a href="reference.html#allow-8bit">3.5. allow_8bit</a></span></dt><dt><span class="sect2"><a href="reference.html#allow-ansi">3.6. allow_ansi</a></span></dt><dt><span class="sect2"><a href="reference.html#arrow-cursor">3.7. arrow_cursor</a></span></dt><dt><span class="sect2"><a href="reference.html#ascii-chars">3.8. ascii_chars</a></span></dt><dt><span class="sect2"><a href="reference.html#askbcc">3.9. askbcc</a></span></dt><dt><span class="sect2"><a href="reference.html#askcc">3.10. askcc</a></span></dt><dt><span class="sect2"><a href="reference.html#assumed-charset">3.11. assumed_charset</a></span></dt><dt><span class="sect2"><a href="reference.html#attach-charset">3.12. attach_charset</a></span></dt><dt><span class="sect2"><a href="reference.html#attach-format">3.13. attach_format</a></span></dt><dt><span class="sect2"><a href="reference.html#attach-sep">3.14. attach_sep</a></span></dt><dt><span class="sect2"><a href="reference.html#attach-split">3.15. attach_split</a></span></dt><dt><span class="sect2"><a href="reference.html#attribution">3.16. attribution</a></span></dt><dt><span class="sect2"><a href="reference.html#auto-tag">3.17. auto_tag</a></span></dt><dt><span class="sect2"><a href="reference.html#autoedit">3.18. autoedit</a></span></dt><dt><span class="sect2"><a href="reference.html#beep">3.19. beep</a></span></dt><dt><span class="sect2"><a href="reference.html#beep-new">3.20. beep_new</a></span></dt><dt><span class="sect2"><a href="reference.html#bounce">3.21. bounce</a></span></dt><dt><span class="sect2"><a href="reference.html#bounce-delivered">3.22. bounce_delivered</a></span></dt><dt><span class="sect2"><a href="reference.html#braille-friendly">3.23. braille_friendly</a></span></dt><dt><span class="sect2"><a href="reference.html#certificate-file">3.24. certificate_file</a></span></dt><dt><span class="sect2"><a href="reference.html#charset">3.25. charset</a></span></dt><dt><span class="sect2"><a href="reference.html#check-mbox-size">3.26. check_mbox_size</a></span></dt><dt><span class="sect2"><a href="reference.html#check-new">3.27. check_new</a></span></dt><dt><span class="sect2"><a href="reference.html#collapse-unread">3.28. collapse_unread</a></span></dt><dt><span class="sect2"><a href="reference.html#compose-format">3.29. compose_format</a></span></dt><dt><span class="sect2"><a href="reference.html#config-charset">3.30. config_charset</a></span></dt><dt><span class="sect2"><a href="reference.html#confirmappend">3.31. confirmappend</a></span></dt><dt><span class="sect2"><a href="reference.html#confirmcreate">3.32. confirmcreate</a></span></dt><dt><span class="sect2"><a href="reference.html#connect-timeout">3.33. connect_timeout</a></span></dt><dt><span class="sect2"><a href="reference.html#content-type">3.34. content_type</a></span></dt><dt><span class="sect2"><a href="reference.html#copy">3.35. copy</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-autoencrypt">3.36. crypt_autoencrypt</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-autopgp">3.37. crypt_autopgp</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-autosign">3.38. crypt_autosign</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-autosmime">3.39. crypt_autosmime</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-replyencrypt">3.40. crypt_replyencrypt</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-replysign">3.41. crypt_replysign</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-replysignencrypted">3.42. crypt_replysignencrypted</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-timestamp">3.43. crypt_timestamp</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-use-gpgme">3.44. crypt_use_gpgme</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-use-pka">3.45. crypt_use_pka</a></span></dt><dt><span class="sect2"><a href="reference.html#crypt-verify-sig">3.46. crypt_verify_sig</a></span></dt><dt><span class="sect2"><a href="reference.html#date-format">3.47. date_format</a></span></dt><dt><span class="sect2"><a href="reference.html#default-hook">3.48. default_hook</a></span></dt><dt><span class="sect2"><a href="reference.html#delete">3.49. delete</a></span></dt><dt><span class="sect2"><a href="reference.html#delete-untag">3.50. delete_untag</a></span></dt><dt><span class="sect2"><a href="reference.html#digest-collapse">3.51. digest_collapse</a></span></dt><dt><span class="sect2"><a href="reference.html#display-filter">3.52. display_filter</a></span></dt><dt><span class="sect2"><a href="reference.html#dotlock-program">3.53. dotlock_program</a></span></dt><dt><span class="sect2"><a href="reference.html#dsn-notify">3.54. dsn_notify</a></span></dt><dt><span class="sect2"><a href="reference.html#dsn-return">3.55. dsn_return</a></span></dt><dt><span class="sect2"><a href="reference.html#duplicate-threads">3.56. duplicate_threads</a></span></dt><dt><span class="sect2"><a href="reference.html#edit-headers">3.57. edit_headers</a></span></dt><dt><span class="sect2"><a href="reference.html#editor">3.58. editor</a></span></dt><dt><span class="sect2"><a href="reference.html#encode-from">3.59. encode_from</a></span></dt><dt><span class="sect2"><a href="reference.html#entropy-file">3.60. entropy_file</a></span></dt><dt><span class="sect2"><a href="reference.html#envelope-from-address">3.61. envelope_from_address</a></span></dt><dt><span class="sect2"><a href="reference.html#escape">3.62. escape</a></span></dt><dt><span class="sect2"><a href="reference.html#fast-reply">3.63. fast_reply</a></span></dt><dt><span class="sect2"><a href="reference.html#fcc-attach">3.64. fcc_attach</a></span></dt><dt><span class="sect2"><a href="reference.html#fcc-clear">3.65. fcc_clear</a></span></dt><dt><span class="sect2"><a href="reference.html#folder">3.66. folder</a></span></dt><dt><span class="sect2"><a href="reference.html#folder-format">3.67. folder_format</a></span></dt><dt><span class="sect2"><a href="reference.html#followup-to">3.68. followup_to</a></span></dt><dt><span class="sect2"><a href="reference.html#force-name">3.69. force_name</a></span></dt><dt><span class="sect2"><a href="reference.html#forward-decode">3.70. forward_decode</a></span></dt><dt><span class="sect2"><a href="reference.html#forward-decrypt">3.71. forward_decrypt</a></span></dt><dt><span class="sect2"><a href="reference.html#forward-edit">3.72. forward_edit</a></span></dt><dt><span class="sect2"><a href="reference.html#forward-format">3.73. forward_format</a></span></dt><dt><span class="sect2"><a href="reference.html#forward-quote">3.74. forward_quote</a></span></dt><dt><span class="sect2"><a href="reference.html#from">3.75. from</a></span></dt><dt><span class="sect2"><a href="reference.html#gecos-mask">3.76. gecos_mask</a></span></dt><dt><span class="sect2"><a href="reference.html#hdrs">3.77. hdrs</a></span></dt><dt><span class="sect2"><a href="reference.html#header">3.78. header</a></span></dt><dt><span class="sect2"><a href="reference.html#header-cache">3.79. header_cache</a></span></dt><dt><span class="sect2"><a href="reference.html#header-cache-compress">3.80. header_cache_compress</a></span></dt><dt><span class="sect2"><a href="reference.html#header-cache-pagesize">3.81. header_cache_pagesize</a></span></dt><dt><span class="sect2"><a href="reference.html#help">3.82. help</a></span></dt><dt><span class="sect2"><a href="reference.html#hidden-host">3.83. hidden_host</a></span></dt><dt><span class="sect2"><a href="reference.html#hide-limited">3.84. hide_limited</a></span></dt><dt><span class="sect2"><a href="reference.html#hide-missing">3.85. hide_missing</a></span></dt><dt><span class="sect2"><a href="reference.html#hide-thread-subject">3.86. hide_thread_subject</a></span></dt><dt><span class="sect2"><a href="reference.html#hide-top-limited">3.87. hide_top_limited</a></span></dt><dt><span class="sect2"><a href="reference.html#hide-top-missing">3.88. hide_top_missing</a></span></dt><dt><span class="sect2"><a href="reference.html#history">3.89. history</a></span></dt><dt><span class="sect2"><a href="reference.html#history-file">3.90. history_file</a></span></dt><dt><span class="sect2"><a href="reference.html#honor-disposition">3.91. honor_disposition</a></span></dt><dt><span class="sect2"><a href="reference.html#honor-followup-to">3.92. honor_followup_to</a></span></dt><dt><span class="sect2"><a href="reference.html#hostname">3.93. hostname</a></span></dt><dt><span class="sect2"><a href="reference.html#ignore-linear-white-space">3.94. ignore_linear_white_space</a></span></dt><dt><span class="sect2"><a href="reference.html#ignore-list-reply-to">3.95. ignore_list_reply_to</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-authenticators">3.96. imap_authenticators</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-check-subscribed">3.97. imap_check_subscribed</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-delim-chars">3.98. imap_delim_chars</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-headers">3.99. imap_headers</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-idle">3.100. imap_idle</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-keepalive">3.101. imap_keepalive</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-list-subscribed">3.102. imap_list_subscribed</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-login">3.103. imap_login</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-pass">3.104. imap_pass</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-passive">3.105. imap_passive</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-peek">3.106. imap_peek</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-pipeline-depth">3.107. imap_pipeline_depth</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-servernoise">3.108. imap_servernoise</a></span></dt><dt><span class="sect2"><a href="reference.html#imap-user">3.109. imap_user</a></span></dt><dt><span class="sect2"><a href="reference.html#implicit-autoview">3.110. implicit_autoview</a></span></dt><dt><span class="sect2"><a href="reference.html#include">3.111. include</a></span></dt><dt><span class="sect2"><a href="reference.html#include-onlyfirst">3.112. include_onlyfirst</a></span></dt><dt><span class="sect2"><a href="reference.html#indent-string">3.113. indent_string</a></span></dt><dt><span class="sect2"><a href="reference.html#index-format">3.114. index_format</a></span></dt><dt><span class="sect2"><a href="reference.html#ispell">3.115. ispell</a></span></dt><dt><span class="sect2"><a href="reference.html#keep-flagged">3.116. keep_flagged</a></span></dt><dt><span class="sect2"><a href="reference.html#locale">3.117. locale</a></span></dt><dt><span class="sect2"><a href="reference.html#mail-check">3.118. mail_check</a></span></dt><dt><span class="sect2"><a href="reference.html#mail-check-recent">3.119. mail_check_recent</a></span></dt><dt><span class="sect2"><a href="reference.html#mailcap-path">3.120. mailcap_path</a></span></dt><dt><span class="sect2"><a href="reference.html#mailcap-sanitize">3.121. mailcap_sanitize</a></span></dt><dt><span class="sect2"><a href="reference.html#maildir-header-cache-verify">3.122. maildir_header_cache_verify</a></span></dt><dt><span class="sect2"><a href="reference.html#maildir-trash">3.123. maildir_trash</a></span></dt><dt><span class="sect2"><a href="reference.html#mark-old">3.124. mark_old</a></span></dt><dt><span class="sect2"><a href="reference.html#markers">3.125. markers</a></span></dt><dt><span class="sect2"><a href="reference.html#mask">3.126. mask</a></span></dt><dt><span class="sect2"><a href="reference.html#mbox">3.127. mbox</a></span></dt><dt><span class="sect2"><a href="reference.html#mbox-type">3.128. mbox_type</a></span></dt><dt><span class="sect2"><a href="reference.html#menu-context">3.129. menu_context</a></span></dt><dt><span class="sect2"><a href="reference.html#menu-move-off">3.130. menu_move_off</a></span></dt><dt><span class="sect2"><a href="reference.html#menu-scroll">3.131. menu_scroll</a></span></dt><dt><span class="sect2"><a href="reference.html#message-cache-clean">3.132. message_cache_clean</a></span></dt><dt><span class="sect2"><a href="reference.html#message-cachedir">3.133. message_cachedir</a></span></dt><dt><span class="sect2"><a href="reference.html#message-format">3.134. message_format</a></span></dt><dt><span class="sect2"><a href="reference.html#meta-key">3.135. meta_key</a></span></dt><dt><span class="sect2"><a href="reference.html#metoo">3.136. metoo</a></span></dt><dt><span class="sect2"><a href="reference.html#mh-purge">3.137. mh_purge</a></span></dt><dt><span class="sect2"><a href="reference.html#mh-seq-flagged">3.138. mh_seq_flagged</a></span></dt><dt><span class="sect2"><a href="reference.html#mh-seq-replied">3.139. mh_seq_replied</a></span></dt><dt><span class="sect2"><a href="reference.html#mh-seq-unseen">3.140. mh_seq_unseen</a></span></dt><dt><span class="sect2"><a href="reference.html#mime-forward">3.141. mime_forward</a></span></dt><dt><span class="sect2"><a href="reference.html#mime-forward-decode">3.142. mime_forward_decode</a></span></dt><dt><span class="sect2"><a href="reference.html#mime-forward-rest">3.143. mime_forward_rest</a></span></dt><dt><span class="sect2"><a href="reference.html#mix-entry-format">3.144. mix_entry_format</a></span></dt><dt><span class="sect2"><a href="reference.html#mixmaster">3.145. mixmaster</a></span></dt><dt><span class="sect2"><a href="reference.html#move">3.146. move</a></span></dt><dt><span class="sect2"><a href="reference.html#narrow-tree">3.147. narrow_tree</a></span></dt><dt><span class="sect2"><a href="reference.html#net-inc">3.148. net_inc</a></span></dt><dt><span class="sect2"><a href="reference.html#pager">3.149. pager</a></span></dt><dt><span class="sect2"><a href="reference.html#pager-context">3.150. pager_context</a></span></dt><dt><span class="sect2"><a href="reference.html#pager-format">3.151. pager_format</a></span></dt><dt><span class="sect2"><a href="reference.html#pager-index-lines">3.152. pager_index_lines</a></span></dt><dt><span class="sect2"><a href="reference.html#pager-stop">3.153. pager_stop</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-auto-decode">3.154. pgp_auto_decode</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-autoinline">3.155. pgp_autoinline</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-check-exit">3.156. pgp_check_exit</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-clearsign-command">3.157. pgp_clearsign_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-decode-command">3.158. pgp_decode_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-decrypt-command">3.159. pgp_decrypt_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-encrypt-only-command">3.160. pgp_encrypt_only_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-encrypt-sign-command">3.161. pgp_encrypt_sign_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-entry-format">3.162. pgp_entry_format</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-export-command">3.163. pgp_export_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-getkeys-command">3.164. pgp_getkeys_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-good-sign">3.165. pgp_good_sign</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-ignore-subkeys">3.166. pgp_ignore_subkeys</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-import-command">3.167. pgp_import_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-list-pubring-command">3.168. pgp_list_pubring_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-list-secring-command">3.169. pgp_list_secring_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-long-ids">3.170. pgp_long_ids</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-mime-auto">3.171. pgp_mime_auto</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-replyinline">3.172. pgp_replyinline</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-retainable-sigs">3.173. pgp_retainable_sigs</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-show-unusable">3.174. pgp_show_unusable</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-sign-as">3.175. pgp_sign_as</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-sign-command">3.176. pgp_sign_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-sort-keys">3.177. pgp_sort_keys</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-strict-enc">3.178. pgp_strict_enc</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-timeout">3.179. pgp_timeout</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-use-gpg-agent">3.180. pgp_use_gpg_agent</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-verify-command">3.181. pgp_verify_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pgp-verify-key-command">3.182. pgp_verify_key_command</a></span></dt><dt><span class="sect2"><a href="reference.html#pipe-decode">3.183. pipe_decode</a></span></dt><dt><span class="sect2"><a href="reference.html#pipe-sep">3.184. pipe_sep</a></span></dt><dt><span class="sect2"><a href="reference.html#pipe-split">3.185. pipe_split</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-auth-try-all">3.186. pop_auth_try_all</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-authenticators">3.187. pop_authenticators</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-checkinterval">3.188. pop_checkinterval</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-delete">3.189. pop_delete</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-host">3.190. pop_host</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-last">3.191. pop_last</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-pass">3.192. pop_pass</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-reconnect">3.193. pop_reconnect</a></span></dt><dt><span class="sect2"><a href="reference.html#pop-user">3.194. pop_user</a></span></dt><dt><span class="sect2"><a href="reference.html#post-indent-string">3.195. post_indent_string</a></span></dt><dt><span class="sect2"><a href="reference.html#postpone">3.196. postpone</a></span></dt><dt><span class="sect2"><a href="reference.html#postponed">3.197. postponed</a></span></dt><dt><span class="sect2"><a href="reference.html#preconnect">3.198. preconnect</a></span></dt><dt><span class="sect2"><a href="reference.html#print">3.199. print</a></span></dt><dt><span class="sect2"><a href="reference.html#print-command">3.200. print_command</a></span></dt><dt><span class="sect2"><a href="reference.html#print-decode">3.201. print_decode</a></span></dt><dt><span class="sect2"><a href="reference.html#print-split">3.202. print_split</a></span></dt><dt><span class="sect2"><a href="reference.html#prompt-after">3.203. prompt_after</a></span></dt><dt><span class="sect2"><a href="reference.html#query-command">3.204. query_command</a></span></dt><dt><span class="sect2"><a href="reference.html#query-format">3.205. query_format</a></span></dt><dt><span class="sect2"><a href="reference.html#quit">3.206. quit</a></span></dt><dt><span class="sect2"><a href="reference.html#quote-regexp">3.207. quote_regexp</a></span></dt><dt><span class="sect2"><a href="reference.html#read-inc">3.208. read_inc</a></span></dt><dt><span class="sect2"><a href="reference.html#read-only">3.209. read_only</a></span></dt><dt><span class="sect2"><a href="reference.html#realname">3.210. realname</a></span></dt><dt><span class="sect2"><a href="reference.html#recall">3.211. recall</a></span></dt><dt><span class="sect2"><a href="reference.html#record">3.212. record</a></span></dt><dt><span class="sect2"><a href="reference.html#reply-regexp">3.213. reply_regexp</a></span></dt><dt><span class="sect2"><a href="reference.html#reply-self">3.214. reply_self</a></span></dt><dt><span class="sect2"><a href="reference.html#reply-to">3.215. reply_to</a></span></dt><dt><span class="sect2"><a href="reference.html#resolve">3.216. resolve</a></span></dt><dt><span class="sect2"><a href="reference.html#reverse-alias">3.217. reverse_alias</a></span></dt><dt><span class="sect2"><a href="reference.html#reverse-name">3.218. reverse_name</a></span></dt><dt><span class="sect2"><a href="reference.html#reverse-realname">3.219. reverse_realname</a></span></dt><dt><span class="sect2"><a href="reference.html#rfc2047-parameters">3.220. rfc2047_parameters</a></span></dt><dt><span class="sect2"><a href="reference.html#save-address">3.221. save_address</a></span></dt><dt><span class="sect2"><a href="reference.html#save-empty">3.222. save_empty</a></span></dt><dt><span class="sect2"><a href="reference.html#save-history">3.223. save_history</a></span></dt><dt><span class="sect2"><a href="reference.html#save-name">3.224. save_name</a></span></dt><dt><span class="sect2"><a href="reference.html#score">3.225. score</a></span></dt><dt><span class="sect2"><a href="reference.html#score-threshold-delete">3.226. score_threshold_delete</a></span></dt><dt><span class="sect2"><a href="reference.html#score-threshold-flag">3.227. score_threshold_flag</a></span></dt><dt><span class="sect2"><a href="reference.html#score-threshold-read">3.228. score_threshold_read</a></span></dt><dt><span class="sect2"><a href="reference.html#search-context">3.229. search_context</a></span></dt><dt><span class="sect2"><a href="reference.html#send-charset">3.230. send_charset</a></span></dt><dt><span class="sect2"><a href="reference.html#sendmail">3.231. sendmail</a></span></dt><dt><span class="sect2"><a href="reference.html#sendmail-wait">3.232. sendmail_wait</a></span></dt><dt><span class="sect2"><a href="reference.html#shell">3.233. shell</a></span></dt><dt><span class="sect2"><a href="reference.html#sig-dashes">3.234. sig_dashes</a></span></dt><dt><span class="sect2"><a href="reference.html#sig-on-top">3.235. sig_on_top</a></span></dt><dt><span class="sect2"><a href="reference.html#signature">3.236. signature</a></span></dt><dt><span class="sect2"><a href="reference.html#simple-search">3.237. simple_search</a></span></dt><dt><span class="sect2"><a href="reference.html#sleep-time">3.238. sleep_time</a></span></dt><dt><span class="sect2"><a href="reference.html#smart-wrap">3.239. smart_wrap</a></span></dt><dt><span class="sect2"><a href="reference.html#smileys">3.240. smileys</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-ask-cert-label">3.241. smime_ask_cert_label</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-ca-location">3.242. smime_ca_location</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-certificates">3.243. smime_certificates</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-decrypt-command">3.244. smime_decrypt_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-decrypt-use-default-key">3.245. smime_decrypt_use_default_key</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-default-key">3.246. smime_default_key</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-encrypt-command">3.247. smime_encrypt_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-encrypt-with">3.248. smime_encrypt_with</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-get-cert-command">3.249. smime_get_cert_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-get-cert-email-command">3.250. smime_get_cert_email_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-get-signer-cert-command">3.251. smime_get_signer_cert_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-import-cert-command">3.252. smime_import_cert_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-is-default">3.253. smime_is_default</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-keys">3.254. smime_keys</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-pk7out-command">3.255. smime_pk7out_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-sign-command">3.256. smime_sign_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-sign-opaque-command">3.257. smime_sign_opaque_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-timeout">3.258. smime_timeout</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-verify-command">3.259. smime_verify_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smime-verify-opaque-command">3.260. smime_verify_opaque_command</a></span></dt><dt><span class="sect2"><a href="reference.html#smtp-authenticators">3.261. smtp_authenticators</a></span></dt><dt><span class="sect2"><a href="reference.html#smtp-pass">3.262. smtp_pass</a></span></dt><dt><span class="sect2"><a href="reference.html#smtp-url">3.263. smtp_url</a></span></dt><dt><span class="sect2"><a href="reference.html#sort">3.264. sort</a></span></dt><dt><span class="sect2"><a href="reference.html#sort-alias">3.265. sort_alias</a></span></dt><dt><span class="sect2"><a href="reference.html#sort-aux">3.266. sort_aux</a></span></dt><dt><span class="sect2"><a href="reference.html#sort-browser">3.267. sort_browser</a></span></dt><dt><span class="sect2"><a href="reference.html#sort-re">3.268. sort_re</a></span></dt><dt><span class="sect2"><a href="reference.html#spam-separator">3.269. spam_separator</a></span></dt><dt><span class="sect2"><a href="reference.html#spoolfile">3.270. spoolfile</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-ca-certificates-file">3.271. ssl_ca_certificates_file</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-client-cert">3.272. ssl_client_cert</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-force-tls">3.273. ssl_force_tls</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-min-dh-prime-bits">3.274. ssl_min_dh_prime_bits</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-starttls">3.275. ssl_starttls</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-use-sslv2">3.276. ssl_use_sslv2</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-use-sslv3">3.277. ssl_use_sslv3</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-use-tlsv1">3.278. ssl_use_tlsv1</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-usesystemcerts">3.279. ssl_usesystemcerts</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-verify-dates">3.280. ssl_verify_dates</a></span></dt><dt><span class="sect2"><a href="reference.html#ssl-verify-host">3.281. ssl_verify_host</a></span></dt><dt><span class="sect2"><a href="reference.html#status-chars">3.282. status_chars</a></span></dt><dt><span class="sect2"><a href="reference.html#status-format">3.283. status_format</a></span></dt><dt><span class="sect2"><a href="reference.html#status-on-top">3.284. status_on_top</a></span></dt><dt><span class="sect2"><a href="reference.html#strict-threads">3.285. strict_threads</a></span></dt><dt><span class="sect2"><a href="reference.html#suspend">3.286. suspend</a></span></dt><dt><span class="sect2"><a href="reference.html#text-flowed">3.287. text_flowed</a></span></dt><dt><span class="sect2"><a href="reference.html#thorough-search">3.288. thorough_search</a></span></dt><dt><span class="sect2"><a href="reference.html#thread-received">3.289. thread_received</a></span></dt><dt><span class="sect2"><a href="reference.html#tilde">3.290. tilde</a></span></dt><dt><span class="sect2"><a href="reference.html#time-inc">3.291. time_inc</a></span></dt><dt><span class="sect2"><a href="reference.html#timeout">3.292. timeout</a></span></dt><dt><span class="sect2"><a href="reference.html#tmpdir">3.293. tmpdir</a></span></dt><dt><span class="sect2"><a href="reference.html#to-chars">3.294. to_chars</a></span></dt><dt><span class="sect2"><a href="reference.html#tunnel">3.295. tunnel</a></span></dt><dt><span class="sect2"><a href="reference.html#uncollapse-jump">3.296. uncollapse_jump</a></span></dt><dt><span class="sect2"><a href="reference.html#use-8bitmime">3.297. use_8bitmime</a></span></dt><dt><span class="sect2"><a href="reference.html#use-domain">3.298. use_domain</a></span></dt><dt><span class="sect2"><a href="reference.html#use-envelope-from">3.299. use_envelope_from</a></span></dt><dt><span class="sect2"><a href="reference.html#use-from">3.300. use_from</a></span></dt><dt><span class="sect2"><a href="reference.html#use-idn">3.301. use_idn</a></span></dt><dt><span class="sect2"><a href="reference.html#use-ipv6">3.302. use_ipv6</a></span></dt><dt><span class="sect2"><a href="reference.html#user-agent">3.303. user_agent</a></span></dt><dt><span class="sect2"><a href="reference.html#visual">3.304. visual</a></span></dt><dt><span class="sect2"><a href="reference.html#wait-key">3.305. wait_key</a></span></dt><dt><span class="sect2"><a href="reference.html#weed">3.306. weed</a></span></dt><dt><span class="sect2"><a href="reference.html#wrap">3.307. wrap</a></span></dt><dt><span class="sect2"><a href="reference.html#wrap-headers">3.308. wrap_headers</a></span></dt><dt><span class="sect2"><a href="reference.html#wrap-search">3.309. wrap_search</a></span></dt><dt><span class="sect2"><a href="reference.html#wrapmargin">3.310. wrapmargin</a></span></dt><dt><span class="sect2"><a href="reference.html#write-bcc">3.311. write_bcc</a></span></dt><dt><span class="sect2"><a href="reference.html#write-inc">3.312. write_inc</a></span></dt></dl></dd><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></dl></dd></dl></div><div class="sect1" title="1. Command-Line Options"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commandline"></a>1. Command-Line Options</h2></div></div></div><p>
31 Running <code class="literal">mutt</code> with no arguments will make Mutt attempt
32 to read your spool mailbox. However, it is possible to read other
33 mailboxes and to send messages from the command line as well.
34 </p><div class="table"><a id="tab-commandline-options"></a><p class="title"><b>Table 9.1. Command line options</b></p><div class="table-contents"><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>print the value of all Mutt variables to stdout</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>
35 To read messages in a mailbox
36 </p><div class="cmdsynopsis"><p><code class="command">mutt</code> [<code class="option">-nz</code>] [<code class="option">-F</code>
37 <em class="replaceable"><code>muttrc</code></em>
38 ] [<code class="option">-m</code>
39 <em class="replaceable"><code>type</code></em>
40 ] [<code class="option">-f</code>
41 <em class="replaceable"><code>mailbox</code></em>
43 To compose a new message
44 </p><div class="cmdsynopsis"><p><code class="command">mutt</code> [<code class="option">-n</code>] [<code class="option">-F</code>
45 <em class="replaceable"><code>muttrc</code></em>
46 ] [<code class="option">-c</code>
47 <em class="replaceable"><code>address</code></em>
48 ] [<code class="option">-i</code>
49 <em class="replaceable"><code>filename</code></em>
50 ] [<code class="option">-s</code>
51 <em class="replaceable"><code>subject</code></em>
53 <code class="option">-a</code>
54 <em class="replaceable"><code>file</code></em>
58 <em class="replaceable"><code>address</code></em>
60 <em class="replaceable"><code>mailto_url</code></em>
62 Mutt also supports a <span class="quote">“<span class="quote">batch</span>”</span> mode to send prepared
63 messages. Simply redirect input from the file you wish to send. For
65 </p><pre class="screen">
66 mutt -s "data set for run #2" professor@bigschool.edu < ~/run2.dat</pre><p>
67 will send a message to
68 <code class="literal"><professor@bigschool.edu></code> with a subject of
69 <span class="quote">“<span class="quote">data set for run #2</span>”</span>. In the body of the message will be
70 the contents of the file <span class="quote">“<span class="quote">~/run2.dat</span>”</span>.
72 All files passed with <code class="literal">-a</code> <span class="emphasis"><em>file</em></span>
73 will be attached as a MIME part to the message. To attach a single or
74 several files, use <span class="quote">“<span class="quote">--</span>”</span> to separate files and recipient
76 </p><pre class="screen">
77 mutt -a image.png -- some@one.org</pre><p>
79 </p><pre class="screen">
80 mutt -a *.png -- some@one.org</pre><div class="note" title="Note"><h3 class="title">Note</h3><p>
81 The <code class="literal">-a</code> option must be last in the option list.
83 In addition to accepting a list of email addresses, Mutt also accepts a URL with
84 the <code class="literal">mailto:</code> schema as specified in RFC2368. This is useful
85 when configuring a web browser to launch Mutt when clicking on mailto links.
86 </p><pre class="screen">
87 mutt mailto:some@one.org?subject=test&cc=other@one.org</pre></div><div class="sect1" title="2. Configuration Commands"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commands"></a>2. Configuration Commands</h2></div></div></div><p>
88 The following are the commands understood by Mutt:
89 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts">account-hook</a></code>
90 <em class="replaceable"><code>pattern</code></em>
91 <em class="replaceable"><code>command</code></em>
92 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#alias" title="4. Defining/Using Aliases">alias</a></code> [
93 <code class="option">-group</code>
94 <em class="replaceable"><code>name</code></em>
96 <em class="replaceable"><code>key</code></em>
98 <em class="replaceable"><code>address</code></em>
100 <em class="replaceable"><code>address</code></em>
101 ...]<br /><code class="command"><a class="link" href="configuration.html#alias" title="4. Defining/Using Aliases">unalias</a></code> [
102 <code class="option">-group</code>
103 <em class="replaceable"><code>name</code></em>
105 <em class="replaceable"><code>*</code></em>
107 <em class="replaceable"><code>key</code></em>
108 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">alternates</a></code> [
109 <code class="option">-group</code>
110 <em class="replaceable"><code>name</code></em>
112 <em class="replaceable"><code>regexp</code></em>
114 <em class="replaceable"><code>regexp</code></em>
115 ...]<br /><code class="command"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">unalternates</a></code> [
116 <code class="option">-group</code>
117 <em class="replaceable"><code>name</code></em>
119 <em class="replaceable"><code>*</code></em>
121 <em class="replaceable"><code>regexp</code></em>
122 ... }</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>
123 <em class="replaceable"><code>mimetype</code></em>
125 <em class="replaceable"><code>mimetype</code></em>
126 ...]<br /><code class="command"><a class="link" href="mimesupport.html#alternative-order" title="5. MIME Multipart/Alternative">unalternative-order</a></code> {
127 <em class="replaceable"><code>*</code></em>
129 <em class="replaceable"><code>mimetype</code></em>
130 ... }</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>
131 <em class="replaceable"><code>{ + | - }disposition</code></em>
133 <em class="replaceable"><code>mime-type</code></em>
134 <br /><code class="command"><a class="link" href="mimesupport.html#attachments" title="6. Attachment Searching and Counting">unattachments</a></code>
135 <em class="replaceable"><code>{ + | - }disposition</code></em>
137 <em class="replaceable"><code>mime-type</code></em>
138 </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>
139 <em class="replaceable"><code>mimetype</code></em>
141 <em class="replaceable"><code>mimetype</code></em>
142 ...]<br /><code class="command"><a class="link" href="mimesupport.html#auto-view" title="4. MIME Autoview">unauto_view</a></code> {
143 <em class="replaceable"><code>*</code></em>
145 <em class="replaceable"><code>mimetype</code></em>
146 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#bind" title="5. Changing the Default Key Bindings">bind</a></code>
147 <em class="replaceable"><code>map</code></em>
149 <em class="replaceable"><code>key</code></em>
151 <em class="replaceable"><code>function</code></em>
152 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#charset-hook" title="6. Defining Aliases for Character Sets">charset-hook</a></code>
153 <em class="replaceable"><code>alias</code></em>
155 <em class="replaceable"><code>charset</code></em>
156 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#iconv-hook">iconv-hook</a></code>
157 <em class="replaceable"><code>charset</code></em>
159 <em class="replaceable"><code>local-charset</code></em>
160 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#color" title="9. Using Color and Mono Video Attributes">color</a></code>
161 <em class="replaceable"><code>object</code></em>
163 <em class="replaceable"><code>foreground</code></em>
165 <em class="replaceable"><code>background</code></em>
166 <br /><code class="command"><a class="link" href="configuration.html#color" title="9. Using Color and Mono Video Attributes">color</a></code> {
167 <code class="option">header</code>
169 <code class="option">body</code>
171 <em class="replaceable"><code>foreground</code></em>
173 <em class="replaceable"><code>background</code></em>
175 <em class="replaceable"><code>regexp</code></em>
176 <br /><code class="command"><a class="link" href="configuration.html#color" title="9. Using Color and Mono Video Attributes">color</a></code>
177 <code class="option">index</code>
179 <em class="replaceable"><code>foreground</code></em>
181 <em class="replaceable"><code>background</code></em>
183 <em class="replaceable"><code>pattern</code></em>
184 <br /><code class="command"><a class="link" href="configuration.html#color" title="9. Using Color and Mono Video Attributes">uncolor</a></code> {
185 <code class="option">index</code>
187 <code class="option">header</code>
189 <code class="option">body</code>
191 <em class="replaceable"><code>*</code></em>
193 <em class="replaceable"><code>pattern</code></em>
194 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#crypt-hook" title="21. Choosing the Cryptographic Key of the Recipient">crypt-hook</a></code>
195 <em class="replaceable"><code>pattern</code></em>
197 <em class="replaceable"><code>keyid</code></em>
198 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#exec" title="23. Executing Functions">exec</a></code>
199 <em class="replaceable"><code>function</code></em>
201 <em class="replaceable"><code>function</code></em>
202 ...]</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></code>
203 <em class="replaceable"><code>[!]pattern</code></em>
205 <em class="replaceable"><code>mailbox</code></em>
206 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#fcc-save-hook" title="18. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></code>
207 <em class="replaceable"><code>[!]pattern</code></em>
209 <em class="replaceable"><code>mailbox</code></em>
210 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#folder-hook" title="7. Setting Variables Based Upon Mailbox">folder-hook</a></code>
211 <em class="replaceable"><code>[!]regexp</code></em>
213 <em class="replaceable"><code>command</code></em>
214 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#addrgroup" title="3. Address Groups">group</a></code> [
215 <code class="option">-group</code>
216 <em class="replaceable"><code>name</code></em>
218 <code class="option">-rx</code>
219 <em class="replaceable"><code>expr</code></em>
221 <code class="option">-addr</code>
222 <em class="replaceable"><code>expr</code></em>
223 ... }<br /><code class="command"><a class="link" href="configuration.html#addrgroup" title="3. Address Groups">ungroup</a></code> [
224 <code class="option">-group</code>
225 <em class="replaceable"><code>name</code></em>
227 <em class="replaceable"><code>*</code></em>
229 <code class="option">-rx</code>
230 <em class="replaceable"><code>expr</code></em>
232 <code class="option">-addr</code>
233 <em class="replaceable"><code>expr</code></em>
234 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#hdr-order" title="10.3. Ordering Displayed Headers">hdr_order</a></code>
235 <em class="replaceable"><code>header</code></em>
237 <em class="replaceable"><code>header</code></em>
238 ...]<br /><code class="command"><a class="link" href="configuration.html#hdr-order" title="10.3. Ordering Displayed Headers">unhdr_order</a></code> {
239 <em class="replaceable"><code>*</code></em>
241 <em class="replaceable"><code>header</code></em>
242 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#ignore" title="10.2. Selecting Headers">ignore</a></code>
243 <em class="replaceable"><code>pattern</code></em>
245 <em class="replaceable"><code>pattern</code></em>
246 ...]<br /><code class="command"><a class="link" href="configuration.html#ignore" title="10.2. Selecting Headers">unignore</a></code> {
247 <em class="replaceable"><code>*</code></em>
249 <em class="replaceable"><code>pattern</code></em>
250 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#lists" title="12. Mailing Lists">lists</a></code> [
251 <code class="option">-group</code>
252 <em class="replaceable"><code>name</code></em>
254 <em class="replaceable"><code>regexp</code></em>
256 <em class="replaceable"><code>regexp</code></em>
257 ...]<br /><code class="command"><a class="link" href="configuration.html#lists" title="12. Mailing Lists">unlists</a></code> [
258 <code class="option">-group</code>
259 <em class="replaceable"><code>name</code></em>
261 <em class="replaceable"><code>*</code></em>
263 <em class="replaceable"><code>regexp</code></em>
264 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#macro" title="8. Keyboard Macros">macro</a></code>
265 <em class="replaceable"><code>menu</code></em>
267 <em class="replaceable"><code>key</code></em>
269 <em class="replaceable"><code>sequence</code></em>
271 <em class="replaceable"><code>description</code></em>
272 ]</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mailboxes" title="14. Monitoring Incoming Mail">mailboxes</a></code>
273 <em class="replaceable"><code>mailbox</code></em>
275 <em class="replaceable"><code>mailbox</code></em>
276 ...]<br /><code class="command"><a class="link" href="configuration.html#mailboxes" title="14. Monitoring Incoming Mail">unmailboxes</a></code> {
277 <em class="replaceable"><code>*</code></em>
279 <em class="replaceable"><code>mailbox</code></em>
280 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mbox-hook" title="13. Using Multiple Spool Mailboxes">mbox-hook</a></code>
281 <em class="replaceable"><code>[!]pattern</code></em>
283 <em class="replaceable"><code>mailbox</code></em>
284 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#message-hook" title="20. Change Settings Before Formatting a Message">message-hook</a></code>
285 <em class="replaceable"><code>[!]pattern</code></em>
287 <em class="replaceable"><code>command</code></em>
288 </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>
289 <em class="replaceable"><code>mimetype</code></em>
291 <em class="replaceable"><code>mimetype</code></em>
292 ...]<br /><code class="command"><a class="link" href="mimesupport.html#mime-lookup" title="7. MIME Lookup">unmime-lookup</a></code> {
293 <em class="replaceable"><code>*</code></em>
295 <em class="replaceable"><code>mimetype</code></em>
296 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#mono">mono</a></code>
297 <em class="replaceable"><code>object</code></em>
299 <em class="replaceable"><code>attribute</code></em>
300 <br /><code class="command"><a class="link" href="configuration.html#mono">mono</a></code> {
301 <code class="option">header</code>
303 <code class="option">body</code>
305 <em class="replaceable"><code>attribute</code></em>
307 <em class="replaceable"><code>regexp</code></em>
308 <br /><code class="command"><a class="link" href="configuration.html#mono">mono</a></code>
309 <code class="option">index</code>
311 <em class="replaceable"><code>attribute</code></em>
313 <em class="replaceable"><code>pattern</code></em>
314 <br /><code class="command"><a class="link" href="configuration.html#mono">unmono</a></code> {
315 <code class="option">index</code>
317 <code class="option">header</code>
319 <code class="option">body</code>
321 <em class="replaceable"><code>*</code></em>
323 <em class="replaceable"><code>pattern</code></em>
324 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#my-hdr" title="15. User-Defined Headers">my_hdr</a></code>
325 <em class="replaceable"><code>string</code></em>
326 <br /><code class="command"><a class="link" href="configuration.html#my-hdr" title="15. User-Defined Headers">unmy_hdr</a></code> {
327 <em class="replaceable"><code>*</code></em>
329 <em class="replaceable"><code>field</code></em>
330 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#push" title="22. Adding Key Sequences to the Keyboard Buffer">push</a></code>
331 <em class="replaceable"><code>string</code></em>
332 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#save-hook" title="16. Specify Default Save Mailbox">save-hook</a></code>
333 <em class="replaceable"><code>[!]pattern</code></em>
335 <em class="replaceable"><code>mailbox</code></em>
336 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="reference.html#score" title="3.225. score">score</a></code>
337 <em class="replaceable"><code>pattern</code></em>
339 <em class="replaceable"><code>value</code></em>
340 <br /><code class="command"><a class="link" href="reference.html#score" title="3.225. score">unscore</a></code> {
341 <em class="replaceable"><code>*</code></em>
343 <em class="replaceable"><code>pattern</code></em>
344 ... }</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>
345 <em class="replaceable"><code>[!]pattern</code></em>
347 <em class="replaceable"><code>command</code></em>
348 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#send-hook" title="19. Change Settings Based Upon Message Recipients">send-hook</a></code>
349 <em class="replaceable"><code>[!]pattern</code></em>
351 <em class="replaceable"><code>command</code></em>
352 </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>
353 <em class="replaceable"><code>[!]pattern</code></em>
355 <em class="replaceable"><code>command</code></em>
356 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#set" title="26. Setting and Querying Variables">set</a></code> {
357 [ <code class="option">no</code> | <code class="option">inv</code> ]
358 <em class="replaceable"><code>variable</code></em>
360 <em class="replaceable"><code>variable=value</code></em>
361 } [...]<br /><code class="command"><a class="link" href="configuration.html#set" title="26. Setting and Querying Variables">toggle</a></code>
362 <em class="replaceable"><code>variable</code></em>
364 <em class="replaceable"><code>variable</code></em>
365 ...]<br /><code class="command"><a class="link" href="configuration.html#set" title="26. Setting and Querying Variables">unset</a></code>
366 <em class="replaceable"><code>variable</code></em>
368 <em class="replaceable"><code>variable</code></em>
369 ...]<br /><code class="command"><a class="link" href="configuration.html#set" title="26. Setting and Querying Variables">reset</a></code>
370 <em class="replaceable"><code>variable</code></em>
372 <em class="replaceable"><code>variable</code></em>
373 ...]</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#source" title="27. Reading Initialization Commands From Another File">source</a></code>
374 <em class="replaceable"><code>filename</code></em>
375 </p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#spam" title="25. Spam Detection">spam</a></code>
376 <em class="replaceable"><code>pattern</code></em>
378 <em class="replaceable"><code>format</code></em>
379 <br /><code class="command"><a class="link" href="configuration.html#spam" title="25. Spam Detection">nospam</a></code> {
380 <em class="replaceable"><code>*</code></em>
382 <em class="replaceable"><code>pattern</code></em>
383 }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#subscribe">subscribe</a></code> [
384 <code class="option">-group</code>
385 <em class="replaceable"><code>name</code></em>
387 <em class="replaceable"><code>regexp</code></em>
389 <em class="replaceable"><code>regexp</code></em>
390 ...]<br /><code class="command"><a class="link" href="configuration.html#subscribe">unsubscribe</a></code> [
391 <code class="option">-group</code>
392 <em class="replaceable"><code>name</code></em>
394 <em class="replaceable"><code>*</code></em>
396 <em class="replaceable"><code>regexp</code></em>
397 ... }</p></div></li><li class="listitem"><div class="cmdsynopsis"><p><code class="command"><a class="link" href="configuration.html#unhook" title="28. Removing Hooks">unhook</a></code> {
398 <em class="replaceable"><code>*</code></em>
400 <em class="replaceable"><code>hook-type</code></em>
401 }</p></div></li></ul></div></div><div class="sect1" title="3. Configuration Variables"><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" title="3.1. abort_nosubject"><div class="titlepage"><div><div><h3 class="title"><a id="abort-nosubject"></a>3.1. abort_nosubject</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
402 Default: ask-yes</p></div><p>
403 If set to <span class="emphasis"><em>yes</em></span>, when composing messages and no subject is given
404 at the subject prompt, composition will be aborted. If set to
405 <span class="emphasis"><em>no</em></span>, composing messages with no subject given at the subject
406 prompt will never be aborted.
407 </p></div><div class="sect2" title="3.2. abort_unmodified"><div class="titlepage"><div><div><h3 class="title"><a id="abort-unmodified"></a>3.2. abort_unmodified</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
408 Default: yes</p></div><p>
409 If set to <span class="emphasis"><em>yes</em></span>, composition will automatically abort after
410 editing the message body if no changes are made to the file (this
411 check only happens after the <span class="emphasis"><em>first</em></span> edit of the file). When set
412 to <span class="emphasis"><em>no</em></span>, composition will never be aborted.
413 </p></div><div class="sect2" title="3.3. alias_file"><div class="titlepage"><div><div><h3 class="title"><a id="alias-file"></a>3.3. alias_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
414 Default: <span class="quote">“<span class="quote"><code class="literal">~/.muttrc</code></span>”</span></p></div><p>
415 The default file in which to save aliases created by the
416 <code class="literal"><a class="link" href="gettingstarted.html#create-alias"><create-alias></a></code> function. Entries added to this file are
417 encoded in the character set specified by <a class="link" href="reference.html#config-charset" title="3.30. config_charset">$config_charset</a> if it
418 is <span class="emphasis"><em>set</em></span> or the current character set otherwise.
420 <span class="bold"><strong>Note:</strong></span> Mutt will not automatically source this file; you must
421 explicitly use the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#source" title="27. Reading Initialization Commands From Another File">source</a></span>”</span> command for it to be executed in case
422 this option points to a dedicated alias file.
424 The default for this option is the currently used muttrc file, or
425 <span class="quote">“<span class="quote">~/.muttrc</span>”</span> if no user muttrc was found.
426 </p></div><div class="sect2" title="3.4. alias_format"><div class="titlepage"><div><div><h3 class="title"><a id="alias-format"></a>3.4. alias_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
427 Default: <span class="quote">“<span class="quote"><code class="literal">%4n %2f %t %-10a %r</code></span>”</span></p></div><p>
428 Specifies the format of the data displayed for the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alias" title="4. Defining/Using Aliases">alias</a></span>”</span> menu. The
429 following <code class="literal">printf(3)</code>-style sequences are available:
431 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>alias name
432 </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
433 </td></tr><tr><td>%n </td><td>index number
434 </td></tr><tr><td>%r </td><td>address which alias expands to
435 </td></tr><tr><td>%t </td><td>character which indicates if the alias is tagged for inclusion
436 </td></tr></tbody></table></div></div><div class="sect2" title="3.5. allow_8bit"><div class="titlepage"><div><div><h3 class="title"><a id="allow-8bit"></a>3.5. allow_8bit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
437 Default: yes</p></div><p>
438 Controls whether 8-bit data is converted to 7-bit using either Quoted-
439 Printable or Base64 encoding when sending mail.
440 </p></div><div class="sect2" title="3.6. allow_ansi"><div class="titlepage"><div><div><h3 class="title"><a id="allow-ansi"></a>3.6. allow_ansi</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
441 Default: no</p></div><p>
442 Controls whether ANSI color codes in messages (and color tags in
443 rich text messages) are to be interpreted.
444 Messages containing these codes are rare, but if this option is <span class="emphasis"><em>set</em></span>,
445 their text will be colored accordingly. Note that this may override
446 your color choices, and even present a security problem, since a
447 message could include a line like
449 </p><pre class="screen">
450 [-- PGP output follows ...
452 and give it the same color as your attachment color (see also
453 <a class="link" href="reference.html#crypt-timestamp" title="3.43. crypt_timestamp">$crypt_timestamp</a>).
454 </p></div><div class="sect2" title="3.7. arrow_cursor"><div class="titlepage"><div><div><h3 class="title"><a id="arrow-cursor"></a>3.7. arrow_cursor</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
455 Default: no</p></div><p>
456 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
457 in menus instead of highlighting the whole line. On slow network or modem
458 links this will make response faster because there is less that has to
459 be redrawn on the screen when moving to the next or previous entries
461 </p></div><div class="sect2" title="3.8. ascii_chars"><div class="titlepage"><div><div><h3 class="title"><a id="ascii-chars"></a>3.8. ascii_chars</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
462 Default: no</p></div><p>
463 If <span class="emphasis"><em>set</em></span>, Mutt will use plain ASCII characters when displaying thread
464 and attachment trees, instead of the default <span class="emphasis"><em>ACS</em></span> characters.
465 </p></div><div class="sect2" title="3.9. askbcc"><div class="titlepage"><div><div><h3 class="title"><a id="askbcc"></a>3.9. askbcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
466 Default: no</p></div><p>
467 If <span class="emphasis"><em>set</em></span>, Mutt will prompt you for blind-carbon-copy (Bcc) recipients
468 before editing an outgoing message.
469 </p></div><div class="sect2" title="3.10. askcc"><div class="titlepage"><div><div><h3 class="title"><a id="askcc"></a>3.10. askcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
470 Default: no</p></div><p>
471 If <span class="emphasis"><em>set</em></span>, Mutt will prompt you for carbon-copy (Cc) recipients before
472 editing the body of an outgoing message.
473 </p></div><div class="sect2" title="3.11. assumed_charset"><div class="titlepage"><div><div><h3 class="title"><a id="assumed-charset"></a>3.11. assumed_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
474 Default: (empty)</p></div><p>
475 This variable is a colon-separated list of character encoding
476 schemes for messages without character encoding indication.
477 Header field values and message body content without character encoding
478 indication would be assumed that they are written in one of this list.
479 By default, all the header fields and message body without any charset
480 indication are assumed to be in <span class="quote">“<span class="quote">us-ascii</span>”</span>.
482 For example, Japanese users might prefer this:
484 </p><pre class="screen">
485 set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
487 However, only the first content is valid for the message body.
488 </p></div><div class="sect2" title="3.12. attach_charset"><div class="titlepage"><div><div><h3 class="title"><a id="attach-charset"></a>3.12. attach_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
489 Default: (empty)</p></div><p>
490 This variable is a colon-separated list of character encoding
491 schemes for text file attachments. Mutt uses this setting to guess
492 which encoding files being attached are encoded in to convert them to
493 a proper character set given in <a class="link" href="reference.html#send-charset" title="3.230. send_charset">$send_charset</a>.
495 If <span class="emphasis"><em>unset</em></span>, the value of <a class="link" href="reference.html#charset" title="3.25. charset">$charset</a> will be used instead.
496 For example, the following configuration would work for Japanese
499 </p><pre class="screen">
500 set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
502 Note: for Japanese users, <span class="quote">“<span class="quote">iso-2022-*</span>”</span> must be put at the head
503 of the value as shown above if included.
504 </p></div><div class="sect2" title="3.13. attach_format"><div class="titlepage"><div><div><h3 class="title"><a id="attach-format"></a>3.13. attach_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
505 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>
506 This variable describes the format of the <span class="quote">“<span class="quote">attachment</span>”</span> menu. The
507 following <code class="literal">printf(3)</code>-style sequences are understood:
509 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%C </td><td>charset
510 </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>)
511 </td></tr><tr><td>%D </td><td>deleted flag
512 </td></tr><tr><td>%d </td><td>description
513 </td></tr><tr><td>%e </td><td>MIME content-transfer-encoding
514 </td></tr><tr><td>%f </td><td>filename
515 </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)
516 </td></tr><tr><td>%m </td><td>major MIME type
517 </td></tr><tr><td>%M </td><td>MIME subtype
518 </td></tr><tr><td>%n </td><td>attachment number
519 </td></tr><tr><td>%Q </td><td><span class="quote">“<span class="quote">Q</span>”</span>, if MIME part qualifies for attachment counting
520 </td></tr><tr><td>%s </td><td>size
521 </td></tr><tr><td>%t </td><td>tagged flag
522 </td></tr><tr><td>%T </td><td>graphic tree characters
523 </td></tr><tr><td>%u </td><td>unlink (=to delete) flag
524 </td></tr><tr><td>%X </td><td>number of qualifying MIME parts in this part and its children
525 (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)
526 </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>
527 </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>
528 </td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
529 </td></tr></tbody></table></div><p>
530 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.114. index_format">$index_format</a> documentation.
531 </p></div><div class="sect2" title="3.14. attach_sep"><div class="titlepage"><div><div><h3 class="title"><a id="attach-sep"></a>3.14. attach_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
532 Default: <span class="quote">“<span class="quote"><code class="literal">\n</code></span>”</span></p></div><p>
533 The separator to add between attachments when operating (saving,
534 printing, piping, etc) on a list of tagged attachments.
535 </p></div><div class="sect2" title="3.15. attach_split"><div class="titlepage"><div><div><h3 class="title"><a id="attach-split"></a>3.15. attach_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
536 Default: yes</p></div><p>
537 If this variable is <span class="emphasis"><em>unset</em></span>, when operating (saving, printing, piping,
538 etc) on a list of tagged attachments, Mutt will concatenate the
539 attachments and will operate on them as a single attachment. The
540 <a class="link" href="reference.html#attach-sep" title="3.14. attach_sep">$attach_sep</a> separator is added after each attachment. When <span class="emphasis"><em>set</em></span>,
541 Mutt will operate on the attachments one by one.
542 </p></div><div class="sect2" title="3.16. attribution"><div class="titlepage"><div><div><h3 class="title"><a id="attribution"></a>3.16. attribution</h3></div></div></div><div class="literallayout"><p>Type: string<br />
543 Default: <span class="quote">“<span class="quote"><code class="literal">On %d, %n wrote:</code></span>”</span></p></div><p>
544 This is the string that will precede a message which has been included
545 in a reply. For a full listing of defined <code class="literal">printf(3)</code>-like sequences see
546 the section on <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>.
547 </p></div><div class="sect2" title="3.17. auto_tag"><div class="titlepage"><div><div><h3 class="title"><a id="auto-tag"></a>3.17. auto_tag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
548 Default: no</p></div><p>
549 When <span class="emphasis"><em>set</em></span>, functions in the <span class="emphasis"><em>index</em></span> menu which affect a message
550 will be applied to all tagged messages (if there are any). When
551 unset, you must first use the <code class="literal"><tag-prefix></code> function (bound to <span class="quote">“<span class="quote">;</span>”</span>
552 by default) to make the next function apply to all tagged messages.
553 </p></div><div class="sect2" title="3.18. autoedit"><div class="titlepage"><div><div><h3 class="title"><a id="autoedit"></a>3.18. autoedit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
554 Default: no</p></div><p>
555 When <span class="emphasis"><em>set</em></span> along with <a class="link" href="reference.html#edit-headers" title="3.57. edit_headers">$edit_headers</a>, Mutt will skip the initial
556 send-menu (prompting for subject and recipients) and allow you to
557 immediately begin editing the body of your
558 message. The send-menu may still be accessed once you have finished
559 editing the body of your message.
561 <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
562 on the recipients when composing a new (non-reply) message, as the initial
563 list of recipients is empty.
565 Also see <a class="link" href="reference.html#fast-reply" title="3.63. fast_reply">$fast_reply</a>.
566 </p></div><div class="sect2" title="3.19. beep"><div class="titlepage"><div><div><h3 class="title"><a id="beep"></a>3.19. beep</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
567 Default: yes</p></div><p>
568 When this variable is <span class="emphasis"><em>set</em></span>, mutt will beep when an error occurs.
569 </p></div><div class="sect2" title="3.20. beep_new"><div class="titlepage"><div><div><h3 class="title"><a id="beep-new"></a>3.20. beep_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
570 Default: no</p></div><p>
571 When this variable is <span class="emphasis"><em>set</em></span>, mutt will beep whenever it prints a message
572 notifying you of new mail. This is independent of the setting of the
573 <a class="link" href="reference.html#beep" title="3.19. beep">$beep</a> variable.
574 </p></div><div class="sect2" title="3.21. bounce"><div class="titlepage"><div><div><h3 class="title"><a id="bounce"></a>3.21. bounce</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
575 Default: ask-yes</p></div><p>
576 Controls whether you will be asked to confirm bouncing messages.
577 If set to <span class="emphasis"><em>yes</em></span> you don't get asked if you want to bounce a
578 message. Setting this variable to <span class="emphasis"><em>no</em></span> is not generally useful,
579 and thus not recommended, because you are unable to bounce messages.
580 </p></div><div class="sect2" title="3.22. bounce_delivered"><div class="titlepage"><div><div><h3 class="title"><a id="bounce-delivered"></a>3.22. bounce_delivered</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
581 Default: yes</p></div><p>
582 When this variable is <span class="emphasis"><em>set</em></span>, mutt will include Delivered-To headers when
583 bouncing messages. Postfix users may wish to <span class="emphasis"><em>unset</em></span> this variable.
584 </p></div><div class="sect2" title="3.23. braille_friendly"><div class="titlepage"><div><div><h3 class="title"><a id="braille-friendly"></a>3.23. braille_friendly</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
585 Default: no</p></div><p>
586 When this variable is <span class="emphasis"><em>set</em></span>, mutt will place the cursor at the beginning
587 of the current line in menus, even when the <a class="link" href="reference.html#arrow-cursor" title="3.7. arrow_cursor">$arrow_cursor</a> variable
588 is <span class="emphasis"><em>unset</em></span>, making it easier for blind persons using Braille displays to
589 follow these menus. The option is <span class="emphasis"><em>unset</em></span> by default because many
590 visual terminals don't permit making the cursor invisible.
591 </p></div><div class="sect2" title="3.24. certificate_file"><div class="titlepage"><div><div><h3 class="title"><a id="certificate-file"></a>3.24. certificate_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
592 Default: <span class="quote">“<span class="quote"><code class="literal">~/.mutt_certificates</code></span>”</span></p></div><p>
593 This variable specifies the file where the certificates you trust
594 are saved. When an unknown certificate is encountered, you are asked
595 if you accept it or not. If you accept it, the certificate can also
596 be saved in this file and further connections are automatically
599 You can also manually add CA certificates in this file. Any server
600 certificate that is signed with one of these CA certificates is
601 also automatically accepted.
605 </p><pre class="screen">
606 set certificate_file=~/.mutt/certificates
607 </pre></div><div class="sect2" title="3.25. charset"><div class="titlepage"><div><div><h3 class="title"><a id="charset"></a>3.25. charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
608 Default: (empty)</p></div><p>
609 Character set your terminal uses to display and enter textual data.
610 It is also the fallback for <a class="link" href="reference.html#send-charset" title="3.230. send_charset">$send_charset</a>.
612 Upon startup Mutt tries to derive this value from environment variables
613 such as <code class="literal">$LC_CTYPE</code> or <code class="literal">$LANG</code>.
615 <span class="bold"><strong>Note:</strong></span> It should only be set in case Mutt isn't able to determine the
616 character set used correctly.
617 </p></div><div class="sect2" title="3.26. check_mbox_size"><div class="titlepage"><div><div><h3 class="title"><a id="check-mbox-size"></a>3.26. check_mbox_size</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
618 Default: no</p></div><p>
619 When this variable is <span class="emphasis"><em>set</em></span>, mutt will use file size attribute instead of
620 access time when checking for new mail in mbox and mmdf folders.
622 This variable is <span class="emphasis"><em>unset</em></span> by default and should only be enabled when
623 new mail detection for these folder types is unreliable or doesn't work.
625 Note that enabling this variable should happen before any <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mailboxes" title="14. Monitoring Incoming Mail">mailboxes</a></span>”</span>
626 directives occur in configuration files regarding mbox or mmdf folders
627 because mutt needs to determine the initial new mail status of such a
628 mailbox by performing a fast mailbox scan when it is defined.
629 Afterwards the new mail status is tracked by file size changes.
630 </p></div><div class="sect2" title="3.27. check_new"><div class="titlepage"><div><div><h3 class="title"><a id="check-new"></a>3.27. check_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
631 Default: yes</p></div><p>
632 <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
635 When <span class="emphasis"><em>set</em></span>, Mutt will check for new mail delivered while the
636 mailbox is open. Especially with MH mailboxes, this operation can
637 take quite some time since it involves scanning the directory and
638 checking each file to see if it has already been looked at. If
639 this variable is <span class="emphasis"><em>unset</em></span>, no check for new mail is performed
640 while the mailbox is open.
641 </p></div><div class="sect2" title="3.28. collapse_unread"><div class="titlepage"><div><div><h3 class="title"><a id="collapse-unread"></a>3.28. collapse_unread</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
642 Default: yes</p></div><p>
643 When <span class="emphasis"><em>unset</em></span>, Mutt will not collapse a thread if it contains any
645 </p></div><div class="sect2" title="3.29. compose_format"><div class="titlepage"><div><div><h3 class="title"><a id="compose-format"></a>3.29. compose_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
646 Default: <span class="quote">“<span class="quote"><code class="literal">-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-</code></span>”</span></p></div><p>
647 Controls the format of the status line displayed in the <span class="quote">“<span class="quote">compose</span>”</span>
648 menu. This string is similar to <a class="link" href="reference.html#status-format" title="3.283. status_format">$status_format</a>, but has its own
649 set of <code class="literal">printf(3)</code>-like sequences:
651 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>total number of attachments
652 </td></tr><tr><td>%h </td><td>local hostname
653 </td></tr><tr><td>%l </td><td>approximate size (in bytes) of the current message
654 </td></tr><tr><td>%v </td><td>Mutt version string
655 </td></tr></tbody></table></div><p>
656 See the text describing the <a class="link" href="reference.html#status-format" title="3.283. status_format">$status_format</a> option for more
657 information on how to set <a class="link" href="reference.html#compose-format" title="3.29. compose_format">$compose_format</a>.
658 </p></div><div class="sect2" title="3.30. config_charset"><div class="titlepage"><div><div><h3 class="title"><a id="config-charset"></a>3.30. config_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
659 Default: (empty)</p></div><p>
660 When defined, Mutt will recode commands in rc files from this
661 encoding to the current character set as specified by <a class="link" href="reference.html#charset" title="3.25. charset">$charset</a>
662 and aliases written to <a class="link" href="reference.html#alias-file" title="3.3. alias_file">$alias_file</a> from the current character set.
664 Please note that if setting <a class="link" href="reference.html#charset" title="3.25. charset">$charset</a> it must be done before
665 setting <a class="link" href="reference.html#config-charset" title="3.30. config_charset">$config_charset</a>.
667 Recoding should be avoided as it may render unconvertable
668 characters as question marks which can lead to undesired
669 side effects (for example in regular expressions).
670 </p></div><div class="sect2" title="3.31. confirmappend"><div class="titlepage"><div><div><h3 class="title"><a id="confirmappend"></a>3.31. confirmappend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
671 Default: yes</p></div><p>
672 When <span class="emphasis"><em>set</em></span>, Mutt will prompt for confirmation when appending messages to
674 </p></div><div class="sect2" title="3.32. confirmcreate"><div class="titlepage"><div><div><h3 class="title"><a id="confirmcreate"></a>3.32. confirmcreate</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
675 Default: yes</p></div><p>
676 When <span class="emphasis"><em>set</em></span>, Mutt will prompt for confirmation when saving messages to a
677 mailbox which does not yet exist before creating it.
678 </p></div><div class="sect2" title="3.33. connect_timeout"><div class="titlepage"><div><div><h3 class="title"><a id="connect-timeout"></a>3.33. connect_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
679 Default: 30</p></div><p>
680 Causes Mutt to timeout a network connection (for IMAP, POP or SMTP) after this
681 many seconds if the connection is not able to be established. A negative
682 value causes Mutt to wait indefinitely for the connection attempt to succeed.
683 </p></div><div class="sect2" title="3.34. content_type"><div class="titlepage"><div><div><h3 class="title"><a id="content-type"></a>3.34. content_type</h3></div></div></div><div class="literallayout"><p>Type: string<br />
684 Default: <span class="quote">“<span class="quote"><code class="literal">text/plain</code></span>”</span></p></div><p>
685 Sets the default Content-Type for the body of newly composed messages.
686 </p></div><div class="sect2" title="3.35. copy"><div class="titlepage"><div><div><h3 class="title"><a id="copy"></a>3.35. copy</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
687 Default: yes</p></div><p>
688 This variable controls whether or not copies of your outgoing messages
689 will be saved for later references. Also see <a class="link" href="reference.html#record" title="3.212. record">$record</a>,
690 <a class="link" href="reference.html#save-name" title="3.224. save_name">$save_name</a>, <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a> and <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span>.
691 </p></div><div class="sect2" title="3.36. crypt_autoencrypt"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.36. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
692 Default: no</p></div><p>
693 Setting this variable will cause Mutt to always attempt to PGP
694 encrypt outgoing messages. This is probably only useful in
695 connection to the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#send-hook" title="19. Change Settings Based Upon Message Recipients">send-hook</a></span>”</span> command. It can be overridden
696 by use of the pgp menu, when encryption is not required or
697 signing is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.253. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
698 then OpenSSL is used instead to create S/MIME messages and
699 settings can be overridden by use of the smime menu instead.
701 </p></div><div class="sect2" title="3.37. crypt_autopgp"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.37. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
702 Default: yes</p></div><p>
703 This variable controls whether or not mutt may automatically enable
704 PGP encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.36. crypt_autoencrypt">$crypt_autoencrypt</a>,
705 <a class="link" href="reference.html#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>,
706 <a class="link" href="reference.html#crypt-autosign" title="3.38. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.253. smime_is_default">$smime_is_default</a>.
707 </p></div><div class="sect2" title="3.38. crypt_autosign"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.38. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
708 Default: no</p></div><p>
709 Setting this variable will cause Mutt to always attempt to
710 cryptographically sign outgoing messages. This can be overridden
711 by use of the pgp menu, when signing is not required or
712 encryption is requested as well. If <a class="link" href="reference.html#smime-is-default" title="3.253. smime_is_default">$smime_is_default</a> is <span class="emphasis"><em>set</em></span>,
713 then OpenSSL is used instead to create S/MIME messages and settings can
714 be overridden by use of the smime menu instead of the pgp menu.
716 </p></div><div class="sect2" title="3.39. crypt_autosmime"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.39. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
717 Default: yes</p></div><p>
718 This variable controls whether or not mutt may automatically enable
719 S/MIME encryption/signing for messages. See also <a class="link" href="reference.html#crypt-autoencrypt" title="3.36. crypt_autoencrypt">$crypt_autoencrypt</a>,
720 <a class="link" href="reference.html#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>,
721 <a class="link" href="reference.html#crypt-autosign" title="3.38. crypt_autosign">$crypt_autosign</a>, <a class="link" href="reference.html#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a> and <a class="link" href="reference.html#smime-is-default" title="3.253. smime_is_default">$smime_is_default</a>.
722 </p></div><div class="sect2" title="3.40. crypt_replyencrypt"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.40. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
723 Default: yes</p></div><p>
724 If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL encrypt replies to messages which are
727 </p></div><div class="sect2" title="3.41. crypt_replysign"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.41. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
728 Default: no</p></div><p>
729 If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages which are
732 <span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted
733 <span class="emphasis"><em>and</em></span> signed!
735 </p></div><div class="sect2" title="3.42. crypt_replysignencrypted"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.42. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
736 Default: no</p></div><p>
737 If <span class="emphasis"><em>set</em></span>, automatically PGP or OpenSSL sign replies to messages
738 which are encrypted. This makes sense in combination with
739 <a class="link" href="reference.html#crypt-replyencrypt" title="3.40. crypt_replyencrypt">$crypt_replyencrypt</a>, because it allows you to sign all
740 messages which are automatically encrypted. This works around
741 the problem noted in <a class="link" href="reference.html#crypt-replysign" title="3.41. crypt_replysign">$crypt_replysign</a>, that mutt is not able
742 to find out whether an encrypted message is also signed.
744 </p></div><div class="sect2" title="3.43. crypt_timestamp"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.43. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
745 Default: yes</p></div><p>
746 If <span class="emphasis"><em>set</em></span>, mutt will include a time stamp in the lines surrounding
747 PGP or S/MIME output, so spoofing such lines is more difficult.
748 If you are using colors to mark these lines, and rely on these,
749 you may <span class="emphasis"><em>unset</em></span> this setting.
751 </p></div><div class="sect2" title="3.44. crypt_use_gpgme"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.44. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
752 Default: no</p></div><p>
753 This variable controls the use of the GPGME-enabled crypto backends.
754 If it is <span class="emphasis"><em>set</em></span> and Mutt was built with gpgme support, the gpgme code for
755 S/MIME and PGP will be used instead of the classic code. Note that
756 you need to set this option in .muttrc; it won't have any effect when
758 </p></div><div class="sect2" title="3.45. crypt_use_pka"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.45. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
759 Default: no</p></div><p>
760 Controls whether mutt uses PKA
761 (see http://www.g10code.de/docs/pka-intro.de.pdf) during signature
762 verification (only supported by the GPGME backend).
763 </p></div><div class="sect2" title="3.46. crypt_verify_sig"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.46. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
764 Default: yes</p></div><p>
765 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.
766 If <span class="emphasis"><em><span class="quote">“<span class="quote">ask-*</span>”</span></em></span>, ask whether or not to verify the signature.
767 If <span class="emphasis"><em><span class="quote">“<span class="quote">no</span>”</span></em></span>, never attempt to verify cryptographic signatures.
769 </p></div><div class="sect2" title="3.47. date_format"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.47. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
770 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>
771 This variable controls the format of the date printed by the <span class="quote">“<span class="quote">%d</span>”</span>
772 sequence in <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>. This is passed to the <code class="literal">strftime(3)</code>
773 function to process the date, see the man page for the proper syntax.
775 Unless the first character in the string is a bang (<span class="quote">“<span class="quote">!</span>”</span>), the month
776 and week day names are expanded according to the locale specified in
777 the variable <a class="link" href="reference.html#locale" title="3.117. locale">$locale</a>. If the first character in the string is a
778 bang, the bang is discarded, and the month and week day names in the
779 rest of the string are expanded in the <span class="emphasis"><em>C</em></span> locale (that is in US
781 </p></div><div class="sect2" title="3.48. default_hook"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.48. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />
782 Default: <span class="quote">“<span class="quote"><code class="literal">~f %s !~P | (~P ~C %s)</code></span>”</span></p></div><p>
783 This variable controls how <span class="quote">“<span class="quote"><a class="link" href="configuration.html#message-hook" title="20. 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="19. Change Settings Based Upon Message Recipients">send-hook</a></span>”</span>,
784 <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="16. 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="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span> will
785 be interpreted if they are specified with only a simple regexp,
786 instead of a matching pattern. The hooks are expanded when they are
787 declared, so a hook will be interpreted according to the value of this
788 variable at the time the hook is declared.
790 The default value matches
791 if the message is either from a user matching the regular expression
792 given, or if it is from you (if the from address matches
793 <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">alternates</a></span>”</span>) and is to or cc'ed to a user matching the given
795 </p></div><div class="sect2" title="3.49. delete"><div class="titlepage"><div><div><h3 class="title"><a id="delete"></a>3.49. delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
796 Default: ask-yes</p></div><p>
797 Controls whether or not messages are really deleted when closing or
798 synchronizing a mailbox. If set to <span class="emphasis"><em>yes</em></span>, messages marked for
799 deleting will automatically be purged without prompting. If set to
800 <span class="emphasis"><em>no</em></span>, messages marked for deletion will be kept in the mailbox.
801 </p></div><div class="sect2" title="3.50. delete_untag"><div class="titlepage"><div><div><h3 class="title"><a id="delete-untag"></a>3.50. delete_untag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
802 Default: yes</p></div><p>
803 If this option is <span class="emphasis"><em>set</em></span>, mutt will untag messages when marking them
804 for deletion. This applies when you either explicitly delete a message,
805 or when you save it to another folder.
806 </p></div><div class="sect2" title="3.51. digest_collapse"><div class="titlepage"><div><div><h3 class="title"><a id="digest-collapse"></a>3.51. digest_collapse</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
807 Default: yes</p></div><p>
808 If this option is <span class="emphasis"><em>set</em></span>, mutt's received-attachments menu will not show the subparts of
809 individual messages in a multipart/digest. To see these subparts, press <span class="quote">“<span class="quote">v</span>”</span> on that menu.
810 </p></div><div class="sect2" title="3.52. display_filter"><div class="titlepage"><div><div><h3 class="title"><a id="display-filter"></a>3.52. display_filter</h3></div></div></div><div class="literallayout"><p>Type: path<br />
811 Default: (empty)</p></div><p>
812 When set, specifies a command used to filter messages. When a message
813 is viewed it is passed as standard input to <a class="link" href="reference.html#display-filter" title="3.52. display_filter">$display_filter</a>, and the
814 filtered message is read from the standard output.
815 </p></div><div class="sect2" title="3.53. dotlock_program"><div class="titlepage"><div><div><h3 class="title"><a id="dotlock-program"></a>3.53. dotlock_program</h3></div></div></div><div class="literallayout"><p>Type: path<br />
816 Default: <span class="quote">“<span class="quote"><code class="literal">/usr/local/bin/mutt_dotlock</code></span>”</span></p></div><p>
817 Contains the path of the <code class="literal">mutt_dotlock(8)</code> binary to be used by
819 </p></div><div class="sect2" title="3.54. dsn_notify"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-notify"></a>3.54. dsn_notify</h3></div></div></div><div class="literallayout"><p>Type: string<br />
820 Default: (empty)</p></div><p>
821 This variable sets the request for when notification is returned. The
822 string consists of a comma separated list (no spaces!) of one or more
823 of the following: <span class="emphasis"><em>never</em></span>, to never request notification,
824 <span class="emphasis"><em>failure</em></span>, to request notification on transmission failure,
825 <span class="emphasis"><em>delay</em></span>, to be notified of message delays, <span class="emphasis"><em>success</em></span>, to be
826 notified of successful transmission.
830 </p><pre class="screen">
831 set dsn_notify="failure,delay"
833 <span class="bold"><strong>Note:</strong></span> when using <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a> for delivery, you should not enable
834 this unless you are either using Sendmail 8.8.x or greater or a MTA
835 providing a <code class="literal">sendmail(1)</code>-compatible interface supporting the <code class="literal">-N</code> option
836 for DSN. For SMTP delivery, DSN support is auto-detected so that it
837 depends on the server whether DSN will be used or not.
838 </p></div><div class="sect2" title="3.55. dsn_return"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-return"></a>3.55. dsn_return</h3></div></div></div><div class="literallayout"><p>Type: string<br />
839 Default: (empty)</p></div><p>
840 This variable controls how much of your message is returned in DSN
841 messages. It may be set to either <span class="emphasis"><em>hdrs</em></span> to return just the
842 message header, or <span class="emphasis"><em>full</em></span> to return the full message.
846 </p><pre class="screen">
849 <span class="bold"><strong>Note:</strong></span> when using <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a> for delivery, you should not enable
850 this unless you are either using Sendmail 8.8.x or greater or a MTA
851 providing a <code class="literal">sendmail(1)</code>-compatible interface supporting the <code class="literal">-R</code> option
852 for DSN. For SMTP delivery, DSN support is auto-detected so that it
853 depends on the server whether DSN will be used or not.
854 </p></div><div class="sect2" title="3.56. duplicate_threads"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.56. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
855 Default: yes</p></div><p>
856 This variable controls whether mutt, when <a class="link" href="reference.html#sort" title="3.264. sort">$sort</a> is set to <span class="emphasis"><em>threads</em></span>, threads
857 messages with the same Message-Id together. If it is <span class="emphasis"><em>set</em></span>, it will indicate
858 that it thinks they are duplicates of each other with an equals sign
860 </p></div><div class="sect2" title="3.57. edit_headers"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.57. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
861 Default: no</p></div><p>
862 This option allows you to edit the header of your outgoing messages
863 along with the body of your message.
865 <span class="bold"><strong>Note</strong></span> that changes made to the References: and Date: headers are
866 ignored for interoperability reasons.
867 </p></div><div class="sect2" title="3.58. editor"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.58. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />
868 Default: (empty)</p></div><p>
869 This variable specifies which editor is used by mutt.
870 It defaults to the value of the <code class="literal">$VISUAL</code>, or <code class="literal">$EDITOR</code>, environment
871 variable, or to the string <span class="quote">“<span class="quote">vi</span>”</span> if neither of those are set.
872 </p></div><div class="sect2" title="3.59. encode_from"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.59. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
873 Default: no</p></div><p>
874 When <span class="emphasis"><em>set</em></span>, mutt will quoted-printable encode messages when
875 they contain the string <span class="quote">“<span class="quote">From </span>”</span> (note the trailing space) in the beginning of a line.
876 This is useful to avoid the tampering certain mail delivery and transport
877 agents tend to do with messages (in order to prevent tools from
878 misinterpreting the line as a mbox message separator).
879 </p></div><div class="sect2" title="3.60. entropy_file"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.60. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
880 Default: (empty)</p></div><p>
881 The file which includes random data that is used to initialize SSL
883 </p></div><div class="sect2" title="3.61. envelope_from_address"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.61. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
884 Default: (empty)</p></div><p>
885 Manually sets the <span class="emphasis"><em>envelope</em></span> sender for outgoing messages.
886 This value is ignored if <a class="link" href="reference.html#use-envelope-from" title="3.299. use_envelope_from">$use_envelope_from</a> is <span class="emphasis"><em>unset</em></span>.
887 </p></div><div class="sect2" title="3.62. escape"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.62. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />
888 Default: <span class="quote">“<span class="quote"><code class="literal">~</code></span>”</span></p></div><p>
889 Escape character to use for functions in the built-in editor.
890 </p></div><div class="sect2" title="3.63. fast_reply"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.63. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
891 Default: no</p></div><p>
892 When <span class="emphasis"><em>set</em></span>, the initial prompt for recipients and subject are skipped
893 when replying to messages, and the initial prompt for subject is
894 skipped when forwarding messages.
896 <span class="bold"><strong>Note:</strong></span> this variable has no effect when the <a class="link" href="reference.html#autoedit" title="3.18. autoedit">$autoedit</a>
897 variable is <span class="emphasis"><em>set</em></span>.
898 </p></div><div class="sect2" title="3.64. fcc_attach"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.64. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
899 Default: yes</p></div><p>
900 This variable controls whether or not attachments on outgoing messages
901 are saved along with the main body of your message.
902 </p></div><div class="sect2" title="3.65. fcc_clear"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.65. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
903 Default: no</p></div><p>
904 When this variable is <span class="emphasis"><em>set</em></span>, FCCs will be stored unencrypted and
905 unsigned, even when the actual message is encrypted and/or
908 </p></div><div class="sect2" title="3.66. folder"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.66. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />
909 Default: <span class="quote">“<span class="quote"><code class="literal">~/Mail</code></span>”</span></p></div><p>
910 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
911 beginning of a pathname will be expanded to the value of this
912 variable. Note that if you change this variable (from the default)
913 value you need to make sure that the assignment occurs <span class="emphasis"><em>before</em></span>
914 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
915 when handling the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mailboxes" title="14. Monitoring Incoming Mail">mailboxes</a></span>”</span> command.
916 </p></div><div class="sect2" title="3.67. folder_format"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.67. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
917 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>
918 This variable allows you to customize the file browser display to your
919 personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>, but has
920 its own set of <code class="literal">printf(3)</code>-like sequences:
922 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%C </td><td>current file number
923 </td></tr><tr><td>%d </td><td>date/time folder was last modified
924 </td></tr><tr><td>%D </td><td>date/time folder was last modified using <a class="link" href="reference.html#date-format" title="3.47. date_format">$date_format</a>.
925 </td></tr><tr><td>%f </td><td>filename (<span class="quote">“<span class="quote">/</span>”</span> is appended to directory names,
926 <span class="quote">“<span class="quote">@</span>”</span> to symbolic links and <span class="quote">“<span class="quote">*</span>”</span> to executable
928 </td></tr><tr><td>%F </td><td>file permissions
929 </td></tr><tr><td>%g </td><td>group name (or numeric gid, if missing)
930 </td></tr><tr><td>%l </td><td>number of hard links
931 </td></tr><tr><td>%N </td><td>N if folder has new mail, blank otherwise
932 </td></tr><tr><td>%s </td><td>size in bytes
933 </td></tr><tr><td>%t </td><td><span class="quote">“<span class="quote">*</span>”</span> if the file is tagged, blank otherwise
934 </td></tr><tr><td>%u </td><td>owner name (or numeric uid, if missing)
935 </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>
936 </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>
937 </td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
938 </td></tr></tbody></table></div><p>
939 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.114. index_format">$index_format</a> documentation.
940 </p></div><div class="sect2" title="3.68. followup_to"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.68. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
941 Default: yes</p></div><p>
942 Controls whether or not the <span class="quote">“<span class="quote">Mail-Followup-To:</span>”</span> header field is
943 generated when sending mail. When <span class="emphasis"><em>set</em></span>, Mutt will generate this
944 field when you are replying to a known mailing list, specified with
945 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="12. Mailing Lists">lists</a></span>”</span> commands.
947 This field has two purposes. First, preventing you from
948 receiving duplicate copies of replies to messages which you send
949 to mailing lists, and second, ensuring that you do get a reply
950 separately for any messages sent to known lists to which you are
953 The header will contain only the list's address
954 for subscribed lists, and both the list address and your own
955 email address for unsubscribed lists. Without this header, a
956 group reply to your message sent to a subscribed list will be
957 sent to both the list and your address, resulting in two copies
958 of the same email for you.
959 </p></div><div class="sect2" title="3.69. force_name"><div class="titlepage"><div><div><h3 class="title"><a id="force-name"></a>3.69. force_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
960 Default: no</p></div><p>
961 This variable is similar to <a class="link" href="reference.html#save-name" title="3.224. save_name">$save_name</a>, except that Mutt will
962 store a copy of your outgoing message by the username of the address
963 you are sending to even if that mailbox does not exist.
965 Also see the <a class="link" href="reference.html#record" title="3.212. record">$record</a> variable.
966 </p></div><div class="sect2" title="3.70. forward_decode"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decode"></a>3.70. forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
967 Default: yes</p></div><p>
968 Controls the decoding of complex MIME messages into <code class="literal">text/plain</code> when
969 forwarding a message. The message header is also RFC2047 decoded.
970 This variable is only used, if <a class="link" href="reference.html#mime-forward" title="3.141. mime_forward">$mime_forward</a> is <span class="emphasis"><em>unset</em></span>,
971 otherwise <a class="link" href="reference.html#mime-forward-decode" title="3.142. mime_forward_decode">$mime_forward_decode</a> is used instead.
972 </p></div><div class="sect2" title="3.71. forward_decrypt"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decrypt"></a>3.71. forward_decrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
973 Default: yes</p></div><p>
974 Controls the handling of encrypted messages when forwarding a message.
975 When <span class="emphasis"><em>set</em></span>, the outer layer of encryption is stripped off. This
976 variable is only used if <a class="link" href="reference.html#mime-forward" title="3.141. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span> and
977 <a class="link" href="reference.html#mime-forward-decode" title="3.142. mime_forward_decode">$mime_forward_decode</a> is <span class="emphasis"><em>unset</em></span>.
979 </p></div><div class="sect2" title="3.72. forward_edit"><div class="titlepage"><div><div><h3 class="title"><a id="forward-edit"></a>3.72. forward_edit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
980 Default: yes</p></div><p>
981 This quadoption controls whether or not the user is automatically
982 placed in the editor when forwarding messages. For those who always want
983 to forward with no modification, use a setting of <span class="quote">“<span class="quote">no</span>”</span>.
984 </p></div><div class="sect2" title="3.73. forward_format"><div class="titlepage"><div><div><h3 class="title"><a id="forward-format"></a>3.73. forward_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
985 Default: <span class="quote">“<span class="quote"><code class="literal">[%a: %s]</code></span>”</span></p></div><p>
986 This variable controls the default subject when forwarding a message.
987 It uses the same format sequences as the <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a> variable.
988 </p></div><div class="sect2" title="3.74. forward_quote"><div class="titlepage"><div><div><h3 class="title"><a id="forward-quote"></a>3.74. forward_quote</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
989 Default: no</p></div><p>
990 When <span class="emphasis"><em>set</em></span>, forwarded messages included in the main body of the
991 message (when <a class="link" href="reference.html#mime-forward" title="3.141. mime_forward">$mime_forward</a> is <span class="emphasis"><em>unset</em></span>) will be quoted using
992 <a class="link" href="reference.html#indent-string" title="3.113. indent_string">$indent_string</a>.
993 </p></div><div class="sect2" title="3.75. from"><div class="titlepage"><div><div><h3 class="title"><a id="from"></a>3.75. from</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />
994 Default: (empty)</p></div><p>
995 When <span class="emphasis"><em>set</em></span>, this variable contains a default from address. It
996 can be overridden using <span class="quote">“<span class="quote"><a class="link" href="configuration.html#my-hdr" title="15. 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="19. Change Settings Based Upon Message Recipients">send-hook</a></span>”</span>) and
997 <a class="link" href="reference.html#reverse-name" title="3.218. reverse_name">$reverse_name</a>. This variable is ignored if <a class="link" href="reference.html#use-from" title="3.300. use_from">$use_from</a> is <span class="emphasis"><em>unset</em></span>.
999 This setting defaults to the contents of the environment variable <code class="literal">$EMAIL</code>.
1000 </p></div><div class="sect2" title="3.76. gecos_mask"><div class="titlepage"><div><div><h3 class="title"><a id="gecos-mask"></a>3.76. gecos_mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1001 Default: <span class="quote">“<span class="quote"><code class="literal">^[^,]*</code></span>”</span></p></div><p>
1002 A regular expression used by mutt to parse the GECOS field of a password
1003 entry when expanding the alias. The default value
1004 will return the string up to the first <span class="quote">“<span class="quote">,</span>”</span> encountered.
1005 If the GECOS field contains a string like <span class="quote">“<span class="quote">lastname, firstname</span>”</span> then you
1006 should set it to <span class="quote">“<span class="quote"><code class="literal">.*</code></span>”</span>.
1008 This can be useful if you see the following behavior: you address an e-mail
1009 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
1010 <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.76. gecos_mask">$gecos_mask</a> to
1011 a regular expression that will match the whole name so mutt will expand
1012 <span class="quote">“<span class="quote">Franklin</span>”</span> to <span class="quote">“<span class="quote">Franklin, Steve</span>”</span>.
1013 </p></div><div class="sect2" title="3.77. hdrs"><div class="titlepage"><div><div><h3 class="title"><a id="hdrs"></a>3.77. hdrs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1014 Default: yes</p></div><p>
1015 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="15. User-Defined Headers">my_hdr</a></span>”</span>
1016 command are not created. This variable <span class="emphasis"><em>must</em></span> be unset before
1017 composing a new message or replying in order to take effect. If <span class="emphasis"><em>set</em></span>,
1018 the user defined header fields are added to every new message.
1019 </p></div><div class="sect2" title="3.78. header"><div class="titlepage"><div><div><h3 class="title"><a id="header"></a>3.78. header</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1020 Default: no</p></div><p>
1021 When <span class="emphasis"><em>set</em></span>, this variable causes Mutt to include the header
1022 of the message you are replying to into the edit buffer.
1023 The <a class="link" href="reference.html#weed" title="3.306. weed">$weed</a> setting applies.
1024 </p></div><div class="sect2" title="3.79. header_cache"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache"></a>3.79. header_cache</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1025 Default: (empty)</p></div><p>
1026 This variable points to the header cache database.
1027 If pointing to a directory Mutt will contain a header cache
1028 database file per folder, if pointing to a file that file will
1029 be a single global header cache. By default it is <span class="emphasis"><em>unset</em></span> so no header
1030 caching will be used.
1032 Header caching can greatly improve speed when opening POP, IMAP
1033 MH or Maildir folders, see <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#caching" title="7. Local Caching">caching</a></span>”</span> for details.
1034 </p></div><div class="sect2" title="3.80. header_cache_compress"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-compress"></a>3.80. header_cache_compress</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1035 Default: yes</p></div><p>
1036 When mutt is compiled with qdbm or tokyocabinet as header cache backend,
1037 this option determines whether the database will be compressed.
1038 Compression results in database files roughly being one fifth
1039 of the usual diskspace, but the decompression can result in a
1040 slower opening of cached folder(s) which in general is still
1041 much faster than opening non header cached folders.
1042 </p></div><div class="sect2" title="3.81. header_cache_pagesize"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-pagesize"></a>3.81. header_cache_pagesize</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1043 Default: <span class="quote">“<span class="quote"><code class="literal">16384</code></span>”</span></p></div><p>
1044 When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1045 this option changes the database page size. Too large or too small
1046 values can waste space, memory, or CPU time. The default should be more
1047 or less optimal for most use cases.
1048 </p></div><div class="sect2" title="3.82. help"><div class="titlepage"><div><div><h3 class="title"><a id="help"></a>3.82. help</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1049 Default: yes</p></div><p>
1050 When <span class="emphasis"><em>set</em></span>, help lines describing the bindings for the major functions
1051 provided by each menu are displayed on the first line of the screen.
1053 <span class="bold"><strong>Note:</strong></span> The binding will not be displayed correctly if the
1054 function is bound to a sequence rather than a single keystroke. Also,
1055 the help line may not be updated if a binding is changed while Mutt is
1056 running. Since this variable is primarily aimed at new users, neither
1057 of these should present a major problem.
1058 </p></div><div class="sect2" title="3.83. hidden_host"><div class="titlepage"><div><div><h3 class="title"><a id="hidden-host"></a>3.83. hidden_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1059 Default: no</p></div><p>
1060 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.93. hostname">$hostname</a> variable
1061 when adding the domain part to addresses. This variable does not
1062 affect the generation of Message-IDs, and it will not lead to the
1063 cut-off of first-level domains.
1064 </p></div><div class="sect2" title="3.84. hide_limited"><div class="titlepage"><div><div><h3 class="title"><a id="hide-limited"></a>3.84. hide_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1065 Default: no</p></div><p>
1066 When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of messages that are hidden
1067 by limiting, in the thread tree.
1068 </p></div><div class="sect2" title="3.85. hide_missing"><div class="titlepage"><div><div><h3 class="title"><a id="hide-missing"></a>3.85. hide_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1069 Default: yes</p></div><p>
1070 When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of missing messages in the
1072 </p></div><div class="sect2" title="3.86. hide_thread_subject"><div class="titlepage"><div><div><h3 class="title"><a id="hide-thread-subject"></a>3.86. hide_thread_subject</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1073 Default: yes</p></div><p>
1074 When <span class="emphasis"><em>set</em></span>, mutt will not show the subject of messages in the thread
1075 tree that have the same subject as their parent or closest previously
1077 </p></div><div class="sect2" title="3.87. hide_top_limited"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-limited"></a>3.87. hide_top_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1078 Default: no</p></div><p>
1079 When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of messages that are hidden
1080 by limiting, at the top of threads in the thread tree. Note that when
1081 <a class="link" href="reference.html#hide-limited" title="3.84. hide_limited">$hide_limited</a> is <span class="emphasis"><em>set</em></span>, this option will have no effect.
1082 </p></div><div class="sect2" title="3.88. hide_top_missing"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-missing"></a>3.88. hide_top_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1083 Default: yes</p></div><p>
1084 When <span class="emphasis"><em>set</em></span>, mutt will not show the presence of missing messages at the
1085 top of threads in the thread tree. Note that when <a class="link" href="reference.html#hide-missing" title="3.85. hide_missing">$hide_missing</a> is
1086 <span class="emphasis"><em>set</em></span>, this option will have no effect.
1087 </p></div><div class="sect2" title="3.89. history"><div class="titlepage"><div><div><h3 class="title"><a id="history"></a>3.89. history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1088 Default: 10</p></div><p>
1089 This variable controls the size (in number of strings remembered) of
1090 the string history buffer per category. The buffer is cleared each time the
1092 </p></div><div class="sect2" title="3.90. history_file"><div class="titlepage"><div><div><h3 class="title"><a id="history-file"></a>3.90. history_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1093 Default: <span class="quote">“<span class="quote"><code class="literal">~/.mutthistory</code></span>”</span></p></div><p>
1094 The file in which Mutt will save its history.
1095 </p></div><div class="sect2" title="3.91. honor_disposition"><div class="titlepage"><div><div><h3 class="title"><a id="honor-disposition"></a>3.91. honor_disposition</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1096 Default: no</p></div><p>
1097 When <span class="emphasis"><em>set</em></span>, Mutt will not display attachments with a
1098 disposition of <span class="quote">“<span class="quote">attachment</span>”</span> inline even if it could
1099 render the part to plain text. These MIME parts can only
1100 be viewed from the attachment menu.
1102 If <span class="emphasis"><em>unset</em></span>, Mutt will render all MIME parts it can
1103 properly transform to plain text.
1104 </p></div><div class="sect2" title="3.92. honor_followup_to"><div class="titlepage"><div><div><h3 class="title"><a id="honor-followup-to"></a>3.92. honor_followup_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1105 Default: yes</p></div><p>
1106 This variable controls whether or not a Mail-Followup-To header is
1107 honored when group-replying to a message.
1108 </p></div><div class="sect2" title="3.93. hostname"><div class="titlepage"><div><div><h3 class="title"><a id="hostname"></a>3.93. hostname</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1109 Default: (empty)</p></div><p>
1110 Specifies the fully-qualified hostname of the system mutt is running on
1111 containing the host's name and the DNS domain it belongs to. It is used
1112 as the domain part (after <span class="quote">“<span class="quote">@</span>”</span>) for local email addresses as well as
1115 Its value is determined at startup as follows: If the node's name
1116 as returned by the <code class="literal">uname(3)</code> function contains the hostname and the
1117 domain, these are used to construct <a class="link" href="reference.html#hostname" title="3.93. hostname">$hostname</a>. If there is no
1118 domain part returned, Mutt will look for a <span class="quote">“<span class="quote">domain</span>”</span> or <span class="quote">“<span class="quote">search</span>”</span>
1119 line in <code class="literal">/etc/resolv.conf</code> to determine the domain. Optionally, Mutt
1120 can be compiled with a fixed domain name in which case a detected
1123 Also see <a class="link" href="reference.html#use-domain" title="3.298. use_domain">$use_domain</a> and <a class="link" href="reference.html#hidden-host" title="3.83. hidden_host">$hidden_host</a>.
1124 </p></div><div class="sect2" title="3.94. ignore_linear_white_space"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-linear-white-space"></a>3.94. ignore_linear_white_space</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1125 Default: no</p></div><p>
1126 This option replaces linear-white-space between encoded-word
1127 and text to a single space to prevent the display of MIME-encoded
1128 <span class="quote">“<span class="quote">Subject:</span>”</span> field from being divided into multiple lines.
1129 </p></div><div class="sect2" title="3.95. ignore_list_reply_to"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-list-reply-to"></a>3.95. ignore_list_reply_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1130 Default: no</p></div><p>
1131 Affects the behavior of the <code class="literal"><reply></code> function when replying to
1132 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
1133 <span class="quote">“<span class="quote"><a class="link" href="configuration.html#lists" title="12. 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
1134 set to the same value as the <span class="quote">“<span class="quote">To:</span>”</span> field, Mutt assumes that the
1135 <span class="quote">“<span class="quote">Reply-To:</span>”</span> field was set by the mailing list to automate responses
1136 to the list, and will ignore this field. To direct a response to the
1137 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>
1138 function; <code class="literal"><group-reply></code> will reply to both the sender and the
1140 </p></div><div class="sect2" title="3.96. imap_authenticators"><div class="titlepage"><div><div><h3 class="title"><a id="imap-authenticators"></a>3.96. imap_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1141 Default: (empty)</p></div><p>
1142 This is a colon-delimited list of authentication methods mutt may
1143 attempt to use to log in to an IMAP server, in the order mutt should
1144 try them. Authentication methods are either <span class="quote">“<span class="quote">login</span>”</span> or the right
1145 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>
1146 or <span class="quote">“<span class="quote">cram-md5</span>”</span>. This option is case-insensitive. If it's
1147 <span class="emphasis"><em>unset</em></span> (the default) mutt will try all available methods,
1148 in order from most-secure to least-secure.
1152 </p><pre class="screen">
1153 set imap_authenticators="gssapi:cram-md5:login"
1155 <span class="bold"><strong>Note:</strong></span> Mutt will only fall back to other authentication methods if
1156 the previous methods are unavailable. If a method is available but
1157 authentication fails, mutt will not connect to the IMAP server.
1158 </p></div><div class="sect2" title="3.97. imap_check_subscribed"><div class="titlepage"><div><div><h3 class="title"><a id="imap-check-subscribed"></a>3.97. imap_check_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1159 Default: no</p></div><p>
1160 When <span class="emphasis"><em>set</em></span>, mutt will fetch the set of subscribed folders from
1161 your server on connection, and add them to the set of mailboxes
1162 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="14. Monitoring Incoming Mail">mailboxes</a></span>”</span>
1164 </p></div><div class="sect2" title="3.98. imap_delim_chars"><div class="titlepage"><div><div><h3 class="title"><a id="imap-delim-chars"></a>3.98. imap_delim_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1165 Default: <span class="quote">“<span class="quote"><code class="literal">/.</code></span>”</span></p></div><p>
1166 This contains the list of characters which you would like to treat
1167 as folder separators for displaying IMAP paths. In particular it
1168 helps in using the <span class="quote">“<span class="quote">=</span>”</span> shortcut for your <span class="emphasis"><em>folder</em></span> variable.
1169 </p></div><div class="sect2" title="3.99. imap_headers"><div class="titlepage"><div><div><h3 class="title"><a id="imap-headers"></a>3.99. imap_headers</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1170 Default: (empty)</p></div><p>
1171 Mutt requests these header fields in addition to the default headers
1172 (<span class="quote">“<span class="quote">Date:</span>”</span>, <span class="quote">“<span class="quote">From:</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>,
1173 <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>,
1174 <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
1175 servers before displaying the index menu. You may want to add more
1176 headers for spam detection.
1178 <span class="bold"><strong>Note:</strong></span> This is a space separated list, items should be uppercase
1179 and not contain the colon, e.g. <span class="quote">“<span class="quote">X-BOGOSITY X-SPAM-STATUS</span>”</span> for the
1180 <span class="quote">“<span class="quote">X-Bogosity:</span>”</span> and <span class="quote">“<span class="quote">X-Spam-Status:</span>”</span> header fields.
1181 </p></div><div class="sect2" title="3.100. imap_idle"><div class="titlepage"><div><div><h3 class="title"><a id="imap-idle"></a>3.100. imap_idle</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1182 Default: no</p></div><p>
1183 When <span class="emphasis"><em>set</em></span>, mutt will attempt to use the IMAP IDLE extension
1184 to check for new mail in the current mailbox. Some servers
1185 (dovecot was the inspiration for this option) react badly
1186 to mutt's implementation. If your connection seems to freeze
1187 up periodically, try unsetting this.
1188 </p></div><div class="sect2" title="3.101. imap_keepalive"><div class="titlepage"><div><div><h3 class="title"><a id="imap-keepalive"></a>3.101. imap_keepalive</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1189 Default: 900</p></div><p>
1190 This variable specifies the maximum amount of time in seconds that mutt
1191 will wait before polling open IMAP connections, to prevent the server
1192 from closing them before mutt has finished with them. The default is
1193 well within the RFC-specified minimum amount of time (30 minutes) before
1194 a server is allowed to do this, but in practice the RFC does get
1195 violated every now and then. Reduce this number if you find yourself
1196 getting disconnected from your IMAP server due to inactivity.
1197 </p></div><div class="sect2" title="3.102. imap_list_subscribed"><div class="titlepage"><div><div><h3 class="title"><a id="imap-list-subscribed"></a>3.102. imap_list_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1198 Default: no</p></div><p>
1199 This variable configures whether IMAP folder browsing will look for
1200 only subscribed folders or all folders. This can be toggled in the
1201 IMAP browser with the <code class="literal"><toggle-subscribed></code> function.
1202 </p></div><div class="sect2" title="3.103. imap_login"><div class="titlepage"><div><div><h3 class="title"><a id="imap-login"></a>3.103. imap_login</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1203 Default: (empty)</p></div><p>
1204 Your login name on the IMAP server.
1206 This variable defaults to the value of <a class="link" href="reference.html#imap-user" title="3.109. imap_user">$imap_user</a>.
1207 </p></div><div class="sect2" title="3.104. imap_pass"><div class="titlepage"><div><div><h3 class="title"><a id="imap-pass"></a>3.104. imap_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1208 Default: (empty)</p></div><p>
1209 Specifies the password for your IMAP account. If <span class="emphasis"><em>unset</em></span>, Mutt will
1210 prompt you for your password when you invoke the <code class="literal"><imap-fetch-mail></code> function
1211 or try to open an IMAP folder.
1213 <span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a
1214 fairly secure machine, because the superuser can read your muttrc even
1215 if you are the only one who can read the file.
1216 </p></div><div class="sect2" title="3.105. imap_passive"><div class="titlepage"><div><div><h3 class="title"><a id="imap-passive"></a>3.105. imap_passive</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1217 Default: yes</p></div><p>
1218 When <span class="emphasis"><em>set</em></span>, mutt will not open new IMAP connections to check for new
1219 mail. Mutt will only check for new mail over existing IMAP
1220 connections. This is useful if you don't want to be prompted to
1221 user/password pairs on mutt invocation, or if opening the connection
1223 </p></div><div class="sect2" title="3.106. imap_peek"><div class="titlepage"><div><div><h3 class="title"><a id="imap-peek"></a>3.106. imap_peek</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1224 Default: yes</p></div><p>
1225 When <span class="emphasis"><em>set</em></span>, mutt will avoid implicitly marking your mail as read whenever
1226 you fetch a message from the server. This is generally a good thing,
1227 but can make closing an IMAP folder somewhat slower. This option
1228 exists to appease speed freaks.
1229 </p></div><div class="sect2" title="3.107. imap_pipeline_depth"><div class="titlepage"><div><div><h3 class="title"><a id="imap-pipeline-depth"></a>3.107. imap_pipeline_depth</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1230 Default: 15</p></div><p>
1231 Controls the number of IMAP commands that may be queued up before they
1232 are sent to the server. A deeper pipeline reduces the amount of time
1233 mutt must wait for the server, and can make IMAP servers feel much
1234 more responsive. But not all servers correctly handle pipelined commands,
1235 so if you have problems you might want to try setting this variable to 0.
1237 <span class="bold"><strong>Note:</strong></span> Changes to this variable have no effect on open connections.
1238 </p></div><div class="sect2" title="3.108. imap_servernoise"><div class="titlepage"><div><div><h3 class="title"><a id="imap-servernoise"></a>3.108. imap_servernoise</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1239 Default: yes</p></div><p>
1240 When <span class="emphasis"><em>set</em></span>, mutt will display warning messages from the IMAP
1241 server as error messages. Since these messages are often
1242 harmless, or generated due to configuration problems on the
1243 server which are out of the users' hands, you may wish to suppress
1245 </p></div><div class="sect2" title="3.109. imap_user"><div class="titlepage"><div><div><h3 class="title"><a id="imap-user"></a>3.109. imap_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1246 Default: (empty)</p></div><p>
1247 The name of the user whose mail you intend to access on the IMAP
1250 This variable defaults to your user name on the local machine.
1251 </p></div><div class="sect2" title="3.110. implicit_autoview"><div class="titlepage"><div><div><h3 class="title"><a id="implicit-autoview"></a>3.110. implicit_autoview</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1252 Default: no</p></div><p>
1253 If set to <span class="quote">“<span class="quote">yes</span>”</span>, mutt will look for a mailcap entry with the
1254 <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
1255 an internal viewer defined for. If such an entry is found, mutt will
1256 use the viewer defined in that entry to convert the body part to text
1258 </p></div><div class="sect2" title="3.111. include"><div class="titlepage"><div><div><h3 class="title"><a id="include"></a>3.111. include</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1259 Default: ask-yes</p></div><p>
1260 Controls whether or not a copy of the message(s) you are replying to
1261 is included in your reply.
1262 </p></div><div class="sect2" title="3.112. include_onlyfirst"><div class="titlepage"><div><div><h3 class="title"><a id="include-onlyfirst"></a>3.112. include_onlyfirst</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1263 Default: no</p></div><p>
1264 Controls whether or not Mutt includes only the first attachment
1265 of the message you are replying.
1266 </p></div><div class="sect2" title="3.113. indent_string"><div class="titlepage"><div><div><h3 class="title"><a id="indent-string"></a>3.113. indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1267 Default: <span class="quote">“<span class="quote"><code class="literal">> </code></span>”</span></p></div><p>
1268 Specifies the string to prepend to each line of text quoted in a
1269 message to which you are replying. You are strongly encouraged not to
1270 change this value, as it tends to agitate the more fanatical netizens.
1272 The value of this option is ignored if <a class="link" href="reference.html#text-flowed" title="3.287. text_flowed">$text_flowed</a> is set, too because
1273 the quoting mechanism is strictly defined for format=flowed.
1275 This option is a format string, please see the description of
1276 <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a> for supported <code class="literal">printf(3)</code>-style sequences.
1277 </p></div><div class="sect2" title="3.114. index_format"><div class="titlepage"><div><div><h3 class="title"><a id="index-format"></a>3.114. index_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1278 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>
1279 This variable allows you to customize the message index display to
1280 your personal taste.
1282 <span class="quote">“<span class="quote">Format strings</span>”</span> are similar to the strings used in the C
1283 function <code class="literal">printf(3)</code> to format output (see the man page for more details).
1284 The following sequences are defined in Mutt:
1286 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>address of the author
1287 </td></tr><tr><td>%A </td><td>reply-to address (if present; otherwise: address of author)
1288 </td></tr><tr><td>%b </td><td>filename of the original message folder (think mailbox)
1289 </td></tr><tr><td>%B </td><td>the list to which the letter was sent, or else the folder name (%b).
1290 </td></tr><tr><td>%c </td><td>number of characters (bytes) in the message
1291 </td></tr><tr><td>%C </td><td>current message number
1292 </td></tr><tr><td>%d </td><td>date and time of the message in the format specified by
1293 <a class="link" href="reference.html#date-format" title="3.47. date_format">$date_format</a> converted to sender's time zone
1294 </td></tr><tr><td>%D </td><td>date and time of the message in the format specified by
1295 <a class="link" href="reference.html#date-format" title="3.47. date_format">$date_format</a> converted to the local time zone
1296 </td></tr><tr><td>%e </td><td>current message number in thread
1297 </td></tr><tr><td>%E </td><td>number of messages in current thread
1298 </td></tr><tr><td>%f </td><td>sender (address + real name), either From: or Return-Path:
1299 </td></tr><tr><td>%F </td><td>author name, or recipient name if the message is from you
1300 </td></tr><tr><td>%H </td><td>spam attribute(s) of this message
1301 </td></tr><tr><td>%i </td><td>message-id of the current message
1302 </td></tr><tr><td>%l </td><td>number of lines in the message (does not work with maildir,
1303 mh, and possibly IMAP folders)
1304 </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
1305 defined by the users <span class="quote">“<span class="quote"><a class="link" href="configuration.html#subscribe">subscribe</a></span>”</span> command, this displays
1306 "To <list-name>", otherwise the same as %F.
1307 </td></tr><tr><td>%m </td><td>total number of message in the mailbox
1308 </td></tr><tr><td>%M </td><td>number of hidden messages if the thread is collapsed.
1309 </td></tr><tr><td>%N </td><td>message score
1310 </td></tr><tr><td>%n </td><td>author's real name (or address if missing)
1311 </td></tr><tr><td>%O </td><td>original save folder where mutt would formerly have
1312 stashed the message: list name or recipient name
1313 if not sent to a list
1314 </td></tr><tr><td>%P </td><td>progress indicator for the built-in pager (how much of the file has been displayed)
1315 </td></tr><tr><td>%s </td><td>subject of the message
1316 </td></tr><tr><td>%S </td><td>status of the message (<span class="quote">“<span class="quote">N</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>/*)
1317 </td></tr><tr><td>%t </td><td><span class="quote">“<span class="quote">To:</span>”</span> field (recipients)
1318 </td></tr><tr><td>%T </td><td>the appropriate character from the <a class="link" href="reference.html#to-chars" title="3.294. to_chars">$to_chars</a> string
1319 </td></tr><tr><td>%u </td><td>user (login) name of the author
1320 </td></tr><tr><td>%v </td><td>first name of the author, or the recipient if the message is from you
1321 </td></tr><tr><td>%X </td><td>number of attachments
1322 (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)
1323 </td></tr><tr><td>%y </td><td><span class="quote">“<span class="quote">X-Label:</span>”</span> field, if present
1324 </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,
1325 <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
1326 preceding message's <span class="quote">“<span class="quote">X-Label:</span>”</span>.
1327 </td></tr><tr><td>%Z </td><td>message status flags
1328 </td></tr><tr><td>%{fmt} </td><td>the date and time of the message is converted to sender's
1329 time zone, and <span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library function
1330 <code class="literal">strftime(3)</code>; a leading bang disables locales
1331 </td></tr><tr><td>%[fmt] </td><td>the date and time of the message is converted to the local
1332 time zone, and <span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library function
1333 <code class="literal">strftime(3)</code>; a leading bang disables locales
1334 </td></tr><tr><td>%(fmt) </td><td>the local date and time when the message was received.
1335 <span class="quote">“<span class="quote">fmt</span>”</span> is expanded by the library function <code class="literal">strftime(3)</code>;
1336 a leading bang disables locales
1337 </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
1338 function <code class="literal">strftime(3)</code>; a leading bang disables locales.
1339 </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>
1340 </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>
1341 </td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
1342 </td></tr></tbody></table></div><p>
1343 <span class="quote">“<span class="quote">Soft-fill</span>”</span> deserves some explanation: Normal right-justification
1344 will print everything to the left of the <span class="quote">“<span class="quote">%></span>”</span>, displaying padding and
1345 whatever lies to the right only if there's room. By contrast,
1346 soft-fill gives priority to the right-hand side, guaranteeing space
1347 to display it and showing padding only if there's still room. If
1348 necessary, soft-fill will eat text leftwards to make room for
1351 Note that these expandos are supported in
1352 <span class="quote">“<span class="quote"><a class="link" href="configuration.html#save-hook" title="16. Specify Default Save Mailbox">save-hook</a></span>”</span>, <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. 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="18. Specify Default Save Filename and Default Fcc: Mailbox at Once">fcc-save-hook</a></span>”</span>, too.
1353 </p></div><div class="sect2" title="3.115. ispell"><div class="titlepage"><div><div><h3 class="title"><a id="ispell"></a>3.115. ispell</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1354 Default: <span class="quote">“<span class="quote"><code class="literal">ispell</code></span>”</span></p></div><p>
1355 How to invoke ispell (GNU's spell-checking software).
1356 </p></div><div class="sect2" title="3.116. keep_flagged"><div class="titlepage"><div><div><h3 class="title"><a id="keep-flagged"></a>3.116. keep_flagged</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1357 Default: no</p></div><p>
1358 If <span class="emphasis"><em>set</em></span>, read messages marked as flagged will not be moved
1359 from your spool mailbox to your <a class="link" href="reference.html#mbox" title="3.127. mbox">$mbox</a> mailbox, or as a result of
1360 a <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mbox-hook" title="13. Using Multiple Spool Mailboxes">mbox-hook</a></span>”</span> command.
1361 </p></div><div class="sect2" title="3.117. locale"><div class="titlepage"><div><div><h3 class="title"><a id="locale"></a>3.117. locale</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1362 Default: <span class="quote">“<span class="quote"><code class="literal">C</code></span>”</span></p></div><p>
1363 The locale used by <code class="literal">strftime(3)</code> to format dates. Legal values are
1364 the strings your system accepts for the locale environment variable <code class="literal">$LC_TIME</code>.
1365 </p></div><div class="sect2" title="3.118. mail_check"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check"></a>3.118. mail_check</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1366 Default: 5</p></div><p>
1367 This variable configures how often (in seconds) mutt should look for
1368 new mail. Also see the <a class="link" href="reference.html#timeout" title="3.292. timeout">$timeout</a> variable.
1369 </p></div><div class="sect2" title="3.119. mail_check_recent"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check-recent"></a>3.119. mail_check_recent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1370 Default: yes</p></div><p>
1371 When <span class="emphasis"><em>set</em></span>, Mutt will only notify you about new mail that has been received
1372 since the last time you opened the mailbox. When <span class="emphasis"><em>unset</em></span>, Mutt will notify you
1373 if any new mail exists in the mailbox, regardless of whether you have visited it
1376 When <span class="emphasis"><em><a class="link" href="reference.html#mark-old" title="3.124. mark_old">$mark_old</a></em></span> is set, Mutt does not consider the mailbox to contain new
1377 mail if only old messages exist.
1378 </p></div><div class="sect2" title="3.120. mailcap_path"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-path"></a>3.120. mailcap_path</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1379 Default: (empty)</p></div><p>
1380 This variable specifies which files to consult when attempting to
1381 display MIME bodies not directly supported by Mutt.
1382 </p></div><div class="sect2" title="3.121. mailcap_sanitize"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-sanitize"></a>3.121. mailcap_sanitize</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1383 Default: yes</p></div><p>
1384 If <span class="emphasis"><em>set</em></span>, mutt will restrict possible characters in mailcap % expandos
1385 to a well-defined set of safe characters. This is the safe setting,
1386 but we are not sure it doesn't break some more advanced MIME stuff.
1388 <span class="bold"><strong>DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
1389 DOING!</strong></span>
1390 </p></div><div class="sect2" title="3.122. maildir_header_cache_verify"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.122. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1391 Default: yes</p></div><p>
1392 Check for Maildir unaware programs other than mutt having modified maildir
1393 files when the header cache is in use. This incurs one <code class="literal">stat(2)</code> per
1394 message every time the folder is opened (which can be very slow for NFS
1396 </p></div><div class="sect2" title="3.123. maildir_trash"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.123. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1397 Default: no</p></div><p>
1398 If <span class="emphasis"><em>set</em></span>, messages marked as deleted will be saved with the maildir
1399 trashed flag instead of unlinked. <span class="bold"><strong>Note:</strong></span> this only applies
1400 to maildir-style mailboxes. Setting it will have no effect on other
1402 </p></div><div class="sect2" title="3.124. mark_old"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.124. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1403 Default: yes</p></div><p>
1404 Controls whether or not mutt marks <span class="emphasis"><em>new</em></span> <span class="bold"><strong>unread</strong></span>
1405 messages as <span class="emphasis"><em>old</em></span> if you exit a mailbox without reading them.
1406 With this option <span class="emphasis"><em>set</em></span>, the next time you start mutt, the messages
1407 will show up with an <span class="quote">“<span class="quote">O</span>”</span> next to them in the index menu,
1408 indicating that they are old.
1409 </p></div><div class="sect2" title="3.125. markers"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.125. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1410 Default: yes</p></div><p>
1411 Controls the display of wrapped lines in the internal pager. If set, a
1412 <span class="quote">“<span class="quote">+</span>”</span> marker is displayed at the beginning of wrapped lines.
1414 Also see the <a class="link" href="reference.html#smart-wrap" title="3.239. smart_wrap">$smart_wrap</a> variable.
1415 </p></div><div class="sect2" title="3.126. mask"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.126. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1416 Default: <span class="quote">“<span class="quote"><code class="literal">!^\.[^.]</code></span>”</span></p></div><p>
1417 A regular expression used in the file browser, optionally preceded by
1418 the <span class="emphasis"><em>not</em></span> operator <span class="quote">“<span class="quote">!</span>”</span>. Only files whose names match this mask
1419 will be shown. The match is always case-sensitive.
1420 </p></div><div class="sect2" title="3.127. mbox"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.127. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1421 Default: <span class="quote">“<span class="quote"><code class="literal">~/mbox</code></span>”</span></p></div><p>
1422 This specifies the folder into which read mail in your <a class="link" href="reference.html#spoolfile" title="3.270. spoolfile">$spoolfile</a>
1423 folder will be appended.
1425 Also see the <a class="link" href="reference.html#move" title="3.146. move">$move</a> variable.
1426 </p></div><div class="sect2" title="3.128. mbox_type"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.128. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />
1427 Default: mbox</p></div><p>
1428 The default mailbox type used when creating new folders. May be any of
1429 <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
1430 <code class="literal">-m</code> command-line option.
1431 </p></div><div class="sect2" title="3.129. menu_context"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.129. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1432 Default: 0</p></div><p>
1433 This variable controls the number of lines of context that are given
1434 when scrolling through menus. (Similar to <a class="link" href="reference.html#pager-context" title="3.150. pager_context">$pager_context</a>.)
1435 </p></div><div class="sect2" title="3.130. menu_move_off"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.130. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1436 Default: yes</p></div><p>
1437 When <span class="emphasis"><em>unset</em></span>, the bottom entry of menus will never scroll up past
1438 the bottom of the screen, unless there are less entries than lines.
1439 When <span class="emphasis"><em>set</em></span>, the bottom entry may move off the bottom.
1440 </p></div><div class="sect2" title="3.131. menu_scroll"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.131. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1441 Default: no</p></div><p>
1442 When <span class="emphasis"><em>set</em></span>, menus will be scrolled up or down one line when you
1443 attempt to move across a screen boundary. If <span class="emphasis"><em>unset</em></span>, the screen
1444 is cleared and the next or previous page of the menu is displayed
1445 (useful for slow links to avoid many redraws).
1446 </p></div><div class="sect2" title="3.132. message_cache_clean"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.132. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1447 Default: no</p></div><p>
1448 If <span class="emphasis"><em>set</em></span>, mutt will clean out obsolete entries from the message cache when
1449 the mailbox is synchronized. You probably only want to set it
1450 every once in a while, since it can be a little slow
1451 (especially for large folders).
1452 </p></div><div class="sect2" title="3.133. message_cachedir"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.133. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1453 Default: (empty)</p></div><p>
1454 Set this to a directory and mutt will cache copies of messages from
1455 your IMAP and POP servers here. You are free to remove entries at any
1458 When setting this variable to a directory, mutt needs to fetch every
1459 remote message only once and can perform regular expression searches
1460 as fast as for local folders.
1462 Also see the <a class="link" href="reference.html#message-cache-clean" title="3.132. message_cache_clean">$message_cache_clean</a> variable.
1463 </p></div><div class="sect2" title="3.134. message_format"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.134. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1464 Default: <span class="quote">“<span class="quote"><code class="literal">%s</code></span>”</span></p></div><p>
1465 This is the string displayed in the <span class="quote">“<span class="quote">attachment</span>”</span> menu for
1466 attachments of type <code class="literal">message/rfc822</code>. For a full listing of defined
1467 <code class="literal">printf(3)</code>-like sequences see the section on <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>.
1468 </p></div><div class="sect2" title="3.135. meta_key"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.135. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1469 Default: no</p></div><p>
1470 If <span class="emphasis"><em>set</em></span>, forces Mutt to interpret keystrokes with the high bit (bit 8)
1471 set as if the user had pressed the Esc key and whatever key remains
1472 after having the high bit removed. For example, if the key pressed
1473 has an ASCII value of <code class="literal">0xf8</code>, then this is treated as if the user had
1474 pressed Esc then <span class="quote">“<span class="quote">x</span>”</span>. This is because the result of removing the
1475 high bit from <code class="literal">0xf8</code> is <code class="literal">0x78</code>, which is the ASCII character
1476 <span class="quote">“<span class="quote">x</span>”</span>.
1477 </p></div><div class="sect2" title="3.136. metoo"><div class="titlepage"><div><div><h3 class="title"><a id="metoo"></a>3.136. metoo</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1478 Default: no</p></div><p>
1479 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="11. Alternative Addresses">alternates</a></span>”</span>
1480 command) from the list of recipients when replying to a message.
1481 </p></div><div class="sect2" title="3.137. mh_purge"><div class="titlepage"><div><div><h3 class="title"><a id="mh-purge"></a>3.137. mh_purge</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1482 Default: no</p></div><p>
1483 When <span class="emphasis"><em>unset</em></span>, mutt will mimic mh's behavior and rename deleted messages
1484 to <span class="emphasis"><em>,<old file name></em></span> in mh folders instead of really deleting
1485 them. This leaves the message on disk but makes programs reading the folder
1486 ignore it. If the variable is <span class="emphasis"><em>set</em></span>, the message files will simply be
1489 This option is similar to <a class="link" href="reference.html#maildir-trash" title="3.123. maildir_trash">$maildir_trash</a> for Maildir folders.
1490 </p></div><div class="sect2" title="3.138. mh_seq_flagged"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-flagged"></a>3.138. mh_seq_flagged</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1491 Default: <span class="quote">“<span class="quote"><code class="literal">flagged</code></span>”</span></p></div><p>
1492 The name of the MH sequence used for flagged messages.
1493 </p></div><div class="sect2" title="3.139. mh_seq_replied"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-replied"></a>3.139. mh_seq_replied</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1494 Default: <span class="quote">“<span class="quote"><code class="literal">replied</code></span>”</span></p></div><p>
1495 The name of the MH sequence used to tag replied messages.
1496 </p></div><div class="sect2" title="3.140. mh_seq_unseen"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-unseen"></a>3.140. mh_seq_unseen</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1497 Default: <span class="quote">“<span class="quote"><code class="literal">unseen</code></span>”</span></p></div><p>
1498 The name of the MH sequence used for unseen messages.
1499 </p></div><div class="sect2" title="3.141. mime_forward"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward"></a>3.141. mime_forward</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1500 Default: no</p></div><p>
1501 When <span class="emphasis"><em>set</em></span>, the message you are forwarding will be attached as a
1502 separate <code class="literal">message/rfc822</code> MIME part instead of included in the main body of the
1503 message. This is useful for forwarding MIME messages so the receiver
1504 can properly view the message as it was delivered to you. If you like
1505 to switch between MIME and not MIME from mail to mail, set this
1506 variable to <span class="quote">“<span class="quote">ask-no</span>”</span> or <span class="quote">“<span class="quote">ask-yes</span>”</span>.
1508 Also see <a class="link" href="reference.html#forward-decode" title="3.70. forward_decode">$forward_decode</a> and <a class="link" href="reference.html#mime-forward-decode" title="3.142. mime_forward_decode">$mime_forward_decode</a>.
1509 </p></div><div class="sect2" title="3.142. mime_forward_decode"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.142. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1510 Default: no</p></div><p>
1511 Controls the decoding of complex MIME messages into <code class="literal">text/plain</code> when
1512 forwarding a message while <a class="link" href="reference.html#mime-forward" title="3.141. mime_forward">$mime_forward</a> is <span class="emphasis"><em>set</em></span>. Otherwise
1513 <a class="link" href="reference.html#forward-decode" title="3.70. forward_decode">$forward_decode</a> is used instead.
1514 </p></div><div class="sect2" title="3.143. mime_forward_rest"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.143. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1515 Default: yes</p></div><p>
1516 When forwarding multiple attachments of a MIME message from the attachment
1517 menu, attachments which cannot be decoded in a reasonable manner will
1518 be attached to the newly composed message if this option is <span class="emphasis"><em>set</em></span>.
1519 </p></div><div class="sect2" title="3.144. mix_entry_format"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.144. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1520 Default: <span class="quote">“<span class="quote"><code class="literal">%4n %c %-16s %a</code></span>”</span></p></div><p>
1521 This variable describes the format of a remailer line on the mixmaster
1522 chain selection screen. The following <code class="literal">printf(3)</code>-like sequences are
1525 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>The running number on the menu.
1526 </td></tr><tr><td>%c </td><td>Remailer capabilities.
1527 </td></tr><tr><td>%s </td><td>The remailer's short name.
1528 </td></tr><tr><td>%a </td><td>The remailer's e-mail address.
1529 </td></tr></tbody></table></div></div><div class="sect2" title="3.145. mixmaster"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.145. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1530 Default: <span class="quote">“<span class="quote"><code class="literal">mixmaster</code></span>”</span></p></div><p>
1531 This variable contains the path to the Mixmaster binary on your
1532 system. It is used with various sets of parameters to gather the
1533 list of known remailers, and to finally send a message through the
1535 </p></div><div class="sect2" title="3.146. move"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.146. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1536 Default: no</p></div><p>
1537 Controls whether or not Mutt will move read messages
1538 from your spool mailbox to your <a class="link" href="reference.html#mbox" title="3.127. mbox">$mbox</a> mailbox, or as a result of
1539 a <span class="quote">“<span class="quote"><a class="link" href="configuration.html#mbox-hook" title="13. Using Multiple Spool Mailboxes">mbox-hook</a></span>”</span> command.
1540 </p></div><div class="sect2" title="3.147. narrow_tree"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.147. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1541 Default: no</p></div><p>
1542 This variable, when <span class="emphasis"><em>set</em></span>, makes the thread tree narrower, allowing
1543 deeper threads to fit on the screen.
1544 </p></div><div class="sect2" title="3.148. net_inc"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.148. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1545 Default: 10</p></div><p>
1546 Operations that expect to transfer a large amount of data over the
1547 network will update their progress every <a class="link" href="reference.html#net-inc" title="3.148. net_inc">$net_inc</a> kilobytes.
1548 If set to 0, no progress messages will be displayed.
1550 See also <a class="link" href="reference.html#read-inc" title="3.208. read_inc">$read_inc</a>, <a class="link" href="reference.html#write-inc" title="3.312. write_inc">$write_inc</a> and <a class="link" href="reference.html#net-inc" title="3.148. net_inc">$net_inc</a>.
1551 </p></div><div class="sect2" title="3.149. pager"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.149. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1552 Default: <span class="quote">“<span class="quote"><code class="literal">builtin</code></span>”</span></p></div><p>
1553 This variable specifies which pager you would like to use to view
1554 messages. The value <span class="quote">“<span class="quote">builtin</span>”</span> means to use the built-in pager, otherwise this
1555 variable should specify the pathname of the external pager you would
1558 Using an external pager may have some disadvantages: Additional
1559 keystrokes are necessary because you can't call mutt functions
1560 directly from the pager, and screen resizes cause lines longer than
1561 the screen width to be badly formatted in the help menu.
1562 </p></div><div class="sect2" title="3.150. pager_context"><div class="titlepage"><div><div><h3 class="title"><a id="pager-context"></a>3.150. pager_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1563 Default: 0</p></div><p>
1564 This variable controls the number of lines of context that are given
1565 when displaying the next or previous page in the internal pager. By
1566 default, Mutt will display the line after the last one on the screen
1567 at the top of the next page (0 lines of context).
1569 This variable also specifies the amount of context given for search
1570 results. If positive, this many lines will be given before a match,
1571 if 0, the match will be top-aligned.
1572 </p></div><div class="sect2" title="3.151. pager_format"><div class="titlepage"><div><div><h3 class="title"><a id="pager-format"></a>3.151. pager_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1573 Default: <span class="quote">“<span class="quote"><code class="literal">-%Z- %C/%m: %-20.20n %s%* -- (%P)</code></span>”</span></p></div><p>
1574 This variable controls the format of the one-line message <span class="quote">“<span class="quote">status</span>”</span>
1575 displayed before each message in either the internal or an external
1576 pager. The valid sequences are listed in the <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>
1578 </p></div><div class="sect2" title="3.152. pager_index_lines"><div class="titlepage"><div><div><h3 class="title"><a id="pager-index-lines"></a>3.152. pager_index_lines</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1579 Default: 0</p></div><p>
1580 Determines the number of lines of a mini-index which is shown when in
1581 the pager. The current message, unless near the top or bottom of the
1582 folder, will be roughly one third of the way down this mini-index,
1583 giving the reader the context of a few messages before and after the
1584 message. This is useful, for example, to determine how many messages
1585 remain to be read in the current thread. One of the lines is reserved
1586 for the status bar from the index, so a setting of 6
1587 will only show 5 lines of the actual index. A value of 0 results in
1588 no index being shown. If the number of messages in the current folder
1589 is less than <a class="link" href="reference.html#pager-index-lines" title="3.152. pager_index_lines">$pager_index_lines</a>, then the index will only use as
1590 many lines as it needs.
1591 </p></div><div class="sect2" title="3.153. pager_stop"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.153. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1592 Default: no</p></div><p>
1593 When <span class="emphasis"><em>set</em></span>, the internal-pager will <span class="bold"><strong>not</strong></span> move to the next message
1594 when you are at the end of a message and invoke the <code class="literal"><next-page></code>
1596 </p></div><div class="sect2" title="3.154. pgp_auto_decode"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.154. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1597 Default: no</p></div><p>
1598 If <span class="emphasis"><em>set</em></span>, mutt will automatically attempt to decrypt traditional PGP
1599 messages whenever the user performs an operation which ordinarily would
1600 result in the contents of the message being operated on. For example,
1601 if the user displays a pgp-traditional message which has not been manually
1602 checked with the <code class="literal"><a class="link" href="gettingstarted.html#check-traditional-pgp"><check-traditional-pgp></a></code> function, mutt will automatically
1603 check the message for traditional pgp.
1604 </p></div><div class="sect2" title="3.155. pgp_autoinline"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.155. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1605 Default: no</p></div><p>
1606 This option controls whether Mutt generates old-style inline
1607 (traditional) PGP encrypted or signed messages under certain
1608 circumstances. This can be overridden by use of the pgp menu,
1609 when inline is not required.
1611 Note that Mutt might automatically use PGP/MIME for messages
1612 which consist of more than a single MIME part. Mutt can be
1613 configured to ask before sending PGP/MIME messages when inline
1614 (traditional) would not work.
1616 Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.171. pgp_mime_auto">$pgp_mime_auto</a> variable.
1618 Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1619 <span class="bold"><strong>deprecated</strong></span>.
1621 </p></div><div class="sect2" title="3.156. pgp_check_exit"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.156. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1622 Default: yes</p></div><p>
1623 If <span class="emphasis"><em>set</em></span>, mutt will check the exit code of the PGP subprocess when
1624 signing or encrypting. A non-zero exit code means that the
1627 </p></div><div class="sect2" title="3.157. pgp_clearsign_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.157. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1628 Default: (empty)</p></div><p>
1629 This format is used to create an old-style <span class="quote">“<span class="quote">clearsigned</span>”</span> PGP
1630 message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>
1631 <span class="bold"><strong>deprecated</strong></span>.
1633 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1634 possible <code class="literal">printf(3)</code>-like sequences.
1636 </p></div><div class="sect2" title="3.158. pgp_decode_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.158. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1637 Default: (empty)</p></div><p>
1638 This format strings specifies a command which is used to decode
1639 application/pgp attachments.
1641 The PGP command formats have their own set of <code class="literal">printf(3)</code>-like sequences:
1643 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%p </td><td>Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
1644 string otherwise. Note: This may be used with a %? construct.
1645 </td></tr><tr><td>%f </td><td>Expands to the name of a file containing a message.
1646 </td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
1647 of a <code class="literal">multipart/signed</code> attachment when verifying it.
1648 </td></tr><tr><td>%a </td><td>The value of <a class="link" href="reference.html#pgp-sign-as" title="3.175. pgp_sign_as">$pgp_sign_as</a>.
1649 </td></tr><tr><td>%r </td><td>One or more key IDs.
1650 </td></tr></tbody></table></div><p>
1651 For examples on how to configure these formats for the various versions
1652 of PGP which are floating around, see the pgp and gpg sample configuration files in
1653 the <code class="literal">samples/</code> subdirectory which has been installed on your system
1654 alongside the documentation.
1656 </p></div><div class="sect2" title="3.159. pgp_decrypt_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.159. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1657 Default: (empty)</p></div><p>
1658 This command is used to decrypt a PGP encrypted message.
1660 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1661 possible <code class="literal">printf(3)</code>-like sequences.
1663 </p></div><div class="sect2" title="3.160. pgp_encrypt_only_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.160. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1664 Default: (empty)</p></div><p>
1665 This command is used to encrypt a body part without signing it.
1667 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1668 possible <code class="literal">printf(3)</code>-like sequences.
1670 </p></div><div class="sect2" title="3.161. pgp_encrypt_sign_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.161. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1671 Default: (empty)</p></div><p>
1672 This command is used to both sign and encrypt a body part.
1674 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1675 possible <code class="literal">printf(3)</code>-like sequences.
1677 </p></div><div class="sect2" title="3.162. pgp_entry_format"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.162. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1678 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>
1679 This variable allows you to customize the PGP key selection menu to
1680 your personal taste. This string is similar to <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>, but
1681 has its own set of <code class="literal">printf(3)</code>-like sequences:
1683 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%n </td><td>number
1684 </td></tr><tr><td>%k </td><td>key id
1685 </td></tr><tr><td>%u </td><td>user id
1686 </td></tr><tr><td>%a </td><td>algorithm
1687 </td></tr><tr><td>%l </td><td>key length
1688 </td></tr><tr><td>%f </td><td>flags
1689 </td></tr><tr><td>%c </td><td>capabilities
1690 </td></tr><tr><td>%t </td><td>trust/validity of the key-uid association
1691 </td></tr><tr><td>%[<s>] </td><td>date of the key where <s> is an <code class="literal">strftime(3)</code> expression
1692 </td></tr></tbody></table></div><p>
1694 </p></div><div class="sect2" title="3.163. pgp_export_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.163. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1695 Default: (empty)</p></div><p>
1696 This command is used to export a public key from the user's
1699 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1700 possible <code class="literal">printf(3)</code>-like sequences.
1702 </p></div><div class="sect2" title="3.164. pgp_getkeys_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.164. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1703 Default: (empty)</p></div><p>
1704 This command is invoked whenever mutt will need public key information.
1705 Of the sequences supported by <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a>, %r is the only
1706 <code class="literal">printf(3)</code>-like sequence used with this format.
1708 </p></div><div class="sect2" title="3.165. pgp_good_sign"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.165. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
1709 Default: (empty)</p></div><p>
1710 If you assign a text to this variable, then a PGP signature is only
1711 considered verified if the output from <a class="link" href="reference.html#pgp-verify-command" title="3.181. pgp_verify_command">$pgp_verify_command</a> contains
1712 the text. Use this variable if the exit code from the command is 0
1713 even for bad signatures.
1715 </p></div><div class="sect2" title="3.166. pgp_ignore_subkeys"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.166. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1716 Default: yes</p></div><p>
1717 Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
1718 the principal key will inherit the subkeys' capabilities. <span class="emphasis"><em>Unset</em></span> this
1719 if you want to play interesting key selection games.
1721 </p></div><div class="sect2" title="3.167. pgp_import_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.167. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1722 Default: (empty)</p></div><p>
1723 This command is used to import a key from a message into
1724 the user's public key ring.
1726 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1727 possible <code class="literal">printf(3)</code>-like sequences.
1729 </p></div><div class="sect2" title="3.168. pgp_list_pubring_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.168. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1730 Default: (empty)</p></div><p>
1731 This command is used to list the public key ring's contents. The
1732 output format must be analogous to the one used by
1734 </p><pre class="screen">
1735 gpg --list-keys --with-colons.
1737 This format is also generated by the <code class="literal">pgpring</code> utility which comes
1740 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1741 possible <code class="literal">printf(3)</code>-like sequences.
1743 </p></div><div class="sect2" title="3.169. pgp_list_secring_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.169. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1744 Default: (empty)</p></div><p>
1745 This command is used to list the secret key ring's contents. The
1746 output format must be analogous to the one used by:
1748 </p><pre class="screen">
1749 gpg --list-keys --with-colons.
1751 This format is also generated by the <code class="literal">pgpring</code> utility which comes
1754 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1755 possible <code class="literal">printf(3)</code>-like sequences.
1757 </p></div><div class="sect2" title="3.170. pgp_long_ids"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.170. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1758 Default: no</p></div><p>
1759 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.
1761 </p></div><div class="sect2" title="3.171. pgp_mime_auto"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.171. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1762 Default: ask-yes</p></div><p>
1763 This option controls whether Mutt will prompt you for
1764 automatically sending a (signed/encrypted) message using
1765 PGP/MIME when inline (traditional) fails (for any reason).
1767 Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1768 <span class="bold"><strong>deprecated</strong></span>.
1770 </p></div><div class="sect2" title="3.172. pgp_replyinline"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.172. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1771 Default: no</p></div><p>
1772 Setting this variable will cause Mutt to always attempt to
1773 create an inline (traditional) message when replying to a
1774 message which is PGP encrypted/signed inline. This can be
1775 overridden by use of the pgp menu, when inline is not
1776 required. This option does not automatically detect if the
1777 (replied-to) message is inline; instead it relies on Mutt
1778 internals for previously checked/flagged messages.
1780 Note that Mutt might automatically use PGP/MIME for messages
1781 which consist of more than a single MIME part. Mutt can be
1782 configured to ask before sending PGP/MIME messages when inline
1783 (traditional) would not work.
1785 Also see the <a class="link" href="reference.html#pgp-mime-auto" title="3.171. pgp_mime_auto">$pgp_mime_auto</a> variable.
1787 Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>
1788 <span class="bold"><strong>deprecated</strong></span>.
1790 </p></div><div class="sect2" title="3.173. pgp_retainable_sigs"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.173. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1791 Default: no</p></div><p>
1792 If <span class="emphasis"><em>set</em></span>, signed and encrypted messages will consist of nested
1793 <code class="literal">multipart/signed</code> and <code class="literal">multipart/encrypted</code> body parts.
1795 This is useful for applications like encrypted and signed mailing
1796 lists, where the outer layer (<code class="literal">multipart/encrypted</code>) can be easily
1797 removed, while the inner <code class="literal">multipart/signed</code> part is retained.
1799 </p></div><div class="sect2" title="3.174. pgp_show_unusable"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.174. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1800 Default: yes</p></div><p>
1801 If <span class="emphasis"><em>set</em></span>, mutt will display non-usable keys on the PGP key selection
1802 menu. This includes keys which have been revoked, have expired, or
1803 have been marked as <span class="quote">“<span class="quote">disabled</span>”</span> by the user.
1805 </p></div><div class="sect2" title="3.175. pgp_sign_as"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.175. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1806 Default: (empty)</p></div><p>
1807 If you have more than one key pair, this option allows you to specify
1808 which of your private keys to use. It is recommended that you use the
1809 keyid form to specify your key (e.g. <code class="literal">0x00112233</code>).
1811 </p></div><div class="sect2" title="3.176. pgp_sign_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.176. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1812 Default: (empty)</p></div><p>
1813 This command is used to create the detached PGP signature for a
1814 <code class="literal">multipart/signed</code> PGP/MIME body part.
1816 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1817 possible <code class="literal">printf(3)</code>-like sequences.
1819 </p></div><div class="sect2" title="3.177. pgp_sort_keys"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.177. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
1820 Default: address</p></div><p>
1821 Specifies how the entries in the pgp menu are sorted. The
1822 following are legal values:
1824 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>address </td><td>sort alphabetically by user id
1825 </td></tr><tr><td>keyid </td><td>sort alphabetically by key id
1826 </td></tr><tr><td>date </td><td>sort by key creation date
1827 </td></tr><tr><td>trust </td><td>sort by the trust of the key
1828 </td></tr></tbody></table></div><p>
1829 If you prefer reverse order of the above values, prefix it with
1830 <span class="quote">“<span class="quote">reverse-</span>”</span>.
1832 </p></div><div class="sect2" title="3.178. pgp_strict_enc"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.178. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1833 Default: yes</p></div><p>
1834 If <span class="emphasis"><em>set</em></span>, Mutt will automatically encode PGP/MIME signed messages as
1835 quoted-printable. Please note that unsetting this variable may
1836 lead to problems with non-verifyable PGP signatures, so only change
1837 this if you know what you are doing.
1839 </p></div><div class="sect2" title="3.179. pgp_timeout"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.179. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1840 Default: 300</p></div><p>
1841 The number of seconds after which a cached passphrase will expire if
1844 </p></div><div class="sect2" title="3.180. pgp_use_gpg_agent"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.180. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1845 Default: no</p></div><p>
1846 If <span class="emphasis"><em>set</em></span>, mutt will use a possibly-running <code class="literal">gpg-agent(1)</code> process.
1848 </p></div><div class="sect2" title="3.181. pgp_verify_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.181. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1849 Default: (empty)</p></div><p>
1850 This command is used to verify PGP signatures.
1852 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1853 possible <code class="literal">printf(3)</code>-like sequences.
1855 </p></div><div class="sect2" title="3.182. pgp_verify_key_command"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.182. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1856 Default: (empty)</p></div><p>
1857 This command is used to verify key information from the key selection
1860 This is a format string, see the <a class="link" href="reference.html#pgp-decode-command" title="3.158. pgp_decode_command">$pgp_decode_command</a> command for
1861 possible <code class="literal">printf(3)</code>-like sequences.
1863 </p></div><div class="sect2" title="3.183. pipe_decode"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.183. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1864 Default: no</p></div><p>
1865 Used in connection with the <code class="literal"><pipe-message></code> command. When <span class="emphasis"><em>unset</em></span>,
1866 Mutt will pipe the messages without any preprocessing. When <span class="emphasis"><em>set</em></span>, Mutt
1867 will weed headers and will attempt to decode the messages
1869 </p></div><div class="sect2" title="3.184. pipe_sep"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.184. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1870 Default: <span class="quote">“<span class="quote"><code class="literal">\n</code></span>”</span></p></div><p>
1871 The separator to add between messages when piping a list of tagged
1872 messages to an external Unix command.
1873 </p></div><div class="sect2" title="3.185. pipe_split"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.185. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1874 Default: no</p></div><p>
1875 Used in connection with the <code class="literal"><pipe-message></code> function following
1876 <code class="literal"><tag-prefix></code>. If this variable is <span class="emphasis"><em>unset</em></span>, when piping a list of
1877 tagged messages Mutt will concatenate the messages and will pipe them
1878 all concatenated. When <span class="emphasis"><em>set</em></span>, Mutt will pipe the messages one by one.
1879 In both cases the messages are piped in the current sorted order,
1880 and the <a class="link" href="reference.html#pipe-sep" title="3.184. pipe_sep">$pipe_sep</a> separator is added after each message.
1881 </p></div><div class="sect2" title="3.186. pop_auth_try_all"><div class="titlepage"><div><div><h3 class="title"><a id="pop-auth-try-all"></a>3.186. pop_auth_try_all</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1882 Default: yes</p></div><p>
1883 If <span class="emphasis"><em>set</em></span>, Mutt will try all available authentication methods.
1884 When <span class="emphasis"><em>unset</em></span>, Mutt will only fall back to other authentication
1885 methods if the previous methods are unavailable. If a method is
1886 available but authentication fails, Mutt will not connect to the POP server.
1887 </p></div><div class="sect2" title="3.187. pop_authenticators"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.187. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1888 Default: (empty)</p></div><p>
1889 This is a colon-delimited list of authentication methods mutt may
1890 attempt to use to log in to an POP server, in the order mutt should
1891 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
1892 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>.
1893 This option is case-insensitive. If this option is <span class="emphasis"><em>unset</em></span>
1894 (the default) mutt will try all available methods, in order from
1895 most-secure to least-secure.
1899 </p><pre class="screen">
1900 set pop_authenticators="digest-md5:apop:user"
1901 </pre></div><div class="sect2" title="3.188. pop_checkinterval"><div class="titlepage"><div><div><h3 class="title"><a id="pop-checkinterval"></a>3.188. pop_checkinterval</h3></div></div></div><div class="literallayout"><p>Type: number<br />
1902 Default: 60</p></div><p>
1903 This variable configures how often (in seconds) mutt should look for
1904 new mail in the currently selected mailbox if it is a POP mailbox.
1905 </p></div><div class="sect2" title="3.189. pop_delete"><div class="titlepage"><div><div><h3 class="title"><a id="pop-delete"></a>3.189. pop_delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1906 Default: ask-no</p></div><p>
1907 If <span class="emphasis"><em>set</em></span>, Mutt will delete successfully downloaded messages from the POP
1908 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
1909 download messages but also leave them on the POP server.
1910 </p></div><div class="sect2" title="3.190. pop_host"><div class="titlepage"><div><div><h3 class="title"><a id="pop-host"></a>3.190. pop_host</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1911 Default: (empty)</p></div><p>
1912 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
1913 can also specify an alternative port, username and password, i.e.:
1915 </p><pre class="screen">
1916 [pop[s]://][username[:password]@]popserver[:port]
1918 where <span class="quote">“<span class="quote">[...]</span>”</span> denotes an optional part.
1919 </p></div><div class="sect2" title="3.191. pop_last"><div class="titlepage"><div><div><h3 class="title"><a id="pop-last"></a>3.191. pop_last</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1920 Default: no</p></div><p>
1921 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
1922 for retrieving only unread messages from the POP server when using
1923 the <code class="literal"><a class="link" href="optionalfeatures.html#fetch-mail"><fetch-mail></a></code> function.
1924 </p></div><div class="sect2" title="3.192. pop_pass"><div class="titlepage"><div><div><h3 class="title"><a id="pop-pass"></a>3.192. pop_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1925 Default: (empty)</p></div><p>
1926 Specifies the password for your POP account. If <span class="emphasis"><em>unset</em></span>, Mutt will
1927 prompt you for your password when you open a POP mailbox.
1929 <span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a
1930 fairly secure machine, because the superuser can read your muttrc
1931 even if you are the only one who can read the file.
1932 </p></div><div class="sect2" title="3.193. pop_reconnect"><div class="titlepage"><div><div><h3 class="title"><a id="pop-reconnect"></a>3.193. pop_reconnect</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1933 Default: ask-yes</p></div><p>
1934 Controls whether or not Mutt will try to reconnect to the POP server if
1935 the connection is lost.
1936 </p></div><div class="sect2" title="3.194. pop_user"><div class="titlepage"><div><div><h3 class="title"><a id="pop-user"></a>3.194. pop_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1937 Default: (empty)</p></div><p>
1938 Your login name on the POP server.
1940 This variable defaults to your user name on the local machine.
1941 </p></div><div class="sect2" title="3.195. post_indent_string"><div class="titlepage"><div><div><h3 class="title"><a id="post-indent-string"></a>3.195. post_indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1942 Default: (empty)</p></div><p>
1943 Similar to the <a class="link" href="reference.html#attribution" title="3.16. attribution">$attribution</a> variable, Mutt will append this
1944 string after the inclusion of a message which is being replied to.
1945 </p></div><div class="sect2" title="3.196. postpone"><div class="titlepage"><div><div><h3 class="title"><a id="postpone"></a>3.196. postpone</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1946 Default: ask-yes</p></div><p>
1947 Controls whether or not messages are saved in the <a class="link" href="reference.html#postponed" title="3.197. postponed">$postponed</a>
1948 mailbox when you elect not to send immediately.
1950 Also see the <a class="link" href="reference.html#recall" title="3.211. recall">$recall</a> variable.
1951 </p></div><div class="sect2" title="3.197. postponed"><div class="titlepage"><div><div><h3 class="title"><a id="postponed"></a>3.197. postponed</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1952 Default: <span class="quote">“<span class="quote"><code class="literal">~/postponed</code></span>”</span></p></div><p>
1953 Mutt allows you to indefinitely <span class="quote">“<span class="quote"><a class="link" href="reference.html#postpone" title="3.196. postpone">postpone</a> sending a message</span>”</span> which
1954 you are editing. When you choose to postpone a message, Mutt saves it
1955 in the mailbox specified by this variable.
1957 Also see the <a class="link" href="reference.html#postpone" title="3.196. postpone">$postpone</a> variable.
1958 </p></div><div class="sect2" title="3.198. preconnect"><div class="titlepage"><div><div><h3 class="title"><a id="preconnect"></a>3.198. preconnect</h3></div></div></div><div class="literallayout"><p>Type: string<br />
1959 Default: (empty)</p></div><p>
1960 If <span class="emphasis"><em>set</em></span>, a shell command to be executed if mutt fails to establish
1961 a connection to the server. This is useful for setting up secure
1962 connections, e.g. with <code class="literal">ssh(1)</code>. If the command returns a nonzero
1963 status, mutt gives up opening the server. Example:
1965 </p><pre class="screen">
1966 set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
1967 sleep 20 < /dev/null > /dev/null"
1969 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
1970 as <span class="quote">“<span class="quote">{localhost:1234}foo</span>”</span>.
1972 Note: For this example to work, you must be able to log in to the
1973 remote machine without having to enter a password.
1974 </p></div><div class="sect2" title="3.199. print"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.199. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
1975 Default: ask-no</p></div><p>
1976 Controls whether or not Mutt really prints messages.
1977 This is set to <span class="quote">“<span class="quote">ask-no</span>”</span> by default, because some people
1978 accidentally hit <span class="quote">“<span class="quote">p</span>”</span> often.
1979 </p></div><div class="sect2" title="3.200. print_command"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.200. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
1980 Default: <span class="quote">“<span class="quote"><code class="literal">lpr</code></span>”</span></p></div><p>
1981 This specifies the command pipe that should be used to print messages.
1982 </p></div><div class="sect2" title="3.201. print_decode"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.201. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1983 Default: yes</p></div><p>
1984 Used in connection with the <code class="literal"><print-message></code> command. If this
1985 option is <span class="emphasis"><em>set</em></span>, the message is decoded before it is passed to the
1986 external command specified by <a class="link" href="reference.html#print-command" title="3.200. print_command">$print_command</a>. If this option
1987 is <span class="emphasis"><em>unset</em></span>, no processing will be applied to the message when
1988 printing it. The latter setting may be useful if you are using
1989 some advanced printer filter which is able to properly format
1990 e-mail messages for printing.
1991 </p></div><div class="sect2" title="3.202. print_split"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.202. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
1992 Default: no</p></div><p>
1993 Used in connection with the <code class="literal"><print-message></code> command. If this option
1994 is <span class="emphasis"><em>set</em></span>, the command specified by <a class="link" href="reference.html#print-command" title="3.200. print_command">$print_command</a> is executed once for
1995 each message which is to be printed. If this option is <span class="emphasis"><em>unset</em></span>,
1996 the command specified by <a class="link" href="reference.html#print-command" title="3.200. print_command">$print_command</a> is executed only once, and
1997 all the messages are concatenated, with a form feed as the message
2000 Those who use the <code class="literal">enscript</code>(1) program's mail-printing mode will
2001 most likely want to <span class="emphasis"><em>set</em></span> this option.
2002 </p></div><div class="sect2" title="3.203. prompt_after"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.203. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2003 Default: yes</p></div><p>
2004 If you use an <span class="emphasis"><em>external</em></span> <a class="link" href="reference.html#pager" title="3.149. pager">$pager</a>, setting this variable will
2005 cause Mutt to prompt you for a command when the pager exits rather
2006 than returning to the index menu. If <span class="emphasis"><em>unset</em></span>, Mutt will return to the
2007 index menu when the external pager exits.
2008 </p></div><div class="sect2" title="3.204. query_command"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.204. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2009 Default: (empty)</p></div><p>
2010 This specifies the command Mutt will use to make external address
2011 queries. The string may contain a <span class="quote">“<span class="quote">%s</span>”</span>, which will be substituted
2012 with the query string the user types. Mutt will add quotes around the
2013 string substituted for <span class="quote">“<span class="quote">%s</span>”</span> automatically according to shell quoting
2014 rules, so you should avoid adding your own. If no <span class="quote">“<span class="quote">%s</span>”</span> is found in
2015 the string, Mutt will append the user's query to the end of the string.
2016 See <span class="quote">“<span class="quote"><a class="link" href="advancedusage.html#query" title="6. External Address Queries">query</a></span>”</span> for more information.
2017 </p></div><div class="sect2" title="3.205. query_format"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.205. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2018 Default: <span class="quote">“<span class="quote"><code class="literal">%4c %t %-25.25a %-25.25n %?e?(%e)?</code></span>”</span></p></div><p>
2019 This variable describes the format of the <span class="quote">“<span class="quote">query</span>”</span> menu. The
2020 following <code class="literal">printf(3)</code>-style sequences are understood:
2022 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%a </td><td>destination address
2023 </td></tr><tr><td>%c </td><td>current entry number
2024 </td></tr><tr><td>%e </td><td>extra information *
2025 </td></tr><tr><td>%n </td><td>destination name
2026 </td></tr><tr><td>%t </td><td><span class="quote">“<span class="quote">*</span>”</span> if current entry is tagged, a space otherwise
2027 </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>
2028 </td></tr><tr><td>%|X </td><td>pad to the end of the line with <span class="quote">“<span class="quote">X</span>”</span>
2029 </td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
2030 </td></tr></tbody></table></div><p>
2031 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.114. index_format">$index_format</a> documentation.
2033 * = can be optionally printed if nonzero, see the <a class="link" href="reference.html#status-format" title="3.283. status_format">$status_format</a> documentation.
2034 </p></div><div class="sect2" title="3.206. quit"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.206. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2035 Default: yes</p></div><p>
2036 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
2037 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
2038 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
2039 prompted for confirmation when you try to quit.
2040 </p></div><div class="sect2" title="3.207. quote_regexp"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.207. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2041 Default: <span class="quote">“<span class="quote"><code class="literal">^([ \t]*[|>:}#])+</code></span>”</span></p></div><p>
2042 A regular expression used in the internal pager to determine quoted
2043 sections of text in the body of a message. Quoted text may be filtered
2044 out using the <code class="literal"><toggle-quoted></code> command, or colored according to the
2045 <span class="quote">“<span class="quote">color quoted</span>”</span> family of directives.
2047 Higher levels of quoting may be colored differently (<span class="quote">“<span class="quote">color quoted1</span>”</span>,
2048 <span class="quote">“<span class="quote">color quoted2</span>”</span>, etc.). The quoting level is determined by removing
2049 the last character from the matched text and recursively reapplying
2050 the regular expression until it fails to produce a match.
2052 Match detection may be overridden by the <a class="link" href="reference.html#smileys" title="3.240. smileys">$smileys</a> regular expression.
2053 </p></div><div class="sect2" title="3.208. read_inc"><div class="titlepage"><div><div><h3 class="title"><a id="read-inc"></a>3.208. read_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2054 Default: 10</p></div><p>
2055 If set to a value greater than 0, Mutt will display which message it
2056 is currently on when reading a mailbox or when performing search actions
2057 such as search and limit. The message is printed after
2058 this many messages have been read or searched (e.g., if set to 25, Mutt will
2059 print a message when it is at message 25, and then again when it gets
2060 to message 50). This variable is meant to indicate progress when
2061 reading or searching large mailboxes which may take some time.
2062 When set to 0, only a single message will appear before the reading
2065 Also see the <a class="link" href="reference.html#write-inc" title="3.312. write_inc">$write_inc</a>, <a class="link" href="reference.html#net-inc" title="3.148. net_inc">$net_inc</a> and <a class="link" href="reference.html#time-inc" title="3.291. time_inc">$time_inc</a> variables and the
2066 <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.
2067 </p></div><div class="sect2" title="3.209. read_only"><div class="titlepage"><div><div><h3 class="title"><a id="read-only"></a>3.209. read_only</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2068 Default: no</p></div><p>
2069 If <span class="emphasis"><em>set</em></span>, all folders are opened in read-only mode.
2070 </p></div><div class="sect2" title="3.210. realname"><div class="titlepage"><div><div><h3 class="title"><a id="realname"></a>3.210. realname</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2071 Default: (empty)</p></div><p>
2072 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
2073 when sending messages.
2075 By default, this is the GECOS field from <code class="literal">/etc/passwd</code>. Note that this
2076 variable will <span class="emphasis"><em>not</em></span> be used when the user has set a real name
2077 in the <a class="link" href="reference.html#from" title="3.75. from">$from</a> variable.
2078 </p></div><div class="sect2" title="3.211. recall"><div class="titlepage"><div><div><h3 class="title"><a id="recall"></a>3.211. recall</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2079 Default: ask-yes</p></div><p>
2080 Controls whether or not Mutt recalls postponed messages
2081 when composing a new message.
2083 <span class="emphasis"><em>Setting</em></span> this variable to is not generally useful, and thus not
2086 Also see <a class="link" href="reference.html#postponed" title="3.197. postponed">$postponed</a> variable.
2087 </p></div><div class="sect2" title="3.212. record"><div class="titlepage"><div><div><h3 class="title"><a id="record"></a>3.212. record</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2088 Default: <span class="quote">“<span class="quote"><code class="literal">~/sent</code></span>”</span></p></div><p>
2089 This specifies the file into which your outgoing messages should be
2090 appended. (This is meant as the primary method for saving a copy of
2091 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="15. User-Defined Headers">my_hdr</a></span>”</span>
2092 command to create a <span class="quote">“<span class="quote">Bcc:</span>”</span> field with your email address in it.)
2094 The value of <span class="emphasis"><em><a class="link" href="reference.html#record" title="3.212. record">$record</a></em></span> is overridden by the <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a> and
2095 <a class="link" href="reference.html#save-name" title="3.224. save_name">$save_name</a> variables, and the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#fcc-hook" title="17. Specify Default Fcc: Mailbox When Composing">fcc-hook</a></span>”</span> command.
2096 </p></div><div class="sect2" title="3.213. reply_regexp"><div class="titlepage"><div><div><h3 class="title"><a id="reply-regexp"></a>3.213. reply_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2097 Default: <span class="quote">“<span class="quote"><code class="literal">^(re([\[0-9\]+])*|aw):[ \t]*</code></span>”</span></p></div><p>
2098 A regular expression used to recognize reply messages when threading
2099 and replying. The default value corresponds to the English "Re:" and
2101 </p></div><div class="sect2" title="3.214. reply_self"><div class="titlepage"><div><div><h3 class="title"><a id="reply-self"></a>3.214. reply_self</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2102 Default: no</p></div><p>
2103 If <span class="emphasis"><em>unset</em></span> and you are replying to a message sent by you, Mutt will
2104 assume that you want to reply to the recipients of that message rather
2107 Also see the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">alternates</a></span>”</span> command.
2108 </p></div><div class="sect2" title="3.215. reply_to"><div class="titlepage"><div><div><h3 class="title"><a id="reply-to"></a>3.215. reply_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2109 Default: ask-yes</p></div><p>
2110 If <span class="emphasis"><em>set</em></span>, when replying to a message, Mutt will use the address listed
2111 in the Reply-to: header as the recipient of the reply. If <span class="emphasis"><em>unset</em></span>,
2112 it will use the address in the From: header field instead. This
2113 option is useful for reading a mailing list that sets the Reply-To:
2114 header field to the list address and you want to send a private
2115 message to the author of a message.
2116 </p></div><div class="sect2" title="3.216. resolve"><div class="titlepage"><div><div><h3 class="title"><a id="resolve"></a>3.216. resolve</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2117 Default: yes</p></div><p>
2118 When <span class="emphasis"><em>set</em></span>, the cursor will be automatically advanced to the next
2119 (possibly undeleted) message whenever a command that modifies the
2120 current message is executed.
2121 </p></div><div class="sect2" title="3.217. reverse_alias"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-alias"></a>3.217. reverse_alias</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2122 Default: no</p></div><p>
2123 This variable controls whether or not Mutt will display the <span class="quote">“<span class="quote">personal</span>”</span>
2124 name from your aliases in the index menu if it finds an alias that
2125 matches the message's sender. For example, if you have the following
2128 </p><pre class="screen">
2129 alias juser abd30425@somewhere.net (Joe User)
2131 and then you receive mail which contains the following header:
2133 </p><pre class="screen">
2134 From: abd30425@somewhere.net
2136 It would be displayed in the index menu as <span class="quote">“<span class="quote">Joe User</span>”</span> instead of
2137 <span class="quote">“<span class="quote">abd30425@somewhere.net.</span>”</span> This is useful when the person's e-mail
2138 address is not human friendly.
2139 </p></div><div class="sect2" title="3.218. reverse_name"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-name"></a>3.218. reverse_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2140 Default: no</p></div><p>
2141 It may sometimes arrive that you receive mail to a certain machine,
2142 move the messages to another machine, and reply to some the messages
2143 from there. If this variable is <span class="emphasis"><em>set</em></span>, the default <span class="emphasis"><em>From:</em></span> line of
2144 the reply messages is built using the address where you received the
2145 messages you are replying to <span class="bold"><strong>if</strong></span> that address matches your
2146 <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">alternates</a></span>”</span>. If the variable is <span class="emphasis"><em>unset</em></span>, or the address that would be
2147 used doesn't match your <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">alternates</a></span>”</span>, the <span class="emphasis"><em>From:</em></span> line will use
2148 your address on the current machine.
2150 Also see the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#alternates" title="11. Alternative Addresses">alternates</a></span>”</span> command.
2151 </p></div><div class="sect2" title="3.219. reverse_realname"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-realname"></a>3.219. reverse_realname</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2152 Default: yes</p></div><p>
2153 This variable fine-tunes the behavior of the <a class="link" href="reference.html#reverse-name" title="3.218. reverse_name">$reverse_name</a> feature.
2154 When it is <span class="emphasis"><em>set</em></span>, mutt will use the address from incoming messages as-is,
2155 possibly including eventual real names. When it is <span class="emphasis"><em>unset</em></span>, mutt will
2156 override any such real names with the setting of the <a class="link" href="reference.html#realname" title="3.210. realname">$realname</a> variable.
2157 </p></div><div class="sect2" title="3.220. rfc2047_parameters"><div class="titlepage"><div><div><h3 class="title"><a id="rfc2047-parameters"></a>3.220. rfc2047_parameters</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2158 Default: no</p></div><p>
2159 When this variable is <span class="emphasis"><em>set</em></span>, Mutt will decode RFC2047-encoded MIME
2160 parameters. You want to set this variable when mutt suggests you
2161 to save attachments to files named like:
2163 </p><pre class="screen">
2164 =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
2166 When this variable is <span class="emphasis"><em>set</em></span> interactively, the change won't be
2167 active until you change folders.
2169 Note that this use of RFC2047's encoding is explicitly
2170 prohibited by the standard, but nevertheless encountered in the
2173 Also note that setting this parameter will <span class="emphasis"><em>not</em></span> have the effect
2174 that mutt <span class="emphasis"><em>generates</em></span> this kind of encoding. Instead, mutt will
2175 unconditionally use the encoding specified in RFC2231.
2176 </p></div><div class="sect2" title="3.221. save_address"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.221. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2177 Default: no</p></div><p>
2178 If <span class="emphasis"><em>set</em></span>, mutt will take the sender's full address when choosing a
2179 default folder for saving a mail. If <a class="link" href="reference.html#save-name" title="3.224. save_name">$save_name</a> or <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a>
2180 is <span class="emphasis"><em>set</em></span> too, the selection of the Fcc folder will be changed as well.
2181 </p></div><div class="sect2" title="3.222. save_empty"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.222. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2182 Default: yes</p></div><p>
2183 When <span class="emphasis"><em>unset</em></span>, mailboxes which contain no saved messages will be removed
2184 when closed (the exception is <a class="link" href="reference.html#spoolfile" title="3.270. spoolfile">$spoolfile</a> which is never removed).
2185 If <span class="emphasis"><em>set</em></span>, mailboxes are never removed.
2187 <span class="bold"><strong>Note:</strong></span> This only applies to mbox and MMDF folders, Mutt does not
2188 delete MH and Maildir directories.
2189 </p></div><div class="sect2" title="3.223. save_history"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.223. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2190 Default: 0</p></div><p>
2191 This variable controls the size of the history (per category) saved in the
2192 <a class="link" href="reference.html#history-file" title="3.90. history_file">$history_file</a> file.
2193 </p></div><div class="sect2" title="3.224. save_name"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.224. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2194 Default: no</p></div><p>
2195 This variable controls how copies of outgoing messages are saved.
2196 When <span class="emphasis"><em>set</em></span>, a check is made to see if a mailbox specified by the
2197 recipient address exists (this is done by searching for a mailbox in
2198 the <a class="link" href="reference.html#folder" title="3.66. folder">$folder</a> directory with the <span class="emphasis"><em>username</em></span> part of the
2199 recipient address). If the mailbox exists, the outgoing message will
2200 be saved to that mailbox, otherwise the message is saved to the
2201 <a class="link" href="reference.html#record" title="3.212. record">$record</a> mailbox.
2203 Also see the <a class="link" href="reference.html#force-name" title="3.69. force_name">$force_name</a> variable.
2204 </p></div><div class="sect2" title="3.225. score"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.225. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2205 Default: yes</p></div><p>
2206 When this variable is <span class="emphasis"><em>unset</em></span>, scoring is turned off. This can
2207 be useful to selectively disable scoring for certain folders when the
2208 <a class="link" href="reference.html#score-threshold-delete" title="3.226. score_threshold_delete">$score_threshold_delete</a> variable and related are used.
2209 </p></div><div class="sect2" title="3.226. score_threshold_delete"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.226. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2210 Default: -1</p></div><p>
2211 Messages which have been assigned a score equal to or lower than the value
2212 of this variable are automatically marked for deletion by mutt. Since
2213 mutt scores are always greater than or equal to zero, the default setting
2214 of this variable will never mark a message for deletion.
2215 </p></div><div class="sect2" title="3.227. score_threshold_flag"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.227. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2216 Default: 9999</p></div><p>
2217 Messages which have been assigned a score greater than or equal to this
2218 variable's value are automatically marked "flagged".
2219 </p></div><div class="sect2" title="3.228. score_threshold_read"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.228. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2220 Default: -1</p></div><p>
2221 Messages which have been assigned a score equal to or lower than the value
2222 of this variable are automatically marked as read by mutt. Since
2223 mutt scores are always greater than or equal to zero, the default setting
2224 of this variable will never mark a message read.
2225 </p></div><div class="sect2" title="3.229. search_context"><div class="titlepage"><div><div><h3 class="title"><a id="search-context"></a>3.229. search_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2226 Default: 0</p></div><p>
2227 For the pager, this variable specifies the number of lines shown
2228 before search results. By default, search results will be top-aligned.
2229 </p></div><div class="sect2" title="3.230. send_charset"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.230. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2230 Default: <span class="quote">“<span class="quote"><code class="literal">us-ascii:iso-8859-1:utf-8</code></span>”</span></p></div><p>
2231 A colon-delimited list of character sets for outgoing messages. Mutt will use the
2232 first character set into which the text can be converted exactly.
2233 If your <a class="link" href="reference.html#charset" title="3.25. charset">$charset</a> is not <span class="quote">“<span class="quote">iso-8859-1</span>”</span> and recipients may not
2234 understand <span class="quote">“<span class="quote">UTF-8</span>”</span>, it is advisable to include in the list an
2235 appropriate widely used standard character set (such as
2236 <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
2237 <span class="quote">“<span class="quote">iso-8859-1</span>”</span>.
2239 In case the text cannot be converted into one of these exactly,
2240 mutt uses <a class="link" href="reference.html#charset" title="3.25. charset">$charset</a> as a fallback.
2241 </p></div><div class="sect2" title="3.231. sendmail"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail"></a>3.231. sendmail</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2242 Default: <span class="quote">“<span class="quote"><code class="literal">/usr/sbin/sendmail -oem -oi</code></span>”</span></p></div><p>
2243 Specifies the program and arguments used to deliver mail sent by Mutt.
2244 Mutt expects that the specified program interprets additional
2245 arguments as recipient addresses.
2246 </p></div><div class="sect2" title="3.232. sendmail_wait"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail-wait"></a>3.232. sendmail_wait</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2247 Default: 0</p></div><p>
2248 Specifies the number of seconds to wait for the <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a> process
2249 to finish before giving up and putting delivery in the background.
2251 Mutt interprets the value of this variable as follows:
2253 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>>0 </td><td>number of seconds to wait for sendmail to finish before continuing
2254 </td></tr><tr><td>0 </td><td>wait forever for sendmail to finish
2255 </td></tr><tr><td><0 </td><td>always put sendmail in the background without waiting
2256 </td></tr></tbody></table></div><p>
2257 Note that if you specify a value other than 0, the output of the child
2258 process will be put in a temporary file. If there is some error, you
2259 will be informed as to where to find the output.
2260 </p></div><div class="sect2" title="3.233. shell"><div class="titlepage"><div><div><h3 class="title"><a id="shell"></a>3.233. shell</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2261 Default: (empty)</p></div><p>
2262 Command to use when spawning a subshell. By default, the user's login
2263 shell from <code class="literal">/etc/passwd</code> is used.
2264 </p></div><div class="sect2" title="3.234. sig_dashes"><div class="titlepage"><div><div><h3 class="title"><a id="sig-dashes"></a>3.234. sig_dashes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2265 Default: yes</p></div><p>
2266 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
2267 <a class="link" href="reference.html#signature" title="3.236. signature">$signature</a>. It is <span class="bold"><strong>strongly</strong></span> recommended that you not <span class="emphasis"><em>unset</em></span>
2268 this variable unless your signature contains just your name. The
2269 reason for this is because many software packages use <span class="quote">“<span class="quote">-- \n</span>”</span> to
2270 detect your signature. For example, Mutt has the ability to highlight
2271 the signature in a different color in the built-in pager.
2272 </p></div><div class="sect2" title="3.235. sig_on_top"><div class="titlepage"><div><div><h3 class="title"><a id="sig-on-top"></a>3.235. sig_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2273 Default: no</p></div><p>
2274 If <span class="emphasis"><em>set</em></span>, the signature will be included before any quoted or forwarded
2275 text. It is <span class="bold"><strong>strongly</strong></span> recommended that you do not set this variable
2276 unless you really know what you are doing, and are prepared to take
2277 some heat from netiquette guardians.
2278 </p></div><div class="sect2" title="3.236. signature"><div class="titlepage"><div><div><h3 class="title"><a id="signature"></a>3.236. signature</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2279 Default: <span class="quote">“<span class="quote"><code class="literal">~/.signature</code></span>”</span></p></div><p>
2280 Specifies the filename of your signature, which is appended to all
2281 outgoing messages. If the filename ends with a pipe (<span class="quote">“<span class="quote">|</span>”</span>), it is
2282 assumed that filename is a shell command and input should be read from
2283 its standard output.
2284 </p></div><div class="sect2" title="3.237. simple_search"><div class="titlepage"><div><div><h3 class="title"><a id="simple-search"></a>3.237. simple_search</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2285 Default: <span class="quote">“<span class="quote"><code class="literal">~f %s | ~s %s</code></span>”</span></p></div><p>
2286 Specifies how Mutt should expand a simple search into a real search
2287 pattern. A simple search is one that does not contain any of the <span class="quote">“<span class="quote">~</span>”</span> pattern
2288 operators. 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.
2290 For example, if you simply type <span class="quote">“<span class="quote">joe</span>”</span> at a search or limit prompt, Mutt
2291 will automatically expand it to the value specified by this variable by
2292 replacing <span class="quote">“<span class="quote">%s</span>”</span> with the supplied string.
2293 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>.
2294 </p></div><div class="sect2" title="3.238. sleep_time"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.238. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2295 Default: 1</p></div><p>
2296 Specifies time, in seconds, to pause while displaying certain informational
2297 messages, while moving from folder to folder and after expunging
2298 messages from the current folder. The default is to pause one second, so
2299 a value of zero for this option suppresses the pause.
2300 </p></div><div class="sect2" title="3.239. smart_wrap"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.239. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2301 Default: yes</p></div><p>
2302 Controls the display of lines longer than the screen width in the
2303 internal pager. If <span class="emphasis"><em>set</em></span>, long lines are wrapped at a word boundary. If
2304 <span class="emphasis"><em>unset</em></span>, lines are simply wrapped at the screen edge. Also see the
2305 <a class="link" href="reference.html#markers" title="3.125. markers">$markers</a> variable.
2306 </p></div><div class="sect2" title="3.240. smileys"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.240. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />
2307 Default: <span class="quote">“<span class="quote"><code class="literal">(>From )|(:[-^]?[][)(><}{|/DP])</code></span>”</span></p></div><p>
2308 The <span class="emphasis"><em>pager</em></span> uses this variable to catch some common false
2309 positives of <a class="link" href="reference.html#quote-regexp" title="3.207. quote_regexp">$quote_regexp</a>, most notably smileys and not consider
2310 a line quoted text if it also matches <a class="link" href="reference.html#smileys" title="3.240. smileys">$smileys</a>. This mostly
2311 happens at the beginning of a line.
2312 </p></div><div class="sect2" title="3.241. smime_ask_cert_label"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.241. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2313 Default: yes</p></div><p>
2314 This flag controls whether you want to be asked to enter a label
2315 for a certificate about to be added to the database or not. It is
2316 <span class="emphasis"><em>set</em></span> by default.
2318 </p></div><div class="sect2" title="3.242. smime_ca_location"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.242. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2319 Default: (empty)</p></div><p>
2320 This variable contains the name of either a directory, or a file which
2321 contains trusted certificates for use with OpenSSL.
2323 </p></div><div class="sect2" title="3.243. smime_certificates"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.243. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2324 Default: (empty)</p></div><p>
2325 Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2326 storage and retrieval of keys by itself. This is very basic right
2327 now, and keys and certificates are stored in two different
2328 directories, both named as the hash-value retrieved from
2329 OpenSSL. There is an index file which contains mailbox-address
2330 keyid pairs, and which can be manually edited. This option points to
2331 the location of the certificates.
2333 </p></div><div class="sect2" title="3.244. smime_decrypt_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.244. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2334 Default: (empty)</p></div><p>
2335 This format string specifies a command which is used to decrypt
2336 <code class="literal">application/x-pkcs7-mime</code> attachments.
2338 The OpenSSL command formats have their own set of <code class="literal">printf(3)</code>-like sequences
2341 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%f </td><td>Expands to the name of a file containing a message.
2342 </td></tr><tr><td>%s </td><td>Expands to the name of a file containing the signature part
2343 of a <code class="literal">multipart/signed</code> attachment when verifying it.
2344 </td></tr><tr><td>%k </td><td>The key-pair specified with <a class="link" href="reference.html#smime-default-key" title="3.246. smime_default_key">$smime_default_key</a>
2345 </td></tr><tr><td>%c </td><td>One or more certificate IDs.
2346 </td></tr><tr><td>%a </td><td>The algorithm used for encryption.
2347 </td></tr><tr><td>%C </td><td>CA location: Depending on whether <a class="link" href="reference.html#smime-ca-location" title="3.242. smime_ca_location">$smime_ca_location</a>
2348 points to a directory or file, this expands to
2349 <span class="quote">“<span class="quote">-CApath <a class="link" href="reference.html#smime-ca-location" title="3.242. 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.242. smime_ca_location">$smime_ca_location</a></span>”</span>.
2350 </td></tr></tbody></table></div><p>
2351 For examples on how to configure these formats, see the <code class="literal">smime.rc</code> in
2352 the <code class="literal">samples/</code> subdirectory which has been installed on your system
2353 alongside the documentation.
2355 </p></div><div class="sect2" title="3.245. smime_decrypt_use_default_key"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.245. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2356 Default: yes</p></div><p>
2357 If <span class="emphasis"><em>set</em></span> (default) this tells mutt to use the default key for decryption. Otherwise,
2358 if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
2359 to determine the key to use. It will ask you to supply a key, if it can't find one.
2361 </p></div><div class="sect2" title="3.246. smime_default_key"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.246. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2362 Default: (empty)</p></div><p>
2363 This is the default key-pair to use for signing. This must be set to the
2364 keyid (the hash-value that OpenSSL generates) to work properly
2366 </p></div><div class="sect2" title="3.247. smime_encrypt_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.247. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2367 Default: (empty)</p></div><p>
2368 This command is used to create encrypted S/MIME messages.
2370 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2371 possible <code class="literal">printf(3)</code>-like sequences.
2373 </p></div><div class="sect2" title="3.248. smime_encrypt_with"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.248. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2374 Default: (empty)</p></div><p>
2375 This sets the algorithm that should be used for encryption.
2376 Valid choices are <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>.
2377 If <span class="emphasis"><em>unset</em></span>, <span class="quote">“<span class="quote">3des</span>”</span> (TripleDES) is used.
2379 </p></div><div class="sect2" title="3.249. smime_get_cert_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.249. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2380 Default: (empty)</p></div><p>
2381 This command is used to extract X509 certificates from a PKCS7 structure.
2383 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2384 possible <code class="literal">printf(3)</code>-like sequences.
2386 </p></div><div class="sect2" title="3.250. smime_get_cert_email_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.250. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2387 Default: (empty)</p></div><p>
2388 This command is used to extract the mail address(es) used for storing
2389 X509 certificates, and for verification purposes (to check whether the
2390 certificate was issued for the sender's mailbox).
2392 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2393 possible <code class="literal">printf(3)</code>-like sequences.
2395 </p></div><div class="sect2" title="3.251. smime_get_signer_cert_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.251. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2396 Default: (empty)</p></div><p>
2397 This command is used to extract only the signers X509 certificate from a S/MIME
2398 signature, so that the certificate's owner may get compared to the
2399 email's <span class="quote">“<span class="quote">From:</span>”</span> field.
2401 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2402 possible <code class="literal">printf(3)</code>-like sequences.
2404 </p></div><div class="sect2" title="3.252. smime_import_cert_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.252. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2405 Default: (empty)</p></div><p>
2406 This command is used to import a certificate via smime_keys.
2408 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2409 possible <code class="literal">printf(3)</code>-like sequences.
2411 </p></div><div class="sect2" title="3.253. smime_is_default"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.253. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2412 Default: no</p></div><p>
2413 The default behavior of mutt is to use PGP on all auto-sign/encryption
2414 operations. To override and to use OpenSSL instead this must be <span class="emphasis"><em>set</em></span>.
2415 However, this has no effect while replying, since mutt will automatically
2416 select the same application that was used to sign/encrypt the original
2417 message. (Note that this variable can be overridden by unsetting <a class="link" href="reference.html#crypt-autosmime" title="3.39. crypt_autosmime">$crypt_autosmime</a>.)
2419 </p></div><div class="sect2" title="3.254. smime_keys"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.254. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2420 Default: (empty)</p></div><p>
2421 Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2422 storage and retrieval of keys/certs by itself. This is very basic right now,
2423 and stores keys and certificates in two different directories, both
2424 named as the hash-value retrieved from OpenSSL. There is an index file
2425 which contains mailbox-address keyid pair, and which can be manually
2426 edited. This option points to the location of the private keys.
2428 </p></div><div class="sect2" title="3.255. smime_pk7out_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.255. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2429 Default: (empty)</p></div><p>
2430 This command is used to extract PKCS7 structures of S/MIME signatures,
2431 in order to extract the public X509 certificate(s).
2433 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2434 possible <code class="literal">printf(3)</code>-like sequences.
2436 </p></div><div class="sect2" title="3.256. smime_sign_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.256. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2437 Default: (empty)</p></div><p>
2438 This command is used to created S/MIME signatures of type
2439 <code class="literal">multipart/signed</code>, which can be read by all mail clients.
2441 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2442 possible <code class="literal">printf(3)</code>-like sequences.
2444 </p></div><div class="sect2" title="3.257. smime_sign_opaque_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.257. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2445 Default: (empty)</p></div><p>
2446 This command is used to created S/MIME signatures of type
2447 <code class="literal">application/x-pkcs7-signature</code>, which can only be handled by mail
2448 clients supporting the S/MIME extension.
2450 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2451 possible <code class="literal">printf(3)</code>-like sequences.
2453 </p></div><div class="sect2" title="3.258. smime_timeout"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.258. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2454 Default: 300</p></div><p>
2455 The number of seconds after which a cached passphrase will expire if
2458 </p></div><div class="sect2" title="3.259. smime_verify_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.259. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2459 Default: (empty)</p></div><p>
2460 This command is used to verify S/MIME signatures of type <code class="literal">multipart/signed</code>.
2462 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2463 possible <code class="literal">printf(3)</code>-like sequences.
2465 </p></div><div class="sect2" title="3.260. smime_verify_opaque_command"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.260. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2466 Default: (empty)</p></div><p>
2467 This command is used to verify S/MIME signatures of type
2468 <code class="literal">application/x-pkcs7-mime</code>.
2470 This is a format string, see the <a class="link" href="reference.html#smime-decrypt-command" title="3.244. smime_decrypt_command">$smime_decrypt_command</a> command for
2471 possible <code class="literal">printf(3)</code>-like sequences.
2473 </p></div><div class="sect2" title="3.261. smtp_authenticators"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.261. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2474 Default: (empty)</p></div><p>
2475 This is a colon-delimited list of authentication methods mutt may
2476 attempt to use to log in to an SMTP server, in the order mutt should
2477 try them. Authentication methods are any SASL mechanism, e.g.
2478 <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>.
2479 This option is case-insensitive. If it is <span class="quote">“<span class="quote">unset</span>”</span>
2480 (the default) mutt will try all available methods, in order from
2481 most-secure to least-secure.
2485 </p><pre class="screen">
2486 set smtp_authenticators="digest-md5:cram-md5"
2487 </pre></div><div class="sect2" title="3.262. smtp_pass"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-pass"></a>3.262. smtp_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2488 Default: (empty)</p></div><p>
2489 Specifies the password for your SMTP account. If <span class="emphasis"><em>unset</em></span>, Mutt will
2490 prompt you for your password when you first send mail via SMTP.
2491 See <a class="link" href="reference.html#smtp-url" title="3.263. smtp_url">$smtp_url</a> to configure mutt to send mail via SMTP.
2493 <span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a
2494 fairly secure machine, because the superuser can read your muttrc even
2495 if you are the only one who can read the file.
2496 </p></div><div class="sect2" title="3.263. smtp_url"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-url"></a>3.263. smtp_url</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2497 Default: (empty)</p></div><p>
2498 Defines the SMTP smarthost where sent messages should relayed for
2499 delivery. This should take the form of an SMTP URL, e.g.:
2501 </p><pre class="screen">
2502 smtp[s]://[user[:pass]@]host[:port]
2504 where <span class="quote">“<span class="quote">[...]</span>”</span> denotes an optional part.
2505 Setting this variable overrides the value of the <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a>
2507 </p></div><div class="sect2" title="3.264. sort"><div class="titlepage"><div><div><h3 class="title"><a id="sort"></a>3.264. sort</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
2508 Default: date</p></div><p>
2509 Specifies how to sort messages in the <span class="quote">“<span class="quote">index</span>”</span> menu. Valid values
2512 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>date or date-sent
2513 </p></li><li class="listitem"><p>date-received
2514 </p></li><li class="listitem"><p>from
2515 </p></li><li class="listitem"><p>mailbox-order (unsorted)
2516 </p></li><li class="listitem"><p>score
2517 </p></li><li class="listitem"><p>size
2518 </p></li><li class="listitem"><p>spam
2519 </p></li><li class="listitem"><p>subject
2520 </p></li><li class="listitem"><p>threads
2521 </p></li><li class="listitem"><p>to
2522 </p></li></ul></div><p>
2523 You may optionally use the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix to specify reverse sorting
2524 order (example: <span class="quote">“<span class="quote"><code class="literal">set sort=reverse-date-sent</code></span>”</span>).
2525 </p></div><div class="sect2" title="3.265. sort_alias"><div class="titlepage"><div><div><h3 class="title"><a id="sort-alias"></a>3.265. sort_alias</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
2526 Default: alias</p></div><p>
2527 Specifies how the entries in the <span class="quote">“<span class="quote">alias</span>”</span> menu are sorted. The
2528 following are legal values:
2530 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>address (sort alphabetically by email address)
2531 </p></li><li class="listitem"><p>alias (sort alphabetically by alias name)
2532 </p></li><li class="listitem"><p>unsorted (leave in order specified in .muttrc)
2533 </p></li></ul></div></div><div class="sect2" title="3.266. sort_aux"><div class="titlepage"><div><div><h3 class="title"><a id="sort-aux"></a>3.266. sort_aux</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
2534 Default: date</p></div><p>
2535 When sorting by threads, this variable controls how threads are sorted
2536 in relation to other threads, and how the branches of the thread trees
2537 are sorted. This can be set to any value that <a class="link" href="reference.html#sort" title="3.264. sort">$sort</a> can, except
2538 <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
2539 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>
2540 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
2541 sorted against its siblings by which has the last descendant, using
2542 the rest of <a class="link" href="reference.html#sort-aux" title="3.266. sort_aux">$sort_aux</a> as an ordering. For instance,
2544 </p><pre class="screen">
2545 set sort_aux=last-date-received
2547 would mean that if a new message is received in a
2548 thread, that thread becomes the last one displayed (or the first, if
2549 you have <span class="quote">“<span class="quote"><code class="literal">set sort=reverse-threads</code></span>”</span>.)
2551 Note: For reversed <a class="link" href="reference.html#sort" title="3.264. sort">$sort</a>
2552 order <a class="link" href="reference.html#sort-aux" title="3.266. sort_aux">$sort_aux</a> is reversed again (which is not the right thing to do,
2553 but kept to not break any existing configuration setting).
2554 </p></div><div class="sect2" title="3.267. sort_browser"><div class="titlepage"><div><div><h3 class="title"><a id="sort-browser"></a>3.267. sort_browser</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />
2555 Default: alpha</p></div><p>
2556 Specifies how to sort entries in the file browser. By default, the
2557 entries are sorted alphabetically. Valid values:
2559 </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>alpha (alphabetically)
2560 </p></li><li class="listitem"><p>date
2561 </p></li><li class="listitem"><p>size
2562 </p></li><li class="listitem"><p>unsorted
2563 </p></li></ul></div><p>
2564 You may optionally use the <span class="quote">“<span class="quote">reverse-</span>”</span> prefix to specify reverse sorting
2565 order (example: <span class="quote">“<span class="quote"><code class="literal">set sort_browser=reverse-date</code></span>”</span>).
2566 </p></div><div class="sect2" title="3.268. sort_re"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.268. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2567 Default: yes</p></div><p>
2568 This variable is only useful when sorting by threads with
2569 <a class="link" href="reference.html#strict-threads" title="3.285. strict_threads">$strict_threads</a> <span class="emphasis"><em>unset</em></span>. In that case, it changes the heuristic
2570 mutt uses to thread messages by subject. With <a class="link" href="reference.html#sort-re" title="3.268. sort_re">$sort_re</a> <span class="emphasis"><em>set</em></span>, mutt will
2571 only attach a message as the child of another message by subject if
2572 the subject of the child message starts with a substring matching the
2573 setting of <a class="link" href="reference.html#reply-regexp" title="3.213. reply_regexp">$reply_regexp</a>. With <a class="link" href="reference.html#sort-re" title="3.268. sort_re">$sort_re</a> <span class="emphasis"><em>unset</em></span>, mutt will attach
2574 the message whether or not this is the case, as long as the
2575 non-<a class="link" href="reference.html#reply-regexp" title="3.213. reply_regexp">$reply_regexp</a> parts of both messages are identical.
2576 </p></div><div class="sect2" title="3.269. spam_separator"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.269. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2577 Default: <span class="quote">“<span class="quote"><code class="literal">,</code></span>”</span></p></div><p>
2578 This variable controls what happens when multiple spam headers
2579 are matched: if <span class="emphasis"><em>unset</em></span>, each successive header will overwrite any
2580 previous matches value for the spam label. If <span class="emphasis"><em>set</em></span>, each successive
2581 match will append to the previous, using this variable's value as a
2583 </p></div><div class="sect2" title="3.270. spoolfile"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.270. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2584 Default: (empty)</p></div><p>
2585 If your spool mailbox is in a non-default place where Mutt cannot find
2586 it, you can specify its location with this variable. Mutt will
2587 initially set this variable to the value of the environment
2588 variable <code class="literal">$MAIL</code> or <code class="literal">$MAILDIR</code> if either is defined.
2589 </p></div><div class="sect2" title="3.271. ssl_ca_certificates_file"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.271. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2590 Default: (empty)</p></div><p>
2591 This variable specifies a file containing trusted CA certificates.
2592 Any server certificate that is signed with one of these CA
2593 certificates is also automatically accepted.
2597 </p><pre class="screen">
2598 set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
2599 </pre></div><div class="sect2" title="3.272. ssl_client_cert"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.272. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2600 Default: (empty)</p></div><p>
2601 The file containing a client certificate and its associated private
2603 </p></div><div class="sect2" title="3.273. ssl_force_tls"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.273. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2604 Default: no</p></div><p>
2605 If this variable is <span class="emphasis"><em>set</em></span>, Mutt will require that all connections
2606 to remote servers be encrypted. Furthermore it will attempt to
2607 negotiate TLS even if the server does not advertise the capability,
2608 since it would otherwise have to abort the connection anyway. This
2609 option supersedes <a class="link" href="reference.html#ssl-starttls" title="3.275. ssl_starttls">$ssl_starttls</a>.
2610 </p></div><div class="sect2" title="3.274. ssl_min_dh_prime_bits"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.274. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2611 Default: 0</p></div><p>
2612 This variable specifies the minimum acceptable prime size (in bits)
2613 for use in any Diffie-Hellman key exchange. A value of 0 will use
2614 the default from the GNUTLS library.
2615 </p></div><div class="sect2" title="3.275. ssl_starttls"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.275. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />
2616 Default: yes</p></div><p>
2617 If <span class="emphasis"><em>set</em></span> (the default), mutt will attempt to use <code class="literal">STARTTLS</code> on servers
2618 advertising the capability. When <span class="emphasis"><em>unset</em></span>, mutt will not attempt to
2619 use <code class="literal">STARTTLS</code> regardless of the server's capabilities.
2620 </p></div><div class="sect2" title="3.276. ssl_use_sslv2"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.276. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2621 Default: no</p></div><p>
2622 This variable specifies whether to attempt to use SSLv2 in the
2623 SSL authentication process.
2624 </p></div><div class="sect2" title="3.277. ssl_use_sslv3"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.277. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2625 Default: yes</p></div><p>
2626 This variable specifies whether to attempt to use SSLv3 in the
2627 SSL authentication process.
2628 </p></div><div class="sect2" title="3.278. ssl_use_tlsv1"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.278. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2629 Default: yes</p></div><p>
2630 This variable specifies whether to attempt to use TLSv1 in the
2631 SSL authentication process.
2632 </p></div><div class="sect2" title="3.279. ssl_usesystemcerts"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.279. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2633 Default: yes</p></div><p>
2634 If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the
2635 system-wide certificate store when checking if a server certificate
2636 is signed by a trusted CA.
2637 </p></div><div class="sect2" title="3.280. ssl_verify_dates"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-dates"></a>3.280. ssl_verify_dates</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2638 Default: yes</p></div><p>
2639 If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
2640 certificate that is either not yet valid or already expired. You should
2641 only unset this for particular known hosts, using the
2642 <code class="literal"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts"><account-hook></a></code> function.
2643 </p></div><div class="sect2" title="3.281. ssl_verify_host"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-verify-host"></a>3.281. ssl_verify_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2644 Default: yes</p></div><p>
2645 If <span class="emphasis"><em>set</em></span> (the default), mutt will not automatically accept a server
2646 certificate whose host name does not match the host used in your folder
2647 URL. You should only unset this for particular known hosts, using
2648 the <code class="literal"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts"><account-hook></a></code> function.
2649 </p></div><div class="sect2" title="3.282. status_chars"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.282. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2650 Default: <span class="quote">“<span class="quote"><code class="literal">-*%A</code></span>”</span></p></div><p>
2651 Controls the characters used by the <span class="quote">“<span class="quote">%r</span>”</span> indicator in
2652 <a class="link" href="reference.html#status-format" title="3.283. status_format">$status_format</a>. The first character is used when the mailbox is
2653 unchanged. The second is used when the mailbox has been changed, and
2654 it needs to be resynchronized. The third is used if the mailbox is in
2655 read-only mode, or if the mailbox will not be written when exiting
2656 that mailbox (You can toggle whether to write changes to a mailbox
2657 with the <code class="literal"><toggle-write></code> operation, bound by default to <span class="quote">“<span class="quote">%</span>”</span>). The fourth
2658 is used to indicate that the current folder has been opened in attach-
2659 message mode (Certain operations like composing a new mail, replying,
2660 forwarding, etc. are not permitted in this mode).
2661 </p></div><div class="sect2" title="3.283. status_format"><div class="titlepage"><div><div><h3 class="title"><a id="status-format"></a>3.283. status_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2662 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?%?l? %l?]---(%s/%S)-%>-(%P)---</code></span>”</span></p></div><p>
2663 Controls the format of the status line displayed in the <span class="quote">“<span class="quote">index</span>”</span>
2664 menu. This string is similar to <a class="link" href="reference.html#index-format" title="3.114. index_format">$index_format</a>, but has its own
2665 set of <code class="literal">printf(3)</code>-like sequences:
2667 </p><div class="informaltable"><table border="1"><colgroup><col /><col /></colgroup><tbody><tr><td>%b </td><td>number of mailboxes with new mail *
2668 </td></tr><tr><td>%d </td><td>number of deleted messages *
2669 </td></tr><tr><td>%f </td><td>the full pathname of the current mailbox
2670 </td></tr><tr><td>%F </td><td>number of flagged messages *
2671 </td></tr><tr><td>%h </td><td>local hostname
2672 </td></tr><tr><td>%l </td><td>size (in bytes) of the current mailbox *
2673 </td></tr><tr><td>%L </td><td>size (in bytes) of the messages shown
2674 (i.e., which match the current limit) *
2675 </td></tr><tr><td>%m </td><td>the number of messages in the mailbox *
2676 </td></tr><tr><td>%M </td><td>the number of messages shown (i.e., which match the current limit) *
2677 </td></tr><tr><td>%n </td><td>number of new messages in the mailbox *
2678 </td></tr><tr><td>%o </td><td>number of old unread messages *
2679 </td></tr><tr><td>%p </td><td>number of postponed messages *
2680 </td></tr><tr><td>%P </td><td>percentage of the way through the index
2681 </td></tr><tr><td>%r </td><td>modified/read-only/won't-write/attach-message indicator,
2682 according to <a class="link" href="reference.html#status-chars" title="3.282. status_chars">$status_chars</a>
2683 </td></tr><tr><td>%s </td><td>current sorting mode (<a class="link" href="reference.html#sort" title="3.264. sort">$sort</a>)
2684 </td></tr><tr><td>%S </td><td>current aux sorting method (<a class="link" href="reference.html#sort-aux" title="3.266. sort_aux">$sort_aux</a>)
2685 </td></tr><tr><td>%t </td><td>number of tagged messages *
2686 </td></tr><tr><td>%u </td><td>number of unread messages *
2687 </td></tr><tr><td>%v </td><td>Mutt version string
2688 </td></tr><tr><td>%V </td><td>currently active limit pattern, if any *
2689 </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>
2690 </td></tr><tr><td>%|X </td><td>pad to the end of the line with <span class="quote">“<span class="quote">X</span>”</span>
2691 </td></tr><tr><td>%*X </td><td>soft-fill with character <span class="quote">“<span class="quote">X</span>”</span> as pad
2692 </td></tr></tbody></table></div><p>
2693 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.114. index_format">$index_format</a> documentation.
2695 * = can be optionally printed if nonzero
2697 Some of the above sequences can be used to optionally print a string
2698 if their value is nonzero. For example, you may only want to see the
2699 number of flagged messages if such messages exist, since zero is not
2700 particularly meaningful. To optionally print a string based upon one
2701 of the above sequences, the following construct is used:
2703 <code class="literal">%?<sequence_char>?<optional_string>?</code>
2705 where <span class="emphasis"><em>sequence_char</em></span> is a character from the table above, and
2706 <span class="emphasis"><em>optional_string</em></span> is the string you would like printed if
2707 <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
2708 other sequences as well as normal text, but you may <span class="bold"><strong>not</strong></span> nest
2711 Here is an example illustrating how to optionally print the number of
2712 new messages in a mailbox:
2714 <code class="literal">%?n?%n new messages.?</code>
2716 You can also switch between two strings using the following construct:
2718 <code class="literal">%?<sequence_char>?<if_string>&<else_string>?</code>
2720 If the value of <span class="emphasis"><em>sequence_char</em></span> is non-zero, <span class="emphasis"><em>if_string</em></span> will
2721 be expanded, otherwise <span class="emphasis"><em>else_string</em></span> will be expanded.
2723 You can force the result of any <code class="literal">printf(3)</code>-like sequence to be lowercase
2724 by prefixing the sequence character with an underscore (<span class="quote">“<span class="quote">_</span>”</span>) sign.
2725 For example, if you want to display the local hostname in lowercase,
2726 you would use: <span class="quote">“<span class="quote"><code class="literal">%_h</code></span>”</span>.
2728 If you prefix the sequence character with a colon (<span class="quote">“<span class="quote">:</span>”</span>) character, mutt
2729 will replace any dots in the expansion by underscores. This might be helpful
2730 with IMAP folders that don't like dots in folder names.
2731 </p></div><div class="sect2" title="3.284. status_on_top"><div class="titlepage"><div><div><h3 class="title"><a id="status-on-top"></a>3.284. status_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2732 Default: no</p></div><p>
2733 Setting this variable causes the <span class="quote">“<span class="quote">status bar</span>”</span> to be displayed on
2734 the first line of the screen rather than near the bottom. If <a class="link" href="reference.html#help" title="3.82. help">$help</a>
2735 is <span class="emphasis"><em>set</em></span>, too it'll be placed at the bottom.
2736 </p></div><div class="sect2" title="3.285. strict_threads"><div class="titlepage"><div><div><h3 class="title"><a id="strict-threads"></a>3.285. strict_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2737 Default: no</p></div><p>
2738 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
2739 <span class="quote">“<span class="quote">References:</span>”</span> fields when you <a class="link" href="reference.html#sort" title="3.264. sort">$sort</a> by message threads. By
2740 default, messages with the same subject are grouped together in
2741 <span class="quote">“<span class="quote">pseudo threads.</span>”</span>. This may not always be desirable, such as in a
2742 personal mailbox where you might have several unrelated messages with
2743 the subjects like <span class="quote">“<span class="quote">hi</span>”</span> which will get grouped together. See also
2744 <a class="link" href="reference.html#sort-re" title="3.268. sort_re">$sort_re</a> for a less drastic way of controlling this
2746 </p></div><div class="sect2" title="3.286. suspend"><div class="titlepage"><div><div><h3 class="title"><a id="suspend"></a>3.286. suspend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2747 Default: yes</p></div><p>
2748 When <span class="emphasis"><em>unset</em></span>, mutt won't stop when the user presses the terminal's
2749 <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
2750 inside an xterm using a command like <span class="quote">“<span class="quote"><code class="literal">xterm -e mutt</code></span>”</span>.
2751 </p></div><div class="sect2" title="3.287. text_flowed"><div class="titlepage"><div><div><h3 class="title"><a id="text-flowed"></a>3.287. text_flowed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2752 Default: no</p></div><p>
2753 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
2754 of <span class="quote">“<span class="quote"><code class="literal">text/plain; format=flowed</code></span>”</span>.
2755 This format is easier to handle for some mailing software, and generally
2756 just looks like ordinary text. To actually make use of this format's
2757 features, you'll need support in your editor.
2759 Note that <a class="link" href="reference.html#indent-string" title="3.113. indent_string">$indent_string</a> is ignored when this option is <span class="emphasis"><em>set</em></span>.
2760 </p></div><div class="sect2" title="3.288. thorough_search"><div class="titlepage"><div><div><h3 class="title"><a id="thorough-search"></a>3.288. thorough_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2761 Default: yes</p></div><p>
2762 Affects the <code class="literal">~b</code> and <code class="literal">~h</code> search operations described in
2763 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
2764 messages to be searched are decoded before searching. If <span class="emphasis"><em>unset</em></span>,
2765 messages are searched as they appear in the folder.
2767 Users searching attachments or for non-ASCII characters should <span class="emphasis"><em>set</em></span>
2768 this value because decoding also includes MIME parsing/decoding and possible
2769 character set conversions. Otherwise mutt will attempt to match against the
2770 raw message received (for example quoted-printable encoded or with encoded
2771 headers) which may lead to incorrect search results.
2772 </p></div><div class="sect2" title="3.289. thread_received"><div class="titlepage"><div><div><h3 class="title"><a id="thread-received"></a>3.289. thread_received</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2773 Default: no</p></div><p>
2774 When <span class="emphasis"><em>set</em></span>, mutt uses the date received rather than the date sent
2775 to thread messages by subject.
2776 </p></div><div class="sect2" title="3.290. tilde"><div class="titlepage"><div><div><h3 class="title"><a id="tilde"></a>3.290. tilde</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2777 Default: no</p></div><p>
2778 When <span class="emphasis"><em>set</em></span>, the internal-pager will pad blank lines to the bottom of the
2779 screen with a tilde (<span class="quote">“<span class="quote">~</span>”</span>).
2780 </p></div><div class="sect2" title="3.291. time_inc"><div class="titlepage"><div><div><h3 class="title"><a id="time-inc"></a>3.291. time_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2781 Default: 0</p></div><p>
2782 Along with <a class="link" href="reference.html#read-inc" title="3.208. read_inc">$read_inc</a>, <a class="link" href="reference.html#write-inc" title="3.312. write_inc">$write_inc</a>, and <a class="link" href="reference.html#net-inc" title="3.148. net_inc">$net_inc</a>, this
2783 variable controls the frequency with which progress updates are
2784 displayed. It suppresses updates less than <a class="link" href="reference.html#time-inc" title="3.291. time_inc">$time_inc</a> milliseconds
2785 apart. This can improve throughput on systems with slow terminals,
2786 or when running mutt on a remote system.
2788 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.
2789 </p></div><div class="sect2" title="3.292. timeout"><div class="titlepage"><div><div><h3 class="title"><a id="timeout"></a>3.292. timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2790 Default: 600</p></div><p>
2791 When Mutt is waiting for user input either idling in menus or
2792 in an interactive prompt, Mutt would block until input is
2793 present. Depending on the context, this would prevent certain
2794 operations from working, like checking for new mail or keeping
2795 an IMAP connection alive.
2797 This variable controls how many seconds Mutt will at most wait
2798 until it aborts waiting for input, performs these operations and
2799 continues to wait for input.
2801 A value of zero or less will cause Mutt to never time out.
2802 </p></div><div class="sect2" title="3.293. tmpdir"><div class="titlepage"><div><div><h3 class="title"><a id="tmpdir"></a>3.293. tmpdir</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2803 Default: (empty)</p></div><p>
2804 This variable allows you to specify where Mutt will place its
2805 temporary files needed for displaying and composing messages. If
2806 this variable is not set, the environment variable <code class="literal">$TMPDIR</code> is
2807 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.
2808 </p></div><div class="sect2" title="3.294. to_chars"><div class="titlepage"><div><div><h3 class="title"><a id="to-chars"></a>3.294. to_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2809 Default: <span class="quote">“<span class="quote"><code class="literal"> +TCFL</code></span>”</span></p></div><p>
2810 Controls the character used to indicate mail addressed to you. The
2811 first character is the one used when the mail is <span class="emphasis"><em>not</em></span> addressed to your
2812 address. The second is used when you are the only
2813 recipient of the message. The third is when your address
2814 appears in the <span class="quote">“<span class="quote">To:</span>”</span> header field, but you are not the only recipient of
2815 the message. The fourth character is used when your
2816 address is specified in the <span class="quote">“<span class="quote">Cc:</span>”</span> header field, but you are not the only
2817 recipient. The fifth character is used to indicate mail that was sent
2818 by <span class="emphasis"><em>you</em></span>. The sixth character is used to indicate when a mail
2819 was sent to a mailing-list you subscribe to.
2820 </p></div><div class="sect2" title="3.295. tunnel"><div class="titlepage"><div><div><h3 class="title"><a id="tunnel"></a>3.295. tunnel</h3></div></div></div><div class="literallayout"><p>Type: string<br />
2821 Default: (empty)</p></div><p>
2822 Setting this variable will cause mutt to open a pipe to a command
2823 instead of a raw socket. You may be able to use this to set up
2824 preauthenticated connections to your IMAP/POP3/SMTP server. Example:
2826 </p><pre class="screen">
2827 set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
2829 Note: For this example to work you must be able to log in to the remote
2830 machine without having to enter a password.
2832 When set, Mutt uses the tunnel for all remote connections.
2833 Please see <span class="quote">“<span class="quote"><a class="link" href="optionalfeatures.html#account-hook" title="6. Managing Multiple Accounts">account-hook</a></span>”</span> in the manual for how to use different
2834 tunnel commands per connection.
2835 </p></div><div class="sect2" title="3.296. uncollapse_jump"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-jump"></a>3.296. uncollapse_jump</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2836 Default: no</p></div><p>
2837 When <span class="emphasis"><em>set</em></span>, Mutt will jump to the next unread message, if any,
2838 when the current thread is <span class="emphasis"><em>un</em></span>collapsed.
2839 </p></div><div class="sect2" title="3.297. use_8bitmime"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.297. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2840 Default: no</p></div><p>
2841 <span class="bold"><strong>Warning:</strong></span> do not set this variable unless you are using a version
2842 of sendmail which supports the <code class="literal">-B8BITMIME</code> flag (such as sendmail
2843 8.8.x) or you may not be able to send mail.
2845 When <span class="emphasis"><em>set</em></span>, Mutt will invoke <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a> with the <code class="literal">-B8BITMIME</code>
2846 flag when sending 8-bit messages to enable ESMTP negotiation.
2847 </p></div><div class="sect2" title="3.298. use_domain"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.298. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2848 Default: yes</p></div><p>
2849 When <span class="emphasis"><em>set</em></span>, Mutt will qualify all local addresses (ones without the
2850 <span class="quote">“<span class="quote">@host</span>”</span> portion) with the value of <a class="link" href="reference.html#hostname" title="3.93. hostname">$hostname</a>. If <span class="emphasis"><em>unset</em></span>, no
2851 addresses will be qualified.
2852 </p></div><div class="sect2" title="3.299. use_envelope_from"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.299. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2853 Default: no</p></div><p>
2854 When <span class="emphasis"><em>set</em></span>, mutt will set the <span class="emphasis"><em>envelope</em></span> sender of the message.
2855 If <a class="link" href="reference.html#envelope-from-address" title="3.61. envelope_from_address">$envelope_from_address</a> is <span class="emphasis"><em>set</em></span>, it will be used as the sender
2856 address. If <span class="emphasis"><em>unset</em></span>, mutt will attempt to derive the sender from the
2857 <span class="quote">“<span class="quote">From:</span>”</span> header.
2859 Note that this information is passed to sendmail command using the
2860 <code class="literal">-f</code> command line switch. Therefore setting this option is not useful
2861 if the <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a> variable already contains <code class="literal">-f</code> or if the
2862 executable pointed to by <a class="link" href="reference.html#sendmail" title="3.231. sendmail">$sendmail</a> doesn't support the <code class="literal">-f</code> switch.
2863 </p></div><div class="sect2" title="3.300. use_from"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.300. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2864 Default: yes</p></div><p>
2865 When <span class="emphasis"><em>set</em></span>, Mutt will generate the <span class="quote">“<span class="quote">From:</span>”</span> header field when
2866 sending messages. If <span class="emphasis"><em>unset</em></span>, no <span class="quote">“<span class="quote">From:</span>”</span> header field will be
2867 generated unless the user explicitly sets one using the <span class="quote">“<span class="quote"><a class="link" href="configuration.html#my-hdr" title="15. User-Defined Headers">my_hdr</a></span>”</span>
2869 </p></div><div class="sect2" title="3.301. use_idn"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.301. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2870 Default: yes</p></div><p>
2871 When <span class="emphasis"><em>set</em></span>, Mutt will show you international domain names decoded.
2872 Note: You can use IDNs for addresses even if this is <span class="emphasis"><em>unset</em></span>.
2873 This variable only affects decoding.
2874 </p></div><div class="sect2" title="3.302. use_ipv6"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.302. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2875 Default: yes</p></div><p>
2876 When <span class="emphasis"><em>set</em></span>, Mutt will look for IPv6 addresses of hosts it tries to
2877 contact. If this option is <span class="emphasis"><em>unset</em></span>, Mutt will restrict itself to IPv4 addresses.
2878 Normally, the default should work.
2879 </p></div><div class="sect2" title="3.303. user_agent"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.303. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2880 Default: yes</p></div><p>
2881 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
2882 messages, indicating which version of mutt was used for composing
2884 </p></div><div class="sect2" title="3.304. visual"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.304. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />
2885 Default: (empty)</p></div><p>
2886 Specifies the visual editor to invoke when the <span class="quote">“<span class="quote"><code class="literal">~v</code></span>”</span> command is
2887 given in the built-in editor.
2888 </p></div><div class="sect2" title="3.305. wait_key"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.305. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2889 Default: yes</p></div><p>
2890 Controls whether Mutt will ask you to press a key after an external command
2891 has been invoked by these functions: <code class="literal"><shell-escape></code>,
2892 <code class="literal"><pipe-message></code>, <code class="literal"><pipe-entry></code>, <code class="literal"><print-message></code>,
2893 and <code class="literal"><print-entry></code> commands.
2895 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
2896 that the corresponding mailcap entry has a <span class="emphasis"><em>needsterminal</em></span> flag,
2897 and the external program is interactive.
2899 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
2900 for a key only if the external command returned a non-zero status.
2901 </p></div><div class="sect2" title="3.306. weed"><div class="titlepage"><div><div><h3 class="title"><a id="weed"></a>3.306. weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2902 Default: yes</p></div><p>
2903 When <span class="emphasis"><em>set</em></span>, mutt will weed headers when displaying, forwarding,
2904 printing, or replying to messages.
2905 </p></div><div class="sect2" title="3.307. wrap"><div class="titlepage"><div><div><h3 class="title"><a id="wrap"></a>3.307. wrap</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2906 Default: 0</p></div><p>
2907 When set to a positive value, mutt will wrap text at <a class="link" href="reference.html#wrap" title="3.307. wrap">$wrap</a> characters.
2908 When set to a negative value, mutt will wrap text so that there are <a class="link" href="reference.html#wrap" title="3.307. wrap">$wrap</a>
2909 characters of empty space on the right side of the terminal. Setting it
2910 to zero makes mutt wrap at the terminal width.
2911 </p></div><div class="sect2" title="3.308. wrap_headers"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-headers"></a>3.308. wrap_headers</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2912 Default: 78</p></div><p>
2913 This option specifies the number of characters to use for wrapping
2914 an outgoing message's headers. Allowed values are between 78 and 998
2917 <span class="bold"><strong>Note:</strong></span> This option usually shouldn't be changed. RFC5233
2918 recommends a line length of 78 (the default), so <span class="bold"><strong>please only change
2919 this setting when you know what you're doing</strong></span>.
2920 </p></div><div class="sect2" title="3.309. wrap_search"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-search"></a>3.309. wrap_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2921 Default: yes</p></div><p>
2922 Controls whether searches wrap around the end.
2924 When <span class="emphasis"><em>set</em></span>, searches will wrap around the first (or last) item. When
2925 <span class="emphasis"><em>unset</em></span>, incremental searches will not wrap.
2926 </p></div><div class="sect2" title="3.310. wrapmargin"><div class="titlepage"><div><div><h3 class="title"><a id="wrapmargin"></a>3.310. wrapmargin</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2927 Default: 0</p></div><p>
2928 (DEPRECATED) Equivalent to setting <a class="link" href="reference.html#wrap" title="3.307. wrap">$wrap</a> with a negative value.
2929 </p></div><div class="sect2" title="3.311. write_bcc"><div class="titlepage"><div><div><h3 class="title"><a id="write-bcc"></a>3.311. write_bcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />
2930 Default: yes</p></div><p>
2931 Controls whether mutt writes out the <span class="quote">“<span class="quote">Bcc:</span>”</span> header when preparing
2932 messages to be sent. Exim users may wish to unset this. If mutt
2933 is set to deliver directly via SMTP (see <a class="link" href="reference.html#smtp-url" title="3.263. smtp_url">$smtp_url</a>), this
2934 option does nothing: mutt will never write out the <span class="quote">“<span class="quote">Bcc:</span>”</span> header
2936 </p></div><div class="sect2" title="3.312. write_inc"><div class="titlepage"><div><div><h3 class="title"><a id="write-inc"></a>3.312. write_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />
2937 Default: 10</p></div><p>
2938 When writing a mailbox, a message will be printed every
2939 <a class="link" href="reference.html#write-inc" title="3.312. write_inc">$write_inc</a> messages to indicate progress. If set to 0, only a
2940 single message will be displayed before writing a mailbox.
2942 Also see the <a class="link" href="reference.html#read-inc" title="3.208. read_inc">$read_inc</a>, <a class="link" href="reference.html#net-inc" title="3.148. net_inc">$net_inc</a> and <a class="link" href="reference.html#time-inc" title="3.291. time_inc">$time_inc</a> variables and the
2943 <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.
2944 </p></div></div><div class="sect1" title="4. Functions"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="functions"></a>4. Functions</h2></div></div></div><p>
2945 The following is the list of available functions listed by the mapping
2946 in which they are available. The default key setting is given, and an
2947 explanation of what the function does. The key bindings of these
2948 functions can be changed with the <a class="link" href="configuration.html#bind" title="5. Changing the Default Key Bindings">bind</a>
2950 </p><div class="sect2" title="4.1. Generic Menu"><div class="titlepage"><div><div><h3 class="title"><a id="generic-map"></a>4.1. Generic Menu</h3></div></div></div><p>
2951 The <span class="emphasis"><em>generic</em></span> menu is not a real menu, but specifies common functions
2952 (such as movement) available in all menus except for <span class="emphasis"><em>pager</em></span> and
2953 <span class="emphasis"><em>editor</em></span>. Changing settings for this menu will affect the default
2954 bindings for all menus (except as noted).
2955 </p><div class="table"><a id="tab-generic-bindings"></a><p class="title"><b>Table 9.2. Default Generic Menu Bindings</b></p><div class="table-contents"><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"><top-page></code></td><td>H</td><td>move to the top of the page</td></tr><tr><td><code class="literal"><next-entry></code></td><td>j</td><td>move to the next entry</td></tr><tr><td><code class="literal"><previous-entry></code></td><td>k</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><bottom-page></code></td><td>L</td><td>move to the bottom of the page</td></tr><tr><td><code class="literal"><refresh></code></td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td><code class="literal"><middle-page></code></td><td>M</td><td>move to the middle of the page</td></tr><tr><td><code class="literal"><search-next></code></td><td>n</td><td>search for next match</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><tag-entry></code></td><td>t</td><td>tag the current entry</td></tr><tr><td><code class="literal"><next-page></code></td><td>z</td><td>move to the next page</td></tr><tr><td><code class="literal"><previous-page></code></td><td>Z</td><td>move to the previous page</td></tr><tr><td><code class="literal"><last-entry></code></td><td>*</td><td>move to the last entry</td></tr><tr><td><code class="literal"><first-entry></code></td><td>=</td><td>move to the first entry</td></tr><tr><td><code class="literal"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><next-line></code></td><td>></td><td>scroll down one line</td></tr><tr><td><code class="literal"><previous-line></code></td><td><</td><td>scroll up one line</td></tr><tr><td><code class="literal"><half-up></code></td><td>[</td><td>scroll up 1/2 page</td></tr><tr><td><code class="literal"><half-down></code></td><td>]</td><td>scroll down 1/2 page</td></tr><tr><td><code class="literal"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><tag-prefix></code></td><td>;</td><td>apply next function to tagged messages</td></tr><tr><td><code class="literal"><tag-prefix-cond></code></td><td> </td><td>apply next function ONLY to tagged messages</td></tr><tr><td><code class="literal"><end-cond></code></td><td> </td><td>end of conditional execution (noop)</td></tr><tr><td><code class="literal"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td><code class="literal"><select-entry></code></td><td><Return></td><td>select the current entry</td></tr><tr><td><code class="literal"><search></code></td><td>/</td><td>search for a regular expression</td></tr><tr><td><code class="literal"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</td></tr><tr><td><code class="literal"><jump></code></td><td> </td><td>jump to an index number</td></tr><tr><td><code class="literal"><current-top></code></td><td> </td><td>move entry to top of screen</td></tr><tr><td><code class="literal"><current-middle></code></td><td> </td><td>move entry to middle of screen</td></tr><tr><td><code class="literal"><current-bottom></code></td><td> </td><td>move entry to bottom of screen</td></tr><tr><td><code class="literal"><what-key></code></td><td> </td><td>display the keycode for a key press</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.2. Index Menu"><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"><b>Table 9.3. Default Index Menu Bindings</b></p><div class="table-contents"><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"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><break-thread></code></td><td>#</td><td>break the thread in two</td></tr><tr><td><code class="literal"><change-folder></code></td><td>c</td><td>open a different folder</td></tr><tr><td><code class="literal"><change-folder-readonly></code></td><td>Esc c</td><td>open a different folder in read only mode</td></tr><tr><td><code class="literal"><next-unread-mailbox></code></td><td> </td><td>open next mailbox with new mail</td></tr><tr><td><code class="literal"><collapse-thread></code></td><td>Esc v</td><td>collapse/uncollapse current thread</td></tr><tr><td><code class="literal"><collapse-all></code></td><td>Esc V</td><td>collapse/uncollapse all threads</td></tr><tr><td><code class="literal"><copy-message></code></td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td><code class="literal"><decode-copy></code></td><td>Esc C</td><td>make decoded (text/plain) copy</td></tr><tr><td><code class="literal"><decode-save></code></td><td>Esc s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td><code class="literal"><delete-message></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><delete-pattern></code></td><td>D</td><td>delete messages matching a pattern</td></tr><tr><td><code class="literal"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</td></tr><tr><td><code class="literal"><delete-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</td></tr><tr><td><code class="literal"><edit></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><fetch-mail></code></td><td>G</td><td>retrieve mail from POP server</td></tr><tr><td><code class="literal"><imap-fetch-mail></code></td><td> </td><td>force retrieval of mail from IMAP server</td></tr><tr><td><code class="literal"><imap-logout-all></code></td><td> </td><td>logout from all IMAP servers</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td>j</td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><limit></code></td><td>l</td><td>show only messages matching a pattern</td></tr><tr><td><code class="literal"><link-threads></code></td><td>&</td><td>link tagged message to the current one</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><toggle-new></code></td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td><code class="literal"><toggle-write></code></td><td>%</td><td>toggle whether the mailbox will be rewritten</td></tr><tr><td><code class="literal"><next-thread></code></td><td>^N</td><td>jump to the next thread</td></tr><tr><td><code class="literal"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</td></tr><tr><td><code class="literal"><query></code></td><td>Q</td><td>query external program for addresses</td></tr><tr><td><code class="literal"><quit></code></td><td>q</td><td>save changes to mailbox and quit</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><show-limit></code></td><td>Esc l</td><td>show currently active limit pattern</td></tr><tr><td><code class="literal"><sort-mailbox></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><print-message></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><previous-thread></code></td><td>^P</td><td>jump to previous thread</td></tr><tr><td><code class="literal"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</td></tr><tr><td><code class="literal"><recall-message></code></td><td>R</td><td>recall a postponed message</td></tr><tr><td><code class="literal"><read-thread></code></td><td>^R</td><td>mark the current thread as read</td></tr><tr><td><code class="literal"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><save-message></code></td><td>s</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><tag-pattern></code></td><td>T</td><td>tag messages matching a pattern</td></tr><tr><td><code class="literal"><tag-subthread></code></td><td> </td><td>tag the current subthread</td></tr><tr><td><code class="literal"><tag-thread></code></td><td>Esc t</td><td>tag the current thread</td></tr><tr><td><code class="literal"><untag-pattern></code></td><td>^T</td><td>untag messages matching a pattern</td></tr><tr><td><code class="literal"><undelete-message></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><undelete-pattern></code></td><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td><code class="literal"><undelete-subthread></code></td><td>Esc u</td><td>undelete all messages in subthread</td></tr><tr><td><code class="literal"><undelete-thread></code></td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr><tr><td><code class="literal"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><set-flag></code></td><td>w</td><td>set a status flag on a message</td></tr><tr><td><code class="literal"><clear-flag></code></td><td>W</td><td>clear a status flag from a message</td></tr><tr><td><code class="literal"><display-message></code></td><td><Return></td><td>display a message</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</td></tr><tr><td><code class="literal"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><pipe-message></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><next-new></code></td><td> </td><td>jump to the next new message</td></tr><tr><td><code class="literal"><next-new-then-unread></code></td><td><Tab></td><td>jump to the next new or unread message</td></tr><tr><td><code class="literal"><previous-new></code></td><td> </td><td>jump to the previous new message</td></tr><tr><td><code class="literal"><previous-new-then-unread></code></td><td>Esc <Tab></td><td>jump to the previous new or unread message</td></tr><tr><td><code class="literal"><next-unread></code></td><td> </td><td>jump to the next unread message</td></tr><tr><td><code class="literal"><previous-unread></code></td><td> </td><td>jump to the previous unread message</td></tr><tr><td><code class="literal"><parent-message></code></td><td>P</td><td>jump to parent message in thread</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><decrypt-copy></code></td><td> </td><td>make decrypted copy</td></tr><tr><td><code class="literal"><decrypt-save></code></td><td> </td><td>make decrypted copy and delete</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.3. Pager Menu"><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"><b>Table 9.4. Default Pager Menu Bindings</b></p><div class="table-contents"><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"><break-thread></code></td><td>#</td><td>break the thread in two</td></tr><tr><td><code class="literal"><create-alias></code></td><td>a</td><td>create an alias from a message sender</td></tr><tr><td><code class="literal"><bounce-message></code></td><td>b</td><td>remail a message to another user</td></tr><tr><td><code class="literal"><change-folder></code></td><td>c</td><td>open a different folder</td></tr><tr><td><code class="literal"><change-folder-readonly></code></td><td>Esc c</td><td>open a different folder in read only mode</td></tr><tr><td><code class="literal"><next-unread-mailbox></code></td><td> </td><td>open next mailbox with new mail</td></tr><tr><td><code class="literal"><copy-message></code></td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td><code class="literal"><decode-copy></code></td><td>Esc C</td><td>make decoded (text/plain) copy</td></tr><tr><td><code class="literal"><delete-message></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><delete-thread></code></td><td>^D</td><td>delete all messages in thread</td></tr><tr><td><code class="literal"><delete-subthread></code></td><td>Esc d</td><td>delete all messages in subthread</td></tr><tr><td><code class="literal"><set-flag></code></td><td>w</td><td>set a status flag on a message</td></tr><tr><td><code class="literal"><clear-flag></code></td><td>W</td><td>clear a status flag from a message</td></tr><tr><td><code class="literal"><edit></code></td><td>e</td><td>edit the raw message</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><flag-message></code></td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><imap-fetch-mail></code></td><td> </td><td>force retrieval of mail from IMAP server</td></tr><tr><td><code class="literal"><imap-logout-all></code></td><td> </td><td>logout from all IMAP servers</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><next-undeleted></code></td><td>j</td><td>move to the next undeleted message</td></tr><tr><td><code class="literal"><next-entry></code></td><td>J</td><td>move to the next entry</td></tr><tr><td><code class="literal"><previous-undeleted></code></td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td><code class="literal"><previous-entry></code></td><td>K</td><td>move to the previous entry</td></tr><tr><td><code class="literal"><link-threads></code></td><td>&</td><td>link tagged message to the current one</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><redraw-screen></code></td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td><code class="literal"><mail></code></td><td>m</td><td>compose a new mail message</td></tr><tr><td><code class="literal"><mark-as-new></code></td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td><code class="literal"><search-next></code></td><td>n</td><td>search for next match</td></tr><tr><td><code class="literal"><next-thread></code></td><td>^N</td><td>jump to the next thread</td></tr><tr><td><code class="literal"><next-subthread></code></td><td>Esc n</td><td>jump to the next subthread</td></tr><tr><td><code class="literal"><sort-mailbox></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><print-message></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><previous-thread></code></td><td>^P</td><td>jump to previous thread</td></tr><tr><td><code class="literal"><previous-subthread></code></td><td>Esc p</td><td>jump to previous subthread</td></tr><tr><td><code class="literal"><quit></code></td><td>Q</td><td>save changes to mailbox and quit</td></tr><tr><td><code class="literal"><exit></code></td><td>q</td><td>exit this menu</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><recall-message></code></td><td>R</td><td>recall a postponed message</td></tr><tr><td><code class="literal"><read-thread></code></td><td>^R</td><td>mark the current thread as read</td></tr><tr><td><code class="literal"><read-subthread></code></td><td>Esc r</td><td>mark the current subthread as read</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><save-message></code></td><td>s</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><skip-quoted></code></td><td>S</td><td>skip beyond quoted text</td></tr><tr><td><code class="literal"><decode-save></code></td><td>Esc s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td><code class="literal"><tag-message></code></td><td>t</td><td>tag the current entry</td></tr><tr><td><code class="literal"><toggle-quoted></code></td><td>T</td><td>toggle display of quoted text</td></tr><tr><td><code class="literal"><undelete-message></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><undelete-subthread></code></td><td>Esc u</td><td>undelete all messages in subthread</td></tr><tr><td><code class="literal"><undelete-thread></code></td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td><code class="literal"><view-attachments></code></td><td>v</td><td>show MIME attachments</td></tr><tr><td><code class="literal"><show-version></code></td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td><code class="literal"><search-toggle></code></td><td>\\</td><td>toggle search pattern coloring</td></tr><tr><td><code class="literal"><display-address></code></td><td>@</td><td>display full address of sender</td></tr><tr><td><code class="literal"><next-new></code></td><td> </td><td>jump to the next new message</td></tr><tr><td><code class="literal"><pipe-message></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><help></code></td><td>?</td><td>this screen</td></tr><tr><td><code class="literal"><next-page></code></td><td><Space></td><td>move to the next page</td></tr><tr><td><code class="literal"><previous-page></code></td><td>-</td><td>move to the previous page</td></tr><tr><td><code class="literal"><top></code></td><td>^</td><td>jump to the top of the message</td></tr><tr><td><code class="literal"><sync-mailbox></code></td><td>$</td><td>save changes to mailbox</td></tr><tr><td><code class="literal"><shell-escape></code></td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td><code class="literal"><enter-command></code></td><td>:</td><td>enter a muttrc command</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><search></code></td><td>/</td><td>search for a regular expression</td></tr><tr><td><code class="literal"><search-reverse></code></td><td>Esc /</td><td>search backwards for a regular expression</td></tr><tr><td><code class="literal"><search-opposite></code></td><td> </td><td>search for next match in opposite direction</td></tr><tr><td><code class="literal"><next-line></code></td><td><Return></td><td>scroll down one line</td></tr><tr><td><code class="literal"><jump></code></td><td> </td><td>jump to an index number</td></tr><tr><td><code class="literal"><next-unread></code></td><td> </td><td>jump to the next unread message</td></tr><tr><td><code class="literal"><previous-new></code></td><td> </td><td>jump to the previous new message</td></tr><tr><td><code class="literal"><previous-unread></code></td><td> </td><td>jump to the previous unread message</td></tr><tr><td><code class="literal"><half-up></code></td><td> </td><td>scroll up 1/2 page</td></tr><tr><td><code class="literal"><half-down></code></td><td> </td><td>scroll down 1/2 page</td></tr><tr><td><code class="literal"><previous-line></code></td><td> </td><td>scroll up one line</td></tr><tr><td><code class="literal"><bottom></code></td><td> </td><td>jump to the bottom of the message</td></tr><tr><td><code class="literal"><parent-message></code></td><td>P</td><td>jump to parent message in thread</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><mail-key></code></td><td>Esc k</td><td>mail a PGP public key</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><decrypt-copy></code></td><td> </td><td>make decrypted copy</td></tr><tr><td><code class="literal"><decrypt-save></code></td><td> </td><td>make decrypted copy and delete</td></tr><tr><td><code class="literal"><what-key></code></td><td> </td><td>display the keycode for a key press</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.4. Alias Menu"><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"><b>Table 9.5. Default Alias Menu Bindings</b></p><div class="table-contents"><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"><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" title="4.5. Query Menu"><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"><b>Table 9.6. Default Query Menu Bindings</b></p><div class="table-contents"><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" title="4.6. Attachment Menu"><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"><b>Table 9.7. Default Attachment Menu Bindings</b></p><div class="table-contents"><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"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^E</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><print-entry></code></td><td>p</td><td>print the current entry</td></tr><tr><td><code class="literal"><save-entry></code></td><td>s</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><view-mailcap></code></td><td>m</td><td>force viewing of attachment using mailcap</td></tr><tr><td><code class="literal"><reply></code></td><td>r</td><td>reply to a message</td></tr><tr><td><code class="literal"><resend-message></code></td><td>Esc e</td><td>use the current message as a template for a new one</td></tr><tr><td><code class="literal"><group-reply></code></td><td>g</td><td>reply to all recipients</td></tr><tr><td><code class="literal"><list-reply></code></td><td>L</td><td>reply to specified mailing list</td></tr><tr><td><code class="literal"><forward-message></code></td><td>f</td><td>forward a message with comments</td></tr><tr><td><code class="literal"><view-text></code></td><td>T</td><td>view attachment as text</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Return></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><delete-entry></code></td><td>d</td><td>delete the current entry</td></tr><tr><td><code class="literal"><undelete-entry></code></td><td>u</td><td>undelete the current entry</td></tr><tr><td><code class="literal"><collapse-parts></code></td><td>v</td><td>Toggle display of subparts</td></tr><tr><td><code class="literal"><check-traditional-pgp></code></td><td>Esc P</td><td>check for classic PGP</td></tr><tr><td><code class="literal"><extract-keys></code></td><td>^K</td><td>extract supported public keys</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.7. Compose Menu"><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"><b>Table 9.8. Default Compose Menu Bindings</b></p><div class="table-contents"><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-message></code></td><td>A</td><td>attach message(s) to this message</td></tr><tr><td><code class="literal"><edit-bcc></code></td><td>b</td><td>edit the BCC list</td></tr><tr><td><code class="literal"><edit-cc></code></td><td>c</td><td>edit the CC list</td></tr><tr><td><code class="literal"><copy-file></code></td><td>C</td><td>save message/attachment to a mailbox/file</td></tr><tr><td><code class="literal"><detach-file></code></td><td>D</td><td>delete the current entry</td></tr><tr><td><code class="literal"><toggle-disposition></code></td><td>^D</td><td>toggle disposition between inline/attachment</td></tr><tr><td><code class="literal"><edit-description></code></td><td>d</td><td>edit attachment description</td></tr><tr><td><code class="literal"><edit-message></code></td><td>e</td><td>edit the message</td></tr><tr><td><code class="literal"><edit-headers></code></td><td>E</td><td>edit the message with headers</td></tr><tr><td><code class="literal"><edit-file></code></td><td>^X e</td><td>edit the file to be attached</td></tr><tr><td><code class="literal"><edit-encoding></code></td><td>^E</td><td>edit attachment transfer-encoding</td></tr><tr><td><code class="literal"><edit-from></code></td><td>Esc f</td><td>edit the from field</td></tr><tr><td><code class="literal"><edit-fcc></code></td><td>f</td><td>enter a file to save a copy of this message in</td></tr><tr><td><code class="literal"><filter-entry></code></td><td>F</td><td>filter attachment through a shell command</td></tr><tr><td><code class="literal"><get-attachment></code></td><td>G</td><td>get a temporary copy of an attachment</td></tr><tr><td><code class="literal"><display-toggle-weed></code></td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td><code class="literal"><ispell></code></td><td>i</td><td>run ispell on the message</td></tr><tr><td><code class="literal"><print-entry></code></td><td>l</td><td>print the current entry</td></tr><tr><td><code class="literal"><edit-mime></code></td><td>m</td><td>edit attachment using mailcap entry</td></tr><tr><td><code class="literal"><new-mime></code></td><td>n</td><td>compose new attachment using mailcap entry</td></tr><tr><td><code class="literal"><postpone-message></code></td><td>P</td><td>save this message to send later</td></tr><tr><td><code class="literal"><edit-reply-to></code></td><td>r</td><td>edit the Reply-To field</td></tr><tr><td><code class="literal"><rename-file></code></td><td>R</td><td>rename/move an attached file</td></tr><tr><td><code class="literal"><edit-subject></code></td><td>s</td><td>edit the subject of this message</td></tr><tr><td><code class="literal"><edit-to></code></td><td>t</td><td>edit the TO list</td></tr><tr><td><code class="literal"><edit-type></code></td><td>^T</td><td>edit attachment content type</td></tr><tr><td><code class="literal"><write-fcc></code></td><td>w</td><td>write the message to a folder</td></tr><tr><td><code class="literal"><toggle-unlink></code></td><td>u</td><td>toggle whether to delete file after sending it</td></tr><tr><td><code class="literal"><toggle-recode></code></td><td> </td><td>toggle recoding of this attachment</td></tr><tr><td><code class="literal"><update-encoding></code></td><td>U</td><td>update an attachment's encoding info</td></tr><tr><td><code class="literal"><view-attach></code></td><td><Return></td><td>view attachment using mailcap entry if necessary</td></tr><tr><td><code class="literal"><send-message></code></td><td>y</td><td>send the message</td></tr><tr><td><code class="literal"><pipe-entry></code></td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td><code class="literal"><attach-key></code></td><td>Esc k</td><td>attach a PGP public key</td></tr><tr><td><code class="literal"><pgp-menu></code></td><td>p</td><td>show PGP options</td></tr><tr><td><code class="literal"><forget-passphrase></code></td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td><code class="literal"><smime-menu></code></td><td>S</td><td>show S/MIME options</td></tr><tr><td><code class="literal"><mix></code></td><td>M</td><td>send the message through a mixmaster remailer chain</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.8. Postpone Menu"><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"><b>Table 9.9. Default Postpone Menu Bindings</b></p><div class="table-contents"><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" title="4.9. Browser Menu"><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"><b>Table 9.10. Default Browser Menu Bindings</b></p><div class="table-contents"><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"><change-dir></code></td><td>c</td><td>change directories</td></tr><tr><td><code class="literal"><display-filename></code></td><td>@</td><td>display the currently selected file's name</td></tr><tr><td><code class="literal"><enter-mask></code></td><td>m</td><td>enter a file mask</td></tr><tr><td><code class="literal"><sort></code></td><td>o</td><td>sort messages</td></tr><tr><td><code class="literal"><sort-reverse></code></td><td>O</td><td>sort messages in reverse order</td></tr><tr><td><code class="literal"><select-new></code></td><td>N</td><td>select a new file in this directory</td></tr><tr><td><code class="literal"><check-new></code></td><td> </td><td>check mailboxes for new mail</td></tr><tr><td><code class="literal"><toggle-mailboxes></code></td><td><Tab></td><td>toggle whether to browse mailboxes or all files</td></tr><tr><td><code class="literal"><view-file></code></td><td><Space></td><td>view file</td></tr><tr><td><code class="literal"><buffy-list></code></td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td><code class="literal"><create-mailbox></code></td><td>C</td><td>create a new mailbox (IMAP only)</td></tr><tr><td><code class="literal"><delete-mailbox></code></td><td>d</td><td>delete the current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><rename-mailbox></code></td><td>r</td><td>rename the current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><subscribe></code></td><td>s</td><td>subscribe to current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><unsubscribe></code></td><td>u</td><td>unsubscribe from current mailbox (IMAP only)</td></tr><tr><td><code class="literal"><toggle-subscribed></code></td><td>T</td><td>toggle view all/subscribed mailboxes (IMAP only)</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.10. Pgp Menu"><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"><b>Table 9.11. Default Pgp Menu Bindings</b></p><div class="table-contents"><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" title="4.11. Smime Menu"><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"><b>Table 9.12. Default Smime Menu Bindings</b></p><div class="table-contents"><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" title="4.12. Mixmaster Menu"><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"><b>Table 9.13. Default Mixmaster Menu Bindings</b></p><div class="table-contents"><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><Return></td><td>Accept the chain constructed</td></tr><tr><td><code class="literal"><append></code></td><td>a</td><td>Append a remailer to the chain</td></tr><tr><td><code class="literal"><insert></code></td><td>i</td><td>Insert a remailer into the chain</td></tr><tr><td><code class="literal"><delete></code></td><td>d</td><td>Delete a remailer from the chain</td></tr><tr><td><code class="literal"><chain-prev></code></td><td><Left></td><td>Select the previous element of the chain</td></tr><tr><td><code class="literal"><chain-next></code></td><td><Right></td><td>Select the next element of the chain</td></tr></tbody></table></div></div><br class="table-break" /></div><div class="sect2" title="4.13. Editor Menu"><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"><b>Table 9.14. Default Editor Menu Bindings</b></p><div class="table-contents"><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"><bol></code></td><td>^A</td><td>jump to the beginning of the line</td></tr><tr><td><code class="literal"><backward-char></code></td><td>^B</td><td>move the cursor one character to the left</td></tr><tr><td><code class="literal"><backward-word></code></td><td>Esc b</td><td>move the cursor to the beginning of the word</td></tr><tr><td><code class="literal"><capitalize-word></code></td><td>Esc c</td><td>capitalize the word</td></tr><tr><td><code class="literal"><downcase-word></code></td><td>Esc l</td><td>convert the word to lower case</td></tr><tr><td><code class="literal"><upcase-word></code></td><td>Esc u</td><td>convert the word to upper case</td></tr><tr><td><code class="literal"><delete-char></code></td><td>^D</td><td>delete the char under the cursor</td></tr><tr><td><code class="literal"><eol></code></td><td>^E</td><td>jump to the end of the line</td></tr><tr><td><code class="literal"><forward-char></code></td><td>^F</td><td>move the cursor one character to the right</td></tr><tr><td><code class="literal"><forward-word></code></td><td>Esc f</td><td>move the cursor to the end of the word</td></tr><tr><td><code class="literal"><backspace></code></td><td><Backspace></td><td>delete the char in front of the cursor</td></tr><tr><td><code class="literal"><kill-eol></code></td><td>^K</td><td>delete chars from cursor to end of line</td></tr><tr><td><code class="literal"><kill-eow></code></td><td>Esc d</td><td>delete chars from the cursor to the end of the word</td></tr><tr><td><code class="literal"><kill-line></code></td><td>^U</td><td>delete all chars on the line</td></tr><tr><td><code class="literal"><quote-char></code></td><td>^V</td><td>quote the next typed key</td></tr><tr><td><code class="literal"><kill-word></code></td><td>^W</td><td>delete the word in front of the cursor</td></tr><tr><td><code class="literal"><complete></code></td><td><Tab></td><td>complete filename or alias</td></tr><tr><td><code class="literal"><complete-query></code></td><td>^T</td><td>complete address with query</td></tr><tr><td><code class="literal"><buffy-cycle></code></td><td><Space></td><td>cycle among incoming mailboxes</td></tr><tr><td><code class="literal"><history-up></code></td><td> </td><td>scroll up through the history list</td></tr><tr><td><code class="literal"><history-down></code></td><td> </td><td>scroll down through the history list</td></tr><tr><td><code class="literal"><transpose-chars></code></td><td> </td><td>transpose character under cursor with previous</td></tr></tbody></table></div></div><br class="table-break" /></div></div></div><div class="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>