]> 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:

add mhonarc list
[etc/mutt.git] / .mutt / muttrc
index 84260b1589e55f4f5f8a03076a4fa9cd41b3915b..259ecd937eb785a8897d739c8968ddab389532a7 100644 (file)
@@ -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
 #
@@ -700,6 +711,9 @@ set delete=yes
 # This option allows you to edit the header of your outgoing messages
 # along with the body of your message.
 # 
+# Note that changes made to the References: and Date: headers are
+# ignored for interoperability reasons.
+# 
 set edit_headers=yes
 # 
 # set editor=""
@@ -829,6 +843,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,7 +948,7 @@ set folder="~/mail"
 # is unset.
 # 
 # Defaults to the contents of the environment variable EMAIL.
-#
+# 
 set from='martin f krafft <madduck@madduck.net>'
 # 
 # set gecos_mask="^[^,]*"
@@ -1107,9 +1125,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 +1164,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 +1406,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 +1436,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,11 +1478,23 @@ 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''.
 # 
-set index_format="%4C %Z %{%b %d} %-15.15F (%?l?%4l&%4c?) %?H?[%H] ?%s"
+set index_format="%4C %Z %{%b %d} %-15.15F %4c %?H?[%H] ?%s"
 # 
 # set ispell="ispell"
 #
@@ -1492,7 +1537,7 @@ set index_format="%4C %Z %{%b %d} %-15.15F (%?l?%4l&%4c?) %?H?[%H] ?%s"
 # 
 # 
 # This variable configures how often (in seconds) mutt should look for
-# new mail.
+# new mail. Also see the ``$timeout'' variable.
 # 
 # 
 # set mailcap_path=""
@@ -1969,11 +2014,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 +3166,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"
@@ -3181,7 +3227,7 @@ set postponed="=drafts"
 # 
 # This specifies the command pipe that should be used to print messages.
 # 
-set print_command="muttprint"
+set print_command="a2ps -Email -1 -o $TMPDIR/muttprint.ps"
 # 
 # set print_decode=yes
 #
@@ -3245,6 +3291,31 @@ set print_split=yes
 # 
 set query_command="lbdbq"
 # 
+# set query_format="%4c %t %-25.25a %-25.25n %?e?(%e)?"
+#
+# Name: query_format
+# Type: string
+# Default: "%4c %t %-25.25a %-25.25n %?e?(%e)?"
+# 
+# 
+# This variable describes the format of the `query' menu. The
+# following printf-style sequences are understood:
+# 
+# %a      destination address
+# %c      current entry number
+# %e      extra information *
+# %n      destination name
+# %t      ``*'' if current entry is tagged, a space otherwise
+# %>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, see the ``$status_format'' documentation.
+# 
+# 
 # set quit=yes
 #
 # Name: quit
@@ -3443,7 +3514,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 +3667,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 +3675,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"
 #
@@ -3927,6 +4001,7 @@ set sort_aux=last-date-received
 # automatically set this variable to the value of the environment
 # variable $MAIL if it is not set.
 # 
+set spoolfile="=inbox"
 # 
 # set status_chars="-*%A"
 #
@@ -3982,7 +4057,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"
+# %*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
 # 
@@ -4114,6 +4192,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
@@ -4121,10 +4213,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=""
@@ -4139,7 +4238,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.
 # 
-set tmpdir="~/.tmp"
 # 
 # set to_chars=" +TCFL"
 #
@@ -4226,13 +4324,15 @@ set tmpdir="~/.tmp"
 # 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
@@ -4445,4 +4545,4 @@ set my_mailboxes = `ls ~/.var/offlineimap/mailboxes 2>/dev/null || echo /dev/nul
 source $my_mailboxes
 
 set alias_file="$my_confdir/aliases"
-source "test -f $alias_file && cat $alias_file || echo unset alias_file|"
+source "test -f $alias_file && cat $alias_file 2>/dev/null || echo unset alias_file|"