Oops, forgot to remove that before moving mutt-ng to SVN.
[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 mbox_type=mbox
1498 #
1499 # Name: mbox_type
1500 # Type: folder magic
1501 # Default: mbox
1502
1503
1504 # The default mailbox type used when creating new folders. May be any of
1505 # mbox, MMDF, MH and Maildir.
1506
1507
1508 # set metoo=no
1509 #
1510 # Name: metoo
1511 # Type: boolean
1512 # Default: no
1513
1514
1515 # If unset, Mutt will remove your address (see the ``alternates''
1516 # command) from the list of recipients when replying to a message.
1517
1518
1519 # set menu_scroll=no
1520 #
1521 # Name: menu_scroll
1522 # Type: boolean
1523 # Default: no
1524
1525
1526 # When set, menus will be scrolled up or down one line when you
1527 # attempt to move across a screen boundary.  If unset, the screen
1528 # is cleared and the next or previous page of the menu is displayed
1529 # (useful for slow links to avoid many redraws).
1530
1531
1532 # set meta_key=no
1533 #
1534 # Name: meta_key
1535 # Type: boolean
1536 # Default: no
1537
1538
1539 # If set, forces Mutt to interpret keystrokes with the high bit (bit 8)
1540 # set as if the user had pressed the ESC key and whatever key remains
1541 # after having the high bit removed.  For example, if the key pressed
1542 # has an ASCII value of 0xf4, then this is treated as if the user had
1543 # pressed ESC then ``x''.  This is because the result of removing the
1544 # high bit from ``0xf4'' is ``0x74'', which is the ASCII character
1545 # ``x''.
1546
1547
1548 # set mh_purge=no
1549 #
1550 # Name: mh_purge
1551 # Type: boolean
1552 # Default: no
1553
1554
1555 # When unset, mutt will mimic mh's behaviour and rename deleted messages
1556 # to ,<old file name> in mh folders instead of really deleting
1557 # them.  If the variable is set, the message files will simply be
1558 # deleted.
1559
1560
1561 # set mh_seq_flagged="flagged"
1562 #
1563 # Name: mh_seq_flagged
1564 # Type: string
1565 # Default: "flagged"
1566
1567
1568 # The name of the MH sequence used for flagged messages.
1569
1570
1571 # set mh_seq_replied="replied"
1572 #
1573 # Name: mh_seq_replied
1574 # Type: string
1575 # Default: "replied"
1576
1577
1578 # The name of the MH sequence used to tag replied messages.
1579
1580
1581 # set mh_seq_unseen="unseen"
1582 #
1583 # Name: mh_seq_unseen
1584 # Type: string
1585 # Default: "unseen"
1586
1587
1588 # The name of the MH sequence used for unseen messages.
1589
1590
1591 # set mime_forward=no
1592 #
1593 # Name: mime_forward
1594 # Type: quadoption
1595 # Default: no
1596
1597
1598 # When set, the message you are forwarding will be attached as a
1599 # separate MIME part instead of included in the main body of the
1600 # message.  This is useful for forwarding MIME messages so the receiver
1601 # can properly view the message as it was delivered to you. If you like
1602 # to switch between MIME and not MIME from mail to mail, set this
1603 # variable to ask-no or ask-yes.
1604
1605 # Also see ``$forward_decode'' and ``$mime_forward_decode''.
1606
1607
1608 # set mime_forward_decode=no
1609 #
1610 # Name: mime_forward_decode
1611 # Type: boolean
1612 # Default: no
1613
1614
1615 # Controls the decoding of complex MIME messages into text/plain when
1616 # forwarding a message while ``$mime_forward'' is set. Otherwise
1617 # ``$forward_decode'' is used instead.
1618
1619
1620 # set mime_forward_rest=yes
1621 #
1622 # Name: mime_forward_rest
1623 # Type: quadoption
1624 # Default: yes
1625
1626
1627 # When forwarding multiple attachments of a MIME message from the recvattach
1628 # menu, attachments which cannot be decoded in a reasonable manner will
1629 # be attached to the newly composed message if this option is set.
1630
1631
1632 # set mime_subject=yes
1633 #
1634 # Name: mime_subject
1635 # Type: boolean
1636 # Default: yes
1637
1638
1639 # If unset, 8-bit ``subject:'' line in article header will not be
1640 # encoded according to RFC2047 to base64.  This is useful when message
1641 # is Usenet article, because MIME for news is nonstandard feature.
1642
1643
1644 # set mix_entry_format="%4n %c %-16s %a"
1645 #
1646 # Name: mix_entry_format
1647 # Type: string
1648 # Default: "%4n %c %-16s %a"
1649
1650
1651 # This variable describes the format of a remailer line on the mixmaster
1652 # chain selection screen.  The following printf-like sequences are 
1653 # supported:
1654
1655 # %n      The running number on the menu.
1656 # %c      Remailer capabilities.
1657 # %s      The remailer's short name.
1658 # %a      The remailer's e-mail address.
1659
1660
1661 # set mixmaster="mixmaster"
1662 #
1663 # Name: mixmaster
1664 # Type: path
1665 # Default: "mixmaster"
1666
1667
1668 # This variable contains the path to the Mixmaster binary on your
1669 # system.  It is used with various sets of parameters to gather the
1670 # list of known remailers, and to finally send a message through the
1671 # mixmaster chain.
1672
1673
1674 # set move=ask-no
1675 #
1676 # Name: move
1677 # Type: quadoption
1678 # Default: ask-no
1679
1680
1681 # Controls whether you will be asked to confirm moving read messages
1682 # from your spool mailbox to your ``$mbox'' mailbox, or as a result of
1683 # a ``mbox-hook'' command.
1684
1685
1686 # set message_format="%s"
1687 #
1688 # Name: message_format
1689 # Type: string
1690 # Default: "%s"
1691
1692
1693 # This is the string displayed in the ``attachment'' menu for
1694 # attachments of type message/rfc822.  For a full listing of defined
1695 # printf()-like sequences see the section on ``$index_format''.
1696
1697
1698 # set narrow_tree=no
1699 #
1700 # Name: narrow_tree
1701 # Type: boolean
1702 # Default: no
1703
1704
1705 # This variable, when set, makes the thread tree narrower, allowing
1706 # deeper threads to fit on the screen.
1707
1708
1709 # set news_cache_dir="~/.mutt"
1710 #
1711 # Name: news_cache_dir
1712 # Type: path
1713 # Default: "~/.mutt"
1714
1715
1716 # This variable pointing to directory where Mutt will save cached news
1717 # articles headers in. If unset, headers will not be saved at all
1718 # and will be reloaded each time when you enter to newsgroup.
1719
1720
1721 # set news_server=""
1722 #
1723 # Name: news_server
1724 # Type: string
1725 # Default: ""
1726
1727
1728 # This variable specifies domain name or address of NNTP server. It
1729 # defaults to the newsserver specified in the environment variable
1730 # $NNTPSERVER or contained in the file /etc/nntpserver.  You can also
1731 # specify username and an alternative port for each newsserver, ie:
1732
1733 # [nntp[s]://][username[:password]@]newsserver[:port]
1734
1735
1736 # set newsrc="~/.newsrc"
1737 #
1738 # Name: newsrc
1739 # Type: path
1740 # Default: "~/.newsrc"
1741
1742
1743 # The file, containing info about subscribed newsgroups - names and
1744 # indexes of read articles.  The following printf-style sequence
1745 # is understood:
1746
1747 # %s      newsserver name
1748
1749
1750 # set nntp_context=1000
1751 #
1752 # Name: nntp_context
1753 # Type: number
1754 # Default: 1000
1755
1756
1757 # This variable defines number of articles which will be in index when
1758 # newsgroup entered.  If active newsgroup have more articles than this
1759 # number, oldest articles will be ignored.  Also controls how many
1760 # articles headers will be saved in cache when you quit newsgroup.
1761
1762
1763 # set nntp_load_description=yes
1764 #
1765 # Name: nntp_load_description
1766 # Type: boolean
1767 # Default: yes
1768
1769
1770 # This variable controls whether or not descriptions for each newsgroup
1771 # must be loaded when newsgroup is added to list (first time list
1772 # loading or new newsgroup adding).
1773
1774
1775 # set nntp_user=""
1776 #
1777 # Name: nntp_user
1778 # Type: string
1779 # Default: ""
1780
1781
1782 # Your login name on the NNTP server.  If unset and NNTP server requires
1783 # authentification, Mutt will prompt you for your account name when you
1784 # connect to newsserver.
1785
1786
1787 # set nntp_pass=""
1788 #
1789 # Name: nntp_pass
1790 # Type: string
1791 # Default: ""
1792
1793
1794 # Your password for NNTP account.
1795
1796
1797 # set nntp_poll=60
1798 #
1799 # Name: nntp_poll
1800 # Type: number
1801 # Default: 60
1802
1803
1804 # The time in seconds until any operations on newsgroup except post new
1805 # article will cause recheck for new news.  If set to 0, Mutt will
1806 # recheck newsgroup on each operation in index (stepping, read article,
1807 # etc.).
1808
1809
1810 # set nntp_reconnect=ask-yes
1811 #
1812 # Name: nntp_reconnect
1813 # Type: quadoption
1814 # Default: ask-yes
1815
1816
1817 # Controls whether or not Mutt will try to reconnect to newsserver when
1818 # connection lost.
1819
1820
1821 # set pager="builtin"
1822 #
1823 # Name: pager
1824 # Type: path
1825 # Default: "builtin"
1826
1827
1828 # This variable specifies which pager you would like to use to view
1829 # messages.  builtin means to use the builtin pager, otherwise this
1830 # variable should specify the pathname of the external pager you would
1831 # like to use.
1832
1833 # Using an external pager may have some disadvantages: Additional
1834 # keystrokes are necessary because you can't call mutt functions
1835 # directly from the pager, and screen resizes cause lines longer than
1836 # the screen width to be badly formatted in the help menu.
1837
1838
1839 # set pager_context=0
1840 #
1841 # Name: pager_context
1842 # Type: number
1843 # Default: 0
1844
1845
1846 # This variable controls the number of lines of context that are given
1847 # when displaying the next or previous page in the internal pager.  By
1848 # default, Mutt will display the line after the last one on the screen
1849 # at the top of the next page (0 lines of context).
1850
1851
1852 # set pager_format="-%Z- %C/%m: %-20.20n   %s"
1853 #
1854 # Name: pager_format
1855 # Type: string
1856 # Default: "-%Z- %C/%m: %-20.20n   %s"
1857
1858
1859 # This variable controls the format of the one-line message ``status''
1860 # displayed before each message in either the internal or an external
1861 # pager.  The valid sequences are listed in the ``$index_format''
1862 # section.
1863
1864
1865 # set pager_index_lines=0
1866 #
1867 # Name: pager_index_lines
1868 # Type: number
1869 # Default: 0
1870
1871
1872 # Determines the number of lines of a mini-index which is shown when in
1873 # the pager.  The current message, unless near the top or bottom of the
1874 # folder, will be roughly one third of the way down this mini-index,
1875 # giving the reader the context of a few messages before and after the
1876 # message.  This is useful, for example, to determine how many messages
1877 # remain to be read in the current thread.  One of the lines is reserved
1878 # for the status bar from the index, so a pager_index_lines of 6
1879 # will only show 5 lines of the actual index.  A value of 0 results in
1880 # no index being shown.  If the number of messages in the current folder
1881 # is less than pager_index_lines, then the index will only use as
1882 # many lines as it needs.
1883
1884
1885 # set pager_stop=no
1886 #
1887 # Name: pager_stop
1888 # Type: boolean
1889 # Default: no
1890
1891
1892 # When set, the internal-pager will not move to the next message
1893 # when you are at the end of a message and invoke the next-page
1894 # function.
1895
1896
1897 # set crypt_autosign=no
1898 #
1899 # Name: crypt_autosign
1900 # Type: boolean
1901 # Default: no
1902
1903
1904 # Setting this variable will cause Mutt to always attempt to
1905 # cryptographically sign outgoing messages.  This can be overridden
1906 # by use of the pgp-menu, when signing is not required or
1907 # encryption is requested as well. If ``$smime_is_default'' is set,
1908 # then OpenSSL is used instead to create S/MIME messages and settings can
1909 # be overridden by use of the smime-menu.
1910 # (Crypto only)
1911
1912
1913 # set crypt_autoencrypt=no
1914 #
1915 # Name: crypt_autoencrypt
1916 # Type: boolean
1917 # Default: no
1918
1919
1920 # Setting this variable will cause Mutt to always attempt to PGP
1921 # encrypt outgoing messages.  This is probably only useful in
1922 # connection to the send-hook command.  It can be overridden
1923 # by use of the pgp-menu, when encryption is not required or
1924 # signing is requested as well.  IF ``$smime_is_default'' is set,
1925 # then OpenSSL is used instead to create S/MIME messages and
1926 # settings can be overridden by use of the smime-menu.
1927 # (Crypto only)
1928
1929
1930 # set pgp_ignore_subkeys=yes
1931 #
1932 # Name: pgp_ignore_subkeys
1933 # Type: boolean
1934 # Default: yes
1935
1936
1937 # Setting this variable will cause Mutt to ignore OpenPGP subkeys. Instead,
1938 # the principal key will inherit the subkeys' capabilities.  Unset this
1939 # if you want to play interesting key selection games.
1940 # (PGP only)
1941
1942
1943 # set crypt_replyencrypt=yes
1944 #
1945 # Name: crypt_replyencrypt
1946 # Type: boolean
1947 # Default: yes
1948
1949
1950 # If set, automatically PGP or OpenSSL encrypt replies to messages which are
1951 # encrypted.
1952 # (Crypto only)
1953
1954
1955 # set crypt_replysign=no
1956 #
1957 # Name: crypt_replysign
1958 # Type: boolean
1959 # Default: no
1960
1961
1962 # If set, automatically PGP or OpenSSL sign replies to messages which are
1963 # signed.
1964
1965 # Note: this does not work on messages that are encrypted
1966 # and signed!
1967 # (Crypto only)
1968
1969
1970 # set crypt_replysignencrypted=no
1971 #
1972 # Name: crypt_replysignencrypted
1973 # Type: boolean
1974 # Default: no
1975
1976
1977 # If set, automatically PGP or OpenSSL sign replies to messages
1978 # which are encrypted. This makes sense in combination with
1979 # ``$crypt_replyencrypt'', because it allows you to sign all
1980 # messages which are automatically encrypted.  This works around
1981 # the problem noted in ``$crypt_replysign'', that mutt is not able
1982 # to find out whether an encrypted message is also signed.
1983 # (Crypto only)
1984
1985
1986 # set crypt_timestamp=yes
1987 #
1988 # Name: crypt_timestamp
1989 # Type: boolean
1990 # Default: yes
1991
1992
1993 # If set, mutt will include a time stamp in the lines surrounding
1994 # PGP or S/MIME output, so spoofing such lines is more difficult.
1995 # If you are using colors to mark these lines, and rely on these,
1996 # you may unset this setting.
1997 # (Crypto only)
1998
1999
2000 # set pgp_use_gpg_agent=no
2001 #
2002 # Name: pgp_use_gpg_agent
2003 # Type: boolean
2004 # Default: no
2005
2006
2007 # If set, mutt will use a possibly-running gpg-agent process.
2008 # (PGP only)
2009
2010
2011 # set crypt_verify_sig=yes
2012 #
2013 # Name: crypt_verify_sig
2014 # Type: quadoption
2015 # Default: yes
2016
2017
2018 # If ``yes'', always attempt to verify PGP or S/MIME signatures.
2019 # If ``ask'', ask whether or not to verify the signature. 
2020 # If ``no'', never attempt to verify cryptographic signatures.
2021 # (Crypto only)
2022
2023
2024 # set smime_is_default=no
2025 #
2026 # Name: smime_is_default
2027 # Type: boolean
2028 # Default: no
2029
2030
2031 # The default behaviour of mutt is to use PGP on all auto-sign/encryption
2032 # operations. To override and to use OpenSSL instead this must be set.
2033 # However, this has no effect while replying, since mutt will automatically 
2034 # select the same application that was used to sign/encrypt the original
2035 # message.  (Note that this variable can be overridden by unsetting $crypt_autosmime.)
2036 # (S/MIME only)
2037
2038
2039 # set smime_ask_cert_label=yes
2040 #
2041 # Name: smime_ask_cert_label
2042 # Type: boolean
2043 # Default: yes
2044
2045
2046 # This flag controls whether you want to be asked to enter a label
2047 # for a certificate about to be added to the database or not. It is
2048 # set by default.
2049 # (S/MIME only)
2050
2051
2052 # set smime_decrypt_use_default_key=yes
2053 #
2054 # Name: smime_decrypt_use_default_key
2055 # Type: boolean
2056 # Default: yes
2057
2058
2059 # If set (default) this tells mutt to use the default key for decryption. Otherwise,
2060 # if manage multiple certificate-key-pairs, mutt will try to use the mailbox-address
2061 # to determine the key to use. It will ask you to supply a key, if it can't find one.
2062 # (S/MIME only)
2063
2064
2065 # set pgp_entry_format="%4n %t%f %4l/0x%k %-4a %2c %u"
2066 #
2067 # Name: pgp_entry_format
2068 # Type: string
2069 # Default: "%4n %t%f %4l/0x%k %-4a %2c %u"
2070
2071
2072 # This variable allows you to customize the PGP key selection menu to
2073 # your personal taste. This string is similar to ``$index_format'', but
2074 # has its own set of printf()-like sequences:
2075
2076 # %n      number
2077 # %k      key id
2078 # %u      user id
2079 # %a      algorithm
2080 # %l      key length
2081 # %f      flags
2082 # %c      capabilities
2083 # %t      trust/validity of the key-uid association
2084 # %[<s>]  date of the key where <s> is an strftime(3) expression
2085
2086
2087 # (PGP only)
2088
2089
2090 # set pgp_good_sign=""
2091 #
2092 # Name: pgp_good_sign
2093 # Type: regular expression
2094 # Default: ""
2095
2096
2097 # If you assign a text to this variable, then a PGP signature is only
2098 # considered verified if the output from $pgp_verify_command contains
2099 # the text. Use this variable if the exit code from the command is 0
2100 # even for bad signatures.
2101 # (PGP only)
2102
2103
2104 # set pgp_check_exit=yes
2105 #
2106 # Name: pgp_check_exit
2107 # Type: boolean
2108 # Default: yes
2109
2110
2111 # If set, mutt will check the exit code of the PGP subprocess when
2112 # signing or encrypting.  A non-zero exit code means that the
2113 # subprocess failed.
2114 # (PGP only)
2115
2116
2117 # set pgp_long_ids=no
2118 #
2119 # Name: pgp_long_ids
2120 # Type: boolean
2121 # Default: no
2122
2123
2124 # If set, use 64 bit PGP key IDs. Unset uses the normal 32 bit Key IDs.
2125 # (PGP only)
2126
2127
2128 # set pgp_retainable_sigs=no
2129 #
2130 # Name: pgp_retainable_sigs
2131 # Type: boolean
2132 # Default: no
2133
2134
2135 # If set, signed and encrypted messages will consist of nested
2136 # multipart/signed and multipart/encrypted body parts.
2137
2138 # This is useful for applications like encrypted and signed mailing
2139 # lists, where the outer layer (multipart/encrypted) can be easily
2140 # removed, while the inner multipart/signed part is retained.
2141 # (PGP only)
2142
2143
2144 # set pgp_show_unusable=yes
2145 #
2146 # Name: pgp_show_unusable
2147 # Type: boolean
2148 # Default: yes
2149
2150
2151 # If set, mutt will display non-usable keys on the PGP key selection
2152 # menu.  This includes keys which have been revoked, have expired, or
2153 # have been marked as ``disabled'' by the user.
2154 # (PGP only)
2155
2156
2157 # set pgp_sign_as=""
2158 #
2159 # Name: pgp_sign_as
2160 # Type: string
2161 # Default: ""
2162
2163
2164 # If you have more than one key pair, this option allows you to specify
2165 # which of your private keys to use.  It is recommended that you use the
2166 # keyid form to specify your key (e.g., ``0x00112233'').
2167 # (PGP only)
2168
2169
2170 # set pgp_strict_enc=yes
2171 #
2172 # Name: pgp_strict_enc
2173 # Type: boolean
2174 # Default: yes
2175
2176
2177 # If set, Mutt will automatically encode PGP/MIME signed messages as
2178 # quoted-printable.  Please note that unsetting this variable may
2179 # lead to problems with non-verifyable PGP signatures, so only change
2180 # this if you know what you are doing.
2181 # (PGP only)
2182
2183
2184 # set pgp_timeout=300
2185 #
2186 # Name: pgp_timeout
2187 # Type: number
2188 # Default: 300
2189
2190
2191 # The number of seconds after which a cached passphrase will expire if
2192 # not used.
2193 # (PGP only)
2194
2195
2196 # set pgp_sort_keys=address
2197 #
2198 # Name: pgp_sort_keys
2199 # Type: sort order
2200 # Default: address
2201
2202
2203 # Specifies how the entries in the `pgp keys' menu are sorted. The
2204 # following are legal values:
2205
2206 # address sort alphabetically by user id
2207 # keyid   sort alphabetically by key id
2208 # date    sort by key creation date
2209 # trust   sort by the trust of the key
2210
2211
2212 # If you prefer reverse order of the above values, prefix it with
2213 # `reverse-'.
2214 # (PGP only)
2215
2216
2217 # set pgp_create_traditional=no
2218 #
2219 # Name: pgp_create_traditional
2220 # Type: quadoption
2221 # Default: no
2222
2223
2224 # This option controls whether Mutt generates old-style inline PGP
2225 # encrypted or signed messages.
2226
2227 # Note that PGP/MIME will be used automatically for messages which have
2228 # a character set different from us-ascii, or which consist of more than
2229 # a single MIME part.
2230
2231 # Also note that using the old-style PGP message format is strongly
2232 # deprecated.
2233 # (PGP only)
2234
2235
2236 # set pgp_auto_traditional=no
2237 #
2238 # Name: pgp_auto_traditional
2239 # Type: boolean
2240 # Default: no
2241
2242
2243 # This option causes Mutt to generate an old-style inline PGP
2244 # encrypted or signed message when replying to an old-style
2245 # message, and a PGP/MIME message when replying to a PGP/MIME
2246 # message.  Note that this option is only meaningful when using
2247 # ``$crypt_replyencrypt'', ``$crypt_replysign'', or
2248 # ``$crypt_replysignencrypted''.
2249
2250 # Also note that PGP/MIME will be used automatically for messages
2251 # which have a character set different from us-ascii, or which
2252 # consist of more than a single MIME part.
2253
2254 # This option overrides ``$pgp_create_traditional''
2255 # (PGP only)
2256
2257
2258 # set pgp_decode_command=""
2259 #
2260 # Name: pgp_decode_command
2261 # Type: string
2262 # Default: ""
2263
2264
2265 # This format strings specifies a command which is used to decode 
2266 # application/pgp attachments.
2267
2268 # The PGP command formats have their own set of printf-like sequences:
2269
2270 # %p      Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
2271 #         string otherwise. Note: This may be used with a %? construct.
2272 # %f      Expands to the name of a file containing a message.
2273 # %s      Expands to the name of a file containing the signature part
2274 #                    of a multipart/signed attachment when verifying it.
2275 # %a      The value of $pgp_sign_as.
2276 # %r      One or more key IDs.
2277
2278
2279 # For examples on how to configure these formats for the various versions
2280 # of PGP which are floating around, see the pgp*.rc and gpg.rc files in
2281 # the samples/ subdirectory which has been installed on your system
2282 # alongside the documentation.
2283 # (PGP only)
2284
2285
2286 # set pgp_getkeys_command=""
2287 #
2288 # Name: pgp_getkeys_command
2289 # Type: string
2290 # Default: ""
2291
2292
2293 # This command is invoked whenever mutt will need public key information.
2294 # %r is the only printf-like sequence used with this format.
2295 # (PGP only)
2296
2297
2298 # set pgp_verify_command=""
2299 #
2300 # Name: pgp_verify_command
2301 # Type: string
2302 # Default: ""
2303
2304
2305 # This command is used to verify PGP signatures.
2306 # (PGP only)
2307
2308
2309 # set pgp_decrypt_command=""
2310 #
2311 # Name: pgp_decrypt_command
2312 # Type: string
2313 # Default: ""
2314
2315
2316 # This command is used to decrypt a PGP encrypted message.
2317 # (PGP only)
2318
2319
2320 # set pgp_clearsign_command=""
2321 #
2322 # Name: pgp_clearsign_command
2323 # Type: string
2324 # Default: ""
2325
2326
2327 # This format is used to create a old-style "clearsigned" PGP
2328 # message.  Note that the use of this format is strongly
2329 # deprecated.
2330 # (PGP only)
2331
2332
2333 # set pgp_sign_command=""
2334 #
2335 # Name: pgp_sign_command
2336 # Type: string
2337 # Default: ""
2338
2339
2340 # This command is used to create the detached PGP signature for a 
2341 # multipart/signed PGP/MIME body part.
2342 # (PGP only)
2343
2344
2345 # set pgp_encrypt_sign_command=""
2346 #
2347 # Name: pgp_encrypt_sign_command
2348 # Type: string
2349 # Default: ""
2350
2351
2352 # This command is used to both sign and encrypt a body part.
2353 # (PGP only)
2354
2355
2356 # set pgp_encrypt_only_command=""
2357 #
2358 # Name: pgp_encrypt_only_command
2359 # Type: string
2360 # Default: ""
2361
2362
2363 # This command is used to encrypt a body part without signing it.
2364 # (PGP only)
2365
2366
2367 # set pgp_import_command=""
2368 #
2369 # Name: pgp_import_command
2370 # Type: string
2371 # Default: ""
2372
2373
2374 # This command is used to import a key from a message into 
2375 # the user's public key ring.
2376 # (PGP only)
2377
2378
2379 # set pgp_export_command=""
2380 #
2381 # Name: pgp_export_command
2382 # Type: string
2383 # Default: ""
2384
2385
2386 # This command is used to export a public key from the user's
2387 # key ring.
2388 # (PGP only)
2389
2390
2391 # set pgp_verify_key_command=""
2392 #
2393 # Name: pgp_verify_key_command
2394 # Type: string
2395 # Default: ""
2396
2397
2398 # This command is used to verify key information from the key selection
2399 # menu.
2400 # (PGP only)
2401
2402
2403 # set pgp_list_secring_command=""
2404 #
2405 # Name: pgp_list_secring_command
2406 # Type: string
2407 # Default: ""
2408
2409
2410 # This command is used to list the secret key ring's contents.  The
2411 # output format must be analogous to the one used by 
2412 # gpg --list-keys --with-colons.
2413
2414 # This format is also generated by the pgpring utility which comes 
2415 # with mutt.
2416 # (PGP only)
2417
2418
2419 # set pgp_list_pubring_command=""
2420 #
2421 # Name: pgp_list_pubring_command
2422 # Type: string
2423 # Default: ""
2424
2425
2426 # This command is used to list the public key ring's contents.  The
2427 # output format must be analogous to the one used by 
2428 # gpg --list-keys --with-colons.
2429
2430 # This format is also generated by the pgpring utility which comes 
2431 # with mutt.
2432 # (PGP only)
2433
2434
2435 # set forward_decrypt=yes
2436 #
2437 # Name: forward_decrypt
2438 # Type: boolean
2439 # Default: yes
2440
2441
2442 # Controls the handling of encrypted messages when forwarding a message.
2443 # When set, the outer layer of encryption is stripped off.  This
2444 # variable is only used if ``$mime_forward'' is set and
2445 # ``$mime_forward_decode'' is unset.
2446 # (PGP only)
2447
2448
2449 # set smime_timeout=300
2450 #
2451 # Name: smime_timeout
2452 # Type: number
2453 # Default: 300
2454
2455
2456 # The number of seconds after which a cached passphrase will expire if
2457 # not used.
2458 # (S/MIME only)
2459
2460
2461 # set smime_encrypt_with=""
2462 #
2463 # Name: smime_encrypt_with
2464 # Type: string
2465 # Default: ""
2466
2467
2468 # This sets the algorithm that should be used for encryption.
2469 # Valid choices are "des", "des3", "rc2-40", "rc2-64", "rc2-128".
2470 # If unset "3des" (TripleDES) is used.
2471 # (S/MIME only)
2472
2473
2474 # set smime_keys=""
2475 #
2476 # Name: smime_keys
2477 # Type: path
2478 # Default: ""
2479
2480
2481 # Since there is no pubring/secring as with PGP, mutt has to handle
2482 # storage ad retrieval of keys/certs by itself. This is very basic right now,
2483 # and stores keys and certificates in two different directories, both
2484 # named as the hash-value retrieved from OpenSSL. There is an index file
2485 # which contains mailbox-address keyid pair, and which can be manually
2486 # edited. This one points to the location of the private keys.
2487 # (S/MIME only)
2488
2489
2490 # set smime_ca_location=""
2491 #
2492 # Name: smime_ca_location
2493 # Type: path
2494 # Default: ""
2495
2496
2497 # This variable contains the name of either a directory, or a file which
2498 # contains trusted certificates for use with OpenSSL.
2499 # (S/MIME only)
2500
2501
2502 # set smime_certificates=""
2503 #
2504 # Name: smime_certificates
2505 # Type: path
2506 # Default: ""
2507
2508
2509 # Since there is no pubring/secring as with PGP, mutt has to handle
2510 # storage and retrieval of keys by itself. This is very basic right
2511 # now, and keys and certificates are stored in two different
2512 # directories, both named as the hash-value retrieved from
2513 # OpenSSL. There is an index file which contains mailbox-address
2514 # keyid pairs, and which can be manually edited. This one points to
2515 # the location of the certificates.
2516 # (S/MIME only)
2517
2518
2519 # set smime_decrypt_command=""
2520 #
2521 # Name: smime_decrypt_command
2522 # Type: string
2523 # Default: ""
2524
2525
2526 # This format string specifies a command which is used to decrypt
2527 # application/x-pkcs7-mime attachments.
2528
2529 # The OpenSSL command formats have their own set of printf-like sequences
2530 # similar to PGP's:
2531
2532 # %f      Expands to the name of a file containing a message.
2533 # %s      Expands to the name of a file containing the signature part
2534 #                    of a multipart/signed attachment when verifying it.
2535 # %k      The key-pair specified with $smime_default_key
2536 # %c      One or more certificate IDs.
2537 # %a      The algorithm used for encryption.
2538 # %C      CA location:  Depending on whether $smime_ca_location
2539 #                    points to a directory or file, this expands to 
2540 #                    "-CApath $smime_ca_location" or "-CAfile $smime_ca_location".
2541
2542
2543 # For examples on how to configure these formats, see the smime.rc in
2544 # the samples/ subdirectory which has been installed on your system
2545 # alongside the documentation.
2546 # (S/MIME only)
2547
2548
2549 # set smime_verify_command=""
2550 #
2551 # Name: smime_verify_command
2552 # Type: string
2553 # Default: ""
2554
2555
2556 # This command is used to verify S/MIME signatures of type multipart/signed.
2557 # (S/MIME only)
2558
2559
2560 # set smime_verify_opaque_command=""
2561 #
2562 # Name: smime_verify_opaque_command
2563 # Type: string
2564 # Default: ""
2565
2566
2567 # This command is used to verify S/MIME signatures of type
2568 # application/x-pkcs7-mime.
2569 # (S/MIME only)
2570
2571
2572 # set smime_sign_command=""
2573 #
2574 # Name: smime_sign_command
2575 # Type: string
2576 # Default: ""
2577
2578
2579 # This command is used to created S/MIME signatures of type
2580 # multipart/signed, which can be read by all mail clients.
2581 # (S/MIME only)
2582
2583
2584 # set smime_sign_opaque_command=""
2585 #
2586 # Name: smime_sign_opaque_command
2587 # Type: string
2588 # Default: ""
2589
2590
2591 # This command is used to created S/MIME signatures of type
2592 # application/x-pkcs7-signature, which can only be handled by mail
2593 # clients supporting the S/MIME extension.
2594 # (S/MIME only)
2595
2596
2597 # set smime_encrypt_command=""
2598 #
2599 # Name: smime_encrypt_command
2600 # Type: string
2601 # Default: ""
2602
2603
2604 # This command is used to create encrypted S/MIME messages.
2605 # (S/MIME only)
2606
2607
2608 # set smime_pk7out_command=""
2609 #
2610 # Name: smime_pk7out_command
2611 # Type: string
2612 # Default: ""
2613
2614
2615 # This command is used to extract PKCS7 structures of S/MIME signatures,
2616 # in order to extract the public X509 certificate(s).
2617 # (S/MIME only)
2618
2619
2620 # set smime_get_cert_command=""
2621 #
2622 # Name: smime_get_cert_command
2623 # Type: string
2624 # Default: ""
2625
2626
2627 # This command is used to extract X509 certificates from a PKCS7 structure.
2628 # (S/MIME only)
2629
2630
2631 # set smime_get_signer_cert_command=""
2632 #
2633 # Name: smime_get_signer_cert_command
2634 # Type: string
2635 # Default: ""
2636
2637
2638 # This command is used to extract only the signers X509 certificate from a S/MIME
2639 # signature, so that the certificate's owner may get compared to the email's 
2640 # 'From'-field.
2641 # (S/MIME only)
2642
2643
2644 # set smime_import_cert_command=""
2645 #
2646 # Name: smime_import_cert_command
2647 # Type: string
2648 # Default: ""
2649
2650
2651 # This command is used to import a certificate via smime_keys.
2652 # (S/MIME only)
2653
2654
2655 # set smime_get_cert_email_command=""
2656 #
2657 # Name: smime_get_cert_email_command
2658 # Type: string
2659 # Default: ""
2660
2661
2662 # This command is used to extract the mail address(es) used for storing
2663 # X509 certificates, and for verification purposes (to check whether the
2664 # certificate was issued for the sender's mailbox).
2665 # (S/MIME only)
2666
2667
2668 # set smime_default_key=""
2669 #
2670 # Name: smime_default_key
2671 # Type: string
2672 # Default: ""
2673
2674
2675 # This is the default key-pair to use for signing. This must be set to the
2676 # keyid (the hash-value that OpenSSL generates) to work properly
2677 # (S/MIME only)
2678
2679
2680 # set ssl_starttls=yes
2681 #
2682 # Name: ssl_starttls
2683 # Type: quadoption
2684 # Default: yes
2685
2686
2687 # If set (the default), mutt will attempt to use STARTTLS on servers
2688 # advertising the capability. When unset, mutt will not attempt to
2689 # use STARTTLS regardless of the server's capabilities.
2690
2691
2692 # set certificate_file=""
2693 #
2694 # Name: certificate_file
2695 # Type: path
2696 # Default: ""
2697
2698
2699 # This variable specifies the file where the certificates you trust
2700 # are saved. When an unknown certificate is encountered, you are asked
2701 # if you accept it or not. If you accept it, the certificate can also 
2702 # be saved in this file and further connections are automatically 
2703 # accepted.
2704
2705 # You can also manually add CA certificates in this file. Any server
2706 # certificate that is signed with one of these CA certificates are 
2707 # also automatically accepted.
2708
2709 # Example: set certificate_file=~/.mutt/certificates
2710
2711
2712 # set ssl_usesystemcerts=yes
2713 #
2714 # Name: ssl_usesystemcerts
2715 # Type: boolean
2716 # Default: yes
2717
2718
2719 # If set to yes, mutt will use CA certificates in the
2720 # system-wide certificate store when checking if server certificate 
2721 # is signed by a trusted CA.
2722
2723
2724 # set entropy_file=""
2725 #
2726 # Name: entropy_file
2727 # Type: path
2728 # Default: ""
2729
2730
2731 # The file which includes random data that is used to initialize SSL
2732 # library functions.
2733
2734
2735 # set ssl_use_sslv2=yes
2736 #
2737 # Name: ssl_use_sslv2
2738 # Type: boolean
2739 # Default: yes
2740
2741
2742 # This variables specifies whether to attempt to use SSLv2 in the
2743 # SSL authentication process.
2744
2745
2746 # set ssl_use_sslv3=yes
2747 #
2748 # Name: ssl_use_sslv3
2749 # Type: boolean
2750 # Default: yes
2751
2752
2753 # This variables specifies whether to attempt to use SSLv3 in the
2754 # SSL authentication process.
2755
2756
2757 # set ssl_use_tlsv1=yes
2758 #
2759 # Name: ssl_use_tlsv1
2760 # Type: boolean
2761 # Default: yes
2762
2763
2764 # This variables specifies whether to attempt to use TLSv1 in the
2765 # SSL authentication process.
2766
2767
2768 # set pipe_split=no
2769 #
2770 # Name: pipe_split
2771 # Type: boolean
2772 # Default: no
2773
2774
2775 # Used in connection with the pipe-message command and the ``tag-
2776 # prefix'' operator.  If this variable is unset, when piping a list of
2777 # tagged messages Mutt will concatenate the messages and will pipe them
2778 # as a single folder.  When set, Mutt will pipe the messages one by one.
2779 # In both cases the messages are piped in the current sorted order,
2780 # and the ``$pipe_sep'' separator is added after each message.
2781
2782
2783 # set pipe_decode=no
2784 #
2785 # Name: pipe_decode
2786 # Type: boolean
2787 # Default: no
2788
2789
2790 # Used in connection with the pipe-message command.  When unset,
2791 # Mutt will pipe the messages without any preprocessing. When set, Mutt
2792 # will weed headers and will attempt to PGP/MIME decode the messages
2793 # first.
2794
2795
2796 # set pipe_sep="\n"
2797 #
2798 # Name: pipe_sep
2799 # Type: string
2800 # Default: "\n"
2801
2802
2803 # The separator to add between messages when piping a list of tagged
2804 # messages to an external Unix command.
2805
2806
2807 # set pop_authenticators=""
2808 #
2809 # Name: pop_authenticators
2810 # Type: string
2811 # Default: ""
2812
2813
2814 # This is a colon-delimited list of authentication methods mutt may
2815 # attempt to use to log in to an POP server, in the order mutt should
2816 # try them.  Authentication methods are either 'user', 'apop' or any
2817 # SASL mechanism, eg 'digest-md5', 'gssapi' or 'cram-md5'.
2818 # This parameter is case-insensitive. If this parameter is unset
2819 # (the default) mutt will try all available methods, in order from
2820 # most-secure to least-secure.
2821
2822 # Example: set pop_authenticators="digest-md5:apop:user"
2823
2824
2825 # set pop_auth_try_all=yes
2826 #
2827 # Name: pop_auth_try_all
2828 # Type: boolean
2829 # Default: yes
2830
2831
2832 # If set, Mutt will try all available methods. When unset, Mutt will
2833 # only fall back to other authentication methods if the previous
2834 # methods are unavailable. If a method is available but authentication
2835 # fails, Mutt will not connect to the POP server.
2836
2837
2838 # set pop_checkinterval=60
2839 #
2840 # Name: pop_checkinterval
2841 # Type: number
2842 # Default: 60
2843
2844
2845 # This variable configures how often (in seconds) POP should look for
2846 # new mail.
2847
2848
2849 # set pop_delete=ask-no
2850 #
2851 # Name: pop_delete
2852 # Type: quadoption
2853 # Default: ask-no
2854
2855
2856 # If set, Mutt will delete successfully downloaded messages from the POP
2857 # server when using the fetch-mail function.  When unset, Mutt will
2858 # download messages but also leave them on the POP server.
2859
2860
2861 # set pop_host=""
2862 #
2863 # Name: pop_host
2864 # Type: string
2865 # Default: ""
2866
2867
2868 # The name of your POP server for the fetch-mail function.  You
2869 # can also specify an alternative port, username and password, ie:
2870
2871 # [pop[s]://][username[:password]@]popserver[:port]
2872
2873
2874 # set pop_last=no
2875 #
2876 # Name: pop_last
2877 # Type: boolean
2878 # Default: no
2879
2880
2881 # If this variable is set, mutt will try to use the "LAST" POP command
2882 # for retrieving only unread messages from the POP server when using
2883 # the fetch-mail function.
2884
2885
2886 # set pop_reconnect=ask-yes
2887 #
2888 # Name: pop_reconnect
2889 # Type: quadoption
2890 # Default: ask-yes
2891
2892
2893 # Controls whether or not Mutt will try to reconnect to POP server when
2894 # connection lost.
2895
2896
2897 # set pop_user=""
2898 #
2899 # Name: pop_user
2900 # Type: string
2901 # Default: ""
2902
2903
2904 # Your login name on the POP server.
2905
2906 # This variable defaults to your user name on the local machine.
2907
2908
2909 # set pop_pass=""
2910 #
2911 # Name: pop_pass
2912 # Type: string
2913 # Default: ""
2914
2915
2916 # Specifies the password for your POP account.  If unset, Mutt will
2917 # prompt you for your password when you open POP mailbox.
2918 # Warning: you should only use this option when you are on a
2919 # fairly secure machine, because the superuser can read your muttrc
2920 # even if you are the only one who can read the file.
2921
2922
2923 # set post_indent_string=""
2924 #
2925 # Name: post_indent_string
2926 # Type: string
2927 # Default: ""
2928
2929
2930 # Similar to the ``$attribution'' variable, Mutt will append this
2931 # string after the inclusion of a message which is being replied to.
2932
2933
2934 # set post_moderated=ask-yes
2935 #
2936 # Name: post_moderated
2937 # Type: quadoption
2938 # Default: ask-yes
2939
2940
2941 # If set to yes, Mutt will post article to newsgroup that have
2942 # not permissions to posting (e.g. moderated).  Note: if newsserver
2943 # does not support posting to that newsgroup or totally read-only, that
2944 # posting will not have an effect.
2945
2946
2947 # set postpone=ask-yes
2948 #
2949 # Name: postpone
2950 # Type: quadoption
2951 # Default: ask-yes
2952
2953
2954 # Controls whether or not messages are saved in the ``$postponed''
2955 # mailbox when you elect not to send immediately.
2956
2957
2958 # set postponed="~/postponed"
2959 #
2960 # Name: postponed
2961 # Type: path
2962 # Default: "~/postponed"
2963
2964
2965 # Mutt allows you to indefinitely ``postpone sending a message'' which
2966 # you are editing.  When you choose to postpone a message, Mutt saves it
2967 # in the mailbox specified by this variable.  Also see the ``$postpone''
2968 # variable.
2969
2970
2971 # set preconnect=""
2972 #
2973 # Name: preconnect
2974 # Type: string
2975 # Default: ""
2976
2977
2978 # If set, a shell command to be executed if mutt fails to establish
2979 # a connection to the server. This is useful for setting up secure
2980 # connections, e.g. with ssh(1). If the command returns a  nonzero
2981 # status, mutt gives up opening the server. Example:
2982
2983 # preconnect="ssh -f -q -L 1234:mailhost.net:143 mailhost.net
2984 # sleep 20 < /dev/null > /dev/null"
2985
2986 # Mailbox 'foo' on mailhost.net can now be reached
2987 # as '{localhost:1234}foo'.
2988
2989 # NOTE: For this example to work, you must be able to log in to the
2990 # remote machine without having to enter a password.
2991
2992
2993 # set print=ask-no
2994 #
2995 # Name: print
2996 # Type: quadoption
2997 # Default: ask-no
2998
2999
3000 # Controls whether or not Mutt asks for confirmation before printing.
3001 # This is useful for people (like me) who accidentally hit ``p'' often.
3002
3003
3004 # set print_command="lpr"
3005 #
3006 # Name: print_command
3007 # Type: path
3008 # Default: "lpr"
3009
3010
3011 # This specifies the command pipe that should be used to print messages.
3012
3013
3014 # set print_decode=yes
3015 #
3016 # Name: print_decode
3017 # Type: boolean
3018 # Default: yes
3019
3020
3021 # Used in connection with the print-message command.  If this
3022 # option is set, the message is decoded before it is passed to the
3023 # external command specified by $print_command.  If this option
3024 # is unset, no processing will be applied to the message when
3025 # printing it.  The latter setting may be useful if you are using
3026 # some advanced printer filter which is able to properly format
3027 # e-mail messages for printing.
3028
3029
3030 # set print_split=no
3031 #
3032 # Name: print_split
3033 # Type: boolean
3034 # Default: no
3035
3036
3037 # Used in connection with the print-message command.  If this option
3038 # is set, the command specified by $print_command is executed once for
3039 # each message which is to be printed.  If this option is unset, 
3040 # the command specified by $print_command is executed only once, and
3041 # all the messages are concatenated, with a form feed as the message
3042 # separator.
3043
3044 # Those who use the enscript(1) program's mail-printing mode will
3045 # most likely want to set this option.
3046
3047
3048 # set prompt_after=yes
3049 #
3050 # Name: prompt_after
3051 # Type: boolean
3052 # Default: yes
3053
3054
3055 # If you use an external ``$pager'', setting this variable will
3056 # cause Mutt to prompt you for a command when the pager exits rather
3057 # than returning to the index menu.  If unset, Mutt will return to the
3058 # index menu when the external pager exits.
3059
3060
3061 # set query_command=""
3062 #
3063 # Name: query_command
3064 # Type: path
3065 # Default: ""
3066
3067
3068 # This specifies the command that mutt will use to make external address
3069 # queries.  The string should contain a %s, which will be substituted
3070 # with the query string the user types.  See ``query'' for more
3071 # information.
3072
3073
3074 # set quit=yes
3075 #
3076 # Name: quit
3077 # Type: quadoption
3078 # Default: yes
3079
3080
3081 # This variable controls whether ``quit'' and ``exit'' actually quit
3082 # from mutt.  If it set to yes, they do quit, if it is set to no, they
3083 # have no effect, and if it is set to ask-yes or ask-no, you are
3084 # prompted for confirmation when you try to quit.
3085
3086
3087 # set quote_regexp="^([ \t]*[|>:}#])+"
3088 #
3089 # Name: quote_regexp
3090 # Type: regular expression
3091 # Default: "^([ \t]*[|>:}#])+"
3092
3093
3094 # A regular expression used in the internal-pager to determine quoted
3095 # sections of text in the body of a message.
3096
3097 # Note: In order to use the quotedx patterns in the
3098 # internal pager, you need to set this to a regular expression that
3099 # matches exactly the quote characters at the beginning of quoted
3100 # lines.
3101
3102
3103 # set read_inc=10
3104 #
3105 # Name: read_inc
3106 # Type: number
3107 # Default: 10
3108
3109
3110 # If set to a value greater than 0, Mutt will display which message it
3111 # is currently on when reading a mailbox.  The message is printed after
3112 # read_inc messages have been read (e.g., if set to 25, Mutt will
3113 # print a message when it reads message 25, and then again when it gets
3114 # to message 50).  This variable is meant to indicate progress when
3115 # reading large mailboxes which may take some time.
3116 # When set to 0, only a single message will appear before the reading
3117 # the mailbox.
3118
3119 # Also see the ``$write_inc'' variable.
3120
3121
3122 # set read_only=no
3123 #
3124 # Name: read_only
3125 # Type: boolean
3126 # Default: no
3127
3128
3129 # If set, all folders are opened in read-only mode.
3130
3131
3132 # set realname=""
3133 #
3134 # Name: realname
3135 # Type: string
3136 # Default: ""
3137
3138
3139 # This variable specifies what "real" or "personal" name should be used
3140 # when sending messages.
3141
3142 # By default, this is the GECOS field from /etc/passwd.  Note that this
3143 # variable will not be used when the user has set a real name
3144 # in the $from variable.
3145
3146
3147 # set recall=ask-yes
3148 #
3149 # Name: recall
3150 # Type: quadoption
3151 # Default: ask-yes
3152
3153
3154 # Controls whether or not you are prompted to recall postponed messages
3155 # when composing a new message.  Also see ``$postponed''.
3156
3157 # Setting this variable to ``yes'' is not generally useful, and thus not
3158 # recommended.
3159
3160
3161 # set record=""
3162 #
3163 # Name: record
3164 # Type: path
3165 # Default: ""
3166
3167
3168 # This specifies the file into which your outgoing messages should be
3169 # appended.  (This is meant as the primary method for saving a copy of
3170 # your messages, but another way to do this is using the ``my_hdr''
3171 # command to create a Bcc: field with your email address in it.)
3172
3173 # The value of $record is overridden by the ``$force_name'' and
3174 # ``$save_name'' variables, and the ``fcc-hook'' command.
3175
3176
3177 # set reply_regexp="^(re([\\[0-9\\]+])*|aw):[ \t]*"
3178 #
3179 # Name: reply_regexp
3180 # Type: regular expression
3181 # Default: "^(re([\\[0-9\\]+])*|aw):[ \t]*"
3182
3183
3184 # A regular expression used to recognize reply messages when threading
3185 # and replying. The default value corresponds to the English "Re:" and
3186 # the German "Aw:".
3187
3188
3189 # set reply_self=no
3190 #
3191 # Name: reply_self
3192 # Type: boolean
3193 # Default: no
3194
3195
3196 # If unset and you are replying to a message sent by you, Mutt will
3197 # assume that you want to reply to the recipients of that message rather
3198 # than to yourself.
3199
3200
3201 # set reply_to=ask-yes
3202 #
3203 # Name: reply_to
3204 # Type: quadoption
3205 # Default: ask-yes
3206
3207
3208 # If set, Mutt will ask you if you want to use the address listed in the
3209 # Reply-To: header field when replying to a message.  If you answer no,
3210 # it will use the address in the From: header field instead.  This
3211 # option is useful for reading a mailing list that sets the Reply-To:
3212 # header field to the list address and you want to send a private
3213 # message to the author of a message.
3214
3215
3216 # set resolve=yes
3217 #
3218 # Name: resolve
3219 # Type: boolean
3220 # Default: yes
3221
3222
3223 # When set, the cursor will be automatically advanced to the next
3224 # (possibly undeleted) message whenever a command that modifies the
3225 # current message is executed.
3226
3227
3228 # set reverse_alias=no
3229 #
3230 # Name: reverse_alias
3231 # Type: boolean
3232 # Default: no
3233
3234
3235 # This variable controls whether or not Mutt will display the "personal"
3236 # name from your aliases in the index menu if it finds an alias that
3237 # matches the message's sender.  For example, if you have the following
3238 # alias:
3239
3240 # alias juser abd30425@somewhere.net (Joe User)
3241
3242 # and then you receive mail which contains the following header:
3243
3244 # From: abd30425@somewhere.net
3245
3246 # It would be displayed in the index menu as ``Joe User'' instead of
3247 # ``abd30425@somewhere.net.''  This is useful when the person's e-mail
3248 # address is not human friendly (like CompuServe addresses).
3249
3250
3251 # set reverse_name=no
3252 #
3253 # Name: reverse_name
3254 # Type: boolean
3255 # Default: no
3256
3257
3258 # It may sometimes arrive that you receive mail to a certain machine,
3259 # move the messages to another machine, and reply to some the messages
3260 # from there.  If this variable is set, the default From: line of
3261 # the reply messages is built using the address where you received the
3262 # messages you are replying to.  If the variable is unset, the
3263 # From: line will use your address on the current machine.
3264
3265
3266 # set reverse_realname=yes
3267 #
3268 # Name: reverse_realname
3269 # Type: boolean
3270 # Default: yes
3271
3272
3273 # This variable fine-tunes the behaviour of the reverse_name feature.
3274 # When it is set, mutt will use the address from incoming messages as-is,
3275 # possibly including eventual real names.  When it is unset, mutt will
3276 # override any such real names with the setting of the realname variable.
3277
3278
3279 # set rfc2047_parameters=no
3280 #
3281 # Name: rfc2047_parameters
3282 # Type: boolean
3283 # Default: no
3284
3285
3286 # When this variable is set, Mutt will decode RFC-2047-encoded MIME 
3287 # parameters. You want to set this variable when mutt suggests you
3288 # to save attachments to files named like this: 
3289 # =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
3290
3291 # When this variable is set interactively, the change doesn't have
3292 # the desired effect before you have changed folders.
3293
3294 # Note that this use of RFC 2047's encoding is explicitly,
3295 # prohibited by the standard, but nevertheless encountered in the
3296 # wild.
3297 # Also note that setting this parameter will not have the effect 
3298 # that mutt generates this kind of encoding.  Instead, mutt will
3299 # unconditionally use the encoding specified in RFC 2231.
3300
3301
3302 # set save_address=no
3303 #
3304 # Name: save_address
3305 # Type: boolean
3306 # Default: no
3307
3308
3309 # If set, mutt will take the sender's full address when choosing a
3310 # default folder for saving a mail. If ``$save_name'' or ``$force_name''
3311 # is set too, the selection of the fcc folder will be changed as well.
3312
3313
3314 # set save_empty=yes
3315 #
3316 # Name: save_empty
3317 # Type: boolean
3318 # Default: yes
3319
3320
3321 # When unset, mailboxes which contain no saved messages will be removed
3322 # when closed (the exception is ``$spoolfile'' which is never removed).
3323 # If set, mailboxes are never removed.
3324
3325 # Note: This only applies to mbox and MMDF folders, Mutt does not
3326 # delete MH and Maildir directories.
3327
3328
3329 # set save_name=no
3330 #
3331 # Name: save_name
3332 # Type: boolean
3333 # Default: no
3334
3335
3336 # This variable controls how copies of outgoing messages are saved.
3337 # When set, a check is made to see if a mailbox specified by the
3338 # recipient address exists (this is done by searching for a mailbox in
3339 # the ``$folder'' directory with the username part of the
3340 # recipient address).  If the mailbox exists, the outgoing message will
3341 # be saved to that mailbox, otherwise the message is saved to the
3342 # ``$record'' mailbox.
3343
3344 # Also see the ``$force_name'' variable.
3345
3346
3347 # set score=yes
3348 #
3349 # Name: score
3350 # Type: boolean
3351 # Default: yes
3352
3353
3354 # When this variable is unset, scoring is turned off.  This can
3355 # be useful to selectively disable scoring for certain folders when the
3356 # ``$score_threshold_delete'' variable and friends are used.
3357
3358
3359 # set score_threshold_delete=-1
3360 #
3361 # Name: score_threshold_delete
3362 # Type: number
3363 # Default: -1
3364
3365
3366 # Messages which have been assigned a score equal to or lower than the value
3367 # of this variable are automatically marked for deletion by mutt.  Since
3368 # mutt scores are always greater than or equal to zero, the default setting
3369 # of this variable will never mark a message for deletion.
3370
3371
3372 # set score_threshold_flag=9999
3373 #
3374 # Name: score_threshold_flag
3375 # Type: number
3376 # Default: 9999
3377
3378
3379 # Messages which have been assigned a score greater than or equal to this 
3380 # variable's value are automatically marked "flagged".
3381
3382
3383 # set score_threshold_read=-1
3384 #
3385 # Name: score_threshold_read
3386 # Type: number
3387 # Default: -1
3388
3389
3390 # Messages which have been assigned a score equal to or lower than the value
3391 # of this variable are automatically marked as read by mutt.  Since
3392 # mutt scores are always greater than or equal to zero, the default setting
3393 # of this variable will never mark a message read.
3394
3395
3396 # set send_charset="us-ascii:iso-8859-1:utf-8"
3397 #
3398 # Name: send_charset
3399 # Type: string
3400 # Default: "us-ascii:iso-8859-1:utf-8"
3401
3402
3403 # A list of character sets for outgoing messages. Mutt will use the
3404 # first character set into which the text can be converted exactly.
3405 # If your ``$charset'' is not iso-8859-1 and recipients may not
3406 # understand UTF-8, it is advisable to include in the list an
3407 # appropriate widely used standard character set (such as
3408 # iso-8859-2, koi8-r or iso-2022-jp) either instead of or after
3409 # "iso-8859-1".
3410
3411
3412 # set sendmail="/usr/sbin/sendmail -oem -oi"
3413 #
3414 # Name: sendmail
3415 # Type: path
3416 # Default: "/usr/sbin/sendmail -oem -oi"
3417
3418
3419 # Specifies the program and arguments used to deliver mail sent by Mutt.
3420 # Mutt expects that the specified program interprets additional
3421 # arguments as recipient addresses.
3422
3423
3424 # set sendmail_wait=0
3425 #
3426 # Name: sendmail_wait
3427 # Type: number
3428 # Default: 0
3429
3430
3431 # Specifies the number of seconds to wait for the ``$sendmail'' process
3432 # to finish before giving up and putting delivery in the background.
3433
3434 # Mutt interprets the value of this variable as follows:
3435 # >0      number of seconds to wait for sendmail to finish before continuing
3436 # 0       wait forever for sendmail to finish
3437 # <0      always put sendmail in the background without waiting
3438
3439
3440 # Note that if you specify a value other than 0, the output of the child
3441 # process will be put in a temporary file.  If there is some error, you
3442 # will be informed as to where to find the output.
3443
3444
3445 # set shell=""
3446 #
3447 # Name: shell
3448 # Type: path
3449 # Default: ""
3450
3451
3452 # Command to use when spawning a subshell.  By default, the user's login
3453 # shell from /etc/passwd is used.
3454
3455
3456 # set save_unsubscribed=no
3457 #
3458 # Name: save_unsubscribed
3459 # Type: boolean
3460 # Default: no
3461
3462
3463 # When set, info about unsubscribed newsgroups will be saved into
3464 # ``newsrc'' file and into cache.
3465
3466
3467 # set show_new_news=yes
3468 #
3469 # Name: show_new_news
3470 # Type: boolean
3471 # Default: yes
3472
3473
3474 # If set, newsserver will be asked for new newsgroups on entering
3475 # the browser.  Otherwise, it will be done only once for a newsserver.
3476 # Also controls whether or not number of new articles of subscribed
3477 # newsgroups will be then checked.
3478
3479
3480 # set show_only_unread=no
3481 #
3482 # Name: show_only_unread
3483 # Type: boolean
3484 # Default: no
3485
3486
3487 # If set, only subscribed newsgroups that contain unread articles
3488 # will be displayed in browser.
3489
3490
3491 # set sig_dashes=yes
3492 #
3493 # Name: sig_dashes
3494 # Type: boolean
3495 # Default: yes
3496
3497
3498 # If set, a line containing ``-- '' will be inserted before your
3499 # ``$signature''.  It is strongly recommended that you not unset
3500 # this variable unless your ``signature'' contains just your name.  The
3501 # reason for this is because many software packages use ``-- \n'' to
3502 # detect your signature.  For example, Mutt has the ability to highlight
3503 # the signature in a different color in the builtin pager.
3504
3505
3506 # set sig_on_top=no
3507 #
3508 # Name: sig_on_top
3509 # Type: boolean
3510 # Default: no
3511
3512
3513 # If set, the signature will be included before any quoted or forwarded
3514 # text.  It is strongly recommended that you do not set this variable
3515 # unless you really know what you are doing, and are prepared to take
3516 # some heat from netiquette guardians.
3517
3518
3519 # set signature="~/.signature"
3520 #
3521 # Name: signature
3522 # Type: path
3523 # Default: "~/.signature"
3524
3525
3526 # Specifies the filename of your signature, which is appended to all
3527 # outgoing messages.   If the filename ends with a pipe (``|''), it is
3528 # assumed that filename is a shell command and input should be read from
3529 # its stdout.
3530
3531
3532 # set simple_search="~f %s | ~s %s"
3533 #
3534 # Name: simple_search
3535 # Type: string
3536 # Default: "~f %s | ~s %s"
3537
3538
3539 # Specifies how Mutt should expand a simple search into a real search
3540 # pattern.  A simple search is one that does not contain any of the ~
3541 # operators.  See ``patterns'' for more information on search patterns.
3542
3543 # For example, if you simply type joe at a search or limit prompt, Mutt
3544 # will automatically expand it to the value specified by this variable.
3545 # For the default value it would be:
3546
3547 # ~f joe | ~s joe
3548
3549
3550 # set smart_wrap=yes
3551 #
3552 # Name: smart_wrap
3553 # Type: boolean
3554 # Default: yes
3555
3556
3557 # Controls the display of lines longer than the screen width in the
3558 # internal pager. If set, long lines are wrapped at a word boundary.  If
3559 # unset, lines are simply wrapped at the screen edge. Also see the
3560 # ``$markers'' variable.
3561
3562
3563 # set smileys="(>From )|(:[-^]?[][)(><}{|/DP])"
3564 #
3565 # Name: smileys
3566 # Type: regular expression
3567 # Default: "(>From )|(:[-^]?[][)(><}{|/DP])"
3568
3569
3570 # The pager uses this variable to catch some common false
3571 # positives of ``$quote_regexp'', most notably smileys in the beginning
3572 # of a line
3573
3574
3575 # set sleep_time=1
3576 #
3577 # Name: sleep_time
3578 # Type: number
3579 # Default: 1
3580
3581
3582 # Specifies time, in seconds, to pause while displaying certain informational
3583 # messages, while moving from folder to folder and after expunging
3584 # messages from the current folder.  The default is to pause one second, so 
3585 # a value of zero for this option suppresses the pause.
3586
3587
3588 # set sort=date
3589 #
3590 # Name: sort
3591 # Type: sort order
3592 # Default: date
3593
3594
3595 # Specifies how to sort messages in the index menu.  Valid values
3596 # are:
3597
3598 #    date or date-sent
3599 #    date-received
3600 #    from
3601 #    mailbox-order (unsorted)
3602 #    score
3603 #    size
3604 #    subject
3605 #    threads
3606 #    to
3607
3608 # You may optionally use the reverse- prefix to specify reverse sorting
3609 # order (example: set sort=reverse-date-sent).
3610
3611
3612 # set sort_alias=alias
3613 #
3614 # Name: sort_alias
3615 # Type: sort order
3616 # Default: alias
3617
3618
3619 # Specifies how the entries in the `alias' menu are sorted.  The
3620 # following are legal values:
3621
3622 #    address (sort alphabetically by email address)
3623 #    alias (sort alphabetically by alias name)
3624 #    unsorted (leave in order specified in .muttrc)
3625
3626
3627 # set sort_aux=date
3628 #
3629 # Name: sort_aux
3630 # Type: sort order
3631 # Default: date
3632
3633
3634 # When sorting by threads, this variable controls how threads are sorted
3635 # in relation to other threads, and how the branches of the thread trees
3636 # are sorted.  This can be set to any value that ``$sort'' can, except
3637 # threads (in that case, mutt will just use date-sent).  You can also
3638 # specify the last- prefix in addition to the reverse- prefix, but last-
3639 # must come after reverse-.  The last- prefix causes messages to be
3640 # sorted against its siblings by which has the last descendant, using
3641 # the rest of sort_aux as an ordering.  For instance, set sort_aux=last-
3642 # date-received would mean that if a new message is received in a
3643 # thread, that thread becomes the last one displayed (or the first, if
3644 # you have set sort=reverse-threads.) Note: For reversed ``$sort''
3645 # order $sort_aux is reversed again (which is not the right thing to do,
3646 # but kept to not break any existing configuration setting).
3647
3648
3649 # set sort_browser=subject
3650 #
3651 # Name: sort_browser
3652 # Type: sort order
3653 # Default: subject
3654
3655
3656 # Specifies how to sort entries in the file browser.  By default, the
3657 # entries are sorted alphabetically.  Valid values:
3658
3659 #    alpha (alphabetically)
3660 #    date
3661 #    size
3662 #    unsorted
3663
3664 # You may optionally use the reverse- prefix to specify reverse sorting
3665 # order (example: set sort_browser=reverse-date).
3666
3667
3668 # set sort_re=yes
3669 #
3670 # Name: sort_re
3671 # Type: boolean
3672 # Default: yes
3673
3674
3675 # This variable is only useful when sorting by threads with
3676 # ``$strict_threads'' unset.  In that case, it changes the heuristic
3677 # mutt uses to thread messages by subject.  With sort_re set, mutt will
3678 # only attach a message as the child of another message by subject if
3679 # the subject of the child message starts with a substring matching the
3680 # setting of ``$reply_regexp''.  With sort_re unset, mutt will attach
3681 # the message whether or not this is the case, as long as the
3682 # non-``$reply_regexp'' parts of both messages are identical.
3683
3684
3685 # set spoolfile=""
3686 #
3687 # Name: spoolfile
3688 # Type: path
3689 # Default: ""
3690
3691
3692 # If your spool mailbox is in a non-default place where Mutt cannot find
3693 # it, you can specify its location with this variable.  Mutt will
3694 # automatically set this variable to the value of the environment
3695 # variable $MAIL if it is not set.
3696
3697
3698 # set status_chars="-*%A"
3699 #
3700 # Name: status_chars
3701 # Type: string
3702 # Default: "-*%A"
3703
3704
3705 # Controls the characters used by the "%r" indicator in
3706 # ``$status_format''. The first character is used when the mailbox is
3707 # unchanged. The second is used when the mailbox has been changed, and
3708 # it needs to be resynchronized. The third is used if the mailbox is in
3709 # read-only mode, or if the mailbox will not be written when exiting
3710 # that mailbox (You can toggle whether to write changes to a mailbox
3711 # with the toggle-write operation, bound by default to "%"). The fourth
3712 # is used to indicate that the current folder has been opened in attach-
3713 # message mode (Certain operations like composing a new mail, replying,
3714 # forwarding, etc. are not permitted in this mode).
3715
3716
3717 # 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)---"
3718 #
3719 # Name: status_format
3720 # Type: string
3721 # 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)---"
3722
3723
3724 # Controls the format of the status line displayed in the index
3725 # menu.  This string is similar to ``$index_format'', but has its own
3726 # set of printf()-like sequences:
3727
3728 # %b      number of mailboxes with new mail *
3729 # %d      number of deleted messages *
3730 # %f      the full pathname of the current mailbox
3731 # %F      number of flagged messages *
3732 # %h      local hostname
3733 # %l      size (in bytes) of the current mailbox *
3734 # %L      size (in bytes) of the messages shown 
3735 #         (i.e., which match the current limit) *
3736 # %m      the number of messages in the mailbox *
3737 # %M      the number of messages shown (i.e., which match the current limit) *
3738 # %n      number of new messages in the mailbox *
3739 # %o      number of old unread messages
3740 # %p      number of postponed messages *
3741 # %P      percentage of the way through the index
3742 # %r      modified/read-only/won't-write/attach-message indicator,
3743 #         according to $status_chars
3744 # %s      current sorting mode ($sort)
3745 # %S      current aux sorting method ($sort_aux)
3746 # %t      number of tagged messages *
3747 # %u      number of unread messages *
3748 # %v      Mutt version string
3749 # %V      currently active limit pattern, if any *
3750 # %>X     right justify the rest of the string and pad with "X"
3751 # %|X     pad to the end of the line with "X"
3752
3753
3754 # * = can be optionally printed if nonzero
3755
3756 # Some of the above sequences can be used to optionally print a string
3757 # if their value is nonzero.  For example, you may only want to see the
3758 # number of flagged messages if such messages exist, since zero is not
3759 # particularly meaningful.  To optionally print a string based upon one
3760 # of the above sequences, the following construct is used
3761
3762 # %?<sequence_char>?<optional_string>?
3763
3764 # where sequence_char is a character from the table above, and
3765 # optional_string is the string you would like printed if
3766 # status_char is nonzero.  optional_string may contain
3767 # other sequence as well as normal text, but you may not nest
3768 # optional strings.
3769
3770 # Here is an example illustrating how to optionally print the number of
3771 # new messages in a mailbox:
3772 # %?n?%n new messages.?
3773
3774 # Additionally you can switch between two strings, the first one, if a
3775 # value is zero, the second one, if the value is nonzero, by using the
3776 # following construct:
3777 # %?<sequence_char>?<if_string>&<else_string>?
3778
3779 # You can additionally force the result of any printf-like sequence to
3780 # be lowercase by prefixing the sequence character with an underscore
3781 # (_) sign.  For example, if you want to display the local hostname in
3782 # lowercase, you would use:
3783 # %_h
3784
3785 # If you prefix the sequence character with a colon (:) character, mutt
3786 # will replace any dots in the expansion by underscores. This might be helpful 
3787 # with IMAP folders that don't like dots in folder names.
3788
3789
3790 # set status_on_top=no
3791 #
3792 # Name: status_on_top
3793 # Type: boolean
3794 # Default: no
3795
3796
3797 # Setting this variable causes the ``status bar'' to be displayed on
3798 # the first line of the screen rather than near the bottom.
3799
3800
3801 # set strict_threads=no
3802 #
3803 # Name: strict_threads
3804 # Type: boolean
3805 # Default: no
3806
3807
3808 # If set, threading will only make use of the ``In-Reply-To'' and
3809 # ``References'' fields when you ``$sort'' by message threads.  By
3810 # default, messages with the same subject are grouped together in
3811 # ``pseudo threads.''  This may not always be desirable, such as in a
3812 # personal mailbox where you might have several unrelated messages with
3813 # the subject ``hi'' which will get grouped together.
3814
3815
3816 # set suspend=yes
3817 #
3818 # Name: suspend
3819 # Type: boolean
3820 # Default: yes
3821
3822
3823 # When unset, mutt won't stop when the user presses the terminal's
3824 # susp key, usually ``control-Z''. This is useful if you run mutt
3825 # inside an xterm using a command like xterm -e mutt.
3826
3827
3828 # set text_flowed=no
3829 #
3830 # Name: text_flowed
3831 # Type: boolean
3832 # Default: no
3833
3834
3835 # When set, mutt will generate text/plain; format=flowed attachments.
3836 # This format is easier to handle for some mailing software, and generally
3837 # just looks like ordinary text.  To actually make use of this format's 
3838 # features, you'll need support in your editor.
3839
3840 # Note that $indent_string is ignored when this option is set.
3841
3842
3843 # set thread_received=no
3844 #
3845 # Name: thread_received
3846 # Type: boolean
3847 # Default: no
3848
3849
3850 # When set, mutt uses the date received rather than the date sent
3851 # to thread messages by subject.
3852
3853
3854 # set thorough_search=no
3855 #
3856 # Name: thorough_search
3857 # Type: boolean
3858 # Default: no
3859
3860
3861 # Affects the ~b and ~h search operations described in
3862 # section ``patterns'' above.  If set, the headers and attachments of
3863 # messages to be searched are decoded before searching.  If unset,
3864 # messages are searched as they appear in the folder.
3865
3866
3867 # set tilde=no
3868 #
3869 # Name: tilde
3870 # Type: boolean
3871 # Default: no
3872
3873
3874 # When set, the internal-pager will pad blank lines to the bottom of the
3875 # screen with a tilde (~).
3876
3877
3878 # set timeout=600
3879 #
3880 # Name: timeout
3881 # Type: number
3882 # Default: 600
3883
3884
3885 # This variable controls the number of seconds Mutt will wait
3886 # for a key to be pressed in the main menu before timing out and
3887 # checking for new mail.  A value of zero or less will cause Mutt
3888 # to never time out.
3889
3890
3891 # set tmpdir=""
3892 #
3893 # Name: tmpdir
3894 # Type: path
3895 # Default: ""
3896
3897
3898 # This variable allows you to specify where Mutt will place its
3899 # temporary files needed for displaying and composing messages.  If
3900 # this variable is not set, the environment variable TMPDIR is
3901 # used.  If TMPDIR is not set then "/tmp" is used.
3902
3903
3904 # set to_chars=" +TCFL"
3905 #
3906 # Name: to_chars
3907 # Type: string
3908 # Default: " +TCFL"
3909
3910
3911 # Controls the character used to indicate mail addressed to you.  The
3912 # first character is the one used when the mail is NOT addressed to your
3913 # address (default: space).  The second is used when you are the only
3914 # recipient of the message (default: +).  The third is when your address
3915 # appears in the TO header field, but you are not the only recipient of
3916 # the message (default: T).  The fourth character is used when your
3917 # address is specified in the CC header field, but you are not the only
3918 # recipient.  The fifth character is used to indicate mail that was sent
3919 # by you.  The sixth character is used to indicate when a mail
3920 # was sent to a mailing-list you subscribe to (default: L).
3921
3922
3923 # set tunnel=""
3924 #
3925 # Name: tunnel
3926 # Type: string
3927 # Default: ""
3928
3929
3930 # Setting this variable will cause mutt to open a pipe to a command
3931 # instead of a raw socket. You may be able to use this to set up
3932 # preauthenticated connections to your IMAP/POP3 server. Example:
3933
3934 # tunnel="ssh -q mailhost.net /usr/local/libexec/imapd"
3935
3936 # NOTE: For this example to work you must be able to log in to the remote
3937 # machine without having to enter a password.
3938
3939
3940 # set use_8bitmime=no
3941 #
3942 # Name: use_8bitmime
3943 # Type: boolean
3944 # Default: no
3945
3946
3947 # Warning: do not set this variable unless you are using a version
3948 # of sendmail which supports the -B8BITMIME flag (such as sendmail
3949 # 8.8.x) or you may not be able to send mail.
3950
3951 # When set, Mutt will invoke ``$sendmail'' with the -B8BITMIME
3952 # flag when sending 8-bit messages to enable ESMTP negotiation.
3953
3954
3955 # set use_domain=yes
3956 #
3957 # Name: use_domain
3958 # Type: boolean
3959 # Default: yes
3960
3961
3962 # When set, Mutt will qualify all local addresses (ones without the
3963 # @host portion) with the value of ``$hostname''.  If unset, no
3964 # addresses will be qualified.
3965
3966
3967 # set use_from=yes
3968 #
3969 # Name: use_from
3970 # Type: boolean
3971 # Default: yes
3972
3973
3974 # When set, Mutt will generate the `From:' header field when
3975 # sending messages.  If unset, no `From:' header field will be
3976 # generated unless the user explicitly sets one using the ``my_hdr''
3977 # command.
3978
3979
3980 # set use_ipv6=yes
3981 #
3982 # Name: use_ipv6
3983 # Type: boolean
3984 # Default: yes
3985
3986
3987 # When set, Mutt will look for IPv6 addresses of hosts it tries to
3988 # contact.  If this option is unset, Mutt will restrict itself to IPv4 addresses.
3989 # Normally, the default should work.
3990
3991
3992 # set use_ipv6=yes
3993 #
3994 # Name: use_ipv6
3995 # Type: boolean
3996 # Default: yes
3997
3998
3999 # When set, Mutt will look for IPv6 addresses of hosts it tries to
4000 # contact.  If this option is unset, Mutt will restrict itself to IPv4 addresses.
4001 # Normally, the default should work.
4002
4003
4004 # set user_agent=yes
4005 #
4006 # Name: user_agent
4007 # Type: boolean
4008 # Default: yes
4009
4010
4011 # When set, mutt will add a "User-Agent" header to outgoing
4012 # messages, indicating which version of mutt was used for composing
4013 # them.
4014
4015
4016 # set visual=""
4017 #
4018 # Name: visual
4019 # Type: path
4020 # Default: ""
4021
4022
4023 # Specifies the visual editor to invoke when the ~v command is
4024 # given in the builtin editor.
4025
4026
4027 # set wait_key=yes
4028 #
4029 # Name: wait_key
4030 # Type: boolean
4031 # Default: yes
4032
4033
4034 # Controls whether Mutt will ask you to press a key after shell-
4035 # escape, pipe-message, pipe-entry, print-message,
4036 # and print-entry commands.
4037
4038 # It is also used when viewing attachments with ``auto_view'', provided
4039 # that the corresponding mailcap entry has a needsterminal flag,
4040 # and the external program is interactive.
4041
4042 # When set, Mutt will always ask for a key. When unset, Mutt will wait
4043 # for a key only if the external command returned a non-zero status.
4044
4045
4046 # set weed=yes
4047 #
4048 # Name: weed
4049 # Type: boolean
4050 # Default: yes
4051
4052
4053 # When set, mutt will weed headers when when displaying, forwarding,
4054 # printing, or replying to messages.
4055
4056
4057 # set wrap_search=yes
4058 #
4059 # Name: wrap_search
4060 # Type: boolean
4061 # Default: yes
4062
4063
4064 # Controls whether searches wrap around the end of the mailbox.
4065
4066 # When set, searches will wrap around the first (or last) message. When
4067 # unset, searches will not wrap.
4068
4069
4070 # set wrapmargin=0
4071 #
4072 # Name: wrapmargin
4073 # Type: number
4074 # Default: 0
4075
4076
4077 # Controls the size of the margin remaining at the right side of
4078 # the terminal when mutt's pager does smart wrapping.
4079
4080
4081 # set write_inc=10
4082 #
4083 # Name: write_inc
4084 # Type: number
4085 # Default: 10
4086
4087
4088 # When writing a mailbox, a message will be printed every
4089 # write_inc messages to indicate progress.  If set to 0, only a
4090 # single message will be displayed before writing a mailbox.
4091
4092 # Also see the ``$read_inc'' variable.
4093
4094
4095 # set write_bcc=yes
4096 #
4097 # Name: write_bcc
4098 # Type: boolean
4099 # Default: yes
4100
4101
4102 # Controls whether mutt writes out the Bcc header when preparing
4103 # messages to be sent.  Exim users may wish to use this.
4104
4105
4106 # set x_comment_to=no
4107 #
4108 # Name: x_comment_to
4109 # Type: boolean
4110 # Default: no
4111
4112
4113 # If set, Mutt will add ``X-Comment-To:'' field (that contains full
4114 # name of original article author) to article that followuped to newsgroup.
4115
4116