2 # System configuration file for Mutt
5 # default list of header fields to weed when displaying
7 ignore "from " received content- mime-version status x-status message-id
8 ignore sender references return-path lines
10 # imitate the old search-body function
11 macro index \eb "<search>~b " "search in message bodies"
13 # simulate the old url menu
14 macro index,pager,attach,compose \cb "\
15 <enter-command> set my_pipe_decode=\$pipe_decode pipe_decode<Enter>\
16 <pipe-message> urlview<Enter>\
17 <enter-command> set pipe_decode=\$my_pipe_decode; unset my_pipe_decode<Enter>" \
18 "call urlview to extract URLs out of a message"
20 # Show documentation when pressing F1
21 macro generic,pager <F1> "<shell-escape> less /usr/local/share/doc/mutt/manual.txt<Enter>" "show Mutt documentation"
23 # show the incoming mailboxes list (just like "mutt -y") and back when pressing "y"
24 macro index,pager y "<change-folder>?<toggle-mailboxes>" "show incoming mailboxes list"
27 # If Mutt is unable to determine your site's domain name correctly, you can
28 # set the default here.
30 # set hostname=cs.hmc.edu
32 # If your sendmail supports the -B8BITMIME flag, enable the following
37 ## *** DEFAULT SETTINGS FOR THE ATTACHMENTS PATCH ***
41 ## Please see the manual (section "attachments") for detailed
42 ## documentation of the "attachments" command.
44 ## Removing a pattern from a list removes that pattern literally. It
45 ## does not remove any type matching the pattern.
47 ## attachments +A */.*
48 ## attachments +A image/jpeg
49 ## unattachments +A */.*
51 ## This leaves "attached" image/jpeg files on the allowed attachments
52 ## list. It does not remove all items, as you might expect, because the
53 ## second */.* is not a matching expression at this time.
55 ## Remember: "unattachments" only undoes what "attachments" has done!
56 ## It does not trigger any matching on actual messages.
58 ## Qualify any MIME part with an "attachment" disposition, EXCEPT for
59 ## text/x-vcard and application/pgp parts. (PGP parts are already known
60 ## to mutt, and can be searched for with ~g, ~G, and ~k.)
62 ## I've added x-pkcs7 to this, since it functions (for S/MIME)
63 ## analogously to PGP signature attachments. S/MIME isn't supported
64 ## in a stock mutt build, but we can still treat it specially here.
67 attachments -A text/x-vcard application/pgp.*
68 attachments -A application/x-pkcs7-.*
70 ## Discount all MIME parts with an "inline" disposition, unless they're
71 ## text/plain. (Why inline a text/plain part unless it's external to the
74 attachments +I text/plain
76 ## These two lines make Mutt qualify MIME containers. (So, for example,
77 ## a message/rfc822 forward will count as an attachment.) The first
78 ## line is unnecessary if you already have "attach-allow */.*", of
79 ## course. These are off by default! The MIME elements contained
80 ## within a message/* or multipart/* are still examined, even if the
81 ## containers themseves don't qualify.
83 #attachments +A message/.* multipart/.*
84 #attachments +I message/.* multipart/.*
86 ## You probably don't really care to know about deleted attachments.
87 attachments -A message/external-body
88 attachments -I message/external-body
95 # set abort_nosubject=ask-yes
97 # Name: abort_nosubject
102 # If set to yes, when composing messages and no subject is given
103 # at the subject prompt, composition will be aborted. If set to
104 # no, composing messages with no subject given at the subject
105 # prompt will never be aborted.
108 # set abort_unmodified=yes
110 # Name: abort_unmodified
115 # If set to yes, composition will automatically abort after
116 # editing the message body if no changes are made to the file (this
117 # check only happens after the first edit of the file). When set
118 # to no, composition will never be aborted.
121 # set alias_file="~/.muttrc"
125 # Default: "~/.muttrc"
128 # The default file in which to save aliases created by the
129 # ``create-alias'' function.
131 # Note: Mutt will not automatically source this file; you must
132 # explicitly use the ``source'' command for it to be executed.
134 # The default for this option is the currently used muttrc file, or
135 # ``~/.muttrc'' if no user muttrc was found.
138 # set alias_format="%4n %2f %t %-10a %r"
142 # Default: "%4n %2f %t %-10a %r"
145 # Specifies the format of the data displayed for the `alias' menu. The
146 # following printf(3)-style sequences are available:
149 # %f flags - currently, a "d" for an alias marked for deletion
151 # %r address which alias expands to
152 # %t character which indicates if the alias is tagged for inclusion
162 # Controls whether 8-bit data is converted to 7-bit using either Quoted-
163 # Printable or Base64 encoding when sending mail.
173 # Controls whether ANSI color codes in messages (and color tags in
174 # rich text messages) are to be interpreted.
175 # Messages containing these codes are rare, but if this option is set,
176 # their text will be colored accordingly. Note that this may override
177 # your color choices, and even present a security problem, since a
178 # message could include a line like "[-- PGP output follows ..." and
179 # give it the same color as your attachment color.
182 # set arrow_cursor=no
189 # When set, an arrow (``->'') will be used to indicate the current entry
190 # in menus instead of highlighting the whole line. On slow network or modem
191 # links this will make response faster because there is less that has to
192 # be redrawn on the screen when moving to the next or previous entries
203 # If set, Mutt will use plain ASCII characters when displaying thread
204 # and attachment trees, instead of the default ACS characters.
214 # If set, Mutt will prompt you for blind-carbon-copy (Bcc) recipients
215 # before editing an outgoing message.
225 # If set, Mutt will prompt you for carbon-copy (Cc) recipients before
226 # editing the body of an outgoing message.
229 # set assumed_charset=""
231 # Name: assumed_charset
236 # This variable is a colon-separated list of character encoding
237 # schemes for messages without character encoding indication.
238 # Header field values and message body content without character encoding
239 # indication would be assumed that they are written in one of this list.
240 # By default, all the header fields and message body without any charset
241 # indication are assumed to be in "us-ascii".
243 # For example, Japanese users might prefer this:
245 # set assumed_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
247 # However, only the first content is valid for the message body.
250 # set attach_charset=""
252 # Name: attach_charset
257 # This variable is a colon-separated list of character encoding
258 # schemes for text file attachments.
259 # If unset, $charset value will be used instead.
260 # For example, the following configuration would work for Japanese
263 # set attach_charset="iso-2022-jp:euc-jp:shift_jis:utf-8"
265 # Note: "iso-2022-*" must be put at the head of the value as shown above
269 # set attach_format="%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "
271 # Name: attach_format
273 # Default: "%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] "
276 # This variable describes the format of the `attachment' menu. The
277 # following printf-style sequences are understood:
280 # %c requires charset conversion (n or c)
283 # %e MIME content-transfer-encoding
285 # %I disposition (I=inline, A=attachment)
288 # %n attachment number
289 # %Q "Q", if MIME part qualifies for attachment counting
292 # %T graphic tree characters
293 # %u unlink (=to delete) flag
294 # %X number of qualifying MIME parts in this part and its children
295 # (please see the ``attachments'' section for possible speed effects)
296 # %>X right justify the rest of the string and pad with character "X"
297 # %|X pad to the end of the line with character "X"
298 # %*X soft-fill with character "X" as pad
301 # For an explanation of `soft-fill', see the ``$index_format'' documentation.
304 # set attach_sep="\n"
311 # The separator to add between attachments when operating (saving,
312 # printing, piping, etc) on a list of tagged attachments.
315 # set attach_split=yes
322 # If this variable is unset, when operating (saving, printing, piping,
323 # etc) on a list of tagged attachments, Mutt will concatenate the
324 # attachments and will operate on them as a single attachment. The
325 # ``$attach_sep'' separator is added after each attachment. When set,
326 # Mutt will operate on the attachments one by one.
329 # set attribution="On %d, %n wrote:"
333 # Default: "On %d, %n wrote:"
336 # This is the string that will precede a message which has been included
337 # in a reply. For a full listing of defined printf()-like sequences see
338 # the section on ``$index_format''.
348 # When set along with ``$edit_headers'', Mutt will skip the initial
349 # send-menu and allow you to immediately begin editing the body of your
350 # message. The send-menu may still be accessed once you have finished
351 # editing the body of your message.
353 # Also see ``$fast_reply''.
363 # When set, functions in the index menu which affect a message
364 # will be applied to all tagged messages (if there are any). When
365 # unset, you must first use the tag-prefix function (default: ";") to
366 # make the next function apply to all tagged messages.
376 # When this variable is set, mutt will beep when an error occurs.
386 # When this variable is set, mutt will beep whenever it prints a message
387 # notifying you of new mail. This is independent of the setting of the
388 # ``$beep'' variable.
398 # Controls whether you will be asked to confirm bouncing messages.
399 # If set to yes you don't get asked if you want to bounce a
400 # message. Setting this variable to no is not generally useful,
401 # and thus not recommended, because you are unable to bounce messages.
404 # set bounce_delivered=yes
406 # Name: bounce_delivered
411 # When this variable is set, mutt will include Delivered-To headers when
412 # bouncing messages. Postfix users may wish to unset this variable.
415 # set braille_friendly=no
417 # Name: braille_friendly
422 # When this variable is set, mutt will place the cursor at the beginning
423 # of the current line in menus, even when the arrow_cursor variable
424 # is unset, making it easier for blind persons using Braille displays to
425 # follow these menus. The option is disabled by default because many
426 # visual terminals don't permit making the cursor invisible.
429 # set check_mbox_size=no
431 # Name: check_mbox_size
436 # When this variable is set, mutt will use file size attribute instead of
437 # access time when checking for new mail.
447 # Character set your terminal uses to display and enter textual data.
448 # It is also the fallback for $send_charset.
458 # Note: this option only affects maildir and MH style
461 # When set, Mutt will check for new mail delivered while the
462 # mailbox is open. Especially with MH mailboxes, this operation can
463 # take quite some time since it involves scanning the directory and
464 # checking each file to see if it has already been looked at. If
465 # check_new is unset, no check for new mail is performed
466 # while the mailbox is open.
469 # set collapse_unread=yes
471 # Name: collapse_unread
476 # When unset, Mutt will not collapse a thread if it contains any
480 # set uncollapse_jump=no
482 # Name: uncollapse_jump
487 # When set, Mutt will jump to the next unread message, if any,
488 # when the current thread is uncollapsed.
491 # set compose_format="-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-"
493 # Name: compose_format
495 # Default: "-- Mutt: Compose [Approx. msg size: %l Atts: %a]%>-"
498 # Controls the format of the status line displayed in the Compose
499 # menu. This string is similar to ``$status_format'', but has its own
500 # set of printf()-like sequences:
502 # %a total number of attachments
504 # %l approximate size (in bytes) of the current message
505 # %v Mutt version string
508 # See the text describing the ``$status_format'' option for more
509 # information on how to set ``$compose_format''.
512 # set config_charset=""
514 # Name: config_charset
519 # When defined, Mutt will recode commands in rc files from this
523 # set confirmappend=yes
525 # Name: confirmappend
530 # When set, Mutt will prompt for confirmation when appending messages to
531 # an existing mailbox.
534 # set confirmcreate=yes
536 # Name: confirmcreate
541 # When set, Mutt will prompt for confirmation when saving messages to a
542 # mailbox which does not yet exist before creating it.
545 # set connect_timeout=30
547 # Name: connect_timeout
552 # Causes Mutt to timeout a network connection (for IMAP or POP) after this
553 # many seconds if the connection is not able to be established. A negative
554 # value causes Mutt to wait indefinitely for the connection to succeed.
557 # set content_type="text/plain"
561 # Default: "text/plain"
564 # Sets the default Content-Type for the body of newly composed messages.
574 # This variable controls whether or not copies of your outgoing messages
575 # will be saved for later references. Also see ``$record'',
576 # ``$save_name'', ``$force_name'' and ``fcc-hook''.
579 # set crypt_use_gpgme=no
581 # Name: crypt_use_gpgme
586 # This variable controls the use of the GPGME-enabled crypto backends.
587 # If it is set and Mutt was built with gpgme support, the gpgme code for
588 # S/MIME and PGP will be used instead of the classic code. Note that
589 # you need to set this option in .muttrc; it won't have any effect when
590 # used interactively.
593 # set crypt_use_pka=no
595 # Name: crypt_use_pka
600 # (http://www.g10code.de/docs/pka-intro.de.pdf) during signature
601 # verification (only supported by the GPGME backend).
604 # set crypt_autopgp=yes
606 # Name: crypt_autopgp
611 # This variable controls whether or not mutt may automatically enable
612 # PGP encryption/signing for messages. See also ``$crypt_autoencrypt'',
613 # ``$crypt_replyencrypt'',
614 # ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''.
617 # set crypt_autosmime=yes
619 # Name: crypt_autosmime
624 # This variable controls whether or not mutt may automatically enable
625 # S/MIME encryption/signing for messages. See also ``$crypt_autoencrypt'',
626 # ``$crypt_replyencrypt'',
627 # ``$crypt_autosign'', ``$crypt_replysign'' and ``$smime_is_default''.
630 # set date_format="!%a, %b %d, %Y at %I:%M:%S%p %Z"
634 # Default: "!%a, %b %d, %Y at %I:%M:%S%p %Z"
637 # This variable controls the format of the date printed by the ``%d''
638 # sequence in ``$index_format''. This is passed to the strftime
639 # call to process the date. See the man page for strftime(3) for
642 # Unless the first character in the string is a bang (``!''), the month
643 # and week day names are expanded according to the locale specified in
644 # the variable ``$locale''. If the first character in the string is a
645 # bang, the bang is discarded, and the month and week day names in the
646 # rest of the string are expanded in the C locale (that is in US
650 # set default_hook="~f %s !~P | (~P ~C %s)"
654 # Default: "~f %s !~P | (~P ~C %s)"
657 # This variable controls how message-hooks, reply-hooks, send-hooks,
658 # send2-hooks, save-hooks, and fcc-hooks will
659 # be interpreted if they are specified with only a simple regexp,
660 # instead of a matching pattern. The hooks are expanded when they are
661 # declared, so a hook will be interpreted according to the value of this
662 # variable at the time the hook is declared. The default value matches
663 # if the message is either from a user matching the regular expression
664 # given, or if it is from you (if the from address matches
665 # ``alternates'') and is to or cc'ed to a user matching the given
666 # regular expression.
676 # Controls whether or not messages are really deleted when closing or
677 # synchronizing a mailbox. If set to yes, messages marked for
678 # deleting will automatically be purged without prompting. If set to
679 # no, messages marked for deletion will be kept in the mailbox.
682 # set delete_untag=yes
689 # If this option is set, mutt will untag messages when marking them
690 # for deletion. This applies when you either explicitly delete a message,
691 # or when you save it to another folder.
694 # set digest_collapse=yes
696 # Name: digest_collapse
701 # If this option is set, mutt's received-attachments menu will not show the subparts of
702 # individual messages in a multipart/digest. To see these subparts, press 'v' on that menu.
705 # set display_filter=""
707 # Name: display_filter
712 # When set, specifies a command used to filter messages. When a message
713 # is viewed it is passed as standard input to $display_filter, and the
714 # filtered message is read from the standard output.
717 # set dotlock_program="/usr/local/bin/mutt_dotlock"
719 # Name: dotlock_program
721 # Default: "/usr/local/bin/mutt_dotlock"
724 # Contains the path of the mutt_dotlock (8) binary to be used by
735 # This variable sets the request for when notification is returned. The
736 # string consists of a comma separated list (no spaces!) of one or more
737 # of the following: never, to never request notification,
738 # failure, to request notification on transmission failure,
739 # delay, to be notified of message delays, success, to be
740 # notified of successful transmission.
742 # Example: set dsn_notify="failure,delay"
744 # Note: when using $sendmail for delivery, you should not enable
745 # this unless you are either using Sendmail 8.8.x or greater or a MTA
746 # providing a sendmail(1)-compatible interface supporting the -N option
747 # for DSN. For SMTP delivery, it depends on the server whether DSN is
758 # This variable controls how much of your message is returned in DSN
759 # messages. It may be set to either hdrs to return just the
760 # message header, or full to return the full message.
762 # Example: set dsn_return=hdrs
764 # Note: when using $sendmail for delivery, you should not enable
765 # this unless you are either using Sendmail 8.8.x or greater or a MTA
766 # providing a sendmail(1)-compatible interface supporting the -R option
767 # for DSN. For SMTP delivery, it depends on the server whether DSN is
771 # set duplicate_threads=yes
773 # Name: duplicate_threads
778 # This variable controls whether mutt, when sorting by threads, threads
779 # messages with the same message-id together. If it is set, it will indicate
780 # that it thinks they are duplicates of each other with an equals sign
781 # in the thread diagram.
784 # set edit_headers=no
791 # This option allows you to edit the header of your outgoing messages
792 # along with the body of your message.
794 # Note that changes made to the References: and Date: headers are
795 # ignored for interoperability reasons.
805 # This variable specifies which editor is used by mutt.
806 # It defaults to the value of the VISUAL, or EDITOR, environment
807 # variable, or to the string "vi" if neither of those are set.
817 # When set, mutt will quoted-printable encode messages when
818 # they contain the string "From " in the beginning of a line.
819 # Useful to avoid the tampering certain mail delivery and transport
820 # agents tend to do with messages.
823 # set envelope_from_address=""
825 # Name: envelope_from_address
826 # Type: e-mail address
830 # Manually sets the envelope sender for outgoing messages.
831 # This value is ignored if ``$use_envelope_from'' is unset.
841 # Escape character to use for functions in the builtin editor.
851 # When set, the initial prompt for recipients and subject are skipped
852 # when replying to messages, and the initial prompt for subject is
853 # skipped when forwarding messages.
855 # Note: this variable has no effect when the ``$autoedit''
866 # This variable controls whether or not attachments on outgoing messages
867 # are saved along with the main body of your message.
877 # When this variable is set, FCCs will be stored unencrypted and
878 # unsigned, even when the actual message is encrypted and/or
883 # set folder="~/Mail"
890 # Specifies the default location of your mailboxes. A `+' or `=' at the
891 # beginning of a pathname will be expanded to the value of this
892 # variable. Note that if you change this variable from the default
893 # value you need to make sure that the assignment occurs before
894 # you use `+' or `=' for any other variables since expansion takes place
895 # during the `set' command.
898 # set folder_format="%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f"
900 # Name: folder_format
902 # Default: "%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f"
905 # This variable allows you to customize the file browser display to your
906 # personal taste. This string is similar to ``$index_format'', but has
907 # its own set of printf()-like sequences:
909 # %C current file number
910 # %d date/time folder was last modified
912 # %F file permissions
913 # %g group name (or numeric gid, if missing)
914 # %l number of hard links
915 # %N N if folder has new mail, blank otherwise
917 # %t * if the file is tagged, blank otherwise
918 # %u owner name (or numeric uid, if missing)
919 # %>X right justify the rest of the string and pad with character "X"
920 # %|X pad to the end of the line with character "X"
921 # %*X soft-fill with character "X" as pad
924 # For an explanation of `soft-fill', see the ``$index_format'' documentation.
927 # set followup_to=yes
934 # Controls whether or not the Mail-Followup-To header field is
935 # generated when sending mail. When set, Mutt will generate this
936 # field when you are replying to a known mailing list, specified with
937 # the ``subscribe'' or ``lists'' commands.
939 # This field has two purposes. First, preventing you from
940 # receiving duplicate copies of replies to messages which you send
941 # to mailing lists, and second, ensuring that you do get a reply
942 # separately for any messages sent to known lists to which you are
943 # not subscribed. The header will contain only the list's address
944 # for subscribed lists, and both the list address and your own
945 # email address for unsubscribed lists. Without this header, a
946 # group reply to your message sent to a subscribed list will be
947 # sent to both the list and your address, resulting in two copies
948 # of the same email for you.
958 # This variable is similar to ``$save_name'', except that Mutt will
959 # store a copy of your outgoing message by the username of the address
960 # you are sending to even if that mailbox does not exist.
962 # Also see the ``$record'' variable.
965 # set forward_decode=yes
967 # Name: forward_decode
972 # Controls the decoding of complex MIME messages into text/plain when
973 # forwarding a message. The message header is also RFC2047 decoded.
974 # This variable is only used, if ``$mime_forward'' is unset,
975 # otherwise ``$mime_forward_decode'' is used instead.
978 # set forward_edit=yes
985 # This quadoption controls whether or not the user is automatically
986 # placed in the editor when forwarding messages. For those who always want
987 # to forward with no modification, use a setting of ``no''.
990 # set forward_format="[%a: %s]"
992 # Name: forward_format
994 # Default: "[%a: %s]"
997 # This variable controls the default subject when forwarding a message.
998 # It uses the same format sequences as the ``$index_format'' variable.
1001 # set forward_quote=no
1003 # Name: forward_quote
1008 # When set forwarded messages included in the main body of the
1009 # message (when ``$mime_forward'' is unset) will be quoted using
1010 # ``$indent_string''.
1016 # Type: e-mail address
1020 # When set, this variable contains a default from address. It
1021 # can be overridden using my_hdr (including from send-hooks) and
1022 # ``$reverse_name''. This variable is ignored if ``$use_from''
1025 # Defaults to the contents of the environment variable EMAIL.
1028 # set gecos_mask="^[^,]*"
1031 # Type: regular expression
1035 # A regular expression used by mutt to parse the GECOS field of a password
1036 # entry when expanding the alias. By default the regular expression is set
1037 # to "^[^,]*" which will return the string up to the first "," encountered.
1038 # If the GECOS field contains a string like "lastname, firstname" then you
1039 # should set the gecos_mask=".*".
1041 # This can be useful if you see the following behavior: you address a e-mail
1042 # to user ID stevef whose full name is Steve Franklin. If mutt expands
1043 # stevef to "Franklin" stevef@foo.bar then you should set the gecos_mask to
1044 # a regular expression that will match the whole name so mutt will expand
1045 # "Franklin" to "Franklin, Steve".
1055 # When unset, the header fields normally added by the ``my_hdr''
1056 # command are not created. This variable must be unset before
1057 # composing a new message or replying in order to take effect. If set,
1058 # the user defined header fields are added to every new message.
1068 # When set, this variable causes Mutt to include the header
1069 # of the message you are replying to into the edit buffer.
1070 # The ``$weed'' setting applies.
1080 # When set, help lines describing the bindings for the major functions
1081 # provided by each menu are displayed on the first line of the screen.
1083 # Note: The binding will not be displayed correctly if the
1084 # function is bound to a sequence rather than a single keystroke. Also,
1085 # the help line may not be updated if a binding is changed while Mutt is
1086 # running. Since this variable is primarily aimed at new users, neither
1087 # of these should present a major problem.
1090 # set hidden_host=no
1097 # When set, mutt will skip the host name part of ``$hostname'' variable
1098 # when adding the domain part to addresses. This variable does not
1099 # affect the generation of Message-IDs, and it will not lead to the
1100 # cut-off of first-level domains.
1103 # set hide_limited=no
1105 # Name: hide_limited
1110 # When set, mutt will not show the presence of messages that are hidden
1111 # by limiting, in the thread tree.
1114 # set hide_missing=yes
1116 # Name: hide_missing
1121 # When set, mutt will not show the presence of missing messages in the
1125 # set hide_thread_subject=yes
1127 # Name: hide_thread_subject
1132 # When set, mutt will not show the subject of messages in the thread
1133 # tree that have the same subject as their parent or closest previously
1134 # displayed sibling.
1137 # set hide_top_limited=no
1139 # Name: hide_top_limited
1144 # When set, mutt will not show the presence of messages that are hidden
1145 # by limiting, at the top of threads in the thread tree. Note that when
1146 # $hide_limited is set, this option will have no effect.
1149 # set hide_top_missing=yes
1151 # Name: hide_top_missing
1156 # When set, mutt will not show the presence of missing messages at the
1157 # top of threads in the thread tree. Note that when $hide_missing is
1158 # set, this option will have no effect.
1168 # This variable controls the size (in number of strings remembered) of
1169 # the string history buffer. The buffer is cleared each time the
1173 # set history_file="~/.mutthistory"
1175 # Name: history_file
1177 # Default: "~/.mutthistory"
1180 # The file in which Mutt will save its history.
1183 # set honor_followup_to=yes
1185 # Name: honor_followup_to
1190 # This variable controls whether or not a Mail-Followup-To header is
1191 # honored when group-replying to a message.
1201 # Specifies the fully-qualified hostname of the system mutt is running on
1202 # containing the host's name and the DNS domain it belongs to. It is used
1203 # as the domain part (after ``@'') for local email addresses as well as
1204 # Message-Id headers.
1206 # Its value is determined at startup as follows: If the node's name
1207 # as returned by the uname(3) function contains the hostname and the
1208 # domain, these are used to construct $hostname. If there is no
1209 # domain part returned, Mutt will look for a ``domain'' or ``search''
1210 # line in /etc/resolv.conf to determine the domain. Optionally, Mutt
1211 # can be compiled with a fixed domain name in which case a detected
1214 # Also see ``$use_domain'' and ``$hidden_host''.
1217 # set ignore_linear_white_space=no
1219 # Name: ignore_linear_white_space
1224 # This option replaces linear-white-space between encoded-word
1225 # and *text to a single space to prevent the display of MIME-encoded
1226 # ``Subject'' field from being divided into multiple lines.
1229 # set ignore_list_reply_to=no
1231 # Name: ignore_list_reply_to
1236 # Affects the behaviour of the reply function when replying to
1237 # messages from mailing lists (as defined by the ``subscribe'' or
1238 # ``lists'' commands). When set, if the ``Reply-To:'' field is
1239 # set to the same value as the ``To:'' field, Mutt assumes that the
1240 # ``Reply-To:'' field was set by the mailing list to automate responses
1241 # to the list, and will ignore this field. To direct a response to the
1242 # mailing list when this option is set, use the list-reply
1243 # function; group-reply will reply to both the sender and the
1247 # set imap_authenticators=""
1249 # Name: imap_authenticators
1254 # This is a colon-delimited list of authentication methods mutt may
1255 # attempt to use to log in to an IMAP server, in the order mutt should
1256 # try them. Authentication methods are either 'login' or the right
1257 # side of an IMAP 'AUTH=xxx' capability string, eg 'digest-md5', 'gssapi'
1258 # or 'cram-md5'. This parameter is case-insensitive. If this
1259 # parameter is unset (the default) mutt will try all available methods,
1260 # in order from most-secure to least-secure.
1262 # Example: set imap_authenticators="gssapi:cram-md5:login"
1264 # Note: Mutt will only fall back to other authentication methods if
1265 # the previous methods are unavailable. If a method is available but
1266 # authentication fails, mutt will not connect to the IMAP server.
1269 # set imap_check_subscribed=no
1271 # Name: imap_check_subscribed
1276 # When set, mutt will fetch the set of subscribed folders from
1277 # your server on connection, and add them to the set of mailboxes
1278 # it polls for new mail. See also the ``mailboxes'' command.
1281 # set imap_delim_chars="/."
1283 # Name: imap_delim_chars
1288 # This contains the list of characters which you would like to treat
1289 # as folder separators for displaying IMAP paths. In particular it
1290 # helps in using the '=' shortcut for your folder variable.
1293 # set imap_headers=""
1295 # Name: imap_headers
1300 # Mutt requests these header fields in addition to the default headers
1301 # ("DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE
1302 # CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES X-LABEL") from IMAP
1303 # servers before displaying the index menu. You may want to add more
1304 # headers for spam detection. Note: This is a space separated list.
1314 # When set, mutt will attempt to use the IMAP IDLE extension
1315 # to check for new mail in the current mailbox. Some servers
1316 # (dovecot was the inspiration for this option) react badly
1317 # to mutt's implementation. If your connection seems to freeze
1318 # up periodically, try unsetting this.
1321 # set imap_keepalive=900
1323 # Name: imap_keepalive
1328 # This variable specifies the maximum amount of time in seconds that mutt
1329 # will wait before polling open IMAP connections, to prevent the server
1330 # from closing them before mutt has finished with them. The default is
1331 # well within the RFC-specified minimum amount of time (30 minutes) before
1332 # a server is allowed to do this, but in practice the RFC does get
1333 # violated every now and then. Reduce this number if you find yourself
1334 # getting disconnected from your IMAP server due to inactivity.
1337 # set imap_list_subscribed=no
1339 # Name: imap_list_subscribed
1344 # This variable configures whether IMAP folder browsing will look for
1345 # only subscribed folders or all folders. This can be toggled in the
1346 # IMAP browser with the toggle-subscribed function.
1356 # Your login name on the IMAP server.
1358 # This variable defaults to the value of imap_user.
1368 # Specifies the password for your IMAP account. If unset, Mutt will
1369 # prompt you for your password when you invoke the fetch-mail function.
1370 # Warning: you should only use this option when you are on a
1371 # fairly secure machine, because the superuser can read your muttrc even
1372 # if you are the only one who can read the file.
1375 # set imap_passive=yes
1377 # Name: imap_passive
1382 # When set, mutt will not open new IMAP connections to check for new
1383 # mail. Mutt will only check for new mail over existing IMAP
1384 # connections. This is useful if you don't want to be prompted to
1385 # user/password pairs on mutt invocation, or if opening the connection
1396 # When set, mutt will avoid implicitly marking your mail as read whenever
1397 # you fetch a message from the server. This is generally a good thing,
1398 # but can make closing an IMAP folder somewhat slower. This option
1399 # exists to appease speed freaks.
1402 # set imap_servernoise=yes
1404 # Name: imap_servernoise
1409 # When set, mutt will display warning messages from the IMAP
1410 # server as error messages. Since these messages are often
1411 # harmless, or generated due to configuration problems on the
1412 # server which are out of the users' hands, you may wish to suppress
1413 # them at some point.
1423 # The name of the user whose mail you intend to access on the IMAP
1426 # This variable defaults to your user name on the local machine.
1429 # set implicit_autoview=no
1431 # Name: implicit_autoview
1436 # If set to ``yes'', mutt will look for a mailcap entry with the
1437 # copiousoutput flag set for every MIME attachment it doesn't have
1438 # an internal viewer defined for. If such an entry is found, mutt will
1439 # use the viewer defined in that entry to convert the body part to text
1443 # set include=ask-yes
1450 # Controls whether or not a copy of the message(s) you are replying to
1451 # is included in your reply.
1454 # set include_onlyfirst=no
1456 # Name: include_onlyfirst
1461 # Controls whether or not Mutt includes only the first attachment
1462 # of the message you are replying.
1465 # set indent_string="> "
1467 # Name: indent_string
1472 # Specifies the string to prepend to each line of text quoted in a
1473 # message to which you are replying. You are strongly encouraged not to
1474 # change this value, as it tends to agitate the more fanatical netizens.
1476 # This option is a format string, please see the description of
1477 # ``$index_format'' for supported printf()-style sequences.
1480 # set index_format="%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"
1482 # Name: index_format
1484 # Default: "%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"
1487 # This variable allows you to customize the message index display to
1488 # your personal taste.
1490 # ``Format strings'' are similar to the strings used in the ``C''
1491 # function printf to format output (see the man page for more detail).
1492 # The following sequences are defined in Mutt:
1494 # %a address of the author
1495 # %A reply-to address (if present; otherwise: address of author)
1496 # %b filename of the original message folder (think mailBox)
1497 # %B the list to which the letter was sent, or else the folder name (%b).
1498 # %c number of characters (bytes) in the message
1499 # %C current message number
1500 # %d date and time of the message in the format specified by
1501 # ``date_format'' converted to sender's time zone
1502 # %D date and time of the message in the format specified by
1503 # ``date_format'' converted to the local time zone
1504 # %e current message number in thread
1505 # %E number of messages in current thread
1506 # %f sender (address + real name), either From: or Return-Path:
1507 # %F author name, or recipient name if the message is from you
1508 # %H spam attribute(s) of this message
1509 # %i message-id of the current message
1510 # %l number of lines in the message (does not work with maildir,
1511 # mh, and possibly IMAP folders)
1512 # %L If an address in the To or CC header field matches an address
1513 # defined by the users ``subscribe'' command, this displays
1514 # "To <list-name>", otherwise the same as %F.
1515 # %m total number of message in the mailbox
1516 # %M number of hidden messages if the thread is collapsed.
1518 # %n author's real name (or address if missing)
1519 # %O (_O_riginal save folder) Where mutt would formerly have
1520 # stashed the message: list name or recipient name if no list
1521 # %P progress indicator for the builtin pager (how much of the file has been displayed)
1522 # %s subject of the message
1523 # %S status of the message (N/D/d/!/r/*)
1524 # %t `to:' field (recipients)
1525 # %T the appropriate character from the $to_chars string
1526 # %u user (login) name of the author
1527 # %v first name of the author, or the recipient if the message is from you
1528 # %X number of attachments
1529 # (please see the ``attachments'' section for possible speed effects)
1530 # %y `x-label:' field, if present
1531 # %Y `x-label' field, if present, and (1) not at part of a thread tree,
1532 # (2) at the top of a thread, or (3) `x-label' is different from
1533 # preceding message's `x-label'.
1534 # %Z message status flags
1535 # %{fmt} the date and time of the message is converted to sender's
1536 # time zone, and ``fmt'' is expanded by the library function
1537 # ``strftime''; a leading bang disables locales
1538 # %[fmt] the date and time of the message is converted to the local
1539 # time zone, and ``fmt'' is expanded by the library function
1540 # ``strftime''; a leading bang disables locales
1541 # %(fmt) the local date and time when the message was received.
1542 # ``fmt'' is expanded by the library function ``strftime'';
1543 # a leading bang disables locales
1544 # %<fmt> the current local time. ``fmt'' is expanded by the library
1545 # function ``strftime''; a leading bang disables locales.
1546 # %>X right justify the rest of the string and pad with character "X"
1547 # %|X pad to the end of the line with character "X"
1548 # %*X soft-fill with character "X" as pad
1551 # `Soft-fill' deserves some explanation. Normal right-justification
1552 # will print everything to the left of the %>, displaying padding and
1553 # the whatever lies to the right only if there's room. By contrast,
1554 # soft-fill gives priority to the right-hand side, guaranteeing space
1555 # to display it and showing padding only if there's still room. If
1556 # necessary, soft-fill will eat text leftwards to make room for
1559 # Note that these expandos are supported in
1560 # ``save-hook'', ``fcc-hook'' and ``fcc-save-hook'', too.
1562 # See also: ``$to_chars''.
1565 # set ispell="ispell"
1572 # How to invoke ispell (GNU's spell-checking software).
1575 # set keep_flagged=no
1577 # Name: keep_flagged
1582 # If set, read messages marked as flagged will not be moved
1583 # from your spool mailbox to your ``$mbox'' mailbox, or as a result of
1584 # a ``mbox-hook'' command.
1594 # The locale used by strftime(3) to format dates. Legal values are
1595 # the strings your system accepts for the locale variable LC_TIME.
1605 # This variable configures how often (in seconds) mutt should look for
1606 # new mail. Also see the ``$timeout'' variable.
1609 # set mailcap_path=""
1611 # Name: mailcap_path
1616 # This variable specifies which files to consult when attempting to
1617 # display MIME bodies not directly supported by Mutt.
1620 # set mailcap_sanitize=yes
1622 # Name: mailcap_sanitize
1627 # If set, mutt will restrict possible characters in mailcap % expandos
1628 # to a well-defined set of safe characters. This is the safe setting,
1629 # but we are not sure it doesn't break some more advanced MIME stuff.
1631 # DON'T CHANGE THIS SETTING UNLESS YOU ARE REALLY SURE WHAT YOU ARE
1635 # set header_cache=""
1637 # Name: header_cache
1642 # The header_cache variable points to the header cache database.
1643 # If header_cache points to a directory it will contain a header cache
1644 # database per folder. If header_cache points to a file that file will
1645 # be a single global header cache. By default it is unset so no header
1646 # caching will be used.
1649 # set maildir_header_cache_verify=yes
1651 # Name: maildir_header_cache_verify
1656 # Check for Maildir unaware programs other than mutt having modified maildir
1657 # files when the header cache is in use. This incurs one stat(2) per
1658 # message every time the folder is opened.
1661 # set header_cache_pagesize="16384"
1663 # Name: header_cache_pagesize
1668 # When mutt is compiled with either gdbm or bdb4 as the header cache backend,
1669 # this option changes the database page size. Too large or too small
1670 # values can waste space, memory, or CPU time. The default should be more
1671 # or less optimal for most use cases.
1674 # set header_cache_compress=yes
1676 # Name: header_cache_compress
1681 # When mutt is compiled with qdbm as header cache backend,
1682 # this option determines whether the database will be compressed.
1683 # Compression results in database files roughly being one fifth
1684 # of the usual diskspace, but the uncompression can result in a
1685 # slower opening of cached folder(s).
1688 # set maildir_trash=no
1690 # Name: maildir_trash
1695 # If set, messages marked as deleted will be saved with the maildir
1696 # (T)rashed flag instead of unlinked. NOTE: this only applies
1697 # to maildir-style mailboxes. Setting it will have no effect on other
1708 # Controls whether or not mutt marks new unread
1709 # messages as old if you exit a mailbox without reading them.
1710 # With this option set, the next time you start mutt, the messages
1711 # will show up with an "O" next to them in the index menu,
1712 # indicating that they are old.
1722 # Controls the display of wrapped lines in the internal pager. If set, a
1723 # ``+'' marker is displayed at the beginning of wrapped lines. Also see
1724 # the ``$smart_wrap'' variable.
1727 # set mask="!^\\.[^.]"
1730 # Type: regular expression
1731 # Default: "!^\\.[^.]"
1734 # A regular expression used in the file browser, optionally preceded by
1735 # the not operator ``!''. Only files whose names match this mask
1736 # will be shown. The match is always case-sensitive.
1746 # This specifies the folder into which read mail in your ``$spoolfile''
1747 # folder will be appended.
1750 # set mbox_type=mbox
1753 # Type: folder magic
1757 # The default mailbox type used when creating new folders. May be any of
1758 # mbox, MMDF, MH and Maildir.
1768 # If unset, Mutt will remove your address (see the ``alternates''
1769 # command) from the list of recipients when replying to a message.
1772 # set menu_context=0
1774 # Name: menu_context
1779 # This variable controls the number of lines of context that are given
1780 # when scrolling through menus. (Similar to ``$pager_context''.)
1783 # set menu_move_off=yes
1785 # Name: menu_move_off
1790 # When unset, the bottom entry of menus will never scroll up past
1791 # the bottom of the screen, unless there are less entries than lines.
1792 # When set, the bottom entry may move off the bottom.
1795 # set menu_scroll=no
1802 # When set, menus will be scrolled up or down one line when you
1803 # attempt to move across a screen boundary. If unset, the screen
1804 # is cleared and the next or previous page of the menu is displayed
1805 # (useful for slow links to avoid many redraws).
1815 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8)
1816 # set as if the user had pressed the ESC key and whatever key remains
1817 # after having the high bit removed. For example, if the key pressed
1818 # has an ASCII value of 0xf8, then this is treated as if the user had
1819 # pressed ESC then ``x''. This is because the result of removing the
1820 # high bit from ``0xf8'' is ``0x78'', which is the ASCII character
1831 # When unset, mutt will mimic mh's behaviour and rename deleted messages
1832 # to ,<old file name> in mh folders instead of really deleting
1833 # them. If the variable is set, the message files will simply be
1837 # set mh_seq_flagged="flagged"
1839 # Name: mh_seq_flagged
1841 # Default: "flagged"
1844 # The name of the MH sequence used for flagged messages.
1847 # set mh_seq_replied="replied"
1849 # Name: mh_seq_replied
1851 # Default: "replied"
1854 # The name of the MH sequence used to tag replied messages.
1857 # set mh_seq_unseen="unseen"
1859 # Name: mh_seq_unseen
1864 # The name of the MH sequence used for unseen messages.
1867 # set mime_forward=no
1869 # Name: mime_forward
1874 # When set, the message you are forwarding will be attached as a
1875 # separate MIME part instead of included in the main body of the
1876 # message. This is useful for forwarding MIME messages so the receiver
1877 # can properly view the message as it was delivered to you. If you like
1878 # to switch between MIME and not MIME from mail to mail, set this
1879 # variable to ask-no or ask-yes.
1881 # Also see ``$forward_decode'' and ``$mime_forward_decode''.
1884 # set mime_forward_decode=no
1886 # Name: mime_forward_decode
1891 # Controls the decoding of complex MIME messages into text/plain when
1892 # forwarding a message while ``$mime_forward'' is set. Otherwise
1893 # ``$forward_decode'' is used instead.
1896 # set mime_forward_rest=yes
1898 # Name: mime_forward_rest
1903 # When forwarding multiple attachments of a MIME message from the recvattach
1904 # menu, attachments which cannot be decoded in a reasonable manner will
1905 # be attached to the newly composed message if this option is set.
1908 # set mix_entry_format="%4n %c %-16s %a"
1910 # Name: mix_entry_format
1912 # Default: "%4n %c %-16s %a"
1915 # This variable describes the format of a remailer line on the mixmaster
1916 # chain selection screen. The following printf-like sequences are
1919 # %n The running number on the menu.
1920 # %c Remailer capabilities.
1921 # %s The remailer's short name.
1922 # %a The remailer's e-mail address.
1925 # set mixmaster="mixmaster"
1929 # Default: "mixmaster"
1932 # This variable contains the path to the Mixmaster binary on your
1933 # system. It is used with various sets of parameters to gather the
1934 # list of known remailers, and to finally send a message through the
1945 # Controls whether or not Mutt will move read messages
1946 # from your spool mailbox to your ``$mbox'' mailbox, or as a result of
1947 # a ``mbox-hook'' command.
1950 # set message_cachedir=""
1952 # Name: message_cachedir
1957 # Set this to a directory and mutt will cache copies of messages from
1958 # your IMAP and POP servers here. You are free to remove entries at any
1959 # time, for instance if stale entries accumulate because you have
1960 # deleted messages with another mail client.
1963 # set message_cache_clean=no
1965 # Name: message_cache_clean
1970 # If set, mutt will clean out obsolete entries from the cache when
1971 # the mailbox is synchronized. You probably only want to set it
1972 # every once in a while, since it can be a little slow.
1975 # set message_format="%s"
1977 # Name: message_format
1982 # This is the string displayed in the ``attachment'' menu for
1983 # attachments of type message/rfc822. For a full listing of defined
1984 # printf()-like sequences see the section on ``$index_format''.
1987 # set narrow_tree=no
1994 # This variable, when set, makes the thread tree narrower, allowing
1995 # deeper threads to fit on the screen.
2005 # Operations that expect to transfer a large amount of data over the
2006 # network will update their progress every net_inc kilobytes.
2007 # If set to 0, no progress messages will be displayed.
2009 # See also ``$read_inc'' and ``$write_inc''.
2012 # set pager="builtin"
2016 # Default: "builtin"
2019 # This variable specifies which pager you would like to use to view
2020 # messages. builtin means to use the builtin pager, otherwise this
2021 # variable should specify the pathname of the external pager you would
2024 # Using an external pager may have some disadvantages: Additional
2025 # keystrokes are necessary because you can't call mutt functions
2026 # directly from the pager, and screen resizes cause lines longer than
2027 # the screen width to be badly formatted in the help menu.
2030 # set pager_context=0
2032 # Name: pager_context
2037 # This variable controls the number of lines of context that are given
2038 # when displaying the next or previous page in the internal pager. By
2039 # default, Mutt will display the line after the last one on the screen
2040 # at the top of the next page (0 lines of context).
2043 # set pager_format="-%Z- %C/%m: %-20.20n %s%* -- (%P)"
2045 # Name: pager_format
2047 # Default: "-%Z- %C/%m: %-20.20n %s%* -- (%P)"
2050 # This variable controls the format of the one-line message ``status''
2051 # displayed before each message in either the internal or an external
2052 # pager. The valid sequences are listed in the ``$index_format''
2056 # set pager_index_lines=0
2058 # Name: pager_index_lines
2063 # Determines the number of lines of a mini-index which is shown when in
2064 # the pager. The current message, unless near the top or bottom of the
2065 # folder, will be roughly one third of the way down this mini-index,
2066 # giving the reader the context of a few messages before and after the
2067 # message. This is useful, for example, to determine how many messages
2068 # remain to be read in the current thread. One of the lines is reserved
2069 # for the status bar from the index, so a pager_index_lines of 6
2070 # will only show 5 lines of the actual index. A value of 0 results in
2071 # no index being shown. If the number of messages in the current folder
2072 # is less than pager_index_lines, then the index will only use as
2073 # many lines as it needs.
2083 # When set, the internal-pager will not move to the next message
2084 # when you are at the end of a message and invoke the next-page
2088 # set crypt_autosign=no
2090 # Name: crypt_autosign
2095 # Setting this variable will cause Mutt to always attempt to
2096 # cryptographically sign outgoing messages. This can be overridden
2097 # by use of the pgp-menu, when signing is not required or
2098 # encryption is requested as well. If ``$smime_is_default'' is set,
2099 # then OpenSSL is used instead to create S/MIME messages and settings can
2100 # be overridden by use of the smime-menu.
2104 # set crypt_autoencrypt=no
2106 # Name: crypt_autoencrypt
2111 # Setting this variable will cause Mutt to always attempt to PGP
2112 # encrypt outgoing messages. This is probably only useful in
2113 # connection to the send-hook command. It can be overridden
2114 # by use of the pgp-menu, when encryption is not required or
2115 # signing is requested as well. IF ``$smime_is_default'' is set,
2116 # then OpenSSL is used instead to create S/MIME messages and
2117 # settings can be overridden by use of the smime-menu.
2121 # set pgp_ignore_subkeys=yes
2123 # Name: pgp_ignore_subkeys
2128 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
2129 # the principal key will inherit the subkeys' capabilities. Unset this
2130 # if you want to play interesting key selection games.
2134 # set crypt_replyencrypt=yes
2136 # Name: crypt_replyencrypt
2141 # If set, automatically PGP or OpenSSL encrypt replies to messages which are
2146 # set crypt_replysign=no
2148 # Name: crypt_replysign
2153 # If set, automatically PGP or OpenSSL sign replies to messages which are
2156 # Note: this does not work on messages that are encrypted
2161 # set crypt_replysignencrypted=no
2163 # Name: crypt_replysignencrypted
2168 # If set, automatically PGP or OpenSSL sign replies to messages
2169 # which are encrypted. This makes sense in combination with
2170 # ``$crypt_replyencrypt'', because it allows you to sign all
2171 # messages which are automatically encrypted. This works around
2172 # the problem noted in ``$crypt_replysign'', that mutt is not able
2173 # to find out whether an encrypted message is also signed.
2177 # set crypt_timestamp=yes
2179 # Name: crypt_timestamp
2184 # If set, mutt will include a time stamp in the lines surrounding
2185 # PGP or S/MIME output, so spoofing such lines is more difficult.
2186 # If you are using colors to mark these lines, and rely on these,
2187 # you may unset this setting.
2191 # set pgp_use_gpg_agent=no
2193 # Name: pgp_use_gpg_agent
2198 # If set, mutt will use a possibly-running gpg-agent process.
2202 # set crypt_verify_sig=yes
2204 # Name: crypt_verify_sig
2209 # If ``yes'', always attempt to verify PGP or S/MIME signatures.
2210 # If ``ask'', ask whether or not to verify the signature.
2211 # If ``no'', never attempt to verify cryptographic signatures.
2215 # set smime_is_default=no
2217 # Name: smime_is_default
2222 # The default behaviour of mutt is to use PGP on all auto-sign/encryption
2223 # operations. To override and to use OpenSSL instead this must be set.
2224 # However, this has no effect while replying, since mutt will automatically
2225 # select the same application that was used to sign/encrypt the original
2226 # message. (Note that this variable can be overridden by unsetting $crypt_autosmime.)
2230 # set smime_ask_cert_label=yes
2232 # Name: smime_ask_cert_label
2237 # This flag controls whether you want to be asked to enter a label
2238 # for a certificate about to be added to the database or not. It is
2243 # set smime_decrypt_use_default_key=yes
2245 # Name: smime_decrypt_use_default_key
2250 # If set (default) this tells mutt to use the default key for decryption. Otherwise,
2251 # if manage multiple certificate-key-pairs, mutt will try to use the mailbox-address
2252 # to determine the key to use. It will ask you to supply a key, if it can't find one.
2256 # set pgp_entry_format="%4n %t%f %4l/0x%k %-4a %2c %u"
2258 # Name: pgp_entry_format
2260 # Default: "%4n %t%f %4l/0x%k %-4a %2c %u"
2263 # This variable allows you to customize the PGP key selection menu to
2264 # your personal taste. This string is similar to ``$index_format'', but
2265 # has its own set of printf()-like sequences:
2274 # %t trust/validity of the key-uid association
2275 # %[<s>] date of the key where <s> is an strftime(3) expression
2281 # set pgp_good_sign=""
2283 # Name: pgp_good_sign
2284 # Type: regular expression
2288 # If you assign a text to this variable, then a PGP signature is only
2289 # considered verified if the output from $pgp_verify_command contains
2290 # the text. Use this variable if the exit code from the command is 0
2291 # even for bad signatures.
2295 # set pgp_check_exit=yes
2297 # Name: pgp_check_exit
2302 # If set, mutt will check the exit code of the PGP subprocess when
2303 # signing or encrypting. A non-zero exit code means that the
2304 # subprocess failed.
2308 # set pgp_long_ids=no
2310 # Name: pgp_long_ids
2315 # If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs.
2319 # set pgp_retainable_sigs=no
2321 # Name: pgp_retainable_sigs
2326 # If set, signed and encrypted messages will consist of nested
2327 # multipart/signed and multipart/encrypted body parts.
2329 # This is useful for applications like encrypted and signed mailing
2330 # lists, where the outer layer (multipart/encrypted) can be easily
2331 # removed, while the inner multipart/signed part is retained.
2335 # set pgp_autoinline=no
2337 # Name: pgp_autoinline
2342 # This option controls whether Mutt generates old-style inline
2343 # (traditional) PGP encrypted or signed messages under certain
2344 # circumstances. This can be overridden by use of the pgp-menu,
2345 # when inline is not required.
2347 # Note that Mutt might automatically use PGP/MIME for messages
2348 # which consist of more than a single MIME part. Mutt can be
2349 # configured to ask before sending PGP/MIME messages when inline
2350 # (traditional) would not work.
2351 # See also: ``$pgp_mime_auto''.
2353 # Also note that using the old-style PGP message format is strongly
2358 # set pgp_replyinline=no
2360 # Name: pgp_replyinline
2365 # Setting this variable will cause Mutt to always attempt to
2366 # create an inline (traditional) message when replying to a
2367 # message which is PGP encrypted/signed inline. This can be
2368 # overridden by use of the pgp-menu, when inline is not
2369 # required. This option does not automatically detect if the
2370 # (replied-to) message is inline; instead it relies on Mutt
2371 # internals for previously checked/flagged messages.
2373 # Note that Mutt might automatically use PGP/MIME for messages
2374 # which consist of more than a single MIME part. Mutt can be
2375 # configured to ask before sending PGP/MIME messages when inline
2376 # (traditional) would not work.
2377 # See also: ``$pgp_mime_auto''.
2379 # Also note that using the old-style PGP message format is strongly
2384 # set pgp_show_unusable=yes
2386 # Name: pgp_show_unusable
2391 # If set, mutt will display non-usable keys on the PGP key selection
2392 # menu. This includes keys which have been revoked, have expired, or
2393 # have been marked as ``disabled'' by the user.
2397 # set pgp_sign_as=""
2404 # If you have more than one key pair, this option allows you to specify
2405 # which of your private keys to use. It is recommended that you use the
2406 # keyid form to specify your key (e.g., ``0x00112233'').
2410 # set pgp_strict_enc=yes
2412 # Name: pgp_strict_enc
2417 # If set, Mutt will automatically encode PGP/MIME signed messages as
2418 # quoted-printable. Please note that unsetting this variable may
2419 # lead to problems with non-verifyable PGP signatures, so only change
2420 # this if you know what you are doing.
2424 # set pgp_timeout=300
2431 # The number of seconds after which a cached passphrase will expire if
2436 # set pgp_sort_keys=address
2438 # Name: pgp_sort_keys
2443 # Specifies how the entries in the `pgp keys' menu are sorted. The
2444 # following are legal values:
2446 # address sort alphabetically by user id
2447 # keyid sort alphabetically by key id
2448 # date sort by key creation date
2449 # trust sort by the trust of the key
2452 # If you prefer reverse order of the above values, prefix it with
2457 # set pgp_mime_auto=ask-yes
2459 # Name: pgp_mime_auto
2464 # This option controls whether Mutt will prompt you for
2465 # automatically sending a (signed/encrypted) message using
2466 # PGP/MIME when inline (traditional) fails (for any reason).
2468 # Also note that using the old-style PGP message format is strongly
2473 # set pgp_auto_decode=no
2475 # Name: pgp_auto_decode
2480 # If set, mutt will automatically attempt to decrypt traditional PGP
2481 # messages whenever the user performs an operation which ordinarily would
2482 # result in the contents of the message being operated on. For example,
2483 # if the user displays a pgp-traditional message which has not been manually
2484 # checked with the check-traditional-pgp function, mutt will automatically
2485 # check the message for traditional pgp.
2488 # set pgp_decode_command=""
2490 # Name: pgp_decode_command
2495 # This format strings specifies a command which is used to decode
2496 # application/pgp attachments.
2498 # The PGP command formats have their own set of printf-like sequences:
2500 # %p Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
2501 # string otherwise. Note: This may be used with a %? construct.
2502 # %f Expands to the name of a file containing a message.
2503 # %s Expands to the name of a file containing the signature part
2504 # of a multipart/signed attachment when verifying it.
2505 # %a The value of $pgp_sign_as.
2506 # %r One or more key IDs.
2509 # For examples on how to configure these formats for the various versions
2510 # of PGP which are floating around, see the pgp*.rc and gpg.rc files in
2511 # the samples/ subdirectory which has been installed on your system
2512 # alongside the documentation.
2516 # set pgp_getkeys_command=""
2518 # Name: pgp_getkeys_command
2523 # This command is invoked whenever mutt will need public key information.
2524 # %r is the only printf-like sequence used with this format.
2528 # set pgp_verify_command=""
2530 # Name: pgp_verify_command
2535 # This command is used to verify PGP signatures.
2539 # set pgp_decrypt_command=""
2541 # Name: pgp_decrypt_command
2546 # This command is used to decrypt a PGP encrypted message.
2550 # set pgp_clearsign_command=""
2552 # Name: pgp_clearsign_command
2557 # This format is used to create a old-style "clearsigned" PGP
2558 # message. Note that the use of this format is strongly
2563 # set pgp_sign_command=""
2565 # Name: pgp_sign_command
2570 # This command is used to create the detached PGP signature for a
2571 # multipart/signed PGP/MIME body part.
2575 # set pgp_encrypt_sign_command=""
2577 # Name: pgp_encrypt_sign_command
2582 # This command is used to both sign and encrypt a body part.
2586 # set pgp_encrypt_only_command=""
2588 # Name: pgp_encrypt_only_command
2593 # This command is used to encrypt a body part without signing it.
2597 # set pgp_import_command=""
2599 # Name: pgp_import_command
2604 # This command is used to import a key from a message into
2605 # the user's public key ring.
2609 # set pgp_export_command=""
2611 # Name: pgp_export_command
2616 # This command is used to export a public key from the user's
2621 # set pgp_verify_key_command=""
2623 # Name: pgp_verify_key_command
2628 # This command is used to verify key information from the key selection
2633 # set pgp_list_secring_command=""
2635 # Name: pgp_list_secring_command
2640 # This command is used to list the secret key ring's contents. The
2641 # output format must be analogous to the one used by
2642 # gpg --list-keys --with-colons.
2644 # This format is also generated by the pgpring utility which comes
2649 # set pgp_list_pubring_command=""
2651 # Name: pgp_list_pubring_command
2656 # This command is used to list the public key ring's contents. The
2657 # output format must be analogous to the one used by
2658 # gpg --list-keys --with-colons.
2660 # This format is also generated by the pgpring utility which comes
2665 # set forward_decrypt=yes
2667 # Name: forward_decrypt
2672 # Controls the handling of encrypted messages when forwarding a message.
2673 # When set, the outer layer of encryption is stripped off. This
2674 # variable is only used if ``$mime_forward'' is set and
2675 # ``$mime_forward_decode'' is unset.
2679 # set smime_timeout=300
2681 # Name: smime_timeout
2686 # The number of seconds after which a cached passphrase will expire if
2691 # set smime_encrypt_with=""
2693 # Name: smime_encrypt_with
2698 # This sets the algorithm that should be used for encryption.
2699 # Valid choices are "des", "des3", "rc2-40", "rc2-64", "rc2-128".
2700 # If unset "3des" (TripleDES) is used.
2711 # Since there is no pubring/secring as with PGP, mutt has to handle
2712 # storage ad retrieval of keys/certs by itself. This is very basic right now,
2713 # and stores keys and certificates in two different directories, both
2714 # named as the hash-value retrieved from OpenSSL. There is an index file
2715 # which contains mailbox-address keyid pair, and which can be manually
2716 # edited. This one points to the location of the private keys.
2720 # set smime_ca_location=""
2722 # Name: smime_ca_location
2727 # This variable contains the name of either a directory, or a file which
2728 # contains trusted certificates for use with OpenSSL.
2732 # set smime_certificates=""
2734 # Name: smime_certificates
2739 # Since there is no pubring/secring as with PGP, mutt has to handle
2740 # storage and retrieval of keys by itself. This is very basic right
2741 # now, and keys and certificates are stored in two different
2742 # directories, both named as the hash-value retrieved from
2743 # OpenSSL. There is an index file which contains mailbox-address
2744 # keyid pairs, and which can be manually edited. This one points to
2745 # the location of the certificates.
2749 # set smime_decrypt_command=""
2751 # Name: smime_decrypt_command
2756 # This format string specifies a command which is used to decrypt
2757 # application/x-pkcs7-mime attachments.
2759 # The OpenSSL command formats have their own set of printf-like sequences
2762 # %f Expands to the name of a file containing a message.
2763 # %s Expands to the name of a file containing the signature part
2764 # of a multipart/signed attachment when verifying it.
2765 # %k The key-pair specified with $smime_default_key
2766 # %c One or more certificate IDs.
2767 # %a The algorithm used for encryption.
2768 # %C CA location: Depending on whether $smime_ca_location
2769 # points to a directory or file, this expands to
2770 # "-CApath $smime_ca_location" or "-CAfile $smime_ca_location".
2773 # For examples on how to configure these formats, see the smime.rc in
2774 # the samples/ subdirectory which has been installed on your system
2775 # alongside the documentation.
2779 # set smime_verify_command=""
2781 # Name: smime_verify_command
2786 # This command is used to verify S/MIME signatures of type multipart/signed.
2790 # set smime_verify_opaque_command=""
2792 # Name: smime_verify_opaque_command
2797 # This command is used to verify S/MIME signatures of type
2798 # application/x-pkcs7-mime.
2802 # set smime_sign_command=""
2804 # Name: smime_sign_command
2809 # This command is used to created S/MIME signatures of type
2810 # multipart/signed, which can be read by all mail clients.
2814 # set smime_sign_opaque_command=""
2816 # Name: smime_sign_opaque_command
2821 # This command is used to created S/MIME signatures of type
2822 # application/x-pkcs7-signature, which can only be handled by mail
2823 # clients supporting the S/MIME extension.
2827 # set smime_encrypt_command=""
2829 # Name: smime_encrypt_command
2834 # This command is used to create encrypted S/MIME messages.
2838 # set smime_pk7out_command=""
2840 # Name: smime_pk7out_command
2845 # This command is used to extract PKCS7 structures of S/MIME signatures,
2846 # in order to extract the public X509 certificate(s).
2850 # set smime_get_cert_command=""
2852 # Name: smime_get_cert_command
2857 # This command is used to extract X509 certificates from a PKCS7 structure.
2861 # set smime_get_signer_cert_command=""
2863 # Name: smime_get_signer_cert_command
2868 # This command is used to extract only the signers X509 certificate from a S/MIME
2869 # signature, so that the certificate's owner may get compared to the
2870 # email's 'From'-field.
2874 # set smime_import_cert_command=""
2876 # Name: smime_import_cert_command
2881 # This command is used to import a certificate via smime_keys.
2885 # set smime_get_cert_email_command=""
2887 # Name: smime_get_cert_email_command
2892 # This command is used to extract the mail address(es) used for storing
2893 # X509 certificates, and for verification purposes (to check whether the
2894 # certificate was issued for the sender's mailbox).
2898 # set smime_default_key=""
2900 # Name: smime_default_key
2905 # This is the default key-pair to use for signing. This must be set to the
2906 # keyid (the hash-value that OpenSSL generates) to work properly
2910 # set ssl_client_cert=""
2912 # Name: ssl_client_cert
2917 # The file containing a client certificate and its associated private
2921 # set ssl_force_tls=no
2923 # Name: ssl_force_tls
2928 # If this variable is set, Mutt will require that all connections
2929 # to remote servers be encrypted. Furthermore it will attempt to
2930 # negotiate TLS even if the server does not advertise the capability,
2931 # since it would otherwise have to abort the connection anyway. This
2932 # option supersedes ``$ssl_starttls''.
2935 # set ssl_starttls=yes
2937 # Name: ssl_starttls
2942 # If set (the default), mutt will attempt to use STARTTLS on servers
2943 # advertising the capability. When unset, mutt will not attempt to
2944 # use STARTTLS regardless of the server's capabilities.
2947 # set certificate_file="~/.mutt_certificates"
2949 # Name: certificate_file
2951 # Default: "~/.mutt_certificates"
2954 # This variable specifies the file where the certificates you trust
2955 # are saved. When an unknown certificate is encountered, you are asked
2956 # if you accept it or not. If you accept it, the certificate can also
2957 # be saved in this file and further connections are automatically
2960 # You can also manually add CA certificates in this file. Any server
2961 # certificate that is signed with one of these CA certificates are
2962 # also automatically accepted.
2964 # Example: set certificate_file=~/.mutt/certificates
2967 # set ssl_usesystemcerts=yes
2969 # Name: ssl_usesystemcerts
2974 # If set to yes, mutt will use CA certificates in the
2975 # system-wide certificate store when checking if server certificate
2976 # is signed by a trusted CA.
2979 # set entropy_file=""
2981 # Name: entropy_file
2986 # The file which includes random data that is used to initialize SSL
2987 # library functions.
2990 # set ssl_use_sslv2=yes
2992 # Name: ssl_use_sslv2
2997 # This variables specifies whether to attempt to use SSLv2 in the
2998 # SSL authentication process.
3001 # set ssl_use_sslv3=yes
3003 # Name: ssl_use_sslv3
3008 # This variables specifies whether to attempt to use SSLv3 in the
3009 # SSL authentication process.
3012 # set ssl_use_tlsv1=yes
3014 # Name: ssl_use_tlsv1
3019 # This variables specifies whether to attempt to use TLSv1 in the
3020 # SSL authentication process.
3023 # set ssl_min_dh_prime_bits=0
3025 # Name: ssl_min_dh_prime_bits
3030 # This variable specifies the minimum acceptable prime size (in bits)
3031 # for use in any Diffie-Hellman key exchange. A value of 0 will use
3032 # the default from the GNUTLS library.
3035 # set ssl_ca_certificates_file=""
3037 # Name: ssl_ca_certificates_file
3042 # This variable specifies a file containing trusted CA certificates.
3043 # Any server certificate that is signed with one of these CA
3044 # certificates are also automatically accepted.
3046 # Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
3056 # Used in connection with the pipe-message command and the ``tag-
3057 # prefix'' operator. If this variable is unset, when piping a list of
3058 # tagged messages Mutt will concatenate the messages and will pipe them
3059 # as a single folder. When set, Mutt will pipe the messages one by one.
3060 # In both cases the messages are piped in the current sorted order,
3061 # and the ``$pipe_sep'' separator is added after each message.
3064 # set pipe_decode=no
3071 # Used in connection with the pipe-message command. When unset,
3072 # Mutt will pipe the messages without any preprocessing. When set, Mutt
3073 # will weed headers and will attempt to PGP/MIME decode the messages
3084 # The separator to add between messages when piping a list of tagged
3085 # messages to an external Unix command.
3088 # set pop_authenticators=""
3090 # Name: pop_authenticators
3095 # This is a colon-delimited list of authentication methods mutt may
3096 # attempt to use to log in to an POP server, in the order mutt should
3097 # try them. Authentication methods are either 'user', 'apop' or any
3098 # SASL mechanism, eg 'digest-md5', 'gssapi' or 'cram-md5'.
3099 # This parameter is case-insensitive. If this parameter is unset
3100 # (the default) mutt will try all available methods, in order from
3101 # most-secure to least-secure.
3103 # Example: set pop_authenticators="digest-md5:apop:user"
3106 # set pop_auth_try_all=yes
3108 # Name: pop_auth_try_all
3113 # If set, Mutt will try all available methods. When unset, Mutt will
3114 # only fall back to other authentication methods if the previous
3115 # methods are unavailable. If a method is available but authentication
3116 # fails, Mutt will not connect to the POP server.
3119 # set pop_checkinterval=60
3121 # Name: pop_checkinterval
3126 # This variable configures how often (in seconds) mutt should look for
3127 # new mail in the currently selected mailbox if it is a POP mailbox.
3130 # set pop_delete=ask-no
3137 # If set, Mutt will delete successfully downloaded messages from the POP
3138 # server when using the fetch-mail function. When unset, Mutt will
3139 # download messages but also leave them on the POP server.
3149 # The name of your POP server for the fetch-mail function. You
3150 # can also specify an alternative port, username and password, ie:
3152 # [pop[s]://][username[:password]@]popserver[:port]
3162 # If this variable is set, mutt will try to use the "LAST" POP command
3163 # for retrieving only unread messages from the POP server when using
3164 # the fetch-mail function.
3167 # set pop_reconnect=ask-yes
3169 # Name: pop_reconnect
3174 # Controls whether or not Mutt will try to reconnect to POP server if
3175 # the connection is lost.
3185 # Your login name on the POP server.
3187 # This variable defaults to your user name on the local machine.
3197 # Specifies the password for your POP account. If unset, Mutt will
3198 # prompt you for your password when you open POP mailbox.
3199 # Warning: you should only use this option when you are on a
3200 # fairly secure machine, because the superuser can read your muttrc
3201 # even if you are the only one who can read the file.
3204 # set post_indent_string=""
3206 # Name: post_indent_string
3211 # Similar to the ``$attribution'' variable, Mutt will append this
3212 # string after the inclusion of a message which is being replied to.
3215 # set postpone=ask-yes
3222 # Controls whether or not messages are saved in the ``$postponed''
3223 # mailbox when you elect not to send immediately. Also see the
3224 # ``$recall'' variable.
3227 # set postponed="~/postponed"
3231 # Default: "~/postponed"
3234 # Mutt allows you to indefinitely ``postpone sending a message'' which
3235 # you are editing. When you choose to postpone a message, Mutt saves it
3236 # in the mailbox specified by this variable. Also see the ``$postpone''
3247 # If set, a shell command to be executed if mutt fails to establish
3248 # a connection to the server. This is useful for setting up secure
3249 # connections, e.g. with ssh(1). If the command returns a nonzero
3250 # status, mutt gives up opening the server. Example:
3252 # preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net
3253 # sleep 20 < /dev/null > /dev/null"
3255 # Mailbox 'foo' on mailhost.net can now be reached
3256 # as '{localhost:1234}foo'.
3258 # NOTE: For this example to work, you must be able to log in to the
3259 # remote machine without having to enter a password.
3269 # Controls whether or not Mutt really prints messages.
3270 # This is set to ask-no by default, because some people
3271 # accidentally hit ``p'' often (like me).
3274 # set print_command="lpr"
3276 # Name: print_command
3281 # This specifies the command pipe that should be used to print messages.
3284 # set print_decode=yes
3286 # Name: print_decode
3291 # Used in connection with the print-message command. If this
3292 # option is set, the message is decoded before it is passed to the
3293 # external command specified by $print_command. If this option
3294 # is unset, no processing will be applied to the message when
3295 # printing it. The latter setting may be useful if you are using
3296 # some advanced printer filter which is able to properly format
3297 # e-mail messages for printing.
3300 # set print_split=no
3307 # Used in connection with the print-message command. If this option
3308 # is set, the command specified by $print_command is executed once for
3309 # each message which is to be printed. If this option is unset,
3310 # the command specified by $print_command is executed only once, and
3311 # all the messages are concatenated, with a form feed as the message
3314 # Those who use the enscript(1) program's mail-printing mode will
3315 # most likely want to set this option.
3318 # set prompt_after=yes
3320 # Name: prompt_after
3325 # If you use an external ``$pager'', setting this variable will
3326 # cause Mutt to prompt you for a command when the pager exits rather
3327 # than returning to the index menu. If unset, Mutt will return to the
3328 # index menu when the external pager exits.
3331 # set query_command=""
3333 # Name: query_command
3338 # This specifies the command that mutt will use to make external address
3339 # queries. The string should contain a %s, which will be substituted
3340 # with the query string the user types. See ``query'' for more
3344 # set query_format="%4c %t %-25.25a %-25.25n %?e?(%e)?"
3346 # Name: query_format
3348 # Default: "%4c %t %-25.25a %-25.25n %?e?(%e)?"
3351 # This variable describes the format of the `query' menu. The
3352 # following printf-style sequences are understood:
3354 # %a destination address
3355 # %c current entry number
3356 # %e extra information *
3357 # %n destination name
3358 # %t ``*'' if current entry is tagged, a space otherwise
3359 # %>X right justify the rest of the string and pad with "X"
3360 # %|X pad to the end of the line with "X"
3361 # %*X soft-fill with character "X" as pad
3364 # For an explanation of `soft-fill', see the ``$index_format'' documentation.
3366 # * = can be optionally printed if nonzero, see the ``$status_format'' documentation.
3376 # This variable controls whether ``quit'' and ``exit'' actually quit
3377 # from mutt. If it set to yes, they do quit, if it is set to no, they
3378 # have no effect, and if it is set to ask-yes or ask-no, you are
3379 # prompted for confirmation when you try to quit.
3382 # set quote_regexp="^([ \t]*[|>:}#])+"
3384 # Name: quote_regexp
3385 # Type: regular expression
3386 # Default: "^([ \t]*[|>:}#])+"
3389 # A regular expression used in the internal-pager to determine quoted
3390 # sections of text in the body of a message.
3392 # Note: In order to use the quotedx patterns in the
3393 # internal pager, you need to set this to a regular expression that
3394 # matches exactly the quote characters at the beginning of quoted
3405 # If set to a value greater than 0, Mutt will display which message it
3406 # is currently on when reading a mailbox or when performing search actions
3407 # such as search and limit. The message is printed after
3408 # read_inc messages have been read or searched (e.g., if set to 25, Mutt will
3409 # print a message when it is at message 25, and then again when it gets
3410 # to message 50). This variable is meant to indicate progress when
3411 # reading or searching large mailboxes which may take some time.
3412 # When set to 0, only a single message will appear before the reading
3415 # Also see the ``$write_inc'' variable and the ``Tuning'' section of the
3416 # manual for performance considerations.
3426 # If set, all folders are opened in read-only mode.
3436 # This variable specifies what "real" or "personal" name should be used
3437 # when sending messages.
3439 # By default, this is the GECOS field from /etc/passwd. Note that this
3440 # variable will not be used when the user has set a real name
3441 # in the $from variable.
3444 # set recall=ask-yes
3451 # Controls whether or not Mutt recalls postponed messages
3452 # when composing a new message. Also see ``$postponed''.
3454 # Setting this variable to ``yes'' is not generally useful, and thus not
3458 # set record="~/sent"
3465 # This specifies the file into which your outgoing messages should be
3466 # appended. (This is meant as the primary method for saving a copy of
3467 # your messages, but another way to do this is using the ``my_hdr''
3468 # command to create a Bcc: field with your email address in it.)
3470 # The value of $record is overridden by the ``$force_name'' and
3471 # ``$save_name'' variables, and the ``fcc-hook'' command.
3474 # set reply_regexp="^(re([\\[0-9\\]+])*|aw):[ \t]*"
3476 # Name: reply_regexp
3477 # Type: regular expression
3478 # Default: "^(re([\\[0-9\\]+])*|aw):[ \t]*"
3481 # A regular expression used to recognize reply messages when threading
3482 # and replying. The default value corresponds to the English "Re:" and
3493 # If unset and you are replying to a message sent by you, Mutt will
3494 # assume that you want to reply to the recipients of that message rather
3498 # set reply_to=ask-yes
3505 # If set, when replying to a message, Mutt will use the address listed
3506 # in the Reply-to: header as the recipient of the reply. If unset,
3507 # it will use the address in the From: header field instead. This
3508 # option is useful for reading a mailing list that sets the Reply-To:
3509 # header field to the list address and you want to send a private
3510 # message to the author of a message.
3520 # When set, the cursor will be automatically advanced to the next
3521 # (possibly undeleted) message whenever a command that modifies the
3522 # current message is executed.
3525 # set reverse_alias=no
3527 # Name: reverse_alias
3532 # This variable controls whether or not Mutt will display the "personal"
3533 # name from your aliases in the index menu if it finds an alias that
3534 # matches the message's sender. For example, if you have the following
3537 # alias juser abd30425@somewhere.net (Joe User)
3539 # and then you receive mail which contains the following header:
3541 # From: abd30425@somewhere.net
3543 # It would be displayed in the index menu as ``Joe User'' instead of
3544 # ``abd30425@somewhere.net.'' This is useful when the person's e-mail
3545 # address is not human friendly (like CompuServe addresses).
3548 # set reverse_name=no
3550 # Name: reverse_name
3555 # It may sometimes arrive that you receive mail to a certain machine,
3556 # move the messages to another machine, and reply to some the messages
3557 # from there. If this variable is set, the default From: line of
3558 # the reply messages is built using the address where you received the
3559 # messages you are replying to if that address matches your
3560 # alternates. If the variable is unset, or the address that would be
3561 # used doesn't match your alternates, the From: line will use
3562 # your address on the current machine.
3565 # set reverse_realname=yes
3567 # Name: reverse_realname
3572 # This variable fine-tunes the behaviour of the reverse_name feature.
3573 # When it is set, mutt will use the address from incoming messages as-is,
3574 # possibly including eventual real names. When it is unset, mutt will
3575 # override any such real names with the setting of the realname variable.
3578 # set rfc2047_parameters=no
3580 # Name: rfc2047_parameters
3585 # When this variable is set, Mutt will decode RFC-2047-encoded MIME
3586 # parameters. You want to set this variable when mutt suggests you
3587 # to save attachments to files named like this:
3588 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3590 # When this variable is set interactively, the change doesn't have
3591 # the desired effect before you have changed folders.
3593 # Note that this use of RFC 2047's encoding is explicitly,
3594 # prohibited by the standard, but nevertheless encountered in the
3596 # Also note that setting this parameter will not have the effect
3597 # that mutt generates this kind of encoding. Instead, mutt will
3598 # unconditionally use the encoding specified in RFC 2231.
3601 # set save_address=no
3603 # Name: save_address
3608 # If set, mutt will take the sender's full address when choosing a
3609 # default folder for saving a mail. If ``$save_name'' or ``$force_name''
3610 # is set too, the selection of the fcc folder will be changed as well.
3613 # set save_empty=yes
3620 # When unset, mailboxes which contain no saved messages will be removed
3621 # when closed (the exception is ``$spoolfile'' which is never removed).
3622 # If set, mailboxes are never removed.
3624 # Note: This only applies to mbox and MMDF folders, Mutt does not
3625 # delete MH and Maildir directories.
3628 # set save_history=0
3630 # Name: save_history
3635 # This variable controls the size of the history saved in the
3636 # ``$history_file'' file.
3646 # This variable controls how copies of outgoing messages are saved.
3647 # When set, a check is made to see if a mailbox specified by the
3648 # recipient address exists (this is done by searching for a mailbox in
3649 # the ``$folder'' directory with the username part of the
3650 # recipient address). If the mailbox exists, the outgoing message will
3651 # be saved to that mailbox, otherwise the message is saved to the
3652 # ``$record'' mailbox.
3654 # Also see the ``$force_name'' variable.
3664 # When this variable is unset, scoring is turned off. This can
3665 # be useful to selectively disable scoring for certain folders when the
3666 # ``$score_threshold_delete'' variable and friends are used.
3669 # set score_threshold_delete=-1
3671 # Name: score_threshold_delete
3676 # Messages which have been assigned a score equal to or lower than the value
3677 # of this variable are automatically marked for deletion by mutt. Since
3678 # mutt scores are always greater than or equal to zero, the default setting
3679 # of this variable will never mark a message for deletion.
3682 # set score_threshold_flag=9999
3684 # Name: score_threshold_flag
3689 # Messages which have been assigned a score greater than or equal to this
3690 # variable's value are automatically marked "flagged".
3693 # set score_threshold_read=-1
3695 # Name: score_threshold_read
3700 # Messages which have been assigned a score equal to or lower than the value
3701 # of this variable are automatically marked as read by mutt. Since
3702 # mutt scores are always greater than or equal to zero, the default setting
3703 # of this variable will never mark a message read.
3706 # set send_charset="us-ascii:iso-8859-1:utf-8"
3708 # Name: send_charset
3710 # Default: "us-ascii:iso-8859-1:utf-8"
3713 # A colon-delimited list of character sets for outgoing messages. Mutt will use the
3714 # first character set into which the text can be converted exactly.
3715 # If your ``$charset'' is not iso-8859-1 and recipients may not
3716 # understand UTF-8, it is advisable to include in the list an
3717 # appropriate widely used standard character set (such as
3718 # iso-8859-2, koi8-r or iso-2022-jp) either instead of or after
3721 # In case the text cannot be converted into one of these exactly,
3722 # mutt uses ``$charset'' as a fallback.
3725 # set sendmail="/usr/sbin/sendmail -oem -oi"
3729 # Default: "/usr/sbin/sendmail -oem -oi"
3732 # Specifies the program and arguments used to deliver mail sent by Mutt.
3733 # Mutt expects that the specified program interprets additional
3734 # arguments as recipient addresses.
3737 # set sendmail_wait=0
3739 # Name: sendmail_wait
3744 # Specifies the number of seconds to wait for the ``$sendmail'' process
3745 # to finish before giving up and putting delivery in the background.
3747 # Mutt interprets the value of this variable as follows:
3748 # >0 number of seconds to wait for sendmail to finish before continuing
3749 # 0 wait forever for sendmail to finish
3750 # <0 always put sendmail in the background without waiting
3753 # Note that if you specify a value other than 0, the output of the child
3754 # process will be put in a temporary file. If there is some error, you
3755 # will be informed as to where to find the output.
3765 # Command to use when spawning a subshell. By default, the user's login
3766 # shell from /etc/passwd is used.
3769 # set sig_dashes=yes
3776 # If set, a line containing ``-- '' will be inserted before your
3777 # ``$signature''. It is strongly recommended that you not unset
3778 # this variable unless your ``signature'' contains just your name. The
3779 # reason for this is because many software packages use ``-- \n'' to
3780 # detect your signature. For example, Mutt has the ability to highlight
3781 # the signature in a different color in the builtin pager.
3791 # If set, the signature will be included before any quoted or forwarded
3792 # text. It is strongly recommended that you do not set this variable
3793 # unless you really know what you are doing, and are prepared to take
3794 # some heat from netiquette guardians.
3797 # set signature="~/.signature"
3801 # Default: "~/.signature"
3804 # Specifies the filename of your signature, which is appended to all
3805 # outgoing messages. If the filename ends with a pipe (``|''), it is
3806 # assumed that filename is a shell command and input should be read from
3810 # set simple_search="~f %s | ~s %s"
3812 # Name: simple_search
3814 # Default: "~f %s | ~s %s"
3817 # Specifies how Mutt should expand a simple search into a real search
3818 # pattern. A simple search is one that does not contain any of the ~
3819 # operators. See ``patterns'' for more information on search patterns.
3821 # For example, if you simply type joe at a search or limit prompt, Mutt
3822 # will automatically expand it to the value specified by this variable.
3823 # For the default value it would be:
3828 # set smart_wrap=yes
3835 # Controls the display of lines longer than the screen width in the
3836 # internal pager. If set, long lines are wrapped at a word boundary. If
3837 # unset, lines are simply wrapped at the screen edge. Also see the
3838 # ``$markers'' variable.
3841 # set smileys="(>From )|(:[-^]?[][)(><}{|/DP])"
3844 # Type: regular expression
3845 # Default: "(>From )|(:[-^]?[][)(><}{|/DP])"
3848 # The pager uses this variable to catch some common false
3849 # positives of ``$quote_regexp'', most notably smileys in the beginning
3860 # Specifies time, in seconds, to pause while displaying certain informational
3861 # messages, while moving from folder to folder and after expunging
3862 # messages from the current folder. The default is to pause one second, so
3863 # a value of zero for this option suppresses the pause.
3866 # set smtp_authenticators=""
3868 # Name: smtp_authenticators
3873 # This is a colon-delimited list of authentication methods mutt may
3874 # attempt to use to log in to an SMTP server, in the order mutt should
3875 # try them. Authentication methods are any SASL mechanism, eg
3876 # ``digest-md5'', ``gssapi'' or ``cram-md5''.
3877 # This parameter is case-insensitive. If this parameter is unset
3878 # (the default) mutt will try all available methods, in order from
3879 # most-secure to least-secure.
3881 # Example: set smtp_authenticators="digest-md5:cram-md5"
3891 # Specifies the password for your SMTP account. If unset, Mutt will
3892 # prompt you for your password when you first send mail via SMTP.
3893 # See ``smtp_url'' to configure mutt to send mail via SMTP.
3894 # Warning: you should only use this option when you are on a
3895 # fairly secure machine, because the superuser can read your muttrc even
3896 # if you are the only one who can read the file.
3906 # Defines the SMTP ``smart'' host where sent messages should relayed for
3907 # delivery. This should take the form of an SMTP URL, eg:
3909 # smtp[s]://[user[:pass]@]host[:port]/
3911 # Setting this variable overrides the value of the ``$sendmail''
3922 # Specifies how to sort messages in the index menu. Valid values
3928 # mailbox-order (unsorted)
3936 # You may optionally use the reverse- prefix to specify reverse sorting
3937 # order (example: set sort=reverse-date-sent).
3940 # set sort_alias=alias
3947 # Specifies how the entries in the `alias' menu are sorted. The
3948 # following are legal values:
3950 # address (sort alphabetically by email address)
3951 # alias (sort alphabetically by alias name)
3952 # unsorted (leave in order specified in .muttrc)
3962 # When sorting by threads, this variable controls how threads are sorted
3963 # in relation to other threads, and how the branches of the thread trees
3964 # are sorted. This can be set to any value that ``$sort'' can, except
3965 # threads (in that case, mutt will just use date-sent). You can also
3966 # specify the last- prefix in addition to the reverse- prefix, but last-
3967 # must come after reverse-. The last- prefix causes messages to be
3968 # sorted against its siblings by which has the last descendant, using
3969 # the rest of sort_aux as an ordering. For instance, set sort_aux=last-
3970 # date-received would mean that if a new message is received in a
3971 # thread, that thread becomes the last one displayed (or the first, if
3972 # you have set sort=reverse-threads.) Note: For reversed ``$sort''
3973 # order $sort_aux is reversed again (which is not the right thing to do,
3974 # but kept to not break any existing configuration setting).
3977 # set sort_browser=alpha
3979 # Name: sort_browser
3984 # Specifies how to sort entries in the file browser. By default, the
3985 # entries are sorted alphabetically. Valid values:
3987 # alpha (alphabetically)
3992 # You may optionally use the reverse- prefix to specify reverse sorting
3993 # order (example: set sort_browser=reverse-date).
4003 # This variable is only useful when sorting by threads with
4004 # ``$strict_threads'' unset. In that case, it changes the heuristic
4005 # mutt uses to thread messages by subject. With sort_re set, mutt will
4006 # only attach a message as the child of another message by subject if
4007 # the subject of the child message starts with a substring matching the
4008 # setting of ``$reply_regexp''. With sort_re unset, mutt will attach
4009 # the message whether or not this is the case, as long as the
4010 # non-``$reply_regexp'' parts of both messages are identical.
4013 # set spam_separator=","
4015 # Name: spam_separator
4020 # ``spam_separator'' controls what happens when multiple spam headers
4021 # are matched: if unset, each successive header will overwrite any
4022 # previous matches value for the spam label. If set, each successive
4023 # match will append to the previous, using ``spam_separator'' as a
4034 # If your spool mailbox is in a non-default place where Mutt cannot find
4035 # it, you can specify its location with this variable. Mutt will
4036 # automatically set this variable to the value of the environment
4037 # variable $MAIL if it is not set.
4040 # set status_chars="-*%A"
4042 # Name: status_chars
4047 # Controls the characters used by the "%r" indicator in
4048 # ``$status_format''. The first character is used when the mailbox is
4049 # unchanged. The second is used when the mailbox has been changed, and
4050 # it needs to be resynchronized. The third is used if the mailbox is in
4051 # read-only mode, or if the mailbox will not be written when exiting
4052 # that mailbox (You can toggle whether to write changes to a mailbox
4053 # with the toggle-write operation, bound by default to "%"). The fourth
4054 # is used to indicate that the current folder has been opened in attach-
4055 # message mode (Certain operations like composing a new mail, replying,
4056 # forwarding, etc. are not permitted in this mode).
4059 # 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)---"
4061 # Name: status_format
4063 # 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)---"
4066 # Controls the format of the status line displayed in the index
4067 # menu. This string is similar to ``$index_format'', but has its own
4068 # set of printf()-like sequences:
4070 # %b number of mailboxes with new mail *
4071 # %d number of deleted messages *
4072 # %f the full pathname of the current mailbox
4073 # %F number of flagged messages *
4075 # %l size (in bytes) of the current mailbox *
4076 # %L size (in bytes) of the messages shown
4077 # (i.e., which match the current limit) *
4078 # %m the number of messages in the mailbox *
4079 # %M the number of messages shown (i.e., which match the current limit) *
4080 # %n number of new messages in the mailbox *
4081 # %o number of old unread messages *
4082 # %p number of postponed messages *
4083 # %P percentage of the way through the index
4084 # %r modified/read-only/won't-write/attach-message indicator,
4085 # according to $status_chars
4086 # %s current sorting mode ($sort)
4087 # %S current aux sorting method ($sort_aux)
4088 # %t number of tagged messages *
4089 # %u number of unread messages *
4090 # %v Mutt version string
4091 # %V currently active limit pattern, if any *
4092 # %>X right justify the rest of the string and pad with "X"
4093 # %|X pad to the end of the line with "X"
4094 # %*X soft-fill with character "X" as pad
4097 # For an explanation of `soft-fill', see the ``$index_format'' documentation.
4099 # * = can be optionally printed if nonzero
4101 # Some of the above sequences can be used to optionally print a string
4102 # if their value is nonzero. For example, you may only want to see the
4103 # number of flagged messages if such messages exist, since zero is not
4104 # particularly meaningful. To optionally print a string based upon one
4105 # of the above sequences, the following construct is used:
4107 # %?<sequence_char>?<optional_string>?
4109 # where sequence_char is a character from the table above, and
4110 # optional_string is the string you would like printed if
4111 # sequence_char is nonzero. optional_string may contain
4112 # other sequences as well as normal text, but you may not nest
4115 # Here is an example illustrating how to optionally print the number of
4116 # new messages in a mailbox:
4117 # %?n?%n new messages.?
4119 # You can also switch between two strings using the following construct:
4121 # %?<sequence_char>?<if_string>&<else_string>?
4123 # If the value of sequence_char is non-zero, if_string will
4124 # be expanded, otherwise else_string will be expanded.
4126 # You can force the result of any printf-like sequence to be lowercase
4127 # by prefixing the sequence character with an underscore (_) sign.
4128 # For example, if you want to display the local hostname in lowercase,
4132 # If you prefix the sequence character with a colon (:) character, mutt
4133 # will replace any dots in the expansion by underscores. This might be helpful
4134 # with IMAP folders that don't like dots in folder names.
4137 # set status_on_top=no
4139 # Name: status_on_top
4144 # Setting this variable causes the ``status bar'' to be displayed on
4145 # the first line of the screen rather than near the bottom.
4148 # set strict_threads=no
4150 # Name: strict_threads
4155 # If set, threading will only make use of the ``In-Reply-To'' and
4156 # ``References'' fields when you ``$sort'' by message threads. By
4157 # default, messages with the same subject are grouped together in
4158 # ``pseudo threads.''. This may not always be desirable, such as in a
4159 # personal mailbox where you might have several unrelated messages with
4160 # the subject ``hi'' which will get grouped together. See also
4161 # ``$sort_re'' for a less drastic way of controlling this
4172 # When unset, mutt won't stop when the user presses the terminal's
4173 # susp key, usually ``control-Z''. This is useful if you run mutt
4174 # inside an xterm using a command like xterm -e mutt.
4177 # set text_flowed=no
4184 # When set, mutt will generate text/plain; format=flowed attachments.
4185 # This format is easier to handle for some mailing software, and generally
4186 # just looks like ordinary text. To actually make use of this format's
4187 # features, you'll need support in your editor.
4189 # Note that $indent_string is ignored when this option is set.
4192 # set thread_received=no
4194 # Name: thread_received
4199 # When set, mutt uses the date received rather than the date sent
4200 # to thread messages by subject.
4203 # set thorough_search=no
4205 # Name: thorough_search
4210 # Affects the ~b and ~h search operations described in
4211 # section ``patterns'' above. If set, the headers and attachments of
4212 # messages to be searched are decoded before searching. If unset,
4213 # messages are searched as they appear in the folder.
4223 # When set, the internal-pager will pad blank lines to the bottom of the
4224 # screen with a tilde (~).
4234 # Along with ``read_inc'', ``write_inc'', and ``net_inc'', this
4235 # variable controls the frequency with which progress updates are
4236 # displayed. It suppresses updates less than ``time_inc'' milliseconds
4237 # apart. This can improve throughput on systems with slow terminals,
4238 # or when running mutt on a remote system.
4248 # When Mutt is waiting for user input either idleing in menus or
4249 # in an interactive prompt, Mutt would block until input is
4250 # present. Depending on the context, this would prevent certain
4251 # operations from working, like checking for new mail or keeping
4252 # an IMAP connection alive.
4254 # This variable controls how many seconds Mutt will at most wait
4255 # until it aborts waiting for input, performs these operations and
4256 # continues to wait for input.
4258 # A value of zero or less will cause Mutt to never time out.
4268 # This variable allows you to specify where Mutt will place its
4269 # temporary files needed for displaying and composing messages. If
4270 # this variable is not set, the environment variable TMPDIR is
4271 # used. If TMPDIR is not set then "/tmp" is used.
4274 # set to_chars=" +TCFL"
4281 # Controls the character used to indicate mail addressed to you. The
4282 # first character is the one used when the mail is NOT addressed to your
4283 # address (default: space). The second is used when you are the only
4284 # recipient of the message (default: +). The third is when your address
4285 # appears in the TO header field, but you are not the only recipient of
4286 # the message (default: T). The fourth character is used when your
4287 # address is specified in the CC header field, but you are not the only
4288 # recipient. The fifth character is used to indicate mail that was sent
4289 # by you. The sixth character is used to indicate when a mail
4290 # was sent to a mailing-list you subscribe to (default: L).
4300 # Setting this variable will cause mutt to open a pipe to a command
4301 # instead of a raw socket. You may be able to use this to set up
4302 # preauthenticated connections to your IMAP/POP3 server. Example:
4304 # tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
4306 # NOTE: For this example to work you must be able to log in to the remote
4307 # machine without having to enter a password.
4310 # set use_8bitmime=no
4312 # Name: use_8bitmime
4317 # Warning: do not set this variable unless you are using a version
4318 # of sendmail which supports the -B8BITMIME flag (such as sendmail
4319 # 8.8.x) or you may not be able to send mail.
4321 # When set, Mutt will invoke ``$sendmail'' with the -B8BITMIME
4322 # flag when sending 8-bit messages to enable ESMTP negotiation.
4325 # set use_domain=yes
4332 # When set, Mutt will qualify all local addresses (ones without the
4333 # @host portion) with the value of ``$hostname''. If unset, no
4334 # addresses will be qualified.
4337 # set use_envelope_from=no
4339 # Name: use_envelope_from
4344 # When set, mutt will set the envelope sender of the message.
4345 # If ``$envelope_from_address'' is set, it will be used as the sender
4346 # address. If not, mutt will attempt to derive the sender from the
4349 # Note that this information is passed to sendmail command using the
4350 # "-f" command line switch. Therefore setting this option is not useful
4351 # if the ``$sendmail'' variable already contains "-f" or if the
4352 # executable pointed to by $sendmail doesn't support the "-f" switch.
4362 # When set, Mutt will generate the `From:' header field when
4363 # sending messages. If unset, no `From:' header field will be
4364 # generated unless the user explicitly sets one using the ``my_hdr''
4375 # When set, Mutt will show you international domain names decoded.
4376 # Note: You can use IDNs for addresses even if this is unset.
4377 # This variable only affects decoding.
4387 # When set, Mutt will look for IPv6 addresses of hosts it tries to
4388 # contact. If this option is unset, Mutt will restrict itself to IPv4 addresses.
4389 # Normally, the default should work.
4392 # set user_agent=yes
4399 # When set, mutt will add a "User-Agent" header to outgoing
4400 # messages, indicating which version of mutt was used for composing
4411 # Specifies the visual editor to invoke when the ~v command is
4412 # given in the builtin editor.
4422 # Controls whether Mutt will ask you to press a key after shell-
4423 # escape, pipe-message, pipe-entry, print-message,
4424 # and print-entry commands.
4426 # It is also used when viewing attachments with ``auto_view'', provided
4427 # that the corresponding mailcap entry has a needsterminal flag,
4428 # and the external program is interactive.
4430 # When set, Mutt will always ask for a key. When unset, Mutt will wait
4431 # for a key only if the external command returned a non-zero status.
4441 # When set, mutt will weed headers when displaying, forwarding,
4442 # printing, or replying to messages.
4452 # When set to a positive value, mutt will wrap text at $wrap characters.
4453 # When set to a negative value, mutt will wrap text so that there are $wrap
4454 # characters of empty space on the right side of the terminal.
4457 # set wrap_search=yes
4464 # Controls whether searches wrap around the end of the mailbox.
4466 # When set, searches will wrap around the first (or last) message. When
4467 # unset, searches will not wrap.
4477 # (DEPRECATED) Equivalent to setting wrap with a negative value.
4487 # When writing a mailbox, a message will be printed every
4488 # write_inc messages to indicate progress. If set to 0, only a
4489 # single message will be displayed before writing a mailbox.
4491 # Also see the ``$read_inc'' variable.
4501 # Controls whether mutt writes out the Bcc header when preparing
4502 # messages to be sent. Exim users may wish to unset this. If mutt
4503 # is set to deliver directly via SMTP (see ``$smtp_url''), this
4504 # option does nothing: mutt will never write out the BCC header
projects / software / mutt-debian.git / blob