]> git.llucax.com Git - software/mutt-debian.git/blob - doc/Muttrc
Add upstream/542344-dont_fold_From_: Do not wrap From_ header (Closes: #542344)
[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 themseves 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 abled 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 \Fi``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 autodetected 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 autodetected 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 builtin 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 # %f      filename (``/'' is appended to directory names,
1081 #         ``@'' to symbolic links and ``*'' to executable
1082 #         files)
1083 # %F      file permissions
1084 # %g      group name (or numeric gid, if missing)
1085 # %l      number of hard links
1086 # %N      N if folder has new mail, blank otherwise
1087 # %s      size in bytes
1088 # %t      ``*'' if the file is tagged, blank otherwise
1089 # %u      owner name (or numeric uid, if missing)
1090 # %>X     right justify the rest of the string and pad with character ``X''
1091 # %|X     pad to the end of the line with character ``X''
1092 # %*X     soft-fill with character ``X'' as pad
1093
1094
1095 # For an explanation of ``soft-fill'', see the $index_format documentation.
1096
1097
1098 # set followup_to=yes
1099 #
1100 # Name: followup_to
1101 # Type: boolean
1102 # Default: yes
1103
1104
1105 # Controls whether or not the ``Mail-Followup-To:'' header field is
1106 # generated when sending mail.  When set, Mutt will generate this
1107 # field when you are replying to a known mailing list, specified with
1108 # the ``subscribe'' or ``lists'' commands.
1109
1110 # This field has two purposes.  First, preventing you from
1111 # receiving duplicate copies of replies to messages which you send
1112 # to mailing lists, and second, ensuring that you do get a reply
1113 # separately for any messages sent to known lists to which you are
1114 # not subscribed.
1115
1116 # The header will contain only the list's address
1117 # for subscribed lists, and both the list address and your own
1118 # email address for unsubscribed lists.  Without this header, a
1119 # group reply to your message sent to a subscribed list will be
1120 # sent to both the list and your address, resulting in two copies
1121 # of the same email for you.
1122
1123
1124 # set force_name=no
1125 #
1126 # Name: force_name
1127 # Type: boolean
1128 # Default: no
1129
1130
1131 # This variable is similar to $save_name, except that Mutt will
1132 # store a copy of your outgoing message by the username of the address
1133 # you are sending to even if that mailbox does not exist.
1134
1135 # Also see the $record variable.
1136
1137
1138 # set forward_decode=yes
1139 #
1140 # Name: forward_decode
1141 # Type: boolean
1142 # Default: yes
1143
1144
1145 # Controls the decoding of complex MIME messages into text/plain when
1146 # forwarding a message.  The message header is also RFC2047 decoded.
1147 # This variable is only used, if $mime_forward is unset,
1148 # otherwise $mime_forward_decode is used instead.
1149
1150
1151 # set forward_decrypt=yes
1152 #
1153 # Name: forward_decrypt
1154 # Type: boolean
1155 # Default: yes
1156
1157
1158 # Controls the handling of encrypted messages when forwarding a message.
1159 # When set, the outer layer of encryption is stripped off.  This
1160 # variable is only used if $mime_forward is set and
1161 # $mime_forward_decode is unset.
1162 # (PGP only)
1163
1164
1165 # set forward_edit=yes
1166 #
1167 # Name: forward_edit
1168 # Type: quadoption
1169 # Default: yes
1170
1171
1172 # This quadoption controls whether or not the user is automatically
1173 # placed in the editor when forwarding messages.  For those who always want
1174 # to forward with no modification, use a setting of ``no''.
1175
1176
1177 # set forward_format="[%a: %s]"
1178 #
1179 # Name: forward_format
1180 # Type: string
1181 # Default: "[%a: %s]"
1182
1183
1184 # This variable controls the default subject when forwarding a message.
1185 # It uses the same format sequences as the $index_format variable.
1186
1187
1188 # set forward_quote=no
1189 #
1190 # Name: forward_quote
1191 # Type: boolean
1192 # Default: no
1193
1194
1195 # When set, forwarded messages included in the main body of the
1196 # message (when $mime_forward is unset) will be quoted using
1197 # $indent_string.
1198
1199
1200 # set from=""
1201 #
1202 # Name: from
1203 # Type: e-mail address
1204 # Default: ""
1205
1206
1207 # When set, this variable contains a default from address.  It
1208 # can be overridden using ``my_hdr'' (including from a ``send-hook'') and
1209 # $reverse_name.  This variable is ignored if $use_from is unset.
1210
1211 # This setting defaults to the contents of the environment variable $EMAIL.
1212
1213
1214 # set gecos_mask="^[^,]*"
1215 #
1216 # Name: gecos_mask
1217 # Type: regular expression
1218 # Default: "^[^,]*"
1219
1220
1221 # A regular expression used by mutt to parse the GECOS field of a password
1222 # entry when expanding the alias.  The default value
1223 # will return the string up to the first ``,'' encountered.
1224 # If the GECOS field contains a string like ``lastname, firstname'' then you
1225 # should set it to ``.*''.
1226
1227 # This can be useful if you see the following behavior: you address an e-mail
1228 # to user ID ``stevef'' whose full name is ``Steve Franklin''.  If mutt expands
1229 # ``stevef'' to ``"Franklin" stevef@foo.bar'' then you should set the $gecos_mask to
1230 # a regular expression that will match the whole name so mutt will expand
1231 # ``Franklin'' to ``Franklin, Steve''.
1232
1233
1234 # set hdrs=yes
1235 #
1236 # Name: hdrs
1237 # Type: boolean
1238 # Default: yes
1239
1240
1241 # When unset, the header fields normally added by the ``my_hdr''
1242 # command are not created.  This variable must be unset before
1243 # composing a new message or replying in order to take effect.  If set,
1244 # the user defined header fields are added to every new message.
1245
1246
1247 # set header=no
1248 #
1249 # Name: header
1250 # Type: boolean
1251 # Default: no
1252
1253
1254 # When set, this variable causes Mutt to include the header
1255 # of the message you are replying to into the edit buffer.
1256 # The $weed setting applies.
1257
1258
1259 # set header_cache=""
1260 #
1261 # Name: header_cache
1262 # Type: path
1263 # Default: ""
1264
1265
1266 # This variable points to the header cache database.
1267 # If pointing to a directory Mutt will contain a header cache
1268 # database file per folder, if pointing to a file that file will
1269 # be a single global header cache. By default it is unset so no header
1270 # caching will be used.
1271
1272 # Header caching can greatly improve speed when opening POP, IMAP
1273 # MH or Maildir folders, see ``caching'' for details.
1274
1275
1276 # set header_cache_compress=yes
1277 #
1278 # Name: header_cache_compress
1279 # Type: boolean
1280 # Default: yes
1281
1282
1283 # When mutt is compiled with qdbm or tokyocabinet as header cache backend,
1284 # this option determines whether the database will be compressed.
1285 # Compression results in database files roughly being one fifth
1286 # of the usual diskspace, but the uncompression can result in a
1287 # slower opening of cached folder(s) which in general is still
1288 # much faster than opening non header cached folders.
1289
1290
1291 # set header_cache_pagesize="16384"
1292 #
1293 # Name: header_cache_pagesize
1294 # Type: string
1295 # Default: "16384"
1296
1297
1298 # When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1299 # this option changes the database page size.  Too large or too small
1300 # values can waste space, memory, or CPU time. The default should be more
1301 # or less optimal for most use cases.
1302
1303
1304 # set help=yes
1305 #
1306 # Name: help
1307 # Type: boolean
1308 # Default: yes
1309
1310
1311 # When set, help lines describing the bindings for the major functions
1312 # provided by each menu are displayed on the first line of the screen.
1313
1314 # Note: The binding will not be displayed correctly if the
1315 # function is bound to a sequence rather than a single keystroke.  Also,
1316 # the help line may not be updated if a binding is changed while Mutt is
1317 # running.  Since this variable is primarily aimed at new users, neither
1318 # of these should present a major problem.
1319
1320
1321 # set hidden_host=no
1322 #
1323 # Name: hidden_host
1324 # Type: boolean
1325 # Default: no
1326
1327
1328 # When set, mutt will skip the host name part of $hostname variable
1329 # when adding the domain part to addresses.  This variable does not
1330 # affect the generation of Message-IDs, and it will not lead to the
1331 # cut-off of first-level domains.
1332
1333
1334 # set hide_limited=no
1335 #
1336 # Name: hide_limited
1337 # Type: boolean
1338 # Default: no
1339
1340
1341 # When set, mutt will not show the presence of messages that are hidden
1342 # by limiting, in the thread tree.
1343
1344
1345 # set hide_missing=yes
1346 #
1347 # Name: hide_missing
1348 # Type: boolean
1349 # Default: yes
1350
1351
1352 # When set, mutt will not show the presence of missing messages in the
1353 # thread tree.
1354
1355
1356 # set hide_thread_subject=yes
1357 #
1358 # Name: hide_thread_subject
1359 # Type: boolean
1360 # Default: yes
1361
1362
1363 # When set, mutt will not show the subject of messages in the thread
1364 # tree that have the same subject as their parent or closest previously
1365 # displayed sibling.
1366
1367
1368 # set hide_top_limited=no
1369 #
1370 # Name: hide_top_limited
1371 # Type: boolean
1372 # Default: no
1373
1374
1375 # When set, mutt will not show the presence of messages that are hidden
1376 # by limiting, at the top of threads in the thread tree.  Note that when
1377 # $hide_limited is set, this option will have no effect.
1378
1379
1380 # set hide_top_missing=yes
1381 #
1382 # Name: hide_top_missing
1383 # Type: boolean
1384 # Default: yes
1385
1386
1387 # When set, mutt will not show the presence of missing messages at the
1388 # top of threads in the thread tree.  Note that when $hide_missing is
1389 # set, this option will have no effect.
1390
1391
1392 # set history=10
1393 #
1394 # Name: history
1395 # Type: number
1396 # Default: 10
1397
1398
1399 # This variable controls the size (in number of strings remembered) of
1400 # the string history buffer per category. The buffer is cleared each time the
1401 # variable is set.
1402
1403
1404 # set history_file="~/.mutthistory"
1405 #
1406 # Name: history_file
1407 # Type: path
1408 # Default: "~/.mutthistory"
1409
1410
1411 # The file in which Mutt will save its history.
1412
1413
1414 # set honor_disposition=no
1415 #
1416 # Name: honor_disposition
1417 # Type: boolean
1418 # Default: no
1419
1420
1421 # When set, Mutt will not display attachments with a
1422 # disposition of ``attachment'' inline even if it could
1423 # render the part to plain text. These MIME parts can only
1424 # be viewed from the attachment menu.
1425
1426 # If unset, Mutt will render all MIME parts it can
1427 # properly transform to plain text.
1428
1429
1430 # set honor_followup_to=yes
1431 #
1432 # Name: honor_followup_to
1433 # Type: quadoption
1434 # Default: yes
1435
1436
1437 # This variable controls whether or not a Mail-Followup-To header is
1438 # honored when group-replying to a message.
1439
1440
1441 # set hostname=""
1442 #
1443 # Name: hostname
1444 # Type: string
1445 # Default: ""
1446
1447
1448 # Specifies the fully-qualified hostname of the system mutt is running on
1449 # containing the host's name and the DNS domain it belongs to. It is used
1450 # as the domain part (after ``@'') for local email addresses as well as
1451 # Message-Id headers.
1452
1453 # Its value is determined at startup as follows: If the node's name
1454 # as returned by the uname(3) function contains the hostname and the
1455 # domain, these are used to construct $hostname. If there is no
1456 # domain part returned, Mutt will look for a ``domain'' or ``search''
1457 # line in /etc/resolv.conf to determine the domain. Optionally, Mutt
1458 # can be compiled with a fixed domain name in which case a detected
1459 # one is not used.
1460
1461 # Also see $use_domain and $hidden_host.
1462
1463
1464 # set ignore_linear_white_space=no
1465 #
1466 # Name: ignore_linear_white_space
1467 # Type: boolean
1468 # Default: no
1469
1470
1471 # This option replaces linear-white-space between encoded-word
1472 # and text to a single space to prevent the display of MIME-encoded
1473 # ``Subject:'' field from being divided into multiple lines.
1474
1475
1476 # set ignore_list_reply_to=no
1477 #
1478 # Name: ignore_list_reply_to
1479 # Type: boolean
1480 # Default: no
1481
1482
1483 # Affects the behaviour of the <reply> function when replying to
1484 # messages from mailing lists (as defined by the ``subscribe'' or
1485 # ``lists'' commands).  When set, if the ``Reply-To:'' field is
1486 # set to the same value as the ``To:'' field, Mutt assumes that the
1487 # ``Reply-To:'' field was set by the mailing list to automate responses
1488 # to the list, and will ignore this field.  To direct a response to the
1489 # mailing list when this option is set, use the <list-reply>
1490 # function; <group-reply> will reply to both the sender and the
1491 # list.
1492
1493
1494 # set imap_authenticators=""
1495 #
1496 # Name: imap_authenticators
1497 # Type: string
1498 # Default: ""
1499
1500
1501 # This is a colon-delimited list of authentication methods mutt may
1502 # attempt to use to log in to an IMAP server, in the order mutt should
1503 # try them.  Authentication methods are either ``login'' or the right
1504 # side of an IMAP ``AUTH=xxx'' capability string, eg ``digest-md5'', ``gssapi''
1505 # or ``cram-md5''. This option is case-insensitive. If it's
1506 # unset (the default) mutt will try all available methods,
1507 # in order from most-secure to least-secure.
1508
1509 # Example:
1510 # set imap_authenticators="gssapi:cram-md5:login"
1511
1512 # Note: Mutt will only fall back to other authentication methods if
1513 # the previous methods are unavailable. If a method is available but
1514 # authentication fails, mutt will not connect to the IMAP server.
1515
1516
1517 # set imap_check_subscribed=no
1518 #
1519 # Name: imap_check_subscribed
1520 # Type: boolean
1521 # Default: no
1522
1523
1524 # When set, mutt will fetch the set of subscribed folders from
1525 # your server on connection, and add them to the set of mailboxes
1526 # it polls for new mail just as if you had issued individual ``mailboxes''
1527 # commands.
1528
1529
1530 # set imap_delim_chars="/."
1531 #
1532 # Name: imap_delim_chars
1533 # Type: string
1534 # Default: "/."
1535
1536
1537 # This contains the list of characters which you would like to treat
1538 # as folder separators for displaying IMAP paths. In particular it
1539 # helps in using the ``='' shortcut for your folder variable.
1540
1541
1542 # set imap_headers=""
1543 #
1544 # Name: imap_headers
1545 # Type: string
1546 # Default: ""
1547
1548
1549 # Mutt requests these header fields in addition to the default headers
1550 # (``Date:'', ``From:'', ``Subject:'', ``To:'', ``Cc:'', ``Message-Id:'',
1551 # ``References:'', ``Content-Type:'', ``Content-Description:'', ``In-Reply-To:'',
1552 # ``Reply-To:'', ``Lines:'', ``List-Post:'', ``X-Label:'') from IMAP
1553 # servers before displaying the index menu. You may want to add more
1554 # headers for spam detection.
1555
1556 # Note: This is a space separated list, items should be uppercase
1557 # and not contain the colon, e.g. ``X-BOGOSITY X-SPAM-STATUS'' for the
1558 # ``X-Bogosity:'' and ``X-Spam-Status:'' header fields.
1559
1560
1561 # set imap_idle=no
1562 #
1563 # Name: imap_idle
1564 # Type: boolean
1565 # Default: no
1566
1567
1568 # When set, mutt will attempt to use the IMAP IDLE extension
1569 # to check for new mail in the current mailbox. Some servers
1570 # (dovecot was the inspiration for this option) react badly
1571 # to mutt's implementation. If your connection seems to freeze
1572 # up periodically, try unsetting this.
1573
1574
1575 # set imap_keepalive=900
1576 #
1577 # Name: imap_keepalive
1578 # Type: number
1579 # Default: 900
1580
1581
1582 # This variable specifies the maximum amount of time in seconds that mutt
1583 # will wait before polling open IMAP connections, to prevent the server
1584 # from closing them before mutt has finished with them. The default is
1585 # well within the RFC-specified minimum amount of time (30 minutes) before
1586 # a server is allowed to do this, but in practice the RFC does get
1587 # violated every now and then. Reduce this number if you find yourself
1588 # getting disconnected from your IMAP server due to inactivity.
1589
1590
1591 # set imap_list_subscribed=no
1592 #
1593 # Name: imap_list_subscribed
1594 # Type: boolean
1595 # Default: no
1596
1597
1598 # This variable configures whether IMAP folder browsing will look for
1599 # only subscribed folders or all folders.  This can be toggled in the
1600 # IMAP browser with the <toggle-subscribed> function.
1601
1602
1603 # set imap_login=""
1604 #
1605 # Name: imap_login
1606 # Type: string
1607 # Default: ""
1608
1609
1610 # Your login name on the IMAP server.
1611
1612 # This variable defaults to the value of $imap_user.
1613
1614
1615 # set imap_pass=""
1616 #
1617 # Name: imap_pass
1618 # Type: string
1619 # Default: ""
1620
1621
1622 # Specifies the password for your IMAP account.  If unset, Mutt will
1623 # prompt you for your password when you invoke the <imap-fetch-mail> function
1624 # or try to open an IMAP folder.
1625
1626 # Warning: you should only use this option when you are on a
1627 # fairly secure machine, because the superuser can read your muttrc even
1628 # if you are the only one who can read the file.
1629
1630
1631 # set imap_passive=yes
1632 #
1633 # Name: imap_passive
1634 # Type: boolean
1635 # Default: yes
1636
1637
1638 # When set, mutt will not open new IMAP connections to check for new
1639 # mail.  Mutt will only check for new mail over existing IMAP
1640 # connections.  This is useful if you don't want to be prompted to
1641 # user/password pairs on mutt invocation, or if opening the connection
1642 # is slow.
1643
1644
1645 # set imap_peek=yes
1646 #
1647 # Name: imap_peek
1648 # Type: boolean
1649 # Default: yes
1650
1651
1652 # When set, mutt will avoid implicitly marking your mail as read whenever
1653 # you fetch a message from the server. This is generally a good thing,
1654 # but can make closing an IMAP folder somewhat slower. This option
1655 # exists to appease speed freaks.
1656
1657
1658 # set imap_pipeline_depth=15
1659 #
1660 # Name: imap_pipeline_depth
1661 # Type: number
1662 # Default: 15
1663
1664
1665 # Controls the number of IMAP commands that may be queued up before they
1666 # are sent to the server. A deeper pipeline reduces the amount of time
1667 # mutt must wait for the server, and can make IMAP servers feel much
1668 # more responsive. But not all servers correctly handle pipelined commands,
1669 # so if you have problems you might want to try setting this variable to 0.
1670
1671 # Note: Changes to this variable have no effect on open connections.
1672
1673
1674 # set imap_servernoise=yes
1675 #
1676 # Name: imap_servernoise
1677 # Type: boolean
1678 # Default: yes
1679
1680
1681 # When set, mutt will display warning messages from the IMAP
1682 # server as error messages. Since these messages are often
1683 # harmless, or generated due to configuration problems on the
1684 # server which are out of the users' hands, you may wish to suppress
1685 # them at some point.
1686
1687
1688 # set imap_user=""
1689 #
1690 # Name: imap_user
1691 # Type: string
1692 # Default: ""
1693
1694
1695 # The name of the user whose mail you intend to access on the IMAP
1696 # server.
1697
1698 # This variable defaults to your user name on the local machine.
1699
1700
1701 # set implicit_autoview=no
1702 #
1703 # Name: implicit_autoview
1704 # Type: boolean
1705 # Default: no
1706
1707
1708 # If set to ``yes'', mutt will look for a mailcap entry with the
1709 # ``copiousoutput'' flag set for every MIME attachment it doesn't have
1710 # an internal viewer defined for.  If such an entry is found, mutt will
1711 # use the viewer defined in that entry to convert the body part to text
1712 # form.
1713
1714
1715 # set include=ask-yes
1716 #
1717 # Name: include
1718 # Type: quadoption
1719 # Default: ask-yes
1720
1721
1722 # Controls whether or not a copy of the message(s) you are replying to
1723 # is included in your reply.
1724
1725
1726 # set include_onlyfirst=no
1727 #
1728 # Name: include_onlyfirst
1729 # Type: boolean
1730 # Default: no
1731
1732
1733 # Controls whether or not Mutt includes only the first attachment
1734 # of the message you are replying.
1735
1736
1737 # set indent_string="> "
1738 #
1739 # Name: indent_string
1740 # Type: string
1741 # Default: "> "
1742
1743
1744 # Specifies the string to prepend to each line of text quoted in a
1745 # message to which you are replying.  You are strongly encouraged not to
1746 # change this value, as it tends to agitate the more fanatical netizens.
1747
1748 # The value of this option is ignored if $text_flowed is set, too because
1749 # the quoting mechanism is strictly defined for format=flowed.
1750
1751 # This option is a format string, please see the description of
1752 # $index_format for supported printf(3)-style sequences.
1753
1754
1755 # set index_format="%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"
1756 #
1757 # Name: index_format
1758 # Type: string
1759 # Default: "%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"
1760
1761
1762 # This variable allows you to customize the message index display to
1763 # your personal taste.
1764
1765 # ``Format strings'' are similar to the strings used in the C
1766 # function printf(3) to format output (see the man page for more details).
1767 # The following sequences are defined in Mutt:
1768 # %a      address of the author
1769 # %A      reply-to address (if present; otherwise: address of author)
1770 # %b      filename of the original message folder (think mailbox)
1771 # %B      the list to which the letter was sent, or else the folder name (%b).
1772 # %c      number of characters (bytes) in the message
1773 # %C      current message number
1774 # %d      date and time of the message in the format specified by
1775 # $date_format         converted to sender's time zone
1776 # %D      date and time of the message in the format specified by
1777 # $date_format         converted to the local time zone
1778 # %e      current message number in thread
1779 # %E      number of messages in current thread
1780 # %f      sender (address + real name), either From: or Return-Path:
1781 # %F      author name, or recipient name if the message is from you
1782 # %H      spam attribute(s) of this message
1783 # %i      message-id of the current message
1784 # %l      number of lines in the message (does not work with maildir,
1785 #         mh, and possibly IMAP folders)
1786 # %L      If an address in the ``To:'' or ``Cc:'' header field matches an address
1787 #         defined by the users ``subscribe'' command, this displays
1788 #         "To <list-name>", otherwise the same as %F.
1789 # %m      total number of message in the mailbox
1790 # %M      number of hidden messages if the thread is collapsed.
1791 # %N      message score
1792 # %n      author's real name (or address if missing)
1793 # %O      original save folder where mutt would formerly have
1794 #         stashed the message: list name or recipient name
1795 #         if not sent to a list
1796 # %P      progress indicator for the builtin pager (how much of the file has been displayed)
1797 # %s      subject of the message
1798 # %S      status of the message (``N''/``D''/``d''/``!''/``r''/*)
1799 # %t      ``To:'' field (recipients)
1800 # %T      the appropriate character from the $to_chars string
1801 # %u      user (login) name of the author
1802 # %v      first name of the author, or the recipient if the message is from you
1803 # %X      number of attachments
1804 #         (please see the ``attachments'' section for possible speed effects)
1805 # %y      ``X-Label:'' field, if present
1806 # %Y      ``X-Label:'' field, if present, and (1) not at part of a thread tree,
1807 #         (2) at the top of a thread, or (3) ``X-Label:'' is different from
1808 #         preceding message's ``X-Label:''.
1809 # %Z      message status flags
1810 # %{fmt}  the date and time of the message is converted to sender's
1811 #         time zone, and ``fmt'' is expanded by the library function
1812 #         strftime(3); a leading bang disables locales
1813 # %[fmt]  the date and time of the message is converted to the local
1814 #         time zone, and ``fmt'' is expanded by the library function
1815 #         strftime(3); a leading bang disables locales
1816 # %(fmt)  the local date and time when the message was received.
1817 #         ``fmt'' is expanded by the library function strftime(3);
1818 #         a leading bang disables locales
1819 # %<fmt>  the current local time. ``fmt'' is expanded by the library
1820 #         function strftime(3); a leading bang disables locales.
1821 # %>X     right justify the rest of the string and pad with character ``X''
1822 # %|X     pad to the end of the line with character ``X''
1823 # %*X     soft-fill with character ``X'' as pad
1824
1825
1826 # ``Soft-fill'' deserves some explanation: Normal right-justification
1827 # will print everything to the left of the ``%>'', displaying padding and
1828 # whatever lies to the right only if there's room. By contrast,
1829 # soft-fill gives priority to the right-hand side, guaranteeing space
1830 # to display it and showing padding only if there's still room. If
1831 # necessary, soft-fill will eat text leftwards to make room for
1832 # rightward text.
1833
1834 # Note that these expandos are supported in
1835 # ``save-hook'', ``fcc-hook'' and ``fcc-save-hook'', too.
1836
1837
1838 # set ispell="ispell"
1839 #
1840 # Name: ispell
1841 # Type: path
1842 # Default: "ispell"
1843
1844
1845 # How to invoke ispell (GNU's spell-checking software).
1846
1847
1848 # set keep_flagged=no
1849 #
1850 # Name: keep_flagged
1851 # Type: boolean
1852 # Default: no
1853
1854
1855 # If set, read messages marked as flagged will not be moved
1856 # from your spool mailbox to your $mbox mailbox, or as a result of
1857 # a ``mbox-hook'' command.
1858
1859
1860 # set locale="C"
1861 #
1862 # Name: locale
1863 # Type: string
1864 # Default: "C"
1865
1866
1867 # The locale used by strftime(3) to format dates. Legal values are
1868 # the strings your system accepts for the locale environment variable $LC_TIME.
1869
1870
1871 # set mail_check=5
1872 #
1873 # Name: mail_check
1874 # Type: number
1875 # Default: 5
1876
1877
1878 # This variable configures how often (in seconds) mutt should look for
1879 # new mail. Also see the $timeout variable.
1880
1881
1882 # set mailcap_path=""
1883 #
1884 # Name: mailcap_path
1885 # Type: string
1886 # Default: ""
1887
1888
1889 # This variable specifies which files to consult when attempting to
1890 # display MIME bodies not directly supported by Mutt.
1891
1892
1893 # set mailcap_sanitize=yes
1894 #
1895 # Name: mailcap_sanitize
1896 # Type: boolean
1897 # Default: yes
1898
1899
1900 # If set, mutt will restrict possible characters in mailcap % expandos
1901 # to a well-defined set of safe characters.  This is the safe setting,
1902 # but we are not sure it doesn't break some more advanced MIME stuff.
1903
1904 # DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
1905 # DOING!
1906
1907
1908 # set maildir_header_cache_verify=yes
1909 #
1910 # Name: maildir_header_cache_verify
1911 # Type: boolean
1912 # Default: yes
1913
1914
1915 # Check for Maildir unaware programs other than mutt having modified maildir
1916 # files when the header cache is in use.  This incurs one stat(2) per
1917 # message every time the folder is opened (which can be very slow for NFS
1918 # folders).
1919
1920
1921 # set maildir_trash=no
1922 #
1923 # Name: maildir_trash
1924 # Type: boolean
1925 # Default: no
1926
1927
1928 # If set, messages marked as deleted will be saved with the maildir
1929 # trashed flag instead of unlinked.  Note: this only applies
1930 # to maildir-style mailboxes.  Setting it will have no effect on other
1931 # mailbox types.
1932
1933
1934 # set mark_old=yes
1935 #
1936 # Name: mark_old
1937 # Type: boolean
1938 # Default: yes
1939
1940
1941 # Controls whether or not mutt marks new unread
1942 # messages as old if you exit a mailbox without reading them.
1943 # With this option set, the next time you start mutt, the messages
1944 # will show up with an ``O'' next to them in the index menu,
1945 # indicating that they are old.
1946
1947
1948 # set markers=yes
1949 #
1950 # Name: markers
1951 # Type: boolean
1952 # Default: yes
1953
1954
1955 # Controls the display of wrapped lines in the internal pager. If set, a
1956 # ``+'' marker is displayed at the beginning of wrapped lines.
1957
1958 # Also see the $smart_wrap variable.
1959
1960
1961 # set mask="!^\\.[^.]"
1962 #
1963 # Name: mask
1964 # Type: regular expression
1965 # Default: "!^\\.[^.]"
1966
1967
1968 # A regular expression used in the file browser, optionally preceded by
1969 # the not operator ``!''.  Only files whose names match this mask
1970 # will be shown. The match is always case-sensitive.
1971
1972
1973 # set mbox="~/mbox"
1974 #
1975 # Name: mbox
1976 # Type: path
1977 # Default: "~/mbox"
1978
1979
1980 # This specifies the folder into which read mail in your $spoolfile
1981 # folder will be appended.
1982
1983 # Also see the $move variable.
1984
1985
1986 # set mbox_type=mbox
1987 #
1988 # Name: mbox_type
1989 # Type: folder magic
1990 # Default: mbox
1991
1992
1993 # The default mailbox type used when creating new folders. May be any of
1994 # ``mbox'', ``MMDF'', ``MH'' and ``Maildir''. This is overriden by the
1995 # -m command-line option.
1996
1997
1998 # set menu_context=0
1999 #
2000 # Name: menu_context
2001 # Type: number
2002 # Default: 0
2003
2004
2005 # This variable controls the number of lines of context that are given
2006 # when scrolling through menus. (Similar to $pager_context.)
2007
2008
2009 # set menu_move_off=yes
2010 #
2011 # Name: menu_move_off
2012 # Type: boolean
2013 # Default: yes
2014
2015
2016 # When unset, the bottom entry of menus will never scroll up past
2017 # the bottom of the screen, unless there are less entries than lines.
2018 # When set, the bottom entry may move off the bottom.
2019
2020
2021 # set menu_scroll=no
2022 #
2023 # Name: menu_scroll
2024 # Type: boolean
2025 # Default: no
2026
2027
2028 # When set, menus will be scrolled up or down one line when you
2029 # attempt to move across a screen boundary.  If unset, the screen
2030 # is cleared and the next or previous page of the menu is displayed
2031 # (useful for slow links to avoid many redraws).
2032
2033
2034 # set message_cache_clean=no
2035 #
2036 # Name: message_cache_clean
2037 # Type: boolean
2038 # Default: no
2039
2040
2041 # If set, mutt will clean out obsolete entries from the message cache when
2042 # the mailbox is synchronized. You probably only want to set it
2043 # every once in a while, since it can be a little slow
2044 # (especially for large folders).
2045
2046
2047 # set message_cachedir=""
2048 #
2049 # Name: message_cachedir
2050 # Type: path
2051 # Default: ""
2052
2053
2054 # Set this to a directory and mutt will cache copies of messages from
2055 # your IMAP and POP servers here. You are free to remove entries at any
2056 # time.
2057
2058 # When setting this variable to a directory, mutt needs to fetch every
2059 # remote message only once and can perform regular expression searches
2060 # as fast as for local folders.
2061
2062 # Also see the $message_cache_clean variable.
2063
2064
2065 # set message_format="%s"
2066 #
2067 # Name: message_format
2068 # Type: string
2069 # Default: "%s"
2070
2071
2072 # This is the string displayed in the ``attachment'' menu for
2073 # attachments of type message/rfc822.  For a full listing of defined
2074 # printf(3)-like sequences see the section on $index_format.
2075
2076
2077 # set meta_key=no
2078 #
2079 # Name: meta_key
2080 # Type: boolean
2081 # Default: no
2082
2083
2084 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8)
2085 # set as if the user had pressed the Esc key and whatever key remains
2086 # after having the high bit removed.  For example, if the key pressed
2087 # has an ASCII value of 0xf8, then this is treated as if the user had
2088 # pressed Esc then ``x''.  This is because the result of removing the
2089 # high bit from 0xf8 is 0x78, which is the ASCII character
2090 # ``x''.
2091
2092
2093 # set metoo=no
2094 #
2095 # Name: metoo
2096 # Type: boolean
2097 # Default: no
2098
2099
2100 # If unset, Mutt will remove your address (see the ``alternates''
2101 # command) from the list of recipients when replying to a message.
2102
2103
2104 # set mh_purge=no
2105 #
2106 # Name: mh_purge
2107 # Type: boolean
2108 # Default: no
2109
2110
2111 # When unset, mutt will mimic mh's behaviour and rename deleted messages
2112 # to ,<old file name> in mh folders instead of really deleting
2113 # them. This leaves the message on disk but makes programs reading the folder
2114 # ignore it. If the variable is set, the message files will simply be
2115 # deleted.
2116
2117 # This option is similar to $maildir_trash for Maildir folders.
2118
2119
2120 # set mh_seq_flagged="flagged"
2121 #
2122 # Name: mh_seq_flagged
2123 # Type: string
2124 # Default: "flagged"
2125
2126
2127 # The name of the MH sequence used for flagged messages.
2128
2129
2130 # set mh_seq_replied="replied"
2131 #
2132 # Name: mh_seq_replied
2133 # Type: string
2134 # Default: "replied"
2135
2136
2137 # The name of the MH sequence used to tag replied messages.
2138
2139
2140 # set mh_seq_unseen="unseen"
2141 #
2142 # Name: mh_seq_unseen
2143 # Type: string
2144 # Default: "unseen"
2145
2146
2147 # The name of the MH sequence used for unseen messages.
2148
2149
2150 # set mime_forward=no
2151 #
2152 # Name: mime_forward
2153 # Type: quadoption
2154 # Default: no
2155
2156
2157 # When set, the message you are forwarding will be attached as a
2158 # separate message/rfc822 MIME part instead of included in the main body of the
2159 # message.  This is useful for forwarding MIME messages so the receiver
2160 # can properly view the message as it was delivered to you. If you like
2161 # to switch between MIME and not MIME from mail to mail, set this
2162 # variable to ``ask-no'' or ``ask-yes''.
2163
2164 # Also see $forward_decode and $mime_forward_decode.
2165
2166
2167 # set mime_forward_decode=no
2168 #
2169 # Name: mime_forward_decode
2170 # Type: boolean
2171 # Default: no
2172
2173
2174 # Controls the decoding of complex MIME messages into text/plain when
2175 # forwarding a message while $mime_forward is set. Otherwise
2176 # $forward_decode is used instead.
2177
2178
2179 # set mime_forward_rest=yes
2180 #
2181 # Name: mime_forward_rest
2182 # Type: quadoption
2183 # Default: yes
2184
2185
2186 # When forwarding multiple attachments of a MIME message from the attachment
2187 # menu, attachments which cannot be decoded in a reasonable manner will
2188 # be attached to the newly composed message if this option is set.
2189
2190
2191 # set mix_entry_format="%4n %c %-16s %a"
2192 #
2193 # Name: mix_entry_format
2194 # Type: string
2195 # Default: "%4n %c %-16s %a"
2196
2197
2198 # This variable describes the format of a remailer line on the mixmaster
2199 # chain selection screen.  The following printf(3)-like sequences are
2200 # supported:
2201 # %n      The running number on the menu.
2202 # %c      Remailer capabilities.
2203 # %s      The remailer's short name.
2204 # %a      The remailer's e-mail address.
2205
2206
2207 # set mixmaster="mixmaster"
2208 #
2209 # Name: mixmaster
2210 # Type: path
2211 # Default: "mixmaster"
2212
2213
2214 # This variable contains the path to the Mixmaster binary on your
2215 # system.  It is used with various sets of parameters to gather the
2216 # list of known remailers, and to finally send a message through the
2217 # mixmaster chain.
2218
2219
2220 # set move=no
2221 #
2222 # Name: move
2223 # Type: quadoption
2224 # Default: no
2225
2226
2227 # Controls whether or not Mutt will move read messages
2228 # from your spool mailbox to your $mbox mailbox, or as a result of
2229 # a ``mbox-hook'' command.
2230
2231
2232 # set narrow_tree=no
2233 #
2234 # Name: narrow_tree
2235 # Type: boolean
2236 # Default: no
2237
2238
2239 # This variable, when set, makes the thread tree narrower, allowing
2240 # deeper threads to fit on the screen.
2241
2242
2243 # set net_inc=10
2244 #
2245 # Name: net_inc
2246 # Type: number
2247 # Default: 10
2248
2249
2250 # Operations that expect to transfer a large amount of data over the
2251 # network will update their progress every $net_inc kilobytes.
2252 # If set to 0, no progress messages will be displayed.
2253
2254 # See also $read_inc, $write_inc and $net_inc.
2255
2256
2257 # set pager="builtin"
2258 #
2259 # Name: pager
2260 # Type: path
2261 # Default: "builtin"
2262
2263
2264 # This variable specifies which pager you would like to use to view
2265 # messages. The value ``builtin'' means to use the builtin pager, otherwise this
2266 # variable should specify the pathname of the external pager you would
2267 # like to use.
2268
2269 # Using an external pager may have some disadvantages: Additional
2270 # keystrokes are necessary because you can't call mutt functions
2271 # directly from the pager, and screen resizes cause lines longer than
2272 # the screen width to be badly formatted in the help menu.
2273
2274
2275 # set pager_context=0
2276 #
2277 # Name: pager_context
2278 # Type: number
2279 # Default: 0
2280
2281
2282 # This variable controls the number of lines of context that are given
2283 # when displaying the next or previous page in the internal pager.  By
2284 # default, Mutt will display the line after the last one on the screen
2285 # at the top of the next page (0 lines of context).
2286
2287 # This variable also specifies the amount of context given for search
2288 # results. If positive, this many lines will be given before a match,
2289 # if 0, the match will be top-aligned.
2290
2291
2292 # set pager_format="-%Z- %C/%m: %-20.20n   %s%*  -- (%P)"
2293 #
2294 # Name: pager_format
2295 # Type: string
2296 # Default: "-%Z- %C/%m: %-20.20n   %s%*  -- (%P)"
2297
2298
2299 # This variable controls the format of the one-line message ``status''
2300 # displayed before each message in either the internal or an external
2301 # pager.  The valid sequences are listed in the $index_format
2302 # section.
2303
2304
2305 # set pager_index_lines=0
2306 #
2307 # Name: pager_index_lines
2308 # Type: number
2309 # Default: 0
2310
2311
2312 # Determines the number of lines of a mini-index which is shown when in
2313 # the pager.  The current message, unless near the top or bottom of the
2314 # folder, will be roughly one third of the way down this mini-index,
2315 # giving the reader the context of a few messages before and after the
2316 # message.  This is useful, for example, to determine how many messages
2317 # remain to be read in the current thread.  One of the lines is reserved
2318 # for the status bar from the index, so a setting of 6
2319 # will only show 5 lines of the actual index.  A value of 0 results in
2320 # no index being shown.  If the number of messages in the current folder
2321 # is less than $pager_index_lines, then the index will only use as
2322 # many lines as it needs.
2323
2324
2325 # set pager_stop=no
2326 #
2327 # Name: pager_stop
2328 # Type: boolean
2329 # Default: no
2330
2331
2332 # When set, the internal-pager will not move to the next message
2333 # when you are at the end of a message and invoke the <next-page>
2334 # function.
2335
2336
2337 # set pgp_auto_decode=no
2338 #
2339 # Name: pgp_auto_decode
2340 # Type: boolean
2341 # Default: no
2342
2343
2344 # If set, mutt will automatically attempt to decrypt traditional PGP
2345 # messages whenever the user performs an operation which ordinarily would
2346 # result in the contents of the message being operated on.  For example,
2347 # if the user displays a pgp-traditional message which has not been manually
2348 # checked with the <check-traditional-pgp> function, mutt will automatically
2349 # check the message for traditional pgp.
2350
2351
2352 # set pgp_autoinline=no
2353 #
2354 # Name: pgp_autoinline
2355 # Type: boolean
2356 # Default: no
2357
2358
2359 # This option controls whether Mutt generates old-style inline
2360 # (traditional) PGP encrypted or signed messages under certain
2361 # circumstances.  This can be overridden by use of the pgp menu,
2362 # when inline is not required.
2363
2364 # Note that Mutt might automatically use PGP/MIME for messages
2365 # which consist of more than a single MIME part.  Mutt can be
2366 # configured to ask before sending PGP/MIME messages when inline
2367 # (traditional) would not work.
2368
2369 # Also see the $pgp_mime_auto variable.
2370
2371 # Also note that using the old-style PGP message format is strongly
2372 # deprecated.
2373 # (PGP only)
2374
2375
2376 # set pgp_check_exit=yes
2377 #
2378 # Name: pgp_check_exit
2379 # Type: boolean
2380 # Default: yes
2381
2382
2383 # If set, mutt will check the exit code of the PGP subprocess when
2384 # signing or encrypting.  A non-zero exit code means that the
2385 # subprocess failed.
2386 # (PGP only)
2387
2388
2389 # set pgp_clearsign_command=""
2390 #
2391 # Name: pgp_clearsign_command
2392 # Type: string
2393 # Default: ""
2394
2395
2396 # This format is used to create an old-style ``clearsigned'' PGP
2397 # message.  Note that the use of this format is strongly
2398 # deprecated.
2399
2400 # This is a format string, see the $pgp_decode_command command for
2401 # possible printf(3)-like sequences.
2402 # (PGP only)
2403
2404
2405 # set pgp_decode_command=""
2406 #
2407 # Name: pgp_decode_command
2408 # Type: string
2409 # Default: ""
2410
2411
2412 # This format strings specifies a command which is used to decode
2413 # application/pgp attachments.
2414
2415 # The PGP command formats have their own set of printf(3)-like sequences:
2416 # %p      Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
2417 #         string otherwise. Note: This may be used with a %? construct.
2418 # %f      Expands to the name of a file containing a message.
2419 # %s      Expands to the name of a file containing the signature part
2420 #                    of a multipart/signed attachment when verifying it.
2421 # %a      The value of $pgp_sign_as.
2422 # %r      One or more key IDs.
2423
2424
2425 # For examples on how to configure these formats for the various versions
2426 # of PGP which are floating around, see the pgp and gpg sample configuration files in
2427 # the samples/ subdirectory which has been installed on your system
2428 # alongside the documentation.
2429 # (PGP only)
2430
2431
2432 # set pgp_decrypt_command=""
2433 #
2434 # Name: pgp_decrypt_command
2435 # Type: string
2436 # Default: ""
2437
2438
2439 # This command is used to decrypt a PGP encrypted message.
2440
2441 # This is a format string, see the $pgp_decode_command command for
2442 # possible printf(3)-like sequences.
2443 # (PGP only)
2444
2445
2446 # set pgp_encrypt_only_command=""
2447 #
2448 # Name: pgp_encrypt_only_command
2449 # Type: string
2450 # Default: ""
2451
2452
2453 # This command is used to encrypt a body part without signing it.
2454
2455 # This is a format string, see the $pgp_decode_command command for
2456 # possible printf(3)-like sequences.
2457 # (PGP only)
2458
2459
2460 # set pgp_encrypt_sign_command=""
2461 #
2462 # Name: pgp_encrypt_sign_command
2463 # Type: string
2464 # Default: ""
2465
2466
2467 # This command is used to both sign and encrypt a body part.
2468
2469 # This is a format string, see the $pgp_decode_command command for
2470 # possible printf(3)-like sequences.
2471 # (PGP only)
2472
2473
2474 # set pgp_entry_format="%4n %t%f %4l/0x%k %-4a %2c %u"
2475 #
2476 # Name: pgp_entry_format
2477 # Type: string
2478 # Default: "%4n %t%f %4l/0x%k %-4a %2c %u"
2479
2480
2481 # This variable allows you to customize the PGP key selection menu to
2482 # your personal taste. This string is similar to $index_format, but
2483 # has its own set of printf(3)-like sequences:
2484 # %n      number
2485 # %k      key id
2486 # %u      user id
2487 # %a      algorithm
2488 # %l      key length
2489 # %f      flags
2490 # %c      capabilities
2491 # %t      trust/validity of the key-uid association
2492 # %[<s>]  date of the key where <s> is an strftime(3) expression
2493
2494
2495 # (PGP only)
2496
2497
2498 # set pgp_export_command=""
2499 #
2500 # Name: pgp_export_command
2501 # Type: string
2502 # Default: ""
2503
2504
2505 # This command is used to export a public key from the user's
2506 # key ring.
2507
2508 # This is a format string, see the $pgp_decode_command command for
2509 # possible printf(3)-like sequences.
2510 # (PGP only)
2511
2512
2513 # set pgp_getkeys_command=""
2514 #
2515 # Name: pgp_getkeys_command
2516 # Type: string
2517 # Default: ""
2518
2519
2520 # This command is invoked whenever mutt will need public key information.
2521 # Of the sequences supported by $pgp_decode_command, %r is the only
2522 # printf(3)-like sequence used with this format.
2523 # (PGP only)
2524
2525
2526 # set pgp_good_sign=""
2527 #
2528 # Name: pgp_good_sign
2529 # Type: regular expression
2530 # Default: ""
2531
2532
2533 # If you assign a text to this variable, then a PGP signature is only
2534 # considered verified if the output from $pgp_verify_command contains
2535 # the text. Use this variable if the exit code from the command is 0
2536 # even for bad signatures.
2537 # (PGP only)
2538
2539
2540 # set pgp_ignore_subkeys=yes
2541 #
2542 # Name: pgp_ignore_subkeys
2543 # Type: boolean
2544 # Default: yes
2545
2546
2547 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
2548 # the principal key will inherit the subkeys' capabilities.  Unset this
2549 # if you want to play interesting key selection games.
2550 # (PGP only)
2551
2552
2553 # set pgp_import_command=""
2554 #
2555 # Name: pgp_import_command
2556 # Type: string
2557 # Default: ""
2558
2559
2560 # This command is used to import a key from a message into
2561 # the user's public key ring.
2562
2563 # This is a format string, see the $pgp_decode_command command for
2564 # possible printf(3)-like sequences.
2565 # (PGP only)
2566
2567
2568 # set pgp_list_pubring_command=""
2569 #
2570 # Name: pgp_list_pubring_command
2571 # Type: string
2572 # Default: ""
2573
2574
2575 # This command is used to list the public key ring's contents.  The
2576 # output format must be analogous to the one used by
2577 # gpg --list-keys --with-colons.
2578
2579 # This format is also generated by the pgpring utility which comes
2580 # with mutt.
2581
2582 # This is a format string, see the $pgp_decode_command command for
2583 # possible printf(3)-like sequences.
2584 # (PGP only)
2585
2586
2587 # set pgp_list_secring_command=""
2588 #
2589 # Name: pgp_list_secring_command
2590 # Type: string
2591 # Default: ""
2592
2593
2594 # This command is used to list the secret key ring's contents.  The
2595 # output format must be analogous to the one used by:
2596 # gpg --list-keys --with-colons.
2597
2598 # This format is also generated by the pgpring utility which comes
2599 # with mutt.
2600
2601 # This is a format string, see the $pgp_decode_command command for
2602 # possible printf(3)-like sequences.
2603 # (PGP only)
2604
2605
2606 # set pgp_long_ids=no
2607 #
2608 # Name: pgp_long_ids
2609 # Type: boolean
2610 # Default: no
2611
2612
2613 # If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs.
2614 # (PGP only)
2615
2616
2617 # set pgp_mime_auto=ask-yes
2618 #
2619 # Name: pgp_mime_auto
2620 # Type: quadoption
2621 # Default: ask-yes
2622
2623
2624 # This option controls whether Mutt will prompt you for
2625 # automatically sending a (signed/encrypted) message using
2626 # PGP/MIME when inline (traditional) fails (for any reason).
2627
2628 # Also note that using the old-style PGP message format is strongly
2629 # deprecated.
2630 # (PGP only)
2631
2632
2633 # set pgp_replyinline=no
2634 #
2635 # Name: pgp_replyinline
2636 # Type: boolean
2637 # Default: no
2638
2639
2640 # Setting this variable will cause Mutt to always attempt to
2641 # create an inline (traditional) message when replying to a
2642 # message which is PGP encrypted/signed inline.  This can be
2643 # overridden by use of the pgp menu, when inline is not
2644 # required.  This option does not automatically detect if the
2645 # (replied-to) message is inline; instead it relies on Mutt
2646 # internals for previously checked/flagged messages.
2647
2648 # Note that Mutt might automatically use PGP/MIME for messages
2649 # which consist of more than a single MIME part.  Mutt can be
2650 # configured to ask before sending PGP/MIME messages when inline
2651 # (traditional) would not work.
2652
2653 # Also see the $pgp_mime_auto variable.
2654
2655 # Also note that using the old-style PGP message format is strongly
2656 # deprecated.
2657 # (PGP only)
2658
2659
2660 # set pgp_retainable_sigs=no
2661 #
2662 # Name: pgp_retainable_sigs
2663 # Type: boolean
2664 # Default: no
2665
2666
2667 # If set, signed and encrypted messages will consist of nested
2668 # multipart/signed and multipart/encrypted body parts.
2669
2670 # This is useful for applications like encrypted and signed mailing
2671 # lists, where the outer layer (multipart/encrypted) can be easily
2672 # removed, while the inner multipart/signed part is retained.
2673 # (PGP only)
2674
2675
2676 # set pgp_show_unusable=yes
2677 #
2678 # Name: pgp_show_unusable
2679 # Type: boolean
2680 # Default: yes
2681
2682
2683 # If set, mutt will display non-usable keys on the PGP key selection
2684 # menu.  This includes keys which have been revoked, have expired, or
2685 # have been marked as ``disabled'' by the user.
2686 # (PGP only)
2687
2688
2689 # set pgp_sign_as=""
2690 #
2691 # Name: pgp_sign_as
2692 # Type: string
2693 # Default: ""
2694
2695
2696 # If you have more than one key pair, this option allows you to specify
2697 # which of your private keys to use.  It is recommended that you use the
2698 # keyid form to specify your key (e.g. 0x00112233).
2699 # (PGP only)
2700
2701
2702 # set pgp_sign_command=""
2703 #
2704 # Name: pgp_sign_command
2705 # Type: string
2706 # Default: ""
2707
2708
2709 # This command is used to create the detached PGP signature for a
2710 # multipart/signed PGP/MIME body part.
2711
2712 # This is a format string, see the $pgp_decode_command command for
2713 # possible printf(3)-like sequences.
2714 # (PGP only)
2715
2716
2717 # set pgp_sort_keys=address
2718 #
2719 # Name: pgp_sort_keys
2720 # Type: sort order
2721 # Default: address
2722
2723
2724 # Specifies how the entries in the pgp menu are sorted. The
2725 # following are legal values:
2726 # address sort alphabetically by user id
2727 # keyid   sort alphabetically by key id
2728 # date    sort by key creation date
2729 # trust   sort by the trust of the key
2730
2731
2732 # If you prefer reverse order of the above values, prefix it with
2733 # ``reverse-''.
2734 # (PGP only)
2735
2736
2737 # set pgp_strict_enc=yes
2738 #
2739 # Name: pgp_strict_enc
2740 # Type: boolean
2741 # Default: yes
2742
2743
2744 # If set, Mutt will automatically encode PGP/MIME signed messages as
2745 # quoted-printable.  Please note that unsetting this variable may
2746 # lead to problems with non-verifyable PGP signatures, so only change
2747 # this if you know what you are doing.
2748 # (PGP only)
2749
2750
2751 # set pgp_timeout=300
2752 #
2753 # Name: pgp_timeout
2754 # Type: number
2755 # Default: 300
2756
2757
2758 # The number of seconds after which a cached passphrase will expire if
2759 # not used.
2760 # (PGP only)
2761
2762
2763 # set pgp_use_gpg_agent=no
2764 #
2765 # Name: pgp_use_gpg_agent
2766 # Type: boolean
2767 # Default: no
2768
2769
2770 # If set, mutt will use a possibly-running gpg-agent(1) process.
2771 # (PGP only)
2772
2773
2774 # set pgp_verify_command=""
2775 #
2776 # Name: pgp_verify_command
2777 # Type: string
2778 # Default: ""
2779
2780
2781 # This command is used to verify PGP signatures.
2782
2783 # This is a format string, see the $pgp_decode_command command for
2784 # possible printf(3)-like sequences.
2785 # (PGP only)
2786
2787
2788 # set pgp_verify_key_command=""
2789 #
2790 # Name: pgp_verify_key_command
2791 # Type: string
2792 # Default: ""
2793
2794
2795 # This command is used to verify key information from the key selection
2796 # menu.
2797
2798 # This is a format string, see the $pgp_decode_command command for
2799 # possible printf(3)-like sequences.
2800 # (PGP only)
2801
2802
2803 # set pipe_decode=no
2804 #
2805 # Name: pipe_decode
2806 # Type: boolean
2807 # Default: no
2808
2809
2810 # Used in connection with the <pipe-message> command.  When unset,
2811 # Mutt will pipe the messages without any preprocessing. When set, Mutt
2812 # will weed headers and will attempt to decode the messages
2813 # first.
2814
2815
2816 # set pipe_sep="\n"
2817 #
2818 # Name: pipe_sep
2819 # Type: string
2820 # Default: "\n"
2821
2822
2823 # The separator to add between messages when piping a list of tagged
2824 # messages to an external Unix command.
2825
2826
2827 # set pipe_split=no
2828 #
2829 # Name: pipe_split
2830 # Type: boolean
2831 # Default: no
2832
2833
2834 # Used in connection with the <pipe-message> function following
2835 # <tag-prefix>.  If this variable is unset, when piping a list of
2836 # tagged messages Mutt will concatenate the messages and will pipe them
2837 # all concatenated.  When set, Mutt will pipe the messages one by one.
2838 # In both cases the messages are piped in the current sorted order,
2839 # and the $pipe_sep separator is added after each message.
2840
2841
2842 # set pop_auth_try_all=yes
2843 #
2844 # Name: pop_auth_try_all
2845 # Type: boolean
2846 # Default: yes
2847
2848
2849 # If set, Mutt will try all available authentication methods.
2850 # When unset, Mutt will only fall back to other authentication
2851 # methods if the previous methods are unavailable. If a method is
2852 # available but authentication fails, Mutt will not connect to the POP server.
2853
2854
2855 # set pop_authenticators=""
2856 #
2857 # Name: pop_authenticators
2858 # Type: string
2859 # Default: ""
2860
2861
2862 # This is a colon-delimited list of authentication methods mutt may
2863 # attempt to use to log in to an POP server, in the order mutt should
2864 # try them.  Authentication methods are either ``user'', ``apop'' or any
2865 # SASL mechanism, eg ``digest-md5'', ``gssapi'' or ``cram-md5''.
2866 # This option is case-insensitive. If this option is unset
2867 # (the default) mutt will try all available methods, in order from
2868 # most-secure to least-secure.
2869
2870 # Example:
2871 # set pop_authenticators="digest-md5:apop:user"
2872
2873
2874 # set pop_checkinterval=60
2875 #
2876 # Name: pop_checkinterval
2877 # Type: number
2878 # Default: 60
2879
2880
2881 # This variable configures how often (in seconds) mutt should look for
2882 # new mail in the currently selected mailbox if it is a POP mailbox.
2883
2884
2885 # set pop_delete=ask-no
2886 #
2887 # Name: pop_delete
2888 # Type: quadoption
2889 # Default: ask-no
2890
2891
2892 # If set, Mutt will delete successfully downloaded messages from the POP
2893 # server when using the <fetch-mail> function.  When unset, Mutt will
2894 # download messages but also leave them on the POP server.
2895
2896
2897 # set pop_host=""
2898 #
2899 # Name: pop_host
2900 # Type: string
2901 # Default: ""
2902
2903
2904 # The name of your POP server for the <fetch-mail> function.  You
2905 # can also specify an alternative port, username and password, ie:
2906 # [pop[s]://][username[:password]@]popserver[:port]
2907
2908 # where ``[...]'' denotes an optional part.
2909
2910
2911 # set pop_last=no
2912 #
2913 # Name: pop_last
2914 # Type: boolean
2915 # Default: no
2916
2917
2918 # If this variable is set, mutt will try to use the ``LAST'' POP command
2919 # for retrieving only unread messages from the POP server when using
2920 # the <fetch-mail> function.
2921
2922
2923 # set pop_pass=""
2924 #
2925 # Name: pop_pass
2926 # Type: string
2927 # Default: ""
2928
2929
2930 # Specifies the password for your POP account.  If unset, Mutt will
2931 # prompt you for your password when you open a POP mailbox.
2932
2933 # Warning: you should only use this option when you are on a
2934 # fairly secure machine, because the superuser can read your muttrc
2935 # even if you are the only one who can read the file.
2936
2937
2938 # set pop_reconnect=ask-yes
2939 #
2940 # Name: pop_reconnect
2941 # Type: quadoption
2942 # Default: ask-yes
2943
2944
2945 # Controls whether or not Mutt will try to reconnect to the POP server if
2946 # the connection is lost.
2947
2948
2949 # set pop_user=""
2950 #
2951 # Name: pop_user
2952 # Type: string
2953 # Default: ""
2954
2955
2956 # Your login name on the POP server.
2957
2958 # This variable defaults to your user name on the local machine.
2959
2960
2961 # set post_indent_string=""
2962 #
2963 # Name: post_indent_string
2964 # Type: string
2965 # Default: ""
2966
2967
2968 # Similar to the $attribution variable, Mutt will append this
2969 # string after the inclusion of a message which is being replied to.
2970
2971
2972 # set postpone=ask-yes
2973 #
2974 # Name: postpone
2975 # Type: quadoption
2976 # Default: ask-yes
2977
2978
2979 # Controls whether or not messages are saved in the $postponed
2980 # mailbox when you elect not to send immediately.
2981
2982 # Also see the $recall variable.
2983
2984
2985 # set postponed="~/postponed"
2986 #
2987 # Name: postponed
2988 # Type: path
2989 # Default: "~/postponed"
2990
2991
2992 # Mutt allows you to indefinitely ``postpone sending a message'' which
2993 # you are editing.  When you choose to postpone a message, Mutt saves it
2994 # in the mailbox specified by this variable.
2995
2996 # Also see the $postpone variable.
2997
2998
2999 # set preconnect=""
3000 #
3001 # Name: preconnect
3002 # Type: string
3003 # Default: ""
3004
3005
3006 # If set, a shell command to be executed if mutt fails to establish
3007 # a connection to the server. This is useful for setting up secure
3008 # connections, e.g. with ssh(1). If the command returns a  nonzero
3009 # status, mutt gives up opening the server. Example:
3010 # set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
3011 # sleep 20 < /dev/null > /dev/null"
3012
3013 # Mailbox ``foo'' on ``mailhost.net'' can now be reached
3014 # as ``{localhost:1234}foo''.
3015
3016 # Note: For this example to work, you must be able to log in to the
3017 # remote machine without having to enter a password.
3018
3019
3020 # set print=ask-no
3021 #
3022 # Name: print
3023 # Type: quadoption
3024 # Default: ask-no
3025
3026
3027 # Controls whether or not Mutt really prints messages.
3028 # This is set to ``ask-no'' by default, because some people
3029 # accidentally hit ``p'' often.
3030
3031
3032 # set print_command="lpr"
3033 #
3034 # Name: print_command
3035 # Type: path
3036 # Default: "lpr"
3037
3038
3039 # This specifies the command pipe that should be used to print messages.
3040
3041
3042 # set print_decode=yes
3043 #
3044 # Name: print_decode
3045 # Type: boolean
3046 # Default: yes
3047
3048
3049 # Used in connection with the <print-message> command.  If this
3050 # option is set, the message is decoded before it is passed to the
3051 # external command specified by $print_command.  If this option
3052 # is unset, no processing will be applied to the message when
3053 # printing it.  The latter setting may be useful if you are using
3054 # some advanced printer filter which is able to properly format
3055 # e-mail messages for printing.
3056
3057
3058 # set print_split=no
3059 #
3060 # Name: print_split
3061 # Type: boolean
3062 # Default: no
3063
3064
3065 # Used in connection with the <print-message> command.  If this option
3066 # is set, the command specified by $print_command is executed once for
3067 # each message which is to be printed.  If this option is unset,
3068 # the command specified by $print_command is executed only once, and
3069 # all the messages are concatenated, with a form feed as the message
3070 # separator.
3071
3072 # Those who use the enscript(1) program's mail-printing mode will
3073 # most likely want to set this option.
3074
3075
3076 # set prompt_after=yes
3077 #
3078 # Name: prompt_after
3079 # Type: boolean
3080 # Default: yes
3081
3082
3083 # If you use an external $pager, setting this variable will
3084 # cause Mutt to prompt you for a command when the pager exits rather
3085 # than returning to the index menu.  If unset, Mutt will return to the
3086 # index menu when the external pager exits.
3087
3088
3089 # set query_command=""
3090 #
3091 # Name: query_command
3092 # Type: path
3093 # Default: ""
3094
3095
3096 # This specifies the command that mutt will use to make external address
3097 # queries.  The string should contain a ``%s'', which will be substituted
3098 # with the query string the user types.  See ``query'' for more
3099 # information.
3100
3101
3102 # set query_format="%4c %t %-25.25a %-25.25n %?e?(%e)?"
3103 #
3104 # Name: query_format
3105 # Type: string
3106 # Default: "%4c %t %-25.25a %-25.25n %?e?(%e)?"
3107
3108
3109 # This variable describes the format of the ``query'' menu. The
3110 # following printf(3)-style sequences are understood:
3111 # %a      destination address
3112 # %c      current entry number
3113 # %e      extra information *
3114 # %n      destination name
3115 # %t      ``*'' if current entry is tagged, a space otherwise
3116 # %>X     right justify the rest of the string and pad with ``X''
3117 # %|X     pad to the end of the line with ``X''
3118 # %*X     soft-fill with character ``X'' as pad
3119
3120
3121 # For an explanation of ``soft-fill'', see the $index_format documentation.
3122
3123 # * = can be optionally printed if nonzero, see the $status_format documentation.
3124
3125
3126 # set quit=yes
3127 #
3128 # Name: quit
3129 # Type: quadoption
3130 # Default: yes
3131
3132
3133 # This variable controls whether ``quit'' and ``exit'' actually quit
3134 # from mutt.  If this option is set, they do quit, if it is unset, they
3135 # have no effect, and if it is set to ask-yes or ask-no, you are
3136 # prompted for confirmation when you try to quit.
3137
3138
3139 # set quote_regexp="^([ \t]*[|>:}#])+"
3140 #
3141 # Name: quote_regexp
3142 # Type: regular expression
3143 # Default: "^([ \t]*[|>:}#])+"
3144
3145
3146 # A regular expression used in the internal pager to determine quoted
3147 # sections of text in the body of a message. Quoted text may be filtered
3148 # out using the <toggle-quoted> command, or colored according to the
3149 # ``color quoted'' family of directives.
3150
3151 # Higher levels of quoting may be colored differently (``color quoted1'',
3152 # ``color quoted2'', etc.). The quoting level is determined by removing
3153 # the last character from the matched text and recursively reapplying
3154 # the regular expression until it fails to produce a match.
3155
3156 # Match detection may be overridden by the $smileys regular expression.
3157
3158
3159 # set read_inc=10
3160 #
3161 # Name: read_inc
3162 # Type: number
3163 # Default: 10
3164
3165
3166 # If set to a value greater than 0, Mutt will display which message it
3167 # is currently on when reading a mailbox or when performing search actions
3168 # such as search and limit. The message is printed after
3169 # this many messages have been read or searched (e.g., if set to 25, Mutt will
3170 # print a message when it is at message 25, and then again when it gets
3171 # to message 50).  This variable is meant to indicate progress when
3172 # reading or searching large mailboxes which may take some time.
3173 # When set to 0, only a single message will appear before the reading
3174 # the mailbox.
3175
3176 # Also see the $write_inc, $net_inc and $time_inc variables and the
3177 # ``tuning'' section of the manual for performance considerations.
3178
3179
3180 # set read_only=no
3181 #
3182 # Name: read_only
3183 # Type: boolean
3184 # Default: no
3185
3186
3187 # If set, all folders are opened in read-only mode.
3188
3189
3190 # set realname=""
3191 #
3192 # Name: realname
3193 # Type: string
3194 # Default: ""
3195
3196
3197 # This variable specifies what ``real'' or ``personal'' name should be used
3198 # when sending messages.
3199
3200 # By default, this is the GECOS field from /etc/passwd.  Note that this
3201 # variable will not be used when the user has set a real name
3202 # in the $from variable.
3203
3204
3205 # set recall=ask-yes
3206 #
3207 # Name: recall
3208 # Type: quadoption
3209 # Default: ask-yes
3210
3211
3212 # Controls whether or not Mutt recalls postponed messages
3213 # when composing a new message.
3214
3215 # Setting this variable to is not generally useful, and thus not
3216 # recommended.
3217
3218 # Also see $postponed variable.
3219
3220
3221 # set record="~/sent"
3222 #
3223 # Name: record
3224 # Type: path
3225 # Default: "~/sent"
3226
3227
3228 # This specifies the file into which your outgoing messages should be
3229 # appended.  (This is meant as the primary method for saving a copy of
3230 # your messages, but another way to do this is using the ``my_hdr''
3231 # command to create a ``Bcc:'' field with your email address in it.)
3232
3233 # The value of $record is overridden by the $force_name and
3234 # $save_name variables, and the ``fcc-hook'' command.
3235
3236
3237 # set reply_regexp="^(re([\\[0-9\\]+])*|aw):[ \t]*"
3238 #
3239 # Name: reply_regexp
3240 # Type: regular expression
3241 # Default: "^(re([\\[0-9\\]+])*|aw):[ \t]*"
3242
3243
3244 # A regular expression used to recognize reply messages when threading
3245 # and replying. The default value corresponds to the English "Re:" and
3246 # the German "Aw:".
3247
3248
3249 # set reply_self=no
3250 #
3251 # Name: reply_self
3252 # Type: boolean
3253 # Default: no
3254
3255
3256 # If unset and you are replying to a message sent by you, Mutt will
3257 # assume that you want to reply to the recipients of that message rather
3258 # than to yourself.
3259
3260 # Also see the ``alternates'' command.
3261
3262
3263 # set reply_to=ask-yes
3264 #
3265 # Name: reply_to
3266 # Type: quadoption
3267 # Default: ask-yes
3268
3269
3270 # If set, when replying to a message, Mutt will use the address listed
3271 # in the Reply-to: header as the recipient of the reply.  If unset,
3272 # it will use the address in the From: header field instead.  This
3273 # option is useful for reading a mailing list that sets the Reply-To:
3274 # header field to the list address and you want to send a private
3275 # message to the author of a message.
3276
3277
3278 # set resolve=yes
3279 #
3280 # Name: resolve
3281 # Type: boolean
3282 # Default: yes
3283
3284
3285 # When set, the cursor will be automatically advanced to the next
3286 # (possibly undeleted) message whenever a command that modifies the
3287 # current message is executed.
3288
3289
3290 # set reverse_alias=no
3291 #
3292 # Name: reverse_alias
3293 # Type: boolean
3294 # Default: no
3295
3296
3297 # This variable controls whether or not Mutt will display the ``personal''
3298 # name from your aliases in the index menu if it finds an alias that
3299 # matches the message's sender.  For example, if you have the following
3300 # alias:
3301 # alias juser abd30425@somewhere.net (Joe User)
3302
3303 # and then you receive mail which contains the following header:
3304 # From: abd30425@somewhere.net
3305
3306 # It would be displayed in the index menu as ``Joe User'' instead of
3307 # ``abd30425@somewhere.net.''  This is useful when the person's e-mail
3308 # address is not human friendly.
3309
3310
3311 # set reverse_name=no
3312 #
3313 # Name: reverse_name
3314 # Type: boolean
3315 # Default: no
3316
3317
3318 # It may sometimes arrive that you receive mail to a certain machine,
3319 # move the messages to another machine, and reply to some the messages
3320 # from there.  If this variable is set, the default From: line of
3321 # the reply messages is built using the address where you received the
3322 # messages you are replying to if that address matches your
3323 # ``alternates''.  If the variable is unset, or the address that would be
3324 # used doesn't match your ``alternates'', the From: line will use
3325 # your address on the current machine.
3326
3327 # Also see the ``alternates'' command.
3328
3329
3330 # set reverse_realname=yes
3331 #
3332 # Name: reverse_realname
3333 # Type: boolean
3334 # Default: yes
3335
3336
3337 # This variable fine-tunes the behaviour of the $reverse_name feature.
3338 # When it is set, mutt will use the address from incoming messages as-is,
3339 # possibly including eventual real names.  When it is unset, mutt will
3340 # override any such real names with the setting of the $realname variable.
3341
3342
3343 # set rfc2047_parameters=no
3344 #
3345 # Name: rfc2047_parameters
3346 # Type: boolean
3347 # Default: no
3348
3349
3350 # When this variable is set, Mutt will decode RFC2047-encoded MIME
3351 # parameters. You want to set this variable when mutt suggests you
3352 # to save attachments to files named like:
3353 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3354
3355 # When this variable is set interactively, the change won't be
3356 # active until you change folders.
3357
3358 # Note that this use of RFC2047's encoding is explicitly
3359 # prohibited by the standard, but nevertheless encountered in the
3360 # wild.
3361
3362 # Also note that setting this parameter will not have the effect
3363 # that mutt generates this kind of encoding.  Instead, mutt will
3364 # unconditionally use the encoding specified in RFC2231.
3365
3366
3367 # set save_address=no
3368 #
3369 # Name: save_address
3370 # Type: boolean
3371 # Default: no
3372
3373
3374 # If set, mutt will take the sender's full address when choosing a
3375 # default folder for saving a mail. If $save_name or $force_name
3376 # is set too, the selection of the Fcc folder will be changed as well.
3377
3378
3379 # set save_empty=yes
3380 #
3381 # Name: save_empty
3382 # Type: boolean
3383 # Default: yes
3384
3385
3386 # When unset, mailboxes which contain no saved messages will be removed
3387 # when closed (the exception is $spoolfile which is never removed).
3388 # If set, mailboxes are never removed.
3389
3390 # Note: This only applies to mbox and MMDF folders, Mutt does not
3391 # delete MH and Maildir directories.
3392
3393
3394 # set save_history=0
3395 #
3396 # Name: save_history
3397 # Type: number
3398 # Default: 0
3399
3400
3401 # This variable controls the size of the history (per category) saved in the
3402 # $history_file file.
3403
3404
3405 # set save_name=no
3406 #
3407 # Name: save_name
3408 # Type: boolean
3409 # Default: no
3410
3411
3412 # This variable controls how copies of outgoing messages are saved.
3413 # When set, a check is made to see if a mailbox specified by the
3414 # recipient address exists (this is done by searching for a mailbox in
3415 # the $folder directory with the username part of the
3416 # recipient address).  If the mailbox exists, the outgoing message will
3417 # be saved to that mailbox, otherwise the message is saved to the
3418 # $record mailbox.
3419
3420 # Also see the $force_name variable.
3421
3422
3423 # set score=yes
3424 #
3425 # Name: score
3426 # Type: boolean
3427 # Default: yes
3428
3429
3430 # When this variable is unset, scoring is turned off.  This can
3431 # be useful to selectively disable scoring for certain folders when the
3432 # $score_threshold_delete variable and related are used.
3433
3434
3435 # set score_threshold_delete=-1
3436 #
3437 # Name: score_threshold_delete
3438 # Type: number
3439 # Default: -1
3440
3441
3442 # Messages which have been assigned a score equal to or lower than the value
3443 # of this variable are automatically marked for deletion by mutt.  Since
3444 # mutt scores are always greater than or equal to zero, the default setting
3445 # of this variable will never mark a message for deletion.
3446
3447
3448 # set score_threshold_flag=9999
3449 #
3450 # Name: score_threshold_flag
3451 # Type: number
3452 # Default: 9999
3453
3454
3455 # Messages which have been assigned a score greater than or equal to this
3456 # variable's value are automatically marked "flagged".
3457
3458
3459 # set score_threshold_read=-1
3460 #
3461 # Name: score_threshold_read
3462 # Type: number
3463 # Default: -1
3464
3465
3466 # Messages which have been assigned a score equal to or lower than the value
3467 # of this variable are automatically marked as read by mutt.  Since
3468 # mutt scores are always greater than or equal to zero, the default setting
3469 # of this variable will never mark a message read.
3470
3471
3472 # set search_context=0
3473 #
3474 # Name: search_context
3475 # Type: number
3476 # Default: 0
3477
3478
3479 # For the pager, this variable specifies the number of lines shown
3480 # before search results. By default, search results will be top-aligned.
3481
3482
3483 # set send_charset="us-ascii:iso-8859-1:utf-8"
3484 #
3485 # Name: send_charset
3486 # Type: string
3487 # Default: "us-ascii:iso-8859-1:utf-8"
3488
3489
3490 # A colon-delimited list of character sets for outgoing messages. Mutt will use the
3491 # first character set into which the text can be converted exactly.
3492 # If your $charset is not ``iso-8859-1'' and recipients may not
3493 # understand ``UTF-8'', it is advisable to include in the list an
3494 # appropriate widely used standard character set (such as
3495 # ``iso-8859-2'', ``koi8-r'' or ``iso-2022-jp'') either instead of or after
3496 # ``iso-8859-1''.
3497
3498 # In case the text cannot be converted into one of these exactly,
3499 # mutt uses $charset as a fallback.
3500
3501
3502 # set sendmail="/usr/sbin/sendmail -oem -oi"
3503 #
3504 # Name: sendmail
3505 # Type: path
3506 # Default: "/usr/sbin/sendmail -oem -oi"
3507
3508
3509 # Specifies the program and arguments used to deliver mail sent by Mutt.
3510 # Mutt expects that the specified program interprets additional
3511 # arguments as recipient addresses.
3512
3513
3514 # set sendmail_wait=0
3515 #
3516 # Name: sendmail_wait
3517 # Type: number
3518 # Default: 0
3519
3520
3521 # Specifies the number of seconds to wait for the $sendmail process
3522 # to finish before giving up and putting delivery in the background.
3523
3524 # Mutt interprets the value of this variable as follows:
3525 # >0      number of seconds to wait for sendmail to finish before continuing
3526 # 0       wait forever for sendmail to finish
3527 # <0      always put sendmail in the background without waiting
3528
3529
3530 # Note that if you specify a value other than 0, the output of the child
3531 # process will be put in a temporary file.  If there is some error, you
3532 # will be informed as to where to find the output.
3533
3534
3535 # set shell=""
3536 #
3537 # Name: shell
3538 # Type: path
3539 # Default: ""
3540
3541
3542 # Command to use when spawning a subshell.  By default, the user's login
3543 # shell from /etc/passwd is used.
3544
3545
3546 # set sig_dashes=yes
3547 #
3548 # Name: sig_dashes
3549 # Type: boolean
3550 # Default: yes
3551
3552
3553 # If set, a line containing ``-- '' (note the trailing space) will be inserted before your
3554 # $signature.  It is strongly recommended that you not unset
3555 # this variable unless your signature contains just your name.  The
3556 # reason for this is because many software packages use ``-- \n'' to
3557 # detect your signature.  For example, Mutt has the ability to highlight
3558 # the signature in a different color in the builtin pager.
3559
3560
3561 # set sig_on_top=no
3562 #
3563 # Name: sig_on_top
3564 # Type: boolean
3565 # Default: no
3566
3567
3568 # If set, the signature will be included before any quoted or forwarded
3569 # text.  It is strongly recommended that you do not set this variable
3570 # unless you really know what you are doing, and are prepared to take
3571 # some heat from netiquette guardians.
3572
3573
3574 # set signature="~/.signature"
3575 #
3576 # Name: signature
3577 # Type: path
3578 # Default: "~/.signature"
3579
3580
3581 # Specifies the filename of your signature, which is appended to all
3582 # outgoing messages.   If the filename ends with a pipe (``|''), it is
3583 # assumed that filename is a shell command and input should be read from
3584 # its standard output.
3585
3586
3587 # set simple_search="~f %s | ~s %s"
3588 #
3589 # Name: simple_search
3590 # Type: string
3591 # Default: "~f %s | ~s %s"
3592
3593
3594 # Specifies how Mutt should expand a simple search into a real search
3595 # pattern.  A simple search is one that does not contain any of the ``~'' pattern
3596 # operators.  See ``patterns'' for more information on search patterns.
3597
3598 # For example, if you simply type ``joe'' at a search or limit prompt, Mutt
3599 # will automatically expand it to the value specified by this variable by
3600 # replacing ``%s'' with the supplied string.
3601 # For the default value, ``joe'' would be expanded to: ``~f joe | ~s joe''.
3602
3603
3604 # set sleep_time=1
3605 #
3606 # Name: sleep_time
3607 # Type: number
3608 # Default: 1
3609
3610
3611 # Specifies time, in seconds, to pause while displaying certain informational
3612 # messages, while moving from folder to folder and after expunging
3613 # messages from the current folder.  The default is to pause one second, so
3614 # a value of zero for this option suppresses the pause.
3615
3616
3617 # set smart_wrap=yes
3618 #
3619 # Name: smart_wrap
3620 # Type: boolean
3621 # Default: yes
3622
3623
3624 # Controls the display of lines longer than the screen width in the
3625 # internal pager. If set, long lines are wrapped at a word boundary.  If
3626 # unset, lines are simply wrapped at the screen edge. Also see the
3627 # $markers variable.
3628
3629
3630 # set smileys="(>From )|(:[-^]?[][)(><}{|/DP])"
3631 #
3632 # Name: smileys
3633 # Type: regular expression
3634 # Default: "(>From )|(:[-^]?[][)(><}{|/DP])"
3635
3636
3637 # The pager uses this variable to catch some common false
3638 # positives of $quote_regexp, most notably smileys and not consider
3639 # a line quoted text if it also matches $smileys. This mostly
3640 # happens at the beginning of a line.
3641
3642
3643 # set smime_ask_cert_label=yes
3644 #
3645 # Name: smime_ask_cert_label
3646 # Type: boolean
3647 # Default: yes
3648
3649
3650 # This flag controls whether you want to be asked to enter a label
3651 # for a certificate about to be added to the database or not. It is
3652 # set by default.
3653 # (S/MIME only)
3654
3655
3656 # set smime_ca_location=""
3657 #
3658 # Name: smime_ca_location
3659 # Type: path
3660 # Default: ""
3661
3662
3663 # This variable contains the name of either a directory, or a file which
3664 # contains trusted certificates for use with OpenSSL.
3665 # (S/MIME only)
3666
3667
3668 # set smime_certificates=""
3669 #
3670 # Name: smime_certificates
3671 # Type: path
3672 # Default: ""
3673
3674
3675 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
3676 # storage and retrieval of keys by itself. This is very basic right
3677 # now, and keys and certificates are stored in two different
3678 # directories, both named as the hash-value retrieved from
3679 # OpenSSL. There is an index file which contains mailbox-address
3680 # keyid pairs, and which can be manually edited. This option points to
3681 # the location of the certificates.
3682 # (S/MIME only)
3683
3684
3685 # set smime_decrypt_command=""
3686 #
3687 # Name: smime_decrypt_command
3688 # Type: string
3689 # Default: ""
3690
3691
3692 # This format string specifies a command which is used to decrypt
3693 # application/x-pkcs7-mime attachments.
3694
3695 # The OpenSSL command formats have their own set of printf(3)-like sequences
3696 # similar to PGP's:
3697 # %f      Expands to the name of a file containing a message.
3698 # %s      Expands to the name of a file containing the signature part
3699 #                    of a multipart/signed attachment when verifying it.
3700 # %k      The key-pair specified with $smime_default_key
3701 # %c      One or more certificate IDs.
3702 # %a      The algorithm used for encryption.
3703 # %C      CA location:  Depending on whether $smime_ca_location
3704 #                    points to a directory or file, this expands to
3705 #                    ``-CApath $smime_ca_location'' or ``-CAfile $smime_ca_location''.
3706
3707
3708 # For examples on how to configure these formats, see the smime.rc in
3709 # the samples/ subdirectory which has been installed on your system
3710 # alongside the documentation.
3711 # (S/MIME only)
3712
3713
3714 # set smime_decrypt_use_default_key=yes
3715 #
3716 # Name: smime_decrypt_use_default_key
3717 # Type: boolean
3718 # Default: yes
3719
3720
3721 # If set (default) this tells mutt to use the default key for decryption. Otherwise,
3722 # if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
3723 # to determine the key to use. It will ask you to supply a key, if it can't find one.
3724 # (S/MIME only)
3725
3726
3727 # set smime_default_key=""
3728 #
3729 # Name: smime_default_key
3730 # Type: string
3731 # Default: ""
3732
3733
3734 # This is the default key-pair to use for signing. This must be set to the
3735 # keyid (the hash-value that OpenSSL generates) to work properly
3736 # (S/MIME only)
3737
3738
3739 # set smime_encrypt_command=""
3740 #
3741 # Name: smime_encrypt_command
3742 # Type: string
3743 # Default: ""
3744
3745
3746 # This command is used to create encrypted S/MIME messages.
3747
3748 # This is a format string, see the $smime_decrypt_command command for
3749 # possible printf(3)-like sequences.
3750 # (S/MIME only)
3751
3752
3753 # set smime_encrypt_with=""
3754 #
3755 # Name: smime_encrypt_with
3756 # Type: string
3757 # Default: ""
3758
3759
3760 # This sets the algorithm that should be used for encryption.
3761 # Valid choices are ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``rc2-128''.
3762 # If unset, ``3des'' (TripleDES) is used.
3763 # (S/MIME only)
3764
3765
3766 # set smime_get_cert_command=""
3767 #
3768 # Name: smime_get_cert_command
3769 # Type: string
3770 # Default: ""
3771
3772
3773 # This command is used to extract X509 certificates from a PKCS7 structure.
3774
3775 # This is a format string, see the $smime_decrypt_command command for
3776 # possible printf(3)-like sequences.
3777 # (S/MIME only)
3778
3779
3780 # set smime_get_cert_email_command=""
3781 #
3782 # Name: smime_get_cert_email_command
3783 # Type: string
3784 # Default: ""
3785
3786
3787 # This command is used to extract the mail address(es) used for storing
3788 # X509 certificates, and for verification purposes (to check whether the
3789 # certificate was issued for the sender's mailbox).
3790
3791 # This is a format string, see the $smime_decrypt_command command for
3792 # possible printf(3)-like sequences.
3793 # (S/MIME only)
3794
3795
3796 # set smime_get_signer_cert_command=""
3797 #
3798 # Name: smime_get_signer_cert_command
3799 # Type: string
3800 # Default: ""
3801
3802
3803 # This command is used to extract only the signers X509 certificate from a S/MIME
3804 # signature, so that the certificate's owner may get compared to the
3805 # email's ``From:'' field.
3806
3807 # This is a format string, see the $smime_decrypt_command command for
3808 # possible printf(3)-like sequences.
3809 # (S/MIME only)
3810
3811
3812 # set smime_import_cert_command=""
3813 #
3814 # Name: smime_import_cert_command
3815 # Type: string
3816 # Default: ""
3817
3818
3819 # This command is used to import a certificate via smime_keys.
3820
3821 # This is a format string, see the $smime_decrypt_command command for
3822 # possible printf(3)-like sequences.
3823 # (S/MIME only)
3824
3825
3826 # set smime_is_default=no
3827 #
3828 # Name: smime_is_default
3829 # Type: boolean
3830 # Default: no
3831
3832
3833 # The default behaviour of mutt is to use PGP on all auto-sign/encryption
3834 # operations. To override and to use OpenSSL instead this must be set.
3835 # However, this has no effect while replying, since mutt will automatically
3836 # select the same application that was used to sign/encrypt the original
3837 # message.  (Note that this variable can be overridden by unsetting $crypt_autosmime.)
3838 # (S/MIME only)
3839
3840
3841 # set smime_keys=""
3842 #
3843 # Name: smime_keys
3844 # Type: path
3845 # Default: ""
3846
3847
3848 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
3849 # storage and retrieval of keys/certs by itself. This is very basic right now,
3850 # and stores keys and certificates in two different directories, both
3851 # named as the hash-value retrieved from OpenSSL. There is an index file
3852 # which contains mailbox-address keyid pair, and which can be manually
3853 # edited. This option points to the location of the private keys.
3854 # (S/MIME only)
3855
3856
3857 # set smime_pk7out_command=""
3858 #
3859 # Name: smime_pk7out_command
3860 # Type: string
3861 # Default: ""
3862
3863
3864 # This command is used to extract PKCS7 structures of S/MIME signatures,
3865 # in order to extract the public X509 certificate(s).
3866
3867 # This is a format string, see the $smime_decrypt_command command for
3868 # possible printf(3)-like sequences.
3869 # (S/MIME only)
3870
3871
3872 # set smime_sign_command=""
3873 #
3874 # Name: smime_sign_command
3875 # Type: string
3876 # Default: ""
3877
3878
3879 # This command is used to created S/MIME signatures of type
3880 # multipart/signed, which can be read by all mail clients.
3881
3882 # This is a format string, see the $smime_decrypt_command command for
3883 # possible printf(3)-like sequences.
3884 # (S/MIME only)
3885
3886
3887 # set smime_sign_opaque_command=""
3888 #
3889 # Name: smime_sign_opaque_command
3890 # Type: string
3891 # Default: ""
3892
3893
3894 # This command is used to created S/MIME signatures of type
3895 # application/x-pkcs7-signature, which can only be handled by mail
3896 # clients supporting the S/MIME extension.
3897
3898 # This is a format string, see the $smime_decrypt_command command for
3899 # possible printf(3)-like sequences.
3900 # (S/MIME only)
3901
3902
3903 # set smime_timeout=300
3904 #
3905 # Name: smime_timeout
3906 # Type: number
3907 # Default: 300
3908
3909
3910 # The number of seconds after which a cached passphrase will expire if
3911 # not used.
3912 # (S/MIME only)
3913
3914
3915 # set smime_verify_command=""
3916 #
3917 # Name: smime_verify_command
3918 # Type: string
3919 # Default: ""
3920
3921
3922 # This command is used to verify S/MIME signatures of type multipart/signed.
3923
3924 # This is a format string, see the $smime_decrypt_command command for
3925 # possible printf(3)-like sequences.
3926 # (S/MIME only)
3927
3928
3929 # set smime_verify_opaque_command=""
3930 #
3931 # Name: smime_verify_opaque_command
3932 # Type: string
3933 # Default: ""
3934
3935
3936 # This command is used to verify S/MIME signatures of type
3937 # application/x-pkcs7-mime.
3938
3939 # This is a format string, see the $smime_decrypt_command command for
3940 # possible printf(3)-like sequences.
3941 # (S/MIME only)
3942
3943
3944 # set smtp_authenticators=""
3945 #
3946 # Name: smtp_authenticators
3947 # Type: string
3948 # Default: ""
3949
3950
3951 # This is a colon-delimited list of authentication methods mutt may
3952 # attempt to use to log in to an SMTP server, in the order mutt should
3953 # try them.  Authentication methods are any SASL mechanism, eg
3954 # ``digest-md5'', ``gssapi'' or ``cram-md5''.
3955 # This option is case-insensitive. If it is ``unset''
3956 # (the default) mutt will try all available methods, in order from
3957 # most-secure to least-secure.
3958
3959 # Example:
3960 # set smtp_authenticators="digest-md5:cram-md5"
3961
3962
3963 # set smtp_pass=""
3964 #
3965 # Name: smtp_pass
3966 # Type: string
3967 # Default: ""
3968
3969
3970 # Specifies the password for your SMTP account.  If unset, Mutt will
3971 # prompt you for your password when you first send mail via SMTP.
3972 # See $smtp_url to configure mutt to send mail via SMTP.
3973
3974 # Warning: you should only use this option when you are on a
3975 # fairly secure machine, because the superuser can read your muttrc even
3976 # if you are the only one who can read the file.
3977
3978
3979 # set smtp_url=""
3980 #
3981 # Name: smtp_url
3982 # Type: string
3983 # Default: ""
3984
3985
3986 # Defines the SMTP smarthost where sent messages should relayed for
3987 # delivery. This should take the form of an SMTP URL, eg:
3988 # smtp[s]://[user[:pass]@]host[:port]/
3989
3990 # where ``[...]'' denotes an optional part.
3991 # Setting this variable overrides the value of the $sendmail
3992 # variable.
3993
3994
3995 # set sort=date
3996 #
3997 # Name: sort
3998 # Type: sort order
3999 # Default: date
4000
4001
4002 # Specifies how to sort messages in the ``index'' menu.  Valid values
4003 # are:
4004 # - date or date-sent
4005 # - date-received
4006 # - from
4007 # - mailbox-order (unsorted)
4008 # - score
4009 # - size
4010 # - spam
4011 # - subject
4012 # - threads
4013 # - to
4014
4015
4016 # You may optionally use the ``reverse-'' prefix to specify reverse sorting
4017 # order (example: ``set sort=reverse-date-sent'').
4018
4019
4020 # set sort_alias=alias
4021 #
4022 # Name: sort_alias
4023 # Type: sort order
4024 # Default: alias
4025
4026
4027 # Specifies how the entries in the ``alias'' menu are sorted.  The
4028 # following are legal values:
4029 # - address (sort alphabetically by email address)
4030 # - alias (sort alphabetically by alias name)
4031 # - unsorted (leave in order specified in .muttrc)
4032
4033
4034 # set sort_aux=date
4035 #
4036 # Name: sort_aux
4037 # Type: sort order
4038 # Default: date
4039
4040
4041 # When sorting by threads, this variable controls how threads are sorted
4042 # in relation to other threads, and how the branches of the thread trees
4043 # are sorted.  This can be set to any value that $sort can, except
4044 # ``threads'' (in that case, mutt will just use ``date-sent'').  You can also
4045 # specify the ``last-'' prefix in addition to the ``reverse-'' prefix, but ``last-''
4046 # must come after ``reverse-''.  The ``last-'' prefix causes messages to be
4047 # sorted against its siblings by which has the last descendant, using
4048 # the rest of $sort_aux as an ordering.  For instance,
4049 # set sort_aux=last-date-received
4050
4051 # would mean that if a new message is received in a
4052 # thread, that thread becomes the last one displayed (or the first, if
4053 # you have ``set sort=reverse-threads''.)
4054
4055 # Note: For reversed $sort
4056 # order $sort_aux is reversed again (which is not the right thing to do,
4057 # but kept to not break any existing configuration setting).
4058
4059
4060 # set sort_browser=alpha
4061 #
4062 # Name: sort_browser
4063 # Type: sort order
4064 # Default: alpha
4065
4066
4067 # Specifies how to sort entries in the file browser.  By default, the
4068 # entries are sorted alphabetically.  Valid values:
4069 # - alpha (alphabetically)
4070 # - date
4071 # - size
4072 # - unsorted
4073
4074
4075 # You may optionally use the ``reverse-'' prefix to specify reverse sorting
4076 # order (example: ``set sort_browser=reverse-date'').
4077
4078
4079 # set sort_re=yes
4080 #
4081 # Name: sort_re
4082 # Type: boolean
4083 # Default: yes
4084
4085
4086 # This variable is only useful when sorting by threads with
4087 # $strict_threads unset.  In that case, it changes the heuristic
4088 # mutt uses to thread messages by subject.  With $sort_re set, mutt will
4089 # only attach a message as the child of another message by subject if
4090 # the subject of the child message starts with a substring matching the
4091 # setting of $reply_regexp.  With $sort_re unset, mutt will attach
4092 # the message whether or not this is the case, as long as the
4093 # non-$reply_regexp parts of both messages are identical.
4094
4095
4096 # set spam_separator=","
4097 #
4098 # Name: spam_separator
4099 # Type: string
4100 # Default: ","
4101
4102
4103 # This variable controls what happens when multiple spam headers
4104 # are matched: if unset, each successive header will overwrite any
4105 # previous matches value for the spam label. If set, each successive
4106 # match will append to the previous, using this variable's value as a
4107 # separator.
4108
4109
4110 # set spoolfile=""
4111 #
4112 # Name: spoolfile
4113 # Type: path
4114 # Default: ""
4115
4116
4117 # If your spool mailbox is in a non-default place where Mutt cannot find
4118 # it, you can specify its location with this variable.  Mutt will
4119 # initially set this variable to the value of the environment
4120 # variable $MAIL or $MAILDIR if either is defined.
4121
4122
4123 # set ssl_ca_certificates_file=""
4124 #
4125 # Name: ssl_ca_certificates_file
4126 # Type: path
4127 # Default: ""
4128
4129
4130 # This variable specifies a file containing trusted CA certificates.
4131 # Any server certificate that is signed with one of these CA
4132 # certificates is also automatically accepted.
4133
4134 # Example:
4135 # set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
4136
4137
4138 # set ssl_client_cert=""
4139 #
4140 # Name: ssl_client_cert
4141 # Type: path
4142 # Default: ""
4143
4144
4145 # The file containing a client certificate and its associated private
4146 # key.
4147
4148
4149 # set ssl_force_tls=no
4150 #
4151 # Name: ssl_force_tls
4152 # Type: boolean
4153 # Default: no
4154
4155
4156 # If this variable is set, Mutt will require that all connections
4157 # to remote servers be encrypted. Furthermore it will attempt to
4158 # negotiate TLS even if the server does not advertise the capability,
4159 # since it would otherwise have to abort the connection anyway. This
4160 # option supersedes $ssl_starttls.
4161
4162
4163 # set ssl_min_dh_prime_bits=0
4164 #
4165 # Name: ssl_min_dh_prime_bits
4166 # Type: number
4167 # Default: 0
4168
4169
4170 # This variable specifies the minimum acceptable prime size (in bits)
4171 # for use in any Diffie-Hellman key exchange. A value of 0 will use
4172 # the default from the GNUTLS library.
4173
4174
4175 # set ssl_starttls=yes
4176 #
4177 # Name: ssl_starttls
4178 # Type: quadoption
4179 # Default: yes
4180
4181
4182 # If set (the default), mutt will attempt to use STARTTLS on servers
4183 # advertising the capability. When unset, mutt will not attempt to
4184 # use STARTTLS regardless of the server's capabilities.
4185
4186
4187 # set ssl_use_sslv2=no
4188 #
4189 # Name: ssl_use_sslv2
4190 # Type: boolean
4191 # Default: no
4192
4193
4194 # This variable specifies whether to attempt to use SSLv2 in the
4195 # SSL authentication process.
4196
4197
4198 # set ssl_use_sslv3=yes
4199 #
4200 # Name: ssl_use_sslv3
4201 # Type: boolean
4202 # Default: yes
4203
4204
4205 # This variable specifies whether to attempt to use SSLv3 in the
4206 # SSL authentication process.
4207
4208
4209 # set ssl_use_tlsv1=yes
4210 #
4211 # Name: ssl_use_tlsv1
4212 # Type: boolean
4213 # Default: yes
4214
4215
4216 # This variable specifies whether to attempt to use TLSv1 in the
4217 # SSL authentication process.
4218
4219
4220 # set ssl_usesystemcerts=yes
4221 #
4222 # Name: ssl_usesystemcerts
4223 # Type: boolean
4224 # Default: yes
4225
4226
4227 # If set to yes, mutt will use CA certificates in the
4228 # system-wide certificate store when checking if a server certificate
4229 # is signed by a trusted CA.
4230
4231
4232 # set ssl_verify_dates=yes
4233 #
4234 # Name: ssl_verify_dates
4235 # Type: boolean
4236 # Default: yes
4237
4238
4239 # If set (the default), mutt will not automatically accept a server
4240 # certificate that is either not yet valid or already expired. You should
4241 # only unset this for particular known hosts, using the
4242 # <account-hook> function.
4243
4244
4245 # set ssl_verify_host=yes
4246 #
4247 # Name: ssl_verify_host
4248 # Type: boolean
4249 # Default: yes
4250
4251
4252 # If set (the default), mutt will not automatically accept a server
4253 # certificate whose host name does not match the host used in your folder
4254 # URL. You should only unset this for particular known hosts, using
4255 # the <account-hook> function.
4256
4257
4258 # set status_chars="-*%A"
4259 #
4260 # Name: status_chars
4261 # Type: string
4262 # Default: "-*%A"
4263
4264
4265 # Controls the characters used by the ``%r'' indicator in
4266 # $status_format. The first character is used when the mailbox is
4267 # unchanged. The second is used when the mailbox has been changed, and
4268 # it needs to be resynchronized. The third is used if the mailbox is in
4269 # read-only mode, or if the mailbox will not be written when exiting
4270 # that mailbox (You can toggle whether to write changes to a mailbox
4271 # with the <toggle-write> operation, bound by default to ``%''). The fourth
4272 # is used to indicate that the current folder has been opened in attach-
4273 # message mode (Certain operations like composing a new mail, replying,
4274 # forwarding, etc. are not permitted in this mode).
4275
4276
4277 # 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)---"
4278 #
4279 # Name: status_format
4280 # Type: string
4281 # 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)---"
4282
4283
4284 # Controls the format of the status line displayed in the ``index''
4285 # menu.  This string is similar to $index_format, but has its own
4286 # set of printf(3)-like sequences:
4287 # %b      number of mailboxes with new mail *
4288 # %d      number of deleted messages *
4289 # %f      the full pathname of the current mailbox
4290 # %F      number of flagged messages *
4291 # %h      local hostname
4292 # %l      size (in bytes) of the current mailbox *
4293 # %L      size (in bytes) of the messages shown
4294 #         (i.e., which match the current limit) *
4295 # %m      the number of messages in the mailbox *
4296 # %M      the number of messages shown (i.e., which match the current limit) *
4297 # %n      number of new messages in the mailbox *
4298 # %o      number of old unread messages *
4299 # %p      number of postponed messages *
4300 # %P      percentage of the way through the index
4301 # %r      modified/read-only/won't-write/attach-message indicator,
4302 #         according to $status_chars
4303 # %s      current sorting mode ($sort)
4304 # %S      current aux sorting method ($sort_aux)
4305 # %t      number of tagged messages *
4306 # %u      number of unread messages *
4307 # %v      Mutt version string
4308 # %V      currently active limit pattern, if any *
4309 # %>X     right justify the rest of the string and pad with ``X''
4310 # %|X     pad to the end of the line with ``X''
4311 # %*X     soft-fill with character ``X'' as pad
4312
4313
4314 # For an explanation of ``soft-fill'', see the $index_format documentation.
4315
4316 # * = can be optionally printed if nonzero
4317
4318 # Some of the above sequences can be used to optionally print a string
4319 # if their value is nonzero.  For example, you may only want to see the
4320 # number of flagged messages if such messages exist, since zero is not
4321 # particularly meaningful.  To optionally print a string based upon one
4322 # of the above sequences, the following construct is used:
4323
4324 # %?<sequence_char>?<optional_string>?
4325
4326 # where sequence_char is a character from the table above, and
4327 # optional_string is the string you would like printed if
4328 # sequence_char is nonzero.  optional_string may contain
4329 # other sequences as well as normal text, but you may not nest
4330 # optional strings.
4331
4332 # Here is an example illustrating how to optionally print the number of
4333 # new messages in a mailbox:
4334
4335 # %?n?%n new messages.?
4336
4337 # You can also switch between two strings using the following construct:
4338
4339 # %?<sequence_char>?<if_string>&<else_string>?
4340
4341 # If the value of sequence_char is non-zero, if_string will
4342 # be expanded, otherwise else_string will be expanded.
4343
4344 # You can force the result of any printf(3)-like sequence to be lowercase
4345 # by prefixing the sequence character with an underscore (``_'') sign.
4346 # For example, if you want to display the local hostname in lowercase,
4347 # you would use: ``%_h''.
4348
4349 # If you prefix the sequence character with a colon (``:'') character, mutt
4350 # will replace any dots in the expansion by underscores. This might be helpful
4351 # with IMAP folders that don't like dots in folder names.
4352
4353
4354 # set status_on_top=no
4355 #
4356 # Name: status_on_top
4357 # Type: boolean
4358 # Default: no
4359
4360
4361 # Setting this variable causes the ``status bar'' to be displayed on
4362 # the first line of the screen rather than near the bottom. If $help
4363 # is set, too it'll be placed at the bottom.
4364
4365
4366 # set strict_threads=no
4367 #
4368 # Name: strict_threads
4369 # Type: boolean
4370 # Default: no
4371
4372
4373 # If set, threading will only make use of the ``In-Reply-To'' and
4374 # ``References:'' fields when you $sort by message threads.  By
4375 # default, messages with the same subject are grouped together in
4376 # ``pseudo threads.''. This may not always be desirable, such as in a
4377 # personal mailbox where you might have several unrelated messages with
4378 # the subjects like ``hi'' which will get grouped together. See also
4379 # $sort_re for a less drastic way of controlling this
4380 # behaviour.
4381
4382
4383 # set suspend=yes
4384 #
4385 # Name: suspend
4386 # Type: boolean
4387 # Default: yes
4388
4389
4390 # When unset, mutt won't stop when the user presses the terminal's
4391 # susp key, usually ``^Z''. This is useful if you run mutt
4392 # inside an xterm using a command like ``xterm -e mutt''.
4393
4394
4395 # set text_flowed=no
4396 #
4397 # Name: text_flowed
4398 # Type: boolean
4399 # Default: no
4400
4401
4402 # When set, mutt will generate ``format=flowed'' bodies with a content type
4403 # of ``text/plain; format=flowed''.
4404 # This format is easier to handle for some mailing software, and generally
4405 # just looks like ordinary text.  To actually make use of this format's
4406 # features, you'll need support in your editor.
4407
4408 # Note that $indent_string is ignored when this option is set.
4409
4410
4411 # set thorough_search=no
4412 #
4413 # Name: thorough_search
4414 # Type: boolean
4415 # Default: no
4416
4417
4418 # Affects the ~b and ~h search operations described in
4419 # section ``patterns''.  If set, the headers and body/attachments of
4420 # messages to be searched are decoded before searching. If unset,
4421 # messages are searched as they appear in the folder.
4422
4423 # Users searching attachments or for non-ASCII characters should set
4424 # this value because decoding also includes MIME parsing/decoding and possible
4425 # character set conversions. Otherwise mutt will attempt to match against the
4426 # raw message received (for example quoted-printable encoded or with encoded
4427 # headers) which may lead to incorrect search results.
4428
4429
4430 # set thread_received=no
4431 #
4432 # Name: thread_received
4433 # Type: boolean
4434 # Default: no
4435
4436
4437 # When set, mutt uses the date received rather than the date sent
4438 # to thread messages by subject.
4439
4440
4441 # set tilde=no
4442 #
4443 # Name: tilde
4444 # Type: boolean
4445 # Default: no
4446
4447
4448 # When set, the internal-pager will pad blank lines to the bottom of the
4449 # screen with a tilde (``~'').
4450
4451
4452 # set time_inc=0
4453 #
4454 # Name: time_inc
4455 # Type: number
4456 # Default: 0
4457
4458
4459 # Along with $read_inc, $write_inc, and $net_inc, this
4460 # variable controls the frequency with which progress updates are
4461 # displayed. It suppresses updates less than $time_inc milliseconds
4462 # apart. This can improve throughput on systems with slow terminals,
4463 # or when running mutt on a remote system.
4464
4465 # Also see the ``tuning'' section of the manual for performance considerations.
4466
4467
4468 # set timeout=600
4469 #
4470 # Name: timeout
4471 # Type: number
4472 # Default: 600
4473
4474
4475 # When Mutt is waiting for user input either idleing in menus or
4476 # in an interactive prompt, Mutt would block until input is
4477 # present. Depending on the context, this would prevent certain
4478 # operations from working, like checking for new mail or keeping
4479 # an IMAP connection alive.
4480
4481 # This variable controls how many seconds Mutt will at most wait
4482 # until it aborts waiting for input, performs these operations and
4483 # continues to wait for input.
4484
4485 # A value of zero or less will cause Mutt to never time out.
4486
4487
4488 # set tmpdir=""
4489 #
4490 # Name: tmpdir
4491 # Type: path
4492 # Default: ""
4493
4494
4495 # This variable allows you to specify where Mutt will place its
4496 # temporary files needed for displaying and composing messages.  If
4497 # this variable is not set, the environment variable $TMPDIR is
4498 # used.  If $TMPDIR is not set then ``/tmp'' is used.
4499
4500
4501 # set to_chars=" +TCFL"
4502 #
4503 # Name: to_chars
4504 # Type: string
4505 # Default: " +TCFL"
4506
4507
4508 # Controls the character used to indicate mail addressed to you.  The
4509 # first character is the one used when the mail is not addressed to your
4510 # address.  The second is used when you are the only
4511 # recipient of the message.  The third is when your address
4512 # appears in the ``To:'' header field, but you are not the only recipient of
4513 # the message.  The fourth character is used when your
4514 # address is specified in the ``Cc:'' header field, but you are not the only
4515 # recipient.  The fifth character is used to indicate mail that was sent
4516 # by you.  The sixth character is used to indicate when a mail
4517 # was sent to a mailing-list you subscribe to.
4518
4519
4520 # set tunnel=""
4521 #
4522 # Name: tunnel
4523 # Type: string
4524 # Default: ""
4525
4526
4527 # Setting this variable will cause mutt to open a pipe to a command
4528 # instead of a raw socket. You may be able to use this to set up
4529 # preauthenticated connections to your IMAP/POP3/SMTP server. Example:
4530 # set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
4531
4532 # Note: For this example to work you must be able to log in to the remote
4533 # machine without having to enter a password.
4534
4535 # When set, Mutt uses the tunnel for all remote connections.
4536 # Please see ``account-hook'' in the manual for how to use different
4537 # tunnel commands per connection.
4538
4539
4540 # set uncollapse_jump=no
4541 #
4542 # Name: uncollapse_jump
4543 # Type: boolean
4544 # Default: no
4545
4546
4547 # When set, Mutt will jump to the next unread message, if any,
4548 # when the current thread is uncollapsed.
4549
4550
4551 # set use_8bitmime=no
4552 #
4553 # Name: use_8bitmime
4554 # Type: boolean
4555 # Default: no
4556
4557
4558 # Warning: do not set this variable unless you are using a version
4559 # of sendmail which supports the -B8BITMIME flag (such as sendmail
4560 # 8.8.x) or you may not be able to send mail.
4561
4562 # When set, Mutt will invoke $sendmail with the -B8BITMIME
4563 # flag when sending 8-bit messages to enable ESMTP negotiation.
4564
4565
4566 # set use_domain=yes
4567 #
4568 # Name: use_domain
4569 # Type: boolean
4570 # Default: yes
4571
4572
4573 # When set, Mutt will qualify all local addresses (ones without the
4574 # ``@host'' portion) with the value of $hostname.  If unset, no
4575 # addresses will be qualified.
4576
4577
4578 # set use_envelope_from=no
4579 #
4580 # Name: use_envelope_from
4581 # Type: boolean
4582 # Default: no
4583
4584
4585 # When set, mutt will set the envelope sender of the message.
4586 # If $envelope_from_address is set, it will be used as the sender
4587 # address. If unset, mutt will attempt to derive the sender from the
4588 # ``From:'' header.
4589
4590 # Note that this information is passed to sendmail command using the
4591 # -f command line switch. Therefore setting this option is not useful
4592 # if the $sendmail variable already contains -f or if the
4593 # executable pointed to by $sendmail doesn't support the -f switch.
4594
4595
4596 # set use_from=yes
4597 #
4598 # Name: use_from
4599 # Type: boolean
4600 # Default: yes
4601
4602
4603 # When set, Mutt will generate the ``From:'' header field when
4604 # sending messages.  If unset, no ``From:'' header field will be
4605 # generated unless the user explicitly sets one using the ``my_hdr''
4606 # command.
4607
4608
4609 # set use_idn=yes
4610 #
4611 # Name: use_idn
4612 # Type: boolean
4613 # Default: yes
4614
4615
4616 # When set, Mutt will show you international domain names decoded.
4617 # Note: You can use IDNs for addresses even if this is unset.
4618 # This variable only affects decoding.
4619
4620
4621 # set use_ipv6=yes
4622 #
4623 # Name: use_ipv6
4624 # Type: boolean
4625 # Default: yes
4626
4627
4628 # When set, Mutt will look for IPv6 addresses of hosts it tries to
4629 # contact.  If this option is unset, Mutt will restrict itself to IPv4 addresses.
4630 # Normally, the default should work.
4631
4632
4633 # set user_agent=yes
4634 #
4635 # Name: user_agent
4636 # Type: boolean
4637 # Default: yes
4638
4639
4640 # When set, mutt will add a ``User-Agent:'' header to outgoing
4641 # messages, indicating which version of mutt was used for composing
4642 # them.
4643
4644
4645 # set visual=""
4646 #
4647 # Name: visual
4648 # Type: path
4649 # Default: ""
4650
4651
4652 # Specifies the visual editor to invoke when the ``~v'' command is
4653 # given in the builtin editor.
4654
4655
4656 # set wait_key=yes
4657 #
4658 # Name: wait_key
4659 # Type: boolean
4660 # Default: yes
4661
4662
4663 # Controls whether Mutt will ask you to press a key after an external command
4664 # has been invoked by these functions: <shell-escape>,
4665 # <pipe-message>, <pipe-entry>, <print-message>,
4666 # and <print-entry> commands.
4667
4668 # It is also used when viewing attachments with ``auto_view'', provided
4669 # that the corresponding mailcap entry has a needsterminal flag,
4670 # and the external program is interactive.
4671
4672 # When set, Mutt will always ask for a key. When unset, Mutt will wait
4673 # for a key only if the external command returned a non-zero status.
4674
4675
4676 # set weed=yes
4677 #
4678 # Name: weed
4679 # Type: boolean
4680 # Default: yes
4681
4682
4683 # When set, mutt will weed headers when displaying, forwarding,
4684 # printing, or replying to messages.
4685
4686
4687 # set wrap=0
4688 #
4689 # Name: wrap
4690 # Type: number
4691 # Default: 0
4692
4693
4694 # When set to a positive value, mutt will wrap text at $wrap characters.
4695 # When set to a negative value, mutt will wrap text so that there are $wrap
4696 # characters of empty space on the right side of the terminal.
4697
4698
4699 # set wrap_search=yes
4700 #
4701 # Name: wrap_search
4702 # Type: boolean
4703 # Default: yes
4704
4705
4706 # Controls whether searches wrap around the end.
4707
4708 # When set, searches will wrap around the first (or last) item. When
4709 # unset, incremental searches will not wrap.
4710
4711
4712 # set wrapmargin=0
4713 #
4714 # Name: wrapmargin
4715 # Type: number
4716 # Default: 0
4717
4718
4719 # (DEPRECATED) Equivalent to setting $wrap with a negative value.
4720
4721
4722 # set write_bcc=yes
4723 #
4724 # Name: write_bcc
4725 # Type: boolean
4726 # Default: yes
4727
4728
4729 # Controls whether mutt writes out the ``Bcc:'' header when preparing
4730 # messages to be sent.  Exim users may wish to unset this. If mutt
4731 # is set to deliver directly via SMTP (see $smtp_url), this
4732 # option does nothing: mutt will never write out the ``Bcc:'' header
4733 # in this case.
4734
4735
4736 # set write_inc=10
4737 #
4738 # Name: write_inc
4739 # Type: number
4740 # Default: 10
4741
4742
4743 # When writing a mailbox, a message will be printed every
4744 # $write_inc messages to indicate progress.  If set to 0, only a
4745 # single message will be displayed before writing a mailbox.
4746
4747 # Also see the $read_inc, $net_inc and $time_inc variables and the
4748 # ``tuning'' section of the manual for performance considerations.
4749
4750