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