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

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