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