]> git.llucax.com Git - software/mutt-debian.git/blob - obj-i486-linux-gnu/doc/Muttrc
noted all fixed bugs
[software/mutt-debian.git] / obj-i486-linux-gnu / 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 pgp_use_gpg_agent=no
2319 #
2320 # Name: pgp_use_gpg_agent
2321 # Type: boolean
2322 # Default: no
2323
2324
2325 # If set, mutt will use a possibly-running gpg-agent(1) process.
2326 # (PGP only)
2327
2328
2329 # set crypt_verify_sig=yes
2330 #
2331 # Name: crypt_verify_sig
2332 # Type: quadoption
2333 # Default: yes
2334
2335
2336 # If ``yes'', always attempt to verify PGP or S/MIME signatures.
2337 # If ``ask-*'', ask whether or not to verify the signature.
2338 # If \Fi``no'', never attempt to verify cryptographic signatures.
2339 # (Crypto only)
2340
2341
2342 # set smime_is_default=no
2343 #
2344 # Name: smime_is_default
2345 # Type: boolean
2346 # Default: no
2347
2348
2349 # The default behaviour of mutt is to use PGP on all auto-sign/encryption
2350 # operations. To override and to use OpenSSL instead this must be set.
2351 # However, this has no effect while replying, since mutt will automatically
2352 # select the same application that was used to sign/encrypt the original
2353 # message.  (Note that this variable can be overridden by unsetting $crypt_autosmime.)
2354 # (S/MIME only)
2355
2356
2357 # set smime_ask_cert_label=yes
2358 #
2359 # Name: smime_ask_cert_label
2360 # Type: boolean
2361 # Default: yes
2362
2363
2364 # This flag controls whether you want to be asked to enter a label
2365 # for a certificate about to be added to the database or not. It is
2366 # set by default.
2367 # (S/MIME only)
2368
2369
2370 # set smime_decrypt_use_default_key=yes
2371 #
2372 # Name: smime_decrypt_use_default_key
2373 # Type: boolean
2374 # Default: yes
2375
2376
2377 # If set (default) this tells mutt to use the default key for decryption. Otherwise,
2378 # if managing multiple certificate-key-pairs, mutt will try to use the mailbox-address
2379 # to determine the key to use. It will ask you to supply a key, if it can't find one.
2380 # (S/MIME only)
2381
2382
2383 # set pgp_entry_format="%4n %t%f %4l/0x%k %-4a %2c %u"
2384 #
2385 # Name: pgp_entry_format
2386 # Type: string
2387 # Default: "%4n %t%f %4l/0x%k %-4a %2c %u"
2388
2389
2390 # This variable allows you to customize the PGP key selection menu to
2391 # your personal taste. This string is similar to $index_format, but
2392 # has its own set of printf(3)-like sequences:
2393 # %n      number
2394 # %k      key id
2395 # %u      user id
2396 # %a      algorithm
2397 # %l      key length
2398 # %f      flags
2399 # %c      capabilities
2400 # %t      trust/validity of the key-uid association
2401 # %[<s>]  date of the key where <s> is an strftime(3) expression
2402
2403
2404 # (PGP only)
2405
2406
2407 # set pgp_good_sign=""
2408 #
2409 # Name: pgp_good_sign
2410 # Type: regular expression
2411 # Default: ""
2412
2413
2414 # If you assign a text to this variable, then a PGP signature is only
2415 # considered verified if the output from $pgp_verify_command contains
2416 # the text. Use this variable if the exit code from the command is 0
2417 # even for bad signatures.
2418 # (PGP only)
2419
2420
2421 # set pgp_check_exit=yes
2422 #
2423 # Name: pgp_check_exit
2424 # Type: boolean
2425 # Default: yes
2426
2427
2428 # If set, mutt will check the exit code of the PGP subprocess when
2429 # signing or encrypting.  A non-zero exit code means that the
2430 # subprocess failed.
2431 # (PGP only)
2432
2433
2434 # set pgp_long_ids=no
2435 #
2436 # Name: pgp_long_ids
2437 # Type: boolean
2438 # Default: no
2439
2440
2441 # If set, use 64 bit PGP key IDs, if unset use the normal 32 bit key IDs.
2442 # (PGP only)
2443
2444
2445 # set pgp_retainable_sigs=no
2446 #
2447 # Name: pgp_retainable_sigs
2448 # Type: boolean
2449 # Default: no
2450
2451
2452 # If set, signed and encrypted messages will consist of nested
2453 # multipart/signed and multipart/encrypted body parts.
2454
2455 # This is useful for applications like encrypted and signed mailing
2456 # lists, where the outer layer (multipart/encrypted) can be easily
2457 # removed, while the inner multipart/signed part is retained.
2458 # (PGP only)
2459
2460
2461 # set pgp_autoinline=no
2462 #
2463 # Name: pgp_autoinline
2464 # Type: boolean
2465 # Default: no
2466
2467
2468 # This option controls whether Mutt generates old-style inline
2469 # (traditional) PGP encrypted or signed messages under certain
2470 # circumstances.  This can be overridden by use of the pgp menu,
2471 # when inline is not required.
2472
2473 # Note that Mutt might automatically use PGP/MIME for messages
2474 # which consist of more than a single MIME part.  Mutt can be
2475 # configured to ask before sending PGP/MIME messages when inline
2476 # (traditional) would not work.
2477
2478 # Also see the $pgp_mime_auto variable.
2479
2480 # Also note that using the old-style PGP message format is strongly
2481 # deprecated.
2482 # (PGP only)
2483
2484
2485 # set pgp_replyinline=no
2486 #
2487 # Name: pgp_replyinline
2488 # Type: boolean
2489 # Default: no
2490
2491
2492 # Setting this variable will cause Mutt to always attempt to
2493 # create an inline (traditional) message when replying to a
2494 # message which is PGP encrypted/signed inline.  This can be
2495 # overridden by use of the pgp menu, when inline is not
2496 # required.  This option does not automatically detect if the
2497 # (replied-to) message is inline; instead it relies on Mutt
2498 # internals for previously checked/flagged messages.
2499
2500 # Note that Mutt might automatically use PGP/MIME for messages
2501 # which consist of more than a single MIME part.  Mutt can be
2502 # configured to ask before sending PGP/MIME messages when inline
2503 # (traditional) would not work.
2504
2505 # Also see the $pgp_mime_auto variable.
2506
2507 # Also note that using the old-style PGP message format is strongly
2508 # deprecated.
2509 # (PGP only)
2510
2511
2512 # set pgp_show_unusable=yes
2513 #
2514 # Name: pgp_show_unusable
2515 # Type: boolean
2516 # Default: yes
2517
2518
2519 # If set, mutt will display non-usable keys on the PGP key selection
2520 # menu.  This includes keys which have been revoked, have expired, or
2521 # have been marked as ``disabled'' by the user.
2522 # (PGP only)
2523
2524
2525 # set pgp_sign_as=""
2526 #
2527 # Name: pgp_sign_as
2528 # Type: string
2529 # Default: ""
2530
2531
2532 # If you have more than one key pair, this option allows you to specify
2533 # which of your private keys to use.  It is recommended that you use the
2534 # keyid form to specify your key (e.g. 0x00112233).
2535 # (PGP only)
2536
2537
2538 # set pgp_strict_enc=yes
2539 #
2540 # Name: pgp_strict_enc
2541 # Type: boolean
2542 # Default: yes
2543
2544
2545 # If set, Mutt will automatically encode PGP/MIME signed messages as
2546 # quoted-printable.  Please note that unsetting this variable may
2547 # lead to problems with non-verifyable PGP signatures, so only change
2548 # this if you know what you are doing.
2549 # (PGP only)
2550
2551
2552 # set pgp_timeout=300
2553 #
2554 # Name: pgp_timeout
2555 # Type: number
2556 # Default: 300
2557
2558
2559 # The number of seconds after which a cached passphrase will expire if
2560 # not used.
2561 # (PGP only)
2562
2563
2564 # set pgp_sort_keys=address
2565 #
2566 # Name: pgp_sort_keys
2567 # Type: sort order
2568 # Default: address
2569
2570
2571 # Specifies how the entries in the pgp menu are sorted. The
2572 # following are legal values:
2573 # address sort alphabetically by user id
2574 # keyid   sort alphabetically by key id
2575 # date    sort by key creation date
2576 # trust   sort by the trust of the key
2577
2578
2579 # If you prefer reverse order of the above values, prefix it with
2580 # ``reverse-''.
2581 # (PGP only)
2582
2583
2584 # set pgp_mime_auto=ask-yes
2585 #
2586 # Name: pgp_mime_auto
2587 # Type: quadoption
2588 # Default: ask-yes
2589
2590
2591 # This option controls whether Mutt will prompt you for
2592 # automatically sending a (signed/encrypted) message using
2593 # PGP/MIME when inline (traditional) fails (for any reason).
2594
2595 # Also note that using the old-style PGP message format is strongly
2596 # deprecated.
2597 # (PGP only)
2598
2599
2600 # set pgp_auto_decode=no
2601 #
2602 # Name: pgp_auto_decode
2603 # Type: boolean
2604 # Default: no
2605
2606
2607 # If set, mutt will automatically attempt to decrypt traditional PGP
2608 # messages whenever the user performs an operation which ordinarily would
2609 # result in the contents of the message being operated on.  For example,
2610 # if the user displays a pgp-traditional message which has not been manually
2611 # checked with the <check-traditional-pgp> function, mutt will automatically
2612 # check the message for traditional pgp.
2613
2614
2615 # set pgp_mime_signature_filename="signature.asc"
2616 #
2617 # Name: pgp_mime_signature_filename
2618 # Type: string
2619 # Default: "signature.asc"
2620
2621
2622 # This option sets the filename used for signature parts in PGP/MIME
2623 # signed messages.
2624
2625
2626 # set pgp_mime_signature_description="Digital signature"
2627 #
2628 # Name: pgp_mime_signature_description
2629 # Type: string
2630 # Default: "Digital signature"
2631
2632
2633 # This option sets the Content-Description used for signature parts in
2634 # PGP/MIME signed messages.
2635
2636
2637 # set pgp_decode_command=""
2638 #
2639 # Name: pgp_decode_command
2640 # Type: string
2641 # Default: ""
2642
2643
2644 # This format strings specifies a command which is used to decode
2645 # application/pgp attachments.
2646
2647 # The PGP command formats have their own set of printf(3)-like sequences:
2648 # %p      Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
2649 #         string otherwise. Note: This may be used with a %? construct.
2650 # %f      Expands to the name of a file containing a message.
2651 # %s      Expands to the name of a file containing the signature part
2652 #                    of a multipart/signed attachment when verifying it.
2653 # %a      The value of $pgp_sign_as.
2654 # %r      One or more key IDs.
2655
2656
2657 # For examples on how to configure these formats for the various versions
2658 # of PGP which are floating around, see the pgp and gpg sample configuration files in
2659 # the samples/ subdirectory which has been installed on your system
2660 # alongside the documentation.
2661 # (PGP only)
2662
2663
2664 # set pgp_getkeys_command=""
2665 #
2666 # Name: pgp_getkeys_command
2667 # Type: string
2668 # Default: ""
2669
2670
2671 # This command is invoked whenever mutt will need public key information.
2672 # Of the sequences supported by $pgp_decode_command, %r is the only
2673 # printf(3)-like sequence used with this format.
2674 # (PGP only)
2675
2676
2677 # set pgp_verify_command=""
2678 #
2679 # Name: pgp_verify_command
2680 # Type: string
2681 # Default: ""
2682
2683
2684 # This command is used to verify PGP signatures.
2685
2686 # This is a format string, see the $pgp_decode_command command for
2687 # possible printf(3)-like sequences.
2688 # (PGP only)
2689
2690
2691 # set pgp_decrypt_command=""
2692 #
2693 # Name: pgp_decrypt_command
2694 # Type: string
2695 # Default: ""
2696
2697
2698 # This command is used to decrypt a PGP encrypted message.
2699
2700 # This is a format string, see the $pgp_decode_command command for
2701 # possible printf(3)-like sequences.
2702 # (PGP only)
2703
2704
2705 # set pgp_clearsign_command=""
2706 #
2707 # Name: pgp_clearsign_command
2708 # Type: string
2709 # Default: ""
2710
2711
2712 # This format is used to create an old-style ``clearsigned'' PGP
2713 # message.  Note that the use of this format is strongly
2714 # deprecated.
2715
2716 # This is a format string, see the $pgp_decode_command command for
2717 # possible printf(3)-like sequences.
2718 # (PGP only)
2719
2720
2721 # set pgp_sign_command=""
2722 #
2723 # Name: pgp_sign_command
2724 # Type: string
2725 # Default: ""
2726
2727
2728 # This command is used to create the detached PGP signature for a
2729 # multipart/signed PGP/MIME body part.
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_encrypt_sign_command=""
2737 #
2738 # Name: pgp_encrypt_sign_command
2739 # Type: string
2740 # Default: ""
2741
2742
2743 # This command is used to both sign and encrypt a body part.
2744
2745 # This is a format string, see the $pgp_decode_command command for
2746 # possible printf(3)-like sequences.
2747 # (PGP only)
2748
2749
2750 # set pgp_encrypt_only_command=""
2751 #
2752 # Name: pgp_encrypt_only_command
2753 # Type: string
2754 # Default: ""
2755
2756
2757 # This command is used to encrypt a body part without signing it.
2758
2759 # This is a format string, see the $pgp_decode_command command for
2760 # possible printf(3)-like sequences.
2761 # (PGP only)
2762
2763
2764 # set pgp_import_command=""
2765 #
2766 # Name: pgp_import_command
2767 # Type: string
2768 # Default: ""
2769
2770
2771 # This command is used to import a key from a message into
2772 # the user's public key ring.
2773
2774 # This is a format string, see the $pgp_decode_command command for
2775 # possible printf(3)-like sequences.
2776 # (PGP only)
2777
2778
2779 # set pgp_export_command=""
2780 #
2781 # Name: pgp_export_command
2782 # Type: string
2783 # Default: ""
2784
2785
2786 # This command is used to export a public key from the user's
2787 # key ring.
2788
2789 # This is a format string, see the $pgp_decode_command command for
2790 # possible printf(3)-like sequences.
2791 # (PGP only)
2792
2793
2794 # set pgp_verify_key_command=""
2795 #
2796 # Name: pgp_verify_key_command
2797 # Type: string
2798 # Default: ""
2799
2800
2801 # This command is used to verify key information from the key selection
2802 # menu.
2803
2804 # This is a format string, see the $pgp_decode_command command for
2805 # possible printf(3)-like sequences.
2806 # (PGP only)
2807
2808
2809 # set pgp_list_secring_command=""
2810 #
2811 # Name: pgp_list_secring_command
2812 # Type: string
2813 # Default: ""
2814
2815
2816 # This command is used to list the secret key ring's contents.  The
2817 # output format must be analogous to the one used by:
2818 # gpg --list-keys --with-colons.
2819
2820 # This format is also generated by the pgpring utility which comes
2821 # with mutt.
2822
2823 # This is a format string, see the $pgp_decode_command command for
2824 # possible printf(3)-like sequences.
2825 # (PGP only)
2826
2827
2828 # set pgp_list_pubring_command=""
2829 #
2830 # Name: pgp_list_pubring_command
2831 # Type: string
2832 # Default: ""
2833
2834
2835 # This command is used to list the public key ring's contents.  The
2836 # output format must be analogous to the one used by
2837 # gpg --list-keys --with-colons.
2838
2839 # This format is also generated by the pgpring utility which comes
2840 # with mutt.
2841
2842 # This is a format string, see the $pgp_decode_command command for
2843 # possible printf(3)-like sequences.
2844 # (PGP only)
2845
2846
2847 # set forward_decrypt=yes
2848 #
2849 # Name: forward_decrypt
2850 # Type: boolean
2851 # Default: yes
2852
2853
2854 # Controls the handling of encrypted messages when forwarding a message.
2855 # When set, the outer layer of encryption is stripped off.  This
2856 # variable is only used if $mime_forward is set and
2857 # $mime_forward_decode is unset.
2858 # (PGP only)
2859
2860
2861 # set smime_timeout=300
2862 #
2863 # Name: smime_timeout
2864 # Type: number
2865 # Default: 300
2866
2867
2868 # The number of seconds after which a cached passphrase will expire if
2869 # not used.
2870 # (S/MIME only)
2871
2872
2873 # set smime_encrypt_with=""
2874 #
2875 # Name: smime_encrypt_with
2876 # Type: string
2877 # Default: ""
2878
2879
2880 # This sets the algorithm that should be used for encryption.
2881 # Valid choices are ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``rc2-128''.
2882 # If unset, ``3des'' (TripleDES) is used.
2883 # (S/MIME only)
2884
2885
2886 # set smime_keys=""
2887 #
2888 # Name: smime_keys
2889 # Type: path
2890 # Default: ""
2891
2892
2893 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2894 # storage and retrieval of keys/certs by itself. This is very basic right now,
2895 # and stores keys and certificates in two different directories, both
2896 # named as the hash-value retrieved from OpenSSL. There is an index file
2897 # which contains mailbox-address keyid pair, and which can be manually
2898 # edited. This option points to the location of the private keys.
2899 # (S/MIME only)
2900
2901
2902 # set smime_ca_location=""
2903 #
2904 # Name: smime_ca_location
2905 # Type: path
2906 # Default: ""
2907
2908
2909 # This variable contains the name of either a directory, or a file which
2910 # contains trusted certificates for use with OpenSSL.
2911 # (S/MIME only)
2912
2913 # Note: On Debian systems, this defaults to the first existing file in
2914 # the following list: ~/.smime/ca-certificates.crt ~/.smime/ca-bundle.crt
2915 # /etc/ssl/certs/ca-certificates.crt.
2916
2917
2918 # set smime_certificates=""
2919 #
2920 # Name: smime_certificates
2921 # Type: path
2922 # Default: ""
2923
2924
2925 # Since for S/MIME there is no pubring/secring as with PGP, mutt has to handle
2926 # storage and retrieval of keys by itself. This is very basic right
2927 # now, and keys and certificates are stored in two different
2928 # directories, both named as the hash-value retrieved from
2929 # OpenSSL. There is an index file which contains mailbox-address
2930 # keyid pairs, and which can be manually edited. This option points to
2931 # the location of the certificates.
2932 # (S/MIME only)
2933
2934
2935 # set smime_decrypt_command=""
2936 #
2937 # Name: smime_decrypt_command
2938 # Type: string
2939 # Default: ""
2940
2941
2942 # This format string specifies a command which is used to decrypt
2943 # application/x-pkcs7-mime attachments.
2944
2945 # The OpenSSL command formats have their own set of printf(3)-like sequences
2946 # similar to PGP's:
2947 # %f      Expands to the name of a file containing a message.
2948 # %s      Expands to the name of a file containing the signature part
2949 #                    of a multipart/signed attachment when verifying it.
2950 # %k      The key-pair specified with $smime_default_key
2951 # %c      One or more certificate IDs.
2952 # %a      The algorithm used for encryption.
2953 # %C      CA location:  Depending on whether $smime_ca_location
2954 #                    points to a directory or file, this expands to
2955 #                    ``-CApath $smime_ca_location'' or ``-CAfile $smime_ca_location''.
2956
2957
2958 # For examples on how to configure these formats, see the smime.rc in
2959 # the samples/ subdirectory which has been installed on your system
2960 # alongside the documentation.
2961 # (S/MIME only)
2962
2963
2964 # set smime_verify_command=""
2965 #
2966 # Name: smime_verify_command
2967 # Type: string
2968 # Default: ""
2969
2970
2971 # This command is used to verify S/MIME signatures of type multipart/signed.
2972
2973 # This is a format string, see the $smime_decrypt_command command for
2974 # possible printf(3)-like sequences.
2975 # (S/MIME only)
2976
2977
2978 # set smime_verify_opaque_command=""
2979 #
2980 # Name: smime_verify_opaque_command
2981 # Type: string
2982 # Default: ""
2983
2984
2985 # This command is used to verify S/MIME signatures of type
2986 # application/x-pkcs7-mime.
2987
2988 # This is a format string, see the $smime_decrypt_command command for
2989 # possible printf(3)-like sequences.
2990 # (S/MIME only)
2991
2992
2993 # set smime_sign_command=""
2994 #
2995 # Name: smime_sign_command
2996 # Type: string
2997 # Default: ""
2998
2999
3000 # This command is used to created S/MIME signatures of type
3001 # multipart/signed, which can be read by all mail clients.
3002
3003 # This is a format string, see the $smime_decrypt_command command for
3004 # possible printf(3)-like sequences.
3005 # (S/MIME only)
3006
3007
3008 # set smime_sign_opaque_command=""
3009 #
3010 # Name: smime_sign_opaque_command
3011 # Type: string
3012 # Default: ""
3013
3014
3015 # This command is used to created S/MIME signatures of type
3016 # application/x-pkcs7-signature, which can only be handled by mail
3017 # clients supporting the S/MIME extension.
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_encrypt_command=""
3025 #
3026 # Name: smime_encrypt_command
3027 # Type: string
3028 # Default: ""
3029
3030
3031 # This command is used to create encrypted S/MIME messages.
3032
3033 # This is a format string, see the $smime_decrypt_command command for
3034 # possible printf(3)-like sequences.
3035 # (S/MIME only)
3036
3037
3038 # set smime_pk7out_command=""
3039 #
3040 # Name: smime_pk7out_command
3041 # Type: string
3042 # Default: ""
3043
3044
3045 # This command is used to extract PKCS7 structures of S/MIME signatures,
3046 # in order to extract the public X509 certificate(s).
3047
3048 # This is a format string, see the $smime_decrypt_command command for
3049 # possible printf(3)-like sequences.
3050 # (S/MIME only)
3051
3052
3053 # set smime_get_cert_command=""
3054 #
3055 # Name: smime_get_cert_command
3056 # Type: string
3057 # Default: ""
3058
3059
3060 # This command is used to extract X509 certificates from a PKCS7 structure.
3061
3062 # This is a format string, see the $smime_decrypt_command command for
3063 # possible printf(3)-like sequences.
3064 # (S/MIME only)
3065
3066
3067 # set smime_get_signer_cert_command=""
3068 #
3069 # Name: smime_get_signer_cert_command
3070 # Type: string
3071 # Default: ""
3072
3073
3074 # This command is used to extract only the signers X509 certificate from a S/MIME
3075 # signature, so that the certificate's owner may get compared to the
3076 # email's ``From:'' field.
3077
3078 # This is a format string, see the $smime_decrypt_command command for
3079 # possible printf(3)-like sequences.
3080 # (S/MIME only)
3081
3082
3083 # set smime_import_cert_command=""
3084 #
3085 # Name: smime_import_cert_command
3086 # Type: string
3087 # Default: ""
3088
3089
3090 # This command is used to import a certificate via smime_keys.
3091
3092 # This is a format string, see the $smime_decrypt_command command for
3093 # possible printf(3)-like sequences.
3094 # (S/MIME only)
3095
3096
3097 # set smime_get_cert_email_command=""
3098 #
3099 # Name: smime_get_cert_email_command
3100 # Type: string
3101 # Default: ""
3102
3103
3104 # This command is used to extract the mail address(es) used for storing
3105 # X509 certificates, and for verification purposes (to check whether the
3106 # certificate was issued for the sender's mailbox).
3107
3108 # This is a format string, see the $smime_decrypt_command command for
3109 # possible printf(3)-like sequences.
3110 # (S/MIME only)
3111
3112
3113 # set smime_default_key=""
3114 #
3115 # Name: smime_default_key
3116 # Type: string
3117 # Default: ""
3118
3119
3120 # This is the default key-pair to use for signing. This must be set to the
3121 # keyid (the hash-value that OpenSSL generates) to work properly
3122 # (S/MIME only)
3123
3124
3125 # set ssl_client_cert=""
3126 #
3127 # Name: ssl_client_cert
3128 # Type: path
3129 # Default: ""
3130
3131
3132 # The file containing a client certificate and its associated private
3133 # key.
3134
3135
3136 # set ssl_force_tls=no
3137 #
3138 # Name: ssl_force_tls
3139 # Type: boolean
3140 # Default: no
3141
3142
3143 # If this variable is set, Mutt will require that all connections
3144 # to remote servers be encrypted. Furthermore it will attempt to
3145 # negotiate TLS even if the server does not advertise the capability,
3146 # since it would otherwise have to abort the connection anyway. This
3147 # option supersedes $ssl_starttls.
3148
3149
3150 # set ssl_starttls=yes
3151 #
3152 # Name: ssl_starttls
3153 # Type: quadoption
3154 # Default: yes
3155
3156
3157 # If set (the default), mutt will attempt to use STARTTLS on servers
3158 # advertising the capability. When unset, mutt will not attempt to
3159 # use STARTTLS regardless of the server's capabilities.
3160
3161
3162 # set certificate_file="~/.mutt_certificates"
3163 #
3164 # Name: certificate_file
3165 # Type: path
3166 # Default: "~/.mutt_certificates"
3167
3168
3169 # This variable specifies the file where the certificates you trust
3170 # are saved. When an unknown certificate is encountered, you are asked
3171 # if you accept it or not. If you accept it, the certificate can also
3172 # be saved in this file and further connections are automatically
3173 # accepted.
3174
3175 # You can also manually add CA certificates in this file. Any server
3176 # certificate that is signed with one of these CA certificates is
3177 # also automatically accepted.
3178
3179 # Example:
3180 # set certificate_file=~/.mutt/certificates
3181
3182
3183 # set ssl_use_sslv3=yes
3184 #
3185 # Name: ssl_use_sslv3
3186 # Type: boolean
3187 # Default: yes
3188
3189
3190 # This variable specifies whether to attempt to use SSLv3 in the
3191 # SSL authentication process.
3192
3193
3194 # set ssl_use_tlsv1=yes
3195 #
3196 # Name: ssl_use_tlsv1
3197 # Type: boolean
3198 # Default: yes
3199
3200
3201 # This variable specifies whether to attempt to use TLSv1 in the
3202 # SSL authentication process.
3203
3204
3205 # set ssl_min_dh_prime_bits=0
3206 #
3207 # Name: ssl_min_dh_prime_bits
3208 # Type: number
3209 # Default: 0
3210
3211
3212 # This variable specifies the minimum acceptable prime size (in bits)
3213 # for use in any Diffie-Hellman key exchange. A value of 0 will use
3214 # the default from the GNUTLS library.
3215
3216
3217 # set ssl_ca_certificates_file=""
3218 #
3219 # Name: ssl_ca_certificates_file
3220 # Type: path
3221 # Default: ""
3222
3223
3224 # This variable specifies a file containing trusted CA certificates.
3225 # Any server certificate that is signed with one of these CA
3226 # certificates is also automatically accepted.
3227
3228 # Example:
3229 # set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
3230
3231 # Note: On Debian systems, this variable defaults to the example
3232 # mentioned. This file is managed by the ``ca-certificates'' package.
3233
3234
3235 # set pipe_split=no
3236 #
3237 # Name: pipe_split
3238 # Type: boolean
3239 # Default: no
3240
3241
3242 # Used in connection with the <pipe-message> function following
3243 # <tag-prefix>.  If this variable is unset, when piping a list of
3244 # tagged messages Mutt will concatenate the messages and will pipe them
3245 # all concatenated.  When set, Mutt will pipe the messages one by one.
3246 # In both cases the messages are piped in the current sorted order,
3247 # and the $pipe_sep separator is added after each message.
3248
3249
3250 # set pipe_decode=no
3251 #
3252 # Name: pipe_decode
3253 # Type: boolean
3254 # Default: no
3255
3256
3257 # Used in connection with the <pipe-message> command.  When unset,
3258 # Mutt will pipe the messages without any preprocessing. When set, Mutt
3259 # will weed headers and will attempt to decode the messages
3260 # first.
3261
3262
3263 # set pipe_sep="\n"
3264 #
3265 # Name: pipe_sep
3266 # Type: string
3267 # Default: "\n"
3268
3269
3270 # The separator to add between messages when piping a list of tagged
3271 # messages to an external Unix command.
3272
3273
3274 # set pop_authenticators=""
3275 #
3276 # Name: pop_authenticators
3277 # Type: string
3278 # Default: ""
3279
3280
3281 # This is a colon-delimited list of authentication methods mutt may
3282 # attempt to use to log in to an POP server, in the order mutt should
3283 # try them.  Authentication methods are either ``user'', ``apop'' or any
3284 # SASL mechanism, eg ``digest-md5'', ``gssapi'' or ``cram-md5''.
3285 # This option is case-insensitive. If this option is unset
3286 # (the default) mutt will try all available methods, in order from
3287 # most-secure to least-secure.
3288
3289 # Example:
3290 # set pop_authenticators="digest-md5:apop:user"
3291
3292
3293 # set pop_auth_try_all=yes
3294 #
3295 # Name: pop_auth_try_all
3296 # Type: boolean
3297 # Default: yes
3298
3299
3300 # If set, Mutt will try all available authentication methods.
3301 # When unset, Mutt will only fall back to other authentication
3302 # methods if the previous methods are unavailable. If a method is
3303 # available but authentication fails, Mutt will not connect to the POP server.
3304
3305
3306 # set pop_checkinterval=60
3307 #
3308 # Name: pop_checkinterval
3309 # Type: number
3310 # Default: 60
3311
3312
3313 # This variable configures how often (in seconds) mutt should look for
3314 # new mail in the currently selected mailbox if it is a POP mailbox.
3315
3316
3317 # set pop_delete=ask-no
3318 #
3319 # Name: pop_delete
3320 # Type: quadoption
3321 # Default: ask-no
3322
3323
3324 # If set, Mutt will delete successfully downloaded messages from the POP
3325 # server when using the <fetch-mail> function.  When unset, Mutt will
3326 # download messages but also leave them on the POP server.
3327
3328
3329 # set pop_host=""
3330 #
3331 # Name: pop_host
3332 # Type: string
3333 # Default: ""
3334
3335
3336 # The name of your POP server for the <fetch-mail> function.  You
3337 # can also specify an alternative port, username and password, ie:
3338 # [pop[s]://][username[:password]@]popserver[:port]
3339
3340 # where ``[...]'' denotes an optional part.
3341
3342
3343 # set pop_last=no
3344 #
3345 # Name: pop_last
3346 # Type: boolean
3347 # Default: no
3348
3349
3350 # If this variable is set, mutt will try to use the ``LAST'' POP command
3351 # for retrieving only unread messages from the POP server when using
3352 # the <fetch-mail> function.
3353
3354
3355 # set pop_reconnect=ask-yes
3356 #
3357 # Name: pop_reconnect
3358 # Type: quadoption
3359 # Default: ask-yes
3360
3361
3362 # Controls whether or not Mutt will try to reconnect to the POP server if
3363 # the connection is lost.
3364
3365
3366 # set pop_user=""
3367 #
3368 # Name: pop_user
3369 # Type: string
3370 # Default: ""
3371
3372
3373 # Your login name on the POP server.
3374
3375 # This variable defaults to your user name on the local machine.
3376
3377
3378 # set pop_pass=""
3379 #
3380 # Name: pop_pass
3381 # Type: string
3382 # Default: ""
3383
3384
3385 # Specifies the password for your POP account.  If unset, Mutt will
3386 # prompt you for your password when you open a POP mailbox.
3387
3388 # Warning: you should only use this option when you are on a
3389 # fairly secure machine, because the superuser can read your muttrc
3390 # even if you are the only one who can read the file.
3391
3392
3393 # set post_indent_string=""
3394 #
3395 # Name: post_indent_string
3396 # Type: string
3397 # Default: ""
3398
3399
3400 # Similar to the $attribution variable, Mutt will append this
3401 # string after the inclusion of a message which is being replied to.
3402
3403
3404 # set postpone=ask-yes
3405 #
3406 # Name: postpone
3407 # Type: quadoption
3408 # Default: ask-yes
3409
3410
3411 # Controls whether or not messages are saved in the $postponed
3412 # mailbox when you elect not to send immediately.
3413
3414 # Also see the $recall variable.
3415
3416
3417 # set postponed="~/postponed"
3418 #
3419 # Name: postponed
3420 # Type: path
3421 # Default: "~/postponed"
3422
3423
3424 # Mutt allows you to indefinitely ``postpone sending a message'' which
3425 # you are editing.  When you choose to postpone a message, Mutt saves it
3426 # in the mailbox specified by this variable.
3427
3428 # Also see the $postpone variable.
3429
3430
3431 # set preconnect=""
3432 #
3433 # Name: preconnect
3434 # Type: string
3435 # Default: ""
3436
3437
3438 # If set, a shell command to be executed if mutt fails to establish
3439 # a connection to the server. This is useful for setting up secure
3440 # connections, e.g. with ssh(1). If the command returns a  nonzero
3441 # status, mutt gives up opening the server. Example:
3442 # set preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net \
3443 # sleep 20 < /dev/null > /dev/null"
3444
3445 # Mailbox ``foo'' on ``mailhost.net'' can now be reached
3446 # as ``{localhost:1234}foo''.
3447
3448 # Note: For this example to work, you must be able to log in to the
3449 # remote machine without having to enter a password.
3450
3451 # When set, Mutt uses the tunnel for all remote connections.
3452 # Please see ``account-hook'' in the manual for how to use different
3453 # tunnel commands per connection.
3454
3455
3456 # set print=ask-no
3457 #
3458 # Name: print
3459 # Type: quadoption
3460 # Default: ask-no
3461
3462
3463 # Controls whether or not Mutt really prints messages.
3464 # This is set to ``ask-no'' by default, because some people
3465 # accidentally hit ``p'' often.
3466
3467
3468 # set print_command="lpr"
3469 #
3470 # Name: print_command
3471 # Type: path
3472 # Default: "lpr"
3473
3474
3475 # This specifies the command pipe that should be used to print messages.
3476
3477
3478 # set print_decode=yes
3479 #
3480 # Name: print_decode
3481 # Type: boolean
3482 # Default: yes
3483
3484
3485 # Used in connection with the <print-message> command.  If this
3486 # option is set, the message is decoded before it is passed to the
3487 # external command specified by $print_command.  If this option
3488 # is unset, no processing will be applied to the message when
3489 # printing it.  The latter setting may be useful if you are using
3490 # some advanced printer filter which is able to properly format
3491 # e-mail messages for printing.
3492
3493
3494 # set print_split=no
3495 #
3496 # Name: print_split
3497 # Type: boolean
3498 # Default: no
3499
3500
3501 # Used in connection with the <print-message> command.  If this option
3502 # is set, the command specified by $print_command is executed once for
3503 # each message which is to be printed.  If this option is unset,
3504 # the command specified by $print_command is executed only once, and
3505 # all the messages are concatenated, with a form feed as the message
3506 # separator.
3507
3508 # Those who use the enscript(1) program's mail-printing mode will
3509 # most likely want to set this option.
3510
3511
3512 # set prompt_after=yes
3513 #
3514 # Name: prompt_after
3515 # Type: boolean
3516 # Default: yes
3517
3518
3519 # If you use an external $pager, setting this variable will
3520 # cause Mutt to prompt you for a command when the pager exits rather
3521 # than returning to the index menu.  If unset, Mutt will return to the
3522 # index menu when the external pager exits.
3523
3524
3525 # set query_command=""
3526 #
3527 # Name: query_command
3528 # Type: path
3529 # Default: ""
3530
3531
3532 # This specifies the command that mutt will use to make external address
3533 # queries.  The string should contain a ``%s'', which will be substituted
3534 # with the query string the user types.  See ``query'' for more
3535 # information.
3536
3537
3538 # set query_format="%4c %t %-25.25a %-25.25n %?e?(%e)?"
3539 #
3540 # Name: query_format
3541 # Type: string
3542 # Default: "%4c %t %-25.25a %-25.25n %?e?(%e)?"
3543
3544
3545 # This variable describes the format of the ``query'' menu. The
3546 # following printf(3)-style sequences are understood:
3547 # %a      destination address
3548 # %c      current entry number
3549 # %e      extra information *
3550 # %n      destination name
3551 # %t      ``*'' if current entry is tagged, a space otherwise
3552 # %>X     right justify the rest of the string and pad with ``X''
3553 # %|X     pad to the end of the line with ``X''
3554 # %*X     soft-fill with character ``X'' as pad
3555
3556
3557 # For an explanation of ``soft-fill'', see the $index_format documentation.
3558
3559 # * = can be optionally printed if nonzero, see the $status_format documentation.
3560
3561
3562 # set quit=yes
3563 #
3564 # Name: quit
3565 # Type: quadoption
3566 # Default: yes
3567
3568
3569 # This variable controls whether ``quit'' and ``exit'' actually quit
3570 # from mutt.  If this option is set, they do quit, if it is unset, they
3571 # have no effect, and if it is set to ask-yes or ask-no, you are
3572 # prompted for confirmation when you try to quit.
3573
3574
3575 # set quote_regexp="^([ \t]*[|>:}#])+"
3576 #
3577 # Name: quote_regexp
3578 # Type: regular expression
3579 # Default: "^([ \t]*[|>:}#])+"
3580
3581
3582 # A regular expression used in the internal pager to determine quoted
3583 # sections of text in the body of a message. Quoted text may be filtered
3584 # out using the <toggle-quoted> command, or colored according to the
3585 # ``color quoted'' family of directives.
3586
3587 # Higher levels of quoting may be colored differently (``color quoted1'',
3588 # ``color quoted2'', etc.). The quoting level is determined by removing
3589 # the last character from the matched text and recursively reapplying
3590 # the regular expression until it fails to produce a match.
3591
3592 # Match detection may be overridden by the $smileys regular expression.
3593
3594
3595 # set read_inc=10
3596 #
3597 # Name: read_inc
3598 # Type: number
3599 # Default: 10
3600
3601
3602 # If set to a value greater than 0, Mutt will display which message it
3603 # is currently on when reading a mailbox or when performing search actions
3604 # such as search and limit. The message is printed after
3605 # this many messages have been read or searched (e.g., if set to 25, Mutt will
3606 # print a message when it is at message 25, and then again when it gets
3607 # to message 50).  This variable is meant to indicate progress when
3608 # reading or searching large mailboxes which may take some time.
3609 # When set to 0, only a single message will appear before the reading
3610 # the mailbox.
3611
3612 # Also see the $write_inc, $net_inc and $time_inc variables and the
3613 # ``tuning'' section of the manual for performance considerations.
3614
3615
3616 # set read_only=no
3617 #
3618 # Name: read_only
3619 # Type: boolean
3620 # Default: no
3621
3622
3623 # If set, all folders are opened in read-only mode.
3624
3625
3626 # set realname=""
3627 #
3628 # Name: realname
3629 # Type: string
3630 # Default: ""
3631
3632
3633 # This variable specifies what ``real'' or ``personal'' name should be used
3634 # when sending messages.
3635
3636 # By default, this is the GECOS field from /etc/passwd.  Note that this
3637 # variable will not be used when the user has set a real name
3638 # in the $from variable.
3639
3640
3641 # set recall=ask-yes
3642 #
3643 # Name: recall
3644 # Type: quadoption
3645 # Default: ask-yes
3646
3647
3648 # Controls whether or not Mutt recalls postponed messages
3649 # when composing a new message.
3650
3651 # Setting this variable to is not generally useful, and thus not
3652 # recommended.
3653
3654 # Also see $postponed variable.
3655
3656
3657 # set record="~/sent"
3658 #
3659 # Name: record
3660 # Type: path
3661 # Default: "~/sent"
3662
3663
3664 # This specifies the file into which your outgoing messages should be
3665 # appended.  (This is meant as the primary method for saving a copy of
3666 # your messages, but another way to do this is using the ``my_hdr''
3667 # command to create a ``Bcc:'' field with your email address in it.)
3668
3669 # The value of $record is overridden by the $force_name and
3670 # $save_name variables, and the ``fcc-hook'' command.
3671
3672
3673 # set reply_regexp="^(re([\\[0-9\\]+])*|aw):[ \t]*"
3674 #
3675 # Name: reply_regexp
3676 # Type: regular expression
3677 # Default: "^(re([\\[0-9\\]+])*|aw):[ \t]*"
3678
3679
3680 # A regular expression used to recognize reply messages when threading
3681 # and replying. The default value corresponds to the English "Re:" and
3682 # the German "Aw:".
3683
3684
3685 # set reply_self=no
3686 #
3687 # Name: reply_self
3688 # Type: boolean
3689 # Default: no
3690
3691
3692 # If unset and you are replying to a message sent by you, Mutt will
3693 # assume that you want to reply to the recipients of that message rather
3694 # than to yourself.
3695
3696 # Also see the ``alternates'' command.
3697
3698
3699 # set reply_to=ask-yes
3700 #
3701 # Name: reply_to
3702 # Type: quadoption
3703 # Default: ask-yes
3704
3705
3706 # If set, when replying to a message, Mutt will use the address listed
3707 # in the Reply-to: header as the recipient of the reply.  If unset,
3708 # it will use the address in the From: header field instead.  This
3709 # option is useful for reading a mailing list that sets the Reply-To:
3710 # header field to the list address and you want to send a private
3711 # message to the author of a message.
3712
3713
3714 # set resolve=yes
3715 #
3716 # Name: resolve
3717 # Type: boolean
3718 # Default: yes
3719
3720
3721 # When set, the cursor will be automatically advanced to the next
3722 # (possibly undeleted) message whenever a command that modifies the
3723 # current message is executed.
3724
3725
3726 # set reverse_alias=no
3727 #
3728 # Name: reverse_alias
3729 # Type: boolean
3730 # Default: no
3731
3732
3733 # This variable controls whether or not Mutt will display the ``personal''
3734 # name from your aliases in the index menu if it finds an alias that
3735 # matches the message's sender.  For example, if you have the following
3736 # alias:
3737 # alias juser abd30425@somewhere.net (Joe User)
3738
3739 # and then you receive mail which contains the following header:
3740 # From: abd30425@somewhere.net
3741
3742 # It would be displayed in the index menu as ``Joe User'' instead of
3743 # ``abd30425@somewhere.net.''  This is useful when the person's e-mail
3744 # address is not human friendly.
3745
3746
3747 # set reverse_name=no
3748 #
3749 # Name: reverse_name
3750 # Type: boolean
3751 # Default: no
3752
3753
3754 # It may sometimes arrive that you receive mail to a certain machine,
3755 # move the messages to another machine, and reply to some the messages
3756 # from there.  If this variable is set, the default From: line of
3757 # the reply messages is built using the address where you received the
3758 # messages you are replying to if that address matches your
3759 # ``alternates''.  If the variable is unset, or the address that would be
3760 # used doesn't match your ``alternates'', the From: line will use
3761 # your address on the current machine.
3762
3763 # Also see the ``alternates'' command.
3764
3765
3766 # set reverse_realname=yes
3767 #
3768 # Name: reverse_realname
3769 # Type: boolean
3770 # Default: yes
3771
3772
3773 # This variable fine-tunes the behaviour of the $reverse_name feature.
3774 # When it is set, mutt will use the address from incoming messages as-is,
3775 # possibly including eventual real names.  When it is unset, mutt will
3776 # override any such real names with the setting of the $realname variable.
3777
3778
3779 # set rfc2047_parameters=no
3780 #
3781 # Name: rfc2047_parameters
3782 # Type: boolean
3783 # Default: no
3784
3785
3786 # When this variable is set, Mutt will decode RFC2047-encoded MIME
3787 # parameters. You want to set this variable when mutt suggests you
3788 # to save attachments to files named like:
3789 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3790
3791 # When this variable is set interactively, the change won't be
3792 # active until you change folders.
3793
3794 # Note that this use of RFC2047's encoding is explicitly
3795 # prohibited by the standard, but nevertheless encountered in the
3796 # wild.
3797
3798 # Also note that setting this parameter will not have the effect
3799 # that mutt generates this kind of encoding.  Instead, mutt will
3800 # unconditionally use the encoding specified in RFC2231.
3801
3802
3803 # set save_address=no
3804 #
3805 # Name: save_address
3806 # Type: boolean
3807 # Default: no
3808
3809
3810 # If set, mutt will take the sender's full address when choosing a
3811 # default folder for saving a mail. If $save_name or $force_name
3812 # is set too, the selection of the Fcc folder will be changed as well.
3813
3814
3815 # set save_empty=yes
3816 #
3817 # Name: save_empty
3818 # Type: boolean
3819 # Default: yes
3820
3821
3822 # When unset, mailboxes which contain no saved messages will be removed
3823 # when closed (the exception is $spoolfile which is never removed).
3824 # If set, mailboxes are never removed.
3825
3826 # Note: This only applies to mbox and MMDF folders, Mutt does not
3827 # delete MH and Maildir directories.
3828
3829
3830 # set save_history=0
3831 #
3832 # Name: save_history
3833 # Type: number
3834 # Default: 0
3835
3836
3837 # This variable controls the size of the history (per category) saved in the
3838 # $history_file file.
3839
3840
3841 # set save_name=no
3842 #
3843 # Name: save_name
3844 # Type: boolean
3845 # Default: no
3846
3847
3848 # This variable controls how copies of outgoing messages are saved.
3849 # When set, a check is made to see if a mailbox specified by the
3850 # recipient address exists (this is done by searching for a mailbox in
3851 # the $folder directory with the username part of the
3852 # recipient address).  If the mailbox exists, the outgoing message will
3853 # be saved to that mailbox, otherwise the message is saved to the
3854 # $record mailbox.
3855
3856 # Also see the $force_name variable.
3857
3858
3859 # set score=yes
3860 #
3861 # Name: score
3862 # Type: boolean
3863 # Default: yes
3864
3865
3866 # When this variable is unset, scoring is turned off.  This can
3867 # be useful to selectively disable scoring for certain folders when the
3868 # $score_threshold_delete variable and related are used.
3869
3870
3871 # set score_threshold_delete=-1
3872 #
3873 # Name: score_threshold_delete
3874 # Type: number
3875 # Default: -1
3876
3877
3878 # Messages which have been assigned a score equal to or lower than the value
3879 # of this variable are automatically marked for deletion by mutt.  Since
3880 # mutt scores are always greater than or equal to zero, the default setting
3881 # of this variable will never mark a message for deletion.
3882
3883
3884 # set score_threshold_flag=9999
3885 #
3886 # Name: score_threshold_flag
3887 # Type: number
3888 # Default: 9999
3889
3890
3891 # Messages which have been assigned a score greater than or equal to this
3892 # variable's value are automatically marked "flagged".
3893
3894
3895 # set score_threshold_read=-1
3896 #
3897 # Name: score_threshold_read
3898 # Type: number
3899 # Default: -1
3900
3901
3902 # Messages which have been assigned a score equal to or lower than the value
3903 # of this variable are automatically marked as read by mutt.  Since
3904 # mutt scores are always greater than or equal to zero, the default setting
3905 # of this variable will never mark a message read.
3906
3907
3908 # set send_charset="us-ascii:iso-8859-1:utf-8"
3909 #
3910 # Name: send_charset
3911 # Type: string
3912 # Default: "us-ascii:iso-8859-1:utf-8"
3913
3914
3915 # A colon-delimited list of character sets for outgoing messages. Mutt will use the
3916 # first character set into which the text can be converted exactly.
3917 # If your $charset is not ``iso-8859-1'' and recipients may not
3918 # understand ``UTF-8'', it is advisable to include in the list an
3919 # appropriate widely used standard character set (such as
3920 # ``iso-8859-2'', ``koi8-r'' or ``iso-2022-jp'') either instead of or after
3921 # ``iso-8859-1''.
3922
3923 # In case the text cannot be converted into one of these exactly,
3924 # mutt uses $charset as a fallback.
3925
3926
3927 # set sendmail="/usr/sbin/sendmail -oem -oi"
3928 #
3929 # Name: sendmail
3930 # Type: path
3931 # Default: "/usr/sbin/sendmail -oem -oi"
3932
3933
3934 # Specifies the program and arguments used to deliver mail sent by Mutt.
3935 # Mutt expects that the specified program interprets additional
3936 # arguments as recipient addresses.
3937
3938
3939 # set sendmail_wait=0
3940 #
3941 # Name: sendmail_wait
3942 # Type: number
3943 # Default: 0
3944
3945
3946 # Specifies the number of seconds to wait for the $sendmail process
3947 # to finish before giving up and putting delivery in the background.
3948
3949 # Mutt interprets the value of this variable as follows:
3950 # >0      number of seconds to wait for sendmail to finish before continuing
3951 # 0       wait forever for sendmail to finish
3952 # <0      always put sendmail in the background without waiting
3953
3954
3955 # Note that if you specify a value other than 0, the output of the child
3956 # process will be put in a temporary file.  If there is some error, you
3957 # will be informed as to where to find the output.
3958
3959
3960 # set shell=""
3961 #
3962 # Name: shell
3963 # Type: path
3964 # Default: ""
3965
3966
3967 # Command to use when spawning a subshell.  By default, the user's login
3968 # shell from /etc/passwd is used.
3969
3970
3971 # set sig_dashes=yes
3972 #
3973 # Name: sig_dashes
3974 # Type: boolean
3975 # Default: yes
3976
3977
3978 # If set, a line containing ``-- '' (note the trailing space) will be inserted before your
3979 # $signature.  It is strongly recommended that you not unset
3980 # this variable unless your signature contains just your name.  The
3981 # reason for this is because many software packages use ``-- \n'' to
3982 # detect your signature.  For example, Mutt has the ability to highlight
3983 # the signature in a different color in the builtin pager.
3984
3985
3986 # set sig_on_top=no
3987 #
3988 # Name: sig_on_top
3989 # Type: boolean
3990 # Default: no
3991
3992
3993 # If set, the signature will be included before any quoted or forwarded
3994 # text.  It is strongly recommended that you do not set this variable
3995 # unless you really know what you are doing, and are prepared to take
3996 # some heat from netiquette guardians.
3997
3998
3999 # set signature="~/.signature"
4000 #
4001 # Name: signature
4002 # Type: path
4003 # Default: "~/.signature"
4004
4005
4006 # Specifies the filename of your signature, which is appended to all
4007 # outgoing messages.   If the filename ends with a pipe (``|''), it is
4008 # assumed that filename is a shell command and input should be read from
4009 # its standard output.
4010
4011
4012 # set simple_search="~f %s | ~s %s"
4013 #
4014 # Name: simple_search
4015 # Type: string
4016 # Default: "~f %s | ~s %s"
4017
4018
4019 # Specifies how Mutt should expand a simple search into a real search
4020 # pattern.  A simple search is one that does not contain any of the ``~'' pattern
4021 # operators.  See ``patterns'' for more information on search patterns.
4022
4023 # For example, if you simply type ``joe'' at a search or limit prompt, Mutt
4024 # will automatically expand it to the value specified by this variable by
4025 # replacing ``%s'' with the supplied string.
4026 # For the default value, ``joe'' would be expanded to: ``~f joe | ~s joe''.
4027
4028
4029 # set smart_wrap=yes
4030 #
4031 # Name: smart_wrap
4032 # Type: boolean
4033 # Default: yes
4034
4035
4036 # Controls the display of lines longer than the screen width in the
4037 # internal pager. If set, long lines are wrapped at a word boundary.  If
4038 # unset, lines are simply wrapped at the screen edge. Also see the
4039 # $markers variable.
4040
4041
4042 # set smileys="(>From )|(:[-^]?[][)(><}{|/DP])"
4043 #
4044 # Name: smileys
4045 # Type: regular expression
4046 # Default: "(>From )|(:[-^]?[][)(><}{|/DP])"
4047
4048
4049 # The pager uses this variable to catch some common false
4050 # positives of $quote_regexp, most notably smileys and not consider
4051 # a line quoted text if it also matches $smileys. This mostly
4052 # happens at the beginning of a line.
4053
4054
4055 # set sleep_time=1
4056 #
4057 # Name: sleep_time
4058 # Type: number
4059 # Default: 1
4060
4061
4062 # Specifies time, in seconds, to pause while displaying certain informational
4063 # messages, while moving from folder to folder and after expunging
4064 # messages from the current folder.  The default is to pause one second, so
4065 # a value of zero for this option suppresses the pause.
4066
4067
4068 # set smtp_authenticators=""
4069 #
4070 # Name: smtp_authenticators
4071 # Type: string
4072 # Default: ""
4073
4074
4075 # This is a colon-delimited list of authentication methods mutt may
4076 # attempt to use to log in to an SMTP server, in the order mutt should
4077 # try them.  Authentication methods are any SASL mechanism, eg
4078 # ``digest-md5'', ``gssapi'' or ``cram-md5''.
4079 # This option is case-insensitive. If it is ``unset''
4080 # (the default) mutt will try all available methods, in order from
4081 # most-secure to least-secure.
4082
4083 # Example:
4084 # set smtp_authenticators="digest-md5:cram-md5"
4085
4086
4087 # set smtp_pass=""
4088 #
4089 # Name: smtp_pass
4090 # Type: string
4091 # Default: ""
4092
4093
4094 # Specifies the password for your SMTP account.  If unset, Mutt will
4095 # prompt you for your password when you first send mail via SMTP.
4096 # See $smtp_url to configure mutt to send mail via SMTP.
4097
4098 # Warning: you should only use this option when you are on a
4099 # fairly secure machine, because the superuser can read your muttrc even
4100 # if you are the only one who can read the file.
4101
4102
4103 # set smtp_url=""
4104 #
4105 # Name: smtp_url
4106 # Type: string
4107 # Default: ""
4108
4109
4110 # Defines the SMTP smarthost where sent messages should relayed for
4111 # delivery. This should take the form of an SMTP URL, eg:
4112 # smtp[s]://[user[:pass]@]host[:port]/
4113
4114 # \.\.\. where ``[...]'' denotes an optional part.
4115 # Setting this variable overrides the value of the $sendmail
4116 # variable.
4117
4118
4119 # set sort=date
4120 #
4121 # Name: sort
4122 # Type: sort order
4123 # Default: date
4124
4125
4126 # Specifies how to sort messages in the ``index'' menu.  Valid values
4127 # are:
4128 # - date or date-sent
4129 # - date-received
4130 # - from
4131 # - mailbox-order (unsorted)
4132 # - score
4133 # - size
4134 # - spam
4135 # - subject
4136 # - threads
4137 # - to
4138
4139
4140 # You may optionally use the ``reverse-'' prefix to specify reverse sorting
4141 # order (example: ``set sort=reverse-date-sent'').
4142
4143 # Note: On Debian systems, this option is set by default to
4144 # ``threads'' in /etc/Muttrc.
4145
4146
4147 # set sort_alias=alias
4148 #
4149 # Name: sort_alias
4150 # Type: sort order
4151 # Default: alias
4152
4153
4154 # Specifies how the entries in the ``alias'' menu are sorted.  The
4155 # following are legal values:
4156 # - address (sort alphabetically by email address)
4157 # - alias (sort alphabetically by alias name)
4158 # - unsorted (leave in order specified in .muttrc)
4159
4160
4161 # set sort_aux=date
4162 #
4163 # Name: sort_aux
4164 # Type: sort order
4165 # Default: date
4166
4167
4168 # When sorting by threads, this variable controls how threads are sorted
4169 # in relation to other threads, and how the branches of the thread trees
4170 # are sorted.  This can be set to any value that $sort can, except
4171 # ``threads'' (in that case, mutt will just use ``date-sent'').  You can also
4172 # specify the ``last-'' prefix in addition to the ``reverse-'' prefix, but ``last-''
4173 # must come after ``reverse-''.  The ``last-'' prefix causes messages to be
4174 # sorted against its siblings by which has the last descendant, using
4175 # the rest of $sort_aux as an ordering.  For instance,
4176 # set sort_aux=last-date-received
4177
4178 # would mean that if a new message is received in a
4179 # thread, that thread becomes the last one displayed (or the first, if
4180 # you have ``set sort=reverse-threads''.)
4181
4182 # Note: For reversed $sort
4183 # order $sort_aux is reversed again (which is not the right thing to do,
4184 # but kept to not break any existing configuration setting).
4185
4186
4187 # set sort_browser=alpha
4188 #
4189 # Name: sort_browser
4190 # Type: sort order
4191 # Default: alpha
4192
4193
4194 # Specifies how to sort entries in the file browser.  By default, the
4195 # entries are sorted alphabetically.  Valid values:
4196 # - alpha (alphabetically)
4197 # - date
4198 # - size
4199 # - unsorted
4200
4201
4202 # You may optionally use the ``reverse-'' prefix to specify reverse sorting
4203 # order (example: ``set sort_browser=reverse-date'').
4204
4205
4206 # set sort_re=yes
4207 #
4208 # Name: sort_re
4209 # Type: boolean
4210 # Default: yes
4211
4212
4213 # This variable is only useful when sorting by threads with
4214 # $strict_threads unset.  In that case, it changes the heuristic
4215 # mutt uses to thread messages by subject.  With $sort_re set, mutt will
4216 # only attach a message as the child of another message by subject if
4217 # the subject of the child message starts with a substring matching the
4218 # setting of $reply_regexp.  With $sort_re unset, mutt will attach
4219 # the message whether or not this is the case, as long as the
4220 # non-$reply_regexp parts of both messages are identical.
4221
4222
4223 # set spam_separator=","
4224 #
4225 # Name: spam_separator
4226 # Type: string
4227 # Default: ","
4228
4229
4230 # This variable controls what happens when multiple spam headers
4231 # are matched: if unset, each successive header will overwrite any
4232 # previous matches value for the spam label. If set, each successive
4233 # match will append to the previous, using this variable's value as a
4234 # separator.
4235
4236
4237 # set spoolfile=""
4238 #
4239 # Name: spoolfile
4240 # Type: path
4241 # Default: ""
4242
4243
4244 # If your spool mailbox is in a non-default place where Mutt cannot find
4245 # it, you can specify its location with this variable.  Mutt will
4246 # automatically set this variable to the value of the environment
4247 # variable $MAIL if it is not set.
4248
4249
4250 # set status_chars="-*%A"
4251 #
4252 # Name: status_chars
4253 # Type: string
4254 # Default: "-*%A"
4255
4256
4257 # Controls the characters used by the ``%r'' indicator in
4258 # $status_format. The first character is used when the mailbox is
4259 # unchanged. The second is used when the mailbox has been changed, and
4260 # it needs to be resynchronized. The third is used if the mailbox is in
4261 # read-only mode, or if the mailbox will not be written when exiting
4262 # that mailbox (You can toggle whether to write changes to a mailbox
4263 # with the <toggle-write> operation, bound by default to ``%''). The fourth
4264 # is used to indicate that the current folder has been opened in attach-
4265 # message mode (Certain operations like composing a new mail, replying,
4266 # forwarding, etc. are not permitted in this mode).
4267
4268
4269 # 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)---"
4270 #
4271 # Name: status_format
4272 # Type: string
4273 # 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)---"
4274
4275
4276 # Controls the format of the status line displayed in the ``index''
4277 # menu.  This string is similar to $index_format, but has its own
4278 # set of printf(3)-like sequences:
4279 # %b      number of mailboxes with new mail *
4280 # %d      number of deleted messages *
4281 # %f      the full pathname of the current mailbox
4282 # %F      number of flagged messages *
4283 # %h      local hostname
4284 # %l      size (in bytes) of the current mailbox *
4285 # %L      size (in bytes) of the messages shown
4286 #         (i.e., which match the current limit) *
4287 # %m      the number of messages in the mailbox *
4288 # %M      the number of messages shown (i.e., which match the current limit) *
4289 # %n      number of new messages in the mailbox *
4290 # %o      number of old unread messages *
4291 # %p      number of postponed messages *
4292 # %P      percentage of the way through the index
4293 # %r      modified/read-only/won't-write/attach-message indicator,
4294 #         according to $status_chars
4295 # %s      current sorting mode ($sort)
4296 # %S      current aux sorting method ($sort_aux)
4297 # %t      number of tagged messages *
4298 # %u      number of unread messages *
4299 # %v      Mutt version string
4300 # %V      currently active limit pattern, if any *
4301 # %>X     right justify the rest of the string and pad with ``X''
4302 # %|X     pad to the end of the line with ``X''
4303 # %*X     soft-fill with character ``X'' as pad
4304
4305
4306 # For an explanation of ``soft-fill'', see the $index_format documentation.
4307
4308 # * = can be optionally printed if nonzero
4309
4310 # Some of the above sequences can be used to optionally print a string
4311 # if their value is nonzero.  For example, you may only want to see the
4312 # number of flagged messages if such messages exist, since zero is not
4313 # particularly meaningful.  To optionally print a string based upon one
4314 # of the above sequences, the following construct is used:
4315
4316 # %?<sequence_char>?<optional_string>?
4317
4318 # where sequence_char is a character from the table above, and
4319 # optional_string is the string you would like printed if
4320 # sequence_char is nonzero.  optional_string may contain
4321 # other sequences as well as normal text, but you may not nest
4322 # optional strings.
4323
4324 # Here is an example illustrating how to optionally print the number of
4325 # new messages in a mailbox:
4326
4327 # %?n?%n new messages.?
4328
4329 # You can also switch between two strings using the following construct:
4330
4331 # %?<sequence_char>?<if_string>&<else_string>?
4332
4333 # If the value of sequence_char is non-zero, if_string will
4334 # be expanded, otherwise else_string will be expanded.
4335
4336 # You can force the result of any printf(3)-like sequence to be lowercase
4337 # by prefixing the sequence character with an underscore (``_'') sign.
4338 # For example, if you want to display the local hostname in lowercase,
4339 # you would use: ``%_h''.
4340
4341 # If you prefix the sequence character with a colon (``:'') character, mutt
4342 # will replace any dots in the expansion by underscores. This might be helpful
4343 # with IMAP folders that don't like dots in folder names.
4344
4345
4346 # set status_on_top=no
4347 #
4348 # Name: status_on_top
4349 # Type: boolean
4350 # Default: no
4351
4352
4353 # Setting this variable causes the ``status bar'' to be displayed on
4354 # the first line of the screen rather than near the bottom. If $help
4355 # is set, too it'll be placed at the bottom.
4356
4357
4358 # set strict_threads=no
4359 #
4360 # Name: strict_threads
4361 # Type: boolean
4362 # Default: no
4363
4364
4365 # If set, threading will only make use of the ``In-Reply-To'' and
4366 # ``References:'' fields when you $sort by message threads.  By
4367 # default, messages with the same subject are grouped together in
4368 # ``pseudo threads.''. This may not always be desirable, such as in a
4369 # personal mailbox where you might have several unrelated messages with
4370 # the subjects like ``hi'' which will get grouped together. See also
4371 # $sort_re for a less drastic way of controlling this
4372 # behaviour.
4373
4374
4375 # set suspend=yes
4376 #
4377 # Name: suspend
4378 # Type: boolean
4379 # Default: yes
4380
4381
4382 # When unset, mutt won't stop when the user presses the terminal's
4383 # susp key, usually ``^Z''. This is useful if you run mutt
4384 # inside an xterm using a command like ``xterm -e mutt''.
4385
4386
4387 # set text_flowed=no
4388 #
4389 # Name: text_flowed
4390 # Type: boolean
4391 # Default: no
4392
4393
4394 # When set, mutt will generate ``format=flowed'' bodies with a content type
4395 # of ``text/plain; format=flowed''.
4396 # This format is easier to handle for some mailing software, and generally
4397 # just looks like ordinary text.  To actually make use of this format's
4398 # features, you'll need support in your editor.
4399
4400 # Note that $indent_string is ignored when this option is set.
4401
4402
4403 # set thread_received=no
4404 #
4405 # Name: thread_received
4406 # Type: boolean
4407 # Default: no
4408
4409
4410 # When set, mutt uses the date received rather than the date sent
4411 # to thread messages by subject.
4412
4413
4414 # set thorough_search=no
4415 #
4416 # Name: thorough_search
4417 # Type: boolean
4418 # Default: no
4419
4420
4421 # Affects the ~b and ~h search operations described in
4422 # section ``patterns''.  If set, the headers and body/attachments of
4423 # messages to be searched are decoded before searching. If unset,
4424 # messages are searched as they appear in the folder.
4425
4426 # Users searching attachments or for non-ASCII characters should set
4427 # this value because decoding also includes MIME parsing/decoding and possible
4428 # character set conversions. Otherwise mutt will attempt to match against the
4429 # raw message received (for example quoted-printable encoded or with encoded
4430 # headers) which may lead to incorrect search results.
4431
4432
4433 # set tilde=no
4434 #
4435 # Name: tilde
4436 # Type: boolean
4437 # Default: no
4438
4439
4440 # When set, the internal-pager will pad blank lines to the bottom of the
4441 # screen with a tilde (``~'').
4442
4443
4444 # set time_inc=0
4445 #
4446 # Name: time_inc
4447 # Type: number
4448 # Default: 0
4449
4450
4451 # Along with $read_inc, $write_inc, and $net_inc, this
4452 # variable controls the frequency with which progress updates are
4453 # displayed. It suppresses updates less than $time_inc milliseconds
4454 # apart. This can improve throughput on systems with slow terminals,
4455 # or when running mutt on a remote system.
4456
4457 # Also see the ``tuning'' section of the manual for performance considerations.
4458
4459
4460 # set timeout=600
4461 #
4462 # Name: timeout
4463 # Type: number
4464 # Default: 600
4465
4466
4467 # When Mutt is waiting for user input either idleing in menus or
4468 # in an interactive prompt, Mutt would block until input is
4469 # present. Depending on the context, this would prevent certain
4470 # operations from working, like checking for new mail or keeping
4471 # an IMAP connection alive.
4472
4473 # This variable controls how many seconds Mutt will at most wait
4474 # until it aborts waiting for input, performs these operations and
4475 # continues to wait for input.
4476
4477 # A value of zero or less will cause Mutt to never time out.
4478
4479
4480 # set tmpdir=""
4481 #
4482 # Name: tmpdir
4483 # Type: path
4484 # Default: ""
4485
4486
4487 # This variable allows you to specify where Mutt will place its
4488 # temporary files needed for displaying and composing messages.  If
4489 # this variable is not set, the environment variable $TMPDIR is
4490 # used.  If $TMPDIR is not set then ``/tmp'' is used.
4491
4492
4493 # set to_chars=" +TCFL"
4494 #
4495 # Name: to_chars
4496 # Type: string
4497 # Default: " +TCFL"
4498
4499
4500 # Controls the character used to indicate mail addressed to you.  The
4501 # first character is the one used when the mail is not addressed to your
4502 # address.  The second is used when you are the only
4503 # recipient of the message.  The third is when your address
4504 # appears in the ``To:'' header field, but you are not the only recipient of
4505 # the message.  The fourth character is used when your
4506 # address is specified in the ``Cc:'' header field, but you are not the only
4507 # recipient.  The fifth character is used to indicate mail that was sent
4508 # by you.  The sixth character is used to indicate when a mail
4509 # was sent to a mailing-list you subscribe to.
4510
4511
4512 # set trash=""
4513 #
4514 # Name: trash
4515 # Type: path
4516 # Default: ""
4517
4518
4519 # If set, this variable specifies the path of the trash folder where the
4520 # mails marked for deletion will be moved, instead of being irremediably
4521 # purged.
4522
4523 # NOTE: When you delete a message in the trash folder, it is really
4524 # deleted, so that you have a way to clean the trash.
4525
4526
4527 # set tunnel=""
4528 #
4529 # Name: tunnel
4530 # Type: string
4531 # Default: ""
4532
4533
4534 # Setting this variable will cause mutt to open a pipe to a command
4535 # instead of a raw socket. You may be able to use this to set up
4536 # preauthenticated connections to your IMAP/POP3/SMTP server. Example:
4537 # set tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
4538
4539 # Note: For this example to work you must be able to log in to the remote
4540 # machine without having to enter a password.
4541
4542
4543 # set use_8bitmime=no
4544 #
4545 # Name: use_8bitmime
4546 # Type: boolean
4547 # Default: no
4548
4549
4550 # Warning: do not set this variable unless you are using a version
4551 # of sendmail which supports the -B8BITMIME flag (such as sendmail
4552 # 8.8.x) or you may not be able to send mail.
4553
4554 # When set, Mutt will invoke $sendmail with the -B8BITMIME
4555 # flag when sending 8-bit messages to enable ESMTP negotiation.
4556
4557
4558 # set use_domain=yes
4559 #
4560 # Name: use_domain
4561 # Type: boolean
4562 # Default: yes
4563
4564
4565 # When set, Mutt will qualify all local addresses (ones without the
4566 # ``@host'' portion) with the value of $hostname.  If unset, no
4567 # addresses will be qualified.
4568
4569
4570 # set use_envelope_from=no
4571 #
4572 # Name: use_envelope_from
4573 # Type: boolean
4574 # Default: no
4575
4576
4577 # When set, mutt will set the envelope sender of the message.
4578 # If $envelope_from_address is set, it will be used as the sender
4579 # address. If unset, mutt will attempt to derive the sender from the
4580 # ``From:'' header.
4581
4582 # Note that this information is passed to sendmail command using the
4583 # -f command line switch. Therefore setting this option is not useful
4584 # if the $sendmail variable already contains -f or if the
4585 # executable pointed to by $sendmail doesn't support the -f switch.
4586
4587
4588 # set use_from=yes
4589 #
4590 # Name: use_from
4591 # Type: boolean
4592 # Default: yes
4593
4594
4595 # When set, Mutt will generate the ``From:'' header field when
4596 # sending messages.  If unset, no ``From:'' header field will be
4597 # generated unless the user explicitly sets one using the ``my_hdr''
4598 # command.
4599
4600
4601 # set use_idn=yes
4602 #
4603 # Name: use_idn
4604 # Type: boolean
4605 # Default: yes
4606
4607
4608 # When set, Mutt will show you international domain names decoded.
4609 # Note: You can use IDNs for addresses even if this is unset.
4610 # This variable only affects decoding.
4611
4612
4613 # set use_ipv6=yes
4614 #
4615 # Name: use_ipv6
4616 # Type: boolean
4617 # Default: yes
4618
4619
4620 # When set, Mutt will look for IPv6 addresses of hosts it tries to
4621 # contact.  If this option is unset, Mutt will restrict itself to IPv4 addresses.
4622 # Normally, the default should work.
4623
4624
4625 # set user_agent=yes
4626 #
4627 # Name: user_agent
4628 # Type: boolean
4629 # Default: yes
4630
4631
4632 # When set, mutt will add a ``User-Agent:'' header to outgoing
4633 # messages, indicating which version of mutt was used for composing
4634 # them.
4635
4636
4637 # set visual=""
4638 #
4639 # Name: visual
4640 # Type: path
4641 # Default: ""
4642
4643
4644 # Specifies the visual editor to invoke when the ``~v'' command is
4645 # given in the builtin editor.
4646
4647
4648 # set wait_key=yes
4649 #
4650 # Name: wait_key
4651 # Type: boolean
4652 # Default: yes
4653
4654
4655 # Controls whether Mutt will ask you to press a key after an external command
4656 # has been invoked by these functions: <shell-escape>,
4657 # <pipe-message>, <pipe-entry>, <print-message>,
4658 # and <print-entry> commands.
4659
4660 # It is also used when viewing attachments with ``auto_view'', provided
4661 # that the corresponding mailcap entry has a needsterminal flag,
4662 # and the external program is interactive.
4663
4664 # When set, Mutt will always ask for a key. When unset, Mutt will wait
4665 # for a key only if the external command returned a non-zero status.
4666
4667
4668 # set weed=yes
4669 #
4670 # Name: weed
4671 # Type: boolean
4672 # Default: yes
4673
4674
4675 # When set, mutt will weed headers when displaying, forwarding,
4676 # printing, or replying to messages.
4677
4678
4679 # set wrap=0
4680 #
4681 # Name: wrap
4682 # Type: number
4683 # Default: 0
4684
4685
4686 # When set to a positive value, mutt will wrap text at $wrap characters.
4687 # When set to a negative value, mutt will wrap text so that there are $wrap
4688 # characters of empty space on the right side of the terminal.
4689
4690
4691 # set wrap_search=yes
4692 #
4693 # Name: wrap_search
4694 # Type: boolean
4695 # Default: yes
4696
4697
4698 # Controls whether searches wrap around the end.
4699
4700 # When set, searches will wrap around the first (or last) item. When
4701 # unset, incremental searches will not wrap.
4702
4703
4704 # set wrapmargin=0
4705 #
4706 # Name: wrapmargin
4707 # Type: number
4708 # Default: 0
4709
4710
4711 # (DEPRECATED) Equivalent to setting $wrap with a negative value.
4712
4713
4714 # set write_inc=10
4715 #
4716 # Name: write_inc
4717 # Type: number
4718 # Default: 10
4719
4720
4721 # When writing a mailbox, a message will be printed every
4722 # $write_inc messages to indicate progress.  If set to 0, only a
4723 # single message will be displayed before writing a mailbox.
4724
4725 # Also see the $read_inc, $net_inc and $time_inc variables and the
4726 # ``tuning'' section of the manual for performance considerations.
4727
4728
4729 # set write_bcc=yes
4730 #
4731 # Name: write_bcc
4732 # Type: boolean
4733 # Default: yes
4734
4735
4736 # Controls whether mutt writes out the ``Bcc:'' header when preparing
4737 # messages to be sent.  Exim users may wish to unset this. If mutt
4738 # is set to deliver directly via SMTP (see $smtp_url), this
4739 # option does nothing: mutt will never write out the ``Bcc:'' header
4740 # in this case.
4741
4742 # Note: On Debian systems, exim4 and postfix strip BCC headers by
4743 # default. The above warning applies to exim3 users, see /etc/Muttrc.
4744
4745
4746 # set xterm_icon="M%?n?AIL&ail?"
4747 #
4748 # Name: xterm_icon
4749 # Type: string
4750 # Default: "M%?n?AIL&ail?"
4751
4752
4753 # Controls the format of the icon title, as long as xterm_set_titles
4754 # is enabled. This string is identical in formatting to the one used by
4755 # ``$status_format''.
4756
4757
4758 # set xterm_set_titles=no
4759 #
4760 # Name: xterm_set_titles
4761 # Type: boolean
4762 # Default: no
4763
4764
4765 # Controls whether mutt sets the xterm title bar and icon name
4766 # (as long as you are in an appropriate terminal).
4767
4768
4769 # set xterm_title="Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?"
4770 #
4771 # Name: xterm_title
4772 # Type: string
4773 # Default: "Mutt with %?m?%m messages&no messages?%?n? [%n NEW]?"
4774
4775
4776 # Controls the format of the title bar of the xterm provided that
4777 # xterm_set_titles has been set. This string is identical in formatting
4778 # to the one used by ``$status_format''.
4779
4780