Package: mutt
Version: 2.2.13-1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with a new version
test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man
page"
[Use "groff -e ' $' -e '\\~$' <file>" to find obvious trailing spaces.]
["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).
[The fate of "test-nroff" was decided in groff bug #55941.]
* What was the outcome of this action?
Many lins of type:
troff:<stdin>:298: warning: trailing space in the line
an.tmac:<stdin>:658: style: use of deprecated macro: .PD
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.12.12-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1),
LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages mutt depends on:
ii libc6 2.40-6
ii libgnutls30t64 3.8.9-2
ii libgpg-error0 1.51-3
ii libgpgme11t64 1.24.1-4
ii libgsasl18 2.2.1-1+b2
ii libgssapi-krb5-2 1.21.3-4
ii libidn2-0 2.3.7-2+b1
ii libncursesw6 6.5+20250125-2
ii libtinfo6 6.5+20250125-2
ii libtokyocabinet9t64 1.4.48-15.1+b1
ii zlib1g 1:1.3.dfsg+really1.3.1-1+b1
Versions of packages mutt recommends:
ii locales 2.40-6
ii mailcap 3.74
ii sensible-utils 0.0.24
Versions of packages mutt suggests:
ii aspell 0.60.8.1-3
ii ca-certificates 20241223
ii exim4-daemon-light [mail-transport-agent] 4.98-3+b1
ii gnupg 2.2.46-1
ii ispell 3.4.06-1
ii openssl 3.4.0-2
pn urlview <none>
Versions of packages mutt is related to:
ii mutt 2.2.13-1
-- no debconf information
Input file is muttrc.5
Output from "mandoc -T lint muttrc.5": (shortened list)
about 55 input text line longer than 80 bytes: ...
5 skipping paragraph macro: PP after SH
3 skipping paragraph macro: PP after SS
1 skipping paragraph macro: PP empty
224 whitespace at end of input line
-.-.
Output from "test-groff -mandoc -t -ww -z muttrc.5": (shortened list)
229 trailing space in the line
-.-.
Remove space characters (whitespace) at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
Number of lines affected is
219
-.-.
Change (or include a "FIXME" paragraph about) misused SI (metric)
numeric prefixes (or names) to the binary ones, like Ki (kibi), Mi
(mebi), Gi (gibi), or Ti (tebi), if indicated.
If the metric prefixes are correct, add the definitions or an
explanation to avoid misunderstanding.
Use "\e" to print the escape character instead of "\\" (which gets
interpreted in copy mode).
465:"\fI\\\\.gz$\fP"). The commands tell Mutt how to uncompress a folder
519:You may also use the \(lqC\(rq escape sequences \fB\\n\fP and
520:\fB\\t\fP for newline and tab, respectively.
1259:Default: \(lq\\n\(rq
3876:Default: \(lq!^\\.[^.]\(rq
5088:Default: \(lq\\n\(rq
5332:set preconnect=\(rqssh \-f \-q \-L 1234:mailhost.net:143 mailhost.net \\
5503:Default: \(lq^([ \\t]*[|>:}#])+\(rq
5653:Default: \(lq^(re)(\\[[0\-9]+\\])*:[ \\t]*\(rq
5667:The initial \fB\(rq\\\\[\(rq\fP means a literal left\-bracket character.
5670:numbers. \fB\(rq\\\\]\(rq\fP means a literal right\-bracket. Finally the
5675:tab. Note \fB\(rq\\t\(rq\fP is converted to a literal tab inside a
6417:reason for this is because many software packages use \(lq\-\- \\n\(rq to
-.-.
Use the word (in)valid instead of (il)legal,
if not related to legal matters.
See "www.gnu.org/prep/standards".
Think about translations into other languages!
muttrc.5:1300:attribution string. Legal values are the strings your system
muttrc.5:4955:following are legal values:
muttrc.5:7047:following are legal values:
-.-.
Remove space in the first column, if not indented.
Use ".in +<number>n" and ".in" to end it; ".nf" and ".fi" to end
it, for an extra indention.
muttrc.5:4547: of a \fBmultipart/signed\fP attachment when verifying
it.
muttrc.5:6611: of a \fBmultipart/signed\fP attachment when verifying
it.
muttrc.5:6627: points to a directory or file, this expands to
muttrc.5:6628: \(lq\-CApath $smime_ca_location\(rq or \(lq\-CAfile
$smime_ca_location\(rq.
-.-.
Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.
81:\fBalias\fP [\fB-group\fP \fIname\fP [...]] \fIkey\fP \fIaddress\fP [\fB,\fP
\fIaddress\fP [ ... ]]
91:\fB-group\fP argument to \fBalias\fP causes the aliased address(es) to be
96:\fBgroup\fP [\fB-group\fP \fIname\fP] [\fB-rx\fP \fIEXPR\fP [ \fI...\fP ]]
[\fB-addr\fP \fIaddress\fP [ \fI...\fP ]]
97:\fBungroup\fP [\fB-group\fP \fIname\fP ] [ \fB*\fP | [[\fB-rx\fP \fIEXPR\fP
[ \fI...\fP ]] [\fB-addr\fP \fIaddress\fP [ \fI...\fP ]]]
102:\fBgroup\fP command can be in any order. The flags \fI-rx\fP and \fI-addr\fP
111:\fBsubscribe\fP and \fBalternates\fP commands by specifying the optional
\fI-group\fP
119:\fBalternates\fP [\fB-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP [
... ]]
127:a regular expression from the list of known alternates. The \fB-group\fP
flag
146:\fBattachments\fP [ \fB+\fP | \fB-\fP ]\fIdisposition\fP \fImime-type\fP
147:\fBunattachments\fP [ \fB+\fP | \fB-\fP ]\fIdisposition\fI \fImime-type\fP
155:\fIdisposition\fP is the attachment's Content-Disposition type - either
164:\fIdisposition\fP is prefixed by either a \fB+\fP symbol or a \fB-\fP
166:disposition and MIME type to qualify. If it's a \fB-\fP, you're saying
182:specific MIME types at this time - they're just text in a
335:\fBlists\fP [\fB-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP ... ]
337:\fBsubscribe\fP [\fB-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP ... ]
350:it from the list of subscribed mailing lists. The \fB-group\fP flag
363:\fBmailboxes\fP [[\fB-notify\fP | \fB-nonotify\fP]
364: [\fB-poll\fP | \fB-nopoll\fP]
365: [[\fB-label\fP \fIlabel\fP] | \fB-nolabel\fP]
600:can be any of the \fB-hook\fP commands documented above.
684:~d \fIMIN\fP-\fIMAX\fP
738:~m \fIMIN\fP-\fIMAX\fP
744:~n \fIMIN\fP-\fIMAX\fP
762:~r \fIMIN\fP-\fIMAX\fP
795:~X \fIMIN\fP-\fIMAX\fP
796:messages with MIN - MAX attachments
801:~z \fIMIN\fP-\fIMAX\fP
825:\fIMIN\fP\fB-\fP, and \fB-\fP\fIMAX\fP.
859:(\(lq\fB-\fP\(rq), followed by a date, this range will match any
868:.BR - ,
879:.B -
-.-.
Find a repeated word
! 610 --> the
! 1988 --> an
! 2055 --> an
-.-.
Add "\&" after "e.g." and "i.e.", or use English words
(man-pages(7)).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.
464:\fBregexp\fP specifies which folders are taken as compressed (e.g.
811:messages in threads containing messages matching a certain pattern, e.g.
all threads containing messages from you: ~(~P)
814:messages whose immediate parent matches PATTERN, e.g. replies to your
messages: ~<(~P)
817:messages having an immediate child matching PATTERN, e.g. messages you
replied to: ~>(~P)
1251:If the path is invalid (e.g. not a directory, or cannot be
1995:message is opened, i.e. via the \fB<display\-message>\fP function.
2342:(e.g. To:, Cc:, Subject:). Headers added in your editor must
2660:When forwarding inline (i.e. $mime_forward \fIunset\fP or
3123:side of an IMAP \(lqAUTH=xxx\(rq capability string, e.g.
\(lqdigest\-md5\(rq, \(lqgssapi\(rq
3227:and not contain the colon, e.g. \(lqX\-BOGOSITY X\-SPAM\-STATUS\(rq for the
3827:programs interacting with the folder (e.g. dovecot) are moving new
4591:(e.g. simply signed and ascii armored text).
4928:to specify your key (e.g. \fB0x00112233\fP).
5133:SASL mechanism, e.g. \(lqdigest\-md5\(rq, \(lqgssapi\(rq or
\(lqcram\-md5\(rq.
5178:can also specify an alternative port, username and password, i.e.:
5327:connections, e.g. with \fBssh(1)\fP. If the command returns a nonzero
6025:of the filter is the generated mime type, e.g. text/html,
6925:try them. Authentication methods are any SASL mechanism, e.g.
-.-.
Wrong distance between sentences in the input file.
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
Mark a final abbreviation point as such by suffixing it with "\&".
Some sentences (etc.) do not begin on a new line.
N.B.
The number of lines affected can be too large to be in a patch.
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
N.B.
The number of lines affected can be too large to be in a patch.
-.-.
Use \(en (en-dash) for a dash at the beginning (en) of a line,
or between space characters,
not a minus (\-) or a hyphen (-), except in the NAME section.
muttrc.5:155:\fIdisposition\fP is the attachment's Content-Disposition type -
either
muttrc.5:182:specific MIME types at this time - they're just text in a
-.-.
Do not use more than two space characters between sentences or (better)
only a new line character.
140:subtype. \fBunalternative_order\fP removes entries from the
6443:outgoing messages. If the filename ends with a pipe (\(lq|\(rq), it is
-.-.
The name of a man page is typeset in bold and the section in roman
(see man-pages(7)).
995:following \fBprintf(3)\fP\-style sequences are available:
1157:following \fBprintf(3)\fP\-style sequences are understood:
1288:in a reply. For a full listing of defined \fBprintf(3)\fP\-like sequences
see
1299:The locale used by \fBstrftime(3)\fP to format dates in the
1357:The following \fBprintf(3)\fP\-style sequences are understood
1469:menu. The following \fBprintf(3)\fP\-style sequences are
1569:locale\-based sorting (using \fBstrcoll(3)\fP), which ignores some
1721:set of \fBprintf(3)\fP\-like sequences:
2168:sequence in $index_format. This is passed to the \fBstrftime(3)\fP
2258:Contains the path of the \fBmutt_dotlock(1)\fP binary to be used by
2286:providing a \fBsendmail(1)\fP\-compatible interface supporting the
\fB\-N\fP option
2312:providing a \fBsendmail(1)\fP\-compatible interface supporting the
\fB\-R\fP option
2548:its own set of \fBprintf(3)\fP\-like sequences:
2676:For a full listing of defined \fBprintf(3)\fP\-like sequences see
2689:For a full listing of defined \fBprintf(3)\fP\-like sequences see
3043:hostname is first determined by the \fBuname(3)\fP function. The
3044:domain is then looked up using the \fBgethostname(2)\fP and
3045:\fBgetaddrinfo(3)\fP functions. If those calls are unable to
3480:$index_format for supported \fBprintf(3)\fP\-style sequences.
3494:function \fBprintf(3)\fP to format output (see the man page for more
details).
3623:\fBstrftime(3)\fP; a leading bang disables locales
3628:\fBstrftime(3)\fP; a leading bang disables locales
3632:\(lqfmt\(rq is expanded by the library function \fBstrftime(3)\fP;
3637:function \fBstrftime(3)\fP; a leading bang disables locales.
3800:files when the header cache is in use. This incurs one \fBstat(2)\fP per
3985:\fBprintf(3)\fP\-like sequences see the section on $index_format.
4012:The following \fBprintf(3)\fP\-style sequences are understood:
4212:chain selection screen. The following \fBprintf(3)\fP\-like sequences are
4419:following \fBprintf(3)\fP\-style sequences are understood:
4520:possible \fBprintf(3)\fP\-like sequences.
4534:The PGP command formats have their own set of \fBprintf(3)\fP\-like
sequences:
4575:possible \fBprintf(3)\fP\-like sequences.
4625:possible \fBprintf(3)\fP\-like sequences.
4639:possible \fBprintf(3)\fP\-like sequences.
4652:has its own set of \fBprintf(3)\fP\-like sequences:
4681:date of the key where <s> is an \fBstrftime(3)\fP expression
4699:possible \fBprintf(3)\fP\-like sequences.
4712:the only \fBprintf(3)\fP\-like sequence used with this format. Note that
4756:possible \fBprintf(3)\fP\-like sequences.
4784:possible \fBprintf(3)\fP\-like sequences.
4814:possible \fBprintf(3)\fP\-like sequences.
4943:possible \fBprintf(3)\fP\-like sequences.
5011:If \fIset\fP, mutt expects a \fBgpg\-agent(1)\fP process will handle
5039:possible \fBprintf(3)\fP\-like sequences.
5054:possible \fBprintf(3)\fP\-like sequences.
5261:For a full listing of defined \fBprintf(3)\fP\-like sequences see
5327:connections, e.g. with \fBssh(1)\fP. If the command returns a nonzero
5451:following \fBprintf(3)\fP\-style sequences are understood:
6046:via \fBexecvp(3)\fP with an array of arguments \- so commands or
6156:similar to $index_format, but has its own set of \fBprintf(3)\fP\-like
6601:The OpenSSL command formats have their own set of \fBprintf(3)\fP\-like
sequences
6685:possible \fBprintf(3)\fP\-like sequences.
6711:possible \fBprintf(3)\fP\-like sequences.
6727:possible \fBprintf(3)\fP\-like sequences.
6743:possible \fBprintf(3)\fP\-like sequences.
6757:possible \fBprintf(3)\fP\-like sequences.
6803:possible \fBprintf(3)\fP\-like sequences.
6842:possible \fBprintf(3)\fP\-like sequences. NOTE: %c and %k will default
6871:possible \fBprintf(3)\fP\-like sequences.
6897:possible \fBprintf(3)\fP\-like sequences.
6912:possible \fBprintf(3)\fP\-like sequences.
7447:For OpenSSL, see ciphers(1) for the syntax of the string.
7450:start of the priority string. See gnutls_priority_init(3) for the
7483:set of \fBprintf(3)\fP\-like sequences:
7599:You can force the result of any \fBprintf(3)\fP\-like sequence to be
lowercase
-.-.
Name of a manual is set in bold, the section in roman.
See man-pages(7).
7447:For OpenSSL, see ciphers(1) for the syntax of the string.
7450:start of the priority string. See gnutls_priority_init(3) for the
-.-.
Put a parenthetical sentence, phrase on a separate line,
if not part of a code.
See man-pages(7), item "semantic newline".
Not considered in a patch, too many lines.
-.-.
Use a hyphen between a number and the unit (name) "bit",
see "man-pages(7)", item "Terms to avoid".
4827:If \fIset\fP, use 64 bit PGP key IDs, if \fIunset\fP use the normal 32 bit
key IDs.
-.-.
FSF office address update. See
https://lists.gnu.org/archive/html/bug-gnulib/2024-09/msg00004.html
19:.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
-.-.
Use a character "\(->" instead of plain "->" or "\->".
1058:When \fIset\fP, an arrow (\(lq\->\(rq) will be used to indicate the
current entry
-.-.
No space is needed before a quote (") at the end of a macro line
221:.BR browser ", " editor ", "
223:.BR pager ", " pgp ", " postpone ", "
289:.BR attachment ", " body ", " bold ", " error ", " header ", "
290:.BR hdrdefault ", " index ", " indicator ", " markers ", "
291:.BR message ", " normal ", " prompt ", " quoted ", " quoted\fIN\fP ", "
292:.BR search ", " signature ", " status ", " tilde ", " tree ", "
295:.BR sidebar_divider ", " sidebar_flagged ", " sidebar_highlight ", "
304:.BR header ", " security_encrypt ", " security_sign ", "
308:.BR white ", " black ", " green ", " magenta ", " blue ", "
312:.BR none ", " bold ", " underline ", "
-.-.
Remove quotes when there is a printable
but no space character between them
and the quotes are not for emphasis (markup),
for example as an argument to a macro.
885:.B "1/1/2001-1w+2w*3d"
-.-.
Add lines to use the CR font for groff instead of CW.
.ie \n(.g .ft CR
.el .ft CW
23:.ft CW
-.-.
Trailing space in a macro call.
220:.BR generic ", " alias ", " attach ", "
222:.BR index ", " compose ", "
879:.B -
904:.B <
-.-.
Output from "test-groff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z
":
troff:<stdin>:193: warning: trailing space in the line
[...]
an.tmac:<stdin>:655: style: use of deprecated macro: .PD
an.tmac:<stdin>:819: style: use of deprecated macro: .DT
[etc.]
an.tmac:<stdin>:4547: style: 11 leading space(s) on input line
[etc.]
-.-.
Spelling (codespell):
unconvertable ==> unconvertible
--- muttrc.5 2025-02-14 02:07:16.746064289 +0000
+++ muttrc.5.new 2025-02-14 03:43:50.132308956 +0000
@@ -3,24 +3,26 @@
.\"
.\" Copyright (C) 1996-2000 Michael R. Elkins <m...@cs.hmc.edu>
.\" Copyright (C) 1999-2000 Thomas Roessler <roess...@does-not-exist.org>
-.\"
+.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
-.\"
+.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
.\" GNU General Public License for more details.
-.\"
+.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
-.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301, USA.
+.\" Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+.\" 02110-1301, USA.
.\"
.de EX
.nf
-.ft CW
+.ie \\n(.g .ft CR
+.el .ft CW
..
.de EE
.ft
@@ -78,7 +80,7 @@ like sh and bash: Prepend the name of th
.
.PP
.nf
-\fBalias\fP [\fB-group\fP \fIname\fP [...]] \fIkey\fP \fIaddress\fP [\fB,\fP
\fIaddress\fP [ ... ]]
+\fBalias\fP [\fB\-group\fP \fIname\fP [...]] \fIkey\fP \fIaddress\fP [\fB,\fP
\fIaddress\fP [ ... ]]
\fBunalias\fP [\fB * \fP | \fIkey\fP ]
.fi
.IP
@@ -88,18 +90,18 @@ or a named email address (User Name <use
Name)\(rq.
\fBunalias\fP removes the alias corresponding to the given \fIkey\fP or
all aliases when \(lq\fB*\fP\(rq is used as an argument. The optional
-\fB-group\fP argument to \fBalias\fP causes the aliased address(es) to be
+\fB\-group\fP argument to \fBalias\fP causes the aliased address(es) to be
added to the named \fIgroup\fP.
.
.PP
.nf
-\fBgroup\fP [\fB-group\fP \fIname\fP] [\fB-rx\fP \fIEXPR\fP [ \fI...\fP ]]
[\fB-addr\fP \fIaddress\fP [ \fI...\fP ]]
-\fBungroup\fP [\fB-group\fP \fIname\fP ] [ \fB*\fP | [[\fB-rx\fP \fIEXPR\fP [
\fI...\fP ]] [\fB-addr\fP \fIaddress\fP [ \fI...\fP ]]]
+\fBgroup\fP [\fB\-group\fP \fIname\fP] [\fB\-rx\fP \fIEXPR\fP [ \fI...\fP ]]
[\fB\-addr\fP \fIaddress\fP [ \fI...\fP ]]
+\fBungroup\fP [\fB\-group\fP \fIname\fP ] [ \fB*\fP | [[\fB\-rx\fP \fIEXPR\fP
[ \fI...\fP ]] [\fB\-addr\fP \fIaddress\fP [ \fI...\fP ]]]
.fi
.IP
\fBgroup\fP is used to directly add either addresses or regular expressions to
the specified group or groups. The different categories of arguments to the
-\fBgroup\fP command can be in any order. The flags \fI-rx\fP and \fI-addr\fP
+\fBgroup\fP command can be in any order. The flags \fI\-rx\fP and \fI\-addr\fP
specify what the following strings (that cannot begin with a hyphen) should be
interpreted as: either a regular expression or an email address, respectively.
\fBungroup\fP is used to remove addresses or regular expressions from the
@@ -108,7 +110,7 @@ however the special character \fB*\fP ca
its contents.
.IP
These address groups can also be created implicitly by the \fBalias\fP,
\fBlists\fP,
-\fBsubscribe\fP and \fBalternates\fP commands by specifying the optional
\fI-group\fP
+\fBsubscribe\fP and \fBalternates\fP commands by specifying the optional
\fI\-group\fP
option.
.IP
Once defined, these address groups can be used in patterns to search for and
limit the
@@ -116,7 +118,7 @@ display to messages matching a group.
.
.PP
.nf
-\fBalternates\fP [\fB-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP [ ... ]]
+\fBalternates\fP [\fB\-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP [ ...
]]
\fBunalternates\fP [\fB * \fP | \fIregexp\fP [ \fIregexp\fP [ ... ]] ]
.fi
.IP
@@ -124,7 +126,7 @@ display to messages matching a group.
where you receive mail; you can use regular expressions to specify
alternate addresses. This affects mutt's idea about messages
from you, and messages addressed to you. \fBunalternates\fP removes
-a regular expression from the list of known alternates. The \fB-group\fP flag
+a regular expression from the list of known alternates. The \fB\-group\fP flag
causes all of the subsequent regular expressions to be added to the named
group.
.
.PP
@@ -137,14 +139,15 @@ causes all of the subsequent regular exp
used by mutt to determine which part of a
\fBmultipart/alternative\fP body to display.
A subtype of \(lq\fB*\fP\(rq matches any subtype, as does an empty
-subtype. \fBunalternative_order\fP removes entries from the
-ordered list or deletes the entire list when \(lq\fB*\fP\(rq is used
-as an argument.
+subtype.
+\fBunalternative_order\fP removes entries from the ordered list
+or deletes the entire list
+when \(lq\fB*\fP\(rq is used as an argument.
.
.PP
.nf
-\fBattachments\fP [ \fB+\fP | \fB-\fP ]\fIdisposition\fP \fImime-type\fP
-\fBunattachments\fP [ \fB+\fP | \fB-\fP ]\fIdisposition\fI \fImime-type\fP
+\fBattachments\fP [ \fB+\fP | \fB\-\fP ]\fIdisposition\fP \fImime-type\fP
+\fBunattachments\fP [ \fB+\fP | \fB\-\fP ]\fIdisposition\fI \fImime-type\fP
\fBattachments\fP \fB?\fP
\fBunattachments\fP \fB*\fP
.fi
@@ -152,7 +155,7 @@ as an argument.
\fBattachments\fP specifies what kinds of attachments are used for Mutt's
attachment counting and searching support.
.IP
-\fIdisposition\fP is the attachment's Content-Disposition type - either
+\fIdisposition\fP is the attachment's Content-Disposition type \(en either
inline or attachment. You can abbreviate this to I or A.
.IP
The first part of a message or multipart group, if inline, is counted
@@ -161,9 +164,9 @@ to count these as attachments. If this f
multipart/alternative, note that its top-level inline parts are also
counted via root disposition (if $count_alternatives is set).
.IP
-\fIdisposition\fP is prefixed by either a \fB+\fP symbol or a \fB-\fP
+\fIdisposition\fP is prefixed by either a \fB+\fP symbol or a \fB\-\fP
symbol. If it's a \fB+\fP, you're saying that you want to allow this
-disposition and MIME type to qualify. If it's a \fB-\fP, you're saying
+disposition and MIME type to qualify. If it's a \fB\-\fP, you're saying
that this disposition and MIME type is an exception to previous \fB+\fP
rules.
.IP
@@ -179,7 +182,7 @@ The MIME types you give to the attachmen
pattern. When you use the attachments directive, the patterns you
specify are added to a list. When you use unattachments, the pattern
is removed from the list. The patterns are not expanded and matched to
-specific MIME types at this time - they're just text in a
+specific MIME types at this time \(en they're just text in a
list. They're only matched when actually evaluating a message.
.
.PP
@@ -190,11 +193,11 @@ list. They're only matched when actually
.IP
This commands permits you to specify that mutt should automatically
convert the given MIME types to text/plain when displaying messages.
-For this to work, there must be a
+For this to work, there must be a
.BR mailcap (5)
-entry for the given MIME type with the
+entry for the given MIME type with the
.B copiousoutput
-flag set. A subtype of \(lq\fB*\fP\(rq
+flag set. A subtype of \(lq\fB*\fP\(rq
matches any subtype, as does an empty subtype.
.
.PP
@@ -205,7 +208,7 @@ matches any subtype, as does an empty su
.IP
This command permits you to define a list of "data" MIME content
types for which mutt will try to determine the actual file type from
-the file name, and not use a
+the file name, and not use a
.BR mailcap (5)
entry given for the original MIME type. For instance, you may add
the \fBapplication/octet-stream\fP MIME type to this list.
@@ -217,10 +220,10 @@ to the given \fIfunction\fP. Multiple ma
separating them with commas (no whitespace is allowed).
.IP
Valid maps are:
-.BR generic ", " alias ", " attach ", "
-.BR browser ", " editor ", "
-.BR index ", " compose ", "
-.BR pager ", " pgp ", " postpone ", "
+.BR generic ", " alias ", " attach ,
+.BR browser ", " editor ,
+.BR index ", " compose ,
+.BR pager ", " pgp ", " postpone ,
.BR mix .
.IP
For more information on keys and functions, please consult the Mutt
@@ -241,9 +244,9 @@ name not known to mutt.
.TP
\fBiconv-hook\fP \fIcharset\fP \fIlocal-charset\fP
This command defines a system-specific name for a character set.
-This is useful when your system's
+This is useful when your system's
.BR iconv (3)
-implementation does not understand MIME character set names (such as
+implementation does not understand MIME character set names (such as
.BR iso-8859-1 ),
but instead insists on being fed with implementation-specific
character set names (such as
@@ -286,13 +289,13 @@ specify multiple maps, put only a comma
If your terminal supports color, these commands can be used to
assign \fIforeground\fP/\fIbackground\fP combinations to certain
objects. Valid objects are:
-.BR attachment ", " body ", " bold ", " error ", " header ", "
-.BR hdrdefault ", " index ", " indicator ", " markers ", "
-.BR message ", " normal ", " prompt ", " quoted ", " quoted\fIN\fP ", "
-.BR search ", " signature ", " status ", " tilde ", " tree ", "
+.BR attachment ", " body ", " bold ", " error ", " header ,
+.BR hdrdefault ", " index ", " indicator ", " markers ,
+.BR message ", " normal ", " prompt ", " quoted ", " quoted\fIN\fP ,
+.BR search ", " signature ", " status ", " tilde ", " tree ,
.BR underline .
If the sidebar is enabled the following objects are also valid:
-.BR sidebar_divider ", " sidebar_flagged ", " sidebar_highlight ", "
+.BR sidebar_divider ", " sidebar_flagged ", " sidebar_highlight ,
.BR sidebar_indicator ", " sidebar_new ", " sidebar_spoolfile .
The
.BR body " and " header
@@ -301,15 +304,15 @@ expression. The \fBindex\fP object perm
messages by pattern.
.IP
Valid composeobjects include
-.BR header ", " security_encrypt ", " security_sign ", "
+.BR header ", " security_encrypt ", " security_sign ,
.BR security_both ", " security_none .
.IP
Valid colors include:
-.BR white ", " black ", " green ", " magenta ", " blue ", "
+.BR white ", " black ", " green ", " magenta ", " blue ,
.BR cyan ", " yellow ", " red ", " default ", " color\fIN\fP .
.IP
Valid attributes include:
-.BR none ", " bold ", " underline ", "
+.BR none ", " bold ", " underline ,
.BR reverse ", and " standout .
.
.PP
@@ -332,9 +335,9 @@ the above mentioned list of ignored head
.
.PP
.nf
-\fBlists\fP [\fB-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP ... ]
+\fBlists\fP [\fB\-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP ... ]
\fBunlists\fP \fIregexp\fP [ \fIregexp\fP ... ]
-\fBsubscribe\fP [\fB-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP ... ]
+\fBsubscribe\fP [\fB\-group\fP \fIname\fP] \fIregexp\fP [ \fIregexp\fP ... ]
\fBunsubscribe\fP \fIregexp\fP [ \fIregexp\fP ... ]
.fi
.IP
@@ -347,7 +350,7 @@ known mailing lists. The \fBunlists\fP
list from the lists of known and subscribed mailing lists. The
\fBsubscribe\fP command adds a mailing list to the lists of known
and subscribed mailing lists. The \fBunsubscribe\fP command removes
-it from the list of subscribed mailing lists. The \fB-group\fP flag
+it from the list of subscribed mailing lists. The \fB\-group\fP flag
adds all of the subsequent regular expressions to the named group.
.
.TP
@@ -360,9 +363,9 @@ The first matching \fBmbox-hook\fP appli
.
.PP
.nf
-\fBmailboxes\fP [[\fB-notify\fP | \fB-nonotify\fP]
- [\fB-poll\fP | \fB-nopoll\fP]
- [[\fB-label\fP \fIlabel\fP] | \fB-nolabel\fP]
+\fBmailboxes\fP [[\fB\-notify\fP | \fB\-nonotify\fP]
+ [\fB\-poll\fP | \fB\-nopoll\fP]
+ [[\fB\-label\fP \fIlabel\fP] | \fB\-nolabel\fP]
\fIfilename\fP] [ ... ]
\fBunmailboxes\fP [ \fB*\fP | \fIfilename\fP ... ]
.fi
@@ -461,8 +464,8 @@ used. The hook's \fIformat-string\fP is
.fi
.IP
These commands provide a way to handle compressed folders. The given
-\fBregexp\fP specifies which folders are taken as compressed (e.g.
-"\fI\\\\.gz$\fP"). The commands tell Mutt how to uncompress a folder
+\fBregexp\fP specifies which folders are taken as compressed (e.g.\&
+"\fI\e\e.gz$\fP"). The commands tell Mutt how to uncompress a folder
(\fBopen-hook\fP), compress a folder (\fBclose-hook\fP) or append a
compressed mail to a compressed folder (\fBappend-hook\fP). The
\fIcommand\fP string is the
@@ -516,8 +519,8 @@ a positive integer value.
.IP
String variables consist of any number of printable characters.
Strings must be enclosed in quotes if they contain spaces or tabs.
-You may also use the \(lqC\(rq escape sequences \fB\\n\fP and
-\fB\\t\fP for newline and tab, respectively.
+You may also use the \(lqC\(rq escape sequences \fB\en\fP and
+\fB\et\fP for newline and tab, respectively.
.IP
Quadoption variables are used to control whether or not to be
prompted for certain actions, or to specify a default action. A
@@ -597,7 +600,7 @@ substitutions will be removed.
\fBunhook\fP [\fB * \fP | \fIhook-type\fP ]
This command will remove all hooks of a given type, or all hooks
when \(lq\fB*\fP\(rq is used as an argument. \fIhook-type\fP
-can be any of the \fB-hook\fP commands documented above.
+can be any of the \fB\-hook\fP commands documented above.
.
.PP
.nf
@@ -607,7 +610,7 @@ can be any of the \fB-hook\fP commands d
.IP
These commands allow the user to modify the list of allowed header
fields in a \fImailto:\fP URL that Mutt will include in the
-the generated message. By default the list contains only
+generated message. By default the list contains only
\fBsubject\fP and \fBbody\fP, as specified by RFC2368.
.
.TP
@@ -681,7 +684,7 @@ messages either to: or cc: \fIEXPR\fP
%C \fIGROUP\fP
messages either to: or cc: to any member of \fIGROUP\fP
.TP
-~d \fIMIN\fP-\fIMAX\fP
+~d \fIMIN\fP\(en\fIMAX\fP
messages with \(lqdate-sent\(rq in a Date range
.TP
~D
@@ -735,13 +738,13 @@ messages either originated or received b
%L \fIGROUP\fP
messages either originated or received by any member of \fIGROUP\fP
.TP
-~m \fIMIN\fP-\fIMAX\fP
+~m \fIMIN\fP\(en\fIMAX\fP
message in the range \fIMIN\fP to \fIMAX\fP
.TP
~M \fIEXPR\fP
messages which contain a mime Content-Type matching \fIEXPR\fP
.TP
-~n \fIMIN\fP-\fIMAX\fP
+~n \fIMIN\fP\(en\fIMAX\fP
messages with a score in the range \fIMIN\fP to \fIMAX\fP
.TP
~N
@@ -759,7 +762,7 @@ messages from you (consults $from, \fBal
~Q
messages which have been replied to
.TP
-~r \fIMIN\fP-\fIMAX\fP
+~r \fIMIN\fP\(en\fIMAX\fP
messages with \(lqdate-received\(rq in a Date range
.TP
~R
@@ -792,13 +795,13 @@ cryptographically verified messages
~x \fIEXPR\fP
messages which contain \fIEXPR\fP in the \(lqReferences\(rq or
\(lqIn-Reply-To\(rq field
.TP
-~X \fIMIN\fP-\fIMAX\fP
-messages with MIN - MAX attachments
+~X \fIMIN\fP\(en\fIMAX\fP
+messages with MIN \- MAX attachments
.TP
~y \fIEXPR\fP
messages which contain \fIEXPR\fP in the \(lqX-Label\(rq field
.TP
-~z \fIMIN\fP-\fIMAX\fP
+~z \fIMIN\fP\(en\fIMAX\fP
messages with a size in the range \fIMIN\fP to \fIMAX\fP
.TP
~=
@@ -808,13 +811,13 @@ duplicated messages (see $duplicate_thre
unreferenced message (requires threaded view)
.TP
~(PATTERN)
-messages in threads containing messages matching a certain pattern, e.g. all
threads containing messages from you: ~(~P)
+messages in threads containing messages matching a certain pattern, e.g.\& all
threads containing messages from you: ~(~P)
.TP
~<(PATTERN)
-messages whose immediate parent matches PATTERN, e.g. replies to your
messages: ~<(~P)
+messages whose immediate parent matches PATTERN, e.g.\& replies to your
messages: ~<(~P)
.TP
~>(PATTERN)
-messages having an immediate child matching PATTERN, e.g. messages you replied
to: ~>(~P)
+messages having an immediate child matching PATTERN, e.g.\& messages you
replied to: ~>(~P)
.PD 1
.DT
.PP
@@ -822,7 +825,7 @@ In the above, \fIEXPR\fP is a regular ex
.PP
With the \fB~d\fP, \fB~m\fP, \fB~n\fP, \fB~r\fP, \fB~X\fP, and \fB~z\fP
modifiers, you can also
specify ranges in the forms \fB<\fP\fIMAX\fP, \fB>\fP\fIMIN\fP,
-\fIMIN\fP\fB-\fP, and \fB-\fP\fIMAX\fP.
+\fIMIN\fP\fB\-\fP, and \fB\-\fP\fIMAX\fP.
.PP
With the \fB~z\fP modifier, the suffixes \(lqK\(rq and \(lqM\(rq are allowed
to specify
kilobyte and megabyte respectively.
@@ -856,7 +859,7 @@ Alternatively, you may use \fIYYYYMMDD\f
.PP
If a date range consists of a single date, the modifier in question
will match that precise date. If the date range consists of a dash
-(\(lq\fB-\fP\(rq), followed by a date, this range will match any
+(\(lq\fB\-\fP\(rq), followed by a date, this range will match any
date before and up to the date given. Similarly, a date followed by
a dash matches the date given and any later point of time. Two
dates, separated by a dash, match any date which lies in the given
@@ -865,7 +868,7 @@ range of time.
You can also modify any absolute date by giving an error range. An
error range consists of one of the characters
.BR + ,
-.BR - ,
+.BR \- ,
.BR * ,
followed by a positive number, followed by one of the unit
characters
@@ -873,16 +876,16 @@ characters
.BR m ,
.BR w ", or"
.BR d ,
-specifying a unit of years, months, weeks, or days.
+specifying a unit of years, months, weeks, or days.
.B +
increases the maximum date matched by the given interval of time,
-.B -
+.B \-
decreases the minimum date matched by the given interval of time, and
.B *
increases the maximum date and decreases the minimum date matched by
the given interval of time. It is possible to give multiple error
margins, which cumulate. Example:
-.B "1/1/2001-1w+2w*3d"
+.B 1/1/2001-1w+2w*3d
.PP
You can also specify offsets relative to the current date. An
offset is specified as one of the characters
@@ -901,7 +904,7 @@ characters
.B >
matches dates which are older than the specified amount of time, an
offset which begins with the character
-.B <
+.B <
matches dates which are more recent than the specified amount of time,
and an offset which begins with the character
.B =
@@ -992,23 +995,23 @@ Default: \(lq%4n %2f %t %\-10a %r\(rq
.fi
.IP
Specifies the format of the data displayed for the \(lqalias\(rq menu. The
-following \fBprintf(3)\fP\-style sequences are available:
+following \fBprintf\fP(3)\-style sequences are available:
.RS
.PD 0
.TP
-%a
+%a
alias name
.TP
-%f
+%f
flags \- currently, a \(lqd\(rq for an alias marked for deletion
.TP
-%n
+%n
index number
.TP
-%r
+%r
address which alias expands to
.TP
-%t
+%t
character which indicates if the alias is tagged for inclusion
.RE
.PD 1
@@ -1055,7 +1058,7 @@ Type: boolean
Default: no
.fi
.IP
-When \fIset\fP, an arrow (\(lq\->\(rq) will be used to indicate the current
entry
+When \fIset\fP, an arrow (\(lq\(->\(rq) will be used to indicate the current
entry
in menus instead of highlighting the whole line. On slow network or modem
links this will make response faster because there is less that has to
be redrawn on the screen when moving to the next or previous entries
@@ -1154,69 +1157,69 @@ Default: \(lq%u%D%I %t%4n %T%.40d%> [%.7
.fi
.IP
This variable describes the format of the \(lqattachment\(rq menu. The
-following \fBprintf(3)\fP\-style sequences are understood:
+following \fBprintf\fP(3)\-style sequences are understood:
.RS
.PD 0
.TP
-%C
+%C
charset
.TP
-%c
+%c
requires charset conversion (\(lqn\(rq or \(lqc\(rq)
.TP
-%D
+%D
deleted flag
.TP
-%d
+%d
description (if none, falls back to %F)
.TP
-%e
+%e
MIME content\-transfer\-encoding
.TP
-%F
+%F
filename in content\-disposition header (if none, falls back to %f)
.TP
-%f
+%f
filename
.TP
-%I
+%I
disposition (\(lqI\(rq for inline, \(lqA\(rq for attachment)
.TP
-%m
+%m
major MIME type
.TP
-%M
+%M
MIME subtype
.TP
-%n
+%n
attachment number
.TP
-%Q
+%Q
\(lqQ\(rq, if MIME part qualifies for attachment counting
.TP
-%s
+%s
size (see formatstrings-size)
.TP
-%t
+%t
tagged flag
.TP
-%T
+%T
graphic tree characters
.TP
-%u
+%u
unlink (=to delete) flag
.TP
-%X
+%X
number of qualifying MIME parts in this part and its children
(please see the \(lqattachments\(rq section for possible speed effects)
.TP
-%>X
+%>X
right justify the rest of the string and pad with character \(lqX\(rq
.TP
-%|X
+%|X
pad to the end of the line with character \(lqX\(rq
.TP
-%*X
+%*X
soft\-fill with character \(lqX\(rq as pad
.RE
.PD 1
@@ -1248,7 +1251,7 @@ The default directory to save attachment
If it doesn't exist, Mutt will prompt to create the directory before
saving.
.IP
-If the path is invalid (e.g. not a directory, or cannot be
+If the path is invalid (e.g.\& not a directory, or cannot be
chdir'ed to), Mutt will fall back to using the current directory.
@@ -1256,7 +1259,7 @@ chdir'ed to), Mutt will fall back to usi
.B attach_sep
.nf
Type: string
-Default: \(lq\\n\(rq
+Default: \(lq\en\(rq
.fi
.IP
The separator to add between attachments when operating (saving,
@@ -1285,7 +1288,7 @@ Default: \(lqOn %d, %n wrote:\(rq
.fi
.IP
This is the string that will precede a message which has been included
-in a reply. For a full listing of defined \fBprintf(3)\fP\-like sequences see
+in a reply. For a full listing of defined \fBprintf\fP(3)\-like sequences see
the section on $index_format.
@@ -1296,8 +1299,8 @@ Type: string
Default: \(lq\(rq
.fi
.IP
-The locale used by \fBstrftime(3)\fP to format dates in the
-attribution string. Legal values are the strings your system
+The locale used by \fBstrftime\fP(3) to format dates in the
+attribution string. Valid values are the strings your system
accepts for the locale environment variable \fB$LC_TIME\fP.
.IP
This variable is to allow the attribution date format to be
@@ -1354,23 +1357,23 @@ Default: \(lq%4n %\-30a %20p %10s\(rq
.fi
.IP
This variable describes the format of the \(lqautocrypt account\(rq menu.
-The following \fBprintf(3)\fP\-style sequences are understood
+The following \fBprintf\fP(3)\-style sequences are understood
.RS
.PD 0
.TP
-%a
+%a
email address
.TP
-%k
+%k
gpg keyid
.TP
-%n
+%n
current entry number
.TP
-%p
+%p
prefer\-encrypt flag
.TP
-%s
+%s
status flag (active/inactive)
.RE
.PD 1
@@ -1466,30 +1469,30 @@ Default: \(lq%10S %7p %s\(rq
.fi
.IP
This variable describes the format of the \(lqbackground compose\(rq
-menu. The following \fBprintf(3)\fP\-style sequences are
+menu. The following \fBprintf\fP(3)\-style sequences are
understood:
.RS
.PD 0
.TP
-%i
+%i
parent message id (for replies and forwarded messages)
.TP
-%n
+%n
the running number on the menu
.TP
-%p
+%p
pid of the $editor process
.TP
-%r
+%r
comma separated list of \(lqTo:\(rq recipients
.TP
-%R
+%R
comma separated list of \(lqCc:\(rq recipients
.TP
-%s
+%s
subject of the message
.TP
-%S
+%S
status of the $editor process: running/finished
.RE
.PD 1
@@ -1566,7 +1569,7 @@ names in the browser mailbox list, using
shortcuts.
.IP
The default \fB\(rqalpha\(rq\fP setting of $sort_browser uses
-locale\-based sorting (using \fBstrcoll(3)\fP), which ignores some
+locale\-based sorting (using \fBstrcoll\fP(3)), which ignores some
punctuation. This can lead to some situations where the order
doesn't make intuitive sense. In those cases, it may be
desirable to \fIunset\fP this variable.
@@ -1718,20 +1721,20 @@ Default: \(lq\-\- Mutt: Compose [Approx
.IP
Controls the format of the status line displayed in the \(lqcompose\(rq
menu. This string is similar to $status_format, but has its own
-set of \fBprintf(3)\fP\-like sequences:
+set of \fBprintf\fP(3)\-like sequences:
.RS
.PD 0
.TP
-%a
+%a
total number of attachments
.TP
-%h
+%h
local hostname
.TP
-%l
+%l
approximate size (in bytes) of the current message (see formatstrings-size)
.TP
-%v
+%v
Mutt version string
.RE
.PD 1
@@ -1985,14 +1988,14 @@ Default: yes
When set, Mutt will display protected headers in the pager,
and will update the index and header cache with revised headers.
Protected headers are stored inside the encrypted or signed part of an
-an email, to prevent disclosure or tampering.
+email, to prevent disclosure or tampering.
For more information see https://github.com/autocrypt/protected\-headers.
Currently Mutt only supports the Subject header.
.IP
Encrypted messages using protected headers often substitute the exposed
Subject header with a dummy value (see $crypt_protected_headers_subject).
Mutt will update its concept of the correct subject \fBafter\fP the
-message is opened, i.e. via the \fB<display\-message>\fP function.
+message is opened, i.e.\& via the \fB<display\-message>\fP function.
If you reply to a message before opening it, Mutt will end up using
the dummy Subject header, so be sure to open such a message first.
(Crypto only)
@@ -2052,7 +2055,7 @@ Default: no
When set, Mutt will generate protected headers for signed and
encrypted emails.
Protected headers are stored inside the encrypted or signed part of an
-an email, to prevent disclosure or tampering.
+email, to prevent disclosure or tampering.
For more information see https://github.com/autocrypt/protected\-headers.
Currently Mutt only supports the Subject header.
(Crypto only)
@@ -2165,7 +2168,7 @@ Default: \(lq!%a, %b %d, %Y at %I:%M:%S%
.fi
.IP
This variable controls the format of the date printed by the \(lq%d\(rq
-sequence in $index_format. This is passed to the \fBstrftime(3)\fP
+sequence in $index_format. This is passed to the \fBstrftime\fP(3)
function to process the date, see the man page for the proper syntax.
.IP
Unless the first character in the string is a bang (\(lq!\(rq), the month
@@ -2255,7 +2258,7 @@ Type: path
Default: \(lq/usr/bin/mutt_dotlock\(rq
.fi
.IP
-Contains the path of the \fBmutt_dotlock(1)\fP binary to be used by
+Contains the path of the \fBmutt_dotlock\fP(1) binary to be used by
mutt.
@@ -2283,7 +2286,7 @@ set dsn_notify=\(rqfailure,delay\(rq
.IP
\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 \fBsendmail(1)\fP\-compatible interface supporting the \fB\-N\fP
option
+providing a \fBsendmail\fP(1)\-compatible interface supporting the \fB\-N\fP
option
for DSN. For SMTP delivery, DSN support is auto\-detected so that it
depends on the server whether DSN will be used or not.
@@ -2309,7 +2312,7 @@ set dsn_return=hdrs
.IP
\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 \fBsendmail(1)\fP\-compatible interface supporting the \fB\-R\fP
option
+providing a \fBsendmail\fP(1)\-compatible interface supporting the \fB\-R\fP
option
for DSN. For SMTP delivery, DSN support is auto\-detected so that it
depends on the server whether DSN will be used or not.
@@ -2339,7 +2342,7 @@ along with the body of your message.
.IP
Although the compose menu may have localized header labels, the
labels passed to your editor will be standard RFC 2822 headers,
-(e.g. To:, Cc:, Subject:). Headers added in your editor must
+(e.g.\& To:, Cc:, Subject:). Headers added in your editor must
also be RFC 2822 headers, or one of the pseudo headers listed in
\(lqedit-header\(rq. Mutt will not understand localized header
labels, just as it would not when parsing an actual email.
@@ -2545,58 +2548,58 @@ Default: \(lq%2C %t %N %F %2l %\-8.8u %\
.IP
This variable allows you to customize the file browser display to your
personal taste. This string is similar to $index_format, but has
-its own set of \fBprintf(3)\fP\-like sequences:
+its own set of \fBprintf\fP(3)\-like sequences:
.RS
.PD 0
.TP
-%C
+%C
current file number
.TP
-%d
+%d
date/time folder was last modified
.TP
-%D
+%D
date/time folder was last modified using $date_format.
.TP
-%f
+%f
filename (\(lq/\(rq is appended to directory names,
\(lq@\(rq to symbolic links and \(lq*\(rq to executable
files)
.TP
-%F
+%F
file permissions
.TP
-%g
+%g
group name (or numeric gid, if missing)
.TP
-%l
+%l
number of hard links
.TP
-%m
+%m
number of messages in the mailbox *
.TP
-%n
+%n
number of unread messages in the mailbox *
.TP
-%N
+%N
N if mailbox has new mail, blank otherwise
.TP
-%s
+%s
size in bytes (see formatstrings-size)
.TP
-%t
+%t
\(lq*\(rq if the file is tagged, blank otherwise
.TP
-%u
+%u
owner name (or numeric uid, if missing)
.TP
-%>X
+%>X
right justify the rest of the string and pad with character \(lqX\(rq
.TP
-%|X
+%|X
pad to the end of the line with character \(lqX\(rq
.TP
-%*X
+%*X
soft\-fill with character \(lqX\(rq as pad
.RE
.PD 1
@@ -2657,7 +2660,7 @@ Type: quadoption
Default: ask\-yes
.fi
.IP
-When forwarding inline (i.e. $mime_forward \fIunset\fP or
+When forwarding inline (i.e.\& $mime_forward \fIunset\fP or
answered with \(lqno\(rq and $forward_decode \fIset\fP), attachments
which cannot be decoded in a reasonable manner will be attached
to the newly composed message if this quadoption is \fIset\fP or
@@ -2673,7 +2676,7 @@ Default: \(lq\-\-\-\-\- Forwarded messag
.IP
This is the string that will precede a message which has been forwarded
in the main body of a message (when $mime_forward is unset).
-For a full listing of defined \fBprintf(3)\fP\-like sequences see
+For a full listing of defined \fBprintf\fP(3)\-like sequences see
the section on $index_format. See also $attribution_locale.
@@ -2686,7 +2689,7 @@ Default: \(lq\-\-\-\-\- End forwarded me
.IP
This is the string that will follow a message which has been forwarded
in the main body of a message (when $mime_forward is unset).
-For a full listing of defined \fBprintf(3)\fP\-like sequences see
+For a full listing of defined \fBprintf\fP(3)\-like sequences see
the section on $index_format. See also $attribution_locale.
@@ -3040,9 +3043,9 @@ as the domain part (after \(lq@\(rq) for
Message\-Id headers.
.IP
Its value is determined at startup as follows: the node's
-hostname is first determined by the \fBuname(3)\fP function. The
-domain is then looked up using the \fBgethostname(2)\fP and
-\fBgetaddrinfo(3)\fP functions. If those calls are unable to
+hostname is first determined by the \fBuname\fP(3) function. The
+domain is then looked up using the \fBgethostname\fP(2) and
+\fBgetaddrinfo\fP(3) functions. If those calls are unable to
determine the domain, the full value returned by uname is used.
Optionally, Mutt can be compiled with a fixed domain name in
which case a detected one is not used.
@@ -3120,7 +3123,7 @@ Default: \(lq\(rq
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 \(lqlogin\(rq or the right
-side of an IMAP \(lqAUTH=xxx\(rq capability string, e.g. \(lqdigest\-md5\(rq,
\(lqgssapi\(rq
+side of an IMAP \(lqAUTH=xxx\(rq capability string, e.g.\&
\(lqdigest\-md5\(rq, \(lqgssapi\(rq
or \(lqcram\-md5\(rq. 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.
@@ -3224,7 +3227,7 @@ servers before displaying the index menu
headers for spam detection.
.IP
\fBNote:\fP This is a space separated list, items should be uppercase
-and not contain the colon, e.g. \(lqX\-BOGOSITY X\-SPAM\-STATUS\(rq for the
+and not contain the colon, e.g.\& \(lqX\-BOGOSITY X\-SPAM\-STATUS\(rq for the
\(lqX\-Bogosity:\(rq and \(lqX\-Spam\-Status:\(rq header fields.
@@ -3477,7 +3480,7 @@ The value of this option is ignored if $
the quoting mechanism is strictly defined for format=flowed.
.IP
This option is a format string, please see the description of
-$index_format for supported \fBprintf(3)\fP\-style sequences.
+$index_format for supported \fBprintf\fP(3)\-style sequences.
.TP
@@ -3491,158 +3494,160 @@ This variable allows you to customize th
your personal taste.
.IP
\(lqFormat strings\(rq are similar to the strings used in the C
-function \fBprintf(3)\fP to format output (see the man page for more details).
+function \fBprintf\fP(3) to format output (see the man page for more details).
For an explanation of the %? construct, see the $status_format description.
The following sequences are defined in Mutt:
.RS
.PD 0
.TP
-%a
+%a
address of the author
.TP
-%A
+%A
reply\-to address (if present; otherwise: address of author)
.TP
-%b
+%b
filename of the original message folder (think mailbox)
.TP
-%B
+%B
the list to which the letter was sent, or else the folder name (%b).
.TP
-%c
+%c
number of characters (bytes) in the message (see formatstrings-size)
.TP
-%C
+%C
current message number
.TP
-%d
+%d
date and time of the message in the format specified by
$date_format converted to sender's time zone
.TP
-%D
+%D
date and time of the message in the format specified by
$date_format converted to the local time zone
.TP
-%e
+%e
current message number in thread
.TP
-%E
+%E
number of messages in current thread
.TP
-%f
+%f
sender (address + real name), either From: or Return\-Path:
.TP
-%F
+%F
author name, or recipient name if the message is from you
.TP
-%H
+%H
spam attribute(s) of this message
.TP
-%i
+%i
message\-id of the current message
.TP
-%l
+%l
number of lines in the unprocessed message (may not work with
maildir, mh, and IMAP folders)
.TP
-%L
+%L
If an address in the \(lqTo:\(rq or \(lqCc:\(rq header field matches an address
defined by the users \(lqsubscribe\(rq command, this displays
\(rqTo <list\-name>\(rq, otherwise the same as %F.
.TP
-%m
+%m
total number of message in the mailbox
.TP
-%M
+%M
number of hidden messages if the thread is collapsed.
.TP
-%N
+%N
message score
.TP
-%n
+%n
author's real name (or address if missing)
.TP
-%O
+%O
original save folder where mutt would formerly have
stashed the message: list name or recipient name
if not sent to a list
.TP
-%P
+%P
progress indicator for the built\-in pager (how much of the file has been
displayed)
.TP
-%r
+%r
comma separated list of \(lqTo:\(rq recipients
.TP
-%R
+%R
comma separated list of \(lqCc:\(rq recipients
.TP
-%s
+%s
subject of the message
.TP
-%S
-single character status of the message
(\(lqN\(rq/\(lqO\(rq/\(lqD\(rq/\(lqd\(rq/\(lq!\(rq/\(lqr\(rq/\(lq*\(rq)
+%S
+single character status of the message
+(\(lqN\(rq/\(lqO\(rq/\(lqD\(rq/\(lqd\(rq/\(lq!\(rq/\(lqr\(rq/\(lq*\(rq)
.TP
-%t
+%t
\(lqTo:\(rq field (recipients)
.TP
-%T
+%T
the appropriate character from the $to_chars string
.TP
-%u
+%u
user (login) name of the author
.TP
-%v
+%v
first name of the author, or the recipient if the message is from you
.TP
-%X
+%X
number of attachments
(please see the \(lqattachments\(rq section for possible speed effects)
.TP
-%y
+%y
\(lqX\-Label:\(rq field, if present
.TP
-%Y
+%Y
\(lqX\-Label:\(rq field, if present, and \fI(1)\fP not at part of a thread
tree,
\fI(2)\fP at the top of a thread, or \fI(3)\fP \(lqX\-Label:\(rq is different
from
preceding message's \(lqX\-Label:\(rq.
.TP
-%Z
+%Z
a three character set of message status flags.
the first character is new/read/replied flags
(\(lqn\(rq/\(lqo\(rq/\(lqr\(rq/\(lqO\(rq/\(lqN\(rq).
-the second is deleted or encryption flags
(\(lqD\(rq/\(lqd\(rq/\(lqS\(rq/\(lqP\(rq/\(lqs\(rq/\(lqK\(rq).
+the second is deleted or encryption flags
+(\(lqD\(rq/\(lqd\(rq/\(lqS\(rq/\(lqP\(rq/\(lqs\(rq/\(lqK\(rq).
the third is either tagged/flagged (\(lq*\(rq/\(lq!\(rq), or one of the
characters
listed in $to_chars.
.TP
-%@name@
+%@name@
insert and evaluate format\-string from the matching
\(lqindex-format-hook\(rq command
.TP
-%{fmt}
+%{fmt}
the date and time of the message is converted to sender's
time zone, and \(lqfmt\(rq is expanded by the library function
-\fBstrftime(3)\fP; a leading bang disables locales
+\fBstrftime\fP(3); a leading bang disables locales
.TP
-%[fmt]
+%[fmt]
the date and time of the message is converted to the local
time zone, and \(lqfmt\(rq is expanded by the library function
-\fBstrftime(3)\fP; a leading bang disables locales
+\fBstrftime\fP(3); a leading bang disables locales
.TP
-%(fmt)
+%(fmt)
the local date and time when the message was received.
-\(lqfmt\(rq is expanded by the library function \fBstrftime(3)\fP;
+\(lqfmt\(rq is expanded by the library function \fBstrftime\fP(3);
a leading bang disables locales
.TP
-%<fmt>
+%<fmt>
the current local time. \(lqfmt\(rq is expanded by the library
-function \fBstrftime(3)\fP; a leading bang disables locales.
+function \fBstrftime\fP(3); a leading bang disables locales.
.TP
-%>X
+%>X
right justify the rest of the string and pad with character \(lqX\(rq
.TP
-%|X
+%|X
pad to the end of the line with character \(lqX\(rq
.TP
-%*X
+%*X
soft\-fill with character \(lqX\(rq as pad
.RE
.PD 1
@@ -3797,7 +3802,7 @@ Default: yes
.fi
.IP
Check for Maildir unaware programs other than mutt having modified maildir
-files when the header cache is in use. This incurs one \fBstat(2)\fP per
+files when the header cache is in use. This incurs one \fBstat\fP(2) per
message every time the folder is opened (which can be very slow for NFS
folders).
@@ -3824,7 +3829,7 @@ Default: no
.IP
If \fIset\fP, mutt will poll both the new and cur directories of
a maildir folder for new messages. This might be useful if other
-programs interacting with the folder (e.g. dovecot) are moving new
+programs interacting with the folder (e.g.\& dovecot) are moving new
messages to the cur directory. Note that setting this option may
slow down polling for new messages in large folders, since mutt has
to scan all cur messages.
@@ -3873,7 +3878,7 @@ Also see the $smart_wrap variable.
.B mask
.nf
Type: regular expression
-Default: \(lq!^\\.[^.]\(rq
+Default: \(lq!^\e.[^.]\(rq
.fi
.IP
A regular expression used in the file browser, optionally preceded by
@@ -3982,7 +3987,7 @@ Default: \(lq%s\(rq
.IP
This is the string displayed in the \(lqattachment\(rq menu for
attachments of type \fBmessage/rfc822\fP. For a full listing of defined
-\fBprintf(3)\fP\-like sequences see the section on $index_format.
+\fBprintf\fP(3)\-like sequences see the section on $index_format.
.TP
@@ -4009,44 +4014,44 @@ generally be left at %f.
The old Message\-ID format can be used by setting this to:
\(lq\fB<%Y%02m%02d%02H%02M%02S.G%c%p@%f>\fP\(rq
.IP
-The following \fBprintf(3)\fP\-style sequences are understood:
+The following \fBprintf\fP(3)\-style sequences are understood:
.RS
.PD 0
.TP
-%c
+%c
step counter looping from \(lqA\(rq to \(lqZ\(rq
.TP
-%d
+%d
current day of the month (GMT)
.TP
-%f
+%f
$hostname
.TP
-%H
+%H
current hour using a 24\-hour clock (GMT)
.TP
-%m
+%m
current month number (GMT)
.TP
-%M
+%M
current minute of the hour (GMT)
.TP
-%p
+%p
pid of the running mutt process
.TP
-%r
+%r
3 bytes of pseudorandom data encoded in Base64
.TP
-%S
+%S
current second of the minute (GMT)
.TP
-%x
+%x
1 byte of pseudorandom data hex encoded (example: '1b')
.TP
-%Y
+%Y
current year using 4 digits (GMT)
.TP
-%z
+%z
4 byte timestamp + 8 bytes of pseudorandom data encoded in Base64
.RE
.PD 1
@@ -4209,21 +4214,21 @@ Default: \(lq%4n %c %\-16s %a\(rq
.fi
.IP
This variable describes the format of a remailer line on the mixmaster
-chain selection screen. The following \fBprintf(3)\fP\-like sequences are
+chain selection screen. The following \fBprintf\fP(3)\-like sequences are
supported:
.RS
.PD 0
.TP
-%n
+%n
The running number on the menu.
.TP
-%c
+%c
Remailer capabilities.
.TP
-%s
+%s
The remailer's short name.
.TP
-%a
+%a
The remailer's e\-mail address.
.RE
.PD 1
@@ -4416,17 +4421,17 @@ Default: \(lq%2n %\-15e %d\(rq
.fi
.IP
This variable describes the format of the \(lqpattern completion\(rq menu. The
-following \fBprintf(3)\fP\-style sequences are understood:
+following \fBprintf\fP(3)\-style sequences are understood:
.RS
.PD 0
.TP
-%d
+%d
pattern description
.TP
-%e
+%e
pattern expression
.TP
-%n
+%n
index number
.RE
.PD 1
@@ -4517,7 +4522,7 @@ message. Note that the use of this form
\fBdeprecated\fP.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4531,26 +4536,26 @@ Default: \(lq\(rq
This format strings specifies a command which is used to decode
application/pgp attachments.
.IP
-The PGP command formats have their own set of \fBprintf(3)\fP\-like sequences:
+The PGP command formats have their own set of \fBprintf\fP(3)\-like sequences:
.RS
.PD 0
.TP
-%p
+%p
Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
string otherwise. Note: This may be used with a %? construct.
.TP
-%f
+%f
Expands to the name of a file containing a message.
.TP
-%s
+%s
Expands to the name of a file containing the signature part
- of a \fBmultipart/signed\fP attachment when verifying it.
+of a \fBmultipart/signed\fP attachment when verifying it.
.TP
-%a
+%a
The value of $pgp_sign_as if set, otherwise the value
of $pgp_default_key.
.TP
-%r
+%r
One or more key IDs (or fingerprints if available).
.RE
.PD 1
@@ -4572,7 +4577,7 @@ Default: \(lq\(rq
This command is used to decrypt a PGP encrypted message.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4588,7 +4593,7 @@ message is only considered successfully
from $pgp_decrypt_command contains the text. This is used to
protect against a spoofed encrypted message, with multipart/encrypted
headers but containing a block that is not actually encrypted.
-(e.g. simply signed and ascii armored text).
+(e.g.\& simply signed and ascii armored text).
.IP
Note that if $pgp_check_gpg_decrypt_status_fd is set, this variable
is ignored.
@@ -4622,7 +4627,7 @@ Default: \(lq\(rq
This command is used to encrypt a body part without signing it.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4636,7 +4641,7 @@ Default: \(lq\(rq
This command is used to both sign and encrypt a body part.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4649,36 +4654,36 @@ Default: \(lq%4n %t%f %4l/0x%k %\-4a %2c
.IP
This variable allows you to customize the PGP key selection menu to
your personal taste. This string is similar to $index_format, but
-has its own set of \fBprintf(3)\fP\-like sequences:
+has its own set of \fBprintf\fP(3)\-like sequences:
.RS
.PD 0
.TP
-%n
+%n
number
.TP
-%k
+%k
key id
.TP
-%u
+%u
user id
.TP
-%a
+%a
algorithm
.TP
-%l
+%l
key length
.TP
-%f
+%f
flags
.TP
-%c
+%c
capabilities
.TP
-%t
+%t
trust/validity of the key\-uid association
.TP
-%[<s>]
-date of the key where <s> is an \fBstrftime(3)\fP expression
+%[<s>]
+date of the key where <s> is an \fBstrftime\fP(3) expression
.RE
.PD 1
.IP
@@ -4696,7 +4701,7 @@ This command is used to export a public
key ring.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4709,7 +4714,7 @@ Default: \(lq\(rq
.IP
This command is invoked whenever Mutt needs to fetch the public key associated
with
an email address. Of the sequences supported by $pgp_decode_command, %r is
-the only \fBprintf(3)\fP\-like sequence used with this format. Note that
+the only \fBprintf\fP(3)\-like sequence used with this format. Note that
in this case, %r expands to the email address, not the public key ID (the key
ID is
unknown, which is why Mutt is invoking this command).
(PGP only)
@@ -4753,7 +4758,7 @@ This command is used to import a key fro
the user's public key ring.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4781,7 +4786,7 @@ produces a different date format which m
incorrect key generation dates.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
Note that in this case, %r expands to the search string, which is a list of
one or more quoted values such as email address, name, or keyid.
(PGP only)
@@ -4811,7 +4816,7 @@ produces a different date format which m
incorrect key generation dates.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
Note that in this case, %r expands to the search string, which is a list of
one or more quoted values such as email address, name, or keyid.
(PGP only)
@@ -4824,7 +4829,7 @@ Type: boolean
Default: yes
.fi
.IP
-If \fIset\fP, use 64 bit PGP key IDs, if \fIunset\fP use the normal 32 bit key
IDs.
+If \fIset\fP, use 64-bit PGP key IDs, if \fIunset\fP use the normal 32-bit key
IDs.
NOTE: Internally, Mutt has transitioned to using fingerprints (or long key IDs
as a fallback). This option now only controls the display of key IDs
in the key selection menu and a few other places.
@@ -4925,7 +4930,7 @@ Default: \(lq\(rq
If you have a different key pair to use for signing, you should
set this to the signing key. Most people will only need to set
$pgp_default_key. It is recommended that you use the keyid form
-to specify your key (e.g. \fB0x00112233\fP).
+to specify your key (e.g.\& \fB0x00112233\fP).
(PGP only)
@@ -4940,7 +4945,7 @@ This command is used to create the detac
\fBmultipart/signed\fP PGP/MIME body part.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -4952,20 +4957,20 @@ Default: address
.fi
.IP
Specifies how the entries in the pgp menu are sorted. The
-following are legal values:
+following are valid values:
.RS
.PD 0
.TP
-address
+address
sort alphabetically by user id
.TP
-keyid
+keyid
sort alphabetically by key id
.TP
-date
+date
sort by key creation date
.TP
-trust
+trust
sort by the trust of the key
.RE
.PD 1
@@ -5008,7 +5013,7 @@ Type: boolean
Default: yes
.fi
.IP
-If \fIset\fP, mutt expects a \fBgpg\-agent(1)\fP process will handle
+If \fIset\fP, mutt expects a \fBgpg\-agent\fP(1) process will handle
private key passphrase prompts. If \fIunset\fP, mutt will prompt
for the passphrase and pass it via stdin to the pgp command.
.IP
@@ -5036,7 +5041,7 @@ Default: \(lq\(rq
This command is used to verify PGP signatures.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -5051,7 +5056,7 @@ This command is used to verify key infor
menu.
.IP
This is a format string, see the $pgp_decode_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(PGP only)
@@ -5085,7 +5090,7 @@ controls whether Mutt will weed headers.
.B pipe_sep
.nf
Type: string
-Default: \(lq\\n\(rq
+Default: \(lq\en\(rq
.fi
.IP
The separator to add between messages when piping a list of tagged
@@ -5130,7 +5135,7 @@ Default: \(lq\(rq
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 \(lquser\(rq, \(lqapop\(rq or any
-SASL mechanism, e.g. \(lqdigest\-md5\(rq, \(lqgssapi\(rq or \(lqcram\-md5\(rq.
+SASL mechanism, e.g.\& \(lqdigest\-md5\(rq, \(lqgssapi\(rq or
\(lqcram\-md5\(rq.
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.
@@ -5258,7 +5263,7 @@ Default: \(lq\(rq
.IP
Similar to the $attribution variable, Mutt will append this
string after the inclusion of a message which is being replied to.
-For a full listing of defined \fBprintf(3)\fP\-like sequences see
+For a full listing of defined \fBprintf\fP(3)\-like sequences see
the section on $index_format.
@@ -5324,12 +5329,12 @@ Default: \(lq\(rq
.IP
If \fIset\fP, a shell command to be executed if mutt fails to establish
a connection to the server. This is useful for setting up secure
-connections, e.g. with \fBssh(1)\fP. If the command returns a nonzero
+connections, e.g.\& with \fBssh\fP(1). If the command returns a nonzero
status, mutt gives up opening the server. Example:
.IP
.EX
-set preconnect=\(rqssh \-f \-q \-L 1234:mailhost.net:143 mailhost.net \\
+set preconnect=\(rqssh \-f \-q \-L 1234:mailhost.net:143 mailhost.net \e
sleep 20 < /dev/null > /dev/null\(rq
.EE
@@ -5448,32 +5453,32 @@ Default: \(lq%4c %t %\-25.25a %\-25.25n
.fi
.IP
This variable describes the format of the \(lqquery\(rq menu. The
-following \fBprintf(3)\fP\-style sequences are understood:
+following \fBprintf\fP(3)\-style sequences are understood:
.RS
.PD 0
.TP
-%a
+%a
destination address
.TP
-%c
+%c
current entry number
.TP
-%e
+%e
extra information *
.TP
-%n
+%n
destination name
.TP
-%t
+%t
\(lq*\(rq if current entry is tagged, a space otherwise
.TP
-%>X
+%>X
right justify the rest of the string and pad with \(lqX\(rq
.TP
-%|X
+%|X
pad to the end of the line with \(lqX\(rq
.TP
-%*X
+%*X
soft\-fill with character \(lqX\(rq as pad
.RE
.PD 1
@@ -5500,7 +5505,7 @@ prompted for confirmation when you try t
.B quote_regexp
.nf
Type: regular expression
-Default: \(lq^([ \\t]*[|>:}#])+\(rq
+Default: \(lq^([ \et]*[|>:}#])+\(rq
.fi
.IP
A regular expression used in the internal pager to determine quoted
@@ -5650,7 +5655,7 @@ Also see $wrap.
.B reply_regexp
.nf
Type: regular expression (localized)
-Default: \(lq^(re)(\\[[0\-9]+\\])*:[ \\t]*\(rq
+Default: \(lq^(re)(\e[[0\-9]+\e])*:[ \et]*\(rq
.fi
.IP
A regular expression used to recognize reply messages when
@@ -5664,15 +5669,15 @@ example: \fB\(rq^(re|se)\(rq\fP or \fB\(
.IP
The second parenthesized expression matches zero or more
bracketed numbers following the prefix, such as \fB\(rqRe[1]: \(rq\fP.
-The initial \fB\(rq\\\\[\(rq\fP means a literal left\-bracket character.
+The initial \fB\(rq\e\e[\(rq\fP means a literal left\-bracket character.
Note the backslash must be doubled when used inside a double
quoted string in the muttrc. \fB\(rq[0\-9]+\(rq\fP means one or more
-numbers. \fB\(rq\\\\]\(rq\fP means a literal right\-bracket. Finally the
+numbers. \fB\(rq\e\e]\(rq\fP means a literal right\-bracket. Finally the
whole parenthesized expression has a \fB\(rq*\(rq\fP suffix, meaning it
can occur zero or more times.
.IP
The last part matches a colon followed by an optional space or
-tab. Note \fB\(rq\\t\(rq\fP is converted to a literal tab inside a
+tab. Note \fB\(rq\et\(rq\fP is converted to a literal tab inside a
double quoted string. If you use a single quoted string, you
would have to type an actual tab character, and would need to
convert the double\-backslashes to single backslashes.
@@ -6022,7 +6027,7 @@ Default: \(lq\(rq
This specifies a filter script, which will convert the main
(composed) message of the email to an alternative format. The
message will be piped to the filter's stdin. The expected output
-of the filter is the generated mime type, e.g. text/html,
+of the filter is the generated mime type, e.g.\& text/html,
followed by a blank line, and then the converted content.
See the section \(lqMIME Multipart/Alternative\(rq (alternative-order).
@@ -6043,7 +6048,7 @@ $dsn_notify, or $dsn_return will be adde
.IP
\fBNote:\fP This command is invoked differently from most other
commands in Mutt. It is tokenized by space, and invoked directly
-via \fBexecvp(3)\fP with an array of arguments \- so commands or
+via \fBexecvp\fP(3) with an array of arguments \- so commands or
arguments with spaces in them are not supported. The shell is
not used to run the command, so shell quoting is also not
supported.
@@ -6065,13 +6070,13 @@ Mutt interprets the value of this variab
.RS
.PD 0
.TP
->0
+>0
number of seconds to wait for sendmail to finish before continuing
.TP
-0
+0
wait forever for sendmail to finish
.TP
-<0
+<0
always put sendmail in the background without waiting
.RE
.PD 1
@@ -6153,48 +6158,48 @@ Default: \(lq%B%* %n\(rq
.fi
.IP
This variable allows you to customize the sidebar display. This string is
-similar to $index_format, but has its own set of \fBprintf(3)\fP\-like
+similar to $index_format, but has its own set of \fBprintf\fP(3)\-like
sequences:
.RS
.PD 0
.TP
-%B
+%B
Name of the mailbox
.TP
-%S
+%S
* Size of mailbox (total number of messages)
.TP
-%N
+%N
* Number of unread messages in the mailbox
.TP
-%n
+%n
N if mailbox has new mail, blank otherwise
.TP
-%F
+%F
* Number of Flagged messages in the mailbox
.TP
-%!
+%!
\(lq!\(rq : one flagged message;
\(lq!!\(rq : two flagged messages;
\(lqn!\(rq : n flagged messages (for n > 2).
Otherwise prints nothing.
.TP
-%d
+%d
* @ Number of deleted messages
.TP
-%L
+%L
* @ Number of messages after limiting
.TP
-%t
+%t
* @ Number of tagged messages
.TP
-%>X
+%>X
right justify the rest of the string and pad with \(lqX\(rq
.TP
-%|X
+%|X
pad to the end of the line with \(lqX\(rq
.TP
-%*X
+%*X
soft\-fill with character \(lqX\(rq as pad
.RE
.PD 1
@@ -6264,20 +6269,20 @@ $sidebar_folder_indent=yes, and $sidebar
.RS
.PD 0
.TP
-\fBmailbox\fP
-\fBset\fP
+\fBmailbox\fP
+\fBset\fP
\fBunset\fP
.TP
-\fB=a.b\fP
-\fB=a.b\fP
+\fB=a.b\fP
+\fB=a.b\fP
\fBâb\fP
.TP
-\fB=a.b.c.d\fP
-\fBâc.d\fP
+\fB=a.b.c.d\fP
+\fBâc.d\fP
\fBâââd\fP
.TP
-\fB=a.b.e\fP
-\fBâe\fP
+\fB=a.b.e\fP
+\fBâe\fP
\fBââe\fP
.RE
.PD 1
@@ -6306,24 +6311,24 @@ names relative to the previous name. Her
.RS
.PD 0
.TP
-\fBshortpath=no\fP
-\fBshortpath=yes\fP
+\fBshortpath=no\fP
+\fBshortpath=yes\fP
\fBshortpath=yes, folderindent=yes, indentstr=\(rq..\(rq\fP
.TP
-\fBfruit\fP
-\fBfruit\fP
+\fBfruit\fP
+\fBfruit\fP
\fBfruit\fP
.TP
-\fBfruit.apple\fP
-\fBapple\fP
+\fBfruit.apple\fP
+\fBapple\fP
\fB..apple\fP
.TP
-\fBfruit.banana\fP
-\fBbanana\fP
+\fBfruit.banana\fP
+\fBbanana\fP
\fB..banana\fP
.TP
-\fBfruit.cherry\fP
-\fBcherry\fP
+\fBfruit.cherry\fP
+\fBcherry\fP
\fB..cherry\fP
.RE
.PD 1
@@ -6414,7 +6419,7 @@ Default: yes
If \fIset\fP, a line containing \(lq\-\- \(rq (note the trailing space) will
be inserted before your
$signature. It is \fBstrongly\fP recommended that you not \fIunset\fP
this variable unless your signature contains just your name. The
-reason for this is because many software packages use \(lq\-\- \\n\(rq to
+reason for this is because many software packages use \(lq\-\- \en\(rq to
detect your signature. For example, Mutt has the ability to highlight
the signature in a different color in the built\-in pager.
@@ -6440,9 +6445,10 @@ Default: \(lq~/.signature\(rq
.fi
.IP
Specifies the filename of your signature, which is appended to all
-outgoing messages. If the filename ends with a pipe (\(lq|\(rq), it is
-assumed that filename is a shell command and input should be read from
-its standard output.
+outgoing messages.
+If the filename ends with a pipe (\(lq|\(rq),
+it is assumed that filename is a shell command
+and input should be read from its standard output.
.TP
@@ -6598,34 +6604,34 @@ Default: \(lq\(rq
This format string specifies a command which is used to decrypt
\fBapplication/x\-pkcs7\-mime\fP attachments.
.IP
-The OpenSSL command formats have their own set of \fBprintf(3)\fP\-like
sequences
+The OpenSSL command formats have their own set of \fBprintf\fP(3)\-like
sequences
similar to PGP's:
.RS
.PD 0
.TP
-%f
+%f
Expands to the name of a file containing a message.
.TP
-%s
+%s
Expands to the name of a file containing the signature part
- of a \fBmultipart/signed\fP attachment when verifying it.
+of a \fBmultipart/signed\fP attachment when verifying it.
.TP
-%k
+%k
The key\-pair specified with $smime_default_key
.TP
-%c
+%c
One or more certificate IDs.
.TP
-%a
+%a
The algorithm used for encryption.
.TP
-%d
+%d
The message digest algorithm specified with $smime_sign_digest_alg.
.TP
-%C
+%C
CA location: Depending on whether $smime_ca_location
- points to a directory or file, this expands to
- \(lq\-CApath $smime_ca_location\(rq or \(lq\-CAfile
$smime_ca_location\(rq.
+points to a directory or file, this expands to
+\(lq\-CApath $smime_ca_location\(rq or \(lq\-CAfile $smime_ca_location\(rq.
.RE
.PD 1
.IP
@@ -6682,7 +6688,7 @@ Default: \(lq\(rq
This command is used to create encrypted S/MIME messages.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6708,7 +6714,7 @@ Default: \(lq\(rq
This command is used to extract X509 certificates from a PKCS7 structure.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6724,7 +6730,7 @@ X509 certificates, and for verification
certificate was issued for the sender's mailbox).
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6740,7 +6746,7 @@ signature, so that the certificate's own
email's \(lqFrom:\(rq field.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6754,7 +6760,7 @@ Default: \(lq\(rq
This command is used to import a certificate via smime_keys.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6800,7 +6806,7 @@ This command is used to extract PKCS7 st
in order to extract the public X509 certificate(s).
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6839,7 +6845,7 @@ This command is used to created S/MIME s
\fBmultipart/signed\fP, which can be read by all mail clients.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences. NOTE: %c and %k will default
+possible \fBprintf\fP(3)\-like sequences. NOTE: %c and %k will default
to $smime_sign_as if set, otherwise $smime_default_key.
(S/MIME only)
@@ -6868,7 +6874,7 @@ This command is used to created S/MIME s
clients supporting the S/MIME extension.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6894,7 +6900,7 @@ Default: \(lq\(rq
This command is used to verify S/MIME signatures of type
\fBmultipart/signed\fP.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6909,7 +6915,7 @@ This command is used to verify S/MIME si
\fBapplication/x\-pkcs7\-mime\fP.
.IP
This is a format string, see the $smime_decrypt_command command for
-possible \fBprintf(3)\fP\-like sequences.
+possible \fBprintf\fP(3)\-like sequences.
(S/MIME only)
@@ -6922,7 +6928,7 @@ Default: \(lq\(rq
.IP
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, e.g.
+try them. Authentication methods are any SASL mechanism, e.g.\&
\(lqdigest\-md5\(rq, \(lqgssapi\(rq or \(lqcram\-md5\(rq.
This option is case\-insensitive. If it is \(lqunset\(rq
(the default) mutt will try all available methods, in order from
@@ -7044,7 +7050,7 @@ Default: alias
.fi
.IP
Specifies how the entries in the \(lqalias\(rq menu are sorted. The
-following are legal values:
+following are valid values:
.RS
.PD 0
.TP
@@ -7444,12 +7450,16 @@ Default: \(lq\(rq
.fi
.IP
Contains a colon\-separated list of ciphers to use when using SSL.
-For OpenSSL, see ciphers(1) for the syntax of the string.
+For OpenSSL, see
+.BR ciphers (1)
+for the syntax of the string.
.IP
For GnuTLS, this option will be used in place of \(rqNORMAL\(rq at the
-start of the priority string. See gnutls_priority_init(3) for the
-syntax and more details. (Note: GnuTLS version 2.1.7 or higher is
-required.)
+start of the priority string.
+See
+.BR gnutls_priority_init (3)
+for the syntax and more details.
+(Note: GnuTLS version 2.1.7 or higher is required.)
.TP
@@ -7480,88 +7490,88 @@ Default: \(lq\-%r\-Mutt: %f [Msgs:%?M?%M
.IP
Controls the format of the status line displayed in the \(lqindex\(rq
menu. This string is similar to $index_format, but has its own
-set of \fBprintf(3)\fP\-like sequences:
+set of \fBprintf\fP(3)\-like sequences:
.RS
.PD 0
.TP
-%b
+%b
number of mailboxes with new mail *
.TP
-%B
+%B
number of backgrounded editing sessions *
.TP
-%d
+%d
number of deleted messages *
.TP
-%f
+%f
the full pathname of the current mailbox
.TP
-%F
+%F
number of flagged messages *
.TP
-%h
+%h
local hostname
.TP
-%l
+%l
size (in bytes) of the current mailbox (see formatstrings-size) *
.TP
-%L
+%L
size (in bytes) of the messages shown
(i.e., which match the current limit) (see formatstrings-size) *
.TP
-%m
+%m
the number of messages in the mailbox *
.TP
-%M
+%M
the number of messages shown (i.e., which match the current limit) *
.TP
-%n
+%n
number of new messages in the mailbox *
.TP
-%o
+%o
number of old unread messages *
.TP
-%p
+%p
number of postponed messages *
.TP
-%P
+%P
percentage of the way through the index
.TP
-%r
+%r
modified/read\-only/won't\-write/attach\-message indicator,
according to $status_chars
.TP
-%R
+%R
number of read messages *
.TP
-%s
+%s
current sorting mode ($sort)
.TP
-%S
+%S
current aux sorting method ($sort_aux)
.TP
-%t
+%t
number of tagged messages *
.TP
-%T
+%T
current thread group sorting method ($sort_thread_groups) *
.TP
-%u
+%u
number of unread messages *
.TP
-%v
+%v
Mutt version string
.TP
-%V
+%V
currently active limit pattern, if any *
.TP
-%>X
+%>X
right justify the rest of the string and pad with \(lqX\(rq
.TP
-%|X
+%|X
pad to the end of the line with \(lqX\(rq
.TP
-%*X
+%*X
soft\-fill with character \(lqX\(rq as pad
.RE
.PD 1
@@ -7596,7 +7606,7 @@ You can also switch between two strings
If the value of \fIsequence_char\fP is non\-zero, \fIif_string\fP will
be expanded, otherwise \fIelse_string\fP will be expanded.
.IP
-You can force the result of any \fBprintf(3)\fP\-like sequence to be lowercase
+You can force the result of any \fBprintf\fP(3)\-like sequence to be lowercase
by prefixing the sequence character with an underscore (\(lq_\(rq) sign.
For example, if you want to display the local hostname in lowercase,
you would use: \(lq\fB%_h\fP\(rq.
Any program (person), that produces man pages, should check the output
for defects by using (both groff and nroff)
[gn]roff -mandoc -t -ww -b -z -K utf8 <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
Any "autogenerator" should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
It should also check its input files for too long (> 80) lines.
This is just a simple quality control measure.
The "autogenerator" may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
Not beginning each input sentence on a new line.
Line length should thus be reduced.
The script "reportbug" uses 'quoted-printable' encoding when a line is
longer than 1024 characters in an 'ascii' file.
See man-pages(7), item "semantic newline".
-.-
The difference between the formatted output of the original and patched file
can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -d -u <out1> <out2>
and for groff, using
\"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - \"
instead of 'nroff -mandoc'
Add the option '-t', if the file contains a table.
Read the output from 'diff -d -u ...' with 'less -R' or similar.
-.-.
If 'man' (man-db) is used to check the manual for warnings,
the following must be set:
The option \"-warnings=w\"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT=\"-ww -b -z\"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-
