# (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"
#
#
# Character set your terminal uses to display and enter textual data.
+# It is also the fallback for $send_charset.
#
#
# set check_new=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,
#
# 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=""
#
# 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
#
# %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
# is unset.
#
# Defaults to the contents of the environment variable EMAIL.
-#
-set from='martin f krafft <madduck@madduck.net>'
+#
#
# set gecos_mask="^[^,]*"
#
# 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.
#
#
# 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
# 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"
#
# ``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
# 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 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''
#
#
# 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"
# 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
#
# 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
# 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"
#
# %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
#
# 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
# 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=""
# 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
projects / etc / mutt.git / commitdiff