** Upon startup Mutt tries to derive this value from environment variables
** such as \fC$$$LC_CTYPE\fP or \fC$$$LANG\fP.
** .pp
- ** \fBNote:\fP It should only be set in case Mutt isn't abled to determine the
+ ** \fBNote:\fP It should only be set in case Mutt isn't able to determine the
** character set used correctly.
*/
{ "check_mbox_size", DT_BOOL, R_NONE, OPTCHECKMBOXSIZE, 0 },
** .pp
** If \fI``yes''\fP, always attempt to verify PGP or S/MIME signatures.
** If \fI``ask-*''\fP, ask whether or not to verify the signature.
- ** If \Fi``no''\fP, never attempt to verify cryptographic signatures.
+ ** If \fI``no''\fP, never attempt to verify cryptographic signatures.
** (Crypto only)
*/
{ "date_format", DT_STR, R_BOTH, UL &DateFmt, UL "!%a, %b %d, %Y at %I:%M:%S%p %Z" },
** \fBNote:\fP 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 \fCsendmail(1)\fP-compatible interface supporting the \fC-N\fP option
- ** for DSN. For SMTP delivery, DSN support is autodetected so that it
+ ** for DSN. For SMTP delivery, DSN support is auto-detected so that it
** depends on the server whether DSN will be used or not.
*/
{ "dsn_return", DT_STR, R_NONE, UL &DsnReturn, UL "" },
** \fBNote:\fP 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 \fCsendmail(1)\fP-compatible interface supporting the \fC-R\fP option
- ** for DSN. For SMTP delivery, DSN support is autodetected so that it
+ ** for DSN. For SMTP delivery, DSN support is auto-detected so that it
** depends on the server whether DSN will be used or not.
*/
{ "duplicate_threads", DT_BOOL, R_RESORT|R_RESORT_INIT|R_INDEX, OPTDUPTHREADS, 1 },
{ "escape", DT_STR, R_NONE, UL &EscChar, UL "~" },
/*
** .pp
- ** Escape character to use for functions in the builtin editor.
+ ** Escape character to use for functions in the built-in editor.
*/
{ "fast_reply", DT_BOOL, R_NONE, OPTFASTREPLY, 0 },
/*
** .dl
** .dt %C .dd current file number
** .dt %d .dd date/time folder was last modified
+ ** .dt %D .dd date/time folder was last modified using $$date_format.
** .dt %f .dd filename (``/'' is appended to directory names,
** ``@'' to symbolic links and ``*'' to executable
** files)
** When mutt is compiled with qdbm or tokyocabinet as header cache backend,
** this option determines whether the database will be compressed.
** Compression results in database files roughly being one fifth
- ** of the usual diskspace, but the uncompression can result in a
+ ** of the usual diskspace, but the decompression can result in a
** slower opening of cached folder(s) which in general is still
** much faster than opening non header cached folders.
*/
{ "ignore_list_reply_to", DT_BOOL, R_NONE, OPTIGNORELISTREPLYTO, 0 },
/*
** .pp
- ** Affects the behaviour of the \fC<reply>\fP function when replying to
+ ** Affects the behavior of the \fC<reply>\fP function when replying to
** messages from mailing lists (as defined by the ``$subscribe'' or
** ``$lists'' commands). When \fIset\fP, if the ``Reply-To:'' field is
** set to the same value as the ``To:'' field, Mutt assumes that the
** 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''
+ ** side of an IMAP ``AUTH=xxx'' capability string, e.g. ``digest-md5'', ``gssapi''
** or ``cram-md5''. This option is case-insensitive. If it's
** \fIunset\fP (the default) mutt will try all available methods,
** in order from most-secure to least-secure.
** .dt %O .dd original save folder where mutt would formerly have
** stashed the message: list name or recipient name
** if not sent to a list
- ** .dt %P .dd progress indicator for the builtin pager (how much of the file has been displayed)
+ ** .dt %P .dd progress indicator for the built-in pager (how much of the file has been displayed)
** .dt %s .dd subject of the message
** .dt %S .dd status of the message (``N''/``D''/``d''/``!''/``r''/\(as)
** .dt %t .dd ``To:'' field (recipients)
** This variable configures how often (in seconds) mutt should look for
** new mail. Also see the $$timeout variable.
*/
+ { "mail_check_recent",DT_BOOL, R_NONE, OPTMAILCHECKRECENT, 1 },
+ /*
+ ** .pp
+ ** When \fIset\fP, Mutt will only notify you about new mail that has been received
+ ** since the last time you opened the mailbox. When \fIunset\fP, Mutt will notify you
+ ** if any new mail exists in the mailbox, regardless of whether you have visited it
+ ** recently.
+ ** .pp
+ ** When \fI$$mark_old\fP is set, Mutt does not consider the mailbox to contain new
+ ** mail if only old messages exist.
+ */
{ "mailcap_path", DT_STR, R_NONE, UL &MailcapPath, 0 },
/*
** .pp
/*
** .pp
** The default mailbox type used when creating new folders. May be any of
- ** ``mbox'', ``MMDF'', ``MH'' and ``Maildir''. This is overriden by the
+ ** ``mbox'', ``MMDF'', ``MH'' and ``Maildir''. This is overridden by the
** \fC-m\fP command-line option.
*/
{ "menu_context", DT_NUM, R_NONE, UL &MenuContext, 0 },
{ "mh_purge", DT_BOOL, R_NONE, OPTMHPURGE, 0 },
/*
** .pp
- ** When \fIunset\fP, mutt will mimic mh's behaviour and rename deleted messages
+ ** When \fIunset\fP, mutt will mimic mh's behavior and rename deleted messages
** to \fI,<old file name>\fP in mh folders instead of really deleting
** them. This leaves the message on disk but makes programs reading the folder
** ignore it. If the variable is \fIset\fP, the message files will simply be
/*
** .pp
** This variable specifies which pager you would like to use to view
- ** messages. The value ``builtin'' means to use the builtin pager, otherwise this
+ ** messages. The value ``builtin'' means to use the built-in pager, otherwise this
** variable should specify the pathname of the external pager you would
** like to use.
** .pp
** This is a colon-delimited list of authentication methods mutt may
** attempt to use to log in to an POP server, in the order mutt should
** try them. Authentication methods are either ``user'', ``apop'' or any
- ** SASL mechanism, eg ``digest-md5'', ``gssapi'' or ``cram-md5''.
+ ** SASL mechanism, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''.
** This option is case-insensitive. If this option is \fIunset\fP
** (the default) mutt will try all available methods, in order from
** most-secure to least-secure.
/*
** .pp
** The name of your POP server for the \fC$<fetch-mail>\fP function. You
- ** can also specify an alternative port, username and password, ie:
+ ** can also specify an alternative port, username and password, i.e.:
** .ts
** [pop[s]://][username[:password]@]popserver[:port]
** .te
{ "query_command", DT_PATH, R_NONE, UL &QueryCmd, UL "" },
/*
** .pp
- ** This specifies the command that mutt will use to make external address
- ** queries. The string should contain a ``%s'', which will be substituted
- ** with the query string the user types. See ``$query'' for more
- ** information.
+ ** This specifies the command Mutt will use to make external address
+ ** queries. The string may contain a ``%s'', which will be substituted
+ ** with the query string the user types. Mutt will add quotes around the
+ ** string substituted for ``%s'' automatically according to shell quoting
+ ** rules, so you should avoid adding your own. If no ``%s'' is found in
+ ** the string, Mutt will append the user's query to the end of the string.
+ ** See ``$query'' for more information.
*/
{ "query_format", DT_STR, R_NONE, UL &QueryFormat, UL "%4c %t %-25.25a %-25.25n %?e?(%e)?" },
/*
{ "reverse_realname", DT_BOOL, R_BOTH, OPTREVREAL, 1 },
/*
** .pp
- ** This variable fine-tunes the behaviour of the $$reverse_name feature.
+ ** This variable fine-tunes the behavior of the $$reverse_name feature.
** When it is \fIset\fP, mutt will use the address from incoming messages as-is,
** possibly including eventual real names. When it is \fIunset\fP, mutt will
** override any such real names with the setting of the $$realname variable.
** this variable unless your signature contains just your name. The
** reason for this is because many software packages use ``-- \n'' to
** detect your signature. For example, Mutt has the ability to highlight
- ** the signature in a different color in the builtin pager.
+ ** the signature in a different color in the built-in pager.
*/
{ "sig_on_top", DT_BOOL, R_NONE, OPTSIGONTOP, 0},
/*
{ "smime_is_default", DT_BOOL, R_NONE, OPTSMIMEISDEFAULT, 0},
/*
** .pp
- ** The default behaviour of mutt is to use PGP on all auto-sign/encryption
+ ** The default behavior of mutt is to use PGP on all auto-sign/encryption
** operations. To override and to use OpenSSL instead this must be \fIset\fP.
** However, this has no effect while replying, since mutt will automatically
** select the same application that was used to sign/encrypt the original
** .pp
** This is a colon-delimited list of authentication methods mutt may
** attempt to use to log in to an SMTP server, in the order mutt should
- ** try them. Authentication methods are any SASL mechanism, eg
+ ** try them. Authentication methods are any SASL mechanism, e.g.
** ``digest-md5'', ``gssapi'' or ``cram-md5''.
** This option is case-insensitive. If it is ``unset''
** (the default) mutt will try all available methods, in order from
/*
** .pp
** Defines the SMTP smarthost where sent messages should relayed for
- ** delivery. This should take the form of an SMTP URL, eg:
+ ** delivery. This should take the form of an SMTP URL, e.g.:
** .ts
- ** smtp[s]://[user[:pass]@]host[:port]/
+ ** smtp[s]://[user[:pass]@]host[:port]
** .te
** .pp
** where ``[...]'' denotes an optional part.
** personal mailbox where you might have several unrelated messages with
** the subjects like ``hi'' which will get grouped together. See also
** $$sort_re for a less drastic way of controlling this
- ** behaviour.
+ ** behavior.
*/
{ "suspend", DT_BOOL, R_NONE, OPTSUSPEND, 1 },
/*
** .pp
** Note that $$indent_string is ignored when this option is \fIset\fP.
*/
- { "thorough_search", DT_BOOL, R_NONE, OPTTHOROUGHSRC, 0 },
+ { "thorough_search", DT_BOOL, R_NONE, OPTTHOROUGHSRC, 1 },
/*
** .pp
** Affects the \fC~b\fP and \fC~h\fP search operations described in
{ "timeout", DT_NUM, R_NONE, UL &Timeout, 600 },
/*
** .pp
- ** When Mutt is waiting for user input either idleing in menus or
+ ** When Mutt is waiting for user input either idling 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
/*
** .pp
** Specifies the visual editor to invoke when the ``\fC~v\fP'' command is
- ** given in the builtin editor.
+ ** given in the built-in editor.
*/
{ "wait_key", DT_BOOL, R_NONE, OPTWAITKEY, 1 },
/*
** .pp
** When set to a positive value, mutt will wrap text at $$wrap characters.
** When set to a negative value, mutt will wrap text so that there are $$wrap
- ** characters of empty space on the right side of the terminal.
+ ** characters of empty space on the right side of the terminal. Setting it
+ ** to zero makes mutt wrap at the terminal width.
+ */
+ { "wrap_headers", DT_NUM, R_PAGER, UL &WrapHeaders, 78 },
+ /*
+ ** .pp
+ ** This option specifies the number of characters to use for wrapping
+ ** an outgoing message's headers. Allowed values are between 78 and 998
+ ** inclusive.
+ ** .pp
+ ** \fBNote:\fP This option usually shouldn't be changed. RFC5233
+ ** recommends a line length of 78 (the default), so \fBplease only change
+ ** this setting when you know what you're doing\fP.
*/
{ "wrap_search", DT_BOOL, R_NONE, OPTWRAPSEARCH, 1 },
/*
static int parse_unlist (BUFFER *, BUFFER *, unsigned long, BUFFER *);
static int parse_group (BUFFER *, BUFFER *, unsigned long, BUFFER *);
-static int parse_ungroup (BUFFER *, BUFFER *, unsigned long, BUFFER *);
static int parse_lists (BUFFER *, BUFFER *, unsigned long, BUFFER *);
static int parse_unlists (BUFFER *, BUFFER *, unsigned long, BUFFER *);
{ "fcc-hook", mutt_parse_hook, M_FCCHOOK },
{ "fcc-save-hook", mutt_parse_hook, M_FCCHOOK | M_SAVEHOOK },
{ "folder-hook", mutt_parse_hook, M_FOLDERHOOK },
- { "group", parse_group, 0 },
- { "ungroup", parse_ungroup, 0 },
+ { "group", parse_group, M_GROUP },
+ { "ungroup", parse_group, M_UNGROUP },
{ "hdr_order", parse_list, UL &HeaderOrderList },
#ifdef HAVE_ICONV
{ "iconv-hook", mutt_parse_hook, M_ICONVHOOK },
projects / software / mutt-debian.git / blobdiff