]> git.madduck.net Git - etc/mutt.git/blobdiff - .mutt/muttrc

madduck's git repository

Every one of the projects in this repository is available at the canonical URL git://git.madduck.net/madduck/pub/<projectpath> — see each project's metadata for the exact URL.

All patches and comments are welcome. Please squash your changes to logical commits before using git-format-patch and git-send-email to patches@git.madduck.net. If you'd read over the Git project's submission guidelines and adhered to them, I'd be especially grateful.

SSH access, as well as push access can be individually arranged.

If you use my repositories frequently, consider adding the following snippet to ~/.gitconfig and using the third clone URL listed for each project:

[url "git://git.madduck.net/madduck/"]
  insteadOf = madduck:

readd setting accidentally removed in 0d3bd36
[etc/mutt.git] / .mutt / muttrc
index abfdb07d7667ae67c3179cd256c16cba1e75e1a2..8ab765d646e4b4c39a18f8e5bced59436c92d148 100644 (file)
@@ -34,8 +34,6 @@ set my_confdir="~/.mutt"
 # Type: path
 # Default: "~/.muttrc"
 # 
 # Type: path
 # Default: "~/.muttrc"
 # 
-set alias_file="$my_confdir/aliases"
-source $my_confdir/aliases
 # 
 # The default file in which to save aliases created by the 
 # ``create-alias'' function.
 # 
 # The default file in which to save aliases created by the 
 # ``create-alias'' function.
@@ -207,6 +205,10 @@ source $my_confdir/aliases
 #         (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"
 #         (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"
 # 
 # 
 # set attach_sep="\n"
@@ -359,6 +361,7 @@ set beep=no
 # 
 # 
 # Character set your terminal uses to display and enter textual data.
 # 
 # 
 # Character set your terminal uses to display and enter textual data.
+# It is also the fallback for $send_charset.
 # 
 # 
 # set check_new=yes
 # 
 # 
 # set check_new=yes
@@ -649,9 +652,6 @@ set delete=yes
 # Default: ""
 # 
 # 
 # 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,
 # 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,
@@ -661,6 +661,12 @@ set delete=yes
 # 
 # Example: set dsn_notify="failure,delay"
 # 
 # 
 # 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=""
 #
 # 
 # set dsn_return=""
 #
@@ -669,15 +675,18 @@ set delete=yes
 # Default: ""
 # 
 # 
 # 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
 # 
 # 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
 #
 # 
 # set duplicate_threads=yes
 #
@@ -831,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"
 # %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
 # 
 # 
 # set followup_to=yes
@@ -1109,9 +1122,20 @@ set history_file="~/.var/mutt/history"
 # Default: ""
 # 
 # 
 # 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.
 # 
 # Note: On Debian systems, the default for this variable is obtained
 # from /etc/mailname when Mutt starts.
@@ -1137,7 +1161,8 @@ set history_file="~/.var/mutt/history"
 # 
 # 
 # Affects the behaviour of the reply function when replying to
 # 
 # 
 # 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
 # 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
@@ -1378,6 +1403,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.
 # 
 # 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"
 #
 # 
 # set index_format="%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s"
 #
@@ -1405,7 +1433,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
 #         ``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
 # %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
@@ -1447,7 +1475,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"
 #         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''.
 # 
 # 
 # See also: ``$to_chars''.
 # 
@@ -1971,11 +2011,11 @@ set narrow_tree=yes
 # 
 set pager_context=2
 # 
 # 
 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
 #
 # 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''
 # 
 # 
 # This variable controls the format of the one-line message ``status''
@@ -2003,6 +2043,7 @@ set pager_context=2
 # is less than pager_index_lines, then the index will only use as
 # many lines as it needs.
 # 
 # is less than pager_index_lines, then the index will only use as
 # many lines as it needs.
 # 
+set pager_index_lines=5
 # 
 # set pager_stop=no
 #
 # 
 # set pager_stop=no
 #
@@ -3122,7 +3163,8 @@ set pipe_decode
 # 
 # 
 # Controls whether or not messages are saved in the ``$postponed''
 # 
 # 
 # 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"
 # 
 # 
 # set postponed="~/postponed"
@@ -3597,7 +3639,7 @@ set save_history=100
 # Default: "us-ascii:iso-8859-1:utf-8"
 # 
 # 
 # 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
 # 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
@@ -3605,6 +3647,9 @@ set save_history=100
 # iso-8859-2, koi8-r or iso-2022-jp) either instead of or after
 # "iso-8859-1".
 # 
 # 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"
 #
 # 
 # set sendmail="/usr/sbin/sendmail -oem -oi"
 #
@@ -3928,6 +3973,7 @@ set sort_aux=last-date-received
 # automatically set this variable to the value of the environment
 # variable $MAIL if it is not set.
 # 
 # automatically set this variable to the value of the environment
 # variable $MAIL if it is not set.
 # 
+set spoolfile="=inbox"
 # 
 # set status_chars="-*%A"
 #
 # 
 # set status_chars="-*%A"
 #
@@ -3983,7 +4029,10 @@ set sort_aux=last-date-received
 # %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"
 # %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
 # 
 # 
 # * = can be optionally printed if nonzero
 # 
@@ -4115,6 +4164,20 @@ set thorough_search=yes
 # screen with a tilde (~).
 # 
 # 
 # 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
 # set timeout=600
 #
 # Name: timeout
@@ -4122,10 +4185,17 @@ set thorough_search=yes
 # Default: 600
 # 
 # 
 # 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=""
 # 
 # 
 # set tmpdir=""
@@ -4140,7 +4210,6 @@ set thorough_search=yes
 # this variable is not set, the environment variable TMPDIR is
 # used.  If TMPDIR is not set then "/tmp" is used.
 # 
 # this variable is not set, the environment variable TMPDIR is
 # used.  If TMPDIR is not set then "/tmp" is used.
 # 
-set tmpdir="~/.tmp"
 # 
 # set to_chars=" +TCFL"
 #
 # 
 # set to_chars=" +TCFL"
 #
@@ -4227,13 +4296,15 @@ set tmpdir="~/.tmp"
 # Default: no
 # 
 # 
 # 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
 # 
 # 
 # set use_from=yes
@@ -4442,5 +4513,8 @@ source $my_confdir/lists
 source $my_confdir/spam
 source $my_confdir/hooks
 
 source $my_confdir/spam
 source $my_confdir/hooks
 
-#set my_mailboxes = `ls ~/.var/offlineimap/mailboxes 2>/dev/null || echo /dev/null`
-#source $my_mailboxes
+set my_mailboxes = `ls ~/.var/offlineimap/mailboxes 2>/dev/null || echo /dev/null`
+source $my_mailboxes
+
+set alias_file="$my_confdir/aliases"
+source "test -f $alias_file && cat $alias_file 2>/dev/null || echo unset alias_file|"