~ubuntu-dev/ubuntu/lucid/mutt/lucid-201002101854 : revision 2.1.2

1

<?xml version="1.0" encoding="UTF-8"?>

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>The Mutt E-Mail Client</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /><meta name="description" content="
 ``All mail clients suck. This one just sucks less.'' -me, circa 1995
 " /></head><body><div class="book" lang="en" xml:lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="id2779299"></a>The Mutt E-Mail Client</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Michael</span> <span class="surname">Elkins</span></h3><code class="email"><<a href="mailto:me@cs.hmc.edu">me@cs.hmc.edu</a>></code></div></div><div><p class="releaseinfo">version 1.5.13 (2006-08-11)</p></div><div><div class="abstract"><p class="title"><b>Abstract</b></p><p>

3

<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Mutt E-Mail Client</title><meta name="generator" content="DocBook XSL Stylesheets V1.71.1" /><meta name="description" content="``All mail clients suck. This one just sucks less.'' -me, circa 1995" /></head><body><div class="book" lang="en" xml:lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="id362612"></a>The Mutt E-Mail Client</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Michael</span> <span class="surname">Elkins</span></h3><code class="email"><<a href="mailto:me@cs.hmc.edu">me@cs.hmc.edu</a>></code></div></div><div><p class="releaseinfo">version 1.5.18 (2008-05-17)</p></div><div><div class="abstract"><p class="title"><b>Abstract</b></p><p>

4

``All mail clients suck. This one just sucks less.'' -me, circa 1995

5

</p></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#intro">1. Introduction</a></span></dt><dd><dl><dt><span class="sect1"><a href="#homepage">1. Mutt Home Page</a></span></dt><dt><span class="sect1"><a href="#muttlists">2. Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#distribution">3. Software Distribution Sites</a></span></dt><dt><span class="sect1"><a href="#irc">4. IRC</a></span></dt><dt><span class="sect1"><a href="#usenet">5. USENET</a></span></dt><dt><span class="sect1"><a href="#copyright">6. Copyright</a></span></dt></dl></dd><dt><span class="chapter"><a href="#gettingstarted">2. Getting Started</a></span></dt><dd><dl><dt><span class="sect1"><a href="#menus">1. Moving Around in Menus</a></span></dt><dt><span class="sect1"><a href="#editing">2. Editing Input Fields</a></span></dt><dd><dl><dt><span class="sect2"><a href="#editing-intro">2.1. Introduction</a></span></dt><dt><span class="sect2"><a href="#editing-history">2.2. History</a></span></dt></dl></dd><dt><span class="sect1"><a href="#reading">3. Reading Mail - The Index and Pager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2830094">3.1. The Message Index</a></span></dt><dt><span class="sect2"><a href="#id2876636">3.2. The Pager</a></span></dt><dt><span class="sect2"><a href="#threads">3.3. Threaded Mode</a></span></dt><dt><span class="sect2"><a href="#id2877085">3.4. Miscellaneous Functions</a></span></dt></dl></dd><dt><span class="sect1"><a href="#sending">4. Sending Mail</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2878068">4.1. Editing the message header</a></span></dt><dt><span class="sect2"><a href="#id2878157">4.2. Using Mutt with PGP</a></span></dt><dt><span class="sect2"><a href="#id2878393">4.3. Sending anonymous messages via mixmaster.</a></span></dt></dl></dd><dt><span class="sect1"><a href="#forwarding-mail">5. Forwarding and Bouncing Mail</a></span></dt><dt><span class="sect1"><a href="#postponing-mail">6. Postponing Mail</a></span></dt></dl></dd><dt><span class="chapter"><a href="#configuration">3. Configuration</a></span></dt><dd><dl><dt><span class="sect1"><a href="#muttrc-syntax">1. Syntax of Initialization Files</a></span></dt><dt><span class="sect1"><a href="#alias">2. Defining/Using aliases</a></span></dt><dt><span class="sect1"><a href="#bind">3. Changing the default key bindings</a></span></dt><dt><span class="sect1"><a href="#charset-hook">4. Defining aliases for character sets </a></span></dt><dt><span class="sect1"><a href="#folder-hook">5. Setting variables based upon mailbox</a></span></dt><dt><span class="sect1"><a href="#macro">6. Keyboard macros</a></span></dt><dt><span class="sect1"><a href="#color">7. Using color and mono video attributes</a></span></dt><dt><span class="sect1"><a href="#ignore">8. Ignoring (weeding) unwanted message headers</a></span></dt><dt><span class="sect1"><a href="#alternates">9. Alternative addresses</a></span></dt><dt><span class="sect1"><a href="#lists">10. Mailing lists</a></span></dt><dt><span class="sect1"><a href="#mbox-hook">11. Using Multiple spool mailboxes</a></span></dt><dt><span class="sect1"><a href="#mailboxes">12. Defining mailboxes which receive mail</a></span></dt><dt><span class="sect1"><a href="#my-hdr">13. User defined headers</a></span></dt><dt><span class="sect1"><a href="#hdr-order">14. Defining the order of headers when viewing messages</a></span></dt><dt><span class="sect1"><a href="#save-hook">15. Specify default save filename</a></span></dt><dt><span class="sect1"><a href="#fcc-hook">16. Specify default Fcc: mailbox when composing</a></span></dt><dt><span class="sect1"><a href="#fcc-save-hook">17. Specify default save filename and default Fcc: mailbox at once</a></span></dt><dt><span class="sect1"><a href="#send-hook">18. Change settings based upon message recipients</a></span></dt><dt><span class="sect1"><a href="#message-hook">19. Change settings before formatting a message</a></span></dt><dt><span class="sect1"><a href="#crypt-hook">20. Choosing the cryptographic key of the recipient</a></span></dt><dt><span class="sect1"><a href="#push">21. Adding key sequences to the keyboard buffer</a></span></dt><dt><span class="sect1"><a href="#exec">22. Executing functions</a></span></dt><dt><span class="sect1"><a href="#score-command">23. Message Scoring</a></span></dt><dt><span class="sect1"><a href="#spam">24. Spam detection</a></span></dt><dt><span class="sect1"><a href="#set">25. Setting and Querying Variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#set-commands">25.1. Commands</a></span></dt><dt><span class="sect2"><a href="#set-myvar">25.2. User-defined variables</a></span></dt></dl></dd><dt><span class="sect1"><a href="#source">26. Reading initialization commands from another file</a></span></dt><dt><span class="sect1"><a href="#unhook">27. Removing hooks</a></span></dt></dl></dd><dt><span class="chapter"><a href="#advancedusage">4. Advanced Usage</a></span></dt><dd><dl><dt><span class="sect1"><a href="#regexp">1. Regular Expressions</a></span></dt><dt><span class="sect1"><a href="#patterns">2. Patterns</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2884333">2.1. Pattern Modifier</a></span></dt><dt><span class="sect2"><a href="#id2884357">2.2. Complex Patterns</a></span></dt><dt><span class="sect2"><a href="#id2884490">2.3. Searching by Date</a></span></dt></dl></dd><dt><span class="sect1"><a href="#tags">3. Using Tags</a></span></dt><dt><span class="sect1"><a href="#hooks">4. Using Hooks</a></span></dt><dd><dl><dt><span class="sect2"><a href="#pattern-hook">4.1. Message Matching in Hooks</a></span></dt></dl></dd><dt><span class="sect1"><a href="#query">5. External Address Queries</a></span></dt><dt><span class="sect1"><a href="#mailbox-formats">6. Mailbox Formats</a></span></dt><dt><span class="sect1"><a href="#shortcuts">7. Mailbox Shortcuts</a></span></dt><dt><span class="sect1"><a href="#using-lists">8. Handling Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#editing-threads">9. Editing threads</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2885762">9.1. Linking threads</a></span></dt><dt><span class="sect2"><a href="#id2885791">9.2. Breaking threads</a></span></dt></dl></dd><dt><span class="sect1"><a href="#dsn">10. Delivery Status Notification (DSN) Support</a></span></dt><dt><span class="sect1"><a href="#pop">11. POP3 Support (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="#imap">12. IMAP Support (OPTIONAL)</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2886159">12.1. The Folder Browser</a></span></dt><dt><span class="sect2"><a href="#id2886281">12.2. Authentication</a></span></dt></dl></dd><dt><span class="sect1"><a href="#account-hook">13. Managing multiple IMAP/POP accounts (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="#urlview">14. Start a WWW Browser on URLs (EXTERNAL)</a></span></dt><dt><span class="sect1"><a href="#caching">15. Local caching (OPTIONAL)</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2886490">15.1. Header caching</a></span></dt><dt><span class="sect2"><a href="#id2886568">15.2. Body caching</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#mimesupport">5. Mutt's MIME Support</a></span></dt><dd><dl><dt><span class="sect1"><a href="#using-mime">1. Using MIME in Mutt</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2886681">1.1. Viewing MIME messages in the pager</a></span></dt><dt><span class="sect2"><a href="#attach-menu">1.2. The Attachment Menu</a></span></dt><dt><span class="sect2"><a href="#compose-menu">1.3. The Compose Menu</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mime-types">2. MIME Type configuration with <code class="literal">mime.types</code></a></span></dt><dt><span class="sect1"><a href="#mime-viewers">3. MIME Viewer configuration with <code class="literal">mailcap</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2887039">3.1. The Basics of the mailcap file</a></span></dt><dt><span class="sect2"><a href="#id2887171">3.2. Secure use of mailcap</a></span></dt><dt><span class="sect2"><a href="#id2887242">3.3. Advanced mailcap Usage</a></span></dt><dt><span class="sect2"><a href="#id2887702">3.4. Example mailcap files</a></span></dt></dl></dd><dt><span class="sect1"><a href="#auto-view">4. MIME Autoview</a></span></dt><dt><span class="sect1"><a href="#alternative-order">5. MIME Multipart/Alternative</a></span></dt><dt><span class="sect1"><a href="#attachments">6. Attachment Searching and Counting</a></span></dt><dt><span class="sect1"><a href="#mime-lookup">7. MIME Lookup</a></span></dt></dl></dd><dt><span class="chapter"><a href="#reference">6. Reference</a></span></dt><dd><dl><dt><span class="sect1"><a href="#commandline">1. Command line options</a></span></dt><dt><span class="sect1"><a href="#commands">2. Configuration Commands</a></span></dt><dt><span class="sect1"><a href="#variables">3. Configuration variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#abort-nosubject">3.1. abort_nosubject</a></span></dt><dt><span class="sect2"><a href="#abort-unmodified">3.2. abort_unmodified</a></span></dt><dt><span class="sect2"><a href="#alias-file">3.3. alias_file</a></span></dt><dt><span class="sect2"><a href="#alias-format">3.4. alias_format</a></span></dt><dt><span class="sect2"><a href="#allow-8bit">3.5. allow_8bit</a></span></dt><dt><span class="sect2"><a href="#allow-ansi">3.6. allow_ansi</a></span></dt><dt><span class="sect2"><a href="#arrow-cursor">3.7. arrow_cursor</a></span></dt><dt><span class="sect2"><a href="#ascii-chars">3.8. ascii_chars</a></span></dt><dt><span class="sect2"><a href="#askbcc">3.9. askbcc</a></span></dt><dt><span class="sect2"><a href="#askcc">3.10. askcc</a></span></dt><dt><span class="sect2"><a href="#attach-format">3.11. attach_format</a></span></dt><dt><span class="sect2"><a href="#attach-sep">3.12. attach_sep</a></span></dt><dt><span class="sect2"><a href="#attach-split">3.13. attach_split</a></span></dt><dt><span class="sect2"><a href="#attribution">3.14. attribution</a></span></dt><dt><span class="sect2"><a href="#autoedit">3.15. autoedit</a></span></dt><dt><span class="sect2"><a href="#auto-tag">3.16. auto_tag</a></span></dt><dt><span class="sect2"><a href="#beep">3.17. beep</a></span></dt><dt><span class="sect2"><a href="#beep-new">3.18. beep_new</a></span></dt><dt><span class="sect2"><a href="#bounce">3.19. bounce</a></span></dt><dt><span class="sect2"><a href="#bounce-delivered">3.20. bounce_delivered</a></span></dt><dt><span class="sect2"><a href="#braille-friendly">3.21. braille_friendly</a></span></dt><dt><span class="sect2"><a href="#charset">3.22. charset</a></span></dt><dt><span class="sect2"><a href="#check-new">3.23. check_new</a></span></dt><dt><span class="sect2"><a href="#collapse-unread">3.24. collapse_unread</a></span></dt><dt><span class="sect2"><a href="#uncollapse-jump">3.25. uncollapse_jump</a></span></dt><dt><span class="sect2"><a href="#compose-format">3.26. compose_format</a></span></dt><dt><span class="sect2"><a href="#config-charset">3.27. config_charset</a></span></dt><dt><span class="sect2"><a href="#confirmappend">3.28. confirmappend</a></span></dt><dt><span class="sect2"><a href="#confirmcreate">3.29. confirmcreate</a></span></dt><dt><span class="sect2"><a href="#connect-timeout">3.30. connect_timeout</a></span></dt><dt><span class="sect2"><a href="#content-type">3.31. content_type</a></span></dt><dt><span class="sect2"><a href="#copy">3.32. copy</a></span></dt><dt><span class="sect2"><a href="#crypt-use-gpgme">3.33. crypt_use_gpgme</a></span></dt><dt><span class="sect2"><a href="#crypt-autopgp">3.34. crypt_autopgp</a></span></dt><dt><span class="sect2"><a href="#crypt-autosmime">3.35. crypt_autosmime</a></span></dt><dt><span class="sect2"><a href="#date-format">3.36. date_format</a></span></dt><dt><span class="sect2"><a href="#default-hook">3.37. default_hook</a></span></dt><dt><span class="sect2"><a href="#delete">3.38. delete</a></span></dt><dt><span class="sect2"><a href="#delete-untag">3.39. delete_untag</a></span></dt><dt><span class="sect2"><a href="#digest-collapse">3.40. digest_collapse</a></span></dt><dt><span class="sect2"><a href="#display-filter">3.41. display_filter</a></span></dt><dt><span class="sect2"><a href="#dotlock-program">3.42. dotlock_program</a></span></dt><dt><span class="sect2"><a href="#dsn-notify">3.43. dsn_notify</a></span></dt><dt><span class="sect2"><a href="#dsn-return">3.44. dsn_return</a></span></dt><dt><span class="sect2"><a href="#duplicate-threads">3.45. duplicate_threads</a></span></dt><dt><span class="sect2"><a href="#edit-headers">3.46. edit_headers</a></span></dt><dt><span class="sect2"><a href="#editor">3.47. editor</a></span></dt><dt><span class="sect2"><a href="#encode-from">3.48. encode_from</a></span></dt><dt><span class="sect2"><a href="#envelope-from-address">3.49. envelope_from_address</a></span></dt><dt><span class="sect2"><a href="#escape">3.50. escape</a></span></dt><dt><span class="sect2"><a href="#fast-reply">3.51. fast_reply</a></span></dt><dt><span class="sect2"><a href="#fcc-attach">3.52. fcc_attach</a></span></dt><dt><span class="sect2"><a href="#fcc-clear">3.53. fcc_clear</a></span></dt><dt><span class="sect2"><a href="#folder">3.54. folder</a></span></dt><dt><span class="sect2"><a href="#folder-format">3.55. folder_format</a></span></dt><dt><span class="sect2"><a href="#followup-to">3.56. followup_to</a></span></dt><dt><span class="sect2"><a href="#force-name">3.57. force_name</a></span></dt><dt><span class="sect2"><a href="#forward-decode">3.58. forward_decode</a></span></dt><dt><span class="sect2"><a href="#forward-edit">3.59. forward_edit</a></span></dt><dt><span class="sect2"><a href="#forward-format">3.60. forward_format</a></span></dt><dt><span class="sect2"><a href="#forward-quote">3.61. forward_quote</a></span></dt><dt><span class="sect2"><a href="#from">3.62. from</a></span></dt><dt><span class="sect2"><a href="#gecos-mask">3.63. gecos_mask</a></span></dt><dt><span class="sect2"><a href="#hdrs">3.64. hdrs</a></span></dt><dt><span class="sect2"><a href="#header">3.65. header</a></span></dt><dt><span class="sect2"><a href="#help">3.66. help</a></span></dt><dt><span class="sect2"><a href="#hidden-host">3.67. hidden_host</a></span></dt><dt><span class="sect2"><a href="#hide-limited">3.68. hide_limited</a></span></dt><dt><span class="sect2"><a href="#hide-missing">3.69. hide_missing</a></span></dt><dt><span class="sect2"><a href="#hide-thread-subject">3.70. hide_thread_subject</a></span></dt><dt><span class="sect2"><a href="#hide-top-limited">3.71. hide_top_limited</a></span></dt><dt><span class="sect2"><a href="#hide-top-missing">3.72. hide_top_missing</a></span></dt><dt><span class="sect2"><a href="#history">3.73. history</a></span></dt><dt><span class="sect2"><a href="#honor-followup-to">3.74. honor_followup_to</a></span></dt><dt><span class="sect2"><a href="#hostname">3.75. hostname</a></span></dt><dt><span class="sect2"><a href="#ignore-list-reply-to">3.76. ignore_list_reply_to</a></span></dt><dt><span class="sect2"><a href="#imap-authenticators">3.77. imap_authenticators</a></span></dt><dt><span class="sect2"><a href="#imap-check-subscribed">3.78. imap_check_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-delim-chars">3.79. imap_delim_chars</a></span></dt><dt><span class="sect2"><a href="#imap-headers">3.80. imap_headers</a></span></dt><dt><span class="sect2"><a href="#imap-home-namespace">3.81. imap_home_namespace</a></span></dt><dt><span class="sect2"><a href="#imap-idle">3.82. imap_idle</a></span></dt><dt><span class="sect2"><a href="#imap-keepalive">3.83. imap_keepalive</a></span></dt><dt><span class="sect2"><a href="#imap-list-subscribed">3.84. imap_list_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-login">3.85. imap_login</a></span></dt><dt><span class="sect2"><a href="#imap-pass">3.86. imap_pass</a></span></dt><dt><span class="sect2"><a href="#imap-passive">3.87. imap_passive</a></span></dt><dt><span class="sect2"><a href="#imap-peek">3.88. imap_peek</a></span></dt><dt><span class="sect2"><a href="#imap-servernoise">3.89. imap_servernoise</a></span></dt><dt><span class="sect2"><a href="#imap-user">3.90. imap_user</a></span></dt><dt><span class="sect2"><a href="#implicit-autoview">3.91. implicit_autoview</a></span></dt><dt><span class="sect2"><a href="#include">3.92. include</a></span></dt><dt><span class="sect2"><a href="#include-onlyfirst">3.93. include_onlyfirst</a></span></dt><dt><span class="sect2"><a href="#indent-string">3.94. indent_string</a></span></dt><dt><span class="sect2"><a href="#index-format">3.95. index_format</a></span></dt><dt><span class="sect2"><a href="#ispell">3.96. ispell</a></span></dt><dt><span class="sect2"><a href="#keep-flagged">3.97. keep_flagged</a></span></dt><dt><span class="sect2"><a href="#locale">3.98. locale</a></span></dt><dt><span class="sect2"><a href="#mail-check">3.99. mail_check</a></span></dt><dt><span class="sect2"><a href="#mailcap-path">3.100. mailcap_path</a></span></dt><dt><span class="sect2"><a href="#mailcap-sanitize">3.101. mailcap_sanitize</a></span></dt><dt><span class="sect2"><a href="#header-cache">3.102. header_cache</a></span></dt><dt><span class="sect2"><a href="#maildir-header-cache-verify">3.103. maildir_header_cache_verify</a></span></dt><dt><span class="sect2"><a href="#header-cache-pagesize">3.104. header_cache_pagesize</a></span></dt><dt><span class="sect2"><a href="#header-cache-compress">3.105. header_cache_compress</a></span></dt><dt><span class="sect2"><a href="#maildir-trash">3.106. maildir_trash</a></span></dt><dt><span class="sect2"><a href="#mark-old">3.107. mark_old</a></span></dt><dt><span class="sect2"><a href="#markers">3.108. markers</a></span></dt><dt><span class="sect2"><a href="#mask">3.109. mask</a></span></dt><dt><span class="sect2"><a href="#mbox">3.110. mbox</a></span></dt><dt><span class="sect2"><a href="#mbox-type">3.111. mbox_type</a></span></dt><dt><span class="sect2"><a href="#metoo">3.112. metoo</a></span></dt><dt><span class="sect2"><a href="#menu-context">3.113. menu_context</a></span></dt><dt><span class="sect2"><a href="#menu-move-off">3.114. menu_move_off</a></span></dt><dt><span class="sect2"><a href="#menu-scroll">3.115. menu_scroll</a></span></dt><dt><span class="sect2"><a href="#meta-key">3.116. meta_key</a></span></dt><dt><span class="sect2"><a href="#mh-purge">3.117. mh_purge</a></span></dt><dt><span class="sect2"><a href="#mh-seq-flagged">3.118. mh_seq_flagged</a></span></dt><dt><span class="sect2"><a href="#mh-seq-replied">3.119. mh_seq_replied</a></span></dt><dt><span class="sect2"><a href="#mh-seq-unseen">3.120. mh_seq_unseen</a></span></dt><dt><span class="sect2"><a href="#mime-forward">3.121. mime_forward</a></span></dt><dt><span class="sect2"><a href="#mime-forward-decode">3.122. mime_forward_decode</a></span></dt><dt><span class="sect2"><a href="#mime-forward-rest">3.123. mime_forward_rest</a></span></dt><dt><span class="sect2"><a href="#mix-entry-format">3.124. mix_entry_format</a></span></dt><dt><span class="sect2"><a href="#mixmaster">3.125. mixmaster</a></span></dt><dt><span class="sect2"><a href="#move">3.126. move</a></span></dt><dt><span class="sect2"><a href="#message-cachedir">3.127. message_cachedir</a></span></dt><dt><span class="sect2"><a href="#message-format">3.128. message_format</a></span></dt><dt><span class="sect2"><a href="#narrow-tree">3.129. narrow_tree</a></span></dt><dt><span class="sect2"><a href="#net-inc">3.130. net_inc</a></span></dt><dt><span class="sect2"><a href="#pager">3.131. pager</a></span></dt><dt><span class="sect2"><a href="#pager-context">3.132. pager_context</a></span></dt><dt><span class="sect2"><a href="#pager-format">3.133. pager_format</a></span></dt><dt><span class="sect2"><a href="#pager-index-lines">3.134. pager_index_lines</a></span></dt><dt><span class="sect2"><a href="#pager-stop">3.135. pager_stop</a></span></dt><dt><span class="sect2"><a href="#crypt-autosign">3.136. crypt_autosign</a></span></dt><dt><span class="sect2"><a href="#crypt-autoencrypt">3.137. crypt_autoencrypt</a></span></dt><dt><span class="sect2"><a href="#pgp-ignore-subkeys">3.138. pgp_ignore_subkeys</a></span></dt><dt><span class="sect2"><a href="#crypt-replyencrypt">3.139. crypt_replyencrypt</a></span></dt><dt><span class="sect2"><a href="#crypt-replysign">3.140. crypt_replysign</a></span></dt><dt><span class="sect2"><a href="#crypt-replysignencrypted">3.141. crypt_replysignencrypted</a></span></dt><dt><span class="sect2"><a href="#crypt-timestamp">3.142. crypt_timestamp</a></span></dt><dt><span class="sect2"><a href="#pgp-use-gpg-agent">3.143. pgp_use_gpg_agent</a></span></dt><dt><span class="sect2"><a href="#crypt-verify-sig">3.144. crypt_verify_sig</a></span></dt><dt><span class="sect2"><a href="#smime-is-default">3.145. smime_is_default</a></span></dt><dt><span class="sect2"><a href="#smime-ask-cert-label">3.146. smime_ask_cert_label</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-use-default-key">3.147. smime_decrypt_use_default_key</a></span></dt><dt><span class="sect2"><a href="#pgp-entry-format">3.148. pgp_entry_format</a></span></dt><dt><span class="sect2"><a href="#pgp-good-sign">3.149. pgp_good_sign</a></span></dt><dt><span class="sect2"><a href="#pgp-check-exit">3.150. pgp_check_exit</a></span></dt><dt><span class="sect2"><a href="#pgp-long-ids">3.151. pgp_long_ids</a></span></dt><dt><span class="sect2"><a href="#pgp-retainable-sigs">3.152. pgp_retainable_sigs</a></span></dt><dt><span class="sect2"><a href="#pgp-autoinline">3.153. pgp_autoinline</a></span></dt><dt><span class="sect2"><a href="#pgp-replyinline">3.154. pgp_replyinline</a></span></dt><dt><span class="sect2"><a href="#pgp-show-unusable">3.155. pgp_show_unusable</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-as">3.156. pgp_sign_as</a></span></dt><dt><span class="sect2"><a href="#pgp-strict-enc">3.157. pgp_strict_enc</a></span></dt><dt><span class="sect2"><a href="#pgp-timeout">3.158. pgp_timeout</a></span></dt><dt><span class="sect2"><a href="#pgp-sort-keys">3.159. pgp_sort_keys</a></span></dt><dt><span class="sect2"><a href="#pgp-mime-auto">3.160. pgp_mime_auto</a></span></dt><dt><span class="sect2"><a href="#pgp-auto-decode">3.161. pgp_auto_decode</a></span></dt><dt><span class="sect2"><a href="#pgp-decode-command">3.162. pgp_decode_command</a></span></dt><dt><span class="sect2"><a href="#pgp-getkeys-command">3.163. pgp_getkeys_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-command">3.164. pgp_verify_command</a></span></dt><dt><span class="sect2"><a href="#pgp-decrypt-command">3.165. pgp_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#pgp-clearsign-command">3.166. pgp_clearsign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-command">3.167. pgp_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-sign-command">3.168. pgp_encrypt_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-only-command">3.169. pgp_encrypt_only_command</a></span></dt><dt><span class="sect2"><a href="#pgp-import-command">3.170. pgp_import_command</a></span></dt><dt><span class="sect2"><a href="#pgp-export-command">3.171. pgp_export_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-key-command">3.172. pgp_verify_key_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-secring-command">3.173. pgp_list_secring_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-pubring-command">3.174. pgp_list_pubring_command</a></span></dt><dt><span class="sect2"><a href="#forward-decrypt">3.175. forward_decrypt</a></span></dt><dt><span class="sect2"><a href="#smime-timeout">3.176. smime_timeout</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-with">3.177. smime_encrypt_with</a></span></dt><dt><span class="sect2"><a href="#smime-keys">3.178. smime_keys</a></span></dt><dt><span class="sect2"><a href="#smime-ca-location">3.179. smime_ca_location</a></span></dt><dt><span class="sect2"><a href="#smime-certificates">3.180. smime_certificates</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-command">3.181. smime_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-command">3.182. smime_verify_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-opaque-command">3.183. smime_verify_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-command">3.184. smime_sign_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-opaque-command">3.185. smime_sign_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-command">3.186. smime_encrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-pk7out-command">3.187. smime_pk7out_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-command">3.188. smime_get_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-signer-cert-command">3.189. smime_get_signer_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-import-cert-command">3.190. smime_import_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-email-command">3.191. smime_get_cert_email_command</a></span></dt><dt><span class="sect2"><a href="#smime-default-key">3.192. smime_default_key</a></span></dt><dt><span class="sect2"><a href="#ssl-client-cert">3.193. ssl_client_cert</a></span></dt><dt><span class="sect2"><a href="#ssl-force-tls">3.194. ssl_force_tls</a></span></dt><dt><span class="sect2"><a href="#ssl-starttls">3.195. ssl_starttls</a></span></dt><dt><span class="sect2"><a href="#certificate-file">3.196. certificate_file</a></span></dt><dt><span class="sect2"><a href="#ssl-usesystemcerts">3.197. ssl_usesystemcerts</a></span></dt><dt><span class="sect2"><a href="#entropy-file">3.198. entropy_file</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv2">3.199. ssl_use_sslv2</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv3">3.200. ssl_use_sslv3</a></span></dt><dt><span class="sect2"><a href="#ssl-use-tlsv1">3.201. ssl_use_tlsv1</a></span></dt><dt><span class="sect2"><a href="#ssl-min-dh-prime-bits">3.202. ssl_min_dh_prime_bits</a></span></dt><dt><span class="sect2"><a href="#ssl-ca-certificates-file">3.203. ssl_ca_certificates_file</a></span></dt><dt><span class="sect2"><a href="#pipe-split">3.204. pipe_split</a></span></dt><dt><span class="sect2"><a href="#pipe-decode">3.205. pipe_decode</a></span></dt><dt><span class="sect2"><a href="#pipe-sep">3.206. pipe_sep</a></span></dt><dt><span class="sect2"><a href="#pop-authenticators">3.207. pop_authenticators</a></span></dt><dt><span class="sect2"><a href="#pop-auth-try-all">3.208. pop_auth_try_all</a></span></dt><dt><span class="sect2"><a href="#pop-checkinterval">3.209. pop_checkinterval</a></span></dt><dt><span class="sect2"><a href="#pop-delete">3.210. pop_delete</a></span></dt><dt><span class="sect2"><a href="#pop-host">3.211. pop_host</a></span></dt><dt><span class="sect2"><a href="#pop-last">3.212. pop_last</a></span></dt><dt><span class="sect2"><a href="#pop-reconnect">3.213. pop_reconnect</a></span></dt><dt><span class="sect2"><a href="#pop-user">3.214. pop_user</a></span></dt><dt><span class="sect2"><a href="#pop-pass">3.215. pop_pass</a></span></dt><dt><span class="sect2"><a href="#post-indent-string">3.216. post_indent_string</a></span></dt><dt><span class="sect2"><a href="#postpone">3.217. postpone</a></span></dt><dt><span class="sect2"><a href="#postponed">3.218. postponed</a></span></dt><dt><span class="sect2"><a href="#preconnect">3.219. preconnect</a></span></dt><dt><span class="sect2"><a href="#print">3.220. print</a></span></dt><dt><span class="sect2"><a href="#print-command">3.221. print_command</a></span></dt><dt><span class="sect2"><a href="#print-decode">3.222. print_decode</a></span></dt><dt><span class="sect2"><a href="#print-split">3.223. print_split</a></span></dt><dt><span class="sect2"><a href="#prompt-after">3.224. prompt_after</a></span></dt><dt><span class="sect2"><a href="#query-command">3.225. query_command</a></span></dt><dt><span class="sect2"><a href="#quit">3.226. quit</a></span></dt><dt><span class="sect2"><a href="#quote-regexp">3.227. quote_regexp</a></span></dt><dt><span class="sect2"><a href="#read-inc">3.228. read_inc</a></span></dt><dt><span class="sect2"><a href="#read-only">3.229. read_only</a></span></dt><dt><span class="sect2"><a href="#realname">3.230. realname</a></span></dt><dt><span class="sect2"><a href="#recall">3.231. recall</a></span></dt><dt><span class="sect2"><a href="#record">3.232. record</a></span></dt><dt><span class="sect2"><a href="#reply-regexp">3.233. reply_regexp</a></span></dt><dt><span class="sect2"><a href="#reply-self">3.234. reply_self</a></span></dt><dt><span class="sect2"><a href="#reply-to">3.235. reply_to</a></span></dt><dt><span class="sect2"><a href="#resolve">3.236. resolve</a></span></dt><dt><span class="sect2"><a href="#reverse-alias">3.237. reverse_alias</a></span></dt><dt><span class="sect2"><a href="#reverse-name">3.238. reverse_name</a></span></dt><dt><span class="sect2"><a href="#reverse-realname">3.239. reverse_realname</a></span></dt><dt><span class="sect2"><a href="#rfc2047-parameters">3.240. rfc2047_parameters</a></span></dt><dt><span class="sect2"><a href="#save-address">3.241. save_address</a></span></dt><dt><span class="sect2"><a href="#save-empty">3.242. save_empty</a></span></dt><dt><span class="sect2"><a href="#save-name">3.243. save_name</a></span></dt><dt><span class="sect2"><a href="#score">3.244. score</a></span></dt><dt><span class="sect2"><a href="#score-threshold-delete">3.245. score_threshold_delete</a></span></dt><dt><span class="sect2"><a href="#score-threshold-flag">3.246. score_threshold_flag</a></span></dt><dt><span class="sect2"><a href="#score-threshold-read">3.247. score_threshold_read</a></span></dt><dt><span class="sect2"><a href="#send-charset">3.248. send_charset</a></span></dt><dt><span class="sect2"><a href="#sendmail">3.249. sendmail</a></span></dt><dt><span class="sect2"><a href="#sendmail-wait">3.250. sendmail_wait</a></span></dt><dt><span class="sect2"><a href="#shell">3.251. shell</a></span></dt><dt><span class="sect2"><a href="#sig-dashes">3.252. sig_dashes</a></span></dt><dt><span class="sect2"><a href="#sig-on-top">3.253. sig_on_top</a></span></dt><dt><span class="sect2"><a href="#signature">3.254. signature</a></span></dt><dt><span class="sect2"><a href="#simple-search">3.255. simple_search</a></span></dt><dt><span class="sect2"><a href="#smart-wrap">3.256. smart_wrap</a></span></dt><dt><span class="sect2"><a href="#smileys">3.257. smileys</a></span></dt><dt><span class="sect2"><a href="#sleep-time">3.258. sleep_time</a></span></dt><dt><span class="sect2"><a href="#sort">3.259. sort</a></span></dt><dt><span class="sect2"><a href="#sort-alias">3.260. sort_alias</a></span></dt><dt><span class="sect2"><a href="#sort-aux">3.261. sort_aux</a></span></dt><dt><span class="sect2"><a href="#sort-browser">3.262. sort_browser</a></span></dt><dt><span class="sect2"><a href="#sort-re">3.263. sort_re</a></span></dt><dt><span class="sect2"><a href="#spam-separator">3.264. spam_separator</a></span></dt><dt><span class="sect2"><a href="#spoolfile">3.265. spoolfile</a></span></dt><dt><span class="sect2"><a href="#status-chars">3.266. status_chars</a></span></dt><dt><span class="sect2"><a href="#status-format">3.267. status_format</a></span></dt><dt><span class="sect2"><a href="#status-on-top">3.268. status_on_top</a></span></dt><dt><span class="sect2"><a href="#strict-threads">3.269. strict_threads</a></span></dt><dt><span class="sect2"><a href="#suspend">3.270. suspend</a></span></dt><dt><span class="sect2"><a href="#text-flowed">3.271. text_flowed</a></span></dt><dt><span class="sect2"><a href="#thread-received">3.272. thread_received</a></span></dt><dt><span class="sect2"><a href="#thorough-search">3.273. thorough_search</a></span></dt><dt><span class="sect2"><a href="#tilde">3.274. tilde</a></span></dt><dt><span class="sect2"><a href="#timeout">3.275. timeout</a></span></dt><dt><span class="sect2"><a href="#tmpdir">3.276. tmpdir</a></span></dt><dt><span class="sect2"><a href="#to-chars">3.277. to_chars</a></span></dt><dt><span class="sect2"><a href="#tunnel">3.278. tunnel</a></span></dt><dt><span class="sect2"><a href="#use-8bitmime">3.279. use_8bitmime</a></span></dt><dt><span class="sect2"><a href="#use-domain">3.280. use_domain</a></span></dt><dt><span class="sect2"><a href="#use-envelope-from">3.281. use_envelope_from</a></span></dt><dt><span class="sect2"><a href="#use-from">3.282. use_from</a></span></dt><dt><span class="sect2"><a href="#use-idn">3.283. use_idn</a></span></dt><dt><span class="sect2"><a href="#use-ipv6">3.284. use_ipv6</a></span></dt><dt><span class="sect2"><a href="#user-agent">3.285. user_agent</a></span></dt><dt><span class="sect2"><a href="#visual">3.286. visual</a></span></dt><dt><span class="sect2"><a href="#wait-key">3.287. wait_key</a></span></dt><dt><span class="sect2"><a href="#weed">3.288. weed</a></span></dt><dt><span class="sect2"><a href="#wrap-search">3.289. wrap_search</a></span></dt><dt><span class="sect2"><a href="#wrapmargin">3.290. wrapmargin</a></span></dt><dt><span class="sect2"><a href="#write-inc">3.291. write_inc</a></span></dt><dt><span class="sect2"><a href="#write-bcc">3.292. write_bcc</a></span></dt></dl></dd><dt><span class="sect1"><a href="#functions">4. Functions</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2900751">4.1. generic</a></span></dt><dt><span class="sect2"><a href="#id2901104">4.2. index</a></span></dt><dt><span class="sect2"><a href="#id2901809">4.3. pager</a></span></dt><dt><span class="sect2"><a href="#id2902560">4.4. alias</a></span></dt><dt><span class="sect2"><a href="#id2902627">4.5. query</a></span></dt><dt><span class="sect2"><a href="#id2902742">4.6. attach</a></span></dt><dt><span class="sect2"><a href="#id2902952">4.7. compose</a></span></dt><dt><span class="sect2"><a href="#id2903305">4.8. postpone</a></span></dt><dt><span class="sect2"><a href="#id2903362">4.9. browser</a></span></dt><dt><span class="sect2"><a href="#id2903533">4.10. pgp</a></span></dt><dt><span class="sect2"><a href="#id2903590">4.11. editor</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#miscellany">7. Miscellany</a></span></dt><dd><dl><dt><span class="sect1"><a href="#acknowledgements">1. Acknowledgements</a></span></dt><dt><span class="sect1"><a href="#about">2. About this document</a></span></dt></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>2.1. <a href="#id2828973">Most common navigation keys</a></dt><dt>2.2. <a href="#id2829715">Most common line editor keys</a></dt><dt>2.3. <a href="#id2830102">Most common message index keys</a></dt><dt>2.4. <a href="#id2876653">Most common pager keys</a></dt><dt>2.5. <a href="#id2876872">Most common thread mode keys</a></dt><dt>2.6. <a href="#id2877582">Most common mail sending keys</a></dt><dt>2.7. <a href="#id2877826">Most common compose menu keys</a></dt><dt>2.8. <a href="#id2878057">PGP key menu flags</a></dt><dt>2.9. <a href="#id2878551">Message forwarding/bouncing keys</a></dt><dt>3.1. <a href="#id2879492">Symbolic key names</a></dt><dt>4.1. <a href="#id2883928">Pattern modifiers</a></dt><dt>6.1. <a href="#id2888098">Command line options</a></dt><dt>6.2. <a href="#id2900777">Default generic function bindings</a></dt><dt>6.3. <a href="#id2901112">Default index menu function bindings</a></dt><dt>6.4. <a href="#id2901817">Default pager menu function bindings</a></dt><dt>6.5. <a href="#id2902568">Default alias menu function bindings</a></dt><dt>6.6. <a href="#id2902634">Default query menu function bindings</a></dt><dt>6.7. <a href="#id2902750">Default attach menu function bindings</a></dt><dt>6.8. <a href="#id2902960">Default compose menu function bindings</a></dt><dt>6.9. <a href="#id2903313">Default postpone menu function bindings</a></dt><dt>6.10. <a href="#id2903370">Default browser menu function bindings</a></dt><dt>6.11. <a href="#id2903540">Default pgp menu function bindings</a></dt><dt>6.12. <a href="#id2903597">Default editor function bindings</a></dt></dl></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="intro"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#homepage">1. Mutt Home Page</a></span></dt><dt><span class="sect1"><a href="#muttlists">2. Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#distribution">3. Software Distribution Sites</a></span></dt><dt><span class="sect1"><a href="#irc">4. IRC</a></span></dt><dt><span class="sect1"><a href="#usenet">5. USENET</a></span></dt><dt><span class="sect1"><a href="#copyright">6. Copyright</a></span></dt></dl></div><p>

5

</p></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="#intro">1. Introduction</a></span></dt><dd><dl><dt><span class="sect1"><a href="#homepage">1. Mutt Home Page</a></span></dt><dt><span class="sect1"><a href="#muttlists">2. Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#distribution">3. Software Distribution Sites</a></span></dt><dt><span class="sect1"><a href="#irc">4. IRC</a></span></dt><dt><span class="sect1"><a href="#usenet">5. USENET</a></span></dt><dt><span class="sect1"><a href="#copyright">6. Copyright</a></span></dt></dl></dd><dt><span class="chapter"><a href="#gettingstarted">2. Getting Started</a></span></dt><dd><dl><dt><span class="sect1"><a href="#menus">1. Moving Around in Menus</a></span></dt><dt><span class="sect1"><a href="#editing">2. Editing Input Fields</a></span></dt><dd><dl><dt><span class="sect2"><a href="#editing-intro">2.1. Introduction</a></span></dt><dt><span class="sect2"><a href="#editing-history">2.2. History</a></span></dt></dl></dd><dt><span class="sect1"><a href="#reading">3. Reading Mail - The Index and Pager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id449968">3.1. The Message Index</a></span></dt><dt><span class="sect2"><a href="#id450511">3.2. The Pager</a></span></dt><dt><span class="sect2"><a href="#threads">3.3. Threaded Mode</a></span></dt><dt><span class="sect2"><a href="#id451166">3.4. Miscellaneous Functions</a></span></dt></dl></dd><dt><span class="sect1"><a href="#sending">4. Sending Mail</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id452150">4.1. Editing the message header</a></span></dt><dt><span class="sect2"><a href="#id452237">4.2. Using Mutt with PGP</a></span></dt><dt><span class="sect2"><a href="#id452481">4.3. Sending anonymous messages via mixmaster.</a></span></dt><dt><span class="sect2"><a href="#id452606">4.4. Sending format=flowed messages</a></span></dt></dl></dd><dt><span class="sect1"><a href="#forwarding-mail">5. Forwarding and Bouncing Mail</a></span></dt><dt><span class="sect1"><a href="#postponing-mail">6. Postponing Mail</a></span></dt></dl></dd><dt><span class="chapter"><a href="#configuration">3. Configuration</a></span></dt><dd><dl><dt><span class="sect1"><a href="#muttrc-syntax">1. Syntax of Initialization Files</a></span></dt><dt><span class="sect1"><a href="#addrgroup">2. Address groups</a></span></dt><dt><span class="sect1"><a href="#alias">3. Defining/Using aliases</a></span></dt><dt><span class="sect1"><a href="#bind">4. Changing the default key bindings</a></span></dt><dt><span class="sect1"><a href="#charset-hook">5. Defining aliases for character sets </a></span></dt><dt><span class="sect1"><a href="#folder-hook">6. Setting variables based upon mailbox</a></span></dt><dt><span class="sect1"><a href="#macro">7. Keyboard macros</a></span></dt><dt><span class="sect1"><a href="#color">8. Using color and mono video attributes</a></span></dt><dt><span class="sect1"><a href="#ignore">9. Ignoring (weeding) unwanted message headers</a></span></dt><dt><span class="sect1"><a href="#alternates">10. Alternative addresses</a></span></dt><dt><span class="sect1"><a href="#lists">11. Mailing lists</a></span></dt><dt><span class="sect1"><a href="#mbox-hook">12. Using Multiple spool mailboxes</a></span></dt><dt><span class="sect1"><a href="#mailboxes">13. Monitoring incoming mail</a></span></dt><dt><span class="sect1"><a href="#my-hdr">14. User defined headers</a></span></dt><dt><span class="sect1"><a href="#hdr-order">15. Defining the order of headers when viewing messages</a></span></dt><dt><span class="sect1"><a href="#save-hook">16. Specify default save mailbox</a></span></dt><dt><span class="sect1"><a href="#fcc-hook">17. Specify default Fcc: mailbox when composing</a></span></dt><dt><span class="sect1"><a href="#fcc-save-hook">18. Specify default save filename and default Fcc: mailbox at once</a></span></dt><dt><span class="sect1"><a href="#send-hook">19. Change settings based upon message recipients</a></span></dt><dt><span class="sect1"><a href="#message-hook">20. Change settings before formatting a message</a></span></dt><dt><span class="sect1"><a href="#crypt-hook">21. Choosing the cryptographic key of the recipient</a></span></dt><dt><span class="sect1"><a href="#push">22. Adding key sequences to the keyboard buffer</a></span></dt><dt><span class="sect1"><a href="#exec">23. Executing functions</a></span></dt><dt><span class="sect1"><a href="#score-command">24. Message Scoring</a></span></dt><dt><span class="sect1"><a href="#spam">25. Spam detection</a></span></dt><dt><span class="sect1"><a href="#set">26. Setting and Querying Variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#set-commands">26.1. Commands</a></span></dt><dt><span class="sect2"><a href="#set-myvar">26.2. User-defined variables</a></span></dt></dl></dd><dt><span class="sect1"><a href="#source">27. Reading initialization commands from another file</a></span></dt><dt><span class="sect1"><a href="#unhook">28. Removing hooks</a></span></dt><dt><span class="sect1"><a href="#formatstrings">29. Format Strings</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id458133">29.1. Basic usage</a></span></dt><dt><span class="sect2"><a href="#id458263">29.2. Filters</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#advancedusage">4. Advanced Usage</a></span></dt><dd><dl><dt><span class="sect1"><a href="#regexp">1. Regular Expressions</a></span></dt><dt><span class="sect1"><a href="#patterns">2. Patterns: Searching, Limiting and Tagging</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id459463">2.1. Pattern Modifier</a></span></dt><dt><span class="sect2"><a href="#id459491">2.2. Simple Patterns</a></span></dt><dt><span class="sect2"><a href="#id459655">2.3. Complex Patterns</a></span></dt><dt><span class="sect2"><a href="#id459787">2.4. Searching by Date</a></span></dt></dl></dd><dt><span class="sect1"><a href="#tags">3. Using Tags</a></span></dt><dt><span class="sect1"><a href="#hooks">4. Using Hooks</a></span></dt><dd><dl><dt><span class="sect2"><a href="#pattern-hook">4.1. Message Matching in Hooks</a></span></dt></dl></dd><dt><span class="sect1"><a href="#query">5. External Address Queries</a></span></dt><dt><span class="sect1"><a href="#mailbox-formats">6. Mailbox Formats</a></span></dt><dt><span class="sect1"><a href="#shortcuts">7. Mailbox Shortcuts</a></span></dt><dt><span class="sect1"><a href="#using-lists">8. Handling Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#editing-threads">9. Editing threads</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id460955">9.1. Linking threads</a></span></dt><dt><span class="sect2"><a href="#id460970">9.2. Breaking threads</a></span></dt></dl></dd><dt><span class="sect1"><a href="#dsn">10. Delivery Status Notification (DSN) Support</a></span></dt><dt><span class="sect1"><a href="#urlview">11. Start a WWW Browser on URLs (EXTERNAL)</a></span></dt></dl></dd><dt><span class="chapter"><a href="#mimesupport">5. Mutt's MIME Support</a></span></dt><dd><dl><dt><span class="sect1"><a href="#using-mime">1. Using MIME in Mutt</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id461145">1.1. Viewing MIME messages in the pager</a></span></dt><dt><span class="sect2"><a href="#attach-menu">1.2. The Attachment Menu</a></span></dt><dt><span class="sect2"><a href="#compose-menu">1.3. The Compose Menu</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mime-types">2. MIME Type configuration with <code class="literal">mime.types</code></a></span></dt><dt><span class="sect1"><a href="#mime-viewers">3. MIME Viewer configuration with <code class="literal">mailcap</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="#id461549">3.1. The Basics of the mailcap file</a></span></dt><dt><span class="sect2"><a href="#id461671">3.2. Secure use of mailcap</a></span></dt><dt><span class="sect2"><a href="#id461742">3.3. Advanced mailcap Usage</a></span></dt><dt><span class="sect2"><a href="#id462190">3.4. Example mailcap files</a></span></dt></dl></dd><dt><span class="sect1"><a href="#auto-view">4. MIME Autoview</a></span></dt><dt><span class="sect1"><a href="#alternative-order">5. MIME Multipart/Alternative</a></span></dt><dt><span class="sect1"><a href="#attachments">6. Attachment Searching and Counting</a></span></dt><dt><span class="sect1"><a href="#mime-lookup">7. MIME Lookup</a></span></dt></dl></dd><dt><span class="chapter"><a href="#optionalfeatures">6. Optional features</a></span></dt><dd><dl><dt><span class="sect1"><a href="#id462485">1. General notes</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id462491">1.1. Enabling/disabling features</a></span></dt><dt><span class="sect2"><a href="#url-syntax">1.2. URL syntax</a></span></dt></dl></dd><dt><span class="sect1"><a href="#ssl">2. SSL/TLS Support</a></span></dt><dt><span class="sect1"><a href="#pop">3. POP3 Support</a></span></dt><dt><span class="sect1"><a href="#imap">4. IMAP Support</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id462908">4.1. The Folder Browser</a></span></dt><dt><span class="sect2"><a href="#id463028">4.2. Authentication</a></span></dt></dl></dd><dt><span class="sect1"><a href="#smtp">5. SMTP Support</a></span></dt><dt><span class="sect1"><a href="#account-hook">6. Managing multiple accounts</a></span></dt><dt><span class="sect1"><a href="#caching">7. Local caching</a></span></dt><dd><dl><dt><span class="sect2"><a href="#header-caching">7.1. Header caching</a></span></dt><dt><span class="sect2"><a href="#body-caching">7.2. Body caching</a></span></dt><dt><span class="sect2"><a href="#maint-cache">7.3. Maintenance</a></span></dt></dl></dd><dt><span class="sect1"><a href="#exact-address">8. Exact address generation</a></span></dt></dl></dd><dt><span class="chapter"><a href="#tuning">7. Performance tuning</a></span></dt><dd><dl><dt><span class="sect1"><a href="#tuning-mailboxes">1. Reading and writing mailboxes</a></span></dt><dt><span class="sect1"><a href="#tuning-messages">2. Reading messages from remote folders</a></span></dt><dt><span class="sect1"><a href="#tuning-search">3. Searching and limiting</a></span></dt></dl></dd><dt><span class="chapter"><a href="#reference">8. Reference</a></span></dt><dd><dl><dt><span class="sect1"><a href="#commandline">1. Command line options</a></span></dt><dt><span class="sect1"><a href="#commands">2. Configuration Commands</a></span></dt><dt><span class="sect1"><a href="#variables">3. Configuration variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#abort-nosubject">3.1. abort_nosubject</a></span></dt><dt><span class="sect2"><a href="#abort-unmodified">3.2. abort_unmodified</a></span></dt><dt><span class="sect2"><a href="#alias-file">3.3. alias_file</a></span></dt><dt><span class="sect2"><a href="#alias-format">3.4. alias_format</a></span></dt><dt><span class="sect2"><a href="#allow-8bit">3.5. allow_8bit</a></span></dt><dt><span class="sect2"><a href="#allow-ansi">3.6. allow_ansi</a></span></dt><dt><span class="sect2"><a href="#arrow-cursor">3.7. arrow_cursor</a></span></dt><dt><span class="sect2"><a href="#ascii-chars">3.8. ascii_chars</a></span></dt><dt><span class="sect2"><a href="#askbcc">3.9. askbcc</a></span></dt><dt><span class="sect2"><a href="#askcc">3.10. askcc</a></span></dt><dt><span class="sect2"><a href="#assumed-charset">3.11. assumed_charset</a></span></dt><dt><span class="sect2"><a href="#attach-charset">3.12. attach_charset</a></span></dt><dt><span class="sect2"><a href="#attach-format">3.13. attach_format</a></span></dt><dt><span class="sect2"><a href="#attach-sep">3.14. attach_sep</a></span></dt><dt><span class="sect2"><a href="#attach-split">3.15. attach_split</a></span></dt><dt><span class="sect2"><a href="#attribution">3.16. attribution</a></span></dt><dt><span class="sect2"><a href="#autoedit">3.17. autoedit</a></span></dt><dt><span class="sect2"><a href="#auto-tag">3.18. auto_tag</a></span></dt><dt><span class="sect2"><a href="#beep">3.19. beep</a></span></dt><dt><span class="sect2"><a href="#beep-new">3.20. beep_new</a></span></dt><dt><span class="sect2"><a href="#bounce">3.21. bounce</a></span></dt><dt><span class="sect2"><a href="#bounce-delivered">3.22. bounce_delivered</a></span></dt><dt><span class="sect2"><a href="#braille-friendly">3.23. braille_friendly</a></span></dt><dt><span class="sect2"><a href="#check-mbox-size">3.24. check_mbox_size</a></span></dt><dt><span class="sect2"><a href="#charset">3.25. charset</a></span></dt><dt><span class="sect2"><a href="#check-new">3.26. check_new</a></span></dt><dt><span class="sect2"><a href="#collapse-unread">3.27. collapse_unread</a></span></dt><dt><span class="sect2"><a href="#uncollapse-jump">3.28. uncollapse_jump</a></span></dt><dt><span class="sect2"><a href="#compose-format">3.29. compose_format</a></span></dt><dt><span class="sect2"><a href="#config-charset">3.30. config_charset</a></span></dt><dt><span class="sect2"><a href="#confirmappend">3.31. confirmappend</a></span></dt><dt><span class="sect2"><a href="#confirmcreate">3.32. confirmcreate</a></span></dt><dt><span class="sect2"><a href="#connect-timeout">3.33. connect_timeout</a></span></dt><dt><span class="sect2"><a href="#content-type">3.34. content_type</a></span></dt><dt><span class="sect2"><a href="#copy">3.35. copy</a></span></dt><dt><span class="sect2"><a href="#crypt-use-gpgme">3.36. crypt_use_gpgme</a></span></dt><dt><span class="sect2"><a href="#crypt-use-pka">3.37. crypt_use_pka</a></span></dt><dt><span class="sect2"><a href="#crypt-autopgp">3.38. crypt_autopgp</a></span></dt><dt><span class="sect2"><a href="#crypt-autosmime">3.39. crypt_autosmime</a></span></dt><dt><span class="sect2"><a href="#date-format">3.40. date_format</a></span></dt><dt><span class="sect2"><a href="#default-hook">3.41. default_hook</a></span></dt><dt><span class="sect2"><a href="#delete">3.42. delete</a></span></dt><dt><span class="sect2"><a href="#delete-untag">3.43. delete_untag</a></span></dt><dt><span class="sect2"><a href="#digest-collapse">3.44. digest_collapse</a></span></dt><dt><span class="sect2"><a href="#display-filter">3.45. display_filter</a></span></dt><dt><span class="sect2"><a href="#dotlock-program">3.46. dotlock_program</a></span></dt><dt><span class="sect2"><a href="#dsn-notify">3.47. dsn_notify</a></span></dt><dt><span class="sect2"><a href="#dsn-return">3.48. dsn_return</a></span></dt><dt><span class="sect2"><a href="#duplicate-threads">3.49. duplicate_threads</a></span></dt><dt><span class="sect2"><a href="#edit-headers">3.50. edit_headers</a></span></dt><dt><span class="sect2"><a href="#editor">3.51. editor</a></span></dt><dt><span class="sect2"><a href="#encode-from">3.52. encode_from</a></span></dt><dt><span class="sect2"><a href="#envelope-from-address">3.53. envelope_from_address</a></span></dt><dt><span class="sect2"><a href="#escape">3.54. escape</a></span></dt><dt><span class="sect2"><a href="#fast-reply">3.55. fast_reply</a></span></dt><dt><span class="sect2"><a href="#fcc-attach">3.56. fcc_attach</a></span></dt><dt><span class="sect2"><a href="#fcc-clear">3.57. fcc_clear</a></span></dt><dt><span class="sect2"><a href="#folder">3.58. folder</a></span></dt><dt><span class="sect2"><a href="#folder-format">3.59. folder_format</a></span></dt><dt><span class="sect2"><a href="#followup-to">3.60. followup_to</a></span></dt><dt><span class="sect2"><a href="#force-name">3.61. force_name</a></span></dt><dt><span class="sect2"><a href="#forward-decode">3.62. forward_decode</a></span></dt><dt><span class="sect2"><a href="#forward-edit">3.63. forward_edit</a></span></dt><dt><span class="sect2"><a href="#forward-format">3.64. forward_format</a></span></dt><dt><span class="sect2"><a href="#forward-quote">3.65. forward_quote</a></span></dt><dt><span class="sect2"><a href="#from">3.66. from</a></span></dt><dt><span class="sect2"><a href="#gecos-mask">3.67. gecos_mask</a></span></dt><dt><span class="sect2"><a href="#hdrs">3.68. hdrs</a></span></dt><dt><span class="sect2"><a href="#header">3.69. header</a></span></dt><dt><span class="sect2"><a href="#help">3.70. help</a></span></dt><dt><span class="sect2"><a href="#hidden-host">3.71. hidden_host</a></span></dt><dt><span class="sect2"><a href="#hide-limited">3.72. hide_limited</a></span></dt><dt><span class="sect2"><a href="#hide-missing">3.73. hide_missing</a></span></dt><dt><span class="sect2"><a href="#hide-thread-subject">3.74. hide_thread_subject</a></span></dt><dt><span class="sect2"><a href="#hide-top-limited">3.75. hide_top_limited</a></span></dt><dt><span class="sect2"><a href="#hide-top-missing">3.76. hide_top_missing</a></span></dt><dt><span class="sect2"><a href="#history">3.77. history</a></span></dt><dt><span class="sect2"><a href="#history-file">3.78. history_file</a></span></dt><dt><span class="sect2"><a href="#honor-followup-to">3.79. honor_followup_to</a></span></dt><dt><span class="sect2"><a href="#hostname">3.80. hostname</a></span></dt><dt><span class="sect2"><a href="#ignore-linear-white-space">3.81. ignore_linear_white_space</a></span></dt><dt><span class="sect2"><a href="#ignore-list-reply-to">3.82. ignore_list_reply_to</a></span></dt><dt><span class="sect2"><a href="#imap-authenticators">3.83. imap_authenticators</a></span></dt><dt><span class="sect2"><a href="#imap-check-subscribed">3.84. imap_check_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-delim-chars">3.85. imap_delim_chars</a></span></dt><dt><span class="sect2"><a href="#imap-headers">3.86. imap_headers</a></span></dt><dt><span class="sect2"><a href="#imap-idle">3.87. imap_idle</a></span></dt><dt><span class="sect2"><a href="#imap-keepalive">3.88. imap_keepalive</a></span></dt><dt><span class="sect2"><a href="#imap-list-subscribed">3.89. imap_list_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-login">3.90. imap_login</a></span></dt><dt><span class="sect2"><a href="#imap-pass">3.91. imap_pass</a></span></dt><dt><span class="sect2"><a href="#imap-passive">3.92. imap_passive</a></span></dt><dt><span class="sect2"><a href="#imap-peek">3.93. imap_peek</a></span></dt><dt><span class="sect2"><a href="#imap-servernoise">3.94. imap_servernoise</a></span></dt><dt><span class="sect2"><a href="#imap-user">3.95. imap_user</a></span></dt><dt><span class="sect2"><a href="#implicit-autoview">3.96. implicit_autoview</a></span></dt><dt><span class="sect2"><a href="#include">3.97. include</a></span></dt><dt><span class="sect2"><a href="#include-onlyfirst">3.98. include_onlyfirst</a></span></dt><dt><span class="sect2"><a href="#indent-string">3.99. indent_string</a></span></dt><dt><span class="sect2"><a href="#index-format">3.100. index_format</a></span></dt><dt><span class="sect2"><a href="#ispell">3.101. ispell</a></span></dt><dt><span class="sect2"><a href="#keep-flagged">3.102. keep_flagged</a></span></dt><dt><span class="sect2"><a href="#locale">3.103. locale</a></span></dt><dt><span class="sect2"><a href="#mail-check">3.104. mail_check</a></span></dt><dt><span class="sect2"><a href="#mailcap-path">3.105. mailcap_path</a></span></dt><dt><span class="sect2"><a href="#mailcap-sanitize">3.106. mailcap_sanitize</a></span></dt><dt><span class="sect2"><a href="#header-cache">3.107. header_cache</a></span></dt><dt><span class="sect2"><a href="#maildir-header-cache-verify">3.108. maildir_header_cache_verify</a></span></dt><dt><span class="sect2"><a href="#header-cache-pagesize">3.109. header_cache_pagesize</a></span></dt><dt><span class="sect2"><a href="#header-cache-compress">3.110. header_cache_compress</a></span></dt><dt><span class="sect2"><a href="#maildir-trash">3.111. maildir_trash</a></span></dt><dt><span class="sect2"><a href="#mark-old">3.112. mark_old</a></span></dt><dt><span class="sect2"><a href="#markers">3.113. markers</a></span></dt><dt><span class="sect2"><a href="#mask">3.114. mask</a></span></dt><dt><span class="sect2"><a href="#mbox">3.115. mbox</a></span></dt><dt><span class="sect2"><a href="#mbox-type">3.116. mbox_type</a></span></dt><dt><span class="sect2"><a href="#metoo">3.117. metoo</a></span></dt><dt><span class="sect2"><a href="#menu-context">3.118. menu_context</a></span></dt><dt><span class="sect2"><a href="#menu-move-off">3.119. menu_move_off</a></span></dt><dt><span class="sect2"><a href="#menu-scroll">3.120. menu_scroll</a></span></dt><dt><span class="sect2"><a href="#meta-key">3.121. meta_key</a></span></dt><dt><span class="sect2"><a href="#mh-purge">3.122. mh_purge</a></span></dt><dt><span class="sect2"><a href="#mh-seq-flagged">3.123. mh_seq_flagged</a></span></dt><dt><span class="sect2"><a href="#mh-seq-replied">3.124. mh_seq_replied</a></span></dt><dt><span class="sect2"><a href="#mh-seq-unseen">3.125. mh_seq_unseen</a></span></dt><dt><span class="sect2"><a href="#mime-forward">3.126. mime_forward</a></span></dt><dt><span class="sect2"><a href="#mime-forward-decode">3.127. mime_forward_decode</a></span></dt><dt><span class="sect2"><a href="#mime-forward-rest">3.128. mime_forward_rest</a></span></dt><dt><span class="sect2"><a href="#mix-entry-format">3.129. mix_entry_format</a></span></dt><dt><span class="sect2"><a href="#mixmaster">3.130. mixmaster</a></span></dt><dt><span class="sect2"><a href="#move">3.131. move</a></span></dt><dt><span class="sect2"><a href="#message-cachedir">3.132. message_cachedir</a></span></dt><dt><span class="sect2"><a href="#message-cache-clean">3.133. message_cache_clean</a></span></dt><dt><span class="sect2"><a href="#message-format">3.134. message_format</a></span></dt><dt><span class="sect2"><a href="#narrow-tree">3.135. narrow_tree</a></span></dt><dt><span class="sect2"><a href="#net-inc">3.136. net_inc</a></span></dt><dt><span class="sect2"><a href="#pager">3.137. pager</a></span></dt><dt><span class="sect2"><a href="#pager-context">3.138. pager_context</a></span></dt><dt><span class="sect2"><a href="#pager-format">3.139. pager_format</a></span></dt><dt><span class="sect2"><a href="#pager-index-lines">3.140. pager_index_lines</a></span></dt><dt><span class="sect2"><a href="#pager-stop">3.141. pager_stop</a></span></dt><dt><span class="sect2"><a href="#crypt-autosign">3.142. crypt_autosign</a></span></dt><dt><span class="sect2"><a href="#crypt-autoencrypt">3.143. crypt_autoencrypt</a></span></dt><dt><span class="sect2"><a href="#pgp-ignore-subkeys">3.144. pgp_ignore_subkeys</a></span></dt><dt><span class="sect2"><a href="#crypt-replyencrypt">3.145. crypt_replyencrypt</a></span></dt><dt><span class="sect2"><a href="#crypt-replysign">3.146. crypt_replysign</a></span></dt><dt><span class="sect2"><a href="#crypt-replysignencrypted">3.147. crypt_replysignencrypted</a></span></dt><dt><span class="sect2"><a href="#crypt-timestamp">3.148. crypt_timestamp</a></span></dt><dt><span class="sect2"><a href="#pgp-use-gpg-agent">3.149. pgp_use_gpg_agent</a></span></dt><dt><span class="sect2"><a href="#crypt-verify-sig">3.150. crypt_verify_sig</a></span></dt><dt><span class="sect2"><a href="#smime-is-default">3.151. smime_is_default</a></span></dt><dt><span class="sect2"><a href="#smime-ask-cert-label">3.152. smime_ask_cert_label</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-use-default-key">3.153. smime_decrypt_use_default_key</a></span></dt><dt><span class="sect2"><a href="#pgp-entry-format">3.154. pgp_entry_format</a></span></dt><dt><span class="sect2"><a href="#pgp-good-sign">3.155. pgp_good_sign</a></span></dt><dt><span class="sect2"><a href="#pgp-check-exit">3.156. pgp_check_exit</a></span></dt><dt><span class="sect2"><a href="#pgp-long-ids">3.157. pgp_long_ids</a></span></dt><dt><span class="sect2"><a href="#pgp-retainable-sigs">3.158. pgp_retainable_sigs</a></span></dt><dt><span class="sect2"><a href="#pgp-autoinline">3.159. pgp_autoinline</a></span></dt><dt><span class="sect2"><a href="#pgp-replyinline">3.160. pgp_replyinline</a></span></dt><dt><span class="sect2"><a href="#pgp-show-unusable">3.161. pgp_show_unusable</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-as">3.162. pgp_sign_as</a></span></dt><dt><span class="sect2"><a href="#pgp-strict-enc">3.163. pgp_strict_enc</a></span></dt><dt><span class="sect2"><a href="#pgp-timeout">3.164. pgp_timeout</a></span></dt><dt><span class="sect2"><a href="#pgp-sort-keys">3.165. pgp_sort_keys</a></span></dt><dt><span class="sect2"><a href="#pgp-mime-auto">3.166. pgp_mime_auto</a></span></dt><dt><span class="sect2"><a href="#pgp-auto-decode">3.167. pgp_auto_decode</a></span></dt><dt><span class="sect2"><a href="#pgp-decode-command">3.168. pgp_decode_command</a></span></dt><dt><span class="sect2"><a href="#pgp-getkeys-command">3.169. pgp_getkeys_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-command">3.170. pgp_verify_command</a></span></dt><dt><span class="sect2"><a href="#pgp-decrypt-command">3.171. pgp_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#pgp-clearsign-command">3.172. pgp_clearsign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-command">3.173. pgp_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-sign-command">3.174. pgp_encrypt_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-only-command">3.175. pgp_encrypt_only_command</a></span></dt><dt><span class="sect2"><a href="#pgp-import-command">3.176. pgp_import_command</a></span></dt><dt><span class="sect2"><a href="#pgp-export-command">3.177. pgp_export_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-key-command">3.178. pgp_verify_key_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-secring-command">3.179. pgp_list_secring_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-pubring-command">3.180. pgp_list_pubring_command</a></span></dt><dt><span class="sect2"><a href="#forward-decrypt">3.181. forward_decrypt</a></span></dt><dt><span class="sect2"><a href="#smime-timeout">3.182. smime_timeout</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-with">3.183. smime_encrypt_with</a></span></dt><dt><span class="sect2"><a href="#smime-keys">3.184. smime_keys</a></span></dt><dt><span class="sect2"><a href="#smime-ca-location">3.185. smime_ca_location</a></span></dt><dt><span class="sect2"><a href="#smime-certificates">3.186. smime_certificates</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-command">3.187. smime_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-command">3.188. smime_verify_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-opaque-command">3.189. smime_verify_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-command">3.190. smime_sign_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-opaque-command">3.191. smime_sign_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-command">3.192. smime_encrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-pk7out-command">3.193. smime_pk7out_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-command">3.194. smime_get_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-signer-cert-command">3.195. smime_get_signer_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-import-cert-command">3.196. smime_import_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-email-command">3.197. smime_get_cert_email_command</a></span></dt><dt><span class="sect2"><a href="#smime-default-key">3.198. smime_default_key</a></span></dt><dt><span class="sect2"><a href="#ssl-client-cert">3.199. ssl_client_cert</a></span></dt><dt><span class="sect2"><a href="#ssl-force-tls">3.200. ssl_force_tls</a></span></dt><dt><span class="sect2"><a href="#ssl-starttls">3.201. ssl_starttls</a></span></dt><dt><span class="sect2"><a href="#certificate-file">3.202. certificate_file</a></span></dt><dt><span class="sect2"><a href="#ssl-usesystemcerts">3.203. ssl_usesystemcerts</a></span></dt><dt><span class="sect2"><a href="#entropy-file">3.204. entropy_file</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv2">3.205. ssl_use_sslv2</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv3">3.206. ssl_use_sslv3</a></span></dt><dt><span class="sect2"><a href="#ssl-use-tlsv1">3.207. ssl_use_tlsv1</a></span></dt><dt><span class="sect2"><a href="#ssl-min-dh-prime-bits">3.208. ssl_min_dh_prime_bits</a></span></dt><dt><span class="sect2"><a href="#ssl-ca-certificates-file">3.209. ssl_ca_certificates_file</a></span></dt><dt><span class="sect2"><a href="#pipe-split">3.210. pipe_split</a></span></dt><dt><span class="sect2"><a href="#pipe-decode">3.211. pipe_decode</a></span></dt><dt><span class="sect2"><a href="#pipe-sep">3.212. pipe_sep</a></span></dt><dt><span class="sect2"><a href="#pop-authenticators">3.213. pop_authenticators</a></span></dt><dt><span class="sect2"><a href="#pop-auth-try-all">3.214. pop_auth_try_all</a></span></dt><dt><span class="sect2"><a href="#pop-checkinterval">3.215. pop_checkinterval</a></span></dt><dt><span class="sect2"><a href="#pop-delete">3.216. pop_delete</a></span></dt><dt><span class="sect2"><a href="#pop-host">3.217. pop_host</a></span></dt><dt><span class="sect2"><a href="#pop-last">3.218. pop_last</a></span></dt><dt><span class="sect2"><a href="#pop-reconnect">3.219. pop_reconnect</a></span></dt><dt><span class="sect2"><a href="#pop-user">3.220. pop_user</a></span></dt><dt><span class="sect2"><a href="#pop-pass">3.221. pop_pass</a></span></dt><dt><span class="sect2"><a href="#post-indent-string">3.222. post_indent_string</a></span></dt><dt><span class="sect2"><a href="#postpone">3.223. postpone</a></span></dt><dt><span class="sect2"><a href="#postponed">3.224. postponed</a></span></dt><dt><span class="sect2"><a href="#preconnect">3.225. preconnect</a></span></dt><dt><span class="sect2"><a href="#print">3.226. print</a></span></dt><dt><span class="sect2"><a href="#print-command">3.227. print_command</a></span></dt><dt><span class="sect2"><a href="#print-decode">3.228. print_decode</a></span></dt><dt><span class="sect2"><a href="#print-split">3.229. print_split</a></span></dt><dt><span class="sect2"><a href="#prompt-after">3.230. prompt_after</a></span></dt><dt><span class="sect2"><a href="#query-command">3.231. query_command</a></span></dt><dt><span class="sect2"><a href="#query-format">3.232. query_format</a></span></dt><dt><span class="sect2"><a href="#quit">3.233. quit</a></span></dt><dt><span class="sect2"><a href="#quote-regexp">3.234. quote_regexp</a></span></dt><dt><span class="sect2"><a href="#read-inc">3.235. read_inc</a></span></dt><dt><span class="sect2"><a href="#read-only">3.236. read_only</a></span></dt><dt><span class="sect2"><a href="#realname">3.237. realname</a></span></dt><dt><span class="sect2"><a href="#recall">3.238. recall</a></span></dt><dt><span class="sect2"><a href="#record">3.239. record</a></span></dt><dt><span class="sect2"><a href="#reply-regexp">3.240. reply_regexp</a></span></dt><dt><span class="sect2"><a href="#reply-self">3.241. reply_self</a></span></dt><dt><span class="sect2"><a href="#reply-to">3.242. reply_to</a></span></dt><dt><span class="sect2"><a href="#resolve">3.243. resolve</a></span></dt><dt><span class="sect2"><a href="#reverse-alias">3.244. reverse_alias</a></span></dt><dt><span class="sect2"><a href="#reverse-name">3.245. reverse_name</a></span></dt><dt><span class="sect2"><a href="#reverse-realname">3.246. reverse_realname</a></span></dt><dt><span class="sect2"><a href="#rfc2047-parameters">3.247. rfc2047_parameters</a></span></dt><dt><span class="sect2"><a href="#save-address">3.248. save_address</a></span></dt><dt><span class="sect2"><a href="#save-empty">3.249. save_empty</a></span></dt><dt><span class="sect2"><a href="#save-history">3.250. save_history</a></span></dt><dt><span class="sect2"><a href="#save-name">3.251. save_name</a></span></dt><dt><span class="sect2"><a href="#score">3.252. score</a></span></dt><dt><span class="sect2"><a href="#score-threshold-delete">3.253. score_threshold_delete</a></span></dt><dt><span class="sect2"><a href="#score-threshold-flag">3.254. score_threshold_flag</a></span></dt><dt><span class="sect2"><a href="#score-threshold-read">3.255. score_threshold_read</a></span></dt><dt><span class="sect2"><a href="#send-charset">3.256. send_charset</a></span></dt><dt><span class="sect2"><a href="#sendmail">3.257. sendmail</a></span></dt><dt><span class="sect2"><a href="#sendmail-wait">3.258. sendmail_wait</a></span></dt><dt><span class="sect2"><a href="#shell">3.259. shell</a></span></dt><dt><span class="sect2"><a href="#sig-dashes">3.260. sig_dashes</a></span></dt><dt><span class="sect2"><a href="#sig-on-top">3.261. sig_on_top</a></span></dt><dt><span class="sect2"><a href="#signature">3.262. signature</a></span></dt><dt><span class="sect2"><a href="#simple-search">3.263. simple_search</a></span></dt><dt><span class="sect2"><a href="#smart-wrap">3.264. smart_wrap</a></span></dt><dt><span class="sect2"><a href="#smileys">3.265. smileys</a></span></dt><dt><span class="sect2"><a href="#sleep-time">3.266. sleep_time</a></span></dt><dt><span class="sect2"><a href="#smtp-authenticators">3.267. smtp_authenticators</a></span></dt><dt><span class="sect2"><a href="#smtp-pass">3.268. smtp_pass</a></span></dt><dt><span class="sect2"><a href="#smtp-url">3.269. smtp_url</a></span></dt><dt><span class="sect2"><a href="#sort">3.270. sort</a></span></dt><dt><span class="sect2"><a href="#sort-alias">3.271. sort_alias</a></span></dt><dt><span class="sect2"><a href="#sort-aux">3.272. sort_aux</a></span></dt><dt><span class="sect2"><a href="#sort-browser">3.273. sort_browser</a></span></dt><dt><span class="sect2"><a href="#sort-re">3.274. sort_re</a></span></dt><dt><span class="sect2"><a href="#spam-separator">3.275. spam_separator</a></span></dt><dt><span class="sect2"><a href="#spoolfile">3.276. spoolfile</a></span></dt><dt><span class="sect2"><a href="#status-chars">3.277. status_chars</a></span></dt><dt><span class="sect2"><a href="#status-format">3.278. status_format</a></span></dt><dt><span class="sect2"><a href="#status-on-top">3.279. status_on_top</a></span></dt><dt><span class="sect2"><a href="#strict-threads">3.280. strict_threads</a></span></dt><dt><span class="sect2"><a href="#suspend">3.281. suspend</a></span></dt><dt><span class="sect2"><a href="#text-flowed">3.282. text_flowed</a></span></dt><dt><span class="sect2"><a href="#thread-received">3.283. thread_received</a></span></dt><dt><span class="sect2"><a href="#thorough-search">3.284. thorough_search</a></span></dt><dt><span class="sect2"><a href="#tilde">3.285. tilde</a></span></dt><dt><span class="sect2"><a href="#time-inc">3.286. time_inc</a></span></dt><dt><span class="sect2"><a href="#timeout">3.287. timeout</a></span></dt><dt><span class="sect2"><a href="#tmpdir">3.288. tmpdir</a></span></dt><dt><span class="sect2"><a href="#to-chars">3.289. to_chars</a></span></dt><dt><span class="sect2"><a href="#tunnel">3.290. tunnel</a></span></dt><dt><span class="sect2"><a href="#use-8bitmime">3.291. use_8bitmime</a></span></dt><dt><span class="sect2"><a href="#use-domain">3.292. use_domain</a></span></dt><dt><span class="sect2"><a href="#use-envelope-from">3.293. use_envelope_from</a></span></dt><dt><span class="sect2"><a href="#use-from">3.294. use_from</a></span></dt><dt><span class="sect2"><a href="#use-idn">3.295. use_idn</a></span></dt><dt><span class="sect2"><a href="#use-ipv6">3.296. use_ipv6</a></span></dt><dt><span class="sect2"><a href="#user-agent">3.297. user_agent</a></span></dt><dt><span class="sect2"><a href="#visual">3.298. visual</a></span></dt><dt><span class="sect2"><a href="#wait-key">3.299. wait_key</a></span></dt><dt><span class="sect2"><a href="#weed">3.300. weed</a></span></dt><dt><span class="sect2"><a href="#wrap">3.301. wrap</a></span></dt><dt><span class="sect2"><a href="#wrap-search">3.302. wrap_search</a></span></dt><dt><span class="sect2"><a href="#wrapmargin">3.303. wrapmargin</a></span></dt><dt><span class="sect2"><a href="#write-inc">3.304. write_inc</a></span></dt><dt><span class="sect2"><a href="#write-bcc">3.305. write_bcc</a></span></dt></dl></dd><dt><span class="sect1"><a href="#functions">4. Functions</a></span></dt><dd><dl><dt><span class="sect2"><a href="#generic_map">4.1. generic</a></span></dt><dt><span class="sect2"><a href="#index_map">4.2. index</a></span></dt><dt><span class="sect2"><a href="#pager_map">4.3. pager</a></span></dt><dt><span class="sect2"><a href="#alias_map">4.4. alias</a></span></dt><dt><span class="sect2"><a href="#query_map">4.5. query</a></span></dt><dt><span class="sect2"><a href="#attach_map">4.6. attach</a></span></dt><dt><span class="sect2"><a href="#compose_map">4.7. compose</a></span></dt><dt><span class="sect2"><a href="#postpone_map">4.8. postpone</a></span></dt><dt><span class="sect2"><a href="#browser_map">4.9. browser</a></span></dt><dt><span class="sect2"><a href="#pgp_map">4.10. pgp</a></span></dt><dt><span class="sect2"><a href="#smime_map">4.11. smime</a></span></dt><dt><span class="sect2"><a href="#mix_map">4.12. mix</a></span></dt><dt><span class="sect2"><a href="#editor_map">4.13. editor</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="#miscellany">9. Miscellany</a></span></dt><dd><dl><dt><span class="sect1"><a href="#acknowledgements">1. Acknowledgements</a></span></dt><dt><span class="sect1"><a href="#about">2. About this document</a></span></dt></dl></dd></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>2.1. <a href="#tab-keys-nav">Most common navigation keys</a></dt><dt>2.2. <a href="#tab-keys-editor">Most common line editor keys</a></dt><dt>2.3. <a href="#tab-key-index">Most common message index keys</a></dt><dt>2.4. <a href="#tab-key-pager">Most common pager keys</a></dt><dt>2.5. <a href="#tab-ansi-esc">ANSI escape sequences</a></dt><dt>2.6. <a href="#tab-color">Color sequences</a></dt><dt>2.7. <a href="#tab-key-threads">Most common thread mode keys</a></dt><dt>2.8. <a href="#tab-key-send">Most common mail sending keys</a></dt><dt>2.9. <a href="#tab-func-compose">Most common compose menu keys</a></dt><dt>2.10. <a href="#tab-pgp-menuflags">PGP key menu flags</a></dt><dt>2.11. <a href="#tab-key-fwd">Message forwarding/bouncing keys</a></dt><dt>3.1. <a href="#tab-key-names">Symbolic key names</a></dt><dt>4.1. <a href="#tab-patterns">Pattern modifiers</a></dt><dt>4.2. <a href="#tab-simplesearch-keywords">Simple search keywords</a></dt><dt>4.3. <a href="#tab-date-units">Date units</a></dt><dt>8.1. <a href="#id463727">Command line options</a></dt><dt>8.2. <a href="#generic_table">Default generic function bindings</a></dt><dt>8.3. <a href="#index_table">Default index function bindings</a></dt><dt>8.4. <a href="#pager_table">Default pager function bindings</a></dt><dt>8.5. <a href="#alias_table">Default alias function bindings</a></dt><dt>8.6. <a href="#query_table">Default query function bindings</a></dt><dt>8.7. <a href="#attach_table">Default attach function bindings</a></dt><dt>8.8. <a href="#compose_table">Default compose function bindings</a></dt><dt>8.9. <a href="#postpone_table">Default postpone function bindings</a></dt><dt>8.10. <a href="#browser_table">Default browser function bindings</a></dt><dt>8.11. <a href="#pgp_table">Default pgp function bindings</a></dt><dt>8.12. <a href="#smime_table">Default smime function bindings</a></dt><dt>8.13. <a href="#mix_table">Default mix function bindings</a></dt><dt>8.14. <a href="#editor_table">Default editor function bindings</a></dt></dl></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="intro"></a>Chapter 1. Introduction</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#homepage">1. Mutt Home Page</a></span></dt><dt><span class="sect1"><a href="#muttlists">2. Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#distribution">3. Software Distribution Sites</a></span></dt><dt><span class="sect1"><a href="#irc">4. IRC</a></span></dt><dt><span class="sect1"><a href="#usenet">5. USENET</a></span></dt><dt><span class="sect1"><a href="#copyright">6. Copyright</a></span></dt></dl></div><p>

6

<span class="bold"><strong>Mutt</strong></span> is a small but very powerful text-based MIME mail client. Mutt is

7

highly configurable, and is well suited to the mail power user with advanced

8

features like key bindings, keyboard macros, mail threading, regular

59

You should have received a copy of the GNU General Public License

60

along with this program; if not, write to the Free Software

61

Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

62

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="gettingstarted"></a>Chapter 2. Getting Started</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#menus">1. Moving Around in Menus</a></span></dt><dt><span class="sect1"><a href="#editing">2. Editing Input Fields</a></span></dt><dd><dl><dt><span class="sect2"><a href="#editing-intro">2.1. Introduction</a></span></dt><dt><span class="sect2"><a href="#editing-history">2.2. History</a></span></dt></dl></dd><dt><span class="sect1"><a href="#reading">3. Reading Mail - The Index and Pager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2830094">3.1. The Message Index</a></span></dt><dt><span class="sect2"><a href="#id2876636">3.2. The Pager</a></span></dt><dt><span class="sect2"><a href="#threads">3.3. Threaded Mode</a></span></dt><dt><span class="sect2"><a href="#id2877085">3.4. Miscellaneous Functions</a></span></dt></dl></dd><dt><span class="sect1"><a href="#sending">4. Sending Mail</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2878068">4.1. Editing the message header</a></span></dt><dt><span class="sect2"><a href="#id2878157">4.2. Using Mutt with PGP</a></span></dt><dt><span class="sect2"><a href="#id2878393">4.3. Sending anonymous messages via mixmaster.</a></span></dt></dl></dd><dt><span class="sect1"><a href="#forwarding-mail">5. Forwarding and Bouncing Mail</a></span></dt><dt><span class="sect1"><a href="#postponing-mail">6. Postponing Mail</a></span></dt></dl></div><p>

62

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="gettingstarted"></a>Chapter 2. Getting Started</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#menus">1. Moving Around in Menus</a></span></dt><dt><span class="sect1"><a href="#editing">2. Editing Input Fields</a></span></dt><dd><dl><dt><span class="sect2"><a href="#editing-intro">2.1. Introduction</a></span></dt><dt><span class="sect2"><a href="#editing-history">2.2. History</a></span></dt></dl></dd><dt><span class="sect1"><a href="#reading">3. Reading Mail - The Index and Pager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id449968">3.1. The Message Index</a></span></dt><dt><span class="sect2"><a href="#id450511">3.2. The Pager</a></span></dt><dt><span class="sect2"><a href="#threads">3.3. Threaded Mode</a></span></dt><dt><span class="sect2"><a href="#id451166">3.4. Miscellaneous Functions</a></span></dt></dl></dd><dt><span class="sect1"><a href="#sending">4. Sending Mail</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id452150">4.1. Editing the message header</a></span></dt><dt><span class="sect2"><a href="#id452237">4.2. Using Mutt with PGP</a></span></dt><dt><span class="sect2"><a href="#id452481">4.3. Sending anonymous messages via mixmaster.</a></span></dt><dt><span class="sect2"><a href="#id452606">4.4. Sending format=flowed messages</a></span></dt></dl></dd><dt><span class="sect1"><a href="#forwarding-mail">5. Forwarding and Bouncing Mail</a></span></dt><dt><span class="sect1"><a href="#postponing-mail">6. Postponing Mail</a></span></dt></dl></div><p>

63

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

64

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

65

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

73

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

74

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

75

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

76

Information is presented in menus, very similar to ELM. Here is a table

77

showing the common keys used to navigate menus in Mutt.

76

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

77

for common keys used to navigate menus in Mutt.

78

</p><p>

79

80

</p><div class="table"><a id="id2828973"></a><p class="title"><b>Table 2.1. Most common navigation keys</b></p><table summary="Most common navigation keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>j or Down</td><td>next-entry</td><td>move to the next entry</td></tr><tr><td>k or Up</td><td>previous-entry</td><td>move to the previous entry</td></tr><tr><td>z or PageDn</td><td>page-down</td><td>go to the next page</td></tr><tr><td>Z or PageUp</td><td>page-up</td><td>go to the previous page</td></tr><tr><td>= or Home</td><td>first-entry</td><td>jump to the first entry</td></tr><tr><td>* or End</td><td>last-entry</td><td>jump to the last entry</td></tr><tr><td>q</td><td>quit</td><td>exit the current menu</td></tr><tr><td>?</td><td>help</td><td>list all keybindings for the current menu</td></tr></tbody></table></div><p>

80

</p><div class="table"><a id="tab-keys-nav"></a><p class="title"><b>Table 2.1. Most common navigation keys</b></p><div class="table-contents"><table summary="Most common navigation keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>j or Down</td><td>next-entry</td><td>move to the next entry</td></tr><tr><td>k or Up</td><td>previous-entry</td><td>move to the previous entry</td></tr><tr><td>z or PageDn</td><td>page-down</td><td>go to the next page</td></tr><tr><td>Z or PageUp</td><td>page-up</td><td>go to the previous page</td></tr><tr><td>= or Home</td><td>first-entry</td><td>jump to the first entry</td></tr><tr><td>* or End</td><td>last-entry</td><td>jump to the last entry</td></tr><tr><td>q</td><td>quit</td><td>exit the current menu</td></tr><tr><td>?</td><td>help</td><td>list all keybindings for the current menu</td></tr></tbody></table></div></div><p><br class="table-break" />

81

82

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

83

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

84

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

85

very similar to those of Emacs. See the following table for a full

85

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

86

reference of available functions, their default key bindings, and

87

short descriptions.

88

</p><p>

89

90

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

90

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

91

92

</p><p>

93

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

94

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

94

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

95

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

96

the cursor rather than under, you could use

97

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

98

bind editor <delete> backspace

99

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

100

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

101

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

101

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

102

cycle through them at an editor prompt by using the

103

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

104

commands.

106

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

107

following categories:

108

</p><p>

109

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

109

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

110

</p><p>

111

Mutt automatically filters out repeated items from the history. It

112

also mimics the behavior of some shells by ignoring items starting

122

</p><p>

123

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

124

modes.

125

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

126

127

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

128

129

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

125

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

126

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

127

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

128

</p><p>

129

130

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

131

132

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

130

133

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

131

134

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

132

135

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

166

169

</p><p>

167

170

Furthermore, the following flags reflect who the message is addressed

168

171

to. They can be customized with the

169

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

172

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

170

173

</p><p>

171

174

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

172

175

message is to you and you only

179

182

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

180

183

message is sent to a subscribed mailing list

181

184

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

182

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

185

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

183

186

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

184

187

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

185

188

featureful.

186

189

</p><p>

187

190

188

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

191

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

189

192

190

193

</p><p>

191

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

194

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

195

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

192

196

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

193

197

advantage over using an external pager to view messages).

194

198

</p><p>

198

202

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

199

203

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

200

204

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

201

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

205

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

202

206

objects to specify a color or mono attribute for them.

203

207

</p><p>

204

208

Additionally, the internal pager supports the ANSI escape sequences for

205

209

character attributes. Mutt translates them into the correct color and

206

character settings. The sequences Mutt supports are:

207

</p><p>

208

209

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

210

ESC [ Ps;Ps;Ps;...;Ps m where Ps =

211

0 All Attributes Off

212

1 Bold on

213

4 Underline on

214

5 Blink on

215

7 Reverse video on

216

3x Foreground color is x

217

4x Background color is x

218

219

Colors are

220

0 black

221

1 red

222

2 green

223

3 yellow

224

4 blue

225

5 magenta

226

6 cyan

227

7 white

228

</pre><p>

229

230

</p><p>

210

character settings. The sequences Mutt supports are

211

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

212

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

213

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

214

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

231

215

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

232

216

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

233

217

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

234

218

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

235

219

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

236

220

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

237

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

238

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

221

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

222

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

223

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

239

224

</p><p>

240

225

241

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

226

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

242

227

243

228

</p><p>

244

229

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

245

230

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

246

231

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

247

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

248

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

232

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

233

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

249

234

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

250

235

</p><p>

251

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

252

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

236

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

237

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

253

238

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

254

239

255

240

</p><p>

256

241

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

257

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

242

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

258

243

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

259

244

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

260

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

245

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

261

246

</p><p>

262

247

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

263

248

272

257

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

273

258

274

259

</p><p>

275

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

260

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

276

261

</p><p>

277

262

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

278

263

305

290

</p><p>

306

291

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

307

292

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

308

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

293

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

309

294

fly.

310

295

</p><p>

311

296

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

325

310

326

311

</p><p>

327

312

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

328

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

313

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

329

314

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

330

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

315

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

331

316

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

332

317

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

333

318

the message you are replying to.

336

321

337

322

</p><p>

338

323

Asks for an external Unix command and pipes the current or

339

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

340

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

324

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

325

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

341

326

</p><p>

342

327

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

343

328

346

331

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

347

332

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

348

333

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

349

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

334

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

350

335

variable.

351

336

</p><p>

352

337

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

356

341

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

357

342

358

343

</p><p>

359

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

344

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

360

345

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

361

346

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

362

347

the return status of the named command.

364

349

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

365

350

366

351

</p><p>

367

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

352

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

368

353

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

369

354

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

370

355

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

376

361

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

377

362

after a line of quoted text in the internal pager.

378

363

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

379

The following bindings are available in the <span class="emphasis"><em>index</em></span> for sending

380

messages.

364

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

365

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

381

366

</p><p>

382

367

383

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

368

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

384

369

385

370

</p><p>

386

371

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

395

380

you are replying to or forwarding a message. See also

396

381

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

397

382

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

398

<a href="#autoedit" title="3.15. autoedit">$autoedit</a>,

399

<a href="#bounce" title="3.19. bounce">$bounce</a>,

400

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

401

and <a href="#include" title="3.92. include">$include</a>

383

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

384

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

385

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

386

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

402

387

for changing how Mutt asks these questions.

403

388

</p><p>

404

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

389

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

405

390

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

406

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

407

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

391

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

392

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

408

393

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

409

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

394

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

410

395

will be appended to the message.

411

396

</p><p>

412

397

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

413

returned to the <span class="emphasis"><em>compose</em></span> menu. The following functions are available:

398

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

399

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

414

400

</p><p>

415

401

416

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

402

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

417

403

418

404

</p><p>

419

405

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

420

406

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

421

407

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

422

408

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

423

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

409

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

424

410

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

425

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

411

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

426

412

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

427

413

special features available.

428

414

</p><p>

444

430

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

445

431

allows you to create a new message thread.

446

432

</p><p>

447

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

448

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

433

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

434

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

449

435

If you want to use PGP, you can specify

450

436

</p><p>

451

437

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

452

438

453

439

</p><p>

454

440

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

455

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

441

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

456

442

</p><p>

457

443

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

458

444

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

471

457

Once you have successfully finished the key selection, the message

472

458

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

473

459

</p><p>

474

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

460

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

475

461

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

476

462

and validity fields are in order.

477

463

</p><p>

478

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

464

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

465

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

479

466

480

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

467

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

481

468

482

469

</p><p>

483

470

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

498

485

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

499

486

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

500

487

indicates complete validity.

501

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

488

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

502

489

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

503

490

anonymous remailer. Mixmaster permits you to send your messages

504

491

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

527

514

</p><p>

528

515

Note that different remailers do have different capabilities,

529

516

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

530

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

517

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

531

518

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

532

519

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

533

520

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

534

521

mixmaster remailers. For details on the other capabilities, please

535

522

have a look at the mixmaster documentation.

536

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

523

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

524

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

525

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

526

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

527

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

528

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

529

</p><p>

530

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

531

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

532

receiver decide completely how to view a message.

533

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

534

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

535

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

536

trailing spaces nor does it provide any other feature related to

537

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

538

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

539

before calling the editor).

540

</p><p>

541

After editing the initial message text and before entering

542

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

543

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

544

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

545

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

546

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

547

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

548

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

549

the original message.

550

</p><p>

551

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

552

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

553

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

554

quote or not.

555

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

556

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

557

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

558

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

559

intend to send <code class="literal">f=f</code> messages.

560

</p><p>

561

Please note that when editing messages from the compose menu several

562

times before really sending a mail, it's up to the user to ensure that

563

the message is properly space-stuffed.

564

</p><p>

565

For example, <span class="emphasis"><em>vim</em></span> provides the <code class="literal">w</code>

566

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

567

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

568

fo-table</code> for details.

569

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

537

570

Bouncing and forwarding let you send an existing message to recipients

538

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

571

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

539

572

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

540

573

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

541

(for example, by adding your own comments).

542

</p><p>

543

The following keys are bound by default:

574

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

575

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

544

576

</p><p>

545

577

546

</p><div class="table"><a id="id2878551"></a><p class="title"><b>Table 2.9. Message forwarding/bouncing keys</b></p><table summary="Message forwarding/bouncing keys" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Key</th><th>Function</th><th>Description</th></tr></thead><tbody><tr><td>f</td><td>forward</td><td>forward message</td></tr><tr><td>b</td><td>bounce</td><td>bounce (remail) message</td></tr></tbody></table></div><p>

578

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

547

579

548

580

</p><p>

549

581

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

550

582

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

551

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

552

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

583

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

584

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

553

585

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

554

586

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

555

587

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

556

588

</p><p>

557

589

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

558

<a href="#weed" title="3.288. weed">$weed</a> variable, unless <a href="#mime-forward" title="3.121. mime_forward">$mime_forward</a> is set.

590

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

559

591

</p><p>

560

592

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

561

593

replying to a message does.

563

595

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

564

596

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

565

597

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

566

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

598

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

567

599

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

568

600

</p><p>

569

601

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

578

610

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

579

611

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

580

612

</p><p>

581

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

582

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="configuration"></a>Chapter 3. Configuration</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#muttrc-syntax">1. Syntax of Initialization Files</a></span></dt><dt><span class="sect1"><a href="#alias">2. Defining/Using aliases</a></span></dt><dt><span class="sect1"><a href="#bind">3. Changing the default key bindings</a></span></dt><dt><span class="sect1"><a href="#charset-hook">4. Defining aliases for character sets </a></span></dt><dt><span class="sect1"><a href="#folder-hook">5. Setting variables based upon mailbox</a></span></dt><dt><span class="sect1"><a href="#macro">6. Keyboard macros</a></span></dt><dt><span class="sect1"><a href="#color">7. Using color and mono video attributes</a></span></dt><dt><span class="sect1"><a href="#ignore">8. Ignoring (weeding) unwanted message headers</a></span></dt><dt><span class="sect1"><a href="#alternates">9. Alternative addresses</a></span></dt><dt><span class="sect1"><a href="#lists">10. Mailing lists</a></span></dt><dt><span class="sect1"><a href="#mbox-hook">11. Using Multiple spool mailboxes</a></span></dt><dt><span class="sect1"><a href="#mailboxes">12. Defining mailboxes which receive mail</a></span></dt><dt><span class="sect1"><a href="#my-hdr">13. User defined headers</a></span></dt><dt><span class="sect1"><a href="#hdr-order">14. Defining the order of headers when viewing messages</a></span></dt><dt><span class="sect1"><a href="#save-hook">15. Specify default save filename</a></span></dt><dt><span class="sect1"><a href="#fcc-hook">16. Specify default Fcc: mailbox when composing</a></span></dt><dt><span class="sect1"><a href="#fcc-save-hook">17. Specify default save filename and default Fcc: mailbox at once</a></span></dt><dt><span class="sect1"><a href="#send-hook">18. Change settings based upon message recipients</a></span></dt><dt><span class="sect1"><a href="#message-hook">19. Change settings before formatting a message</a></span></dt><dt><span class="sect1"><a href="#crypt-hook">20. Choosing the cryptographic key of the recipient</a></span></dt><dt><span class="sect1"><a href="#push">21. Adding key sequences to the keyboard buffer</a></span></dt><dt><span class="sect1"><a href="#exec">22. Executing functions</a></span></dt><dt><span class="sect1"><a href="#score-command">23. Message Scoring</a></span></dt><dt><span class="sect1"><a href="#spam">24. Spam detection</a></span></dt><dt><span class="sect1"><a href="#set">25. Setting and Querying Variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#set-commands">25.1. Commands</a></span></dt><dt><span class="sect2"><a href="#set-myvar">25.2. User-defined variables</a></span></dt></dl></dd><dt><span class="sect1"><a href="#source">26. Reading initialization commands from another file</a></span></dt><dt><span class="sect1"><a href="#unhook">27. Removing hooks</a></span></dt></dl></div><p>

613

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

614

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="configuration"></a>Chapter 3. Configuration</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#muttrc-syntax">1. Syntax of Initialization Files</a></span></dt><dt><span class="sect1"><a href="#addrgroup">2. Address groups</a></span></dt><dt><span class="sect1"><a href="#alias">3. Defining/Using aliases</a></span></dt><dt><span class="sect1"><a href="#bind">4. Changing the default key bindings</a></span></dt><dt><span class="sect1"><a href="#charset-hook">5. Defining aliases for character sets </a></span></dt><dt><span class="sect1"><a href="#folder-hook">6. Setting variables based upon mailbox</a></span></dt><dt><span class="sect1"><a href="#macro">7. Keyboard macros</a></span></dt><dt><span class="sect1"><a href="#color">8. Using color and mono video attributes</a></span></dt><dt><span class="sect1"><a href="#ignore">9. Ignoring (weeding) unwanted message headers</a></span></dt><dt><span class="sect1"><a href="#alternates">10. Alternative addresses</a></span></dt><dt><span class="sect1"><a href="#lists">11. Mailing lists</a></span></dt><dt><span class="sect1"><a href="#mbox-hook">12. Using Multiple spool mailboxes</a></span></dt><dt><span class="sect1"><a href="#mailboxes">13. Monitoring incoming mail</a></span></dt><dt><span class="sect1"><a href="#my-hdr">14. User defined headers</a></span></dt><dt><span class="sect1"><a href="#hdr-order">15. Defining the order of headers when viewing messages</a></span></dt><dt><span class="sect1"><a href="#save-hook">16. Specify default save mailbox</a></span></dt><dt><span class="sect1"><a href="#fcc-hook">17. Specify default Fcc: mailbox when composing</a></span></dt><dt><span class="sect1"><a href="#fcc-save-hook">18. Specify default save filename and default Fcc: mailbox at once</a></span></dt><dt><span class="sect1"><a href="#send-hook">19. Change settings based upon message recipients</a></span></dt><dt><span class="sect1"><a href="#message-hook">20. Change settings before formatting a message</a></span></dt><dt><span class="sect1"><a href="#crypt-hook">21. Choosing the cryptographic key of the recipient</a></span></dt><dt><span class="sect1"><a href="#push">22. Adding key sequences to the keyboard buffer</a></span></dt><dt><span class="sect1"><a href="#exec">23. Executing functions</a></span></dt><dt><span class="sect1"><a href="#score-command">24. Message Scoring</a></span></dt><dt><span class="sect1"><a href="#spam">25. Spam detection</a></span></dt><dt><span class="sect1"><a href="#set">26. Setting and Querying Variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#set-commands">26.1. Commands</a></span></dt><dt><span class="sect2"><a href="#set-myvar">26.2. User-defined variables</a></span></dt></dl></dd><dt><span class="sect1"><a href="#source">27. Reading initialization commands from another file</a></span></dt><dt><span class="sect1"><a href="#unhook">28. Removing hooks</a></span></dt><dt><span class="sect1"><a href="#formatstrings">29. Format Strings</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id458133">29.1. Basic usage</a></span></dt><dt><span class="sect2"><a href="#id458263">29.2. Filters</a></span></dt></dl></dd></dl></div><p>

583

615

While the default configuration (or ``preferences'') make Mutt

584

616

usable right out of the box, it is often desirable to tailor Mutt to

585

617

suit your own tastes. When Mutt is first invoked, it will attempt to

668

700

</pre><p>

669

701

will cause mutt to save outgoing messages to a folder named

670

702

``sent_on_kremvax'' if the environment variable HOSTNAME is set to

671

``kremvax.'' (See <a href="#record" title="3.232. record">$record</a> for

703

``kremvax.'' (See <a href="#record" title="3.239. record">$record</a> for

672

704

details.)

673

705

</p><p>

674

706

Mutt expands the variable when it is assigned, not when it is used. If

678

710

</p><p>

679

711

The commands understood by mutt are explained in the next paragraphs.

680

712

For a complete list, see the <a href="#commands" title="2. Configuration Commands">command reference</a>.

681

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="alias"></a>2. Defining/Using aliases</h2></div></div></div><p>

682

Usage: <code class="literal">alias</code> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>address</em></span> [ , <span class="emphasis"><em>address</em></span>, ... ]

713

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="addrgroup"></a>2. Address groups</h2></div></div></div><p>

714

Usage: <code class="literal">group</code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] [ <code class="literal">-rx</code> <span class="emphasis"><em>EXPR</em></span> [ ... ] ] [ <code class="literal">-addr</code> <span class="emphasis"><em>EXPR</em></span> [ ... ] ]

715

</p><p>

716

<code class="literal">group</code> is used to directly add either addresses or

717

regular expressions to the specified group or groups. The different

718

categories of arguments to the <code class="literal">group</code> command can be

719

in any order. The flags <code class="literal">-rx</code> and

720

<code class="literal">-addr</code> specify what the following strings (that cannot

721

begin with a hyphen) should be interpreted as: either a regular

722

expression or an email address, respectively.

723

</p><p>

724

These address groups can also be created implicitely by the

725

<a href="#alias" title="3. Defining/Using aliases">alias</a>, <a href="#lists" title="11. Mailing lists">lists</a>,

726

<a href="#lists" title="11. Mailing lists">subscribe</a> and

727

<a href="#alternates" title="10. Alternative addresses">alternates</a> commands by specifying the

728

optional <code class="literal">-group</code> option.

729

</p><p>

730

Once defined, these address groups can be used in

731

<a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a> to search for and limit the

732

display to messages matching a group.

733

</p><p>

734

Usage: <code class="literal">ungroup</code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] [ * | [ [ <code class="literal">-rx</code> <span class="emphasis"><em>EXPR</em></span> [ ... ] ] [ <code class="literal">-addr</code> <span class="emphasis"><em>EXPR</em></span> [ ... ] ] ]

735

</p><p>

736

<code class="literal">ungroup</code> is used to remove addresses or regular

737

expressions from the specified group or groups. The syntax is similar to

738

the <code class="literal">group</code> command, however the special character

739

<code class="literal">*</code> can be used to empty a group of all of its

740

contents.

741

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="alias"></a>3. Defining/Using aliases</h2></div></div></div><p>

742

Usage: <code class="literal">alias</code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>address</em></span> [ , <span class="emphasis"><em>address</em></span>, ... ]

683

743

</p><p>

684

744

It's usually very cumbersome to remember or type out the address of someone

685

745

you are communicating with. Mutt allows you to create ``aliases'' which map

686

746

a short string to a full address.

687

747

</p><p>

688

<span class="bold"><strong>Note:</strong></span> if you want to create an alias for a group (by specifying more than

689

one address), you <span class="bold"><strong>must</strong></span> separate the addresses with a comma (``,'').

748

<span class="bold"><strong>Note:</strong></span> if you want to create an alias for more than

749

one address, you <span class="bold"><strong>must</strong></span> separate the addresses with a comma (``,'').

750

</p><p>

751

The optional <code class="literal">-group</code> argument to

752

<code class="literal">alias</code> causes the aliased address(es) to be added to

753

the named <span class="emphasis"><em>group</em></span>.

690

754

</p><p>

691

755

To remove an alias or aliases (``*'' means all aliases):

692

756

</p><p>

701

765

</p><p>

702

766

Unlike other mailers, Mutt doesn't require aliases to be defined

703

767

in a special file. The <code class="literal">alias</code> command can appear anywhere in

704

a configuration file, as long as this file is <a href="#source" title="26. Reading initialization commands from another file">sourced</a>. Consequently, you can have multiple alias files, or

768

a configuration file, as long as this file is <a href="#source" title="27. Reading initialization commands from another file">sourced</a>. Consequently, you can have multiple alias files, or

705

769

you can have all aliases defined in your muttrc.

706

770

</p><p>

707

771

On the other hand, the <a href="#create-alias">create-alias</a>

708

772

function can use only one file, the one pointed to by the <a href="#alias-file" title="3.3. alias_file">$alias_file</a> variable (which is

709

773

<code class="literal">˜/.muttrc</code> by default). This file is not special either,

710

774

in the sense that Mutt will happily append aliases to any file, but in

711

order for the new aliases to take effect you need to explicitly <a href="#source" title="26. Reading initialization commands from another file">source</a> this file too.

775

order for the new aliases to take effect you need to explicitly <a href="#source" title="27. Reading initialization commands from another file">source</a> this file too.

712

776

</p><p>

713

777

For example:

714

778

</p><p>

723

787

To use aliases, you merely use the alias at any place in mutt where mutt

724

788

prompts for addresses, such as the <span class="emphasis"><em>To:</em></span> or <span class="emphasis"><em>Cc:</em></span> prompt. You can

725

789

also enter aliases in your editor at the appropriate headers if you have the

726

<a href="#edit-headers" title="3.46. edit_headers">$edit_headers</a> variable set.

790

<a href="#edit-headers" title="3.50. edit_headers">$edit_headers</a> variable set.

727

791

</p><p>

728

792

In addition, at the various address prompts, you can use the tab character

729

793

to expand a partial alias to the full alias. If there are multiple matches,

735

799

In the alias menu, you can select as many aliases as you want with the

736

800

<span class="emphasis"><em>select-entry</em></span> key (default: RET), and use the <span class="emphasis"><em>exit</em></span> key

737

801

(default: q) to return to the address prompt.

738

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="bind"></a>3. Changing the default key bindings</h2></div></div></div><p>

802

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="bind"></a>4. Changing the default key bindings</h2></div></div></div><p>

739

803

Usage: <code class="literal">bind</code> <span class="emphasis"><em>map</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>function</em></span>

740

804

</p><p>

741

805

This command allows you to change the default key bindings (operation

785

849

ignored, so that <span class="emphasis"><em>\CA</em></span>, <span class="emphasis"><em>\Ca</em></span>, <span class="emphasis"><em>\cA</em></span> and <span class="emphasis"><em>\ca</em></span> are all

786

850

equivalent. An alternative form is to specify the key as a three digit

787

851

octal number prefixed with a ``\'' (for example <span class="emphasis"><em>\177</em></span> is

788

equivalent to <span class="emphasis"><em>\c?</em></span>).

789

</p><p>

790

In addition, <span class="emphasis"><em>key</em></span> may consist of:

852

equivalent to <span class="emphasis"><em>\c?</em></span>). In addition, <span class="emphasis"><em>key</em></span> may

853

be a symbolic name as shown in <a href="#tab-key-names" title="Table 3.1. Symbolic key names">Table 3.1, “Symbolic key names”</a>.

791

854

</p><p>

792

855

793

</p><div class="table"><a id="id2879492"></a><p class="title"><b>Table 3.1. Symbolic key names</b></p><table summary="Symbolic key names" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Symbolic name</th><th>Meaning</th></tr></thead><tbody><tr><td>\t</td><td>tab</td></tr><tr><td><tab></td><td>tab</td></tr><tr><td><backtab></td><td>backtab / shift-tab</td></tr><tr><td>\r</td><td>carriage return</td></tr><tr><td>\n</td><td>newline</td></tr><tr><td>\e</td><td>escape</td></tr><tr><td><esc></td><td>escape</td></tr><tr><td><up></td><td>up arrow</td></tr><tr><td><down></td><td>down arrow</td></tr><tr><td><left></td><td>left arrow</td></tr><tr><td><right></td><td>right arrow</td></tr><tr><td><pageup></td><td>Page Up</td></tr><tr><td><pagedown></td><td>Page Down</td></tr><tr><td><backspace></td><td>Backspace</td></tr><tr><td><delete></td><td>Delete</td></tr><tr><td><insert></td><td>Insert</td></tr><tr><td><enter></td><td>Enter</td></tr><tr><td><return></td><td>Return</td></tr><tr><td><home></td><td>Home</td></tr><tr><td><end></td><td>End</td></tr><tr><td><space></td><td>Space bar</td></tr><tr><td><f1></td><td>function key 1</td></tr><tr><td><f10></td><td>function key 10</td></tr></tbody></table></div><p>

856

</p><div class="table"><a id="tab-key-names"></a><p class="title"><b>Table 3.1. Symbolic key names</b></p><div class="table-contents"><table summary="Symbolic key names" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Symbolic name</th><th>Meaning</th></tr></thead><tbody><tr><td>\t</td><td>tab</td></tr><tr><td><tab></td><td>tab</td></tr><tr><td><backtab></td><td>backtab / shift-tab</td></tr><tr><td>\r</td><td>carriage return</td></tr><tr><td>\n</td><td>newline</td></tr><tr><td>\e</td><td>escape</td></tr><tr><td><esc></td><td>escape</td></tr><tr><td><up></td><td>up arrow</td></tr><tr><td><down></td><td>down arrow</td></tr><tr><td><left></td><td>left arrow</td></tr><tr><td><right></td><td>right arrow</td></tr><tr><td><pageup></td><td>Page Up</td></tr><tr><td><pagedown></td><td>Page Down</td></tr><tr><td><backspace></td><td>Backspace</td></tr><tr><td><delete></td><td>Delete</td></tr><tr><td><insert></td><td>Insert</td></tr><tr><td><enter></td><td>Enter</td></tr><tr><td><return></td><td>Return</td></tr><tr><td><home></td><td>Home</td></tr><tr><td><end></td><td>End</td></tr><tr><td><space></td><td>Space bar</td></tr><tr><td><f1></td><td>function key 1</td></tr><tr><td><f10></td><td>function key 10</td></tr></tbody></table></div></div><p><br class="table-break" />

794

857

795

858

</p><p>

796

859

<span class="emphasis"><em>key</em></span> does not need to be enclosed in quotes unless it contains a

799

862

<span class="emphasis"><em>function</em></span> specifies which action to take when <span class="emphasis"><em>key</em></span> is pressed.

800

863

For a complete list of functions, see the <a href="#functions" title="4. Functions">reference</a>. The special function <code class="literal">noop</code> unbinds the specified key

801

864

sequence.

802

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="charset-hook"></a>4. Defining aliases for character sets </h2></div></div></div><p>

865

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="charset-hook"></a>5. Defining aliases for character sets </h2></div></div></div><p>

803

866

</p><div class="literallayout"><p><br />

804

867

Usage: <code class="literal">charset-hook</code> <span class="emphasis"><em>alias</em></span> <span class="emphasis"><em>charset</em></span><br />

805

868

Usage: <code class="literal">iconv-hook</code> <span class="emphasis"><em>charset</em></span> <span class="emphasis"><em>local-charset</em></span><br />

813

876

character set. This is helpful when your systems character

814

877

conversion library insists on using strange, system-specific names

815

878

for character sets.

816

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="folder-hook"></a>5. Setting variables based upon mailbox</h2></div></div></div><p>

879

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="folder-hook"></a>6. Setting variables based upon mailbox</h2></div></div></div><p>

817

880

Usage: <code class="literal">folder-hook</code> [!]<span class="emphasis"><em>regexp</em></span> <span class="emphasis"><em>command</em></span>

818

881

</p><p>

819

882

It is often desirable to change settings based on which mailbox you are

823

886

matches multiple folder-hook's, they are executed in the order given in the

824

887

muttrc.

825

888

</p><p>

826

<span class="bold"><strong>Note:</strong></span> if you use the ``!'' shortcut for <a href="#spoolfile" title="3.265. spoolfile">$spoolfile</a> at the beginning of the pattern, you must place it

889

<span class="bold"><strong>Note:</strong></span> if you use the ``!'' shortcut for <a href="#spoolfile" title="3.276. spoolfile">$spoolfile</a> at the beginning of the pattern, you must place it

827

890

inside of double or single quotes in order to distinguish it from the

828

891

logical <span class="emphasis"><em>not</em></span> operator for the expression.

829

892

</p><p>

846

909

folder-hook . set sort=date-sent

847

910

</pre><p>

848

911

849

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="macro"></a>6. Keyboard macros</h2></div></div></div><p>

912

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="macro"></a>7. Keyboard macros</h2></div></div></div><p>

850

913

Usage: <code class="literal">macro</code> <span class="emphasis"><em>menu</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>sequence</em></span> [ <span class="emphasis"><em>description</em></span> ]

851

914

</p><p>

852

915

Macros are useful when you would like a single key to perform a series of

860

923

commas. Whitespace may not be used in between the menu arguments and the

861

924

commas separating them.

862

925

</p><p>

863

<span class="emphasis"><em>key</em></span> and <span class="emphasis"><em>sequence</em></span> are expanded by the same rules as the <a href="#bind" title="3. Changing the default key bindings">key bindings</a>. There are some additions however. The

926

<span class="emphasis"><em>key</em></span> and <span class="emphasis"><em>sequence</em></span> are expanded by the same rules as the <a href="#bind" title="4. Changing the default key bindings">key bindings</a>. There are some additions however. The

864

927

first is that control characters in <span class="emphasis"><em>sequence</em></span> can also be specified

865

928

as <span class="emphasis"><em>^x</em></span>. In order to get a caret (`^'') you need to use

866

929

<span class="emphasis"><em>^^</em></span>. Secondly, to specify a certain key such as <span class="emphasis"><em>up</em></span>

867

930

or to invoke a function directly, you can use the format

868

931

<span class="emphasis"><em><key name></em></span> and <span class="emphasis"><em><function name></em></span>. For a listing of key

869

names see the section on <a href="#bind" title="3. Changing the default key bindings">key bindings</a>. Functions

932

names see the section on <a href="#bind" title="4. Changing the default key bindings">key bindings</a>. Functions

870

933

are listed in the <a href="#functions" title="4. Functions">reference</a>.

871

934

</p><p>

872

935

The advantage with using function names directly is that the macros will

880

943

</p><p>

881

944

<span class="bold"><strong>Note:</strong></span> Macro definitions (if any) listed in the help screen(s), are

882

945

silently truncated at the screen width, and are not wrapped.

883

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="color"></a>7. Using color and mono video attributes</h2></div></div></div><p>

946

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="color"></a>8. Using color and mono video attributes</h2></div></div></div><p>

884

947

</p><div class="literallayout"><p><br />

885

948

Usage: <code class="literal">color</code> <span class="emphasis"><em>object</em></span> <span class="emphasis"><em>foreground</em></span> <span class="emphasis"><em>background</em></span> [ <span class="emphasis"><em>regexp</em></span> ]<br />

886

949

Usage: <code class="literal">color</code> index <span class="emphasis"><em>foreground</em></span> <span class="emphasis"><em>background</em></span> <span class="emphasis"><em>pattern</em></span><br />

918

981

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

919

982

normal

920

983

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

921

quoted (text matching <a href="#quote-regexp" title="3.227. quote_regexp">$quote_regexp</a> in the body of a message)

984

quoted (text matching <a href="#quote-regexp" title="3.234. quote_regexp">$quote_regexp</a> in the body of a message)

922

985

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

923

986

quoted1, quoted2, ..., quoted<span class="bold"><strong>N</strong></span> (higher levels of quoting)

924

987

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

1017

1080

standout

1018

1081

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

1019

1082

1020

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="ignore"></a>8. Ignoring (weeding) unwanted message headers</h2></div></div></div><p>

1083

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="ignore"></a>9. Ignoring (weeding) unwanted message headers</h2></div></div></div><p>

1021

1084

Usage: <code class="literal">[un]ignore</code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

1022

1085

</p><p>

1023

1086

Messages often have many header fields added by automatic processing systems,

1044

1107

unignore posted-to:

1045

1108

</pre><p>

1046

1109

1047

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="alternates"></a>9. Alternative addresses</h2></div></div></div><p>

1048

Usage: <code class="literal">[un]alternates</code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

1110

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="alternates"></a>10. Alternative addresses</h2></div></div></div><p>

1111

Usage: <code class="literal">[un]alternates</code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

1049

1112

1050

1113

</p><p>

1051

1114

With various functions, mutt will treat messages differently,

1053

1116

someone else. For instance, when replying to a message that you

1054

1117

sent to a different party, mutt will automatically suggest to send

1055

1118

the response to the original message's recipients -- responding to

1056

yourself won't make much sense in many cases. (See <a href="#reply-to" title="3.235. reply_to">$reply_to</a>.)

1119

yourself won't make much sense in many cases. (See <a href="#reply-to" title="3.242. reply_to">$reply_to</a>.)

1057

1120

</p><p>

1058

1121

Many users receive e-mail under a number of different addresses. To

1059

1122

fully use mutt's features here, the program must be able to

1062

1125

expressions, each of which can identify an address under which you

1063

1126

receive e-mail.

1064

1127

</p><p>

1128

As addresses are matched using regular expressions and not exact strict

1129

comparisons, you should make sure you specify your addresses as precise

1130

as possible to avoid mismatches. For example, if you specify:

1131

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

1132

alternates user@example

1133

</pre><p>

1134

mutt will consider ``<code class="literal">some-user@example</code>'' as

1135

being your address, too which may not be desired. As a solution, in such

1136

cases addresses should be specified as:

1137

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

1138

alternates '^user@example$'

1139

</pre><p>

1140

The <code class="literal">-group</code> flag causes all of the subsequent regular expressions

1141

to be added to the named group.

1142

</p><p>

1065

1143

The <code class="literal">unalternates</code> command can be used to write exceptions to

1066

1144

<code class="literal">alternates</code> patterns. If an address matches something in an

1067

1145

<code class="literal">alternates</code> command, but you nonetheless do not think it is

1070

1148

</p><p>

1071

1149

To remove a regular expression from the <code class="literal">alternates</code> list, use the

1072

1150

<code class="literal">unalternates</code> command with exactly the same <span class="emphasis"><em>regexp</em></span>.

1073

Likewise, if the <span class="emphasis"><em>regexp</em></span> for a <code class="literal">alternates</code> command matches

1151

Likewise, if the <span class="emphasis"><em>regexp</em></span> for an <code class="literal">alternates</code> command matches

1074

1152

an entry on the <code class="literal">unalternates</code> list, that <code class="literal">unalternates</code>

1075

1153

entry will be removed. If the <span class="emphasis"><em>regexp</em></span> for <code class="literal">unalternates</code>

1076

1154

is ``*'', <span class="emphasis"><em>all entries</em></span> on <code class="literal">alternates</code> will be removed.

1077

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="lists"></a>10. Mailing lists</h2></div></div></div><p>

1155

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="lists"></a>11. Mailing lists</h2></div></div></div><p>

1078

1156

</p><div class="literallayout"><p><br />

1079

Usage: <code class="literal">[un]lists</code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]<br />

1080

Usage: <code class="literal">[un]subscribe</code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]<br />

1157

Usage: <code class="literal">[un]lists</code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]<br />

1158

Usage: <code class="literal">[un]subscribe</code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]<br />

1081

1159

</p></div><p>

1082

1160

</p><p>

1083

1161

Mutt has a few nice features for <a href="#using-lists" title="8. Handling Mailing Lists">handling mailing lists</a>. In order to take advantage of them, you must

1089

1167

the Mail-Followup-To header is a non-standard extension which is not

1090

1168

supported by all mail user agents. Adding it is not bullet-proof against

1091

1169

receiving personal CCs of list messages. Also note that the generation

1092

of the Mail-Followup-To header is controlled by the <a href="#followup-to" title="3.56. followup_to">$followup_to</a> configuration variable.

1170

of the Mail-Followup-To header is controlled by the <a href="#followup-to" title="3.60. followup_to">$followup_to</a> configuration variable.

1093

1171

</p><p>

1094

1172

More precisely, Mutt maintains lists of patterns for the addresses

1095

1173

of known and subscribed mailing lists. Every subscribed mailing

1114

1192

or ``subscribe ^mutt-users@mutt\\.org$'' to

1115

1193

match only mail from the actual list.

1116

1194

</p><p>

1195

The <code class="literal">-group</code> flag adds all of the subsequent regular expressions

1196

to the named group.

1197

</p><p>

1117

1198

The ``unlists'' command is used to remove a token from the list of

1118

1199

known and subscribed mailing-lists. Use ``unlists *'' to remove all

1119

1200

tokens.

1120

1201

</p><p>

1121

1202

To remove a mailing list from the list of subscribed mailing lists,

1122

1203

but keep it on the list of known mailing lists, use ``unsubscribe''.

1123

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="mbox-hook"></a>11. Using Multiple spool mailboxes</h2></div></div></div><p>

1204

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="mbox-hook"></a>12. Using Multiple spool mailboxes</h2></div></div></div><p>

1124

1205

Usage: <code class="literal">mbox-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

1125

1206

</p><p>

1126

1207

This command is used to move read messages from a specified mailbox to a

1132

1213

Unlike some of the other <span class="emphasis"><em>hook</em></span> commands, only the <span class="emphasis"><em>first</em></span> matching

1133

1214

pattern is used (it is not possible to save read mail in more than a single

1134

1215

mailbox).

1135

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="mailboxes"></a>12. Defining mailboxes which receive mail</h2></div></div></div><p>

1136

Usage: <code class="literal">[un]mailboxes</code> [!]<span class="emphasis"><em>filename</em></span> [ <span class="emphasis"><em>filename</em></span> ... ]

1216

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="mailboxes"></a>13. Monitoring incoming mail</h2></div></div></div><p>

1217

Usage: <code class="literal">[un]mailboxes</code> <span class="emphasis"><em>folder</em></span> [ <span class="emphasis"><em>folder</em></span> ... ]

1137

1218

</p><p>

1138

1219

This command specifies folders which can receive mail and

1139

1220

which will be checked for new messages. By default, the

1140

1221

main menu status bar displays how many of these folders have

1141

1222

new messages.

1142

1223

</p><p>

1224

<code class="literal">folder</code> can either be a local file or directory

1225

(Mbox/Mmdf or Maildir/Mh). If Mutt was built with POP and/or IMAP

1226

support, <code class="literal">folder</code> can also be a POP/IMAP folder

1227

URL. The URL syntax is described in <a href="#url-syntax" title="1.2. URL syntax">Section 1.2, “URL syntax”</a>,

1228

POP and IMAP are described in <a href="#pop" title="3. POP3 Support">Section 3, “POP3 Support”</a> and <a href="#imap" title="4. IMAP Support">Section 4, “IMAP Support”</a>

1229

respectively.

1230

</p><p>

1143

1231

When changing folders, pressing <span class="emphasis"><em>space</em></span> will cycle

1144

1232

through folders with new mail.

1145

1233

</p><p>

1152

1240

of folders which receive mail. Use ``unmailboxes *'' to remove all

1153

1241

tokens.

1154

1242

</p><p>

1155

<span class="bold"><strong>Note:</strong></span> new mail is detected by comparing the last modification time to

1156

the last access time. Utilities like <code class="literal">biff</code> or <code class="literal">frm</code> or any other

1157

program which accesses the mailbox might cause Mutt to never detect new mail

1158

for that mailbox if they do not properly reset the access time. Backup

1159

tools are another common reason for updated access times.

1160

</p><p>

1161

<span class="bold"><strong>Note:</strong></span> the filenames in the <code class="literal">mailboxes</code> command are resolved when

1243

<span class="bold"><strong>Note:</strong></span> the folders in the <code class="literal">mailboxes</code> command are resolved when

1162

1244

the command is executed, so if these names contain <a href="#shortcuts" title="7. Mailbox Shortcuts">shortcut characters</a> (such as ``='' and ``!''), any variable

1163

definition that affect these characters (like <a href="#folder" title="3.54. folder">$folder</a> and <a href="#spoolfile" title="3.265. spoolfile">$spoolfile</a>)

1164

should be executed before the <code class="literal">mailboxes</code> command.

1165

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="my-hdr"></a>13. User defined headers</h2></div></div></div><p>

1245

definition that affect these characters (like <a href="#folder" title="3.58. folder">$folder</a> and <a href="#spoolfile" title="3.276. spoolfile">$spoolfile</a>)

1246

should be executed before the <code class="literal">mailboxes</code> command. If

1247

none of these shorcuts are used, a local path should be absolute as

1248

otherwise mutt tries to find it within the current working directory

1249

from where mutt was started which may not always be desired.

1250

</p><p>

1251

For local folders, new mail is detected by comparing access and/or

1252

modification times of files and folders. The interval in which Mutt

1253

checks for new mail is defined by

1254

<a href="#mail-check" title="3.104. mail_check">$mail_check</a>.

1255

</p><p>

1256

Special care is required with Mbox and Mmdf

1257

folders as Mutt assumes such a folder has new mail if it wasn't

1258

accessed after it was last modified. Utilities like <code class="literal">biff</code> or

1259

<code class="literal">frm</code> or any other program which accesses the mailbox might cause

1260

Mutt to never detect new mail for that mailbox if they do not properly reset the

1261

access time. Backup tools are another common reason for updated access times.

1262

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="my-hdr"></a>14. User defined headers</h2></div></div></div><p>

1166

1263

Usage:

1167

1264

1168

1265

<code class="literal">my_hdr</code> <span class="emphasis"><em>string</em></span>

1184

1281

space is illegal there, so Mutt enforces the rule.

1185

1282

</p><p>

1186

1283

If you would like to add a header field to a single message, you should

1187

either set the <a href="#edit-headers" title="3.46. edit_headers">$edit_headers</a> variable,

1284

either set the <a href="#edit-headers" title="3.50. edit_headers">$edit_headers</a> variable,

1188

1285

or use the <span class="emphasis"><em>edit-headers</em></span> function (default: ``E'') in the send-menu so

1189

1286

that you can edit the header of your message along with the body.

1190

1287

</p><p>

1194

1291

``Cc'' header fields, you could use:

1195

1292

</p><p>

1196

1293

“<span class="quote">unmy_hdr to cc</span>”

1197

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="hdr-order"></a>14. Defining the order of headers when viewing messages</h2></div></div></div><p>

1294

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="hdr-order"></a>15. Defining the order of headers when viewing messages</h2></div></div></div><p>

1198

1295

Usage: <code class="literal">hdr_order</code> <span class="emphasis"><em>header1</em></span> <span class="emphasis"><em>header2</em></span> <span class="emphasis"><em>header3</em></span>

1199

1296

</p><p>

1200

1297

With this command, you can specify an order in which mutt will attempt

1209

1306

hdr_order From Date: From: To: Cc: Subject:

1210

1307

</pre><p>

1211

1308

1212

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="save-hook"></a>15. Specify default save filename</h2></div></div></div><p>

1213

Usage: <code class="literal">save-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>filename</em></span>

1214

</p><p>

1215

This command is used to override the default filename used when saving

1216

messages. <span class="emphasis"><em>filename</em></span> will be used as the default filename if the message is

1217

<span class="emphasis"><em>From:</em></span> an address matching <span class="emphasis"><em>regexp</em></span> or if you are the author and the

1218

message is addressed <span class="emphasis"><em>to:</em></span> something matching <span class="emphasis"><em>regexp</em></span>.

1219

</p><p>

1220

See <a href="#pattern-hook">Message Matching in Hooks</a> for information on the exact format of <span class="emphasis"><em>pattern</em></span>.

1309

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="save-hook"></a>16. Specify default save mailbox</h2></div></div></div><p>

1310

Usage: <code class="literal">save-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

1311

</p><p>

1312

This command is used to override the default mailbox used when saving

1313

messages. <span class="emphasis"><em>mailbox</em></span> will be used as the default if the message

1314

matches <span class="emphasis"><em>pattern</em></span>, see <a href="#pattern-hook">Message Matching in Hooks</a> for information

1315

on the exact format.

1316

</p><p>

1317

To provide more flexibility and good defaults, Mutt applies the

1318

expandos of <a href="#index-format" title="3.100. index_format">$index_format</a> to

1319

<span class="emphasis"><em>mailbox</em></span> after it was expanded.

1221

1320

</p><p>

1222

1321

Examples:

1223

1322

</p><p>

1224

1323

1225

1324

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

1325

# default: save all to ~/Mail/<author name>

1326

save-hook . ~/Mail/%F

1327

# save from me@turing.cs.hmc.edu/me@cs.hmc.edu to $folder/elinks

1226

1328

save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins

1329

# save from aol.com to $folder/spam

1227

1330

save-hook aol\\.com$ +spam

1228

1331

</pre><p>

1229

1332

1230

1333

</p><p>

1231

Also see the <a href="#fcc-save-hook" title="17. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a> command.

1232

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="fcc-hook"></a>16. Specify default Fcc: mailbox when composing</h2></div></div></div><p>

1334

Also see the <a href="#fcc-save-hook" title="18. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a> command.

1335

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="fcc-hook"></a>17. Specify default Fcc: mailbox when composing</h2></div></div></div><p>

1233

1336

Usage: <code class="literal">fcc-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

1234

1337

</p><p>

1235

1338

This command is used to save outgoing mail in a mailbox other than

1236

<a href="#record" title="3.232. record">$record</a>. Mutt searches the initial list of

1339

<a href="#record" title="3.239. record">$record</a>. Mutt searches the initial list of

1237

1340

message recipients for the first matching <span class="emphasis"><em>regexp</em></span> and uses <span class="emphasis"><em>mailbox</em></span>

1238

1341

as the default Fcc: mailbox. If no match is found the message will be saved

1239

to <a href="#record" title="3.232. record">$record</a> mailbox.

1342

to <a href="#record" title="3.239. record">$record</a> mailbox.

1343

</p><p>

1344

To provide more flexibility and good defaults, Mutt applies the

1345

expandos of <a href="#index-format" title="3.100. index_format">$index_format</a> to

1346

<span class="emphasis"><em>mailbox</em></span> after it was expanded.

1240

1347

</p><p>

1241

1348

See <a href="#pattern-hook">Message Matching in Hooks</a> for information on the exact format of <span class="emphasis"><em>pattern</em></span>.

1242

1349

</p><p>

1243

1350

Example: <code class="literal">fcc-hook [@.]aol\\.com$ +spammers</code>

1244

1351

</p><p>

1245

1352

The above will save a copy of all messages going to the aol.com domain to

1246

the `+spammers' mailbox by default. Also see the <a href="#fcc-save-hook" title="17. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a> command.

1247

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="fcc-save-hook"></a>17. Specify default save filename and default Fcc: mailbox at once</h2></div></div></div><p>

1353

the `+spammers' mailbox by default. Also see the <a href="#fcc-save-hook" title="18. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a> command.

1354

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="fcc-save-hook"></a>18. Specify default save filename and default Fcc: mailbox at once</h2></div></div></div><p>

1248

1355

Usage: <code class="literal">fcc-save-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

1249

1356

</p><p>

1250

This command is a shortcut, equivalent to doing both a <a href="#fcc-hook" title="16. Specify default Fcc: mailbox when composing">fcc-hook</a>

1251

and a <a href="#save-hook" title="15. Specify default save filename">save-hook</a> with its arguments.

1252

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="send-hook"></a>18. Change settings based upon message recipients</h2></div></div></div><p>

1357

This command is a shortcut, equivalent to doing both a <a href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a>

1358

and a <a href="#save-hook" title="16. Specify default save mailbox">save-hook</a> with its arguments,

1359

including %-expansion on <span class="emphasis"><em>mailbox</em></span> according

1360

to <a href="#index-format" title="3.100. index_format">$index_format</a>.

1361

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="send-hook"></a>19. Change settings based upon message recipients</h2></div></div></div><p>

1253

1362

</p><div class="literallayout"><p><br />

1254

1363

Usage: <code class="literal">reply-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span><br />

1255

1364

Usage: <code class="literal">send-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span><br />

1270

1379

<code class="literal">send2-hook</code> is matched every time a message is changed, either

1271

1380

by editing it, or by using the compose menu to change its recipients

1272

1381

or subject. <code class="literal">send2-hook</code> is executed after <code class="literal">send-hook</code>, and

1273

can, e.g., be used to set parameters such as the <a href="#sendmail" title="3.249. sendmail">$sendmail</a> variable depending on the message's sender

1382

can, e.g., be used to set parameters such as the <a href="#sendmail" title="3.257. sendmail">$sendmail</a> variable depending on the message's sender

1274

1383

address.

1275

1384

</p><p>

1276

1385

For each type of <code class="literal">send-hook</code> or <code class="literal">reply-hook</code>, when multiple matches

1282

1391

Example: <code class="literal">send-hook mutt "set mime_forward signature=''"</code>

1283

1392

</p><p>

1284

1393

Another typical use for this command is to change the values of the

1285

<a href="#attribution" title="3.14. attribution">$attribution</a>, <a href="#signature" title="3.254. signature">$signature</a> and <a href="#locale" title="3.98. locale">$locale</a>

1394

<a href="#attribution" title="3.16. attribution">$attribution</a>, <a href="#signature" title="3.262. signature">$signature</a> and <a href="#locale" title="3.103. locale">$locale</a>

1286

1395

variables in order to change the language of the attributions and

1287

1396

signatures based upon the recipients.

1288

1397

</p><p>

1292

1401

my_hdr commands which modify recipient headers, or the message's

1293

1402

subject, don't have any effect on the current message when executed

1294

1403

from a send-hook.

1295

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="message-hook"></a>19. Change settings before formatting a message</h2></div></div></div><p>

1404

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="message-hook"></a>20. Change settings before formatting a message</h2></div></div></div><p>

1296

1405

Usage: <code class="literal">message-hook</code> [!]<span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

1297

1406

</p><p>

1298

1407

This command can be used to execute arbitrary configuration commands

1311

1420

message-hook '~f freshmeat-news' 'set pager="less \"+/^ subject: .*\""'

1312

1421

</pre><p>

1313

1422

1314

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="crypt-hook"></a>20. Choosing the cryptographic key of the recipient</h2></div></div></div><p>

1423

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="crypt-hook"></a>21. Choosing the cryptographic key of the recipient</h2></div></div></div><p>

1315

1424

Usage: <code class="literal">crypt-hook</code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>keyid</em></span>

1316

1425

</p><p>

1317

1426

When encrypting messages with PGP or OpenSSL, you may want to associate a certain

1325

1434

The meaning of "key id" is to be taken broadly in this context: You

1326

1435

can either put a numerical key ID here, an e-mail address, or even

1327

1436

just a real name.

1328

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="push"></a>21. Adding key sequences to the keyboard buffer</h2></div></div></div><p>

1437

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="push"></a>22. Adding key sequences to the keyboard buffer</h2></div></div></div><p>

1329

1438

Usage: <code class="literal">push</code> <span class="emphasis"><em>string</em></span>

1330

1439

</p><p>

1331

1440

This command adds the named string to the keyboard buffer. The string may

1332

1441

contain control characters, key names and function names like the sequence

1333

string in the <a href="#macro" title="6. Keyboard macros">macro</a> command. You may use it to

1442

string in the <a href="#macro" title="7. Keyboard macros">macro</a> command. You may use it to

1334

1443

automatically run a sequence of commands at startup, or when entering

1335

1444

certain folders. For example, the following command will automatically

1336

1445

collapse all threads when entering a folder:

1338

1447

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

1339

1448

folder-hook . 'push <collapse-all>'

1340

1449

</pre><p>

1341

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exec"></a>22. Executing functions</h2></div></div></div><p>

1450

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exec"></a>23. Executing functions</h2></div></div></div><p>

1342

1451

Usage: <code class="literal">exec</code> <span class="emphasis"><em>function</em></span> [ <span class="emphasis"><em>function</em></span> ... ]

1343

1452

</p><p>

1344

1453

This command can be used to execute any function. Functions are

1345

1454

listed in the <a href="#functions" title="4. Functions">function reference</a>.

1346

1455

``exec function'' is equivalent to ``push <function>''.

1347

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="score-command"></a>23. Message Scoring</h2></div></div></div><p>

1456

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="score-command"></a>24. Message Scoring</h2></div></div></div><p>

1348

1457

</p><div class="literallayout"><p><br />

1349

1458

Usage: <code class="literal">score</code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>value</em></span><br />

1350

1459

Usage: <code class="literal">unscore</code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]<br />

1351

1460

</p></div><p>

1352

1461

</p><p>

1353

1462

The <code class="literal">score</code> commands adds <span class="emphasis"><em>value</em></span> to a message's score if <span class="emphasis"><em>pattern</em></span>

1354

matches it. <span class="emphasis"><em>pattern</em></span> is a string in the format described in the <a href="#patterns" title="2. Patterns">patterns</a> section (note: For efficiency reasons, patterns

1463

matches it. <span class="emphasis"><em>pattern</em></span> is a string in the format described in the <a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a> section (note: For efficiency reasons, patterns

1355

1464

which scan information not available in the index, such as <code class="literal">˜b</code>,

1356

1465

<code class="literal">˜B</code> or <code class="literal">˜h</code>, may not be used). <span class="emphasis"><em>value</em></span> is a

1357

1466

positive or negative integer. A message's final score is the sum total of all

1363

1472

specify the same pattern specified in the <code class="literal">score</code> command for it to be

1364

1473

removed. The pattern ``*'' is a special token which means to clear the list

1365

1474

of all score entries.

1366

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="spam"></a>24. Spam detection</h2></div></div></div><p>

1475

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="spam"></a>25. Spam detection</h2></div></div></div><p>

1367

1476

</p><div class="literallayout"><p><br />

1368

1477

Usage: <code class="literal">spam</code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>format</em></span><br />

1369

1478

Usage: <code class="literal">nospam</code> <span class="emphasis"><em>pattern</em></span><br />

1374

1483

commands, you can <span class="emphasis"><em>limit</em></span>, <span class="emphasis"><em>search</em></span>, and <span class="emphasis"><em>sort</em></span> your

1375

1484

mail based on its spam attributes, as determined by the external

1376

1485

filter. You also can display the spam attributes in your index

1377

display using the <code class="literal">%H</code> selector in the <a href="#index-format" title="3.95. index_format">$index_format</a> variable. (Tip: try <code class="literal">%?H?[%H] ?</code>

1486

display using the <code class="literal">%H</code> selector in the <a href="#index-format" title="3.100. index_format">$index_format</a> variable. (Tip: try <code class="literal">%?H?[%H] ?</code>

1378

1487

to display spam tags only when they are defined for a given message.)

1379

1488

</p><p>

1380

1489

Your first step is to define your external filter's spam patterns using

1465

1574

spam "^From: .*MAILER-DAEMON" "999"

1466

1575

</pre><p>

1467

1576

1468

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="set"></a>25. Setting and Querying Variables</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="set-commands"></a>25.1. Commands</h3></div></div></div><p>

1577

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="set"></a>26. Setting and Querying Variables</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="set-commands"></a>26.1. Commands</h3></div></div></div><p>

1469

1578

The following commands are available to manipulate and query variables:

1470

1579

</p><p>

1471

1580

</p><div class="literallayout"><p><br />

1525

1634

</p><p>

1526

1635

With the <code class="literal">reset</code> command there exists the special variable ``all'',

1527

1636

which allows you to reset all variables to their system defaults.

1528

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="set-myvar"></a>25.2. User-defined variables</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="set-myvar-intro"></a>25.2.1. Introduction</h4></div></div></div><p>

1637

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="set-myvar"></a>26.2. User-defined variables</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="set-myvar-intro"></a>26.2.1. Introduction</h4></div></div></div><p>

1529

1638

Along with the variables listed in the

1530

1639

<a href="#variables" title="3. Configuration variables">Configuration variables</a> section, mutt

1531

1640

supports user-defined variables with names starting

1541

1650

environment variables are (except for

1542

1651

the <a href="#shell-escape">shell-escape</a> command), this

1543

1652

feature can be used to make configuration files more readable.

1544

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="set-myvar-examples"></a>25.2.2. Examples</h4></div></div></div><p>

1653

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="set-myvar-examples"></a>26.2.2. Examples</h4></div></div></div><p>

1545

1654

The following example defines and uses the variable <code class="literal">my_cfgdir</code>

1546

to abbreviate the calls of the <a href="#source" title="26. Reading initialization commands from another file">source</a> command:

1655

to abbreviate the calls of the <a href="#source" title="27. Reading initialization commands from another file">source</a> command:

1547

1656

</p><p>

1548

1657

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

1549

1658

set my_cfgdir = $HOME/mutt/config

1555

1664

</p><p>

1556

1665

A custom variable can also be used in macros to backup the current value

1557

1666

of another variable. In the following example, the value of the

1558

<a href="#delete" title="3.38. delete">$delete</a> is changed temporarily

1667

<a href="#delete" title="3.42. delete">$delete</a> is changed temporarily

1559

1668

while its original value is saved as <code class="literal">my_delete</code>.

1560

After the macro has executed all commands, the original value of <a href="#delete" title="3.38. delete">$delete</a> is restored.

1669

After the macro has executed all commands, the original value of <a href="#delete" title="3.42. delete">$delete</a> is restored.

1561

1670

</p><p>

1562

1671

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

1563

1672

macro pager ,x '\

1589

1698

between <code class="literal"><enter-command></code> and

1590

1699

the <code class="literal">set</code> configuration command, preventing mutt from

1591

1700

recording the macro's commands into its history.

1592

</p></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="source"></a>26. Reading initialization commands from another file</h2></div></div></div><p>

1701

</p></div></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="source"></a>27. Reading initialization commands from another file</h2></div></div></div><p>

1593

1702

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

1594

1703

</p><p>

1595

1704

This command allows the inclusion of initialization commands

1603

1712

If the filename ends with a vertical bar (|), then <span class="emphasis"><em>filename</em></span> is

1604

1713

considered to be an executable program from which to read input (eg.

1605

1714

<code class="literal">source ˜/bin/myscript|</code>).

1606

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="unhook"></a>27. Removing hooks</h2></div></div></div><p>

1715

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="unhook"></a>28. Removing hooks</h2></div></div></div><p>

1607

1716

Usage: <code class="literal">unhook</code> [ * | <span class="emphasis"><em>hook-type</em></span> ]

1608

1717

</p><p>

1609

1718

This command permits you to flush hooks you have previously defined.

1610

1719

You can either remove all hooks by giving the ``*'' character as an

1611

1720

argument, or you can remove all hooks of a specific type by saying

1612

1721

something like <code class="literal">unhook send-hook</code>.

1613

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="advancedusage"></a>Chapter 4. Advanced Usage</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#regexp">1. Regular Expressions</a></span></dt><dt><span class="sect1"><a href="#patterns">2. Patterns</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2884333">2.1. Pattern Modifier</a></span></dt><dt><span class="sect2"><a href="#id2884357">2.2. Complex Patterns</a></span></dt><dt><span class="sect2"><a href="#id2884490">2.3. Searching by Date</a></span></dt></dl></dd><dt><span class="sect1"><a href="#tags">3. Using Tags</a></span></dt><dt><span class="sect1"><a href="#hooks">4. Using Hooks</a></span></dt><dd><dl><dt><span class="sect2"><a href="#pattern-hook">4.1. Message Matching in Hooks</a></span></dt></dl></dd><dt><span class="sect1"><a href="#query">5. External Address Queries</a></span></dt><dt><span class="sect1"><a href="#mailbox-formats">6. Mailbox Formats</a></span></dt><dt><span class="sect1"><a href="#shortcuts">7. Mailbox Shortcuts</a></span></dt><dt><span class="sect1"><a href="#using-lists">8. Handling Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#editing-threads">9. Editing threads</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2885762">9.1. Linking threads</a></span></dt><dt><span class="sect2"><a href="#id2885791">9.2. Breaking threads</a></span></dt></dl></dd><dt><span class="sect1"><a href="#dsn">10. Delivery Status Notification (DSN) Support</a></span></dt><dt><span class="sect1"><a href="#pop">11. POP3 Support (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="#imap">12. IMAP Support (OPTIONAL)</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2886159">12.1. The Folder Browser</a></span></dt><dt><span class="sect2"><a href="#id2886281">12.2. Authentication</a></span></dt></dl></dd><dt><span class="sect1"><a href="#account-hook">13. Managing multiple IMAP/POP accounts (OPTIONAL)</a></span></dt><dt><span class="sect1"><a href="#urlview">14. Start a WWW Browser on URLs (EXTERNAL)</a></span></dt><dt><span class="sect1"><a href="#caching">15. Local caching (OPTIONAL)</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2886490">15.1. Header caching</a></span></dt><dt><span class="sect2"><a href="#id2886568">15.2. Body caching</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="regexp"></a>1. Regular Expressions</h2></div></div></div><p>

1722

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="formatstrings"></a>29. Format Strings</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id458133"></a>29.1. Basic usage</h3></div></div></div><p>

1723

Format strings are a general concept you'll find in several locations

1724

through the mutt configuration, especially in the

1725

<a href="#index-format" title="3.100. index_format">$index_format"</a>,

1726

<a href="#pager-format" title="3.139. pager_format">$pager_format"</a>,

1727

<a href="#status-format" title="3.278. status_format">$status_format"</a>,

1728

and other ``*_format'' variables. These can be very straightforward,

1729

and it's quite possible you already know how to use them.

1730

</p><p>

1731

The most basic format string element is a percent symbol followed

1732

by another character. For example, <code class="literal">%s</code>

1733

represents a message's Subject: header in the <a href="#index-format" title="3.100. index_format">$index_format"</a> variable. The

1734

``expandos'' available are documented with each format variable, but

1735

there are general modifiers available with all formatting expandos,

1736

too. Those are our concern here.

1737

</p><p>

1738

Some of the modifers are borrowed right out of C (though you might

1739

know them from Perl, Python, shell, or another langugage). These are

1740

the [-]m.n modifiers, as in <code class="literal">%-12.12s</code>. As with

1741

such programming languages, these modifiers allow you to specify the

1742

minumum and maximum size of the resulting string, as well as its

1743

justification. If the ``-'' sign follows the percent, the string will

1744

be left-justified instead of right-justified. If there's a number

1745

immediately following that, it's the minimum amount of space the

1746

formatted string will occupy -- if it's naturally smaller than that, it

1747

will be padded out with spaces. If a decimal point and another number

1748

follow, that's the maximum space allowable -- the string will not be

1749

permitted to exceed that width, no matter its natural size. Each of

1750

these three elements is optional, so that all these are legal format

1751

strings:

1752

1753

1754

1755

1756

</p><p>

1757

Mutt adds some other modifiers to format strings. If you use an equals

1758

symbol (<code class="literal">=</code>) as a numeric prefix (like the minus

1759

above), it will force the string to be centered within its minimum

1760

space range. For example, <code class="literal">%=14y</code> will reserve 14

1761

characters for the %y expansion -- that's the X-Label: header, in

1762

<code class="literal">$index_format</code>. If the expansion

1763

results in a string less than 14 characters, it will be centered in a

1764

14-character space. If the X-Label for a message were "test", that

1765

expansion would look like `` test ''.

1766

</p><p>

1767

There are two very little-known modifiers that affect the way that an

1768

expando is replaced. If there is an underline (``_'') character

1769

between any format modifiers (as above) and the expando letter, it will

1770

expands in all lower case. And if you use a colon (``:''), it will

1771

replace all decimal points with underlines.

1772

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id458263"></a>29.2. Filters</h3></div></div></div><p>

1773

Any format string ending in a vertical bar (``|'') will be

1774

expanded and piped through the first word in the string, using spaces

1775

as separator. The string returned will be used for display.

1776

If the returned string ends in %, it will be passed through

1777

the formatter a second time. This allows the filter to generate a

1778

replacement format string including % expandos.

1779

</p><p>

1780

All % expandos in a format string are expanded before the script

1781

is called so that:

1782

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

1783

set status_format="script.sh '%r %f (%L)'|"

1784

</pre><p>

1785

will make mutt expand <code class="literal">%r</code>,

1786

1787

before calling the script. The example also shows that arguments can be

1788

quoted: the script will receive the expanded string between the single quotes

1789

as the only argument.

1790

</p><p>

1791

A practical example is the <code class="literal">mutt_xtitle</code>

1792

script installed in the <code class="literal">samples</code>

1793

subdirectory of the mutt documentation: it can be used as filter for

1794

<code class="literal">$status_format</code> to set the current

1795

terminal's title, if supported.

1796

</p></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="advancedusage"></a>Chapter 4. Advanced Usage</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#regexp">1. Regular Expressions</a></span></dt><dt><span class="sect1"><a href="#patterns">2. Patterns: Searching, Limiting and Tagging</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id459463">2.1. Pattern Modifier</a></span></dt><dt><span class="sect2"><a href="#id459491">2.2. Simple Patterns</a></span></dt><dt><span class="sect2"><a href="#id459655">2.3. Complex Patterns</a></span></dt><dt><span class="sect2"><a href="#id459787">2.4. Searching by Date</a></span></dt></dl></dd><dt><span class="sect1"><a href="#tags">3. Using Tags</a></span></dt><dt><span class="sect1"><a href="#hooks">4. Using Hooks</a></span></dt><dd><dl><dt><span class="sect2"><a href="#pattern-hook">4.1. Message Matching in Hooks</a></span></dt></dl></dd><dt><span class="sect1"><a href="#query">5. External Address Queries</a></span></dt><dt><span class="sect1"><a href="#mailbox-formats">6. Mailbox Formats</a></span></dt><dt><span class="sect1"><a href="#shortcuts">7. Mailbox Shortcuts</a></span></dt><dt><span class="sect1"><a href="#using-lists">8. Handling Mailing Lists</a></span></dt><dt><span class="sect1"><a href="#editing-threads">9. Editing threads</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id460955">9.1. Linking threads</a></span></dt><dt><span class="sect2"><a href="#id460970">9.2. Breaking threads</a></span></dt></dl></dd><dt><span class="sect1"><a href="#dsn">10. Delivery Status Notification (DSN) Support</a></span></dt><dt><span class="sect1"><a href="#urlview">11. Start a WWW Browser on URLs (EXTERNAL)</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="regexp"></a>1. Regular Expressions</h2></div></div></div><p>

1614

1797

All string patterns in Mutt including those in more complex

1615

<a href="#patterns" title="2. Patterns">patterns</a> must be specified

1798

<a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a> must be specified

1616

1799

using regular expressions (regexp) in the ``POSIX extended'' syntax (which

1617

1800

is more or less the syntax used by egrep and GNU awk). For your

1618

1801

convenience, we have included below a brief description of this syntax.

1767

1950

</p><p>

1768

1951

Please note however that these operators are not defined by POSIX, so

1769

1952

they may or may not be available in stock libraries on various systems.

1770

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="patterns"></a>2. Patterns</h2></div></div></div><p>

1953

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="patterns"></a>2. Patterns: Searching, Limiting and Tagging</h2></div></div></div><p>

1771

1954

Many of Mutt's commands allow you to specify a pattern to match

1772

(limit, tag-pattern, delete-pattern, etc.). There are several ways to select

1773

messages:

1955

(limit, tag-pattern, delete-pattern, etc.). <a href="#tab-patterns" title="Table 4.1. Pattern modifiers">Table 4.1, “Pattern modifiers”</a>

1956

shows several ways to select messages.

1774

1957

</p><p>

1775

1958

1776

</p><div class="table"><a id="id2883928"></a><p class="title"><b>Table 4.1. Pattern modifiers</b></p><table summary="Pattern modifiers" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Pattern modifier</th><th>Description</th></tr></thead><tbody><tr><td>~A</td><td>all messages</td></tr><tr><td>~b EXPR</td><td>messages which contain EXPR in the message body</td></tr><tr><td>~B EXPR</td><td>messages which contain EXPR in the whole message</td></tr><tr><td>~c EXPR</td><td>messages carbon-copied to EXPR</td></tr><tr><td>~C EXPR</td><td>message is either to: or cc: EXPR</td></tr><tr><td>~d [MIN]-[MAX]</td><td>messages with ``date-sent'' in a Date range</td></tr><tr><td>~D</td><td>deleted messages</td></tr><tr><td>~e EXPR</td><td>message which contains EXPR in the ``Sender'' field</td></tr><tr><td>~E</td><td>expired messages</td></tr><tr><td>~F</td><td>flagged messages</td></tr><tr><td>~f EXPR</td><td>messages originating from EXPR</td></tr><tr><td>~g</td><td>cryptographically signed messages</td></tr><tr><td>~G</td><td>cryptographically encrypted messages</td></tr><tr><td>~h EXPR</td><td>messages which contain EXPR in the message header</td></tr><tr><td>~H EXPR</td><td>messages with a spam attribute matching EXPR</td></tr><tr><td>~i EXPR</td><td>message which match EXPR in the ``Message-ID'' field</td></tr><tr><td>~k</td><td>message contains PGP key material</td></tr><tr><td>~L EXPR</td><td>message is either originated or received by EXPR</td></tr><tr><td>~l</td><td>message is addressed to a known mailing list</td></tr><tr><td>~m [MIN]-[MAX]</td><td>message in the range MIN to MAX *)</td></tr><tr><td>~n [MIN]-[MAX]</td><td>messages with a score in the range MIN to MAX *)</td></tr><tr><td>~N</td><td>new messages</td></tr><tr><td>~O</td><td>old messages</td></tr><tr><td>~p</td><td>message is addressed to you (consults alternates)</td></tr><tr><td>~P</td><td>message is from you (consults alternates)</td></tr><tr><td>~Q</td><td>messages which have been replied to</td></tr><tr><td>~r [MIN]-[MAX]</td><td>messages with ``date-received'' in a Date range</td></tr><tr><td>~R</td><td>read messages</td></tr><tr><td>~s EXPR</td><td>messages having EXPR in the ``Subject'' field.</td></tr><tr><td>~S</td><td>superseded messages</td></tr><tr><td>~t EXPR</td><td>messages addressed to EXPR</td></tr><tr><td>~T</td><td>tagged messages</td></tr><tr><td>~u</td><td>message is addressed to a subscribed mailing list</td></tr><tr><td>~U</td><td>unread messages</td></tr><tr><td>~v</td><td>message is part of a collapsed thread.</td></tr><tr><td>~V</td><td>cryptographically verified messages</td></tr><tr><td>~x EXPR</td><td>messages which contain EXPR in the `References' field</td></tr><tr><td>~X [MIN]-[MAX]</td><td>messages with MIN to MAX attachments *)</td></tr><tr><td>~y EXPR</td><td>messages which contain EXPR in the `X-Label' field</td></tr><tr><td>~z [MIN]-[MAX]</td><td>messages with a size in the range MIN to MAX *)</td></tr><tr><td>~=</td><td>duplicated messages (see $duplicate_threads)</td></tr><tr><td>~$</td><td>unreferenced messages (requires threaded view)</td></tr><tr><td>~(PATTERN)</td><td>messages in threads

1959

</p><div class="table"><a id="tab-patterns"></a><p class="title"><b>Table 4.1. Pattern modifiers</b></p><div class="table-contents"><table summary="Pattern modifiers" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Pattern modifier</th><th>Description</th></tr></thead><tbody><tr><td>~A</td><td>all messages</td></tr><tr><td>~b EXPR</td><td>messages which contain EXPR in the message body</td></tr><tr><td>=b STRING</td><td>messages which contain STRING in the message body. If IMAP is enabled, searches for STRING on the server, rather than downloading each message and searching it locally.</td></tr><tr><td>~B EXPR</td><td>messages which contain EXPR in the whole message</td></tr><tr><td>~c EXPR</td><td>messages carbon-copied to EXPR</td></tr><tr><td>%c GROUP</td><td>messages carbon-copied to any member of GROUP</td></tr><tr><td>~C EXPR</td><td>message is either to: or cc: EXPR</td></tr><tr><td>%C GROUP</td><td>message is either to: or cc: to any member of GROUP</td></tr><tr><td>~d [MIN]-[MAX]</td><td>messages with ``date-sent'' in a Date range</td></tr><tr><td>~D</td><td>deleted messages</td></tr><tr><td>~e EXPR</td><td>message which contains EXPR in the ``Sender'' field</td></tr><tr><td>%e GROUP</td><td>message which contain a member of GROUP in the ``Sender'' field</td></tr><tr><td>~E</td><td>expired messages</td></tr><tr><td>~F</td><td>flagged messages</td></tr><tr><td>~f EXPR</td><td>messages originating from EXPR</td></tr><tr><td>%f GROUP</td><td>messages originating from any member of GROUP</td></tr><tr><td>~g</td><td>cryptographically signed messages</td></tr><tr><td>~G</td><td>cryptographically encrypted messages</td></tr><tr><td>~h EXPR</td><td>messages which contain EXPR in the message header</td></tr><tr><td>~H EXPR</td><td>messages with a spam attribute matching EXPR</td></tr><tr><td>~i EXPR</td><td>message which match EXPR in the ``Message-ID'' field</td></tr><tr><td>~k</td><td>message contains PGP key material</td></tr><tr><td>~L EXPR</td><td>message is either originated or received by EXPR</td></tr><tr><td>%L GROUP</td><td>message is either originated or received by any member of GROUP</td></tr><tr><td>~l</td><td>message is addressed to a known mailing list</td></tr><tr><td>~m [MIN]-[MAX]</td><td>message in the range MIN to MAX *)</td></tr><tr><td>~n [MIN]-[MAX]</td><td>messages with a score in the range MIN to MAX *)</td></tr><tr><td>~N</td><td>new messages</td></tr><tr><td>~O</td><td>old messages</td></tr><tr><td>~p</td><td>message is addressed to you (consults alternates)</td></tr><tr><td>~P</td><td>message is from you (consults alternates)</td></tr><tr><td>~Q</td><td>messages which have been replied to</td></tr><tr><td>~r [MIN]-[MAX]</td><td>messages with ``date-received'' in a Date range</td></tr><tr><td>~R</td><td>read messages</td></tr><tr><td>~s EXPR</td><td>messages having EXPR in the ``Subject'' field.</td></tr><tr><td>~S</td><td>superseded messages</td></tr><tr><td>~t EXPR</td><td>messages addressed to EXPR</td></tr><tr><td>~T</td><td>tagged messages</td></tr><tr><td>~u</td><td>message is addressed to a subscribed mailing list</td></tr><tr><td>~U</td><td>unread messages</td></tr><tr><td>~v</td><td>message is part of a collapsed thread.</td></tr><tr><td>~V</td><td>cryptographically verified messages</td></tr><tr><td>~x EXPR</td><td>messages which contain EXPR in the `References' field</td></tr><tr><td>~X [MIN]-[MAX]</td><td>messages with MIN to MAX attachments *)</td></tr><tr><td>~y EXPR</td><td>messages which contain EXPR in the `X-Label' field</td></tr><tr><td>~z [MIN]-[MAX]</td><td>messages with a size in the range MIN to MAX *)</td></tr><tr><td>~=</td><td>duplicated messages (see $duplicate_threads)</td></tr><tr><td>~$</td><td>unreferenced messages (requires threaded view)</td></tr><tr><td>~(PATTERN)</td><td>messages in threads

1777

1960

containing messages matching a certain pattern, e.g. all

1778

threads containing messages from you: ~(~P)</td></tr></tbody></table></div><p>

1961

threads containing messages from you: ~(~P)</td></tr></tbody></table></div></div><p><br class="table-break" />

1779

1962

1780

1963

</p><p>

1781

1964

Where EXPR is a

1799

1982

*) The forms <code class="literal"><[MAX]</code>, <code class="literal">>[MIN]</code>,

1800

1983

1801

1984

are allowed, too.

1802

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2884333"></a>2.1. Pattern Modifier</h3></div></div></div><p>

1985

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id459463"></a>2.1. Pattern Modifier</h3></div></div></div><p>

1803

1986

Note that patterns matching 'lists' of addresses (notably c,C,p,P and t)

1804

1987

match if there is at least one match in the whole list. If you want to

1805

1988

make sure that all elements of that list match, you need to prefix your

1811

1994

^~C \.de$

1812

1995

</pre><p>

1813

1996

1814

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2884357"></a>2.2. Complex Patterns</h3></div></div></div><p>

1997

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id459491"></a>2.2. Simple Patterns</h3></div></div></div><p>

1998

Mutt supports two versions of so called ``simple searches'' which are

1999

issued if the query entered for searching, limiting and similar

2000

operations does not seem to be a valid pattern (i.e. it does not contain

2001

one of these characters: ``~'', ``='' or ``%''). If the query is

2002

supposed to contain one of these special characters, they must be escaped

2003

by prepending a backslash (``\'').

2004

</p><p>

2005

The first type is by checking whether the query string equals

2006

a keyword case-insensitively from <a href="#tab-simplesearch-keywords" title="Table 4.2. Simple search keywords">Table 4.2, “Simple search keywords”</a>:

2007

If that is the case, Mutt will use the shown pattern modifier instead.

2008

If a keyword would conflict with your search keyword, you need to turn

2009

it into a regular expression to avoid matching the keyword table. For

2010

example, if you want to find all messages matching ``<code class="literal">flag</code>''

2011

(using <a href="#simple-search" title="3.263. simple_search">$simple_search</a>,

2012

see below but not meaning flagged messages) simply search for

2013

``<code class="literal">[f]lag</code>''.

2014

</p><div class="table"><a id="tab-simplesearch-keywords"></a><p class="title"><b>Table 4.2. Simple search keywords</b></p><div class="table-contents"><table summary="Simple search keywords" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Keyword</th><th>Pattern modifier</th></tr></thead><tbody><tr><td>all</td><td>~A</td></tr><tr><td>.</td><td>~A</td></tr><tr><td>^</td><td>~A</td></tr><tr><td>del</td><td>~D</td></tr><tr><td>flag</td><td>~F</td></tr><tr><td>new</td><td>~N</td></tr><tr><td>old</td><td>~O</td></tr><tr><td>repl</td><td>~Q</td></tr><tr><td>read</td><td>~R</td></tr><tr><td>tag</td><td>~T</td></tr><tr><td>unread</td><td>~U</td></tr></tbody></table></div></div><br class="table-break" /><p>

2015

The second type of simple search is to build a complex search

2016

pattern using <a href="#simple-search" title="3.263. simple_search">$simple_search</a>

2017

as a template. Mutt will insert your query properly quoted and search

2018

for the composed complex query.

2019

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id459655"></a>2.3. Complex Patterns</h3></div></div></div><p>

1815

2020

Logical AND is performed by specifying more than one criterion. For

1816

2021

example:

1817

2022

</p><p>

1873

2078

Without the quotes, the parenthesis wouldn't end.

1874

2079

This would be seperated to two OR'd patterns: <span class="emphasis"><em>˜f me@(mutt\.org</em></span>

1875

2080

and <span class="emphasis"><em>cs\.hmc\.edu)</em></span>. They are never what you want.

1876

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2884490"></a>2.3. Searching by Date</h3></div></div></div><p>

2081

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id459787"></a>2.4. Searching by Date</h3></div></div></div><p>

1877

2082

Mutt supports two types of dates, <span class="emphasis"><em>absolute</em></span> and <span class="emphasis"><em>relative</em></span>.

1878

2083

</p><p>

1879

2084

<span class="bold"><strong>Absolute</strong></span>. Dates <span class="bold"><strong>must</strong></span> be in DD/MM/YY format (month and year are

1894

2099

</p><p>

1895

2100

<span class="bold"><strong>Error Margins</strong></span>. You can add error margins to absolute dates.

1896

2101

An error margin is a sign (+ or -), followed by a digit, followed by

1897

one of the following units:

1898

1899

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

1900

y years

1901

m months

1902

w weeks

1903

d days

1904

</pre><p>

1905

1906

As a special case, you can replace the sign by a ``*'' character,

1907

which is equivalent to giving identical plus and minus error margins.

1908

</p><p>

2102

one of the units in <a href="#tab-date-units" title="Table 4.3. Date units">Table 4.3, “Date units”</a>. As a special case, you can replace the

2103

sign by a ``*'' character, which is equivalent to giving identical plus and minus error margins.

2104

</p><div class="table"><a id="tab-date-units"></a><p class="title"><b>Table 4.3. Date units</b></p><div class="table-contents"><table summary="Date units" border="1"><colgroup><col /><col /></colgroup><thead><tr><th>Unit</th><th>Description</th></tr></thead><tbody><tr><td>y</td><td>Years</td></tr><tr><td>m</td><td>Months</td></tr><tr><td>w</td><td>Weeks</td></tr><tr><td>d</td><td>Days</td></tr></tbody></table></div></div><br class="table-break" /><p>

1909

2105

Example: To select any messages two weeks around January 15, 2001,

1910

2106

you'd use the following pattern:

1911

2107

1927

2123

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

1928

2124

1929

2125

</p><p>

1930

<span class="emphasis"><em>offset</em></span> is specified as a positive number with one of the following

1931

units:

1932

1933

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

1934

y years

1935

m months

1936

w weeks

1937

d days

1938

</pre><p>

1939

2126

<span class="emphasis"><em>offset</em></span> is specified as a positive number with one of the units from <a href="#tab-date-units" title="Table 4.3. Date units">Table 4.3, “Date units”</a>.

1940

2127

</p><p>

1941

2128

Example: to select messages less than 1 month old, you would use

1942

2129

1946

2133

1947

2134

</p><p>

1948

2135

<span class="bold"><strong>Note:</strong></span> all dates used when searching are relative to the

1949

<span class="bold"><strong>local</strong></span> time zone, so unless you change the setting of your <a href="#index-format" title="3.95. index_format">$index_format</a> to include a

2136

<span class="bold"><strong>local</strong></span> time zone, so unless you change the setting of your <a href="#index-format" title="3.100. index_format">$index_format</a> to include a

1950

2137

<code class="literal">%[...]</code> format, these are <span class="bold"><strong>not</strong></span> the dates shown

1951

2138

in the main index.

1952

2139

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tags"></a>3. Using Tags</h2></div></div></div><p>

1957

2144

matching a pattern, use the tag-pattern function, which is bound to

1958

2145

``shift-T'' by default. Or you can select individual messages by

1959

2146

hand using the ``tag-message'' function, which is bound to ``t'' by

1960

default. See <a href="#patterns" title="2. Patterns">patterns</a> for Mutt's pattern

2147

default. See <a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a> for Mutt's pattern

1961

2148

matching syntax.

1962

2149

</p><p>

1963

2150

Once you have tagged the desired messages, you can use the

1964

2151

``tag-prefix'' operator, which is the ``;'' (semicolon) key by default.

1965

2152

When the ``tag-prefix'' operator is used, the <span class="bold"><strong>next</strong></span> operation will

1966

2153

be applied to all tagged messages if that operation can be used in that

1967

manner. If the <a href="#auto-tag" title="3.16. auto_tag">$auto_tag</a>

2154

manner. If the <a href="#auto-tag" title="3.18. auto_tag">$auto_tag</a>

1968

2155

variable is set, the next operation applies to the tagged messages

1969

2156

automatically, without requiring the ``tag-prefix''.

1970

2157

</p><p>

1971

In <a href="#macro" title="6. Keyboard macros">macros</a> or <a href="#push" title="21. Adding key sequences to the keyboard buffer">push</a> commands,

2158

In <a href="#macro" title="7. Keyboard macros">macros</a> or <a href="#push" title="22. Adding key sequences to the keyboard buffer">push</a> commands,

1972

2159

you can use the ``tag-prefix-cond'' operator. If there are no tagged

1973

2160

messages, mutt will "eat" the rest of the macro to abort it's execution.

1974

2161

Mutt will stop "eating" the macro when it encounters the ``end-cond''

1980

2167

you may wish to tailor your configuration based upon which mailbox you are

1981

2168

reading, or to whom you are sending mail. In the Mutt world, a <span class="emphasis"><em>hook</em></span>

1982

2169

consists of a <a href="#regexp" title="1. Regular Expressions">regular expression</a> or

1983

<a href="#patterns" title="2. Patterns">pattern</a> along with a

2170

<a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">pattern</a> along with a

1984

2171

configuration option/command. See

1985

2172

1986

2173

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

1987

<a href="#folder-hook" title="5. Setting variables based upon mailbox">folder-hook</a>

1988

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

1989

1990

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

1991

<a href="#message-hook" title="19. Change settings before formatting a message">message-hook</a>

1992

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

1993

1994

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

1995

1996

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

1997

1998

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

1999

2174

<a href="#folder-hook" title="6. Setting variables based upon mailbox">folder-hook</a>

2175

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

2176

2177

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

2178

<a href="#message-hook" title="20. Change settings before formatting a message">message-hook</a>

2179

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

2180

2181

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

2182

2183

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

2184

2185

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

2186

2000

2187

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

2001

2188

2002

2189

for specific details on each type of <span class="emphasis"><em>hook</em></span> available.

2014

2201

</pre><p>

2015

2202

2016

2203

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pattern-hook"></a>4.1. Message Matching in Hooks</h3></div></div></div><p>

2017

Hooks that act upon messages (<code class="literal">send-hook, save-hook, fcc-hook,

2018

message-hook</code>) are evaluated in a slightly different manner. For the other

2204

Hooks that act upon messages (<code class="literal">message-hook, reply-hook,

2205

send-hook, send2-hook, save-hook, fcc-hook</code>) are evaluated in a

2206

slightly different manner. For the other

2019

2207

types of hooks, a <a href="#regexp" title="1. Regular Expressions">regular expression</a> is

2020

2208

sufficient. But in dealing with messages a finer grain of control is

2021

2209

needed for matching since for different purposes you want to match

2022

2210

different criteria.

2023

2211

</p><p>

2024

Mutt allows the use of the <a href="#patterns" title="2. Patterns">search pattern</a>

2212

Mutt allows the use of the <a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">search pattern</a>

2025

2213

language for matching messages in hook commands. This works in

2026

2214

exactly the same way as it would when <span class="emphasis"><em>limiting</em></span> or

2027

2215

<span class="emphasis"><em>searching</em></span> the mailbox, except that you are restricted to those

2042

2230

full searching language. You can still specify a simple <span class="emphasis"><em>regular

2043

2231

expression</em></span> like the other hooks, in which case Mutt will translate your

2044

2232

pattern into the full language, using the translation specified by the

2045

<a href="#default-hook" title="3.37. default_hook">$default_hook</a> variable. The

2233

<a href="#default-hook" title="3.41. default_hook">$default_hook</a> variable. The

2046

2234

pattern is translated at the time the hook is declared, so the value of

2047

<a href="#default-hook" title="3.37. default_hook">$default_hook</a> that is in effect

2235

<a href="#default-hook" title="3.41. default_hook">$default_hook</a> that is in effect

2048

2236

at that time will be used.

2049

2237

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="query"></a>5. External Address Queries</h2></div></div></div><p>

2050

2238

Mutt supports connecting to external directory databases such as LDAP,

2051

2239

ph/qi, bbdb, or NIS through a wrapper script which connects to mutt

2052

using a simple interface. Using the <a href="#query-command" title="3.225. query_command">$query_command</a> variable, you specify the wrapper

2240

using a simple interface. Using the <a href="#query-command" title="3.231. query_command">$query_command</a> variable, you specify the wrapper

2053

2241

command to use. For example:

2054

2242

</p><p>

2055

2243

2070

2258

Searching database ... 20 entries ... 3 matching:

2071

2259

me@cs.hmc.edu Michael Elkins mutt dude

2072

2260

blong@fiction.net Brandon Long mutt and more

2073

roessler@guug.de Thomas Roessler mutt pgp

2261

roessler@does-not-exist.org Thomas Roessler mutt pgp

2074

2262

</pre><p>

2075

2263

2076

2264

</p><p>

2095

2283

Mutt supports reading and writing of four different mailbox formats:

2096

2284

mbox, MMDF, MH and Maildir. The mailbox type is autodetected, so there

2097

2285

is no need to use a flag for different mailbox types. When creating new

2098

mailboxes, Mutt uses the default specified with the <a href="#mbox-type" title="3.111. mbox_type">$mbox_type</a> variable.

2286

mailboxes, Mutt uses the default specified with the <a href="#mbox-type" title="3.116. mbox_type">$mbox_type</a> variable.

2099

2287

</p><p>

2100

2288

<span class="bold"><strong>mbox</strong></span>. This is the most widely used mailbox format for UNIX. All

2101

2289

messages are stored in a single file. Each message has a line of the form:

2134

2322

</p><p>

2135

2323

2136

2324

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

2137

! -- refers to your <a href="#spoolfile" title="3.265. spoolfile">$spoolfile</a> (incoming) mailbox

2138

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

2139

> -- refers to your <a href="#mbox" title="3.110. mbox">$mbox</a> file

2140

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

2141

< -- refers to your <a href="#record" title="3.232. record">$record</a> file

2325

! -- refers to your <a href="#spoolfile" title="3.276. spoolfile">$spoolfile</a> (incoming) mailbox

2326

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

2327

> -- refers to your <a href="#mbox" title="3.115. mbox">$mbox</a> file

2328

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

2329

< -- refers to your <a href="#record" title="3.239. record">$record</a> file

2142

2330

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

2143

2331

^ -- refers to the current mailbox

2144

2332

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

2146

2334

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

2147

2335

˜ -- refers to your home directory

2148

2336

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

2149

= or + -- refers to your <a href="#folder" title="3.54. folder">$folder</a> directory

2337

= or + -- refers to your <a href="#folder" title="3.58. folder">$folder</a> directory

2150

2338

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

2151

@<span class="emphasis"><em>alias</em></span> -- refers to the <a href="#save-hook" title="15. Specify default save filename">default save folder</a> as determined by the address of the alias

2339

@<span class="emphasis"><em>alias</em></span> -- refers to the <a href="#save-hook" title="16. Specify default save mailbox">default save folder</a> as determined by the address of the alias

2152

2340

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

2153

2341

2154

2342

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="using-lists"></a>8. Handling Mailing Lists</h2></div></div></div><p>

2157

2345

know what addresses you consider to be mailing lists (technically

2158

2346

this does not have to be a mailing list, but that is what it is most

2159

2347

often used for), and what lists you are subscribed to. This is

2160

accomplished through the use of the <a href="#lists" title="10. Mailing lists">lists and subscribe</a> commands in your muttrc.

2348

accomplished through the use of the <a href="#lists" title="11. Mailing lists">lists and subscribe</a> commands in your muttrc.

2161

2349

</p><p>

2162

2350

Now that Mutt knows what your mailing lists are, it can do several

2163

2351

things, the first of which is the ability to show the name of a list

2164

2352

through which you received a message (i.e., of a subscribed list) in

2165

2353

the <span class="emphasis"><em>index</em></span> menu display. This is useful to distinguish between

2166

personal and list mail in the same mailbox. In the <a href="#index-format" title="3.95. index_format">$index_format</a> variable, the escape ``%L''

2354

personal and list mail in the same mailbox. In the <a href="#index-format" title="3.100. index_format">$index_format</a> variable, the escape ``%L''

2167

2355

will return the string ``To <list>'' when ``list'' appears in the

2168

2356

``To'' field, and ``Cc <list>'' when it appears in the ``Cc''

2169

2357

field (otherwise it returns the name of the author).

2179

2367

</p><p>

2180

2368

Mutt also supports the <code class="literal">Mail-Followup-To</code> header. When you send

2181

2369

a message to a list of recipients which includes one or several

2182

subscribed mailing lists, and if the <a href="#followup-to" title="3.56. followup_to">$followup_to</a> option is set, mutt will generate

2370

subscribed mailing lists, and if the <a href="#followup-to" title="3.60. followup_to">$followup_to</a> option is set, mutt will generate

2183

2371

a Mail-Followup-To header which contains all the recipients to whom

2184

2372

you send this message, but not your address. This indicates that

2185

2373

group-replies or list-replies (also known as ``followups'') to this

2189

2377

</p><p>

2190

2378

Conversely, when group-replying or list-replying to a message which

2191

2379

has a <code class="literal">Mail-Followup-To</code> header, mutt will respect this header if

2192

the <a href="#honor-followup-to" title="3.74. honor_followup_to">$honor_followup_to</a> configuration

2380

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

2193

2381

variable is set. Using list-reply will in this case also make sure

2194

2382

that the reply goes to the mailing list, even if it's not specified

2195

2383

in the list of recipients in the <code class="literal">Mail-Followup-To</code>.

2203

2391

than the author of the message. This can create problems when trying

2204

2392

to reply directly to the author in private, since most mail clients

2205

2393

will automatically reply to the address given in the ``Reply-To''

2206

field. Mutt uses the <a href="#reply-to" title="3.235. reply_to">$reply_to</a>

2394

field. Mutt uses the <a href="#reply-to" title="3.242. reply_to">$reply_to</a>

2207

2395

variable to help decide which address to use. If set to <span class="emphasis"><em>ask-yes</em></span> or

2208

2396

<span class="emphasis"><em>ask-no</em></span>, you will be

2209

2397

prompted as to whether or not you would like to use the address given in

2213

2401

</p><p>

2214

2402

The ``X-Label:'' header field can be used to further identify mailing

2215

2403

lists or list subject matter (or just to annotate messages

2216

individually). The <a href="#index-format" title="3.95. index_format">$index_format</a> variable's ``%y'' and

2404

individually). The <a href="#index-format" title="3.100. index_format">$index_format</a> variable's ``%y'' and

2217

2405

``%Y'' escapes can be used to expand ``X-Label:'' fields in the

2218

2406

index, and Mutt's pattern-matcher can match regular expressions to

2219

2407

``X-Label:'' fields with the ``˜y'' selector. ``X-Label:'' is not a

2220

2408

standard message header field, but it can easily be inserted by procmail

2221

2409

and other mail filtering agents.

2222

2410

</p><p>

2223

Lastly, Mutt has the ability to <a href="#sort" title="3.259. sort">sort</a> the mailbox into

2411

Lastly, Mutt has the ability to <a href="#sort" title="3.270. sort">sort</a> the mailbox into

2224

2412

<a href="#threads" title="3.3. Threaded Mode">threads</a>. A thread is a group of messages which all relate to the same

2225

2413

subject. This is usually organized into a tree-like structure where a

2226

2414

message and all of its replies are represented graphically. If you've ever

2232

2420

either by misconfigured software or bad behavior from some

2233

2421

correspondents. This allows to clean your mailboxes formats) from these

2234

2422

annoyances which make it hard to follow a discussion.

2235

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2885762"></a>9.1. Linking threads</h3></div></div></div><p>

2423

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id460955"></a>9.1. Linking threads</h3></div></div></div><p>

2236

2424

Some mailers tend to "forget" to correctly set the "In-Reply-To:" and

2237

2425

"References:" headers when replying to a message. This results in broken

2238

2426

discussions because Mutt has not enough information to guess the correct

2243

2431

</p><p>

2244

2432

You can also connect multiple children at once, tagging them and using the

2245

2433

tag-prefix command (';') or the auto_tag option.

2246

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2885791"></a>9.2. Breaking threads</h3></div></div></div><p>

2434

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id460970"></a>9.2. Breaking threads</h3></div></div></div><p>

2247

2435

On mailing lists, some people are in the bad habit of starting a new

2248

2436

discussion by hitting "reply" to any message from the list and changing

2249

2437

the subject to a totally unrelated one.

2253

2441

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="dsn"></a>10. Delivery Status Notification (DSN) Support</h2></div></div></div><p>

2254

2442

RFC1894 defines a set of MIME content types for relaying information

2255

2443

about the status of electronic mail messages. These can be thought of as

2256

``return receipts.'' Berkeley sendmail 8.8.x currently has some command

2257

line options in which the mail client can make requests as to what type

2258

of status messages should be returned.

2444

``return receipts.''

2259

2445

</p><p>

2260

To support this, there are two variables. <a href="#dsn-notify" title="3.43. dsn_notify">$dsn_notify</a> is used to request receipts for

2446

To support DSN, there are two variables. <a href="#dsn-notify" title="3.47. dsn_notify">$dsn_notify</a> is used to request receipts for

2261

2447

different results (such as failed message, message delivered, etc.).

2262

<a href="#dsn-return" title="3.44. dsn_return">$dsn_return</a> requests how much

2448

<a href="#dsn-return" title="3.48. dsn_return">$dsn_return</a> requests how much

2263

2449

of your message should be returned with the receipt (headers or full

2264

message). Refer to the man page on sendmail for more details on DSN.

2265

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="pop"></a>11. POP3 Support (OPTIONAL)</h2></div></div></div><p>

2266

If Mutt was compiled with POP3 support (by running the <span class="emphasis"><em>configure</em></span>

2267

script with the <span class="emphasis"><em>--enable-pop</em></span> flag), it has the ability to work

2268

with mailboxes located on a remote POP3 server and fetch mail for local

2269

browsing.

2270

</p><p>

2271

You can access the remote POP3 mailbox by selecting the folder

2272

<code class="literal">pop://popserver/</code>.

2273

</p><p>

2274

You can select an alternative port by specifying it with the server, ie:

2275

<code class="literal">pop://popserver:port/</code>.

2276

</p><p>

2277

You can also specify different username for each folder, ie:

2278

<code class="literal">pop://username@popserver[:port]/</code>.

2279

</p><p>

2280

Polling for new mail is more expensive over POP3 than locally. For this

2281

reason the frequency at which Mutt will check for mail remotely can be

2282

controlled by the

2283

<a href="#pop-checkinterval" title="3.209. pop_checkinterval">$pop_checkinterval</a>

2284

variable, which defaults to every 60 seconds.

2285

</p><p>

2286

If Mutt was compiled with SSL support (by running the <span class="emphasis"><em>configure</em></span>

2287

script with the <span class="emphasis"><em>--with-ssl</em></span> flag), connections to POP3 servers

2288

can be encrypted. This naturally requires that the server supports

2289

SSL encrypted connections. To access a folder with POP3/SSL, you should

2290

use pops: prefix, ie:

2291

<code class="literal">pops://[username@]popserver[:port]/</code>.

2292

</p><p>

2293

Another way to access your POP3 mail is the <span class="emphasis"><em>fetch-mail</em></span> function

2294

(default: G). It allows to connect to <a href="#pop-host" title="3.211. pop_host">$pop_host</a>, fetch all your new mail and place it in the

2295

local <a href="#spoolfile" title="3.265. spoolfile">$spoolfile</a>. After this

2296

point, Mutt runs exactly as if the mail had always been local.

2297

</p><p>

2298

<span class="bold"><strong>Note:</strong></span> If you only need to fetch all messages to local mailbox

2299

you should consider using a specialized program, such as <a href="http://www.ccil.org/~esr/fetchmail" target="_top">fetchmail</a>

2300

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="imap"></a>12. IMAP Support (OPTIONAL)</h2></div></div></div><p>

2301

If Mutt was compiled with IMAP support (by running the <span class="emphasis"><em>configure</em></span>

2302

script with the <span class="emphasis"><em>--enable-imap</em></span> flag), it has the ability to work

2303

with folders located on a remote IMAP server.

2304

</p><p>

2305

You can access the remote inbox by selecting the folder

2306

<code class="literal">imap://imapserver/INBOX</code>, where <code class="literal">imapserver</code> is the name of the

2307

IMAP server and <code class="literal">INBOX</code> is the special name for your spool mailbox on

2308

the IMAP server. If you want to access another mail folder at the IMAP

2309

server, you should use <code class="literal">imap://imapserver/path/to/folder</code> where

2310

<code class="literal">path/to/folder</code> is the path of the folder you want to access.

2311

</p><p>

2312

You can select an alternative port by specifying it with the server, ie:

2313

<code class="literal">imap://imapserver:port/INBOX</code>.

2314

</p><p>

2315

You can also specify different username for each folder, ie:

2316

<code class="literal">imap://username@imapserver[:port]/INBOX</code>.

2317

</p><p>

2318

If Mutt was compiled with SSL support (by running the <span class="emphasis"><em>configure</em></span>

2319

script with the <span class="emphasis"><em>--with-ssl</em></span> flag), connections to IMAP servers

2320

can be encrypted. This naturally requires that the server supports

2321

SSL encrypted connections. To access a folder with IMAP/SSL, you should

2322

use <code class="literal">imaps://[username@]imapserver[:port]/path/to/folder</code> as your

2323

folder path.

2324

</p><p>

2325

Pine-compatible notation is also supported, ie

2326

<code class="literal">{[username@]imapserver[:port][/ssl]}path/to/folder</code>

2327

</p><p>

2328

Note that not all servers use / as the hierarchy separator. Mutt should

2329

correctly notice which separator is being used by the server and convert

2330

paths accordingly.

2331

</p><p>

2332

When browsing folders on an IMAP server, you can toggle whether to look

2333

at only the folders you are subscribed to, or all folders with the

2334

<span class="emphasis"><em>toggle-subscribed</em></span> command. See also the

2335

<a href="#imap-list-subscribed" title="3.84. imap_list_subscribed">$imap_list_subscribed</a> variable.

2336

</p><p>

2337

Polling for new mail on an IMAP server can cause noticeable delays. So, you'll

2338

want to carefully tune the

2339

<a href="#mail-check" title="3.99. mail_check">$mail_check</a>

2340

and

2341

<a href="#timeout" title="3.275. timeout">$timeout</a>

2342

variables. Personally I use

2343

2344

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

2345

set mail_check=90

2346

set timeout=15

2347

</pre><p>

2348

2349

with relatively good results over my slow modem line.

2350

</p><p>

2351

Note that if you are using mbox as the mail store on UW servers prior to

2352

v12.250, the server has been reported to disconnect a client if another client

2353

selects the same folder.

2354

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2886159"></a>12.1. The Folder Browser</h3></div></div></div><p>

2355

As of version 1.2, mutt supports browsing mailboxes on an IMAP

2356

server. This is mostly the same as the local file browser, with the

2357

following differences:

2358

2359

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

2360

In lieu of file permissions, mutt displays the string "IMAP",

2361

possibly followed by the symbol "+", indicating

2362

that the entry contains both messages and subfolders. On

2363

Cyrus-like servers folders will often contain both messages and

2364

subfolders.

2365

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

2366

For the case where an entry can contain both messages and

2367

subfolders, the selection key (bound to <code class="literal">enter</code> by default)

2368

will choose to descend into the subfolder view. If you wish to view

2369

the messages in that folder, you must use <code class="literal">view-file</code> instead

2370

(bound to <code class="literal">space</code> by default).

2371

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

2372

You can create, delete and rename mailboxes with the

2373

<code class="literal">create-mailbox</code>, <code class="literal">delete-mailbox</code>, and

2374

<code class="literal">rename-mailbox</code> commands (default bindings: <code class="literal">C</code>,

2375

<code class="literal">d</code> and <code class="literal">r</code>, respectively). You may also

2376

<code class="literal">subscribe</code> and <code class="literal">unsubscribe</code> to mailboxes (normally

2377

these are bound to <code class="literal">s</code> and <code class="literal">u</code>, respectively).

2378

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

2379

2380

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2886281"></a>12.2. Authentication</h3></div></div></div><p>

2381

Mutt supports four authentication methods with IMAP servers: SASL,

2382

GSSAPI, CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add

2383

NTLM authentication for you poor exchange users out there, but it has

2384

yet to be integrated into the main tree). There is also support for

2385

the pseudo-protocol ANONYMOUS, which allows you to log in to a public

2386

IMAP server without having an account. To use ANONYMOUS, simply make

2387

your username blank or "anonymous".

2388

</p><p>

2389

SASL is a special super-authenticator, which selects among several protocols

2390

(including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure

2391

method available on your host and the server. Using some of these methods

2392

(including DIGEST-MD5 and possibly GSSAPI), your entire session will be

2393

encrypted and invisible to those teeming network snoops. It is the best

2394

option if you have it. To use it, you must have the Cyrus SASL library

2395

installed on your system and compile mutt with the <span class="emphasis"><em>--with-sasl</em></span> flag.

2396

</p><p>

2397

Mutt will try whichever methods are compiled in and available on the server,

2398

in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.

2399

</p><p>

2400

There are a few variables which control authentication:

2401

2402

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

2403

<a href="#imap-user" title="3.90. imap_user">$imap_user</a> - controls

2404

the username under which you request authentication on the IMAP server,

2405

for all authenticators. This is overridden by an explicit username in

2406

the mailbox path (ie by using a mailbox name of the form

2407

<code class="literal">{user@host}</code>).

2408

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

2409

<a href="#imap-pass" title="3.86. imap_pass">$imap_pass</a> - a

2410

password which you may preset, used by all authentication methods where

2411

a password is needed.

2412

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

2413

<a href="#imap-authenticators" title="3.77. imap_authenticators">$imap_authenticators</a> - a colon-delimited list of IMAP

2414

authentication methods to try, in the order you wish to try them. If

2415

specified, this overrides mutt's default (attempt everything, in the order

2416

listed above).

2417

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

2418

2419

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="account-hook"></a>13. Managing multiple IMAP/POP accounts (OPTIONAL)</h2></div></div></div><p>

2420

If you happen to have accounts on multiple IMAP and/or POP servers,

2421

you may find managing all the authentication settings inconvenient and

2422

error-prone. The account-hook command may help. This hook works like

2423

folder-hook but is invoked whenever you access a remote mailbox

2424

(including inside the folder browser), not just when you open the

2425

mailbox.

2426

</p><p>

2427

Some examples:

2428

</p><p>

2429

2430

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

2431

account-hook . 'unset imap_user; unset imap_pass; unset tunnel'

2432

account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'

2433

account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'

2434

</pre><p>

2435

2436

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="urlview"></a>14. Start a WWW Browser on URLs (EXTERNAL)</h2></div></div></div><p>

2450

message).

2451

</p><p>

2452

When using <a href="#sendmail" title="3.257. sendmail">$sendmail</a> for mail

2453

delivery, you need to use either Berkeley sendmail 8.8.x (or greater) a MTA

2454

supporting DSN command line options compatible to Sendmail: The -N and -R

2455

options can be used by the mail client to make requests as to what type of

2456

status messages should be returned. Please consider your MTA documentation

2457

whether DSN is supported.

2458

</p><p>

2459

For SMTP delivery using <a href="#smtp-url" title="3.269. smtp_url">$smtp_url</a>, it depends on the

2460

capabilities announced by the server whether mutt will attempt to

2461

request DSN or not.

2462

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="urlview"></a>11. Start a WWW Browser on URLs (EXTERNAL)</h2></div></div></div><p>

2437

2463

If a message contains URLs (<span class="emphasis"><em>unified resource locator</em></span> = address in the

2438

2464

WWW space like <span class="emphasis"><em>http://www.mutt.org/</em></span>), it is efficient to get

2439

2465

a menu with all the URLs and start a WWW browser on one of them. This

2445

2471

macro pager \cb |urlview\n

2446

2472

</pre><p>

2447

2473

2448

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="caching"></a>15. Local caching (OPTIONAL)</h2></div></div></div><p>

2449

Mutt contains two types of local caching: <span class="emphasis"><em>(1)</em></span>

2450

the so-called ``header caching'' and <span class="emphasis"><em>(2)</em></span> the

2451

so-called ``body caching'' which are both described in this section.

2452

</p><p>

2453

These are optional which means they're not enabled by default.

2454

Details on how to enable either of these techniques are given in the

2455

following subsections.

2456

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2886490"></a>15.1. Header caching</h3></div></div></div><p>

2457

Mutt provides optional support for caching message headers for the

2458

following types of folders: IMAP, POP, Maildir and MH. Header caching

2459

greatly improves speed because for remote folders, headers

2460

usually only need to be downloaded once. For Maildir and MH, reading the

2461

headers from a single file is much faster than looking at possibly

2462

thousands of single files (since Maildir and MH use one file per message.)

2463

</p><p>

2464

Header caching can be enabled via the configure script and the

2465

<span class="emphasis"><em>--enable-hcache</em></span> option. It's not turned on

2466

by default because external database libraries are required: one

2467

of qdbm, gdbm or bdb must be present.

2468

</p><p>

2469

If enabled, <a href="#header-cache" title="3.102. header_cache">$header_cache</a> can be

2470

used to either point to a file or a directory. If set to point to

2471

a file, one database file for all folders will be used (which may

2472

result in lower performance), but one file per folder if it points

2473

to a directory.

2474

</p><p>

2475

For the one-file-per-folder case, database files will be named by MD5

2476

sums. They may be safely removed if a system is short on space. You

2477

can compute the name of the header cache file for a particular folder

2478

through a command like the following:

2479

</p><p>

2480

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

2481

$ printf '%s' '/path/to/folder' | md5sum

2482

$ printf '%s' 'imaps://user@host/path/to/folder' | md5sum

2483

$ printf '%s' 'pops://user@host' | md5sum

2484

</pre><p>

2485

</p><p>

2486

The <code class="literal">md5sum</code> command may also be

2487

named <code class="literal">md5</code>, depending on your operating system.

2488

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2886568"></a>15.2. Body caching</h3></div></div></div><p>

2489

In addition to caching message headers only, mutt can also cache

2490

whole message bodies. This results in faster display of messages

2491

for POP and IMAP folders because messages usually have to be

2492

downloaded only once.

2493

</p><p>

2494

If the configure script is called with <span class="emphasis"><em>--enable-pop</em></span>

2495

and/or <span class="emphasis"><em>--enable-imap</em></span>, body caching will be

2496

built in as it does not require additional software packages such

2497

as database libraries.

2498

</p><p>

2499

For configuration, the variable <a href="#message-cachedir" title="3.127. message_cachedir">$message_cachedir</a> must point to a

2500

directory. There, mutt will create a hierarchy of subdirectories

2501

named like: <code class="literal">proto:user@hostname</code> where

2502

<code class="literal">proto</code> is either ``pop'' or ``imap.'' Within

2503

there for each folder, mutt stores messages in single files (just

2504

like Maildir) so that with manual symlink creation these cache

2505

directories can be examined with mutt as read-only Maildir folders.

2506

</p><p>

2507

All files can be removed as needed if the consumed disk space

2508

becomes an issue as mutt will silently fetch missing items again.

2509

</p></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="mimesupport"></a>Chapter 5. Mutt's MIME Support</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#using-mime">1. Using MIME in Mutt</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2886681">1.1. Viewing MIME messages in the pager</a></span></dt><dt><span class="sect2"><a href="#attach-menu">1.2. The Attachment Menu</a></span></dt><dt><span class="sect2"><a href="#compose-menu">1.3. The Compose Menu</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mime-types">2. MIME Type configuration with <code class="literal">mime.types</code></a></span></dt><dt><span class="sect1"><a href="#mime-viewers">3. MIME Viewer configuration with <code class="literal">mailcap</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2887039">3.1. The Basics of the mailcap file</a></span></dt><dt><span class="sect2"><a href="#id2887171">3.2. Secure use of mailcap</a></span></dt><dt><span class="sect2"><a href="#id2887242">3.3. Advanced mailcap Usage</a></span></dt><dt><span class="sect2"><a href="#id2887702">3.4. Example mailcap files</a></span></dt></dl></dd><dt><span class="sect1"><a href="#auto-view">4. MIME Autoview</a></span></dt><dt><span class="sect1"><a href="#alternative-order">5. MIME Multipart/Alternative</a></span></dt><dt><span class="sect1"><a href="#attachments">6. Attachment Searching and Counting</a></span></dt><dt><span class="sect1"><a href="#mime-lookup">7. MIME Lookup</a></span></dt></dl></div><p>

2474

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="mimesupport"></a>Chapter 5. Mutt's MIME Support</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#using-mime">1. Using MIME in Mutt</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id461145">1.1. Viewing MIME messages in the pager</a></span></dt><dt><span class="sect2"><a href="#attach-menu">1.2. The Attachment Menu</a></span></dt><dt><span class="sect2"><a href="#compose-menu">1.3. The Compose Menu</a></span></dt></dl></dd><dt><span class="sect1"><a href="#mime-types">2. MIME Type configuration with <code class="literal">mime.types</code></a></span></dt><dt><span class="sect1"><a href="#mime-viewers">3. MIME Viewer configuration with <code class="literal">mailcap</code></a></span></dt><dd><dl><dt><span class="sect2"><a href="#id461549">3.1. The Basics of the mailcap file</a></span></dt><dt><span class="sect2"><a href="#id461671">3.2. Secure use of mailcap</a></span></dt><dt><span class="sect2"><a href="#id461742">3.3. Advanced mailcap Usage</a></span></dt><dt><span class="sect2"><a href="#id462190">3.4. Example mailcap files</a></span></dt></dl></dd><dt><span class="sect1"><a href="#auto-view">4. MIME Autoview</a></span></dt><dt><span class="sect1"><a href="#alternative-order">5. MIME Multipart/Alternative</a></span></dt><dt><span class="sect1"><a href="#attachments">6. Attachment Searching and Counting</a></span></dt><dt><span class="sect1"><a href="#mime-lookup">7. MIME Lookup</a></span></dt></dl></div><p>

2510

2475

Quite a bit of effort has been made to make Mutt the premier text-mode

2511

2476

MIME MUA. Every effort has been made to provide the functionality that

2512

2477

the discerning MIME user requires, and the conformance to the standards

2519

2484

There are three areas/menus in Mutt which deal with MIME, they are the

2520

2485

pager (while viewing a message), the attachment menu and the compose

2521

2486

menu.

2522

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2886681"></a>1.1. Viewing MIME messages in the pager</h3></div></div></div><p>

2487

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id461145"></a>1.1. Viewing MIME messages in the pager</h3></div></div></div><p>

2523

2488

When you select a message from the index and view it in the pager, Mutt

2524

2489

decodes the message to a text representation. Mutt internally supports

2525

2490

a number of MIME types, including <code class="literal">text/plain, text/enriched,

2573

2538

Attachments appear as follows:

2574

2539

2575

2540

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

2576

- 1 [text/plain, 7bit, 1K] /tmp/mutt-euler-8082-0 <no description>

2577

2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz <no description>

2541

- 1 [text/plain, 7bit, 1K] /tmp/mutt-euler-8082-0 <no description>

2542

2 [applica/x-gunzip, base64, 422K] ~/src/mutt-0.85.tar.gz <no description>

2578

2543

</pre><p>

2579

2544

2580

2545

</p><p>

2633

2598

</p><p>

2634

2599

In order to handle various MIME types that Mutt can not handle

2635

2600

internally, Mutt parses a series of external configuration files to

2636

find an external handler. The default search string for these files

2637

is a colon delimited list set to

2638

2601

find an external handler. The default search string for these files

2602

is a colon delimited list containing the following files:

2603

2604

</p><div class="orderedlist"><ol type="1"><li><p><code class="literal">$HOME/.mailcap</code></p></li><li><p><code class="literal">$PKGDATADIR/mailcap</code></p></li><li><p><code class="literal">$SYSCONFDIR/mailcap</code></p></li><li><p><code class="literal">/etc/mailcap</code></p></li><li><p><code class="literal">/usr/etc/mailcap</code></p></li><li><p><code class="literal">/usr/local/etc/mailcap</code></p></li></ol></div><p>

2605

2606

where <code class="literal">$HOME</code> is your home directory. The

2607

<code class="literal">$PKGDATADIR</code> and the

2608

<code class="literal">$SYSCONFDIR</code> directories depend on where mutt

2609

is installed: the former is the default for shared data, the

2610

latter for system configuration files.

2611

</p><p>

2612

The default search path can be obtained by running the following

2613

command:

2639

2614

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

2640

${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap

2615

mutt -nF /dev/null -Q mailcap_path

2641

2616

</pre><p>

2642

2643

where <code class="literal">$HOME</code> is your home directory.

2644

</p><p>

2645

2617

In particular, the metamail distribution will install a mailcap file,

2646

2618

usually as <code class="literal">/usr/local/etc/mailcap</code>, which contains some baseline

2647

2619

entries.

2648

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2887039"></a>3.1. The Basics of the mailcap file</h3></div></div></div><p>

2620

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id461549"></a>3.1. The Basics of the mailcap file</h3></div></div></div><p>

2649

2621

A mailcap file consists of a series of lines which are comments, blank,

2650

2622

or definitions.

2651

2623

</p><p>

2721

2693

</pre><p>

2722

2694

2723

2695

This is the simplest form of a mailcap file.

2724

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2887171"></a>3.2. Secure use of mailcap</h3></div></div></div><p>

2696

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id461671"></a>3.2. Secure use of mailcap</h3></div></div></div><p>

2725

2697

The interpretation of shell meta-characters embedded in MIME parameters

2726

2698

can lead to security problems in general. Mutt tries to quote parameters

2727

2699

in expansion of %s syntaxes properly, and avoids risky characters by

2728

substituting them, see the <a href="#mailcap-sanitize" title="3.101. mailcap_sanitize">$mailcap_sanitize</a> variable.

2700

substituting them, see the <a href="#mailcap-sanitize" title="3.106. mailcap_sanitize">$mailcap_sanitize</a> variable.

2729

2701

</p><p>

2730

2702

Although mutt's procedures to invoke programs with mailcap seem to be

2731

2703

safe, there are other applications parsing mailcap, maybe taking less care

2751

2723

&& test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1

2752

2724

</pre><p>

2753

2725

2754

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2887242"></a>3.3. Advanced mailcap Usage</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2887247"></a>3.3.1. Optional Fields</h4></div></div></div><p>

2726

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id461742"></a>3.3. Advanced mailcap Usage</h3></div></div></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id461748"></a>3.3.1. Optional Fields</h4></div></div></div><p>

2755

2727

In addition to the required content-type and view command fields, you

2756

2728

can add semi-colon ';' separated fields to set flags and other options.

2757

2729

Mutt recognizes the following optional fields:

2771

2743

and Mutt will use your standard pager to display the results.

2772

2744

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

2773

2745

Mutt uses this flag when viewing attachments with <a href="#auto-view" title="4. MIME Autoview">auto_view</a>, in order to decide whether it should honor the setting

2774

of the <a href="#wait-key" title="3.287. wait_key">$wait_key</a> variable or

2746

of the <a href="#wait-key" title="3.299. wait_key">$wait_key</a> variable or

2775

2747

not. When an attachment is viewed using an interactive program, and the

2776

2748

corresponding mailcap entry has a <span class="emphasis"><em>needsterminal</em></span> flag, Mutt will use

2777

<a href="#wait-key" title="3.287. wait_key">$wait_key</a> and the exit status

2749

<a href="#wait-key" title="3.299. wait_key">$wait_key</a> and the exit status

2778

2750

of the program to decide if it will ask you to press a key after the

2779

2751

external program has exited. In all other situations it will not prompt

2780

2752

you for a key.

2827

2799

text/html object. If RunningX doesn't return 0, then Mutt will go on

2828

2800

to the next entry and use lynx to display the text/html object.

2829

2801

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

2830

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2887503"></a>3.3.2. Search Order</h4></div></div></div><p>

2802

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id461993"></a>3.3.2. Search Order</h4></div></div></div><p>

2831

2803

When searching for an entry in the mailcap file, Mutt will search for

2832

2804

the most useful entry for its purpose. For instance, if you are

2833

2805

attempting to print an <code class="literal">image/gif</code>, and you have the following

2860

2832

will run the program RunningX to determine if it should use the first

2861

2833

entry. If the program returns non-zero, Mutt will use the second entry

2862

2834

for interactive viewing.

2863

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2887580"></a>3.3.3. Command Expansion</h4></div></div></div><p>

2835

</p></div><div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id462069"></a>3.3.3. Command Expansion</h4></div></div></div><p>

2864

2836

The various commands defined in the mailcap files are passed to the

2865

2837

<code class="literal">/bin/sh</code> shell using the system() function. Before the

2866

2838

command is passed to <code class="literal">/bin/sh -c</code>, it is parsed to expand

2896

2868

Mutt does not currently support the %F and %n keywords

2897

2869

specified in RFC 1524. The main purpose of these parameters is for

2898

2870

multipart messages, which is handled internally by Mutt.

2899

</p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2887702"></a>3.4. Example mailcap files</h3></div></div></div><p>

2871

</p></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id462190"></a>3.4. Example mailcap files</h3></div></div></div><p>

2900

2872

This mailcap file is fairly simple and standard:

2901

2873

2902

2874

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

2966

2938

For instance, if you set auto_view to:

2967

2939

2968

2940

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

2969

auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz

2941

auto_view text/html application/x-gunzip \

2942

application/postscript image/gif application/x-tar-gz

2970

2943

</pre><p>

2971

2944

2972

2945

</p><p>

2975

2948

2976

2949

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

2977

2950

text/html; lynx -dump %s; copiousoutput; nametemplate=%s.html

2978

image/*; anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput

2951

image/*; anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | \

2952

pgmtopbm | pbmtoascii ; copiousoutput

2979

2953

application/x-gunzip; gzcat; copiousoutput

2980

2954

application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput

2981

2955

application/postscript; ps2ascii %s; copiousoutput

3119

3093

In addition, the unmime_lookup command may be used to disable this feature

3120

3094

for any particular mime-type if it had been set, for example, in a global

3121

3095

muttrc.

3122

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="reference"></a>Chapter 6. Reference</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#commandline">1. Command line options</a></span></dt><dt><span class="sect1"><a href="#commands">2. Configuration Commands</a></span></dt><dt><span class="sect1"><a href="#variables">3. Configuration variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#abort-nosubject">3.1. abort_nosubject</a></span></dt><dt><span class="sect2"><a href="#abort-unmodified">3.2. abort_unmodified</a></span></dt><dt><span class="sect2"><a href="#alias-file">3.3. alias_file</a></span></dt><dt><span class="sect2"><a href="#alias-format">3.4. alias_format</a></span></dt><dt><span class="sect2"><a href="#allow-8bit">3.5. allow_8bit</a></span></dt><dt><span class="sect2"><a href="#allow-ansi">3.6. allow_ansi</a></span></dt><dt><span class="sect2"><a href="#arrow-cursor">3.7. arrow_cursor</a></span></dt><dt><span class="sect2"><a href="#ascii-chars">3.8. ascii_chars</a></span></dt><dt><span class="sect2"><a href="#askbcc">3.9. askbcc</a></span></dt><dt><span class="sect2"><a href="#askcc">3.10. askcc</a></span></dt><dt><span class="sect2"><a href="#attach-format">3.11. attach_format</a></span></dt><dt><span class="sect2"><a href="#attach-sep">3.12. attach_sep</a></span></dt><dt><span class="sect2"><a href="#attach-split">3.13. attach_split</a></span></dt><dt><span class="sect2"><a href="#attribution">3.14. attribution</a></span></dt><dt><span class="sect2"><a href="#autoedit">3.15. autoedit</a></span></dt><dt><span class="sect2"><a href="#auto-tag">3.16. auto_tag</a></span></dt><dt><span class="sect2"><a href="#beep">3.17. beep</a></span></dt><dt><span class="sect2"><a href="#beep-new">3.18. beep_new</a></span></dt><dt><span class="sect2"><a href="#bounce">3.19. bounce</a></span></dt><dt><span class="sect2"><a href="#bounce-delivered">3.20. bounce_delivered</a></span></dt><dt><span class="sect2"><a href="#braille-friendly">3.21. braille_friendly</a></span></dt><dt><span class="sect2"><a href="#charset">3.22. charset</a></span></dt><dt><span class="sect2"><a href="#check-new">3.23. check_new</a></span></dt><dt><span class="sect2"><a href="#collapse-unread">3.24. collapse_unread</a></span></dt><dt><span class="sect2"><a href="#uncollapse-jump">3.25. uncollapse_jump</a></span></dt><dt><span class="sect2"><a href="#compose-format">3.26. compose_format</a></span></dt><dt><span class="sect2"><a href="#config-charset">3.27. config_charset</a></span></dt><dt><span class="sect2"><a href="#confirmappend">3.28. confirmappend</a></span></dt><dt><span class="sect2"><a href="#confirmcreate">3.29. confirmcreate</a></span></dt><dt><span class="sect2"><a href="#connect-timeout">3.30. connect_timeout</a></span></dt><dt><span class="sect2"><a href="#content-type">3.31. content_type</a></span></dt><dt><span class="sect2"><a href="#copy">3.32. copy</a></span></dt><dt><span class="sect2"><a href="#crypt-use-gpgme">3.33. crypt_use_gpgme</a></span></dt><dt><span class="sect2"><a href="#crypt-autopgp">3.34. crypt_autopgp</a></span></dt><dt><span class="sect2"><a href="#crypt-autosmime">3.35. crypt_autosmime</a></span></dt><dt><span class="sect2"><a href="#date-format">3.36. date_format</a></span></dt><dt><span class="sect2"><a href="#default-hook">3.37. default_hook</a></span></dt><dt><span class="sect2"><a href="#delete">3.38. delete</a></span></dt><dt><span class="sect2"><a href="#delete-untag">3.39. delete_untag</a></span></dt><dt><span class="sect2"><a href="#digest-collapse">3.40. digest_collapse</a></span></dt><dt><span class="sect2"><a href="#display-filter">3.41. display_filter</a></span></dt><dt><span class="sect2"><a href="#dotlock-program">3.42. dotlock_program</a></span></dt><dt><span class="sect2"><a href="#dsn-notify">3.43. dsn_notify</a></span></dt><dt><span class="sect2"><a href="#dsn-return">3.44. dsn_return</a></span></dt><dt><span class="sect2"><a href="#duplicate-threads">3.45. duplicate_threads</a></span></dt><dt><span class="sect2"><a href="#edit-headers">3.46. edit_headers</a></span></dt><dt><span class="sect2"><a href="#editor">3.47. editor</a></span></dt><dt><span class="sect2"><a href="#encode-from">3.48. encode_from</a></span></dt><dt><span class="sect2"><a href="#envelope-from-address">3.49. envelope_from_address</a></span></dt><dt><span class="sect2"><a href="#escape">3.50. escape</a></span></dt><dt><span class="sect2"><a href="#fast-reply">3.51. fast_reply</a></span></dt><dt><span class="sect2"><a href="#fcc-attach">3.52. fcc_attach</a></span></dt><dt><span class="sect2"><a href="#fcc-clear">3.53. fcc_clear</a></span></dt><dt><span class="sect2"><a href="#folder">3.54. folder</a></span></dt><dt><span class="sect2"><a href="#folder-format">3.55. folder_format</a></span></dt><dt><span class="sect2"><a href="#followup-to">3.56. followup_to</a></span></dt><dt><span class="sect2"><a href="#force-name">3.57. force_name</a></span></dt><dt><span class="sect2"><a href="#forward-decode">3.58. forward_decode</a></span></dt><dt><span class="sect2"><a href="#forward-edit">3.59. forward_edit</a></span></dt><dt><span class="sect2"><a href="#forward-format">3.60. forward_format</a></span></dt><dt><span class="sect2"><a href="#forward-quote">3.61. forward_quote</a></span></dt><dt><span class="sect2"><a href="#from">3.62. from</a></span></dt><dt><span class="sect2"><a href="#gecos-mask">3.63. gecos_mask</a></span></dt><dt><span class="sect2"><a href="#hdrs">3.64. hdrs</a></span></dt><dt><span class="sect2"><a href="#header">3.65. header</a></span></dt><dt><span class="sect2"><a href="#help">3.66. help</a></span></dt><dt><span class="sect2"><a href="#hidden-host">3.67. hidden_host</a></span></dt><dt><span class="sect2"><a href="#hide-limited">3.68. hide_limited</a></span></dt><dt><span class="sect2"><a href="#hide-missing">3.69. hide_missing</a></span></dt><dt><span class="sect2"><a href="#hide-thread-subject">3.70. hide_thread_subject</a></span></dt><dt><span class="sect2"><a href="#hide-top-limited">3.71. hide_top_limited</a></span></dt><dt><span class="sect2"><a href="#hide-top-missing">3.72. hide_top_missing</a></span></dt><dt><span class="sect2"><a href="#history">3.73. history</a></span></dt><dt><span class="sect2"><a href="#honor-followup-to">3.74. honor_followup_to</a></span></dt><dt><span class="sect2"><a href="#hostname">3.75. hostname</a></span></dt><dt><span class="sect2"><a href="#ignore-list-reply-to">3.76. ignore_list_reply_to</a></span></dt><dt><span class="sect2"><a href="#imap-authenticators">3.77. imap_authenticators</a></span></dt><dt><span class="sect2"><a href="#imap-check-subscribed">3.78. imap_check_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-delim-chars">3.79. imap_delim_chars</a></span></dt><dt><span class="sect2"><a href="#imap-headers">3.80. imap_headers</a></span></dt><dt><span class="sect2"><a href="#imap-home-namespace">3.81. imap_home_namespace</a></span></dt><dt><span class="sect2"><a href="#imap-idle">3.82. imap_idle</a></span></dt><dt><span class="sect2"><a href="#imap-keepalive">3.83. imap_keepalive</a></span></dt><dt><span class="sect2"><a href="#imap-list-subscribed">3.84. imap_list_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-login">3.85. imap_login</a></span></dt><dt><span class="sect2"><a href="#imap-pass">3.86. imap_pass</a></span></dt><dt><span class="sect2"><a href="#imap-passive">3.87. imap_passive</a></span></dt><dt><span class="sect2"><a href="#imap-peek">3.88. imap_peek</a></span></dt><dt><span class="sect2"><a href="#imap-servernoise">3.89. imap_servernoise</a></span></dt><dt><span class="sect2"><a href="#imap-user">3.90. imap_user</a></span></dt><dt><span class="sect2"><a href="#implicit-autoview">3.91. implicit_autoview</a></span></dt><dt><span class="sect2"><a href="#include">3.92. include</a></span></dt><dt><span class="sect2"><a href="#include-onlyfirst">3.93. include_onlyfirst</a></span></dt><dt><span class="sect2"><a href="#indent-string">3.94. indent_string</a></span></dt><dt><span class="sect2"><a href="#index-format">3.95. index_format</a></span></dt><dt><span class="sect2"><a href="#ispell">3.96. ispell</a></span></dt><dt><span class="sect2"><a href="#keep-flagged">3.97. keep_flagged</a></span></dt><dt><span class="sect2"><a href="#locale">3.98. locale</a></span></dt><dt><span class="sect2"><a href="#mail-check">3.99. mail_check</a></span></dt><dt><span class="sect2"><a href="#mailcap-path">3.100. mailcap_path</a></span></dt><dt><span class="sect2"><a href="#mailcap-sanitize">3.101. mailcap_sanitize</a></span></dt><dt><span class="sect2"><a href="#header-cache">3.102. header_cache</a></span></dt><dt><span class="sect2"><a href="#maildir-header-cache-verify">3.103. maildir_header_cache_verify</a></span></dt><dt><span class="sect2"><a href="#header-cache-pagesize">3.104. header_cache_pagesize</a></span></dt><dt><span class="sect2"><a href="#header-cache-compress">3.105. header_cache_compress</a></span></dt><dt><span class="sect2"><a href="#maildir-trash">3.106. maildir_trash</a></span></dt><dt><span class="sect2"><a href="#mark-old">3.107. mark_old</a></span></dt><dt><span class="sect2"><a href="#markers">3.108. markers</a></span></dt><dt><span class="sect2"><a href="#mask">3.109. mask</a></span></dt><dt><span class="sect2"><a href="#mbox">3.110. mbox</a></span></dt><dt><span class="sect2"><a href="#mbox-type">3.111. mbox_type</a></span></dt><dt><span class="sect2"><a href="#metoo">3.112. metoo</a></span></dt><dt><span class="sect2"><a href="#menu-context">3.113. menu_context</a></span></dt><dt><span class="sect2"><a href="#menu-move-off">3.114. menu_move_off</a></span></dt><dt><span class="sect2"><a href="#menu-scroll">3.115. menu_scroll</a></span></dt><dt><span class="sect2"><a href="#meta-key">3.116. meta_key</a></span></dt><dt><span class="sect2"><a href="#mh-purge">3.117. mh_purge</a></span></dt><dt><span class="sect2"><a href="#mh-seq-flagged">3.118. mh_seq_flagged</a></span></dt><dt><span class="sect2"><a href="#mh-seq-replied">3.119. mh_seq_replied</a></span></dt><dt><span class="sect2"><a href="#mh-seq-unseen">3.120. mh_seq_unseen</a></span></dt><dt><span class="sect2"><a href="#mime-forward">3.121. mime_forward</a></span></dt><dt><span class="sect2"><a href="#mime-forward-decode">3.122. mime_forward_decode</a></span></dt><dt><span class="sect2"><a href="#mime-forward-rest">3.123. mime_forward_rest</a></span></dt><dt><span class="sect2"><a href="#mix-entry-format">3.124. mix_entry_format</a></span></dt><dt><span class="sect2"><a href="#mixmaster">3.125. mixmaster</a></span></dt><dt><span class="sect2"><a href="#move">3.126. move</a></span></dt><dt><span class="sect2"><a href="#message-cachedir">3.127. message_cachedir</a></span></dt><dt><span class="sect2"><a href="#message-format">3.128. message_format</a></span></dt><dt><span class="sect2"><a href="#narrow-tree">3.129. narrow_tree</a></span></dt><dt><span class="sect2"><a href="#net-inc">3.130. net_inc</a></span></dt><dt><span class="sect2"><a href="#pager">3.131. pager</a></span></dt><dt><span class="sect2"><a href="#pager-context">3.132. pager_context</a></span></dt><dt><span class="sect2"><a href="#pager-format">3.133. pager_format</a></span></dt><dt><span class="sect2"><a href="#pager-index-lines">3.134. pager_index_lines</a></span></dt><dt><span class="sect2"><a href="#pager-stop">3.135. pager_stop</a></span></dt><dt><span class="sect2"><a href="#crypt-autosign">3.136. crypt_autosign</a></span></dt><dt><span class="sect2"><a href="#crypt-autoencrypt">3.137. crypt_autoencrypt</a></span></dt><dt><span class="sect2"><a href="#pgp-ignore-subkeys">3.138. pgp_ignore_subkeys</a></span></dt><dt><span class="sect2"><a href="#crypt-replyencrypt">3.139. crypt_replyencrypt</a></span></dt><dt><span class="sect2"><a href="#crypt-replysign">3.140. crypt_replysign</a></span></dt><dt><span class="sect2"><a href="#crypt-replysignencrypted">3.141. crypt_replysignencrypted</a></span></dt><dt><span class="sect2"><a href="#crypt-timestamp">3.142. crypt_timestamp</a></span></dt><dt><span class="sect2"><a href="#pgp-use-gpg-agent">3.143. pgp_use_gpg_agent</a></span></dt><dt><span class="sect2"><a href="#crypt-verify-sig">3.144. crypt_verify_sig</a></span></dt><dt><span class="sect2"><a href="#smime-is-default">3.145. smime_is_default</a></span></dt><dt><span class="sect2"><a href="#smime-ask-cert-label">3.146. smime_ask_cert_label</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-use-default-key">3.147. smime_decrypt_use_default_key</a></span></dt><dt><span class="sect2"><a href="#pgp-entry-format">3.148. pgp_entry_format</a></span></dt><dt><span class="sect2"><a href="#pgp-good-sign">3.149. pgp_good_sign</a></span></dt><dt><span class="sect2"><a href="#pgp-check-exit">3.150. pgp_check_exit</a></span></dt><dt><span class="sect2"><a href="#pgp-long-ids">3.151. pgp_long_ids</a></span></dt><dt><span class="sect2"><a href="#pgp-retainable-sigs">3.152. pgp_retainable_sigs</a></span></dt><dt><span class="sect2"><a href="#pgp-autoinline">3.153. pgp_autoinline</a></span></dt><dt><span class="sect2"><a href="#pgp-replyinline">3.154. pgp_replyinline</a></span></dt><dt><span class="sect2"><a href="#pgp-show-unusable">3.155. pgp_show_unusable</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-as">3.156. pgp_sign_as</a></span></dt><dt><span class="sect2"><a href="#pgp-strict-enc">3.157. pgp_strict_enc</a></span></dt><dt><span class="sect2"><a href="#pgp-timeout">3.158. pgp_timeout</a></span></dt><dt><span class="sect2"><a href="#pgp-sort-keys">3.159. pgp_sort_keys</a></span></dt><dt><span class="sect2"><a href="#pgp-mime-auto">3.160. pgp_mime_auto</a></span></dt><dt><span class="sect2"><a href="#pgp-auto-decode">3.161. pgp_auto_decode</a></span></dt><dt><span class="sect2"><a href="#pgp-decode-command">3.162. pgp_decode_command</a></span></dt><dt><span class="sect2"><a href="#pgp-getkeys-command">3.163. pgp_getkeys_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-command">3.164. pgp_verify_command</a></span></dt><dt><span class="sect2"><a href="#pgp-decrypt-command">3.165. pgp_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#pgp-clearsign-command">3.166. pgp_clearsign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-command">3.167. pgp_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-sign-command">3.168. pgp_encrypt_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-only-command">3.169. pgp_encrypt_only_command</a></span></dt><dt><span class="sect2"><a href="#pgp-import-command">3.170. pgp_import_command</a></span></dt><dt><span class="sect2"><a href="#pgp-export-command">3.171. pgp_export_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-key-command">3.172. pgp_verify_key_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-secring-command">3.173. pgp_list_secring_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-pubring-command">3.174. pgp_list_pubring_command</a></span></dt><dt><span class="sect2"><a href="#forward-decrypt">3.175. forward_decrypt</a></span></dt><dt><span class="sect2"><a href="#smime-timeout">3.176. smime_timeout</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-with">3.177. smime_encrypt_with</a></span></dt><dt><span class="sect2"><a href="#smime-keys">3.178. smime_keys</a></span></dt><dt><span class="sect2"><a href="#smime-ca-location">3.179. smime_ca_location</a></span></dt><dt><span class="sect2"><a href="#smime-certificates">3.180. smime_certificates</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-command">3.181. smime_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-command">3.182. smime_verify_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-opaque-command">3.183. smime_verify_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-command">3.184. smime_sign_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-opaque-command">3.185. smime_sign_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-command">3.186. smime_encrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-pk7out-command">3.187. smime_pk7out_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-command">3.188. smime_get_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-signer-cert-command">3.189. smime_get_signer_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-import-cert-command">3.190. smime_import_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-email-command">3.191. smime_get_cert_email_command</a></span></dt><dt><span class="sect2"><a href="#smime-default-key">3.192. smime_default_key</a></span></dt><dt><span class="sect2"><a href="#ssl-client-cert">3.193. ssl_client_cert</a></span></dt><dt><span class="sect2"><a href="#ssl-force-tls">3.194. ssl_force_tls</a></span></dt><dt><span class="sect2"><a href="#ssl-starttls">3.195. ssl_starttls</a></span></dt><dt><span class="sect2"><a href="#certificate-file">3.196. certificate_file</a></span></dt><dt><span class="sect2"><a href="#ssl-usesystemcerts">3.197. ssl_usesystemcerts</a></span></dt><dt><span class="sect2"><a href="#entropy-file">3.198. entropy_file</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv2">3.199. ssl_use_sslv2</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv3">3.200. ssl_use_sslv3</a></span></dt><dt><span class="sect2"><a href="#ssl-use-tlsv1">3.201. ssl_use_tlsv1</a></span></dt><dt><span class="sect2"><a href="#ssl-min-dh-prime-bits">3.202. ssl_min_dh_prime_bits</a></span></dt><dt><span class="sect2"><a href="#ssl-ca-certificates-file">3.203. ssl_ca_certificates_file</a></span></dt><dt><span class="sect2"><a href="#pipe-split">3.204. pipe_split</a></span></dt><dt><span class="sect2"><a href="#pipe-decode">3.205. pipe_decode</a></span></dt><dt><span class="sect2"><a href="#pipe-sep">3.206. pipe_sep</a></span></dt><dt><span class="sect2"><a href="#pop-authenticators">3.207. pop_authenticators</a></span></dt><dt><span class="sect2"><a href="#pop-auth-try-all">3.208. pop_auth_try_all</a></span></dt><dt><span class="sect2"><a href="#pop-checkinterval">3.209. pop_checkinterval</a></span></dt><dt><span class="sect2"><a href="#pop-delete">3.210. pop_delete</a></span></dt><dt><span class="sect2"><a href="#pop-host">3.211. pop_host</a></span></dt><dt><span class="sect2"><a href="#pop-last">3.212. pop_last</a></span></dt><dt><span class="sect2"><a href="#pop-reconnect">3.213. pop_reconnect</a></span></dt><dt><span class="sect2"><a href="#pop-user">3.214. pop_user</a></span></dt><dt><span class="sect2"><a href="#pop-pass">3.215. pop_pass</a></span></dt><dt><span class="sect2"><a href="#post-indent-string">3.216. post_indent_string</a></span></dt><dt><span class="sect2"><a href="#postpone">3.217. postpone</a></span></dt><dt><span class="sect2"><a href="#postponed">3.218. postponed</a></span></dt><dt><span class="sect2"><a href="#preconnect">3.219. preconnect</a></span></dt><dt><span class="sect2"><a href="#print">3.220. print</a></span></dt><dt><span class="sect2"><a href="#print-command">3.221. print_command</a></span></dt><dt><span class="sect2"><a href="#print-decode">3.222. print_decode</a></span></dt><dt><span class="sect2"><a href="#print-split">3.223. print_split</a></span></dt><dt><span class="sect2"><a href="#prompt-after">3.224. prompt_after</a></span></dt><dt><span class="sect2"><a href="#query-command">3.225. query_command</a></span></dt><dt><span class="sect2"><a href="#quit">3.226. quit</a></span></dt><dt><span class="sect2"><a href="#quote-regexp">3.227. quote_regexp</a></span></dt><dt><span class="sect2"><a href="#read-inc">3.228. read_inc</a></span></dt><dt><span class="sect2"><a href="#read-only">3.229. read_only</a></span></dt><dt><span class="sect2"><a href="#realname">3.230. realname</a></span></dt><dt><span class="sect2"><a href="#recall">3.231. recall</a></span></dt><dt><span class="sect2"><a href="#record">3.232. record</a></span></dt><dt><span class="sect2"><a href="#reply-regexp">3.233. reply_regexp</a></span></dt><dt><span class="sect2"><a href="#reply-self">3.234. reply_self</a></span></dt><dt><span class="sect2"><a href="#reply-to">3.235. reply_to</a></span></dt><dt><span class="sect2"><a href="#resolve">3.236. resolve</a></span></dt><dt><span class="sect2"><a href="#reverse-alias">3.237. reverse_alias</a></span></dt><dt><span class="sect2"><a href="#reverse-name">3.238. reverse_name</a></span></dt><dt><span class="sect2"><a href="#reverse-realname">3.239. reverse_realname</a></span></dt><dt><span class="sect2"><a href="#rfc2047-parameters">3.240. rfc2047_parameters</a></span></dt><dt><span class="sect2"><a href="#save-address">3.241. save_address</a></span></dt><dt><span class="sect2"><a href="#save-empty">3.242. save_empty</a></span></dt><dt><span class="sect2"><a href="#save-name">3.243. save_name</a></span></dt><dt><span class="sect2"><a href="#score">3.244. score</a></span></dt><dt><span class="sect2"><a href="#score-threshold-delete">3.245. score_threshold_delete</a></span></dt><dt><span class="sect2"><a href="#score-threshold-flag">3.246. score_threshold_flag</a></span></dt><dt><span class="sect2"><a href="#score-threshold-read">3.247. score_threshold_read</a></span></dt><dt><span class="sect2"><a href="#send-charset">3.248. send_charset</a></span></dt><dt><span class="sect2"><a href="#sendmail">3.249. sendmail</a></span></dt><dt><span class="sect2"><a href="#sendmail-wait">3.250. sendmail_wait</a></span></dt><dt><span class="sect2"><a href="#shell">3.251. shell</a></span></dt><dt><span class="sect2"><a href="#sig-dashes">3.252. sig_dashes</a></span></dt><dt><span class="sect2"><a href="#sig-on-top">3.253. sig_on_top</a></span></dt><dt><span class="sect2"><a href="#signature">3.254. signature</a></span></dt><dt><span class="sect2"><a href="#simple-search">3.255. simple_search</a></span></dt><dt><span class="sect2"><a href="#smart-wrap">3.256. smart_wrap</a></span></dt><dt><span class="sect2"><a href="#smileys">3.257. smileys</a></span></dt><dt><span class="sect2"><a href="#sleep-time">3.258. sleep_time</a></span></dt><dt><span class="sect2"><a href="#sort">3.259. sort</a></span></dt><dt><span class="sect2"><a href="#sort-alias">3.260. sort_alias</a></span></dt><dt><span class="sect2"><a href="#sort-aux">3.261. sort_aux</a></span></dt><dt><span class="sect2"><a href="#sort-browser">3.262. sort_browser</a></span></dt><dt><span class="sect2"><a href="#sort-re">3.263. sort_re</a></span></dt><dt><span class="sect2"><a href="#spam-separator">3.264. spam_separator</a></span></dt><dt><span class="sect2"><a href="#spoolfile">3.265. spoolfile</a></span></dt><dt><span class="sect2"><a href="#status-chars">3.266. status_chars</a></span></dt><dt><span class="sect2"><a href="#status-format">3.267. status_format</a></span></dt><dt><span class="sect2"><a href="#status-on-top">3.268. status_on_top</a></span></dt><dt><span class="sect2"><a href="#strict-threads">3.269. strict_threads</a></span></dt><dt><span class="sect2"><a href="#suspend">3.270. suspend</a></span></dt><dt><span class="sect2"><a href="#text-flowed">3.271. text_flowed</a></span></dt><dt><span class="sect2"><a href="#thread-received">3.272. thread_received</a></span></dt><dt><span class="sect2"><a href="#thorough-search">3.273. thorough_search</a></span></dt><dt><span class="sect2"><a href="#tilde">3.274. tilde</a></span></dt><dt><span class="sect2"><a href="#timeout">3.275. timeout</a></span></dt><dt><span class="sect2"><a href="#tmpdir">3.276. tmpdir</a></span></dt><dt><span class="sect2"><a href="#to-chars">3.277. to_chars</a></span></dt><dt><span class="sect2"><a href="#tunnel">3.278. tunnel</a></span></dt><dt><span class="sect2"><a href="#use-8bitmime">3.279. use_8bitmime</a></span></dt><dt><span class="sect2"><a href="#use-domain">3.280. use_domain</a></span></dt><dt><span class="sect2"><a href="#use-envelope-from">3.281. use_envelope_from</a></span></dt><dt><span class="sect2"><a href="#use-from">3.282. use_from</a></span></dt><dt><span class="sect2"><a href="#use-idn">3.283. use_idn</a></span></dt><dt><span class="sect2"><a href="#use-ipv6">3.284. use_ipv6</a></span></dt><dt><span class="sect2"><a href="#user-agent">3.285. user_agent</a></span></dt><dt><span class="sect2"><a href="#visual">3.286. visual</a></span></dt><dt><span class="sect2"><a href="#wait-key">3.287. wait_key</a></span></dt><dt><span class="sect2"><a href="#weed">3.288. weed</a></span></dt><dt><span class="sect2"><a href="#wrap-search">3.289. wrap_search</a></span></dt><dt><span class="sect2"><a href="#wrapmargin">3.290. wrapmargin</a></span></dt><dt><span class="sect2"><a href="#write-inc">3.291. write_inc</a></span></dt><dt><span class="sect2"><a href="#write-bcc">3.292. write_bcc</a></span></dt></dl></dd><dt><span class="sect1"><a href="#functions">4. Functions</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id2900751">4.1. generic</a></span></dt><dt><span class="sect2"><a href="#id2901104">4.2. index</a></span></dt><dt><span class="sect2"><a href="#id2901809">4.3. pager</a></span></dt><dt><span class="sect2"><a href="#id2902560">4.4. alias</a></span></dt><dt><span class="sect2"><a href="#id2902627">4.5. query</a></span></dt><dt><span class="sect2"><a href="#id2902742">4.6. attach</a></span></dt><dt><span class="sect2"><a href="#id2902952">4.7. compose</a></span></dt><dt><span class="sect2"><a href="#id2903305">4.8. postpone</a></span></dt><dt><span class="sect2"><a href="#id2903362">4.9. browser</a></span></dt><dt><span class="sect2"><a href="#id2903533">4.10. pgp</a></span></dt><dt><span class="sect2"><a href="#id2903590">4.11. editor</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commandline"></a>1. Command line options</h2></div></div></div><p>

3096

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="optionalfeatures"></a>Chapter 6. Optional features</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#id462485">1. General notes</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id462491">1.1. Enabling/disabling features</a></span></dt><dt><span class="sect2"><a href="#url-syntax">1.2. URL syntax</a></span></dt></dl></dd><dt><span class="sect1"><a href="#ssl">2. SSL/TLS Support</a></span></dt><dt><span class="sect1"><a href="#pop">3. POP3 Support</a></span></dt><dt><span class="sect1"><a href="#imap">4. IMAP Support</a></span></dt><dd><dl><dt><span class="sect2"><a href="#id462908">4.1. The Folder Browser</a></span></dt><dt><span class="sect2"><a href="#id463028">4.2. Authentication</a></span></dt></dl></dd><dt><span class="sect1"><a href="#smtp">5. SMTP Support</a></span></dt><dt><span class="sect1"><a href="#account-hook">6. Managing multiple accounts</a></span></dt><dt><span class="sect1"><a href="#caching">7. Local caching</a></span></dt><dd><dl><dt><span class="sect2"><a href="#header-caching">7.1. Header caching</a></span></dt><dt><span class="sect2"><a href="#body-caching">7.2. Body caching</a></span></dt><dt><span class="sect2"><a href="#maint-cache">7.3. Maintenance</a></span></dt></dl></dd><dt><span class="sect1"><a href="#exact-address">8. Exact address generation</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id462485"></a>1. General notes</h2></div></div></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id462491"></a>1.1. Enabling/disabling features</h3></div></div></div><p>

3097

Mutt supports several of optional features which can be enabled or

3098

disabled at compile-time by giving the <span class="emphasis"><em>configure</em></span> script

3099

certain arguments. These are listed in the ``Optional features'' section of

3100

the <span class="emphasis"><em>configure --help</em></span> output.

3101

</p><p>

3102

Which features are enabled or disabled can later be determined from the

3103

output of <code class="literal">mutt -v</code>. If a compile option starts with

3104

``+'' it is enabled and disabled if prefixed with ``-''. For example, if

3105

mutt was compiled using GnuTLS for encrypted communication instead of

3106

OpenSSL, <code class="literal">mutt -v</code> would contain:

3107

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

3108

-USE_SSL_OPENSSL +USE_SSL_GNUTLS</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="url-syntax"></a>1.2. URL syntax</h3></div></div></div><p>

3109

Mutt optionally supports the IMAP, POP3 and SMTP protocols which require

3110

to access servers using URLs. The canonical syntax for specifying URLs

3111

in mutt is (an item enclosed in <code class="literal">[]</code> means it is optional and

3112

may be omitted):

3113

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

3114

proto[s]://[username[:password]@]server[:port]/[path]

3115

</pre><p>

3116

<code class="literal">proto</code> is the communication protocol:

3117

<code class="literal">imap</code> for IMAP, <code class="literal">pop</code> for POP3 and

3118

<code class="literal">smtp</code> for SMTP. If ``s'' for ``secure communication''

3119

is appended, mutt will attempt to establish an encrypted communication

3120

using SSL or TLS. If no explicit port is given, mutt will use the

3121

system's default for the given protocol.

3122

</p><p>

3123

Since all protocols by mutt support authentication, the username may be

3124

given directly in the URL instead of using the <code class="literal">pop_user</code> or

3125

<code class="literal">imap_user</code> variables. A password can be given, too but

3126

is not recommended if the URL is specified in a configuration file on

3127

disk.

3128

</p><p>

3129

The optional path is only relevant for IMAP.

3130

</p><p>

3131

For IMAP for example, you can select an alternative port by specifying it with the

3132

server: <code class="literal">imap://imapserver:port/INBOX</code>. You can also specify different

3133

username for each folder: <code class="literal">imap://username@imapserver[:port]/INBOX</code>

3134

or <code class="literal">imap://username2@imapserver[:port]/path/to/folder</code>.

3135

Replacing <code class="literal">imap://</code> by <code class="literal">imaps://</code>

3136

would make mutt attempt to conect using SSL or TLS on a different port

3137

to encrypt the communication.

3138

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="ssl"></a>2. SSL/TLS Support</h2></div></div></div><p>

3139

If mutt is compiled with IMAP, POP3 and/or SMTP support, it can also be

3140

compiled with support for SSL or TLS using either OpenSSL or GnuTLS (

3141

by running the <span class="emphasis"><em>configure</em></span> script with the

3142

<span class="emphasis"><em>--enable-ssl=...</em></span> option for OpenSSL or

3143

<span class="emphasis"><em>--enable-gnutls=...</em></span> for GnuTLS). Mutt can then

3144

attempt to encrypt communication with remote servers if these protocols

3145

are suffixed with ``s'' for ``secure communication''.

3146

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="pop"></a>3. POP3 Support</h2></div></div></div><p>

3147

If Mutt was compiled with POP3 support (by running the <span class="emphasis"><em>configure</em></span>

3148

script with the <span class="emphasis"><em>--enable-pop</em></span> flag), it has the ability to work

3149

with mailboxes located on a remote POP3 server and fetch mail for local

3150

browsing.

3151

</p><p>

3152

Remote POP3 servers can be accessed using URLs with the <code class="literal">pop</code> protocol

3153

for unencrypted and <code class="literal">pops</code> for encrypted

3154

communication, see <a href="#url-syntax" title="1.2. URL syntax">Section 1.2, “URL syntax”</a> for details.

3155

</p><p>

3156

Polling for new mail is more expensive over POP3 than locally. For this

3157

reason the frequency at which Mutt will check for mail remotely can be

3158

controlled by the

3159

<a href="#pop-checkinterval" title="3.215. pop_checkinterval">$pop_checkinterval</a>

3160

variable, which defaults to every 60 seconds.

3161

</p><p>

3162

Another way to access your POP3 mail is the <span class="emphasis"><em>fetch-mail</em></span> function

3163

(default: G). It allows to connect to <a href="#pop-host" title="3.217. pop_host">$pop_host</a>, fetch all your new mail and place it in the

3164

local <a href="#spoolfile" title="3.276. spoolfile">$spoolfile</a>. After this

3165

point, Mutt runs exactly as if the mail had always been local.

3166

</p><p>

3167

<span class="bold"><strong>Note:</strong></span> If you only need to fetch all messages to a

3168

local mailbox you should consider using a specialized program, such as

3169

<code class="literal">fetchmail</code>, <code class="literal">getmail</code> or similar.

3170

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="imap"></a>4. IMAP Support</h2></div></div></div><p>

3171

If Mutt was compiled with IMAP support (by running the <span class="emphasis"><em>configure</em></span>

3172

script with the <span class="emphasis"><em>--enable-imap</em></span> flag), it has the ability to work

3173

with folders located on a remote IMAP server.

3174

</p><p>

3175

You can access the remote inbox by selecting the folder by its URL

3176

(see <a href="#url-syntax" title="1.2. URL syntax">Section 1.2, “URL syntax”</a> for details) using the

3177

<code class="literal">imap</code> or <code class="literal">imaps</code> protocol.

3178

Alternatively, a pine-compatible notation is also supported, ie

3179

<code class="literal">{[username@]imapserver[:port][/ssl]}path/to/folder</code>

3180

</p><p>

3181

Note that not all servers use ``/'' as the hierarchy separator. Mutt should

3182

correctly notice which separator is being used by the server and convert

3183

paths accordingly.

3184

</p><p>

3185

When browsing folders on an IMAP server, you can toggle whether to look

3186

at only the folders you are subscribed to, or all folders with the

3187

<span class="emphasis"><em>toggle-subscribed</em></span> command. See also the

3188

<a href="#imap-list-subscribed" title="3.89. imap_list_subscribed">$imap_list_subscribed</a> variable.

3189

</p><p>

3190

Polling for new mail on an IMAP server can cause noticeable delays. So, you'll

3191

want to carefully tune the

3192

<a href="#mail-check" title="3.104. mail_check">$mail_check</a>

3193

and

3194

<a href="#timeout" title="3.287. timeout">$timeout</a>

3195

variables. Personally I use

3196

3197

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

3198

set mail_check=90

3199

set timeout=15

3200

</pre><p>

3201

3202

with relatively good results over my slow modem line.

3203

</p><p>

3204

Note that if you are using mbox as the mail store on UW servers prior to

3205

v12.250, the server has been reported to disconnect a client if another client

3206

selects the same folder.

3207

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id462908"></a>4.1. The Folder Browser</h3></div></div></div><p>

3208

As of version 1.2, mutt supports browsing mailboxes on an IMAP

3209

server. This is mostly the same as the local file browser, with the

3210

following differences:

3211

3212

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

3213

In lieu of file permissions, mutt displays the string "IMAP",

3214

possibly followed by the symbol "+", indicating

3215

that the entry contains both messages and subfolders. On

3216

Cyrus-like servers folders will often contain both messages and

3217

subfolders.

3218

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

3219

For the case where an entry can contain both messages and

3220

subfolders, the selection key (bound to <code class="literal">enter</code> by default)

3221

will choose to descend into the subfolder view. If you wish to view

3222

the messages in that folder, you must use <code class="literal">view-file</code> instead

3223

(bound to <code class="literal">space</code> by default).

3224

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

3225

You can create, delete and rename mailboxes with the

3226

<code class="literal">create-mailbox</code>, <code class="literal">delete-mailbox</code>, and

3227

<code class="literal">rename-mailbox</code> commands (default bindings: <code class="literal">C</code>,

3228

<code class="literal">d</code> and <code class="literal">r</code>, respectively). You may also

3229

<code class="literal">subscribe</code> and <code class="literal">unsubscribe</code> to mailboxes (normally

3230

these are bound to <code class="literal">s</code> and <code class="literal">u</code>, respectively).

3231

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

3232

3233

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id463028"></a>4.2. Authentication</h3></div></div></div><p>

3234

Mutt supports four authentication methods with IMAP servers: SASL,

3235

GSSAPI, CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add

3236

NTLM authentication for you poor exchange users out there, but it has

3237

yet to be integrated into the main tree). There is also support for

3238

the pseudo-protocol ANONYMOUS, which allows you to log in to a public

3239

IMAP server without having an account. To use ANONYMOUS, simply make

3240

your username blank or "anonymous".

3241

</p><p>

3242

SASL is a special super-authenticator, which selects among several protocols

3243

(including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure

3244

method available on your host and the server. Using some of these methods

3245

(including DIGEST-MD5 and possibly GSSAPI), your entire session will be

3246

encrypted and invisible to those teeming network snoops. It is the best

3247

option if you have it. To use it, you must have the Cyrus SASL library

3248

installed on your system and compile mutt with the <span class="emphasis"><em>--with-sasl</em></span> flag.

3249

</p><p>

3250

Mutt will try whichever methods are compiled in and available on the server,

3251

in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.

3252

</p><p>

3253

There are a few variables which control authentication:

3254

3255

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

3256

<a href="#imap-user" title="3.95. imap_user">$imap_user</a> - controls

3257

the username under which you request authentication on the IMAP server,

3258

for all authenticators. This is overridden by an explicit username in

3259

the mailbox path (ie by using a mailbox name of the form

3260

<code class="literal">{user@host}</code>).

3261

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

3262

<a href="#imap-pass" title="3.91. imap_pass">$imap_pass</a> - a

3263

password which you may preset, used by all authentication methods where

3264

a password is needed.

3265

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

3266

<a href="#imap-authenticators" title="3.83. imap_authenticators">$imap_authenticators</a> - a colon-delimited list of IMAP

3267

authentication methods to try, in the order you wish to try them. If

3268

specified, this overrides mutt's default (attempt everything, in the order

3269

listed above).

3270

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

3271

3272

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="smtp"></a>5. SMTP Support</h2></div></div></div><p>

3273

Besides supporting traditional mail delivery through a

3274

sendmail-compatible program, mutt supports delivery through SMTP if it

3275

was configured and built with <code class="literal">--enable-smtp</code>.

3276

</p><p>

3277

If the configuration variable

3278

<a href="#smtp-url" title="3.269. smtp_url">$smtp_url</a> is set, mutt

3279

will contact the given SMTP server to deliver messages; if it is unset,

3280

mutt will use the program specified by <a href="#sendmail" title="3.257. sendmail">$sendmail</a>.

3281

</p><p>

3282

For details on the URL syntax, please see <a href="#url-syntax" title="1.2. URL syntax">Section 1.2, “URL syntax”</a>.

3283

</p><p>

3284

The built-in SMTP support supports encryption (the <code class="literal">smtps</code> protocol

3285

using SSL or TLS) as well as SMTP authentication using SASL. The authentication mechanisms

3286

for SASL are specified in <a href="#smtp-authenticators" title="3.267. smtp_authenticators">$smtp_authenticators</a>

3287

defaulting to an empty list which makes mutt try all available methods

3288

from most-secure to least-secure.

3289

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="account-hook"></a>6. Managing multiple accounts</h2></div></div></div><p>

3290

If you happen to have accounts on multiple IMAP, POP and/or SMTP servers,

3291

you may find managing all the authentication settings inconvenient and

3292

error-prone. The account-hook command may help. This hook works like

3293

folder-hook but is invoked whenever you access a remote mailbox

3294

(including inside the folder browser), not just when you open the

3295

mailbox.

3296

</p><p>

3297

Some examples:

3298

</p><p>

3299

3300

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

3301

account-hook . 'unset imap_user; unset imap_pass; unset tunnel'

3302

account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'

3303

account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'

3304

account-hook smtp://user@host3/ 'set tunnel="ssh host3 /usr/libexec/smtpd"'

3305

</pre><p>

3306

3307

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="caching"></a>7. Local caching</h2></div></div></div><p>

3308

Mutt contains two types of local caching: <span class="emphasis"><em>(1)</em></span>

3309

the so-called ``header caching'' and <span class="emphasis"><em>(2)</em></span> the

3310

so-called ``body caching'' which are both described in this section.

3311

</p><p>

3312

Header caching is optional as it depends on external libraries, body

3313

caching is always enabled if mutt is compiled with POP and/or IMAP

3314

support as these use it (body caching requires no external library).

3315

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-caching"></a>7.1. Header caching</h3></div></div></div><p>

3316

Mutt provides optional support for caching message headers for the

3317

following types of folders: IMAP, POP, Maildir and MH. Header caching

3318

greatly improves speed because for remote folders, headers

3319

usually only need to be downloaded once. For Maildir and MH, reading the

3320

headers from a single file is much faster than looking at possibly

3321

thousands of single files (since Maildir and MH use one file per message.)

3322

</p><p>

3323

Header caching can be enabled via the configure script and the

3324

<span class="emphasis"><em>--enable-hcache</em></span> option. It's not turned on

3325

by default because external database libraries are required: one

3326

of qdbm, gdbm or bdb must be present.

3327

</p><p>

3328

If enabled, <a href="#header-cache" title="3.107. header_cache">$header_cache</a> can be

3329

used to either point to a file or a directory. If set to point to

3330

a file, one database file for all folders will be used (which may

3331

result in lower performance), but one file per folder if it points

3332

to a directory.

3333

</p><p>

3334

For the one-file-per-folder case, database files for remote folders

3335

will be named according to their URL while database files for local

3336

folders will be named by the MD5 checksums of their path. These database

3337

files may be safely removed if a system is short on space. You

3338

can compute the name of the header cache file for a particular local folder

3339

through a command like the following:

3340

</p><p>

3341

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

3342

$ printf '%s' '/path/to/folder' | md5sum

3343

</pre><p>

3344

</p><p>

3345

The <code class="literal">md5sum</code> command may also be

3346

named <code class="literal">md5</code>, depending on your operating system.

3347

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="body-caching"></a>7.2. Body caching</h3></div></div></div><p>

3348

Both cache methods can be combined using the same directory for storage

3349

(and for IMAP/POP even provide meaningful file names) which simplifies

3350

manual maintenance tasks.

3351

</p><p>

3352

In addition to caching message headers only, mutt can also cache

3353

whole message bodies. This results in faster display of messages

3354

for POP and IMAP folders because messages usually have to be

3355

downloaded only once.

3356

</p><p>

3357

For configuration, the variable <a href="#message-cachedir" title="3.132. message_cachedir">$message_cachedir</a> must point to a

3358

directory. There, mutt will create a hierarchy of subdirectories

3359

named like: <code class="literal">proto:user@hostname</code> where

3360

<code class="literal">proto</code> is either ``pop'' or ``imap.'' Within

3361

there for each folder, mutt stores messages in single files (just

3362

like Maildir) so that with manual symlink creation these cache

3363

directories can be examined with mutt as read-only Maildir folders.

3364

</p><p>

3365

All files can be removed as needed if the consumed disk space

3366

becomes an issue as mutt will silently fetch missing items again.

3367

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maint-cache"></a>7.3. Maintenance</h3></div></div></div><p>

3368

Mutt does not (yet) support maintenance features for header cache

3369

database files so that files have to be removed in case they grow too

3370

big. It depends on the database library used for header caching whether

3371

disk space freed by removing messages is re-used.

3372

</p><p>

3373

For body caches, mutt can keep the local cache in sync with the

3374

remote mailbox if the

3375

<a href="#message-cache-clean" title="3.133. message_cache_clean">$message_cache_clean</a>

3376

variable is set. Cleaning means to remove messages from the cache which

3377

are no longer present in the mailbox which only happens when other mail

3378

clients or instances of mutt using a different body cache location

3379

delete messages (Mutt itself removes deleted messages from the cache

3380

when syncing a mailbox). As cleaning can take a noticeable amount of time,

3381

it should not be set in general but only occasionally.

3382

</p></div></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="exact-address"></a>8. Exact address generation</h2></div></div></div><p>

3383

Mutt supports the ``Name <user@host>'' address syntax for reading and

3384

writing messages, the older ``user@host (Name)'' syntax is only supported when

3385

reading messages. The <span class="emphasis"><em>--enable-exact-address</em></span>

3386

switch can be given to configure to build it with write-support

3387

for the latter syntax. <code class="literal">EXACT_ADDRESS</code> in the output of

3388

<code class="literal">mutt -v</code> indicates whether it's supported.

3389

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="tuning"></a>Chapter 7. Performance tuning</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#tuning-mailboxes">1. Reading and writing mailboxes</a></span></dt><dt><span class="sect1"><a href="#tuning-messages">2. Reading messages from remote folders</a></span></dt><dt><span class="sect1"><a href="#tuning-search">3. Searching and limiting</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tuning-mailboxes"></a>1. Reading and writing mailboxes</h2></div></div></div><p>

3390

Mutt's performance when reading mailboxes can be improved in two ways:

3391

</p><p>

3392

</p><div class="orderedlist"><ol type="1"><li><p>

3393

For remote folders (IMAP and POP) as well as folders using

3394

one-file-per message storage (Maildir and MH), mutt's

3395

performance can be greatly improved using

3396

<a href="#header-caching" title="7.1. Header caching">header caching</a>.

3397

Using a single database per folder may further increase

3398

performance.

3399

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

3400

Mutt provides the <a href="#read-inc" title="3.235. read_inc">$read_inc</a>

3401

and <a href="#write-inc" title="3.304. write_inc">$write_inc</a>

3402

variables to specify at which rate to update progress

3403

counters. If these values are too low, mutt may spend more

3404

time on updating the progress counter than it spends on

3405

actually reading/writing folders.

3406

</p><p>

3407

For example, when opening a maildir folder with a few

3408

thousand messages, the default value for

3409

3410

may be too low. It can be tuned on on a folder-basis using

3411

<a href="#folder-hook" title="6. Setting variables based upon mailbox">folder-hooks</a>:

3412

3413

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

3414

# use very high $read_inc to speed up reading hcache'd maildirs

3415

folder-hook . 'set read_inc=1000'

3416

# use lower value for reading slower remote IMAP folders

3417

folder-hook ^imap 'set read_inc=100'

3418

# use even lower value for reading even slower remote POP folders

3419

folder-hook ^pop 'set read_inc=1'</pre><p>

3420

</p></li></ol></div><p>

3421

</p><p>These settings work on a per-message basis. However, as messages may

3422

greatly differ in size and certain operations are much faster than others,

3423

even per-folder settings of the increment variables may not be

3424

desirable as they produce either too few or too much progress updates.

3425

Thus, Mutt allows to limit the number of progress updates per second it'll

3426

actually send to the terminal using the

3427

<a href="#time-inc" title="3.286. time_inc">$time_inc</a> variable.</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tuning-messages"></a>2. Reading messages from remote folders</h2></div></div></div><p>

3428

Reading messages from remote folders such as IMAP an POP can be

3429

slow especially for large mailboxes since mutt only caches a very

3430

limited number of recently viewed messages (usually 10) per

3431

session (so that it will be gone for the next session.)

3432

</p><p>

3433

To improve performance and permanently cache whole messages,

3434

please refer to mutt's so-called

3435

<a href="#body-caching" title="7.2. Body caching">body caching</a> for details.

3436

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="tuning-search"></a>3. Searching and limiting</h2></div></div></div><p>

3437

When searching mailboxes either via a search or a limit action, for

3438

some patterns mutt distinguishes between regular expression and string

3439

searches. For regular expressions, patterns are prefixed with

3440

``˜'' and with ``='' for string searches.

3441

</p><p>

3442

Even though a regular expression search is fast, it's several times

3443

slower than a pure string search which is noticable especially on large

3444

folders. As a consequence, a string search should be used instead of a

3445

regular expression search if the user already knows enough about the

3446

search pattern.

3447

</p><p>

3448

For example, when limiting a large folder to all messages sent to or by

3449

an author, it's much faster to search for the initial part of an e-mail

3450

address via <code class="literal">=Luser@</code> instead of

3451

<code class="literal">˜Luser@</code>. This is especially true for searching

3452

message bodies since a larger amount of input has to be searched.

3453

</p><p>

3454

Please note that string search is an exact case-sensitive search

3455

while a regular expression search with only lower-case letters performs

3456

a case-insensitive search.

3457

</p></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="reference"></a>Chapter 8. Reference</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#commandline">1. Command line options</a></span></dt><dt><span class="sect1"><a href="#commands">2. Configuration Commands</a></span></dt><dt><span class="sect1"><a href="#variables">3. Configuration variables</a></span></dt><dd><dl><dt><span class="sect2"><a href="#abort-nosubject">3.1. abort_nosubject</a></span></dt><dt><span class="sect2"><a href="#abort-unmodified">3.2. abort_unmodified</a></span></dt><dt><span class="sect2"><a href="#alias-file">3.3. alias_file</a></span></dt><dt><span class="sect2"><a href="#alias-format">3.4. alias_format</a></span></dt><dt><span class="sect2"><a href="#allow-8bit">3.5. allow_8bit</a></span></dt><dt><span class="sect2"><a href="#allow-ansi">3.6. allow_ansi</a></span></dt><dt><span class="sect2"><a href="#arrow-cursor">3.7. arrow_cursor</a></span></dt><dt><span class="sect2"><a href="#ascii-chars">3.8. ascii_chars</a></span></dt><dt><span class="sect2"><a href="#askbcc">3.9. askbcc</a></span></dt><dt><span class="sect2"><a href="#askcc">3.10. askcc</a></span></dt><dt><span class="sect2"><a href="#assumed-charset">3.11. assumed_charset</a></span></dt><dt><span class="sect2"><a href="#attach-charset">3.12. attach_charset</a></span></dt><dt><span class="sect2"><a href="#attach-format">3.13. attach_format</a></span></dt><dt><span class="sect2"><a href="#attach-sep">3.14. attach_sep</a></span></dt><dt><span class="sect2"><a href="#attach-split">3.15. attach_split</a></span></dt><dt><span class="sect2"><a href="#attribution">3.16. attribution</a></span></dt><dt><span class="sect2"><a href="#autoedit">3.17. autoedit</a></span></dt><dt><span class="sect2"><a href="#auto-tag">3.18. auto_tag</a></span></dt><dt><span class="sect2"><a href="#beep">3.19. beep</a></span></dt><dt><span class="sect2"><a href="#beep-new">3.20. beep_new</a></span></dt><dt><span class="sect2"><a href="#bounce">3.21. bounce</a></span></dt><dt><span class="sect2"><a href="#bounce-delivered">3.22. bounce_delivered</a></span></dt><dt><span class="sect2"><a href="#braille-friendly">3.23. braille_friendly</a></span></dt><dt><span class="sect2"><a href="#check-mbox-size">3.24. check_mbox_size</a></span></dt><dt><span class="sect2"><a href="#charset">3.25. charset</a></span></dt><dt><span class="sect2"><a href="#check-new">3.26. check_new</a></span></dt><dt><span class="sect2"><a href="#collapse-unread">3.27. collapse_unread</a></span></dt><dt><span class="sect2"><a href="#uncollapse-jump">3.28. uncollapse_jump</a></span></dt><dt><span class="sect2"><a href="#compose-format">3.29. compose_format</a></span></dt><dt><span class="sect2"><a href="#config-charset">3.30. config_charset</a></span></dt><dt><span class="sect2"><a href="#confirmappend">3.31. confirmappend</a></span></dt><dt><span class="sect2"><a href="#confirmcreate">3.32. confirmcreate</a></span></dt><dt><span class="sect2"><a href="#connect-timeout">3.33. connect_timeout</a></span></dt><dt><span class="sect2"><a href="#content-type">3.34. content_type</a></span></dt><dt><span class="sect2"><a href="#copy">3.35. copy</a></span></dt><dt><span class="sect2"><a href="#crypt-use-gpgme">3.36. crypt_use_gpgme</a></span></dt><dt><span class="sect2"><a href="#crypt-use-pka">3.37. crypt_use_pka</a></span></dt><dt><span class="sect2"><a href="#crypt-autopgp">3.38. crypt_autopgp</a></span></dt><dt><span class="sect2"><a href="#crypt-autosmime">3.39. crypt_autosmime</a></span></dt><dt><span class="sect2"><a href="#date-format">3.40. date_format</a></span></dt><dt><span class="sect2"><a href="#default-hook">3.41. default_hook</a></span></dt><dt><span class="sect2"><a href="#delete">3.42. delete</a></span></dt><dt><span class="sect2"><a href="#delete-untag">3.43. delete_untag</a></span></dt><dt><span class="sect2"><a href="#digest-collapse">3.44. digest_collapse</a></span></dt><dt><span class="sect2"><a href="#display-filter">3.45. display_filter</a></span></dt><dt><span class="sect2"><a href="#dotlock-program">3.46. dotlock_program</a></span></dt><dt><span class="sect2"><a href="#dsn-notify">3.47. dsn_notify</a></span></dt><dt><span class="sect2"><a href="#dsn-return">3.48. dsn_return</a></span></dt><dt><span class="sect2"><a href="#duplicate-threads">3.49. duplicate_threads</a></span></dt><dt><span class="sect2"><a href="#edit-headers">3.50. edit_headers</a></span></dt><dt><span class="sect2"><a href="#editor">3.51. editor</a></span></dt><dt><span class="sect2"><a href="#encode-from">3.52. encode_from</a></span></dt><dt><span class="sect2"><a href="#envelope-from-address">3.53. envelope_from_address</a></span></dt><dt><span class="sect2"><a href="#escape">3.54. escape</a></span></dt><dt><span class="sect2"><a href="#fast-reply">3.55. fast_reply</a></span></dt><dt><span class="sect2"><a href="#fcc-attach">3.56. fcc_attach</a></span></dt><dt><span class="sect2"><a href="#fcc-clear">3.57. fcc_clear</a></span></dt><dt><span class="sect2"><a href="#folder">3.58. folder</a></span></dt><dt><span class="sect2"><a href="#folder-format">3.59. folder_format</a></span></dt><dt><span class="sect2"><a href="#followup-to">3.60. followup_to</a></span></dt><dt><span class="sect2"><a href="#force-name">3.61. force_name</a></span></dt><dt><span class="sect2"><a href="#forward-decode">3.62. forward_decode</a></span></dt><dt><span class="sect2"><a href="#forward-edit">3.63. forward_edit</a></span></dt><dt><span class="sect2"><a href="#forward-format">3.64. forward_format</a></span></dt><dt><span class="sect2"><a href="#forward-quote">3.65. forward_quote</a></span></dt><dt><span class="sect2"><a href="#from">3.66. from</a></span></dt><dt><span class="sect2"><a href="#gecos-mask">3.67. gecos_mask</a></span></dt><dt><span class="sect2"><a href="#hdrs">3.68. hdrs</a></span></dt><dt><span class="sect2"><a href="#header">3.69. header</a></span></dt><dt><span class="sect2"><a href="#help">3.70. help</a></span></dt><dt><span class="sect2"><a href="#hidden-host">3.71. hidden_host</a></span></dt><dt><span class="sect2"><a href="#hide-limited">3.72. hide_limited</a></span></dt><dt><span class="sect2"><a href="#hide-missing">3.73. hide_missing</a></span></dt><dt><span class="sect2"><a href="#hide-thread-subject">3.74. hide_thread_subject</a></span></dt><dt><span class="sect2"><a href="#hide-top-limited">3.75. hide_top_limited</a></span></dt><dt><span class="sect2"><a href="#hide-top-missing">3.76. hide_top_missing</a></span></dt><dt><span class="sect2"><a href="#history">3.77. history</a></span></dt><dt><span class="sect2"><a href="#history-file">3.78. history_file</a></span></dt><dt><span class="sect2"><a href="#honor-followup-to">3.79. honor_followup_to</a></span></dt><dt><span class="sect2"><a href="#hostname">3.80. hostname</a></span></dt><dt><span class="sect2"><a href="#ignore-linear-white-space">3.81. ignore_linear_white_space</a></span></dt><dt><span class="sect2"><a href="#ignore-list-reply-to">3.82. ignore_list_reply_to</a></span></dt><dt><span class="sect2"><a href="#imap-authenticators">3.83. imap_authenticators</a></span></dt><dt><span class="sect2"><a href="#imap-check-subscribed">3.84. imap_check_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-delim-chars">3.85. imap_delim_chars</a></span></dt><dt><span class="sect2"><a href="#imap-headers">3.86. imap_headers</a></span></dt><dt><span class="sect2"><a href="#imap-idle">3.87. imap_idle</a></span></dt><dt><span class="sect2"><a href="#imap-keepalive">3.88. imap_keepalive</a></span></dt><dt><span class="sect2"><a href="#imap-list-subscribed">3.89. imap_list_subscribed</a></span></dt><dt><span class="sect2"><a href="#imap-login">3.90. imap_login</a></span></dt><dt><span class="sect2"><a href="#imap-pass">3.91. imap_pass</a></span></dt><dt><span class="sect2"><a href="#imap-passive">3.92. imap_passive</a></span></dt><dt><span class="sect2"><a href="#imap-peek">3.93. imap_peek</a></span></dt><dt><span class="sect2"><a href="#imap-servernoise">3.94. imap_servernoise</a></span></dt><dt><span class="sect2"><a href="#imap-user">3.95. imap_user</a></span></dt><dt><span class="sect2"><a href="#implicit-autoview">3.96. implicit_autoview</a></span></dt><dt><span class="sect2"><a href="#include">3.97. include</a></span></dt><dt><span class="sect2"><a href="#include-onlyfirst">3.98. include_onlyfirst</a></span></dt><dt><span class="sect2"><a href="#indent-string">3.99. indent_string</a></span></dt><dt><span class="sect2"><a href="#index-format">3.100. index_format</a></span></dt><dt><span class="sect2"><a href="#ispell">3.101. ispell</a></span></dt><dt><span class="sect2"><a href="#keep-flagged">3.102. keep_flagged</a></span></dt><dt><span class="sect2"><a href="#locale">3.103. locale</a></span></dt><dt><span class="sect2"><a href="#mail-check">3.104. mail_check</a></span></dt><dt><span class="sect2"><a href="#mailcap-path">3.105. mailcap_path</a></span></dt><dt><span class="sect2"><a href="#mailcap-sanitize">3.106. mailcap_sanitize</a></span></dt><dt><span class="sect2"><a href="#header-cache">3.107. header_cache</a></span></dt><dt><span class="sect2"><a href="#maildir-header-cache-verify">3.108. maildir_header_cache_verify</a></span></dt><dt><span class="sect2"><a href="#header-cache-pagesize">3.109. header_cache_pagesize</a></span></dt><dt><span class="sect2"><a href="#header-cache-compress">3.110. header_cache_compress</a></span></dt><dt><span class="sect2"><a href="#maildir-trash">3.111. maildir_trash</a></span></dt><dt><span class="sect2"><a href="#mark-old">3.112. mark_old</a></span></dt><dt><span class="sect2"><a href="#markers">3.113. markers</a></span></dt><dt><span class="sect2"><a href="#mask">3.114. mask</a></span></dt><dt><span class="sect2"><a href="#mbox">3.115. mbox</a></span></dt><dt><span class="sect2"><a href="#mbox-type">3.116. mbox_type</a></span></dt><dt><span class="sect2"><a href="#metoo">3.117. metoo</a></span></dt><dt><span class="sect2"><a href="#menu-context">3.118. menu_context</a></span></dt><dt><span class="sect2"><a href="#menu-move-off">3.119. menu_move_off</a></span></dt><dt><span class="sect2"><a href="#menu-scroll">3.120. menu_scroll</a></span></dt><dt><span class="sect2"><a href="#meta-key">3.121. meta_key</a></span></dt><dt><span class="sect2"><a href="#mh-purge">3.122. mh_purge</a></span></dt><dt><span class="sect2"><a href="#mh-seq-flagged">3.123. mh_seq_flagged</a></span></dt><dt><span class="sect2"><a href="#mh-seq-replied">3.124. mh_seq_replied</a></span></dt><dt><span class="sect2"><a href="#mh-seq-unseen">3.125. mh_seq_unseen</a></span></dt><dt><span class="sect2"><a href="#mime-forward">3.126. mime_forward</a></span></dt><dt><span class="sect2"><a href="#mime-forward-decode">3.127. mime_forward_decode</a></span></dt><dt><span class="sect2"><a href="#mime-forward-rest">3.128. mime_forward_rest</a></span></dt><dt><span class="sect2"><a href="#mix-entry-format">3.129. mix_entry_format</a></span></dt><dt><span class="sect2"><a href="#mixmaster">3.130. mixmaster</a></span></dt><dt><span class="sect2"><a href="#move">3.131. move</a></span></dt><dt><span class="sect2"><a href="#message-cachedir">3.132. message_cachedir</a></span></dt><dt><span class="sect2"><a href="#message-cache-clean">3.133. message_cache_clean</a></span></dt><dt><span class="sect2"><a href="#message-format">3.134. message_format</a></span></dt><dt><span class="sect2"><a href="#narrow-tree">3.135. narrow_tree</a></span></dt><dt><span class="sect2"><a href="#net-inc">3.136. net_inc</a></span></dt><dt><span class="sect2"><a href="#pager">3.137. pager</a></span></dt><dt><span class="sect2"><a href="#pager-context">3.138. pager_context</a></span></dt><dt><span class="sect2"><a href="#pager-format">3.139. pager_format</a></span></dt><dt><span class="sect2"><a href="#pager-index-lines">3.140. pager_index_lines</a></span></dt><dt><span class="sect2"><a href="#pager-stop">3.141. pager_stop</a></span></dt><dt><span class="sect2"><a href="#crypt-autosign">3.142. crypt_autosign</a></span></dt><dt><span class="sect2"><a href="#crypt-autoencrypt">3.143. crypt_autoencrypt</a></span></dt><dt><span class="sect2"><a href="#pgp-ignore-subkeys">3.144. pgp_ignore_subkeys</a></span></dt><dt><span class="sect2"><a href="#crypt-replyencrypt">3.145. crypt_replyencrypt</a></span></dt><dt><span class="sect2"><a href="#crypt-replysign">3.146. crypt_replysign</a></span></dt><dt><span class="sect2"><a href="#crypt-replysignencrypted">3.147. crypt_replysignencrypted</a></span></dt><dt><span class="sect2"><a href="#crypt-timestamp">3.148. crypt_timestamp</a></span></dt><dt><span class="sect2"><a href="#pgp-use-gpg-agent">3.149. pgp_use_gpg_agent</a></span></dt><dt><span class="sect2"><a href="#crypt-verify-sig">3.150. crypt_verify_sig</a></span></dt><dt><span class="sect2"><a href="#smime-is-default">3.151. smime_is_default</a></span></dt><dt><span class="sect2"><a href="#smime-ask-cert-label">3.152. smime_ask_cert_label</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-use-default-key">3.153. smime_decrypt_use_default_key</a></span></dt><dt><span class="sect2"><a href="#pgp-entry-format">3.154. pgp_entry_format</a></span></dt><dt><span class="sect2"><a href="#pgp-good-sign">3.155. pgp_good_sign</a></span></dt><dt><span class="sect2"><a href="#pgp-check-exit">3.156. pgp_check_exit</a></span></dt><dt><span class="sect2"><a href="#pgp-long-ids">3.157. pgp_long_ids</a></span></dt><dt><span class="sect2"><a href="#pgp-retainable-sigs">3.158. pgp_retainable_sigs</a></span></dt><dt><span class="sect2"><a href="#pgp-autoinline">3.159. pgp_autoinline</a></span></dt><dt><span class="sect2"><a href="#pgp-replyinline">3.160. pgp_replyinline</a></span></dt><dt><span class="sect2"><a href="#pgp-show-unusable">3.161. pgp_show_unusable</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-as">3.162. pgp_sign_as</a></span></dt><dt><span class="sect2"><a href="#pgp-strict-enc">3.163. pgp_strict_enc</a></span></dt><dt><span class="sect2"><a href="#pgp-timeout">3.164. pgp_timeout</a></span></dt><dt><span class="sect2"><a href="#pgp-sort-keys">3.165. pgp_sort_keys</a></span></dt><dt><span class="sect2"><a href="#pgp-mime-auto">3.166. pgp_mime_auto</a></span></dt><dt><span class="sect2"><a href="#pgp-auto-decode">3.167. pgp_auto_decode</a></span></dt><dt><span class="sect2"><a href="#pgp-decode-command">3.168. pgp_decode_command</a></span></dt><dt><span class="sect2"><a href="#pgp-getkeys-command">3.169. pgp_getkeys_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-command">3.170. pgp_verify_command</a></span></dt><dt><span class="sect2"><a href="#pgp-decrypt-command">3.171. pgp_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#pgp-clearsign-command">3.172. pgp_clearsign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-sign-command">3.173. pgp_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-sign-command">3.174. pgp_encrypt_sign_command</a></span></dt><dt><span class="sect2"><a href="#pgp-encrypt-only-command">3.175. pgp_encrypt_only_command</a></span></dt><dt><span class="sect2"><a href="#pgp-import-command">3.176. pgp_import_command</a></span></dt><dt><span class="sect2"><a href="#pgp-export-command">3.177. pgp_export_command</a></span></dt><dt><span class="sect2"><a href="#pgp-verify-key-command">3.178. pgp_verify_key_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-secring-command">3.179. pgp_list_secring_command</a></span></dt><dt><span class="sect2"><a href="#pgp-list-pubring-command">3.180. pgp_list_pubring_command</a></span></dt><dt><span class="sect2"><a href="#forward-decrypt">3.181. forward_decrypt</a></span></dt><dt><span class="sect2"><a href="#smime-timeout">3.182. smime_timeout</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-with">3.183. smime_encrypt_with</a></span></dt><dt><span class="sect2"><a href="#smime-keys">3.184. smime_keys</a></span></dt><dt><span class="sect2"><a href="#smime-ca-location">3.185. smime_ca_location</a></span></dt><dt><span class="sect2"><a href="#smime-certificates">3.186. smime_certificates</a></span></dt><dt><span class="sect2"><a href="#smime-decrypt-command">3.187. smime_decrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-command">3.188. smime_verify_command</a></span></dt><dt><span class="sect2"><a href="#smime-verify-opaque-command">3.189. smime_verify_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-command">3.190. smime_sign_command</a></span></dt><dt><span class="sect2"><a href="#smime-sign-opaque-command">3.191. smime_sign_opaque_command</a></span></dt><dt><span class="sect2"><a href="#smime-encrypt-command">3.192. smime_encrypt_command</a></span></dt><dt><span class="sect2"><a href="#smime-pk7out-command">3.193. smime_pk7out_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-command">3.194. smime_get_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-signer-cert-command">3.195. smime_get_signer_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-import-cert-command">3.196. smime_import_cert_command</a></span></dt><dt><span class="sect2"><a href="#smime-get-cert-email-command">3.197. smime_get_cert_email_command</a></span></dt><dt><span class="sect2"><a href="#smime-default-key">3.198. smime_default_key</a></span></dt><dt><span class="sect2"><a href="#ssl-client-cert">3.199. ssl_client_cert</a></span></dt><dt><span class="sect2"><a href="#ssl-force-tls">3.200. ssl_force_tls</a></span></dt><dt><span class="sect2"><a href="#ssl-starttls">3.201. ssl_starttls</a></span></dt><dt><span class="sect2"><a href="#certificate-file">3.202. certificate_file</a></span></dt><dt><span class="sect2"><a href="#ssl-usesystemcerts">3.203. ssl_usesystemcerts</a></span></dt><dt><span class="sect2"><a href="#entropy-file">3.204. entropy_file</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv2">3.205. ssl_use_sslv2</a></span></dt><dt><span class="sect2"><a href="#ssl-use-sslv3">3.206. ssl_use_sslv3</a></span></dt><dt><span class="sect2"><a href="#ssl-use-tlsv1">3.207. ssl_use_tlsv1</a></span></dt><dt><span class="sect2"><a href="#ssl-min-dh-prime-bits">3.208. ssl_min_dh_prime_bits</a></span></dt><dt><span class="sect2"><a href="#ssl-ca-certificates-file">3.209. ssl_ca_certificates_file</a></span></dt><dt><span class="sect2"><a href="#pipe-split">3.210. pipe_split</a></span></dt><dt><span class="sect2"><a href="#pipe-decode">3.211. pipe_decode</a></span></dt><dt><span class="sect2"><a href="#pipe-sep">3.212. pipe_sep</a></span></dt><dt><span class="sect2"><a href="#pop-authenticators">3.213. pop_authenticators</a></span></dt><dt><span class="sect2"><a href="#pop-auth-try-all">3.214. pop_auth_try_all</a></span></dt><dt><span class="sect2"><a href="#pop-checkinterval">3.215. pop_checkinterval</a></span></dt><dt><span class="sect2"><a href="#pop-delete">3.216. pop_delete</a></span></dt><dt><span class="sect2"><a href="#pop-host">3.217. pop_host</a></span></dt><dt><span class="sect2"><a href="#pop-last">3.218. pop_last</a></span></dt><dt><span class="sect2"><a href="#pop-reconnect">3.219. pop_reconnect</a></span></dt><dt><span class="sect2"><a href="#pop-user">3.220. pop_user</a></span></dt><dt><span class="sect2"><a href="#pop-pass">3.221. pop_pass</a></span></dt><dt><span class="sect2"><a href="#post-indent-string">3.222. post_indent_string</a></span></dt><dt><span class="sect2"><a href="#postpone">3.223. postpone</a></span></dt><dt><span class="sect2"><a href="#postponed">3.224. postponed</a></span></dt><dt><span class="sect2"><a href="#preconnect">3.225. preconnect</a></span></dt><dt><span class="sect2"><a href="#print">3.226. print</a></span></dt><dt><span class="sect2"><a href="#print-command">3.227. print_command</a></span></dt><dt><span class="sect2"><a href="#print-decode">3.228. print_decode</a></span></dt><dt><span class="sect2"><a href="#print-split">3.229. print_split</a></span></dt><dt><span class="sect2"><a href="#prompt-after">3.230. prompt_after</a></span></dt><dt><span class="sect2"><a href="#query-command">3.231. query_command</a></span></dt><dt><span class="sect2"><a href="#query-format">3.232. query_format</a></span></dt><dt><span class="sect2"><a href="#quit">3.233. quit</a></span></dt><dt><span class="sect2"><a href="#quote-regexp">3.234. quote_regexp</a></span></dt><dt><span class="sect2"><a href="#read-inc">3.235. read_inc</a></span></dt><dt><span class="sect2"><a href="#read-only">3.236. read_only</a></span></dt><dt><span class="sect2"><a href="#realname">3.237. realname</a></span></dt><dt><span class="sect2"><a href="#recall">3.238. recall</a></span></dt><dt><span class="sect2"><a href="#record">3.239. record</a></span></dt><dt><span class="sect2"><a href="#reply-regexp">3.240. reply_regexp</a></span></dt><dt><span class="sect2"><a href="#reply-self">3.241. reply_self</a></span></dt><dt><span class="sect2"><a href="#reply-to">3.242. reply_to</a></span></dt><dt><span class="sect2"><a href="#resolve">3.243. resolve</a></span></dt><dt><span class="sect2"><a href="#reverse-alias">3.244. reverse_alias</a></span></dt><dt><span class="sect2"><a href="#reverse-name">3.245. reverse_name</a></span></dt><dt><span class="sect2"><a href="#reverse-realname">3.246. reverse_realname</a></span></dt><dt><span class="sect2"><a href="#rfc2047-parameters">3.247. rfc2047_parameters</a></span></dt><dt><span class="sect2"><a href="#save-address">3.248. save_address</a></span></dt><dt><span class="sect2"><a href="#save-empty">3.249. save_empty</a></span></dt><dt><span class="sect2"><a href="#save-history">3.250. save_history</a></span></dt><dt><span class="sect2"><a href="#save-name">3.251. save_name</a></span></dt><dt><span class="sect2"><a href="#score">3.252. score</a></span></dt><dt><span class="sect2"><a href="#score-threshold-delete">3.253. score_threshold_delete</a></span></dt><dt><span class="sect2"><a href="#score-threshold-flag">3.254. score_threshold_flag</a></span></dt><dt><span class="sect2"><a href="#score-threshold-read">3.255. score_threshold_read</a></span></dt><dt><span class="sect2"><a href="#send-charset">3.256. send_charset</a></span></dt><dt><span class="sect2"><a href="#sendmail">3.257. sendmail</a></span></dt><dt><span class="sect2"><a href="#sendmail-wait">3.258. sendmail_wait</a></span></dt><dt><span class="sect2"><a href="#shell">3.259. shell</a></span></dt><dt><span class="sect2"><a href="#sig-dashes">3.260. sig_dashes</a></span></dt><dt><span class="sect2"><a href="#sig-on-top">3.261. sig_on_top</a></span></dt><dt><span class="sect2"><a href="#signature">3.262. signature</a></span></dt><dt><span class="sect2"><a href="#simple-search">3.263. simple_search</a></span></dt><dt><span class="sect2"><a href="#smart-wrap">3.264. smart_wrap</a></span></dt><dt><span class="sect2"><a href="#smileys">3.265. smileys</a></span></dt><dt><span class="sect2"><a href="#sleep-time">3.266. sleep_time</a></span></dt><dt><span class="sect2"><a href="#smtp-authenticators">3.267. smtp_authenticators</a></span></dt><dt><span class="sect2"><a href="#smtp-pass">3.268. smtp_pass</a></span></dt><dt><span class="sect2"><a href="#smtp-url">3.269. smtp_url</a></span></dt><dt><span class="sect2"><a href="#sort">3.270. sort</a></span></dt><dt><span class="sect2"><a href="#sort-alias">3.271. sort_alias</a></span></dt><dt><span class="sect2"><a href="#sort-aux">3.272. sort_aux</a></span></dt><dt><span class="sect2"><a href="#sort-browser">3.273. sort_browser</a></span></dt><dt><span class="sect2"><a href="#sort-re">3.274. sort_re</a></span></dt><dt><span class="sect2"><a href="#spam-separator">3.275. spam_separator</a></span></dt><dt><span class="sect2"><a href="#spoolfile">3.276. spoolfile</a></span></dt><dt><span class="sect2"><a href="#status-chars">3.277. status_chars</a></span></dt><dt><span class="sect2"><a href="#status-format">3.278. status_format</a></span></dt><dt><span class="sect2"><a href="#status-on-top">3.279. status_on_top</a></span></dt><dt><span class="sect2"><a href="#strict-threads">3.280. strict_threads</a></span></dt><dt><span class="sect2"><a href="#suspend">3.281. suspend</a></span></dt><dt><span class="sect2"><a href="#text-flowed">3.282. text_flowed</a></span></dt><dt><span class="sect2"><a href="#thread-received">3.283. thread_received</a></span></dt><dt><span class="sect2"><a href="#thorough-search">3.284. thorough_search</a></span></dt><dt><span class="sect2"><a href="#tilde">3.285. tilde</a></span></dt><dt><span class="sect2"><a href="#time-inc">3.286. time_inc</a></span></dt><dt><span class="sect2"><a href="#timeout">3.287. timeout</a></span></dt><dt><span class="sect2"><a href="#tmpdir">3.288. tmpdir</a></span></dt><dt><span class="sect2"><a href="#to-chars">3.289. to_chars</a></span></dt><dt><span class="sect2"><a href="#tunnel">3.290. tunnel</a></span></dt><dt><span class="sect2"><a href="#use-8bitmime">3.291. use_8bitmime</a></span></dt><dt><span class="sect2"><a href="#use-domain">3.292. use_domain</a></span></dt><dt><span class="sect2"><a href="#use-envelope-from">3.293. use_envelope_from</a></span></dt><dt><span class="sect2"><a href="#use-from">3.294. use_from</a></span></dt><dt><span class="sect2"><a href="#use-idn">3.295. use_idn</a></span></dt><dt><span class="sect2"><a href="#use-ipv6">3.296. use_ipv6</a></span></dt><dt><span class="sect2"><a href="#user-agent">3.297. user_agent</a></span></dt><dt><span class="sect2"><a href="#visual">3.298. visual</a></span></dt><dt><span class="sect2"><a href="#wait-key">3.299. wait_key</a></span></dt><dt><span class="sect2"><a href="#weed">3.300. weed</a></span></dt><dt><span class="sect2"><a href="#wrap">3.301. wrap</a></span></dt><dt><span class="sect2"><a href="#wrap-search">3.302. wrap_search</a></span></dt><dt><span class="sect2"><a href="#wrapmargin">3.303. wrapmargin</a></span></dt><dt><span class="sect2"><a href="#write-inc">3.304. write_inc</a></span></dt><dt><span class="sect2"><a href="#write-bcc">3.305. write_bcc</a></span></dt></dl></dd><dt><span class="sect1"><a href="#functions">4. Functions</a></span></dt><dd><dl><dt><span class="sect2"><a href="#generic_map">4.1. generic</a></span></dt><dt><span class="sect2"><a href="#index_map">4.2. index</a></span></dt><dt><span class="sect2"><a href="#pager_map">4.3. pager</a></span></dt><dt><span class="sect2"><a href="#alias_map">4.4. alias</a></span></dt><dt><span class="sect2"><a href="#query_map">4.5. query</a></span></dt><dt><span class="sect2"><a href="#attach_map">4.6. attach</a></span></dt><dt><span class="sect2"><a href="#compose_map">4.7. compose</a></span></dt><dt><span class="sect2"><a href="#postpone_map">4.8. postpone</a></span></dt><dt><span class="sect2"><a href="#browser_map">4.9. browser</a></span></dt><dt><span class="sect2"><a href="#pgp_map">4.10. pgp</a></span></dt><dt><span class="sect2"><a href="#smime_map">4.11. smime</a></span></dt><dt><span class="sect2"><a href="#mix_map">4.12. mix</a></span></dt><dt><span class="sect2"><a href="#editor_map">4.13. editor</a></span></dt></dl></dd></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commandline"></a>1. Command line options</h2></div></div></div><p>

3123

3458

Running <code class="literal">mutt</code> with no arguments will make Mutt attempt to read your spool

3124

3459

mailbox. However, it is possible to read other mailboxes and

3125

3460

to send messages from the command line as well.

3126

3461

</p><p>

3127

3462

3128

</p><div class="table"><a id="id2888098"></a><p class="title"><b>Table 6.1. Command line options</b></p><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 mailboxes 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><p>

3463

</p><div class="table"><a id="id463727"></a><p class="title"><b>Table 8.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 mailboxes 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><p><br class="table-break" />

3129

3464

3130

3465

</p><p>

3131

3466

To read messages in a mailbox

3134

3469

</p><p>

3135

3470

To compose a new message

3136

3471

</p><p>

3137

<code class="literal">mutt</code> [ -n ] [ -F <span class="emphasis"><em>muttrc</em></span> ] [ -a <span class="emphasis"><em>file</em></span> ] [ -c <span class="emphasis"><em>address</em></span> ] [ -i <span class="emphasis"><em>filename</em></span> ] [ -s <span class="emphasis"><em>subject</em></span> ] <span class="emphasis"><em>address</em></span> [ <span class="emphasis"><em>address</em></span> ... ]

3472

<code class="literal">mutt</code> [ -n ] [ -F <span class="emphasis"><em>muttrc</em></span> ] [ -a <span class="emphasis"><em>file</em></span> ] [ -c <span class="emphasis"><em>address</em></span> ] [ -i <span class="emphasis"><em>filename</em></span> ] [ -s <span class="emphasis"><em>subject</em></span> ]

3473

[ [ <span class="emphasis"><em>file</em></span> ... ] -- ] <span class="emphasis"><em>address</em></span> [ <span class="emphasis"><em>address</em></span> ... ]

3138

3474

</p><p>

3139

3475

Mutt also supports a ``batch'' mode to send prepared messages. Simply redirect

3140

3476

input from the file you wish to send. For example,

3145

3481

This command will send a message to ``professor@bigschool.edu'' with a subject

3146

3482

of ``data set for run #2''. In the body of the message will be the contents

3147

3483

of the file ``˜/run2.dat''.

3484

</p><p>

3485

All files passed with -a <span class="emphasis"><em>file</em></span> will be attached as a MIME

3486

part to the message. To attach several files, use ``--'' to separate files and

3487

recipient addresses: <code class="literal">mutt -a *.png -- some@one.org</code>

3148

3488

</p></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="commands"></a>2. Configuration Commands</h2></div></div></div><p>

3149

3489

The following are the commands understood by mutt.

3150

3490

</p><p>

3151

3491

3152

3492

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

3153

<code class="literal"><a href="#account-hook" title="13. Managing multiple IMAP/POP accounts (OPTIONAL)">account-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3154

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

3155

<code class="literal"><a href="#alias" title="2. Defining/Using aliases">alias</a></code> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>address</em></span> [ , <span class="emphasis"><em>address</em></span>, ... ]

3156

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

3157

<code class="literal"><a href="#alias" title="2. Defining/Using aliases">unalias</a></code> [ * | <span class="emphasis"><em>key</em></span> ... ]

3158

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

3159

<code class="literal"><a href="#alternates" title="9. Alternative addresses">alternates</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3160

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

3161

<code class="literal"><a href="#alternates" title="9. Alternative addresses">unalternates</a></code> [ * | <span class="emphasis"><em>regexp</em></span> ... ]

3493

<code class="literal"><a href="#account-hook" title="6. Managing multiple accounts">account-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3494

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

3495

<code class="literal"><a href="#alias" title="3. Defining/Using aliases">alias</a></code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>address</em></span> [ , <span class="emphasis"><em>address</em></span>, ... ]

3496

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

3497

<code class="literal"><a href="#alias" title="3. Defining/Using aliases">unalias</a></code> [ * | <span class="emphasis"><em>key</em></span> ... ]

3498

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

3499

<code class="literal"><a href="#alternates" title="10. Alternative addresses">alternates</a></code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3500

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

3501

<code class="literal"><a href="#alternates" title="10. Alternative addresses">unalternates</a></code> [ * | <span class="emphasis"><em>regexp</em></span> ... ]

3162

3502

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

3163

3503

<code class="literal"><a href="#alternative-order" title="5. MIME Multipart/Alternative">alternative-order</a></code> <span class="emphasis"><em>mimetype</em></span> [ <span class="emphasis"><em>mimetype</em></span> ... ]

3164

3504

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

3168

3508

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

3169

3509

<code class="literal"><a href="#auto-view" title="4. MIME Autoview">unauto_view</a></code> <span class="emphasis"><em>mimetype</em></span> [ <span class="emphasis"><em>mimetype</em></span> ... ]

3170

3510

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

3171

<code class="literal"><a href="#bind" title="3. Changing the default key bindings">bind</a></code> <span class="emphasis"><em>map</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>function</em></span>

3172

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

3173

<code class="literal"><a href="#charset-hook" title="4. Defining aliases for character sets ">charset-hook</a></code> <span class="emphasis"><em>alias</em></span> <span class="emphasis"><em>charset</em></span>

3174

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

3175

<code class="literal"><a href="#color" title="7. Using color and mono video attributes">color</a></code> <span class="emphasis"><em>object</em></span> <span class="emphasis"><em>foreground</em></span> <span class="emphasis"><em>background</em></span> [ <span class="emphasis"><em>regexp</em></span> ]

3176

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

3177

<code class="literal"><a href="#color" title="7. Using color and mono video attributes">uncolor</a></code> <span class="emphasis"><em>index</em></span> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3178

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

3179

<code class="literal"><a href="#exec" title="22. Executing functions">exec</a></code> <span class="emphasis"><em>function</em></span> [ <span class="emphasis"><em>function</em></span> ... ]

3180

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

3181

<code class="literal"><a href="#fcc-hook" title="16. Specify default Fcc: mailbox when composing">fcc-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

3182

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

3183

<code class="literal"><a href="#fcc-save-hook" title="17. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

3184

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

3185

<code class="literal"><a href="#folder-hook" title="5. Setting variables based upon mailbox">folder-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3186

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

3187

<code class="literal"><a href="#hdr-order" title="14. Defining the order of headers when viewing messages">hdr_order</a></code> <span class="emphasis"><em>header</em></span> [ <span class="emphasis"><em>header</em></span> ... ]

3188

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

3189

<code class="literal"><a href="#hdr-order" title="14. Defining the order of headers when viewing messages">unhdr_order</a></code> <span class="emphasis"><em>header</em></span> [ <span class="emphasis"><em>header</em></span> ... ]

3190

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

3191

<code class="literal"><a href="#charset-hook" title="4. Defining aliases for character sets ">charset-hook</a></code> <span class="emphasis"><em>charset</em></span> <span class="emphasis"><em>local-charset</em></span>

3192

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

3193

<code class="literal"><a href="#ignore" title="8. Ignoring (weeding) unwanted message headers">ignore</a></code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3194

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

3195

<code class="literal"><a href="#ignore" title="8. Ignoring (weeding) unwanted message headers">unignore</a></code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3196

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

3197

<code class="literal"><a href="#lists" title="10. Mailing lists">lists</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3198

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

3199

<code class="literal"><a href="#lists" title="10. Mailing lists">unlists</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3200

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

3201

<code class="literal"><a href="#macro" title="6. Keyboard macros">macro</a></code> <span class="emphasis"><em>menu</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>sequence</em></span> [ <span class="emphasis"><em>description</em></span> ]

3202

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

3203

<code class="literal"><a href="#mailboxes" title="12. Defining mailboxes which receive mail">mailboxes</a></code> <span class="emphasis"><em>filename</em></span> [ <span class="emphasis"><em>filename</em></span> ... ]

3204

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

3205

<code class="literal"><a href="#mbox-hook" title="11. Using Multiple spool mailboxes">mbox-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

3206

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

3207

<code class="literal"><a href="#message-hook" title="19. Change settings before formatting a message">message-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3511

<code class="literal"><a href="#bind" title="4. Changing the default key bindings">bind</a></code> <span class="emphasis"><em>map</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>function</em></span>

3512

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

3513

<code class="literal"><a href="#charset-hook" title="5. Defining aliases for character sets">charset-hook</a></code> <span class="emphasis"><em>alias</em></span> <span class="emphasis"><em>charset</em></span>

3514

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

3515

<code class="literal"><a href="#charset-hook" title="5. Defining aliases for character sets">iconv-hook</a></code> <span class="emphasis"><em>charset</em></span> <span class="emphasis"><em>local-charset</em></span>

3516

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

3517

<code class="literal"><a href="#color" title="8. Using color and mono video attributes">color</a></code> <span class="emphasis"><em>object</em></span> <span class="emphasis"><em>foreground</em></span> <span class="emphasis"><em>background</em></span> [ <span class="emphasis"><em>regexp</em></span> ]

3518

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

3519

<code class="literal"><a href="#color" title="8. Using color and mono video attributes">uncolor</a></code> <span class="emphasis"><em>index</em></span> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3520

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

3521

<code class="literal"><a href="#exec" title="23. Executing functions">exec</a></code> <span class="emphasis"><em>function</em></span> [ <span class="emphasis"><em>function</em></span> ... ]

3522

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

3523

<code class="literal"><a href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

3524

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

3525

<code class="literal"><a href="#fcc-save-hook" title="18. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

3526

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

3527

<code class="literal"><a href="#folder-hook" title="6. Setting variables based upon mailbox">folder-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3528

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

3529

<code class="literal"><a href="#hdr-order" title="15. Defining the order of headers when viewing messages">hdr_order</a></code> <span class="emphasis"><em>header</em></span> [ <span class="emphasis"><em>header</em></span> ... ]

3530

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

3531

<code class="literal"><a href="#hdr-order" title="15. Defining the order of headers when viewing messages">unhdr_order</a></code> <span class="emphasis"><em>header</em></span> [ <span class="emphasis"><em>header</em></span> ... ]

3532

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

3533

<code class="literal"><a href="#ignore" title="9. Ignoring (weeding) unwanted message headers">ignore</a></code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3534

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

3535

<code class="literal"><a href="#ignore" title="9. Ignoring (weeding) unwanted message headers">unignore</a></code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3536

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

3537

<code class="literal"><a href="#lists" title="11. Mailing lists">lists</a></code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3538

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

3539

<code class="literal"><a href="#lists" title="11. Mailing lists">unlists</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3540

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

3541

<code class="literal"><a href="#macro" title="7. Keyboard macros">macro</a></code> <span class="emphasis"><em>menu</em></span> <span class="emphasis"><em>key</em></span> <span class="emphasis"><em>sequence</em></span> [ <span class="emphasis"><em>description</em></span> ]

3542

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

3543

<code class="literal"><a href="#mailboxes" title="13. Monitoring incoming mail">mailboxes</a></code> <span class="emphasis"><em>filename</em></span> [ <span class="emphasis"><em>filename</em></span> ... ]

3544

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

3545

<code class="literal"><a href="#mbox-hook" title="12. Using Multiple spool mailboxes">mbox-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>mailbox</em></span>

3546

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

3547

<code class="literal"><a href="#message-hook" title="20. Change settings before formatting a message">message-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3208

3548

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

3209

3549

<code class="literal"><a href="#mime-lookup" title="7. MIME Lookup">mime_lookup</a></code> <span class="emphasis"><em>mimetype</em></span> [ <span class="emphasis"><em>mimetype</em></span> ... ]

3210

3550

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

3211

3551

<code class="literal"><a href="#mime-lookup" title="7. MIME Lookup">unmime_lookup</a></code> <span class="emphasis"><em>mimetype</em></span> [ <span class="emphasis"><em>mimetype</em></span> ... ]

3212

3552

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

3213

<code class="literal"><a href="#color" title="7. Using color and mono video attributes">mono</a></code> <span class="emphasis"><em>object attribute</em></span> [ <span class="emphasis"><em>regexp</em></span> ]

3214

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

3215

<code class="literal"><a href="#color" title="7. Using color and mono video attributes">unmono</a></code> <span class="emphasis"><em>index</em></span> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3216

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

3217

<code class="literal"><a href="#my-hdr" title="13. User defined headers">my_hdr</a></code> <span class="emphasis"><em>string</em></span>

3218

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

3219

<code class="literal"><a href="#my-hdr" title="13. User defined headers">unmy_hdr</a></code> <span class="emphasis"><em>field</em></span> [ <span class="emphasis"><em>field</em></span> ... ]

3220

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

3221

<code class="literal"><a href="#crypt-hook" title="20. Choosing the cryptographic key of the recipient">crypt-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>key-id</em></span>

3222

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

3223

<code class="literal"><a href="#push" title="21. Adding key sequences to the keyboard buffer">push</a></code> <span class="emphasis"><em>string</em></span>

3224

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

3225

<code class="literal"><a href="#set" title="25. Setting and Querying Variables">reset</a></code> <span class="emphasis"><em>variable</em></span> [<span class="emphasis"><em>variable</em></span> ... ]

3226

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

3227

<code class="literal"><a href="#save-hook" title="15. Specify default save filename">save-hook</a></code> <span class="emphasis"><em>regexp</em></span> <span class="emphasis"><em>filename</em></span>

3228

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

3229

<code class="literal"><a href="#score-command" title="23. Message Scoring">score</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>value</em></span>

3230

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

3231

<code class="literal"><a href="#score-command" title="23. Message Scoring">unscore</a></code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3232

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

3233

<code class="literal"><a href="#send-hook" title="18. Change settings based upon message recipients">send-hook</a></code> <span class="emphasis"><em>regexp</em></span> <span class="emphasis"><em>command</em></span>

3234

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

3235

<code class="literal"><a href="#send-hook" title="18. Change settings based upon message recipients">reply-hook</a></code> <span class="emphasis"><em>regexp</em></span> <span class="emphasis"><em>command</em></span>

3236

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

3237

<code class="literal"><a href="#set" title="25. Setting and Querying Variables">set</a></code> [no|inv]<span class="emphasis"><em>variable</em></span>[=<span class="emphasis"><em>value</em></span>] [ <span class="emphasis"><em>variable</em></span> ... ]

3238

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

3239

<code class="literal"><a href="#set" title="25. Setting and Querying Variables">unset</a></code> <span class="emphasis"><em>variable</em></span> [<span class="emphasis"><em>variable</em></span> ... ]

3240

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

3241

<code class="literal"><a href="#source" title="26. Reading initialization commands from another file">source</a></code> <span class="emphasis"><em>filename</em></span>

3242

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

3243

<code class="literal"><a href="#spam" title="24. Spam detection">spam</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>format</em></span>

3244

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

3245

<code class="literal"><a href="#spam" title="24. Spam detection">nospam</a></code> <span class="emphasis"><em>pattern</em></span>

3246

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

3247

<code class="literal"><a href="#lists" title="10. Mailing lists">subscribe</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3248

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

3249

<code class="literal"><a href="#lists" title="10. Mailing lists">unsubscribe</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3250

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

3251

<code class="literal"><a href="#set" title="25. Setting and Querying Variables">toggle</a></code> <span class="emphasis"><em>variable</em></span> [<span class="emphasis"><em>variable</em></span> ... ]

3252

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

3253

<code class="literal"><a href="#unhook" title="27. Removing hooks">unhook</a></code> <span class="emphasis"><em>hook-type</em></span>

3553

<code class="literal"><a href="#color" title="8. Using color and mono video attributes">mono</a></code> <span class="emphasis"><em>object attribute</em></span> [ <span class="emphasis"><em>regexp</em></span> ]

3554

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

3555

<code class="literal"><a href="#color" title="8. Using color and mono video attributes">unmono</a></code> <span class="emphasis"><em>index</em></span> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3556

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

3557

<code class="literal"><a href="#my-hdr" title="14. User defined headers">my_hdr</a></code> <span class="emphasis"><em>string</em></span>

3558

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

3559

<code class="literal"><a href="#my-hdr" title="14. User defined headers">unmy_hdr</a></code> <span class="emphasis"><em>field</em></span> [ <span class="emphasis"><em>field</em></span> ... ]

3560

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

3561

<code class="literal"><a href="#crypt-hook" title="21. Choosing the cryptographic key of the recipient">crypt-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>key-id</em></span>

3562

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

3563

<code class="literal"><a href="#push" title="22. Adding key sequences to the keyboard buffer">push</a></code> <span class="emphasis"><em>string</em></span>

3564

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

3565

<code class="literal"><a href="#set" title="26. Setting and Querying Variables">reset</a></code> <span class="emphasis"><em>variable</em></span> [<span class="emphasis"><em>variable</em></span> ... ]

3566

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

3567

<code class="literal"><a href="#save-hook" title="16. Specify default save mailbox">save-hook</a></code> <span class="emphasis"><em>regexp</em></span> <span class="emphasis"><em>filename</em></span>

3568

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

3569

<code class="literal"><a href="#score-command" title="24. Message Scoring">score</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>value</em></span>

3570

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

3571

<code class="literal"><a href="#score-command" title="24. Message Scoring">unscore</a></code> <span class="emphasis"><em>pattern</em></span> [ <span class="emphasis"><em>pattern</em></span> ... ]

3572

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

3573

<code class="literal"><a href="#send-hook" title="19. Change settings based upon message recipients">reply-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3574

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

3575

<code class="literal"><a href="#send-hook" title="19. Change settings based upon message recipients">send-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3576

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

3577

<code class="literal"><a href="#send-hook" title="19. Change settings based upon message recipients">send2-hook</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>command</em></span>

3578

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

3579

<code class="literal"><a href="#set" title="26. Setting and Querying Variables">set</a></code> [no|inv]<span class="emphasis"><em>variable</em></span>[=<span class="emphasis"><em>value</em></span>] [ <span class="emphasis"><em>variable</em></span> ... ]

3580

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

3581

<code class="literal"><a href="#set" title="26. Setting and Querying Variables">unset</a></code> <span class="emphasis"><em>variable</em></span> [<span class="emphasis"><em>variable</em></span> ... ]

3582

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

3583

<code class="literal"><a href="#source" title="27. Reading initialization commands from another file">source</a></code> <span class="emphasis"><em>filename</em></span>

3584

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

3585

<code class="literal"><a href="#spam" title="25. Spam detection">spam</a></code> <span class="emphasis"><em>pattern</em></span> <span class="emphasis"><em>format</em></span>

3586

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

3587

<code class="literal"><a href="#spam" title="25. Spam detection">nospam</a></code> <span class="emphasis"><em>pattern</em></span>

3588

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

3589

<code class="literal"><a href="#lists" title="11. Mailing lists">subscribe</a></code> [ <code class="literal">-group</code> <span class="emphasis"><em>name</em></span> [ ... ] ] <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3590

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

3591

<code class="literal"><a href="#lists" title="11. Mailing lists">unsubscribe</a></code> <span class="emphasis"><em>regexp</em></span> [ <span class="emphasis"><em>regexp</em></span> ... ]

3592

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

3593

<code class="literal"><a href="#set" title="26. Setting and Querying Variables">toggle</a></code> <span class="emphasis"><em>variable</em></span> [<span class="emphasis"><em>variable</em></span> ... ]

3594

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

3595

<code class="literal"><a href="#unhook" title="28. Removing hooks">unhook</a></code> <span class="emphasis"><em>hook-type</em></span>

3254

3596

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

3255

3597

3256

3598

</p></div><div class="sect1" lang="en" xml:lang="en"><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" lang="en" xml:lang="en"><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 />

3271

3613

``<a href="#create-alias">create-alias</a>'' function.

3272

3614

</p><p>

3273

3615

<span class="bold"><strong>Note:</strong></span> Mutt will not automatically source this file; you must

3274

explicitly use the ``<a href="#source" title="26. Reading initialization commands from another file">source</a>'' command for it to be executed.

3616

explicitly use the ``<a href="#source" title="27. Reading initialization commands from another file">source</a>'' command for it to be executed.

3617

</p><p>

3618

The default for this option is the currently used muttrc file, or

3619

``˜/.muttrc'' if no user muttrc was found.

3275

3620

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3276

3621

Default: "%4n %2f %t %-10a %r"</p></div><p>

3277

3622

Specifies the format of the data displayed for the `alias' menu. The

3316

3661

Default: no</p></div><p>

3317

3662

If set, Mutt will prompt you for carbon-copy (Cc) recipients before

3318

3663

editing the body of an outgoing message.

3319

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="attach-format"></a>3.11. attach_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3664

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3665

Default: ""</p></div><p>

3666

This variable is a colon-separated list of character encoding

3667

schemes for messages without character encoding indication.

3668

Header field values and message body content without character encoding

3669

indication would be assumed that they are written in one of this list.

3670

By default, all the header fields and message body without any charset

3671

indication are assumed to be in "us-ascii".

3672

</p><p>

3673

For example, Japanese users might prefer this:

3674

</p><p>

3675

set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"

3676

</p><p>

3677

However, only the first content is valid for the message body.

3678

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3679

Default: ""</p></div><p>

3680

This variable is a colon-separated list of character encoding

3681

schemes for text file attachments.

3682

If unset, <a href="#charset" title="3.25. charset">$charset</a> value will be used instead.

3683

For example, the following configuration would work for Japanese

3684

text handling:

3685

</p><p>

3686

set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"

3687

</p><p>

3688

Note: "iso-2022-*" must be put at the head of the value as shown above

3689

if included.

3690

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3320

3691

Default: "%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "</p></div><p>

3321

3692

This variable describes the format of the `attachment' menu. The

3322

3693

following printf-style sequences are understood:

3341

3712

(please see the ``<a href="#attachments" title="6. Attachment Searching and Counting">attachments</a>'' section for possible speed effects)

3342

3713

</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character "X"

3343

3714

</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character "X"

3715

</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character "X" as pad

3344

3716

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

3345

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="attach-sep"></a>3.12. attach_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3717

3718

</p><p>

3719

For an explanation of `soft-fill', see the ``<a href="#index-format" title="3.100. index_format">$index_format</a>'' documentation.

3720

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3346

3721

Default: "\n"</p></div><p>

3347

3722

The separator to add between attachments when operating (saving,

3348

3723

printing, piping, etc) on a list of tagged attachments.

3349

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="attach-split"></a>3.13. attach_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3724

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3350

3725

Default: yes</p></div><p>

3351

3726

If this variable is unset, when operating (saving, printing, piping,

3352

3727

etc) on a list of tagged attachments, Mutt will concatenate the

3353

3728

attachments and will operate on them as a single attachment. The

3354

``<a href="#attach-sep" title="3.12. attach_sep">$attach_sep</a>'' separator is added after each attachment. When set,

3729

``<a href="#attach-sep" title="3.14. attach_sep">$attach_sep</a>'' separator is added after each attachment. When set,

3355

3730

Mutt will operate on the attachments one by one.

3356

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="attribution"></a>3.14. attribution</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3731

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3357

3732

Default: "On %d, %n wrote:"</p></div><p>

3358

3733

This is the string that will precede a message which has been included

3359

3734

in a reply. For a full listing of defined printf()-like sequences see

3360

the section on ``<a href="#index-format" title="3.95. index_format">$index_format</a>''.

3361

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="autoedit"></a>3.15. autoedit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3735

the section on ``<a href="#index-format" title="3.100. index_format">$index_format</a>''.

3736

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="autoedit"></a>3.17. autoedit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3362

3737

Default: no</p></div><p>

3363

When set along with ``<a href="#edit-headers" title="3.46. edit_headers">$edit_headers</a>'', Mutt will skip the initial

3738

When set along with ``<a href="#edit-headers" title="3.50. edit_headers">$edit_headers</a>'', Mutt will skip the initial

3364

3739

send-menu and allow you to immediately begin editing the body of your

3365

3740

message. The send-menu may still be accessed once you have finished

3366

3741

editing the body of your message.

3367

3742

</p><p>

3368

Also see ``<a href="#fast-reply" title="3.51. fast_reply">$fast_reply</a>''.

3369

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="auto-tag"></a>3.16. auto_tag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3743

Also see ``<a href="#fast-reply" title="3.55. fast_reply">$fast_reply</a>''.

3744

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="auto-tag"></a>3.18. auto_tag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3370

3745

Default: no</p></div><p>

3371

3746

When set, functions in the <span class="emphasis"><em>index</em></span> menu which affect a message

3372

3747

will be applied to all tagged messages (if there are any). When

3373

3748

unset, you must first use the tag-prefix function (default: ";") to

3374

3749

make the next function apply to all tagged messages.

3375

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="beep"></a>3.17. beep</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3750

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3376

3751

Default: yes</p></div><p>

3377

3752

When this variable is set, mutt will beep when an error occurs.

3378

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="beep-new"></a>3.18. beep_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3753

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3379

3754

Default: no</p></div><p>

3380

3755

When this variable is set, mutt will beep whenever it prints a message

3381

3756

notifying you of new mail. This is independent of the setting of the

3382

``<a href="#beep" title="3.17. beep">$beep</a>'' variable.

3383

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="bounce"></a>3.19. bounce</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3757

``<a href="#beep" title="3.19. beep">$beep</a>'' variable.

3758

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3384

3759

Default: ask-yes</p></div><p>

3385

3760

Controls whether you will be asked to confirm bouncing messages.

3386

3761

If set to <span class="emphasis"><em>yes</em></span> you don't get asked if you want to bounce a

3387

3762

message. Setting this variable to <span class="emphasis"><em>no</em></span> is not generally useful,

3388

3763

and thus not recommended, because you are unable to bounce messages.

3389

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="bounce-delivered"></a>3.20. bounce_delivered</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3764

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3390

3765

Default: yes</p></div><p>

3391

3766

When this variable is set, mutt will include Delivered-To headers when

3392

3767

bouncing messages. Postfix users may wish to unset this variable.

3393

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="braille-friendly"></a>3.21. braille_friendly</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3768

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3394

3769

Default: no</p></div><p>

3395

3770

When this variable is set, mutt will place the cursor at the beginning

3396

3771

of the current line in menus, even when the arrow_cursor variable

3397

3772

is unset, making it easier for blind persons using Braille displays to

3398

3773

follow these menus. The option is disabled by default because many

3399

3774

visual terminals don't permit making the cursor invisible.

3400

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="charset"></a>3.22. charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3775

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="check-mbox-size"></a>3.24. check_mbox_size</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3776

Default: no</p></div><p>

3777

When this variable is set, mutt will use file size attribute instead of

3778

access time when checking for new mail.

3779

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3401

3780

Default: ""</p></div><p>

3402

3781

Character set your terminal uses to display and enter textual data.

3403

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="check-new"></a>3.23. check_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3782

It is also the fallback for <a href="#send-charset" title="3.256. send_charset">$send_charset</a>.

3783

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="check-new"></a>3.26. check_new</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3404

3784

Default: yes</p></div><p>

3405

3785

<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

3406

3786

mailboxes.

3411

3791

checking each file to see if it has already been looked at. If

3412

3792

<span class="emphasis"><em>check_new</em></span> is <span class="emphasis"><em>unset</em></span>, no check for new mail is performed

3413

3793

while the mailbox is open.

3414

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="collapse-unread"></a>3.24. collapse_unread</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3794

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="collapse-unread"></a>3.27. collapse_unread</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3415

3795

Default: yes</p></div><p>

3416

3796

When <span class="emphasis"><em>unset</em></span>, Mutt will not collapse a thread if it contains any

3417

3797

unread messages.

3418

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-jump"></a>3.25. uncollapse_jump</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3798

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="uncollapse-jump"></a>3.28. uncollapse_jump</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3419

3799

Default: no</p></div><p>

3420

3800

When <span class="emphasis"><em>set</em></span>, Mutt will jump to the next unread message, if any,

3421

3801

when the current thread is <span class="emphasis"><em>un</em></span>collapsed.

3422

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="compose-format"></a>3.26. compose_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3802

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3423

3803

Default: "-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-"</p></div><p>

3424

3804

Controls the format of the status line displayed in the <span class="emphasis"><em>Compose</em></span>

3425

menu. This string is similar to ``<a href="#status-format" title="3.267. status_format">$status_format</a>'', but has its own

3805

menu. This string is similar to ``<a href="#status-format" title="3.278. status_format">$status_format</a>'', but has its own

3426

3806

set of printf()-like sequences:

3427

3807

</p><p>

3428

3808

3433

3813

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

3434

3814

3435

3815

</p><p>

3436

See the text describing the ``<a href="#status-format" title="3.267. status_format">$status_format</a>'' option for more

3437

information on how to set ``<a href="#compose-format" title="3.26. compose_format">$compose_format</a>''.

3438

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="config-charset"></a>3.27. config_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3816

See the text describing the ``<a href="#status-format" title="3.278. status_format">$status_format</a>'' option for more

3817

information on how to set ``<a href="#compose-format" title="3.29. compose_format">$compose_format</a>''.

3818

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3439

3819

Default: ""</p></div><p>

3440

3820

When defined, Mutt will recode commands in rc files from this

3441

3821

encoding.

3442

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="confirmappend"></a>3.28. confirmappend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3822

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3443

3823

Default: yes</p></div><p>

3444

3824

When set, Mutt will prompt for confirmation when appending messages to

3445

3825

an existing mailbox.

3446

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="confirmcreate"></a>3.29. confirmcreate</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3826

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3447

3827

Default: yes</p></div><p>

3448

3828

When set, Mutt will prompt for confirmation when saving messages to a

3449

3829

mailbox which does not yet exist before creating it.

3450

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="connect-timeout"></a>3.30. connect_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

3830

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3451

3831

Default: 30</p></div><p>

3452

3832

Causes Mutt to timeout a network connection (for IMAP or POP) after this

3453

3833

many seconds if the connection is not able to be established. A negative

3454

3834

value causes Mutt to wait indefinitely for the connection to succeed.

3455

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="content-type"></a>3.31. content_type</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3835

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

3456

3836

Default: "text/plain"</p></div><p>

3457

3837

Sets the default Content-Type for the body of newly composed messages.

3458

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="copy"></a>3.32. copy</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3838

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="copy"></a>3.35. copy</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3459

3839

Default: yes</p></div><p>

3460

3840

This variable controls whether or not copies of your outgoing messages

3461

will be saved for later references. Also see ``<a href="#record" title="3.232. record">$record</a>'',

3462

``<a href="#save-name" title="3.243. save_name">$save_name</a>'', ``<a href="#force-name" title="3.57. force_name">$force_name</a>'' and ``<a href="#fcc-hook" title="16. Specify default Fcc: mailbox when composing">fcc-hook</a>''.

3463

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.33. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3841

will be saved for later references. Also see ``<a href="#record" title="3.239. record">$record</a>'',

3842

``<a href="#save-name" title="3.251. save_name">$save_name</a>'', ``<a href="#force-name" title="3.61. force_name">$force_name</a>'' and ``<a href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a>''.

3843

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-gpgme"></a>3.36. crypt_use_gpgme</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3464

3844

Default: no</p></div><p>

3465

This variable controls the use the GPGME enabled crypto backends.

3466

If it is set and Mutt was build with gpgme support, the gpgme code for

3467

S/MIME and PGP will be used instead of the classic code. Note, that

3468

you need to use this option in .muttrc as it won't have any effect when

3845

This variable controls the use of the GPGME-enabled crypto backends.

3846

If it is set and Mutt was built with gpgme support, the gpgme code for

3847

S/MIME and PGP will be used instead of the classic code. Note that

3848

you need to set this option in .muttrc; it won't have any effect when

3469

3849

used interactively.

3470

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.34. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3471

Default: yes</p></div><p>

3472

This variable controls whether or not mutt may automatically enable

3473

PGP encryption/signing for messages. See also ``<a href="#crypt-autoencrypt" title="3.137. crypt_autoencrypt">$crypt_autoencrypt</a>'',

3474

``<a href="#crypt-replyencrypt" title="3.139. crypt_replyencrypt">$crypt_replyencrypt</a>'',

3475

``<a href="#crypt-autosign" title="3.136. crypt_autosign">$crypt_autosign</a>'', ``<a href="#crypt-replysign" title="3.140. crypt_replysign">$crypt_replysign</a>'' and ``<a href="#smime-is-default" title="3.145. smime_is_default">$smime_is_default</a>''.

3476

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.35. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3477

Default: yes</p></div><p>

3478

This variable controls whether or not mutt may automatically enable

3479

S/MIME encryption/signing for messages. See also ``<a href="#crypt-autoencrypt" title="3.137. crypt_autoencrypt">$crypt_autoencrypt</a>'',

3480

``<a href="#crypt-replyencrypt" title="3.139. crypt_replyencrypt">$crypt_replyencrypt</a>'',

3481

``<a href="#crypt-autosign" title="3.136. crypt_autosign">$crypt_autosign</a>'', ``<a href="#crypt-replysign" title="3.140. crypt_replysign">$crypt_replysign</a>'' and ``<a href="#smime-is-default" title="3.145. smime_is_default">$smime_is_default</a>''.

3482

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.36. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3850

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-use-pka"></a>3.37. crypt_use_pka</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3851

Default: no</p></div><p>

3852

(http://www.g10code.de/docs/pka-intro.de.pdf) during signature

3853

verification (only supported by the GPGME backend).

3854

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autopgp"></a>3.38. crypt_autopgp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3855

Default: yes</p></div><p>

3856

This variable controls whether or not mutt may automatically enable

3857

PGP encryption/signing for messages. See also ``<a href="#crypt-autoencrypt" title="3.143. crypt_autoencrypt">$crypt_autoencrypt</a>'',

3858

``<a href="#crypt-replyencrypt" title="3.145. crypt_replyencrypt">$crypt_replyencrypt</a>'',

3859

``<a href="#crypt-autosign" title="3.142. crypt_autosign">$crypt_autosign</a>'', ``<a href="#crypt-replysign" title="3.146. crypt_replysign">$crypt_replysign</a>'' and ``<a href="#smime-is-default" title="3.151. smime_is_default">$smime_is_default</a>''.

3860

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosmime"></a>3.39. crypt_autosmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3861

Default: yes</p></div><p>

3862

This variable controls whether or not mutt may automatically enable

3863

S/MIME encryption/signing for messages. See also ``<a href="#crypt-autoencrypt" title="3.143. crypt_autoencrypt">$crypt_autoencrypt</a>'',

3864

``<a href="#crypt-replyencrypt" title="3.145. crypt_replyencrypt">$crypt_replyencrypt</a>'',

3865

``<a href="#crypt-autosign" title="3.142. crypt_autosign">$crypt_autosign</a>'', ``<a href="#crypt-replysign" title="3.146. crypt_replysign">$crypt_replysign</a>'' and ``<a href="#smime-is-default" title="3.151. smime_is_default">$smime_is_default</a>''.

3866

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="date-format"></a>3.40. date_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3483

3867

Default: "!%a, %b %d, %Y at %I:%M:%S%p %Z"</p></div><p>

3484

3868

This variable controls the format of the date printed by the ``%d''

3485

sequence in ``<a href="#index-format" title="3.95. index_format">$index_format</a>''. This is passed to the <span class="emphasis"><em>strftime</em></span>

3869

sequence in ``<a href="#index-format" title="3.100. index_format">$index_format</a>''. This is passed to the <span class="emphasis"><em>strftime</em></span>

3486

3870

call to process the date. See the man page for <span class="emphasis"><em>strftime(3)</em></span> for

3487

3871

the proper syntax.

3488

3872

</p><p>

3489

3873

Unless the first character in the string is a bang (``!''), the month

3490

3874

and week day names are expanded according to the locale specified in

3491

the variable ``<a href="#locale" title="3.98. locale">$locale</a>''. If the first character in the string is a

3875

the variable ``<a href="#locale" title="3.103. locale">$locale</a>''. If the first character in the string is a

3492

3876

bang, the bang is discarded, and the month and week day names in the

3493

3877

rest of the string are expanded in the <span class="emphasis"><em>C</em></span> locale (that is in US

3494

3878

English).

3495

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.37. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3879

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="default-hook"></a>3.41. default_hook</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3496

3880

Default: "˜f %s !˜P | (˜P ˜C %s)"</p></div><p>

3497

This variable controls how send-hooks, message-hooks, save-hooks,

3498

and fcc-hooks will

3881

This variable controls how message-hooks, reply-hooks, send-hooks,

3882

send2-hooks, save-hooks, and fcc-hooks will

3499

3883

be interpreted if they are specified with only a simple regexp,

3500

3884

instead of a matching pattern. The hooks are expanded when they are

3501

3885

declared, so a hook will be interpreted according to the value of this

3504

3888

given, or if it is from you (if the from address matches

3505

3889

``alternates'') and is to or cc'ed to a user matching the given

3506

3890

regular expression.

3507

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="delete"></a>3.38. delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3891

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="delete"></a>3.42. delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3508

3892

Default: ask-yes</p></div><p>

3509

3893

Controls whether or not messages are really deleted when closing or

3510

3894

synchronizing a mailbox. If set to <span class="emphasis"><em>yes</em></span>, messages marked for

3511

3895

deleting will automatically be purged without prompting. If set to

3512

3896

<span class="emphasis"><em>no</em></span>, messages marked for deletion will be kept in the mailbox.

3513

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="delete-untag"></a>3.39. delete_untag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3897

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="delete-untag"></a>3.43. delete_untag</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3514

3898

Default: yes</p></div><p>

3515

3899

If this option is <span class="emphasis"><em>set</em></span>, mutt will untag messages when marking them

3516

3900

for deletion. This applies when you either explicitly delete a message,

3517

3901

or when you save it to another folder.

3518

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="digest-collapse"></a>3.40. digest_collapse</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3902

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="digest-collapse"></a>3.44. digest_collapse</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3519

3903

Default: yes</p></div><p>

3520

3904

If this option is <span class="emphasis"><em>set</em></span>, mutt's received-attachments menu will not show the subparts of

3521

3905

individual messages in a multipart/digest. To see these subparts, press 'v' on that menu.

3522

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="display-filter"></a>3.41. display_filter</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3906

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="display-filter"></a>3.45. display_filter</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3523

3907

Default: ""</p></div><p>

3524

3908

When set, specifies a command used to filter messages. When a message

3525

is viewed it is passed as standard input to <a href="#display-filter" title="3.41. display_filter">$display_filter</a>, and the

3909

is viewed it is passed as standard input to <a href="#display-filter" title="3.45. display_filter">$display_filter</a>, and the

3526

3910

filtered message is read from the standard output.

3527

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="dotlock-program"></a>3.42. dotlock_program</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3911

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="dotlock-program"></a>3.46. dotlock_program</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3528

3912

Default: "/usr/local/bin/mutt_dotlock"</p></div><p>

3529

3913

Contains the path of the mutt_dotlock (8) binary to be used by

3530

3914

mutt.

3531

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-notify"></a>3.43. dsn_notify</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3915

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-notify"></a>3.47. dsn_notify</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3532

3916

Default: ""</p></div><p>

3533

<span class="bold"><strong>Note:</strong></span> you should not enable this unless you are using Sendmail

3534

8.8.x or greater.

3535

</p><p>

3536

3917

This variable sets the request for when notification is returned. The

3537

3918

string consists of a comma separated list (no spaces!) of one or more

3538

3919

of the following: <span class="emphasis"><em>never</em></span>, to never request notification,

3541

3922

notified of successful transmission.

3542

3923

</p><p>

3543

3924

Example: set dsn_notify="failure,delay"

3544

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-return"></a>3.44. dsn_return</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3925

</p><p>

3926

<span class="bold"><strong>Note:</strong></span> when using <a href="#sendmail" title="3.257. sendmail">$sendmail</a> for delivery, you should not enable

3927

this unless you are either using Sendmail 8.8.x or greater or a MTA

3928

providing a sendmail(1)-compatible interface supporting the -N option

3929

for DSN. For SMTP delivery, it depends on the server whether DSN is

3930

supported or not.

3931

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="dsn-return"></a>3.48. dsn_return</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3545

3932

Default: ""</p></div><p>

3546

<span class="bold"><strong>Note:</strong></span> you should not enable this unless you are using Sendmail

3547

8.8.x or greater.

3548

</p><p>

3549

3933

This variable controls how much of your message is returned in DSN

3550

3934

messages. It may be set to either <span class="emphasis"><em>hdrs</em></span> to return just the

3551

3935

message header, or <span class="emphasis"><em>full</em></span> to return the full message.

3552

3936

</p><p>

3553

3937

Example: set dsn_return=hdrs

3554

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.45. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3938

</p><p>

3939

<span class="bold"><strong>Note:</strong></span> when using <a href="#sendmail" title="3.257. sendmail">$sendmail</a> for delivery, you should not enable

3940

this unless you are either using Sendmail 8.8.x or greater or a MTA

3941

providing a sendmail(1)-compatible interface supporting the -R option

3942

for DSN. For SMTP delivery, it depends on the server whether DSN is

3943

supported or not.

3944

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="duplicate-threads"></a>3.49. duplicate_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3555

3945

Default: yes</p></div><p>

3556

3946

This variable controls whether mutt, when sorting by threads, threads

3557

3947

messages with the same message-id together. If it is set, it will indicate

3558

3948

that it thinks they are duplicates of each other with an equals sign

3559

3949

in the thread diagram.

3560

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.46. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3950

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="edit-headers"></a>3.50. edit_headers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3561

3951

Default: no</p></div><p>

3562

3952

This option allows you to edit the header of your outgoing messages

3563

3953

along with the body of your message.

3564

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.47. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3954

</p><p>

3955

<span class="bold"><strong>Note</strong></span> that changes made to the References: and Date: headers are

3956

ignored for interoperability reasons.

3957

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor"></a>3.51. editor</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3565

3958

Default: ""</p></div><p>

3566

3959

This variable specifies which editor is used by mutt.

3567

3960

It defaults to the value of the VISUAL, or EDITOR, environment

3568

3961

variable, or to the string "vi" if neither of those are set.

3569

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.48. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3962

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="encode-from"></a>3.52. encode_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3570

3963

Default: no</p></div><p>

3571

3964

When <span class="emphasis"><em>set</em></span>, mutt will quoted-printable encode messages when

3572

3965

they contain the string "From " in the beginning of a line.

3573

3966

Useful to avoid the tampering certain mail delivery and transport

3574

3967

agents tend to do with messages.

3575

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.49. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />

3968

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="envelope-from-address"></a>3.53. envelope_from_address</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />

3576

3969

Default: ""</p></div><p>

3577

3970

Manually sets the <span class="emphasis"><em>envelope</em></span> sender for outgoing messages.

3578

This value is ignored if ``<a href="#use-envelope-from" title="3.281. use_envelope_from">$use_envelope_from</a>'' is unset.

3579

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.50. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3971

This value is ignored if ``<a href="#use-envelope-from" title="3.293. use_envelope_from">$use_envelope_from</a>'' is unset.

3972

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="escape"></a>3.54. escape</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3580

3973

Default: "˜"</p></div><p>

3581

3974

Escape character to use for functions in the builtin editor.

3582

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.51. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3975

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fast-reply"></a>3.55. fast_reply</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3583

3976

Default: no</p></div><p>

3584

3977

When set, the initial prompt for recipients and subject are skipped

3585

3978

when replying to messages, and the initial prompt for subject is

3586

3979

skipped when forwarding messages.

3587

3980

</p><p>

3588

<span class="bold"><strong>Note:</strong></span> this variable has no effect when the ``<a href="#autoedit" title="3.15. autoedit">$autoedit</a>''

3981

<span class="bold"><strong>Note:</strong></span> this variable has no effect when the ``<a href="#autoedit" title="3.17. autoedit">$autoedit</a>''

3589

3982

variable is set.

3590

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.52. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3983

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-attach"></a>3.56. fcc_attach</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3591

3984

Default: yes</p></div><p>

3592

3985

This variable controls whether or not attachments on outgoing messages

3593

3986

are saved along with the main body of your message.

3594

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.53. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3987

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="fcc-clear"></a>3.57. fcc_clear</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3595

3988

Default: no</p></div><p>

3596

3989

When this variable is set, FCCs will be stored unencrypted and

3597

3990

unsigned, even when the actual message is encrypted and/or

3598

3991

signed.

3599

3992

(PGP only)

3600

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.54. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3993

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder"></a>3.58. folder</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3601

3994

Default: "˜/Mail"</p></div><p>

3602

3995

Specifies the default location of your mailboxes. A `+' or `=' at the

3603

3996

beginning of a pathname will be expanded to the value of this

3605

3998

value you need to make sure that the assignment occurs <span class="emphasis"><em>before</em></span>

3606

3999

you use `+' or `=' for any other variables since expansion takes place

3607

4000

during the `set' command.

3608

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.55. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4001

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="folder-format"></a>3.59. folder_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3609

4002

Default: "%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f"</p></div><p>

3610

4003

This variable allows you to customize the file browser display to your

3611

personal taste. This string is similar to ``<a href="#index-format" title="3.95. index_format">$index_format</a>'', but has

4004

personal taste. This string is similar to ``<a href="#index-format" title="3.100. index_format">$index_format</a>'', but has

3612

4005

its own set of printf()-like sequences:

3613

4006

</p><p>

3614

4007

3624

4017

</p></dd><dt><span class="term">%u </span></dt><dd><p>owner name (or numeric uid, if missing)

3625

4018

</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character "X"

3626

4019

</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character "X"

4020

</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character "X" as pad

3627

4021

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

3628

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.56. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4022

4023

</p><p>

4024

For an explanation of `soft-fill', see the ``<a href="#index-format" title="3.100. index_format">$index_format</a>'' documentation.

4025

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="followup-to"></a>3.60. followup_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3629

4026

Default: yes</p></div><p>

3630

4027

Controls whether or not the <span class="emphasis"><em>Mail-Followup-To</em></span> header field is

3631

4028

generated when sending mail. When <span class="emphasis"><em>set</em></span>, Mutt will generate this

3632

4029

field when you are replying to a known mailing list, specified with

3633

the ``subscribe'' or ``<a href="#lists" title="10. Mailing lists">lists</a>'' commands.

4030

the ``subscribe'' or ``<a href="#lists" title="11. Mailing lists">lists</a>'' commands.

3634

4031

</p><p>

3635

4032

This field has two purposes. First, preventing you from

3636

4033

receiving duplicate copies of replies to messages which you send

3642

4039

group reply to your message sent to a subscribed list will be

3643

4040

sent to both the list and your address, resulting in two copies

3644

4041

of the same email for you.

3645

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="force-name"></a>3.57. force_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4042

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="force-name"></a>3.61. force_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3646

4043

Default: no</p></div><p>

3647

This variable is similar to ``<a href="#save-name" title="3.243. save_name">$save_name</a>'', except that Mutt will

4044

This variable is similar to ``<a href="#save-name" title="3.251. save_name">$save_name</a>'', except that Mutt will

3648

4045

store a copy of your outgoing message by the username of the address

3649

4046

you are sending to even if that mailbox does not exist.

3650

4047

</p><p>

3651

Also see the ``<a href="#record" title="3.232. record">$record</a>'' variable.

3652

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decode"></a>3.58. forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4048

Also see the ``<a href="#record" title="3.239. record">$record</a>'' variable.

4049

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decode"></a>3.62. forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3653

4050

Default: yes</p></div><p>

3654

4051

Controls the decoding of complex MIME messages into text/plain when

3655

4052

forwarding a message. The message header is also RFC2047 decoded.

3656

This variable is only used, if ``<a href="#mime-forward" title="3.121. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>unset</em></span>,

3657

otherwise ``<a href="#mime-forward-decode" title="3.122. mime_forward_decode">$mime_forward_decode</a>'' is used instead.

3658

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-edit"></a>3.59. forward_edit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4053

This variable is only used, if ``<a href="#mime-forward" title="3.126. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>unset</em></span>,

4054

otherwise ``<a href="#mime-forward-decode" title="3.127. mime_forward_decode">$mime_forward_decode</a>'' is used instead.

4055

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-edit"></a>3.63. forward_edit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3659

4056

Default: yes</p></div><p>

3660

4057

This quadoption controls whether or not the user is automatically

3661

4058

placed in the editor when forwarding messages. For those who always want

3662

4059

to forward with no modification, use a setting of ``no''.

3663

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-format"></a>3.60. forward_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4060

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-format"></a>3.64. forward_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3664

4061

Default: "[%a: %s]"</p></div><p>

3665

4062

This variable controls the default subject when forwarding a message.

3666

It uses the same format sequences as the ``<a href="#index-format" title="3.95. index_format">$index_format</a>'' variable.

3667

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-quote"></a>3.61. forward_quote</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4063

It uses the same format sequences as the ``<a href="#index-format" title="3.100. index_format">$index_format</a>'' variable.

4064

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-quote"></a>3.65. forward_quote</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3668

4065

Default: no</p></div><p>

3669

4066

When <span class="emphasis"><em>set</em></span> forwarded messages included in the main body of the

3670

message (when ``<a href="#mime-forward" title="3.121. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>unset</em></span>) will be quoted using

3671

``<a href="#indent-string" title="3.94. indent_string">$indent_string</a>''.

3672

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="from"></a>3.62. from</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />

4067

message (when ``<a href="#mime-forward" title="3.126. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>unset</em></span>) will be quoted using

4068

``<a href="#indent-string" title="3.99. indent_string">$indent_string</a>''.

4069

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="from"></a>3.66. from</h3></div></div></div><div class="literallayout"><p>Type: e-mail address<br />

3673

4070

Default: ""</p></div><p>

3674

4071

When set, this variable contains a default from address. It

3675

4072

can be overridden using my_hdr (including from send-hooks) and

3676

``<a href="#reverse-name" title="3.238. reverse_name">$reverse_name</a>''. This variable is ignored if ``<a href="#use-from" title="3.282. use_from">$use_from</a>''

4073

``<a href="#reverse-name" title="3.245. reverse_name">$reverse_name</a>''. This variable is ignored if ``<a href="#use-from" title="3.294. use_from">$use_from</a>''

3677

4074

is unset.

3678

4075

</p><p>

3679

4076

Defaults to the contents of the environment variable EMAIL.

3680

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="gecos-mask"></a>3.63. gecos_mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4077

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="gecos-mask"></a>3.67. gecos_mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

3681

4078

Default: "^[^,]*"</p></div><p>

3682

4079

A regular expression used by mutt to parse the GECOS field of a password

3683

4080

entry when expanding the alias. By default the regular expression is set

3690

4087

stevef to "Franklin" stevef@foo.bar then you should set the gecos_mask to

3691

4088

a regular expression that will match the whole name so mutt will expand

3692

4089

"Franklin" to "Franklin, Steve".

3693

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hdrs"></a>3.64. hdrs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4090

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hdrs"></a>3.68. hdrs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3694

4091

Default: yes</p></div><p>

3695

When unset, the header fields normally added by the ``<a href="#my-hdr" title="13. User defined headers">my_hdr</a>''

4092

When unset, the header fields normally added by the ``<a href="#my-hdr" title="14. User defined headers">my_hdr</a>''

3696

4093

command are not created. This variable <span class="emphasis"><em>must</em></span> be unset before

3697

4094

composing a new message or replying in order to take effect. If set,

3698

4095

the user defined header fields are added to every new message.

3699

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header"></a>3.65. header</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4096

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header"></a>3.69. header</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3700

4097

Default: no</p></div><p>

3701

4098

When set, this variable causes Mutt to include the header

3702

4099

of the message you are replying to into the edit buffer.

3703

The ``<a href="#weed" title="3.288. weed">$weed</a>'' setting applies.

3704

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="help"></a>3.66. help</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4100

The ``<a href="#weed" title="3.300. weed">$weed</a>'' setting applies.

4101

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="help"></a>3.70. help</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3705

4102

Default: yes</p></div><p>

3706

4103

When set, help lines describing the bindings for the major functions

3707

4104

provided by each menu are displayed on the first line of the screen.

3711

4108

the help line may not be updated if a binding is changed while Mutt is

3712

4109

running. Since this variable is primarily aimed at new users, neither

3713

4110

of these should present a major problem.

3714

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hidden-host"></a>3.67. hidden_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4111

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hidden-host"></a>3.71. hidden_host</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3715

4112

Default: no</p></div><p>

3716

When set, mutt will skip the host name part of ``<a href="#hostname" title="3.75. hostname">$hostname</a>'' variable

4113

When set, mutt will skip the host name part of ``<a href="#hostname" title="3.80. hostname">$hostname</a>'' variable

3717

4114

when adding the domain part to addresses. This variable does not

3718

4115

affect the generation of Message-IDs, and it will not lead to the

3719

4116

cut-off of first-level domains.

3720

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-limited"></a>3.68. hide_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4117

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-limited"></a>3.72. hide_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3721

4118

Default: no</p></div><p>

3722

4119

When set, mutt will not show the presence of messages that are hidden

3723

4120

by limiting, in the thread tree.

3724

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-missing"></a>3.69. hide_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4121

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-missing"></a>3.73. hide_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3725

4122

Default: yes</p></div><p>

3726

4123

When set, mutt will not show the presence of missing messages in the

3727

4124

thread tree.

3728

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-thread-subject"></a>3.70. hide_thread_subject</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4125

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-thread-subject"></a>3.74. hide_thread_subject</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3729

4126

Default: yes</p></div><p>

3730

4127

When set, mutt will not show the subject of messages in the thread

3731

4128

tree that have the same subject as their parent or closest previously

3732

4129

displayed sibling.

3733

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-limited"></a>3.71. hide_top_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4130

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-limited"></a>3.75. hide_top_limited</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3734

4131

Default: no</p></div><p>

3735

4132

When set, mutt will not show the presence of messages that are hidden

3736

4133

by limiting, at the top of threads in the thread tree. Note that when

3737

<a href="#hide-limited" title="3.68. hide_limited">$hide_limited</a> is set, this option will have no effect.

3738

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-missing"></a>3.72. hide_top_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4134

<a href="#hide-limited" title="3.72. hide_limited">$hide_limited</a> is set, this option will have no effect.

4135

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hide-top-missing"></a>3.76. hide_top_missing</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3739

4136

Default: yes</p></div><p>

3740

4137

When set, mutt will not show the presence of missing messages at the

3741

top of threads in the thread tree. Note that when <a href="#hide-missing" title="3.69. hide_missing">$hide_missing</a> is

4138

top of threads in the thread tree. Note that when <a href="#hide-missing" title="3.73. hide_missing">$hide_missing</a> is

3742

4139

set, this option will have no effect.

3743

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="history"></a>3.73. history</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4140

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="history"></a>3.77. history</h3></div></div></div><div class="literallayout"><p>Type: number<br />

3744

4141

Default: 10</p></div><p>

3745

4142

This variable controls the size (in number of strings remembered) of

3746

4143

the string history buffer. The buffer is cleared each time the

3747

4144

variable is set.

3748

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="honor-followup-to"></a>3.74. honor_followup_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4145

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="history-file"></a>3.78. history_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4146

Default: "˜/.mutthistory"</p></div><p>

4147

The file in which Mutt will save its history.

4148

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="honor-followup-to"></a>3.79. honor_followup_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3749

4149

Default: yes</p></div><p>

3750

4150

This variable controls whether or not a Mail-Followup-To header is

3751

4151

honored when group-replying to a message.

3752

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hostname"></a>3.75. hostname</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4152

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="hostname"></a>3.80. hostname</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3753

4153

Default: ""</p></div><p>

3754

Specifies the hostname to use after the ``@'' in local e-mail

3755

addresses. This overrides the compile time definition obtained from

3756

/etc/resolv.conf.

3757

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-list-reply-to"></a>3.76. ignore_list_reply_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4154

Specifies the fully-qualified hostname of the system mutt is running on

4155

containing the host's name and the DNS domain it belongs to. It is used

4156

as the domain part (after ``@'') for local email addresses as well as

4157

Message-Id headers.

4158

</p><p>

4159

Its value is determined at startup as follows: If the node's name

4160

as returned by the uname(3) function contains the hostname and the

4161

domain, these are used to construct <a href="#hostname" title="3.80. hostname">$hostname</a>. If there is no

4162

domain part returned, Mutt will look for a ``domain'' or ``search''

4163

line in /etc/resolv.conf to determine the domain. Optionally, Mutt

4164

can be compiled with a fixed domain name in which case a detected

4165

one is not used.

4166

</p><p>

4167

Also see ``<a href="#use-domain" title="3.292. use_domain">$use_domain</a>'' and ``<a href="#hidden-host" title="3.71. hidden_host">$hidden_host</a>''.

4168

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-linear-white-space"></a>3.81. ignore_linear_white_space</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4169

Default: no</p></div><p>

4170

This option replaces linear-white-space between encoded-word

4171

and *text to a single space to prevent the display of MIME-encoded

4172

``Subject'' field from being divided into multiple lines.

4173

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ignore-list-reply-to"></a>3.82. ignore_list_reply_to</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3758

4174

Default: no</p></div><p>

3759

4175

Affects the behaviour of the <span class="emphasis"><em>reply</em></span> function when replying to

3760

messages from mailing lists. When set, if the ``Reply-To:'' field is

4176

messages from mailing lists (as defined by the ``subscribe'' or

4177

``<a href="#lists" title="11. Mailing lists">lists</a>'' commands). When set, if the ``Reply-To:'' field is

3761

4178

set to the same value as the ``To:'' field, Mutt assumes that the

3762

4179

``Reply-To:'' field was set by the mailing list to automate responses

3763

4180

to the list, and will ignore this field. To direct a response to the

3764

4181

mailing list when this option is set, use the <span class="emphasis"><em>list-reply</em></span>

3765

4182

function; <span class="emphasis"><em>group-reply</em></span> will reply to both the sender and the

3766

4183

list.

3767

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-authenticators"></a>3.77. imap_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4184

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-authenticators"></a>3.83. imap_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3768

4185

Default: ""</p></div><p>

3769

4186

This is a colon-delimited list of authentication methods mutt may

3770

4187

attempt to use to log in to an IMAP server, in the order mutt should

3779

4196

<span class="bold"><strong>Note:</strong></span> Mutt will only fall back to other authentication methods if

3780

4197

the previous methods are unavailable. If a method is available but

3781

4198

authentication fails, mutt will not connect to the IMAP server.

3782

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-check-subscribed"></a>3.78. imap_check_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4199

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-check-subscribed"></a>3.84. imap_check_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3783

4200

Default: no</p></div><p>

3784

4201

When <span class="emphasis"><em>set</em></span>, mutt will fetch the set of subscribed folders from

3785

4202

your server on connection, and add them to the set of mailboxes

3786

it polls for new mail. See also the ``<a href="#mailboxes" title="12. Defining mailboxes which receive mail">mailboxes</a>'' command.

3787

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-delim-chars"></a>3.79. imap_delim_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4203

it polls for new mail. See also the ``<a href="#mailboxes" title="13. Monitoring incoming mail">mailboxes</a>'' command.

4204

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-delim-chars"></a>3.85. imap_delim_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3788

4205

Default: "/."</p></div><p>

3789

4206

This contains the list of characters which you would like to treat

3790

4207

as folder separators for displaying IMAP paths. In particular it

3791

4208

helps in using the '=' shortcut for your <span class="emphasis"><em>folder</em></span> variable.

3792

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-headers"></a>3.80. imap_headers</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4209

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-headers"></a>3.86. imap_headers</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3793

4210

Default: ""</p></div><p>

3794

4211

Mutt requests these header fields in addition to the default headers

3795

4212

("DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE

3796

4213

CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES X-LABEL") from IMAP

3797

4214

servers before displaying the index menu. You may want to add more

3798

4215

headers for spam detection. <span class="bold"><strong>Note:</strong></span> This is a space separated list.

3799

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-home-namespace"></a>3.81. imap_home_namespace</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3800

Default: ""</p></div><p>

3801

You normally want to see your personal folders alongside

3802

your INBOX in the IMAP browser. If you see something else, you may set

3803

this variable to the IMAP path to your folders.

3804

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-idle"></a>3.82. imap_idle</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4216

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-idle"></a>3.87. imap_idle</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3805

4217

Default: no</p></div><p>

3806

4218

When <span class="emphasis"><em>set</em></span>, mutt will attempt to use the IMAP IDLE extension

3807

4219

to check for new mail in the current mailbox. Some servers

3808

4220

(dovecot was the inspiration for this option) react badly

3809

4221

to mutt's implementation. If your connection seems to freeze

3810

4222

up periodically, try unsetting this.

3811

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-keepalive"></a>3.83. imap_keepalive</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4223

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-keepalive"></a>3.88. imap_keepalive</h3></div></div></div><div class="literallayout"><p>Type: number<br />

3812

4224

Default: 900</p></div><p>

3813

4225

This variable specifies the maximum amount of time in seconds that mutt

3814

4226

will wait before polling open IMAP connections, to prevent the server

3817

4229

a server is allowed to do this, but in practice the RFC does get

3818

4230

violated every now and then. Reduce this number if you find yourself

3819

4231

getting disconnected from your IMAP server due to inactivity.

3820

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-list-subscribed"></a>3.84. imap_list_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4232

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-list-subscribed"></a>3.89. imap_list_subscribed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3821

4233

Default: no</p></div><p>

3822

4234

This variable configures whether IMAP folder browsing will look for

3823

4235

only subscribed folders or all folders. This can be toggled in the

3824

4236

IMAP browser with the <span class="emphasis"><em>toggle-subscribed</em></span> function.

3825

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-login"></a>3.85. imap_login</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4237

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-login"></a>3.90. imap_login</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3826

4238

Default: ""</p></div><p>

3827

4239

Your login name on the IMAP server.

3828

4240

</p><p>

3829

4241

This variable defaults to the value of <span class="emphasis"><em>imap_user</em></span>.

3830

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-pass"></a>3.86. imap_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4242

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-pass"></a>3.91. imap_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3831

4243

Default: ""</p></div><p>

3832

4244

Specifies the password for your IMAP account. If <span class="emphasis"><em>unset</em></span>, Mutt will

3833

4245

prompt you for your password when you invoke the fetch-mail function.

3834

4246

<span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a

3835

4247

fairly secure machine, because the superuser can read your muttrc even

3836

4248

if you are the only one who can read the file.

3837

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-passive"></a>3.87. imap_passive</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4249

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-passive"></a>3.92. imap_passive</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3838

4250

Default: yes</p></div><p>

3839

4251

When <span class="emphasis"><em>set</em></span>, mutt will not open new IMAP connections to check for new

3840

4252

mail. Mutt will only check for new mail over existing IMAP

3841

4253

connections. This is useful if you don't want to be prompted to

3842

4254

user/password pairs on mutt invocation, or if opening the connection

3843

4255

is slow.

3844

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-peek"></a>3.88. imap_peek</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4256

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-peek"></a>3.93. imap_peek</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3845

4257

Default: yes</p></div><p>

3846

4258

When <span class="emphasis"><em>set</em></span>, mutt will avoid implicitly marking your mail as read whenever

3847

4259

you fetch a message from the server. This is generally a good thing,

3848

4260

but can make closing an IMAP folder somewhat slower. This option

3849

4261

exists to appease speed freaks.

3850

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-servernoise"></a>3.89. imap_servernoise</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4262

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-servernoise"></a>3.94. imap_servernoise</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3851

4263

Default: yes</p></div><p>

3852

4264

When <span class="emphasis"><em>set</em></span>, mutt will display warning messages from the IMAP

3853

4265

server as error messages. Since these messages are often

3854

4266

harmless, or generated due to configuration problems on the

3855

4267

server which are out of the users' hands, you may wish to suppress

3856

4268

them at some point.

3857

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-user"></a>3.90. imap_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4269

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="imap-user"></a>3.95. imap_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3858

4270

Default: ""</p></div><p>

3859

4271

The name of the user whose mail you intend to access on the IMAP

3860

4272

server.

3861

4273

</p><p>

3862

4274

This variable defaults to your user name on the local machine.

3863

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="implicit-autoview"></a>3.91. implicit_autoview</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4275

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="implicit-autoview"></a>3.96. implicit_autoview</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3864

4276

Default: no</p></div><p>

3865

4277

If set to ``yes'', mutt will look for a mailcap entry with the

3866

4278

copiousoutput flag set for <span class="emphasis"><em>every</em></span> MIME attachment it doesn't have

3867

4279

an internal viewer defined for. If such an entry is found, mutt will

3868

4280

use the viewer defined in that entry to convert the body part to text

3869

4281

form.

3870

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="include"></a>3.92. include</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4282

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="include"></a>3.97. include</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

3871

4283

Default: ask-yes</p></div><p>

3872

4284

Controls whether or not a copy of the message(s) you are replying to

3873

4285

is included in your reply.

3874

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="include-onlyfirst"></a>3.93. include_onlyfirst</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4286

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="include-onlyfirst"></a>3.98. include_onlyfirst</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3875

4287

Default: no</p></div><p>

3876

4288

Controls whether or not Mutt includes only the first attachment

3877

4289

of the message you are replying.

3878

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="indent-string"></a>3.94. indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4290

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="indent-string"></a>3.99. indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3879

4291

Default: "> "</p></div><p>

3880

4292

Specifies the string to prepend to each line of text quoted in a

3881

4293

message to which you are replying. You are strongly encouraged not to

3882

4294

change this value, as it tends to agitate the more fanatical netizens.

3883

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="index-format"></a>3.95. index_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4295

</p><p>

4296

This option is a format string, please see the description of

4297

``<a href="#index-format" title="3.100. index_format">$index_format</a>'' for supported printf()-style sequences.

4298

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="index-format"></a>3.100. index_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3884

4299

Default: "%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"</p></div><p>

3885

4300

This variable allows you to customize the message index display to

3886

4301

your personal taste.

3902

4317

``date_format'' converted to the local time zone

3903

4318

</p></dd><dt><span class="term">%e </span></dt><dd><p>current message number in thread

3904

4319

</p></dd><dt><span class="term">%E </span></dt><dd><p>number of messages in current thread

3905

</p></dd><dt><span class="term">%f </span></dt><dd><p>entire From: line (address + real name)

4320

</p></dd><dt><span class="term">%f </span></dt><dd><p>sender (address + real name), either From: or Return-Path:

3906

4321

</p></dd><dt><span class="term">%F </span></dt><dd><p>author name, or recipient name if the message is from you

3907

4322

</p></dd><dt><span class="term">%H </span></dt><dd><p>spam attribute(s) of this message

3908

4323

</p></dd><dt><span class="term">%i </span></dt><dd><p>message-id of the current message

3917

4332

</p></dd><dt><span class="term">%n </span></dt><dd><p>author's real name (or address if missing)

3918

4333

</p></dd><dt><span class="term">%O </span></dt><dd><p>(_O_riginal save folder) Where mutt would formerly have

3919

4334

stashed the message: list name or recipient name if no list

4335

</p></dd><dt><span class="term">%P </span></dt><dd><p>progress indicator for the builtin pager (how much of the file has been displayed)

3920

4336

</p></dd><dt><span class="term">%s </span></dt><dd><p>subject of the message

3921

4337

</p></dd><dt><span class="term">%S </span></dt><dd><p>status of the message (N/D/d/!/r/*)

3922

4338

</p></dd><dt><span class="term">%t </span></dt><dd><p>`to:' field (recipients)

3923

</p></dd><dt><span class="term">%T </span></dt><dd><p>the appropriate character from the <a href="#to-chars" title="3.277. to_chars">$to_chars</a> string

4339

</p></dd><dt><span class="term">%T </span></dt><dd><p>the appropriate character from the <a href="#to-chars" title="3.289. to_chars">$to_chars</a> string

3924

4340

</p></dd><dt><span class="term">%u </span></dt><dd><p>user (login) name of the author

3925

4341

</p></dd><dt><span class="term">%v </span></dt><dd><p>first name of the author, or the recipient if the message is from you

3926

4342

</p></dd><dt><span class="term">%X </span></dt><dd><p>number of attachments

3943

4359

function ``strftime''; a leading bang disables locales.

3944

4360

</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with character "X"

3945

4361

</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with character "X"

4362

</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character "X" as pad

3946

4363

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

3947

4364

3948

4365

</p><p>

3949

See also: ``<a href="#to-chars" title="3.277. to_chars">$to_chars</a>''.

3950

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ispell"></a>3.96. ispell</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3951

Default: "/usr/bin/ispell"</p></div><p>

4366

`Soft-fill' deserves some explanation. Normal right-justification

4367

will print everything to the left of the %>, displaying padding and

4368

the whatever lies to the right only if there's room. By contrast,

4369

soft-fill gives priority to the right-hand side, guaranteeing space

4370

to display it and showing padding only if there's still room. If

4371

necessary, soft-fill will eat text leftwards to make room for

4372

rightward text.

4373

</p><p>

4374

Note that these expandos are supported in

4375

``<a href="#save-hook" title="16. Specify default save mailbox">save-hook</a>'', ``<a href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a>'' and ``<a href="#fcc-save-hook" title="18. Specify default save filename and default Fcc: mailbox at once">fcc-save-hook</a>'', too.

4376

</p><p>

4377

See also: ``<a href="#to-chars" title="3.289. to_chars">$to_chars</a>''.

4378

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ispell"></a>3.101. ispell</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4379

Default: "ispell"</p></div><p>

3952

4380

How to invoke ispell (GNU's spell-checking software).

3953

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="keep-flagged"></a>3.97. keep_flagged</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4381

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="keep-flagged"></a>3.102. keep_flagged</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3954

4382

Default: no</p></div><p>

3955

4383

If set, read messages marked as flagged will not be moved

3956

from your spool mailbox to your ``<a href="#mbox" title="3.110. mbox">$mbox</a>'' mailbox, or as a result of

3957

a ``<a href="#mbox-hook" title="11. Using Multiple spool mailboxes">mbox-hook</a>'' command.

3958

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="locale"></a>3.98. locale</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4384

from your spool mailbox to your ``<a href="#mbox" title="3.115. mbox">$mbox</a>'' mailbox, or as a result of

4385

a ``<a href="#mbox-hook" title="12. Using Multiple spool mailboxes">mbox-hook</a>'' command.

4386

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="locale"></a>3.103. locale</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3959

4387

Default: "C"</p></div><p>

3960

4388

The locale used by <span class="emphasis"><em>strftime(3)</em></span> to format dates. Legal values are

3961

4389

the strings your system accepts for the locale variable <span class="emphasis"><em>LC_TIME</em></span>.

3962

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check"></a>3.99. mail_check</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4390

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mail-check"></a>3.104. mail_check</h3></div></div></div><div class="literallayout"><p>Type: number<br />

3963

4391

Default: 5</p></div><p>

3964

4392

This variable configures how often (in seconds) mutt should look for

3965

new mail.

3966

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-path"></a>3.100. mailcap_path</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4393

new mail. Also see the ``<a href="#timeout" title="3.287. timeout">$timeout</a>'' variable.

4394

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-path"></a>3.105. mailcap_path</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3967

4395

Default: ""</p></div><p>

3968

4396

This variable specifies which files to consult when attempting to

3969

4397

display MIME bodies not directly supported by Mutt.

3970

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-sanitize"></a>3.101. mailcap_sanitize</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4398

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mailcap-sanitize"></a>3.106. mailcap_sanitize</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3971

4399

Default: yes</p></div><p>

3972

4400

If set, mutt will restrict possible characters in mailcap % expandos

3973

4401

to a well-defined set of safe characters. This is the safe setting,

3975

4403

</p><p>

3976

4404

<span class="bold"><strong>DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE

3977

4405

DOING!</strong></span>

3978

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache"></a>3.102. header_cache</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4406

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache"></a>3.107. header_cache</h3></div></div></div><div class="literallayout"><p>Type: path<br />

3979

4407

Default: ""</p></div><p>

3980

4408

The header_cache variable points to the header cache database.

3981

4409

If header_cache points to a directory it will contain a header cache

3982

4410

database per folder. If header_cache points to a file that file will

3983

4411

be a single global header cache. By default it is unset so no header

3984

4412

caching will be used.

3985

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.103. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4413

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-header-cache-verify"></a>3.108. maildir_header_cache_verify</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3986

4414

Default: yes</p></div><p>

3987

4415

Check for Maildir unaware programs other than mutt having modified maildir

3988

4416

files when the header cache is in use. This incurs one stat(2) per

3989

4417

message every time the folder is opened.

3990

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-pagesize"></a>3.104. header_cache_pagesize</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4418

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-pagesize"></a>3.109. header_cache_pagesize</h3></div></div></div><div class="literallayout"><p>Type: string<br />

3991

4419

Default: "16384"</p></div><p>

3992

4420

When mutt is compiled with either gdbm or bdb4 as the header cache backend,

3993

4421

this option changes the database page size. Too large or too small

3994

4422

values can waste space, memory, or CPU time. The default should be more

3995

4423

or less optimal for most use cases.

3996

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-compress"></a>3.105. header_cache_compress</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

3997

Default: no</p></div><p>

4424

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="header-cache-compress"></a>3.110. header_cache_compress</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4425

Default: yes</p></div><p>

3998

4426

When mutt is compiled with qdbm as header cache backend,

3999

4427

this option determines whether the database will be compressed.

4000

4428

Compression results in database files roughly being one fifth

4001

4429

of the usual diskspace, but the uncompression can result in a

4002

4430

slower opening of cached folder(s).

4003

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.106. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4431

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="maildir-trash"></a>3.111. maildir_trash</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4004

4432

Default: no</p></div><p>

4005

4433

If set, messages marked as deleted will be saved with the maildir

4006

4434

(T)rashed flag instead of unlinked. <span class="bold"><strong>NOTE:</strong></span> this only applies

4007

4435

to maildir-style mailboxes. Setting it will have no effect on other

4008

4436

mailbox types.

4009

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.107. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4437

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mark-old"></a>3.112. mark_old</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4010

4438

Default: yes</p></div><p>

4011

4439

Controls whether or not mutt marks <span class="emphasis"><em>new</em></span> <span class="bold"><strong>unread</strong></span>

4012

4440

messages as <span class="emphasis"><em>old</em></span> if you exit a mailbox without reading them.

4013

4441

With this option set, the next time you start mutt, the messages

4014

4442

will show up with an "O" next to them in the index menu,

4015

4443

indicating that they are old.

4016

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.108. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4444

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="markers"></a>3.113. markers</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4017

4445

Default: yes</p></div><p>

4018

4446

Controls the display of wrapped lines in the internal pager. If set, a

4019

4447

``+'' marker is displayed at the beginning of wrapped lines. Also see

4020

the ``<a href="#smart-wrap" title="3.256. smart_wrap">$smart_wrap</a>'' variable.

4021

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.109. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4448

the ``<a href="#smart-wrap" title="3.264. smart_wrap">$smart_wrap</a>'' variable.

4449

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mask"></a>3.114. mask</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4022

4450

Default: "!^\.[^.]"</p></div><p>

4023

4451

A regular expression used in the file browser, optionally preceded by

4024

4452

the <span class="emphasis"><em>not</em></span> operator ``!''. Only files whose names match this mask

4025

4453

will be shown. The match is always case-sensitive.

4026

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.110. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4454

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox"></a>3.115. mbox</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4027

4455

Default: "˜/mbox"</p></div><p>

4028

This specifies the folder into which read mail in your ``<a href="#spoolfile" title="3.265. spoolfile">$spoolfile</a>''

4456

This specifies the folder into which read mail in your ``<a href="#spoolfile" title="3.276. spoolfile">$spoolfile</a>''

4029

4457

folder will be appended.

4030

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.111. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />

4458

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mbox-type"></a>3.116. mbox_type</h3></div></div></div><div class="literallayout"><p>Type: folder magic<br />

4031

4459

Default: mbox</p></div><p>

4032

4460

The default mailbox type used when creating new folders. May be any of

4033

4461

mbox, MMDF, MH and Maildir.

4034

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="metoo"></a>3.112. metoo</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4462

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="metoo"></a>3.117. metoo</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4035

4463

Default: no</p></div><p>

4036

4464

If unset, Mutt will remove your address (see the ``alternates''

4037

4465

command) from the list of recipients when replying to a message.

4038

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.113. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4466

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-context"></a>3.118. menu_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4039

4467

Default: 0</p></div><p>

4040

4468

This variable controls the number of lines of context that are given

4041

when scrolling through menus. (Similar to ``<a href="#pager-context" title="3.132. pager_context">$pager_context</a>''.)

4042

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.114. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4469

when scrolling through menus. (Similar to ``<a href="#pager-context" title="3.138. pager_context">$pager_context</a>''.)

4470

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-move-off"></a>3.119. menu_move_off</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4043

4471

Default: yes</p></div><p>

4044

4472

When <span class="emphasis"><em>unset</em></span>, the bottom entry of menus will never scroll up past

4045

4473

the bottom of the screen, unless there are less entries than lines.

4046

4474

When <span class="emphasis"><em>set</em></span>, the bottom entry may move off the bottom.

4047

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.115. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4475

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="menu-scroll"></a>3.120. menu_scroll</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4048

4476

Default: no</p></div><p>

4049

4477

When <span class="emphasis"><em>set</em></span>, menus will be scrolled up or down one line when you

4050

4478

attempt to move across a screen boundary. If <span class="emphasis"><em>unset</em></span>, the screen

4051

4479

is cleared and the next or previous page of the menu is displayed

4052

4480

(useful for slow links to avoid many redraws).

4053

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.116. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4481

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="meta-key"></a>3.121. meta_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4054

4482

Default: no</p></div><p>

4055

4483

If set, forces Mutt to interpret keystrokes with the high bit (bit 8)

4056

4484

set as if the user had pressed the ESC key and whatever key remains

4059

4487

pressed ESC then ``x''. This is because the result of removing the

4060

4488

high bit from ``0xf8'' is ``0x78'', which is the ASCII character

4061

4489

``x''.

4062

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-purge"></a>3.117. mh_purge</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4490

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-purge"></a>3.122. mh_purge</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4063

4491

Default: no</p></div><p>

4064

4492

When unset, mutt will mimic mh's behaviour and rename deleted messages

4065

4493

to <span class="emphasis"><em>,<old file name></em></span> in mh folders instead of really deleting

4066

4494

them. If the variable is set, the message files will simply be

4067

4495

deleted.

4068

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-flagged"></a>3.118. mh_seq_flagged</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4496

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-flagged"></a>3.123. mh_seq_flagged</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4069

4497

Default: "flagged"</p></div><p>

4070

4498

The name of the MH sequence used for flagged messages.

4071

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-replied"></a>3.119. mh_seq_replied</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4499

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-replied"></a>3.124. mh_seq_replied</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4072

4500

Default: "replied"</p></div><p>

4073

4501

The name of the MH sequence used to tag replied messages.

4074

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-unseen"></a>3.120. mh_seq_unseen</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4502

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mh-seq-unseen"></a>3.125. mh_seq_unseen</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4075

4503

Default: "unseen"</p></div><p>

4076

4504

The name of the MH sequence used for unseen messages.

4077

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward"></a>3.121. mime_forward</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4505

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward"></a>3.126. mime_forward</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4078

4506

Default: no</p></div><p>

4079

4507

When set, the message you are forwarding will be attached as a

4080

4508

separate MIME part instead of included in the main body of the

4083

4511

to switch between MIME and not MIME from mail to mail, set this

4084

4512

variable to ask-no or ask-yes.

4085

4513

</p><p>

4086

Also see ``<a href="#forward-decode" title="3.58. forward_decode">$forward_decode</a>'' and ``<a href="#mime-forward-decode" title="3.122. mime_forward_decode">$mime_forward_decode</a>''.

4087

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.122. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4514

Also see ``<a href="#forward-decode" title="3.62. forward_decode">$forward_decode</a>'' and ``<a href="#mime-forward-decode" title="3.127. mime_forward_decode">$mime_forward_decode</a>''.

4515

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-decode"></a>3.127. mime_forward_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4088

4516

Default: no</p></div><p>

4089

4517

Controls the decoding of complex MIME messages into text/plain when

4090

forwarding a message while ``<a href="#mime-forward" title="3.121. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>set</em></span>. Otherwise

4091

``<a href="#forward-decode" title="3.58. forward_decode">$forward_decode</a>'' is used instead.

4092

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.123. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4518

forwarding a message while ``<a href="#mime-forward" title="3.126. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>set</em></span>. Otherwise

4519

``<a href="#forward-decode" title="3.62. forward_decode">$forward_decode</a>'' is used instead.

4520

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mime-forward-rest"></a>3.128. mime_forward_rest</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4093

4521

Default: yes</p></div><p>

4094

4522

When forwarding multiple attachments of a MIME message from the recvattach

4095

4523

menu, attachments which cannot be decoded in a reasonable manner will

4096

4524

be attached to the newly composed message if this option is set.

4097

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.124. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4525

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix-entry-format"></a>3.129. mix_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4098

4526

Default: "%4n %c %-16s %a"</p></div><p>

4099

4527

This variable describes the format of a remailer line on the mixmaster

4100

4528

chain selection screen. The following printf-like sequences are

4106

4534

</p></dd><dt><span class="term">%s </span></dt><dd><p>The remailer's short name.

4107

4535

</p></dd><dt><span class="term">%a </span></dt><dd><p>The remailer's e-mail address.

4108

4536

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

4109

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.125. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4537

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mixmaster"></a>3.130. mixmaster</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4110

4538

Default: "mixmaster"</p></div><p>

4111

4539

This variable contains the path to the Mixmaster binary on your

4112

4540

system. It is used with various sets of parameters to gather the

4113

4541

list of known remailers, and to finally send a message through the

4114

4542

mixmaster chain.

4115

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.126. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4543

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="move"></a>3.131. move</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4116

4544

Default: ask-no</p></div><p>

4117

4545

Controls whether or not Mutt will move read messages

4118

from your spool mailbox to your ``<a href="#mbox" title="3.110. mbox">$mbox</a>'' mailbox, or as a result of

4119

a ``<a href="#mbox-hook" title="11. Using Multiple spool mailboxes">mbox-hook</a>'' command.

4120

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.127. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4546

from your spool mailbox to your ``<a href="#mbox" title="3.115. mbox">$mbox</a>'' mailbox, or as a result of

4547

a ``<a href="#mbox-hook" title="12. Using Multiple spool mailboxes">mbox-hook</a>'' command.

4548

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cachedir"></a>3.132. message_cachedir</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4121

4549

Default: ""</p></div><p>

4122

4550

Set this to a directory and mutt will cache copies of messages from

4123

4551

your IMAP and POP servers here. You are free to remove entries at any

4124

4552

time, for instance if stale entries accumulate because you have

4125

4553

deleted messages with another mail client.

4126

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-format"></a>3.128. message_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4554

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="message-cache-clean"></a>3.133. message_cache_clean</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4555

Default: no</p></div><p>

4556

If set, mutt will clean out obsolete entries from the cache when

4557

the mailbox is synchronized. You probably only want to set it

4558

every once in a while, since it can be a little slow.

4559

</p></div><div class="sect2" lang="en" xml:lang="en"><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 />

4127

4560

Default: "%s"</p></div><p>

4128

4561

This is the string displayed in the ``attachment'' menu for

4129

4562

attachments of type message/rfc822. For a full listing of defined

4130

printf()-like sequences see the section on ``<a href="#index-format" title="3.95. index_format">$index_format</a>''.

4131

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.129. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4563

printf()-like sequences see the section on ``<a href="#index-format" title="3.100. index_format">$index_format</a>''.

4564

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="narrow-tree"></a>3.135. narrow_tree</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4132

4565

Default: no</p></div><p>

4133

4566

This variable, when set, makes the thread tree narrower, allowing

4134

4567

deeper threads to fit on the screen.

4135

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.130. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4568

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="net-inc"></a>3.136. net_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4136

4569

Default: 10</p></div><p>

4137

4570

Operations that expect to transfer a large amount of data over the

4138

4571

network will update their progress every <span class="emphasis"><em>net_inc</em></span> kilobytes.

4139

4572

If set to 0, no progress messages will be displayed.

4140

4573

</p><p>

4141

See also ``<a href="#read-inc" title="3.228. read_inc">$read_inc</a>'' and ``<a href="#write-inc" title="3.291. write_inc">$write_inc</a>''.

4142

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.131. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4574

See also ``<a href="#read-inc" title="3.235. read_inc">$read_inc</a>'' and ``<a href="#write-inc" title="3.304. write_inc">$write_inc</a>''.

4575

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager"></a>3.137. pager</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4143

4576

Default: "builtin"</p></div><p>

4144

4577

This variable specifies which pager you would like to use to view

4145

4578

messages. builtin means to use the builtin pager, otherwise this

4150

4583

keystrokes are necessary because you can't call mutt functions

4151

4584

directly from the pager, and screen resizes cause lines longer than

4152

4585

the screen width to be badly formatted in the help menu.

4153

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-context"></a>3.132. pager_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4586

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-context"></a>3.138. pager_context</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4154

4587

Default: 0</p></div><p>

4155

4588

This variable controls the number of lines of context that are given

4156

4589

when displaying the next or previous page in the internal pager. By

4157

4590

default, Mutt will display the line after the last one on the screen

4158

4591

at the top of the next page (0 lines of context).

4159

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-format"></a>3.133. pager_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4160

Default: "-%Z- %C/%m: %-20.20n %s"</p></div><p>

4592

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-format"></a>3.139. pager_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4593

Default: "-%Z- %C/%m: %-20.20n %s%* -- (%P)"</p></div><p>

4161

4594

This variable controls the format of the one-line message ``status''

4162

4595

displayed before each message in either the internal or an external

4163

pager. The valid sequences are listed in the ``<a href="#index-format" title="3.95. index_format">$index_format</a>''

4596

pager. The valid sequences are listed in the ``<a href="#index-format" title="3.100. index_format">$index_format</a>''

4164

4597

section.

4165

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-index-lines"></a>3.134. pager_index_lines</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4598

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-index-lines"></a>3.140. pager_index_lines</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4166

4599

Default: 0</p></div><p>

4167

4600

Determines the number of lines of a mini-index which is shown when in

4168

4601

the pager. The current message, unless near the top or bottom of the

4175

4608

no index being shown. If the number of messages in the current folder

4176

4609

is less than <span class="emphasis"><em>pager_index_lines</em></span>, then the index will only use as

4177

4610

many lines as it needs.

4178

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.135. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4611

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pager-stop"></a>3.141. pager_stop</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4179

4612

Default: no</p></div><p>

4180

4613

When set, the internal-pager will <span class="bold"><strong>not</strong></span> move to the next message

4181

4614

when you are at the end of a message and invoke the <span class="emphasis"><em>next-page</em></span>

4182

4615

function.

4183

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.136. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4616

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autosign"></a>3.142. crypt_autosign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4184

4617

Default: no</p></div><p>

4185

4618

Setting this variable will cause Mutt to always attempt to

4186

4619

cryptographically sign outgoing messages. This can be overridden

4187

4620

by use of the <span class="emphasis"><em>pgp-menu</em></span>, when signing is not required or

4188

encryption is requested as well. If ``<a href="#smime-is-default" title="3.145. smime_is_default">$smime_is_default</a>'' is set,

4621

encryption is requested as well. If ``<a href="#smime-is-default" title="3.151. smime_is_default">$smime_is_default</a>'' is set,

4189

4622

then OpenSSL is used instead to create S/MIME messages and settings can

4190

4623

be overridden by use of the <span class="emphasis"><em>smime-menu</em></span>.

4191

4624

(Crypto only)

4192

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.137. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4625

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-autoencrypt"></a>3.143. crypt_autoencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4193

4626

Default: no</p></div><p>

4194

4627

Setting this variable will cause Mutt to always attempt to PGP

4195

4628

encrypt outgoing messages. This is probably only useful in

4196

4629

connection to the <span class="emphasis"><em>send-hook</em></span> command. It can be overridden

4197

4630

by use of the <span class="emphasis"><em>pgp-menu</em></span>, when encryption is not required or

4198

signing is requested as well. IF ``<a href="#smime-is-default" title="3.145. smime_is_default">$smime_is_default</a>'' is set,

4631

signing is requested as well. IF ``<a href="#smime-is-default" title="3.151. smime_is_default">$smime_is_default</a>'' is set,

4199

4632

then OpenSSL is used instead to create S/MIME messages and

4200

4633

settings can be overridden by use of the <span class="emphasis"><em>smime-menu</em></span>.

4201

4634

(Crypto only)

4202

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.138. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4635

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-ignore-subkeys"></a>3.144. pgp_ignore_subkeys</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4203

4636

Default: yes</p></div><p>

4204

4637

Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,

4205

4638

the principal key will inherit the subkeys' capabilities. Unset this

4206

4639

if you want to play interesting key selection games.

4207

4640

(PGP only)

4208

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.139. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4641

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replyencrypt"></a>3.145. crypt_replyencrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4209

4642

Default: yes</p></div><p>

4210

4643

If set, automatically PGP or OpenSSL encrypt replies to messages which are

4211

4644

encrypted.

4212

4645

(Crypto only)

4213

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.140. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4646

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysign"></a>3.146. crypt_replysign</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4214

4647

Default: no</p></div><p>

4215

4648

If set, automatically PGP or OpenSSL sign replies to messages which are

4216

4649

signed.

4218

4651

<span class="bold"><strong>Note:</strong></span> this does not work on messages that are encrypted

4219

4652

<span class="bold"><strong>and</strong></span> signed!

4220

4653

(Crypto only)

4221

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.141. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4654

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-replysignencrypted"></a>3.147. crypt_replysignencrypted</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4222

4655

Default: no</p></div><p>

4223

4656

If set, automatically PGP or OpenSSL sign replies to messages

4224

4657

which are encrypted. This makes sense in combination with

4225

``<a href="#crypt-replyencrypt" title="3.139. crypt_replyencrypt">$crypt_replyencrypt</a>'', because it allows you to sign all

4658

``<a href="#crypt-replyencrypt" title="3.145. crypt_replyencrypt">$crypt_replyencrypt</a>'', because it allows you to sign all

4226

4659

messages which are automatically encrypted. This works around

4227

the problem noted in ``<a href="#crypt-replysign" title="3.140. crypt_replysign">$crypt_replysign</a>'', that mutt is not able

4660

the problem noted in ``<a href="#crypt-replysign" title="3.146. crypt_replysign">$crypt_replysign</a>'', that mutt is not able

4228

4661

to find out whether an encrypted message is also signed.

4229

4662

(Crypto only)

4230

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.142. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4663

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-timestamp"></a>3.148. crypt_timestamp</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4231

4664

Default: yes</p></div><p>

4232

4665

If set, mutt will include a time stamp in the lines surrounding

4233

4666

PGP or S/MIME output, so spoofing such lines is more difficult.

4234

4667

If you are using colors to mark these lines, and rely on these,

4235

4668

you may unset this setting.

4236

4669

(Crypto only)

4237

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.143. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4670

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-use-gpg-agent"></a>3.149. pgp_use_gpg_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4238

4671

Default: no</p></div><p>

4239

4672

If set, mutt will use a possibly-running gpg-agent process.

4240

4673

(PGP only)

4241

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.144. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4674

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="crypt-verify-sig"></a>3.150. crypt_verify_sig</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4242

4675

Default: yes</p></div><p>

4243

4676

If ``yes'', always attempt to verify PGP or S/MIME signatures.

4244

4677

If ``ask'', ask whether or not to verify the signature.

4245

4678

If ``no'', never attempt to verify cryptographic signatures.

4246

4679

(Crypto only)

4247

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.145. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4680

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-is-default"></a>3.151. smime_is_default</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4248

4681

Default: no</p></div><p>

4249

4682

The default behaviour of mutt is to use PGP on all auto-sign/encryption

4250

4683

operations. To override and to use OpenSSL instead this must be set.

4251

4684

However, this has no effect while replying, since mutt will automatically

4252

4685

select the same application that was used to sign/encrypt the original

4253

message. (Note that this variable can be overridden by unsetting <a href="#crypt-autosmime" title="3.35. crypt_autosmime">$crypt_autosmime</a>.)

4686

message. (Note that this variable can be overridden by unsetting <a href="#crypt-autosmime" title="3.39. crypt_autosmime">$crypt_autosmime</a>.)

4254

4687

(S/MIME only)

4255

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.146. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4688

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ask-cert-label"></a>3.152. smime_ask_cert_label</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4256

4689

Default: yes</p></div><p>

4257

4690

This flag controls whether you want to be asked to enter a label

4258

4691

for a certificate about to be added to the database or not. It is

4259

4692

set by default.

4260

4693

(S/MIME only)

4261

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.147. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4694

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-use-default-key"></a>3.153. smime_decrypt_use_default_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4262

4695

Default: yes</p></div><p>

4263

4696

If set (default) this tells mutt to use the default key for decryption. Otherwise,

4264

4697

if manage multiple certificate-key-pairs, mutt will try to use the mailbox-address

4265

4698

to determine the key to use. It will ask you to supply a key, if it can't find one.

4266

4699

(S/MIME only)

4267

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.148. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4700

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-entry-format"></a>3.154. pgp_entry_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4268

4701

Default: "%4n %t%f %4l/0x%k %-4a %2c %u"</p></div><p>

4269

4702

This variable allows you to customize the PGP key selection menu to

4270

your personal taste. This string is similar to ``<a href="#index-format" title="3.95. index_format">$index_format</a>'', but

4703

your personal taste. This string is similar to ``<a href="#index-format" title="3.100. index_format">$index_format</a>'', but

4271

4704

has its own set of printf()-like sequences:

4272

4705

</p><p>

4273

4706

4284

4717

4285

4718

</p><p>

4286

4719

(PGP only)

4287

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.149. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4720

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-good-sign"></a>3.155. pgp_good_sign</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4288

4721

Default: ""</p></div><p>

4289

4722

If you assign a text to this variable, then a PGP signature is only

4290

considered verified if the output from <a href="#pgp-verify-command" title="3.164. pgp_verify_command">$pgp_verify_command</a> contains

4723

considered verified if the output from <a href="#pgp-verify-command" title="3.170. pgp_verify_command">$pgp_verify_command</a> contains

4291

4724

the text. Use this variable if the exit code from the command is 0

4292

4725

even for bad signatures.

4293

4726

(PGP only)

4294

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.150. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4727

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-check-exit"></a>3.156. pgp_check_exit</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4295

4728

Default: yes</p></div><p>

4296

4729

If set, mutt will check the exit code of the PGP subprocess when

4297

4730

signing or encrypting. A non-zero exit code means that the

4298

4731

subprocess failed.

4299

4732

(PGP only)

4300

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.151. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4733

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-long-ids"></a>3.157. pgp_long_ids</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4301

4734

Default: no</p></div><p>

4302

4735

If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs.

4303

4736

(PGP only)

4304

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.152. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4737

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-retainable-sigs"></a>3.158. pgp_retainable_sigs</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4305

4738

Default: no</p></div><p>

4306

4739

If set, signed and encrypted messages will consist of nested

4307

4740

multipart/signed and multipart/encrypted body parts.

4310

4743

lists, where the outer layer (multipart/encrypted) can be easily

4311

4744

removed, while the inner multipart/signed part is retained.

4312

4745

(PGP only)

4313

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.153. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4746

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-autoinline"></a>3.159. pgp_autoinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4314

4747

Default: no</p></div><p>

4315

4748

This option controls whether Mutt generates old-style inline

4316

4749

(traditional) PGP encrypted or signed messages under certain

4321

4754

which consist of more than a single MIME part. Mutt can be

4322

4755

configured to ask before sending PGP/MIME messages when inline

4323

4756

(traditional) would not work.

4324

See also: ``<a href="#pgp-mime-auto" title="3.160. pgp_mime_auto">$pgp_mime_auto</a>''.

4757

See also: ``<a href="#pgp-mime-auto" title="3.166. pgp_mime_auto">$pgp_mime_auto</a>''.

4325

4758

</p><p>

4326

4759

Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>

4327

4760

<span class="bold"><strong>deprecated</strong></span>.

4328

4761

(PGP only)

4329

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.154. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4762

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-replyinline"></a>3.160. pgp_replyinline</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4330

4763

Default: no</p></div><p>

4331

4764

Setting this variable will cause Mutt to always attempt to

4332

4765

create an inline (traditional) message when replying to a

4340

4773

which consist of more than a single MIME part. Mutt can be

4341

4774

configured to ask before sending PGP/MIME messages when inline

4342

4775

(traditional) would not work.

4343

See also: ``<a href="#pgp-mime-auto" title="3.160. pgp_mime_auto">$pgp_mime_auto</a>''.

4776

See also: ``<a href="#pgp-mime-auto" title="3.166. pgp_mime_auto">$pgp_mime_auto</a>''.

4344

4777

</p><p>

4345

4778

Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>

4346

4779

<span class="bold"><strong>deprecated</strong></span>.

4347

4780

(PGP only)

4348

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.155. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4781

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-show-unusable"></a>3.161. pgp_show_unusable</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4349

4782

Default: yes</p></div><p>

4350

4783

If set, mutt will display non-usable keys on the PGP key selection

4351

4784

menu. This includes keys which have been revoked, have expired, or

4352

4785

have been marked as ``disabled'' by the user.

4353

4786

(PGP only)

4354

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.156. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4787

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-as"></a>3.162. pgp_sign_as</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4355

4788

Default: ""</p></div><p>

4356

4789

If you have more than one key pair, this option allows you to specify

4357

4790

which of your private keys to use. It is recommended that you use the

4358

4791

keyid form to specify your key (e.g., ``0x00112233'').

4359

4792

(PGP only)

4360

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.157. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4793

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-strict-enc"></a>3.163. pgp_strict_enc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4361

4794

Default: yes</p></div><p>

4362

4795

If set, Mutt will automatically encode PGP/MIME signed messages as

4363

4796

<span class="emphasis"><em>quoted-printable</em></span>. Please note that unsetting this variable may

4364

4797

lead to problems with non-verifyable PGP signatures, so only change

4365

4798

this if you know what you are doing.

4366

4799

(PGP only)

4367

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.158. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4800

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-timeout"></a>3.164. pgp_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4368

4801

Default: 300</p></div><p>

4369

4802

The number of seconds after which a cached passphrase will expire if

4370

4803

not used.

4371

4804

(PGP only)

4372

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.159. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

4805

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sort-keys"></a>3.165. pgp_sort_keys</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

4373

4806

Default: address</p></div><p>

4374

4807

Specifies how the entries in the `pgp keys' menu are sorted. The

4375

4808

following are legal values:

4385

4818

If you prefer reverse order of the above values, prefix it with

4386

4819

`reverse-'.

4387

4820

(PGP only)

4388

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.160. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4821

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-mime-auto"></a>3.166. pgp_mime_auto</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4389

4822

Default: ask-yes</p></div><p>

4390

4823

This option controls whether Mutt will prompt you for

4391

4824

automatically sending a (signed/encrypted) message using

4394

4827

Also note that using the old-style PGP message format is <span class="bold"><strong>strongly</strong></span>

4395

4828

<span class="bold"><strong>deprecated</strong></span>.

4396

4829

(PGP only)

4397

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.161. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4830

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-auto-decode"></a>3.167. pgp_auto_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4398

4831

Default: no</p></div><p>

4399

4832

If set, mutt will automatically attempt to decrypt traditional PGP

4400

4833

messages whenever the user performs an operation which ordinarily would

4402

4835

if the user displays a pgp-traditional message which has not been manually

4403

4836

checked with the check-traditional-pgp function, mutt will automatically

4404

4837

check the message for traditional pgp.

4405

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.162. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4838

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decode-command"></a>3.168. pgp_decode_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4406

4839

Default: ""</p></div><p>

4407

4840

This format strings specifies a command which is used to decode

4408

4841

application/pgp attachments.

4415

4848

</p></dd><dt><span class="term">%f </span></dt><dd><p>Expands to the name of a file containing a message.

4416

4849

</p></dd><dt><span class="term">%s </span></dt><dd><p>Expands to the name of a file containing the signature part

4417

4850

of a multipart/signed attachment when verifying it.

4418

</p></dd><dt><span class="term">%a </span></dt><dd><p>The value of <a href="#pgp-sign-as" title="3.156. pgp_sign_as">$pgp_sign_as</a>.

4851

</p></dd><dt><span class="term">%a </span></dt><dd><p>The value of <a href="#pgp-sign-as" title="3.162. pgp_sign_as">$pgp_sign_as</a>.

4419

4852

</p></dd><dt><span class="term">%r </span></dt><dd><p>One or more key IDs.

4420

4853

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

4421

4854

4425

4858

the samples/ subdirectory which has been installed on your system

4426

4859

alongside the documentation.

4427

4860

(PGP only)

4428

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.163. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4861

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-getkeys-command"></a>3.169. pgp_getkeys_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4429

4862

Default: ""</p></div><p>

4430

4863

This command is invoked whenever mutt will need public key information.

4431

4864

%r is the only printf-like sequence used with this format.

4432

4865

(PGP only)

4433

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.164. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4866

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-command"></a>3.170. pgp_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4434

4867

Default: ""</p></div><p>

4435

4868

This command is used to verify PGP signatures.

4436

4869

(PGP only)

4437

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.165. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4870

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-decrypt-command"></a>3.171. pgp_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4438

4871

Default: ""</p></div><p>

4439

4872

This command is used to decrypt a PGP encrypted message.

4440

4873

(PGP only)

4441

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.166. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4874

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-clearsign-command"></a>3.172. pgp_clearsign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4442

4875

Default: ""</p></div><p>

4443

4876

This format is used to create a old-style "clearsigned" PGP

4444

4877

message. Note that the use of this format is <span class="bold"><strong>strongly</strong></span>

4445

4878

<span class="bold"><strong>deprecated</strong></span>.

4446

4879

(PGP only)

4447

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.167. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4880

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-sign-command"></a>3.173. pgp_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4448

4881

Default: ""</p></div><p>

4449

4882

This command is used to create the detached PGP signature for a

4450

4883

multipart/signed PGP/MIME body part.

4451

4884

(PGP only)

4452

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.168. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4885

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-sign-command"></a>3.174. pgp_encrypt_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4453

4886

Default: ""</p></div><p>

4454

4887

This command is used to both sign and encrypt a body part.

4455

4888

(PGP only)

4456

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.169. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4889

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-encrypt-only-command"></a>3.175. pgp_encrypt_only_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4457

4890

Default: ""</p></div><p>

4458

4891

This command is used to encrypt a body part without signing it.

4459

4892

(PGP only)

4460

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.170. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4893

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-import-command"></a>3.176. pgp_import_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4461

4894

Default: ""</p></div><p>

4462

4895

This command is used to import a key from a message into

4463

4896

the user's public key ring.

4464

4897

(PGP only)

4465

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.171. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4898

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-export-command"></a>3.177. pgp_export_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4466

4899

Default: ""</p></div><p>

4467

4900

This command is used to export a public key from the user's

4468

4901

key ring.

4469

4902

(PGP only)

4470

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.172. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4903

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-verify-key-command"></a>3.178. pgp_verify_key_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4471

4904

Default: ""</p></div><p>

4472

4905

This command is used to verify key information from the key selection

4473

4906

menu.

4474

4907

(PGP only)

4475

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.173. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4908

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-secring-command"></a>3.179. pgp_list_secring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4476

4909

Default: ""</p></div><p>

4477

4910

This command is used to list the secret key ring's contents. The

4478

4911

output format must be analogous to the one used by

4481

4914

This format is also generated by the pgpring utility which comes

4482

4915

with mutt.

4483

4916

(PGP only)

4484

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.174. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4917

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp-list-pubring-command"></a>3.180. pgp_list_pubring_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4485

4918

Default: ""</p></div><p>

4486

4919

This command is used to list the public key ring's contents. The

4487

4920

output format must be analogous to the one used by

4490

4923

This format is also generated by the pgpring utility which comes

4491

4924

with mutt.

4492

4925

(PGP only)

4493

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decrypt"></a>3.175. forward_decrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4926

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="forward-decrypt"></a>3.181. forward_decrypt</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4494

4927

Default: yes</p></div><p>

4495

4928

Controls the handling of encrypted messages when forwarding a message.

4496

4929

When set, the outer layer of encryption is stripped off. This

4497

variable is only used if ``<a href="#mime-forward" title="3.121. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>set</em></span> and

4498

``<a href="#mime-forward-decode" title="3.122. mime_forward_decode">$mime_forward_decode</a>'' is <span class="emphasis"><em>unset</em></span>.

4930

variable is only used if ``<a href="#mime-forward" title="3.126. mime_forward">$mime_forward</a>'' is <span class="emphasis"><em>set</em></span> and

4931

``<a href="#mime-forward-decode" title="3.127. mime_forward_decode">$mime_forward_decode</a>'' is <span class="emphasis"><em>unset</em></span>.

4499

4932

(PGP only)

4500

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.176. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4933

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-timeout"></a>3.182. smime_timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4501

4934

Default: 300</p></div><p>

4502

4935

The number of seconds after which a cached passphrase will expire if

4503

4936

not used.

4504

4937

(S/MIME only)

4505

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.177. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4938

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-with"></a>3.183. smime_encrypt_with</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4506

4939

Default: ""</p></div><p>

4507

4940

This sets the algorithm that should be used for encryption.

4508

4941

Valid choices are "des", "des3", "rc2-40", "rc2-64", "rc2-128".

4509

4942

If unset "3des" (TripleDES) is used.

4510

4943

(S/MIME only)

4511

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.178. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4944

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-keys"></a>3.184. smime_keys</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4512

4945

Default: ""</p></div><p>

4513

4946

Since there is no pubring/secring as with PGP, mutt has to handle

4514

4947

storage ad retrieval of keys/certs by itself. This is very basic right now,

4517

4950

which contains mailbox-address keyid pair, and which can be manually

4518

4951

edited. This one points to the location of the private keys.

4519

4952

(S/MIME only)

4520

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.179. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4953

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-ca-location"></a>3.185. smime_ca_location</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4521

4954

Default: ""</p></div><p>

4522

4955

This variable contains the name of either a directory, or a file which

4523

4956

contains trusted certificates for use with OpenSSL.

4524

4957

(S/MIME only)

4525

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.180. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4958

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-certificates"></a>3.186. smime_certificates</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4526

4959

Default: ""</p></div><p>

4527

4960

Since there is no pubring/secring as with PGP, mutt has to handle

4528

4961

storage and retrieval of keys by itself. This is very basic right

4532

4965

keyid pairs, and which can be manually edited. This one points to

4533

4966

the location of the certificates.

4534

4967

(S/MIME only)

4535

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.181. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4968

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-decrypt-command"></a>3.187. smime_decrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4536

4969

Default: ""</p></div><p>

4537

4970

This format string specifies a command which is used to decrypt

4538

4971

application/x-pkcs7-mime attachments.

4544

4977

</p><div class="variablelist"><dl><dt><span class="term">%f </span></dt><dd><p>Expands to the name of a file containing a message.

4545

4978

</p></dd><dt><span class="term">%s </span></dt><dd><p>Expands to the name of a file containing the signature part

4546

4979

of a multipart/signed attachment when verifying it.

4547

</p></dd><dt><span class="term">%k </span></dt><dd><p>The key-pair specified with <a href="#smime-default-key" title="3.192. smime_default_key">$smime_default_key</a>

4980

</p></dd><dt><span class="term">%k </span></dt><dd><p>The key-pair specified with <a href="#smime-default-key" title="3.198. smime_default_key">$smime_default_key</a>

4548

4981

</p></dd><dt><span class="term">%c </span></dt><dd><p>One or more certificate IDs.

4549

4982

</p></dd><dt><span class="term">%a </span></dt><dd><p>The algorithm used for encryption.

4550

</p></dd><dt><span class="term">%C </span></dt><dd><p>CA location: Depending on whether <a href="#smime-ca-location" title="3.179. smime_ca_location">$smime_ca_location</a>

4983

</p></dd><dt><span class="term">%C </span></dt><dd><p>CA location: Depending on whether <a href="#smime-ca-location" title="3.185. smime_ca_location">$smime_ca_location</a>

4551

4984

points to a directory or file, this expands to

4552

"-CApath <a href="#smime-ca-location" title="3.179. smime_ca_location">$smime_ca_location</a>" or "-CAfile <a href="#smime-ca-location" title="3.179. smime_ca_location">$smime_ca_location</a>".

4985

"-CApath <a href="#smime-ca-location" title="3.185. smime_ca_location">$smime_ca_location</a>" or "-CAfile <a href="#smime-ca-location" title="3.185. smime_ca_location">$smime_ca_location</a>".

4553

4986

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

4554

4987

4555

4988

</p><p>

4557

4990

the samples/ subdirectory which has been installed on your system

4558

4991

alongside the documentation.

4559

4992

(S/MIME only)

4560

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.182. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4993

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-command"></a>3.188. smime_verify_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4561

4994

Default: ""</p></div><p>

4562

4995

This command is used to verify S/MIME signatures of type multipart/signed.

4563

4996

(S/MIME only)

4564

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.183. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4997

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-verify-opaque-command"></a>3.189. smime_verify_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4565

4998

Default: ""</p></div><p>

4566

4999

This command is used to verify S/MIME signatures of type

4567

5000

application/x-pkcs7-mime.

4568

5001

(S/MIME only)

4569

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.184. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5002

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-command"></a>3.190. smime_sign_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4570

5003

Default: ""</p></div><p>

4571

5004

This command is used to created S/MIME signatures of type

4572

5005

multipart/signed, which can be read by all mail clients.

4573

5006

(S/MIME only)

4574

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.185. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5007

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-sign-opaque-command"></a>3.191. smime_sign_opaque_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4575

5008

Default: ""</p></div><p>

4576

5009

This command is used to created S/MIME signatures of type

4577

5010

application/x-pkcs7-signature, which can only be handled by mail

4578

5011

clients supporting the S/MIME extension.

4579

5012

(S/MIME only)

4580

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.186. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5013

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-encrypt-command"></a>3.192. smime_encrypt_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4581

5014

Default: ""</p></div><p>

4582

5015

This command is used to create encrypted S/MIME messages.

4583

5016

(S/MIME only)

4584

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.187. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5017

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-pk7out-command"></a>3.193. smime_pk7out_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4585

5018

Default: ""</p></div><p>

4586

5019

This command is used to extract PKCS7 structures of S/MIME signatures,

4587

5020

in order to extract the public X509 certificate(s).

4588

5021

(S/MIME only)

4589

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.188. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5022

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-command"></a>3.194. smime_get_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4590

5023

Default: ""</p></div><p>

4591

5024

This command is used to extract X509 certificates from a PKCS7 structure.

4592

5025

(S/MIME only)

4593

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.189. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5026

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-signer-cert-command"></a>3.195. smime_get_signer_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4594

5027

Default: ""</p></div><p>

4595

5028

This command is used to extract only the signers X509 certificate from a S/MIME

4596

5029

signature, so that the certificate's owner may get compared to the

4597

5030

email's 'From'-field.

4598

5031

(S/MIME only)

4599

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.190. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5032

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-import-cert-command"></a>3.196. smime_import_cert_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4600

5033

Default: ""</p></div><p>

4601

5034

This command is used to import a certificate via smime_keys.

4602

5035

(S/MIME only)

4603

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.191. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5036

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-get-cert-email-command"></a>3.197. smime_get_cert_email_command</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4604

5037

Default: ""</p></div><p>

4605

5038

This command is used to extract the mail address(es) used for storing

4606

5039

X509 certificates, and for verification purposes (to check whether the

4607

5040

certificate was issued for the sender's mailbox).

4608

5041

(S/MIME only)

4609

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.192. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5042

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime-default-key"></a>3.198. smime_default_key</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4610

5043

Default: ""</p></div><p>

4611

5044

This is the default key-pair to use for signing. This must be set to the

4612

5045

keyid (the hash-value that OpenSSL generates) to work properly

4613

5046

(S/MIME only)

4614

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.193. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5047

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-client-cert"></a>3.199. ssl_client_cert</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4615

5048

Default: ""</p></div><p>

4616

5049

The file containing a client certificate and its associated private

4617

5050

key.

4618

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.194. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5051

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-force-tls"></a>3.200. ssl_force_tls</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4619

5052

Default: no</p></div><p>

4620

5053

If this variable is set, Mutt will require that all connections

4621

5054

to remote servers be encrypted. Furthermore it will attempt to

4622

5055

negotiate TLS even if the server does not advertise the capability,

4623

5056

since it would otherwise have to abort the connection anyway. This

4624

option supersedes ``<a href="#ssl-starttls" title="3.195. ssl_starttls">$ssl_starttls</a>''.

4625

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.195. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5057

option supersedes ``<a href="#ssl-starttls" title="3.201. ssl_starttls">$ssl_starttls</a>''.

5058

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-starttls"></a>3.201. ssl_starttls</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4626

5059

Default: yes</p></div><p>

4627

5060

If set (the default), mutt will attempt to use STARTTLS on servers

4628

5061

advertising the capability. When unset, mutt will not attempt to

4629

5062

use STARTTLS regardless of the server's capabilities.

4630

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="certificate-file"></a>3.196. certificate_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5063

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="certificate-file"></a>3.202. certificate_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4631

5064

Default: "˜/.mutt_certificates"</p></div><p>

4632

5065

This variable specifies the file where the certificates you trust

4633

5066

are saved. When an unknown certificate is encountered, you are asked

4640

5073

also automatically accepted.

4641

5074

</p><p>

4642

5075

Example: set certificate_file=˜/.mutt/certificates

4643

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.197. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5076

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-usesystemcerts"></a>3.203. ssl_usesystemcerts</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4644

5077

Default: yes</p></div><p>

4645

5078

If set to <span class="emphasis"><em>yes</em></span>, mutt will use CA certificates in the

4646

5079

system-wide certificate store when checking if server certificate

4647

5080

is signed by a trusted CA.

4648

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.198. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5081

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="entropy-file"></a>3.204. entropy_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4649

5082

Default: ""</p></div><p>

4650

5083

The file which includes random data that is used to initialize SSL

4651

5084

library functions.

4652

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.199. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5085

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv2"></a>3.205. ssl_use_sslv2</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4653

5086

Default: yes</p></div><p>

4654

5087

This variables specifies whether to attempt to use SSLv2 in the

4655

5088

SSL authentication process.

4656

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.200. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5089

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-sslv3"></a>3.206. ssl_use_sslv3</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4657

5090

Default: yes</p></div><p>

4658

5091

This variables specifies whether to attempt to use SSLv3 in the

4659

5092

SSL authentication process.

4660

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.201. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5093

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-use-tlsv1"></a>3.207. ssl_use_tlsv1</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4661

5094

Default: yes</p></div><p>

4662

5095

This variables specifies whether to attempt to use TLSv1 in the

4663

5096

SSL authentication process.

4664

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.202. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5097

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-min-dh-prime-bits"></a>3.208. ssl_min_dh_prime_bits</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4665

5098

Default: 0</p></div><p>

4666

5099

This variable specifies the minimum acceptable prime size (in bits)

4667

5100

for use in any Diffie-Hellman key exchange. A value of 0 will use

4668

5101

the default from the GNUTLS library.

4669

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.203. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5102

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="ssl-ca-certificates-file"></a>3.209. ssl_ca_certificates_file</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4670

5103

Default: ""</p></div><p>

4671

5104

This variable specifies a file containing trusted CA certificates.

4672

5105

Any server certificate that is signed with one of these CA

4673

5106

certificates are also automatically accepted.

4674

5107

</p><p>

4675

5108

Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt

4676

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.204. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5109

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-split"></a>3.210. pipe_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4677

5110

Default: no</p></div><p>

4678

5111

Used in connection with the <span class="emphasis"><em>pipe-message</em></span> command and the ``tag-

4679

5112

prefix'' operator. If this variable is unset, when piping a list of

4680

5113

tagged messages Mutt will concatenate the messages and will pipe them

4681

5114

as a single folder. When set, Mutt will pipe the messages one by one.

4682

5115

In both cases the messages are piped in the current sorted order,

4683

and the ``<a href="#pipe-sep" title="3.206. pipe_sep">$pipe_sep</a>'' separator is added after each message.

4684

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.205. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5116

and the ``<a href="#pipe-sep" title="3.212. pipe_sep">$pipe_sep</a>'' separator is added after each message.

5117

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-decode"></a>3.211. pipe_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4685

5118

Default: no</p></div><p>

4686

5119

Used in connection with the <span class="emphasis"><em>pipe-message</em></span> command. When unset,

4687

5120

Mutt will pipe the messages without any preprocessing. When set, Mutt

4688

5121

will weed headers and will attempt to PGP/MIME decode the messages

4689

5122

first.

4690

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.206. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5123

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pipe-sep"></a>3.212. pipe_sep</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4691

5124

Default: "\n"</p></div><p>

4692

5125

The separator to add between messages when piping a list of tagged

4693

5126

messages to an external Unix command.

4694

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.207. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5127

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-authenticators"></a>3.213. pop_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4695

5128

Default: ""</p></div><p>

4696

5129

This is a colon-delimited list of authentication methods mutt may

4697

5130

attempt to use to log in to an POP server, in the order mutt should

4702

5135

most-secure to least-secure.

4703

5136

</p><p>

4704

5137

Example: set pop_authenticators="digest-md5:apop:user"

4705

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-auth-try-all"></a>3.208. pop_auth_try_all</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5138

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-auth-try-all"></a>3.214. pop_auth_try_all</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4706

5139

Default: yes</p></div><p>

4707

5140

If set, Mutt will try all available methods. When unset, Mutt will

4708

5141

only fall back to other authentication methods if the previous

4709

5142

methods are unavailable. If a method is available but authentication

4710

5143

fails, Mutt will not connect to the POP server.

4711

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-checkinterval"></a>3.209. pop_checkinterval</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5144

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-checkinterval"></a>3.215. pop_checkinterval</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4712

5145

Default: 60</p></div><p>

4713

5146

This variable configures how often (in seconds) mutt should look for

4714

5147

new mail in the currently selected mailbox if it is a POP mailbox.

4715

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-delete"></a>3.210. pop_delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5148

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-delete"></a>3.216. pop_delete</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4716

5149

Default: ask-no</p></div><p>

4717

5150

If set, Mutt will delete successfully downloaded messages from the POP

4718

5151

server when using the fetch-mail function. When unset, Mutt will

4719

5152

download messages but also leave them on the POP server.

4720

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-host"></a>3.211. pop_host</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5153

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-host"></a>3.217. pop_host</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4721

5154

Default: ""</p></div><p>

4722

5155

The name of your POP server for the fetch-mail function. You

4723

5156

can also specify an alternative port, username and password, ie:

4724

5157

</p><p>

4725

5158

[pop[s]://][username[:password]@]popserver[:port]

4726

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-last"></a>3.212. pop_last</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5159

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-last"></a>3.218. pop_last</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4727

5160

Default: no</p></div><p>

4728

5161

If this variable is set, mutt will try to use the "LAST" POP command

4729

5162

for retrieving only unread messages from the POP server when using

4730

5163

the fetch-mail function.

4731

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-reconnect"></a>3.213. pop_reconnect</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5164

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-reconnect"></a>3.219. pop_reconnect</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4732

5165

Default: ask-yes</p></div><p>

4733

5166

Controls whether or not Mutt will try to reconnect to POP server if

4734

5167

the connection is lost.

4735

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-user"></a>3.214. pop_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5168

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-user"></a>3.220. pop_user</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4736

5169

Default: ""</p></div><p>

4737

5170

Your login name on the POP server.

4738

5171

</p><p>

4739

5172

This variable defaults to your user name on the local machine.

4740

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-pass"></a>3.215. pop_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5173

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pop-pass"></a>3.221. pop_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4741

5174

Default: ""</p></div><p>

4742

5175

Specifies the password for your POP account. If unset, Mutt will

4743

5176

prompt you for your password when you open POP mailbox.

4744

5177

<span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a

4745

5178

fairly secure machine, because the superuser can read your muttrc

4746

5179

even if you are the only one who can read the file.

4747

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="post-indent-string"></a>3.216. post_indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5180

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="post-indent-string"></a>3.222. post_indent_string</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4748

5181

Default: ""</p></div><p>

4749

Similar to the ``<a href="#attribution" title="3.14. attribution">$attribution</a>'' variable, Mutt will append this

5182

Similar to the ``<a href="#attribution" title="3.16. attribution">$attribution</a>'' variable, Mutt will append this

4750

5183

string after the inclusion of a message which is being replied to.

4751

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="postpone"></a>3.217. postpone</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5184

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="postpone"></a>3.223. postpone</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4752

5185

Default: ask-yes</p></div><p>

4753

Controls whether or not messages are saved in the ``<a href="#postponed" title="3.218. postponed">$postponed</a>''

4754

mailbox when you elect not to send immediately.

4755

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="postponed"></a>3.218. postponed</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5186

Controls whether or not messages are saved in the ``<a href="#postponed" title="3.224. postponed">$postponed</a>''

5187

mailbox when you elect not to send immediately. Also see the

5188

``<a href="#recall" title="3.238. recall">$recall</a>'' variable.

5189

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="postponed"></a>3.224. postponed</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4756

5190

Default: "˜/postponed"</p></div><p>

4757

Mutt allows you to indefinitely ``<a href="#postpone" title="3.217. postpone">postpone</a> sending a message'' which

5191

Mutt allows you to indefinitely ``<a href="#postpone" title="3.223. postpone">postpone</a> sending a message'' which

4758

5192

you are editing. When you choose to postpone a message, Mutt saves it

4759

in the mailbox specified by this variable. Also see the ``<a href="#postpone" title="3.217. postpone">$postpone</a>''

5193

in the mailbox specified by this variable. Also see the ``<a href="#postpone" title="3.223. postpone">$postpone</a>''

4760

5194

variable.

4761

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="preconnect"></a>3.219. preconnect</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5195

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="preconnect"></a>3.225. preconnect</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4762

5196

Default: ""</p></div><p>

4763

5197

If set, a shell command to be executed if mutt fails to establish

4764

5198

a connection to the server. This is useful for setting up secure

4773

5207

</p><p>

4774

5208

NOTE: For this example to work, you must be able to log in to the

4775

5209

remote machine without having to enter a password.

4776

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.220. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5210

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print"></a>3.226. print</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4777

5211

Default: ask-no</p></div><p>

4778

5212

Controls whether or not Mutt really prints messages.

4779

5213

This is set to <span class="emphasis"><em>ask-no</em></span> by default, because some people

4780

5214

accidentally hit ``p'' often (like me).

4781

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.221. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5215

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-command"></a>3.227. print_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4782

5216

Default: "lpr"</p></div><p>

4783

5217

This specifies the command pipe that should be used to print messages.

4784

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.222. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5218

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-decode"></a>3.228. print_decode</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4785

5219

Default: yes</p></div><p>

4786

5220

Used in connection with the print-message command. If this

4787

5221

option is set, the message is decoded before it is passed to the

4788

external command specified by <a href="#print-command" title="3.221. print_command">$print_command</a>. If this option

5222

external command specified by <a href="#print-command" title="3.227. print_command">$print_command</a>. If this option

4789

5223

is unset, no processing will be applied to the message when

4790

5224

printing it. The latter setting may be useful if you are using

4791

5225

some advanced printer filter which is able to properly format

4792

5226

e-mail messages for printing.

4793

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.223. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5227

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="print-split"></a>3.229. print_split</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4794

5228

Default: no</p></div><p>

4795

5229

Used in connection with the print-message command. If this option

4796

is set, the command specified by <a href="#print-command" title="3.221. print_command">$print_command</a> is executed once for

5230

is set, the command specified by <a href="#print-command" title="3.227. print_command">$print_command</a> is executed once for

4797

5231

each message which is to be printed. If this option is unset,

4798

the command specified by <a href="#print-command" title="3.221. print_command">$print_command</a> is executed only once, and

5232

the command specified by <a href="#print-command" title="3.227. print_command">$print_command</a> is executed only once, and

4799

5233

all the messages are concatenated, with a form feed as the message

4800

5234

separator.

4801

5235

</p><p>

4802

5236

Those who use the <span class="bold"><strong>enscript</strong></span>(1) program's mail-printing mode will

4803

5237

most likely want to set this option.

4804

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.224. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5238

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="prompt-after"></a>3.230. prompt_after</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4805

5239

Default: yes</p></div><p>

4806

If you use an <span class="emphasis"><em>external</em></span> ``<a href="#pager" title="3.131. pager">$pager</a>'', setting this variable will

5240

If you use an <span class="emphasis"><em>external</em></span> ``<a href="#pager" title="3.137. pager">$pager</a>'', setting this variable will

4807

5241

cause Mutt to prompt you for a command when the pager exits rather

4808

5242

than returning to the index menu. If unset, Mutt will return to the

4809

5243

index menu when the external pager exits.

4810

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.225. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5244

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-command"></a>3.231. query_command</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4811

5245

Default: ""</p></div><p>

4812

5246

This specifies the command that mutt will use to make external address

4813

5247

queries. The string should contain a %s, which will be substituted

4814

5248

with the query string the user types. See ``<a href="#query" title="5. External Address Queries">query</a>'' for more

4815

5249

information.

4816

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.226. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5250

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query-format"></a>3.232. query_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5251

Default: "%4c %t %-25.25a %-25.25n %?e?(%e)?"</p></div><p>

5252

This variable describes the format of the `query' menu. The

5253

following printf-style sequences are understood:

5254

</p><p>

5255

5256

</p><div class="variablelist"><dl><dt><span class="term">%a </span></dt><dd><p>destination address

5257

</p></dd><dt><span class="term">%c </span></dt><dd><p>current entry number

5258

</p></dd><dt><span class="term">%e </span></dt><dd><p>extra information *

5259

</p></dd><dt><span class="term">%n </span></dt><dd><p>destination name

5260

</p></dd><dt><span class="term">%t </span></dt><dd><p>``*'' if current entry is tagged, a space otherwise

5261

</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with "X"

5262

</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with "X"

5263

</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character "X" as pad

5264

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

5265

5266

</p><p>

5267

For an explanation of `soft-fill', see the ``<a href="#index-format" title="3.100. index_format">$index_format</a>'' documentation.

5268

</p><p>

5269

* = can be optionally printed if nonzero, see the ``<a href="#status-format" title="3.278. status_format">$status_format</a>'' documentation.

5270

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quit"></a>3.233. quit</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4817

5271

Default: yes</p></div><p>

4818

5272

This variable controls whether ``quit'' and ``exit'' actually quit

4819

5273

from mutt. If it set to yes, they do quit, if it is set to no, they

4820

5274

have no effect, and if it is set to ask-yes or ask-no, you are

4821

5275

prompted for confirmation when you try to quit.

4822

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.227. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

5276

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="quote-regexp"></a>3.234. quote_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4823

5277

Default: "^([ \t]*[|>:}#])+"</p></div><p>

4824

5278

A regular expression used in the internal-pager to determine quoted

4825

5279

sections of text in the body of a message.

4828

5282

internal pager, you need to set this to a regular expression that

4829

5283

matches <span class="emphasis"><em>exactly</em></span> the quote characters at the beginning of quoted

4830

5284

lines.

4831

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="read-inc"></a>3.228. read_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5285

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="read-inc"></a>3.235. read_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4832

5286

Default: 10</p></div><p>

4833

5287

If set to a value greater than 0, Mutt will display which message it

4834

is currently on when reading a mailbox. The message is printed after

4835

<span class="emphasis"><em>read_inc</em></span> messages have been read (e.g., if set to 25, Mutt will

4836

print a message when it reads message 25, and then again when it gets

5288

is currently on when reading a mailbox or when performing search actions

5289

such as search and limit. The message is printed after

5290

<span class="emphasis"><em>read_inc</em></span> messages have been read or searched (e.g., if set to 25, Mutt will

5291

print a message when it is at message 25, and then again when it gets

4837

5292

to message 50). This variable is meant to indicate progress when

4838

reading large mailboxes which may take some time.

5293

reading or searching large mailboxes which may take some time.

4839

5294

When set to 0, only a single message will appear before the reading

4840

5295

the mailbox.

4841

5296

</p><p>

4842

Also see the ``<a href="#write-inc" title="3.291. write_inc">$write_inc</a>'' variable.

4843

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="read-only"></a>3.229. read_only</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5297

Also see the ``<a href="#write-inc" title="3.304. write_inc">$write_inc</a>'' variable and the ``Tuning'' section of the

5298

manual for performance considerations.

5299

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="read-only"></a>3.236. read_only</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4844

5300

Default: no</p></div><p>

4845

5301

If set, all folders are opened in read-only mode.

4846

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="realname"></a>3.230. realname</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5302

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="realname"></a>3.237. realname</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4847

5303

Default: ""</p></div><p>

4848

5304

This variable specifies what "real" or "personal" name should be used

4849

5305

when sending messages.

4850

5306

</p><p>

4851

5307

By default, this is the GECOS field from /etc/passwd. Note that this

4852

5308

variable will <span class="emphasis"><em>not</em></span> be used when the user has set a real name

4853

in the <a href="#from" title="3.62. from">$from</a> variable.

4854

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="recall"></a>3.231. recall</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5309

in the <a href="#from" title="3.66. from">$from</a> variable.

5310

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="recall"></a>3.238. recall</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4855

5311

Default: ask-yes</p></div><p>

4856

5312

Controls whether or not Mutt recalls postponed messages

4857

when composing a new message. Also see ``<a href="#postponed" title="3.218. postponed">$postponed</a>''.

5313

when composing a new message. Also see ``<a href="#postponed" title="3.224. postponed">$postponed</a>''.

4858

5314

</p><p>

4859

5315

Setting this variable to ``yes'' is not generally useful, and thus not

4860

5316

recommended.

4861

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="record"></a>3.232. record</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5317

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="record"></a>3.239. record</h3></div></div></div><div class="literallayout"><p>Type: path<br />

4862

5318

Default: "˜/sent"</p></div><p>

4863

5319

This specifies the file into which your outgoing messages should be

4864

5320

appended. (This is meant as the primary method for saving a copy of

4865

your messages, but another way to do this is using the ``<a href="#my-hdr" title="13. User defined headers">my_hdr</a>''

5321

your messages, but another way to do this is using the ``<a href="#my-hdr" title="14. User defined headers">my_hdr</a>''

4866

5322

command to create a <span class="emphasis"><em>Bcc:</em></span> field with your email address in it.)

4867

5323

</p><p>

4868

The value of <span class="emphasis"><em><a href="#record" title="3.232. record">$record</a></em></span> is overridden by the ``<a href="#force-name" title="3.57. force_name">$force_name</a>'' and

4869

``<a href="#save-name" title="3.243. save_name">$save_name</a>'' variables, and the ``<a href="#fcc-hook" title="16. Specify default Fcc: mailbox when composing">fcc-hook</a>'' command.

4870

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reply-regexp"></a>3.233. reply_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

5324

The value of <span class="emphasis"><em><a href="#record" title="3.239. record">$record</a></em></span> is overridden by the ``<a href="#force-name" title="3.61. force_name">$force_name</a>'' and

5325

``<a href="#save-name" title="3.251. save_name">$save_name</a>'' variables, and the ``<a href="#fcc-hook" title="17. Specify default Fcc: mailbox when composing">fcc-hook</a>'' command.

5326

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reply-regexp"></a>3.240. reply_regexp</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

4871

5327

Default: "^(re([\[0-9\]+])*|aw):[ \t]*"</p></div><p>

4872

5328

A regular expression used to recognize reply messages when threading

4873

5329

and replying. The default value corresponds to the English "Re:" and

4874

5330

the German "Aw:".

4875

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reply-self"></a>3.234. reply_self</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5331

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reply-self"></a>3.241. reply_self</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4876

5332

Default: no</p></div><p>

4877

5333

If unset and you are replying to a message sent by you, Mutt will

4878

5334

assume that you want to reply to the recipients of that message rather

4879

5335

than to yourself.

4880

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reply-to"></a>3.235. reply_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

5336

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reply-to"></a>3.242. reply_to</h3></div></div></div><div class="literallayout"><p>Type: quadoption<br />

4881

5337

Default: ask-yes</p></div><p>

4882

5338

If set, when replying to a message, Mutt will use the address listed

4883

5339

in the Reply-to: header as the recipient of the reply. If unset,

4885

5341

option is useful for reading a mailing list that sets the Reply-To:

4886

5342

header field to the list address and you want to send a private

4887

5343

message to the author of a message.

4888

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="resolve"></a>3.236. resolve</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5344

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="resolve"></a>3.243. resolve</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4889

5345

Default: yes</p></div><p>

4890

5346

When set, the cursor will be automatically advanced to the next

4891

5347

(possibly undeleted) message whenever a command that modifies the

4892

5348

current message is executed.

4893

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-alias"></a>3.237. reverse_alias</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5349

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-alias"></a>3.244. reverse_alias</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4894

5350

Default: no</p></div><p>

4895

5351

This variable controls whether or not Mutt will display the "personal"

4896

5352

name from your aliases in the index menu if it finds an alias that

4912

5368

It would be displayed in the index menu as ``Joe User'' instead of

4913

5369

``abd30425@somewhere.net.'' This is useful when the person's e-mail

4914

5370

address is not human friendly (like CompuServe addresses).

4915

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-name"></a>3.238. reverse_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5371

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-name"></a>3.245. reverse_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4916

5372

Default: no</p></div><p>

4917

5373

It may sometimes arrive that you receive mail to a certain machine,

4918

5374

move the messages to another machine, and reply to some the messages

4922

5378

alternates. If the variable is unset, or the address that would be

4923

5379

used doesn't match your alternates, the <span class="emphasis"><em>From:</em></span> line will use

4924

5380

your address on the current machine.

4925

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-realname"></a>3.239. reverse_realname</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5381

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="reverse-realname"></a>3.246. reverse_realname</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4926

5382

Default: yes</p></div><p>

4927

This variable fine-tunes the behaviour of the <a href="#reverse-name" title="3.238. reverse_name">reverse_name</a> feature.

5383

This variable fine-tunes the behaviour of the <a href="#reverse-name" title="3.245. reverse_name">reverse_name</a> feature.

4928

5384

When it is set, mutt will use the address from incoming messages as-is,

4929

5385

possibly including eventual real names. When it is unset, mutt will

4930

override any such real names with the setting of the <a href="#realname" title="3.230. realname">realname</a> variable.

4931

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="rfc2047-parameters"></a>3.240. rfc2047_parameters</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5386

override any such real names with the setting of the <a href="#realname" title="3.237. realname">realname</a> variable.

5387

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="rfc2047-parameters"></a>3.247. rfc2047_parameters</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4932

5388

Default: no</p></div><p>

4933

5389

When this variable is set, Mutt will decode RFC-2047-encoded MIME

4934

5390

parameters. You want to set this variable when mutt suggests you

4944

5400

Also note that setting this parameter will <span class="emphasis"><em>not</em></span> have the effect

4945

5401

that mutt <span class="emphasis"><em>generates</em></span> this kind of encoding. Instead, mutt will

4946

5402

unconditionally use the encoding specified in RFC 2231.

4947

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.241. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5403

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-address"></a>3.248. save_address</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4948

5404

Default: no</p></div><p>

4949

5405

If set, mutt will take the sender's full address when choosing a

4950

default folder for saving a mail. If ``<a href="#save-name" title="3.243. save_name">$save_name</a>'' or ``<a href="#force-name" title="3.57. force_name">$force_name</a>''

5406

default folder for saving a mail. If ``<a href="#save-name" title="3.251. save_name">$save_name</a>'' or ``<a href="#force-name" title="3.61. force_name">$force_name</a>''

4951

5407

is set too, the selection of the fcc folder will be changed as well.

4952

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.242. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5408

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-empty"></a>3.249. save_empty</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4953

5409

Default: yes</p></div><p>

4954

5410

When unset, mailboxes which contain no saved messages will be removed

4955

when closed (the exception is ``<a href="#spoolfile" title="3.265. spoolfile">$spoolfile</a>'' which is never removed).

5411

when closed (the exception is ``<a href="#spoolfile" title="3.276. spoolfile">$spoolfile</a>'' which is never removed).

4956

5412

If set, mailboxes are never removed.

4957

5413

</p><p>

4958

5414

<span class="bold"><strong>Note:</strong></span> This only applies to mbox and MMDF folders, Mutt does not

4959

5415

delete MH and Maildir directories.

4960

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.243. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5416

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-history"></a>3.250. save_history</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5417

Default: 0</p></div><p>

5418

This variable controls the size of the history saved in the

5419

``<a href="#history-file" title="3.78. history_file">$history_file</a>'' file.

5420

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="save-name"></a>3.251. save_name</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4961

5421

Default: no</p></div><p>

4962

5422

This variable controls how copies of outgoing messages are saved.

4963

5423

When set, a check is made to see if a mailbox specified by the

4964

5424

recipient address exists (this is done by searching for a mailbox in

4965

the ``<a href="#folder" title="3.54. folder">$folder</a>'' directory with the <span class="emphasis"><em>username</em></span> part of the

5425

the ``<a href="#folder" title="3.58. folder">$folder</a>'' directory with the <span class="emphasis"><em>username</em></span> part of the

4966

5426

recipient address). If the mailbox exists, the outgoing message will

4967

5427

be saved to that mailbox, otherwise the message is saved to the

4968

``<a href="#record" title="3.232. record">$record</a>'' mailbox.

5428

``<a href="#record" title="3.239. record">$record</a>'' mailbox.

4969

5429

</p><p>

4970

Also see the ``<a href="#force-name" title="3.57. force_name">$force_name</a>'' variable.

4971

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.244. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5430

Also see the ``<a href="#force-name" title="3.61. force_name">$force_name</a>'' variable.

5431

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score"></a>3.252. score</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

4972

5432

Default: yes</p></div><p>

4973

5433

When this variable is <span class="emphasis"><em>unset</em></span>, scoring is turned off. This can

4974

5434

be useful to selectively disable scoring for certain folders when the

4975

``<a href="#score-threshold-delete" title="3.245. score_threshold_delete">$score_threshold_delete</a>'' variable and friends are used.

4976

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.245. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5435

``<a href="#score-threshold-delete" title="3.253. score_threshold_delete">$score_threshold_delete</a>'' variable and friends are used.

5436

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-delete"></a>3.253. score_threshold_delete</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4977

5437

Default: -1</p></div><p>

4978

5438

Messages which have been assigned a score equal to or lower than the value

4979

5439

of this variable are automatically marked for deletion by mutt. Since

4980

5440

mutt scores are always greater than or equal to zero, the default setting

4981

5441

of this variable will never mark a message for deletion.

4982

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.246. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5442

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-flag"></a>3.254. score_threshold_flag</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4983

5443

Default: 9999</p></div><p>

4984

5444

Messages which have been assigned a score greater than or equal to this

4985

5445

variable's value are automatically marked "flagged".

4986

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.247. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5446

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="score-threshold-read"></a>3.255. score_threshold_read</h3></div></div></div><div class="literallayout"><p>Type: number<br />

4987

5447

Default: -1</p></div><p>

4988

5448

Messages which have been assigned a score equal to or lower than the value

4989

5449

of this variable are automatically marked as read by mutt. Since

4990

5450

mutt scores are always greater than or equal to zero, the default setting

4991

5451

of this variable will never mark a message read.

4992

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.248. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5452

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="send-charset"></a>3.256. send_charset</h3></div></div></div><div class="literallayout"><p>Type: string<br />

4993

5453

Default: "us-ascii:iso-8859-1:utf-8"</p></div><p>

4994

A list of character sets for outgoing messages. Mutt will use the

5454

A colon-delimited list of character sets for outgoing messages. Mutt will use the

4995

5455

first character set into which the text can be converted exactly.

4996

If your ``<a href="#charset" title="3.22. charset">$charset</a>'' is not iso-8859-1 and recipients may not

5456

If your ``<a href="#charset" title="3.25. charset">$charset</a>'' is not iso-8859-1 and recipients may not

4997

5457

understand UTF-8, it is advisable to include in the list an

4998

5458

appropriate widely used standard character set (such as

4999

5459

iso-8859-2, koi8-r or iso-2022-jp) either instead of or after

5000

5460

"iso-8859-1".

5001

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail"></a>3.249. sendmail</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5461

</p><p>

5462

In case the text cannot be converted into one of these exactly,

5463

mutt uses ``<a href="#charset" title="3.25. charset">$charset</a>'' as a fallback.

5464

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail"></a>3.257. sendmail</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5002

5465

Default: "/usr/sbin/sendmail -oem -oi"</p></div><p>

5003

5466

Specifies the program and arguments used to deliver mail sent by Mutt.

5004

5467

Mutt expects that the specified program interprets additional

5005

5468

arguments as recipient addresses.

5006

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail-wait"></a>3.250. sendmail_wait</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5469

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sendmail-wait"></a>3.258. sendmail_wait</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5007

5470

Default: 0</p></div><p>

5008

Specifies the number of seconds to wait for the ``<a href="#sendmail" title="3.249. sendmail">$sendmail</a>'' process

5471

Specifies the number of seconds to wait for the ``<a href="#sendmail" title="3.257. sendmail">$sendmail</a>'' process

5009

5472

to finish before giving up and putting delivery in the background.

5010

5473

</p><p>

5011

5474

Mutt interprets the value of this variable as follows:

5019

5482

Note that if you specify a value other than 0, the output of the child

5020

5483

process will be put in a temporary file. If there is some error, you

5021

5484

will be informed as to where to find the output.

5022

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="shell"></a>3.251. shell</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5485

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="shell"></a>3.259. shell</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5023

5486

Default: ""</p></div><p>

5024

5487

Command to use when spawning a subshell. By default, the user's login

5025

5488

shell from /etc/passwd is used.

5026

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sig-dashes"></a>3.252. sig_dashes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5489

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sig-dashes"></a>3.260. sig_dashes</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5027

5490

Default: yes</p></div><p>

5028

5491

If set, a line containing ``-- '' will be inserted before your

5029

``<a href="#signature" title="3.254. signature">$signature</a>''. It is <span class="bold"><strong>strongly</strong></span> recommended that you not unset

5492

``<a href="#signature" title="3.262. signature">$signature</a>''. It is <span class="bold"><strong>strongly</strong></span> recommended that you not unset

5030

5493

this variable unless your ``signature'' contains just your name. The

5031

5494

reason for this is because many software packages use ``-- \n'' to

5032

5495

detect your signature. For example, Mutt has the ability to highlight

5033

5496

the signature in a different color in the builtin pager.

5034

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sig-on-top"></a>3.253. sig_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5497

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sig-on-top"></a>3.261. sig_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5035

5498

Default: no</p></div><p>

5036

5499

If set, the signature will be included before any quoted or forwarded

5037

5500

text. It is <span class="bold"><strong>strongly</strong></span> recommended that you do not set this variable

5038

5501

unless you really know what you are doing, and are prepared to take

5039

5502

some heat from netiquette guardians.

5040

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="signature"></a>3.254. signature</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5503

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="signature"></a>3.262. signature</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5041

5504

Default: "˜/.signature"</p></div><p>

5042

5505

Specifies the filename of your signature, which is appended to all

5043

5506

outgoing messages. If the filename ends with a pipe (``|''), it is

5044

5507

assumed that filename is a shell command and input should be read from

5045

5508

its stdout.

5046

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="simple-search"></a>3.255. simple_search</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5509

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="simple-search"></a>3.263. simple_search</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5047

5510

Default: "˜f %s | ˜s %s"</p></div><p>

5048

5511

Specifies how Mutt should expand a simple search into a real search

5049

5512

pattern. A simple search is one that does not contain any of the ˜

5050

operators. See ``<a href="#patterns" title="2. Patterns">patterns</a>'' for more information on search patterns.

5513

operators. See ``<a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a>'' for more information on search patterns.

5051

5514

</p><p>

5052

5515

For example, if you simply type joe at a search or limit prompt, Mutt

5053

5516

will automatically expand it to the value specified by this variable.

5054

5517

For the default value it would be:

5055

5518

</p><p>

5056

5519

˜f joe | ˜s joe

5057

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.256. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5520

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smart-wrap"></a>3.264. smart_wrap</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5058

5521

Default: yes</p></div><p>

5059

5522

Controls the display of lines longer than the screen width in the

5060

5523

internal pager. If set, long lines are wrapped at a word boundary. If

5061

5524

unset, lines are simply wrapped at the screen edge. Also see the

5062

``<a href="#markers" title="3.108. markers">$markers</a>'' variable.

5063

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.257. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

5525

``<a href="#markers" title="3.113. markers">$markers</a>'' variable.

5526

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smileys"></a>3.265. smileys</h3></div></div></div><div class="literallayout"><p>Type: regular expression<br />

5064

5527

Default: "(>From )|(:[-^]?[][)(><}{|/DP])"</p></div><p>

5065

5528

The <span class="emphasis"><em>pager</em></span> uses this variable to catch some common false

5066

positives of ``<a href="#quote-regexp" title="3.227. quote_regexp">$quote_regexp</a>'', most notably smileys in the beginning

5529

positives of ``<a href="#quote-regexp" title="3.234. quote_regexp">$quote_regexp</a>'', most notably smileys in the beginning

5067

5530

of a line

5068

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.258. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5531

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sleep-time"></a>3.266. sleep_time</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5069

5532

Default: 1</p></div><p>

5070

5533

Specifies time, in seconds, to pause while displaying certain informational

5071

5534

messages, while moving from folder to folder and after expunging

5072

5535

messages from the current folder. The default is to pause one second, so

5073

5536

a value of zero for this option suppresses the pause.

5074

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort"></a>3.259. sort</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5537

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-authenticators"></a>3.267. smtp_authenticators</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5538

Default: ""</p></div><p>

5539

This is a colon-delimited list of authentication methods mutt may

5540

attempt to use to log in to an SMTP server, in the order mutt should

5541

try them. Authentication methods are any SASL mechanism, eg

5542

``digest-md5'', ``gssapi'' or ``cram-md5''.

5543

This parameter is case-insensitive. If this parameter is unset

5544

(the default) mutt will try all available methods, in order from

5545

most-secure to least-secure.

5546

</p><p>

5547

Example: set smtp_authenticators="digest-md5:cram-md5"

5548

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-pass"></a>3.268. smtp_pass</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5549

Default: ""</p></div><p>

5550

Specifies the password for your SMTP account. If <span class="emphasis"><em>unset</em></span>, Mutt will

5551

prompt you for your password when you first send mail via SMTP.

5552

See ``<a href="#smtp-url" title="3.269. smtp_url">smtp_url</a>'' to configure mutt to send mail via SMTP.

5553

<span class="bold"><strong>Warning</strong></span>: you should only use this option when you are on a

5554

fairly secure machine, because the superuser can read your muttrc even

5555

if you are the only one who can read the file.

5556

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smtp-url"></a>3.269. smtp_url</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5557

Default: ""</p></div><p>

5558

Defines the SMTP ``smart'' host where sent messages should relayed for

5559

delivery. This should take the form of an SMTP URL, eg:

5560

</p><p>

5561

smtp[s]://[user[:pass]@]host[:port]/

5562

</p><p>

5563

Setting this variable overrides the value of the ``<a href="#sendmail" title="3.257. sendmail">$sendmail</a>''

5564

variable.

5565

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort"></a>3.270. sort</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5075

5566

Default: date</p></div><p>

5076

5567

Specifies how to sort messages in the <span class="emphasis"><em>index</em></span> menu. Valid values

5077

5568

are:

5092

5583

</pre><p>

5093

5584

You may optionally use the reverse- prefix to specify reverse sorting

5094

5585

order (example: set sort=reverse-date-sent).

5095

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-alias"></a>3.260. sort_alias</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5586

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-alias"></a>3.271. sort_alias</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5096

5587

Default: alias</p></div><p>

5097

5588

Specifies how the entries in the `alias' menu are sorted. The

5098

5589

following are legal values:

5103

5594

alias (sort alphabetically by alias name)

5104

5595

unsorted (leave in order specified in .muttrc)

5105

5596

5106

</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-aux"></a>3.261. sort_aux</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5597

</pre></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-aux"></a>3.272. sort_aux</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5107

5598

Default: date</p></div><p>

5108

5599

When sorting by threads, this variable controls how threads are sorted

5109

5600

in relation to other threads, and how the branches of the thread trees

5110

are sorted. This can be set to any value that ``<a href="#sort" title="3.259. sort">$sort</a>'' can, except

5601

are sorted. This can be set to any value that ``<a href="#sort" title="3.270. sort">$sort</a>'' can, except

5111

5602

threads (in that case, mutt will just use date-sent). You can also

5112

5603

specify the last- prefix in addition to the reverse- prefix, but last-

5113

5604

must come after reverse-. The last- prefix causes messages to be

5115

5606

the rest of sort_aux as an ordering. For instance, set sort_aux=last-

5116

5607

date-received would mean that if a new message is received in a

5117

5608

thread, that thread becomes the last one displayed (or the first, if

5118

you have set sort=reverse-threads.) Note: For reversed ``<a href="#sort" title="3.259. sort">$sort</a>''

5119

order <a href="#sort-aux" title="3.261. sort_aux">$sort_aux</a> is reversed again (which is not the right thing to do,

5609

you have set sort=reverse-threads.) Note: For reversed ``<a href="#sort" title="3.270. sort">$sort</a>''

5610

order <a href="#sort-aux" title="3.272. sort_aux">$sort_aux</a> is reversed again (which is not the right thing to do,

5120

5611

but kept to not break any existing configuration setting).

5121

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-browser"></a>3.262. sort_browser</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5612

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-browser"></a>3.273. sort_browser</h3></div></div></div><div class="literallayout"><p>Type: sort order<br />

5122

5613

Default: alpha</p></div><p>

5123

5614

Specifies how to sort entries in the file browser. By default, the

5124

5615

entries are sorted alphabetically. Valid values:

5133

5624

</pre><p>

5134

5625

You may optionally use the reverse- prefix to specify reverse sorting

5135

5626

order (example: set sort_browser=reverse-date).

5136

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.263. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5627

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="sort-re"></a>3.274. sort_re</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5137

5628

Default: yes</p></div><p>

5138

5629

This variable is only useful when sorting by threads with

5139

``<a href="#strict-threads" title="3.269. strict_threads">$strict_threads</a>'' unset. In that case, it changes the heuristic

5630

``<a href="#strict-threads" title="3.280. strict_threads">$strict_threads</a>'' unset. In that case, it changes the heuristic

5140

5631

mutt uses to thread messages by subject. With sort_re set, mutt will

5141

5632

only attach a message as the child of another message by subject if

5142

5633

the subject of the child message starts with a substring matching the

5143

setting of ``<a href="#reply-regexp" title="3.233. reply_regexp">$reply_regexp</a>''. With sort_re unset, mutt will attach

5634

setting of ``<a href="#reply-regexp" title="3.240. reply_regexp">$reply_regexp</a>''. With sort_re unset, mutt will attach

5144

5635

the message whether or not this is the case, as long as the

5145

non-``<a href="#reply-regexp" title="3.233. reply_regexp">$reply_regexp</a>'' parts of both messages are identical.

5146

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.264. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5636

non-``<a href="#reply-regexp" title="3.240. reply_regexp">$reply_regexp</a>'' parts of both messages are identical.

5637

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spam-separator"></a>3.275. spam_separator</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5147

5638

Default: ","</p></div><p>

5148

``<a href="#spam-separator" title="3.264. spam_separator">spam_separator</a>'' controls what happens when multiple spam headers

5639

``<a href="#spam-separator" title="3.275. spam_separator">spam_separator</a>'' controls what happens when multiple spam headers

5149

5640

are matched: if unset, each successive header will overwrite any

5150

5641

previous matches value for the spam label. If set, each successive

5151

match will append to the previous, using ``<a href="#spam-separator" title="3.264. spam_separator">spam_separator</a>'' as a

5642

match will append to the previous, using ``<a href="#spam-separator" title="3.275. spam_separator">spam_separator</a>'' as a

5152

5643

separator.

5153

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.265. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5644

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="spoolfile"></a>3.276. spoolfile</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5154

5645

Default: ""</p></div><p>

5155

5646

If your spool mailbox is in a non-default place where Mutt cannot find

5156

5647

it, you can specify its location with this variable. Mutt will

5157

5648

automatically set this variable to the value of the environment

5158

5649

variable $MAIL if it is not set.

5159

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.266. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5650

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-chars"></a>3.277. status_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5160

5651

Default: "-*%A"</p></div><p>

5161

5652

Controls the characters used by the "%r" indicator in

5162

``<a href="#status-format" title="3.267. status_format">$status_format</a>''. The first character is used when the mailbox is

5653

``<a href="#status-format" title="3.278. status_format">$status_format</a>''. The first character is used when the mailbox is

5163

5654

unchanged. The second is used when the mailbox has been changed, and

5164

5655

it needs to be resynchronized. The third is used if the mailbox is in

5165

5656

read-only mode, or if the mailbox will not be written when exiting

5168

5659

is used to indicate that the current folder has been opened in attach-

5169

5660

message mode (Certain operations like composing a new mail, replying,

5170

5661

forwarding, etc. are not permitted in this mode).

5171

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-format"></a>3.267. status_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5662

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-format"></a>3.278. status_format</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5172

5663

Default: "-%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)---"</p></div><p>

5173

5664

Controls the format of the status line displayed in the <span class="emphasis"><em>index</em></span>

5174

menu. This string is similar to ``<a href="#index-format" title="3.95. index_format">$index_format</a>'', but has its own

5665

menu. This string is similar to ``<a href="#index-format" title="3.100. index_format">$index_format</a>'', but has its own

5175

5666

set of printf()-like sequences:

5176

5667

</p><p>

5177

5668

5190

5681

</p></dd><dt><span class="term">%p </span></dt><dd><p>number of postponed messages *

5191

5682

</p></dd><dt><span class="term">%P </span></dt><dd><p>percentage of the way through the index

5192

5683

</p></dd><dt><span class="term">%r </span></dt><dd><p>modified/read-only/won't-write/attach-message indicator,

5193

according to <a href="#status-chars" title="3.266. status_chars">$status_chars</a>

5194

</p></dd><dt><span class="term">%s </span></dt><dd><p>current sorting mode (<a href="#sort" title="3.259. sort">$sort</a>)

5195

</p></dd><dt><span class="term">%S </span></dt><dd><p>current aux sorting method (<a href="#sort-aux" title="3.261. sort_aux">$sort_aux</a>)

5684

according to <a href="#status-chars" title="3.277. status_chars">$status_chars</a>

5685

</p></dd><dt><span class="term">%s </span></dt><dd><p>current sorting mode (<a href="#sort" title="3.270. sort">$sort</a>)

5686

</p></dd><dt><span class="term">%S </span></dt><dd><p>current aux sorting method (<a href="#sort-aux" title="3.272. sort_aux">$sort_aux</a>)

5196

5687

</p></dd><dt><span class="term">%t </span></dt><dd><p>number of tagged messages *

5197

5688

</p></dd><dt><span class="term">%u </span></dt><dd><p>number of unread messages *

5198

5689

</p></dd><dt><span class="term">%v </span></dt><dd><p>Mutt version string

5199

5690

</p></dd><dt><span class="term">%V </span></dt><dd><p>currently active limit pattern, if any *

5200

5691

</p></dd><dt><span class="term">%>X </span></dt><dd><p>right justify the rest of the string and pad with "X"

5201

5692

</p></dd><dt><span class="term">%|X </span></dt><dd><p>pad to the end of the line with "X"

5693

</p></dd><dt><span class="term">%*X </span></dt><dd><p>soft-fill with character "X" as pad

5202

5694

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

5203

5695

5204

5696

</p><p>

5697

For an explanation of `soft-fill', see the ``<a href="#index-format" title="3.100. index_format">$index_format</a>'' documentation.

5698

</p><p>

5205

5699

* = can be optionally printed if nonzero

5206

5700

</p><p>

5207

5701

Some of the above sequences can be used to optionally print a string

5208

5702

if their value is nonzero. For example, you may only want to see the

5209

5703

number of flagged messages if such messages exist, since zero is not

5210

5704

particularly meaningful. To optionally print a string based upon one

5211

of the above sequences, the following construct is used

5705

of the above sequences, the following construct is used:

5212

5706

</p><p>

5213

5707

%?<sequence_char>?<optional_string>?

5214

5708

</p><p>

5222

5716

new messages in a mailbox:

5223

5717

%?n?%n new messages.?

5224

5718

</p><p>

5225

Additionally you can switch between two strings, the first one, if a

5226

value is zero, the second one, if the value is nonzero, by using the

5227

following construct:

5719

You can also switch between two strings using the following construct:

5720

</p><p>

5228

5721

%?<sequence_char>?<if_string>&<else_string>?

5229

5722

</p><p>

5230

You can additionally force the result of any printf-like sequence to

5231

be lowercase by prefixing the sequence character with an underscore

5232

(_) sign. For example, if you want to display the local hostname in

5233

lowercase, you would use:

5723

If the value of <span class="emphasis"><em>sequence_char</em></span> is non-zero, <span class="emphasis"><em>if_string</em></span> will

5724

be expanded, otherwise <span class="emphasis"><em>else_string</em></span> will be expanded.

5725

</p><p>

5726

You can force the result of any printf-like sequence to be lowercase

5727

by prefixing the sequence character with an underscore (_) sign.

5728

For example, if you want to display the local hostname in lowercase,

5729

you would use:

5234

5730

%_h

5235

5731

</p><p>

5236

5732

If you prefix the sequence character with a colon (:) character, mutt

5237

5733

will replace any dots in the expansion by underscores. This might be helpful

5238

5734

with IMAP folders that don't like dots in folder names.

5239

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-on-top"></a>3.268. status_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5735

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="status-on-top"></a>3.279. status_on_top</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5240

5736

Default: no</p></div><p>

5241

5737

Setting this variable causes the ``status bar'' to be displayed on

5242

5738

the first line of the screen rather than near the bottom.

5243

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="strict-threads"></a>3.269. strict_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5739

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="strict-threads"></a>3.280. strict_threads</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5244

5740

Default: no</p></div><p>

5245

5741

If set, threading will only make use of the ``In-Reply-To'' and

5246

``References'' fields when you ``<a href="#sort" title="3.259. sort">$sort</a>'' by message threads. By

5742

``References'' fields when you ``<a href="#sort" title="3.270. sort">$sort</a>'' by message threads. By

5247

5743

default, messages with the same subject are grouped together in

5248

5744

``pseudo threads.''. This may not always be desirable, such as in a

5249

5745

personal mailbox where you might have several unrelated messages with

5250

5746

the subject ``hi'' which will get grouped together. See also

5251

``<a href="#sort-re" title="3.263. sort_re">$sort_re</a>'' for a less drastic way of controlling this

5747

``<a href="#sort-re" title="3.274. sort_re">$sort_re</a>'' for a less drastic way of controlling this

5252

5748

behaviour.

5253

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="suspend"></a>3.270. suspend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5749

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="suspend"></a>3.281. suspend</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5254

5750

Default: yes</p></div><p>

5255

5751

When <span class="emphasis"><em>unset</em></span>, mutt won't stop when the user presses the terminal's

5256

5752

<span class="emphasis"><em>susp</em></span> key, usually ``control-Z''. This is useful if you run mutt

5257

5753

inside an xterm using a command like xterm -e mutt.

5258

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="text-flowed"></a>3.271. text_flowed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5754

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="text-flowed"></a>3.282. text_flowed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5259

5755

Default: no</p></div><p>

5260

5756

When set, mutt will generate text/plain; format=flowed attachments.

5261

5757

This format is easier to handle for some mailing software, and generally

5262

5758

just looks like ordinary text. To actually make use of this format's

5263

5759

features, you'll need support in your editor.

5264

5760

</p><p>

5265

Note that <a href="#indent-string" title="3.94. indent_string">$indent_string</a> is ignored when this option is set.

5266

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="thread-received"></a>3.272. thread_received</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5761

Note that <a href="#indent-string" title="3.99. indent_string">$indent_string</a> is ignored when this option is set.

5762

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="thread-received"></a>3.283. thread_received</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5267

5763

Default: no</p></div><p>

5268

5764

When set, mutt uses the date received rather than the date sent

5269

5765

to thread messages by subject.

5270

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="thorough-search"></a>3.273. thorough_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5766

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="thorough-search"></a>3.284. thorough_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5271

5767

Default: no</p></div><p>

5272

5768

Affects the <span class="emphasis"><em>˜b</em></span> and <span class="emphasis"><em>˜h</em></span> search operations described in

5273

section ``<a href="#patterns" title="2. Patterns">patterns</a>'' above. If set, the headers and attachments of

5769

section ``<a href="#patterns" title="2. Patterns: Searching, Limiting and Tagging">patterns</a>'' above. If set, the headers and attachments of

5274

5770

messages to be searched are decoded before searching. If unset,

5275

5771

messages are searched as they appear in the folder.

5276

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="tilde"></a>3.274. tilde</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5772

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="tilde"></a>3.285. tilde</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5277

5773

Default: no</p></div><p>

5278

5774

When set, the internal-pager will pad blank lines to the bottom of the

5279

5775

screen with a tilde (˜).

5280

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="timeout"></a>3.275. timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5776

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="time-inc"></a>3.286. time_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5777

Default: 0</p></div><p>

5778

Along with ``<a href="#read-inc" title="3.235. read_inc">read_inc</a>'', ``<a href="#write-inc" title="3.304. write_inc">write_inc</a>'', and ``<a href="#net-inc" title="3.136. net_inc">net_inc</a>'', this

5779

variable controls the frequency with which progress updates are

5780

displayed. It suppresses updates less than ``<a href="#time-inc" title="3.286. time_inc">time_inc</a>'' milliseconds

5781

apart. This can improve throughput on systems with slow terminals,

5782

or when running mutt on a remote system.

5783

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="timeout"></a>3.287. timeout</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5281

5784

Default: 600</p></div><p>

5282

This variable controls the <span class="emphasis"><em>number of seconds</em></span> Mutt will wait

5283

for a key to be pressed in the main menu before timing out and

5284

checking for new mail. A value of zero or less will cause Mutt

5285

to never time out.

5286

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="tmpdir"></a>3.276. tmpdir</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5785

When Mutt is waiting for user input either idleing in menus or

5786

in an interactive prompt, Mutt would block until input is

5787

present. Depending on the context, this would prevent certain

5788

operations from working, like checking for new mail or keeping

5789

an IMAP connection alive.

5790

</p><p>

5791

This variable controls how many seconds Mutt will at most wait

5792

until it aborts waiting for input, performs these operations and

5793

continues to wait for input.

5794

</p><p>

5795

A value of zero or less will cause Mutt to never time out.

5796

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="tmpdir"></a>3.288. tmpdir</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5287

5797

Default: ""</p></div><p>

5288

5798

This variable allows you to specify where Mutt will place its

5289

5799

temporary files needed for displaying and composing messages. If

5290

5800

this variable is not set, the environment variable TMPDIR is

5291

5801

used. If TMPDIR is not set then "/tmp" is used.

5292

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="to-chars"></a>3.277. to_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5802

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="to-chars"></a>3.289. to_chars</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5293

5803

Default: " +TCFL"</p></div><p>

5294

5804

Controls the character used to indicate mail addressed to you. The

5295

5805

first character is the one used when the mail is NOT addressed to your

5301

5811

recipient. The fifth character is used to indicate mail that was sent

5302

5812

by <span class="emphasis"><em>you</em></span>. The sixth character is used to indicate when a mail

5303

5813

was sent to a mailing-list you subscribe to (default: L).

5304

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="tunnel"></a>3.278. tunnel</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5814

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="tunnel"></a>3.290. tunnel</h3></div></div></div><div class="literallayout"><p>Type: string<br />

5305

5815

Default: ""</p></div><p>

5306

5816

Setting this variable will cause mutt to open a pipe to a command

5307

5817

instead of a raw socket. You may be able to use this to set up

5311

5821

</p><p>

5312

5822

NOTE: For this example to work you must be able to log in to the remote

5313

5823

machine without having to enter a password.

5314

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.279. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5824

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-8bitmime"></a>3.291. use_8bitmime</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5315

5825

Default: no</p></div><p>

5316

5826

<span class="bold"><strong>Warning:</strong></span> do not set this variable unless you are using a version

5317

5827

of sendmail which supports the -B8BITMIME flag (such as sendmail

5318

5828

8.8.x) or you may not be able to send mail.

5319

5829

</p><p>

5320

When <span class="emphasis"><em>set</em></span>, Mutt will invoke ``<a href="#sendmail" title="3.249. sendmail">$sendmail</a>'' with the -B8BITMIME

5830

When <span class="emphasis"><em>set</em></span>, Mutt will invoke ``<a href="#sendmail" title="3.257. sendmail">$sendmail</a>'' with the -B8BITMIME

5321

5831

flag when sending 8-bit messages to enable ESMTP negotiation.

5322

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.280. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5832

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-domain"></a>3.292. use_domain</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5323

5833

Default: yes</p></div><p>

5324

5834

When set, Mutt will qualify all local addresses (ones without the

5325

@host portion) with the value of ``<a href="#hostname" title="3.75. hostname">$hostname</a>''. If <span class="emphasis"><em>unset</em></span>, no

5835

@host portion) with the value of ``<a href="#hostname" title="3.80. hostname">$hostname</a>''. If <span class="emphasis"><em>unset</em></span>, no

5326

5836

addresses will be qualified.

5327

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.281. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5837

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-envelope-from"></a>3.293. use_envelope_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5328

5838

Default: no</p></div><p>

5329

When <span class="emphasis"><em>set</em></span>, mutt will use ``<a href="#envelope-from-address" title="3.49. envelope_from_address">$envelope_from_address</a>'' as the

5330

<span class="emphasis"><em>envelope</em></span> sender if that is set, otherwise it will attempt to

5331

derive it from the "From:" header. Note that this information is passed

5332

to sendmail command using the "-f" command line switch, so don't set this

5333

option if you are using that switch in <a href="#sendmail" title="3.249. sendmail">$sendmail</a> yourself,

5334

or if the sendmail on your machine doesn't support that command

5335

line switch.

5336

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.282. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5839

When <span class="emphasis"><em>set</em></span>, mutt will set the <span class="emphasis"><em>envelope</em></span> sender of the message.

5840

If ``<a href="#envelope-from-address" title="3.53. envelope_from_address">$envelope_from_address</a>'' is set, it will be used as the sender

5841

address. If not, mutt will attempt to derive the sender from the

5842

"From:" header.

5843

</p><p>

5844

Note that this information is passed to sendmail command using the

5845

"-f" command line switch. Therefore setting this option is not useful

5846

if the ``<a href="#sendmail" title="3.257. sendmail">$sendmail</a>'' variable already contains "-f" or if the

5847

executable pointed to by <a href="#sendmail" title="3.257. sendmail">$sendmail</a> doesn't support the "-f" switch.

5848

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-from"></a>3.294. use_from</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5337

5849

Default: yes</p></div><p>

5338

5850

When <span class="emphasis"><em>set</em></span>, Mutt will generate the `From:' header field when

5339

5851

sending messages. If <span class="emphasis"><em>unset</em></span>, no `From:' header field will be

5340

generated unless the user explicitly sets one using the ``<a href="#my-hdr" title="13. User defined headers">my_hdr</a>''

5852

generated unless the user explicitly sets one using the ``<a href="#my-hdr" title="14. User defined headers">my_hdr</a>''

5341

5853

command.

5342

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.283. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5854

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-idn"></a>3.295. use_idn</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5343

5855

Default: yes</p></div><p>

5344

5856

When <span class="emphasis"><em>set</em></span>, Mutt will show you international domain names decoded.

5345

5857

Note: You can use IDNs for addresses even if this is <span class="emphasis"><em>unset</em></span>.

5346

5858

This variable only affects decoding.

5347

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.284. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5859

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="use-ipv6"></a>3.296. use_ipv6</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5348

5860

Default: yes</p></div><p>

5349

5861

When <span class="emphasis"><em>set</em></span>, Mutt will look for IPv6 addresses of hosts it tries to

5350

5862

contact. If this option is unset, Mutt will restrict itself to IPv4 addresses.

5351

5863

Normally, the default should work.

5352

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.285. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5864

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="user-agent"></a>3.297. user_agent</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5353

5865

Default: yes</p></div><p>

5354

5866

When <span class="emphasis"><em>set</em></span>, mutt will add a "User-Agent" header to outgoing

5355

5867

messages, indicating which version of mutt was used for composing

5356

5868

them.

5357

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.286. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5869

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="visual"></a>3.298. visual</h3></div></div></div><div class="literallayout"><p>Type: path<br />

5358

5870

Default: ""</p></div><p>

5359

5871

Specifies the visual editor to invoke when the <span class="emphasis"><em>˜v</em></span> command is

5360

5872

given in the builtin editor.

5361

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.287. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5873

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wait-key"></a>3.299. wait_key</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5362

5874

Default: yes</p></div><p>

5363

5875

Controls whether Mutt will ask you to press a key after <span class="emphasis"><em>shell-

5364

5876

escape</em></span>, <span class="emphasis"><em>pipe-message</em></span>, <span class="emphasis"><em>pipe-entry</em></span>, <span class="emphasis"><em>print-message</em></span>,

5370

5882

</p><p>

5371

5883

When set, Mutt will always ask for a key. When unset, Mutt will wait

5372

5884

for a key only if the external command returned a non-zero status.

5373

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="weed"></a>3.288. weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5885

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="weed"></a>3.300. weed</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5374

5886

Default: yes</p></div><p>

5375

5887

When set, mutt will weed headers when displaying, forwarding,

5376

5888

printing, or replying to messages.

5377

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-search"></a>3.289. wrap_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5889

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap"></a>3.301. wrap</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5890

Default: 0</p></div><p>

5891

When set to a positive value, mutt will wrap text at <a href="#wrap" title="3.301. wrap">$wrap</a> characters.

5892

When set to a negative value, mutt will wrap text so that there are <a href="#wrap" title="3.301. wrap">$wrap</a>

5893

characters of empty space on the right side of the terminal.

5894

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrap-search"></a>3.302. wrap_search</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5378

5895

Default: yes</p></div><p>

5379

5896

Controls whether searches wrap around the end of the mailbox.

5380

5897

</p><p>

5381

5898

When set, searches will wrap around the first (or last) message. When

5382

5899

unset, searches will not wrap.

5383

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrapmargin"></a>3.290. wrapmargin</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5900

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="wrapmargin"></a>3.303. wrapmargin</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5384

5901

Default: 0</p></div><p>

5385

Controls the size of the margin remaining at the right side of

5386

the terminal when mutt's pager does smart wrapping.

5387

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-inc"></a>3.291. write_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5902

(DEPRECATED) Equivalent to setting <a href="#wrap" title="3.301. wrap">wrap</a> with a negative value.

5903

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-inc"></a>3.304. write_inc</h3></div></div></div><div class="literallayout"><p>Type: number<br />

5388

5904

Default: 10</p></div><p>

5389

5905

When writing a mailbox, a message will be printed every

5390

5906

<span class="emphasis"><em>write_inc</em></span> messages to indicate progress. If set to 0, only a

5391

5907

single message will be displayed before writing a mailbox.

5392

5908

</p><p>

5393

Also see the ``<a href="#read-inc" title="3.228. read_inc">$read_inc</a>'' variable.

5394

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-bcc"></a>3.292. write_bcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5909

Also see the ``<a href="#read-inc" title="3.235. read_inc">$read_inc</a>'' variable.

5910

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="write-bcc"></a>3.305. write_bcc</h3></div></div></div><div class="literallayout"><p>Type: boolean<br />

5395

5911

Default: yes</p></div><p>

5396

5912

Controls whether mutt writes out the Bcc header when preparing

5397

messages to be sent. Exim users may wish to unset this.

5913

messages to be sent. Exim users may wish to unset this. If mutt

5914

is set to deliver directly via SMTP (see ``<a href="#smtp-url" title="3.269. smtp_url">$smtp_url</a>''), this

5915

option does nothing: mutt will never write out the BCC header

5916

in this case.

5398

5917

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

5399

5918

The following is the list of available functions listed by the mapping

5400

5919

in which they are available. The default key setting is given, and an

5401

5920

explanation of what the function does. The key bindings of these

5402

functions can be changed with the <a href="#bind" title="3. Changing the default key bindings">bind</a>

5921

functions can be changed with the <a href="#bind" title="4. Changing the default key bindings">bind</a>

5403

5922

command.

5404

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2900751"></a>4.1. generic</h3></div></div></div><p>

5923

</p><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="generic_map"></a>4.1. generic</h3></div></div></div><p>

5405

5924

The <span class="emphasis"><em>generic</em></span> menu is not a real menu, but specifies common functions

5406

5925

(such as movement) available in all menus except for <span class="emphasis"><em>pager</em></span> and

5407

5926

<span class="emphasis"><em>editor</em></span>. Changing settings for this menu will affect the default

5408

5927

bindings for all menus (except as noted).

5409

5928

</p><p>

5410

5929

5411

</p><div class="table"><a id="id2900777"></a><p class="title"><b>Table 6.2. Default generic function bindings</b></p><table summary="Default generic function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>bottom-page</td><td>L</td><td>move to the bottom of the page</td></tr><tr><td>current-bottom</td><td>not bound</td><td>move current entry to bottom of page</td></tr><tr><td>current-middle</td><td>not bound</td><td>move current entry to middle of page</td></tr><tr><td>current-top</td><td>not bound</td><td>move current entry to top of page</td></tr><tr><td>enter-command</td><td>:</td><td>enter a muttrc command</td></tr><tr><td>exit</td><td>q</td><td>exit this menu</td></tr><tr><td>first-entry</td><td>=</td><td>move to the first entry</td></tr><tr><td>half-down</td><td>]</td><td>scroll down 1/2 page</td></tr><tr><td>half-up</td><td>[</td><td>scroll up 1/2 page</td></tr><tr><td>help</td><td>?</td><td>this screen</td></tr><tr><td>jump</td><td>number</td><td>jump to an index number</td></tr><tr><td>last-entry</td><td>*</td><td>move to the last entry</td></tr><tr><td>middle-page</td><td>M</td><td>move to the middle of the page</td></tr><tr><td>next-entry</td><td>j</td><td>move to the next entry</td></tr><tr><td>next-line</td><td>></td><td>scroll down one line</td></tr><tr><td>next-page</td><td>z</td><td>move to the next page</td></tr><tr><td>previous-entry</td><td>k</td><td>move to the previous entry</td></tr><tr><td>previous-line</td><td><</td><td>scroll up one line</td></tr><tr><td>previous-page</td><td>Z</td><td>move to the previous page</td></tr><tr><td>refresh</td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>search-opposite</td><td>not bound</td><td>search for next match in opposite direction</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr><tr><td>select-entry</td><td>RET</td><td>select the current entry</td></tr><tr><td>shell-escape</td><td>!</td><td>run a program in a subshell</td></tr><tr><td>tag-entry</td><td>t</td><td>toggle the tag on the current entry</td></tr><tr><td>tag-prefix</td><td>;</td><td>apply next command to tagged entries</td></tr><tr><td>tag-prefix-cond</td><td>not bound</td><td>apply next function ONLY to tagged messages</td></tr><tr><td>top-page</td><td>H</td><td>move to the top of the page</td></tr><tr><td>what-key</td><td>not bound</td><td>display the keycode for a key press</td></tr></tbody></table></div><p>

5412

5413

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2901104"></a>4.2. index</h3></div></div></div><p>

5414

5415

</p><div class="table"><a id="id2901112"></a><p class="title"><b>Table 6.3. Default index menu function bindings</b></p><table summary="Default index menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>bounce-message</td><td>b</td><td>remail a message to another user</td></tr><tr><td>change-folder</td><td>c</td><td>open a different folder</td></tr><tr><td>change-folder-readonly</td><td>ESC c</td><td>open a different folder in read only mode</td></tr><tr><td>check-traditional-pgp</td><td>ESC P</td><td>check for classic pgp</td></tr><tr><td>clear-flag</td><td>W</td><td>clear a status flag from a message</td></tr><tr><td>copy-message</td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td>create-alias</td><td>a</td><td>create an alias from a message sender</td></tr><tr><td>decode-copy</td><td>ESC C</td><td>decode a message and copy it to a file/mailbox</td></tr><tr><td>decode-save</td><td>ESC s</td><td>decode a message and save it to a file/mailbox</td></tr><tr><td>delete-message</td><td>d</td><td>delete the current entry</td></tr><tr><td>delete-pattern</td><td>D</td><td>delete messages matching a pattern</td></tr><tr><td>delete-subthread</td><td>ESC d</td><td>delete all messages in subthread</td></tr><tr><td>delete-thread</td><td>^D</td><td>delete all messages in thread</td></tr><tr><td>display-address</td><td>@</td><td>display full address of sender</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>display-message</td><td>RET</td><td>display a message</td></tr><tr><td>edit</td><td>e</td><td>edit the current message</td></tr><tr><td>edit-type</td><td>^E</td><td>edit the current message's Content-Type</td></tr><tr><td>exit</td><td>x</td><td>exit without saving changes</td></tr><tr><td>extract-keys</td><td>^K</td><td>extract PGP public keys</td></tr><tr><td>fetch-mail</td><td>G</td><td>retrieve mail from POP server</td></tr><tr><td>flag-message</td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe PGP passphrase from memory</td></tr><tr><td>forward-message</td><td>f</td><td>forward a message with comments</td></tr><tr><td>group-reply</td><td>g</td><td>reply to all recipients</td></tr><tr><td>limit</td><td>l</td><td>show only messages matching a pattern</td></tr><tr><td>list-reply</td><td>L</td><td>reply to specified mailing list</td></tr><tr><td>mail</td><td>m</td><td>compose a new mail message</td></tr><tr><td>mail-key</td><td>ESC k</td><td>mail a PGP public key</td></tr><tr><td>next-new</td><td>not bound</td><td>jump to the next new message</td></tr><tr><td>next-new-then-unread</td><td>TAB</td><td>jump to the next new or unread message</td></tr><tr><td>next-subthread</td><td>ESC n</td><td>jump to the next subthread</td></tr><tr><td>next-thread</td><td>^N</td><td>jump to the next thread</td></tr><tr><td>next-undeleted</td><td>j</td><td>move to the next undeleted message</td></tr><tr><td>next-unread</td><td>not bound</td><td>jump to the next unread message</td></tr><tr><td>parent-message</td><td>P</td><td>jump to parent message in thread</td></tr><tr><td>pipe-message</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>previous-new</td><td>not bound</td><td>jump to the previous new message</td></tr><tr><td>previous-new-then-unread</td><td>ESC TAB</td><td>jump to the previous new or unread message</td></tr><tr><td>previous-page</td><td>Z</td><td>move to the previous page</td></tr><tr><td>previous-subthread</td><td>ESC p</td><td>jump to previous subthread</td></tr><tr><td>previous-thread</td><td>^P</td><td>jump to previous thread</td></tr><tr><td>previous-undeleted</td><td>k</td><td>move to the last undelete message</td></tr><tr><td>previous-unread</td><td>not bound</td><td>jump to the previous unread message</td></tr><tr><td>print-message</td><td>p</td><td>print the current entry</td></tr><tr><td>query</td><td>Q</td><td>query external program for addresses</td></tr><tr><td>quit</td><td>q</td><td>save changes to mailbox and quit</td></tr><tr><td>read-subthread</td><td>ESC r</td><td>mark the current subthread as read</td></tr><tr><td>read-thread</td><td>^R</td><td>mark the current thread as read</td></tr><tr><td>recall-message</td><td>R</td><td>recall a postponed message</td></tr><tr><td>reply</td><td>r</td><td>reply to a message</td></tr><tr><td>resend-message</td><td>ESC e</td><td>resend message and preserve MIME structure</td></tr><tr><td>save-message</td><td>s</td><td>save message/attachment to a file</td></tr><tr><td>set-flag</td><td>w</td><td>set a status flag on a message</td></tr><tr><td>show-version</td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td>show-limit</td><td>ESC l</td><td>show currently active limit pattern, if any</td></tr><tr><td>sort-mailbox</td><td>o</td><td>sort messages</td></tr><tr><td>sort-reverse</td><td>O</td><td>sort messages in reverse order</td></tr><tr><td>sync-mailbox</td><td>$</td><td>save changes to mailbox</td></tr><tr><td>tag-pattern</td><td>T</td><td>tag messages matching a pattern</td></tr><tr><td>tag-thread</td><td>ESC t</td><td>tag/untag all messages in the current thread</td></tr><tr><td>toggle-new</td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td>toggle-write</td><td>%</td><td>toggle whether the mailbox will be rewritten</td></tr><tr><td>undelete-message</td><td>u</td><td>undelete the current entry</td></tr><tr><td>undelete-pattern</td><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td>undelete-subthread</td><td>ESC u</td><td>undelete all messages in subthread</td></tr><tr><td>undelete-thread</td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td>untag-pattern</td><td>^T</td><td>untag messages matching a pattern</td></tr><tr><td>view-attachments</td><td>v</td><td>show MIME attachments</td></tr></tbody></table></div><p>

5416

5417

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

5418

5419

</p><div class="table"><a id="id2901817"></a><p class="title"><b>Table 6.4. Default pager menu function bindings</b></p><table summary="Default pager menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>bottom</td><td>not bound</td><td>jump to the bottom of the message</td></tr><tr><td>bounce-message</td><td>b</td><td>remail a message to another user</td></tr><tr><td>change-folder</td><td>c</td><td>open a different folder</td></tr><tr><td>change-folder-readonly</td><td>ESC c</td><td>open a different folder in read only mode</td></tr><tr><td>check-traditional-pgp</td><td>ESC P</td><td>check for classic pgp</td></tr><tr><td>copy-message</td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td>create-alias</td><td>a</td><td>create an alias from a message sender</td></tr><tr><td>decode-copy</td><td>ESC C</td><td>decode a message and copy it to a file/mailbox</td></tr><tr><td>decode-save</td><td>ESC s</td><td>decode a message and save it to a file/mailbox</td></tr><tr><td>delete-message</td><td>d</td><td>delete the current entry</td></tr><tr><td>delete-subthread</td><td>ESC d</td><td>delete all messages in subthread</td></tr><tr><td>delete-thread</td><td>^D</td><td>delete all messages in thread</td></tr><tr><td>display-address</td><td>@</td><td>display full address of sender</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>edit</td><td>e</td><td>edit the current message</td></tr><tr><td>edit-type</td><td>^E</td><td>edit the current message's Content-Type</td></tr><tr><td>enter-command</td><td>:</td><td>enter a muttrc command</td></tr><tr><td>exit</td><td>i</td><td>return to the main-menu</td></tr><tr><td>extract-keys</td><td>^K</td><td>extract PGP public keys</td></tr><tr><td>flag-message</td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe PGP passphrase from memory</td></tr><tr><td>forward-message</td><td>f</td><td>forward a message with comments</td></tr><tr><td>group-reply</td><td>g</td><td>reply to all recipients</td></tr><tr><td>half-up</td><td>not bound</td><td>move up one-half page</td></tr><tr><td>half-down</td><td>not bound</td><td>move down one-half page</td></tr><tr><td>help</td><td>?</td><td>this screen</td></tr><tr><td>list-reply</td><td>L</td><td>reply to specified mailing list</td></tr><tr><td>mail</td><td>m</td><td>compose a new mail message</td></tr><tr><td>mail-key</td><td>ESC k</td><td>mail a PGP public key</td></tr><tr><td>mark-as-new</td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td>next-line</td><td>RET</td><td>scroll down one line</td></tr><tr><td>next-entry</td><td>J</td><td>move to the next entry</td></tr><tr><td>next-new</td><td>not bound</td><td>jump to the next new message</td></tr><tr><td>next-new-then-unread</td><td>TAB</td><td>jump to the next new or unread message</td></tr><tr><td>next-page</td><td>not bound</td><td>move to the next page</td></tr><tr><td>next-subthread</td><td>ESC n</td><td>jump to the next subthread</td></tr><tr><td>next-thread</td><td>^N</td><td>jump to the next thread</td></tr><tr><td>next-undeleted</td><td>j</td><td>move to the next undeleted message</td></tr><tr><td>next-unread</td><td>not bound</td><td>jump to the next unread message</td></tr><tr><td>parent-message</td><td>P</td><td>jump to parent message in thread</td></tr><tr><td>pipe-message</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>previous-line</td><td>BackSpace</td><td>scroll up one line</td></tr><tr><td>previous-entry</td><td>K</td><td>move to the previous entry</td></tr><tr><td>previous-new</td><td>not bound</td><td>jump to the previous new message</td></tr><tr><td>previous-new-then-unread</td><td>not bound</td><td>jump to the previous new message</td></tr><tr><td>previous-page</td><td>-</td><td>move to the previous page</td></tr><tr><td>previous-subthread</td><td>ESC p</td><td>jump to previous subthread</td></tr><tr><td>previous-thread</td><td>^P</td><td>jump to previous thread</td></tr><tr><td>previous-undeleted</td><td>k</td><td>move to the last undelete message</td></tr><tr><td>previous-unread</td><td>not bound</td><td>jump to the previous unread message</td></tr><tr><td>print-message</td><td>p</td><td>print the current entry</td></tr><tr><td>quit</td><td>Q</td><td>save changes to mailbox and quit</td></tr><tr><td>read-subthread</td><td>ESC r</td><td>mark the current subthread as read</td></tr><tr><td>read-thread</td><td>^R</td><td>mark the current thread as read</td></tr><tr><td>recall-message</td><td>R</td><td>recall a postponed message</td></tr><tr><td>redraw-screen</td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td>reply</td><td>r</td><td>reply to a message</td></tr><tr><td>save-message</td><td>s</td><td>save message/attachment to a file</td></tr><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>search-opposite</td><td>not bound</td><td>search for next match in opposite direction</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr><tr><td>search-toggle</td><td>\</td><td>toggle search pattern coloring</td></tr><tr><td>shell-escape</td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td>show-version</td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td>skip-quoted</td><td>S</td><td>skip beyond quoted text</td></tr><tr><td>sync-mailbox</td><td>$</td><td>save changes to mailbox</td></tr><tr><td>tag-message</td><td>t</td><td>tag a message</td></tr><tr><td>toggle-quoted</td><td>T</td><td>toggle display of quoted text</td></tr><tr><td>top</td><td>^</td><td>jump to the top of the message</td></tr><tr><td>undelete-message</td><td>u</td><td>undelete the current entry</td></tr><tr><td>undelete-subthread</td><td>ESC u</td><td>undelete all messages in subthread</td></tr><tr><td>undelete-thread</td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td>view-attachments</td><td>v</td><td>show MIME attachments</td></tr></tbody></table></div><p>

5420

5421

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2902560"></a>4.4. alias</h3></div></div></div><p>

5422

5423

</p><div class="table"><a id="id2902568"></a><p class="title"><b>Table 6.5. Default alias menu function bindings</b></p><table summary="Default alias menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr></tbody></table></div><p>

5424

5425

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2902627"></a>4.5. query</h3></div></div></div><p>

5426

5427

</p><div class="table"><a id="id2902634"></a><p class="title"><b>Table 6.6. Default query menu function bindings</b></p><table summary="Default query menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>create-alias</td><td>a</td><td>create an alias from a message sender</td></tr><tr><td>mail</td><td>m</td><td>compose a new mail message</td></tr><tr><td>query</td><td>Q</td><td>query external program for addresses</td></tr><tr><td>query-append</td><td>A</td><td>append new query results to current results</td></tr><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>search-opposite</td><td>not bound</td><td>search for next match in opposite direction</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr></tbody></table></div><p>

5428

5429

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2902742"></a>4.6. attach</h3></div></div></div><p>

5430

5431

</p><div class="table"><a id="id2902750"></a><p class="title"><b>Table 6.7. Default attach menu function bindings</b></p><table summary="Default attach menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>bounce-message</td><td>b</td><td>remail a message to another user</td></tr><tr><td>collapse-parts</td><td>v</td><td>toggle display of subparts</td></tr><tr><td>delete-entry</td><td>d</td><td>delete the current entry</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>edit-type</td><td>^E</td><td>edit the current entry's Content-Type</td></tr><tr><td>extract-keys</td><td>^K</td><td>extract PGP public keys</td></tr><tr><td>forward-message</td><td>f</td><td>forward a message with comments</td></tr><tr><td>group-reply</td><td>g</td><td>reply to all recipients</td></tr><tr><td>list-reply</td><td>L</td><td>reply to specified mailing list</td></tr><tr><td>pipe-entry</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>print-entry</td><td>p</td><td>print the current entry</td></tr><tr><td>reply</td><td>r</td><td>reply to a message</td></tr><tr><td>resend-message</td><td>ESC e</td><td>resend message and preserve MIME structure</td></tr><tr><td>save-entry</td><td>s</td><td>save message/attachment to a file</td></tr><tr><td>undelete-entry</td><td>u</td><td>undelete the current entry</td></tr><tr><td>view-attach</td><td>RET</td><td>view attachment using mailcap entry if necessary</td></tr><tr><td>view-mailcap</td><td>m</td><td>force viewing of attachment using mailcap</td></tr><tr><td>view-text</td><td>T</td><td>view attachment as text</td></tr></tbody></table></div><p>

5432

5433

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2902952"></a>4.7. compose</h3></div></div></div><p>

5434

5435

</p><div class="table"><a id="id2902960"></a><p class="title"><b>Table 6.8. Default compose menu function bindings</b></p><table summary="Default compose menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>attach-file</td><td>a</td><td>attach a file(s) to this message</td></tr><tr><td>attach-message</td><td>A</td><td>attach message(s) to this message</td></tr><tr><td>attach-key</td><td>ESC k</td><td>attach a PGP public key</td></tr><tr><td>copy-file</td><td>C</td><td>save message/attachment to a file</td></tr><tr><td>detach-file</td><td>D</td><td>delete the current entry</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>edit-bcc</td><td>b</td><td>edit the BCC list</td></tr><tr><td>edit-cc</td><td>c</td><td>edit the CC list</td></tr><tr><td>edit-description</td><td>d</td><td>edit attachment description</td></tr><tr><td>edit-encoding</td><td>^E</td><td>edit attachment transfer-encoding</td></tr><tr><td>edit-fcc</td><td>f</td><td>enter a file to save a copy of this message in</td></tr><tr><td>edit-from</td><td>ESC f</td><td>edit the from: field</td></tr><tr><td>edit-file</td><td>^X e</td><td>edit the file to be attached</td></tr><tr><td>edit-headers</td><td>E</td><td>edit the message with headers</td></tr><tr><td>edit</td><td>e</td><td>edit the message</td></tr><tr><td>edit-mime</td><td>m</td><td>edit attachment using mailcap entry</td></tr><tr><td>edit-reply-to</td><td>r</td><td>edit the Reply-To field</td></tr><tr><td>edit-subject</td><td>s</td><td>edit the subject of this message</td></tr><tr><td>edit-to</td><td>t</td><td>edit the TO list</td></tr><tr><td>edit-type</td><td>^T</td><td>edit attachment type</td></tr><tr><td>filter-entry</td><td>F</td><td>filter attachment through a shell command</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe PGP passphrase from memory</td></tr><tr><td>ispell</td><td>i</td><td>run ispell on the message</td></tr><tr><td>new-mime</td><td>n</td><td>compose new attachment using mailcap entry</td></tr><tr><td>pgp-menu</td><td>p</td><td>show PGP options</td></tr><tr><td>pipe-entry</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>postpone-message</td><td>P</td><td>save this message to send later</td></tr><tr><td>print-entry</td><td>l</td><td>print the current entry</td></tr><tr><td>rename-file</td><td>R</td><td>rename/move an attached file</td></tr><tr><td>send-message</td><td>y</td><td>send the message</td></tr><tr><td>toggle-unlink</td><td>u</td><td>toggle whether to delete file after sending it</td></tr><tr><td>view-attach</td><td>RET</td><td>view attachment using mailcap entry if necessary</td></tr><tr><td>write-fcc</td><td>w</td><td>write the message to a folder</td></tr></tbody></table></div><p>

5436

5437

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2903305"></a>4.8. postpone</h3></div></div></div><p>

5438

5439

</p><div class="table"><a id="id2903313"></a><p class="title"><b>Table 6.9. Default postpone menu function bindings</b></p><table summary="Default postpone menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>delete-entry</td><td>d</td><td>delete the current entry</td></tr><tr><td>undelete-entry</td><td>u</td><td>undelete the current entry</td></tr></tbody></table></div><p>

5440

5441

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2903362"></a>4.9. browser</h3></div></div></div><p>

5442

5443

</p><div class="table"><a id="id2903370"></a><p class="title"><b>Table 6.10. Default browser menu function bindings</b></p><table summary="Default browser menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>change-dir</td><td>c</td><td>change directories</td></tr><tr><td>check-new</td><td>TAB</td><td>check mailboxes for new mail</td></tr><tr><td>enter-mask</td><td>m</td><td>enter a file mask</td></tr><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr><tr><td>select-new</td><td>N</td><td>select a new file in this directory</td></tr><tr><td>sort</td><td>o</td><td>sort messages</td></tr><tr><td>sort-reverse</td><td>O</td><td>sort messages in reverse order</td></tr><tr><td>toggle-mailboxes</td><td>TAB</td><td>toggle whether to browse mailboxes or all files</td></tr><tr><td>view-file</td><td>SPACE</td><td>view file</td></tr><tr><td>subscribe</td><td>s</td><td>subscribe to current mailbox (IMAP Only)</td></tr><tr><td>unsubscribe</td><td>u</td><td>unsubscribe to current mailbox (IMAP Only)</td></tr><tr><td>toggle-subscribed</td><td>T</td><td>toggle view all/subscribed mailboxes (IMAP Only)</td></tr></tbody></table></div><p>

5444

5445

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2903533"></a>4.10. pgp</h3></div></div></div><p>

5446

5447

</p><div class="table"><a id="id2903540"></a><p class="title"><b>Table 6.11. Default pgp menu function bindings</b></p><table summary="Default pgp menu function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>view-name</td><td>%</td><td>view the key's user id</td></tr><tr><td>verify-key</td><td>c</td><td>verify a PGP public key</td></tr></tbody></table></div><p>

5448

5449

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2903590"></a>4.11. editor</h3></div></div></div><p>

5450

5451

</p><div class="table"><a id="id2903597"></a><p class="title"><b>Table 6.12. Default editor function bindings</b></p><table summary="Default editor function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>backspace</td><td>BackSpace</td><td>delete the char in front of the cursor</td></tr><tr><td>backward-char</td><td>^B</td><td>move the cursor one character to the left</td></tr><tr><td>backward-word</td><td>ESC b</td><td>move the cursor to the previous word</td></tr><tr><td>bol</td><td>^A</td><td>jump to the beginning of the line</td></tr><tr><td>buffy-cycle</td><td>Space</td><td>cycle among incoming mailboxes</td></tr><tr><td>capitalize-word</td><td>ESC c</td><td>uppercase the first character in the word</td></tr><tr><td>complete</td><td>TAB</td><td>complete filename or alias</td></tr><tr><td>complete-query</td><td>^T</td><td>complete address with query</td></tr><tr><td>delete-char</td><td>^D</td><td>delete the char under the cursor</td></tr><tr><td>downcase-word</td><td>ESC l</td><td>lowercase all characters in current word</td></tr><tr><td>eol</td><td>^E</td><td>jump to the end of the line</td></tr><tr><td>forward-char</td><td>^F</td><td>move the cursor one character to the right</td></tr><tr><td>forward-word</td><td>ESC f</td><td>move the cursor to the next word</td></tr><tr><td>history-down</td><td>not bound</td><td>scroll down through the history list</td></tr><tr><td>history-up</td><td>not bound</td><td>scroll up through the history list</td></tr><tr><td>kill-eol</td><td>^K</td><td>delete chars from cursor to end of line</td></tr><tr><td>kill-eow</td><td>ESC d</td><td>delete chars from cursor to end of word</td></tr><tr><td>kill-line</td><td>^U</td><td>delete all chars on the line</td></tr><tr><td>kill-word</td><td>^W</td><td>delete the word in front of the cursor</td></tr><tr><td>quote-char</td><td>^V</td><td>quote the next typed key</td></tr><tr><td>transpose-chars</td><td>not bound</td><td>transpose character under cursor with previous</td></tr><tr><td>upcase-word</td><td>ESC u</td><td>uppercase all characters in current word</td></tr></tbody></table></div><p>

5452

5453

</p></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="miscellany"></a>Chapter 7. Miscellany</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#acknowledgements">1. Acknowledgements</a></span></dt><dt><span class="sect1"><a href="#about">2. About this document</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="acknowledgements"></a>1. Acknowledgements</h2></div></div></div><p>

5930

</p><div class="table"><a id="generic_table"></a><p class="title"><b>Table 8.2. Default generic function bindings</b></p><div class="table-contents"><table summary="Default generic function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>top-page</td><td>H</td><td>move to the top of the page</td></tr><tr><td>next-entry</td><td>j</td><td>move to the next entry</td></tr><tr><td>previous-entry</td><td>k</td><td>move to the previous entry</td></tr><tr><td>bottom-page</td><td>L</td><td>move to the bottom of the page</td></tr><tr><td>refresh</td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td>middle-page</td><td>M</td><td>move to the middle of the page</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>exit</td><td>q</td><td>exit this menu</td></tr><tr><td>tag-entry</td><td>t</td><td>tag the current entry</td></tr><tr><td>next-page</td><td>z</td><td>move to the next page</td></tr><tr><td>previous-page</td><td>Z</td><td>move to the previous page</td></tr><tr><td>last-entry</td><td>*</td><td>move to the last entry</td></tr><tr><td>first-entry</td><td>=</td><td>move to the first entry</td></tr><tr><td>enter-command</td><td>:</td><td>enter a muttrc command</td></tr><tr><td>next-line</td><td>></td><td>scroll down one line</td></tr><tr><td>previous-line</td><td><</td><td>scroll up one line</td></tr><tr><td>half-up</td><td>[</td><td>scroll up 1/2 page</td></tr><tr><td>half-down</td><td>]</td><td>scroll down 1/2 page</td></tr><tr><td>help</td><td>?</td><td>this screen</td></tr><tr><td>tag-prefix</td><td>;</td><td>apply next function to tagged messages</td></tr><tr><td>tag-prefix-cond</td><td>not bound</td><td>apply next function ONLY to tagged messages</td></tr><tr><td>end-cond</td><td>not bound</td><td>end of conditional execution (noop)</td></tr><tr><td>shell-escape</td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td>select-entry</td><td>RET</td><td>select the current entry</td></tr><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr><tr><td>search-opposite</td><td>not bound</td><td>search for next match in opposite direction</td></tr><tr><td>jump</td><td>not bound</td><td>jump to an index number</td></tr><tr><td>current-top</td><td>not bound</td><td>move entry to top of screen</td></tr><tr><td>current-middle</td><td>not bound</td><td>move entry to middle of screen</td></tr><tr><td>current-bottom</td><td>not bound</td><td>move entry to bottom of screen</td></tr><tr><td>what-key</td><td>not bound</td><td>display the keycode for a key press</td></tr></tbody></table></div></div><p><br class="table-break" />

5931

5932

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="index_map"></a>4.2. index</h3></div></div></div><p>

5933

5934

</p><div class="table"><a id="index_table"></a><p class="title"><b>Table 8.3. Default index function bindings</b></p><div class="table-contents"><table summary="Default index function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>create-alias</td><td>a</td><td>create an alias from a message sender</td></tr><tr><td>bounce-message</td><td>b</td><td>remail a message to another user</td></tr><tr><td>break-thread</td><td>#</td><td>break the thread in two</td></tr><tr><td>change-folder</td><td>c</td><td>open a different folder</td></tr><tr><td>change-folder-readonly</td><td>ESC c</td><td>open a different folder in read only mode</td></tr><tr><td>next-unread-mailbox</td><td>not bound</td><td>open next mailbox with new mail</td></tr><tr><td>collapse-thread</td><td>ESC v</td><td>collapse/uncollapse current thread</td></tr><tr><td>collapse-all</td><td>ESC V</td><td>collapse/uncollapse all threads</td></tr><tr><td>copy-message</td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td>decode-copy</td><td>ESC C</td><td>make decoded (text/plain) copy</td></tr><tr><td>decode-save</td><td>ESC s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td>delete-message</td><td>d</td><td>delete the current entry</td></tr><tr><td>delete-pattern</td><td>D</td><td>delete messages matching a pattern</td></tr><tr><td>delete-thread</td><td>^D</td><td>delete all messages in thread</td></tr><tr><td>delete-subthread</td><td>ESC d</td><td>delete all messages in subthread</td></tr><tr><td>edit</td><td>e</td><td>edit the raw message</td></tr><tr><td>edit-type</td><td>^E</td><td>edit attachment content type</td></tr><tr><td>forward-message</td><td>f</td><td>forward a message with comments</td></tr><tr><td>flag-message</td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td>group-reply</td><td>g</td><td>reply to all recipients</td></tr><tr><td>fetch-mail</td><td>G</td><td>retrieve mail from POP server</td></tr><tr><td>imap-fetch-mail</td><td>not bound</td><td>force retrieval of mail from IMAP server</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>next-undeleted</td><td>j</td><td>move to the next undeleted message</td></tr><tr><td>previous-undeleted</td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td>limit</td><td>l</td><td>show only messages matching a pattern</td></tr><tr><td>link-threads</td><td>&</td><td>link tagged message to the current one</td></tr><tr><td>list-reply</td><td>L</td><td>reply to specified mailing list</td></tr><tr><td>mail</td><td>m</td><td>compose a new mail message</td></tr><tr><td>toggle-new</td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td>toggle-write</td><td>%</td><td>toggle whether the mailbox will be rewritten</td></tr><tr><td>next-thread</td><td>^N</td><td>jump to the next thread</td></tr><tr><td>next-subthread</td><td>ESC n</td><td>jump to the next subthread</td></tr><tr><td>query</td><td>Q</td><td>query external program for addresses</td></tr><tr><td>quit</td><td>q</td><td>save changes to mailbox and quit</td></tr><tr><td>reply</td><td>r</td><td>reply to a message</td></tr><tr><td>show-limit</td><td>ESC l</td><td>show currently active limit pattern</td></tr><tr><td>sort-mailbox</td><td>o</td><td>sort messages</td></tr><tr><td>sort-reverse</td><td>O</td><td>sort messages in reverse order</td></tr><tr><td>print-message</td><td>p</td><td>print the current entry</td></tr><tr><td>previous-thread</td><td>^P</td><td>jump to previous thread</td></tr><tr><td>previous-subthread</td><td>ESC p</td><td>jump to previous subthread</td></tr><tr><td>recall-message</td><td>R</td><td>recall a postponed message</td></tr><tr><td>read-thread</td><td>^R</td><td>mark the current thread as read</td></tr><tr><td>read-subthread</td><td>ESC r</td><td>mark the current subthread as read</td></tr><tr><td>resend-message</td><td>ESC e</td><td>use the current message as a template for a new one</td></tr><tr><td>save-message</td><td>s</td><td>save message/attachment to a file</td></tr><tr><td>tag-pattern</td><td>T</td><td>tag messages matching a pattern</td></tr><tr><td>tag-subthread</td><td>not bound</td><td>tag the current subthread</td></tr><tr><td>tag-thread</td><td>ESC t</td><td>tag the current thread</td></tr><tr><td>untag-pattern</td><td>^T</td><td>untag messages matching a pattern</td></tr><tr><td>undelete-message</td><td>u</td><td>undelete the current entry</td></tr><tr><td>undelete-pattern</td><td>U</td><td>undelete messages matching a pattern</td></tr><tr><td>undelete-subthread</td><td>ESC u</td><td>undelete all messages in subthread</td></tr><tr><td>undelete-thread</td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td>view-attachments</td><td>v</td><td>show MIME attachments</td></tr><tr><td>show-version</td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td>set-flag</td><td>w</td><td>set a status flag on a message</td></tr><tr><td>clear-flag</td><td>W</td><td>clear a status flag from a message</td></tr><tr><td>display-message</td><td>RET</td><td>display a message</td></tr><tr><td>buffy-list</td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td>sync-mailbox</td><td>$</td><td>save changes to mailbox</td></tr><tr><td>display-address</td><td>@</td><td>display full address of sender</td></tr><tr><td>pipe-message</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>next-new</td><td>not bound</td><td>jump to the next new message</td></tr><tr><td>next-new-then-unread</td><td>TAB</td><td>jump to the next new or unread message</td></tr><tr><td>previous-new</td><td>not bound</td><td>jump to the previous new message</td></tr><tr><td>previous-new-then-unread</td><td>ESC TAB</td><td>jump to the previous new or unread message</td></tr><tr><td>next-unread</td><td>not bound</td><td>jump to the next unread message</td></tr><tr><td>previous-unread</td><td>not bound</td><td>jump to the previous unread message</td></tr><tr><td>parent-message</td><td>P</td><td>jump to parent message in thread</td></tr><tr><td>extract-keys</td><td>^K</td><td>extract supported public keys</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td>check-traditional-pgp</td><td>ESC P</td><td>check for classic PGP</td></tr><tr><td>mail-key</td><td>ESC k</td><td>mail a PGP public key</td></tr><tr><td>decrypt-copy</td><td>not bound</td><td>make decrypted copy</td></tr><tr><td>decrypt-save</td><td>not bound</td><td>make decrypted copy and delete</td></tr></tbody></table></div></div><p><br class="table-break" />

5935

5936

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

5937

5938

</p><div class="table"><a id="pager_table"></a><p class="title"><b>Table 8.4. Default pager function bindings</b></p><div class="table-contents"><table summary="Default pager function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>break-thread</td><td>#</td><td>break the thread in two</td></tr><tr><td>create-alias</td><td>a</td><td>create an alias from a message sender</td></tr><tr><td>bounce-message</td><td>b</td><td>remail a message to another user</td></tr><tr><td>change-folder</td><td>c</td><td>open a different folder</td></tr><tr><td>change-folder-readonly</td><td>ESC c</td><td>open a different folder in read only mode</td></tr><tr><td>next-unread-mailbox</td><td>not bound</td><td>open next mailbox with new mail</td></tr><tr><td>copy-message</td><td>C</td><td>copy a message to a file/mailbox</td></tr><tr><td>decode-copy</td><td>ESC C</td><td>make decoded (text/plain) copy</td></tr><tr><td>delete-message</td><td>d</td><td>delete the current entry</td></tr><tr><td>delete-thread</td><td>^D</td><td>delete all messages in thread</td></tr><tr><td>delete-subthread</td><td>ESC d</td><td>delete all messages in subthread</td></tr><tr><td>edit</td><td>e</td><td>edit the raw message</td></tr><tr><td>edit-type</td><td>^E</td><td>edit attachment content type</td></tr><tr><td>forward-message</td><td>f</td><td>forward a message with comments</td></tr><tr><td>flag-message</td><td>F</td><td>toggle a message's 'important' flag</td></tr><tr><td>group-reply</td><td>g</td><td>reply to all recipients</td></tr><tr><td>imap-fetch-mail</td><td>not bound</td><td>force retrieval of mail from IMAP server</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>next-undeleted</td><td>j</td><td>move to the next undeleted message</td></tr><tr><td>next-entry</td><td>J</td><td>move to the next entry</td></tr><tr><td>previous-undeleted</td><td>k</td><td>move to the previous undeleted message</td></tr><tr><td>previous-entry</td><td>K</td><td>move to the previous entry</td></tr><tr><td>link-threads</td><td>&</td><td>link tagged message to the current one</td></tr><tr><td>list-reply</td><td>L</td><td>reply to specified mailing list</td></tr><tr><td>redraw-screen</td><td>^L</td><td>clear and redraw the screen</td></tr><tr><td>mail</td><td>m</td><td>compose a new mail message</td></tr><tr><td>mark-as-new</td><td>N</td><td>toggle a message's 'new' flag</td></tr><tr><td>search-next</td><td>n</td><td>search for next match</td></tr><tr><td>next-thread</td><td>^N</td><td>jump to the next thread</td></tr><tr><td>next-subthread</td><td>ESC n</td><td>jump to the next subthread</td></tr><tr><td>print-message</td><td>p</td><td>print the current entry</td></tr><tr><td>previous-thread</td><td>^P</td><td>jump to previous thread</td></tr><tr><td>previous-subthread</td><td>ESC p</td><td>jump to previous subthread</td></tr><tr><td>quit</td><td>Q</td><td>save changes to mailbox and quit</td></tr><tr><td>exit</td><td>q</td><td>exit this menu</td></tr><tr><td>reply</td><td>r</td><td>reply to a message</td></tr><tr><td>recall-message</td><td>R</td><td>recall a postponed message</td></tr><tr><td>read-thread</td><td>^R</td><td>mark the current thread as read</td></tr><tr><td>read-subthread</td><td>ESC r</td><td>mark the current subthread as read</td></tr><tr><td>resend-message</td><td>ESC e</td><td>use the current message as a template for a new one</td></tr><tr><td>save-message</td><td>s</td><td>save message/attachment to a file</td></tr><tr><td>skip-quoted</td><td>S</td><td>skip beyond quoted text</td></tr><tr><td>decode-save</td><td>ESC s</td><td>make decoded copy (text/plain) and delete</td></tr><tr><td>tag-message</td><td>t</td><td>tag the current entry</td></tr><tr><td>toggle-quoted</td><td>T</td><td>toggle display of quoted text</td></tr><tr><td>undelete-message</td><td>u</td><td>undelete the current entry</td></tr><tr><td>undelete-subthread</td><td>ESC u</td><td>undelete all messages in subthread</td></tr><tr><td>undelete-thread</td><td>^U</td><td>undelete all messages in thread</td></tr><tr><td>view-attachments</td><td>v</td><td>show MIME attachments</td></tr><tr><td>show-version</td><td>V</td><td>show the Mutt version number and date</td></tr><tr><td>search-toggle</td><td>\\</td><td>toggle search pattern coloring</td></tr><tr><td>display-address</td><td>@</td><td>display full address of sender</td></tr><tr><td>next-new</td><td>not bound</td><td>jump to the next new message</td></tr><tr><td>pipe-message</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>help</td><td>?</td><td>this screen</td></tr><tr><td>next-page</td><td>Space</td><td>move to the next page</td></tr><tr><td>previous-page</td><td>-</td><td>move to the previous page</td></tr><tr><td>top</td><td>^</td><td>jump to the top of the message</td></tr><tr><td>sync-mailbox</td><td>$</td><td>save changes to mailbox</td></tr><tr><td>shell-escape</td><td>!</td><td>invoke a command in a subshell</td></tr><tr><td>enter-command</td><td>:</td><td>enter a muttrc command</td></tr><tr><td>buffy-list</td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td>search</td><td>/</td><td>search for a regular expression</td></tr><tr><td>search-reverse</td><td>ESC /</td><td>search backwards for a regular expression</td></tr><tr><td>search-opposite</td><td>not bound</td><td>search for next match in opposite direction</td></tr><tr><td>next-line</td><td>RET</td><td>scroll down one line</td></tr><tr><td>jump</td><td>not bound</td><td>jump to an index number</td></tr><tr><td>next-unread</td><td>not bound</td><td>jump to the next unread message</td></tr><tr><td>previous-new</td><td>not bound</td><td>jump to the previous new message</td></tr><tr><td>previous-unread</td><td>not bound</td><td>jump to the previous unread message</td></tr><tr><td>half-up</td><td>not bound</td><td>scroll up 1/2 page</td></tr><tr><td>half-down</td><td>not bound</td><td>scroll down 1/2 page</td></tr><tr><td>previous-line</td><td>not bound</td><td>scroll up one line</td></tr><tr><td>bottom</td><td>not bound</td><td>jump to the bottom of the message</td></tr><tr><td>parent-message</td><td>P</td><td>jump to parent message in thread</td></tr><tr><td>check-traditional-pgp</td><td>ESC P</td><td>check for classic PGP</td></tr><tr><td>mail-key</td><td>ESC k</td><td>mail a PGP public key</td></tr><tr><td>extract-keys</td><td>^K</td><td>extract supported public keys</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td>decrypt-copy</td><td>not bound</td><td>make decrypted copy</td></tr><tr><td>decrypt-save</td><td>not bound</td><td>make decrypted copy and delete</td></tr></tbody></table></div></div><p><br class="table-break" />

5939

5940

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="alias_map"></a>4.4. alias</h3></div></div></div><p>

5941

5942

</p><div class="table"><a id="alias_table"></a><p class="title"><b>Table 8.5. Default alias function bindings</b></p><div class="table-contents"><table summary="Default alias function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>delete-entry</td><td>d</td><td>delete the current entry</td></tr><tr><td>undelete-entry</td><td>u</td><td>undelete the current entry</td></tr></tbody></table></div></div><p><br class="table-break" />

5943

5944

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="query_map"></a>4.5. query</h3></div></div></div><p>

5945

5946

</p><div class="table"><a id="query_table"></a><p class="title"><b>Table 8.6. Default query function bindings</b></p><div class="table-contents"><table summary="Default query function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>create-alias</td><td>a</td><td>create an alias from a message sender</td></tr><tr><td>mail</td><td>m</td><td>compose a new mail message</td></tr><tr><td>query</td><td>Q</td><td>query external program for addresses</td></tr><tr><td>query-append</td><td>A</td><td>append new query results to current results</td></tr></tbody></table></div></div><p><br class="table-break" />

5947

5948

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="attach_map"></a>4.6. attach</h3></div></div></div><p>

5949

5950

</p><div class="table"><a id="attach_table"></a><p class="title"><b>Table 8.7. Default attach function bindings</b></p><div class="table-contents"><table summary="Default attach function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>bounce-message</td><td>b</td><td>remail a message to another user</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>edit-type</td><td>^E</td><td>edit attachment content type</td></tr><tr><td>print-entry</td><td>p</td><td>print the current entry</td></tr><tr><td>save-entry</td><td>s</td><td>save message/attachment to a file</td></tr><tr><td>pipe-entry</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>view-mailcap</td><td>m</td><td>force viewing of attachment using mailcap</td></tr><tr><td>reply</td><td>r</td><td>reply to a message</td></tr><tr><td>resend-message</td><td>ESC e</td><td>use the current message as a template for a new one</td></tr><tr><td>group-reply</td><td>g</td><td>reply to all recipients</td></tr><tr><td>list-reply</td><td>L</td><td>reply to specified mailing list</td></tr><tr><td>forward-message</td><td>f</td><td>forward a message with comments</td></tr><tr><td>view-text</td><td>T</td><td>view attachment as text</td></tr><tr><td>view-attach</td><td>RET</td><td>view attachment using mailcap entry if necessary</td></tr><tr><td>delete-entry</td><td>d</td><td>delete the current entry</td></tr><tr><td>undelete-entry</td><td>u</td><td>undelete the current entry</td></tr><tr><td>collapse-parts</td><td>v</td><td>Toggle display of subparts</td></tr><tr><td>check-traditional-pgp</td><td>ESC P</td><td>check for classic PGP</td></tr><tr><td>extract-keys</td><td>^K</td><td>extract supported public keys</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe passphrase(s) from memory</td></tr></tbody></table></div></div><p><br class="table-break" />

5951

5952

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="compose_map"></a>4.7. compose</h3></div></div></div><p>

5953

5954

</p><div class="table"><a id="compose_table"></a><p class="title"><b>Table 8.8. Default compose function bindings</b></p><div class="table-contents"><table summary="Default compose function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>attach-file</td><td>a</td><td>attach file(s) to this message</td></tr><tr><td>attach-message</td><td>A</td><td>attach message(s) to this message</td></tr><tr><td>edit-bcc</td><td>b</td><td>edit the BCC list</td></tr><tr><td>edit-cc</td><td>c</td><td>edit the CC list</td></tr><tr><td>copy-file</td><td>C</td><td>save message/attachment to a file</td></tr><tr><td>detach-file</td><td>D</td><td>delete the current entry</td></tr><tr><td>toggle-disposition</td><td>^D</td><td>toggle disposition between inline/attachment</td></tr><tr><td>edit-description</td><td>d</td><td>edit attachment description</td></tr><tr><td>edit-message</td><td>e</td><td>edit the message</td></tr><tr><td>edit-headers</td><td>E</td><td>edit the message with headers</td></tr><tr><td>edit-file</td><td>^X e</td><td>edit the file to be attached</td></tr><tr><td>edit-encoding</td><td>^E</td><td>edit attachment transfer-encoding</td></tr><tr><td>edit-from</td><td>ESC f</td><td>edit the from field</td></tr><tr><td>edit-fcc</td><td>f</td><td>enter a file to save a copy of this message in</td></tr><tr><td>filter-entry</td><td>F</td><td>filter attachment through a shell command</td></tr><tr><td>get-attachment</td><td>G</td><td>get a temporary copy of an attachment</td></tr><tr><td>display-toggle-weed</td><td>h</td><td>display message and toggle header weeding</td></tr><tr><td>ispell</td><td>i</td><td>run ispell on the message</td></tr><tr><td>print-entry</td><td>l</td><td>print the current entry</td></tr><tr><td>edit-mime</td><td>m</td><td>edit attachment using mailcap entry</td></tr><tr><td>new-mime</td><td>n</td><td>compose new attachment using mailcap entry</td></tr><tr><td>postpone-message</td><td>P</td><td>save this message to send later</td></tr><tr><td>edit-reply-to</td><td>r</td><td>edit the Reply-To field</td></tr><tr><td>rename-file</td><td>R</td><td>rename/move an attached file</td></tr><tr><td>edit-subject</td><td>s</td><td>edit the subject of this message</td></tr><tr><td>edit-to</td><td>t</td><td>edit the TO list</td></tr><tr><td>edit-type</td><td>^T</td><td>edit attachment content type</td></tr><tr><td>write-fcc</td><td>w</td><td>write the message to a folder</td></tr><tr><td>toggle-unlink</td><td>u</td><td>toggle whether to delete file after sending it</td></tr><tr><td>toggle-recode</td><td>not bound</td><td>toggle recoding of this attachment</td></tr><tr><td>update-encoding</td><td>U</td><td>update an attachment's encoding info</td></tr><tr><td>view-attach</td><td>RET</td><td>view attachment using mailcap entry if necessary</td></tr><tr><td>send-message</td><td>y</td><td>send the message</td></tr><tr><td>pipe-entry</td><td>|</td><td>pipe message/attachment to a shell command</td></tr><tr><td>attach-key</td><td>ESC k</td><td>attach a PGP public key</td></tr><tr><td>pgp-menu</td><td>p</td><td>show PGP options</td></tr><tr><td>forget-passphrase</td><td>^F</td><td>wipe passphrase(s) from memory</td></tr><tr><td>smime-menu</td><td>S</td><td>show S/MIME options</td></tr><tr><td>mix</td><td>M</td><td>send the message through a mixmaster remailer chain</td></tr></tbody></table></div></div><p><br class="table-break" />

5955

5956

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="postpone_map"></a>4.8. postpone</h3></div></div></div><p>

5957

5958

</p><div class="table"><a id="postpone_table"></a><p class="title"><b>Table 8.9. Default postpone function bindings</b></p><div class="table-contents"><table summary="Default postpone function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>delete-entry</td><td>d</td><td>delete the current entry</td></tr><tr><td>undelete-entry</td><td>u</td><td>undelete the current entry</td></tr></tbody></table></div></div><p><br class="table-break" />

5959

5960

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="browser_map"></a>4.9. browser</h3></div></div></div><p>

5961

5962

</p><div class="table"><a id="browser_table"></a><p class="title"><b>Table 8.10. Default browser function bindings</b></p><div class="table-contents"><table summary="Default browser function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>change-dir</td><td>c</td><td>change directories</td></tr><tr><td>display-filename</td><td>@</td><td>display the currently selected file's name</td></tr><tr><td>enter-mask</td><td>m</td><td>enter a file mask</td></tr><tr><td>sort</td><td>o</td><td>sort messages</td></tr><tr><td>sort-reverse</td><td>O</td><td>sort messages in reverse order</td></tr><tr><td>select-new</td><td>N</td><td>select a new file in this directory</td></tr><tr><td>check-new</td><td>not bound</td><td>check mailboxes for new mail</td></tr><tr><td>toggle-mailboxes</td><td>TAB</td><td>toggle whether to browse mailboxes or all files</td></tr><tr><td>view-file</td><td>Space</td><td>view file</td></tr><tr><td>buffy-list</td><td>.</td><td>list mailboxes with new mail</td></tr><tr><td>create-mailbox</td><td>C</td><td>create a new mailbox (IMAP only)</td></tr><tr><td>delete-mailbox</td><td>d</td><td>delete the current mailbox (IMAP only)</td></tr><tr><td>rename-mailbox</td><td>r</td><td>rename the current mailbox (IMAP only)</td></tr><tr><td>subscribe</td><td>s</td><td>subscribe to current mailbox (IMAP only)</td></tr><tr><td>unsubscribe</td><td>u</td><td>unsubscribe from current mailbox (IMAP only)</td></tr><tr><td>toggle-subscribed</td><td>T</td><td>toggle view all/subscribed mailboxes (IMAP only)</td></tr></tbody></table></div></div><p><br class="table-break" />

5963

5964

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="pgp_map"></a>4.10. pgp</h3></div></div></div><p>

5965

5966

</p><div class="table"><a id="pgp_table"></a><p class="title"><b>Table 8.11. Default pgp function bindings</b></p><div class="table-contents"><table summary="Default pgp function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>verify-key</td><td>c</td><td>verify a PGP public key</td></tr><tr><td>view-name</td><td>%</td><td>view the key's user id</td></tr></tbody></table></div></div><p><br class="table-break" />

5967

5968

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="smime_map"></a>4.11. smime</h3></div></div></div><p>

5969

5970

</p><div class="table"><a id="smime_table"></a><p class="title"><b>Table 8.12. Default smime function bindings</b></p><div class="table-contents"><table summary="Default smime function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>verify-key</td><td>c</td><td>verify a PGP public key</td></tr><tr><td>view-name</td><td>%</td><td>view the key's user id</td></tr></tbody></table></div></div><p><br class="table-break" />

5971

5972

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="mix_map"></a>4.12. mix</h3></div></div></div><p>

5973

5974

</p><div class="table"><a id="mix_table"></a><p class="title"><b>Table 8.13. Default mix function bindings</b></p><div class="table-contents"><table summary="Default mix function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>accept</td><td>RET</td><td>Accept the chain constructed</td></tr><tr><td>append</td><td>a</td><td>Append a remailer to the chain</td></tr><tr><td>insert</td><td>i</td><td>Insert a remailer into the chain</td></tr><tr><td>delete</td><td>d</td><td>Delete a remailer from the chain</td></tr><tr><td>chain-prev</td><td>left</td><td>Select the previous element of the chain</td></tr><tr><td>chain-next</td><td>right</td><td>Select the next element of the chain</td></tr></tbody></table></div></div><p><br class="table-break" />

5975

5976

</p></div><div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="editor_map"></a>4.13. editor</h3></div></div></div><p>

5977

5978

</p><div class="table"><a id="editor_table"></a><p class="title"><b>Table 8.14. Default editor function bindings</b></p><div class="table-contents"><table summary="Default editor function bindings" border="1"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Function</th><th>Default key</th><th>Description</th></tr></thead><tbody><tr><td>bol</td><td>^A</td><td>jump to the beginning of the line</td></tr><tr><td>backward-char</td><td>^B</td><td>move the cursor one character to the left</td></tr><tr><td>backward-word</td><td>ESC b</td><td>move the cursor to the beginning of the word</td></tr><tr><td>capitalize-word</td><td>ESC c</td><td>capitalize the word</td></tr><tr><td>downcase-word</td><td>ESC l</td><td>convert the word to lower case</td></tr><tr><td>upcase-word</td><td>ESC u</td><td>convert the word to upper case</td></tr><tr><td>delete-char</td><td>^D</td><td>delete the char under the cursor</td></tr><tr><td>eol</td><td>^E</td><td>jump to the end of the line</td></tr><tr><td>forward-char</td><td>^F</td><td>move the cursor one character to the right</td></tr><tr><td>forward-word</td><td>ESC f</td><td>move the cursor to the end of the word</td></tr><tr><td>backspace</td><td>Backspace</td><td>delete the char in front of the cursor</td></tr><tr><td>kill-eol</td><td>^K</td><td>delete chars from cursor to end of line</td></tr><tr><td>kill-eow</td><td>ESC d</td><td>delete chars from the cursor to the end of the word</td></tr><tr><td>kill-line</td><td>^U</td><td>delete all chars on the line</td></tr><tr><td>quote-char</td><td>^V</td><td>quote the next typed key</td></tr><tr><td>kill-word</td><td>^W</td><td>delete the word in front of the cursor</td></tr><tr><td>complete</td><td>TAB</td><td>complete filename or alias</td></tr><tr><td>complete-query</td><td>^T</td><td>complete address with query</td></tr><tr><td>buffy-cycle</td><td>Space</td><td>cycle among incoming mailboxes</td></tr><tr><td>history-up</td><td>not bound</td><td>scroll up through the history list</td></tr><tr><td>history-down</td><td>not bound</td><td>scroll down through the history list</td></tr><tr><td>transpose-chars</td><td>not bound</td><td>transpose character under cursor with previous</td></tr></tbody></table></div></div><p><br class="table-break" />

5979

5980

</p></div></div></div><div class="chapter" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="miscellany"></a>Chapter 9. Miscellany</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#acknowledgements">1. Acknowledgements</a></span></dt><dt><span class="sect1"><a href="#about">2. About this document</a></span></dt></dl></div><div class="sect1" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="acknowledgements"></a>1. Acknowledgements</h2></div></div></div><p>

5454

5981

Kari Hurtta <code class="email"><<a href="mailto:kari.hurtta@fmi.fi">kari.hurtta@fmi.fi</a>></code>

5455

5982

co-developed the original MIME parsing code back in the ELM-ME days.

5456

5983

</p><p>