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

madduck's git repository

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

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

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

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

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

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