]> git.madduck.net Git - etc/mutt.git/blob - .config/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:

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