]> git.madduck.net Git - etc/mutt.git/blob - .mutt/confvars

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

include tty in mutt xterm title
[etc/mutt.git] / .mutt / confvars
1 # Auto-generated using mkconf from manual.txt
2 # on 2019-01-18 23:28:41
3 #
4 # Invoked as: ./mkconf confvars
5 #
6
7 # 3.1. abort_noattach
8
9 # Type: quadoption
10 # Default: no
11
12 # When the body of the message matches $abort_noattach_regexp and there are no
13 # attachments, this quadoption controls whether to abort sending the message.
14
15 set abort_noattach=ask-yes
16
17
18 # 3.2. abort_noattach_regexp
19
20 # Type: regular expression
21 # Default: “attach”
22
23 # Specifies a regular expression to match against the body of the message, to
24 # determine if an attachment was mentioned but mistakenly forgotten. If it
25 # matches, $abort_noattach will be consulted to determine if message sending will
26 # be aborted.
27
28 # Like other regular expressions in Mutt, the search is case sensitive if the
29 # pattern contains at least one upper case letter, and case insensitive
30 # otherwise. 
31
32 set abort_noattach_regexp='attach|beigefügt|angehängt|an(hang|lage)|screenshot|bildschirmphoto'
33 #'attach(ing|ed|ment)?|included\W+(with|in)\W+th(is|e\W+(curr|pres)ent)\W+mail|an(geh(ä|=E4|=C3=A4)ngt|h(ä|=E4|=C3=A4)ngsel|bei)|bei(gef(ü|=FC|=C3=BC)gt|lage)|(im|siehe)\W+(anhang|beilage)|attach(e|er|(é|=E9|=C3=A9)e?s?|ement|ant)'
34
35
36 # 3.3. abort_nosubject
37
38 # Type: quadoption
39 # Default: ask-yes
40
41 # If set to yes, when composing messages and no subject is given at the subject
42 # prompt, composition will be aborted. If set to no, composing messages with no
43 # subject given at the subject prompt will never be aborted.
44
45
46
47 # 3.4. abort_unmodified
48
49 # Type: quadoption
50 # Default: yes
51
52 # If set to yes, composition will automatically abort after editing the message
53 # body if no changes are made to the file (this check only happens after the
54 # first edit of the file). When set to no, composition will never be aborted.
55
56
57
58 # 3.5. alias_file
59
60 # Type: path
61 # Default: “~/.muttrc”
62
63 # The default file in which to save aliases created by the <create-alias>
64 # function. Entries added to this file are encoded in the character set specified
65 # by $config_charset if it is set or the current character set otherwise.
66
67 # Note: Mutt will not automatically source this file; you must explicitly use the
68 # “source” command for it to be executed in case this option points to a
69 # dedicated alias file.
70
71 # The default for this option is the currently used muttrc file, or “~/.muttrc”
72 # if no user muttrc was found.
73
74 set alias_file="$my_confdir/aliases"
75
76
77 # 3.6. alias_format
78
79 # Type: string
80 # Default: “%4n %2f %t %-10a   %r”
81
82 # Specifies the format of the data displayed for the “alias” menu. The following
83 # printf(3)-style sequences are available:
84
85 # ┌──┬──────────────────────────────────────────────────────────────┐ 
86 # │%a│alias name                                                    │
87 # ├──┼──────────────────────────────────────────────────────────────┤ 
88 # │%f│flags - currently, a “d” for an alias marked for deletion     │
89 # ├──┼──────────────────────────────────────────────────────────────┤ 
90 # │%n│index number                                                  │
91 # ├──┼──────────────────────────────────────────────────────────────┤ 
92 # │%r│address which alias expands to                                │
93 # ├──┼──────────────────────────────────────────────────────────────┤ 
94 # │%t│character which indicates if the alias is tagged for inclusion│
95 # └──┴──────────────────────────────────────────────────────────────┘ 
96
97
98
99 # 3.7. allow_8bit
100
101 # Type: boolean
102 # Default: yes
103
104 # Controls whether 8-bit data is converted to 7-bit using either Quoted-
105 # Printable or Base64 encoding when sending mail.
106
107
108
109 # 3.8. allow_ansi
110
111 # Type: boolean
112 # Default: no
113
114 # Controls whether ANSI color codes in messages (and color tags in rich text
115 # messages) are to be interpreted. Messages containing these codes are rare, but
116 # if this option is set, their text will be colored accordingly. Note that this
117 # may override your color choices, and even present a security problem, since a
118 # message could include a line like
119
120 # [-- PGP output follows ...
121
122 # and give it the same color as your attachment color (see also $crypt_timestamp
123 # ). 
124
125
126
127 # 3.9. arrow_cursor
128
129 # Type: boolean
130 # Default: no
131
132 # When set, an arrow (“->”) will be used to indicate the current entry in menus
133 # instead of highlighting the whole line. On slow network or modem links this
134 # will make response faster because there is less that has to be redrawn on the
135 # screen when moving to the next or previous entries in the menu.
136
137
138
139 # 3.10. ascii_chars
140
141 # Type: boolean
142 # Default: no
143
144 # If set, Mutt will use plain ASCII characters when displaying thread and
145 # attachment trees, instead of the default ACS characters.
146
147
148
149 # 3.11. askbcc
150
151 # Type: boolean
152 # Default: no
153
154 # If set, Mutt will prompt you for blind-carbon-copy (Bcc) recipients before
155 # editing an outgoing message.
156
157
158
159 # 3.12. askcc
160
161 # Type: boolean
162 # Default: no
163
164 # If set, Mutt will prompt you for carbon-copy (Cc) recipients before editing the
165 # body of an outgoing message.
166
167
168
169 # 3.13. assumed_charset
170
171 # Type: string
172 # Default: (empty)
173
174 # This variable is a colon-separated list of character encoding schemes for
175 # messages without character encoding indication. Header field values and message
176 # body content without character encoding indication would be assumed that they
177 # are written in one of this list. By default, all the header fields and message
178 # body without any charset indication are assumed to be in “us-ascii”.
179
180 # For example, Japanese users might prefer this:
181
182 # set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
183
184 # However, only the first content is valid for the message body.
185
186
187
188 # 3.14. attach_charset
189
190 # Type: string
191 # Default: (empty)
192
193 # This variable is a colon-separated list of character encoding schemes for text
194 # file attachments. Mutt uses this setting to guess which encoding files being
195 # attached are encoded in to convert them to a proper character set given in
196 # $send_charset. 
197
198 # If unset, the value of $charset will be used instead. For example, the
199 # following configuration would work for Japanese text handling:
200
201 # set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
202
203 # Note: for Japanese users, “iso-2022-*” must be put at the head of the value as
204 # shown above if included.
205
206
207
208 # 3.15. attach_format
209
210 # Type: string
211 # Default: “%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] ”
212
213 # This variable describes the format of the “attachment” menu. The following
214 # printf(3)-style sequences are understood:
215
216 # ┌───┬─────────────────────────────────────────────────────────────────────────┐ 
217 # │%C │charset                                                                  │
218 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
219 # │%c │requires charset conversion (“n” or “c”)                                 │
220 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
221 # │%D │deleted flag                                                             │
222 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
223 # │%d │description (if none, falls back to %F)                                  │
224 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
225 # │%e │MIME content-transfer-encoding                                           │
226 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
227 # │%F │filename in content-disposition header (if none, falls back to %f)       │
228 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
229 # │%f │filename                                                                 │
230 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
231 # │%I │disposition (“I” for inline, “A” for attachment)                         │
232 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
233 # │%m │major MIME type                                                          │
234 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
235 # │%M │MIME subtype                                                             │
236 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
237 # │%n │attachment number                                                        │
238 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
239 # │%Q │“Q”, if MIME part qualifies for attachment counting                      │
240 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
241 # │%s │size                                                                     │
242 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
243 # │%t │tagged flag                                                              │
244 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
245 # │%T │graphic tree characters                                                  │
246 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
247 # │%u │unlink (=to delete) flag                                                 │
248 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
249 # │%X │number of qualifying MIME parts in this part and its children (please see│
250 # │ │the “attachments” section for possible speed effects)                    │
251 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
252 # │%>X│right justify the rest of the string and pad with character “X”          │
253 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
254 # │%|X│pad to the end of the line with character “X”                            │
255 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
256 # │%*X│soft-fill with character “X” as pad                                      │
257 # └───┴─────────────────────────────────────────────────────────────────────────┘ 
258
259 # For an explanation of “soft-fill”, see the $index_format documentation.
260
261
262
263 # 3.16. attach_sep
264
265 # Type: string
266 # Default: “n”
267
268 # The separator to add between attachments when operating (saving, printing,
269 # piping, etc) on a list of tagged attachments.
270
271
272
273 # 3.17. attach_split
274
275 # Type: boolean
276 # Default: yes
277
278 # If this variable is unset, when operating (saving, printing, piping, etc) on a
279 # list of tagged attachments, Mutt will concatenate the attachments and will
280 # operate on them as a single attachment. The $attach_sep separator is added
281 # after each attachment. When set, Mutt will operate on the attachments one by
282 # one. 
283
284
285
286 # 3.18. attribution
287
288 # Type: string
289 # Default: “On %d, %n wrote:”
290
291 # This is the string that will precede a message which has been included in a
292 # reply. For a full listing of defined printf(3)-like sequences see the section
293 # on $index_format.
294
295 set attribution="$my_attribution_en"
296
297
298 # 3.19. attribution_locale
299
300 # Type: string
301 # Default: (empty)
302
303 # The locale used by strftime(3) to format dates in the attribution string. Legal
304 # values are the strings your system accepts for the locale environment variable
305 # $LC_TIME. 
306
307 # This variable is to allow the attribution date format to be customized by
308 # recipient or folder using hooks. By default, Mutt will use your locale
309 # environment, so there is no need to set this except to override that default.
310
311
312
313 # 3.20. auto_tag
314
315 # Type: boolean
316 # Default: no
317
318 # When set, functions in the index menu which affect a message will be applied to
319 # all tagged messages (if there are any). When unset, you must first use the
320 # <tag-prefix> function (bound to “;” by default) to make the next function apply
321 # to all tagged messages.
322
323
324
325 # 3.21. autoedit
326
327 # Type: boolean
328 # Default: no
329
330 # When set along with $edit_headers, Mutt will skip the initial send-menu
331 # (prompting for subject and recipients) and allow you to immediately begin
332 # editing the body of your message. The send-menu may still be accessed once you
333 # have finished editing the body of your message.
334
335 # Note: when this option is set, you cannot use send-hooks that depend on the
336 # recipients when composing a new (non-reply) message, as the initial list of
337 # recipients is empty.
338
339 # Also see $fast_reply.
340
341 set autoedit=yes
342
343
344 # 3.22. beep
345
346 # Type: boolean
347 # Default: yes
348
349 # When this variable is set, mutt will beep when an error occurs.
350
351 set beep=no
352
353
354 # 3.23. beep_new
355
356 # Type: boolean
357 # Default: no
358
359 # When this variable is set, mutt will beep whenever it prints a message
360 # notifying you of new mail. This is independent of the setting of the $beep
361 # variable. 
362
363
364
365 # 3.24. bounce
366
367 # Type: quadoption
368 # Default: ask-yes
369
370 # Controls whether you will be asked to confirm bouncing messages. If set to yes
371 # you don't get asked if you want to bounce a message. Setting this variable to
372 # no is not generally useful, and thus not recommended, because you are unable to
373 # bounce messages.
374
375
376
377 # 3.25. bounce_delivered
378
379 # Type: boolean
380 # Default: yes
381
382 # When this variable is set, mutt will include Delivered-To headers when bouncing
383 # messages. Postfix users may wish to unset this variable.
384
385 set bounce_delivered=no
386
387
388 # 3.26. braille_friendly
389
390 # Type: boolean
391 # Default: no
392
393 # When this variable is set, mutt will place the cursor at the beginning of the
394 # current line in menus, even when the $arrow_cursor variable is unset, making it
395 # easier for blind persons using Braille displays to follow these menus. The
396 # option is unset by default because many visual terminals don't permit making
397 # the cursor invisible.
398
399
400
401 # 3.27. browser_abbreviate_mailboxes
402
403 # Type: boolean
404 # Default: yes
405
406 # When this variable is set, mutt will abbreviate mailbox names in the browser
407 # mailbox list, using '~' and '=' shortcuts.
408
409 # The default "alpha" setting of $sort_browser uses locale-based sorting (using
410 # strcoll(3)), which ignores some punctuation. This can lead to some situations
411 # where the order doesn't make intuitive sense. In those cases, it may be
412 # desirable to unset this variable.
413
414
415
416 # 3.28. certificate_file
417
418 # Type: path
419 # Default: “~/.mutt_certificates”
420
421 # This variable specifies the file where the certificates you trust are saved.
422 # When an unknown certificate is encountered, you are asked if you accept it or
423 # not. If you accept it, the certificate can also be saved in this file and
424 # further connections are automatically accepted.
425
426 # You can also manually add CA certificates in this file. Any server certificate
427 # that is signed with one of these CA certificates is also automatically
428 # accepted. 
429
430 # Example: 
431
432 # set certificate_file=~/.mutt/certificates
433
434
435
436 # 3.29. change_folder_next
437
438 # Type: boolean
439 # Default: no
440
441 # When this variable is set, the <change-folder> function mailbox suggestion will
442 # start at the next folder in your “mailboxes” list, instead of starting at the
443 # first folder in the list.
444
445
446
447 # 3.30. charset
448
449 # Type: string
450 # Default: (empty)
451
452 # Character set your terminal uses to display and enter textual data. It is also
453 # the fallback for $send_charset.
454
455 # Upon startup Mutt tries to derive this value from environment variables such as
456 # $LC_CTYPE or $LANG.
457
458 # Note: It should only be set in case Mutt isn't able to determine the character
459 # set used correctly.
460
461
462
463 # 3.31. check_mbox_size
464
465 # Type: boolean
466 # Default: no
467
468 # When this variable is set, mutt will use file size attribute instead of access
469 # time when checking for new mail in mbox and mmdf folders.
470
471 # This variable is unset by default and should only be enabled when new mail
472 # detection for these folder types is unreliable or doesn't work.
473
474 # Note that enabling this variable should happen before any “mailboxes”
475 # directives occur in configuration files regarding mbox or mmdf folders because
476 # mutt needs to determine the initial new mail status of such a mailbox by
477 # performing a fast mailbox scan when it is defined. Afterwards the new mail
478 # status is tracked by file size changes.
479
480
481
482 # 3.32. check_new
483
484 # Type: boolean
485 # Default: yes
486
487 # Note: this option only affects maildir and MH style mailboxes.
488
489 # When set, Mutt will check for new mail delivered while the mailbox is open.
490 # Especially with MH mailboxes, this operation can take quite some time since it
491 # involves scanning the directory and checking each file to see if it has already
492 # been looked at. If this variable is unset, no check for new mail is performed
493 # while the mailbox is open.
494
495
496
497 # 3.33. collapse_unread
498
499 # Type: boolean
500 # Default: yes
501
502 # When unset, Mutt will not collapse a thread if it contains any unread messages.
503
504
505
506 # 3.34. compose_format
507
508 # Type: string
509 # Default: “-- Mutt: Compose  [Approx. msg size: %l   Atts: %a]%>-”
510
511 # Controls the format of the status line displayed in the “compose” menu. This
512 # string is similar to $status_format, but has its own set of printf(3)-like
513 # sequences: 
514
515 # ┌──┬──────────────────────────────────────────────────┐ 
516 # │%a│total number of attachments                       │
517 # ├──┼──────────────────────────────────────────────────┤ 
518 # │%h│local hostname                                    │
519 # ├──┼──────────────────────────────────────────────────┤ 
520 # │%l│approximate size (in bytes) of the current message│
521 # ├──┼──────────────────────────────────────────────────┤ 
522 # │%v│Mutt version string                               │
523 # └──┴──────────────────────────────────────────────────┘ 
524
525 # See the text describing the $status_format option for more information on how
526 # to set $compose_format.
527
528
529
530 # 3.35. config_charset
531
532 # Type: string
533 # Default: (empty)
534
535 # When defined, Mutt will recode commands in rc files from this encoding to the
536 # current character set as specified by $charset and aliases written to
537 # $alias_file from the current character set.
538
539 # Please note that if setting $charset it must be done before setting
540 # $config_charset. 
541
542 # Recoding should be avoided as it may render unconvertable characters as
543 # question marks which can lead to undesired side effects (for example in regular
544 # expressions). 
545
546
547
548 # 3.36. confirmappend
549
550 # Type: boolean
551 # Default: yes
552
553 # When set, Mutt will prompt for confirmation when appending messages to an
554 # existing mailbox.
555
556 set confirmappend=no
557
558
559 # 3.37. confirmcreate
560
561 # Type: boolean
562 # Default: yes
563
564 # When set, Mutt will prompt for confirmation when saving messages to a mailbox
565 # which does not yet exist before creating it.
566
567
568
569 # 3.38. connect_timeout
570
571 # Type: number
572 # Default: 30
573
574 # Causes Mutt to timeout a network connection (for IMAP, POP or SMTP) after this
575 # many seconds if the connection is not able to be established. A negative value
576 # causes Mutt to wait indefinitely for the connection attempt to succeed.
577
578
579
580 # 3.39. content_type
581
582 # Type: string
583 # Default: “text/plain”
584
585 # Sets the default Content-Type for the body of newly composed messages.
586
587 set content_type="text/plain; markup=markdown"
588
589
590 # 3.40. copy
591
592 # Type: quadoption
593 # Default: yes
594
595 # This variable controls whether or not copies of your outgoing messages will be
596 # saved for later references. Also see $record, $save_name, $force_name and “
597 # fcc-hook”. 
598
599 set copy=yes
600
601
602 # 3.41. crypt_autoencrypt
603
604 # Type: boolean
605 # Default: no
606
607 # Setting this variable will cause Mutt to always attempt to PGP encrypt outgoing
608 # messages. This is probably only useful in connection to the “send-hook”
609 # command. It can be overridden by use of the pgp menu, when encryption is not
610 # required or signing is requested as well. If $smime_is_default is set, then
611 # OpenSSL is used instead to create S/MIME messages and settings can be
612 # overridden by use of the smime menu instead. (Crypto only)
613
614
615
616 # 3.42. crypt_autopgp
617
618 # Type: boolean
619 # Default: yes
620
621 # This variable controls whether or not mutt may automatically enable PGP
622 # encryption/signing for messages. See also $crypt_autoencrypt,
623 # $crypt_replyencrypt, $crypt_autosign, $crypt_replysign and $smime_is_default.
624
625
626
627 # 3.43. crypt_autosign
628
629 # Type: boolean
630 # Default: no
631
632 # Setting this variable will cause Mutt to always attempt to cryptographically
633 # sign outgoing messages. This can be overridden by use of the pgp menu, when
634 # signing is not required or encryption is requested as well. If
635 # $smime_is_default is set, then OpenSSL is used instead to create S/MIME
636 # messages and settings can be overridden by use of the smime menu instead of the
637 # pgp menu. (Crypto only)
638
639 set crypt_autosign=yes
640
641
642 # 3.44. crypt_autosmime
643
644 # Type: boolean
645 # Default: yes
646
647 # This variable controls whether or not mutt may automatically enable S/MIME
648 # encryption/signing for messages. See also $crypt_autoencrypt,
649 # $crypt_replyencrypt, $crypt_autosign, $crypt_replysign and $smime_is_default.
650
651 set crypt_autosmime=no
652
653
654 # 3.45. crypt_confirmhook
655
656 # Type: boolean
657 # Default: yes
658
659 # If set, then you will be prompted for confirmation of keys when using the
660 # crypt-hook command. If unset, no such confirmation prompt will be presented.
661 # This is generally considered unsafe, especially where typos are concerned.
662
663
664
665 # 3.46. crypt_opportunistic_encrypt
666
667 # Type: boolean
668 # Default: no
669
670 # Setting this variable will cause Mutt to automatically enable and disable
671 # encryption, based on whether all message recipient keys can be located by Mutt.
672
673 # When this option is enabled, Mutt will enable/disable encryption each time the
674 # TO, CC, and BCC lists are edited. If $edit_headers is set, Mutt will also do so
675 # each time the message is edited.
676
677 # While this is set, encryption can't be manually enabled/disabled. The pgp or
678 # smime menus provide a selection to temporarily disable this option for the
679 # current message.
680
681 # If $crypt_autoencrypt or $crypt_replyencrypt enable encryption for a message,
682 # this option will be disabled for that message. It can be manually re-enabled in
683 # the pgp or smime menus. (Crypto only)
684
685 set crypt_opportunistic_encrypt=yes
686
687
688 # 3.47. crypt_replyencrypt
689
690 # Type: boolean
691 # Default: yes
692
693 # If set, automatically PGP or OpenSSL encrypt replies to messages which are
694 # encrypted. (Crypto only)
695
696
697
698 # 3.48. crypt_replysign
699
700 # Type: boolean
701 # Default: no
702
703 # If set, automatically PGP or OpenSSL sign replies to messages which are signed.
704
705 # Note: this does not work on messages that are encrypted and signed! (Crypto
706 # only) 
707
708 set crypt_replysign=yes
709
710
711 # 3.49. crypt_replysignencrypted
712
713 # Type: boolean
714 # Default: no
715
716 # If set, automatically PGP or OpenSSL sign replies to messages which are
717 # encrypted. This makes sense in combination with $crypt_replyencrypt, because it
718 # allows you to sign all messages which are automatically encrypted. This works
719 # around the problem noted in $crypt_replysign, that mutt is not able to find out
720 # whether an encrypted message is also signed. (Crypto only)
721
722 set crypt_replysignencrypted=yes
723
724
725 # 3.50. crypt_timestamp
726
727 # Type: boolean
728 # Default: yes
729
730 # If set, mutt will include a time stamp in the lines surrounding PGP or S/MIME
731 # output, so spoofing such lines is more difficult. If you are using colors to
732 # mark these lines, and rely on these, you may unset this setting. (Crypto only)
733
734
735
736 # 3.51. crypt_use_gpgme
737
738 # Type: boolean
739 # Default: no
740
741 # This variable controls the use of the GPGME-enabled crypto backends. If it is
742 # set and Mutt was built with gpgme support, the gpgme code for S/MIME and PGP
743 # will be used instead of the classic code. Note that you need to set this option
744 # in .muttrc; it won't have any effect when used interactively.
745
746 # Note that the GPGME backend does not support creating old-style inline
747 # (traditional) PGP encrypted or signed messages (see $pgp_autoinline).
748
749
750
751 # 3.52. crypt_use_pka
752
753 # Type: boolean
754 # Default: no
755
756 # Controls whether mutt uses PKA (see http://www.g10code.de/docs/
757 # pka-intro.de.pdf) during signature verification (only supported by the GPGME
758 # backend). 
759
760 set crypt_use_pka=yes
761
762
763 # 3.53. crypt_verify_sig
764
765 # Type: quadoption
766 # Default: yes
767
768 # If “yes”, always attempt to verify PGP or S/MIME signatures. If “ask-*”, ask
769 # whether or not to verify the signature. If “no”, never attempt to verify
770 # cryptographic signatures. (Crypto only)
771
772
773
774 # 3.54. date_format
775
776 # Type: string
777 # Default: “!%a, %b %d, %Y at %I:%M:%S%p %Z”
778
779 # This variable controls the format of the date printed by the “%d” sequence in
780 # $index_format. This is passed to the strftime(3) function to process the date,
781 # see the man page for the proper syntax.
782
783 # Unless the first character in the string is a bang (“!”), the month and week
784 # day names are expanded according to the locale. If the first character in the
785 # string is a bang, the bang is discarded, and the month and week day names in
786 # the rest of the string are expanded in the C locale (that is in US English).
787
788 set date_format="%F"
789
790
791 # 3.55. default_hook
792
793 # Type: string
794 # Default: “~f %s !~P | (~P ~C %s)”
795
796 # This variable controls how “message-hook”, “reply-hook”, “send-hook”, “
797 # send2-hook”, “save-hook”, and “fcc-hook” will be interpreted if they are
798 # specified with only a simple regexp, instead of a matching pattern. The hooks
799 # are expanded when they are declared, so a hook will be interpreted according to
800 # the value of this variable at the time the hook is declared.
801
802 # The default value matches if the message is either from a user matching the
803 # regular expression given, or if it is from you (if the from address matches “
804 # alternates”) and is to or cc'ed to a user matching the given regular
805 # expression. 
806
807
808
809 # 3.56. delete
810
811 # Type: quadoption
812 # Default: ask-yes
813
814 # Controls whether or not messages are really deleted when closing or
815 # synchronizing a mailbox. If set to yes, messages marked for deleting will
816 # automatically be purged without prompting. If set to no, messages marked for
817 # deletion will be kept in the mailbox.
818
819 set delete=yes
820
821
822 # 3.57. delete_untag
823
824 # Type: boolean
825 # Default: yes
826
827 # If this option is set, mutt will untag messages when marking them for deletion.
828 # This applies when you either explicitly delete a message, or when you save it
829 # to another folder.
830
831
832
833 # 3.58. digest_collapse
834
835 # Type: boolean
836 # Default: yes
837
838 # If this option is set, mutt's received-attachments menu will not show the
839 # subparts of individual messages in a multipart/digest. To see these subparts,
840 # press “v” on that menu.
841
842
843
844 # 3.59. display_filter
845
846 # Type: path
847 # Default: (empty)
848
849 # When set, specifies a command used to filter messages. When a message is viewed
850 # it is passed as standard input to $display_filter, and the filtered message is
851 # read from the standard output.
852
853
854
855 # 3.60. dotlock_program
856
857 # Type: path
858 # Default: “/usr/bin/mutt_dotlock”
859
860 # Contains the path of the mutt_dotlock(8) binary to be used by mutt.
861
862
863
864 # 3.61. dsn_notify
865
866 # Type: string
867 # Default: (empty)
868
869 # This variable sets the request for when notification is returned. The string
870 # consists of a comma separated list (no spaces!) of one or more of the
871 # following: never, to never request notification, failure, to request
872 # notification on transmission failure, delay, to be notified of message delays,
873 # success, to be notified of successful transmission.
874
875 # Example: 
876
877 # set dsn_notify="failure,delay"
878
879 # Note: when using $sendmail for delivery, you should not enable this unless you
880 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
881 # -compatible interface supporting the -N option for DSN. For SMTP delivery, DSN
882 # support is auto-detected so that it depends on the server whether DSN will be
883 # used or not.
884
885
886
887 # 3.62. dsn_return
888
889 # Type: string
890 # Default: (empty)
891
892 # This variable controls how much of your message is returned in DSN messages. It
893 # may be set to either hdrs to return just the message header, or full to return
894 # the full message.
895
896 # Example: 
897
898 # set dsn_return=hdrs
899
900 # Note: when using $sendmail for delivery, you should not enable this unless you
901 # are either using Sendmail 8.8.x or greater or a MTA providing a sendmail(1)
902 # -compatible interface supporting the -R option for DSN. For SMTP delivery, DSN
903 # support is auto-detected so that it depends on the server whether DSN will be
904 # used or not.
905
906
907
908 # 3.63. duplicate_threads
909
910 # Type: boolean
911 # Default: yes
912
913 # This variable controls whether mutt, when $sort is set to threads, threads
914 # messages with the same Message-Id together. If it is set, it will indicate that
915 # it thinks they are duplicates of each other with an equals sign in the thread
916 # tree. 
917
918
919
920 # 3.64. edit_headers
921
922 # Type: boolean
923 # Default: no
924
925 # This option allows you to edit the header of your outgoing messages along with
926 # the body of your message.
927
928 # Although the compose menu may have localized header labels, the labels passed
929 # to your editor will be standard RFC 2822 headers, (e.g. To:, Cc:, Subject:).
930 # Headers added in your editor must also be RFC 2822 headers, or one of the
931 # pseudo headers listed in “edit-header”. Mutt will not understand localized
932 # header labels, just as it would not when parsing an actual email.
933
934 # Note that changes made to the References: and Date: headers are ignored for
935 # interoperability reasons.
936
937 set edit_headers=yes
938
939
940 # 3.65. editor
941
942 # Type: path
943 # Default: (empty)
944
945 # This variable specifies which editor is used by mutt. It defaults to the value
946 # of the $VISUAL, or $EDITOR, environment variable, or to the string “vi” if
947 # neither of those are set.
948
949 # The $editor string may contain a %s escape, which will be replaced by the name
950 # of the file to be edited. If the %s escape does not appear in $editor, a space
951 # and the name to be edited are appended.
952
953 # The resulting string is then executed by running
954
955 # sh -c 'string'
956
957 # where string is the expansion of $editor described above.
958
959 set editor="mailplate --edit --auto --keep-unknown"
960
961
962 # 3.66. encode_from
963
964 # Type: boolean
965 # Default: no
966
967 # When set, mutt will quoted-printable encode messages when they contain the
968 # string “From ” (note the trailing space) in the beginning of a line. This is
969 # useful to avoid the tampering certain mail delivery and transport agents tend
970 # to do with messages (in order to prevent tools from misinterpreting the line as
971 # a mbox message separator).
972
973
974
975 # 3.67. entropy_file
976
977 # Type: path
978 # Default: (empty)
979
980 # The file which includes random data that is used to initialize SSL library
981 # functions. 
982
983
984
985 # 3.68. envelope_from_address
986
987 # Type: e-mail address
988 # Default: (empty)
989
990 # Manually sets the envelope sender for outgoing messages. This value is ignored
991 # if $use_envelope_from is unset.
992
993
994
995 # 3.69. error_history
996
997 # Type: number
998 # Default: 30
999
1000 # This variable controls the size (in number of strings remembered) of the error
1001 # messages displayed by mutt. These can be shown with the <error-history>
1002 # function. The history is cleared each time this variable is set.
1003
1004
1005
1006 # 3.70. escape
1007
1008 # Type: string
1009 # Default: “~”
1010
1011 # Escape character to use for functions in the built-in editor.
1012
1013
1014
1015 # 3.71. fast_reply
1016
1017 # Type: boolean
1018 # Default: no
1019
1020 # When set, the initial prompt for recipients and subject are skipped when
1021 # replying to messages, and the initial prompt for subject is skipped when
1022 # forwarding messages.
1023
1024 # Note: this variable has no effect when the $autoedit variable is set.
1025
1026
1027
1028 # 3.72. fcc_attach
1029
1030 # Type: quadoption
1031 # Default: yes
1032
1033 # This variable controls whether or not attachments on outgoing messages are
1034 # saved along with the main body of your message.
1035
1036 set fcc_attach=yes
1037
1038
1039 # 3.73. fcc_clear
1040
1041 # Type: boolean
1042 # Default: no
1043
1044 # When this variable is set, FCCs will be stored unencrypted and unsigned, even
1045 # when the actual message is encrypted and/or signed. (PGP only)
1046
1047
1048
1049 # 3.74. flag_safe
1050
1051 # Type: boolean
1052 # Default: no
1053
1054 # If set, flagged messages cannot be deleted.
1055
1056
1057
1058 # 3.75. folder
1059
1060 # Type: path
1061 # Default: “~/Mail”
1062
1063 # Specifies the default location of your mailboxes. A “+” or “=” at the beginning
1064 # of a pathname will be expanded to the value of this variable. Note that if you
1065 # change this variable (from the default) value you need to make sure that the
1066 # assignment occurs before you use “+” or “=” for any other variables since
1067 # expansion takes place when handling the “mailboxes” command.
1068
1069 set folder="~/mail"
1070
1071
1072 # 3.76. folder_format
1073
1074 # Type: string
1075 # Default: “%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f”
1076
1077 # This variable allows you to customize the file browser display to your personal
1078 # taste. This string is similar to $index_format, but has its own set of printf
1079 # (3)-like sequences:
1080
1081 # ┌───┬─────────────────────────────────────────────────────────────────────────┐ 
1082 # │%C │current file number                                                      │
1083 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1084 # │%d │date/time folder was last modified                                       │
1085 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1086 # │%D │date/time folder was last modified using $date_format.                   │
1087 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1088 # │%f │filename (“/” is appended to directory names, “@” to symbolic links and “│
1089 # │ │*” to executable files)                                                  │
1090 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1091 # │%F │file permissions                                                         │
1092 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1093 # │%g │group name (or numeric gid, if missing)                                  │
1094 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1095 # │%l │number of hard links                                                     │
1096 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1097 # │%m │number of messages in the mailbox *                                      │
1098 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1099 # │%n │number of unread messages in the mailbox *                               │
1100 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1101 # │%N │N if mailbox has new mail, blank otherwise                               │
1102 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1103 # │%s │size in bytes                                                            │
1104 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1105 # │%t │“*” if the file is tagged, blank otherwise                               │
1106 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1107 # │%u │owner name (or numeric uid, if missing)                                  │
1108 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1109 # │%>X│right justify the rest of the string and pad with character “X”          │
1110 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1111 # │%|X│pad to the end of the line with character “X”                            │
1112 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
1113 # │%*X│soft-fill with character “X” as pad                                      │
1114 # └───┴─────────────────────────────────────────────────────────────────────────┘ 
1115
1116 # For an explanation of “soft-fill”, see the $index_format documentation.
1117
1118 # * = can be optionally printed if nonzero
1119
1120 # %m, %n, and %N only work for monitored mailboxes. %m requires $mail_check_stats
1121 # to be set. %n requires $mail_check_stats to be set (except for IMAP mailboxes).
1122
1123 set folder_format='%t%N%2C  %D  %4s  %f'
1124
1125 # 3.77. followup_to
1126
1127 # Type: boolean
1128 # Default: yes
1129
1130 # Controls whether or not the “Mail-Followup-To:” header field is generated when
1131 # sending mail. When set, Mutt will generate this field when you are replying to
1132 # a known mailing list, specified with the “subscribe” or “lists” commands.
1133
1134 # This field has two purposes. First, preventing you from receiving duplicate
1135 # copies of replies to messages which you send to mailing lists, and second,
1136 # ensuring that you do get a reply separately for any messages sent to known
1137 # lists to which you are not subscribed.
1138
1139 # The header will contain only the list's address for subscribed lists, and both
1140 # the list address and your own email address for unsubscribed lists. Without
1141 # this header, a group reply to your message sent to a subscribed list will be
1142 # sent to both the list and your address, resulting in two copies of the same
1143 # email for you.
1144
1145
1146
1147 # 3.78. force_name
1148
1149 # Type: boolean
1150 # Default: no
1151
1152 # This variable is similar to $save_name, except that Mutt will store a copy of
1153 # your outgoing message by the username of the address you are sending to even if
1154 # that mailbox does not exist.
1155
1156 # Also see the $record variable.
1157
1158
1159
1160 # 3.79. forward_attribution_intro
1161
1162 # Type: string
1163 # Default: “----- Forwarded message from %f -----”
1164
1165 # This is the string that will precede a message which has been forwarded in the
1166 # main body of a message (when $mime_forward is unset). For a full listing of
1167 # defined printf(3)-like sequences see the section on $index_format. See also
1168 # $attribution_locale. 
1169
1170
1171
1172 # 3.80. forward_attribution_trailer
1173
1174 # Type: string
1175 # Default: “----- End forwarded message -----”
1176
1177 # This is the string that will follow a message which has been forwarded in the
1178 # main body of a message (when $mime_forward is unset). For a full listing of
1179 # defined printf(3)-like sequences see the section on $index_format. See also
1180 # $attribution_locale. 
1181
1182
1183
1184 # 3.81. forward_decode
1185
1186 # Type: boolean
1187 # Default: yes
1188
1189 # Controls the decoding of complex MIME messages into text/plain when forwarding
1190 # a message. The message header is also RFC2047 decoded. This variable is only
1191 # used, if $mime_forward is unset, otherwise $mime_forward_decode is used
1192 # instead. 
1193
1194
1195
1196 # 3.82. forward_decrypt
1197
1198 # Type: boolean
1199 # Default: yes
1200
1201 # Controls the handling of encrypted messages when forwarding a message. When set
1202 # , the outer layer of encryption is stripped off. This variable is only used if
1203 # $mime_forward is set and $mime_forward_decode is unset. (PGP only)
1204
1205
1206
1207 # 3.83. forward_edit
1208
1209 # Type: quadoption
1210 # Default: yes
1211
1212 # This quadoption controls whether or not the user is automatically placed in the
1213 # editor when forwarding messages. For those who always want to forward with no
1214 # modification, use a setting of “no”.
1215
1216
1217
1218 # 3.84. forward_format
1219
1220 # Type: string
1221 # Default: “[%a: %s]”
1222
1223 # This variable controls the default subject when forwarding a message. It uses
1224 # the same format sequences as the $index_format variable.
1225
1226 set forward_format="(fwd) %s"
1227
1228
1229 # 3.85. forward_quote
1230
1231 # Type: boolean
1232 # Default: no
1233
1234 # When set, forwarded messages included in the main body of the message (when
1235 # $mime_forward is unset) will be quoted using $indent_string.
1236
1237
1238
1239 # 3.86. from
1240
1241 # Type: e-mail address
1242 # Default: (empty)
1243
1244 # When set, this variable contains a default from address. It can be overridden
1245 # using “my_hdr” (including from a “send-hook”) and $reverse_name. This variable
1246 # is ignored if $use_from is unset.
1247
1248 # This setting defaults to the contents of the environment variable $EMAIL.
1249
1250 set from='martin f krafft <madduck@madduck.net>'
1251
1252
1253 # 3.87. gecos_mask
1254
1255 # Type: regular expression
1256 # Default: “^[^,]*”
1257
1258 # A regular expression used by mutt to parse the GECOS field of a password entry
1259 # when expanding the alias. The default value will return the string up to the
1260 # first “,” encountered. If the GECOS field contains a string like “lastname,
1261 # firstname” then you should set it to “.*”.
1262
1263 # This can be useful if you see the following behavior: you address an e-mail to
1264 # user ID “stevef” whose full name is “Steve Franklin”. If mutt expands “stevef”
1265 # to “"Franklin" stevef@foo.bar” then you should set the $gecos_mask to a regular
1266 # expression that will match the whole name so mutt will expand “Franklin” to “
1267 # Franklin, Steve”.
1268
1269
1270
1271 # 3.88. hdrs
1272
1273 # Type: boolean
1274 # Default: yes
1275
1276 # When unset, the header fields normally added by the “my_hdr” command are not
1277 # created. This variable must be unset before composing a new message or replying
1278 # in order to take effect. If set, the user defined header fields are added to
1279 # every new message.
1280
1281
1282
1283 # 3.89. header
1284
1285 # Type: boolean
1286 # Default: no
1287
1288 # When set, this variable causes Mutt to include the header of the message you
1289 # are replying to into the edit buffer. The $weed setting applies.
1290
1291
1292
1293 # 3.90. header_cache
1294
1295 # Type: path
1296 # Default: (empty)
1297
1298 # This variable points to the header cache database. If pointing to a directory
1299 # Mutt will contain a header cache database file per folder, if pointing to a
1300 # file that file will be a single global header cache. By default it is unset so
1301 # no header caching will be used.
1302
1303 # Header caching can greatly improve speed when opening POP, IMAP MH or Maildir
1304 # folders, see “caching” for details.
1305
1306 set header_cache="~/.var/mutt/header_cache"
1307
1308
1309 # 3.91. header_cache_compress
1310
1311 # Type: boolean
1312 # Default: yes
1313
1314 # When mutt is compiled with qdbm, tokyocabinet, or kyotocabinet as header cache
1315 # backend, this option determines whether the database will be compressed.
1316 # Compression results in database files roughly being one fifth of the usual
1317 # diskspace, but the decompression can result in a slower opening of cached
1318 # folder(s) which in general is still much faster than opening non header cached
1319 # folders. 
1320
1321 set header_cache_compress=no
1322
1323
1324 # 3.92. header_cache_pagesize
1325
1326 # Type: string
1327 # Default: “16384”
1328
1329 # When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1330 # this option changes the database page size. Too large or too small values can
1331 # waste space, memory, or CPU time. The default should be more or less optimal
1332 # for most use cases.
1333
1334
1335
1336 # 3.93. header_color_partial
1337
1338 # Type: boolean
1339 # Default: no
1340
1341 # When set, color header regexps behave like color body regexps: color is applied
1342 # to the exact text matched by the regexp. When unset, color is applied to the
1343 # entire header.
1344
1345 # One use of this option might be to apply color to just the header labels.
1346
1347 # See “color” for more details.
1348
1349
1350
1351 # 3.94. help
1352
1353 # Type: boolean
1354 # Default: yes
1355
1356 # When set, help lines describing the bindings for the major functions provided
1357 # by each menu are displayed on the first line of the screen.
1358
1359 # Note: The binding will not be displayed correctly if the function is bound to a
1360 # sequence rather than a single keystroke. Also, the help line may not be updated
1361 # if a binding is changed while Mutt is running. Since this variable is primarily
1362 # aimed at new users, neither of these should present a major problem.
1363
1364
1365
1366 # 3.95. hidden_host
1367
1368 # Type: boolean
1369 # Default: no
1370
1371 # When set, mutt will skip the host name part of $hostname variable when adding
1372 # the domain part to addresses. This variable does not affect the generation of
1373 # Message-IDs, and it will not lead to the cut-off of first-level domains.
1374
1375
1376
1377 # 3.96. hide_limited
1378
1379 # Type: boolean
1380 # Default: no
1381
1382 # When set, mutt will not show the presence of messages that are hidden by
1383 # limiting, in the thread tree.
1384
1385
1386
1387 # 3.97. hide_missing
1388
1389 # Type: boolean
1390 # Default: yes
1391
1392 # When set, mutt will not show the presence of missing messages in the thread
1393 # tree. 
1394
1395
1396
1397 # 3.98. hide_thread_subject
1398
1399 # Type: boolean
1400 # Default: yes
1401
1402 # When set, mutt will not show the subject of messages in the thread tree that
1403 # have the same subject as their parent or closest previously displayed sibling.
1404
1405
1406
1407 # 3.99. hide_top_limited
1408
1409 # Type: boolean
1410 # Default: no
1411
1412 # When set, mutt will not show the presence of messages that are hidden by
1413 # limiting, at the top of threads in the thread tree. Note that when
1414 # $hide_limited is set, this option will have no effect.
1415
1416
1417
1418 # 3.100. hide_top_missing
1419
1420 # Type: boolean
1421 # Default: yes
1422
1423 # When set, mutt will not show the presence of missing messages at the top of
1424 # threads in the thread tree. Note that when $hide_missing is set, this option
1425 # will have no effect.
1426
1427
1428
1429 # 3.101. history
1430
1431 # Type: number
1432 # Default: 10
1433
1434 # This variable controls the size (in number of strings remembered) of the string
1435 # history buffer per category. The buffer is cleared each time the variable is
1436 # set. 
1437
1438
1439
1440 # 3.102. history_file
1441
1442 # Type: path
1443 # Default: “~/.mutthistory”
1444
1445 # The file in which Mutt will save its history.
1446
1447 # Also see $save_history.
1448
1449 set history_file="~/.var/mutt/history"
1450
1451
1452 # 3.103. history_remove_dups
1453
1454 # Type: boolean
1455 # Default: no
1456
1457 # When set, all of the string history will be scanned for duplicates when a new
1458 # entry is added. Duplicate entries in the $history_file will also be removed
1459 # when it is periodically compacted.
1460
1461
1462
1463 # 3.104. honor_disposition
1464
1465 # Type: boolean
1466 # Default: no
1467
1468 # When set, Mutt will not display attachments with a disposition of “attachment”
1469 # inline even if it could render the part to plain text. These MIME parts can
1470 # only be viewed from the attachment menu.
1471
1472 # If unset, Mutt will render all MIME parts it can properly transform to plain
1473 # text. 
1474
1475
1476
1477 # 3.105. honor_followup_to
1478
1479 # Type: quadoption
1480 # Default: yes
1481
1482 # This variable controls whether or not a Mail-Followup-To header is honored when
1483 # group-replying to a message.
1484
1485
1486
1487 # 3.106. hostname
1488
1489 # Type: string
1490 # Default: (empty)
1491
1492 # Specifies the fully-qualified hostname of the system mutt is running on
1493 # containing the host's name and the DNS domain it belongs to. It is used as the
1494 # domain part (after “@”) for local email addresses as well as Message-Id
1495 # headers. 
1496
1497 # Its value is determined at startup as follows: the node's hostname is first
1498 # determined by the uname(3) function. The domain is then looked up using the
1499 # gethostname(2) and getaddrinfo(3) functions. If those calls are unable to
1500 # determine the domain, the full value returned by uname is used. Optionally,
1501 # Mutt can be compiled with a fixed domain name in which case a detected one is
1502 # not used.
1503
1504 # Also see $use_domain and $hidden_host.
1505
1506
1507
1508 # 3.107. idn_decode
1509
1510 # Type: boolean
1511 # Default: yes
1512
1513 # When set, Mutt will show you international domain names decoded. Note: You can
1514 # use IDNs for addresses even if this is unset. This variable only affects
1515 # decoding. (IDN only)
1516
1517
1518
1519 # 3.108. idn_encode
1520
1521 # Type: boolean
1522 # Default: yes
1523
1524 # When set, Mutt will encode international domain names using IDN. Unset this if
1525 # your SMTP server can handle newer (RFC 6531) UTF-8 encoded domains. (IDN only)
1526
1527
1528
1529 # 3.109. ignore_linear_white_space
1530
1531 # Type: boolean
1532 # Default: no
1533
1534 # This option replaces linear-white-space between encoded-word and text to a
1535 # single space to prevent the display of MIME-encoded “Subject:” field from being
1536 # divided into multiple lines.
1537
1538
1539
1540 # 3.110. ignore_list_reply_to
1541
1542 # Type: boolean
1543 # Default: no
1544
1545 # Affects the behavior of the <reply> function when replying to messages from
1546 # mailing lists (as defined by the “subscribe” or “lists” commands). When set, if
1547 # the “Reply-To:” field is set to the same value as the “To:” field, Mutt assumes
1548 # that the “Reply-To:” field was set by the mailing list to automate responses to
1549 # the list, and will ignore this field. To direct a response to the mailing list
1550 # when this option is set, use the <list-reply> function; <group-reply> will
1551 # reply to both the sender and the list.
1552
1553 set ignore_list_reply_to=yes
1554
1555
1556 # 3.111. imap_authenticators
1557
1558 # Type: string
1559 # Default: (empty)
1560
1561 # This is a colon-delimited list of authentication methods mutt may attempt to
1562 # use to log in to an IMAP server, in the order mutt should try them.
1563 # Authentication methods are either “login” or the right side of an IMAP “AUTH=
1564 # xxx” capability string, e.g. “digest-md5”, “gssapi” or “cram-md5”. This option
1565 # is case-insensitive. If it's unset (the default) mutt will try all available
1566 # methods, in order from most-secure to least-secure.
1567
1568 # Example: 
1569
1570 # set imap_authenticators="gssapi:cram-md5:login"
1571
1572 # Note: Mutt will only fall back to other authentication methods if the previous
1573 # methods are unavailable. If a method is available but authentication fails,
1574 # mutt will not connect to the IMAP server.
1575
1576
1577
1578 # 3.112. imap_check_subscribed
1579
1580 # Type: boolean
1581 # Default: no
1582
1583 # When set, mutt will fetch the set of subscribed folders from your server on
1584 # connection, and add them to the set of mailboxes it polls for new mail just as
1585 # if you had issued individual “mailboxes” commands.
1586
1587
1588
1589 # 3.113. imap_delim_chars
1590
1591 # Type: string
1592 # Default: “/.”
1593
1594 # This contains the list of characters which you would like to treat as folder
1595 # separators for displaying IMAP paths. In particular it helps in using the “=”
1596 # shortcut for your folder variable.
1597
1598
1599
1600 # 3.114. imap_headers
1601
1602 # Type: string
1603 # Default: (empty)
1604
1605 # Mutt requests these header fields in addition to the default headers (“Date:”,
1606 # “From:”, “Subject:”, “To:”, “Cc:”, “Message-Id:”, “References:”, “Content-Type:
1607 # ”, “Content-Description:”, “In-Reply-To:”, “Reply-To:”, “Lines:”, “List-Post:”,
1608 # “X-Label:”) from IMAP servers before displaying the index menu. You may want to
1609 # add more headers for spam detection.
1610
1611 # Note: This is a space separated list, items should be uppercase and not contain
1612 # the colon, e.g. “X-BOGOSITY X-SPAM-STATUS” for the “X-Bogosity:” and “
1613 # X-Spam-Status:” header fields.
1614
1615
1616
1617 # 3.115. imap_idle
1618
1619 # Type: boolean
1620 # Default: no
1621
1622 # When set, mutt will attempt to use the IMAP IDLE extension to check for new
1623 # mail in the current mailbox. Some servers (dovecot was the inspiration for this
1624 # option) react badly to mutt's implementation. If your connection seems to
1625 # freeze up periodically, try unsetting this.
1626
1627
1628
1629 # 3.116. imap_keepalive
1630
1631 # Type: number
1632 # Default: 300
1633
1634 # This variable specifies the maximum amount of time in seconds that mutt will
1635 # wait before polling open IMAP connections, to prevent the server from closing
1636 # them before mutt has finished with them. The default is well within the
1637 # RFC-specified minimum amount of time (30 minutes) before a server is allowed to
1638 # do this, but in practice the RFC does get violated every now and then. Reduce
1639 # this number if you find yourself getting disconnected from your IMAP server due
1640 # to inactivity.
1641
1642
1643
1644 # 3.117. imap_list_subscribed
1645
1646 # Type: boolean
1647 # Default: no
1648
1649 # This variable configures whether IMAP folder browsing will look for only
1650 # subscribed folders or all folders. This can be toggled in the IMAP browser with
1651 # the <toggle-subscribed> function.
1652
1653
1654
1655 # 3.118. imap_login
1656
1657 # Type: string
1658 # Default: (empty)
1659
1660 # Your login name on the IMAP server.
1661
1662 # This variable defaults to the value of $imap_user.
1663
1664
1665
1666 # 3.119. imap_oauth_refresh_command
1667
1668 # Type: string
1669 # Default: (empty)
1670
1671 # The command to run to generate an OAUTH refresh token for authorizing your
1672 # connection to your IMAP server. This command will be run on every connection
1673 # attempt that uses the OAUTHBEARER authentication mechanism.
1674
1675
1676
1677 # 3.120. imap_pass
1678
1679 # Type: string
1680 # Default: (empty)
1681
1682 # Specifies the password for your IMAP account. If unset, Mutt will prompt you
1683 # for your password when you invoke the <imap-fetch-mail> function or try to open
1684 # an IMAP folder.
1685
1686 # Warning: you should only use this option when you are on a fairly secure
1687 # machine, because the superuser can read your muttrc even if you are the only
1688 # one who can read the file.
1689
1690
1691
1692 # 3.121. imap_passive
1693
1694 # Type: boolean
1695 # Default: yes
1696
1697 # When set, mutt will not open new IMAP connections to check for new mail. Mutt
1698 # will only check for new mail over existing IMAP connections. This is useful if
1699 # you don't want to be prompted to user/password pairs on mutt invocation, or if
1700 # opening the connection is slow.
1701
1702
1703
1704 # 3.122. imap_peek
1705
1706 # Type: boolean
1707 # Default: yes
1708
1709 # When set, mutt will avoid implicitly marking your mail as read whenever you
1710 # fetch a message from the server. This is generally a good thing, but can make
1711 # closing an IMAP folder somewhat slower. This option exists to appease speed
1712 # freaks. 
1713
1714
1715
1716 # 3.123. imap_pipeline_depth
1717
1718 # Type: number
1719 # Default: 15
1720
1721 # Controls the number of IMAP commands that may be queued up before they are sent
1722 # to the server. A deeper pipeline reduces the amount of time mutt must wait for
1723 # the server, and can make IMAP servers feel much more responsive. But not all
1724 # servers correctly handle pipelined commands, so if you have problems you might
1725 # want to try setting this variable to 0.
1726
1727 # Note: Changes to this variable have no effect on open connections.
1728
1729
1730
1731 # 3.124. imap_poll_timeout
1732
1733 # Type: number
1734 # Default: 15
1735
1736 # This variable specifies the maximum amount of time in seconds that mutt will
1737 # wait for a response when polling IMAP connections for new mail, before timing
1738 # out and closing the connection. Set to 0 to disable timing out.
1739
1740
1741
1742 # 3.125. imap_servernoise
1743
1744 # Type: boolean
1745 # Default: yes
1746
1747 # When set, mutt will display warning messages from the IMAP server as error
1748 # messages. Since these messages are often harmless, or generated due to
1749 # configuration problems on the server which are out of the users' hands, you may
1750 # wish to suppress them at some point.
1751
1752
1753
1754 # 3.126. imap_user
1755
1756 # Type: string
1757 # Default: (empty)
1758
1759 # The name of the user whose mail you intend to access on the IMAP server.
1760
1761 # This variable defaults to your user name on the local machine.
1762
1763
1764
1765 # 3.127. implicit_autoview
1766
1767 # Type: boolean
1768 # Default: no
1769
1770 # If set to “yes”, mutt will look for a mailcap entry with the “copiousoutput”
1771 # flag set for every MIME attachment it doesn't have an internal viewer defined
1772 # for. If such an entry is found, mutt will use the viewer defined in that entry
1773 # to convert the body part to text form.
1774
1775 set implicit_autoview=no
1776
1777
1778 # 3.128. include
1779
1780 # Type: quadoption
1781 # Default: ask-yes
1782
1783 # Controls whether or not a copy of the message(s) you are replying to is
1784 # included in your reply.
1785
1786 set include=yes
1787
1788
1789 # 3.129. include_onlyfirst
1790
1791 # Type: boolean
1792 # Default: no
1793
1794 # Controls whether or not Mutt includes only the first attachment of the message
1795 # you are replying.
1796
1797
1798
1799 # 3.130. indent_string
1800
1801 # Type: string
1802 # Default: “> ”
1803
1804 # Specifies the string to prepend to each line of text quoted in a message to
1805 # which you are replying. You are strongly encouraged not to change this value,
1806 # as it tends to agitate the more fanatical netizens.
1807
1808 # The value of this option is ignored if $text_flowed is set, because the quoting
1809 # mechanism is strictly defined for format=flowed.
1810
1811 # This option is a format string, please see the description of $index_format for
1812 # supported printf(3)-style sequences.
1813
1814
1815
1816 # 3.131. index_format
1817
1818 # Type: string
1819 # Default: “%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s”
1820
1821 # This variable allows you to customize the message index display to your
1822 # personal taste.
1823
1824 # “Format strings” are similar to the strings used in the C function printf(3) to
1825 # format output (see the man page for more details). For an explanation of the %?
1826 # construct, see the $status_format description. The following sequences are
1827 # defined in Mutt:
1828
1829 # ┌─────┬───────────────────────────────────────────────────────────────────────┐ 
1830 # │%a │address of the author                                                  │
1831 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1832 # │%A │reply-to address (if present; otherwise: address of author)            │
1833 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1834 # │%b │filename of the original message folder (think mailbox)                │
1835 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1836 # │%B │the list to which the letter was sent, or else the folder name (%b).   │
1837 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1838 # │%c │number of characters (bytes) in the message                            │
1839 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1840 # │%C │current message number                                                 │
1841 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1842 # │%d │date and time of the message in the format specified by $date_format   │
1843 # │ │converted to sender's time zone                                        │
1844 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1845 # │%D │date and time of the message in the format specified by $date_format   │
1846 # │ │converted to the local time zone                                       │
1847 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1848 # │%e │current message number in thread                                       │
1849 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1850 # │%E │number of messages in current thread                                   │
1851 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1852 # │%f │sender (address + real name), either From: or Return-Path:             │
1853 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1854 # │%F │author name, or recipient name if the message is from you              │
1855 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1856 # │%H │spam attribute(s) of this message                                      │
1857 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1858 # │%i │message-id of the current message                                      │
1859 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1860 # │%l │number of lines in the message (does not work with maildir, mh, and    │
1861 # │ │possibly IMAP folders)                                                 │
1862 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1863 # │ │If an address in the “To:” or “Cc:” header field matches an address    │
1864 # │%L │defined by the users “subscribe” command, this displays "To <list-name>│
1865 # │ │", otherwise the same as %F.                                           │
1866 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1867 # │%m │total number of message in the mailbox                                 │
1868 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1869 # │%M │number of hidden messages if the thread is collapsed.                  │
1870 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1871 # │%N │message score                                                          │
1872 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1873 # │%n │author's real name (or address if missing)                             │
1874 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1875 # │%O │original save folder where mutt would formerly have stashed the        │
1876 # │ │message: list name or recipient name if not sent to a list             │
1877 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1878 # │%P │progress indicator for the built-in pager (how much of the file has    │
1879 # │ │been displayed)                                                        │
1880 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1881 # │%r │comma separated list of “To:” recipients                               │
1882 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1883 # │%R │comma separated list of “Cc:” recipients                               │
1884 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1885 # │%s │subject of the message                                                 │
1886 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1887 # │%S │single character status of the message (“N”/“O”/“D”/“d”/“!”/“r”/“*”)   │
1888 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1889 # │%t │“To:” field (recipients)                                               │
1890 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1891 # │%T │the appropriate character from the $to_chars string                    │
1892 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1893 # │%u │user (login) name of the author                                        │
1894 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1895 # │%v │first name of the author, or the recipient if the message is from you  │
1896 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1897 # │%X │number of attachments (please see the “attachments” section for        │
1898 # │ │possible speed effects)                                                │
1899 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1900 # │%y │“X-Label:” field, if present                                           │
1901 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1902 # │ │“X-Label:” field, if present, and (1) not at part of a thread tree, (2)│
1903 # │%Y │at the top of a thread, or (3) “X-Label:” is different from preceding  │
1904 # │ │message's “X-Label:”.                                                  │
1905 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1906 # │ │a three character set of message status flags. the first character is  │
1907 # │%Z │new/read/replied flags (“n”/“o”/“r”/“O”/“N”). the second is deleted or │
1908 # │ │encryption flags (“D”/“d”/“S”/“P”/“s”/“K”). the third is either tagged/│
1909 # │ │flagged (“*”/“!”), or one of the characters listed in $to_chars.       │
1910 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1911 # │% │the date and time of the message is converted to sender's time zone,   │
1912 # │{fmt}│and “fmt” is expanded by the library function strftime(3); a leading   │
1913 # │ │bang disables locales                                                  │
1914 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1915 # │% │the date and time of the message is converted to the local time zone,  │
1916 # │[fmt]│and “fmt” is expanded by the library function strftime(3); a leading   │
1917 # │ │bang disables locales                                                  │
1918 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1919 # │% │the local date and time when the message was received. “fmt” is        │
1920 # │(fmt)│expanded by the library function strftime(3); a leading bang disables  │
1921 # │ │locales                                                                │
1922 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1923 # │% │the current local time. “fmt” is expanded by the library function      │
1924 # │<fmt>│strftime(3); a leading bang disables locales.                          │
1925 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1926 # │%>X │right justify the rest of the string and pad with character “X”        │
1927 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1928 # │%|X │pad to the end of the line with character “X”                          │
1929 # ├─────┼───────────────────────────────────────────────────────────────────────┤ 
1930 # │%*X │soft-fill with character “X” as pad                                    │
1931 # └─────┴───────────────────────────────────────────────────────────────────────┘ 
1932
1933 # “Soft-fill” deserves some explanation: Normal right-justification will print
1934 # everything to the left of the “%>”, displaying padding and whatever lies to the
1935 # right only if there's room. By contrast, soft-fill gives priority to the
1936 # right-hand side, guaranteeing space to display it and showing padding only if
1937 # there's still room. If necessary, soft-fill will eat text leftwards to make
1938 # room for rightward text.
1939
1940 # Note that these expandos are supported in “save-hook”, “fcc-hook” and “
1941 # fcc-save-hook”, too.
1942
1943
1944
1945 # 3.132. ispell
1946
1947 # Type: path
1948 # Default: “ispell”
1949
1950 # How to invoke ispell (GNU's spell-checking software).
1951
1952
1953
1954 # 3.133. keep_flagged
1955
1956 # Type: boolean
1957 # Default: no
1958
1959 # If set, read messages marked as flagged will not be moved from your spool
1960 # mailbox to your $mbox mailbox, or as a result of a “mbox-hook” command.
1961
1962
1963
1964 # 3.134. mail_check
1965
1966 # Type: number
1967 # Default: 5
1968
1969 # This variable configures how often (in seconds) mutt should look for new mail.
1970 # Also see the $timeout variable.
1971
1972
1973
1974 # 3.135. mail_check_recent
1975
1976 # Type: boolean
1977 # Default: yes
1978
1979 # When set, Mutt will only notify you about new mail that has been received since
1980 # the last time you opened the mailbox. When unset, Mutt will notify you if any
1981 # new mail exists in the mailbox, regardless of whether you have visited it
1982 # recently. 
1983
1984 # When $mark_old is set, Mutt does not consider the mailbox to contain new mail
1985 # if only old messages exist.
1986
1987
1988
1989 # 3.136. mail_check_stats
1990
1991 # Type: boolean
1992 # Default: no
1993
1994 # When set, mutt will periodically calculate message statistics of a mailbox
1995 # while polling for new mail. It will check for unread, flagged, and total
1996 # message counts. Because this operation is more performance intensive, it
1997 # defaults to unset, and has a separate option, $mail_check_stats_interval, to
1998 # control how often to update these counts.
1999
2000 set mail_check_stats=yes
2001
2002
2003 # 3.137. mail_check_stats_interval
2004
2005 # Type: number
2006 # Default: 60
2007
2008 # When $mail_check_stats is set, this variable configures how often (in seconds)
2009 # mutt will update message counts.
2010
2011
2012
2013 # 3.138. mailcap_path
2014
2015 # Type: string
2016 # Default: (empty)
2017
2018 # This variable specifies which files to consult when attempting to display MIME
2019 # bodies not directly supported by Mutt.
2020
2021 set mailcap_path="$my_confdir/mailcap.icalendar:$my_confdir/mailcap.backgrounding:$my_confdir/mailcap.htmldump"
2022
2023
2024 # 3.139. mailcap_sanitize
2025
2026 # Type: boolean
2027 # Default: yes
2028
2029 # If set, mutt will restrict possible characters in mailcap % expandos to a
2030 # well-defined set of safe characters. This is the safe setting, but we are not
2031 # sure it doesn't break some more advanced MIME stuff.
2032
2033 # DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE DOING!
2034
2035
2036
2037 # 3.140. maildir_header_cache_verify
2038
2039 # Type: boolean
2040 # Default: yes
2041
2042 # Check for Maildir unaware programs other than mutt having modified maildir
2043 # files when the header cache is in use. This incurs one stat(2) per message
2044 # every time the folder is opened (which can be very slow for NFS folders).
2045
2046 set maildir_header_cache_verify=no
2047
2048
2049 # 3.141. maildir_trash
2050
2051 # Type: boolean
2052 # Default: no
2053
2054 # If set, messages marked as deleted will be saved with the maildir trashed flag
2055 # instead of unlinked. Note: this only applies to maildir-style mailboxes.
2056 # Setting it will have no effect on other mailbox types.
2057
2058
2059
2060 # 3.142. maildir_check_cur
2061
2062 # Type: boolean
2063 # Default: no
2064
2065 # If set, mutt will poll both the new and cur directories of a maildir folder for
2066 # new messages. This might be useful if other programs interacting with the
2067 # folder (e.g. dovecot) are moving new messages to the cur directory. Note that
2068 # setting this option may slow down polling for new messages in large folders,
2069 # since mutt has to scan all cur messages.
2070
2071
2072
2073 # 3.143. mark_macro_prefix
2074
2075 # Type: string
2076 # Default: “'”
2077
2078 # Prefix for macros created using mark-message. A new macro automatically
2079 # generated with <mark-message>a will be composed from this prefix and the letter
2080 # a. 
2081
2082
2083
2084 # 3.144. mark_old
2085
2086 # Type: boolean
2087 # Default: yes
2088
2089 # Controls whether or not mutt marks new unread messages as old if you exit a
2090 # mailbox without reading them. With this option set, the next time you start
2091 # mutt, the messages will show up with an “O” next to them in the index menu,
2092 # indicating that they are old.
2093
2094 set mark_old=no
2095
2096
2097 # 3.145. markers
2098
2099 # Type: boolean
2100 # Default: yes
2101
2102 # Controls the display of wrapped lines in the internal pager. If set, a “+”
2103 # marker is displayed at the beginning of wrapped lines.
2104
2105 # Also see the $smart_wrap variable.
2106
2107 set markers=no
2108
2109
2110 # 3.146. mask
2111
2112 # Type: regular expression
2113 # Default: “!^.[^.]”
2114
2115 # A regular expression used in the file browser, optionally preceded by the not
2116 # operator “!”. Only files whose names match this mask will be shown. The match
2117 # is always case-sensitive.
2118
2119
2120
2121 # 3.147. mbox
2122
2123 # Type: path
2124 # Default: “~/mbox”
2125
2126 # This specifies the folder into which read mail in your $spoolfile folder will
2127 # be appended.
2128
2129 # Also see the $move variable.
2130
2131
2132
2133 # 3.148. mbox_type
2134
2135 # Type: folder magic
2136 # Default: mbox
2137
2138 # The default mailbox type used when creating new folders. May be any of “mbox”,
2139 # “MMDF”, “MH” and “Maildir”. This is overridden by the -m command-line option.
2140
2141 set mbox_type=Maildir
2142
2143
2144 # 3.149. menu_context
2145
2146 # Type: number
2147 # Default: 0
2148
2149 # This variable controls the number of lines of context that are given when
2150 # scrolling through menus. (Similar to $pager_context.)
2151
2152 set menu_context=2
2153
2154
2155 # 3.150. menu_move_off
2156
2157 # Type: boolean
2158 # Default: yes
2159
2160 # When unset, the bottom entry of menus will never scroll up past the bottom of
2161 # the screen, unless there are less entries than lines. When set, the bottom
2162 # entry may move off the bottom.
2163
2164
2165
2166 # 3.151. menu_scroll
2167
2168 # Type: boolean
2169 # Default: no
2170
2171 # When set, menus will be scrolled up or down one line when you attempt to move
2172 # across a screen boundary. If unset, the screen is cleared and the next or
2173 # previous page of the menu is displayed (useful for slow links to avoid many
2174 # redraws). 
2175
2176 set menu_scroll=yes
2177
2178
2179 # 3.152. message_cache_clean
2180
2181 # Type: boolean
2182 # Default: no
2183
2184 # If set, mutt will clean out obsolete entries from the message cache when the
2185 # mailbox is synchronized. You probably only want to set it every once in a
2186 # while, since it can be a little slow (especially for large folders).
2187
2188
2189
2190 # 3.153. message_cachedir
2191
2192 # Type: path
2193 # Default: (empty)
2194
2195 # Set this to a directory and mutt will cache copies of messages from your IMAP
2196 # and POP servers here. You are free to remove entries at any time.
2197
2198 # When setting this variable to a directory, mutt needs to fetch every remote
2199 # message only once and can perform regular expression searches as fast as for
2200 # local folders.
2201
2202 # Also see the $message_cache_clean variable.
2203
2204
2205
2206 # 3.154. message_format
2207
2208 # Type: string
2209 # Default: “%s”
2210
2211 # This is the string displayed in the “attachment” menu for attachments of type
2212 # message/rfc822. For a full listing of defined printf(3)-like sequences see the
2213 # section on $index_format.
2214
2215
2216
2217 # 3.155. meta_key
2218
2219 # Type: boolean
2220 # Default: no
2221
2222 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8) set as if
2223 # the user had pressed the Esc key and whatever key remains after having the high
2224 # bit removed. For example, if the key pressed has an ASCII value of 0xf8, then
2225 # this is treated as if the user had pressed Esc then “x”. This is because the
2226 # result of removing the high bit from 0xf8 is 0x78, which is the ASCII character
2227 # “x”. 
2228
2229
2230
2231 # 3.156. metoo
2232
2233 # Type: boolean
2234 # Default: no
2235
2236 # If unset, Mutt will remove your address (see the “alternates” command) from the
2237 # list of recipients when replying to a message.
2238
2239
2240
2241 # 3.157. mh_purge
2242
2243 # Type: boolean
2244 # Default: no
2245
2246 # When unset, mutt will mimic mh's behavior and rename deleted messages to ,<old
2247 # file name> in mh folders instead of really deleting them. This leaves the
2248 # message on disk but makes programs reading the folder ignore it. If the
2249 # variable is set, the message files will simply be deleted.
2250
2251 # This option is similar to $maildir_trash for Maildir folders.
2252
2253
2254
2255 # 3.158. mh_seq_flagged
2256
2257 # Type: string
2258 # Default: “flagged”
2259
2260 # The name of the MH sequence used for flagged messages.
2261
2262
2263
2264 # 3.159. mh_seq_replied
2265
2266 # Type: string
2267 # Default: “replied”
2268
2269 # The name of the MH sequence used to tag replied messages.
2270
2271
2272
2273 # 3.160. mh_seq_unseen
2274
2275 # Type: string
2276 # Default: “unseen”
2277
2278 # The name of the MH sequence used for unseen messages.
2279
2280
2281
2282 # 3.161. mime_forward
2283
2284 # Type: quadoption
2285 # Default: no
2286
2287 # When set, the message you are forwarding will be attached as a separate message
2288 # /rfc822 MIME part instead of included in the main body of the message. This is
2289 # useful for forwarding MIME messages so the receiver can properly view the
2290 # message as it was delivered to you. If you like to switch between MIME and not
2291 # MIME from mail to mail, set this variable to “ask-no” or “ask-yes”.
2292
2293 # Also see $forward_decode and $mime_forward_decode.
2294
2295 set mime_forward=ask-yes
2296
2297
2298 # 3.162. mime_forward_decode
2299
2300 # Type: boolean
2301 # Default: no
2302
2303 # Controls the decoding of complex MIME messages into text/plain when forwarding
2304 # a message while $mime_forward is set. Otherwise $forward_decode is used
2305 # instead. 
2306
2307
2308
2309 # 3.163. mime_forward_rest
2310
2311 # Type: quadoption
2312 # Default: yes
2313
2314 # When forwarding multiple attachments of a MIME message from the attachment
2315 # menu, attachments which cannot be decoded in a reasonable manner will be
2316 # attached to the newly composed message if this option is set.
2317
2318
2319
2320 # 3.164. mime_type_query_command
2321
2322 # Type: string
2323 # Default: (empty)
2324
2325 # This specifies a command to run, to determine the mime type of a new attachment
2326 # when composing a message. Unless $mime_type_query_first is set, this will only
2327 # be run if the attachment's extension is not found in the mime.types file.
2328
2329 # The string may contain a “%s”, which will be substituted with the attachment
2330 # filename. Mutt will add quotes around the string substituted for “%s”
2331 # automatically according to shell quoting rules, so you should avoid adding your
2332 # own. If no “%s” is found in the string, Mutt will append the attachment
2333 # filename to the end of the string.
2334
2335 # The command should output a single line containing the attachment's mime type.
2336
2337 # Suggested values are “xdg-mime query filetype” or “file -bi”.
2338
2339
2340
2341 # 3.165. mime_type_query_first
2342
2343 # Type: boolean
2344 # Default: no
2345
2346 # When set, the $mime_type_query_command will be run before the mime.types
2347 # lookup. 
2348
2349
2350
2351 # 3.166. mix_entry_format
2352
2353 # Type: string
2354 # Default: “%4n %c %-16s %a”
2355
2356 # This variable describes the format of a remailer line on the mixmaster chain
2357 # selection screen. The following printf(3)-like sequences are supported:
2358
2359 # ┌──┬───────────────────────────────┐ 
2360 # │%n│The running number on the menu.│
2361 # ├──┼───────────────────────────────┤ 
2362 # │%c│Remailer capabilities.         │
2363 # ├──┼───────────────────────────────┤ 
2364 # │%s│The remailer's short name.     │
2365 # ├──┼───────────────────────────────┤ 
2366 # │%a│The remailer's e-mail address. │
2367 # └──┴───────────────────────────────┘ 
2368
2369
2370
2371 # 3.167. mixmaster
2372
2373 # Type: path
2374 # Default: “mixmaster”
2375
2376 # This variable contains the path to the Mixmaster binary on your system. It is
2377 # used with various sets of parameters to gather the list of known remailers, and
2378 # to finally send a message through the mixmaster chain.
2379
2380 set mixmaster="mixmaster-filter"
2381
2382
2383 # 3.168. move
2384
2385 # Type: quadoption
2386 # Default: no
2387
2388 # Controls whether or not Mutt will move read messages from your spool mailbox to
2389 # your $mbox mailbox, or as a result of a “mbox-hook” command.
2390
2391 set move=no
2392
2393
2394 # 3.169. narrow_tree
2395
2396 # Type: boolean
2397 # Default: no
2398
2399 # This variable, when set, makes the thread tree narrower, allowing deeper
2400 # threads to fit on the screen.
2401
2402 set narrow_tree=yes
2403
2404
2405 # 3.170. net_inc
2406
2407 # Type: number
2408 # Default: 10
2409
2410 # Operations that expect to transfer a large amount of data over the network will
2411 # update their progress every $net_inc kilobytes. If set to 0, no progress
2412 # messages will be displayed.
2413
2414 # See also $read_inc, $write_inc and $net_inc.
2415
2416
2417
2418 # 3.171. new_mail_command
2419
2420 # Type: path
2421 # Default: (empty)
2422
2423 # If set, Mutt will call this command after a new message is received. See the
2424 # $status_format documentation for the values that can be formatted into this
2425 # command. 
2426
2427
2428
2429 # 3.172. pager
2430
2431 # Type: path
2432 # Default: “builtin”
2433
2434 # This variable specifies which pager you would like to use to view messages. The
2435 # value “builtin” means to use the built-in pager, otherwise this variable should
2436 # specify the pathname of the external pager you would like to use.
2437
2438 # Using an external pager may have some disadvantages: Additional keystrokes are
2439 # necessary because you can't call mutt functions directly from the pager, and
2440 # screen resizes cause lines longer than the screen width to be badly formatted
2441 # in the help menu.
2442
2443
2444
2445 # 3.173. pager_context
2446
2447 # Type: number
2448 # Default: 0
2449
2450 # This variable controls the number of lines of context that are given when
2451 # displaying the next or previous page in the internal pager. By default, Mutt
2452 # will display the line after the last one on the screen at the top of the next
2453 # page (0 lines of context).
2454
2455 # This variable also specifies the amount of context given for search results. If
2456 # positive, this many lines will be given before a match, if 0, the match will be
2457 # top-aligned. 
2458
2459 set pager_context=2
2460
2461
2462 # 3.174. pager_format
2463
2464 # Type: string
2465 # Default: “-%Z- %C/%m: %-20.20n   %s%*  -- (%P)”
2466
2467 # This variable controls the format of the one-line message “status” displayed
2468 # before each message in either the internal or an external pager. The valid
2469 # sequences are listed in the $index_format section.
2470
2471 set pager_format="<%a> %*  %i (%P)"
2472
2473
2474 # 3.175. pager_index_lines
2475
2476 # Type: number
2477 # Default: 0
2478
2479 # Determines the number of lines of a mini-index which is shown when in the
2480 # pager. The current message, unless near the top or bottom of the folder, will
2481 # be roughly one third of the way down this mini-index, giving the reader the
2482 # context of a few messages before and after the message. This is useful, for
2483 # example, to determine how many messages remain to be read in the current
2484 # thread. One of the lines is reserved for the status bar from the index, so a
2485 # setting of 6 will only show 5 lines of the actual index. A value of 0 results
2486 # in no index being shown. If the number of messages in the current folder is
2487 # less than $pager_index_lines, then the index will only use as many lines as it
2488 # needs. 
2489
2490 set pager_index_lines=5
2491
2492
2493 # 3.176. pager_stop
2494
2495 # Type: boolean
2496 # Default: no
2497
2498 # When set, the internal-pager will not move to the next message when you are at
2499 # the end of a message and invoke the <next-page> function.
2500
2501 set pager_stop=yes
2502
2503
2504 # 3.177. pgp_auto_decode
2505
2506 # Type: boolean
2507 # Default: no
2508
2509 # If set, mutt will automatically attempt to decrypt traditional PGP messages
2510 # whenever the user performs an operation which ordinarily would result in the
2511 # contents of the message being operated on. For example, if the user displays a
2512 # pgp-traditional message which has not been manually checked with the
2513 # <check-traditional-pgp> function, mutt will automatically check the message for
2514 # traditional pgp.
2515
2516 set pgp_auto_decode=yes
2517
2518
2519 # 3.178. pgp_autoinline
2520
2521 # Type: boolean
2522 # Default: no
2523
2524 # This option controls whether Mutt generates old-style inline (traditional) PGP
2525 # encrypted or signed messages under certain circumstances. This can be
2526 # overridden by use of the pgp menu, when inline is not required. The GPGME
2527 # backend does not support this option.
2528
2529 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2530 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2531 # MIME messages when inline (traditional) would not work.
2532
2533 # Also see the $pgp_mime_auto variable.
2534
2535 # Also note that using the old-style PGP message format is strongly deprecated.
2536 # (PGP only)
2537
2538
2539
2540 # 3.179. pgp_check_exit
2541
2542 # Type: boolean
2543 # Default: yes
2544
2545 # If set, mutt will check the exit code of the PGP subprocess when signing or
2546 # encrypting. A non-zero exit code means that the subprocess failed. (PGP only)
2547
2548
2549
2550 # 3.180. pgp_check_gpg_decrypt_status_fd
2551
2552 # Type: boolean
2553 # Default: yes
2554
2555 # If set, mutt will check the status file descriptor output of
2556 # $pgp_decrypt_command and $pgp_decode_command for GnuPG status codes indicating
2557 # successful decryption. This will check for the presence of DECRYPTION_OKAY,
2558 # absence of DECRYPTION_FAILED, and that all PLAINTEXT occurs between the
2559 # BEGIN_DECRYPTION and END_DECRYPTION status codes.
2560
2561 # If unset, mutt will instead match the status fd output against
2562 # $pgp_decryption_okay. (PGP only)
2563
2564
2565
2566 # 3.181. pgp_clearsign_command
2567
2568 # Type: string
2569 # Default: (empty)
2570
2571 # This format is used to create an old-style “clearsigned” PGP message. Note that
2572 # the use of this format is strongly deprecated.
2573
2574 # This is a format string, see the $pgp_decode_command command for possible
2575 # printf(3)-like sequences. (PGP only)
2576
2577
2578
2579 # 3.182. pgp_decode_command
2580
2581 # Type: string
2582 # Default: (empty)
2583
2584 # This format strings specifies a command which is used to decode application/pgp
2585 # attachments. 
2586
2587 # The PGP command formats have their own set of printf(3)-like sequences:
2588
2589 # ┌──┬──────────────────────────────────────────────────────────────────────────┐ 
2590 # │%p│Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty string   │
2591 # │ │otherwise. Note: This may be used with a %? construct.                    │
2592 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
2593 # │%f│Expands to the name of a file containing a message.                       │
2594 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
2595 # │%s│Expands to the name of a file containing the signature part of a multipart│
2596 # │ │/signed attachment when verifying it.                                     │
2597 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
2598 # │%a│The value of $pgp_sign_as if set, otherwise the value of $pgp_default_key.│
2599 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
2600 # │%r│One or more key IDs (or fingerprints if available).                       │
2601 # └──┴──────────────────────────────────────────────────────────────────────────┘ 
2602
2603 # For examples on how to configure these formats for the various versions of PGP
2604 # which are floating around, see the pgp and gpg sample configuration files in
2605 # the samples/ subdirectory which has been installed on your system alongside the
2606 # documentation. (PGP only)
2607
2608
2609
2610 # 3.183. pgp_decrypt_command
2611
2612 # Type: string
2613 # Default: (empty)
2614
2615 # This command is used to decrypt a PGP encrypted message.
2616
2617 # This is a format string, see the $pgp_decode_command command for possible
2618 # printf(3)-like sequences. (PGP only)
2619
2620
2621
2622 # 3.184. pgp_decryption_okay
2623
2624 # Type: regular expression
2625 # Default: (empty)
2626
2627 # If you assign text to this variable, then an encrypted PGP message is only
2628 # considered successfully decrypted if the output from $pgp_decrypt_command
2629 # contains the text. This is used to protect against a spoofed encrypted message,
2630 # with multipart/encrypted headers but containing a block that is not actually
2631 # encrypted. (e.g. simply signed and ascii armored text).
2632
2633 # Note that if $pgp_check_gpg_decrypt_status_fd is set, this variable is ignored.
2634 # (PGP only)
2635
2636
2637
2638 # 3.185. pgp_default_key
2639
2640 # Type: string
2641 # Default: (empty)
2642
2643 # This is the default key-pair to use for PGP operations. It will be used for
2644 # encryption (see $postpone_encrypt and $pgp_self_encrypt).
2645
2646 # It will also be used for signing unless $pgp_sign_as is set.
2647
2648 # The (now deprecated) pgp_self_encrypt_as is an alias for this variable, and
2649 # should no longer be used. (PGP only)
2650
2651
2652
2653 # 3.186. pgp_encrypt_only_command
2654
2655 # Type: string
2656 # Default: (empty)
2657
2658 # This command is used to encrypt a body part without signing it.
2659
2660 # This is a format string, see the $pgp_decode_command command for possible
2661 # printf(3)-like sequences. (PGP only)
2662
2663
2664
2665 # 3.187. pgp_encrypt_sign_command
2666
2667 # Type: string
2668 # Default: (empty)
2669
2670 # This command is used to both sign and encrypt a body part.
2671
2672 # This is a format string, see the $pgp_decode_command command for possible
2673 # printf(3)-like sequences. (PGP only)
2674
2675
2676
2677 # 3.188. pgp_entry_format
2678
2679 # Type: string
2680 # Default: “%4n %t%f %4l/0x%k %-4a %2c %u”
2681
2682 # This variable allows you to customize the PGP key selection menu to your
2683 # personal taste. This string is similar to $index_format, but has its own set of
2684 # printf(3)-like sequences:
2685
2686 # ┌──────┬──────────────────────────────────────────────────────┐ 
2687 # │%n │number                                                │
2688 # ├──────┼──────────────────────────────────────────────────────┤ 
2689 # │%k │key id                                                │
2690 # ├──────┼──────────────────────────────────────────────────────┤ 
2691 # │%u │user id                                               │
2692 # ├──────┼──────────────────────────────────────────────────────┤ 
2693 # │%a │algorithm                                             │
2694 # ├──────┼──────────────────────────────────────────────────────┤ 
2695 # │%l │key length                                            │
2696 # ├──────┼──────────────────────────────────────────────────────┤ 
2697 # │%f │flags                                                 │
2698 # ├──────┼──────────────────────────────────────────────────────┤ 
2699 # │%c │capabilities                                          │
2700 # ├──────┼──────────────────────────────────────────────────────┤ 
2701 # │%t │trust/validity of the key-uid association             │
2702 # ├──────┼──────────────────────────────────────────────────────┤ 
2703 # │%[<s>]│date of the key where <s> is an strftime(3) expression│
2704 # └──────┴──────────────────────────────────────────────────────┘ 
2705
2706 # (PGP only)
2707
2708
2709
2710 # 3.189. pgp_export_command
2711
2712 # Type: string
2713 # Default: (empty)
2714
2715 # This command is used to export a public key from the user's key ring.
2716
2717 # This is a format string, see the $pgp_decode_command command for possible
2718 # printf(3)-like sequences. (PGP only)
2719
2720
2721
2722 # 3.190. pgp_getkeys_command
2723
2724 # Type: string
2725 # Default: (empty)
2726
2727 # This command is invoked whenever Mutt needs to fetch the public key associated
2728 # with an email address. Of the sequences supported by $pgp_decode_command, %r is
2729 # the only printf(3)-like sequence used with this format. Note that in this case,
2730 # %r expands to the email address, not the public key ID (the key ID is unknown,
2731 # which is why Mutt is invoking this command). (PGP only)
2732
2733
2734
2735 # 3.191. pgp_good_sign
2736
2737 # Type: regular expression
2738 # Default: (empty)
2739
2740 # If you assign a text to this variable, then a PGP signature is only considered
2741 # verified if the output from $pgp_verify_command contains the text. Use this
2742 # variable if the exit code from the command is 0 even for bad signatures. (PGP
2743 # only) 
2744
2745
2746
2747 # 3.192. pgp_ignore_subkeys
2748
2749 # Type: boolean
2750 # Default: yes
2751
2752 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead, the
2753 # principal key will inherit the subkeys' capabilities. Unset this if you want to
2754 # play interesting key selection games. (PGP only)
2755
2756
2757
2758 # 3.193. pgp_import_command
2759
2760 # Type: string
2761 # Default: (empty)
2762
2763 # This command is used to import a key from a message into the user's public key
2764 # ring. 
2765
2766 # This is a format string, see the $pgp_decode_command command for possible
2767 # printf(3)-like sequences. (PGP only)
2768
2769
2770
2771 # 3.194. pgp_list_pubring_command
2772
2773 # Type: string
2774 # Default: (empty)
2775
2776 # This command is used to list the public key ring's contents. The output format
2777 # must be analogous to the one used by
2778
2779 # gpg --list-keys --with-colons --with-fingerprint
2780
2781 # This format is also generated by the pgpring utility which comes with mutt.
2782
2783 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2784 # date format which may result in mutt showing incorrect key generation dates.
2785
2786 # This is a format string, see the $pgp_decode_command command for possible
2787 # printf(3)-like sequences. (PGP only)
2788
2789
2790
2791 # 3.195. pgp_list_secring_command
2792
2793 # Type: string
2794 # Default: (empty)
2795
2796 # This command is used to list the secret key ring's contents. The output format
2797 # must be analogous to the one used by:
2798
2799 # gpg --list-keys --with-colons --with-fingerprint
2800
2801 # This format is also generated by the pgpring utility which comes with mutt.
2802
2803 # Note: gpg's fixed-list-mode option should not be used. It produces a different
2804 # date format which may result in mutt showing incorrect key generation dates.
2805
2806 # This is a format string, see the $pgp_decode_command command for possible
2807 # printf(3)-like sequences. (PGP only)
2808
2809
2810
2811 # 3.196. pgp_long_ids
2812
2813 # Type: boolean
2814 # Default: yes
2815
2816 # If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs. NOTE:
2817 # Internally, Mutt has transitioned to using fingerprints (or long key IDs as a
2818 # fallback). This option now only controls the display of key IDs in the key
2819 # selection menu and a few other places. (PGP only)
2820
2821
2822
2823 # 3.197. pgp_mime_auto
2824
2825 # Type: quadoption
2826 # Default: ask-yes
2827
2828 # This option controls whether Mutt will prompt you for automatically sending a
2829 # (signed/encrypted) message using PGP/MIME when inline (traditional) fails (for
2830 # any reason).
2831
2832 # Also note that using the old-style PGP message format is strongly deprecated.
2833 # (PGP only)
2834
2835
2836
2837 # 3.198. pgp_replyinline
2838
2839 # Type: boolean
2840 # Default: no
2841
2842 # Setting this variable will cause Mutt to always attempt to create an inline
2843 # (traditional) message when replying to a message which is PGP encrypted/signed
2844 # inline. This can be overridden by use of the pgp menu, when inline is not
2845 # required. This option does not automatically detect if the (replied-to) message
2846 # is inline; instead it relies on Mutt internals for previously checked/flagged
2847 # messages. 
2848
2849 # Note that Mutt might automatically use PGP/MIME for messages which consist of
2850 # more than a single MIME part. Mutt can be configured to ask before sending PGP/
2851 # MIME messages when inline (traditional) would not work.
2852
2853 # Also see the $pgp_mime_auto variable.
2854
2855 # Also note that using the old-style PGP message format is strongly deprecated.
2856 # (PGP only)
2857
2858
2859
2860 # 3.199. pgp_retainable_sigs
2861
2862 # Type: boolean
2863 # Default: no
2864
2865 # If set, signed and encrypted messages will consist of nested multipart/signed
2866 # and multipart/encrypted body parts.
2867
2868 # This is useful for applications like encrypted and signed mailing lists, where
2869 # the outer layer (multipart/encrypted) can be easily removed, while the inner
2870 # multipart/signed part is retained. (PGP only)
2871
2872 set pgp_retainable_sigs=yes
2873
2874
2875 # 3.200. pgp_self_encrypt
2876
2877 # Type: boolean
2878 # Default: yes
2879
2880 # When set, PGP encrypted messages will also be encrypted using the key in
2881 # $pgp_default_key. (PGP only)
2882
2883
2884
2885 # 3.201. pgp_show_unusable
2886
2887 # Type: boolean
2888 # Default: yes
2889
2890 # If set, mutt will display non-usable keys on the PGP key selection menu. This
2891 # includes keys which have been revoked, have expired, or have been marked as “
2892 # disabled” by the user. (PGP only)
2893
2894 set pgp_show_unusable=no
2895
2896
2897 # 3.202. pgp_sign_as
2898
2899 # Type: string
2900 # Default: (empty)
2901
2902 # If you have a different key pair to use for signing, you should set this to the
2903 # signing key. Most people will only need to set $pgp_default_key. It is
2904 # recommended that you use the keyid form to specify your key (e.g. 0x00112233).
2905 # (PGP only)
2906
2907 set pgp_sign_as="0x9C9D6979AE941637"
2908
2909
2910 # 3.203. pgp_sign_command
2911
2912 # Type: string
2913 # Default: (empty)
2914
2915 # This command is used to create the detached PGP signature for a multipart/
2916 # signed PGP/MIME body part.
2917
2918 # This is a format string, see the $pgp_decode_command command for possible
2919 # printf(3)-like sequences. (PGP only)
2920
2921
2922
2923 # 3.204. pgp_sort_keys
2924
2925 # Type: sort order
2926 # Default: address
2927
2928 # Specifies how the entries in the pgp menu are sorted. The following are legal
2929 # values: 
2930
2931 # ┌───────┬──────────────────────────────┐ 
2932 # │address│sort alphabetically by user id│
2933 # ├───────┼──────────────────────────────┤ 
2934 # │keyid │sort alphabetically by key id │
2935 # ├───────┼──────────────────────────────┤ 
2936 # │date │sort by key creation date     │
2937 # ├───────┼──────────────────────────────┤ 
2938 # │trust │sort by the trust of the key  │
2939 # └───────┴──────────────────────────────┘ 
2940
2941 # If you prefer reverse order of the above values, prefix it with “reverse-”.
2942 # (PGP only)
2943
2944
2945
2946 # 3.205. pgp_strict_enc
2947
2948 # Type: boolean
2949 # Default: yes
2950
2951 # If set, Mutt will automatically encode PGP/MIME signed messages as
2952 # quoted-printable. Please note that unsetting this variable may lead to problems
2953 # with non-verifyable PGP signatures, so only change this if you know what you
2954 # are doing. (PGP only)
2955
2956
2957
2958 # 3.206. pgp_timeout
2959
2960 # Type: number
2961 # Default: 300
2962
2963 # The number of seconds after which a cached passphrase will expire if not used.
2964 # (PGP only)
2965
2966
2967
2968 # 3.207. pgp_use_gpg_agent
2969
2970 # Type: boolean
2971 # Default: no
2972
2973 # If set, mutt will use a possibly-running gpg-agent(1) process. Note that as of
2974 # version 2.1, GnuPG no longer exports GPG_AGENT_INFO, so mutt no longer verifies
2975 # if the agent is running. (PGP only)
2976
2977 set pgp_use_gpg_agent=yes
2978
2979
2980 # 3.208. pgp_verify_command
2981
2982 # Type: string
2983 # Default: (empty)
2984
2985 # This command is used to verify PGP signatures.
2986
2987 # This is a format string, see the $pgp_decode_command command for possible
2988 # printf(3)-like sequences. (PGP only)
2989
2990
2991
2992 # 3.209. pgp_verify_key_command
2993
2994 # Type: string
2995 # Default: (empty)
2996
2997 # This command is used to verify key information from the key selection menu.
2998
2999 # This is a format string, see the $pgp_decode_command command for possible
3000 # printf(3)-like sequences. (PGP only)
3001
3002
3003
3004 # 3.210. pipe_decode
3005
3006 # Type: boolean
3007 # Default: no
3008
3009 # Used in connection with the <pipe-message> command. When unset, Mutt will pipe
3010 # the messages without any preprocessing. When set, Mutt will weed headers and
3011 # will attempt to decode the messages first.
3012
3013
3014
3015 # 3.211. pipe_sep
3016
3017 # Type: string
3018 # Default: “n”
3019
3020 # The separator to add between messages when piping a list of tagged messages to
3021 # an external Unix command.
3022
3023
3024
3025 # 3.212. pipe_split
3026
3027 # Type: boolean
3028 # Default: no
3029
3030 # Used in connection with the <pipe-message> function following <tag-prefix>. If
3031 # this variable is unset, when piping a list of tagged messages Mutt will
3032 # concatenate the messages and will pipe them all concatenated. When set, Mutt
3033 # will pipe the messages one by one. In both cases the messages are piped in the
3034 # current sorted order, and the $pipe_sep separator is added after each message.
3035
3036
3037
3038 # 3.213. pop_auth_try_all
3039
3040 # Type: boolean
3041 # Default: yes
3042
3043 # If set, Mutt will try all available authentication methods. When unset, Mutt
3044 # will only fall back to other authentication methods if the previous methods are
3045 # unavailable. If a method is available but authentication fails, Mutt will not
3046 # connect to the POP server.
3047
3048
3049
3050 # 3.214. pop_authenticators
3051
3052 # Type: string
3053 # Default: (empty)
3054
3055 # This is a colon-delimited list of authentication methods mutt may attempt to
3056 # use to log in to an POP server, in the order mutt should try them.
3057 # Authentication methods are either “user”, “apop” or any SASL mechanism, e.g. “
3058 # digest-md5”, “gssapi” or “cram-md5”. This option is case-insensitive. If this
3059 # option is unset (the default) mutt will try all available methods, in order
3060 # from most-secure to least-secure.
3061
3062 # Example: 
3063
3064 # set pop_authenticators="digest-md5:apop:user"
3065
3066
3067
3068 # 3.215. pop_checkinterval
3069
3070 # Type: number
3071 # Default: 60
3072
3073 # This variable configures how often (in seconds) mutt should look for new mail
3074 # in the currently selected mailbox if it is a POP mailbox.
3075
3076
3077
3078 # 3.216. pop_delete
3079
3080 # Type: quadoption
3081 # Default: ask-no
3082
3083 # If set, Mutt will delete successfully downloaded messages from the POP server
3084 # when using the <fetch-mail> function. When unset, Mutt will download messages
3085 # but also leave them on the POP server.
3086
3087
3088
3089 # 3.217. pop_host
3090
3091 # Type: string
3092 # Default: (empty)
3093
3094 # The name of your POP server for the <fetch-mail> function. You can also specify
3095 # an alternative port, username and password, i.e.:
3096
3097 # [pop[s]://][username[:password]@]popserver[:port] 
3098
3099 # where “[...]” denotes an optional part.
3100
3101
3102
3103 # 3.218. pop_last
3104
3105 # Type: boolean
3106 # Default: no
3107
3108 # If this variable is set, mutt will try to use the “LAST” POP command for
3109 # retrieving only unread messages from the POP server when using the <fetch-mail>
3110 # function. 
3111
3112
3113
3114 # 3.219. pop_oauth_refresh_command
3115
3116 # Type: string
3117 # Default: (empty)
3118
3119 # The command to run to generate an OAUTH refresh token for authorizing your
3120 # connection to your POP server. This command will be run on every connection
3121 # attempt that uses the OAUTHBEARER authentication mechanism.
3122
3123
3124
3125 # 3.220. pop_pass
3126
3127 # Type: string
3128 # Default: (empty)
3129
3130 # Specifies the password for your POP account. If unset, Mutt will prompt you for
3131 # your password when you open a POP mailbox.
3132
3133 # Warning: you should only use this option when you are on a fairly secure
3134 # machine, because the superuser can read your muttrc even if you are the only
3135 # one who can read the file.
3136
3137
3138
3139 # 3.221. pop_reconnect
3140
3141 # Type: quadoption
3142 # Default: ask-yes
3143
3144 # Controls whether or not Mutt will try to reconnect to the POP server if the
3145 # connection is lost.
3146
3147
3148
3149 # 3.222. pop_user
3150
3151 # Type: string
3152 # Default: (empty)
3153
3154 # Your login name on the POP server.
3155
3156 # This variable defaults to your user name on the local machine.
3157
3158
3159
3160 # 3.223. post_indent_string
3161
3162 # Type: string
3163 # Default: (empty)
3164
3165 # Similar to the $attribution variable, Mutt will append this string after the
3166 # inclusion of a message which is being replied to.
3167
3168
3169
3170 # 3.224. postpone
3171
3172 # Type: quadoption
3173 # Default: ask-yes
3174
3175 # Controls whether or not messages are saved in the $postponed mailbox when you
3176 # elect not to send immediately.
3177
3178 # Also see the $recall variable.
3179
3180
3181
3182 # 3.225. postponed
3183
3184 # Type: path
3185 # Default: “~/postponed”
3186
3187 # Mutt allows you to indefinitely “postpone sending a message” which you are
3188 # editing. When you choose to postpone a message, Mutt saves it in the mailbox
3189 # specified by this variable.
3190
3191 # Also see the $postpone variable.
3192
3193 set postponed="=drafts"
3194
3195
3196 # 3.226. postpone_encrypt
3197
3198 # Type: boolean
3199 # Default: no
3200
3201 # When set, postponed messages that are marked for encryption will be
3202 # self-encrypted. Mutt will first try to encrypt using the value specified in
3203 # $pgp_default_key or $smime_default_key. If those are not set, it will try the
3204 # deprecated $postpone_encrypt_as. (Crypto only)
3205
3206
3207
3208 # 3.227. postpone_encrypt_as
3209
3210 # Type: string
3211 # Default: (empty)
3212
3213 # This is a deprecated fall-back variable for $postpone_encrypt. Please use
3214 # $pgp_default_key or $smime_default_key. (Crypto only)
3215
3216
3217
3218 # 3.228. preconnect
3219
3220 # Type: string
3221 # Default: (empty)
3222
3223 # If set, a shell command to be executed if mutt fails to establish a connection
3224 # to the server. This is useful for setting up secure connections, e.g. with ssh
3225 # (1). If the command returns a nonzero status, mutt gives up opening the server.
3226 # Example: 
3227
3228 # set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 < /dev/null > /dev/null"
3229
3230 # Mailbox “foo” on “mailhost.net” can now be reached as “{localhost:1234}foo”.
3231
3232 # Note: For this example to work, you must be able to log in to the remote
3233 # machine without having to enter a password.
3234
3235
3236
3237 # 3.229. print
3238
3239 # Type: quadoption
3240 # Default: ask-no
3241
3242 # Controls whether or not Mutt really prints messages. This is set to “ask-no” by
3243 # default, because some people accidentally hit “p” often.
3244
3245
3246
3247 # 3.230. print_command
3248
3249 # Type: path
3250 # Default: “lpr”
3251
3252 # This specifies the command pipe that should be used to print messages.
3253
3254 set print_command="muttprint"
3255
3256
3257 # 3.231. print_decode
3258
3259 # Type: boolean
3260 # Default: yes
3261
3262 # Used in connection with the <print-message> command. If this option is set, the
3263 # message is decoded before it is passed to the external command specified by
3264 # $print_command. If this option is unset, no processing will be applied to the
3265 # message when printing it. The latter setting may be useful if you are using
3266 # some advanced printer filter which is able to properly format e-mail messages
3267 # for printing.
3268
3269
3270
3271 # 3.232. print_split
3272
3273 # Type: boolean
3274 # Default: no
3275
3276 # Used in connection with the <print-message> command. If this option is set, the
3277 # command specified by $print_command is executed once for each message which is
3278 # to be printed. If this option is unset, the command specified by $print_command
3279 # is executed only once, and all the messages are concatenated, with a form feed
3280 # as the message separator.
3281
3282 # Those who use the enscript(1) program's mail-printing mode will most likely
3283 # want to set this option.
3284
3285 set print_split=yes
3286
3287
3288 # 3.233. prompt_after
3289
3290 # Type: boolean
3291 # Default: yes
3292
3293 # If you use an external $pager, setting this variable will cause Mutt to prompt
3294 # you for a command when the pager exits rather than returning to the index menu.
3295 # If unset, Mutt will return to the index menu when the external pager exits.
3296
3297
3298
3299 # 3.234. query_command
3300
3301 # Type: path
3302 # Default: (empty)
3303
3304 # This specifies the command Mutt will use to make external address queries. The
3305 # string may contain a “%s”, which will be substituted with the query string the
3306 # user types. Mutt will add quotes around the string substituted for “%s”
3307 # automatically according to shell quoting rules, so you should avoid adding your
3308 # own. If no “%s” is found in the string, Mutt will append the user's query to
3309 # the end of the string. See “query” for more information.
3310
3311 set query_command="lbdbq"
3312
3313
3314 # 3.235. query_format
3315
3316 # Type: string
3317 # Default: “%4c %t %-25.25a %-25.25n %?e?(%e)?”
3318
3319 # This variable describes the format of the “query” menu. The following printf(3)
3320 # -style sequences are understood:
3321
3322 # ┌───┬─────────────────────────────────────────────────────┐ 
3323 # │%a │destination address                                  │
3324 # ├───┼─────────────────────────────────────────────────────┤ 
3325 # │%c │current entry number                                 │
3326 # ├───┼─────────────────────────────────────────────────────┤ 
3327 # │%e │extra information *                                  │
3328 # ├───┼─────────────────────────────────────────────────────┤ 
3329 # │%n │destination name                                     │
3330 # ├───┼─────────────────────────────────────────────────────┤ 
3331 # │%t │“*” if current entry is tagged, a space otherwise    │
3332 # ├───┼─────────────────────────────────────────────────────┤ 
3333 # │%>X│right justify the rest of the string and pad with “X”│
3334 # ├───┼─────────────────────────────────────────────────────┤ 
3335 # │%|X│pad to the end of the line with “X”                  │
3336 # ├───┼─────────────────────────────────────────────────────┤ 
3337 # │%*X│soft-fill with character “X” as pad                  │
3338 # └───┴─────────────────────────────────────────────────────┘ 
3339
3340 # For an explanation of “soft-fill”, see the $index_format documentation.
3341
3342 # * = can be optionally printed if nonzero, see the $status_format documentation.
3343
3344
3345
3346 # 3.236. quit
3347
3348 # Type: quadoption
3349 # Default: yes
3350
3351 # This variable controls whether “quit” and “exit” actually quit from mutt. If
3352 # this option is set, they do quit, if it is unset, they have no effect, and if
3353 # it is set to ask-yes or ask-no, you are prompted for confirmation when you try
3354 # to quit.
3355
3356
3357
3358 # 3.237. quote_regexp
3359
3360 # Type: regular expression
3361 # Default: “^([ t]*[|>:}#])+”
3362
3363 # A regular expression used in the internal pager to determine quoted sections of
3364 # text in the body of a message. Quoted text may be filtered out using the
3365 # <toggle-quoted> command, or colored according to the “color quoted” family of
3366 # directives. 
3367
3368 # Higher levels of quoting may be colored differently (“color quoted1”, “color
3369 # quoted2”, etc.). The quoting level is determined by removing the last character
3370 # from the matched text and recursively reapplying the regular expression until
3371 # it fails to produce a match.
3372
3373 # Match detection may be overridden by the $smileys regular expression.
3374
3375
3376
3377 # 3.238. read_inc
3378
3379 # Type: number
3380 # Default: 10
3381
3382 # If set to a value greater than 0, Mutt will display which message it is
3383 # currently on when reading a mailbox or when performing search actions such as
3384 # search and limit. The message is printed after this many messages have been
3385 # read or searched (e.g., if set to 25, Mutt will print a message when it is at
3386 # message 25, and then again when it gets to message 50). This variable is meant
3387 # to indicate progress when reading or searching large mailboxes which may take
3388 # some time. When set to 0, only a single message will appear before the reading
3389 # the mailbox.
3390
3391 # Also see the $write_inc, $net_inc and $time_inc variables and the “tuning”
3392 # section of the manual for performance considerations.
3393
3394
3395
3396 # 3.239. read_only
3397
3398 # Type: boolean
3399 # Default: no
3400
3401 # If set, all folders are opened in read-only mode.
3402
3403
3404
3405 # 3.240. realname
3406
3407 # Type: string
3408 # Default: (empty)
3409
3410 # This variable specifies what “real” or “personal” name should be used when
3411 # sending messages.
3412
3413 # By default, this is the GECOS field from /etc/passwd. Note that this variable
3414 # will not be used when the user has set a real name in the $from variable.
3415
3416
3417
3418 # 3.241. recall
3419
3420 # Type: quadoption
3421 # Default: ask-yes
3422
3423 # Controls whether or not Mutt recalls postponed messages when composing a new
3424 # message. 
3425
3426 # Setting this variable to yes is not generally useful, and thus not recommended.
3427 # Note that the <recall-message> function can be used to manually recall
3428 # postponed messages.
3429
3430 # Also see $postponed variable.
3431
3432 set recall=no
3433
3434
3435 # 3.242. record
3436
3437 # Type: path
3438 # Default: “~/sent”
3439
3440 # This specifies the file into which your outgoing messages should be appended.
3441 # (This is meant as the primary method for saving a copy of your messages, but
3442 # another way to do this is using the “my_hdr” command to create a “Bcc:” field
3443 # with your email address in it.)
3444
3445 # The value of $record is overridden by the $force_name and $save_name variables,
3446 # and the “fcc-hook” command.
3447
3448 set record="=store"
3449
3450
3451 # 3.243. reflow_space_quotes
3452
3453 # Type: boolean
3454 # Default: yes
3455
3456 # This option controls how quotes from format=flowed messages are displayed in
3457 # the pager and when replying (with $text_flowed unset). When set, this option
3458 # adds spaces after each level of quote marks, turning ">>>foo" into "> > > foo".
3459
3460 # Note: If $reflow_text is unset, this option has no effect. Also, this option
3461 # does not affect replies when $text_flowed is set.
3462
3463
3464
3465 # 3.244. reflow_text
3466
3467 # Type: boolean
3468 # Default: yes
3469
3470 # When set, Mutt will reformat paragraphs in text/plain parts marked format=
3471 # flowed. If unset, Mutt will display paragraphs unaltered from how they appear
3472 # in the message body. See RFC3676 for details on the format=flowed format.
3473
3474 # Also see $reflow_wrap, and $wrap.
3475
3476
3477
3478 # 3.245. reflow_wrap
3479
3480 # Type: number
3481 # Default: 78
3482
3483 # This variable controls the maximum paragraph width when reformatting text/plain
3484 # parts when $reflow_text is set. When the value is 0, paragraphs will be wrapped
3485 # at the terminal's right margin. A positive value sets the paragraph width
3486 # relative to the left margin. A negative value set the paragraph width relative
3487 # to the right margin.
3488
3489 # Also see $wrap.
3490
3491 set reflow_wrap=-10
3492
3493
3494 # 3.246. reply_regexp
3495
3496 # Type: regular expression
3497 # Default: “^(re([[0-9]+])*|aw):[ t]*”
3498
3499 # A regular expression used to recognize reply messages when threading and
3500 # replying. The default value corresponds to the English "Re:" and the German
3501 # "Aw:". 
3502
3503 set reply_regexp="^((re([-[(]?[[:digit:]]+[)]]?)?|a(nt)?w(ort)?|wg|s(gkb|v)):[[:space:]]*)+"
3504
3505
3506 # 3.247. reply_self
3507
3508 # Type: boolean
3509 # Default: no
3510
3511 # If unset and you are replying to a message sent by you, Mutt will assume that
3512 # you want to reply to the recipients of that message rather than to yourself.
3513
3514 # Also see the “alternates” command.
3515
3516
3517
3518 # 3.248. reply_to
3519
3520 # Type: quadoption
3521 # Default: ask-yes
3522
3523 # If set, when replying to a message, Mutt will use the address listed in the
3524 # Reply-to: header as the recipient of the reply. If unset, it will use the
3525 # address in the From: header field instead. This option is useful for reading a
3526 # mailing list that sets the Reply-To: header field to the list address and you
3527 # want to send a private message to the author of a message.
3528
3529
3530
3531 # 3.249. resolve
3532
3533 # Type: boolean
3534 # Default: yes
3535
3536 # When set, the cursor will be automatically advanced to the next (possibly
3537 # undeleted) message whenever a command that modifies the current message is
3538 # executed. 
3539
3540
3541
3542 # 3.250. resume_draft_files
3543
3544 # Type: boolean
3545 # Default: no
3546
3547 # If set, draft files (specified by -H on the command line) are processed
3548 # similarly to when resuming a postponed message. Recipients are not prompted
3549 # for; send-hooks are not evaluated; no alias expansion takes place; user-defined
3550 # headers and signatures are not added to the message.
3551
3552
3553
3554 # 3.251. resume_edited_draft_files
3555
3556 # Type: boolean
3557 # Default: yes
3558
3559 # If set, draft files previously edited (via -E -H on the command line) will have
3560 # $resume_draft_files automatically set when they are used as a draft file again.
3561
3562 # The first time a draft file is saved, mutt will add a header,
3563 # X-Mutt-Resume-Draft to the saved file. The next time the draft file is read in,
3564 # if mutt sees the header, it will set $resume_draft_files.
3565
3566 # This option is designed to prevent multiple signatures, user-defined headers,
3567 # and other processing effects from being made multiple times to the draft file.
3568
3569
3570
3571 # 3.252. reverse_alias
3572
3573 # Type: boolean
3574 # Default: no
3575
3576 # This variable controls whether or not Mutt will display the “personal” name
3577 # from your aliases in the index menu if it finds an alias that matches the
3578 # message's sender. For example, if you have the following alias:
3579
3580 # alias juser abd30425@somewhere.net (Joe User)
3581
3582 # and then you receive mail which contains the following header:
3583
3584 # From: abd30425@somewhere.net
3585
3586 # It would be displayed in the index menu as “Joe User” instead of “
3587 # abd30425@somewhere.net.” This is useful when the person's e-mail address is not
3588 # human friendly.
3589
3590
3591
3592 # 3.253. reverse_name
3593
3594 # Type: boolean
3595 # Default: no
3596
3597 # It may sometimes arrive that you receive mail to a certain machine, move the
3598 # messages to another machine, and reply to some the messages from there. If this
3599 # variable is set, the default From: line of the reply messages is built using
3600 # the address where you received the messages you are replying to if that address
3601 # matches your “alternates”. If the variable is unset, or the address that would
3602 # be used doesn't match your “alternates”, the From: line will use your address
3603 # on the current machine.
3604
3605 # Also see the “alternates” command.
3606
3607 set reverse_name=yes
3608
3609
3610 # 3.254. reverse_realname
3611
3612 # Type: boolean
3613 # Default: yes
3614
3615 # This variable fine-tunes the behavior of the $reverse_name feature. When it is
3616 # set, mutt will use the address from incoming messages as-is, possibly including
3617 # eventual real names. When it is unset, mutt will override any such real names
3618 # with the setting of the $realname variable.
3619
3620
3621
3622 # 3.255. rfc2047_parameters
3623
3624 # Type: boolean
3625 # Default: no
3626
3627 # When this variable is set, Mutt will decode RFC2047-encoded MIME parameters.
3628 # You want to set this variable when mutt suggests you to save attachments to
3629 # files named like:
3630
3631 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?= 
3632
3633 # When this variable is set interactively, the change won't be active until you
3634 # change folders.
3635
3636 # Note that this use of RFC2047's encoding is explicitly prohibited by the
3637 # standard, but nevertheless encountered in the wild.
3638
3639 # Also note that setting this parameter will not have the effect that mutt
3640 # generates this kind of encoding. Instead, mutt will unconditionally use the
3641 # encoding specified in RFC2231.
3642
3643 set rfc2047_parameters=yes
3644
3645
3646 # 3.256. save_address
3647
3648 # Type: boolean
3649 # Default: no
3650
3651 # If set, mutt will take the sender's full address when choosing a default folder
3652 # for saving a mail. If $save_name or $force_name is set too, the selection of
3653 # the Fcc folder will be changed as well.
3654
3655
3656
3657 # 3.257. save_empty
3658
3659 # Type: boolean
3660 # Default: yes
3661
3662 # When unset, mailboxes which contain no saved messages will be removed when
3663 # closed (the exception is $spoolfile which is never removed). If set, mailboxes
3664 # are never removed.
3665
3666 # Note: This only applies to mbox and MMDF folders, Mutt does not delete MH and
3667 # Maildir directories.
3668
3669
3670
3671 # 3.258. save_history
3672
3673 # Type: number
3674 # Default: 0
3675
3676 # This variable controls the size of the history (per category) saved in the
3677 # $history_file file.
3678
3679 set save_history=100
3680
3681
3682 # 3.259. save_name
3683
3684 # Type: boolean
3685 # Default: no
3686
3687 # This variable controls how copies of outgoing messages are saved. When set, a
3688 # check is made to see if a mailbox specified by the recipient address exists
3689 # (this is done by searching for a mailbox in the $folder directory with the
3690 # username part of the recipient address). If the mailbox exists, the outgoing
3691 # message will be saved to that mailbox, otherwise the message is saved to the
3692 # $record mailbox.
3693
3694 # Also see the $force_name variable.
3695
3696
3697
3698 # 3.260. score
3699
3700 # Type: boolean
3701 # Default: yes
3702
3703 # When this variable is unset, scoring is turned off. This can be useful to
3704 # selectively disable scoring for certain folders when the
3705 # $score_threshold_delete variable and related are used.
3706
3707
3708
3709 # 3.261. score_threshold_delete
3710
3711 # Type: number
3712 # Default: -1
3713
3714 # Messages which have been assigned a score equal to or lower than the value of
3715 # this variable are automatically marked for deletion by mutt. Since mutt scores
3716 # are always greater than or equal to zero, the default setting of this variable
3717 # will never mark a message for deletion.
3718
3719
3720
3721 # 3.262. score_threshold_flag
3722
3723 # Type: number
3724 # Default: 9999
3725
3726 # Messages which have been assigned a score greater than or equal to this
3727 # variable's value are automatically marked "flagged".
3728
3729
3730
3731 # 3.263. score_threshold_read
3732
3733 # Type: number
3734 # Default: -1
3735
3736 # Messages which have been assigned a score equal to or lower than the value of
3737 # this variable are automatically marked as read by mutt. Since mutt scores are
3738 # always greater than or equal to zero, the default setting of this variable will
3739 # never mark a message read.
3740
3741
3742
3743 # 3.264. search_context
3744
3745 # Type: number
3746 # Default: 0
3747
3748 # For the pager, this variable specifies the number of lines shown before search
3749 # results. By default, search results will be top-aligned.
3750
3751 set search_context=5
3752
3753
3754 # 3.265. send_charset
3755
3756 # Type: string
3757 # Default: “us-ascii:iso-8859-1:utf-8”
3758
3759 # A colon-delimited list of character sets for outgoing messages. Mutt will use
3760 # the first character set into which the text can be converted exactly. If your
3761 # $charset is not “iso-8859-1” and recipients may not understand “UTF-8”, it is
3762 # advisable to include in the list an appropriate widely used standard character
3763 # set (such as “iso-8859-2”, “koi8-r” or “iso-2022-jp”) either instead of or
3764 # after “iso-8859-1”.
3765
3766 # In case the text cannot be converted into one of these exactly, mutt uses
3767 # $charset as a fallback.
3768
3769 set send_charset="utf-8"
3770
3771
3772 # 3.266. sendmail
3773
3774 # Type: path
3775 # Default: “/usr/sbin/sendmail -oem -oi”
3776
3777 # Specifies the program and arguments used to deliver mail sent by Mutt. Mutt
3778 # expects that the specified program interprets additional arguments as recipient
3779 # addresses. Mutt appends all recipients after adding a -- delimiter (if not
3780 # already present). Additional flags, such as for $use_8bitmime,
3781 # $use_envelope_from, $dsn_notify, or $dsn_return will be added before the
3782 # delimiter. 
3783
3784 set sendmail="$my_confdir/sendmail"
3785
3786
3787 # 3.267. sendmail_wait
3788
3789 # Type: number
3790 # Default: 0
3791
3792 # Specifies the number of seconds to wait for the $sendmail process to finish
3793 # before giving up and putting delivery in the background.
3794
3795 # Mutt interprets the value of this variable as follows:
3796
3797 # ┌──┬──────────────────────────────────────────────────────────────────┐ 
3798 # │>0│number of seconds to wait for sendmail to finish before continuing│
3799 # ├──┼──────────────────────────────────────────────────────────────────┤ 
3800 # │0 │wait forever for sendmail to finish                               │
3801 # ├──┼──────────────────────────────────────────────────────────────────┤ 
3802 # │<0│always put sendmail in the background without waiting             │
3803 # └──┴──────────────────────────────────────────────────────────────────┘ 
3804
3805 # Note that if you specify a value other than 0, the output of the child process
3806 # will be put in a temporary file. If there is some error, you will be informed
3807 # as to where to find the output.
3808
3809
3810
3811 # 3.268. shell
3812
3813 # Type: path
3814 # Default: (empty)
3815
3816 # Command to use when spawning a subshell. By default, the user's login shell
3817 # from /etc/passwd is used.
3818
3819
3820
3821 # 3.269. sidebar_delim_chars
3822
3823 # Type: string
3824 # Default: “/.”
3825
3826 # This contains the list of characters which you would like to treat as folder
3827 # separators for displaying paths in the sidebar.
3828
3829 # Local mail is often arranged in directories: `dir1/dir2/mailbox'.
3830
3831 # set sidebar_delim_chars='/'
3832
3833 # IMAP mailboxes are often named: `folder1.folder2.mailbox'.
3834
3835 # set sidebar_delim_chars='.'
3836
3837 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_indent_string.
3838
3839
3840
3841 # 3.270. sidebar_divider_char
3842
3843 # Type: string
3844 # Default: “|”
3845
3846 # This specifies the characters to be drawn between the sidebar (when visible)
3847 # and the other Mutt panels. ASCII and Unicode line-drawing characters are
3848 # supported. 
3849
3850 set sidebar_divider_char=" "
3851
3852
3853 # 3.271. sidebar_folder_indent
3854
3855 # Type: boolean
3856 # Default: no
3857
3858 # Set this to indent mailboxes in the sidebar.
3859
3860 # See also: $sidebar_short_path, $sidebar_indent_string, $sidebar_delim_chars.
3861
3862 set sidebar_folder_indent=yes
3863
3864
3865 # 3.272. sidebar_format
3866
3867 # Type: string
3868 # Default: “%B%*  %n”
3869
3870 # This variable allows you to customize the sidebar display. This string is
3871 # similar to $index_format, but has its own set of printf(3)-like sequences:
3872
3873 # ┌───┬─────────────────────────────────────────────────────────────────────────┐ 
3874 # │%B │Name of the mailbox                                                      │
3875 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3876 # │%S │* Size of mailbox (total number of messages)                             │
3877 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3878 # │%N │* Number of unread messages in the mailbox                               │
3879 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3880 # │%n │N if mailbox has new mail, blank otherwise                               │
3881 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3882 # │%F │* Number of Flagged messages in the mailbox                              │
3883 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3884 # │%! │“!” : one flagged message; “!!” : two flagged messages; “n!” : n flagged │
3885 # │ │messages (for n > 2). Otherwise prints nothing.                          │
3886 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3887 # │%d │* @ Number of deleted messages                                           │
3888 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3889 # │%L │* @ Number of messages after limiting                                    │
3890 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3891 # │%t │* @ Number of tagged messages                                            │
3892 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3893 # │%>X│right justify the rest of the string and pad with “X”                    │
3894 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3895 # │%|X│pad to the end of the line with “X”                                      │
3896 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
3897 # │%*X│soft-fill with character “X” as pad                                      │
3898 # └───┴─────────────────────────────────────────────────────────────────────────┘ 
3899
3900 # * = Can be optionally printed if nonzero @ = Only applicable to the current
3901 # folder 
3902
3903 # In order to use %S, %N, %F, and %!, $mail_check_stats must be set. When thus
3904 # set, a suggested value for this option is "%B%?F? [%F]?%* %?N?%N/?%S".
3905
3906 set sidebar_format="%B%?F? [%F]?%*  %?N?%N/?%S"
3907
3908
3909 # 3.273. sidebar_indent_string
3910
3911 # Type: string
3912 # Default: “  ”
3913
3914 # This specifies the string that is used to indent mailboxes in the sidebar. It
3915 # defaults to two spaces.
3916
3917 # See also: $sidebar_short_path, $sidebar_folder_indent, $sidebar_delim_chars.
3918
3919 set sidebar_indent_string=" "
3920
3921
3922 # 3.274. sidebar_new_mail_only
3923
3924 # Type: boolean
3925 # Default: no
3926
3927 # When set, the sidebar will only display mailboxes containing new, or flagged,
3928 # mail. 
3929
3930 # See also: sidebar_whitelist.
3931
3932
3933
3934 # 3.275. sidebar_next_new_wrap
3935
3936 # Type: boolean
3937 # Default: no
3938
3939 # When set, the <sidebar-next-new> command will not stop and the end of the list
3940 # of mailboxes, but wrap around to the beginning. The <sidebar-prev-new> command
3941 # is similarly affected, wrapping around to the end of the list.
3942
3943 set sidebar_next_new_wrap=yes
3944
3945
3946 # 3.276. sidebar_short_path
3947
3948 # Type: boolean
3949 # Default: no
3950
3951 # By default the sidebar will show the mailbox's path, relative to the $folder
3952 # variable. Setting sidebar_shortpath=yes will shorten the names relative to the
3953 # previous name. Here's an example:
3954
3955 # ┌────────────┬─────────────┬───────────────────────────────────────────────┐ 
3956 # │shortpath=no│shortpath=yes│shortpath=yes, folderindent=yes, indentstr=".."│
3957 # ├────────────┼─────────────┼───────────────────────────────────────────────┤ 
3958 # │fruit │fruit        │fruit                                          │
3959 # ├────────────┼─────────────┼───────────────────────────────────────────────┤ 
3960 # │fruit.apple │apple        │..apple                                        │
3961 # ├────────────┼─────────────┼───────────────────────────────────────────────┤ 
3962 # │fruit.banana│banana │..banana                                       │
3963 # ├────────────┼─────────────┼───────────────────────────────────────────────┤ 
3964 # │fruit.cherry│cherry │..cherry                                       │
3965 # └────────────┴─────────────┴───────────────────────────────────────────────┘ 
3966
3967 # See also: $sidebar_delim_chars, $sidebar_folder_indent, $sidebar_indent_string.
3968
3969 set sidebar_short_path=yes
3970
3971
3972 # 3.277. sidebar_sort_method
3973
3974 # Type: sort order
3975 # Default: order
3976
3977 # Specifies how to sort entries in the file browser. By default, the entries are
3978 # sorted alphabetically. Valid values:
3979
3980 # • alpha (alphabetically)
3981
3982 # • count (all message count)
3983
3984 # • flagged (flagged message count)
3985
3986 # • name (alphabetically)
3987
3988 # • new (unread message count)
3989
3990 # • path (alphabetically)
3991
3992 # • unread (unread message count)
3993
3994 # • unsorted
3995
3996 # You may optionally use the “reverse-” prefix to specify reverse sorting order
3997 # (example: “set sort_browser=reverse-date”).
3998
3999 set sidebar_sort_method=path
4000
4001
4002 # 3.278. sidebar_visible
4003
4004 # Type: boolean
4005 # Default: no
4006
4007 # This specifies whether or not to show sidebar. The sidebar shows a list of all
4008 # your mailboxes.
4009
4010 # See also: $sidebar_format, $sidebar_width
4011
4012 set sidebar_visible=yes
4013
4014
4015 # 3.279. sidebar_width
4016
4017 # Type: number
4018 # Default: 30
4019
4020 # This controls the width of the sidebar. It is measured in screen columns. For
4021 # example: sidebar_width=20 could display 20 ASCII characters, or 10 Chinese
4022 # characters. 
4023
4024 set sidebar_width=20
4025
4026
4027 # 3.280. sig_dashes
4028
4029 # Type: boolean
4030 # Default: yes
4031
4032 # If set, a line containing “-- ” (note the trailing space) will be inserted
4033 # before your $signature. It is strongly recommended that you not unset this
4034 # variable unless your signature contains just your name. The reason for this is
4035 # because many software packages use “-- n” to detect your signature. For
4036 # example, Mutt has the ability to highlight the signature in a different color
4037 # in the built-in pager.
4038
4039 set sig_dashes=no
4040
4041
4042 # 3.281. sig_on_top
4043
4044 # Type: boolean
4045 # Default: no
4046
4047 # If set, the signature will be included before any quoted or forwarded text. It
4048 # is strongly recommended that you do not set this variable unless you really
4049 # know what you are doing, and are prepared to take some heat from netiquette
4050 # guardians. 
4051
4052
4053
4054 # 3.282. signature
4055
4056 # Type: path
4057 # Default: “~/.signature”
4058
4059 # Specifies the filename of your signature, which is appended to all outgoing
4060 # messages. If the filename ends with a pipe (“|”), it is assumed that filename
4061 # is a shell command and input should be read from its standard output.
4062
4063
4064
4065 # 3.283. simple_search
4066
4067 # Type: string
4068 # Default: “~f %s | ~s %s”
4069
4070 # Specifies how Mutt should expand a simple search into a real search pattern. A
4071 # simple search is one that does not contain any of the “~” pattern operators.
4072 # See “patterns” for more information on search patterns.
4073
4074 # For example, if you simply type “joe” at a search or limit prompt, Mutt will
4075 # automatically expand it to the value specified by this variable by replacing “
4076 # %s” with the supplied string. For the default value, “joe” would be expanded
4077 # to: “~f joe | ~s joe”.
4078
4079 set simple_search="~L %s | ~s %s"
4080
4081
4082 # 3.284. sleep_time
4083
4084 # Type: number
4085 # Default: 1
4086
4087 # Specifies time, in seconds, to pause while displaying certain informational
4088 # messages, while moving from folder to folder and after expunging messages from
4089 # the current folder. The default is to pause one second, so a value of zero for
4090 # this option suppresses the pause.
4091
4092
4093
4094 # 3.285. smart_wrap
4095
4096 # Type: boolean
4097 # Default: yes
4098
4099 # Controls the display of lines longer than the screen width in the internal
4100 # pager. If set, long lines are wrapped at a word boundary. If unset, lines are
4101 # simply wrapped at the screen edge. Also see the $markers variable.
4102
4103
4104
4105 # 3.286. smileys
4106
4107 # Type: regular expression
4108 # Default: “(>From )|(:[-^]?[][)(><}{|/DP])”
4109
4110 # The pager uses this variable to catch some common false positives of
4111 # $quote_regexp, most notably smileys and not consider a line quoted text if it
4112 # also matches $smileys. This mostly happens at the beginning of a line.
4113
4114
4115
4116 # 3.287. smime_ask_cert_label
4117
4118 # Type: boolean
4119 # Default: yes
4120
4121 # This flag controls whether you want to be asked to enter a label for a
4122 # certificate about to be added to the database or not. It is set by default. (S/
4123 # MIME only)
4124
4125
4126
4127 # 3.288. smime_ca_location
4128
4129 # Type: path
4130 # Default: (empty)
4131
4132 # This variable contains the name of either a directory, or a file which contains
4133 # trusted certificates for use with OpenSSL. (S/MIME only)
4134
4135
4136
4137 # 3.289. smime_certificates
4138
4139 # Type: path
4140 # Default: (empty)
4141
4142 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4143 # storage and retrieval of keys by itself. This is very basic right now, and keys
4144 # and certificates are stored in two different directories, both named as the
4145 # hash-value retrieved from OpenSSL. There is an index file which contains
4146 # mailbox-address keyid pairs, and which can be manually edited. This option
4147 # points to the location of the certificates. (S/MIME only)
4148
4149 set smime_certificates="~/.smime/certificates"
4150
4151
4152 # 3.290. smime_decrypt_command
4153
4154 # Type: string
4155 # Default: (empty)
4156
4157 # This format string specifies a command which is used to decrypt application/
4158 # x-pkcs7-mime attachments.
4159
4160 # The OpenSSL command formats have their own set of printf(3)-like sequences
4161 # similar to PGP's:
4162
4163 # ┌──┬──────────────────────────────────────────────────────────────────────────┐ 
4164 # │%f│Expands to the name of a file containing a message.                       │
4165 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
4166 # │%s│Expands to the name of a file containing the signature part of a multipart│
4167 # │ │/signed attachment when verifying it.                                     │
4168 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
4169 # │%k│The key-pair specified with $smime_default_key                            │
4170 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
4171 # │%c│One or more certificate IDs.                                              │
4172 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
4173 # │%a│The algorithm used for encryption.                                        │
4174 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
4175 # │%d│The message digest algorithm specified with $smime_sign_digest_alg.       │
4176 # ├──┼──────────────────────────────────────────────────────────────────────────┤ 
4177 # │ │CA location: Depending on whether $smime_ca_location points to a directory│
4178 # │%C│or file, this expands to “-CApath $smime_ca_location” or “-CAfile         │
4179 # │ │$smime_ca_location”.                                                      │
4180 # └──┴──────────────────────────────────────────────────────────────────────────┘ 
4181
4182 # For examples on how to configure these formats, see the smime.rc in the samples
4183 # / subdirectory which has been installed on your system alongside the
4184 # documentation. (S/MIME only)
4185
4186
4187
4188 # 3.291. smime_decrypt_use_default_key
4189
4190 # Type: boolean
4191 # Default: yes
4192
4193 # If set (default) this tells mutt to use the default key for decryption.
4194 # Otherwise, if managing multiple certificate-key-pairs, mutt will try to use the
4195 # mailbox-address to determine the key to use. It will ask you to supply a key,
4196 # if it can't find one. (S/MIME only)
4197
4198
4199
4200 # 3.292. smime_default_key
4201
4202 # Type: string
4203 # Default: (empty)
4204
4205 # This is the default key-pair to use for S/MIME operations, and must be set to
4206 # the keyid (the hash-value that OpenSSL generates) to work properly.
4207
4208 # It will be used for encryption (see $postpone_encrypt and $smime_self_encrypt).
4209
4210 # It will be used for decryption unless $smime_decrypt_use_default_key is unset.
4211
4212 # It will also be used for signing unless $smime_sign_as is set.
4213
4214 # The (now deprecated) smime_self_encrypt_as is an alias for this variable, and
4215 # should no longer be used. (S/MIME only)
4216
4217
4218
4219 # 3.293. smime_encrypt_command
4220
4221 # Type: string
4222 # Default: (empty)
4223
4224 # This command is used to create encrypted S/MIME messages.
4225
4226 # This is a format string, see the $smime_decrypt_command command for possible
4227 # printf(3)-like sequences. (S/MIME only)
4228
4229
4230
4231 # 3.294. smime_encrypt_with
4232
4233 # Type: string
4234 # Default: “aes256”
4235
4236 # This sets the algorithm that should be used for encryption. Valid choices are “
4237 # aes128”, “aes192”, “aes256”, “des”, “des3”, “rc2-40”, “rc2-64”, “rc2-128”. (S/
4238 # MIME only)
4239
4240
4241
4242 # 3.295. smime_get_cert_command
4243
4244 # Type: string
4245 # Default: (empty)
4246
4247 # This command is used to extract X509 certificates from a PKCS7 structure.
4248
4249 # This is a format string, see the $smime_decrypt_command command for possible
4250 # printf(3)-like sequences. (S/MIME only)
4251
4252
4253
4254 # 3.296. smime_get_cert_email_command
4255
4256 # Type: string
4257 # Default: (empty)
4258
4259 # This command is used to extract the mail address(es) used for storing X509
4260 # certificates, and for verification purposes (to check whether the certificate
4261 # was issued for the sender's mailbox).
4262
4263 # This is a format string, see the $smime_decrypt_command command for possible
4264 # printf(3)-like sequences. (S/MIME only)
4265
4266
4267
4268 # 3.297. smime_get_signer_cert_command
4269
4270 # Type: string
4271 # Default: (empty)
4272
4273 # This command is used to extract only the signers X509 certificate from a S/MIME
4274 # signature, so that the certificate's owner may get compared to the email's “
4275 # From:” field.
4276
4277 # This is a format string, see the $smime_decrypt_command command for possible
4278 # printf(3)-like sequences. (S/MIME only)
4279
4280
4281
4282 # 3.298. smime_import_cert_command
4283
4284 # Type: string
4285 # Default: (empty)
4286
4287 # This command is used to import a certificate via smime_keys.
4288
4289 # This is a format string, see the $smime_decrypt_command command for possible
4290 # printf(3)-like sequences. (S/MIME only)
4291
4292
4293
4294 # 3.299. smime_is_default
4295
4296 # Type: boolean
4297 # Default: no
4298
4299 # The default behavior of mutt is to use PGP on all auto-sign/encryption
4300 # operations. To override and to use OpenSSL instead this must be set. However,
4301 # this has no effect while replying, since mutt will automatically select the
4302 # same application that was used to sign/encrypt the original message. (Note that
4303 # this variable can be overridden by unsetting $crypt_autosmime.) (S/MIME only)
4304
4305
4306
4307 # 3.300. smime_keys
4308
4309 # Type: path
4310 # Default: (empty)
4311
4312 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
4313 # storage and retrieval of keys/certs by itself. This is very basic right now,
4314 # and stores keys and certificates in two different directories, both named as
4315 # the hash-value retrieved from OpenSSL. There is an index file which contains
4316 # mailbox-address keyid pair, and which can be manually edited. This option
4317 # points to the location of the private keys. (S/MIME only)
4318
4319 set smime_keys="~/.smime/keys"
4320
4321
4322 # 3.301. smime_pk7out_command
4323
4324 # Type: string
4325 # Default: (empty)
4326
4327 # This command is used to extract PKCS7 structures of S/MIME signatures, in order
4328 # to extract the public X509 certificate(s).
4329
4330 # This is a format string, see the $smime_decrypt_command command for possible
4331 # printf(3)-like sequences. (S/MIME only)
4332
4333
4334
4335 # 3.302. smime_self_encrypt
4336
4337 # Type: boolean
4338 # Default: yes
4339
4340 # When set, S/MIME encrypted messages will also be encrypted using the
4341 # certificate in $smime_default_key. (S/MIME only)
4342
4343
4344
4345 # 3.303. smime_sign_as
4346
4347 # Type: string
4348 # Default: (empty)
4349
4350 # If you have a separate key to use for signing, you should set this to the
4351 # signing key. Most people will only need to set $smime_default_key. (S/MIME
4352 # only) 
4353
4354
4355
4356 # 3.304. smime_sign_command
4357
4358 # Type: string
4359 # Default: (empty)
4360
4361 # This command is used to created S/MIME signatures of type multipart/signed,
4362 # which can be read by all mail clients.
4363
4364 # This is a format string, see the $smime_decrypt_command command for possible
4365 # printf(3)-like sequences. NOTE: %c and %k will default to $smime_sign_as if
4366 # set, otherwise $smime_default_key. (S/MIME only)
4367
4368
4369
4370 # 3.305. smime_sign_digest_alg
4371
4372 # Type: string
4373 # Default: “sha256”
4374
4375 # This sets the algorithm that should be used for the signature message digest.
4376 # Valid choices are “md5”, “sha1”, “sha224”, “sha256”, “sha384”, “sha512”. (S/
4377 # MIME only)
4378
4379
4380
4381 # 3.306. smime_sign_opaque_command
4382
4383 # Type: string
4384 # Default: (empty)
4385
4386 # This command is used to created S/MIME signatures of type application/
4387 # x-pkcs7-signature, which can only be handled by mail clients supporting the S/
4388 # MIME extension.
4389
4390 # This is a format string, see the $smime_decrypt_command command for possible
4391 # printf(3)-like sequences. (S/MIME only)
4392
4393
4394
4395 # 3.307. smime_timeout
4396
4397 # Type: number
4398 # Default: 300
4399
4400 # The number of seconds after which a cached passphrase will expire if not used.
4401 # (S/MIME only)
4402
4403
4404
4405 # 3.308. smime_verify_command
4406
4407 # Type: string
4408 # Default: (empty)
4409
4410 # This command is used to verify S/MIME signatures of type multipart/signed.
4411
4412 # This is a format string, see the $smime_decrypt_command command for possible
4413 # printf(3)-like sequences. (S/MIME only)
4414
4415
4416
4417 # 3.309. smime_verify_opaque_command
4418
4419 # Type: string
4420 # Default: (empty)
4421
4422 # This command is used to verify S/MIME signatures of type application/
4423 # x-pkcs7-mime. 
4424
4425 # This is a format string, see the $smime_decrypt_command command for possible
4426 # printf(3)-like sequences. (S/MIME only)
4427
4428
4429
4430 # 3.310. smtp_authenticators
4431
4432 # Type: string
4433 # Default: (empty)
4434
4435 # This is a colon-delimited list of authentication methods mutt may attempt to
4436 # use to log in to an SMTP server, in the order mutt should try them.
4437 # Authentication methods are any SASL mechanism, e.g. “digest-md5”, “gssapi” or “
4438 # cram-md5”. This option is case-insensitive. If it is “unset” (the default) mutt
4439 # will try all available methods, in order from most-secure to least-secure.
4440
4441 # Example: 
4442
4443 # set smtp_authenticators="digest-md5:cram-md5"
4444
4445
4446
4447 # 3.311. smtp_oauth_refresh_command
4448
4449 # Type: string
4450 # Default: (empty)
4451
4452 # The command to run to generate an OAUTH refresh token for authorizing your
4453 # connection to your SMTP server. This command will be run on every connection
4454 # attempt that uses the OAUTHBEARER authentication mechanism.
4455
4456
4457
4458 # 3.312. smtp_pass
4459
4460 # Type: string
4461 # Default: (empty)
4462
4463 # Specifies the password for your SMTP account. If unset, Mutt will prompt you
4464 # for your password when you first send mail via SMTP. See $smtp_url to configure
4465 # mutt to send mail via SMTP.
4466
4467 # Warning: you should only use this option when you are on a fairly secure
4468 # machine, because the superuser can read your muttrc even if you are the only
4469 # one who can read the file.
4470
4471
4472
4473 # 3.313. smtp_url
4474
4475 # Type: string
4476 # Default: (empty)
4477
4478 # Defines the SMTP smarthost where sent messages should relayed for delivery.
4479 # This should take the form of an SMTP URL, e.g.:
4480
4481 # smtp[s]://[user[:pass]@]host[:port] 
4482
4483 # where “[...]” denotes an optional part. Setting this variable overrides the
4484 # value of the $sendmail variable.
4485
4486
4487
4488 # 3.314. sort
4489
4490 # Type: sort order
4491 # Default: date
4492
4493 # Specifies how to sort messages in the “index” menu. Valid values are:
4494
4495 # • date or date-sent
4496
4497 # • date-received
4498
4499 # • from
4500
4501 # • mailbox-order (unsorted)
4502
4503 # • score
4504
4505 # • size
4506
4507 # • spam
4508
4509 # • subject
4510
4511 # • threads
4512
4513 # • to
4514
4515 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4516 # (example: “set sort=reverse-date-sent”).
4517
4518 set sort=threads
4519
4520
4521 # 3.315. sort_alias
4522
4523 # Type: sort order
4524 # Default: alias
4525
4526 # Specifies how the entries in the “alias” menu are sorted. The following are
4527 # legal values:
4528
4529 # • address (sort alphabetically by email address)
4530
4531 # • alias (sort alphabetically by alias name)
4532
4533 # • unsorted (leave in order specified in .muttrc)
4534
4535
4536
4537 # 3.316. sort_aux
4538
4539 # Type: sort order
4540 # Default: date
4541
4542 # When sorting by threads, this variable controls how threads are sorted in
4543 # relation to other threads, and how the branches of the thread trees are sorted.
4544 # This can be set to any value that $sort can, except “threads” (in that case,
4545 # mutt will just use “date-sent”). You can also specify the “last-” prefix in
4546 # addition to the “reverse-” prefix, but “last-” must come after “reverse-”. The
4547 # “last-” prefix causes messages to be sorted against its siblings by which has
4548 # the last descendant, using the rest of $sort_aux as an ordering. For instance,
4549
4550 # set sort_aux=last-date-received
4551
4552 # would mean that if a new message is received in a thread, that thread becomes
4553 # the last one displayed (or the first, if you have “set sort=reverse-threads”.)
4554
4555 # Note: For reversed $sort order $sort_aux is reversed again (which is not the
4556 # right thing to do, but kept to not break any existing configuration setting).
4557
4558 set sort_aux=last-date-received
4559
4560
4561 # 3.317. sort_browser
4562
4563 # Type: sort order
4564 # Default: alpha
4565
4566 # Specifies how to sort entries in the file browser. By default, the entries are
4567 # sorted alphabetically. Valid values:
4568
4569 # • alpha (alphabetically)
4570
4571 # • count
4572
4573 # • date
4574
4575 # • size
4576
4577 # • unread
4578
4579 # • unsorted
4580
4581 # You may optionally use the “reverse-” prefix to specify reverse sorting order
4582 # (example: “set sort_browser=reverse-date”).
4583
4584
4585
4586 # 3.318. sort_re
4587
4588 # Type: boolean
4589 # Default: yes
4590
4591 # This variable is only useful when sorting by threads with $strict_threads unset
4592 # . In that case, it changes the heuristic mutt uses to thread messages by
4593 # subject. With $sort_re set, mutt will only attach a message as the child of
4594 # another message by subject if the subject of the child message starts with a
4595 # substring matching the setting of $reply_regexp. With $sort_re unset, mutt will
4596 # attach the message whether or not this is the case, as long as the non-
4597 # $reply_regexp parts of both messages are identical.
4598
4599
4600
4601 # 3.319. spam_separator
4602
4603 # Type: string
4604 # Default: “,”
4605
4606 # This variable controls what happens when multiple spam headers are matched: if
4607 # unset, each successive header will overwrite any previous matches value for the
4608 # spam label. If set, each successive match will append to the previous, using
4609 # this variable's value as a separator.
4610
4611
4612
4613 # 3.320. spoolfile
4614
4615 # Type: path
4616 # Default: (empty)
4617
4618 # If your spool mailbox is in a non-default place where Mutt cannot find it, you
4619 # can specify its location with this variable. Mutt will initially set this
4620 # variable to the value of the environment variable $MAIL or $MAILDIR if either
4621 # is defined.
4622
4623 set spoolfile="=inbox"
4624
4625
4626 # 3.321. ssl_ca_certificates_file
4627
4628 # Type: path
4629 # Default: (empty)
4630
4631 # This variable specifies a file containing trusted CA certificates. Any server
4632 # certificate that is signed with one of these CA certificates is also
4633 # automatically accepted. (GnuTLS only)
4634
4635 # Example: 
4636
4637 # set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
4638
4639 set ssl_ca_certificates_file="/etc/ssl/certs/ca-certificates.crt"
4640
4641
4642 # 3.322. ssl_client_cert
4643
4644 # Type: path
4645 # Default: (empty)
4646
4647 # The file containing a client certificate and its associated private key.
4648
4649
4650
4651 # 3.323. ssl_force_tls
4652
4653 # Type: boolean
4654 # Default: no
4655
4656 # If this variable is set, Mutt will require that all connections to remote
4657 # servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
4658 # server does not advertise the capability, since it would otherwise have to
4659 # abort the connection anyway. This option supersedes $ssl_starttls.
4660
4661
4662
4663 # 3.324. ssl_min_dh_prime_bits
4664
4665 # Type: number
4666 # Default: 0
4667
4668 # This variable specifies the minimum acceptable prime size (in bits) for use in
4669 # any Diffie-Hellman key exchange. A value of 0 will use the default from the
4670 # GNUTLS library. (GnuTLS only)
4671
4672
4673
4674 # 3.325. ssl_starttls
4675
4676 # Type: quadoption
4677 # Default: yes
4678
4679 # If set (the default), mutt will attempt to use STARTTLS on servers advertising
4680 # the capability. When unset, mutt will not attempt to use STARTTLS regardless of
4681 # the server's capabilities.
4682
4683
4684
4685 # 3.326. ssl_use_sslv2
4686
4687 # Type: boolean
4688 # Default: no
4689
4690 # This variable specifies whether to attempt to use SSLv2 in the SSL
4691 # authentication process. Note that SSLv2 and SSLv3 are now considered
4692 # fundamentally insecure and are no longer recommended. (OpenSSL only)
4693
4694
4695
4696 # 3.327. ssl_use_sslv3
4697
4698 # Type: boolean
4699 # Default: no
4700
4701 # This variable specifies whether to attempt to use SSLv3 in the SSL
4702 # authentication process. Note that SSLv2 and SSLv3 are now considered
4703 # fundamentally insecure and are no longer recommended.
4704
4705
4706
4707 # 3.328. ssl_use_tlsv1
4708
4709 # Type: boolean
4710 # Default: yes
4711
4712 # This variable specifies whether to attempt to use TLSv1.0 in the SSL
4713 # authentication process.
4714
4715
4716
4717 # 3.329. ssl_use_tlsv1_1
4718
4719 # Type: boolean
4720 # Default: yes
4721
4722 # This variable specifies whether to attempt to use TLSv1.1 in the SSL
4723 # authentication process.
4724
4725
4726
4727 # 3.330. ssl_use_tlsv1_2
4728
4729 # Type: boolean
4730 # Default: yes
4731
4732 # This variable specifies whether to attempt to use TLSv1.2 in the SSL
4733 # authentication process.
4734
4735
4736
4737 # 3.331. ssl_usesystemcerts
4738
4739 # Type: boolean
4740 # Default: yes
4741
4742 # If set to yes, mutt will use CA certificates in the system-wide certificate
4743 # store when checking if a server certificate is signed by a trusted CA. (OpenSSL
4744 # only) 
4745
4746
4747
4748 # 3.332. ssl_verify_dates
4749
4750 # Type: boolean
4751 # Default: yes
4752
4753 # If set (the default), mutt will not automatically accept a server certificate
4754 # that is either not yet valid or already expired. You should only unset this for
4755 # particular known hosts, using the <account-hook> function.
4756
4757
4758
4759 # 3.333. ssl_verify_host
4760
4761 # Type: boolean
4762 # Default: yes
4763
4764 # If set (the default), mutt will not automatically accept a server certificate
4765 # whose host name does not match the host used in your folder URL. You should
4766 # only unset this for particular known hosts, using the <account-hook> function.
4767
4768
4769
4770 # 3.334. ssl_verify_partial_chains
4771
4772 # Type: boolean
4773 # Default: no
4774
4775 # This option should not be changed from the default unless you understand what
4776 # you are doing.
4777
4778 # Setting this variable to yes will permit verifying partial certification
4779 # chains, i. e. a certificate chain where not the root, but an intermediate
4780 # certificate CA, or the host certificate, are marked trusted (in
4781 # $certificate_file), without marking the root signing CA as trusted.
4782
4783 # (OpenSSL 1.0.2b and newer only).
4784
4785
4786
4787 # 3.335. ssl_ciphers
4788
4789 # Type: string
4790 # Default: (empty)
4791
4792 # Contains a colon-seperated list of ciphers to use when using SSL. For OpenSSL,
4793 # see ciphers(1) for the syntax of the string.
4794
4795 # For GnuTLS, this option will be used in place of "NORMAL" at the start of the
4796 # priority string. See gnutls_priority_init(3) for the syntax and more details.
4797 # (Note: GnuTLS version 2.1.7 or higher is required.)
4798
4799
4800
4801 # 3.336. status_chars
4802
4803 # Type: string
4804 # Default: “-*%A”
4805
4806 # Controls the characters used by the “%r” indicator in $status_format. The first
4807 # character is used when the mailbox is unchanged. The second is used when the
4808 # mailbox has been changed, and it needs to be resynchronized. The third is used
4809 # if the mailbox is in read-only mode, or if the mailbox will not be written when
4810 # exiting that mailbox (You can toggle whether to write changes to a mailbox with
4811 # the <toggle-write> operation, bound by default to “%”). The fourth is used to
4812 # indicate that the current folder has been opened in attach- message mode
4813 # (Certain operations like composing a new mail, replying, forwarding, etc. are
4814 # not permitted in this mode).
4815
4816
4817
4818 # 3.337. status_format
4819
4820 # Type: string
4821 # Default: “-%r-Mutt: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d? Del:%d?%?F?
4822 # Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l? %l?]---(%s/%S)-%>-(%P)---”
4823
4824 # Controls the format of the status line displayed in the “index” menu. This
4825 # string is similar to $index_format, but has its own set of printf(3)-like
4826 # sequences: 
4827
4828 # ┌───┬─────────────────────────────────────────────────────────────────────────┐ 
4829 # │%b │number of mailboxes with new mail *                                      │
4830 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4831 # │%d │number of deleted messages *                                             │
4832 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4833 # │%f │the full pathname of the current mailbox                                 │
4834 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4835 # │%F │number of flagged messages *                                             │
4836 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4837 # │%h │local hostname                                                           │
4838 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4839 # │%l │size (in bytes) of the current mailbox *                                 │
4840 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4841 # │%L │size (in bytes) of the messages shown (i.e., which match the current     │
4842 # │ │limit) *                                                                 │
4843 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4844 # │%m │the number of messages in the mailbox *                                  │
4845 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4846 # │%M │the number of messages shown (i.e., which match the current limit) *     │
4847 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4848 # │%n │number of new messages in the mailbox *                                  │
4849 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4850 # │%o │number of old unread messages *                                          │
4851 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4852 # │%p │number of postponed messages *                                           │
4853 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4854 # │%P │percentage of the way through the index                                  │
4855 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4856 # │%r │modified/read-only/won't-write/attach-message indicator, according to    │
4857 # │ │$status_chars                                                            │
4858 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4859 # │%R │number of read messages *                                                │
4860 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4861 # │%s │current sorting mode ($sort)                                             │
4862 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4863 # │%S │current aux sorting method ($sort_aux)                                   │
4864 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4865 # │%t │number of tagged messages *                                              │
4866 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4867 # │%u │number of unread messages *                                              │
4868 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4869 # │%v │Mutt version string                                                      │
4870 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4871 # │%V │currently active limit pattern, if any *                                 │
4872 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4873 # │%>X│right justify the rest of the string and pad with “X”                    │
4874 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4875 # │%|X│pad to the end of the line with “X”                                      │
4876 # ├───┼─────────────────────────────────────────────────────────────────────────┤ 
4877 # │%*X│soft-fill with character “X” as pad                                      │
4878 # └───┴─────────────────────────────────────────────────────────────────────────┘ 
4879
4880 # For an explanation of “soft-fill”, see the $index_format documentation.
4881
4882 # * = can be optionally printed if nonzero
4883
4884 # Some of the above sequences can be used to optionally print a string if their
4885 # value is nonzero. For example, you may only want to see the number of flagged
4886 # messages if such messages exist, since zero is not particularly meaningful. To
4887 # optionally print a string based upon one of the above sequences, the following
4888 # construct is used:
4889
4890 # %?<sequence_char>?<optional_string>? 
4891
4892 # where sequence_char is a character from the table above, and optional_string is
4893 # the string you would like printed if sequence_char is nonzero. optional_string
4894 # may contain other sequences as well as normal text, but you may not nest
4895 # optional strings.
4896
4897 # Here is an example illustrating how to optionally print the number of new
4898 # messages in a mailbox:
4899
4900 # %?n?%n new messages.?
4901
4902 # You can also switch between two strings using the following construct:
4903
4904 # %?<sequence_char>?<if_string>&<else_string>? 
4905
4906 # If the value of sequence_char is non-zero, if_string will be expanded,
4907 # otherwise else_string will be expanded.
4908
4909 # You can force the result of any printf(3)-like sequence to be lowercase by
4910 # prefixing the sequence character with an underscore (“_”) sign. For example, if
4911 # you want to display the local hostname in lowercase, you would use: “%_h”.
4912
4913 # If you prefix the sequence character with a colon (“:”) character, mutt will
4914 # replace any dots in the expansion by underscores. This might be helpful with
4915 # IMAP folders that don't like dots in folder names.
4916
4917 set status_format=" %r %f [m:%?M?%M/?%m%?n? n:%n?%?o? o:%o?%?d? d:%d?%?F? f:%F?%?t? t:%t?%?p? p:%p?%?b? i:%b?%?l? %l?] %?V?%V ?(%s/%S) %> (%P) "
4918
4919
4920 # 3.338. status_on_top
4921
4922 # Type: boolean
4923 # Default: no
4924
4925 # Setting this variable causes the “status bar” to be displayed on the first line
4926 # of the screen rather than near the bottom. If $help is set, too it'll be placed
4927 # at the bottom.
4928
4929
4930
4931 # 3.339. strict_threads
4932
4933 # Type: boolean
4934 # Default: no
4935
4936 # If set, threading will only make use of the “In-Reply-To” and “References:”
4937 # fields when you $sort by message threads. By default, messages with the same
4938 # subject are grouped together in “pseudo threads.”. This may not always be
4939 # desirable, such as in a personal mailbox where you might have several unrelated
4940 # messages with the subjects like “hi” which will get grouped together. See also
4941 # $sort_re for a less drastic way of controlling this behavior.
4942
4943 set strict_threads=yes
4944
4945
4946 # 3.340. suspend
4947
4948 # Type: boolean
4949 # Default: yes
4950
4951 # When unset, mutt won't stop when the user presses the terminal's susp key,
4952 # usually “^Z”. This is useful if you run mutt inside an xterm using a command
4953 # like “xterm -e mutt”.
4954
4955
4956
4957 # 3.341. text_flowed
4958
4959 # Type: boolean
4960 # Default: no
4961
4962 # When set, mutt will generate “format=flowed” bodies with a content type of “
4963 # text/plain; format=flowed”. This format is easier to handle for some mailing
4964 # software, and generally just looks like ordinary text. To actually make use of
4965 # this format's features, you'll need support in your editor.
4966
4967 # Note that $indent_string is ignored when this option is set.
4968
4969 set text_flowed=yes
4970
4971
4972 # 3.342. thorough_search
4973
4974 # Type: boolean
4975 # Default: yes
4976
4977 # Affects the ~b and ~h search operations described in section “patterns”. If set
4978 # , the headers and body/attachments of messages to be searched are decoded
4979 # before searching. If unset, messages are searched as they appear in the folder.
4980
4981 # Users searching attachments or for non-ASCII characters should set this value
4982 # because decoding also includes MIME parsing/decoding and possible character set
4983 # conversions. Otherwise mutt will attempt to match against the raw message
4984 # received (for example quoted-printable encoded or with encoded headers) which
4985 # may lead to incorrect search results.
4986
4987 set thorough_search=yes
4988
4989
4990 # 3.343. thread_received
4991
4992 # Type: boolean
4993 # Default: no
4994
4995 # When set, mutt uses the date received rather than the date sent to thread
4996 # messages by subject.
4997
4998 set thread_received=yes
4999
5000
5001 # 3.344. tilde
5002
5003 # Type: boolean
5004 # Default: no
5005
5006 # When set, the internal-pager will pad blank lines to the bottom of the screen
5007 # with a tilde (“~”).
5008
5009 set tilde=yes
5010
5011
5012 # 3.345. time_inc
5013
5014 # Type: number
5015 # Default: 0
5016
5017 # Along with $read_inc, $write_inc, and $net_inc, this variable controls the
5018 # frequency with which progress updates are displayed. It suppresses updates less
5019 # than $time_inc milliseconds apart. This can improve throughput on systems with
5020 # slow terminals, or when running mutt on a remote system.
5021
5022 # Also see the “tuning” section of the manual for performance considerations.
5023
5024 set time_inc=250
5025
5026
5027 # 3.346. timeout
5028
5029 # Type: number
5030 # Default: 600
5031
5032 # When Mutt is waiting for user input either idling in menus or in an interactive
5033 # prompt, Mutt would block until input is present. Depending on the context, this
5034 # would prevent certain operations from working, like checking for new mail or
5035 # keeping an IMAP connection alive.
5036
5037 # This variable controls how many seconds Mutt will at most wait until it aborts
5038 # waiting for input, performs these operations and continues to wait for input.
5039
5040 # A value of zero or less will cause Mutt to never time out.
5041
5042
5043
5044 # 3.347. tmpdir
5045
5046 # Type: path
5047 # Default: (empty)
5048
5049 # This variable allows you to specify where Mutt will place its temporary files
5050 # needed for displaying and composing messages. If this variable is not set, the
5051 # environment variable $TMPDIR is used. If $TMPDIR is not set then “/tmp” is
5052 # used. 
5053
5054
5055
5056 # 3.348. to_chars
5057
5058 # Type: string
5059 # Default: “ +TCFL”
5060
5061 # Controls the character used to indicate mail addressed to you. The first
5062 # character is the one used when the mail is not addressed to your address. The
5063 # second is used when you are the only recipient of the message. The third is
5064 # when your address appears in the “To:” header field, but you are not the only
5065 # recipient of the message. The fourth character is used when your address is
5066 # specified in the “Cc:” header field, but you are not the only recipient. The
5067 # fifth character is used to indicate mail that was sent by you. The sixth
5068 # character is used to indicate when a mail was sent to a mailing-list you
5069 # subscribe to.
5070
5071
5072
5073 # 3.349. trash
5074
5075 # Type: path
5076 # Default: (empty)
5077
5078 # If set, this variable specifies the path of the trash folder where the mails
5079 # marked for deletion will be moved, instead of being irremediably purged.
5080
5081 # NOTE: When you delete a message in the trash folder, it is really deleted, so
5082 # that you have a way to clean the trash.
5083
5084
5085
5086 # 3.350. ts_icon_format
5087
5088 # Type: string
5089 # Default: “M%?n?AIL&ail?”
5090
5091 # Controls the format of the icon title, as long as “$ts_enabled” is set. This
5092 # string is identical in formatting to the one used by “$status_format”.
5093
5094
5095
5096 # 3.351. ts_enabled
5097
5098 # Type: boolean
5099 # Default: no
5100
5101 # Controls whether mutt tries to set the terminal status line and icon name. Most
5102 # terminal emulators emulate the status line in the window title.
5103
5104 set ts_enabled=yes
5105
5106
5107 # 3.352. ts_status_format
5108
5109 # Type: string
5110 # Default: “Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?”
5111
5112 # Controls the format of the terminal status line (or window title), provided
5113 # that “$ts_enabled” has been set. This string is identical in formatting to the
5114 # one used by “$status_format”.
5115
5116 set ts_status_format="[`tty|sed -re 's,.+pts/,,'`]mutt@%h%r %f%?V?[%V]&?"
5117
5118
5119 # 3.353. tunnel
5120
5121 # Type: string
5122 # Default: (empty)
5123
5124 # Setting this variable will cause mutt to open a pipe to a command instead of a
5125 # raw socket. You may be able to use this to set up preauthenticated connections
5126 # to your IMAP/POP3/SMTP server. Example:
5127
5128 # set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
5129
5130 # Note: For this example to work you must be able to log in to the remote machine
5131 # without having to enter a password.
5132
5133 # When set, Mutt uses the tunnel for all remote connections. Please see “
5134 # account-hook” in the manual for how to use different tunnel commands per
5135 # connection. 
5136
5137
5138
5139 # 3.354. uncollapse_jump
5140
5141 # Type: boolean
5142 # Default: no
5143
5144 # When set, Mutt will jump to the next unread message, if any, when the current
5145 # thread is uncollapsed.
5146
5147
5148
5149 # 3.355. uncollapse_new
5150
5151 # Type: boolean
5152 # Default: yes
5153
5154 # When set, Mutt will automatically uncollapse any collapsed thread that receives
5155 # a new message. When unset, collapsed threads will remain collapsed. the
5156 # presence of the new message will still affect index sorting, though.
5157
5158
5159
5160 # 3.356. use_8bitmime
5161
5162 # Type: boolean
5163 # Default: no
5164
5165 # Warning: do not set this variable unless you are using a version of sendmail
5166 # which supports the -B8BITMIME flag (such as sendmail 8.8.x) or you may not be
5167 # able to send mail.
5168
5169 # When set, Mutt will invoke $sendmail with the -B8BITMIME flag when sending
5170 # 8-bit messages to enable ESMTP negotiation.
5171
5172
5173
5174 # 3.357. use_domain
5175
5176 # Type: boolean
5177 # Default: yes
5178
5179 # When set, Mutt will qualify all local addresses (ones without the “@host”
5180 # portion) with the value of $hostname. If unset, no addresses will be qualified.
5181
5182
5183
5184 # 3.358. use_envelope_from
5185
5186 # Type: boolean
5187 # Default: no
5188
5189 # When set, mutt will set the envelope sender of the message. If
5190 # $envelope_from_address is set, it will be used as the sender address. If unset,
5191 # mutt will attempt to derive the sender from the “From:” header.
5192
5193 # Note that this information is passed to sendmail command using the -f command
5194 # line switch. Therefore setting this option is not useful if the $sendmail
5195 # variable already contains -f or if the executable pointed to by $sendmail
5196 # doesn't support the -f switch.
5197
5198 set use_envelope_from=yes
5199
5200
5201 # 3.359. use_from
5202
5203 # Type: boolean
5204 # Default: yes
5205
5206 # When set, Mutt will generate the “From:” header field when sending messages. If
5207 # unset, no “From:” header field will be generated unless the user explicitly
5208 # sets one using the “my_hdr” command.
5209
5210
5211
5212 # 3.360. use_ipv6
5213
5214 # Type: boolean
5215 # Default: yes
5216
5217 # When set, Mutt will look for IPv6 addresses of hosts it tries to contact. If
5218 # this option is unset, Mutt will restrict itself to IPv4 addresses. Normally,
5219 # the default should work.
5220
5221
5222
5223 # 3.361. user_agent
5224
5225 # Type: boolean
5226 # Default: yes
5227
5228 # When set, mutt will add a “User-Agent:” header to outgoing messages, indicating
5229 # which version of mutt was used for composing them.
5230
5231
5232
5233 # 3.362. visual
5234
5235 # Type: path
5236 # Default: (empty)
5237
5238 # Specifies the visual editor to invoke when the “~v” command is given in the
5239 # built-in editor.
5240
5241
5242
5243 # 3.363. wait_key
5244
5245 # Type: boolean
5246 # Default: yes
5247
5248 # Controls whether Mutt will ask you to press a key after an external command has
5249 # been invoked by these functions: <shell-escape>, <pipe-message>, <pipe-entry>,
5250 # <print-message>, and <print-entry> commands.
5251
5252 # It is also used when viewing attachments with “auto_view”, provided that the
5253 # corresponding mailcap entry has a needsterminal flag, and the external program
5254 # is interactive.
5255
5256 # When set, Mutt will always ask for a key. When unset, Mutt will wait for a key
5257 # only if the external command returned a non-zero status.
5258
5259 set wait_key=no
5260
5261
5262 # 3.364. weed
5263
5264 # Type: boolean
5265 # Default: yes
5266
5267 # When set, mutt will weed headers when displaying, forwarding, printing, or
5268 # replying to messages.
5269
5270
5271
5272 # 3.365. wrap
5273
5274 # Type: number
5275 # Default: 0
5276
5277 # When set to a positive value, mutt will wrap text at $wrap characters. When set
5278 # to a negative value, mutt will wrap text so that there are $wrap characters of
5279 # empty space on the right side of the terminal. Setting it to zero makes mutt
5280 # wrap at the terminal width.
5281
5282 # Also see $reflow_wrap.
5283
5284 set wrap=$reflow_wrap
5285
5286
5287 # 3.366. wrap_headers
5288
5289 # Type: number
5290 # Default: 78
5291
5292 # This option specifies the number of characters to use for wrapping an outgoing
5293 # message's headers. Allowed values are between 78 and 998 inclusive.
5294
5295 # Note: This option usually shouldn't be changed. RFC5233 recommends a line
5296 # length of 78 (the default), so please only change this setting when you know
5297 # what you're doing.
5298
5299
5300
5301 # 3.367. wrap_search
5302
5303 # Type: boolean
5304 # Default: yes
5305
5306 # Controls whether searches wrap around the end.
5307
5308 # When set, searches will wrap around the first (or last) item. When unset,
5309 # incremental searches will not wrap.
5310
5311
5312
5313 # 3.368. wrapmargin
5314
5315 # Type: number
5316 # Default: 0
5317
5318 # (DEPRECATED) Equivalent to setting $wrap with a negative value.
5319
5320
5321
5322 # 3.369. write_bcc
5323
5324 # Type: boolean
5325 # Default: yes
5326
5327 # Controls whether mutt writes out the “Bcc:” header when preparing messages to
5328 # be sent. Exim users may wish to unset this. If mutt is set to deliver directly
5329 # via SMTP (see $smtp_url), this option does nothing: mutt will never write out
5330 # the “Bcc:” header in this case.
5331
5332
5333
5334 # 3.370. write_inc
5335
5336 # Type: number
5337 # Default: 10
5338
5339 # When writing a mailbox, a message will be printed every $write_inc messages to
5340 # indicate progress. If set to 0, only a single message will be displayed before
5341 # writing a mailbox.
5342
5343 # Also see the $read_inc, $net_inc and $time_inc variables and the “tuning”
5344 # section of the manual for performance considerations.
5345
5346
5347 # vim:sw=12:noet:sts=12:ts=12:ft=muttrc