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