]> 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:

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