From: martin f. krafft Date: Mon, 12 May 2008 12:40:41 +0000 (+0100) Subject: import new defaults and comments from sample Muttrc X-Git-Url: https://git.madduck.net/etc/mutt.git/commitdiff_plain/0d3bd369f791c7121bf6dcbe3077f2381335cc54 import new defaults and comments from sample Muttrc --- diff --git a/.mutt/muttrc b/.mutt/muttrc index fd09d3d..883baa7 100644 --- a/.mutt/muttrc +++ b/.mutt/muttrc @@ -205,6 +205,10 @@ set my_confdir="~/.mutt" # (please see the ``attachments'' section for possible speed effects) # %>X right justify the rest of the string and pad with character "X" # %|X pad to the end of the line with character "X" +# %*X soft-fill with character "X" as pad +# +# +# For an explanation of `soft-fill', see the ``$index_format'' documentation. # # # set attach_sep="\n" @@ -357,6 +361,7 @@ set beep=no # # # Character set your terminal uses to display and enter textual data. +# It is also the fallback for $send_charset. # # # set check_new=yes @@ -647,9 +652,6 @@ set delete=yes # Default: "" # # -# Note: you should not enable this unless you are using Sendmail -# 8.8.x or greater. -# # This variable sets the request for when notification is returned. The # string consists of a comma separated list (no spaces!) of one or more # of the following: never, to never request notification, @@ -659,6 +661,12 @@ set delete=yes # # Example: set dsn_notify="failure,delay" # +# Note: when using $sendmail for delivery, you should not enable +# this unless you are either using Sendmail 8.8.x or greater or a MTA +# providing a sendmail(1)-compatible interface supporting the -N option +# for DSN. For SMTP delivery, it depends on the server whether DSN is +# supported or not. +# # # set dsn_return="" # @@ -667,15 +675,18 @@ set delete=yes # Default: "" # # -# Note: you should not enable this unless you are using Sendmail -# 8.8.x or greater. -# # This variable controls how much of your message is returned in DSN # messages. It may be set to either hdrs to return just the # message header, or full to return the full message. # # Example: set dsn_return=hdrs # +# Note: when using $sendmail for delivery, you should not enable +# this unless you are either using Sendmail 8.8.x or greater or a MTA +# providing a sendmail(1)-compatible interface supporting the -R option +# for DSN. For SMTP delivery, it depends on the server whether DSN is +# supported or not. +# # # set duplicate_threads=yes # @@ -829,6 +840,10 @@ set folder="~/mail" # %u owner name (or numeric uid, if missing) # %>X right justify the rest of the string and pad with character "X" # %|X pad to the end of the line with character "X" +# %*X soft-fill with character "X" as pad +# +# +# For an explanation of `soft-fill', see the ``$index_format'' documentation. # # # set followup_to=yes @@ -930,8 +945,7 @@ set folder="~/mail" # is unset. # # Defaults to the contents of the environment variable EMAIL. -# -set from='martin f krafft ' +# # # set gecos_mask="^[^,]*" # @@ -1107,9 +1121,20 @@ set history_file="~/.var/mutt/history" # Default: "" # # -# Specifies the hostname to use after the ``@'' in local e-mail -# addresses. This overrides the compile time definition obtained from -# /etc/resolv.conf. +# Specifies the fully-qualified hostname of the system mutt is running on +# containing the host's name and the DNS domain it belongs to. It is used +# as the domain part (after ``@'') for local email addresses as well as +# Message-Id headers. +# +# Its value is determined at startup as follows: If the node's name +# as returned by the uname(3) function contains the hostname and the +# domain, these are used to construct $hostname. If there is no +# domain part returned, Mutt will look for a ``domain'' or ``search'' +# line in /etc/resolv.conf to determine the domain. Optionally, Mutt +# can be compiled with a fixed domain name in which case a detected +# one is not used. +# +# Also see ``$use_domain'' and ``$hidden_host''. # # Note: On Debian systems, the default for this variable is obtained # from /etc/mailname when Mutt starts. @@ -1135,7 +1160,8 @@ set history_file="~/.var/mutt/history" # # # Affects the behaviour of the reply function when replying to -# messages from mailing lists. When set, if the ``Reply-To:'' field is +# messages from mailing lists (as defined by the ``subscribe'' or +# ``lists'' commands). When set, if the ``Reply-To:'' field is # set to the same value as the ``To:'' field, Mutt assumes that the # ``Reply-To:'' field was set by the mailing list to automate responses # to the list, and will ignore this field. To direct a response to the @@ -1376,6 +1402,9 @@ set include=yes # message to which you are replying. You are strongly encouraged not to # change this value, as it tends to agitate the more fanatical netizens. # +# This option is a format string, please see the description of +# ``$index_format'' for supported printf()-style sequences. +# # # set index_format="%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s" # @@ -1403,7 +1432,7 @@ set include=yes # ``date_format'' converted to the local time zone # %e current message number in thread # %E number of messages in current thread -# %f entire From: line (address + real name) +# %f sender (address + real name), either From: or Return-Path: # %F author name, or recipient name if the message is from you # %H spam attribute(s) of this message # %i message-id of the current message @@ -1445,7 +1474,19 @@ set include=yes # function ``strftime''; a leading bang disables locales. # %>X right justify the rest of the string and pad with character "X" # %|X pad to the end of the line with character "X" +# %*X soft-fill with character "X" as pad +# +# +# `Soft-fill' deserves some explanation. Normal right-justification +# will print everything to the left of the %>, displaying padding and +# the whatever lies to the right only if there's room. By contrast, +# soft-fill gives priority to the right-hand side, guaranteeing space +# to display it and showing padding only if there's still room. If +# necessary, soft-fill will eat text leftwards to make room for +# rightward text. # +# Note that these expandos are supported in +# ``save-hook'', ``fcc-hook'' and ``fcc-save-hook'', too. # # See also: ``$to_chars''. # @@ -1969,11 +2010,11 @@ set narrow_tree=yes # set pager_context=2 # -# set pager_format="-%Z- %C/%m: %-20.20n %s%> -- (%P)" +# set pager_format="-%Z- %C/%m: %-20.20n %s%* -- (%P)" # # Name: pager_format # Type: string -# Default: "-%Z- %C/%m: %-20.20n %s%> -- (%P)" +# Default: "-%Z- %C/%m: %-20.20n %s%* -- (%P)" # # # This variable controls the format of the one-line message ``status'' @@ -3121,7 +3162,8 @@ set pipe_decode # # # Controls whether or not messages are saved in the ``$postponed'' -# mailbox when you elect not to send immediately. +# mailbox when you elect not to send immediately. Also see the +# ``$recall'' variable. # # # set postponed="~/postponed" @@ -3443,8 +3485,7 @@ set reply_regexp="^((re([[(]?[[:digit:]]+[)]]?)?|aw|antwort|wg|sgkb):[[:space:]] # 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_name=yes +# # # set reverse_realname=yes # @@ -3596,7 +3637,7 @@ set save_history=100 # Default: "us-ascii:iso-8859-1:utf-8" # # -# A list of character sets for outgoing messages. Mutt will use the +# A colon-delimited list of character sets for outgoing messages. Mutt will use the # first character set into which the text can be converted exactly. # If your ``$charset'' is not iso-8859-1 and recipients may not # understand UTF-8, it is advisable to include in the list an @@ -3604,6 +3645,9 @@ set save_history=100 # iso-8859-2, koi8-r or iso-2022-jp) either instead of or after # "iso-8859-1". # +# In case the text cannot be converted into one of these exactly, +# mutt uses ``$charset'' as a fallback. +# # # set sendmail="/usr/sbin/sendmail -oem -oi" # @@ -3983,7 +4027,10 @@ set spoolfile="=inbox" # %V currently active limit pattern, if any * # %>X right justify the rest of the string and pad with "X" # %|X pad to the end of the line with "X" +# %*X soft-fill with character "X" as pad +# # +# For an explanation of `soft-fill', see the ``$index_format'' documentation. # # * = can be optionally printed if nonzero # @@ -4115,6 +4162,20 @@ set thorough_search=yes # screen with a tilde (~). # # +# set time_inc=0 +# +# Name: time_inc +# Type: number +# Default: 0 +# +# +# Along with ``read_inc'', ``write_inc'', and ``net_inc'', this +# variable controls the frequency with which progress updates are +# displayed. It suppresses updates less than ``time_inc'' milliseconds +# apart. This can improve throughput on systems with slow terminals, +# or when running mutt on a remote system. +# +# # set timeout=600 # # Name: timeout @@ -4122,10 +4183,17 @@ set thorough_search=yes # Default: 600 # # -# This variable controls the number of seconds Mutt will wait -# for a key to be pressed in the main menu before timing out and -# checking for new mail. A value of zero or less will cause Mutt -# to never time out. +# When Mutt is waiting for user input either idleing in menus or +# in an interactive prompt, Mutt would block until input is +# present. Depending on the context, this would prevent certain +# operations from working, like checking for new mail or keeping +# an IMAP connection alive. +# +# This variable controls how many seconds Mutt will at most wait +# until it aborts waiting for input, performs these operations and +# continues to wait for input. +# +# A value of zero or less will cause Mutt to never time out. # # # set tmpdir="" @@ -4226,13 +4294,15 @@ set thorough_search=yes # Default: no # # -# When set, mutt will use ``$envelope_from_address'' as the -# envelope sender if that is set, otherwise it will attempt to -# derive it from the "From:" header. Note that this information is passed -# to sendmail command using the "-f" command line switch, so don't set this -# option if you are using that switch in $sendmail yourself, -# or if the sendmail on your machine doesn't support that command -# line switch. +# When set, mutt will set the envelope sender of the message. +# If ``$envelope_from_address'' is set, it will be used as the sender +# address. If not, mutt will attempt to derive the sender from the +# "From:" header. +# +# Note that this information is passed to sendmail command using the +# "-f" command line switch. Therefore setting this option is not useful +# if the ``$sendmail'' variable already contains "-f" or if the +# executable pointed to by $sendmail doesn't support the "-f" switch. # # # set use_from=yes