Use p_new instead of xmalloc()
[apps/madmutt.git] / Muttrc
diff --git a/Muttrc b/Muttrc
index 7666cf5..5a56e85 100644 (file)
--- a/Muttrc
+++ b/Muttrc
@@ -197,7 +197,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # following printf-style sequences are understood:
 # 
 # %C      charset
-# %c      reqiures charset conversion (n or c)
+# %c      requires charset conversion (n or c)
 # %D      deleted flag
 # %d      description
 # %e      MIME content-transfer-encoding
@@ -393,7 +393,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: "-- Mutt: Compose  [Approx. msg size: %l   Atts: %a]%>-"
 # 
 # 
-# Controls the format of the status line displayed in the \fCompose
+# Controls the format of the status line displayed in the Compose
 # menu.  This string is similar to ``$status_format'', but has its own
 # set of printf()-like sequences:
 # 
@@ -407,6 +407,17 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # information on how to set ``$compose_format''.
 # 
 # 
+# set config_charset=""
+#
+# Name: config_charset
+# Type: string
+# Default: ""
+# 
+# 
+# When defined, Mutt will recode commands in rc files from this
+# encoding.
+# 
+# 
 # set confirmappend=yes
 #
 # Name: confirmappend
@@ -463,6 +474,20 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # ``$save_name'', ``$force_name'' and ``fcc-hook''.
 # 
 # 
+# set crypt_use_gpgme=no
+#
+# Name: crypt_use_gpgme
+# Type: boolean
+# Default: no
+# 
+# 
+# This variable controls the use the GPGME enabled crypto backends.
+# If it is set and Mutt was build with gpgme support, the gpgme code for
+# S/MIME and PGP will be used instead of the classic code.  Note, that
+# you need to use this option in .muttrc as it won't have any effect when 
+# used interactively.
+# 
+# 
 # set crypt_autopgp=yes
 #
 # Name: crypt_autopgp
@@ -560,8 +585,8 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: yes
 # 
 # 
-# If this option is set, mutt's revattach menu will not show the subparts of
-# individual messages in a digest.  To see these subparts, press 'v' on that menu.
+# If this option is set, mutt's received-attachments menu will not show the subparts of
+# individual messages in a multipart/digest.  To see these subparts, press 'v' on that menu.
 # 
 # 
 # set display_filter=""
@@ -1010,6 +1035,18 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # thread tree.
 # 
 # 
+# set hide_thread_subject=yes
+#
+# Name: hide_thread_subject
+# Type: boolean
+# Default: yes
+# 
+# 
+# When set, mutt will not show the subject of messages in the thread
+# tree that have the same subject as their parent or closest previously
+# displayed sibling.
+# 
+# 
 # set hide_top_limited=no
 #
 # Name: hide_top_limited
@@ -1096,8 +1133,8 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # This is a colon-delimited list of authentication methods mutt may
 # attempt to use to log in to an IMAP server, in the order mutt should
 # try them.  Authentication methods are either 'login' or the right
-# side of an IMAP 'AUTH=xxx' capability string, eg 'digest-md5',
-# 'gssapi' or 'cram-md5'. This parameter is case-insensitive. If this
+# side of an IMAP 'AUTH=xxx' capability string, eg 'digest-md5', 'gssapi'
+# or 'cram-md5'. This parameter is case-insensitive. If this
 # parameter is unset (the default) mutt will try all available methods,
 # in order from most-secure to least-secure.
 # 
@@ -1131,6 +1168,20 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # connecting to IMAP servers.
 # 
 # 
+# set imap_headers=""
+#
+# Name: imap_headers
+# Type: string
+# Default: ""
+# 
+# 
+# Mutt requests these header fields in addition to the default headers
+# ("DATE FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE
+# CONTENT-DESCRIPTION IN-REPLY-TO REPLY-TO LINES X-LABEL") from IMAP
+# servers before displaying the index menu. You may want to add more
+# headers for spam detection. Note: This is a space separated list.
+# 
+# 
 # set imap_home_namespace=""
 #
 # Name: imap_home_namespace
@@ -1263,6 +1314,17 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # is included in your reply.
 # 
 # 
+# set include_onlyfirst=no
+#
+# Name: include_onlyfirst
+# Type: boolean
+# Default: no
+# 
+# 
+# Controls whether or not Mutt includes only the first attachment
+# of the message you are replying.
+# 
+# 
 # set indent_string="> "
 #
 # Name: indent_string
@@ -1536,6 +1598,17 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # command) from the list of recipients when replying to a message.
 # 
 # 
+# set menu_context=0
+#
+# Name: menu_context
+# Type: number
+# Default: 0
+# 
+# 
+# This variable controls the number of lines of context that are given
+# when scrolling through menus. (Similar to ``$pager_context''.)
+# 
+# 
 # set menu_scroll=no
 #
 # Name: menu_scroll
@@ -1698,7 +1771,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: ask-no
 # 
 # 
-# Controls whether you will be asked to confirm moving read messages
+# Controls whether or not Mutt will move read messages
 # from your spool mailbox to your ``$mbox'' mailbox, or as a result of
 # a ``mbox-hook'' command.
 # 
@@ -2161,6 +2234,55 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # (PGP only)
 # 
 # 
+# set pgp_autoinline=no
+#
+# Name: pgp_autoinline
+# Type: boolean
+# Default: no
+# 
+# 
+# This option controls whether Mutt generates old-style inline
+# (traditional) PGP encrypted or signed messages under certain
+# circumstances.  This can be overridden by use of the pgp-menu,
+# when inline is not required.
+# 
+# Note that Mutt might automatically use PGP/MIME for messages
+# which consist of more than a single MIME part.  Mutt can be
+# configured to ask before sending PGP/MIME messages when inline
+# (traditional) would not work.
+# See also: ``$pgp_mime_auto''.
+# 
+# Also note that using the old-style PGP message format is strongly
+# deprecated.
+# (PGP only)
+# 
+# 
+# set pgp_replyinline=no
+#
+# Name: pgp_replyinline
+# Type: boolean
+# Default: no
+# 
+# 
+# Setting this variable will cause Mutt to always attempt to
+# create an inline (traditional) message when replying to a
+# message which is PGP encrypted/signed inline.  This can be
+# overridden by use of the pgp-menu, when inline is not
+# required.  This option does not automatically detect if the
+# (replied-to) message is inline; instead it relies on Mutt
+# internals for previously checked/flagged messages.
+# 
+# Note that Mutt might automatically use PGP/MIME for messages
+# which consist of more than a single MIME part.  Mutt can be
+# configured to ask before sending PGP/MIME messages when inline
+# (traditional) would not work.
+# See also: ``$pgp_mime_auto''.
+# 
+# Also note that using the old-style PGP message format is strongly
+# deprecated.
+# (PGP only)
+# 
+# 
 # set pgp_show_unusable=yes
 #
 # Name: pgp_show_unusable
@@ -2234,45 +2356,35 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # (PGP only)
 # 
 # 
-# set pgp_create_traditional=no
+# set pgp_mime_auto=ask-yes
 #
-# Name: pgp_create_traditional
+# Name: pgp_mime_auto
 # Type: quadoption
-# Default: no
-# 
+# Default: ask-yes
 # 
-# This option controls whether Mutt generates old-style inline PGP
-# encrypted or signed messages.
 # 
-# Note that PGP/MIME will be used automatically for messages which have
-# a character set different from us-ascii, or which consist of more than
-# a single MIME part.
+# This option controls whether Mutt will prompt you for
+# automatically sending a (signed/encrypted) message using
+# PGP/MIME when inline (traditional) fails (for any reason).
 # 
 # Also note that using the old-style PGP message format is strongly
 # deprecated.
 # (PGP only)
 # 
 # 
-# set pgp_auto_traditional=no
+# set pgp_auto_decode=no
 #
-# Name: pgp_auto_traditional
+# Name: pgp_auto_decode
 # Type: boolean
 # Default: no
 # 
 # 
-# This option causes Mutt to generate an old-style inline PGP
-# encrypted or signed message when replying to an old-style
-# message, and a PGP/MIME message when replying to a PGP/MIME
-# message.  Note that this option is only meaningful when using
-# ``$crypt_replyencrypt'', ``$crypt_replysign'', or
-# ``$crypt_replysignencrypted''.
-# 
-# Also note that PGP/MIME will be used automatically for messages
-# which have a character set different from us-ascii, or which
-# consist of more than a single MIME part.
-# 
-# This option overrides ``$pgp_create_traditional''
-# (PGP only)
+# If set, mutt will automatically attempt to decrypt traditional PGP
+# messages whenever the user performs an operation which ordinarily would
+# result in the contents of the message being operated on.  For example,
+# if the user displays a pgp-traditional message which has not been manually
+# checked with the check-traditional-pgp function, mutt will automatically
+# check the message for traditional pgp.
 # 
 # 
 # set pgp_decode_command=""
@@ -2656,8 +2768,8 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # 
 # 
 # This command is used to extract only the signers X509 certificate from a S/MIME
-# signature, so that the certificate's owner may get compared to the email's 
-# 'From'-field.
+# signature, so that the certificate's owner may get compared to the
+# email's 'From'-field.
 # (S/MIME only)
 # 
 # 
@@ -2697,6 +2809,17 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # (S/MIME only)
 # 
 # 
+# set ssl_client_cert=""
+#
+# Name: ssl_client_cert
+# Type: path
+# Default: ""
+# 
+# 
+# The file containing a client certificate and its associated private
+# key.
+# 
+# 
 # set ssl_starttls=yes
 #
 # Name: ssl_starttls
@@ -2709,11 +2832,11 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # use STARTTLS regardless of the server's capabilities.
 # 
 # 
-# set certificate_file=""
+# set certificate_file="~/.mutt_certificates"
 #
 # Name: certificate_file
 # Type: path
-# Default: ""
+# Default: "~/.mutt_certificates"
 # 
 # 
 # This variable specifies the file where the certificates you trust
@@ -3017,8 +3140,9 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: ask-no
 # 
 # 
-# Controls whether or not Mutt asks for confirmation before printing.
-# This is useful for people (like me) who accidentally hit ``p'' often.
+# Controls whether or not Mutt really prints messages.
+# This is set to ask-no by default, because some people
+# accidentally hit ``p'' often (like me).
 # 
 # 
 # set print_command="lpr"
@@ -3171,7 +3295,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: ask-yes
 # 
 # 
-# Controls whether or not you are prompted to recall postponed messages
+# Controls whether or not Mutt recalls postponed messages
 # when composing a new message.  Also see ``$postponed''.
 # 
 # Setting this variable to ``yes'' is not generally useful, and thus not
@@ -3225,8 +3349,8 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: ask-yes
 # 
 # 
-# If set, Mutt will ask you if you want to use the address listed in the
-# Reply-To: header field when replying to a message.  If you answer no,
+# If set, when replying to a message, Mutt will use the address listed
+# in the Reply-to: header as the recipient of the reply.  If unset,
 # it will use the address in the From: header field instead.  This
 # option is useful for reading a mailing list that sets the Reply-To:
 # header field to the list address and you want to send a private
@@ -3279,8 +3403,10 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # move the messages to another machine, and reply to some the messages
 # from there.  If this variable is set, the default From: line of
 # the reply messages is built using the address where you received the
-# messages you are replying to.  If the variable is unset, the
-# From: line will use your address on the current machine.
+# messages you are replying to if that address matches your
+# alternates.  If the variable is unset, or the address that would be
+# used doesn't match your alternates, the From: line will use
+# your address on the current machine.
 # 
 # 
 # set reverse_realname=yes
@@ -3621,6 +3747,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 #    mailbox-order (unsorted)
 #    score
 #    size
+#    spam
 #    subject
 #    threads
 #    to
@@ -3666,11 +3793,11 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # but kept to not break any existing configuration setting).
 # 
 # 
-# set sort_browser=subject
+# set sort_browser=alpha
 #
 # Name: sort_browser
 # Type: sort order
-# Default: subject
+# Default: alpha
 # 
 # 
 # Specifies how to sort entries in the file browser.  By default, the
@@ -3702,6 +3829,20 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # non-``$reply_regexp'' parts of both messages are identical.
 # 
 # 
+# set spam_separator=","
+#
+# Name: spam_separator
+# Type: string
+# Default: ","
+# 
+# 
+# ``spam_separator'' controls what happens when multiple spam headers
+# are matched: if unset, each successive header will overwrite any
+# previous matches value for the spam label. If set, each successive
+# match will append to the previous, using ``spam_separator'' as a
+# separator.
+# 
+# 
 # set spoolfile=""
 #
 # Name: spoolfile
@@ -3756,7 +3897,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # %m      the number of messages in the mailbox *
 # %M      the number of messages shown (i.e., which match the current limit) *
 # %n      number of new messages in the mailbox *
-# %o      number of old unread messages
+# %o      number of old unread messages *
 # %p      number of postponed messages *
 # %P      percentage of the way through the index
 # %r      modified/read-only/won't-write/attach-message indicator,
@@ -3783,8 +3924,8 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # 
 # where sequence_char is a character from the table above, and
 # optional_string is the string you would like printed if
-# status_char is nonzero.  optional_string may contain
-# other sequence as well as normal text, but you may not nest
+# sequence_char is nonzero.  optional_string may contain
+# other sequences as well as normal text, but you may not nest
 # optional strings.
 # 
 # Here is an example illustrating how to optionally print the number of
@@ -4009,6 +4150,18 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Normally, the default should work.
 # 
 # 
+# set use_idn=yes
+#
+# Name: use_idn
+# Type: boolean
+# Default: yes
+# 
+# 
+# When set, Mutt will show you international domain names decoded.
+# Note: You can use IDNs for addresses even if this is unset.
+# This variable only affects decoding.
+# 
+# 
 # set use_ipv6=yes
 #
 # Name: use_ipv6
@@ -4070,7 +4223,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # Default: yes
 # 
 # 
-# When set, mutt will weed headers when when displaying, forwarding,
+# When set, mutt will weed headers when displaying, forwarding,
 # printing, or replying to messages.
 # 
 # 
@@ -4120,7 +4273,7 @@ macro pager   <f1> "!less /usr/local/doc/mutt/manual.txt\n" "Show Mutt documenta
 # 
 # 
 # Controls whether mutt writes out the Bcc header when preparing
-# messages to be sent.  Exim users may wish to use this.
+# messages to be sent.  Exim users may wish to unset this.
 # 
 # 
 # set x_comment_to=no