Rocco Rutte:
[apps/madmutt.git] / doc / manual.txt
1
2                            T\bTh\bhe\be M\bMu\but\btt\bt N\bNe\bex\bxt\bt G\bGe\ben\bne\ber\bra\bat\bti\bio\bon\bn E\bE-\b-M\bMa\bai\bil\bl C\bCl\bli\bie\ben\bnt\bt
3
4                       by Andreas Krennmair <ak@synflood.at> and others
5                 originally based on _\bm_\bu_\bt_\bt by Michael Elkins <me@cs.hmc.edu> and others
6
7                                      version devel-r460
8
9                                           A\bAb\bbs\bst\btr\bra\bac\bct\bt
10
11             Michael Elinks on mutt, circa 1995: ``All mail clients suck. This one just
12             sucks less.'' - Sven Guckes on mutt, ca. 2003: ``But it still sucks!''
13
14        _\b1_\b.  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
15
16        _\b1_\b._\b1  _\bO_\bv_\be_\br_\bv_\bi_\be_\bw
17
18        M\bMu\but\btt\bt-\b-n\bng\bg is a small but very powerful text-based MIME mail client.  Mutt-ng is
19        highly configurable, and is well suited to the mail power user with advanced
20        features like key bindings, keyboard macros, mail threading, regular expression
21        searches and a powerful pattern matching language for selecting groups of mes-
22        sages.
23
24        This documentation additionally contains documentation to M\bMu\but\btt\bt-\b-N\bNG\bG, a fork from
25        Mutt with the goal to fix all the little annoyances of Mutt, to integrate all
26        the Mutt patches that are floating around in the web, and to add other new fea-
27        tures. Features specific to Mutt-ng will be discussed in an extra section.
28        Don't be confused when most of the documentation talk about Mutt and not Mutt-
29        ng, Mutt-ng contains all Mutt features, plus many more.
30
31        _\b1_\b._\b2  _\bM_\bu_\bt_\bt_\b-_\bn_\bg _\bH_\bo_\bm_\be _\bP_\ba_\bg_\be
32
33        http://www.muttng.org
34
35        _\b1_\b._\b3  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
36
37           +\bo mutt-ng-users@lists.berlios.de -- This is where the mutt-ng user support
38             happens.
39
40        The Mutt Next Generation E-Mail Client                                        1
41
42        The Mutt Next Generation E-Mail Client                                        2
43
44           +\bo mutt-ng-devel@lists.berlios.de -- The development mailing list for mutt-ng
45
46        _\b1_\b._\b4  _\bS_\bo_\bf_\bt_\bw_\ba_\br_\be _\bD_\bi_\bs_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn _\bS_\bi_\bt_\be_\bs
47
48        So far, there are no official releases of Mutt-ng, but you can download daily
49        snapshots from http://mutt-ng.berlios.de/snapshots/
50
51        _\b1_\b._\b5  _\bI_\bR_\bC
52
53        Visit channel _\b#_\bm_\bu_\bt_\bt_\bn_\bg on irc.freenode.net (www.freenode.net) to chat with other
54        people interested in Mutt-ng.
55
56        _\b1_\b._\b6  _\bW_\be_\bb_\bl_\bo_\bg
57
58        If you want to read fresh news about the latest development in Mutt-ng, and get
59        informed about stuff like interesting, Mutt-ng-related articles and packages
60        for your favorite distribution, you can read and/or subscribe to our Mutt-ng
61        development weblog.
62
63        _\b1_\b._\b7  _\bC_\bo_\bp_\by_\br_\bi_\bg_\bh_\bt
64
65        Mutt is Copyright (C) 1996-2000 Michael R. Elkins <me@cs.hmc.edu> and others
66
67        This program is free software; you can redistribute it and/or modify it under
68        the terms of the GNU General Public License as published by the Free Software
69        Foundation; either version 2 of the License, or (at your option) any later ver-
70        sion.
71
72        This program is distributed in the hope that it will be useful, but WITHOUT ANY
73        WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
74        PARTICULAR PURPOSE.  See the GNU General Public License for more details.
75
76        You should have received a copy of the GNU General Public License along with
77        this program; if not, write to the Free Software Foundation, Inc., 59 Temple
78        Place - Suite 330, Boston, MA  02111, USA.
79
80        _\b2_\b.  _\bG_\be_\bt_\bt_\bi_\bn_\bg _\bS_\bt_\ba_\br_\bt_\be_\bd
81
82        _\b2_\b._\b1  _\bB_\ba_\bs_\bi_\bc _\bC_\bo_\bn_\bc_\be_\bp_\bt_\bs
83
84        The Mutt Next Generation E-Mail Client                                        3
85
86        _\b2_\b._\b1_\b._\b1  _\bS_\bc_\br_\be_\be_\bn_\bs _\ba_\bn_\bd _\bM_\be_\bn_\bu_\bs
87
88        mutt-ng offers different screens of which every has its special purpose:
89
90           +\bo The _\bi_\bn_\bd_\be_\bx displays the contents of the currently opened mailbox.
91
92           +\bo The _\bp_\ba_\bg_\be_\br is responsible for displaying messages, that is, the header, the
93             body and all attached parts.
94
95           +\bo The _\bf_\bi_\bl_\be _\bb_\br_\bo_\bw_\bs_\be_\br offers operations on and displays information of all
96             folders mutt-ng should watch for mail.
97
98           +\bo The _\bs_\bi_\bd_\be_\bb_\ba_\br offers a permanent view of which mailboxes contain how many
99             total, new and/or flagged mails.
100
101           +\bo The _\bh_\be_\bl_\bp _\bs_\bc_\br_\be_\be_\bn lists for all currently available commands how to invoke
102             them as well as a short description.
103
104           +\bo The _\bc_\bo_\bm_\bp_\bo_\bs_\be menu is a comfortable interface take last actions before send-
105             ing mail: change subjects, attach files, remove attachements, etc.
106
107           +\bo The _\ba_\bt_\bt_\ba_\bc_\bh_\be_\bm_\be_\bn_\bt menu gives a summary and the tree structure of the
108             attachements of the current message.
109
110           +\bo The _\ba_\bl_\bi_\ba_\bs menu lists all or a fraction of the aliases a user has defined.
111
112           +\bo The _\bk_\be_\by menu used in connection with encryption lets users choose the
113             right key to encrypt with.
114
115        When mutt-ng is started without any further options, it'll open the users
116        default mailbox and display the index.
117
118        _\b2_\b._\b1_\b._\b2  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn
119
120        Mutt-ng does _\bn_\bo_\bt feature an internal configuration interface or menu due to the
121        simple fact that this would be too complex to handle (currently there are sev-
122        eral _\bh_\bu_\bn_\bd_\br_\be_\bd variables which fine-tune the behaviour.)
123
124        Mutt-ng is configured using configuration files which allow users to add com-
125        ments or manage them via version control systems to ease maintenance.
126
127        Also, mutt-ng comes with a shell script named grml-muttng kindly contributed by
128        users which really helps and eases the creation of a user's configuration file.
129        When downloading the source code via a snapshot or via subversion, it can be
130        found in the contrib directory.
131
132        _\b2_\b._\b1_\b._\b3  _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
133
134        Mutt-ng offers great flexibility due to the use of functions: internally, every
135        action a user can make mutt-ng perform is named ``function.'' Those functions
136
137        The Mutt Next Generation E-Mail Client                                        4
138
139        are assigned to keys (or even key sequences) and may be completely adjusted to
140        user's needs. The basic idea is that the impatient users get a very intuitive
141        interface to start off with and advanced users virtually get no limits to
142        adjustments.
143
144        _\b2_\b._\b1_\b._\b4  _\bI_\bn_\bt_\be_\br_\ba_\bc_\bt_\bi_\bo_\bn
145
146        Mutt-ng has two basic concepts of user interaction:
147
148          1.  There is one dedicated line on the screen used to query the user for
149              input, issue any command, query variables and display error and informa-
150              tional messages. As for every type of user input, this requires manual
151              action leading to the need of input.
152
153          2.  The automatized interface for interaction are the so called _\bh_\bo_\bo_\bk_\bs. Hooks
154              specify actions the user wants to be performed at well-defined situa-
155              tions: what to do when entering which folder, what to do when displaying
156              or replying to what kind of message, etc. These are optional, i.e. a user
157              doesn't need to specify them but can do so.
158
159        _\b2_\b._\b1_\b._\b5  _\bM_\bo_\bd_\bu_\bl_\ba_\br_\bi_\bz_\ba_\bt_\bi_\bo_\bn
160
161        Although mutt-ng has many functionality built-in, many features can be dele-
162        gated to external tools to increase flexibility: users can define programs to
163        filter a message through before displaying, users can use any program they want
164        for displaying a message, message types (such as PDF or PostScript) for which
165        mutt-ng doesn't have a built-in filter can be rendered by arbitrary tools and
166        so forth. Although mutt-ng has an alias mechanism built-in, it features using
167        external tools to query for nearly every type of addresses from sources like
168        LDAP, databases or just the list of locally known users.
169
170        _\b2_\b._\b1_\b._\b6  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
171
172        Mutt-ng has a built-in pattern matching ``language'' which is as widely used as
173        possible to present a consistent interface to users. The same ``pattern terms''
174        can be used for searching, scoring, message selection and much more.
175
176        _\b2_\b._\b2  _\bS_\bc_\br_\be_\be_\bn_\bs _\ba_\bn_\bd _\bM_\be_\bn_\bu_\bs
177
178        _\b2_\b._\b2_\b._\b1  _\bI_\bn_\bd_\be_\bx
179
180        The index is the screen that you usually see first when you start mutt-ng. It
181        gives an overview over your emails in the currently opened mailbox. By default,
182        this is your system mailbox.  The information you see in the index is a list of
183
184        The Mutt Next Generation E-Mail Client                                        5
185
186        emails, each with its number on the left, its flags (new email, important
187        email, email that has been forwarded or replied to, tagged email, ...), the
188        date when email was sent, its sender, the email size, and the subject. Addi-
189        tionally, the index also shows thread hierarchies: when you reply to an email,
190        and the other person replies back, you can see the other's person email in a
191        "sub-tree" below.  This is especially useful for personal email between a group
192        of people or when you've subscribed to mailing lists.
193
194        _\b2_\b._\b2_\b._\b2  _\bP_\ba_\bg_\be_\br
195
196        The pager is responsible for showing the email content. On the top of the pager
197        you have an overview over the most important email headers like the sender, the
198        recipient, the subject, and much more information. How much information you
199        actually see depends on your configuration, which we'll describe below.
200
201        Below the headers, you see the email body which usually contains the message.
202        If the email contains any attachments, you will see more information about them
203        below the email body, or, if the attachments are text files, you can view them
204        directly in the pager.
205
206        To give the user a good overview, it is possible to configure mutt-ng to show
207        different things in the pager with different colors. Virtually everything that
208        can be described with a regular expression can be colored, e.g. URLs, email
209        addresses or smileys.
210
211        _\b2_\b._\b2_\b._\b3  _\bF_\bi_\bl_\be _\bB_\br_\bo_\bw_\bs_\be_\br
212
213        The file browser is the interface to the local or remote file system. When
214        selecting a mailbox to open, the browser allows custom sorting of items, limit-
215        ing the items shown by a regular expression and a freely adjustable format of
216        what to display in which way. It also allows for easy navigation through the
217        file system when selecting file(s) to attach to a message, select multiple
218        files to attach and many more.
219
220        _\b2_\b._\b2_\b._\b4  _\bS_\bi_\bd_\be_\bb_\ba_\br
221
222        The sidebar comes in handy to manage mails which are spread over different
223        folders. All folders users setup mutt-ng to watch for new mail will be listed.
224        The listing includes not only the name but also the number of total messages,
225        the number of new and flagged messages. Items with new mail may be colored dif-
226        ferent from those with flagged mail, items may be shortened or compress if
227        they're they to long to be printed in full form so that by abbreviated names,
228        user still now what the name stands for.
229
230        _\b2_\b._\b2_\b._\b5  _\bH_\be_\bl_\bp
231
232        The Mutt Next Generation E-Mail Client                                        6
233
234        The help screen is meant to offer a quick help to the user. It lists the cur-
235        rent configuration of key bindings and their associated commands including a
236        short description, and currently unbound functions that still need to be asso-
237        ciated with a key binding (or alternatively, they can be called via the mutt-ng
238        command prompt).
239
240        _\b2_\b._\b2_\b._\b6  _\bC_\bo_\bm_\bp_\bo_\bs_\be _\bM_\be_\bn_\bu
241
242        The compose menu features a split screen containing the information which
243        really matter before actually sending a message by mail or posting an article
244        to a newsgroup: who gets the message as what (recipient, newsgroup, who gets
245        what kind of copy). Additionally, users may set security options like deciding
246        whether to sign, encrypt or sign and encrypt a message with/for what keys.
247
248        Also, it's used to attach messages, news articles or files to a message, to re-
249        edit any attachment including the message itself.
250
251        _\b2_\b._\b2_\b._\b7  _\bA_\bl_\bi_\ba_\bs _\bM_\be_\bn_\bu
252
253        The alias menu is used to help users finding the recipients of messages. For
254        users who need to contact many people, there's no need to remember addresses or
255        names completely because it allows for searching, too. The alias mechanism and
256        thus the alias menu also features grouping several addresses by a shorter nick-
257        name, the actual alias, so that users don't have to select each single recipi-
258        ent manually.
259
260        _\b2_\b._\b2_\b._\b8  _\bA_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bM_\be_\bn_\bu
261
262        As will be later discussed in detail, mutt-ng features a good and stable MIME
263        implementation, that is, is greatly supports sending and receiving messages of
264        arbitrary type. The attachment menu displays a message's structure in detail:
265        what content parts are attached to which parent part (which gives a true tree
266        structure), which type is of what type and what size.  Single parts may saved,
267        deleted or modified to offer great and easy access to message's internals.
268
269        _\b2_\b._\b2_\b._\b9  _\bK_\be_\by _\bM_\be_\bn_\bu
270
271        FIXME
272
273        _\b2_\b._\b3  _\bM_\bo_\bv_\bi_\bn_\bg _\bA_\br_\bo_\bu_\bn_\bd _\bi_\bn _\bM_\be_\bn_\bu_\bs
274
275        Information is presented in menus, very similar to ELM.  Here is a table
276
277        The Mutt Next Generation E-Mail Client                                        7
278
279        showing the common keys used to navigate menus in Mutt-ng.
280
281             j or Down       next-entry      move to the next entry
282             k or Up         previous-entry  move to the previous entry
283             z or PageDn     page-down       go to the next page
284             Z or PageUp     page-up         go to the previous page
285             = or Home       first-entry     jump to the first entry
286             * or End        last-entry      jump to the last entry
287             q               quit            exit the current menu
288             ?               help            list all key bindings for the current menu
289
290        _\b2_\b._\b4  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bI_\bn_\bp_\bu_\bt _\bF_\bi_\be_\bl_\bd_\bs
291
292        Mutt-ng has a builtin line editor which is used as the primary way to input
293        textual data such as email addresses or filenames.  The keys used to move
294        around while editing are very similar to those of Emacs.
295
296             ^A or <Home>    bol             move to the start of the line
297             ^B or <Left>    backward-char   move back one char
298             Esc B          backward-word  move back one word
299             ^D or <Delete>  delete-char     delete the char under the cursor
300             ^E or <End>     eol             move to the end of the line
301             ^F or <Right>   forward-char    move forward one char
302             Esc F          forward-word   move forward one word
303             <Tab>           complete        complete filename or alias
304             ^T              complete-query  complete address with query
305             ^K              kill-eol        delete to the end of the line
306             ESC d          kill-eow  delete to the end of the word
307             ^W              kill-word       kill the word in front of the cursor
308             ^U              kill-line       delete entire line
309             ^V              quote-char      quote the next typed key
310             <Up>            history-up      recall previous string from history
311             <Down>          history-down    recall next string from history
312             <BackSpace>     backspace       kill the char in front of the cursor
313             Esc u          upcase-word    convert word to upper case
314             Esc l          downcase-word  convert word to lower case
315             Esc c          capitalize-word capitalize the word
316             ^G              n/a             abort
317             <Return>        n/a             finish editing
318
319        You can remap the _\be_\bd_\bi_\bt_\bo_\br functions using the _\bb_\bi_\bn_\bd (section 3.5  , page 26) com-
320        mand.  For example, to make the _\bD_\be_\bl_\be_\bt_\be key delete the character in front of the
321        cursor rather than under, you could use
322
323        bind editor <delete> backspace
324
325        The Mutt Next Generation E-Mail Client                                        8
326
327        _\b2_\b._\b5  _\bR_\be_\ba_\bd_\bi_\bn_\bg _\bM_\ba_\bi_\bl _\b- _\bT_\bh_\be _\bI_\bn_\bd_\be_\bx _\ba_\bn_\bd _\bP_\ba_\bg_\be_\br
328
329        Similar to many other mail clients, there are two modes in which mail is read
330        in Mutt-ng.  The first is the index of messages in the mailbox, which is called
331        the ``index'' in Mutt-ng.  The second mode is the display of the message con-
332        tents.  This is called the ``pager.''
333
334        The next few sections describe the functions provided in each of these modes.
335
336        _\b2_\b._\b5_\b._\b1  _\bT_\bh_\be _\bM_\be_\bs_\bs_\ba_\bg_\be _\bI_\bn_\bd_\be_\bx
337
338             c               change to a different mailbox
339             ESC c           change to a folder in read-only mode
340             C               copy the current message to another mailbox
341             ESC C           decode a message and copy it to a folder
342             ESC s           decode a message and save it to a folder
343             D               delete messages matching a pattern
344             d               delete the current message
345             F               mark as important
346             l               show messages matching a pattern
347             N               mark message as new
348             o               change the current sort method
349             O               reverse sort the mailbox
350             q               save changes and exit
351             s               save-message
352             T               tag messages matching a pattern
353             t               toggle the tag on a message
354             ESC t           toggle tag on entire message thread
355             U               undelete messages matching a pattern
356             u               undelete-message
357             v               view-attachments
358             x               abort changes and exit
359             <Return>        display-message
360             <Tab>           jump to the next new message
361             @               show the author's full e-mail address
362             $               save changes to mailbox
363             /               search
364             ESC /           search-reverse
365             ^L              clear and redraw the screen
366             ^T              untag messages matching a pattern
367
368        _\b2_\b._\b5_\b._\b1_\b._\b1  _\bS_\bt_\ba_\bt_\bu_\bs _\bF_\bl_\ba_\bg_\bs
369
370        In addition to who sent the message and the subject, a short summary of the
371        disposition of each message is printed beside the message number.  Zero or more
372        of the following ``flags'' may appear, which mean:
373
374              D
375                    message is deleted (is marked for deletion)
376
377              d
378                    message have attachments marked for deletion
379
380        The Mutt Next Generation E-Mail Client                                        9
381
382              K
383                    contains a PGP public key
384
385              N
386                    message is new
387
388              O
389                    message is old
390
391              P
392                    message is PGP encrypted
393
394              r
395                    message has been replied to
396
397              S
398                    message is signed, and the signature is succesfully verified
399
400              s
401                    message is signed
402
403              !
404                    message is flagged
405
406              *
407                    message is tagged
408
409        Some of the status flags can be turned on or off using
410
411           +\bo s\bse\bet\bt-\b-f\bfl\bla\bag\bg (default: w)
412
413           +\bo c\bcl\ble\bea\bar\br-\b-f\bfl\bla\bag\bg (default: W)
414
415        Furthermore, the following flags reflect who the message is addressed to.  They
416        can be customized with the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.330  , page 170) variable.
417
418              +
419                    message is to you and you only
420
421              T
422                    message is to you, but also to or cc'ed to others
423
424              C
425                    message is cc'ed to you
426
427              F
428                    message is from you
429
430              L
431                    message is sent to a subscribed mailing list
432
433        _\b2_\b._\b5_\b._\b2  _\bT_\bh_\be _\bP_\ba_\bg_\be_\br
434
435        By default, Mutt-ng uses its builtin pager to display the body of messages.
436
437        The Mutt Next Generation E-Mail Client                                       10
438
439        The pager is very similar to the Unix program _\bl_\be_\bs_\bs though not nearly as fea-
440        tureful.
441
442             <Return>        go down one line
443             <Space>         display the next page (or next message if at the end of a message)
444             -               go back to the previous page
445             n               search for next match
446             S               skip beyond quoted text
447             T               toggle display of quoted text
448             ?               show key bindings
449             /               search for a regular expression (pattern)
450             ESC /           search backwards for a regular expression
451             \               toggle search pattern coloring
452             ^               jump to the top of the message
453
454        In addition, many of the functions from the _\bi_\bn_\bd_\be_\bx are available in the pager,
455        such as _\bd_\be_\bl_\be_\bt_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be or _\bc_\bo_\bp_\by_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be (this is one advantage over using an
456        external pager to view messages).
457
458        Also, the internal pager supports a couple other advanced features. For one, it
459        will accept and translate the ``standard'' nroff sequences for bold and under-
460        line. These sequences are a series of either the letter, backspace (^H), the
461        letter again for bold or the letter, backspace, ``_'' for denoting underline.
462        Mutt-ng will attempt to display these in bold and underline respectively if
463        your terminal supports them. If not, you can use the bold and underline _\bc_\bo_\bl_\bo_\br
464        (section 3.9  , page 30) objects to specify a color or mono attribute for them.
465
466        Additionally, the internal pager supports the ANSI escape sequences for charac-
467        ter attributes.  Mutt-ng translates them into the correct color and character
468        settings.  The sequences Mutt-ng supports are:
469
470             ESC [ Ps;Ps;Ps;...;Ps m
471             where Ps =
472             0    All Attributes Off
473             1    Bold on
474             4    Underline on
475             5    Blink on
476             7    Reverse video on
477             3x   Foreground color is x
478             4x   Background color is x
479
480             Colors are
481             0    black
482             1    red
483             2    green
484             3    yellow
485             4    blue
486             5    magenta
487             6    cyan
488             7    white
489
490        The Mutt Next Generation E-Mail Client                                       11
491
492        Mutt-ng uses these attributes for handling text/enriched messages, and they can
493        also be used by an external _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 78) script for high-
494        lighting purposes.  N\bNo\bot\bte\be:\b: If you change the colors for your display, for exam-
495        ple by changing the color associated with color2 for your xterm, then that
496        color will be used instead of green.
497
498        _\b2_\b._\b5_\b._\b3  _\bT_\bh_\br_\be_\ba_\bd_\be_\bd _\bM_\bo_\bd_\be
499
500        When the mailbox is _\bs_\bo_\br_\bt_\be_\bd (section 7.4.298  , page 160) by _\bt_\bh_\br_\be_\ba_\bd_\bs, there are
501        a few additional functions available in the _\bi_\bn_\bd_\be_\bx and _\bp_\ba_\bg_\be_\br modes.
502
503             ^D      delete-thread           delete all messages in the current thread
504             ^U      undelete-thread         undelete all messages in the current thread
505             ^N      next-thread             jump to the start of the next thread
506             ^P      previous-thread         jump to the start of the previous thread
507             ^R      read-thread             mark the current thread as read
508             ESC d   delete-subthread        delete all messages in the current subthread
509             ESC u   undelete-subthread      undelete all messages in the current subthread
510             ESC n   next-subthread          jump to the start of the next subthread
511             ESC p   previous-subthread      jump to the start of the previous subthread
512             ESC r   read-subthread          mark the current subthread as read
513             ESC t   tag-thread              toggle the tag on the current thread
514             ESC v     collapse-thread          toggle collapse for the current thread
515             ESC V     collapse-all        toggle collapse for all threads
516             P       parent-message          jump to parent message in thread
517
518        N\bNo\bot\bte\be:\b: Collapsing a thread displays only the first message in the thread and
519        hides the others. This is useful when threads contain so many messages that you
520        can only see a handful of threads on the screen. See %M in _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (sec-
521        tion 7.4.116  , page 115).  For example, you could use "%?M?(#%03M)&(%4l)?" in
522        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115) to optionally display the number of
523        hidden messages if the thread is collapsed.
524
525        See also: _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs (section 7.4.319  , page 167).
526
527        _\b2_\b._\b5_\b._\b4  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\be_\bo_\bu_\bs _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
528
529        c\bcr\bre\bea\bat\bte\be-\b-a\bal\bli\bia\bas\bs
530         (default: a)
531
532        Creates a new alias based upon the current message (or prompts for a new one).
533        Once editing is complete, an _\ba_\bl_\bi_\ba_\bs (section 3.4  , page 25) command is added to
534        the file specified by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 7.4.5  , page 89) variable for
535        future use. N\bNo\bot\bte\be:\b: Specifying an _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 7.4.5  , page 89) does not
536        add the aliases specified there-in, you must also _\bs_\bo_\bu_\br_\bc_\be (section 3.29  , page
537        45) the file.
538
539        c\bch\bhe\bec\bck\bk-\b-t\btr\bra\bad\bdi\bit\bti\bio\bon\bna\bal\bl-\b-p\bpg\bgp\bp
540         (default: ESC P)
541
542        This function will search the current message for content signed or encrypted
543        with PGP the "traditional" way, that is, without proper MIME tagging.
544
545        The Mutt Next Generation E-Mail Client                                       12
546
547        Technically, this function will temporarily change the MIME content types of
548        the body parts containing PGP data; this is similar to the _\be_\bd_\bi_\bt_\b-_\bt_\by_\bp_\be (section
549        2.5.4  , page 12) function's effect.
550
551        d\bdi\bis\bsp\bpl\bla\bay\by-\b-t\bto\bog\bgg\bgl\ble\be-\b-w\bwe\bee\bed\bd
552         (default: h)
553
554        Toggles the weeding of message header fields specified by _\bi_\bg_\bn_\bo_\br_\be (section
555        3.10  , page 32) commands.
556
557        e\bed\bdi\bit\bt
558         (default: e)
559
560        This command (available in the ``index'' and ``pager'') allows you to edit the
561        raw current message as it's present in the mail folder.  After you have fin-
562        ished editing, the changed message will be appended to the current folder, and
563        the original message will be marked for deletion.
564
565        e\bed\bdi\bit\bt-\b-t\bty\byp\bpe\be
566
567        (default: ^E on the attachment menu, and in the pager and index menus; ^T on
568        the compose menu)
569
570        This command is used to temporarily edit an attachment's content type to fix,
571        for instance, bogus character set parameters.  When invoked from the index or
572        from the pager, you'll have the opportunity to edit the top-level attachment's
573        content type.  On the _\ba_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bm_\be_\bn_\bu (section 5.1.2  , page 70), you can
574        change any attachment's content type. These changes are not persistent, and get
575        lost upon changing folders.
576
577        Note that this command is also available on the _\bc_\bo_\bm_\bp_\bo_\bs_\be _\bm_\be_\bn_\bu (section 5.1.3  ,
578        page 71).  There, it's used to fine-tune the properties of attachments you are
579        going to send.
580
581        e\ben\bnt\bte\ber\br-\b-c\bco\bom\bmm\bma\ban\bnd\bd
582         (default: ``:'')
583
584        This command is used to execute any command you would normally put in a config-
585        uration file.  A common use is to check the settings of variables, or in con-
586        junction with _\bm_\ba_\bc_\br_\bo_\bs (section 3.8  , page 29) to change settings on the fly.
587
588        e\bex\bxt\btr\bra\bac\bct\bt-\b-k\bke\bey\bys\bs
589         (default: ^K)
590
591        This command extracts PGP public keys from the current or tagged message(s) and
592        adds them to your PGP public key ring.
593
594        f\bfo\bor\brg\bge\bet\bt-\b-p\bpa\bas\bss\bsp\bph\bhr\bra\bas\bse\be
595         (default: ^F)
596
597        This command wipes the passphrase(s) from memory. It is useful, if you mis-
598        spelled the passphrase.
599
600        The Mutt Next Generation E-Mail Client                                       13
601
602        l\bli\bis\bst\bt-\b-r\bre\bep\bpl\bly\by
603         (default: L)
604
605        Reply to the current or tagged message(s) by extracting any addresses which
606        match the regular expressions given by the _\bl_\bi_\bs_\bt_\bs _\bo_\br _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.13  ,
607        page 35) commands, but also honor any Mail-Followup-To header(s) if the
608        _\b$_\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.94  , page 110) configuration variable is set.
609        Using this when replying to messages posted to mailing lists helps avoid dupli-
610        cate copies being sent to the author of the message you are replying to.
611
612        p\bpi\bip\bpe\be-\b-m\bme\bes\bss\bsa\bag\bge\be
613         (default: |)
614
615        Asks for an external Unix command and pipes the current or tagged message(s) to
616        it.  The variables _\b$_\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.207  , page 139), _\b$_\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
617        (section 7.4.209  , page 140), _\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp (section 7.4.208  , page 139) and
618        _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.341  , page 172) control the exact behavior of this
619        function.
620
621        r\bre\bes\bse\ben\bnd\bd-\b-m\bme\bes\bss\bsa\bag\bge\be
622         (default: ESC e)
623
624        With resend-message, mutt takes the current message as a template for a new
625        message.  This function is best described as "recall from arbitrary folders".
626        It can conveniently be used to forward MIME messages while preserving the orig-
627        inal mail structure. Note that the amount of headers included here depends on
628        the value of the _\b$_\bw_\be_\be_\bd (section 7.4.342  , page 172) variable.
629
630        This function is also available from the attachment menu. You can use this to
631        easily resend a message which was included with a bounce message as a mes-
632        sage/rfc822 body part.
633
634        s\bsh\bhe\bel\bll\bl-\b-e\bes\bsc\bca\bap\bpe\be
635         (default: !)
636
637        Asks for an external Unix command and executes it.  The _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section
638        7.4.341  , page 172) can be used to control whether Mutt-ng will wait for a key
639        to be pressed when the command returns (presumably to let the user read the
640        output of the command), based on the return status of the named command.
641
642        t\bto\bog\bgg\bgl\ble\be-\b-q\bqu\buo\bot\bte\bed\bd
643         (default: T)
644
645        The _\bp_\ba_\bg_\be_\br uses the _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.232  , page 145) variable to
646        detect quoted text when displaying the body of the message.  This function tog-
647        gles the display of the quoted material in the message.  It is particularly
648        useful when are interested in just the response and there is a large amount of
649        quoted text in the way.
650
651        s\bsk\bki\bip\bp-\b-q\bqu\buo\bot\bte\bed\bd
652         (default: S)
653
654        This function will go to the next line of non-quoted text which come after a
655        line of quoted text in the internal pager.
656
657        The Mutt Next Generation E-Mail Client                                       14
658
659        _\b2_\b._\b6  _\bS_\be_\bn_\bd_\bi_\bn_\bg _\bM_\ba_\bi_\bl
660
661        The following bindings are available in the _\bi_\bn_\bd_\be_\bx for sending messages.
662
663             m       compose         compose a new message
664             r       reply           reply to sender
665             g       group-reply     reply to all recipients
666             L       list-reply      reply to mailing list address
667             f       forward         forward message
668             b       bounce          bounce (remail) message
669             ESC k   mail-key        mail a PGP public key to someone
670
671        Bouncing a message sends the message as is to the recipient you specify.  For-
672        warding a message allows you to add comments or modify the message you are for-
673        warding.  These items are discussed in greater detail in the next chapter
674        _\b`_\b`_\bF_\bo_\br_\bw_\ba_\br_\bd_\bi_\bn_\bg _\ba_\bn_\bd _\bB_\bo_\bu_\bn_\bc_\bi_\bn_\bg _\bM_\ba_\bi_\bl_\b'_\b' (section 2.7  , page 20).
675
676        _\b2_\b._\b6_\b._\b1  _\bC_\bo_\bm_\bp_\bo_\bs_\bi_\bn_\bg _\bn_\be_\bw _\bm_\be_\bs_\bs_\ba_\bg_\be_\bs
677
678        When you want to send an email using mutt-ng, simply press m on your keyboard.
679        Then, mutt-ng asks for the recipient via a prompt in the last line:
680
681             To:
682
683        After you've finished entering the recipient(s), press return. If you want to
684        send an email to more than one recipient, separate the email addresses using
685        the comma ",". Mutt-ng then asks you for the email subject. Again, press return
686        after you've entered it. After that, mutt-ng got the most important information
687        from you, and starts up an editor where you can then enter your email.
688
689        The editor that is called is selected in the following way: you can e.g. set it
690        in the mutt-ng configuration:
691
692             set editor = "vim +/^$/ -c ':set tw=72'"
693             set editor = "nano"
694             set editor = "emacs"
695
696        If you don't set your preferred editor in your configuration, mutt-ng first
697        looks whether the environment variable $VISUAL is set, and if so, it takes its
698        value as editor command. Otherwise, it has a look at $EDITOR and takes its
699        value if it is set. If no editor command can be found, mutt-ng simply assumes
700        vi to be the default editor, since it's the most widespread editor in the Unix
701        world and it's pretty safe to assume that it is installed and available.
702
703        When you've finished entering your message, save it and quit your editor. Mutt-
704        ng will then present you with a summary screen, the compose menu.  On the top,
705        you see a summary of the most important available key commands.  Below that,
706        you see the sender, the recipient(s), Cc and/or Bcc recipient(s), the subject,
707
708        The Mutt Next Generation E-Mail Client                                       15
709
710        the reply-to address, and optionally information where the sent email will be
711        stored and whether it should be digitally signed and/or encrypted.
712
713        Below that, you see a list of "attachments". The mail you've just entered
714        before is also an attachment, but due to its special type (it's plain text), it
715        will be displayed as the normal message on the receiver's side.
716
717        At this point, you can add more attachments, pressing a, you can edit the
718        recipient addresses, pressing t for the "To:" field, c for the "Cc:" field, and
719        b for the "Bcc: field. You can also edit the subject the subject by simply
720        pressing s or the email message that you've entered before by pressing e. You
721        will then again return to the editor. You can even edit the sender, by pressing
722        <esc>f, but this shall only be used with caution.
723
724        Alternatively, you can configure mutt-ng in a way that most of the above set-
725        tings can be edited using the editor. Therefore, you only need to add the fol-
726        lowing to your configuration:
727
728             set edit_headers
729
730        Once you have finished editing the body of your mail message, you are returned
731        to the _\bc_\bo_\bm_\bp_\bo_\bs_\be menu.  The following options are available:
732
733             a       attach-file             attach a file
734             A    attach-message      attach message(s) to the message
735             ESC k   attach-key              attach a PGP public key
736             d       edit-description        edit description on attachment
737             D       detach-file             detach a file
738             t       edit-to                 edit the To field
739             ESC f   edit-from               edit the From field
740             r       edit-reply-to           edit the Reply-To field
741             c       edit-cc                 edit the Cc field
742             b       edit-bcc                edit the Bcc field
743             y       send-message            send the message
744             s       edit-subject            edit the Subject
745             S       smime-menu              select S/MIME options
746             f       edit-fcc                specify an ``Fcc'' mailbox
747             p       pgp-menu                select PGP options
748             P       postpone-message        postpone this message until later
749             q       quit                    quit (abort) sending the message
750             w    write-fcc      write the message to a folder
751             i       ispell                  check spelling (if available on your system)
752             ^F      forget-passphrase       wipe passphrase(s) from memory
753
754        N\bNo\bot\bte\be:\b: The attach-message function will prompt you for a folder to attach mes-
755        sages from. You can now tag messages in that folder and they will be attached
756        to the message you are sending. Note that certain operations like composing a
757        new mail, replying, forwarding, etc. are not permitted when you are in that
758        folder. The %r in _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.315  , page 164) will change to a
759        'A' to indicate that you are in attach-message mode.
760
761        The Mutt Next Generation E-Mail Client                                       16
762
763        _\b2_\b._\b6_\b._\b2  _\bR_\be_\bp_\bl_\by_\bi_\bn_\bg
764
765        _\b2_\b._\b6_\b._\b2_\b._\b1  _\bS_\bi_\bm_\bp_\bl_\be _\bR_\be_\bp_\bl_\bi_\be_\bs
766
767        When you want to reply to an email message, select it in the index menu and
768        then press r. Mutt-ng's behaviour is then similar to the behaviour when you
769        compose a message: first, you will be asked for the recipient, then for the
770        subject, and then, mutt-ng will start the editor with the quote attribution and
771        the quoted message. This can e.g. look like the example below.
772
773             On Mon, Mar 07, 2005 at 05:02:12PM +0100, Michael Svensson wrote:
774             > Bill, can you please send last month's progress report to Mr.
775             > Morgan? We also urgently need the cost estimation for the new
776             > production server that we want to set up before our customer's
777             > project will go live.
778
779        You can start editing the email message. It is strongly recommended to put your
780        answer _\bb_\be_\bl_\bo_\bw the quoted text and to only quote what is really necessary and
781        that you refer to. Putting your answer on top of the quoted message, is,
782        although very widespread, very often not considered to be a polite way to
783        answer emails.
784
785        The quote attribution is configurable, by default it is set to
786
787             set attribution = "On %d, %n wrote:"
788
789        It can also be set to something more compact, e.g.
790
791             set attribution = "attribution="* %n <%a> [%(%y-%m-%d %H:%M)]:"
792
793        The example above results in the following attribution:
794
795             * Michael Svensson <svensson@foobar.com> [05-03-06 17:02]:
796             > Bill, can you please send last month's progress report to Mr.
797             > Morgan? We also urgently need the cost estimation for the new
798             > production server that we want to set up before our customer's
799             > project will go live.
800
801        Generally, try to keep your attribution short yet information-rich. It is _\bn_\bo_\bt
802        the right place for witty quotes, long "attribution" novels or anything like
803        that: the right place for such things is - if at all - the email signature at
804        the very bottom of the message.
805
806        When you're done with writing your message, save and quit the editor. As
807        before, you will return to the compose menu, which is used in the same way as
808
809        The Mutt Next Generation E-Mail Client                                       17
810
811        before.
812
813        _\b2_\b._\b6_\b._\b2_\b._\b2  _\bG_\br_\bo_\bu_\bp _\bR_\be_\bp_\bl_\bi_\be_\bs
814
815        In the situation where a group of people uses email as a discussion, most of
816        the emails will have one or more recipients, and probably several "Cc:" recipi-
817        ents. The group reply functionality ensures that when you press g instead of r
818        to do a reply, each and every recipient that is contained in the original mes-
819        sage will receive a copy of the message, either as normal recipient or as "Cc:"
820        recipient.
821
822        _\b2_\b._\b6_\b._\b2_\b._\b3  _\bL_\bi_\bs_\bt _\bR_\be_\bp_\bl_\bi_\be_\bs
823
824        When you use mailing lists, it's generally better to send your reply to a mes-
825        sage only to the list instead of the list and the original author. To make this
826        easy to use, mutt-ng features list replies.
827
828        To do a list reply, simply press L. If the email contains a Mail-Followup-To:
829        header, its value will be used as reply address. Otherwise, mutt-ng searches
830        through all mail addresses in the original message and tries to match them a
831        list of regular expressions which can be specified using the lists command.  If
832        any of the regular expression matches, a mailing list address has been found,
833        and it will be used as reply address.
834
835             lists linuxevent@luga\.at vuln-dev@ mutt-ng-users@
836
837        Nowadays, most mailing list software like GNU Mailman adds a Mail-Followup-To:
838        header to their emails anyway, so setting lists is hardly ever necessary in
839        practice.
840
841        _\b2_\b._\b6_\b._\b3  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\be _\bm_\be_\bs_\bs_\ba_\bg_\be _\bh_\be_\ba_\bd_\be_\br
842
843        When editing the header of your outgoing message, there are a couple of special
844        features available.
845
846        If you specify
847
848        Fcc: _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
849
850        Mutt-ng will pick up _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be just as if you had used the _\be_\bd_\bi_\bt_\b-_\bf_\bc_\bc function in
851        the _\bc_\bo_\bm_\bp_\bo_\bs_\be menu.
852
853        You can also attach files to your message by specifying
854
855        The Mutt Next Generation E-Mail Client                                       18
856
857        Attach: _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be  [ _\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn ]
858
859        where _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be is the file to attach and _\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn is an optional string to
860        use as the description of the attached file.
861
862        When replying to messages, if you remove the _\bI_\bn_\b-_\bR_\be_\bp_\bl_\by_\b-_\bT_\bo_\b: field from the header
863        field, Mutt-ng will not generate a _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be_\bs_\b: field, which allows you to cre-
864        ate a new message thread.
865
866        Also see _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102).
867
868        _\b2_\b._\b6_\b._\b4  _\bU_\bs_\bi_\bn_\bg _\bM_\bu_\bt_\bt_\b-_\bn_\bg _\bw_\bi_\bt_\bh _\bP_\bG_\bP
869
870        If you want to use PGP, you can specify
871
872        Pgp: [ E | S | S_\b<_\bi_\bd_\b> ]
873
874        ``E'' encrypts, ``S'' signs and ``S<id>'' signs with the given key, setting
875        _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 7.4.199  , page 138) permanently.
876
877        If you have told mutt to PGP encrypt a message, it will guide you through a key
878        selection process when you try to send the message.  Mutt-ng will not ask you
879        any questions about keys which have a certified user ID matching one of the
880        message recipients' mail addresses.  However, there may be situations in which
881        there are several keys, weakly certified user ID fields, or where no matching
882        keys can be found.
883
884        In these cases, you are dropped into a menu with a list of keys from which you
885        can select one.  When you quit this menu, or mutt can't find any matching keys,
886        you are prompted for a user ID.  You can, as usually, abort this prompt using
887        ^G.  When you do so, mutt will return to the compose screen.
888
889        Once you have successfully finished the key selection, the message will be
890        encrypted using the selected public keys, and sent out.
891
892        Most fields of the entries in the key selection menu (see also _\b$_\bp_\bg_\bp_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\b-
893        _\bm_\ba_\bt (section 7.4.186  , page 134)) have obvious meanings.  But some explana-
894        tions on the capabilities, flags, and validity fields are in order.
895
896        The flags sequence (%f) will expand to one of the following flags:
897
898             R            The key has been revoked and can't be used.
899             X            The key is expired and can't be used.
900             d            You have marked the key as disabled.
901             c            There are unknown critical self-signature
902                          packets.
903
904        The capabilities field (%c) expands to a two-character sequence representing a
905        key's capabilities.  The first character gives the key's encryption capabili-
906        ties: A minus sign (-\b-) means that the key cannot be used for encryption.  A dot
907        (.\b.) means that it's marked as a signature key in one of the user IDs, but may
908
909        The Mutt Next Generation E-Mail Client                                       19
910
911        also be used for encryption.  The letter e\be indicates that this key can be used
912        for encryption.
913
914        The second character indicates the key's signing capabilities.  Once again, a
915        ``-\b-'' implies ``not for signing'', ``.\b.'' implies that the key is marked as an
916        encryption key in one of the user-ids, and ``s\bs'' denotes a key which can be
917        used for signing.
918
919        Finally, the validity field (%t) indicates how well-certified a user-id is.  A
920        question mark (?\b?) indicates undefined validity, a minus character (-\b-) marks an
921        untrusted association, a space character means a partially trusted association,
922        and a plus character (+\b+) indicates complete validity.
923
924        _\b2_\b._\b6_\b._\b5  _\bS_\be_\bn_\bd_\bi_\bn_\bg _\ba_\bn_\bo_\bn_\by_\bm_\bo_\bu_\bs _\bm_\be_\bs_\bs_\ba_\bg_\be_\bs _\bv_\bi_\ba _\bm_\bi_\bx_\bm_\ba_\bs_\bt_\be_\br
925
926        You may also have configured mutt to co-operate with Mixmaster, an anonymous
927        remailer.  Mixmaster permits you to send your messages anonymously using a
928        chain of remailers. Mixmaster support in mutt is for mixmaster version 2.04
929        (beta 45 appears to be the latest) and 2.03.  It does not support earlier ver-
930        sions or the later so-called version 3 betas, of which the latest appears to be
931        called 2.9b23.
932
933        To use it, you'll have to obey certain restrictions.  Most important, you can-
934        not use the Cc and Bcc headers.  To tell Mutt-ng to use mixmaster, you have to
935        select a remailer chain, using the mix function on the compose menu.
936
937        The chain selection screen is divided into two parts.  In the (larger) upper
938        part, you get a list of remailers you may use.  In the lower part, you see the
939        currently selected chain of remailers.
940
941        You can navigate in the chain using the chain-prev and chain-next functions,
942        which are by default bound to the left and right arrows and to the h and l keys
943        (think vi keyboard bindings).  To insert a remailer at the current chain posi-
944        tion, use the insert function.  To append a remailer behind the current chain
945        position, use select-entry or append.  You can also delete entries from the
946        chain, using the corresponding function.  Finally, to abandon your changes,
947        leave the menu, or accept them pressing (by default) the Return key.
948
949        Note that different remailers do have different capabilities, indicated in the
950        %c entry of the remailer menu lines (see _\b$_\bm_\bi_\bx_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.146  ,
951        page 124)).  Most important is the ``middleman'' capability, indicated by a
952        capital ``M'': This means that the remailer in question cannot be used as the
953        final element of a chain, but will only forward messages to other mixmaster
954        remailers.  For details on the other capabilities, please have a look at the
955        mixmaster documentation.
956
957        _\b2_\b._\b7  _\bF_\bo_\br_\bw_\ba_\br_\bd_\bi_\bn_\bg _\ba_\bn_\bd _\bB_\bo_\bu_\bn_\bc_\bi_\bn_\bg _\bM_\ba_\bi_\bl
958
959        The Mutt Next Generation E-Mail Client                                       20
960
961        Often, it is necessary to forward mails to other people.  Therefore, mutt-ng
962        supports forwarding messages in two different ways.
963
964        The first one is regular forwarding, as you probably know it from other mail
965        clients. You simply press f, enter the recipient email address, the subject of
966        the forwarded email, and then you can edit the message to be forwarded in the
967        editor. The forwarded message is separated from the rest of the message via the
968        two following markers:
969
970             ----- Forwarded message from Lucas User <luser@example.com> -----
971
972             From: Lucas User <luser@example.com>
973             Date: Thu, 02 Dec 2004 03:08:34 +0100
974             To: Michael Random <mrandom@example.com>
975             Subject: Re: blackmail
976
977             Pay me EUR 50,000.- cash or your favorite stuffed animal will die
978             a horrible death.
979
980             ----- End forwarded message -----
981
982        When you're done with editing the mail, save and quit the editor, and you will
983        return to the compose menu, the same menu you also encounter when composing or
984        replying to mails.
985
986        The second mode of forwarding emails with mutt-ng is the so-called _\bb_\bo_\bu_\bn_\bc_\bi_\bn_\bg:
987        when you bounce an email to another address, it will be sent in practically the
988        same format you send it (except for headers that are created during transport-
989        ing the message). To bounce a message, press b and enter the recipient email
990        address. By default, you are then asked whether you really want to bounce the
991        message to the specified recipient. If you answer with yes, the message will
992        then be bounced.
993
994        To the recipient, the bounced email will look as if he got it like a regular
995        email where he was Bcc: recipient. The only possibility to find out whether it
996        was a bounced email is to carefully study the email headers and to find out
997        which host really sent the email.
998
999        _\b2_\b._\b8  _\bP_\bo_\bs_\bt_\bp_\bo_\bn_\bi_\bn_\bg _\bM_\ba_\bi_\bl
1000
1001        At times it is desirable to delay sending a message that you have already begun
1002        to compose.  When the _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be function is used in the _\bc_\bo_\bm_\bp_\bo_\bs_\be menu,
1003        the body of your message and attachments are stored in the mailbox specified by
1004        the _\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 7.4.221  , page 142) variable.  This means that you can
1005        recall the message even if you exit Mutt-ng and then restart it at a later
1006        time.
1007
1008        Once a message is postponed, there are several ways to resume it.  From the
1009        command line you can use the ``-p'' option, or if you _\bc_\bo_\bm_\bp_\bo_\bs_\be a new message
1010
1011        The Mutt Next Generation E-Mail Client                                       21
1012
1013        from the _\bi_\bn_\bd_\be_\bx or _\bp_\ba_\bg_\be_\br you will be prompted if postponed messages exist.  If
1014        multiple messages are currently postponed, the _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd menu will pop up and
1015        you can select which message you would like to resume.
1016
1017        N\bNo\bot\bte\be:\b: If you postpone a reply to a message, the reply setting of the message is
1018        only updated when you actually finish the message and send it.  Also, you must
1019        be in the same folder with the message you replied to for the status of the
1020        message to be updated.
1021
1022        See also the _\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.220  , page 142) quad-option.
1023
1024        _\b3_\b.  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn
1025
1026        _\b3_\b._\b1  _\bL_\bo_\bc_\ba_\bt_\bi_\bo_\bn_\bs _\bo_\bf _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bF_\bi_\bl_\be_\bs
1027
1028        While the default configuration (or ``preferences'') make Mutt-ng usable right
1029        out of the box, it is often desirable to tailor Mutt-ng to suit your own
1030        tastes. When Mutt-ng is first invoked, it will attempt to read the ``system''
1031        configuration file (defaults set by your local system administrator), unless
1032        the ``-n'' _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be (section 7.1  , page 82) option is specified.  This
1033        file is typically /usr/local/share/muttng/Muttngrc or /etc/Muttngrc, Mutt-ng
1034        users will find this file in /usr/local/share/muttng/Muttrc or /etc/Muttngrc.
1035        Mutt will next look for a file named .muttrc in your home directory, Mutt-ng
1036        will look for .muttngrc.  If this file does not exist and your home directory
1037        has a subdirectory named .mutt, mutt try to load a file named .muttng/muttngrc.
1038
1039        .muttrc (or .muttngrc for Mutt-ng) is the file where you will usually place
1040        your _\bc_\bo_\bm_\bm_\ba_\bn_\bd_\bs (section 7.3  , page 85) to configure Mutt-ng.
1041
1042        _\b3_\b._\b2  _\bB_\ba_\bs_\bi_\bc _\bS_\by_\bn_\bt_\ba_\bx _\bo_\bf _\bI_\bn_\bi_\bt_\bi_\ba_\bl_\bi_\bz_\ba_\bt_\bi_\bo_\bn _\bF_\bi_\bl_\be_\bs
1043
1044        An initialization file consists of a series of _\bc_\bo_\bm_\bm_\ba_\bn_\bd_\bs (section 7.3  , page
1045        85).  Each line of the file may contain one or more commands.  When multiple
1046        commands are used, they must be separated by a semicolon (;).
1047
1048             set realname='Mutt-ng user' ; ignore x-
1049
1050        The hash mark, or pound sign (``#''), is used as a ``comment'' character. You
1051        can use it to annotate your initialization file. All text after the comment
1052        character to the end of the line is ignored. For example,
1053
1054             my_hdr X-Disclaimer: Why are you listening to me? # This is a comment
1055
1056        Single quotes (') and double quotes (') can be used to quote strings which
1057
1058        The Mutt Next Generation E-Mail Client                                       22
1059
1060        contain spaces or other special characters.  The difference between the two
1061        types of quotes is similar to that of many popular shell programs, namely that
1062        a single quote is used to specify a literal string (one that is not interpreted
1063        for shell variables or quoting with a backslash [see next paragraph]), while
1064        double quotes indicate a string for which should be evaluated.  For example,
1065        backtics are evaluated inside of double quotes, but n\bno\bot\bt for single quotes.
1066
1067        \ quotes the next character, just as in shells such as bash and zsh.  For exam-
1068        ple, if want to put quotes ``''' inside of a string, you can use ``\'' to force
1069        the next character to be a literal instead of interpreted character.
1070
1071             set realname="Michael \"MuttDude\" Elkins"
1072
1073        ``\\'' means to insert a literal ``\'' into the line.  ``\n'' and ``\r'' have
1074        their usual C meanings of linefeed and carriage-return, respectively.
1075
1076        A \ at the end of a line can be used to split commands over multiple lines,
1077        provided that the split points don't appear in the middle of command names.
1078
1079        Please note that, unlike the various shells, mutt-ng interprets a ``\'' at the
1080        end of a line also in comments. This allows you to disable a command split over
1081        multiple lines with only one ``#''.
1082
1083             # folder-hook . \
1084               set realname="Michael \"MuttDude\" Elkins"
1085
1086        When testing your config files, beware the following caveat. The backslash at
1087        the end of the commented line extends the current line with the next line -
1088        then referred to as a ``continuation line''.  As the first line is commented
1089        with a hash (#) all following continuation lines are also part of a comment and
1090        therefore are ignored, too. So take care of comments when continuation lines
1091        are involved within your setup files!
1092
1093        Abstract example:
1094
1095             line1\
1096             line2a # line2b\
1097             line3\
1098             line4
1099             line5
1100
1101        line1 ``continues'' until line4. however, the part after the # is a comment
1102        which includes line3 and line4. line5 is a new line of its own and thus is
1103        interpreted again.
1104
1105        The commands understood by mutt are explained in the next paragraphs.  For a
1106        complete list, see the _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.3  , page 85).
1107
1108        The Mutt Next Generation E-Mail Client                                       23
1109
1110        _\b3_\b._\b3  _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
1111
1112        _\b3_\b._\b3_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs_\b' _\bO_\bu_\bt_\bp_\bu_\bt
1113
1114        It is possible to substitute the output of a Unix command in an initialization
1115        file.  This is accomplished by enclosing the command in backquotes (``) as in,
1116        for example:
1117
1118             my_hdr X-Operating-System: `uname -a`
1119
1120        The output of the Unix command ``uname -a'' will be substituted before the line
1121        is parsed. Note that since initialization files are line oriented, only the
1122        first line of output from the Unix command will be substituted.
1123
1124        _\b3_\b._\b3_\b._\b2  _\bE_\bn_\bv_\bi_\br_\bo_\bn_\bm_\be_\bn_\bt _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
1125
1126        UNIX environments can be accessed like the way it is done in shells like sh and
1127        bash: Prepend the name of the environment by a ``$'' sign. For example,
1128
1129             set record=+sent_on_$HOSTNAME
1130
1131        sets the _\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.237  , page 146) variable to the string _\b+_\bs_\be_\bn_\bt_\b__\bo_\bn_\b_
1132        and appends the value of the evironment variable $HOSTNAME.
1133
1134        N\bNo\bot\bte\be:\b: There will be no warning if an environment variable is not defined. The
1135        result will of the expansion will then be empty.
1136
1137        _\b3_\b._\b3_\b._\b3  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
1138
1139        As for environment variables, the values of all configuration variables as
1140        string can be used in the same way, too. For example,
1141
1142             set imap_home_namespace = $folder
1143
1144        would set the value of _\b$_\bi_\bm_\ba_\bp_\b__\bh_\bo_\bm_\be_\b__\bn_\ba_\bm_\be_\bs_\bp_\ba_\bc_\be (section 7.4.101  , page 112) to
1145        the value to which _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) is _\bc_\bu_\br_\br_\be_\bn_\bt_\bl_\by set to.
1146
1147        N\bNo\bot\bte\be:\b: There're no logical links established in such cases so that the the value
1148        for _\b$_\bi_\bm_\ba_\bp_\b__\bh_\bo_\bm_\be_\b__\bn_\ba_\bm_\be_\bs_\bp_\ba_\bc_\be (section 7.4.101  , page 112) won't change even if
1149        _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) gets changed.
1150
1151        N\bNo\bot\bte\be:\b: There will be no warning if a configuration variable is not defined or is
1152        empty. The result will of the expansion will then be empty.
1153
1154        _\b3_\b._\b3_\b._\b4  _\bS_\be_\bl_\bf_\b-_\bD_\be_\bf_\bi_\bn_\be_\bd _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
1155
1156        Mutt-ng flexibly allows users to define their own variables. To avoid conflicts
1157        with the standard set and to prevent misleading error messages, there's a
1158
1159        The Mutt Next Generation E-Mail Client                                       24
1160
1161        reserved namespace for them: all user-defined variables must be prefixed with
1162        user_ and can be used just like any ordinary configuration or environment vari-
1163        able.
1164
1165        For example, to view the manual, users can either define two macros like the
1166        following
1167
1168             macro generic <F1> "!less -r /path/to/manual" "Show manual"
1169             macro pager <F1> "!less -r /path/to/manual" "Show manual"
1170
1171        for generic, pager and index. The alternative is to define a custom variable
1172        like so:
1173
1174             set user_manualcmd = '!less -r /path/to_manual'
1175             macro generic <F1> "$user_manualcmd<enter>" "Show manual"
1176             macro pager <F1> "$user_manualcmd<enter>" "Show manual"
1177             macro index <F1> "$user_manualcmd<enter>" "Show manual"
1178
1179        to re-use the command sequence as in:
1180
1181             macro index <F2> "$user_manualcmd | grep '\^[ ]\\+~. '" "Show Patterns"
1182
1183        Using this feature, arbitrary sequences can be defined once and recalled and
1184        reused where necessary. More advanced scenarios could include to save a vari-
1185        able's value at the beginning of macro sequence and restore it at end.
1186
1187        When the variable is first defined, the first value it gets assigned is also
1188        the initial value to which it can be reset using the reset command.
1189
1190        The complete removal is done via the unset keyword.
1191
1192        After the following sequence:
1193
1194             set user_foo = 42
1195             set user_foo = 666
1196
1197        the variable $user_foo has a current value of 666 and an initial of 42. The
1198        query
1199
1200             set ?user_foo
1201
1202        will show 666. After doing the reset via
1203
1204        The Mutt Next Generation E-Mail Client                                       25
1205
1206             reset user_foo
1207
1208        a following query will give 42 as the result. After unsetting it via
1209
1210             unset user_foo
1211
1212        any query or operation (except the noted expansion within other statements)
1213        will lead to an error message.
1214
1215        _\b3_\b._\b3_\b._\b5  _\bT_\by_\bp_\be _\bC_\bo_\bn_\bv_\be_\br_\bs_\bi_\bo_\bn_\bs
1216
1217        A note about variable's types during conversion: internally values are stored
1218        in internal types but for any dump/query or set operation they're converted to
1219        and from string. That means that there's no need to worry about types when ref-
1220        erencing any variable.  As an example, the following can be used without harm
1221        (besides makeing muttng very likely behave strange):
1222
1223             set read_inc = 100
1224             set folder = $read_inc
1225             set read_inc = $folder
1226             set user_magic_number = 42
1227             set folder = $user_magic_number
1228
1229        _\b3_\b._\b4  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg_\b/_\bU_\bs_\bi_\bn_\bg _\ba_\bl_\bi_\ba_\bs_\be_\bs
1230
1231        Usage: alias _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
1232
1233        It's usually very cumbersome to remember or type out the address of someone you
1234        are communicating with.  Mutt-ng allows you to create ``aliases'' which map a
1235        short string to a full address.
1236
1237        N\bNo\bot\bte\be:\b: if you want to create an alias for a group (by specifying more than one
1238        address), you m\bmu\bus\bst\bt separate the addresses with a comma (``,'').
1239
1240        To remove an alias or aliases (``*'' means all aliases):
1241
1242        unalias [ * | _\bk_\be_\by _\b._\b._\b. ]
1243
1244             alias muttdude me@cs.hmc.edu (Michael Elkins)
1245             alias theguys manny, moe, jack
1246
1247        Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a spe-
1248        cial file.  The alias command can appear anywhere in a configuration file, as
1249        long as this file is _\bs_\bo_\bu_\br_\bc_\be_\bd (section 3.29  , page 45).  Consequently, you can
1250        have multiple alias files, or you can have all aliases defined in your muttrc.
1251
1252        On the other hand, the _\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (section 2.5.4  , page 11) function can use
1253
1254        The Mutt Next Generation E-Mail Client                                       26
1255
1256        only one file, the one pointed to by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 7.4.5  , page 89)
1257        variable (which is ~/.muttrc by default). This file is not special either, in
1258        the sense that Mutt-ng will happily append aliases to any file, but in order
1259        for the new aliases to take effect you need to explicitly _\bs_\bo_\bu_\br_\bc_\be (section
1260        3.29  , page 45) this file too.
1261
1262        For example:
1263
1264             source /usr/local/share/Mutt-ng.aliases
1265             source ~/.mail_aliases
1266             set alias_file=~/.mail_aliases
1267
1268        To use aliases, you merely use the alias at any place in mutt where mutt
1269        prompts for addresses, such as the _\bT_\bo_\b: or _\bC_\bc_\b: prompt.  You can also enter
1270        aliases in your editor at the appropriate headers if you have the _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs
1271        (section 7.4.59  , page 102) variable set.
1272
1273        In addition, at the various address prompts, you can use the tab character to
1274        expand a partial alias to the full alias.  If there are multiple matches, mutt
1275        will bring up a menu with the matching aliases.  In order to be presented with
1276        the full list of aliases, you must hit tab with out a partial alias, such as at
1277        the beginning of the prompt or after a comma denoting multiple addresses.
1278
1279        In the alias menu, you can select as many aliases as you want with the _\bs_\be_\bl_\be_\bc_\bt_\b-
1280        _\be_\bn_\bt_\br_\by key (default: RET), and use the _\be_\bx_\bi_\bt key (default: q) to return to the
1281        address prompt.
1282
1283        _\b3_\b._\b5  _\bC_\bh_\ba_\bn_\bg_\bi_\bn_\bg _\bt_\bh_\be _\bd_\be_\bf_\ba_\bu_\bl_\bt _\bk_\be_\by _\bb_\bi_\bn_\bd_\bi_\bn_\bg_\bs
1284
1285        Usage: bind _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
1286
1287        This command allows you to change the default key bindings (operation invoked
1288        when pressing a key).
1289
1290        _\bm_\ba_\bp specifies in which menu the binding belongs.  Multiple maps may be speci-
1291        fied by separating them with commas (no additional whitespace is allowed). The
1292        currently defined maps are:
1293
1294              generic
1295                    This is not a real menu, but is used as a fallback for all of the
1296                    other menus except for the pager and editor modes.  If a key is not
1297                    defined in another menu, Mutt-ng will look for a binding to use in
1298                    this menu.  This allows you to bind a key to a certain function in
1299                    multiple menus instead of having multiple bind statements to accom-
1300                    plish the same task.
1301
1302              alias
1303                    The alias menu is the list of your personal aliases as defined in
1304
1305        The Mutt Next Generation E-Mail Client                                       27
1306
1307                    your muttrc.  It is the mapping from a short alias name to the full
1308                    email address(es) of the recipient(s).
1309
1310              attach
1311                    The attachment menu is used to access the attachments on received
1312                    messages.
1313
1314              browser
1315                    The browser is used for both browsing the local directory struc-
1316                    ture, and for listing all of your incoming mailboxes.
1317
1318              editor
1319                    The editor is the line-based editor the user enters text data.
1320
1321              index
1322                    The index is the list of messages contained in a mailbox.
1323
1324              compose
1325                    The compose menu is the screen used when sending a new message.
1326
1327              pager
1328                    The pager is the mode used to display message/attachment data, and
1329                    help listings.
1330
1331              pgp
1332                    The pgp menu is used to select the OpenPGP keys used for encrypting
1333                    outgoing messages.
1334
1335              postpone
1336                    The postpone menu is similar to the index menu, except is used when
1337                    recalling a message the user was composing, but saved until later.
1338
1339        _\bk_\be_\by is the key (or key sequence) you wish to bind.  To specify a control char-
1340        acter, use the sequence _\b\_\bC_\bx, where _\bx is the letter of the control character
1341        (for example, to specify control-A use ``\Ca'').  Note that the case of _\bx as
1342        well as _\b\_\bC is ignored, so that _\b\_\bC_\bA, _\b\_\bC_\ba, _\b\_\bc_\bA and _\b\_\bc_\ba are all equivalent.  An
1343        alternative form is to specify the key as a three digit octal number prefixed
1344        with a ``\'' (for example _\b\_\b1_\b7_\b7 is equivalent to _\b\_\bc_\b?).
1345
1346        In addition, _\bk_\be_\by may consist of:
1347
1348        The Mutt Next Generation E-Mail Client                                       28
1349
1350             \t              tab
1351             <tab>           tab
1352             <backtab>       backtab / shift-tab
1353             \r              carriage return
1354             \n              newline
1355             \e              escape
1356             <esc>           escape
1357             <up>            up arrow
1358             <down>          down arrow
1359             <left>          left arrow
1360             <right>         right arrow
1361             <pageup>        Page Up
1362             <pagedown>      Page Down
1363             <backspace>     Backspace
1364             <delete>        Delete
1365             <insert>        Insert
1366             <enter>         Enter
1367             <return>        Return
1368             <home>          Home
1369             <end>           End
1370             <space>         Space bar
1371             <f1>            function key 1
1372             <f10>           function key 10
1373
1374        _\bk_\be_\by does not need to be enclosed in quotes unless it contains a space (`` '').
1375
1376        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn specifies which action to take when _\bk_\be_\by is pressed.  For a complete
1377        list of functions, see the _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 174).  The special
1378        function noop unbinds the specified key sequence.
1379
1380        _\b3_\b._\b6  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg _\ba_\bl_\bi_\ba_\bs_\be_\bs _\bf_\bo_\br _\bc_\bh_\ba_\br_\ba_\bc_\bt_\be_\br _\bs_\be_\bt_\bs
1381
1382        Usage: charset-hook _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
1383
1384        Usage: iconv-hook _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
1385
1386        The charset-hook command defines an alias for a character set.  This is useful
1387        to properly display messages which are tagged with a character set name not
1388        known to mutt.
1389
1390        The iconv-hook command defines a system-specific name for a character set.
1391        This is helpful when your systems character conversion library insists on using
1392        strange, system-specific names for character sets.
1393
1394        _\b3_\b._\b7  _\bS_\be_\bt_\bt_\bi_\bn_\bg _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs _\bb_\ba_\bs_\be_\bd _\bu_\bp_\bo_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1395
1396        Usage: folder-hook [!]_\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1397
1398        It is often desirable to change settings based on which mailbox you are
1399
1400        The Mutt Next Generation E-Mail Client                                       29
1401
1402        reading.  The folder-hook command provides a method by which you can execute
1403        any configuration command.  _\br_\be_\bg_\be_\bx_\bp is a regular expression specifying in which
1404        mailboxes to execute _\bc_\bo_\bm_\bm_\ba_\bn_\bd before loading.  If a mailbox matches multiple
1405        folder-hook's, they are executed in the order given in the muttrc.
1406
1407        N\bNo\bot\bte\be:\b: if you use the ``!'' shortcut for _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.304  , page
1408        162) at the beginning of the pattern, you must place it inside of double or
1409        single quotes in order to distinguish it from the logical _\bn_\bo_\bt operator for the
1410        expression.
1411
1412        Note that the settings are _\bn_\bo_\bt restored when you leave the mailbox.  For exam-
1413        ple, a command action to perform is to change the sorting method based upon the
1414        mailbox being read:
1415
1416             folder-hook mutt set sort=threads
1417
1418        However, the sorting method is not restored to its previous value when reading
1419        a different mailbox.  To specify a _\bd_\be_\bf_\ba_\bu_\bl_\bt command, use the pattern ``.'':
1420
1421             folder-hook . set sort=date-sent
1422
1423        _\b3_\b._\b8  _\bK_\be_\by_\bb_\bo_\ba_\br_\bd _\bm_\ba_\bc_\br_\bo_\bs
1424
1425        Usage: macro _\bm_\be_\bn_\bu _\bk_\be_\by _\bs_\be_\bq_\bu_\be_\bn_\bc_\be [ _\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn ]
1426
1427        Macros are useful when you would like a single key to perform a series of
1428        actions.  When you press _\bk_\be_\by in menu _\bm_\be_\bn_\bu, Mutt-ng will behave as if you had
1429        typed _\bs_\be_\bq_\bu_\be_\bn_\bc_\be.  So if you have a common sequence of commands you type, you can
1430        create a macro to execute those commands with a single key.
1431
1432        _\bm_\be_\bn_\bu is the _\bm_\ba_\bp (section 3.5  , page 26) which the macro will be bound.  Multi-
1433        ple maps may be specified by separating multiple menu arguments by commas.
1434        Whitespace may not be used in between the menu arguments and the commas sepa-
1435        rating them.
1436
1437        _\bk_\be_\by and _\bs_\be_\bq_\bu_\be_\bn_\bc_\be are expanded by the same rules as the _\bk_\be_\by _\bb_\bi_\bn_\bd_\bi_\bn_\bg_\bs (section
1438        3.5  , page 26).  There are some additions however.  The first is that control
1439        characters in _\bs_\be_\bq_\bu_\be_\bn_\bc_\be can also be specified as _\b^_\bx.  In order to get a caret
1440        (`^'') you need to use _\b^_\b^.  Secondly, to specify a certain key such as _\bu_\bp or to
1441        invoke a function directly, you can use the format _\b<_\bk_\be_\by _\bn_\ba_\bm_\be_\b> and _\b<_\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
1442        _\bn_\ba_\bm_\be_\b>.  For a listing of key names see the section on _\bk_\be_\by _\bb_\bi_\bn_\bd_\bi_\bn_\bg_\bs (section
1443        3.5  , page 26).  Functions are listed in the _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section
1444        7.5  , page 174).
1445
1446        The advantage with using function names directly is that the macros will work
1447        regardless of the current key bindings, so they are not dependent on the user
1448        having particular key definitions.  This makes them more robust and portable,
1449        and also facilitates defining of macros in files used by more than one user
1450
1451        The Mutt Next Generation E-Mail Client                                       30
1452
1453        (eg. the system Muttngrc).
1454
1455        Optionally you can specify a descriptive text after _\bs_\be_\bq_\bu_\be_\bn_\bc_\be, which is shown in
1456        the help screens.
1457
1458        N\bNo\bot\bte\be:\b: Macro definitions (if any) listed in the help screen(s), are silently
1459        truncated at the screen width, and are not wrapped.
1460
1461        _\b3_\b._\b9  _\bU_\bs_\bi_\bn_\bg _\bc_\bo_\bl_\bo_\br _\ba_\bn_\bd _\bm_\bo_\bn_\bo _\bv_\bi_\bd_\be_\bo _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be_\bs
1462
1463        Usage: color _\bo_\bb_\bj_\be_\bc_\bt _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd _\bb_\ba_\bc_\bk_\bg_\br_\bo_\bu_\bn_\bd [ _\br_\be_\bg_\be_\bx_\bp ]
1464
1465        Usage: color index _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd _\bb_\ba_\bc_\bk_\bg_\br_\bo_\bu_\bn_\bd _\bp_\ba_\bt_\bt_\be_\br_\bn
1466
1467        Usage: uncolor index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1468
1469        If your terminal supports color, you can spice up Mutt-ng by creating your own
1470        color scheme.  To define the color of an object (type of information), you must
1471        specify both a foreground color a\ban\bnd\bd a background color (it is not possible to
1472        only specify one or the other).
1473
1474        _\bo_\bb_\bj_\be_\bc_\bt can be one of:
1475
1476           +\bo attachment
1477
1478           +\bo body (match _\br_\be_\bg_\be_\bx_\bp in the body of messages)
1479
1480           +\bo bold (highlighting bold patterns in the body of messages)
1481
1482           +\bo error (error messages printed by Mutt-ng)
1483
1484           +\bo header (match _\br_\be_\bg_\be_\bx_\bp in the message header)
1485
1486           +\bo hdrdefault (default color of the message header in the pager)
1487
1488           +\bo index (match _\bp_\ba_\bt_\bt_\be_\br_\bn in the message index)
1489
1490           +\bo indicator (arrow or bar used to indicate the current item in a menu)
1491
1492           +\bo markers (the ``+'' markers at the beginning of wrapped lines in the pager)
1493
1494           +\bo message (informational messages)
1495
1496           +\bo normal
1497
1498           +\bo quoted (text matching _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.232  , page 145) in the
1499             body of a message)
1500
1501           +\bo quoted1, quoted2, ..., quotedN\bN (higher levels of quoting)
1502
1503           +\bo search (highlighting of words in the pager)
1504
1505        The Mutt Next Generation E-Mail Client                                       31
1506
1507           +\bo signature
1508
1509           +\bo status (mode lines used to display info about the mailbox or message)
1510
1511           +\bo tilde (the ``~'' used to pad blank lines in the pager)
1512
1513           +\bo tree (thread tree drawn in the message index and attachment menu)
1514
1515           +\bo underline (highlighting underlined patterns in the body of messages)
1516
1517        _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd and _\bb_\ba_\bc_\bk_\bg_\br_\bo_\bu_\bn_\bd can be one of the following:
1518
1519           +\bo white
1520
1521           +\bo black
1522
1523           +\bo green
1524
1525           +\bo magenta
1526
1527           +\bo blue
1528
1529           +\bo cyan
1530
1531           +\bo yellow
1532
1533           +\bo red
1534
1535           +\bo default
1536
1537           +\bo color_\bx
1538
1539        _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd can optionally be prefixed with the keyword bright to make the fore-
1540        ground color boldfaced (e.g., brightred).
1541
1542        If your terminal supports it, the special keyword _\bd_\be_\bf_\ba_\bu_\bl_\bt can be used as a
1543        transparent color.  The value _\bb_\br_\bi_\bg_\bh_\bt_\bd_\be_\bf_\ba_\bu_\bl_\bt is also valid.  If Mutt-ng is
1544        linked against the _\bS_\b-_\bL_\ba_\bn_\bg library, you also need to set the _\bC_\bO_\bL_\bO_\bR_\bF_\bG_\bB_\bG environ-
1545        ment variable to the default colors of your terminal for this to work; for
1546        example (for Bourne-like shells):
1547
1548             set COLORFGBG="green;black"
1549             export COLORFGBG
1550
1551        N\bNo\bot\bte\be:\b: The _\bS_\b-_\bL_\ba_\bn_\bg library requires you to use the _\bl_\bi_\bg_\bh_\bt_\bg_\br_\ba_\by and _\bb_\br_\bo_\bw_\bn keywords
1552        instead of _\bw_\bh_\bi_\bt_\be and _\by_\be_\bl_\bl_\bo_\bw when setting this variable.
1553
1554        N\bNo\bot\bte\be:\b: The uncolor command can be applied to the index object only.  It removes
1555        entries from the list. You m\bmu\bus\bst\bt specify the same pattern specified in the color
1556        command for it to be removed.  The pattern ``*'' is a special token which means
1557        to clear the color index list of all entries.
1558
1559        The Mutt Next Generation E-Mail Client                                       32
1560
1561        Mutt-ng also recognizes the keywords _\bc_\bo_\bl_\bo_\br_\b0, _\bc_\bo_\bl_\bo_\br_\b1, ..., _\bc_\bo_\bl_\bo_\brN\bN-\b-1\b1 (N\bN being the
1562        number of colors supported by your terminal).  This is useful when you remap
1563        the colors for your display (for example by changing the color associated with
1564        _\bc_\bo_\bl_\bo_\br_\b2 for your xterm), since color names may then lose their normal meaning.
1565
1566        If your terminal does not support color, it is still possible change the video
1567        attributes through the use of the ``mono'' command:
1568
1569        Usage: mono _\b<_\bo_\bb_\bj_\be_\bc_\bt_\b> _\b<_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be_\b> [ _\br_\be_\bg_\be_\bx_\bp ]
1570
1571        Usage: mono index _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be _\bp_\ba_\bt_\bt_\be_\br_\bn
1572
1573        Usage: unmono index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1574
1575        where _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be is one of the following:
1576
1577           +\bo none
1578
1579           +\bo bold
1580
1581           +\bo underline
1582
1583           +\bo reverse
1584
1585           +\bo standout
1586
1587        _\b3_\b._\b1_\b0  _\bI_\bg_\bn_\bo_\br_\bi_\bn_\bg _\b(_\bw_\be_\be_\bd_\bi_\bn_\bg_\b) _\bu_\bn_\bw_\ba_\bn_\bt_\be_\bd _\bm_\be_\bs_\bs_\ba_\bg_\be _\bh_\be_\ba_\bd_\be_\br_\bs
1588
1589        Usage: [un]ignore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1590
1591        Messages often have many header fields added by automatic processing systems,
1592        or which may not seem useful to display on the screen.  This command allows you
1593        to specify header fields which you don't normally want to see.
1594
1595        You do not need to specify the full header field name.  For example, ``ignore
1596        content-'' will ignore all header fields that begin with the pattern ``con-
1597        tent-''. ``ignore *'' will ignore all headers.
1598
1599        To remove a previously added token from the list, use the ``unignore'' command.
1600        The ``unignore'' command will make Mutt-ng display headers with the given pat-
1601        tern.  For example, if you do ``ignore x-'' it is possible to ``unignore x-
1602        mailer''.
1603
1604        ``unignore *'' will remove all tokens from the ignore list.
1605
1606        For example:
1607
1608             # Sven's draconian header weeding
1609             ignore *
1610             unignore from date subject to cc
1611             unignore organization organisation x-mailer: x-newsreader: x-mailing-list:
1612             unignore posted-to:
1613
1614        The Mutt Next Generation E-Mail Client                                       33
1615
1616        _\b3_\b._\b1_\b1  _\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be _\ba_\bd_\bd_\br_\be_\bs_\bs_\be_\bs
1617
1618        Usage: [un]alternates _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1619
1620        With various functions, mutt will treat messages differently, depending on
1621        whether you sent them or whether you received them from someone else.  For
1622        instance, when replying to a message that you sent to a different party, mutt
1623        will automatically suggest to send the response to the original message's
1624        recipients -- responding to yourself won't make much sense in many cases.  (See
1625        _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section 7.4.240  , page 147).)
1626
1627        Many users receive e-mail under a number of different addresses. To fully use
1628        mutt's features here, the program must be able to recognize what e-mail
1629        addresses you receive mail under. That's the purpose of the alternates command:
1630        It takes a list of regular expressions, each of which can identify an address
1631        under which you receive e-mail.
1632
1633        The unalternates command can be used to write exceptions to alternates pat-
1634        terns. If an address matches something in an alternates command, but you none-
1635        theless do not think it is from you, you can list a more precise pattern under
1636        an unalternates command.
1637
1638        To remove a regular expression from the alternates list, use the unalternates
1639        command with exactly the same _\br_\be_\bg_\be_\bx_\bp.  Likewise, if the _\br_\be_\bg_\be_\bx_\bp for a alternates
1640        command matches an entry on the unalternates list, that unalternates entry will
1641        be removed. If the _\br_\be_\bg_\be_\bx_\bp for unalternates is ``*'', _\ba_\bl_\bl _\be_\bn_\bt_\br_\bi_\be_\bs on alternates
1642        will be removed.
1643
1644        _\b3_\b._\b1_\b2  _\bF_\bo_\br_\bm_\ba_\bt _\b= _\bF_\bl_\bo_\bw_\be_\bd
1645
1646        _\b3_\b._\b1_\b2_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
1647
1648        Mutt-ng contains support for so-called format=flowed messages.  In the begin-
1649        ning of email, each message had a fixed line width, and it was enough for dis-
1650        playing them on fixed-size terminals. But times changed, and nowadays hardly
1651        anybody still uses fixed-size terminals: more people nowaydays use graphical
1652        user interfaces, with dynamically resizable windows. This led to the demand of
1653        a new email format that makes it possible for the email client to make the
1654        email look nice in a resizable window without breaking quoting levels and cre-
1655        ating an incompatible email format that can also be displayed nicely on old
1656        fixed-size terminals.
1657
1658        For introductory information on format=flowed messages, see
1659        <http://www.joeclark.org/ffaq.html>.
1660
1661        _\b3_\b._\b1_\b2_\b._\b2  _\bR_\be_\bc_\be_\bi_\bv_\bi_\bn_\bg_\b: _\bD_\bi_\bs_\bp_\bl_\ba_\by _\bS_\be_\bt_\bu_\bp
1662
1663        When you receive emails that are marked as format=flowed messages, and is for-
1664        matted correctly, mutt-ng will try to reformat the message to optimally fit on
1665        your terminal. If you want a fixed margin on the right side of your terminal,
1666        you can set the following:
1667
1668        The Mutt Next Generation E-Mail Client                                       34
1669
1670                 set wrapmargin = 10
1671
1672        The code above makes the line break 10 columns before the right side of the
1673        terminal.
1674
1675        If your terminal is so wide that the lines are embarrassingly long, you can
1676        also set a maximum line length:
1677
1678                 set max_line_length = 120
1679
1680        The example above will give you lines not longer than 120 characters.
1681
1682        When you view at format=flowed messages, you will often see the quoting hierar-
1683        chy like in the following example:
1684
1685                 >Bill, can you please send last month's progress report to Mr.
1686                 >Morgan? We also urgently need the cost estimation for the new
1687                 >production server that we want to set up before our customer's
1688                 >project will go live.
1689
1690        This obviously doesn't look very nice, and it makes it very hard to differenti-
1691        ate between text and quoting character. The solution is to configure mutt-ng to
1692        "stuff" the quoting:
1693
1694                 set stuff_quoted
1695
1696        This will lead to a nicer result that is easier to read:
1697
1698                 > Bill, can you please send last month's progress report to Mr.
1699                 > Morgan? We also urgently need the cost estimation for the new
1700                 > production server that we want to set up before our customer's
1701                 > project will go live.
1702
1703        _\b3_\b._\b1_\b2_\b._\b3  _\bS_\be_\bn_\bd_\bi_\bn_\bg
1704
1705        If you want mutt-ng to send emails with format=flowed set, you need to explic-
1706        itly set it:
1707
1708                 set text_flowed
1709
1710        The Mutt Next Generation E-Mail Client                                       35
1711
1712        Additionally, you have to use an editor which supports writing format=flowed-
1713        conforming emails. For vim, this is done by adding w to the formatoptions (see
1714        :h formatoptions and :h fo-table) when writing emails.
1715
1716        Also note that _\bf_\bo_\br_\bm_\ba_\bt_\b=_\bf_\bl_\bo_\bw_\be_\bd knows about ``space-stuffing'', that is, when
1717        sending messages, some kinds of lines have to be indented with a single space
1718        on the sending side. On the receiving side, the first space (if any) is
1719        removed. As a consequence and in addition to the above simple setting, please
1720        keep this in mind when making manual formattings within the editor. Also note
1721        that mutt-ng currently violates the standard (RfC 3676) as it does not space-
1722        stuff lines starting with:
1723
1724           +\bo > This is _\bn_\bo_\bt the quote character but a right angle used for other reasons
1725
1726           +\bo From with a trailing space.
1727
1728           +\bo just a space for formatting reasons
1729
1730        Please make sure that you manually prepend a space to each of them.
1731
1732        _\b3_\b._\b1_\b2_\b._\b4  _\bA_\bd_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bN_\bo_\bt_\be_\bs
1733
1734            "
1735
1736         For completeness, the _\b$_\bd_\be_\bl_\be_\bt_\be_\b__\bs_\bp_\ba_\bc_\be (section 7.4.51  , page 100) variable pro-
1737        vides the mechanism to generate a DelSp=yes parameter on _\bo_\bu_\bt_\bg_\bo_\bi_\bn_\bg messages.
1738        According to the standard, clients receiving a format=flowed messages should
1739        delete the last space of a flowed line but still interpret the line as flowed.
1740        Because flowed lines usually contain only one space at the end, this parameter
1741        would make the receiving client concatenate the last word of the previous with
1742        the first of the current line _\bw_\bi_\bt_\bh_\bo_\bu_\bt a space. This makes ordinary text unread-
1743        able and is intended for languages rarely using spaces. So please use this set-
1744        ting only if you're sure what you're doing.
1745
1746        _\b3_\b._\b1_\b3  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bl_\bi_\bs_\bt_\bs
1747
1748        Usage: [un]lists _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1749
1750        Usage: [un]subscribe _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1751
1752        Mutt-ng has a few nice features for _\bh_\ba_\bn_\bd_\bl_\bi_\bn_\bg _\bm_\ba_\bi_\bl_\bi_\bn_\bg _\bl_\bi_\bs_\bt_\bs (section 4.10  ,
1753        page 60).  In order to take advantage of them, you must specify which addresses
1754        belong to mailing lists, and which mailing lists you are subscribed to.  Once
1755        you have done this, the _\bl_\bi_\bs_\bt_\b-_\br_\be_\bp_\bl_\by (section 2.5.4  , page 12) function will
1756        work for all known lists.  Additionally, when you send a message to a sub-
1757        scribed list, mutt will add a Mail-Followup-To header to tell other users' mail
1758        user agents not to send copies of replies to your personal address.   Note that
1759        the Mail-Followup-To header is a non-standard extension which is not supported
1760        by all mail user agents.  Adding it is not bullet-proof against receiving per-
1761        sonal CCs of list messages.  Also note that the generation of the Mail-Fol-
1762        lowup-To header is controlled by the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.72  , page 105)
1763        configuration variable.
1764
1765        The Mutt Next Generation E-Mail Client                                       36
1766
1767        More precisely, Mutt-ng maintains lists of patterns for the addresses of known
1768        and subscribed mailing lists.  Every subscribed mailing list is known. To mark
1769        a mailing list as known, use the ``lists'' command.  To mark it as subscribed,
1770        use ``subscribe''.
1771
1772        You can use regular expressions with both commands.  To mark all messages sent
1773        to a specific bug report's address on mutt's bug tracking system as list mail,
1774        for instance, you could say ``subscribe [0-9]*@bugs.guug.de''.  Often, it's
1775        sufficient to just give a portion of the list's e-mail address.
1776
1777        Specify as much of the address as you need to to remove ambiguity.  For exam-
1778        ple, if you've subscribed to the Mutt-ng mailing list, you will receive mail
1779        addressed to _\bm_\bu_\bt_\bt_\b-_\bu_\bs_\be_\br_\bs_\b@_\bm_\bu_\bt_\bt_\b._\bo_\br_\bg.  So, to tell Mutt-ng that this is a mailing
1780        list, you could add ``lists mutt-users'' to your initialization file.  To tell
1781        mutt that you are subscribed to it, add ``subscribe mutt-users'' to your ini-
1782        tialization file instead.  If you also happen to get mail from someone whose
1783        address is _\bm_\bu_\bt_\bt_\b-_\bu_\bs_\be_\br_\bs_\b@_\be_\bx_\ba_\bm_\bp_\bl_\be_\b._\bc_\bo_\bm, you could use ``lists mutt-
1784        users@mutt\\.org'' or ``subscribe mutt-users@mutt\\.org'' to match only mail
1785        from the actual list.
1786
1787        The ``unlists'' command is used to remove a token from the list of known and
1788        subscribed mailing-lists. Use ``unlists *'' to remove all tokens.
1789
1790        To remove a mailing list from the list of subscribed mailing lists, but keep it
1791        on the list of known mailing lists, use ``unsubscribe''.
1792
1793        _\b3_\b._\b1_\b4  _\bU_\bs_\bi_\bn_\bg _\bM_\bu_\bl_\bt_\bi_\bp_\bl_\be _\bs_\bp_\bo_\bo_\bl _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs
1794
1795        Usage: mbox-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1796
1797        This command is used to move read messages from a specified mailbox to a dif-
1798        ferent mailbox automatically when you quit or change folders.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a
1799        regular expression specifying the mailbox to treat as a ``spool'' mailbox and
1800        _\bm_\ba_\bi_\bl_\bb_\bo_\bx specifies where mail should be saved when read.
1801
1802        Unlike some of the other _\bh_\bo_\bo_\bk commands, only the _\bf_\bi_\br_\bs_\bt matching pattern is used
1803        (it is not possible to save read mail in more than a single mailbox).
1804
1805        _\b3_\b._\b1_\b5  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs _\bw_\bh_\bi_\bc_\bh _\br_\be_\bc_\be_\bi_\bv_\be _\bm_\ba_\bi_\bl
1806
1807        Usage: [un]mailboxes [!]_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
1808
1809        This command specifies folders which can receive mail and which will be checked
1810        for new messages.  By default, the main menu status bar displays how many of
1811        these folders have new messages.
1812
1813        When changing folders, pressing _\bs_\bp_\ba_\bc_\be will cycle through folders with new mail.
1814
1815        Pressing TAB in the directory browser will bring up a menu showing the files
1816        specified by the mailboxes command, and indicate which contain new messages.
1817
1818        The Mutt Next Generation E-Mail Client                                       37
1819
1820        Mutt-ng will automatically enter this mode when invoked from the command line
1821        with the -y option.
1822
1823        The ``unmailboxes'' command is used to remove a token from the list of folders
1824        which receive mail. Use ``unmailboxes *'' to remove all tokens.
1825
1826        N\bNo\bot\bte\be:\b: new mail is detected by comparing the last modification time to the last
1827        access time.  Utilities like biff or frm or any other program which accesses
1828        the mailbox might cause Mutt-ng to never detect new mail for that mailbox if
1829        they do not properly reset the access time.  Backup tools are another common
1830        reason for updated access times.
1831
1832        N\bNo\bot\bte\be:\b: the filenames in the mailboxes command are resolved when the command is
1833        executed, so if these names contain _\bs_\bh_\bo_\br_\bt_\bc_\bu_\bt _\bc_\bh_\ba_\br_\ba_\bc_\bt_\be_\br_\bs (section 4.9  , page
1834        60) (such as ``='' and ``!''), any variable definition that affect these char-
1835        acters (like _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) and _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
1836        7.4.304  , page 162)) should be executed before the mailboxes command.
1837
1838        _\b3_\b._\b1_\b6  _\bU_\bs_\be_\br _\bd_\be_\bf_\bi_\bn_\be_\bd _\bh_\be_\ba_\bd_\be_\br_\bs
1839
1840        Usage:
1841
1842        my_hdr _\bs_\bt_\br_\bi_\bn_\bg
1843
1844        unmy_hdr _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
1845
1846        The ``my_hdr'' command allows you to create your own header fields which will
1847        be added to every message you send.
1848
1849        For example, if you would like to add an ``Organization:'' header field to all
1850        of your outgoing messages, you can put the command
1851
1852             my_hdr Organization: A Really Big Company, Anytown, USA
1853
1854        in your .muttrc.
1855
1856        N\bNo\bot\bte\be:\b:  space characters are _\bn_\bo_\bt allowed between the keyword and the colon
1857        (``:'').  The standard for electronic mail (RFC822) says that space is illegal
1858        there, so Mutt-ng enforces the rule.
1859
1860        If you would like to add a header field to a single message, you should either
1861        set the _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102) variable, or use the _\be_\bd_\bi_\bt_\b-
1862        _\bh_\be_\ba_\bd_\be_\br_\bs function (default: ``E'') in the send-menu so that you can edit the
1863        header of your message along with the body.
1864
1865        To remove user defined header fields, use the ``unmy_hdr'' command.  You may
1866        specify an asterisk (``*'') to remove all header fields, or the fields to
1867        remove.  For example, to remove all ``To'' and ``Cc'' header fields, you could
1868        use:
1869
1870        The Mutt Next Generation E-Mail Client                                       38
1871
1872             unmy_hdr to cc
1873
1874        _\b3_\b._\b1_\b7  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg _\bt_\bh_\be _\bo_\br_\bd_\be_\br _\bo_\bf _\bh_\be_\ba_\bd_\be_\br_\bs _\bw_\bh_\be_\bn _\bv_\bi_\be_\bw_\bi_\bn_\bg _\bm_\be_\bs_\bs_\ba_\bg_\be_\bs
1875
1876        Usage: hdr_order _\bh_\be_\ba_\bd_\be_\br_\b1 _\bh_\be_\ba_\bd_\be_\br_\b2 _\bh_\be_\ba_\bd_\be_\br_\b3
1877
1878        With this command, you can specify an order in which mutt will attempt to
1879        present headers to you when viewing messages.
1880
1881        ``unhdr_order *'' will clear all previous headers from the order list, thus
1882        removing the header order effects set by the system-wide startup file.
1883
1884             hdr_order From Date: From: To: Cc: Subject:
1885
1886        _\b3_\b._\b1_\b8  _\bS_\bp_\be_\bc_\bi_\bf_\by _\bd_\be_\bf_\ba_\bu_\bl_\bt _\bs_\ba_\bv_\be _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
1887
1888        Usage: save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
1889
1890        This command is used to override the default filename used when saving mes-
1891        sages.  _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be will be used as the default filename if the message is _\bF_\br_\bo_\bm_\b:
1892        an address matching _\br_\be_\bg_\be_\bx_\bp or if you are the author and the message is
1893        addressed _\bt_\bo_\b: something matching _\br_\be_\bg_\be_\bx_\bp.
1894
1895        See _\bM_\be_\bs_\bs_\ba_\bg_\be _\bM_\ba_\bt_\bc_\bh_\bi_\bn_\bg _\bi_\bn _\bH_\bo_\bo_\bk_\bs (section 4.5.1  , page 57) for information on the
1896        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1897
1898        Examples:
1899
1900             save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
1901             save-hook aol\\.com$ +spam
1902
1903        Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 39) command.
1904
1905        _\b3_\b._\b1_\b9  _\bS_\bp_\be_\bc_\bi_\bf_\by _\bd_\be_\bf_\ba_\bu_\bl_\bt _\bF_\bc_\bc_\b: _\bm_\ba_\bi_\bl_\bb_\bo_\bx _\bw_\bh_\be_\bn _\bc_\bo_\bm_\bp_\bo_\bs_\bi_\bn_\bg
1906
1907        Usage: fcc-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1908
1909        This command is used to save outgoing mail in a mailbox other than _\b$_\br_\be_\bc_\bo_\br_\bd
1910        (section 7.4.237  , page 146).  Mutt-ng searches the initial list of message
1911        recipients for the first matching _\br_\be_\bg_\be_\bx_\bp and uses _\bm_\ba_\bi_\bl_\bb_\bo_\bx as the default Fcc:
1912        mailbox.  If no match is found the message will be saved to _\b$_\br_\be_\bc_\bo_\br_\bd (section
1913        7.4.237  , page 146) mailbox.
1914
1915        The Mutt Next Generation E-Mail Client                                       39
1916
1917        See _\bM_\be_\bs_\bs_\ba_\bg_\be _\bM_\ba_\bt_\bc_\bh_\bi_\bn_\bg _\bi_\bn _\bH_\bo_\bo_\bk_\bs (section 4.5.1  , page 57) for information on the
1918        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1919
1920        Example: fcc-hook [@.]aol\\.com$ +spammers
1921
1922        The above will save a copy of all messages going to the aol.com domain to the
1923        `+spammers' mailbox by default.  Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  ,
1924        page 39) command.
1925
1926        _\b3_\b._\b2_\b0  _\bS_\bp_\be_\bc_\bi_\bf_\by _\bd_\be_\bf_\ba_\bu_\bl_\bt _\bs_\ba_\bv_\be _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be _\ba_\bn_\bd _\bd_\be_\bf_\ba_\bu_\bl_\bt _\bF_\bc_\bc_\b: _\bm_\ba_\bi_\bl_\bb_\bo_\bx _\ba_\bt _\bo_\bn_\bc_\be
1927
1928        Usage: fcc-save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1929
1930        This command is a shortcut, equivalent to doing both a _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section
1931        3.19  , page 38) and a _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 38) with its arguments.
1932
1933        _\b3_\b._\b2_\b1  _\bC_\bh_\ba_\bn_\bg_\be _\bs_\be_\bt_\bt_\bi_\bn_\bg_\bs _\bb_\ba_\bs_\be_\bd _\bu_\bp_\bo_\bn _\bm_\be_\bs_\bs_\ba_\bg_\be _\br_\be_\bc_\bi_\bp_\bi_\be_\bn_\bt_\bs
1934
1935        Usage: reply-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1936
1937        Usage: send-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1938
1939        Usage: send2-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1940
1941        These commands can be used to execute arbitrary configuration commands based
1942        upon recipients of the message.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a regular expression matching the
1943        desired address.  _\bc_\bo_\bm_\bm_\ba_\bn_\bd is executed when _\br_\be_\bg_\be_\bx_\bp matches recipients of the
1944        message.
1945
1946        reply-hook is matched against the message you are _\br_\be_\bp_\bl_\by_\bi_\bn_\bg t\bto\bo, instead of the
1947        message you are _\bs_\be_\bn_\bd_\bi_\bn_\bg.  send-hook is matched against all messages, both _\bn_\be_\bw
1948        and _\br_\be_\bp_\bl_\bi_\be_\bs.  N\bNo\bot\bte\be:\b: reply-hooks are matched b\bbe\bef\bfo\bor\bre\be the send-hook, r\bre\beg\bga\bar\brd\bdl\ble\bes\bss\bs of
1949        the order specified in the users's configuration file.
1950
1951        send2-hook is matched every time a message is changed, either by editing it, or
1952        by using the compose menu to change its recipients or subject.  send2-hook is
1953        executed after send-hook, and can, e.g., be used to set parameters such as the
1954        _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.254  , page 150) variable depending on the message's
1955        sender address.
1956
1957        For each type of send-hook or reply-hook, when multiple matches occur, commands
1958        are executed in the order they are specified in the muttrc (for that type of
1959        hook).
1960
1961        See _\bM_\be_\bs_\bs_\ba_\bg_\be _\bM_\ba_\bt_\bc_\bh_\bi_\bn_\bg _\bi_\bn _\bH_\bo_\bo_\bk_\bs (section 4.5.1  , page 57) for information on the
1962        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1963
1964        Example: send-hook mutt 'set mime_forward signature='''
1965
1966        Another typical use for this command is to change the values of the
1967
1968        The Mutt Next Generation E-Mail Client                                       40
1969
1970        _\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 7.4.18  , page 93), _\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.266  , page
1971        153) and _\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.120  , page 119) variables in order to change the
1972        language of the attributions and signatures based upon the recipients.
1973
1974        N\bNo\bot\bte\be:\b: the send-hook's are only executed ONCE after getting the initial list of
1975        recipients.  Adding a recipient after replying or editing the message will NOT
1976        cause any send-hook to be executed.  Also note that my_hdr commands which mod-
1977        ify recipient headers, or the message's subject, don't have any effect on the
1978        current message when executed from a send-hook.
1979
1980        _\b3_\b._\b2_\b2  _\bC_\bh_\ba_\bn_\bg_\be _\bs_\be_\bt_\bt_\bi_\bn_\bg_\bs _\bb_\be_\bf_\bo_\br_\be _\bf_\bo_\br_\bm_\ba_\bt_\bt_\bi_\bn_\bg _\ba _\bm_\be_\bs_\bs_\ba_\bg_\be
1981
1982        Usage: message-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1983
1984        This command can be used to execute arbitrary configuration commands before
1985        viewing or formatting a message based upon information about the message.  _\bc_\bo_\bm_\b-
1986        _\bm_\ba_\bn_\bd is executed if the _\bp_\ba_\bt_\bt_\be_\br_\bn matches the message to be displayed. When mul-
1987        tiple matches occur, commands are executed in the order they are specified in
1988        the muttrc.
1989
1990        See _\bM_\be_\bs_\bs_\ba_\bg_\be _\bM_\ba_\bt_\bc_\bh_\bi_\bn_\bg _\bi_\bn _\bH_\bo_\bo_\bk_\bs (section 4.5.1  , page 57) for information on the
1991        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1992
1993        Example:
1994
1995             message-hook ~A 'set pager=builtin'
1996             message-hook '~f freshmeat-news' 'set pager="less \"+/^  subject: .*\""'
1997
1998        _\b3_\b._\b2_\b3  _\bC_\bh_\bo_\bo_\bs_\bi_\bn_\bg _\bt_\bh_\be _\bc_\br_\by_\bp_\bt_\bo_\bg_\br_\ba_\bp_\bh_\bi_\bc _\bk_\be_\by _\bo_\bf _\bt_\bh_\be _\br_\be_\bc_\bi_\bp_\bi_\be_\bn_\bt
1999
2000        Usage: crypt-hook _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\bi_\bd
2001
2002        When encrypting messages with PGP or OpenSSL, you may want to associate a cer-
2003        tain key with a given e-mail address automatically, either because the recipi-
2004        ent's public key can't be deduced from the destination address, or because, for
2005        some reasons, you need to override the key Mutt-ng would normally use.  The
2006        crypt-hook command provides a method by which you can specify the ID of the
2007        public key to be used when encrypting messages to a certain recipient.
2008
2009        The meaning of "key id" is to be taken broadly in this context:  You can either
2010        put a numerical key ID here, an e-mail address, or even just a real name.
2011
2012        _\b3_\b._\b2_\b4  _\bA_\bd_\bd_\bi_\bn_\bg _\bk_\be_\by _\bs_\be_\bq_\bu_\be_\bn_\bc_\be_\bs _\bt_\bo _\bt_\bh_\be _\bk_\be_\by_\bb_\bo_\ba_\br_\bd _\bb_\bu_\bf_\bf_\be_\br
2013
2014        Usage: push _\bs_\bt_\br_\bi_\bn_\bg
2015
2016        This command adds the named string to the keyboard buffer. The string may
2017
2018        The Mutt Next Generation E-Mail Client                                       41
2019
2020        contain control characters, key names and function names like the sequence
2021        string in the _\bm_\ba_\bc_\br_\bo (section 3.8  , page 29) command. You may use it to auto-
2022        matically run a sequence of commands at startup, or when entering certain fold-
2023        ers.
2024
2025        _\b3_\b._\b2_\b5  _\bE_\bx_\be_\bc_\bu_\bt_\bi_\bn_\bg _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
2026
2027        Usage: exec _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
2028
2029        This command can be used to execute any function. Functions are listed in the
2030        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 174).  ``exec function'' is equivalent
2031        to ``push <function>''.
2032
2033        _\b3_\b._\b2_\b6  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bS_\bc_\bo_\br_\bi_\bn_\bg
2034
2035        Usage: score _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
2036
2037        Usage: unscore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
2038
2039        In situations where you have to cope with a lot of emails, e.g.  when you read
2040        many different mailing lists, and take part in discussions, it is always useful
2041        to have the important messages marked and the annoying messages or the ones
2042        that you aren't interested in deleted. For this purpose, mutt-ng features a
2043        mechanism called ``scoring''.
2044
2045        When you use scoring, every message has a base score of 0. You can then use the
2046        score command to define patterns and a positive or negative value associated
2047        with it. When a pattern matches a message, the message's score will be raised
2048        or lowered by the amount of the value associated with the pattern.
2049
2050             score "~f nion@muttng\.org" 50
2051             score "~f @sco\.com" -100
2052
2053        If the pattern matches, it is also possible to set the score value of the cur-
2054        rent message to a certain value and then stop evaluation:
2055
2056             score "~f santaclaus@northpole\.int" =666
2057
2058        What is important to note is that negative score values will be rounded up to
2059        0.
2060
2061        To make scoring actually useful, the score must be applied in some way.  That's
2062        what the _\bs_\bc_\bo_\br_\be _\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\bs are for. Currently, there are three score thresholds:
2063
2064           +\bo flag threshold: when a message has a score value equal or higher than the
2065             flag threshold, it will be flagged.
2066
2067        The Mutt Next Generation E-Mail Client                                       42
2068
2069           +\bo read threshold: when a message has a score value equal or lower than the
2070             read threshold, it will be marked as read.
2071
2072           +\bo delete threshold: when a message has a score value equal or lower than the
2073             delete threshold, it will be marked as deleted.
2074
2075        These three thresholds can be set via the variables _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bf_\bl_\ba_\bg (sec-
2076        tion 7.4.251  , page 149), _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.252  , page 150),
2077        _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be (section 7.4.250  , page 149) and.  By default,
2078        _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.252  , page 150) and _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
2079        (section 7.4.250  , page 149) are set to -1, which means that in the default
2080        threshold configuration no message will ever get marked as read or deleted.
2081
2082        Scoring gets especially interesting when combined with the color command and
2083        the ~n pattern:
2084
2085             color index  black   yellow  "~n 10-"
2086             color index  red     yellow  "~n 100-"
2087
2088        The rules above mark all messages with a score between 10 and 99 with black and
2089        yellow, and messages with a score greater or equal 100 with red and yellow.
2090        This might be unusual to you if you're used to e.g. slrn's scoring mechanism,
2091        but it is more flexible, as it visually marks different scores.
2092
2093        _\b3_\b._\b2_\b7  _\bS_\bp_\ba_\bm _\bd_\be_\bt_\be_\bc_\bt_\bi_\bo_\bn
2094
2095        Usage: spam _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
2096
2097        Usage: nospam _\bp_\ba_\bt_\bt_\be_\br_\bn
2098
2099        Mutt-ng has generalized support for external spam-scoring filters.  By defining
2100        your spam patterns with the spam and nospam commands, you can _\bl_\bi_\bm_\bi_\bt, _\bs_\be_\ba_\br_\bc_\bh,
2101        and _\bs_\bo_\br_\bt your mail based on its spam attributes, as determined by the external
2102        filter. You also can display the spam attributes in your index display using
2103        the %H selector in the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115) variable.
2104        (Tip: try %?H?[%H] ?  to display spam tags only when they are defined for a
2105        given message.)
2106
2107        Your first step is to define your external filter's spam patterns using the
2108        spam command. _\bp_\ba_\bt_\bt_\be_\br_\bn should be a regular expression that matches a header in a
2109        mail message. If any message in the mailbox matches this regular expression, it
2110        will receive a ``spam tag'' or ``spam attribute'' (unless it also matches a
2111        nospam pattern -- see below.) The appearance of this attribute is entirely up
2112        to you, and is governed by the _\bf_\bo_\br_\bm_\ba_\bt parameter. _\bf_\bo_\br_\bm_\ba_\bt can be any static text,
2113        but it also can include back-references from the _\bp_\ba_\bt_\bt_\be_\br_\bn expression. (A regular
2114        expression ``back-reference'' refers to a sub-expression contained within
2115        parentheses.) %1 is replaced with the first back-reference in the regex, %2
2116        with the second, etc.
2117
2118        If you're using multiple spam filters, a message can have more than one spam-
2119
2120        The Mutt Next Generation E-Mail Client                                       43
2121
2122        related header. You can define spam patterns for each filter you use. If a mes-
2123        sage matches two or more of these patterns, and the $spam_separator variable is
2124        set to a string, then the message's spam tag will consist of all the _\bf_\bo_\br_\bm_\ba_\bt
2125        strings joined together, with the value of $spam_separator separating them.
2126
2127        For example, suppose I use DCC, SpamAssassin, and PureMessage. I might define
2128        these spam settings:
2129
2130             spam "X-DCC-.*-Metrics:.*(....)=many"         "90+/DCC-%1"
2131             spam "X-Spam-Status: Yes"                     "90+/SA"
2132             spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM"
2133             set spam_separator=", "
2134
2135        If I then received a message that DCC registered with ``many'' hits under the
2136        ``Fuz2'' checksum, and that PureMessage registered with a 97% probability of
2137        being spam, that message's spam tag would read 90+/DCC-Fuz2, 97/PM. (The four
2138        characters before ``=many'' in a DCC report indicate the checksum used -- in
2139        this case, ``Fuz2''.)
2140
2141        If the $spam_separator variable is unset, then each spam pattern match super-
2142        sedes the previous one. Instead of getting joined _\bf_\bo_\br_\bm_\ba_\bt strings, you'll get
2143        only the last one to match.
2144
2145        The spam tag is what will be displayed in the index when you use %H in the
2146        $index_format variable. It's also the string that the ~H pattern-matching
2147        expression matches against for _\bs_\be_\ba_\br_\bc_\bh and _\bl_\bi_\bm_\bi_\bt functions. And it's what sort-
2148        ing by spam attribute will use as a sort key.
2149
2150        That's a pretty complicated example, and most people's actual environments will
2151        have only one spam filter. The simpler your configuration, the more effective
2152        mutt can be, especially when it comes to sorting.
2153
2154        Generally, when you sort by spam tag, mutt will sort _\bl_\be_\bx_\bi_\bc_\ba_\bl_\bl_\by -- that is, by
2155        ordering strings alphnumerically. However, if a spam tag begins with a number,
2156        mutt will sort numerically first, and lexically only when two numbers are equal
2157        in value. (This is like UNIX's sort -n.) A message with no spam attributes at
2158        all -- that is, one that didn't match _\ba_\bn_\by of your spam patterns -- is sorted at
2159        lowest priority. Numbers are sorted next, beginning with 0 and ranging upward.
2160        Finally, non-numeric strings are sorted, with ``a'' taking lower priority than
2161        ``z''. Clearly, in general, sorting by spam tags is most effective when you can
2162        coerce your filter to give you a raw number. But in case you can't, mutt can
2163        still do something useful.
2164
2165        The nospam command can be used to write exceptions to spam patterns. If a
2166        header pattern matches something in a spam command, but you nonetheless do not
2167        want it to receive a spam tag, you can list a more precise pattern under a
2168        nospam command.
2169
2170        If the _\bp_\ba_\bt_\bt_\be_\br_\bn given to nospam is exactly the same as the _\bp_\ba_\bt_\bt_\be_\br_\bn on an exist-
2171        ing spam list entry, the effect will be to remove the entry from the spam list,
2172        instead of adding an exception.  Likewise, if the _\bp_\ba_\bt_\bt_\be_\br_\bn for a spam command
2173        matches an entry on the nospam list, that nospam entry will be removed. If the
2174        _\bp_\ba_\bt_\bt_\be_\br_\bn for nospam is ``*'', _\ba_\bl_\bl _\be_\bn_\bt_\br_\bi_\be_\bs _\bo_\bn _\bb_\bo_\bt_\bh _\bl_\bi_\bs_\bt_\bs will be removed. This
2175
2176        The Mutt Next Generation E-Mail Client                                       44
2177
2178        might be the default action if you use spam and nospam in conjunction with a
2179        folder-hook.
2180
2181        You can have as many spam or nospam commands as you like.  You can even do your
2182        own primitive spam detection within mutt -- for example, if you consider all
2183        mail from MAILER-DAEMON to be spam, you can use a spam command like this:
2184
2185             spam "^From: .*MAILER-DAEMON"       "999"
2186
2187        _\b3_\b._\b2_\b8  _\bS_\be_\bt_\bt_\bi_\bn_\bg _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2188
2189        Usage: set [no|inv]_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be[=_\bv_\ba_\bl_\bu_\be] [ _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2190
2191        Usage: toggle _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2192
2193        Usage: unset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2194
2195        Usage: reset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2196
2197        This command is used to set (and unset) _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs (section 7.4  ,
2198        page 87).  There are four basic types of variables: boolean, number, string and
2199        quadoption.  _\bb_\bo_\bo_\bl_\be_\ba_\bn variables can be _\bs_\be_\bt (true) or _\bu_\bn_\bs_\be_\bt (false).  _\bn_\bu_\bm_\bb_\be_\br
2200        variables can be assigned a positive integer value.
2201
2202        _\bs_\bt_\br_\bi_\bn_\bg variables consist of any number of printable characters.  _\bs_\bt_\br_\bi_\bn_\bg_\bs must
2203        be enclosed in quotes if they contain spaces or tabs.  You may also use the
2204        ``C'' escape sequences \\b\n\bn and \\b\t\bt for newline and tab, respectively.
2205
2206        _\bq_\bu_\ba_\bd_\bo_\bp_\bt_\bi_\bo_\bn variables are used to control whether or not to be prompted for cer-
2207        tain actions, or to specify a default action.  A value of _\by_\be_\bs will cause the
2208        action to be carried out automatically as if you had answered yes to the ques-
2209        tion.  Similarly, a value of _\bn_\bo will cause the the action to be carried out as
2210        if you had answered ``no.''  A value of _\ba_\bs_\bk_\b-_\by_\be_\bs will cause a prompt with a
2211        default answer of ``yes'' and _\ba_\bs_\bk_\b-_\bn_\bo will provide a default answer of ``no.''
2212
2213        Prefixing a variable with ``no'' will unset it.  Example: set noaskbcc.
2214
2215        For _\bb_\bo_\bo_\bl_\be_\ba_\bn variables, you may optionally prefix the variable name with inv to
2216        toggle the value (on or off).  This is useful when writing macros.  Example:
2217        set invsmart_wrap.
2218
2219        The toggle command automatically prepends the inv prefix to all specified vari-
2220        ables.
2221
2222        The unset command automatically prepends the no prefix to all specified vari-
2223        ables.
2224
2225        Using the enter-command function in the _\bi_\bn_\bd_\be_\bx menu, you can query the value of
2226        a variable by prefixing the name of the variable with a question mark:
2227
2228        The Mutt Next Generation E-Mail Client                                       45
2229
2230             set ?allow_8bit
2231
2232        The question mark is actually only required for boolean and quadoption vari-
2233        ables.
2234
2235        The reset command resets all given variables to the compile time defaults
2236        (hopefully mentioned in this manual). If you use the command set and prefix the
2237        variable with ``&'' this has the same behavior as the reset command.
2238
2239        With the reset command there exists the special variable ``all'', which allows
2240        you to reset all variables to their system defaults.
2241
2242        _\b3_\b._\b2_\b9  _\bR_\be_\ba_\bd_\bi_\bn_\bg _\bi_\bn_\bi_\bt_\bi_\ba_\bl_\bi_\bz_\ba_\bt_\bi_\bo_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd_\bs _\bf_\br_\bo_\bm _\ba_\bn_\bo_\bt_\bh_\be_\br _\bf_\bi_\bl_\be
2243
2244        Usage: source _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
2245
2246        This command allows the inclusion of initialization commands from other files.
2247        For example, I place all of my aliases in ~/.mail_aliases so that I can make my
2248        ~/.muttrc readable and keep my aliases private.
2249
2250        If the filename begins with a tilde (``~''), it will be expanded to the path of
2251        your home directory.
2252
2253        If the filename ends with a vertical bar (|), then _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be is considered to be
2254        an executable program from which to read input (eg.  source ~/bin/myscript|).
2255
2256        _\b3_\b._\b3_\b0  _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
2257
2258        Usage: unhook [ * | _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be ]
2259
2260        This command permits you to flush hooks you have previously defined.  You can
2261        either remove all hooks by giving the ``*'' character as an argument, or you
2262        can remove all hooks of a specific type by saying something like unhook send-
2263        hook.
2264
2265        _\b3_\b._\b3_\b1  _\bS_\bh_\ba_\br_\bi_\bn_\bg _\bS_\be_\bt_\bu_\bp_\bs
2266
2267        _\b3_\b._\b3_\b1_\b._\b1  _\bC_\bh_\ba_\br_\ba_\bc_\bt_\be_\br _\bS_\be_\bt_\bs
2268
2269        As users may run mutt-ng on different systems, the configuration must be main-
2270        tained because it's likely that people want to use the setup everywhere they
2271        use mutt-ng. And mutt-ng tries to help where it can.
2272
2273        To not produce conflicts with different character sets, mutt-ng allows users to
2274        specify in which character set their configuration files are encoded. Please
2275        note that while reading the configuration files, this is only respected after
2276        the corresponding declaration appears. It's advised to put the following at the
2277
2278        The Mutt Next Generation E-Mail Client                                       46
2279
2280        very beginning of a users muttngrc:
2281
2282             set config_charset = "..."
2283
2284        and replacing the dots with the actual character set. To avoid problems while
2285        maintaining the setup, vim user's may want to use modelines as show in:
2286
2287             # vim:fileencoding=...:
2288
2289        while, again, replacing the dots with the appropriate name. This tells vim as
2290        which character set to read and save the file.
2291
2292        _\b3_\b._\b3_\b1_\b._\b2  _\bM_\bo_\bd_\bu_\bl_\ba_\br_\bi_\bz_\ba_\bt_\bi_\bo_\bn
2293
2294        ``Modularization'' means to divide the setup into several files while sorting
2295        the options or commands by topic. Especially for longer setups (e.g. with many
2296        hooks), this helps maintaining it and solving trouble.
2297
2298        When using separation, setups may be, as a whole or in fractions, shared over
2299        different systems.
2300
2301        _\b3_\b._\b3_\b1_\b._\b3  _\bC_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bp_\ba_\br_\bt_\bs
2302
2303        When using a configuration on different systems, the user may not always have
2304        influence on how mutt-ng is installed and which features it includes.
2305
2306        To solve this, mutt-ng contain a feature based on the ``ifdef'' patch written
2307        for mutt. Its basic syntax is:
2308
2309             ifdef <item> <command>
2310             ifndef <item> <command>
2311
2312        ...whereby <item> can be one of:
2313
2314           +\bo a function name
2315
2316           +\bo a variable name
2317
2318           +\bo a menu name
2319
2320           +\bo a feature name
2321
2322        All available functions, variables and menus are documented elsewhere in this
2323        manual but ``features'' is specific to these two commands. To test for one,
2324
2325        The Mutt Next Generation E-Mail Client                                       47
2326
2327        prefix one of the following keywords with feature_:
2328
2329             ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl,
2330             gnutls, sasl, sasl2, libesmtp, compressed, color, classic_pgp,
2331             classic_smime, gpgme, header_cache
2332
2333        As an example, one can use the following in ~/.muttngrc:
2334
2335             ifdef feature_imap 'source ~/.mutt-ng/setup-imap'
2336             ifdef feature_pop  'source ~/.mutt-ng/setup-pop'
2337             ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp'
2338
2339        ...to only source ~/.mutt-ng/setup-imap if IMAP support is built in, only
2340        source ~/.mutt-ng/setup-pop if POP support is built in and only source ~/.mutt-
2341        ng/setup-nntp if NNTP support is built in.
2342
2343        An example for testing for variable names can be used if users use different
2344        revisions of mutt-ng whereby the older one may not have a certain variable. To
2345        test for the availability of _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.105  , page 113),
2346        use:
2347
2348             ifdef imap_mail_check 'set imap_mail_check = 300'
2349
2350        Provided for completeness is the test for menu names. To set _\b$_\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs
2351        (section 7.4.176  , page 132) only if the pager menu is available, use:
2352
2353             ifdef pager 'set pager_index_lines = 10'
2354
2355        For completeness, too, the opposite of ifdef is provided: ifndef which only
2356        executes the command if the test fails. For example, the following two examples
2357        are equivalent:
2358
2359             ifdef feature_ncurses 'source ~/.mutt-ng/setup-ncurses'
2360             ifndef feature_ncurses 'source ~/.mutt-ng/setup-slang'
2361
2362        ...and...
2363
2364             ifdef feature_slang 'source ~/.mutt-ng/setup-slang'
2365             ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
2366
2367        The Mutt Next Generation E-Mail Client                                       48
2368
2369        _\b3_\b._\b3_\b2  _\bO_\bb_\bs_\bo_\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2370
2371        In the process of ensuring and creating more consistency, many variables have
2372        been renamed and some of the old names were already removed. Please see _\bO_\bb_\bs_\bo_\b-
2373        _\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs (section 7.4  , page 87) for a complete list.
2374
2375        _\b4_\b.  _\bA_\bd_\bv_\ba_\bn_\bc_\be_\bd _\bU_\bs_\ba_\bg_\be
2376
2377        _\b4_\b._\b1  _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs
2378
2379        All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
2380        tion 7.2  , page 83) must be specified using regular expressions (regexp) in
2381        the ``POSIX extended'' syntax (which is more or less the syntax used by egrep
2382        and GNU awk).  For your convenience, we have included below a brief description
2383        of this syntax.
2384
2385        The search is case sensitive if the pattern contains at least one upper case
2386        letter, and case insensitive otherwise. Note that ``\'' must be quoted if used
2387        for a regular expression in an initialization command: ``\\''.
2388
2389        A regular expression is a pattern that describes a set of strings.  Regular
2390        expressions are constructed analogously to arithmetic expressions, by using
2391        various operators to combine smaller expressions.
2392
2393        Note that the regular expression can be enclosed/delimited by either ' or '
2394        which is useful if the regular expression includes a white-space character.
2395        See _\bS_\by_\bn_\bt_\ba_\bx _\bo_\bf _\bI_\bn_\bi_\bt_\bi_\ba_\bl_\bi_\bz_\ba_\bt_\bi_\bo_\bn _\bF_\bi_\bl_\be_\bs (section 3.2  , page 21) for more informa-
2396        tion on ' and ' delimiter processing.  To match a literal ' or ' you must pref-
2397        ace it with \ (backslash).
2398
2399        The fundamental building blocks are the regular expressions that match a single
2400        character.  Most characters, including all letters and digits, are regular
2401        expressions that match themselves.  Any metacharacter with special meaning may
2402        be quoted by preceding it with a backslash.
2403
2404        The period ``.'' matches any single character.  The caret ``^'' and the dollar
2405        sign ``$'' are metacharacters that respectively match the empty string at the
2406        beginning and end of a line.
2407
2408        A list of characters enclosed by ``['' and ``]'' matches any single character
2409        in that list; if the first character of the list is a caret ``^'' then it
2410        matches any character n\bno\bot\bt in the list.  For example, the regular expression
2411        [\b[0\b01\b12\b23\b34\b45\b56\b67\b78\b89\b9]\b] matches any single digit.  A range of ASCII characters may be
2412        specified by giving the first and last characters, separated by a hyphen ``-''.
2413        Most metacharacters lose their special meaning inside lists.  To include a lit-
2414        eral ``]'' place it first in the list.  Similarly, to include a literal ``^''
2415        place it anywhere but first.  Finally, to include a literal hyphen ``-'' place
2416        it last.
2417
2418        The Mutt Next Generation E-Mail Client                                       49
2419
2420        Certain named classes of characters are predefined.  Character classes consist
2421        of ``[:'', a keyword denoting the class, and ``:]''.  The following classes are
2422        defined by the POSIX standard:
2423
2424              [:alnum:]
2425                    Alphanumeric characters.
2426
2427              [:alpha:]
2428                    Alphabetic characters.
2429
2430              [:blank:]
2431                    Space or tab characters.
2432
2433              [:cntrl:]
2434                    Control characters.
2435
2436              [:digit:]
2437                    Numeric characters.
2438
2439              [:graph:]
2440                    Characters that are both printable and visible.  (A space is print-
2441                    able, but not visible, while an ``a'' is both.)
2442
2443              [:lower:]
2444                    Lower-case alphabetic characters.
2445
2446              [:print:]
2447                    Printable characters (characters that are not control characters.)
2448
2449              [:punct:]
2450                    Punctuation characters (characters that are not letter, digits,
2451                    control characters, or space characters).
2452
2453              [:space:]
2454                    Space characters (such as space, tab and formfeed, to name a few).
2455
2456              [:upper:]
2457                    Upper-case alphabetic characters.
2458
2459              [:xdigit:]
2460                    Characters that are hexadecimal digits.
2461
2462        A character class is only valid in a regular expression inside the brackets of
2463        a character list.  Note that the brackets in these class names are part of the
2464        symbolic names, and must be included in addition to the brackets delimiting the
2465        bracket list.  For example, [\b[[\b[:\b:d\bdi\big\bgi\bit\bt:\b:]\b]]\b] is equivalent to [\b[0\b0-\b-9\b9]\b].
2466
2467        Two additional special sequences can appear in character lists.  These apply to
2468        non-ASCII character sets, which can have single symbols (called collating ele-
2469        ments) that are represented with more than one character, as well as several
2470        characters that are equivalent for collating or sorting purposes:
2471
2472              Collating Symbols
2473                    A collating symbol is a multi-character collating element enclosed
2474
2475        The Mutt Next Generation E-Mail Client                                       50
2476
2477                    in ``[.'' and ``.]''.  For example, if ``ch'' is a collating ele-
2478                    ment, then [\b[[\b[.\b.c\bch\bh.\b.]\b]]\b] is a regexp that matches this collating ele-
2479                    ment, while [\b[c\bch\bh]\b] is a regexp that matches either ``c'' or ``h''.
2480
2481              Equivalence Classes
2482                    An equivalence class is a locale-specific name for a list of char-
2483                    acters that are equivalent. The name is enclosed in ``[='' and
2484                    ``=]''.  For example, the name ``e'' might be used to represent all
2485                    of ``'' ``'' and ``e''.  In this case, [\b[[\b[=\b=e\be=\b=]\b]]\b] is a regexp that
2486                    matches any of ``'', ``'' and ``e''.
2487
2488        A regular expression matching a single character may be followed by one of sev-
2489        eral repetition operators:
2490
2491              ?
2492                    The preceding item is optional and matched at most once.
2493
2494              *
2495                    The preceding item will be matched zero or more times.
2496
2497              +
2498                    The preceding item will be matched one or more times.
2499
2500              {n}
2501                    The preceding item is matched exactly _\bn times.
2502
2503              {n,}
2504                    The preceding item is matched _\bn or more times.
2505
2506              {,m}
2507                    The preceding item is matched at most _\bm times.
2508
2509              {n,m}
2510                    The preceding item is matched at least _\bn times, but no more than _\bm
2511                    times.
2512
2513        Two regular expressions may be concatenated; the resulting regular expression
2514        matches any string formed by concatenating two substrings that respectively
2515        match the concatenated subexpressions.
2516
2517        Two regular expressions may be joined by the infix operator ``|''; the result-
2518        ing regular expression matches any string matching either subexpression.
2519
2520        Repetition takes precedence over concatenation, which in turn takes precedence
2521        over alternation.  A whole subexpression may be enclosed in parentheses to
2522        override these precedence rules.
2523
2524        N\bNo\bot\bte\be:\b: If you compile Mutt-ng with the GNU _\br_\bx package, the following operators
2525        may also be used in regular expressions:
2526
2527              \\y
2528                    Matches the empty string at either the beginning or the end of a
2529                    word.
2530
2531        The Mutt Next Generation E-Mail Client                                       51
2532
2533              \\B
2534                    Matches the empty string within a word.
2535
2536              \\<
2537                    Matches the empty string at the beginning of a word.
2538
2539              \\>
2540                    Matches the empty string at the end of a word.
2541
2542              \\w
2543                    Matches any word-constituent character (letter, digit, or under-
2544                    score).
2545
2546              \\W
2547                    Matches any character that is not word-constituent.
2548
2549              \\`
2550                    Matches the empty string at the beginning of a buffer (string).
2551
2552              \\'
2553                    Matches the empty string at the end of a buffer.
2554
2555        Please note however that these operators are not defined by POSIX, so they may
2556        or may not be available in stock libraries on various systems.
2557
2558        _\b4_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2559
2560        Mutt-ng's pattern language provides a simple yet effective way to set up rules
2561        to match messages, e.g. for operations like tagging and scoring. A pattern con-
2562        sists of one or more sub-pattern, which can be logically grouped, ORed, and
2563        negated. For a complete listing of these patterns, please refer to table _\bP_\ba_\bt_\b-
2564        _\bt_\be_\br_\bn_\bs (section 7.2  , page 83) in the Reference chapter.
2565
2566        It must be noted that in this table, EXPR, USER, ID and SUBJECT are regular
2567        expressions. For ranges, the forms <[MAX], >>[MIN], [MIN]- and -[MAX] are also
2568        possible.
2569
2570        _\b4_\b._\b2_\b._\b1  _\bC_\bo_\bm_\bp_\bl_\be_\bx _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2571
2572        It is possible to combine several sub-patterns to a more complex pattern. The
2573        most simple possibility is to logically AND several patterns by stringing them
2574        together:
2575
2576             ~s 'SPAM' ~U
2577
2578        The pattern above matches all messages that contain ``SPAM'' in the subject and
2579        are unread.
2580
2581        To logical OR patterns, simply use the | operator. This one especially useful
2582        when using local groups:
2583
2584        The Mutt Next Generation E-Mail Client                                       52
2585
2586             ~f ("nion@muttng\.org"|"ak@muttng\.org"|"pdmef@muttng\.org")
2587             (~b mutt-ng|~s Mutt-ng)
2588             !~x '@synflood\.at'
2589
2590        The first pattern matches all messages that were sent by one of the mutt-ng
2591        maintainers, while the seconds pattern matches all messages that contain
2592        ``mutt-ng'' in the message body or ``Mutt-ng'' in the subject. The third pat-
2593        tern matches all messages that do not contain ``@synflood\.at'' in the Refer-
2594        ences: header, i.e.  messages that are not an (indirect) reply to one of my
2595        messages. A pattern can be logicall negated using the ! operator.
2596
2597        _\b4_\b._\b2_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs _\ba_\bn_\bd _\bD_\ba_\bt_\be_\bs
2598
2599        When using dates in patterns, the dates must be specified in a special format,
2600        i.e.  DD/MM/YYYY. If you don't specify month or year, they default to the cur-
2601        rent month or year. When using date ranges, and you specify only the minimum or
2602        the maximum, the specified date will be excluded, e.g. 01/06/2005- matches
2603        against all messages _\ba_\bf_\bt_\be_\br Juni 1st, 2005.
2604
2605        It is also possible to use so-called ``error margins'' when specifying date
2606        ranges.  You simply specify a date, and then the error margin. This margin
2607        needs to contain the information whether it goes ``forth'' or ``back'' in time,
2608        by using + and -.  Then follows a number and a unit, i.e. y for years, m for
2609        months, w for weeks and d for days. If you use the special * sign, it means
2610        that the error margin goes to both ``directions'' in time.
2611
2612             ~d 01/01/2005+1y
2613             ~d 18/10/2004-2w
2614             ~d 28/12/2004*1d
2615
2616        The first pattern matches all dates between January 1st, 2005 and January 1st
2617        2006.  The second pattern matches all dates between October 18th, 2004 and
2618        October 4th 2004 (2 weeks before 18/10/2004), while the third pattern matches
2619        all dates 1 day around December 28th, 2004 (i.e. Dec 27th, 28th and 29th).
2620
2621        Relative dates are also very important, as they make it possible to specify
2622        date ranges between a fixed number of units and the current date. How this
2623        works can be seen in the following example:
2624
2625             ~d >2w # messages older than two weeks
2626             ~d <3d # messages newer than 3 days
2627             ~d =1m # messages that are exactly one month old
2628
2629        _\b4_\b._\b3  _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs
2630
2631        _\b4_\b._\b3_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
2632
2633        The Mutt Next Generation E-Mail Client                                       53
2634
2635        The so called _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs offer great flexibility when configuring mutt-ng.
2636        In short, they describe what items to print out how in menus and status mes-
2637        sages.
2638
2639        Basically, they work as this: for different menus and bars, there's a variable
2640        specifying the layout. For every item available, there is a so called _\be_\bx_\bp_\ba_\bn_\bd_\bo.
2641
2642        For example, when running mutt-ng on different machines or different versions
2643        for testing purposes, it may be interesting to have the following information
2644        always printed on screen when one is in the index:
2645
2646           +\bo the current hostname
2647
2648           +\bo the current mutt-ng version number
2649
2650        The setting for the status bar of the index is controlled via the _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\b-
2651        _\bm_\ba_\bt (section 7.4.315  , page 164) variable. For the hostname and version
2652        string, there's an expando for $status_format: %h expands to the hostname and
2653        %v to the version string. When just configuring:
2654
2655             set status_format = "%v on %h: ..."
2656
2657        mutt-ng will replace the sequence %v with the version string and %h with the
2658        host's name. When you are, for example, running mutt-ng version 1.5.9i on host
2659        mailhost, you'll see the following when you're in the index:
2660
2661             Mutt-ng 1.5.9i on mailhost: ...
2662
2663        In the index, there're more useful information one could want to see:
2664
2665           +\bo which mailbox is open
2666
2667           +\bo how man new, flagged or postponed messages
2668
2669           +\bo ...
2670
2671        To include the mailbox' name is as easy as:
2672
2673             set status_format = "%v on %h: %B: ...
2674
2675        When the currently opened mailbox is Inbox, this will be expanded to:
2676
2677             Mutt-ng 1.5.9i on mailhost: Inbox: ...
2678
2679        For the number of certain types of messages, one more feature of the format
2680        strings is extremely useful. If there aren't messages of a certain type, it may
2681
2682        The Mutt Next Generation E-Mail Client                                       54
2683
2684        not be desired to print just that there aren't any but instead only print some-
2685        thing if there are any.
2686
2687        _\b4_\b._\b3_\b._\b2  _\bC_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
2688
2689        To only print the number of messages if there are new messages in the current
2690        mailbox, further extend $status_format to:
2691
2692             set status_format = "%v on %h: %B %?n?%n new? ...
2693
2694        This feature is called _\bn_\bo_\bn_\bz_\be_\br_\bo_\b-_\bp_\br_\bi_\bn_\bt_\bi_\bn_\bg and works as this: some expandos may be
2695        optionally printed nonzero, i.e.  a portion of the format string is only evalu-
2696        ated if the value of the expando is different from zero. The basic syntax is:
2697
2698             %?<item>?<string if nonzero>?
2699
2700        which tells mutt-ng to only look at <string if nonzero> if the value of the
2701        %<item%gt; expando is different from zero. In our example, we used n as the
2702        expando to check for and %n new as the optional nonzero string.
2703
2704        But this is not all: this feature only offers one alternative: ``print some-
2705        thing if not zero.'' Mutt-ng does, as you might guess, also provide a logically
2706        complete version: ``if zero, print something and else print something else.''
2707        This is achieved by the following syntax for those expandos which may be
2708        printed nonzero:
2709
2710             %?<item>?<string if nonzero>&<string if zero>?
2711
2712        Using this we can make mutt-ng to do the following:
2713
2714           +\bo  make it print ``_\bn new messages'' whereby _\bn is the count but only if there
2715             new ones
2716
2717           +\bo  and make it print ``no new messages'' if there aren't any
2718
2719        The corresponding configuration is:
2720
2721             set status_format = "%v on %h: %B: %?n?%n new messages&no new messages? ...
2722
2723        This doubles the use of the ``new messages'' string because it'll get always
2724        printed. Thus, it can be shortened to:
2725
2726             set status_format = "%v on %h: %B: %?n?%n&no? new messages ...
2727
2728        The Mutt Next Generation E-Mail Client                                       55
2729
2730        As you might see from this rather simple example, one can create very complex
2731        but fancy status messages. Please see the reference chapter for expandos and
2732        those which may be printed nonzero.
2733
2734        _\b4_\b._\b3_\b._\b3  _\bM_\bo_\bd_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn_\bs _\ba_\bn_\bd _\bP_\ba_\bd_\bd_\bi_\bn_\bg
2735
2736        Besides the information given so far, there're even more features of format
2737        strings:
2738
2739           +\bo When specifying %_<item> instead of just %<item>, mutt-ng will convert all
2740             characters in the expansion of <item> to lowercase.
2741
2742           +\bo When specifying %:<item> instead of just %<item>, mutt-ng will convert all
2743             dots in the expansion of <item> to underscores (_).
2744
2745        Also, there's a feature called _\bP_\ba_\bd_\bd_\bi_\bn_\bg supplied by the following two expandos:
2746        %|X and %>X.
2747
2748              %|X
2749                    When this occurs, mutt-ng will fill the rest of the line with the
2750                    character X. In our example, filling the rest of the line with
2751                    dashes is done by setting:
2752
2753                         set status_format = "%v on %h: %B: %?n?%n&no? new messages %|-"
2754
2755              %>X
2756                    Since the previous expando stops at the end of line, there must be
2757                    a way to fill the gap between two items via the %>X expando: it
2758                    puts as many characters X in between two items so that the rest of
2759                    the line will be right-justified. For example, to not put the ver-
2760                    sion string and hostname of our example on the left but on the
2761                    right and fill the gap with spaces, one might use (note the space
2762                    after %>):
2763
2764                         set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)"
2765
2766        _\b4_\b._\b4  _\bU_\bs_\bi_\bn_\bg _\bT_\ba_\bg_\bs
2767
2768        Sometimes it is desirable to perform an operation on a group of messages all at
2769        once rather than one at a time.  An example might be to save messages to a
2770        mailing list to a separate folder, or to delete all messages with a given sub-
2771        ject.  To tag all messages matching a pattern, use the tag-pattern function,
2772        which is bound to ``shift-T'' by default.  Or you can select individual mes-
2773        sages by hand using the ``tag-message'' function, which is bound to ``t'' by
2774
2775        The Mutt Next Generation E-Mail Client                                       56
2776
2777        default.  See _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 83) for Mutt-ng's pattern matching
2778        syntax.
2779
2780        Once you have tagged the desired messages, you can use the ``tag-prefix'' oper-
2781        ator, which is the ``;'' (semicolon) key by default.  When the ``tag-prefix''
2782        operator is used, the n\bne\bex\bxt\bt operation will be applied to all tagged messages if
2783        that operation can be used in that manner.  If the _\b$_\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg (section 7.4.19  ,
2784        page 93) variable is set, the next operation applies to the tagged messages
2785        automatically, without requiring the ``tag-prefix''.
2786
2787        In _\bm_\ba_\bc_\br_\bo_\bs (section 3.8  , page 29) or _\bp_\bu_\bs_\bh (section 3.24  , page 40) commands,
2788        you can use the ``tag-prefix-cond'' operator.  If there are no tagged messages,
2789        mutt will "eat" the rest of the macro to abort it's execution.  Mutt-ng will
2790        stop "eating" the macro when it encounters the ``end-cond'' operator;  after
2791        this operator the rest of the macro will be executed as normal.
2792
2793        _\b4_\b._\b5  _\bU_\bs_\bi_\bn_\bg _\bH_\bo_\bo_\bk_\bs
2794
2795        A _\bh_\bo_\bo_\bk is a concept borrowed from the EMACS editor which allows you to execute
2796        arbitrary commands before performing some operation.  For example, you may wish
2797        to tailor your configuration based upon which mailbox you are reading, or to
2798        whom you are sending mail.  In the Mutt-ng world, a _\bh_\bo_\bo_\bk consists of a _\br_\be_\bg_\bu_\bl_\ba_\br
2799        _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 48) or _\bp_\ba_\bt_\bt_\be_\br_\bn (section 7.2  , page 83) along
2800        with a configuration option/command.  See
2801
2802           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.7  , page 28)
2803
2804           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 39)
2805
2806           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.22  , page 40)
2807
2808           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 38)
2809
2810           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 36)
2811
2812           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 38)
2813
2814           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 39)
2815
2816        for specific details on each type of _\bh_\bo_\bo_\bk available.
2817
2818        N\bNo\bot\bte\be:\b: if a hook changes configuration settings, these changes remain effective
2819        until the end of the current mutt session. As this is generally not desired, a
2820        default hook needs to be added before all other hooks to restore configuration
2821        defaults. Here is an example with send-hook and the my_hdr directive:
2822
2823             send-hook . 'unmy_hdr From:'
2824             send-hook ~C'^b@b\.b$' my_hdr from: c@c.c
2825
2826        The Mutt Next Generation E-Mail Client                                       57
2827
2828        _\b4_\b._\b5_\b._\b1  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bM_\ba_\bt_\bc_\bh_\bi_\bn_\bg _\bi_\bn _\bH_\bo_\bo_\bk_\bs
2829
2830        Hooks that act upon messages (send-hook, save-hook, fcc-hook, message-hook) are
2831        evaluated in a slightly different manner.  For the other types of hooks, a _\br_\be_\bg_\b-
2832        _\bu_\bl_\ba_\br _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 48) is sufficient.  But in dealing with
2833        messages a finer grain of control is needed for matching since for different
2834        purposes you want to match different criteria.
2835
2836        Mutt-ng allows the use of the _\bs_\be_\ba_\br_\bc_\bh _\bp_\ba_\bt_\bt_\be_\br_\bn (section 7.2  , page 83) language
2837        for matching messages in hook commands.  This works in exactly the same way as
2838        it would when _\bl_\bi_\bm_\bi_\bt_\bi_\bn_\bg or _\bs_\be_\ba_\br_\bc_\bh_\bi_\bn_\bg the mailbox, except that you are restricted
2839        to those operators which match information mutt extracts from the header of the
2840        message (i.e.  from, to, cc, date, subject, etc.).
2841
2842        For example, if you wanted to set your return address based upon sending mail
2843        to a specific address, you could do something like:
2844
2845             send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>'
2846
2847        which would execute the given command when sending mail to _\bm_\be_\b@_\bc_\bs_\b._\bh_\bm_\bc_\b._\be_\bd_\bu.
2848
2849        However, it is not required that you write the pattern to match using the full
2850        searching language.  You can still specify a simple _\br_\be_\bg_\bu_\bl_\ba_\br _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn like the
2851        other hooks, in which case Mutt-ng will translate your pattern into the full
2852        language, using the translation specified by the _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section
2853        7.4.49  , page 100) variable.  The pattern is translated at the time the hook
2854        is declared, so the value of _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section 7.4.49  , page 100) that is
2855        in effect at that time will be used.
2856
2857        _\b4_\b._\b6  _\bU_\bs_\bi_\bn_\bg _\bt_\bh_\be _\bs_\bi_\bd_\be_\bb_\ba_\br
2858
2859        The sidebar, a feature specific to Mutt-ng, allows you to use a mailbox listing
2860        which looks very similar to the ones you probably know from GUI mail clients.
2861        The sidebar lists all specified mailboxes, shows the number in each and high-
2862        lights the ones with new email Use the following configuration commands:
2863
2864             set sidebar_visible="yes"
2865             set sidebar_width=25
2866
2867        If you want to specify the mailboxes you can do so with:
2868
2869             set mbox='=INBOX'
2870             mailboxes INBOX \
2871                       MBOX1 \
2872                       MBOX2 \
2873                       ...
2874
2875        You can also specify the colors for mailboxes with new mails by using:
2876
2877        The Mutt Next Generation E-Mail Client                                       58
2878
2879             color sidebar_new red black
2880             color sidebar white black
2881
2882        The available functions are:
2883
2884             sidebar-scroll-up      Scrolls the mailbox list up 1 page
2885             sidebar-scroll-down    Scrolls the mailbox list down 1 page
2886             sidebar-next           Highlights the next mailbox
2887             sidebar-next-new       Highlights the next mailbox with new mail
2888             sidebar-previous       Highlights the previous mailbox
2889             sidebar-open           Opens the currently highlighted mailbox
2890
2891        Reasonable key bindings look e.g. like this:
2892
2893             bind index \Cp sidebar-prev
2894             bind index \Cn sidebar-next
2895             bind index \Cb sidebar-open
2896             bind pager \Cp sidebar-prev
2897             bind pager \Cn sidebar-next
2898             bind pager \Cb sidebar-open
2899
2900             macro index B ':toggle sidebar_visible^M'
2901             macro pager B ':toggle sidebar_visible^M'
2902
2903        You can then go up and down by pressing Ctrl-P and Ctrl-N, and switch on and
2904        off the sidebar simply by pressing 'B'.
2905
2906        _\b4_\b._\b7  _\bE_\bx_\bt_\be_\br_\bn_\ba_\bl _\bA_\bd_\bd_\br_\be_\bs_\bs _\bQ_\bu_\be_\br_\bi_\be_\bs
2907
2908        Mutt-ng supports connecting to external directory databases such as LDAP,
2909        ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using a
2910        simple interface.  Using the _\b$_\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.228  , page 144) vari-
2911        able, you specify the wrapper command to use.  For example:
2912
2913             set query_command = "mutt_ldap_query.pl '%s'"
2914
2915        The wrapper script should accept the query on the command-line.  It should
2916        return a one line message, then each matching response on a single line, each
2917        line containing a tab separated address then name then some other optional
2918        information.  On error, or if there are no matching addresses, return a non-
2919        zero exit code and a one line error message.
2920
2921        An example multiple response output:
2922
2923             Searching database ... 20 entries ... 3 matching:
2924             me@cs.hmc.edu           Michael Elkins  mutt dude
2925             blong@fiction.net       Brandon Long    mutt and more
2926
2927        The Mutt Next Generation E-Mail Client                                       59
2928
2929             roessler@guug.de        Thomas Roessler mutt pgp
2930
2931        There are two mechanisms for accessing the query function of mutt.  One is to
2932        do a query from the index menu using the query function (default: Q).  This
2933        will prompt for a query, then bring up the query menu which will list the
2934        matching responses.  From the query menu, you can select addresses to create
2935        aliases, or to mail.  You can tag multiple addresses to mail, start a new
2936        query, or have a new query appended to the current responses.
2937
2938        The other mechanism for accessing the query function is for address completion,
2939        similar to the alias completion.  In any prompt for address entry, you can use
2940        the complete-query function (default: ^T) to run a query based on the current
2941        address you have typed.  Like aliases, mutt will look for what you have typed
2942        back to the last space or comma.  If there is a single response for that query,
2943        mutt will expand the address in place.  If there are multiple responses, mutt
2944        will activate the query menu.  At the query menu, you can select one or more
2945        addresses to be added to the prompt.
2946
2947        _\b4_\b._\b8  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bF_\bo_\br_\bm_\ba_\bt_\bs
2948
2949        Mutt-ng supports reading and writing of four different mailbox formats: mbox,
2950        MMDF, MH and Maildir.  The mailbox type is autodetected, so there is no need to
2951        use a flag for different mailbox types.  When creating new mailboxes, Mutt-ng
2952        uses the default specified with the _\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.132  , page 121)
2953        variable.
2954
2955        m\bmb\bbo\box\bx.  This is the most widely used mailbox format for UNIX.  All messages are
2956        stored in a single file.  Each message has a line of the form:
2957
2958             From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
2959
2960        to denote the start of a new message (this is often referred to as the
2961        ``From_'' line).
2962
2963        M\bMM\bMD\bDF\bF.  This is a variant of the _\bm_\bb_\bo_\bx format.  Each message is surrounded by
2964        lines containing ``^A^A^A^A'' (four control-A's).
2965
2966        M\bMH\bH. A radical departure from _\bm_\bb_\bo_\bx and _\bM_\bM_\bD_\bF, a mailbox consists of a directory
2967        and each message is stored in a separate file.  The filename indicates the mes-
2968        sage number (however, this is may not correspond to the message number Mutt-ng
2969        displays). Deleted messages are renamed with a comma (,) prepended to the file-
2970        name. N\bNo\bot\bte\be:\b: Mutt detects this type of mailbox by looking for either
2971        .mh_sequences or .xmhcache (needed to distinguish normal directories from MH
2972        mailboxes).
2973
2974        M\bMa\bai\bil\bld\bdi\bir\br.  The newest of the mailbox formats, used by the Qmail MTA (a replace-
2975        ment for sendmail).  Similar to _\bM_\bH, except that it adds three subdirectories of
2976        the mailbox: _\bt_\bm_\bp, _\bn_\be_\bw and _\bc_\bu_\br.  Filenames for the messages are chosen in such a
2977        way they are unique, even when two programs are writing the mailbox over NFS,
2978
2979        The Mutt Next Generation E-Mail Client                                       60
2980
2981        which means that no file locking is needed.
2982
2983        _\b4_\b._\b9  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bS_\bh_\bo_\br_\bt_\bc_\bu_\bt_\bs
2984
2985        There are a number of built in shortcuts which refer to specific mailboxes.
2986        These shortcuts can be used anywhere you are prompted for a file or mailbox
2987        path.
2988
2989           +\bo ! -- refers to your _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.304  , page 162) (incoming)
2990             mailbox
2991
2992           +\bo > -- refers to your _\b$_\bm_\bb_\bo_\bx (section 7.4.131  , page 121) file
2993
2994           +\bo < -- refers to your _\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.237  , page 146) file
2995
2996           +\bo ^ -- refers to the current mailbox
2997
2998           +\bo - or !! -- refers to the file you've last visited
2999
3000           +\bo ~ -- refers to your home directory
3001
3002           +\bo = or + -- refers to your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) directory
3003
3004           +\bo @_\ba_\bl_\bi_\ba_\bs -- refers to the _\bd_\be_\bf_\ba_\bu_\bl_\bt _\bs_\ba_\bv_\be _\bf_\bo_\bl_\bd_\be_\br (section 3.18  , page 38) as
3005             determined by the address of the alias
3006
3007        _\b4_\b._\b1_\b0  _\bH_\ba_\bn_\bd_\bl_\bi_\bn_\bg _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
3008
3009        Mutt-ng has a few configuration options that make dealing with large amounts of
3010        mail easier.  The first thing you must do is to let Mutt know what addresses
3011        you consider to be mailing lists (technically this does not have to be a mail-
3012        ing list, but that is what it is most often used for), and what lists you are
3013        subscribed to.  This is accomplished through the use of the _\bl_\bi_\bs_\bt_\bs _\ba_\bn_\bd _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be
3014        (section 3.13  , page 35) commands in your muttrc.
3015
3016        Now that Mutt-ng knows what your mailing lists are, it can do several things,
3017        the first of which is the ability to show the name of a list through which you
3018        received a message (i.e., of a subscribed list) in the _\bi_\bn_\bd_\be_\bx menu display.
3019        This is useful to distinguish between personal and list mail in the same mail-
3020        box.  In the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115) variable, the escape
3021        ``%L'' will return the string ``To <list>'' when ``list'' appears in the ``To''
3022        field, and ``Cc <list>'' when it appears in the ``Cc'' field (otherwise it
3023        returns the name of the author).
3024
3025        Often times the ``To'' and ``Cc'' fields in mailing list messages tend to get
3026        quite large. Most people do not bother to remove the author of the message they
3027        are reply to from the list, resulting in two or more copies being sent to that
3028        person.  The ``list-reply'' function, which by default is bound to ``L'' in the
3029        _\bi_\bn_\bd_\be_\bx menu and _\bp_\ba_\bg_\be_\br, helps reduce the clutter by only replying to the known
3030        mailing list addresses instead of all recipients (except as specified by Mail-
3031
3032        The Mutt Next Generation E-Mail Client                                       61
3033
3034        Followup-To, see below).
3035
3036        Mutt-ng also supports the Mail-Followup-To header.  When you send a message to
3037        a list of recipients which includes one or several subscribed mailing lists,
3038        and if the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.72  , page 105) option is set, mutt will
3039        generate a Mail-Followup-To header which contains all the recipients to whom
3040        you send this message, but not your address. This indicates that group-replies
3041        or list-replies (also known as ``followups'') to this message should only be
3042        sent to the original recipients of the message, and not separately to you -
3043        you'll receive your copy through one of the mailing lists you are subscribed
3044        to.
3045
3046        Conversely, when group-replying or list-replying to a message which has a Mail-
3047        Followup-To header, mutt will respect this header if the _\b$_\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
3048        (section 7.4.94  , page 110) configuration variable is set.  Using list-reply
3049        will in this case also make sure that the reply goes to the mailing list, even
3050        if it's not specified in the list of recipients in the Mail-Followup-To.
3051
3052        Note that, when header editing is enabled, you can create a Mail-Followup-To
3053        header manually.  Mutt-ng will only auto-generate this header if it doesn't
3054        exist when you send the message.
3055
3056        The other method some mailing list admins use is to generate a ``Reply-To''
3057        field which points back to the mailing list address rather than the author of
3058        the message.  This can create problems when trying to reply directly to the
3059        author in private, since most mail clients will automatically reply to the
3060        address given in the ``Reply-To'' field.  Mutt-ng uses the _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section
3061        7.4.240  , page 147) variable to help decide which address to use.  If set to
3062        _\ba_\bs_\bk_\b-_\by_\be_\bs or _\ba_\bs_\bk_\b-_\bn_\bo, you will be prompted as to whether or not you would like to
3063        use the address given in the ``Reply-To'' field, or reply directly to the
3064        address given in the ``From'' field.  When set to _\by_\be_\bs, the ``Reply-To'' field
3065        will be used when present.
3066
3067        The ``X-Label:'' header field can be used to further identify mailing lists or
3068        list subject matter (or just to annotate messages individually).  The
3069        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115) variable's ``%y'' and ``%Y''
3070        escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's
3071        pattern-matcher can match regular expressions to ``X-Label:'' fields with the
3072        ``~y'' selector.  ``X-Label:'' is not a standard message header field, but it
3073        can easily be inserted by procmail and other mail filtering agents.
3074
3075        Lastly, Mutt-ng has the ability to _\bs_\bo_\br_\bt (section 7.4.298  , page 160) the mail-
3076        box into _\bt_\bh_\br_\be_\ba_\bd_\bs (section 2.5.3  , page 11).  A thread is a group of messages
3077        which all relate to the same subject.  This is usually organized into a tree-
3078        like structure where a message and all of its replies are represented graphi-
3079        cally.  If you've ever used a threaded news client, this is the same concept.
3080        It makes dealing with large volume mailing lists easier because you can easily
3081        delete uninteresting threads and quickly find topics of value.
3082
3083        _\b4_\b._\b1_\b1  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3084
3085        Mutt-ng has the ability to dynamically restructure threads that are broken
3086
3087        The Mutt Next Generation E-Mail Client                                       62
3088
3089        either by misconfigured software or bad behavior from some correspondents. This
3090        allows to clean your mailboxes formats) from these annoyances which make it
3091        hard to follow a discussion.
3092
3093        _\b4_\b._\b1_\b1_\b._\b1  _\bL_\bi_\bn_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3094
3095        Some mailers tend to "forget" to correctly set the "In-Reply-To:" and "Refer-
3096        ences:" headers when replying to a message. This results in broken discussions
3097        because Mutt-ng has not enough information to guess the correct threading.  You
3098        can fix this by tagging the reply, then moving to the parent message and using
3099        the ``link-threads'' function (bound to & by default). The reply will then be
3100        connected to this "parent" message.
3101
3102        You can also connect multiple children at once, tagging them and using the tag-
3103        prefix command (';') or the auto_tag option.
3104
3105        _\b4_\b._\b1_\b1_\b._\b2  _\bB_\br_\be_\ba_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3106
3107        On mailing lists, some people are in the bad habit of starting a new discussion
3108        by hitting "reply" to any message from the list and changing the subject to a
3109        totally unrelated one.  You can fix such threads by using the ``break-thread''
3110        function (bound by default to #), which will turn the subthread starting from
3111        the current message into a whole different thread.
3112
3113        _\b4_\b._\b1_\b2  _\bD_\be_\bl_\bi_\bv_\be_\br_\by _\bS_\bt_\ba_\bt_\bu_\bs _\bN_\bo_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn _\b(_\bD_\bS_\bN_\b) _\bS_\bu_\bp_\bp_\bo_\br_\bt
3114
3115        RFC1894 defines a set of MIME content types for relaying information about the
3116        status of electronic mail messages.  These can be thought of as ``return
3117        receipts.''
3118
3119        Users can make use of it in one of the following two ways:
3120
3121           +\bo Berkeley sendmail 8.8.x currently has some command line options in which
3122             the mail client can make requests as to what type of status messages
3123             should be returned.
3124
3125           +\bo The SMTP support via libESMTP supports it, too.
3126
3127        To support this, there are two variables:
3128
3129           +\bo _\b$_\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by (section 7.4.56  , page 101) is used to request receipts for
3130             different results (such as failed message, message delivered, etc.).
3131
3132           +\bo _\b$_\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn (section 7.4.57  , page 102) requests how much of your message
3133             should be returned with the receipt (headers or full message).
3134
3135        Please see the reference chapter for possible values.
3136
3137        _\b4_\b._\b1_\b3  _\bP_\bO_\bP_\b3 _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
3138
3139        The Mutt Next Generation E-Mail Client                                       63
3140
3141        If Mutt-ng was compiled with POP3 support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3142        the _\b-_\b-_\be_\bn_\ba_\bb_\bl_\be_\b-_\bp_\bo_\bp flag), it has the ability to work with mailboxes located on a
3143        remote POP3 server and fetch mail for local browsing.
3144
3145        You can access the remote POP3 mailbox by selecting the folder
3146        pop://popserver/.
3147
3148        You can select an alternative port by specifying it with the server, i.e.:
3149        pop://popserver:port/.
3150
3151        You can also specify different username for each folder, i.e.: pop://user-
3152        name@popserver[:port]/.
3153
3154        Polling for new mail is more expensive over POP3 than locally. For this reason
3155        the frequency at which Mutt-ng will check for mail remotely can be controlled
3156        by the _\b$_\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.215  , page 141) variable, which defaults
3157        to every 60 seconds.
3158
3159        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3160        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to POP3 servers can be encrypted. This natu-
3161        rally requires that the server supports SSL encrypted connections. To access a
3162        folder with POP3/SSL, you should use pops: prefix, ie: pops://[user-
3163        name@]popserver[:port]/.
3164
3165        Another way to access your POP3 mail is the _\bf_\be_\bt_\bc_\bh_\b-_\bm_\ba_\bi_\bl function (default: G).
3166        It allows to connect to _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.213  , page 141), fetch all your
3167        new mail and place it in the local _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.304  , page 162).
3168        After this point, Mutt-ng runs exactly as if the mail had always been local.
3169
3170        N\bNo\bot\bte\be:\b: If you only need to fetch all messages to local mailbox you should con-
3171        sider using a specialized program, such as fetchmail
3172
3173        _\b4_\b._\b1_\b4  _\bI_\bM_\bA_\bP _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
3174
3175        If Mutt-ng was compiled with IMAP support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3176        the _\b-_\b-_\be_\bn_\ba_\bb_\bl_\be_\b-_\bi_\bm_\ba_\bp flag), it has the ability to work with folders located on a
3177        remote IMAP server.
3178
3179        You can access the remote inbox by selecting the folder
3180        imap://imapserver/INBOX, where imapserver is the name of the IMAP server and
3181        INBOX is the special name for your spool mailbox on the IMAP server. If you
3182        want to access another mail folder at the IMAP server, you should use
3183        imap://imapserver/path/to/folder where path/to/folder is the path of the folder
3184        you want to access.
3185
3186        You can select an alternative port by specifying it with the server, i.e.:
3187        imap://imapserver:port/INBOX.
3188
3189        You can also specify different username for each folder, i.e.: imap://user-
3190        name@imapserver[:port]/INBOX.
3191
3192        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3193
3194        The Mutt Next Generation E-Mail Client                                       64
3195
3196        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to IMAP servers can be encrypted. This natu-
3197        rally requires that the server supports SSL encrypted connections. To access a
3198        folder with IMAP/SSL, you should use imaps://[user-
3199        name@]imapserver[:port]/path/to/folder as your folder path.
3200
3201        Pine-compatible notation is also supported, i.e.  {[user-
3202        name@]imapserver[:port][/ssl]}path/to/folder
3203
3204        Note that not all servers use / as the hierarchy separator.  Mutt-ng should
3205        correctly notice which separator is being used by the server and convert paths
3206        accordingly.
3207
3208        When browsing folders on an IMAP server, you can toggle whether to look at only
3209        the folders you are subscribed to, or all folders with the _\bt_\bo_\bg_\bg_\bl_\be_\b-_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
3210        command.  See also the _\b$_\bi_\bm_\ba_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd (section 7.4.103  , page 113)
3211        variable.
3212
3213        Polling for new mail on an IMAP server can cause noticeable delays. So, you'll
3214        want to carefully tune the _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.105  , page 113) and
3215        _\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.328  , page 169) variables.
3216
3217        Note that if you are using mbox as the mail store on UW servers prior to
3218        v12.250, the server has been reported to disconnect a client if another client
3219        selects the same folder.
3220
3221        _\b4_\b._\b1_\b4_\b._\b1  _\bT_\bh_\be _\bF_\bo_\bl_\bd_\be_\br _\bB_\br_\bo_\bw_\bs_\be_\br
3222
3223        As of version 1.2, mutt supports browsing mailboxes on an IMAP server. This is
3224        mostly the same as the local file browser, with the following differences:
3225
3226           +\bo Instead of file permissions, mutt displays the string "IMAP", possibly
3227             followed by the symbol "+", indicating that the entry contains both mes-
3228             sages and subfolders. On Cyrus-like servers folders will often contain
3229             both messages and subfolders.
3230
3231           +\bo For the case where an entry can contain both messages and subfolders, the
3232             selection key (bound to enter by default) will choose to descend into the
3233             subfolder view. If you wish to view the messages in that folder, you must
3234             use view-file instead (bound to space by default).
3235
3236           +\bo You can create, delete and rename mailboxes with the create-mailbox,
3237             delete-mailbox, and rename-mailbox commands (default bindings: C, d and r,
3238             respectively). You may also subscribe and unsubscribe to mailboxes (nor-
3239             mally these are bound to s and u, respectively).
3240
3241        _\b4_\b._\b1_\b4_\b._\b2  _\bA_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bi_\bo_\bn
3242
3243        Mutt-ng supports four authentication methods with IMAP servers: SASL, GSSAPI,
3244        CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add NTLM authentica-
3245        tion for you poor exchange users out there, but it has yet to be integrated
3246        into the main tree). There is also support for the pseudo-protocol ANONYMOUS,
3247        which allows you to log in to a public IMAP server without having an account.
3248        To use ANONYMOUS, simply make your username blank or "anonymous".
3249
3250        The Mutt Next Generation E-Mail Client                                       65
3251
3252        SASL is a special super-authenticator, which selects among several protocols
3253        (including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure method
3254        available on your host and the server. Using some of these methods (including
3255        DIGEST-MD5 and possibly GSSAPI), your entire session will be encrypted and
3256        invisible to those teeming network snoops. It is the best option if you have
3257        it. To use it, you must have the Cyrus SASL library installed on your system
3258        and compile mutt with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\ba_\bs_\bl flag.
3259
3260        Mutt-ng will try whichever methods are compiled in and available on the server,
3261        in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.
3262
3263        There are a few variables which control authentication:
3264
3265           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.111  , page 114) - controls the username under
3266             which you request authentication on the IMAP server, for all authentica-
3267             tors. This is overridden by an explicit username in the mailbox path (i.e.
3268             by using a mailbox name of the form {user@host}).
3269
3270           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.106  , page 113) - a password which you may pre-
3271             set, used by all authentication methods where a password is needed.
3272
3273           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs (section 7.4.97  , page 111) - a colon-delimited list
3274             of IMAP authentication methods to try, in the order you wish to try them.
3275             If specified, this overrides mutt's default (attempt everything, in the
3276             order listed above).
3277
3278        _\b4_\b._\b1_\b5  _\bN_\bN_\bT_\bP _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
3279
3280        If compiled with ``--enable-nntp'' option, Mutt-ng can read news from a
3281        newsserver via NNTP.  You can open a newsgroup with the ``change-newsgroup''
3282        function from the index/pager which is by default bound to i.
3283
3284        The Default newsserver can be obtained from the $NNTPSERVER environment vari-
3285        able. Like other news readers, info about subscribed newsgroups is saved in a
3286        file as specified by the _\b$_\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc (section 7.4.163  , page 129) variable.
3287        Article headers are cached and can be loaded from a file when a newsgroup is
3288        entered instead loading from newsserver; currently, this caching mechanism
3289        still is different from the header caching for maildir/IMAP.
3290
3291        _\b4_\b._\b1_\b5_\b._\b1  _\bA_\bg_\ba_\bi_\bn_\b: _\bS_\bc_\bo_\br_\bi_\bn_\bg
3292
3293        Especially for Usenet, people often ask for advanced filtering and scoring
3294        functionality. Of course, mutt-ng has scoring and allows a killfile, too. How
3295        to use a killfile has been discussed in _\bM_\be_\bs_\bs_\ba_\bg_\be _\bs_\bc_\bo_\br_\bi_\bn_\bg (section 3.26  , page
3296        41).
3297
3298        What has not been discusses in detail is mutt-ng's built-in realname filter.
3299        For may newsreaders including those for ``advanced users'' like _\bs_\bl_\br_\bn or _\bt_\bi_\bn,
3300        there are frequent request for such functionality. The solutions offered often
3301        are complicated regular expressions.
3302
3303        In mutt-ng this is as easy as
3304
3305        The Mutt Next Generation E-Mail Client                                       66
3306
3307             score ~* =42
3308
3309        This tells mutt-ng to apply a score of 42 to all messages whose sender speci-
3310        fied a valid realname and a valid email address. Using
3311
3312             score !~* =42
3313
3314        on the contrary applies a score of 42 to all messages _\bn_\bo_\bt matching those crite-
3315        ria which are very strict:
3316
3317           +\bo Email addresses must be valid according to RFC 2822, see <ftp://ftp.rfc-
3318             editor.org/in-notes/rfc2822.txt>
3319
3320           +\bo the name must consist of at least 2 fields whereby a field must not end in
3321             a dot. This means that ``Joe User'' and ``Joe A.  User'' are valid while
3322             ``J. User'' and ``J. A. User'' aren't.
3323
3324           +\bo it's assumed that users are interested in reading their own mail and mail
3325             from people who they have defined an alias for so that those 2 groups of
3326             messages are excluded from the strict rules.
3327
3328        _\b4_\b._\b1_\b6  _\bS_\bM_\bT_\bP _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
3329
3330        Mutt-ng can be built using a library called ``libESMTP'' which provides SMTP
3331        functionality. When configure was called with --with-libesmtp or the output
3332        muttng -v contains +USE_LIBESMTP, this will be or is the case already. The SMTP
3333        support includes support for Delivery Status Notification (see _\bD_\be_\bl_\bi_\bv_\be_\br_\by _\bS_\bt_\ba_\bt_\bu_\bs
3334        _\bN_\bo_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn (section 4.12  , page 62) section) as well as handling the 8BIT-
3335        MIME flag controlled via _\b$_\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be (section 7.4.335  , page 171).
3336
3337        To enable sending mail directly via SMTP without an MTA such as Postfix or
3338        SSMTP and the like, simply set the _\b$_\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.293  , page 159)
3339        variable pointing to your SMTP server.
3340
3341        Authentication mechanisms are available via the _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section 7.4.297  ,
3342        page 160) and _\b$_\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.294  , page 159) variables.
3343
3344        Transport Encryption via the StartTLS command is also available. For this to
3345        work, first of all Mutt-ng must be built with SSL or GNUTLS.  Secondly, the
3346        _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs (section 7.4.296  , page 160) variable must be either set to
3347        ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server
3348        supports it: for the second case, the connection will fail if it doesn't while
3349        switching back to unencrypted communication for the first one.
3350
3351        Some mail providers require user's to set a particular envelope sender, i.e.
3352
3353        The Mutt Next Generation E-Mail Client                                       67
3354
3355        they allow for only one value which may not be what the user wants to send as
3356        the From: header. In this case, the variable _\b$_\bs_\bm_\bt_\bp_\b__\be_\bn_\bv_\be_\bl_\bo_\bp_\be (section 7.4.292  ,
3357        page 159) may be used to set the envelope different from the From: header.
3358
3359        _\b4_\b._\b1_\b7  _\bM_\ba_\bn_\ba_\bg_\bi_\bn_\bg _\bm_\bu_\bl_\bt_\bi_\bp_\bl_\be _\bI_\bM_\bA_\bP_\b/_\bP_\bO_\bP_\b/_\bN_\bN_\bT_\bP _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\bs _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
3360
3361        If you happen to have accounts on multiple IMAP and/or POP servers, you may
3362        find managing all the authentication settings inconvenient and error-prone.
3363        The account-hook command may help. This hook works like folder-hook but is
3364        invoked whenever you access a remote mailbox (including inside the folder
3365        browser), not just when you open the mailbox.
3366
3367        Some examples:
3368
3369             account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
3370             account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
3371             account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
3372
3373        _\b4_\b._\b1_\b8  _\bS_\bt_\ba_\br_\bt _\ba _\bW_\bW_\bW _\bB_\br_\bo_\bw_\bs_\be_\br _\bo_\bn _\bU_\bR_\bL_\bs _\b(_\bE_\bX_\bT_\bE_\bR_\bN_\bA_\bL_\b)
3374
3375        If a message contains URLs (_\bu_\bn_\bi_\bf_\bi_\be_\bd _\br_\be_\bs_\bo_\bu_\br_\bc_\be _\bl_\bo_\bc_\ba_\bt_\bo_\br = address in the WWW space
3376        like _\bh_\bt_\bt_\bp_\b:_\b/_\b/_\bw_\bw_\bw_\b._\bm_\bu_\bt_\bt_\b._\bo_\br_\bg_\b/), it is efficient to get a menu with all the URLs and
3377        start a WWW browser on one of them.  This functionality is provided by the
3378        external urlview program which can be retrieved at ftp://ftp.mutt.org/mutt/con-
3379        trib/ and the configuration commands:
3380
3381             macro index \cb |urlview\n
3382             macro pager \cb |urlview\n
3383
3384        _\b4_\b._\b1_\b9  _\bC_\bo_\bm_\bp_\br_\be_\bs_\bs_\be_\bd _\bf_\bo_\bl_\bd_\be_\br_\bs _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
3385
3386        If Mutt-ng was compiled with compressed folders support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\b-
3387        _\bu_\br_\be script with the _\b-_\b-_\be_\bn_\ba_\bb_\bl_\be_\b-_\bc_\bo_\bm_\bp_\br_\be_\bs_\bs_\be_\bd flag), Mutt can open folders stored in
3388        an arbitrary format, provided that the user has a script to convert from/to
3389        this format to one of the accepted.
3390
3391        The most common use is to open compressed archived folders e.g. with gzip.
3392
3393        In addition, the user can provide a script that gets a folder in an accepted
3394        format and appends its context to the folder in the user-defined format, which
3395        may be faster than converting the entire folder to the accepted format, append-
3396        ing to it and converting back to the user-defined format.
3397
3398        There are three hooks defined (_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 68), _\bc_\bl_\bo_\bs_\be_\b-
3399        _\bh_\bo_\bo_\bk (section 4.19.2  , page 68) and _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 69))
3400        which define commands to uncompress and compress a folder and to append mes-
3401        sages to an existing compressed folder respectively.
3402
3403        The Mutt Next Generation E-Mail Client                                       68
3404
3405        For example:
3406
3407             open-hook \\.gz$ "gzip -cd %f > %t"
3408             close-hook \\.gz$ "gzip -c %t > %f"
3409             append-hook \\.gz$ "gzip -c %t >> %f"
3410
3411        You do not have to specify all of the commands. If you omit _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (sec-
3412        tion 4.19.3  , page 69), the folder will be open and closed again each time you
3413        will add to it. If you omit _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 68) (or give
3414        empty command) , the folder will be open in the  mode. If you specify _\ba_\bp_\bp_\be_\bn_\bd_\b-
3415        _\bh_\bo_\bo_\bk (section 4.19.3  , page 69) though you'll be able to append to the folder.
3416
3417        Note that Mutt-ng will only try to use hooks if the file is not in one of the
3418        accepted formats. In particular, if the file is empty, mutt supposes it is not
3419        compressed. This is important because it allows the use of programs that do not
3420        have well defined extensions. Just use '.' as a regexp. But this may be sur-
3421        prising if your compressing script produces empty files. In this situation,
3422        unset _\b$_\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by (section 7.4.247  , page 148), so that the compressed file
3423        will be removed if you delete all of the messages.
3424
3425        _\b4_\b._\b1_\b9_\b._\b1  _\bO_\bp_\be_\bn _\ba _\bc_\bo_\bm_\bp_\br_\be_\bs_\bs_\be_\bd _\bm_\ba_\bi_\bl_\bb_\bo_\bx _\bf_\bo_\br _\br_\be_\ba_\bd_\bi_\bn_\bg
3426
3427        Usage: open-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3428
3429        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd is the command that can be used for opening the folders whose names
3430        match _\br_\be_\bg_\be_\bx_\bp.
3431
3432        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the printf-like format string, and it should accept two
3433        parameters: %f, which is replaced with the (compressed) folder name, and %t
3434        which is replaced with the name of the temporary folder to which to write.
3435
3436        %f and %t can be repeated any number of times in the command string, and all of
3437        the entries are replaced with the appropriate folder name. In addition, %% is
3438        replaced by %, as in printf, and any other %anything is left as is.
3439
3440        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd should n\bno\bot\bt remove the original compressed file.  The _\bc_\bo_\bm_\bm_\ba_\bn_\bd should
3441        return non-zero exit status if it fails, so mutt knows something's wrong.
3442
3443        Example:
3444
3445             open-hook \\.gz$ "gzip -cd %f > %t"
3446
3447        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type.
3448
3449        _\b4_\b._\b1_\b9_\b._\b2  _\bW_\br_\bi_\bt_\be _\ba _\bc_\bo_\bm_\bp_\br_\be_\bs_\bs_\be_\bd _\bm_\ba_\bi_\bl_\bb_\bo_\bx
3450
3451        Usage: close-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3452
3453        This is used to close the folder that was open with the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3454        4.19.1  , page 68) command after some changes were made to it.
3455
3456        The Mutt Next Generation E-Mail Client                                       69
3457
3458        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the command that can be used for closing the folders
3459        whose names match _\br_\be_\bg_\be_\bx_\bp. It has the same format as in the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3460        4.19.1  , page 68) command. Temporary folder in this case is the folder previ-
3461        ously produced by the <_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 68) command.
3462
3463        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd should n\bno\bot\bt remove the decompressed file. The _\bc_\bo_\bm_\bm_\ba_\bn_\bd should return
3464        non-zero exit status if it fails, so mutt knows something's wrong.
3465
3466        Example:
3467
3468             close-hook \\.gz$ "gzip -c %t > %f"
3469
3470        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type, and the
3471        file can only be open in the readonly mode.
3472
3473        _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 68) is not called when you exit from the
3474        folder if the folder was not changed.
3475
3476        _\b4_\b._\b1_\b9_\b._\b3  _\bA_\bp_\bp_\be_\bn_\bd _\ba _\bm_\be_\bs_\bs_\ba_\bg_\be _\bt_\bo _\ba _\bc_\bo_\bm_\bp_\br_\be_\bs_\bs_\be_\bd _\bm_\ba_\bi_\bl_\bb_\bo_\bx
3477
3478        Usage: append-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3479
3480        This command is used for saving to an existing compressed folder.  The _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3481        is the command that can be used for appending to the folders whose names match
3482        _\br_\be_\bg_\be_\bx_\bp. It has the same format as in the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 68)
3483        command.  The temporary folder in this case contains the messages that are
3484        being appended.
3485
3486        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd should n\bno\bot\bt remove the decompressed file. The _\bc_\bo_\bm_\bm_\ba_\bn_\bd should return
3487        non-zero exit status if it fails, so mutt knows something's wrong.
3488
3489        Example:
3490
3491             append-hook \\.gz$ "gzip -c %t >> %f"
3492
3493        When _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 69) is used, the folder is not opened,
3494        which saves time, but this means that we can not find out what the folder type
3495        is. Thus the default (_\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.132  , page 121)) type is always
3496        supposed (i.e.  this is the format used for the temporary folder).
3497
3498        If the file does not exist when you save to it, _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  ,
3499        page 68) is called, and not _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 69). _\ba_\bp_\bp_\be_\bn_\bd_\b-
3500        _\bh_\bo_\bo_\bk (section 4.19.3  , page 69) is only for appending to existing folders.
3501
3502        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type. In this
3503        case, the folder will be open and closed again (using _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3504        4.19.1  , page 68) and _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 68)respectively) each
3505        time you will add to it.
3506
3507        The Mutt Next Generation E-Mail Client                                       70
3508
3509        _\b4_\b._\b1_\b9_\b._\b4  _\bE_\bn_\bc_\br_\by_\bp_\bt_\be_\bd _\bf_\bo_\bl_\bd_\be_\br_\bs
3510
3511        The compressed folders support can also be used to handle encrypted folders. If
3512        you want to encrypt a folder with PGP, you may want to use the following hooks:
3513
3514             open-hook  \\.pgp$ "pgp -f < %f > %t"
3515             close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
3516
3517        Please note, that PGP does not support appending to an encrypted folder, so
3518        there is no append-hook defined.
3519
3520        N\bNo\bot\bte\be:\b: the folder is temporary stored decrypted in the /tmp directory, where it
3521        can be read by your system administrator. So think about the security aspects
3522        of this.
3523
3524        _\b5_\b.  _\bM_\bu_\bt_\bt_\b-_\bn_\bg_\b'_\bs _\bM_\bI_\bM_\bE _\bS_\bu_\bp_\bp_\bo_\br_\bt
3525
3526        Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME
3527        MUA.  Every effort has been made to provide the functionality that the discern-
3528        ing MIME user requires, and the conformance to the standards wherever possible.
3529        When configuring Mutt-ng for MIME, there are two extra types of configuration
3530        files which Mutt-ng uses.  One is the mime.types file, which contains the map-
3531        ping of file extensions to IANA MIME types.  The other is the mailcap file,
3532        which specifies the external commands to use for handling specific MIME types.
3533
3534        _\b5_\b._\b1  _\bU_\bs_\bi_\bn_\bg _\bM_\bI_\bM_\bE _\bi_\bn _\bM_\bu_\bt_\bt
3535
3536        There are three areas/menus in Mutt-ng which deal with MIME, they are the pager
3537        (while viewing a message), the attachment menu and the compose menu.
3538
3539        _\b5_\b._\b1_\b._\b1  _\bV_\bi_\be_\bw_\bi_\bn_\bg _\bM_\bI_\bM_\bE _\bm_\be_\bs_\bs_\ba_\bg_\be_\bs _\bi_\bn _\bt_\bh_\be _\bp_\ba_\bg_\be_\br
3540
3541        When you select a message from the index and view it in the pager, Mutt decodes
3542        the message to a text representation.  Mutt-ng internally supports a number of
3543        MIME types, including text/plain, text/enriched, message/rfc822, and mes-
3544        sage/news.  In addition, the export controlled version of Mutt-ng recognizes a
3545        variety of PGP MIME types, including PGP/MIME and application/pgp.
3546
3547        Mutt-ng will denote attachments with a couple lines describing them.  These
3548        lines are of the form:
3549
3550             [-- Attachment #1: Description --]
3551             [-- Type: text/plain, Encoding: 7bit, Size: 10000 --]
3552
3553        Where the Description is the description or filename given for the attachment,
3554        and the Encoding is one of 7bit/8bit/quoted-printable/base64/binary.
3555
3556        The Mutt Next Generation E-Mail Client                                       71
3557
3558        If Mutt-ng cannot deal with a MIME type, it will display a message like:
3559
3560             [-- image/gif is unsupported (use 'v' to view this part) --]
3561
3562        _\b5_\b._\b1_\b._\b2  _\bT_\bh_\be _\bA_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bM_\be_\bn_\bu
3563
3564        The default binding for view-attachments is `v', which displays the attachment
3565        menu for a message.  The attachment menu displays a list of the attachments in
3566        a message.  From the attachment menu, you can save, print, pipe, delete, and
3567        view attachments.  You can apply these operations to a group of attachments at
3568        once, by tagging the attachments and by using the ``tag-prefix'' operator.  You
3569        can also reply to the current message from this menu, and only the current
3570        attachment (or the attachments tagged) will be quoted in your reply.  You can
3571        view attachments as text, or view them using the mailcap viewer definition.
3572
3573        Finally, you can apply the usual message-related functions (like _\br_\be_\bs_\be_\bn_\bd_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be
3574        (section 2.5.4  , page 13), and the reply and forward functions) to attachments
3575        of type message/rfc822.
3576
3577        See the help on the attachment menu for more information.
3578
3579        _\b5_\b._\b1_\b._\b3  _\bT_\bh_\be _\bC_\bo_\bm_\bp_\bo_\bs_\be _\bM_\be_\bn_\bu
3580
3581        The compose menu is the menu you see before you send a message.  It allows you
3582        to edit the recipient list, the subject, and other aspects of your message.  It
3583        also contains a list of the attachments of your message, including the main
3584        body.  From this menu, you can print, copy, filter, pipe, edit, compose,
3585        review, and rename an attachment or a list of tagged attachments.  You can also
3586        modifying the attachment information, notably the type, encoding and descrip-
3587        tion.
3588
3589        Attachments appear as follows:
3590
3591             -   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 <no description>
3592                 2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz <no description>
3593
3594        The '-' denotes that Mutt-ng will delete the file after sending (or postponing,
3595        or canceling) the message.  It can be toggled with the toggle-unlink command
3596        (default: u).  The next field is the MIME content-type, and can be changed with
3597        the edit-type command (default: ^T).  The next field is the encoding for the
3598        attachment, which allows a binary message to be encoded for transmission on
3599        7bit links.  It can be changed with the edit-encoding command (default: ^E).
3600        The next field is the size of the attachment, rounded to kilobytes or
3601        megabytes.  The next field is the filename, which can be changed with the
3602        rename-file command (default: R).  The final field is the description of the
3603        attachment, and can be changed with the edit-description command (default: d).
3604
3605        _\b5_\b._\b2  _\bM_\bI_\bM_\bE _\bT_\by_\bp_\be _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bw_\bi_\bt_\bh _\bm_\bi_\bm_\be_\b._\bt_\by_\bp_\be_\bs
3606
3607        When you add an attachment to your mail message, Mutt-ng searches your personal
3608
3609        The Mutt Next Generation E-Mail Client                                       72
3610
3611        mime.types file at ${HOME}/.mime.types, and then the system mime.types file at
3612        /usr/local/share/mutt/mime.types or /etc/mime.types
3613
3614        The mime.types file consist of lines containing a MIME type and a space sepa-
3615        rated list of extensions.  For example:
3616
3617             application/postscript          ps eps
3618             application/pgp                 pgp
3619             audio/x-aiff                    aif aifc aiff
3620
3621        A sample mime.types file comes with the Mutt-ng distribution, and should con-
3622        tain most of the MIME types you are likely to use.
3623
3624        If Mutt-ng can not determine the mime type by the extension of the file you
3625        attach, it will look at the file.  If the file is free of binary information,
3626        Mutt-ng will assume that the file is plain text, and mark it as text/plain.  If
3627        the file contains binary information, then Mutt-ng will mark it as applica-
3628        tion/octet-stream.  You can change the MIME type that Mutt-ng assigns to an
3629        attachment by using the edit-type command from the compose menu (default: ^T).
3630        The MIME type is actually a major mime type followed by the sub-type, separated
3631        by a '/'. 6 major types: application, text, image, video, audio, and model have
3632        been approved after various internet discussions. Mutt-ng recognises all of
3633        these if the appropriate entry is found in the mime.types file. It also recog-
3634        nises other major mime types, such as the chemical type that is widely used in
3635        the molecular modelling community to pass molecular data in various forms to
3636        various molecular viewers. Non-recognised mime types should only be used if the
3637        recipient of the message is likely to be expecting such attachments.
3638
3639        _\b5_\b._\b3  _\bM_\bI_\bM_\bE _\bV_\bi_\be_\bw_\be_\br _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bw_\bi_\bt_\bh _\bm_\ba_\bi_\bl_\bc_\ba_\bp
3640
3641        Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix specific
3642        format specified in Appendix A of RFC 1524.  This file format is commonly
3643        referred to as the mailcap format.  Many MIME compliant programs utilize the
3644        mailcap format, allowing you to specify handling for all MIME types in one
3645        place for all programs.  Programs known to use this format include Netscape,
3646        XMosaic, lynx and metamail.
3647
3648        In order to handle various MIME types that Mutt-ng can not handle internally,
3649        Mutt-ng parses a series of external configuration files to find an external
3650        handler.  The default search string for these files is a colon delimited list
3651        set to
3652
3653             ${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
3654
3655        where $HOME is your home directory.
3656
3657        In particular, the metamail distribution will install a mailcap file, usually
3658        as /usr/local/etc/mailcap, which contains some baseline entries.
3659
3660        The Mutt Next Generation E-Mail Client                                       73
3661
3662        _\b5_\b._\b3_\b._\b1  _\bT_\bh_\be _\bB_\ba_\bs_\bi_\bc_\bs _\bo_\bf _\bt_\bh_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be
3663
3664        A mailcap file consists of a series of lines which are comments, blank, or def-
3665        initions.
3666
3667        A comment line consists of a # character followed by anything you want.
3668
3669        A blank line is blank.
3670
3671        A definition line consists of a content type, a view command, and any number of
3672        optional fields.  Each field of a definition line is divided by a semicolon ';'
3673        character.
3674
3675        The content type is specified in the MIME standard type/subtype method.  For
3676        example, text/plain, text/html, image/gif, etc.  In addition, the mailcap for-
3677        mat includes two formats for wildcards, one using the special '*' subtype, the
3678        other is the implicit wild, where you only include the major type.  For exam-
3679        ple, image/*, or video, will match all image types and video types, respec-
3680        tively.
3681
3682        The view command is a Unix command for viewing the type specified. There are
3683        two different types of commands supported. The default is to send the body of
3684        the MIME message to the command on stdin. You can change this behavior by using
3685        %s as a parameter to your view command.  This will cause Mutt-ng to save the
3686        body of the MIME message to a temporary file, and then call the view command
3687        with the %s replaced by the name of the temporary file. In both cases, Mutt-ng
3688        will turn over the terminal to the view program until the program quits, at
3689        which time Mutt will remove the temporary file if it exists.
3690
3691        So, in the simplest form, you can send a text/plain message to the external
3692        pager more on stdin:
3693
3694             text/plain; more
3695
3696        Or, you could send the message as a file:
3697
3698             text/plain; more %s
3699
3700        Perhaps you would like to use lynx to interactively view a text/html message:
3701
3702             text/html; lynx %s
3703
3704        In this case, lynx does not support viewing a file from stdin, so you must use
3705        the %s syntax.  N\bNo\bot\bte\be:\b: _\bS_\bo_\bm_\be _\bo_\bl_\bd_\be_\br _\bv_\be_\br_\bs_\bi_\bo_\bn_\bs _\bo_\bf _\bl_\by_\bn_\bx _\bc_\bo_\bn_\bt_\ba_\bi_\bn _\ba _\bb_\bu_\bg _\bw_\bh_\be_\br_\be _\bt_\bh_\be_\by _\bw_\bi_\bl_\bl
3706        _\bc_\bh_\be_\bc_\bk _\bt_\bh_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be _\bf_\bo_\br _\ba _\bv_\bi_\be_\bw_\be_\br _\bf_\bo_\br _\bt_\be_\bx_\bt_\b/_\bh_\bt_\bm_\bl_\b.  _\bT_\bh_\be_\by _\bw_\bi_\bl_\bl _\bf_\bi_\bn_\bd _\bt_\bh_\be _\bl_\bi_\bn_\be
3707        _\bw_\bh_\bi_\bc_\bh _\bc_\ba_\bl_\bl_\bs _\bl_\by_\bn_\bx_\b, _\ba_\bn_\bd _\br_\bu_\bn _\bi_\bt_\b.  _\bT_\bh_\bi_\bs _\bc_\ba_\bu_\bs_\be_\bs _\bl_\by_\bn_\bx _\bt_\bo _\bc_\bo_\bn_\bt_\bi_\bn_\bu_\bo_\bu_\bs_\bl_\by _\bs_\bp_\ba_\bw_\bn _\bi_\bt_\bs_\be_\bl_\bf _\bt_\bo
3708        _\bv_\bi_\be_\bw _\bt_\bh_\be _\bo_\bb_\bj_\be_\bc_\bt_\b.
3709
3710        On the other hand, maybe you don't want to use lynx interactively, you just
3711        want to have it convert the text/html to text/plain, then you can use:
3712
3713        The Mutt Next Generation E-Mail Client                                       74
3714
3715             text/html; lynx -dump %s | more
3716
3717        Perhaps you wish to use lynx to view text/html files, and a pager on all other
3718        text formats, then you would use the following:
3719
3720             text/html; lynx %s
3721             text/*; more
3722
3723        This is the simplest form of a mailcap file.
3724
3725        _\b5_\b._\b3_\b._\b2  _\bS_\be_\bc_\bu_\br_\be _\bu_\bs_\be _\bo_\bf _\bm_\ba_\bi_\bl_\bc_\ba_\bp
3726
3727        The interpretation of shell meta-characters embedded in MIME parameters can
3728        lead to security problems in general.  Mutt-ng tries to quote parameters in
3729        expansion of %s syntaxes properly, and avoids risky characters by substituting
3730        them, see the _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 7.4.123  , page 119) variable.
3731
3732        Although mutt's procedures to invoke programs with mailcap seem to be safe,
3733        there are other applications parsing mailcap, maybe taking less care of it.
3734        Therefore you should pay attention to the following rules:
3735
3736        _\bK_\be_\be_\bp _\bt_\bh_\be _\b%_\b-_\be_\bx_\bp_\ba_\bn_\bd_\bo_\bs _\ba_\bw_\ba_\by _\bf_\br_\bo_\bm _\bs_\bh_\be_\bl_\bl _\bq_\bu_\bo_\bt_\bi_\bn_\bg_\b.  Don't quote them with single or
3737        double quotes.  Mutt-ng does this for you, the right way, as should any other
3738        program which interprets mailcap.  Don't put them into backtick expansions.  Be
3739        highly careful with eval statements, and avoid them if possible at all.  Trying
3740        to fix broken behaviour with quotes introduces new leaks - there is no alterna-
3741        tive to correct quoting in the first place.
3742
3743        If you have to use the %-expandos' values in context where you need quoting or
3744        backtick expansions, put that value into a shell variable and reference the
3745        shell variable where necessary, as in the following example (using $charset
3746        inside the backtick expansion is safe, since it is not itself subject to any
3747        further expansion):
3748
3749             text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \
3750                     && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1
3751
3752        _\b5_\b._\b3_\b._\b3  _\bA_\bd_\bv_\ba_\bn_\bc_\be_\bd _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bU_\bs_\ba_\bg_\be
3753
3754        _\b5_\b._\b3_\b._\b3_\b._\b1  _\bO_\bp_\bt_\bi_\bo_\bn_\ba_\bl _\bF_\bi_\be_\bl_\bd_\bs
3755
3756        In addition to the required content-type and view command fields, you can add
3757        semi-colon ';' separated fields to set flags and other options.  Mutt-ng recog-
3758        nizes the following optional fields:
3759
3760              copiousoutput
3761                    This flag tells Mutt-ng that the command passes possibly large
3762                    amounts of text on stdout.  This causes Mutt-ng to invoke a pager
3763                    (either the internal pager or the external pager defined by the
3764                    pager variable) on the output of the view command.  Without this
3765
3766        The Mutt Next Generation E-Mail Client                                       75
3767
3768                    flag, Mutt-ng assumes that the command is interactive.  One could
3769                    use this to replace the pipe to more in the lynx -dump example in
3770                    the Basic section:
3771
3772                         text/html; lynx -dump %s ; copiousoutput
3773
3774                    This will cause lynx to format the text/html output as text/plain
3775                    and Mutt-ng will use your standard pager to display the results.
3776
3777              needsterminal
3778                    Mutt-ng uses this flag when viewing attachments with _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (sec-
3779                    tion 5.4  , page 78), in order to decide whether it should honor
3780                    the setting of the _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.341  , page 172) variable
3781                    or not.  When an attachment is viewed using an interactive program,
3782                    and the corresponding mailcap entry has a _\bn_\be_\be_\bd_\bs_\bt_\be_\br_\bm_\bi_\bn_\ba_\bl flag, Mutt-
3783                    ng will use _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.341  , page 172) and the exit
3784                    status of the program to decide if it will ask you to press a key
3785                    after the external program has exited.  In all other situations it
3786                    will not prompt you for a key.
3787
3788              compose=<command>
3789                    This flag specifies the command to use to create a new attachment
3790                    of a specific MIME type.  Mutt-ng supports this from the compose
3791                    menu.
3792
3793              composetyped=<command>
3794                    This flag specifies the command to use to create a new attachment
3795                    of a specific MIME type.  This command differs from the compose
3796                    command in that mutt will expect standard MIME headers on the data.
3797                    This can be used to specify parameters, filename, description, etc.
3798                    for a new attachment.   Mutt-ng supports this from the compose
3799                    menu.
3800
3801              print=<command>
3802                    This flag specifies the command to use to print a specific MIME
3803                    type.  Mutt-ng supports this from the attachment and compose menus.
3804
3805              edit=<command>
3806                    This flag specifies the command to use to edit a specific MIME
3807                    type.  Mutt-ng supports this from the compose menu, and also uses
3808                    it to compose new attachments.  Mutt-ng will default to the defined
3809                    editor for text attachments.
3810
3811              nametemplate=<template>
3812                    This field specifies the format for the file denoted by %s in the
3813                    command fields.  Certain programs will require a certain file
3814                    extension, for instance, to correctly view a file.  For instance,
3815                    lynx will only interpret a file as text/html if the file ends in
3816                    .html.  So, you would specify lynx as a text/html viewer with a
3817                    line in the mailcap file like:
3818
3819                         text/html; lynx %s; nametemplate=%s.html
3820
3821        The Mutt Next Generation E-Mail Client                                       76
3822
3823              test=<command>
3824                    This field specifies a command to run to test whether this mailcap
3825                    entry should be used.  The command is defined with the command
3826                    expansion rules defined in the next section.  If the command
3827                    returns 0, then the test passed, and Mutt-ng uses this entry.  If
3828                    the command returns non-zero, then the test failed, and Mutt-ng
3829                    continues searching for the right entry.  N\bNo\bot\bte\be:\b: _\bt_\bh_\be _\bc_\bo_\bn_\bt_\be_\bn_\bt_\b-_\bt_\by_\bp_\be
3830                    _\bm_\bu_\bs_\bt _\bm_\ba_\bt_\bc_\bh _\bb_\be_\bf_\bo_\br_\be _\bM_\bu_\bt_\bt_\b-_\bn_\bg _\bp_\be_\br_\bf_\bo_\br_\bm_\bs _\bt_\bh_\be _\bt_\be_\bs_\bt_\b.  For example:
3831
3832                         text/html; netscape -remote 'openURL(%s)' ; test=RunningX
3833                         text/html; lynx %s
3834
3835                    In this example, Mutt-ng will run the program RunningX which will
3836                    return 0 if the X Window manager is running, and non-zero if it
3837                    isn't.  If RunningX returns 0, then Mutt-ng will call netscape to
3838                    display the text/html object.  If RunningX doesn't return 0, then
3839                    Mutt-ng will go on to the next entry and use lynx to display the
3840                    text/html object.
3841
3842        _\b5_\b._\b3_\b._\b3_\b._\b2  _\bS_\be_\ba_\br_\bc_\bh _\bO_\br_\bd_\be_\br
3843
3844        When searching for an entry in the mailcap file, Mutt-ng will search for the
3845        most useful entry for its purpose.  For instance, if you are attempting to
3846        print an image/gif, and you have the following entries in your mailcap file,
3847        Mutt-ng will search for an entry with the print command:
3848
3849             image/*;        xv %s
3850             image/gif;      ; print= anytopnm %s | pnmtops | lpr; \
3851                             nametemplate=%s.gif
3852
3853        Mutt-ng will skip the image/* entry and use the image/gif entry with the print
3854        command.
3855
3856        In addition, you can use this with _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 78) to denote
3857        two commands for viewing an attachment, one to be viewed automatically, the
3858        other to be viewed interactively from the attachment menu.  In addition, you
3859        can then use the test feature to determine which viewer to use interactively
3860        depending on your environment.
3861
3862             text/html;      netscape -remote 'openURL(%s)' ; test=RunningX
3863             text/html;      lynx %s; nametemplate=%s.html
3864             text/html;      lynx -dump %s; nametemplate=%s.html; copiousoutput
3865
3866        For _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 78), Mutt-ng will choose the third entry
3867        because of the copiousoutput tag.  For interactive viewing, Mutt will run the
3868        program RunningX to determine if it should use the first entry.  If the program
3869        returns non-zero, Mutt-ng will use the second entry for interactive viewing.
3870
3871        _\b5_\b._\b3_\b._\b3_\b._\b3  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
3872
3873        The various commands defined in the mailcap files are passed to the /bin/sh
3874
3875        The Mutt Next Generation E-Mail Client                                       77
3876
3877        shell using the system() function.  Before the command is passed to /bin/sh -c,
3878        it is parsed to expand various special parameters with information from Mutt-
3879        ng.  The keywords Mutt-ng expands are:
3880
3881              %s
3882                    As seen in the basic mailcap section, this variable is expanded to
3883                    a filename specified by the calling program.  This file contains
3884                    the body of the message to view/print/edit or where the composing
3885                    program should place the results of composition.  In addition, the
3886                    use of this keyword causes Mutt-ng to not pass the body of the mes-
3887                    sage to the view/print/edit program on stdin.
3888
3889              %t
3890                    Mutt-ng will expand %t to the text representation of the content
3891                    type of the message in the same form as the first parameter of the
3892                    mailcap definition line, ie text/html or image/gif.
3893
3894              %{<parameter>}
3895                    Mutt-ng will expand this to the value of the specified parameter
3896                    from the Content-Type: line of the mail message.  For instance, if
3897                    Your mail message contains:
3898
3899                         Content-Type: text/plain; charset=iso-8859-1
3900
3901                    then Mutt-ng will expand %{charset} to iso-8859-1.  The default
3902                    metamail mailcap file uses this feature to test the charset to
3903                    spawn an xterm using the right charset to view the message.
3904
3905              \%
3906                    This will be replaced by a %
3907
3908        Mutt-ng does not currently support the %F and %n keywords specified in RFC
3909        1524.  The main purpose of these parameters is for multipart messages, which is
3910        handled internally by Mutt-ng.
3911
3912        _\b5_\b._\b3_\b._\b4  _\bE_\bx_\ba_\bm_\bp_\bl_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be_\bs
3913
3914        This mailcap file is fairly simple and standard:
3915
3916             # I'm always running X :)
3917             video/*;        xanim %s > /dev/null
3918             image/*;        xv %s > /dev/null
3919
3920             # I'm always running netscape (if my computer had more memory, maybe)
3921             text/html;      netscape -remote 'openURL(%s)'
3922
3923        This mailcap file shows quite a number of examples:
3924
3925        The Mutt Next Generation E-Mail Client                                       78
3926
3927             # Use xanim to view all videos   Xanim produces a header on startup,
3928             # send that to /dev/null so I don't see it
3929             video/*;        xanim %s > /dev/null
3930
3931             # Send html to a running netscape by remote
3932             text/html;      netscape -remote 'openURL(%s)'; test=RunningNetscape
3933
3934             # If I'm not running netscape but I am running X, start netscape on the
3935             # object
3936             text/html;      netscape %s; test=RunningX
3937
3938             # Else use lynx to view it as text
3939             text/html;      lynx %s
3940
3941             # This version would convert the text/html to text/plain
3942             text/html;      lynx -dump %s; copiousoutput
3943
3944             # I use enscript to print text in two columns to a page
3945             text/*;         more %s; print=enscript -2Gr %s
3946
3947             # Netscape adds a flag to tell itself to view jpegs internally
3948             image/jpeg;xv %s; x-mozilla-flags=internal
3949
3950             # Use xv to view images if I'm running X
3951             # In addition, this uses the \ to extend the line and set my editor
3952             # for images
3953             image/*;xv %s; test=RunningX; \
3954                     edit=xpaint %s
3955
3956             # Convert images to text using the netpbm tools
3957             image/*;  (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
3958             pbmtoascii -1x2 ) 2>&1 ; copiousoutput
3959
3960             # Send excel spreadsheets to my NT box
3961             application/ms-excel; open.pl %s
3962
3963        _\b5_\b._\b4  _\bM_\bI_\bM_\bE _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw
3964
3965        In addition to explicitly telling Mutt-ng to view an attachment with the MIME
3966        viewer defined in the mailcap file, Mutt-ng has support for automatically view-
3967        ing MIME attachments while in the pager.
3968
3969        To work, you must define a viewer in the mailcap file which uses the copi-
3970        ousoutput option to denote that it is non-interactive.  Usually, you also use
3971        the entry to convert the attachment to a text representation which you can view
3972        in the pager.
3973
3974        You then use the auto_view muttrc command to list the content-types that you
3975        wish to view automatically.
3976
3977        For instance, if you set auto_view to:
3978
3979        The Mutt Next Generation E-Mail Client                                       79
3980
3981             auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz
3982
3983        Mutt-ng could use the following mailcap entries to automatically view attach-
3984        ments of these types.
3985
3986             text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
3987             image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
3988             application/x-gunzip;   gzcat; copiousoutput
3989             application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput
3990             application/postscript; ps2ascii %s; copiousoutput
3991
3992        ``unauto_view'' can be used to remove previous entries from the autoview list.
3993        This can be used with message-hook to autoview messages based on size, etc.
3994        ``unauto_view *'' will remove all previous entries.
3995
3996        _\b5_\b._\b5  _\bM_\bI_\bM_\bE _\bM_\bu_\bl_\bt_\bi_\bp_\ba_\br_\bt_\b/_\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be
3997
3998        Mutt-ng has some heuristics for determining which attachment of a multi-
3999        part/alternative type to display.  First, mutt will check the alternative_order
4000        list to determine if one of the available types is preferred.  The alterna-
4001        tive_order list consists of a number of MIME types in order, including support
4002        for implicit and explicit wildcards, for example:
4003
4004             alternative_order text/enriched text/plain text application/postscript image/*
4005
4006        Next, mutt will check if any of the types have a defined _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section
4007        5.4  , page 78), and use that.  Failing that, Mutt-ng will look for any text
4008        type.  As a last attempt, mutt will look for any type it knows how to handle.
4009
4010        To remove a MIME type from the alternative_order list, use the unalterna-
4011        tive_order command.
4012
4013        _\b5_\b._\b6  _\bM_\bI_\bM_\bE _\bL_\bo_\bo_\bk_\bu_\bp
4014
4015        Mutt-ng's mime_lookup list specifies a list of mime-types that should not be
4016        treated according to their mailcap entry.  This option is designed to deal with
4017        binary types such as application/octet-stream.  When an attachment's mime-type
4018        is listed in mime_lookup, then the extension of the filename will be compared
4019        to the list of extensions in the mime.types file.  The mime-type associated
4020        with this extension will then be used to process the attachment according to
4021        the rules in the mailcap file and according to any other configuration options
4022        (such as auto_view) specified.  Common usage would be:
4023
4024             mime_lookup application/octet-stream application/X-Lotus-Manuscript
4025
4026        In addition, the unmime_lookup command may be used to disable this feature for
4027
4028        The Mutt Next Generation E-Mail Client                                       80
4029
4030        any particular mime-type if it had been set, for example, in a global muttrc.
4031
4032        _\b6_\b.  _\bS_\be_\bc_\bu_\br_\bi_\bt_\by _\bC_\bo_\bn_\bs_\bi_\bd_\be_\br_\ba_\bt_\bi_\bo_\bn_\bs
4033
4034        First of all, mutt-ng contains no security holes included by intention but may
4035        contain unknown security holes. As a consequence, please run mutt-ng only with
4036        as few permissions as possible.
4037
4038        Please do not run mutt-ng as the super user.
4039
4040        When configuring mutt-ng, there're some points to note about secure setups.
4041
4042        In practice, mutt-ng can be easily made as vulnerable as even the most insecure
4043        mail user agents (in their default configuration) just by changing mutt-ng's
4044        configuration files: it then can execute arbitrary programs and scripts
4045        attached to messages, send out private data on its own, etc. Although this is
4046        not believed to the common type of setup, please read this chapter carefully.
4047
4048        _\b6_\b._\b1  _\bP_\ba_\bs_\bs_\bw_\bo_\br_\bd_\bs
4049
4050        Although mutt-ng can be told the various passwords for accounts, please never
4051        store passwords in configuration files. Besides the fact that the system's
4052        operator can always read them, you could forget to replace the actual password
4053        with asterisks when reporting a bug or asking for help via, for example, a
4054        mailing list so that your mail including your password could be archived by
4055        internet search engines, etc. Please never store passwords on disk.
4056
4057        _\b6_\b._\b2  _\bT_\be_\bm_\bp_\bo_\br_\ba_\br_\by _\bF_\bi_\bl_\be_\bs
4058
4059        Mutt-ng uses many temporary files for viewing messages, verifying digital sig-
4060        natures, etc. The _\b$_\bu_\bm_\ba_\bs_\bk (section 7.4.333  , page 170) variable can be used to
4061        change the default permissions of these files. Please only change it if you
4062        really know what you are doing.  Also, a different location for these files may
4063        be desired which can be changed via the _\b$_\bt_\bm_\bp_\bd_\bi_\br (section 7.4.329  , page 169)
4064        variable.
4065
4066        _\b6_\b._\b3  _\bI_\bn_\bf_\bo_\br_\bm_\ba_\bt_\bi_\bo_\bn _\bL_\be_\ba_\bk_\bs
4067
4068        _\b6_\b._\b3_\b._\b1  _\bM_\be_\bs_\bs_\ba_\bg_\be_\b-_\bI_\bD_\b: _\bh_\be_\ba_\bd_\be_\br_\bs
4069
4070        In the default configuration, mutt-ng will leak some information to the outside
4071        world when sending messages: the generation of Message-ID: headers includes a
4072        step counter which is increased (and rotated) with every message sent. If you'd
4073        like to hide this information probably telling others how many mail you sent in
4074        which time, you at least need to remove the %P expando from the default setting
4075        of the _\b$_\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.149  , page 124) variable. Please make sure
4076        that you really know how local parts of these Message-ID: headers are composed.
4077
4078        The Mutt Next Generation E-Mail Client                                       81
4079
4080        _\b6_\b._\b3_\b._\b2  _\bm_\ba_\bi_\bl_\bt_\bo_\b:_\b-_\bs_\bt_\by_\bl_\be _\bl_\bi_\bn_\bk_\bs
4081
4082        As mutt-ng be can be set up to be the mail client to handle mailto: style links
4083        in websites, there're security considerations, too. To keep the old behavior by
4084        default, mutt-ng will be strict in interpreting them which means that arbitrary
4085        header fields can be embedded in these links which could override existing
4086        header fields or attach arbitrary files. This may be problematic if the
4087        _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102) variable is _\bu_\bn_\bs_\be_\bt, i.e. the user
4088        doesn't want to see header fields while editing the message.
4089
4090        For example, following a link like
4091
4092             mailto:joe@host?Attach=~/.gnupg/secring.gpg
4093
4094        will send out the user's private gnupg keyring to joe@host if the user doesn't
4095        follow the information on screen carefully enough.
4096
4097        When _\bu_\bn_\bs_\be_\bt_\bt_\bi_\bn_\bg the _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo (section 7.4.317  , page 167) variable, mutt-
4098        ng will
4099
4100           +\bo be less strict when interpreting these links by prepending a X-Mailto-
4101             string to all header fields embedded in such a link _\ba_\bn_\bd
4102
4103           +\bo turn on the _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102) variable by force
4104             to let the user see all the headers (because they still may leak informa-
4105             tion.)
4106
4107        _\b6_\b._\b4  _\bE_\bx_\bt_\be_\br_\bn_\ba_\bl _\ba_\bp_\bp_\bl_\bi_\bc_\ba_\bt_\bi_\bo_\bn_\bs
4108
4109        Mutt-ng in many places has to rely on external applications or for convenience
4110        supports mechanisms involving external applications.
4111
4112        _\b6_\b._\b4_\b._\b1  _\bm_\ba_\bi_\bl_\bc_\ba_\bp
4113
4114        One of these is the mailcap mechanism as defined by RfC 1524. Mutt-ng can be
4115        set up to _\ba_\bu_\bt_\bo_\bm_\ba_\bt_\bi_\bc_\ba_\bl_\bl_\by execute any given utility as listed in one of the mail-
4116        cap files (see the _\b$_\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh (section 7.4.122  , page 119) variable for
4117        details.)
4118
4119        These utilities may have a variety of security vulnerabilities, including over-
4120        writing of arbitrary files, information leaks or other exploitable bugs.  These
4121        vulnerabilities may go unnoticed by the user, especially when they are called
4122        automatically (and without interactive prompting) from the mailcap file(s).
4123        When using mutt-ng's autoview mechanism in combination with mailcap files,
4124        please be sure to...
4125
4126           +\bo manually select trustworth applications with a reasonable calling sequence
4127
4128           +\bo periodically check the contents of mailcap files, especially after soft-
4129             ware installations or upgrades
4130
4131        The Mutt Next Generation E-Mail Client                                       82
4132
4133           +\bo keep the software packages referenced in the mailcap file up to date
4134
4135           +\bo leave the _\b$_\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 7.4.123  , page 119) variable in its
4136             default state to restrict mailcap expandos to a safe set of characters
4137
4138        _\b6_\b._\b4_\b._\b2  _\bO_\bt_\bh_\be_\br
4139
4140        Besides the mailcap mechanism, mutt-ng uses a number of other external utili-
4141        ties for operation.
4142
4143        The same security considerations apply for these as for tools involved via
4144        mailcap (for example, mutt-ng is vulnerable to Denial of Service Attacks with
4145        compressed folders support if the uncompressed mailbox is too large for the
4146        disk it is saved to.)
4147
4148        As already noted, most of these problems are not built in but caused by wrong
4149        configuration, so please check your configuration.
4150
4151        _\b7_\b.  _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be
4152
4153        _\b7_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs
4154
4155        Running mutt with no arguments will make Mutt-ng attempt to read your spool
4156        mailbox.  However, it is possible to read other mailboxes and to send messages
4157        from the command line as well.
4158
4159             -A      expand an alias
4160             -a      attach a file to a message
4161             -b      specify a blind carbon-copy (BCC) address
4162             -c      specify a carbon-copy (Cc) address
4163             -e      specify a config command to be run after initialization files are read
4164             -f      specify a mailbox to load
4165             -F      specify an alternate file to read initialization commands
4166             -h      print help on command line options
4167             -H      specify a draft file from which to read a header and body
4168             -i      specify a file to include in a message composition
4169             -m      specify a default mailbox type
4170             -n      do not read the system Muttngrc
4171             -p      recall a postponed message
4172             -Q      query a configuration variable
4173             -R      open mailbox in read-only mode
4174             -s      specify a subject (enclose in quotes if it contains spaces)
4175             -t      dump the value of all variables to stdout
4176             -T      dump the value of all changed variables to stdout
4177             -v      show version number and compile-time definitions
4178             -x      simulate the mailx(1) compose mode
4179             -y      show a menu containing the files specified by the mailboxes command
4180             -z      exit immediately if there are no messages in the mailbox
4181             -Z      open the first folder with new message,exit immediately if none
4182
4183        To read messages in a mailbox
4184
4185        The Mutt Next Generation E-Mail Client                                       83
4186
4187        mutt [ -nz ] [ -F _\bm_\bu_\bt_\bt_\br_\bc ] [ -m _\bt_\by_\bp_\be ] [ -f _\bm_\ba_\bi_\bl_\bb_\bo_\bx ]
4188
4189        To compose a new message
4190
4191        mutt [ -n ] [ -F _\bm_\bu_\bt_\bt_\br_\bc ] [ -a _\bf_\bi_\bl_\be ] [ -c _\ba_\bd_\bd_\br_\be_\bs_\bs ] [ -i _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ] [ -s _\bs_\bu_\bb_\b-
4192        _\bj_\be_\bc_\bt ] _\ba_\bd_\bd_\br_\be_\bs_\bs [ _\ba_\bd_\bd_\br_\be_\bs_\bs ... ]
4193
4194        Mutt-ng also supports a ``batch'' mode to send prepared messages.  Simply redi-
4195        rect input from the file you wish to send.  For example,
4196
4197        mutt -s 'data set for run #2' professor@bigschool.edu < ~/run2.dat
4198
4199        This command will send a message to ``professor@bigschool.edu'' with a subject
4200        of ``data set for run #2''.  In the body of the message will be the contents of
4201        the file ``~/run2.dat''.
4202
4203        _\b7_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
4204
4205        The Mutt Next Generation E-Mail Client                                       84
4206
4207             ~A              all messages
4208             ~b EXPR         messages which contain EXPR in the message body
4209             ~B EXPR         messages which contain EXPR in the whole message
4210             ~c USER         messages carbon-copied to USER
4211             ~C EXPR         message is either to: or cc: EXPR
4212             ~D              deleted messages
4213             ~d [MIN]-[MAX]  messages with ``date-sent'' in a Date range
4214             ~E              expired messages
4215             ~e EXPR         message which contains EXPR in the ``Sender'' field
4216             ~F              flagged messages
4217             ~f USER         messages originating from USER
4218             ~g              cryptographically signed messages
4219             ~G              cryptographically encrypted messages
4220             ~H EXPR         messages with a spam attribute matching EXPR
4221             ~h EXPR         messages which contain EXPR in the message header
4222             ~k              message contains PGP key material
4223             ~i ID           message which match ID in the ``Message-ID'' field
4224             ~L EXPR         message is either originated or received by EXPR
4225             ~l              message is addressed to a known mailing list
4226             ~m [MIN]-[MAX]  message in the range MIN to MAX *)
4227             ~n [MIN]-[MAX]  messages with a score in the range MIN to MAX *)
4228             ~N              new messages
4229             ~O              old messages
4230             ~p              message is addressed to you (consults alternates)
4231             ~P              message is from you (consults alternates)
4232             ~Q              messages which have been replied to
4233             ~R              read messages
4234             ~r [MIN]-[MAX]  messages with ``date-received'' in a Date range
4235             ~S              superseded messages
4236             ~s SUBJECT      messages having SUBJECT in the ``Subject'' field.
4237             ~T              tagged messages
4238             ~t USER         messages addressed to USER
4239             ~U              unread messages
4240             ~v              message is part of a collapsed thread.
4241             ~V              cryptographically verified messages
4242             ~w EXPR         messages which contain EXPR in the `Newsgroups' field
4243                             (if compiled with NNTP support)
4244             ~x EXPR         messages which contain EXPR in the `References' field
4245             ~y EXPR         messages which contain EXPR in the `X-Label' field
4246             ~z [MIN]-[MAX]  messages with a size in the range MIN to MAX *)
4247             ~=              duplicated messages (see $duplicate_threads)
4248             ~$              unreferenced messages (requires threaded view)
4249             ~*              ``From'' contains realname and (syntactically) valid
4250                             address (excluded are addresses matching against
4251                             alternates or any alias)
4252
4253        Where EXPR, USER, ID, and SUBJECT are _\br_\be_\bg_\bu_\bl_\ba_\br _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs (section 4.1  , page
4254        48).  Special attention has to be made when using regular expressions inside of
4255        patterns.  Specifically, Mutt-ng's parser for these patterns will strip one
4256        level of backslash (\), which is normally used for quoting.  If it is your
4257        intention to use a backslash in the regular expression, you will need to use
4258        two backslashes instead (\\).
4259
4260        The Mutt Next Generation E-Mail Client                                       85
4261
4262        *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too.
4263
4264        _\b7_\b._\b3  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs
4265
4266        The following are the commands understood by mutt.
4267
4268           +\bo _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\b-_\bh_\bo_\bo_\bk (section 4.17  , page 66) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4269
4270           +\bo _\ba_\bl_\bi_\ba_\bs (section 3.4  , page 25) _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
4271
4272           +\bo _\bu_\bn_\ba_\bl_\bi_\ba_\bs (section 3.4  , page 25) [ * | _\bk_\be_\by ... ]
4273
4274           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.11  , page 33) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4275
4276           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.11  , page 33) [ * | _\br_\be_\bg_\be_\bx_\bp ... ]
4277
4278           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 79) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4279
4280           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 79) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4281
4282           +\bo _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 69) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4283
4284           +\bo _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 78) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4285
4286           +\bo _\bu_\bn_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 78) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4287
4288           +\bo _\bb_\bi_\bn_\bd (section 3.5  , page 26) _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
4289
4290           +\bo _\bc_\bh_\ba_\br_\bs_\be_\bt_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 28) _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
4291
4292           +\bo _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 68) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4293
4294           +\bo _\bc_\bo_\bl_\bo_\br (section 3.9  , page 30) _\bo_\bb_\bj_\be_\bc_\bt _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd _\bb_\ba_\bc_\bk_\bg_\br_\bo_\bu_\bn_\bd [ _\br_\be_\bg_\be_\bx_\bp ]
4295
4296           +\bo _\bu_\bn_\bc_\bo_\bl_\bo_\br (section 3.9  , page 30) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4297
4298           +\bo _\be_\bx_\be_\bc (section 3.25  , page 41) _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
4299
4300           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 38) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4301
4302           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 39) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4303
4304           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.7  , page 28) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4305
4306           +\bo _\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.17  , page 38) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
4307
4308           +\bo _\bu_\bn_\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.17  , page 38) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
4309
4310           +\bo _\bi_\bc_\bo_\bn_\bv_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 28) _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
4311
4312           +\bo _\bi_\bg_\bn_\bo_\br_\be (section 3.10  , page 32) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4313
4314        The Mutt Next Generation E-Mail Client                                       86
4315
4316           +\bo _\bu_\bn_\bi_\bg_\bn_\bo_\br_\be (section 3.10  , page 32) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4317
4318           +\bo _\bl_\bi_\bs_\bt_\bs (section 3.13  , page 35) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4319
4320           +\bo _\bu_\bn_\bl_\bi_\bs_\bt_\bs (section 3.13  , page 35) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4321
4322           +\bo _\bm_\ba_\bc_\br_\bo (section 3.8  , page 29) _\bm_\be_\bn_\bu _\bk_\be_\by _\bs_\be_\bq_\bu_\be_\bn_\bc_\be [ _\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn ]
4323
4324           +\bo _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.15  , page 36) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
4325
4326           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 36) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4327
4328           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.22  , page 40) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4329
4330           +\bo _\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 79) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4331
4332           +\bo _\bu_\bn_\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 79) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4333
4334           +\bo _\bm_\bo_\bn_\bo (section 3.9  , page 30) _\bo_\bb_\bj_\be_\bc_\bt _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be [ _\br_\be_\bg_\be_\bx_\bp ]
4335
4336           +\bo _\bu_\bn_\bm_\bo_\bn_\bo (section 3.9  , page 30) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4337
4338           +\bo _\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37) _\bs_\bt_\br_\bi_\bn_\bg
4339
4340           +\bo _\bu_\bn_\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37) _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
4341
4342           +\bo _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 68) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4343
4344           +\bo _\bc_\br_\by_\bp_\bt_\b-_\bh_\bo_\bo_\bk (section 3.23  , page 40) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\b-_\bi_\bd
4345
4346           +\bo _\bp_\bu_\bs_\bh (section 3.24  , page 40) _\bs_\bt_\br_\bi_\bn_\bg
4347
4348           +\bo _\br_\be_\bs_\be_\bt (section 3.28  , page 44) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4349
4350           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 38) _\br_\be_\bg_\be_\bx_\bp _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4351
4352           +\bo _\bs_\bc_\bo_\br_\be (section 3.26  , page 41) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
4353
4354           +\bo _\bu_\bn_\bs_\bc_\bo_\br_\be (section 3.26  , page 41) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4355
4356           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 39) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4357
4358           +\bo _\br_\be_\bp_\bl_\by_\b-_\bh_\bo_\bo_\bk (section , page ) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4359
4360           +\bo _\bs_\be_\bt (section 3.28  , page 44) [no|inv]_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be[=_\bv_\ba_\bl_\bu_\be] [ _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4361
4362           +\bo _\bu_\bn_\bs_\be_\bt (section 3.28  , page 44) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4363
4364           +\bo _\bs_\bo_\bu_\br_\bc_\be (section 3.29  , page 45) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4365
4366           +\bo _\bs_\bp_\ba_\bm (section 3.27  , page 42) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
4367
4368           +\bo _\bn_\bo_\bs_\bp_\ba_\bm (section 3.27  , page 42) _\bp_\ba_\bt_\bt_\be_\br_\bn
4369
4370        The Mutt Next Generation E-Mail Client                                       87
4371
4372           +\bo _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.13  , page 35) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4373
4374           +\bo _\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.13  , page 35) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4375
4376           +\bo _\bt_\bo_\bg_\bg_\bl_\be (section 3.28  , page 44) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4377
4378           +\bo _\bu_\bn_\bh_\bo_\bo_\bk (section 3.30  , page 45) _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be
4379
4380        _\b7_\b._\b4  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
4381
4382        The following list contains all variables which, in the process of providing
4383        more consistency, have been renamed and are partially even removed already. The
4384        left column contains the old synonym variables, the right column the full/new
4385        name:
4386
4387        The Mutt Next Generation E-Mail Client                                       88
4388
4389             edit_hdrs               edit_headers
4390             forw_decode             forward_decode
4391             forw_format             forward_format
4392             forw_quote              forward_quote
4393             hdr_format              index_format
4394             indent_str              indent_string
4395             mime_fwd                mime_forward
4396             msg_format              message_format
4397             pgp_autosign            crypt_autosign
4398             pgp_autoencrypt         crypt_autoencrypt
4399             pgp_replyencrypt        crypt_replyencrypt
4400             pgp_replysign           crypt_replysign
4401             pgp_replysignencrypted  crypt_replysignencrypted
4402             pgp_verify_sig          crypt_verify_sig
4403             pgp_create_traditional  pgp_autoinline
4404             pgp_auto_traditional    pgp_replyinline
4405             forw_decrypt            forward_decrypt
4406             smime_sign_as           smime_default_key
4407             post_indent_str         post_indent_string
4408             print_cmd               print_command
4409             shorten_hierarchy       sidebar_shorten_hierarchy
4410             ask_followup_to         nntp_ask_followup_to
4411             ask_x_comment_to        nntp_ask_x_comment_to
4412             catchup_newsgroup       nntp_catchup
4413             followup_to_poster      nntp_followup_to_poster
4414             group_index_format      nntp_group_index_format
4415             inews                   nntp_inews
4416             mime_subject            nntp_mime_subject
4417             news_cache_dir          nntp_cache_dir
4418             news_server             nntp_host
4419             newsrc                  nntp_newsrc
4420             nntp_poll               nntp_mail_check
4421             pop_checkinterval       pop_mail_check
4422             post_moderated          nntp_post_moderated
4423             save_unsubscribed       nntp_save_unsubscribed
4424             show_new_news           nntp_show_new_news
4425             show_only_unread        nntp_show_only_unread
4426             x_comment_to            nntp_x_comment_to
4427             smtp_auth_username      smtp_user
4428             smtp_auth_password      smtp_pass
4429
4430        The contrib subdirectory contains a script named update-config.pl which eases
4431        migration.
4432
4433        A complete list of current variables follows.
4434
4435        _\b7_\b._\b4_\b._\b1  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\ba_\bt_\bt_\ba_\bc_\bh
4436
4437        Type: quadoption
4438
4439        Default: no
4440
4441        This variable specifies whether to abort sending if no attachment was made but
4442
4443        The Mutt Next Generation E-Mail Client                                       89
4444
4445        the content references them, i.e. the content matches the regular expression
4446        given in _\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\br_\be_\bm_\bi_\bn_\bd_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.15  , page 92). If a match was
4447        found and this variable is set to _\by_\be_\bs, message sending will be aborted but the
4448        mail will be send nevertheless if set to _\bn_\bo.
4449
4450        This variable and _\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\br_\be_\bm_\bi_\bn_\bd_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.15  , page 92) are
4451        intended to remind the user to attach files if the message's text references
4452        them.
4453
4454        See also the _\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\br_\be_\bm_\bi_\bn_\bd_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.15  , page 92) variable.
4455
4456        _\b7_\b._\b4_\b._\b2  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\bs_\bu_\bb_\bj_\be_\bc_\bt
4457
4458        Type: quadoption
4459
4460        Default: ask-yes
4461
4462        If set to _\by_\be_\bs, when composing messages and no subject is given at the subject
4463        prompt, composition will be aborted.  If set to _\bn_\bo, composing messages with no
4464        subject given at the subject prompt will never be aborted.
4465
4466        _\b7_\b._\b4_\b._\b3  _\ba_\bb_\bo_\br_\bt_\b__\bu_\bn_\bm_\bo_\bd_\bi_\bf_\bi_\be_\bd
4467
4468        Type: quadoption
4469
4470        Default: yes
4471
4472        If set to _\by_\be_\bs, composition will automatically abort after editing the message
4473        body if no changes are made to the file (this check only happens after the
4474        _\bf_\bi_\br_\bs_\bt edit of the file).  When set to _\bn_\bo, composition will never be aborted.
4475
4476        _\b7_\b._\b4_\b._\b4  _\ba_\bg_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
4477
4478        Type: boolean
4479
4480        Default: yes
4481
4482        When _\bs_\be_\bt, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indi-
4483        cating which version of Mutt-ng was used for composing them.
4484
4485        _\b7_\b._\b4_\b._\b5  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be
4486
4487        Type: path
4488
4489        Default: '~/.muttngrc'
4490
4491        The default file in which to save aliases created by the ``_\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (sec-
4492        tion 2.5.4  , page 11)'' function.
4493
4494        N\bNo\bot\bte\be:\b: Mutt-ng will not automatically source this file; you must explicitly use
4495        the ``_\bs_\bo_\bu_\br_\bc_\be (section 3.29  , page 45)'' command for it to be executed.
4496
4497        _\b7_\b._\b4_\b._\b6  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
4498
4499        The Mutt Next Generation E-Mail Client                                       90
4500
4501        Type: string
4502
4503        Default: '%4n %2f %t %-10a   %r'
4504
4505        Specifies the format of the data displayed for the ``alias'' menu. The follow-
4506        ing printf(3)-style sequences are available:
4507
4508              %a
4509                    alias name
4510
4511              %f
4512                    flags - currently, a 'd' for an alias marked for deletion
4513
4514              %n
4515                    index number
4516
4517              %r
4518                    address which alias expands to
4519
4520              %t
4521                    character which indicates if the alias is tagged for inclusion
4522
4523        _\b7_\b._\b4_\b._\b7  _\ba_\bl_\bl_\bo_\bw_\b__\b8_\bb_\bi_\bt
4524
4525        Type: boolean
4526
4527        Default: yes
4528
4529        Controls whether 8-bit data is converted to 7-bit using either quoted-printable
4530        or base64 encoding when sending mail.
4531
4532        _\b7_\b._\b4_\b._\b8  _\ba_\bl_\bl_\bo_\bw_\b__\ba_\bn_\bs_\bi
4533
4534        Type: boolean
4535
4536        Default: no
4537
4538        Controls whether ANSI color codes in messages (and color tags in rich text mes-
4539        sages) are to be interpreted.  Messages containing these codes are rare, but if
4540        this option is set, their text will be colored accordingly. Note that this may
4541        override your color choices, and even present a security problem, since a mes-
4542        sage could include a line like ``[-- PGP output follows ...' and give it the
4543        same color as your attachment color.
4544
4545        _\b7_\b._\b4_\b._\b9  _\ba_\br_\br_\bo_\bw_\b__\bc_\bu_\br_\bs_\bo_\br
4546
4547        Type: boolean
4548
4549        Default: no
4550
4551        When _\bs_\be_\bt, an arrow (``->'') will be used to indicate the current entry in menus
4552        instead of highlighting the whole line.  On slow network or modem links this
4553        will make response faster because there is less that has to be redrawn on the
4554        screen when moving to the next or previous entries in the menu.
4555
4556        The Mutt Next Generation E-Mail Client                                       91
4557
4558        _\b7_\b._\b4_\b._\b1_\b0  _\ba_\bs_\bc_\bi_\bi_\b__\bc_\bh_\ba_\br_\bs
4559
4560        Type: boolean
4561
4562        Default: no
4563
4564        If _\bs_\be_\bt, Mutt-ng will use plain ASCII characters when displaying thread and
4565        attachment trees, instead of the default ACS characters.
4566
4567        _\b7_\b._\b4_\b._\b1_\b1  _\ba_\bs_\bk_\bb_\bc_\bc
4568
4569        Type: boolean
4570
4571        Default: no
4572
4573        If _\bs_\be_\bt, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before
4574        editing an outgoing message.
4575
4576        _\b7_\b._\b4_\b._\b1_\b2  _\ba_\bs_\bk_\bc_\bc
4577
4578        Type: boolean
4579
4580        Default: no
4581
4582        If _\bs_\be_\bt, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing
4583        the body of an outgoing message.
4584
4585        _\b7_\b._\b4_\b._\b1_\b3  _\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4586
4587        Type: string
4588
4589        Default: 'us-ascii'
4590
4591        This variable is a colon-separated list of character encoding schemes for mes-
4592        sages without character encoding indication.  Header field values and message
4593        body content without character encoding indication would be assumed that they
4594        are written in one of this list.  By default, all the header fields and message
4595        body without any charset indication are assumed to be in us-ascii.
4596
4597        For example, Japanese users might prefer this:
4598
4599        set assumed_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
4600
4601        However, only the first content is valid for the message body.  This variable
4602        is valid only if _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be (section 7.4.318  , page 167) is unset.
4603
4604        _\b7_\b._\b4_\b._\b1_\b4  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bf_\bo_\br_\bm_\ba_\bt
4605
4606        Type: string
4607
4608        Default: '%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] '
4609
4610        This variable describes the format of the ``attachment'' menu.  The following
4611        printf(3)-style sequences are understood:
4612
4613        The Mutt Next Generation E-Mail Client                                       92
4614
4615              %C
4616                    charset
4617
4618              %c
4619                    requires charset conversion (n or c)
4620
4621              %D
4622                    deleted flag
4623
4624              %d
4625                    description
4626
4627              %e
4628                    MIME Content-Transfer-Encoding: header field
4629
4630              %f
4631                    filename
4632
4633              %I
4634                    MIME Content-Disposition: header field (I=inline, A=attachment)
4635
4636              %m
4637                    major MIME type
4638
4639              %M
4640                    MIME subtype
4641
4642              %n
4643                    attachment number
4644
4645              %s
4646                    size
4647
4648              %t
4649                    tagged flag
4650
4651              %T
4652                    graphic tree characters
4653
4654              %u
4655                    unlink (=to delete) flag
4656
4657              %>X
4658                    right justify the rest of the string and pad with character 'X'
4659
4660              %|X
4661                    pad to the end of the line with character 'X'
4662
4663        _\b7_\b._\b4_\b._\b1_\b5  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\br_\be_\bm_\bi_\bn_\bd_\b__\br_\be_\bg_\be_\bx_\bp
4664
4665        Type: regular expression
4666
4667        Default: 'attach'
4668
4669        The Mutt Next Generation E-Mail Client                                       93
4670
4671        If this variable is non-empty, muttng will scan a message's contents before
4672        sending for this regular expression. If it is found, it will ask for what to do
4673        depending on the setting of _\b$_\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\ba_\bt_\bt_\ba_\bc_\bh (section 7.4.1  , page 88).
4674
4675        This variable and _\b$_\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\ba_\bt_\bt_\ba_\bc_\bh (section 7.4.1  , page 88) are intended to
4676        remind the user to attach files if the message's text references them.
4677
4678        _\b7_\b._\b4_\b._\b1_\b6  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp
4679
4680        Type: string
4681
4682        Default: '\n'
4683
4684        The separator to add between attachments when operating (saving, printing, pip-
4685        ing, etc) on a list of tagged attachments.
4686
4687        _\b7_\b._\b4_\b._\b1_\b7  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\bp_\bl_\bi_\bt
4688
4689        Type: boolean
4690
4691        Default: yes
4692
4693        If this variable is _\bu_\bn_\bs_\be_\bt, when operating (saving, printing, piping, etc) on a
4694        list of tagged attachments, Mutt-ng will concatenate the attachments and will
4695        operate on them as a single attachment. The ``_\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp (section 7.4.16  ,
4696        page 93)'' separator is added after each attachment. When _\bs_\be_\bt, Mutt-ng will
4697        operate on the attachments one by one.
4698
4699        _\b7_\b._\b4_\b._\b1_\b8  _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn
4700
4701        Type: string
4702
4703        Default: 'On %d, %n wrote:'
4704
4705        This is the string that will precede a message which has been included in a
4706        reply.  For a full listing of defined printf(3)-like sequences see the section
4707        on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''.
4708
4709        _\b7_\b._\b4_\b._\b1_\b9  _\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg
4710
4711        Type: boolean
4712
4713        Default: no
4714
4715        When _\bs_\be_\bt, functions in the _\bi_\bn_\bd_\be_\bx menu which affect a message will be applied to
4716        all tagged messages (if there are any).  When unset, you must first use the
4717        ``tag-prefix'' function (default: ';') to make the next function apply to all
4718        tagged messages.
4719
4720        _\b7_\b._\b4_\b._\b2_\b0  _\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt
4721
4722        Type: boolean
4723
4724        Default: no
4725
4726        The Mutt Next Generation E-Mail Client                                       94
4727
4728        When _\bs_\be_\bt along with ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102)'', Mutt-ng
4729        will skip the initial send-menu and allow you to immediately begin editing the
4730        body of your message.  The send-menu may still be accessed once you have fin-
4731        ished editing the body of your message.
4732
4733        Also see ``_\b$_\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by (section 7.4.66  , page 104)''.
4734
4735        _\b7_\b._\b4_\b._\b2_\b1  _\bb_\be_\be_\bp
4736
4737        Type: boolean
4738
4739        Default: yes
4740
4741        When this variable is _\bs_\be_\bt, Mutt-ng will beep when an error occurs.
4742
4743        _\b7_\b._\b4_\b._\b2_\b2  _\bb_\be_\be_\bp_\b__\bn_\be_\bw
4744
4745        Type: boolean
4746
4747        Default: no
4748
4749        When this variable is _\bs_\be_\bt, Mutt-ng will beep whenever it prints a message noti-
4750        fying you of new mail.  This is independent of the setting of the ``_\b$_\bb_\be_\be_\bp (sec-
4751        tion 7.4.21  , page 94)'' variable.
4752
4753        _\b7_\b._\b4_\b._\b2_\b3  _\bb_\bo_\bu_\bn_\bc_\be
4754
4755        Type: quadoption
4756
4757        Default: ask-yes
4758
4759        Controls whether you will be asked to confirm bouncing messages.  If set to _\by_\be_\bs
4760        you don't get asked if you want to bounce a message. Setting this variable to
4761        _\bn_\bo is not generally useful, and thus not recommended, because you are unable to
4762        bounce messages.
4763
4764        _\b7_\b._\b4_\b._\b2_\b4  _\bb_\bo_\bu_\bn_\bc_\be_\b__\bd_\be_\bl_\bi_\bv_\be_\br_\be_\bd
4765
4766        Type: boolean
4767
4768        Default: yes
4769
4770        When this variable is _\bs_\be_\bt, Mutt-ng will include Delivered-To: header fields
4771        when bouncing messages.  Postfix users may wish to _\bu_\bn_\bs_\be_\bt this variable.
4772
4773        _\b7_\b._\b4_\b._\b2_\b5  _\bb_\br_\ba_\bi_\bl_\bl_\be_\b__\bf_\br_\bi_\be_\bn_\bd_\bl_\by
4774
4775        Type: boolean
4776
4777        Default: no
4778
4779        When this variable is set, mutt will place the cursor at the beginning of the
4780        current line in menus, even when the arrow_cursor variable is unset, making it
4781        easier for blind persons using Braille displays to follow these menus.  The
4782
4783        The Mutt Next Generation E-Mail Client                                       95
4784
4785        option is disabled by default because many visual terminals don't permit making
4786        the cursor invisible.
4787
4788        _\b7_\b._\b4_\b._\b2_\b6  _\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\b__\bf_\bi_\bl_\be
4789
4790        Type: path
4791
4792        Default: '~/.mutt_certificates'
4793
4794        Availability: SSL or GNUTLS
4795
4796        This variable specifies the file where the certificates you trust are saved.
4797        When an unknown certificate is encountered, you are asked if you accept it or
4798        not. If you accept it, the certificate can also be saved in this file and fur-
4799        ther connections are automatically accepted.
4800
4801        You can also manually add CA certificates in this file. Any server certificate
4802        that is signed with one of these CA certificates are also automatically
4803        accepted.
4804
4805        Example: set certificate_file=~/.muttng/certificates
4806
4807        _\b7_\b._\b4_\b._\b2_\b7  _\bc_\bh_\ba_\br_\bs_\be_\bt
4808
4809        Type: string
4810
4811        Default: ''
4812
4813        Character set your terminal uses to display and enter textual data.
4814
4815        _\b7_\b._\b4_\b._\b2_\b8  _\bc_\bh_\be_\bc_\bk_\b__\bn_\be_\bw
4816
4817        Type: boolean
4818
4819        Default: yes
4820
4821        N\bNo\bot\bte\be:\b: this option only affects _\bm_\ba_\bi_\bl_\bd_\bi_\br and _\bM_\bH style mailboxes.
4822
4823        When _\bs_\be_\bt, Mutt-ng will check for new mail delivered while the mailbox is open.
4824        Especially with MH mailboxes, this operation can take quite some time since it
4825        involves scanning the directory and checking each file to see if it has already
4826        been looked at.  If it's _\bu_\bn_\bs_\be_\bt, no check for new mail is performed while the
4827        mailbox is open.
4828
4829        _\b7_\b._\b4_\b._\b2_\b9  _\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bu_\bn_\br_\be_\ba_\bd
4830
4831        Type: boolean
4832
4833        Default: yes
4834
4835        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not collapse a thread if it contains any unread mes-
4836        sages.
4837
4838        The Mutt Next Generation E-Mail Client                                       96
4839
4840        _\b7_\b._\b4_\b._\b3_\b0  _\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4841
4842        Type: string
4843
4844        Default: '-- Mutt-ng: Compose  [Approx. msg size: %l   Atts: %a]%>-'
4845
4846        Controls the format of the status line displayed in the ``compose'' menu.  This
4847        string is similar to ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.315  , page 164)'', but has
4848        its own set of printf(3)-like sequences:
4849
4850              %a
4851                    total number of attachments
4852
4853              %h
4854                    local hostname
4855
4856              %l
4857                    approximate size (in bytes) of the current message
4858
4859              %v
4860                    Mutt-ng version string
4861
4862        See the text describing the ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.315  , page 164)''
4863        option for more information on how to set ``_\b$_\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.30  ,
4864        page 96)''.
4865
4866        _\b7_\b._\b4_\b._\b3_\b1  _\bc_\bo_\bn_\bf_\bi_\bg_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4867
4868        Type: string
4869
4870        Default: ''
4871
4872        When defined, Mutt-ng will recode commands in rc files from this encoding.
4873
4874        _\b7_\b._\b4_\b._\b3_\b2  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\ba_\bp_\bp_\be_\bn_\bd
4875
4876        Type: boolean
4877
4878        Default: yes
4879
4880        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when appending messages to an
4881        existing mailbox.
4882
4883        _\b7_\b._\b4_\b._\b3_\b3  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\bc_\br_\be_\ba_\bt_\be
4884
4885        Type: boolean
4886
4887        Default: yes
4888
4889        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when saving messages to a mail-
4890        box which does not yet exist before creating it.
4891
4892        _\b7_\b._\b4_\b._\b3_\b4  _\bc_\bo_\bn_\bn_\be_\bc_\bt_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
4893
4894        The Mutt Next Generation E-Mail Client                                       97
4895
4896        Type: number
4897
4898        Default: 30
4899
4900        Causes Mutt-ng to timeout a network connection (for IMAP or POP) after this
4901        many seconds if the connection is not able to be established.  A negative value
4902        causes Mutt-ng to wait indefinitely for the connection to succeed.
4903
4904        _\b7_\b._\b4_\b._\b3_\b5  _\bc_\bo_\bn_\bt_\be_\bn_\bt_\b__\bt_\by_\bp_\be
4905
4906        Type: string
4907
4908        Default: 'text/plain'
4909
4910        Sets the default Content-Type: header field for the body of newly composed mes-
4911        sages.
4912
4913        _\b7_\b._\b4_\b._\b3_\b6  _\bc_\bo_\bp_\by
4914
4915        Type: quadoption
4916
4917        Default: yes
4918
4919        This variable controls whether or not copies of your outgoing messages will be
4920        saved for later references.  Also see ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.237  , page
4921        146)'', ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.248  , page 149)'', ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section
4922        7.4.74  , page 106)'' and ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 38)''.
4923
4924        _\b7_\b._\b4_\b._\b3_\b7  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt
4925
4926        Type: boolean
4927
4928        Default: no
4929
4930        Setting this variable will cause Mutt-ng to always attempt to PGP encrypt out-
4931        going messages.  This is probably only useful in connection to the _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk
4932        command.  It can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when encryption is not
4933        required or signing is requested as well.  If ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section
4934        7.4.284  , page 157)'' is _\bs_\be_\bt, then OpenSSL is used instead to create S/MIME
4935        messages and settings can be overridden by use of the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto
4936        only)
4937
4938        _\b7_\b._\b4_\b._\b3_\b8  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bp_\bg_\bp
4939
4940        Type: boolean
4941
4942        Default: yes
4943
4944        This variable controls whether or not Mutt-ng may automatically enable PGP
4945        encryption/signing for messages.  See also ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt (section
4946        7.4.37  , page 97)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 7.4.41  , page 98)'',
4947        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 7.4.39  , page 97)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
4948        7.4.42  , page 98)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.284  , page 157)''.
4949
4950        The Mutt Next Generation E-Mail Client                                       98
4951
4952        _\b7_\b._\b4_\b._\b3_\b9  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn
4953
4954        Type: boolean
4955
4956        Default: no
4957
4958        Setting this variable will cause Mutt-ng to always attempt to cryptographically
4959        sign outgoing messages.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when
4960        signing is not required or encryption is requested as well. If
4961        ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.284  , page 157)'' is _\bs_\be_\bt, then OpenSSL is
4962        used instead to create S/MIME messages and settings can be overridden by use of
4963        the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto only)
4964
4965        _\b7_\b._\b4_\b._\b4_\b0  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bm_\bi_\bm_\be
4966
4967        Type: boolean
4968
4969        Default: yes
4970
4971        This variable controls whether or not Mutt-ng may automatically enable S/MIME
4972        encryption/signing for messages. See also ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt (section
4973        7.4.37  , page 97)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 7.4.41  , page 98)'',
4974        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 7.4.39  , page 97)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
4975        7.4.42  , page 98)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.284  , page 157)''.
4976
4977        _\b7_\b._\b4_\b._\b4_\b1  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt
4978
4979        Type: boolean
4980
4981        Default: yes
4982
4983        If _\bs_\be_\bt, automatically PGP or OpenSSL encrypt replies to messages which are
4984        encrypted.  (Crypto only)
4985
4986        _\b7_\b._\b4_\b._\b4_\b2  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn
4987
4988        Type: boolean
4989
4990        Default: no
4991
4992        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are signed.
4993
4994        N\bNo\bot\bte\be:\b: this does not work on messages that are encrypted a\ban\bnd\bd signed!  (Crypto
4995        only)
4996
4997        _\b7_\b._\b4_\b._\b4_\b3  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn_\be_\bn_\bc_\br_\by_\bp_\bt_\be_\bd
4998
4999        Type: boolean
5000
5001        Default: no
5002
5003        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are
5004        encrypted. This makes sense in combination with ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section
5005        7.4.41  , page 98)'', because it allows you to sign all messages which are
5006
5007        The Mutt Next Generation E-Mail Client                                       99
5008
5009        automatically encrypted.  This works around the problem noted in
5010        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section 7.4.42  , page 98)'', that Mutt-ng is not able to
5011        find out whether an encrypted message is also signed.  (Crypto only)
5012
5013        _\b7_\b._\b4_\b._\b4_\b4  _\bc_\br_\by_\bp_\bt_\b__\bt_\bi_\bm_\be_\bs_\bt_\ba_\bm_\bp
5014
5015        Type: boolean
5016
5017        Default: yes
5018
5019        If _\bs_\be_\bt, Mutt-ng will include a time stamp in the lines surrounding PGP or
5020        S/MIME output, so spoofing such lines is more difficult.  If you are using col-
5021        ors to mark these lines, and rely on these, you may _\bu_\bn_\bs_\be_\bt this setting.
5022        (Crypto only)
5023
5024        _\b7_\b._\b4_\b._\b4_\b5  _\bc_\br_\by_\bp_\bt_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\bm_\be
5025
5026        Type: boolean
5027
5028        Default: no
5029
5030        This variable controls the use the GPGME enabled crypto backends.  If it is _\bs_\be_\bt
5031        and Mutt-ng was build with gpgme support, the gpgme code for S/MIME and PGP
5032        will be used instead of the classic code.
5033
5034        N\bNo\bot\bte\be: You need to use this option in your .muttngrc configuration file as it
5035        won't have any effect when used interactively.
5036
5037        _\b7_\b._\b4_\b._\b4_\b6  _\bc_\br_\by_\bp_\bt_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bs_\bi_\bg
5038
5039        Type: quadoption
5040
5041        Default: yes
5042
5043        If ``_\by_\be_\bs'', always attempt to verify PGP or S/MIME signatures.  If ``_\ba_\bs_\bk'', ask
5044        whether or not to verify the signature.  If ``_\bn_\bo'', never attempt to verify
5045        cryptographic signatures.  (Crypto only)
5046
5047        _\b7_\b._\b4_\b._\b4_\b7  _\bd_\ba_\bt_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
5048
5049        Type: string
5050
5051        Default: '!%a, %b %d, %Y at %I:%M:%S%p %Z'
5052
5053        This variable controls the format of the date printed by the ``%d'' sequence in
5054        ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''.  This is passed to strftime(3)
5055        to process the date.
5056
5057        Unless the first character in the string is a bang (``!''), the month and week
5058        day names are expanded according to the locale specified in the variable
5059        ``_\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.120  , page 119)''. If the first character in the string
5060        is a bang, the bang is discarded, and the month and week day names in the rest
5061        of the string are expanded in the _\bC locale (that is in US English).
5062
5063        The Mutt Next Generation E-Mail Client                                      100
5064
5065        _\b7_\b._\b4_\b._\b4_\b8  _\bd_\be_\bb_\bu_\bg_\b__\bl_\be_\bv_\be_\bl
5066
5067        Type: number
5068
5069        Default: 0
5070
5071        Availability: debug
5072
5073        This variable specifies the current debug level and may be used to increase or
5074        decrease the verbosity level during runtime. It overrides the level given with
5075        the -d command line option.
5076
5077        Currently, this number must be >= 0 and <= 5 and muttng must be started with -d
5078        to enable debugging at all; enabling at runtime is not possible.
5079
5080        _\b7_\b._\b4_\b._\b4_\b9  _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk
5081
5082        Type: string
5083
5084        Default: '~f %s !~P | (~P ~C %s)'
5085
5086        This variable controls how send-hooks, message-hooks, save-hooks, and fcc-hooks
5087        will be interpreted if they are specified with only a simple regexp, instead of
5088        a matching pattern.  The hooks are expanded when they are declared, so a hook
5089        will be interpreted according to the value of this variable at the time the
5090        hook is declared.  The default value matches if the message is either from a
5091        user matching the regular expression given, or if it is from you (if the from
5092        address matches ``alternates'') and is to or cc'ed to a user matching the given
5093        regular expression.
5094
5095        _\b7_\b._\b4_\b._\b5_\b0  _\bd_\be_\bl_\be_\bt_\be
5096
5097        Type: quadoption
5098
5099        Default: ask-yes
5100
5101        Controls whether or not messages are really deleted when closing or synchroniz-
5102        ing a mailbox.  If set to _\by_\be_\bs, messages marked for deleting will automatically
5103        be purged without prompting.  If set to _\bn_\bo, messages marked for deletion will
5104        be kept in the mailbox.
5105
5106        _\b7_\b._\b4_\b._\b5_\b1  _\bd_\be_\bl_\be_\bt_\be_\b__\bs_\bp_\ba_\bc_\be
5107
5108        Type: boolean
5109
5110        Default: no
5111
5112        When sending messages with format=flowed by _\bs_\be_\bt_\bt_\bi_\bn_\bg the _\b$_\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd (section
5113        7.4.324  , page 168) variable, this variable specifies whether to also set the
5114        DelSp parameter to yes. If this is _\bu_\bn_\bs_\be_\bt, no additional parameter will be send
5115        as a value of no already is the default behavior.
5116
5117        N\bNo\bot\bte\be:\b: this variable only has an effect on _\bo_\bu_\bt_\bg_\bo_\bi_\bn_\bg messages (if _\b$_\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd
5118        (section 7.4.324  , page 168) is _\bs_\be_\bt) but not on incomming.
5119
5120        The Mutt Next Generation E-Mail Client                                      101
5121
5122        _\b7_\b._\b4_\b._\b5_\b2  _\bd_\be_\bl_\be_\bt_\be_\b__\bu_\bn_\bt_\ba_\bg
5123
5124        Type: boolean
5125
5126        Default: yes
5127
5128        If this option is _\bs_\be_\bt, Mutt-ng will untag messages when marking them for dele-
5129        tion.  This applies when you either explicitly delete a message, or when you
5130        save it to another folder.
5131
5132        _\b7_\b._\b4_\b._\b5_\b3  _\bd_\bi_\bg_\be_\bs_\bt_\b__\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be
5133
5134        Type: boolean
5135
5136        Default: yes
5137
5138        If this option is _\bs_\be_\bt, Mutt-ng's received-attachments menu will not show the
5139        subparts of individual messages in a multipart/digest.  To see these subparts,
5140        press 'v' on that menu.
5141
5142        _\b7_\b._\b4_\b._\b5_\b4  _\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br
5143
5144        Type: path
5145
5146        Default: ''
5147
5148        When _\bs_\be_\bt, specifies a command used to filter messages.  When a message is
5149        viewed it is passed as standard input to _\b$_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br (section 7.4.54  ,
5150        page 101), and the filtered message is read from the standard output.
5151
5152        _\b7_\b._\b4_\b._\b5_\b5  _\bd_\bo_\bt_\bl_\bo_\bc_\bk_\b__\bp_\br_\bo_\bg_\br_\ba_\bm
5153
5154        Type: path
5155
5156        Default: '/opt/freebsd4/mutt-ng/bin/muttng_dotlock'
5157
5158        Availability: Standalone and Dotlock
5159
5160        Contains the path of the muttng_dotlock(1) binary to be used by Mutt-ng.
5161
5162        _\b7_\b._\b4_\b._\b5_\b6  _\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by
5163
5164        Type: string
5165
5166        Default: ''
5167
5168        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
5169        or in connection with the SMTP support via libESMTP.
5170
5171        This variable sets the request for when notification is returned.  The string
5172        consists of a comma separated list (no spaces!) of one or more of the follow-
5173        ing: _\bn_\be_\bv_\be_\br, to never request notification, _\bf_\ba_\bi_\bl_\bu_\br_\be, to request notification on
5174        transmission failure, _\bd_\be_\bl_\ba_\by, to be notified of message delays, _\bs_\bu_\bc_\bc_\be_\bs_\bs, to be
5175        notified of successful transmission.
5176
5177        The Mutt Next Generation E-Mail Client                                      102
5178
5179        Example: set dsn_notify='failure,delay'
5180
5181        _\b7_\b._\b4_\b._\b5_\b7  _\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn
5182
5183        Type: string
5184
5185        Default: ''
5186
5187        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
5188        or in connection with the SMTP support via libESMTP.
5189
5190        This variable controls how much of your message is returned in DSN messages.
5191        It may be set to either _\bh_\bd_\br_\bs to return just the message header, or _\bf_\bu_\bl_\bl to
5192        return the full message.
5193
5194        Example: set dsn_return=hdrs
5195
5196        _\b7_\b._\b4_\b._\b5_\b8  _\bd_\bu_\bp_\bl_\bi_\bc_\ba_\bt_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
5197
5198        Type: boolean
5199
5200        Default: yes
5201
5202        This variable controls whether Mutt-ng, when sorting by threads, threads mes-
5203        sages with the same Message-Id: header field together.  If it is _\bs_\be_\bt, it will
5204        indicate that it thinks they are duplicates of each other with an equals sign
5205        in the thread diagram.
5206
5207        _\b7_\b._\b4_\b._\b5_\b9  _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5208
5209        Type: boolean
5210
5211        Default: no
5212
5213        This option allows you to edit the header of your outgoing messages along with
5214        the body of your message.
5215
5216        Which empty header fields to show is controlled by the _\b$_\be_\bd_\bi_\bt_\bo_\br_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section
5217        7.4.61  , page 102) option.
5218
5219        _\b7_\b._\b4_\b._\b6_\b0  _\be_\bd_\bi_\bt_\bo_\br
5220
5221        Type: path
5222
5223        Default: ''
5224
5225        This variable specifies which editor is used by Mutt-ng.  It defaults to the
5226        value of the $VISUAL, or $EDITOR, environment variable, or to the string 'vi'
5227        if neither of those are set.
5228
5229        _\b7_\b._\b4_\b._\b6_\b1  _\be_\bd_\bi_\bt_\bo_\br_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5230
5231        Type: string
5232
5233        The Mutt Next Generation E-Mail Client                                      103
5234
5235        Default: 'From: To: Cc: Bcc: Subject: Reply-To: Newsgroups: Followup-To: X-Com-
5236        ment-To:'
5237
5238        If _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102) is _\bs_\be_\bt, this space-separated list
5239        specifies which _\bn_\bo_\bn_\b-_\be_\bm_\bp_\bt_\by header fields to edit in addition to user-defined
5240        headers.
5241
5242        Note: if _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102) had to be turned on by
5243        force because _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo (section 7.4.317  , page 167) is _\bu_\bn_\bs_\be_\bt, this
5244        option has no effect.
5245
5246        _\b7_\b._\b4_\b._\b6_\b2  _\be_\bn_\bc_\bo_\bd_\be_\b__\bf_\br_\bo_\bm
5247
5248        Type: boolean
5249
5250        Default: no
5251
5252        When _\bs_\be_\bt, Mutt-ng will quoted-printable encode messages when they contain the
5253        string ``From '' (note the trailing space) in the beginning of a line. Useful
5254        to avoid the tampering certain mail delivery and transport agents tend to do
5255        with messages.
5256
5257        N\bNo\bot\bte\be:\b: as mutt-ng currently violates RfC3676 defining format=flowed, it's
5258        <em/strongly/ advised to _\bs_\be_\bt this option although discouraged by the standard.
5259        Alternatively, you must take care of space-stuffing <tt/From / lines (with a
5260        trailing space) yourself.
5261
5262        _\b7_\b._\b4_\b._\b6_\b3  _\be_\bn_\bt_\br_\bo_\bp_\by_\b__\bf_\bi_\bl_\be
5263
5264        Type: path
5265
5266        Default: ''
5267
5268        Availability: SSL
5269
5270        The file which includes random data that is used to initialize SSL library
5271        functions.
5272
5273        _\b7_\b._\b4_\b._\b6_\b4  _\be_\bn_\bv_\be_\bl_\bo_\bp_\be_\b__\bf_\br_\bo_\bm
5274
5275        Type: boolean
5276
5277        Default: no
5278
5279        When _\bs_\be_\bt, Mutt-ng will try to derive the message's _\be_\bn_\bv_\be_\bl_\bo_\bp_\be sender from the
5280        ``From:'' header field. Note that this information is passed to the sendmail
5281        command using the ``-f' command line switch, so don't set this option if you
5282        are using that switch in _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.254  , page 150) yourself, or
5283        if the sendmail on your machine doesn't support that command line switch.
5284
5285        _\b7_\b._\b4_\b._\b6_\b5  _\be_\bs_\bc_\ba_\bp_\be
5286
5287        Type: string
5288
5289        The Mutt Next Generation E-Mail Client                                      104
5290
5291        Default: '~'
5292
5293        Escape character to use for functions in the builtin editor.
5294
5295        _\b7_\b._\b4_\b._\b6_\b6  _\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5296
5297        Type: boolean
5298
5299        Default: no
5300
5301        When _\bs_\be_\bt, the initial prompt for recipients and subject are skipped when reply-
5302        ing to messages, and the initial prompt for subject is skipped when forwarding
5303        messages.
5304
5305        N\bNo\bot\bte\be:\b: this variable has no effect when the ``_\b$_\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt (section 7.4.20  , page
5306        93)'' variable is _\bs_\be_\bt.
5307
5308        _\b7_\b._\b4_\b._\b6_\b7  _\bf_\bc_\bc_\b__\ba_\bt_\bt_\ba_\bc_\bh
5309
5310        Type: boolean
5311
5312        Default: yes
5313
5314        This variable controls whether or not attachments on outgoing messages are
5315        saved along with the main body of your message.
5316
5317        _\b7_\b._\b4_\b._\b6_\b8  _\bf_\bc_\bc_\b__\bc_\bl_\be_\ba_\br
5318
5319        Type: boolean
5320
5321        Default: no
5322
5323        When this variable is _\bs_\be_\bt, FCCs will be stored unencrypted and unsigned, even
5324        when the actual message is encrypted and/or signed.  (PGP only)
5325
5326        _\b7_\b._\b4_\b._\b6_\b9  _\bf_\bi_\bl_\be_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
5327
5328        Type: string
5329
5330        Default: ''
5331
5332        This variable is a colon-separated list of character encoding schemes for text
5333        file attatchments.  If _\bu_\bn_\bs_\be_\bt, _\b$_\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.27  , page 95) value will
5334        be used instead.  For example, the following configuration would work for
5335        Japanese text handling:
5336
5337        set file_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
5338
5339        Note: ``iso-2022-*'' must be put at the head of the value as shown above if
5340        included.
5341
5342        _\b7_\b._\b4_\b._\b7_\b0  _\bf_\bo_\bl_\bd_\be_\br
5343
5344        Type: path
5345
5346        The Mutt Next Generation E-Mail Client                                      105
5347
5348        Default: '~/Mail'
5349
5350        Specifies the default location of your mailboxes.  A ``+'' or ``='' at the
5351        beginning of a pathname will be expanded to the value of this variable.  Note
5352        that if you change this variable from the default value you need to make sure
5353        that the assignment occurs _\bb_\be_\bf_\bo_\br_\be you use ``+'' or ``='' for any other vari-
5354        ables since expansion takes place during the ``set'' command.
5355
5356        _\b7_\b._\b4_\b._\b7_\b1  _\bf_\bo_\bl_\bd_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
5357
5358        Type: string
5359
5360        Default: '%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f'
5361
5362        This variable allows you to customize the file browser display to your personal
5363        taste.  This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page
5364        115)'', but has its own set of printf(3)-like sequences:
5365
5366              %C
5367                    current file number
5368
5369              %d
5370                    date/time folder was last modified
5371
5372              %f
5373                    filename
5374
5375              %F
5376                    file permissions
5377
5378              %g
5379                    group name (or numeric gid, if missing)
5380
5381              %l
5382                    number of hard links
5383
5384              %N
5385                    N if folder has new mail, blank otherwise
5386
5387              %s
5388                    size in bytes
5389
5390              %t
5391                    * if the file is tagged, blank otherwise
5392
5393              %u
5394                    owner name (or numeric uid, if missing)
5395
5396              %>X
5397                    right justify the rest of the string and pad with character 'X'
5398
5399              %|X
5400                    pad to the end of the line with character 'X'
5401
5402        The Mutt Next Generation E-Mail Client                                      106
5403
5404        _\b7_\b._\b4_\b._\b7_\b2  _\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5405
5406        Type: boolean
5407
5408        Default: yes
5409
5410        Controls whether or not the Mail-Followup-To: header field is generated when
5411        sending mail.  When _\bs_\be_\bt, Mutt-ng will generate this field when you are replying
5412        to a known mailing list, specified with the ``subscribe'' or ``_\bl_\bi_\bs_\bt_\bs (section
5413        3.13  , page 35)'' commands or detected by common mailing list headers.
5414
5415        This field has two purposes.  First, preventing you from receiving duplicate
5416        copies of replies to messages which you send to mailing lists. Second, ensuring
5417        that you do get a reply separately for any messages sent to known lists to
5418        which you are not subscribed.  The header will contain only the list's address
5419        for subscribed lists, and both the list address and your own email address for
5420        unsubscribed lists.  Without this header, a group reply to your message sent to
5421        a subscribed list will be sent to both the list and your address, resulting in
5422        two copies of the same email for you.
5423
5424        _\b7_\b._\b4_\b._\b7_\b3  _\bf_\bo_\br_\bc_\be_\b__\bb_\bu_\bf_\bf_\by_\b__\bc_\bh_\be_\bc_\bk
5425
5426        Type: boolean
5427
5428        Default: no
5429
5430        When _\bs_\be_\bt, it causes Mutt-ng to check for new mail when the _\bb_\bu_\bf_\bf_\by_\b-_\bl_\bi_\bs_\bt command
5431        is invoked. When _\bu_\bn_\bs_\be_\bt, _\bb_\bu_\bf_\bf_\by_\b__\bl_\bi_\bs_\bt will just list all mailboxes which are
5432        already known to have new mail.
5433
5434        Also see the following variables: ``_\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.328  , page 169)'',
5435        ``_\b$_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.121  , page 119)'' and ``_\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section
5436        7.4.105  , page 113)''.
5437
5438        _\b7_\b._\b4_\b._\b7_\b4  _\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be
5439
5440        Type: boolean
5441
5442        Default: no
5443
5444        This variable is similar to ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.248  , page 149)'',
5445        except that Mutt-ng will store a copy of your outgoing message by the username
5446        of the address you are sending to even if that mailbox does not exist.
5447
5448        Also see the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.237  , page 146)'' variable.
5449
5450        _\b7_\b._\b4_\b._\b7_\b5  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
5451
5452        Type: boolean
5453
5454        Default: yes
5455
5456        Controls the decoding of complex MIME messages into text/plain when forwarding
5457        a message.  The message header is also RFC2047 decoded.  This variable is only
5458
5459        The Mutt Next Generation E-Mail Client                                      107
5460
5461        used, if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.143  , page 123)'' is _\bu_\bn_\bs_\be_\bt, otherwise
5462        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.144  , page 123)'' is used instead.
5463
5464        _\b7_\b._\b4_\b._\b7_\b6  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\br_\by_\bp_\bt
5465
5466        Type: boolean
5467
5468        Default: yes
5469
5470        Controls the handling of encrypted messages when forwarding a message.  When
5471        _\bs_\be_\bt, the outer layer of encryption is stripped off.  This variable is only used
5472        if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.143  , page 123)'' is _\bs_\be_\bt and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
5473        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.144  , page 123)'' is _\bu_\bn_\bs_\be_\bt.  (PGP only)
5474
5475        _\b7_\b._\b4_\b._\b7_\b7  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\be_\bd_\bi_\bt
5476
5477        Type: quadoption
5478
5479        Default: yes
5480
5481        This quadoption controls whether or not the user is automatically placed in the
5482        editor when forwarding messages.  For those who always want to forward with no
5483        modification, use a setting of _\bn_\bo.
5484
5485        _\b7_\b._\b4_\b._\b7_\b8  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
5486
5487        Type: string
5488
5489        Default: '[%a: %s]'
5490
5491        This variable controls the default subject when forwarding a message.  It uses
5492        the same format sequences as the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page
5493        115)'' variable.
5494
5495        _\b7_\b._\b4_\b._\b7_\b9  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bq_\bu_\bo_\bt_\be
5496
5497        Type: boolean
5498
5499        Default: no
5500
5501        When _\bs_\be_\bt forwarded messages included in the main body of the message (when
5502        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.143  , page 123)'' is _\bu_\bn_\bs_\be_\bt) will be quoted using
5503        ``_\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.115  , page 115)''.
5504
5505        _\b7_\b._\b4_\b._\b8_\b0  _\bf_\br_\bo_\bm
5506
5507        Type: e-mail address
5508
5509        Default: ''
5510
5511        This variable contains a default from address.  It can be overridden using
5512        my_hdr (including from send-hooks) and ``_\b$_\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.243  , page
5513        147)''.  This variable is ignored if ``_\b$_\bu_\bs_\be_\b__\bf_\br_\bo_\bm (section 7.4.337  , page
5514        171)'' is unset.
5515
5516        The Mutt Next Generation E-Mail Client                                      108
5517
5518        E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar
5519        <foo@bar.fb>' when replying to the mutt-ng developer's mailing list and Mutt-ng
5520        takes this email address.
5521
5522        Defaults to the contents of the environment variable $EMAIL.
5523
5524        _\b7_\b._\b4_\b._\b8_\b1  _\bg_\be_\bc_\bo_\bs_\b__\bm_\ba_\bs_\bk
5525
5526        Type: regular expression
5527
5528        Default: '^[^,]*'
5529
5530        A regular expression used by Mutt-ng to parse the GECOS field of a password
5531        entry when expanding the alias.  By default the regular expression is set to
5532        ``^[^,]*'' which will return the string up to the first ``,'' encountered.  If
5533        the GECOS field contains a string like 'lastname, firstname' then you should
5534        do: set gecos_mask='.*'.
5535
5536        This can be useful if you see the following behavior: you address a e-mail to
5537        user ID stevef whose full name is Steve Franklin.  If Mutt-ng expands stevef to
5538        ``Franklin'' stevef@foo.bar then you should set the gecos_mask to a regular
5539        expression that will match the whole name so Mutt-ng will expand ``Franklin''
5540        to ``Franklin, Steve''.
5541
5542        _\b7_\b._\b4_\b._\b8_\b2  _\bh_\bd_\br_\bs
5543
5544        Type: boolean
5545
5546        Default: yes
5547
5548        When _\bu_\bn_\bs_\be_\bt, the header fields normally added by the ``_\bm_\by_\b__\bh_\bd_\br (section 3.16  ,
5549        page 37)'' command are not created.  This variable _\bm_\bu_\bs_\bt be _\bu_\bn_\bs_\be_\bt before compos-
5550        ing a new message or replying in order to take effect.  If _\bs_\be_\bt, the user
5551        defined header fields are added to every new message.
5552
5553        _\b7_\b._\b4_\b._\b8_\b3  _\bh_\be_\ba_\bd_\be_\br
5554
5555        Type: boolean
5556
5557        Default: no
5558
5559        When _\bs_\be_\bt, this variable causes Mutt-ng to include the header of the message you
5560        are replying to into the edit buffer.  The ``_\b$_\bw_\be_\be_\bd (section 7.4.342  , page
5561        172)'' setting applies.
5562
5563        _\b7_\b._\b4_\b._\b8_\b4  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be
5564
5565        Type: path
5566
5567        Default: ''
5568
5569        Availability: Header Cache
5570
5571        The _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 7.4.84  , page 108) variable points to the header
5572
5573        The Mutt Next Generation E-Mail Client                                      109
5574
5575        cache database.
5576
5577        If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 7.4.84  , page 108) points to a directory it will
5578        contain a header cache database  per folder. If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section
5579        7.4.84  , page 108) points to a file that file will be a single global header
5580        cache. By default it is _\bu_\bn_\bs_\be_\bt so no header caching will be used.
5581
5582        _\b7_\b._\b4_\b._\b8_\b5  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be_\b__\bc_\bo_\bm_\bp_\br_\be_\bs_\bs
5583
5584        Type: boolean
5585
5586        Default: no
5587
5588        If enabled the header cache will be compressed. So only one fifth of the usual
5589        diskspace is used, but the uncompression can result in a slower open of the
5590        cached folder.
5591
5592        _\b7_\b._\b4_\b._\b8_\b6  _\bh_\be_\bl_\bp
5593
5594        Type: boolean
5595
5596        Default: yes
5597
5598        When _\bs_\be_\bt, help lines describing the bindings for the major functions provided
5599        by each menu are displayed on the first line of the screen.
5600
5601        N\bNo\bot\bte\be:\b: The binding will not be displayed correctly if the function is bound to a
5602        sequence rather than a single keystroke.  Also, the help line may not be
5603        updated if a binding is changed while Mutt-ng is running.  Since this variable
5604        is primarily aimed at new users, neither of these should present a major prob-
5605        lem.
5606
5607        _\b7_\b._\b4_\b._\b8_\b7  _\bh_\bi_\bd_\bd_\be_\bn_\b__\bh_\bo_\bs_\bt
5608
5609        Type: boolean
5610
5611        Default: no
5612
5613        When _\bs_\be_\bt, Mutt-ng will skip the host name part of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section
5614        7.4.95  , page 110)'' variable when adding the domain part to addresses.  This
5615        variable does not affect the generation of Message-ID: header fields, and it
5616        will not lead to the cut-off of first-level domains.
5617
5618        _\b7_\b._\b4_\b._\b8_\b8  _\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5619
5620        Type: boolean
5621
5622        Default: no
5623
5624        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5625        limiting, in the thread tree.
5626
5627        _\b7_\b._\b4_\b._\b8_\b9  _\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5628
5629        The Mutt Next Generation E-Mail Client                                      110
5630
5631        Type: boolean
5632
5633        Default: yes
5634
5635        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages in the thread
5636        tree.
5637
5638        _\b7_\b._\b4_\b._\b9_\b0  _\bh_\bi_\bd_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
5639
5640        Type: boolean
5641
5642        Default: yes
5643
5644        When _\bs_\be_\bt, Mutt-ng will not show the subject of messages in the thread tree that
5645        have the same subject as their parent or closest previously displayed sibling.
5646
5647        _\b7_\b._\b4_\b._\b9_\b1  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5648
5649        Type: boolean
5650
5651        Default: no
5652
5653        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5654        limiting, at the top of threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\b-
5655        _\bi_\bn_\bg (section 7.4.89  , page 109) is set, this option will have no effect.
5656
5657        _\b7_\b._\b4_\b._\b9_\b2  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5658
5659        Type: boolean
5660
5661        Default: yes
5662
5663        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages at the top of
5664        threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd (section 7.4.88  ,
5665        page 109) is _\bs_\be_\bt, this option will have no effect.
5666
5667        _\b7_\b._\b4_\b._\b9_\b3  _\bh_\bi_\bs_\bt_\bo_\br_\by
5668
5669        Type: number
5670
5671        Default: 10
5672
5673        This variable controls the size (in number of strings remembered) of the string
5674        history buffer. The buffer is cleared each time the variable is changed.
5675
5676        _\b7_\b._\b4_\b._\b9_\b4  _\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5677
5678        Type: quadoption
5679
5680        Default: yes
5681
5682        This variable controls whether or not a Mail-Followup-To: header field is hon-
5683        ored when group-replying to a message.
5684
5685        The Mutt Next Generation E-Mail Client                                      111
5686
5687        _\b7_\b._\b4_\b._\b9_\b5  _\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be
5688
5689        Type: string
5690
5691        Default: ''
5692
5693        Specifies the hostname to use after the ``@'' in local e-mail addresses and
5694        during generation of Message-Id: headers.
5695
5696        Please be sure to really know what you are doing when changing this variable to
5697        configure a custom domain part of Message-IDs.
5698
5699        _\b7_\b._\b4_\b._\b9_\b6  _\bi_\bg_\bn_\bo_\br_\be_\b__\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by_\b__\bt_\bo
5700
5701        Type: boolean
5702
5703        Default: no
5704
5705        Affects the behaviour of the _\br_\be_\bp_\bl_\by function when replying to messages from
5706        mailing lists.  When _\bs_\be_\bt, if the ``Reply-To:'' header field is set to the same
5707        value as the ``To:'' header field, Mutt-ng assumes that the ``Reply-To:''
5708        header field was set by the mailing list to automate responses to the list, and
5709        will ignore this field.  To direct a response to the mailing list when this
5710        option is set, use the _\bl_\bi_\bs_\bt_\b-_\br_\be_\bp_\bl_\by function; _\bg_\br_\bo_\bu_\bp_\b-_\br_\be_\bp_\bl_\by will reply to both the
5711        sender and the list.
5712
5713        _\b7_\b._\b4_\b._\b9_\b7  _\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
5714
5715        Type: string
5716
5717        Default: ''
5718
5719        Availability: IMAP
5720
5721        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
5722        use to log in to an IMAP server, in the order Mutt-ng should try them.  Authen-
5723        tication methods are either ``login'' or the right side of an IMAP ``AUTH=''
5724        capability string, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''. This param-
5725        eter is case-insensitive.
5726
5727        If this parameter is _\bu_\bn_\bs_\be_\bt (the default) Mutt-ng will try all available meth-
5728        ods, in order from most-secure to least-secure.
5729
5730        Example: set imap_authenticators='gssapi:cram-md5:login'
5731
5732        N\bNo\bot\bte\be:\b: Mutt-ng will only fall back to other authentication methods if the previ-
5733        ous methods are unavailable. If a method is available but authentication fails,
5734        Mutt-ng will not connect to the IMAP server.
5735
5736        _\b7_\b._\b4_\b._\b9_\b8  _\bi_\bm_\ba_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5737
5738        Type: boolean
5739
5740        Default: no
5741
5742        The Mutt Next Generation E-Mail Client                                      112
5743
5744        When _\bs_\be_\bt, mutt will fetch the set of subscribed folders from your server on
5745        connection, and add them to the set of mailboxes it polls for new mail. See
5746        also the ``_\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.15  , page 36)'' command.
5747
5748        _\b7_\b._\b4_\b._\b9_\b9  _\bi_\bm_\ba_\bp_\b__\bd_\be_\bl_\bi_\bm_\b__\bc_\bh_\ba_\br_\bs
5749
5750        Type: string
5751
5752        Default: '/.'
5753
5754        Availability: IMAP
5755
5756        This contains the list of characters which you would like to treat as folder
5757        separators for displaying IMAP paths. In particular it helps in using the '='
5758        shortcut for your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) variable.
5759
5760        _\b7_\b._\b4_\b._\b1_\b0_\b0  _\bi_\bm_\ba_\bp_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5761
5762        Type: string
5763
5764        Default: ''
5765
5766        Availability: IMAP
5767
5768        Mutt-ng requests these header fields in addition to the default headers (``DATE
5769        FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-
5770        REPLY-TO REPLY-TO LINES X-LABEL'') from IMAP servers before displaying the
5771        ``index'' menu. You may want to add more headers for spam detection.
5772
5773        N\bNo\bot\bte\be:\b: This is a space separated list.
5774
5775        _\b7_\b._\b4_\b._\b1_\b0_\b1  _\bi_\bm_\ba_\bp_\b__\bh_\bo_\bm_\be_\b__\bn_\ba_\bm_\be_\bs_\bp_\ba_\bc_\be
5776
5777        Type: string
5778
5779        Default: ''
5780
5781        Availability: IMAP
5782
5783        You normally want to see your personal folders alongside your INBOX in the IMAP
5784        browser. If you see something else, you may set this variable to the IMAP path
5785        to your folders.
5786
5787        _\b7_\b._\b4_\b._\b1_\b0_\b2  _\bi_\bm_\ba_\bp_\b__\bk_\be_\be_\bp_\ba_\bl_\bi_\bv_\be
5788
5789        Type: number
5790
5791        Default: 900
5792
5793        Availability: IMAP
5794
5795        This variable specifies the maximum amount of time in seconds that Mutt-ng will
5796        wait before polling open IMAP connections, to prevent the server from closing
5797        them before Mutt-ng has finished with them.
5798
5799        The Mutt Next Generation E-Mail Client                                      113
5800
5801        The default is well within the RFC-specified minimum amount of time (30 min-
5802        utes) before a server is allowed to do this, but in practice the RFC does get
5803        violated every now and then.
5804
5805        Reduce this number if you find yourself getting disconnected from your IMAP
5806        server due to inactivity.
5807
5808        _\b7_\b._\b4_\b._\b1_\b0_\b3  _\bi_\bm_\ba_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5809
5810        Type: boolean
5811
5812        Default: no
5813
5814        Availability: IMAP
5815
5816        This variable configures whether IMAP folder browsing will look for only sub-
5817        scribed folders or all folders.  This can be toggled in the IMAP browser with
5818        the _\bt_\bo_\bg_\bg_\bl_\be_\b-_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd function.
5819
5820        _\b7_\b._\b4_\b._\b1_\b0_\b4  _\bi_\bm_\ba_\bp_\b__\bl_\bo_\bg_\bi_\bn
5821
5822        Type: string
5823
5824        Default: ''
5825
5826        Availability: IMAP
5827
5828        Your login name on the IMAP server.
5829
5830        This variable defaults to the value of ``_\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.111  , page
5831        114).''
5832
5833        _\b7_\b._\b4_\b._\b1_\b0_\b5  _\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5834
5835        Type: number
5836
5837        Default: 300
5838
5839        This variable configures how often (in seconds) Mutt-ng should look for new
5840        mail in IMAP folders. This is split from the ``_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.121  ,
5841        page 119)'' variable to generate less traffic and get more accurate information
5842        for local folders.
5843
5844        _\b7_\b._\b4_\b._\b1_\b0_\b6  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs
5845
5846        Type: string
5847
5848        Default: ''
5849
5850        Availability: IMAP
5851
5852        Specifies the password for your IMAP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt
5853        you for your password when you invoke the fetch-mail function.
5854
5855        The Mutt Next Generation E-Mail Client                                      114
5856
5857        W\bWa\bar\brn\bni\bin\bng\bg: you should only use this option when you are on a fairly secure
5858        machine, because the superuser can read your configuration even if you are the
5859        only one who can read the file.
5860
5861        _\b7_\b._\b4_\b._\b1_\b0_\b7  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs_\bi_\bv_\be
5862
5863        Type: boolean
5864
5865        Default: yes
5866
5867        Availability: IMAP
5868
5869        When _\bs_\be_\bt, Mutt-ng will not open new IMAP connections to check for new mail.
5870        Mutt-ng will only check for new mail over existing IMAP connections.  This is
5871        useful if you don't want to be prompted to user/password pairs on Mutt-ng invo-
5872        cation, or if opening the connection is slow.
5873
5874        _\b7_\b._\b4_\b._\b1_\b0_\b8  _\bi_\bm_\ba_\bp_\b__\bp_\be_\be_\bk
5875
5876        Type: boolean
5877
5878        Default: yes
5879
5880        Availability: IMAP
5881
5882        If _\bs_\be_\bt, Mutt-ng will avoid implicitly marking your mail as read whenever you
5883        fetch a message from the server. This is generally a good thing, but can make
5884        closing an IMAP folder somewhat slower. This option exists to appease speed
5885        freaks.
5886
5887        _\b7_\b._\b4_\b._\b1_\b0_\b9  _\bi_\bm_\ba_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
5888
5889        Type: quadoption
5890
5891        Default: ask-yes
5892
5893        Availability: IMAP
5894
5895        Controls whether or not Mutt-ng will try to reconnect to IMAP server when the
5896        connection is lost.
5897
5898        _\b7_\b._\b4_\b._\b1_\b1_\b0  _\bi_\bm_\ba_\bp_\b__\bs_\be_\br_\bv_\be_\br_\bn_\bo_\bi_\bs_\be
5899
5900        Type: boolean
5901
5902        Default: yes
5903
5904        Availability: IMAP
5905
5906        When _\bs_\be_\bt, Mutt-ng will display warning messages from the IMAP server as error
5907        messages. Since these messages are often harmless, or generated due to configu-
5908        ration problems on the server which are out of the users' hands, you may wish
5909        to suppress them at some point.
5910
5911        The Mutt Next Generation E-Mail Client                                      115
5912
5913        _\b7_\b._\b4_\b._\b1_\b1_\b1  _\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br
5914
5915        Type: string
5916
5917        Default: ''
5918
5919        Availability: IMAP
5920
5921        The name of the user whose mail you intend to access on the IMAP server.
5922
5923        This variable defaults to your user name on the local machine.
5924
5925        _\b7_\b._\b4_\b._\b1_\b1_\b2  _\bi_\bm_\bp_\bl_\bi_\bc_\bi_\bt_\b__\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw
5926
5927        Type: boolean
5928
5929        Default: no
5930
5931        If _\bs_\be_\bt, Mutt-ng will look for a mailcap entry with the ``copiousoutput'' flag
5932        set for _\be_\bv_\be_\br_\by MIME attachment it doesn't have an internal viewer defined for.
5933        If such an entry is found, Mutt-ng will use the viewer defined in that entry to
5934        convert the body part to text form.
5935
5936        _\b7_\b._\b4_\b._\b1_\b1_\b3  _\bi_\bn_\bc_\bl_\bu_\bd_\be
5937
5938        Type: quadoption
5939
5940        Default: ask-yes
5941
5942        Controls whether or not a copy of the message(s) you are replying to is
5943        included in your reply.
5944
5945        _\b7_\b._\b4_\b._\b1_\b1_\b4  _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b__\bo_\bn_\bl_\by_\bf_\bi_\br_\bs_\bt
5946
5947        Type: boolean
5948
5949        Default: no
5950
5951        Controls whether or not Mutt-ng includes only the first attachment of the mes-
5952        sage you are replying.
5953
5954        _\b7_\b._\b4_\b._\b1_\b1_\b5  _\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
5955
5956        Type: string
5957
5958        Default: '> '
5959
5960        Specifies the string to prepend to each line of text quoted in a message to
5961        which you are replying.  You are strongly encouraged not to change this value,
5962        as it tends to agitate the more fanatical netizens.
5963
5964        _\b7_\b._\b4_\b._\b1_\b1_\b6  _\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
5965
5966        Type: string
5967
5968        The Mutt Next Generation E-Mail Client                                      116
5969
5970        Default: '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
5971
5972        This variable allows you to customize the message index display to your per-
5973        sonal taste.
5974
5975        ``Format strings'' are similar to the strings used in the ``C'' function
5976        printf(3) to format output (see the man page for more detail).  The following
5977        sequences are defined in Mutt-ng:
5978
5979              %a
5980                    address of the author
5981
5982              %A
5983                    reply-to address (if present; otherwise: address of author)
5984
5985              %b
5986                    filename of the original message folder (think mailBox)
5987
5988              %B
5989                    the list to which the letter was sent, or else the folder name
5990                    (%b).
5991
5992              %c
5993                    number of characters (bytes) in the message
5994
5995              %C
5996                    current message number
5997
5998              %d
5999                    date and time of the message in the format specified by ``date_for-
6000                    mat'' converted to sender's time zone
6001
6002              %D
6003                    date and time of the message in the format specified by ``date_for-
6004                    mat'' converted to the local time zone
6005
6006              %e
6007                    current message number in thread
6008
6009              %E
6010                    number of messages in current thread
6011
6012              %f
6013                    entire From: line (address + real name)
6014
6015              %F
6016                    author name, or recipient name if the message is from you
6017
6018              %H
6019                    spam attribute(s) of this message
6020
6021              %g
6022                    newsgroup name (if compiled with nntp support)
6023
6024        The Mutt Next Generation E-Mail Client                                      117
6025
6026              %i
6027                    message-id of the current message
6028
6029              %l
6030                    number of lines in the message (does not work with maildir, mh, and
6031                    possibly IMAP folders)
6032
6033              %L
6034                    If an address in the To or CC header field matches an address
6035                    defined by the users ``subscribe'' command, this displays 'To
6036                    <list-name>', otherwise the same as %F.
6037
6038              %m
6039                    total number of message in the mailbox
6040
6041              %M
6042                    number of hidden messages if the thread is collapsed.
6043
6044              %N
6045                    message score
6046
6047              %n
6048                    author's real name (or address if missing)
6049
6050              %O
6051                    (_O_riginal save folder)  Where Mutt-ng would formerly have stashed
6052                    the message: list name or recipient name if no list
6053
6054              %s
6055                    subject of the message
6056
6057              %S
6058                    status of the message (N/D/d/!/r/*)
6059
6060              %t
6061                    `to:' field (recipients)
6062
6063              %T
6064                    the appropriate character from the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.330  ,
6065                    page 170) string
6066
6067              %u
6068                    user (login) name of the author
6069
6070              %v
6071                    first name of the author, or the recipient if the message is from
6072                    you
6073
6074              %W
6075                    name of organization of author (`organization:' field)
6076
6077              %y
6078                    `x-label:' field, if present
6079
6080        The Mutt Next Generation E-Mail Client                                      118
6081
6082              %Y
6083                    `x-label' field, if present, and (1) not at part of a thread tree,
6084                    (2) at the top of a thread, or (3) `x-label' is different from pre-
6085                    ceding message's `x-label'.
6086
6087              %Z
6088                    message status flags
6089
6090              %{fmt}
6091                    the date and time of the message is converted to sender's time
6092                    zone, and ``fmt'' is expanded by the library function ``strftime'';
6093                    a leading bang disables locales
6094
6095              %[fmt]
6096                    the date and time of the message is converted to the local time
6097                    zone, and ``fmt'' is expanded by the library function ``strftime'';
6098                    a leading bang disables locales
6099
6100              %(fmt)
6101                    the local date and time when the message was received.  ``fmt'' is
6102                    expanded by the library function ``strftime''; a leading bang dis-
6103                    ables locales
6104
6105              %<fmt>
6106                    the current local time. ``fmt'' is expanded by the library function
6107                    ``strftime''; a leading bang disables locales.
6108
6109              %>X
6110                    right justify the rest of the string and pad with character 'X'
6111
6112              %|X
6113                    pad to the end of the line with character 'X'
6114
6115        See also: ``_\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.330  , page 170)''.
6116
6117        _\b7_\b._\b4_\b._\b1_\b1_\b7  _\bi_\bs_\bp_\be_\bl_\bl
6118
6119        Type: path
6120
6121        Default: 'ispell'
6122
6123        How to invoke ispell (GNU's spell-checking software).
6124
6125        _\b7_\b._\b4_\b._\b1_\b1_\b8  _\bk_\be_\be_\bp_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
6126
6127        Type: boolean
6128
6129        Default: no
6130
6131        If _\bs_\be_\bt, read messages marked as flagged will not be moved from your spool mail-
6132        box to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.131  , page 121)'' mailbox, or as a result of
6133        a ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 36)'' command.
6134
6135        The Mutt Next Generation E-Mail Client                                      119
6136
6137        _\b7_\b._\b4_\b._\b1_\b1_\b9  _\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by
6138
6139        Type: quadoption
6140
6141        Default: no
6142
6143        When _\bs_\be_\bt, address replies to the mailing list the original message came from
6144        (instead to the author only). Setting this option to ``_\ba_\bs_\bk_\b-_\by_\be_\bs'' or ``_\ba_\bs_\bk_\b-_\bn_\bo''
6145        will ask if you really intended to reply to the author only.
6146
6147        _\b7_\b._\b4_\b._\b1_\b2_\b0  _\bl_\bo_\bc_\ba_\bl_\be
6148
6149        Type: string
6150
6151        Default: 'C'
6152
6153        The locale used by strftime(3) to format dates. Legal values are the strings
6154        your system accepts for the locale variable LC_TIME.
6155
6156        _\b7_\b._\b4_\b._\b1_\b2_\b1  _\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6157
6158        Type: number
6159
6160        Default: 5
6161
6162        This variable configures how often (in seconds) Mutt-ng should look for new
6163        mail.
6164
6165        N\bNo\bot\bte\be:\b: This does not apply to IMAP mailboxes, see _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section
6166        7.4.105  , page 113).
6167
6168        _\b7_\b._\b4_\b._\b1_\b2_\b2  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh
6169
6170        Type: string
6171
6172        Default: ''
6173
6174        This variable specifies which files to consult when attempting to display MIME
6175        bodies not directly supported by Mutt-ng.
6176
6177        _\b7_\b._\b4_\b._\b1_\b2_\b3  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be
6178
6179        Type: boolean
6180
6181        Default: yes
6182
6183        If _\bs_\be_\bt, Mutt-ng will restrict possible characters in mailcap % expandos to a
6184        well-defined set of safe characters.  This is the safe setting, but we are not
6185        sure it doesn't break some more advanced MIME stuff.
6186
6187        D\bDO\bON\bN'\b'T\bT C\bCH\bHA\bAN\bNG\bGE\bE T\bTH\bHI\bIS\bS S\bSE\bET\bTT\bTI\bIN\bNG\bG U\bUN\bNL\bLE\bES\bSS\bS Y\bYO\bOU\bU A\bAR\bRE\bE R\bRE\bEA\bAL\bLL\bLY\bY S\bSU\bUR\bRE\bE W\bWH\bHA\bAT\bT Y\bYO\bOU\bU A\bAR\bRE\bE D\bDO\bOI\bIN\bNG\bG!\b!
6188
6189        _\b7_\b._\b4_\b._\b1_\b2_\b4  _\bm_\ba_\bi_\bl_\bd_\bi_\br_\b__\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be_\b__\bv_\be_\br_\bi_\bf_\by
6190
6191        The Mutt Next Generation E-Mail Client                                      120
6192
6193        Type: boolean
6194
6195        Default: yes
6196
6197        Availability: Header Cache
6198
6199        Check for Maildir unaware programs other than Mutt-ng having modified maildir
6200        files when the header cache is in use. This incurs one stat(2) per message
6201        every time the folder is opened.
6202
6203        _\b7_\b._\b4_\b._\b1_\b2_\b5  _\bm_\ba_\bi_\bl_\bd_\bi_\br_\b__\bt_\br_\ba_\bs_\bh
6204
6205        Type: boolean
6206
6207        Default: no
6208
6209        If _\bs_\be_\bt, messages marked as deleted will be saved with the maildir (T)rashed
6210        flag instead of physically deleted.
6211
6212        N\bNO\bOT\bTE\bE:\b: this only applies to maildir-style mailboxes. Setting it will have no
6213        effect on other mailbox types.
6214
6215        It is similiar to the trash option.
6216
6217        _\b7_\b._\b4_\b._\b1_\b2_\b6  _\bm_\ba_\br_\bk_\b__\bo_\bl_\bd
6218
6219        Type: boolean
6220
6221        Default: yes
6222
6223        Controls whether or not Mutt-ng marks _\bn_\be_\bw u\bun\bnr\bre\bea\bad\bd messages as _\bo_\bl_\bd if you exit a
6224        mailbox without reading them.
6225
6226        With this option _\bs_\be_\bt, the next time you start Mutt-ng, the messages will show
6227        up with an 'O' next to them in the ``index'' menu, indicating that they are
6228        old.
6229
6230        _\b7_\b._\b4_\b._\b1_\b2_\b7  _\bm_\ba_\br_\bk_\be_\br_\bs
6231
6232        Type: boolean
6233
6234        Default: yes
6235
6236        Controls the display of wrapped lines in the internal pager. If set, a ``+''
6237        marker is displayed at the beginning of wrapped lines. Also see the
6238        ``_\b$_\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp (section 7.4.270  , page 154)'' variable.
6239
6240        _\b7_\b._\b4_\b._\b1_\b2_\b8  _\bm_\ba_\bs_\bk
6241
6242        Type: regular expression
6243
6244        Default: '!^\.[^.]'
6245
6246        A regular expression used in the file browser, optionally preceded by the _\bn_\bo_\bt
6247
6248        The Mutt Next Generation E-Mail Client                                      121
6249
6250        operator ``!''.  Only files whose names match this mask will be shown. The
6251        match is always case-sensitive.
6252
6253        _\b7_\b._\b4_\b._\b1_\b2_\b9  _\bm_\ba_\bx_\b__\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\br_\be_\bc_\bi_\bp_\bs
6254
6255        Type: number
6256
6257        Default: 0
6258
6259        When set non-zero, this specifies the maximum number of recipient header lines
6260        (To:, Cc: and Bcc:) to display in the pager if header weeding is turned on. In
6261        case the number of lines exeeds its value, the last line will have 3 dots
6262        appended.
6263
6264        _\b7_\b._\b4_\b._\b1_\b3_\b0  _\bm_\ba_\bx_\b__\bl_\bi_\bn_\be_\b__\bl_\be_\bn_\bg_\bt_\bh
6265
6266        Type: number
6267
6268        Default: 0
6269
6270        When _\bs_\be_\bt, the maximum line length for displaying ``format = flowed'' messages
6271        is limited to this length. A value of 0 (which is also the default) means that
6272        the maximum line length is determined by the terminal width and _\b$_\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
6273        (section 7.4.344  , page 173).
6274
6275        _\b7_\b._\b4_\b._\b1_\b3_\b1  _\bm_\bb_\bo_\bx
6276
6277        Type: path
6278
6279        Default: '~/mbox'
6280
6281        This specifies the folder into which read mail in your ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
6282        7.4.304  , page 162)'' folder will be appended.
6283
6284        _\b7_\b._\b4_\b._\b1_\b3_\b2  _\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be
6285
6286        Type: folder magic
6287
6288        Default: mbox
6289
6290        The default mailbox type used when creating new folders. May be any of mbox,
6291        MMDF, MH and Maildir.
6292
6293        _\b7_\b._\b4_\b._\b1_\b3_\b3  _\bm_\be_\bn_\bu_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6294
6295        Type: number
6296
6297        Default: 0
6298
6299        This variable controls the number of lines of context that are given when
6300        scrolling through menus. (Similar to ``_\b$_\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.174  , page
6301        132)''.)
6302
6303        The Mutt Next Generation E-Mail Client                                      122
6304
6305        _\b7_\b._\b4_\b._\b1_\b3_\b4  _\bm_\be_\bn_\bu_\b__\bm_\bo_\bv_\be_\b__\bo_\bf_\bf
6306
6307        Type: boolean
6308
6309        Default: yes
6310
6311        When _\bu_\bn_\bs_\be_\bt, the bottom entry of menus will never scroll up past the bottom of
6312        the screen, unless there are less entries than lines.  When _\bs_\be_\bt, the bottom
6313        entry may move off the bottom.
6314
6315        _\b7_\b._\b4_\b._\b1_\b3_\b5  _\bm_\be_\bn_\bu_\b__\bs_\bc_\br_\bo_\bl_\bl
6316
6317        Type: boolean
6318
6319        Default: no
6320
6321        When _\bs_\be_\bt, menus will be scrolled up or down one line when you attempt to move
6322        across a screen boundary.  If _\bu_\bn_\bs_\be_\bt, the screen is cleared and the next or pre-
6323        vious page of the menu is displayed (useful for slow links to avoid many
6324        redraws).
6325
6326        _\b7_\b._\b4_\b._\b1_\b3_\b6  _\bm_\be_\bs_\bs_\ba_\bg_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
6327
6328        Type: string
6329
6330        Default: '%s'
6331
6332        This is the string displayed in the ``attachment'' menu for attachments of type
6333        message/rfc822.  For a full listing of defined printf(3)-like sequences see the
6334        section on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''.
6335
6336        _\b7_\b._\b4_\b._\b1_\b3_\b7  _\bm_\be_\bt_\ba_\b__\bk_\be_\by
6337
6338        Type: boolean
6339
6340        Default: no
6341
6342        If _\bs_\be_\bt, forces Mutt-ng to interpret keystrokes with the high bit (bit 8) set as
6343        if the user had pressed the ESC key and whatever key remains after having the
6344        high bit removed.  For example, if the key pressed has an ASCII value of 0xf4,
6345        then this is treated as if the user had pressed ESC then ``x''.  This is
6346        because the result of removing the high bit from ``0xf4'' is ``0x74'', which is
6347        the ASCII character ``x''.
6348
6349        _\b7_\b._\b4_\b._\b1_\b3_\b8  _\bm_\be_\bt_\bo_\bo
6350
6351        Type: boolean
6352
6353        Default: no
6354
6355        If _\bu_\bn_\bs_\be_\bt, Mutt-ng will remove your address (see the ``alternates'' command)
6356        from the list of recipients when replying to a message.
6357
6358        The Mutt Next Generation E-Mail Client                                      123
6359
6360        _\b7_\b._\b4_\b._\b1_\b3_\b9  _\bm_\bh_\b__\bp_\bu_\br_\bg_\be
6361
6362        Type: boolean
6363
6364        Default: no
6365
6366        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will mimic mh's behaviour and rename deleted messages to
6367        _\b,_\b<_\bo_\bl_\bd _\bf_\bi_\bl_\be _\bn_\ba_\bm_\be_\b> in mh folders instead of really deleting them.  If the vari-
6368        able is set, the message files will simply be deleted.
6369
6370        _\b7_\b._\b4_\b._\b1_\b4_\b0  _\bm_\bh_\b__\bs_\be_\bq_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
6371
6372        Type: string
6373
6374        Default: 'flagged'
6375
6376        The name of the MH sequence used for flagged messages.
6377
6378        _\b7_\b._\b4_\b._\b1_\b4_\b1  _\bm_\bh_\b__\bs_\be_\bq_\b__\br_\be_\bp_\bl_\bi_\be_\bd
6379
6380        Type: string
6381
6382        Default: 'replied'
6383
6384        The name of the MH sequence used to tag replied messages.
6385
6386        _\b7_\b._\b4_\b._\b1_\b4_\b2  _\bm_\bh_\b__\bs_\be_\bq_\b__\bu_\bn_\bs_\be_\be_\bn
6387
6388        Type: string
6389
6390        Default: 'unseen'
6391
6392        The name of the MH sequence used for unseen messages.
6393
6394        _\b7_\b._\b4_\b._\b1_\b4_\b3  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd
6395
6396        Type: quadoption
6397
6398        Default: no
6399
6400        When _\bs_\be_\bt, the message you are forwarding will be attached as a separate MIME
6401        part instead of included in the main body of the message.
6402
6403        This is useful for forwarding MIME messages so the receiver can properly view
6404        the message as it was delivered to you. If you like to switch between MIME and
6405        not MIME from mail to mail, set this variable to ask-no or ask-yes.
6406
6407        Also see ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.75  , page 106)'' and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
6408        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.144  , page 123)''.
6409
6410        _\b7_\b._\b4_\b._\b1_\b4_\b4  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
6411
6412        Type: boolean
6413
6414        The Mutt Next Generation E-Mail Client                                      124
6415
6416        Default: no
6417
6418        Controls the decoding of complex MIME messages into text/plain when forwarding
6419        a message while ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.143  , page 123)'' is _\bs_\be_\bt. Other-
6420        wise ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.75  , page 106)'' is used instead.
6421
6422        _\b7_\b._\b4_\b._\b1_\b4_\b5  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\br_\be_\bs_\bt
6423
6424        Type: quadoption
6425
6426        Default: yes
6427
6428        When forwarding multiple attachments of a MIME message from the recvattach
6429        menu, attachments which cannot be decoded in a reasonable manner will be
6430        attached to the newly composed message if this option is set.
6431
6432        _\b7_\b._\b4_\b._\b1_\b4_\b6  _\bm_\bi_\bx_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
6433
6434        Type: string
6435
6436        Default: '%4n %c %-16s %a'
6437
6438        Availability: Mixmaster
6439
6440        This variable describes the format of a remailer line on the mixmaster chain
6441        selection screen.  The following printf(3)-like sequences are supported:
6442
6443              %n
6444                    The running number on the menu.
6445
6446              %c
6447                    Remailer capabilities.
6448
6449              %s
6450                    The remailer's short name.
6451
6452              %a
6453                    The remailer's e-mail address.
6454
6455        _\b7_\b._\b4_\b._\b1_\b4_\b7  _\bm_\bi_\bx_\bm_\ba_\bs_\bt_\be_\br
6456
6457        Type: path
6458
6459        Default: 'mixmaster'
6460
6461        Availability: Mixmaster
6462
6463        This variable contains the path to the Mixmaster binary on your system.  It is
6464        used with various sets of parameters to gather the list of known remailers, and
6465        to finally send a message through the mixmaster chain.
6466
6467        _\b7_\b._\b4_\b._\b1_\b4_\b8  _\bm_\bo_\bv_\be
6468
6469        Type: quadoption
6470
6471        The Mutt Next Generation E-Mail Client                                      125
6472
6473        Default: ask-no
6474
6475        Controls whether or not Mutt-ng will move read messages from your spool mailbox
6476        to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.131  , page 121)'' mailbox, or as a result of a
6477        ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 36)'' command.
6478
6479        _\b7_\b._\b4_\b._\b1_\b4_\b9  _\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
6480
6481        Type: string
6482
6483        Default: '%Y%m%d%h%M%s.G%P%p'
6484
6485        This is the format for the ``local part'' of the Message-Id: header field gen-
6486        erated by Mutt-ng. If this variable is empty, no Message-Id: headers will be
6487        generated. The '%' character marks that certain data will be added to the
6488        string, similar to printf(3). The following characters are allowed:
6489
6490              %d
6491                    the current day of month
6492
6493              %h
6494                    the current hour
6495
6496              %m
6497                    the current month
6498
6499              %M
6500                    the current minute
6501
6502              %O
6503                    the current UNIX timestamp (octal)
6504
6505              %p
6506                    the process ID
6507
6508              %P
6509                    the current Message-ID prefix (a character rotating with every Mes-
6510                    sage-ID being generated)
6511
6512              %r
6513                    a random integer value (decimal)
6514
6515              %R
6516                    a random integer value (hexadecimal)
6517
6518              %s
6519                    the current second
6520
6521              %T
6522                    the current UNIX timestamp (decimal)
6523
6524              %X
6525                    the current UNIX timestamp (hexadecimal)
6526
6527        The Mutt Next Generation E-Mail Client                                      126
6528
6529              %Y
6530                    the current year (Y2K compliant)
6531
6532              %%
6533                    the '%' character
6534
6535        N\bNo\bot\bte\be:\b: Please only change this setting if you know what you are doing.  Also
6536        make sure to consult RFC2822 to produce technically _\bv_\ba_\bl_\bi_\bd strings.
6537
6538        _\b7_\b._\b4_\b._\b1_\b5_\b0  _\bn_\ba_\br_\br_\bo_\bw_\b__\bt_\br_\be_\be
6539
6540        Type: boolean
6541
6542        Default: no
6543
6544        This variable, when _\bs_\be_\bt, makes the thread tree narrower, allowing deeper
6545        threads to fit on the screen.
6546
6547        _\b7_\b._\b4_\b._\b1_\b5_\b1  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
6548
6549        Type: boolean
6550
6551        Default: no
6552
6553        Availability: NNTP
6554
6555        If _\bs_\be_\bt, Mutt-ng will prompt you for the Followup-To: header field before edit-
6556        ing the body of an outgoing news article.
6557
6558        _\b7_\b._\b4_\b._\b1_\b5_\b2  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6559
6560        Type: boolean
6561
6562        Default: no
6563
6564        Availability: NNTP
6565
6566        If _\bs_\be_\bt, Mutt-ng will prompt you for the X-Comment-To: header field before edit-
6567        ing the body of an outgoing news article.
6568
6569        _\b7_\b._\b4_\b._\b1_\b5_\b3  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br
6570
6571        Type: path
6572
6573        Default: '~/.muttng'
6574
6575        Availability: NNTP
6576
6577        This variable points to directory where Mutt-ng will cache news article head-
6578        ers. If _\bu_\bn_\bs_\be_\bt, headers will not be saved at all and will be reloaded each time
6579        when you enter a newsgroup.
6580
6581        As for the header caching in connection with IMAP and/or Maildir, this drasti-
6582        cally increases speed and lowers traffic.
6583
6584        The Mutt Next Generation E-Mail Client                                      127
6585
6586        _\b7_\b._\b4_\b._\b1_\b5_\b4  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bt_\bc_\bh_\bu_\bp
6587
6588        Type: quadoption
6589
6590        Default: ask-yes
6591
6592        Availability: NNTP
6593
6594        If this variable is _\bs_\be_\bt, Mutt-ng will mark all articles in a newsgroup as read
6595        when you leaving it.
6596
6597        _\b7_\b._\b4_\b._\b1_\b5_\b5  _\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6598
6599        Type: number
6600
6601        Default: 1000
6602
6603        Availability: NNTP
6604
6605        This variable controls how many news articles to cache per newsgroup (if
6606        caching is enabled, see _\b$_\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section 7.4.153  , page 126)) and how
6607        many news articles to show in the ``index'' menu.
6608
6609        If there're more articles than defined with _\b$_\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.155  ,
6610        page 127), all older ones will be removed/not shown in the index.
6611
6612        _\b7_\b._\b4_\b._\b1_\b5_\b6  _\bn_\bn_\bt_\bp_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo_\b__\bp_\bo_\bs_\bt_\be_\br
6613
6614        Type: quadoption
6615
6616        Default: ask-yes
6617
6618        Availability: NNTP
6619
6620        If this variable is _\bs_\be_\bt and the keyword 'poster' is present in the Followup-To:
6621        header field, a follow-up to the newsgroup is not permitted.  The message will
6622        be mailed to the submitter of the message via mail.
6623
6624        _\b7_\b._\b4_\b._\b1_\b5_\b7  _\bn_\bn_\bt_\bp_\b__\bg_\br_\bo_\bu_\bp_\b__\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
6625
6626        Type: string
6627
6628        Default: '%4C %M%N %5s  %-45.45f %d'
6629
6630        Availability: NNTP
6631
6632        This variable allows you to customize the newsgroup browser display to your
6633        personal taste.  This string is similar to ``_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  ,
6634        page 115)'', but has its own set of printf(3)-like sequences:
6635
6636        The Mutt Next Generation E-Mail Client                                      128
6637
6638             %C      current newsgroup number
6639             %d      description of newsgroup (retrieved from server)
6640             %f      newsgroup name
6641             %M      ``-'' if newsgroup not allowed for direct post (moderated for example)
6642             %N      ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
6643             %n      number of new articles in newsgroup
6644             %s      number of unread articles in newsgroup
6645             %>X     right justify the rest of the string and pad with character "X"
6646             %|X     pad to the end of the line with character "X"
6647
6648        _\b7_\b._\b4_\b._\b1_\b5_\b8  _\bn_\bn_\bt_\bp_\b__\bh_\bo_\bs_\bt
6649
6650        Type: string
6651
6652        Default: ''
6653
6654        Availability: NNTP
6655
6656        This variable specifies the name (or address) of the NNTP server to be used.
6657
6658        It defaults to the value specified via the environment variable $NNTPSERVER or
6659        contained in the file /etc/nntpserver.
6660
6661        You can also specify a username and an alternative port for each newsserver,
6662        e.g.
6663
6664        [nntp[s]://][username[:password]@]newsserver[:port]
6665
6666        N\bNo\bot\bte\be:\b: Using a password as shown and stored in a configuration file presents a
6667        security risk since the superuser of your machine may read it regardless of the
6668        file's permissions.
6669
6670        _\b7_\b._\b4_\b._\b1_\b5_\b9  _\bn_\bn_\bt_\bp_\b__\bi_\bn_\be_\bw_\bs
6671
6672        Type: path
6673
6674        Default: ''
6675
6676        Availability: NNTP
6677
6678        If _\bs_\be_\bt, specifies the program and arguments used to deliver news posted by
6679        Mutt-ng.  Otherwise, Mutt-ng posts article using current connection.  The fol-
6680        lowing printf(3)-style sequence is understood:
6681
6682             %s      newsserver name
6683
6684        Example: set inews='/usr/local/bin/inews -hS'
6685
6686        _\b7_\b._\b4_\b._\b1_\b6_\b0  _\bn_\bn_\bt_\bp_\b__\bl_\bo_\ba_\bd_\b__\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn
6687
6688        Type: boolean
6689
6690        The Mutt Next Generation E-Mail Client                                      129
6691
6692        Default: yes
6693
6694        Availability: NNTP
6695
6696        This variable controls whether or not descriptions for newsgroups are to be
6697        loaded when subscribing to a newsgroup.
6698
6699        _\b7_\b._\b4_\b._\b1_\b6_\b1  _\bn_\bn_\bt_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6700
6701        Type: number
6702
6703        Default: 60
6704
6705        Availability: NNTP
6706
6707        The time in seconds until any operations on a newsgroup except posting a new
6708        article will cause a recheck for new news. If set to 0, Mutt-ng will recheck on
6709        each operation in index (stepping, read article, etc.).
6710
6711        _\b7_\b._\b4_\b._\b1_\b6_\b2  _\bn_\bn_\bt_\bp_\b__\bm_\bi_\bm_\be_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
6712
6713        Type: boolean
6714
6715        Default: yes
6716
6717        Availability: NNTP
6718
6719        If _\bu_\bn_\bs_\be_\bt, an 8-bit ``Subject:'' header field in a news article will not be
6720        encoded according to RFC2047.
6721
6722        N\bNo\bot\bte\be:\b: Only change this setting if you know what you are doing.
6723
6724        _\b7_\b._\b4_\b._\b1_\b6_\b3  _\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc
6725
6726        Type: path
6727
6728        Default: '~/.newsrc'
6729
6730        Availability: NNTP
6731
6732        This file contains information about subscribed newsgroup and articles read so
6733        far.
6734
6735        To ease the use of multiple news servers, the following printf(3)-style
6736        sequence is understood:
6737
6738             %s      newsserver name
6739
6740        _\b7_\b._\b4_\b._\b1_\b6_\b4  _\bn_\bn_\bt_\bp_\b__\bp_\ba_\bs_\bs
6741
6742        Type: string
6743
6744        The Mutt Next Generation E-Mail Client                                      130
6745
6746        Default: ''
6747
6748        Availability: NNTP
6749
6750        Your password for NNTP account.
6751
6752        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
6753        the superuser of your machine may read it regardless of the file's permissions.
6754
6755        _\b7_\b._\b4_\b._\b1_\b6_\b5  _\bn_\bn_\bt_\bp_\b__\bp_\bo_\bs_\bt_\b__\bm_\bo_\bd_\be_\br_\ba_\bt_\be_\bd
6756
6757        Type: quadoption
6758
6759        Default: ask-yes
6760
6761        Availability: NNTP
6762
6763        If set to _\by_\be_\bs, Mutt-ng will post articles to newsgroup that have not permis-
6764        sions to post (e.g. moderated).
6765
6766        N\bNo\bot\bte\be:\b: if the newsserver does not support posting to that newsgroup or a group
6767        is totally read-only, that posting will not have any effect.
6768
6769        _\b7_\b._\b4_\b._\b1_\b6_\b6  _\bn_\bn_\bt_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
6770
6771        Type: quadoption
6772
6773        Default: ask-yes
6774
6775        Availability: NNTP
6776
6777        Controls whether or not Mutt-ng will try to reconnect to a newsserver when the
6778        was connection lost.
6779
6780        _\b7_\b._\b4_\b._\b1_\b6_\b7  _\bn_\bn_\bt_\bp_\b__\bs_\ba_\bv_\be_\b__\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
6781
6782        Type: boolean
6783
6784        Default: no
6785
6786        Availability: NNTP
6787
6788        When _\bs_\be_\bt, info about unsubscribed newsgroups will be saved into the ``newsrc''
6789        file and into the news cache.
6790
6791        _\b7_\b._\b4_\b._\b1_\b6_\b8  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bn_\be_\bw_\b__\bn_\be_\bw_\bs
6792
6793        Type: boolean
6794
6795        Default: yes
6796
6797        Availability: NNTP
6798
6799        If _\bs_\be_\bt, the newsserver will be asked for new newsgroups on entering the
6800
6801        The Mutt Next Generation E-Mail Client                                      131
6802
6803        browser.  Otherwise, it will be done only once for a newsserver.  Also controls
6804        whether or not the number of new articles of subscribed newsgroups will be
6805        checked.
6806
6807        _\b7_\b._\b4_\b._\b1_\b6_\b9  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bo_\bn_\bl_\by_\b__\bu_\bn_\br_\be_\ba_\bd
6808
6809        Type: boolean
6810
6811        Default: no
6812
6813        Availability: NNTP
6814
6815        If _\bs_\be_\bt, only subscribed newsgroups that contain unread articles will be dis-
6816        played in the newsgroup browser.
6817
6818        _\b7_\b._\b4_\b._\b1_\b7_\b0  _\bn_\bn_\bt_\bp_\b__\bu_\bs_\be_\br
6819
6820        Type: string
6821
6822        Default: ''
6823
6824        Availability: NNTP
6825
6826        Your login name on the NNTP server.  If _\bu_\bn_\bs_\be_\bt and the server requires authen-
6827        tification, Mutt-ng will prompt you for your account name.
6828
6829        _\b7_\b._\b4_\b._\b1_\b7_\b1  _\bn_\bn_\bt_\bp_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6830
6831        Type: boolean
6832
6833        Default: no
6834
6835        Availability: NNTP
6836
6837        If _\bs_\be_\bt, Mutt-ng will add a ``X-Comment-To:'' header field (that contains full
6838        name of the original article author) to articles that you followup to.
6839
6840        _\b7_\b._\b4_\b._\b1_\b7_\b2  _\bo_\bp_\be_\br_\ba_\bt_\bi_\bn_\bg_\b__\bs_\by_\bs_\bt_\be_\bm
6841
6842        Type: string
6843
6844        Default: ''
6845
6846        This specifies the operating system name for the User-Agent: header field. If
6847        this is _\bu_\bn_\bs_\be_\bt, it will be set to the operating system name that uname(2)
6848        returns. If uname(2) fails, ``UNIX'' will be used.
6849
6850        It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''.
6851
6852        _\b7_\b._\b4_\b._\b1_\b7_\b3  _\bp_\ba_\bg_\be_\br
6853
6854        Type: path
6855
6856        Default: 'builtin'
6857
6858        The Mutt Next Generation E-Mail Client                                      132
6859
6860        This variable specifies which pager you would like to use to view messages.
6861        ``builtin'' means to use the builtin pager, otherwise this variable should
6862        specify the pathname of the external pager you would like to use.
6863
6864        Using an external pager may have some disadvantages: Additional keystrokes are
6865        necessary because you can't call Mutt-ng functions directly from the pager, and
6866        screen resizes cause lines longer than the screen width to be badly formatted
6867        in the help menu.
6868
6869        _\b7_\b._\b4_\b._\b1_\b7_\b4  _\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6870
6871        Type: number
6872
6873        Default: 0
6874
6875        This variable controls the number of lines of context that are given when dis-
6876        playing the next or previous page in the internal pager.  By default, Mutt-ng
6877        will display the line after the last one on the screen at the top of the next
6878        page (0 lines of context).
6879
6880        _\b7_\b._\b4_\b._\b1_\b7_\b5  _\bp_\ba_\bg_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
6881
6882        Type: string
6883
6884        Default: '-%Z- %C/%m: %-20.20n   %s'
6885
6886        This variable controls the format of the one-line message ``status'' displayed
6887        before each message in either the internal or an external pager.  The valid
6888        sequences are listed in the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''
6889        section.
6890
6891        _\b7_\b._\b4_\b._\b1_\b7_\b6  _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs
6892
6893        Type: number
6894
6895        Default: 0
6896
6897        Determines the number of lines of a mini-index which is shown when in the
6898        pager.  The current message, unless near the top or bottom of the folder, will
6899        be roughly one third of the way down this mini-index, giving the reader the
6900        context of a few messages before and after the message.  This is useful, for
6901        example, to determine how many messages remain to be read in the current
6902        thread.  One of the lines is reserved for the status bar from the index, so a
6903        _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs of 6 will only show 5 lines of the actual index.  A value of
6904        0 results in no index being shown.  If the number of messages in the current
6905        folder is less than _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs, then the index will only use as many
6906        lines as it needs.
6907
6908        _\b7_\b._\b4_\b._\b1_\b7_\b7  _\bp_\ba_\bg_\be_\br_\b__\bs_\bt_\bo_\bp
6909
6910        Type: boolean
6911
6912        Default: no
6913
6914        The Mutt Next Generation E-Mail Client                                      133
6915
6916        When _\bs_\be_\bt, the internal-pager will n\bno\bot\bt move to the next message when you are at
6917        the end of a message and invoke the _\bn_\be_\bx_\bt_\b-_\bp_\ba_\bg_\be function.
6918
6919        _\b7_\b._\b4_\b._\b1_\b7_\b8  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\b__\bd_\be_\bc_\bo_\bd_\be
6920
6921        Type: boolean
6922
6923        Default: no
6924
6925        If _\bs_\be_\bt, Mutt-ng will automatically attempt to decrypt traditional PGP messages
6926        whenever the user performs an operation which ordinarily would result in the
6927        contents of the message being operated on.  For example, if the user displays a
6928        pgp-traditional message which has not been manually checked with the check-tra-
6929        ditional-pgp function, Mutt-ng will automatically check the message for tradi-
6930        tional pgp.
6931
6932        _\b7_\b._\b4_\b._\b1_\b7_\b9  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\bi_\bn_\bl_\bi_\bn_\be
6933
6934        Type: boolean
6935
6936        Default: no
6937
6938        This option controls whether Mutt-ng generates old-style inline (traditional)
6939        PGP encrypted or signed messages under certain circumstances.  This can be
6940        overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not required.
6941
6942        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
6943        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
6944        ing PGP/MIME messages when inline (traditional) would not work.  See also:
6945        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.195  , page 137)''.
6946
6947        Also note that using the old-style PGP message format is s\bst\btr\bro\bon\bng\bgl\bly\by d\bde\bep\bpr\bre\bec\bca\bat\bte\bed\bd.
6948        (PGP only)
6949
6950        _\b7_\b._\b4_\b._\b1_\b8_\b0  _\bp_\bg_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\be_\bx_\bi_\bt
6951
6952        Type: boolean
6953
6954        Default: yes
6955
6956        If _\bs_\be_\bt, Mutt-ng will check the exit code of the PGP subprocess when signing or
6957        encrypting.  A non-zero exit code means that the subprocess failed.  (PGP only)
6958
6959        _\b7_\b._\b4_\b._\b1_\b8_\b1  _\bp_\bg_\bp_\b__\bc_\bl_\be_\ba_\br_\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6960
6961        Type: string
6962
6963        Default: ''
6964
6965        This format is used to create a old-style ``clearsigned'' PGP message.
6966
6967        Note that the use of this format is s\bst\btr\bro\bon\bng\bgl\bly\by d\bde\bep\bpr\bre\bec\bca\bat\bte\bed\bd.  (PGP only)
6968
6969        The Mutt Next Generation E-Mail Client                                      134
6970
6971        _\b7_\b._\b4_\b._\b1_\b8_\b2  _\bp_\bg_\bp_\b__\bd_\be_\bc_\bo_\bd_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6972
6973        Type: string
6974
6975        Default: ''
6976
6977        This format strings specifies a command which is used to decode application/pgp
6978        attachments.
6979
6980        The PGP command formats have their own set of printf(3)-like sequences:
6981
6982              %p
6983                    Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
6984                    string otherwise. Note: This may be used with a %? construct.
6985
6986              %f
6987                    Expands to the name of a file containing a message.
6988
6989              %s
6990                    Expands to the name of a file containing the signature part of a
6991                    multipart/signed attachment when verifying it.
6992
6993              %a
6994                    The value of _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 7.4.199  , page 138).
6995
6996              %r
6997                    One or more key IDs.
6998
6999        For examples on how to configure these formats for the various versions of PGP
7000        which are floating around, see the pgp*.rc and gpg.rc files in the samples/
7001        subdirectory which has been installed on your system alongside the documenta-
7002        tion.  (PGP only)
7003
7004        _\b7_\b._\b4_\b._\b1_\b8_\b3  _\bp_\bg_\bp_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7005
7006        Type: string
7007
7008        Default: ''
7009
7010        This command is used to decrypt a PGP encrypted message.  (PGP only)
7011
7012        _\b7_\b._\b4_\b._\b1_\b8_\b4  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bo_\bn_\bl_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7013
7014        Type: string
7015
7016        Default: ''
7017
7018        This command is used to encrypt a body part without signing it.  (PGP only)
7019
7020        _\b7_\b._\b4_\b._\b1_\b8_\b5  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7021
7022        Type: string
7023
7024        Default: ''
7025
7026        The Mutt Next Generation E-Mail Client                                      135
7027
7028        This command is used to both sign and encrypt a body part.  (PGP only)
7029
7030        _\b7_\b._\b4_\b._\b1_\b8_\b6  _\bp_\bg_\bp_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
7031
7032        Type: string
7033
7034        Default: '%4n %t%f %4l/0x%k %-4a %2c %u'
7035
7036        This variable allows you to customize the PGP key selection menu to your per-
7037        sonal taste. This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page
7038        115)'', but has its own set of printf(3)-like sequences:
7039
7040              %n
7041                    number
7042
7043              %k
7044                    key id
7045
7046              %u
7047                    user id
7048
7049              %a
7050                    algorithm
7051
7052              %l
7053                    key length
7054
7055              %f
7056                    flags
7057
7058              %c
7059                    capabilities
7060
7061              %t
7062                    trust/validity of the key-uid association
7063
7064              %[<s>]
7065                    date of the key where <s> is an strftime(3) expression
7066
7067        (PGP only)
7068
7069        _\b7_\b._\b4_\b._\b1_\b8_\b7  _\bp_\bg_\bp_\b__\be_\bx_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7070
7071        Type: string
7072
7073        Default: ''
7074
7075        This command is used to export a public key from the user's key ring.  (PGP
7076        only)
7077
7078        _\b7_\b._\b4_\b._\b1_\b8_\b8  _\bp_\bg_\bp_\b__\bg_\be_\bt_\bk_\be_\by_\bs_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7079
7080        Type: string
7081
7082        The Mutt Next Generation E-Mail Client                                      136
7083
7084        Default: ''
7085
7086        This command is invoked whenever Mutt-ng will need public key information.  %r
7087        is the only printf(3)-like sequence used with this format.  (PGP only)
7088
7089        _\b7_\b._\b4_\b._\b1_\b8_\b9  _\bp_\bg_\bp_\b__\bg_\bo_\bo_\bd_\b__\bs_\bi_\bg_\bn
7090
7091        Type: regular expression
7092
7093        Default: ''
7094
7095        If you assign a text to this variable, then a PGP signature is only considered
7096        verified if the output from _\b$_\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.205  , page 139)
7097        contains the text. Use this variable if the exit code from the command is 0
7098        even for bad signatures.  (PGP only)
7099
7100        _\b7_\b._\b4_\b._\b1_\b9_\b0  _\bp_\bg_\bp_\b__\bi_\bg_\bn_\bo_\br_\be_\b__\bs_\bu_\bb_\bk_\be_\by_\bs
7101
7102        Type: boolean
7103
7104        Default: yes
7105
7106        Setting this variable will cause Mutt-ng to ignore OpenPGP subkeys. Instead,
7107        the principal key will inherit the subkeys' capabilities. _\bU_\bn_\bs_\be_\bt this if you
7108        want to play interesting key selection games.  (PGP only)
7109
7110        _\b7_\b._\b4_\b._\b1_\b9_\b1  _\bp_\bg_\bp_\b__\bi_\bm_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7111
7112        Type: string
7113
7114        Default: ''
7115
7116        This command is used to import a key from a message into the user's public key
7117        ring.  (PGP only)
7118
7119        _\b7_\b._\b4_\b._\b1_\b9_\b2  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bp_\bu_\bb_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7120
7121        Type: string
7122
7123        Default: ''
7124
7125        This command is used to list the public key ring's contents.  The output format
7126        must be analogous to the one used by gpg --list-keys --with-colons.
7127
7128        This format is also generated by the pgpring utility which comes with Mutt-ng.
7129        (PGP only)
7130
7131        _\b7_\b._\b4_\b._\b1_\b9_\b3  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\be_\bc_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7132
7133        Type: string
7134
7135        Default: ''
7136
7137        This command is used to list the secret key ring's contents.  The output format
7138
7139        The Mutt Next Generation E-Mail Client                                      137
7140
7141        must be analogous to the one used by gpg --list-keys --with-colons.
7142
7143        This format is also generated by the pgpring utility which comes with Mutt-ng.
7144        (PGP only)
7145
7146        _\b7_\b._\b4_\b._\b1_\b9_\b4  _\bp_\bg_\bp_\b__\bl_\bo_\bn_\bg_\b__\bi_\bd_\bs
7147
7148        Type: boolean
7149
7150        Default: no
7151
7152        If _\bs_\be_\bt, use 64 bit PGP key IDs. _\bU_\bn_\bs_\be_\bt uses the normal 32 bit Key IDs.  (PGP
7153        only)
7154
7155        _\b7_\b._\b4_\b._\b1_\b9_\b5  _\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo
7156
7157        Type: quadoption
7158
7159        Default: ask-yes
7160
7161        This option controls whether Mutt-ng will prompt you for automatically sending
7162        a (signed/encrypted) message using PGP/MIME when inline (traditional) fails
7163        (for any reason).
7164
7165        Also note that using the old-style PGP message format is s\bst\btr\bro\bon\bng\bgl\bly\by d\bde\bep\bpr\bre\bec\bca\bat\bte\bed\bd.
7166        (PGP only)
7167
7168        _\b7_\b._\b4_\b._\b1_\b9_\b6  _\bp_\bg_\bp_\b__\br_\be_\bp_\bl_\by_\bi_\bn_\bl_\bi_\bn_\be
7169
7170        Type: boolean
7171
7172        Default: no
7173
7174        Setting this variable will cause Mutt-ng to always attempt to create an inline
7175        (traditional) message when replying to a message which is PGP encrypted/signed
7176        inline.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not
7177        required.  This option does not automatically detect if the (replied-to) mes-
7178        sage is inline; instead it relies on Mutt-ng internals for previously
7179        checked/flagged messages.
7180
7181        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
7182        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
7183        ing PGP/MIME messages when inline (traditional) would not work.  See also:
7184        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.195  , page 137)''.
7185
7186        Also note that using the old-style PGP message format is s\bst\btr\bro\bon\bng\bgl\bly\by d\bde\bep\bpr\bre\bec\bca\bat\bte\bed\bd.
7187        (PGP only)
7188
7189        _\b7_\b._\b4_\b._\b1_\b9_\b7  _\bp_\bg_\bp_\b__\br_\be_\bt_\ba_\bi_\bn_\ba_\bb_\bl_\be_\b__\bs_\bi_\bg_\bs
7190
7191        Type: boolean
7192
7193        Default: no
7194
7195        The Mutt Next Generation E-Mail Client                                      138
7196
7197        If _\bs_\be_\bt, signed and encrypted messages will consist of nested multipart/signed
7198        and multipart/encrypted body parts.
7199
7200        This is useful for applications like encrypted and signed mailing lists, where
7201        the outer layer (multipart/encrypted) can be easily removed, while the inner
7202        multipart/signed part is retained.  (PGP only)
7203
7204        _\b7_\b._\b4_\b._\b1_\b9_\b8  _\bp_\bg_\bp_\b__\bs_\bh_\bo_\bw_\b__\bu_\bn_\bu_\bs_\ba_\bb_\bl_\be
7205
7206        Type: boolean
7207
7208        Default: yes
7209
7210        If _\bs_\be_\bt, Mutt-ng will display non-usable keys on the PGP key selection menu.
7211        This includes keys which have been revoked, have expired, or have been marked
7212        as ``disabled'' by the user.  (PGP only)
7213
7214        _\b7_\b._\b4_\b._\b1_\b9_\b9  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs
7215
7216        Type: string
7217
7218        Default: ''
7219
7220        If you have more than one key pair, this option allows you to specify which of
7221        your private keys to use.  It is recommended that you use the keyid form to
7222        specify your key (e.g., ``0x00112233'').  (PGP only)
7223
7224        _\b7_\b._\b4_\b._\b2_\b0_\b0  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7225
7226        Type: string
7227
7228        Default: ''
7229
7230        This command is used to create the detached PGP signature for a multi-
7231        part/signed PGP/MIME body part.  (PGP only)
7232
7233        _\b7_\b._\b4_\b._\b2_\b0_\b1  _\bp_\bg_\bp_\b__\bs_\bo_\br_\bt_\b__\bk_\be_\by_\bs
7234
7235        Type: sort order
7236
7237        Default: address
7238
7239        Specifies how the entries in the ``pgp keys'' menu are sorted. The following
7240        are legal values:
7241
7242              address
7243                    sort alphabetically by user id
7244
7245              keyid
7246                    sort alphabetically by key id
7247
7248              date
7249                    sort by key creation date
7250
7251        The Mutt Next Generation E-Mail Client                                      139
7252
7253              trust
7254                    sort by the trust of the key
7255
7256        If you prefer reverse order of the above values, prefix it with ``reverse-''.
7257        (PGP only)
7258
7259        _\b7_\b._\b4_\b._\b2_\b0_\b2  _\bp_\bg_\bp_\b__\bs_\bt_\br_\bi_\bc_\bt_\b__\be_\bn_\bc
7260
7261        Type: boolean
7262
7263        Default: yes
7264
7265        If _\bs_\be_\bt, Mutt-ng will automatically encode PGP/MIME signed messages as quoted-
7266        printable.  Please note that unsetting this variable may lead to problems with
7267        non-verifyable PGP signatures, so only change this if you know what you are
7268        doing.  (PGP only)
7269
7270        _\b7_\b._\b4_\b._\b2_\b0_\b3  _\bp_\bg_\bp_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
7271
7272        Type: number
7273
7274        Default: 300
7275
7276        The number of seconds after which a cached passphrase will expire if not used.
7277        Default: 300.  (PGP only)
7278
7279        _\b7_\b._\b4_\b._\b2_\b0_\b4  _\bp_\bg_\bp_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\b__\ba_\bg_\be_\bn_\bt
7280
7281        Type: boolean
7282
7283        Default: no
7284
7285        If _\bs_\be_\bt, Mutt-ng will use a possibly-running gpg-agent process.  (PGP only)
7286
7287        _\b7_\b._\b4_\b._\b2_\b0_\b5  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7288
7289        Type: string
7290
7291        Default: ''
7292
7293        This command is used to verify PGP signatures.  (PGP only)
7294
7295        _\b7_\b._\b4_\b._\b2_\b0_\b6  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bk_\be_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7296
7297        Type: string
7298
7299        Default: ''
7300
7301        This command is used to verify key information from the key selection menu.
7302        (PGP only)
7303
7304        _\b7_\b._\b4_\b._\b2_\b0_\b7  _\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be
7305
7306        Type: boolean
7307
7308        The Mutt Next Generation E-Mail Client                                      140
7309
7310        Default: no
7311
7312        Used in connection with the _\bp_\bi_\bp_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be command.  When _\bu_\bn_\bs_\be_\bt, Mutt-ng will
7313        pipe the messages without any preprocessing. When _\bs_\be_\bt, Mutt-ng will weed head-
7314        ers and will attempt to PGP/MIME decode the messages first.
7315
7316        _\b7_\b._\b4_\b._\b2_\b0_\b8  _\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7317
7318        Type: string
7319
7320        Default: '\n'
7321
7322        The separator to add between messages when piping a list of tagged messages to
7323        an external Unix command.
7324
7325        _\b7_\b._\b4_\b._\b2_\b0_\b9  _\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
7326
7327        Type: boolean
7328
7329        Default: no
7330
7331        Used in connection with the _\bp_\bi_\bp_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be command and the ``tag- prefix'' or
7332        ``tag-prefix-cond'' operators.  If this variable is _\bu_\bn_\bs_\be_\bt, when piping a list
7333        of tagged messages Mutt-ng will concatenate the messages and will pipe them as
7334        a single folder.  When _\bs_\be_\bt, Mutt-ng will pipe the messages one by one.  In both
7335        cases the messages are piped in the current sorted order, and the ``_\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7336        (section 7.4.208  , page 139)'' separator is added after each message.
7337
7338        _\b7_\b._\b4_\b._\b2_\b1_\b0  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\b__\bt_\br_\by_\b__\ba_\bl_\bl
7339
7340        Type: boolean
7341
7342        Default: yes
7343
7344        Availability: POP
7345
7346        If _\bs_\be_\bt, Mutt-ng will try all available methods. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will only
7347        fall back to other authentication methods if the previous methods are unavail-
7348        able. If a method is available but authentication fails, Mutt-ng will not con-
7349        nect to the POP server.
7350
7351        _\b7_\b._\b4_\b._\b2_\b1_\b1  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
7352
7353        Type: string
7354
7355        Default: ''
7356
7357        Availability: POP
7358
7359        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
7360        use to log in to an POP server, in the order Mutt-ng should try them.  Authen-
7361        tication methods are either ``user'', ``apop'' or any SASL mechanism, eg
7362        ``digest-md5'', ``gssapi'' or ``cram-md5''.
7363
7364        The Mutt Next Generation E-Mail Client                                      141
7365
7366        This parameter is case-insensitive. If this parameter is _\bu_\bn_\bs_\be_\bt (the default)
7367        Mutt-ng will try all available methods, in order from most-secure to least-
7368        secure.
7369
7370        Example: set pop_authenticators='digest-md5:apop:user'
7371
7372        _\b7_\b._\b4_\b._\b2_\b1_\b2  _\bp_\bo_\bp_\b__\bd_\be_\bl_\be_\bt_\be
7373
7374        Type: quadoption
7375
7376        Default: ask-no
7377
7378        Availability: POP
7379
7380        If _\bs_\be_\bt, Mutt-ng will delete successfully downloaded messages from the POP
7381        server when using the ``fetch-mail'' function.  When _\bu_\bn_\bs_\be_\bt, Mutt-ng will down-
7382        load messages but also leave them on the POP server.
7383
7384        _\b7_\b._\b4_\b._\b2_\b1_\b3  _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt
7385
7386        Type: string
7387
7388        Default: ''
7389
7390        Availability: POP
7391
7392        The name of your POP server for the ``fetch-mail'' function.  You can also
7393        specify an alternative port, username and password, i.e.:
7394
7395        [pop[s]://][username[:password]@]popserver[:port]
7396
7397        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7398        the superuser of your machine may read it regardless of the file's permissions.
7399
7400        _\b7_\b._\b4_\b._\b2_\b1_\b4  _\bp_\bo_\bp_\b__\bl_\ba_\bs_\bt
7401
7402        Type: boolean
7403
7404        Default: no
7405
7406        Availability: POP
7407
7408        If this variable is _\bs_\be_\bt, Mutt-ng will try to use the ``LAST'' POP command for
7409        retrieving only unread messages from the POP server when using the ``fetch-
7410        mail'' function.
7411
7412        _\b7_\b._\b4_\b._\b2_\b1_\b5  _\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
7413
7414        Type: number
7415
7416        Default: 60
7417
7418        Availability: POP
7419
7420        The Mutt Next Generation E-Mail Client                                      142
7421
7422        This variable configures how often (in seconds) POP should look for new mail.
7423
7424        _\b7_\b._\b4_\b._\b2_\b1_\b6  _\bp_\bo_\bp_\b__\bp_\ba_\bs_\bs
7425
7426        Type: string
7427
7428        Default: ''
7429
7430        Availability: POP
7431
7432        Specifies the password for your POP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt you
7433        for your password when you open POP mailbox.
7434
7435        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7436        the superuser of your machine may read it regardless of the file's permissions.
7437
7438        _\b7_\b._\b4_\b._\b2_\b1_\b7  _\bp_\bo_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7439
7440        Type: quadoption
7441
7442        Default: ask-yes
7443
7444        Availability: POP
7445
7446        Controls whether or not Mutt-ng will try to reconnect to a POP server when the
7447        connection is lost.
7448
7449        _\b7_\b._\b4_\b._\b2_\b1_\b8  _\bp_\bo_\bp_\b__\bu_\bs_\be_\br
7450
7451        Type: string
7452
7453        Default: ''
7454
7455        Availability: POP
7456
7457        Your login name on the POP server.
7458
7459        This variable defaults to your user name on the local machine.
7460
7461        _\b7_\b._\b4_\b._\b2_\b1_\b9  _\bp_\bo_\bs_\bt_\b__\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
7462
7463        Type: string
7464
7465        Default: ''
7466
7467        Similar to the ``_\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 7.4.18  , page 93)'' variable, Mutt-ng
7468        will append this string after the inclusion of a message which is being replied
7469        to.
7470
7471        _\b7_\b._\b4_\b._\b2_\b2_\b0  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
7472
7473        Type: quadoption
7474
7475        Default: ask-yes
7476
7477        The Mutt Next Generation E-Mail Client                                      143
7478
7479        Controls whether or not messages are saved in the ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section
7480        7.4.221  , page 142)'' mailbox when you elect not to send immediately.
7481
7482        _\b7_\b._\b4_\b._\b2_\b2_\b1  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd
7483
7484        Type: path
7485
7486        Default: '~/postponed'
7487
7488        Mutt-ng allows you to indefinitely ``_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.220  , page 142)
7489        sending a message'' which you are editing.  When you choose to postpone a mes-
7490        sage, Mutt-ng saves it in the mailbox specified by this variable.  Also see the
7491        ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.220  , page 142)'' variable.
7492
7493        _\b7_\b._\b4_\b._\b2_\b2_\b2  _\bp_\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7494
7495        Type: string
7496
7497        Default: ''
7498
7499        If _\bs_\be_\bt, a shell command to be executed if Mutt-ng fails to establish a connec-
7500        tion to the server. This is useful for setting up secure connections, e.g. with
7501        ssh(1). If the command returns a  nonzero status, Mutt-ng gives up opening the
7502        server. Example:
7503
7504        preconnect='ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 <
7505        /dev/null > /dev/null'
7506
7507        Mailbox ``foo'' on mailhost.net can now be reached as ``{localhost:1234}foo''.
7508
7509        N\bNo\bot\bte\be:\b: For this example to work, you must be able to log in to the remote
7510        machine without having to enter a password.
7511
7512        _\b7_\b._\b4_\b._\b2_\b2_\b3  _\bp_\br_\bi_\bn_\bt
7513
7514        Type: quadoption
7515
7516        Default: ask-no
7517
7518        Controls whether or not Mutt-ng really prints messages.  This is set to _\ba_\bs_\bk_\b-_\bn_\bo
7519        by default, because some people accidentally hit ``p'' often.
7520
7521        _\b7_\b._\b4_\b._\b2_\b2_\b4  _\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7522
7523        Type: path
7524
7525        Default: 'lpr'
7526
7527        This specifies the command pipe that should be used to print messages.
7528
7529        _\b7_\b._\b4_\b._\b2_\b2_\b5  _\bp_\br_\bi_\bn_\bt_\b__\bd_\be_\bc_\bo_\bd_\be
7530
7531        Type: boolean
7532
7533        The Mutt Next Generation E-Mail Client                                      144
7534
7535        Default: yes
7536
7537        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7538        message is decoded before it is passed to the external command specified by
7539        _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.224  , page 143).  If this option is _\bu_\bn_\bs_\be_\bt, no pro-
7540        cessing will be applied to the message when printing it.  The latter setting
7541        may be useful if you are using some advanced printer filter which is able to
7542        properly format e-mail messages for printing.
7543
7544        _\b7_\b._\b4_\b._\b2_\b2_\b6  _\bp_\br_\bi_\bn_\bt_\b__\bs_\bp_\bl_\bi_\bt
7545
7546        Type: boolean
7547
7548        Default: no
7549
7550        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7551        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.224  , page 143) is executed
7552        once for each message which is to be printed.  If this option is _\bu_\bn_\bs_\be_\bt, the
7553        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.224  , page 143) is executed
7554        only once, and all the messages are concatenated, with a form feed as the mes-
7555        sage separator.
7556
7557        Those who use the enscript(1) program's mail-printing mode will most likely
7558        want to set this option.
7559
7560        _\b7_\b._\b4_\b._\b2_\b2_\b7  _\bp_\br_\bo_\bm_\bp_\bt_\b__\ba_\bf_\bt_\be_\br
7561
7562        Type: boolean
7563
7564        Default: yes
7565
7566        If you use an _\be_\bx_\bt_\be_\br_\bn_\ba_\bl ``_\b$_\bp_\ba_\bg_\be_\br (section 7.4.173  , page 131)'', setting this
7567        variable will cause Mutt-ng to prompt you for a command when the pager exits
7568        rather than returning to the index menu.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will return to the
7569        index menu when the external pager exits.
7570
7571        _\b7_\b._\b4_\b._\b2_\b2_\b8  _\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7572
7573        Type: path
7574
7575        Default: ''
7576
7577        This specifies the command that Mutt-ng will use to make external address
7578        queries.  The string should contain a %s, which will be substituted with the
7579        query string the user types.  See ``_\bq_\bu_\be_\br_\by (section 4.7  , page 58)'' for more
7580        information.
7581
7582        _\b7_\b._\b4_\b._\b2_\b2_\b9  _\bq_\bu_\bi_\bt
7583
7584        Type: quadoption
7585
7586        Default: yes
7587
7588        This variable controls whether ``quit'' and ``exit'' actually quit from Mutt-
7589
7590        The Mutt Next Generation E-Mail Client                                      145
7591
7592        ng.  If it set to _\by_\be_\bs, they do quit, if it is set to _\bn_\bo, they have no effect,
7593        and if it is set to _\ba_\bs_\bk_\b-_\by_\be_\bs or _\ba_\bs_\bk_\b-_\bn_\bo, you are prompted for confirmation when
7594        you try to quit.
7595
7596        _\b7_\b._\b4_\b._\b2_\b3_\b0  _\bq_\bu_\bo_\bt_\be_\b__\be_\bm_\bp_\bt_\by
7597
7598        Type: boolean
7599
7600        Default: yes
7601
7602        Controls whether or not empty lines will be quoted using ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (sec-
7603        tion 7.4.115  , page 115)''.
7604
7605        _\b7_\b._\b4_\b._\b2_\b3_\b1  _\bq_\bu_\bo_\bt_\be_\b__\bq_\bu_\bo_\bt_\be_\bd
7606
7607        Type: boolean
7608
7609        Default: no
7610
7611        Controls how quoted lines will be quoted. If _\bs_\be_\bt, one quote character will be
7612        added to the end of existing prefix.  Otherwise, quoted lines will be prepended
7613        by ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.115  , page 115)''.
7614
7615        _\b7_\b._\b4_\b._\b2_\b3_\b2  _\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp
7616
7617        Type: regular expression
7618
7619        Default: '^([ \t]*[|>:}#])+'
7620
7621        A regular expression used in the internal-pager to determine quoted sections of
7622        text in the body of a message.
7623
7624        N\bNo\bot\bte\be:\b: In order to use the _\bq_\bu_\bo_\bt_\be_\bdx\bx patterns in the internal pager, you need to
7625        set this to a regular expression that matches _\be_\bx_\ba_\bc_\bt_\bl_\by the quote characters at
7626        the beginning of quoted lines.
7627
7628        _\b7_\b._\b4_\b._\b2_\b3_\b3  _\br_\be_\ba_\bd_\b__\bi_\bn_\bc
7629
7630        Type: number
7631
7632        Default: 10
7633
7634        If set to a value greater than 0, Mutt-ng will display which message it is cur-
7635        rently on when reading a mailbox.  The message is printed after _\br_\be_\ba_\bd_\b__\bi_\bn_\bc mes-
7636        sages have been read (e.g., if set to 25, Mutt-ng will print a message when it
7637        reads message 25, and then again when it gets to message 50).  This variable is
7638        meant to indicate progress when reading large mailboxes which may take some
7639        time.  When set to 0, only a single message will appear before the reading the
7640        mailbox.
7641
7642        Also see the ``_\b$_\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc (section 7.4.346  , page 173)'' variable.
7643
7644        _\b7_\b._\b4_\b._\b2_\b3_\b4  _\br_\be_\ba_\bd_\b__\bo_\bn_\bl_\by
7645
7646        The Mutt Next Generation E-Mail Client                                      146
7647
7648        Type: boolean
7649
7650        Default: no
7651
7652        If set, all folders are opened in read-only mode.
7653
7654        _\b7_\b._\b4_\b._\b2_\b3_\b5  _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7655
7656        Type: string
7657
7658        Default: ''
7659
7660        This variable specifies what ``real'' or ``personal'' name should be used when
7661        sending messages.
7662
7663        By default, this is the GECOS field from /etc/passwd.
7664
7665        _\bN_\bo_\bt_\be_\b: This variable will _\bn_\bo_\bt be used when the user has set a real name in the
7666        _\b$_\bf_\br_\bo_\bm (section 7.4.80  , page 107) variable.
7667
7668        _\b7_\b._\b4_\b._\b2_\b3_\b6  _\br_\be_\bc_\ba_\bl_\bl
7669
7670        Type: quadoption
7671
7672        Default: ask-yes
7673
7674        Controls whether or not Mutt-ng recalls postponed messages when composing a new
7675        message.  Also see ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 7.4.221  , page 142)''.
7676
7677        Setting this variable to _\by_\be_\bs is not generally useful, and thus not recommended.
7678
7679        _\b7_\b._\b4_\b._\b2_\b3_\b7  _\br_\be_\bc_\bo_\br_\bd
7680
7681        Type: path
7682
7683        Default: ''
7684
7685        This specifies the file into which your outgoing messages should be appended.
7686        (This is meant as the primary method for saving a copy of your messages, but
7687        another way to do this is using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37)'' com-
7688        mand to create a Bcc: header field with your email address in it.)
7689
7690        The value of _\b$_\br_\be_\bc_\bo_\br_\bd _\b(_\bs_\be_\bc_\bt_\bi_\bo_\bn _\b7_\b._\b4_\b._\b2_\b3_\b7  _\b, _\bp_\ba_\bg_\be _\b1_\b4_\b6_\b) is overridden by the
7691        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.74  , page 106)'' and ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section
7692        7.4.248  , page 149)'' variables, and the ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page
7693        38)'' command.
7694
7695        _\b7_\b._\b4_\b._\b2_\b3_\b8  _\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp
7696
7697        Type: regular expression
7698
7699        Default: '^(re([\[0-9\]+])*|aw):[ \t]*'
7700
7701        A regular expression used to recognize reply messages when threading and
7702
7703        The Mutt Next Generation E-Mail Client                                      147
7704
7705        replying. The default value corresponds to the English ``Re:'' and the German
7706        ``Aw:''.
7707
7708        _\b7_\b._\b4_\b._\b2_\b3_\b9  _\br_\be_\bp_\bl_\by_\b__\bs_\be_\bl_\bf
7709
7710        Type: boolean
7711
7712        Default: no
7713
7714        If _\bu_\bn_\bs_\be_\bt and you are replying to a message sent by you, Mutt-ng will assume
7715        that you want to reply to the recipients of that message rather than to your-
7716        self.
7717
7718        _\b7_\b._\b4_\b._\b2_\b4_\b0  _\br_\be_\bp_\bl_\by_\b__\bt_\bo
7719
7720        Type: quadoption
7721
7722        Default: ask-yes
7723
7724        If _\bs_\be_\bt, when replying to a message, Mutt-ng will use the address listed in the
7725        ``Reply-To:'' header field as the recipient of the reply.  If _\bu_\bn_\bs_\be_\bt, it will
7726        use the address in the ``From:'' header field instead.
7727
7728        This option is useful for reading a mailing list that sets the ``Reply-To:''
7729        header field to the list address and you want to send a private message to the
7730        author of a message.
7731
7732        _\b7_\b._\b4_\b._\b2_\b4_\b1  _\br_\be_\bs_\bo_\bl_\bv_\be
7733
7734        Type: boolean
7735
7736        Default: yes
7737
7738        When set, the cursor will be automatically advanced to the next (possibly
7739        undeleted) message whenever a command that modifies the current message is exe-
7740        cuted.
7741
7742        _\b7_\b._\b4_\b._\b2_\b4_\b2  _\br_\be_\bv_\be_\br_\bs_\be_\b__\ba_\bl_\bi_\ba_\bs
7743
7744        Type: boolean
7745
7746        Default: no
7747
7748        This variable controls whether or not Mutt-ng will display the ``personal''
7749        name from your aliases in the index menu if it finds an alias that matches the
7750        message's sender.  For example, if you have the following alias:
7751
7752        alias juser abd30425@somewhere.net (Joe User)
7753
7754        and then you receive mail which contains the following header:
7755
7756        From: abd30425@somewhere.net
7757
7758        It would be displayed in the index menu as ``Joe User'' instead of
7759
7760        The Mutt Next Generation E-Mail Client                                      148
7761
7762        ``abd30425@somewhere.net.''  This is useful when the person's e-mail address is
7763        not human friendly (like CompuServe addresses).
7764
7765        _\b7_\b._\b4_\b._\b2_\b4_\b3  _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be
7766
7767        Type: boolean
7768
7769        Default: no
7770
7771        It may sometimes arrive that you receive mail to a certain machine, move the
7772        messages to another machine, and reply to some the messages from there.  If
7773        this variable is _\bs_\be_\bt, the default From: line of the reply messages is built
7774        using the address where you received the messages you are replying to i\bif\bf that
7775        address matches your alternates.  If the variable is _\bu_\bn_\bs_\be_\bt, or the address that
7776        would be used doesn't match your alternates, the From: line will use your
7777        address on the current machine.
7778
7779        _\b7_\b._\b4_\b._\b2_\b4_\b4  _\br_\be_\bv_\be_\br_\bs_\be_\b__\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7780
7781        Type: boolean
7782
7783        Default: yes
7784
7785        This variable fine-tunes the behaviour of the _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.243  ,
7786        page 147) feature.  When it is _\bs_\be_\bt, Mutt-ng will use the address from incoming
7787        messages as-is, possibly including eventual real names.  When it is _\bu_\bn_\bs_\be_\bt,
7788        Mutt-ng will override any such real names with the setting of the _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7789        (section 7.4.235  , page 145) variable.
7790
7791        _\b7_\b._\b4_\b._\b2_\b4_\b5  _\br_\bf_\bc_\b2_\b0_\b4_\b7_\b__\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br_\bs
7792
7793        Type: boolean
7794
7795        Default: no
7796
7797        When this variable is _\bs_\be_\bt, Mutt-ng will decode RFC-2047-encoded MIME parame-
7798        ters. You want to set this variable when Mutt-ng suggests you to save attach-
7799        ments to files named like this:
7800
7801        =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
7802
7803        When this variable is _\bs_\be_\bt interactively, the change doesn't have the desired
7804        effect before you have changed folders.
7805
7806        Note that this use of RFC 2047's encoding is explicitly, prohibited by the
7807        standard, but nevertheless encountered in the wild.
7808
7809        Also note that setting this parameter will _\bn_\bo_\bt have the effect that Mutt-ng
7810        _\bg_\be_\bn_\be_\br_\ba_\bt_\be_\bs this kind of encoding.  Instead, Mutt-ng will unconditionally use the
7811        encoding specified in RFC 2231.
7812
7813        _\b7_\b._\b4_\b._\b2_\b4_\b6  _\bs_\ba_\bv_\be_\b__\ba_\bd_\bd_\br_\be_\bs_\bs
7814
7815        Type: boolean
7816
7817        The Mutt Next Generation E-Mail Client                                      149
7818
7819        Default: no
7820
7821        If _\bs_\be_\bt, Mutt-ng will take the sender's full address when choosing a default
7822        folder for saving a mail. If ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.248  , page 149)'' or
7823        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.74  , page 106)'' is _\bs_\be_\bt too, the selection of the
7824        fcc folder will be changed as well.
7825
7826        _\b7_\b._\b4_\b._\b2_\b4_\b7  _\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by
7827
7828        Type: boolean
7829
7830        Default: yes
7831
7832        When _\bu_\bn_\bs_\be_\bt, mailboxes which contain no saved messages will be removed when
7833        closed (the exception is ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.304  , page 162)'' which is
7834        never removed).  If _\bs_\be_\bt, mailboxes are never removed.
7835
7836        N\bNo\bot\bte\be:\b: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH
7837        and Maildir directories.
7838
7839        _\b7_\b._\b4_\b._\b2_\b4_\b8  _\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be
7840
7841        Type: boolean
7842
7843        Default: no
7844
7845        This variable controls how copies of outgoing messages are saved.  When set, a
7846        check is made to see if a mailbox specified by the recipient address exists
7847        (this is done by searching for a mailbox in the ``_\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  ,
7848        page 104)'' directory with the _\bu_\bs_\be_\br_\bn_\ba_\bm_\be part of the recipient address).  If the
7849        mailbox exists, the outgoing message will be saved to that mailbox, otherwise
7850        the message is saved to the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.237  , page 146)'' mailbox.
7851
7852        Also see the ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.74  , page 106)'' variable.
7853
7854        _\b7_\b._\b4_\b._\b2_\b4_\b9  _\bs_\bc_\bo_\br_\be
7855
7856        Type: boolean
7857
7858        Default: yes
7859
7860        When this variable is _\bu_\bn_\bs_\be_\bt, scoring is turned off.  This can be useful to
7861        selectively disable scoring for certain folders when the ``_\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\b-
7862        _\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be (section 7.4.250  , page 149)'' variable and friends are used.
7863
7864        _\b7_\b._\b4_\b._\b2_\b5_\b0  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
7865
7866        Type: number
7867
7868        Default: -1
7869
7870        Messages which have been assigned a score equal to or lower than the value of
7871        this variable are automatically marked for deletion by Mutt-ng.  Since Mutt-ng
7872        scores are always greater than or equal to zero, the default setting of this
7873
7874        The Mutt Next Generation E-Mail Client                                      150
7875
7876        variable will never mark a message for deletion.
7877
7878        _\b7_\b._\b4_\b._\b2_\b5_\b1  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bf_\bl_\ba_\bg
7879
7880        Type: number
7881
7882        Default: 9999
7883
7884        Messages which have been assigned a score greater than or equal to this vari-
7885        able's value are automatically marked ``flagged''.
7886
7887        _\b7_\b._\b4_\b._\b2_\b5_\b2  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd
7888
7889        Type: number
7890
7891        Default: -1
7892
7893        Messages which have been assigned a score equal to or lower than the value of
7894        this variable are automatically marked as read by Mutt-ng.  Since Mutt-ng
7895        scores are always greater than or equal to zero, the default setting of this
7896        variable will never mark a message read.
7897
7898        _\b7_\b._\b4_\b._\b2_\b5_\b3  _\bs_\be_\bn_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
7899
7900        Type: string
7901
7902        Default: 'us-ascii:iso-8859-1:utf-8'
7903
7904        A list of character sets for outgoing messages. Mutt-ng will use the first
7905        character set into which the text can be converted exactly.  If your ``_\b$_\bc_\bh_\ba_\br_\bs_\be_\bt
7906        (section 7.4.27  , page 95)'' is not iso-8859-1 and recipients may not under-
7907        stand UTF-8, it is advisable to include in the list an appropriate widely used
7908        standard character set (such as iso-8859-2, koi8-r or iso-2022-jp) either
7909        instead of or after iso-8859-1.
7910
7911        _\b7_\b._\b4_\b._\b2_\b5_\b4  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl
7912
7913        Type: path
7914
7915        Default: '/usr/sbin/sendmail -oem -oi'
7916
7917        Specifies the program and arguments used to deliver mail sent by Mutt-ng.
7918        Mutt-ng expects that the specified program interprets additional arguments as
7919        recipient addresses.
7920
7921        _\b7_\b._\b4_\b._\b2_\b5_\b5  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl_\b__\bw_\ba_\bi_\bt
7922
7923        Type: number
7924
7925        Default: 0
7926
7927        Specifies the number of seconds to wait for the ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.254  ,
7928        page 150)'' process to finish before giving up and putting delivery in the
7929        background.
7930
7931        The Mutt Next Generation E-Mail Client                                      151
7932
7933        Mutt-ng interprets the value of this variable as follows:
7934
7935              >0
7936                    number of seconds to wait for sendmail to finish before continuing
7937
7938              0
7939                    wait forever for sendmail to finish
7940
7941              <0
7942                    always put sendmail in the background without waiting
7943
7944        Note that if you specify a value other than 0, the output of the child process
7945        will be put in a temporary file.  If there is some error, you will be informed
7946        as to where to find the output.
7947
7948        _\b7_\b._\b4_\b._\b2_\b5_\b6  _\bs_\bh_\be_\bl_\bl
7949
7950        Type: path
7951
7952        Default: ''
7953
7954        Command to use when spawning a subshell.  By default, the user's login shell
7955        from /etc/passwd is used.
7956
7957        _\b7_\b._\b4_\b._\b2_\b5_\b7  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by
7958
7959        Type: string
7960
7961        Default: '.'
7962
7963        When the sidebar is displayed and _\b$_\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bs_\bh_\bo_\br_\bt_\be_\bn_\b__\bh_\bi_\be_\br_\ba_\br_\bc_\bh_\by (section
7964        7.4.261  , page 152) is _\bs_\be_\bt, this variable specifies the characters at which to
7965        split a folder name into ``hierarchy items.''
7966
7967        _\b7_\b._\b4_\b._\b2_\b5_\b8  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bd_\be_\bl_\bi_\bm
7968
7969        Type: string
7970
7971        Default: '|'
7972
7973        This specifies the delimiter between the sidebar (if visible) and other
7974        screens.
7975
7976        _\b7_\b._\b4_\b._\b2_\b5_\b9  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\be_\bw_\bm_\ba_\bi_\bl_\b__\bo_\bn_\bl_\by
7977
7978        Type: boolean
7979
7980        Default: no
7981
7982        If _\bs_\be_\bt, only folders with new mail will be shown in the sidebar.
7983
7984        _\b7_\b._\b4_\b._\b2_\b6_\b0  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\bu_\bm_\bb_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
7985
7986        Type: string
7987
7988        The Mutt Next Generation E-Mail Client                                      152
7989
7990        Default: '%m%?n?(%n)?%?f?[%f]?'
7991
7992        This variable controls how message counts are printed when the sidebar is
7993        enabled. If this variable is _\be_\bm_\bp_\bt_\by (_\ba_\bn_\bd _\bo_\bn_\bl_\by _\bi_\bf), no numbers will be printed
7994        _\ba_\bn_\bd mutt-ng won't frequently count mail (which may be a great speedup esp. with
7995        mbox-style mailboxes.)
7996
7997        The following printf(3)-like sequences are supported all of which may be
7998        printed non-zero:
7999
8000              %d
8001                    Number of deleted messages. 1)
8002
8003              %F
8004                    Number of flagged messages.
8005
8006              %m
8007                    Total number of messages.
8008
8009              %M
8010                    Total number of messages shown, i.e. not hidden by a limit. 1)
8011
8012              %n
8013                    Number of new messages.
8014
8015              %t
8016                    Number of tagged messages. 1)
8017
8018        1) These expandos only have a non-zero value for the current mailbox and will
8019        always be zero otherwise.
8020
8021        _\b7_\b._\b4_\b._\b2_\b6_\b1  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bs_\bh_\bo_\br_\bt_\be_\bn_\b__\bh_\bi_\be_\br_\ba_\br_\bc_\bh_\by
8022
8023        Type: boolean
8024
8025        Default: no
8026
8027        When _\bs_\be_\bt, the ``hierarchy'' of the sidebar entries will be shortened only if
8028        they cannot be printed in full length (because ``_\b$_\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh (section
8029        7.4.263  , page 152)'' is set to a too low value). For example, if the news-
8030        group name ``de.alt.sysadmin.recovery'' doesn't fit on the screen, it'll get
8031        shortened ``d.a.s.recovery'' while ``de.alt.d0'' still would and thus will not
8032        get shortened.
8033
8034        At which characters this compression is done is controled via the _\b$_\bs_\bi_\bd_\be_\b-
8035        _\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by (section 7.4.257  , page 151) variable.
8036
8037        _\b7_\b._\b4_\b._\b2_\b6_\b2  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bv_\bi_\bs_\bi_\bb_\bl_\be
8038
8039        Type: boolean
8040
8041        Default: no
8042
8043        This specifies whether or not to show the sidebar (a list of folders specified
8044
8045        The Mutt Next Generation E-Mail Client                                      153
8046
8047        with the ``mailboxes'' command).
8048
8049        _\b7_\b._\b4_\b._\b2_\b6_\b3  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh
8050
8051        Type: number
8052
8053        Default: 0
8054
8055        The width of the sidebar.
8056
8057        _\b7_\b._\b4_\b._\b2_\b6_\b4  _\bs_\bi_\bg_\b__\bd_\ba_\bs_\bh_\be_\bs
8058
8059        Type: boolean
8060
8061        Default: yes
8062
8063        If set, a line containing ``-- '' (dash, dash, space) will be inserted before
8064        your ``_\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.266  , page 153)''.  It is s\bst\btr\bro\bon\bng\bgl\bly\by recommended
8065        that you not unset this variable unless your ``signature'' contains just your
8066        name. The reason for this is because many software packages use ``-- \n'' to
8067        detect your signature.
8068
8069        For example, Mutt-ng has the ability to highlight the signature in a different
8070        color in the builtin pager.
8071
8072        _\b7_\b._\b4_\b._\b2_\b6_\b5  _\bs_\bi_\bg_\b__\bo_\bn_\b__\bt_\bo_\bp
8073
8074        Type: boolean
8075
8076        Default: no
8077
8078        If _\bs_\be_\bt, the signature will be included before any quoted or forwarded text.  It
8079        is s\bst\btr\bro\bon\bng\bgl\bly\by recommended that you do not set this variable unless you really
8080        know what you are doing, and are prepared to take some heat from netiquette
8081        guardians.
8082
8083        _\b7_\b._\b4_\b._\b2_\b6_\b6  _\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be
8084
8085        Type: path
8086
8087        Default: '~/.signature'
8088
8089        Specifies the filename of your signature, which is appended to all outgoing
8090        messages.   If the filename ends with a pipe (``|''), it is assumed that file-
8091        name is a shell command and input should be read from its stdout.
8092
8093        _\b7_\b._\b4_\b._\b2_\b6_\b7  _\bs_\bi_\bg_\bn_\bo_\bf_\bf_\b__\bs_\bt_\br_\bi_\bn_\bg
8094
8095        Type: string
8096
8097        Default: ''
8098
8099        If _\bs_\be_\bt, this string will be inserted before the signature. This is useful for
8100        people that want to sign off every message they send with their name.
8101
8102        The Mutt Next Generation E-Mail Client                                      154
8103
8104        If you want to insert your website's URL, additional contact information or
8105        witty quotes into your mails, better use a signature file instead of the sig-
8106        noff string.
8107
8108        _\b7_\b._\b4_\b._\b2_\b6_\b8  _\bs_\bi_\bm_\bp_\bl_\be_\b__\bs_\be_\ba_\br_\bc_\bh
8109
8110        Type: string
8111
8112        Default: '~f %s | ~s %s'
8113
8114        Specifies how Mutt-ng should expand a simple search into a real search pattern.
8115        A simple search is one that does not contain any of the ~ operators.  See
8116        ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 83)'' for more information on search patterns.
8117
8118        For example, if you simply type ``joe'' at a search or limit prompt, Mutt-ng
8119        will automatically expand it to the value specified by this variable.  For the
8120        default value it would be:
8121
8122        ~f joe | ~s joe
8123
8124        _\b7_\b._\b4_\b._\b2_\b6_\b9  _\bs_\bl_\be_\be_\bp_\b__\bt_\bi_\bm_\be
8125
8126        Type: number
8127
8128        Default: 1
8129
8130        Specifies time, in seconds, to pause while displaying certain informational
8131        messages, while moving from folder to folder and after expunging messages from
8132        the current folder.  The default is to pause one second, so a value of zero for
8133        this option suppresses the pause.
8134
8135        _\b7_\b._\b4_\b._\b2_\b7_\b0  _\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp
8136
8137        Type: boolean
8138
8139        Default: yes
8140
8141        Controls the display of lines longer than the screen width in the internal
8142        pager. If _\bs_\be_\bt, long lines are wrapped at a word boundary.  If _\bu_\bn_\bs_\be_\bt, lines are
8143        simply wrapped at the screen edge. Also see the ``_\b$_\bm_\ba_\br_\bk_\be_\br_\bs (section 7.4.127  ,
8144        page 120)'' variable.
8145
8146        _\b7_\b._\b4_\b._\b2_\b7_\b1  _\bs_\bm_\bi_\bl_\be_\by_\bs
8147
8148        Type: regular expression
8149
8150        Default: '(>From )|(:[-^]?[][)(><}{|/DP])'
8151
8152        The _\bp_\ba_\bg_\be_\br uses this variable to catch some common false positives of
8153        ``_\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.232  , page 145)'', most notably smileys in the
8154        beginning of a line
8155
8156        _\b7_\b._\b4_\b._\b2_\b7_\b2  _\bs_\bm_\bi_\bm_\be_\b__\ba_\bs_\bk_\b__\bc_\be_\br_\bt_\b__\bl_\ba_\bb_\be_\bl
8157
8158        The Mutt Next Generation E-Mail Client                                      155
8159
8160        Type: boolean
8161
8162        Default: yes
8163
8164        This flag controls whether you want to be asked to enter a label for a certifi-
8165        cate about to be added to the database or not. It is _\bs_\be_\bt by default.  (S/MIME
8166        only)
8167
8168        _\b7_\b._\b4_\b._\b2_\b7_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn
8169
8170        Type: path
8171
8172        Default: ''
8173
8174        This variable contains the name of either a directory, or a file which contains
8175        trusted certificates for use with OpenSSL.  (S/MIME only)
8176
8177        _\b7_\b._\b4_\b._\b2_\b7_\b4  _\bs_\bm_\bi_\bm_\be_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs
8178
8179        Type: path
8180
8181        Default: ''
8182
8183        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage
8184        and retrieval of keys by itself. This is very basic right now, and keys and
8185        certificates are stored in two different directories, both named as the hash-
8186        value retrieved from OpenSSL. There is an index file which contains mailbox-
8187        address keyid pairs, and which can be manually edited. This one points to the
8188        location of the certificates.  (S/MIME only)
8189
8190        _\b7_\b._\b4_\b._\b2_\b7_\b5  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8191
8192        Type: string
8193
8194        Default: ''
8195
8196        This format string specifies a command which is used to decrypt application/x-
8197        pkcs7-mime attachments.
8198
8199        The OpenSSL command formats have their own set of printf(3)-like sequences sim-
8200        ilar to PGP's:
8201
8202              %f
8203                    Expands to the name of a file containing a message.
8204
8205              %s
8206                    Expands to the name of a file containing the signature part of a
8207                    multipart/signed attachment when verifying it.
8208
8209              %k
8210                    The key-pair specified with _\b$_\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by (section 7.4.277  ,
8211                    page 156)
8212
8213        The Mutt Next Generation E-Mail Client                                      156
8214
8215              %c
8216                    One or more certificate IDs.
8217
8218              %a
8219                    The algorithm used for encryption.
8220
8221              %C
8222                    CA location:  Depending on whether _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section
8223                    7.4.273  , page 155) points to a directory or file, this expands to
8224                    '-CApath _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.273  , page 155)' or
8225                    '-CAfile _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.273  , page 155)'.
8226
8227        For examples on how to configure these formats, see the smime.rc in the sam-
8228        ples/ subdirectory which has been installed on your system alongside the docu-
8229        mentation.  (S/MIME only)
8230
8231        _\b7_\b._\b4_\b._\b2_\b7_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bu_\bs_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by
8232
8233        Type: boolean
8234
8235        Default: yes
8236
8237        If _\bs_\be_\bt (default) this tells Mutt-ng to use the default key for decryption. Oth-
8238        erwise, if manage multiple certificate-key-pairs, Mutt-ng will try to use the
8239        mailbox-address to determine the key to use. It will ask you to supply a key,
8240        if it can't find one.  (S/MIME only)
8241
8242        _\b7_\b._\b4_\b._\b2_\b7_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by
8243
8244        Type: string
8245
8246        Default: ''
8247
8248        This is the default key-pair to use for signing. This must be set to the keyid
8249        (the hash-value that OpenSSL generates) to work properly (S/MIME only)
8250
8251        _\b7_\b._\b4_\b._\b2_\b7_\b8  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8252
8253        Type: string
8254
8255        Default: ''
8256
8257        This command is used to create encrypted S/MIME messages.  (S/MIME only)
8258
8259        _\b7_\b._\b4_\b._\b2_\b7_\b9  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bw_\bi_\bt_\bh
8260
8261        Type: string
8262
8263        Default: ''
8264
8265        This sets the algorithm that should be used for encryption.  Valid choices are
8266        ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``\frc2-128''.
8267
8268        If _\bu_\bn_\bs_\be_\bt ``_\b3_\bd_\be_\bs'' (TripleDES) is used.  (S/MIME only)
8269
8270        The Mutt Next Generation E-Mail Client                                      157
8271
8272        _\b7_\b._\b4_\b._\b2_\b8_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bg_\be_\bt_\b__\bc_\be_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8273
8274        Type: string
8275
8276        Default: ''
8277
8278        This command is used to extract X509 certificates from a PKCS7 structure.
8279        (S/MIME only)
8280
8281        _\b7_\b._\b4_\b._\b2_\b8_\b1  _\bs_\bm_\bi_\bm_\be_\b__\bg_\be_\bt_\b__\bc_\be_\br_\bt_\b__\be_\bm_\ba_\bi_\bl_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8282
8283        Type: string
8284
8285        Default: ''
8286
8287        This command is used to extract the mail address(es) used for storing X509 cer-
8288        tificates, and for verification purposes (to check whether the certificate was
8289        issued for the sender's mailbox).  (S/MIME only)
8290
8291        _\b7_\b._\b4_\b._\b2_\b8_\b2  _\bs_\bm_\bi_\bm_\be_\b__\bg_\be_\bt_\b__\bs_\bi_\bg_\bn_\be_\br_\b__\bc_\be_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8292
8293        Type: string
8294
8295        Default: ''
8296
8297        This command is used to extract only the signers X509 certificate from a S/MIME
8298        signature, so that the certificate's owner may get compared to the email's
8299        ``From:'' header field.  (S/MIME only)
8300
8301        _\b7_\b._\b4_\b._\b2_\b8_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bi_\bm_\bp_\bo_\br_\bt_\b__\bc_\be_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8302
8303        Type: string
8304
8305        Default: ''
8306
8307        This command is used to import a certificate via smime_keysng.  (S/MIME only)
8308
8309        _\b7_\b._\b4_\b._\b2_\b8_\b4  _\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt
8310
8311        Type: boolean
8312
8313        Default: no
8314
8315        The default behaviour of Mutt-ng is to use PGP on all auto-sign/encryption
8316        operations. To override and to use OpenSSL instead this must be _\bs_\be_\bt.
8317
8318        However, this has no effect while replying, since Mutt-ng will automatically
8319        select the same application that was used to sign/encrypt the original message.
8320
8321        (Note that this variable can be overridden by unsetting _\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bm_\bi_\bm_\be (sec-
8322        tion 7.4.40  , page 98).)  (S/MIME only)
8323
8324        _\b7_\b._\b4_\b._\b2_\b8_\b5  _\bs_\bm_\bi_\bm_\be_\b__\bk_\be_\by_\bs
8325
8326        The Mutt Next Generation E-Mail Client                                      158
8327
8328        Type: path
8329
8330        Default: ''
8331
8332        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage ad
8333        retrieval of keys/certs by itself. This is very basic right now, and stores
8334        keys and certificates in two different directories, both named as the hash-
8335        value retrieved from OpenSSL. There is an index file which contains mailbox-
8336        address keyid pair, and which can be manually edited. This one points to the
8337        location of the private keys.  (S/MIME only)
8338
8339        _\b7_\b._\b4_\b._\b2_\b8_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bp_\bk_\b7_\bo_\bu_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8340
8341        Type: string
8342
8343        Default: ''
8344
8345        This command is used to extract PKCS7 structures of S/MIME signatures, in order
8346        to extract the public X509 certificate(s).  (S/MIME only)
8347
8348        _\b7_\b._\b4_\b._\b2_\b8_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8349
8350        Type: string
8351
8352        Default: ''
8353
8354        This command is used to created S/MIME signatures of type multipart/signed,
8355        which can be read by all mail clients.  (S/MIME only)
8356
8357        _\b7_\b._\b4_\b._\b2_\b8_\b8  _\bs_\bm_\bi_\bm_\be_\b__\bs_\bi_\bg_\bn_\b__\bo_\bp_\ba_\bq_\bu_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8358
8359        Type: string
8360
8361        Default: ''
8362
8363        This command is used to created S/MIME signatures of type application/x-
8364        pkcs7-signature, which can only be handled by mail clients supporting the
8365        S/MIME extension.  (S/MIME only)
8366
8367        _\b7_\b._\b4_\b._\b2_\b8_\b9  _\bs_\bm_\bi_\bm_\be_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
8368
8369        Type: number
8370
8371        Default: 300
8372
8373        The number of seconds after which a cached passphrase will expire if not used.
8374        (S/MIME only)
8375
8376        _\b7_\b._\b4_\b._\b2_\b9_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8377
8378        Type: string
8379
8380        Default: ''
8381
8382        The Mutt Next Generation E-Mail Client                                      159
8383
8384        This command is used to verify S/MIME signatures of type multipart/signed.
8385        (S/MIME only)
8386
8387        _\b7_\b._\b4_\b._\b2_\b9_\b1  _\bs_\bm_\bi_\bm_\be_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bo_\bp_\ba_\bq_\bu_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8388
8389        Type: string
8390
8391        Default: ''
8392
8393        This command is used to verify S/MIME signatures of type application/x-
8394        pkcs7-mime.  (S/MIME only)
8395
8396        _\b7_\b._\b4_\b._\b2_\b9_\b2  _\bs_\bm_\bt_\bp_\b__\be_\bn_\bv_\be_\bl_\bo_\bp_\be
8397
8398        Type: string
8399
8400        Default: ''
8401
8402        Availability: SMTP
8403
8404        If this variable is non-empty, it'll be used as the envelope sender. If it's
8405        empty (the default), the value of the regular From: header will be used.
8406
8407        This may be necessary as some providers don't allow for arbitrary values as the
8408        envelope sender but only a particular one which may not be the same as the
8409        user's desired From: header.
8410
8411        _\b7_\b._\b4_\b._\b2_\b9_\b3  _\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt
8412
8413        Type: string
8414
8415        Default: ''
8416
8417        Availability: SMTP
8418
8419        Defines the SMTP host which will be used to deliver mail, as opposed to invok-
8420        ing the sendmail binary.  Setting this variable overrides the value of ``_\b$_\bs_\be_\bn_\bd_\b-
8421        _\bm_\ba_\bi_\bl (section 7.4.254  , page 150)'', and any associated variables.
8422
8423        _\b7_\b._\b4_\b._\b2_\b9_\b4  _\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs
8424
8425        Type: string
8426
8427        Default: ''
8428
8429        Availability: SMTP
8430
8431        Defines the password to use with SMTP AUTH.  If ``_\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section
8432        7.4.297  , page 160)'' is set, but this variable is not, you will be prompted
8433        for a password when sending.
8434
8435        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
8436        the superuser of your machine may read it regardless of the file's permissions.
8437
8438        The Mutt Next Generation E-Mail Client                                      160
8439
8440        _\b7_\b._\b4_\b._\b2_\b9_\b5  _\bs_\bm_\bt_\bp_\b__\bp_\bo_\br_\bt
8441
8442        Type: number
8443
8444        Default: 25
8445
8446        Availability: SMTP
8447
8448        Defines the port that the SMTP host is listening on for mail delivery.  Must be
8449        specified as a number.
8450
8451        Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers
8452        will probably desire 587, the mail submission port.
8453
8454        _\b7_\b._\b4_\b._\b2_\b9_\b6  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs
8455
8456        Type: string
8457
8458        Default: ''
8459
8460        Availability: SMTP (and SSL)
8461
8462        Defines wether to use STARTTLS. If this option is set to ``_\br_\be_\bq_\bu_\bi_\br_\be_\bd'' and the
8463        server does not support STARTTLS or there is an error in the TLS Handshake, the
8464        connection will fail. Setting this to ``_\be_\bn_\ba_\bb_\bl_\be_\bd'' will try to start TLS and
8465        continue without TLS in case of an error.  Muttng still needs to have SSL sup-
8466        port enabled in order to use it.
8467
8468        _\b7_\b._\b4_\b._\b2_\b9_\b7  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br
8469
8470        Type: string
8471
8472        Default: ''
8473
8474        Availability: SMTP
8475
8476        Defines the username to use with SMTP AUTH.  Setting this variable will cause
8477        Mutt-ng to attempt to use SMTP AUTH when sending.
8478
8479        _\b7_\b._\b4_\b._\b2_\b9_\b8  _\bs_\bo_\br_\bt
8480
8481        Type: sort order
8482
8483        Default: date
8484
8485        Specifies how to sort messages in the _\bi_\bn_\bd_\be_\bx menu.  Valid values are:
8486
8487        The Mutt Next Generation E-Mail Client                                      161
8488
8489                date or date-sent
8490                date-received
8491                from
8492                mailbox-order (unsorted)
8493                score
8494                size
8495                spam
8496                subject
8497                threads
8498                to
8499
8500        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8501        (example: set sort=reverse-date-sent).
8502
8503        _\b7_\b._\b4_\b._\b2_\b9_\b9  _\bs_\bo_\br_\bt_\b__\ba_\bl_\bi_\ba_\bs
8504
8505        Type: sort order
8506
8507        Default: alias
8508
8509        Specifies how the entries in the ``alias'' menu are sorted.  The following are
8510        legal values:
8511
8512                address (sort alphabetically by email address)
8513                alias (sort alphabetically by alias name)
8514                unsorted (leave in order specified in .muttrc)
8515
8516        _\b7_\b._\b4_\b._\b3_\b0_\b0  _\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8517
8518        Type: sort order
8519
8520        Default: date
8521
8522        When sorting by threads, this variable controls how threads are sorted in rela-
8523        tion to other threads, and how the branches of the thread trees are sorted.
8524        This can be set to any value that ``_\b$_\bs_\bo_\br_\bt (section 7.4.298  , page 160)'' can,
8525        except threads (in that case, Mutt-ng will just use date-sent).  You can also
8526        specify the ``last-'' prefix in addition to ``reverse-'' prefix, but last- must
8527        come after reverse-.  The last- prefix causes messages to be sorted against its
8528        siblings by which has the last descendant, using the rest of sort_aux as an
8529        ordering.
8530
8531        For instance, set sort_aux=last-date-received would mean that if a new message
8532        is received in a thread, that thread becomes the last one displayed (or the
8533        first, if you have set sort=reverse-threads.)
8534
8535        N\bNo\bot\bte\be:\b: For reversed ``_\b$_\bs_\bo_\br_\bt (section 7.4.298  , page 160)'' order _\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8536        (section 7.4.300  , page 161) is reversed again (which is not the right thing
8537        to do, but kept to not break any existing configuration setting).
8538
8539        The Mutt Next Generation E-Mail Client                                      162
8540
8541        _\b7_\b._\b4_\b._\b3_\b0_\b1  _\bs_\bo_\br_\bt_\b__\bb_\br_\bo_\bw_\bs_\be_\br
8542
8543        Type: sort order
8544
8545        Default: alpha
8546
8547        Specifies how to sort entries in the file browser.  By default, the entries are
8548        sorted alphabetically.  Valid values:
8549
8550                alpha (alphabetically)
8551                date
8552                size
8553                unsorted
8554
8555        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8556        (example: set sort_browser=reverse-date).
8557
8558        _\b7_\b._\b4_\b._\b3_\b0_\b2  _\bs_\bo_\br_\bt_\b__\br_\be
8559
8560        Type: boolean
8561
8562        Default: yes
8563
8564        This variable is only useful when sorting by threads with ``_\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
8565        (section 7.4.319  , page 167)'' _\bu_\bn_\bs_\be_\bt. In that case, it changes the heuristic
8566        Mutt-ng uses to thread messages by subject.  With _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.302  ,
8567        page 162) _\bs_\be_\bt, Mutt-ng will only attach a message as the child of another mes-
8568        sage by subject if the subject of the child message starts with a substring
8569        matching the setting of ``_\b$_\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.238  , page 146)''. With
8570        _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.302  , page 162) _\bu_\bn_\bs_\be_\bt, Mutt-ng will attach the message
8571        whether or not this is the case, as long as the non-``_\b$_\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp (section
8572        7.4.238  , page 146)'' parts of both messages are identical.
8573
8574        _\b7_\b._\b4_\b._\b3_\b0_\b3  _\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br
8575
8576        Type: string
8577
8578        Default: ','
8579
8580        ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.303  , page 162)'' controls what happens when
8581        multiple spam headers are matched: if _\bu_\bn_\bs_\be_\bt, each successive header will over-
8582        write any previous matches value for the spam label. If _\bs_\be_\bt, each successive
8583        match will append to the previous, using ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.303  ,
8584        page 162)'' as a separator.
8585
8586        _\b7_\b._\b4_\b._\b3_\b0_\b4  _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be
8587
8588        Type: path
8589
8590        Default: ''
8591
8592        If your spool mailbox is in a non-default place where Mutt-ng cannot find it,
8593
8594        The Mutt Next Generation E-Mail Client                                      163
8595
8596        you can specify its location with this variable.  Mutt-ng will automatically
8597        set this variable to the value of the environment variable $MAIL if it is not
8598        set.
8599
8600        _\b7_\b._\b4_\b._\b3_\b0_\b5  _\bs_\bs_\bl_\b__\bc_\ba_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs_\b__\bf_\bi_\bl_\be
8601
8602        Type: path
8603
8604        Default: ''
8605
8606        This variable specifies a file containing trusted CA certificates.  Any server
8607        certificate that is signed with one of these CA certificates are also automati-
8608        cally accepted.
8609
8610        Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
8611
8612        _\b7_\b._\b4_\b._\b3_\b0_\b6  _\bs_\bs_\bl_\b__\bc_\bl_\bi_\be_\bn_\bt_\b__\bc_\be_\br_\bt
8613
8614        Type: path
8615
8616        Default: ''
8617
8618        Availability: SSL
8619
8620        The file containing a client certificate and its associated private key.
8621
8622        _\b7_\b._\b4_\b._\b3_\b0_\b7  _\bs_\bs_\bl_\b__\bf_\bo_\br_\bc_\be_\b__\bt_\bl_\bs
8623
8624        Type: boolean
8625
8626        Default: no
8627
8628        If this variable is _\bs_\be_\bt, mutt-ng will require that all connections to remote
8629        servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
8630        server does not advertise the capability, since it would otherwise have to
8631        abort the connection anyway. This option supersedes ``_\b$_\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs (section
8632        7.4.309  , page 163)''.
8633
8634        _\b7_\b._\b4_\b._\b3_\b0_\b8  _\bs_\bs_\bl_\b__\bm_\bi_\bn_\b__\bd_\bh_\b__\bp_\br_\bi_\bm_\be_\b__\bb_\bi_\bt_\bs
8635
8636        Type: number
8637
8638        Default: 0
8639
8640        Availability: GNUTLS
8641
8642        This variable specifies the minimum acceptable prime size (in bits) for use in
8643        any Diffie-Hellman key exchange. A value of 0 will use the default from the
8644        GNUTLS library.
8645
8646        _\b7_\b._\b4_\b._\b3_\b0_\b9  _\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs
8647
8648        Type: quadoption
8649
8650        The Mutt Next Generation E-Mail Client                                      164
8651
8652        Default: yes
8653
8654        Availability: SSL or GNUTLS
8655
8656        If _\bs_\be_\bt (the default), Mutt-ng will attempt to use STARTTLS on servers advertis-
8657        ing the capability. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not attempt to use STARTTLS
8658        regardless of the server's capabilities.
8659
8660        _\b7_\b._\b4_\b._\b3_\b1_\b0  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b2
8661
8662        Type: boolean
8663
8664        Default: yes
8665
8666        Availability: SSL
8667
8668        This variables specifies whether to attempt to use SSLv2 in the SSL authentica-
8669        tion process.
8670
8671        _\b7_\b._\b4_\b._\b3_\b1_\b1  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b3
8672
8673        Type: boolean
8674
8675        Default: yes
8676
8677        Availability: SSL or GNUTLS
8678
8679        This variables specifies whether to attempt to use SSLv3 in the SSL authentica-
8680        tion process.
8681
8682        _\b7_\b._\b4_\b._\b3_\b1_\b2  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bt_\bl_\bs_\bv_\b1
8683
8684        Type: boolean
8685
8686        Default: yes
8687
8688        Availability: SSL or GNUTLS
8689
8690        This variables specifies whether to attempt to use TLSv1 in the SSL authentica-
8691        tion process.
8692
8693        _\b7_\b._\b4_\b._\b3_\b1_\b3  _\bs_\bs_\bl_\b__\bu_\bs_\be_\bs_\by_\bs_\bt_\be_\bm_\bc_\be_\br_\bt_\bs
8694
8695        Type: boolean
8696
8697        Default: yes
8698
8699        Availability: SSL
8700
8701        If set to _\by_\be_\bs, Mutt-ng will use CA certificates in the system-wide certificate
8702        store when checking if server certificate is signed by a trusted CA.
8703
8704        _\b7_\b._\b4_\b._\b3_\b1_\b4  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs
8705
8706        The Mutt Next Generation E-Mail Client                                      165
8707
8708        Type: string
8709
8710        Default: '-*%A'
8711
8712        Controls the characters used by the ``%r'' indicator in ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (sec-
8713        tion 7.4.315  , page 164)''. The first character is used when the mailbox is
8714        unchanged. The second is used when the mailbox has been changed, and it needs
8715        to be resynchronized. The third is used if the mailbox is in read-only mode, or
8716        if the mailbox will not be written when exiting that mailbox (You can toggle
8717        whether to write changes to a mailbox with the toggle-write operation, bound by
8718        default to ``%'').  The fourth  is used to indicate that the current folder has
8719        been opened in attach-message mode (Certain operations like composing a new
8720        mail, replying, forwarding, etc. are not permitted in this mode).
8721
8722        _\b7_\b._\b4_\b._\b3_\b1_\b5  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
8723
8724        Type: string
8725
8726        Default: '-%r-Mutt-ng: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d?
8727        Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l?
8728        %l?]---(%s/%S)-%>-(%P)---'
8729
8730        Controls the format of the status line displayed in the _\bi_\bn_\bd_\be_\bx menu.  This
8731        string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)'', but has
8732        its own set of printf(3)-like sequences:
8733
8734              %b
8735                    number of mailboxes with new mail *
8736
8737              %B
8738                    the short pathname of the current mailbox
8739
8740              %d
8741                    number of deleted messages *
8742
8743              %f
8744                    the full pathname of the current mailbox
8745
8746              %F
8747                    number of flagged messages *
8748
8749              %h
8750                    local hostname
8751
8752              %l
8753                    size (in bytes) of the current mailbox *
8754
8755              %L
8756                    size (in bytes) of the messages shown (i.e., which match the cur-
8757                    rent limit) *
8758
8759              %m
8760                    the number of messages in the mailbox *
8761
8762        The Mutt Next Generation E-Mail Client                                      166
8763
8764              %M
8765                    the number of messages shown (i.e., which match the current limit)
8766                    *
8767
8768              %n
8769                    number of new messages in the mailbox *
8770
8771              %o
8772                    number of old unread messages *
8773
8774              %p
8775                    number of postponed messages *
8776
8777              %P
8778                    percentage of the way through the index
8779
8780              %r
8781                    modified/read-only/won't-write/attach-message indicator, according
8782                    to _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs (section 7.4.314  , page 164)
8783
8784              %s
8785                    current sorting mode (_\b$_\bs_\bo_\br_\bt (section 7.4.298  , page 160))
8786
8787              %S
8788                    current aux sorting method (_\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx (section 7.4.300  , page
8789                    161))
8790
8791              %t
8792                    number of tagged messages *
8793
8794              %u
8795                    number of unread messages *
8796
8797              %v
8798                    Mutt-ng version string
8799
8800              %V
8801                    currently active limit pattern, if any *
8802
8803              %>X
8804                    right justify the rest of the string and pad with 'X'
8805
8806              %|X
8807                    pad to the end of the line with 'X'
8808
8809        * = can be optionally printed if nonzero
8810
8811        Some of the above sequences can be used to optionally print a string if their
8812        value is nonzero.  For example, you may only want to see the number of flagged
8813        messages if such messages exist, since zero is not particularly meaningful.  To
8814        optionally print a string based upon one of the above sequences, the following
8815        construct is used
8816
8817        %?<sequence_char>?<optional_string>?
8818
8819        The Mutt Next Generation E-Mail Client                                      167
8820
8821        where _\bs_\be_\bq_\bu_\be_\bn_\bc_\be_\b__\bc_\bh_\ba_\br is a character from the table above, and _\bo_\bp_\bt_\bi_\bo_\bn_\ba_\bl_\b__\bs_\bt_\br_\bi_\bn_\bg is
8822        the string you would like printed if _\bs_\be_\bq_\bu_\be_\bn_\bc_\be_\b__\bc_\bh_\ba_\br is nonzero.  _\bo_\bp_\bt_\bi_\bo_\bn_\ba_\bl_\b__\bs_\bt_\br_\bi_\bn_\bg
8823        m\bma\bay\by contain other sequences as well as normal text, but you may n\bno\bot\bt nest
8824        optional strings.
8825
8826        Here is an example illustrating how to optionally print the number of new mes-
8827        sages in a mailbox:
8828
8829        %?n?%n new messages.?
8830
8831        Additionally you can switch between two strings, the first one, if a value is
8832        zero, the second one, if the value is nonzero, by using the following con-
8833        struct:
8834
8835        %?<sequence_char>?<if_string>&<else_string>?
8836
8837        You can additionally force the result of any printf(3)-like sequence to be low-
8838        ercase by prefixing the sequence character with an underscore (_) sign.  For
8839        example, if you want to display the local hostname in lowercase, you would use:
8840
8841        %_h
8842
8843        If you prefix the sequence character with a colon (:) character, Mutt-ng will
8844        replace any dots in the expansion by underscores. This might be helpful with
8845        IMAP folders that don't like dots in folder names.
8846
8847        _\b7_\b._\b4_\b._\b3_\b1_\b6  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bo_\bn_\b__\bt_\bo_\bp
8848
8849        Type: boolean
8850
8851        Default: no
8852
8853        Setting this variable causes the ``status bar'' to be displayed on the first
8854        line of the screen rather than near the bottom.
8855
8856        _\b7_\b._\b4_\b._\b3_\b1_\b7  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo
8857
8858        Type: boolean
8859
8860        Default: yes
8861
8862        With mailto: style links, a body as well as arbitrary header information may be
8863        embedded. This may lead to (user) headers being overwriten without note if
8864        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102)'' is unset.
8865
8866        If this variable is _\bs_\be_\bt, mutt-ng is strict and allows anything to be changed.
8867        If it's _\bu_\bn_\bs_\be_\bt, all headers given will be prefixed with ``X-Mailto-'' and the
8868        message including headers will be shown in the editor regardless of what
8869        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102)'' is set to.
8870
8871        _\b7_\b._\b4_\b._\b3_\b1_\b8  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be
8872
8873        Type: boolean
8874
8875        The Mutt Next Generation E-Mail Client                                      168
8876
8877        Default: yes
8878
8879        When _\bu_\bn_\bs_\be_\bt, non MIME-compliant messages that doesn't have any charset indica-
8880        tion in the ``Content-Type:'' header field can be displayed (non MIME-compliant
8881        messages are often generated by old mailers or buggy mailers like MS Outlook
8882        Express).  See also _\b$_\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.13  , page 91).
8883
8884        This option also replaces linear-white-space between encoded-word and *text to
8885        a single space to prevent the display of MIME-encoded ``Subject:'' header field
8886        from being devided into multiple lines.
8887
8888        _\b7_\b._\b4_\b._\b3_\b1_\b9  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
8889
8890        Type: boolean
8891
8892        Default: no
8893
8894        If _\bs_\be_\bt, threading will only make use of the ``In-Reply-To:'' and ``Refer-
8895        ences:'' header fields when you ``_\b$_\bs_\bo_\br_\bt (section 7.4.298  , page 160)'' by mes-
8896        sage threads.  By default, messages with the same subject are grouped together
8897        in ``pseudo threads.''  This may not always be desirable, such as in a personal
8898        mailbox where you might have several unrelated messages with the subject ``hi''
8899        which will get grouped together.
8900
8901        _\b7_\b._\b4_\b._\b3_\b2_\b0  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs
8902
8903        Type: boolean
8904
8905        Default: no
8906
8907        When _\bs_\be_\bt, mutt-ng will remove the trailing part of the ``Subject:'' line which
8908        matches _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx (section 7.4.321  , page 168) when replying. This is
8909        useful to properly react on subject changes and reduce ``subject noise.'' (esp.
8910        in Usenet)
8911
8912        _\b7_\b._\b4_\b._\b3_\b2_\b1  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx
8913
8914        Type: regular expression
8915
8916        Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$'
8917
8918        When non-empty and _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs (section 7.4.320  , page 168) is _\bs_\be_\bt, mutt-ng
8919        will remove this trailing part of the ``Subject'' line when replying if it
8920        won't be empty afterwards.
8921
8922        _\b7_\b._\b4_\b._\b3_\b2_\b2  _\bs_\bt_\bu_\bf_\bf_\b__\bq_\bu_\bo_\bt_\be_\bd
8923
8924        Type: boolean
8925
8926        Default: no
8927
8928        If _\bs_\be_\bt, attachments with flowed format will have their quoting ``stuffed'',
8929        i.e. a space will be inserted between the quote characters and the actual text.
8930
8931        The Mutt Next Generation E-Mail Client                                      169
8932
8933        _\b7_\b._\b4_\b._\b3_\b2_\b3  _\bs_\bu_\bs_\bp_\be_\bn_\bd
8934
8935        Type: boolean
8936
8937        Default: yes
8938
8939        When _\bu_\bn_\bs_\be_\bt, Mutt-ng won't stop when the user presses the terminal's _\bs_\bu_\bs_\bp key,
8940        usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a com-
8941        mand like ``xterm -e muttng.''
8942
8943        _\b7_\b._\b4_\b._\b3_\b2_\b4  _\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd
8944
8945        Type: boolean
8946
8947        Default: no
8948
8949        When _\bs_\be_\bt, Mutt-ng will generate text/plain; format=flowed attachments.  This
8950        format is easier to handle for some mailing software, and generally just looks
8951        like ordinary text.  To actually make use of this format's features, you'll
8952        need support in your editor.
8953
8954        Note that _\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.115  , page 115) is ignored when this
8955        option is set.
8956
8957        _\b7_\b._\b4_\b._\b3_\b2_\b5  _\bt_\bh_\bo_\br_\bo_\bu_\bg_\bh_\b__\bs_\be_\ba_\br_\bc_\bh
8958
8959        Type: boolean
8960
8961        Default: no
8962
8963        Affects the ~b and ~h search operations described in section ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
8964        tion 7.2  , page 83)'' above.  If _\bs_\be_\bt, the headers and attachments of messages
8965        to be searched are decoded before searching.  If _\bu_\bn_\bs_\be_\bt, messages are searched
8966        as they appear in the folder.
8967
8968        _\b7_\b._\b4_\b._\b3_\b2_\b6  _\bt_\bh_\br_\be_\ba_\bd_\b__\br_\be_\bc_\be_\bi_\bv_\be_\bd
8969
8970        Type: boolean
8971
8972        Default: no
8973
8974        When _\bs_\be_\bt, Mutt-ng uses the date received rather than the date sent to thread
8975        messages by subject.
8976
8977        _\b7_\b._\b4_\b._\b3_\b2_\b7  _\bt_\bi_\bl_\bd_\be
8978
8979        Type: boolean
8980
8981        Default: no
8982
8983        When _\bs_\be_\bt, the internal-pager will pad blank lines to the bottom of the screen
8984        with a tilde (~).
8985
8986        The Mutt Next Generation E-Mail Client                                      170
8987
8988        _\b7_\b._\b4_\b._\b3_\b2_\b8  _\bt_\bi_\bm_\be_\bo_\bu_\bt
8989
8990        Type: number
8991
8992        Default: 600
8993
8994        This variable controls the _\bn_\bu_\bm_\bb_\be_\br _\bo_\bf _\bs_\be_\bc_\bo_\bn_\bd_\bs Mutt-ng will wait for a key to be
8995        pressed in the main menu before timing out and checking for new mail.  A value
8996        of zero or less will cause Mutt-ng to never time out.
8997
8998        _\b7_\b._\b4_\b._\b3_\b2_\b9  _\bt_\bm_\bp_\bd_\bi_\br
8999
9000        Type: path
9001
9002        Default: ''
9003
9004        This variable allows you to specify where Mutt-ng will place its temporary
9005        files needed for displaying and composing messages.  If this variable is not
9006        set, the environment variable $TMPDIR is used.  If $TMPDIR is not set then
9007        '/tmp' is used.
9008
9009        _\b7_\b._\b4_\b._\b3_\b3_\b0  _\bt_\bo_\b__\bc_\bh_\ba_\br_\bs
9010
9011        Type: string
9012
9013        Default: ' +TCFL'
9014
9015        Controls the character used to indicate mail addressed to you.  The first char-
9016        acter is the one used when the mail is NOT addressed to your address (default:
9017        space).  The second is used when you are the only recipient of the message
9018        (default: +).  The third is when your address appears in the ``To:'' header
9019        field, but you are not the only recipient of the message (default: T).  The
9020        fourth character is used when your address is specified in the ``Cc:'' header
9021        field, but you are not the only recipient.  The fifth character is used to
9022        indicate mail that was sent by _\by_\bo_\bu.  The sixth character is used to indicate
9023        when a mail was sent to a mailing-list you're subscribe to (default: L).
9024
9025        _\b7_\b._\b4_\b._\b3_\b3_\b1  _\bt_\br_\ba_\bs_\bh
9026
9027        Type: path
9028
9029        Default: ''
9030
9031        If _\bs_\be_\bt, this variable specifies the path of the trash folder where the mails
9032        marked for deletion will be moved, instead of being irremediably purged.
9033
9034        N\bNo\bot\bte\be: When you delete a message in the trash folder, it is really deleted, so
9035        that there is no way to recover mail.
9036
9037        _\b7_\b._\b4_\b._\b3_\b3_\b2  _\bt_\bu_\bn_\bn_\be_\bl
9038
9039        Type: string
9040
9041        Default: ''
9042
9043        The Mutt Next Generation E-Mail Client                                      171
9044
9045        Setting this variable will cause Mutt-ng to open a pipe to a command instead of
9046        a raw socket. You may be able to use this to set up preauthenticated connec-
9047        tions to your IMAP/POP3 server. Example:
9048
9049        tunnel='ssh -q mailhost.net /usr/local/libexec/imapd'
9050
9051        N\bNo\bot\bte\be:\b: For this example to work you must be able to log in to the remote machine
9052        without having to enter a password.
9053
9054        _\b7_\b._\b4_\b._\b3_\b3_\b3  _\bu_\bm_\ba_\bs_\bk
9055
9056        Type: number
9057
9058        Default: 0077
9059
9060        This sets the umask that will be used by Mutt-ng when creating all kinds of
9061        files. If _\bu_\bn_\bs_\be_\bt, the default value is 077.
9062
9063        _\b7_\b._\b4_\b._\b3_\b3_\b4  _\bu_\bn_\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bj_\bu_\bm_\bp
9064
9065        Type: boolean
9066
9067        Default: no
9068
9069        When _\bs_\be_\bt, Mutt-ng will jump to the next unread message, if any, when the cur-
9070        rent thread is _\bu_\bncollapsed.
9071
9072        _\b7_\b._\b4_\b._\b3_\b3_\b5  _\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be
9073
9074        Type: boolean
9075
9076        Default: no
9077
9078        W\bWa\bar\brn\bni\bin\bng\bg:\b: do not set this variable unless you are using a version of sendmail
9079        which supports the -B8BITMIME flag (such as sendmail 8.8.x) or in connection
9080        with the SMTP support via libESMTP.  Otherwise you may not be able to send
9081        mail.
9082
9083        When _\bs_\be_\bt, Mutt-ng will either invoke ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.254  , page
9084        150)'' with the -B8BITMIME flag when sending 8-bit messages to enable ESMTP
9085        negotiation or tell libESMTP to do so.
9086
9087        _\b7_\b._\b4_\b._\b3_\b3_\b6  _\bu_\bs_\be_\b__\bd_\bo_\bm_\ba_\bi_\bn
9088
9089        Type: boolean
9090
9091        Default: yes
9092
9093        When _\bs_\be_\bt, Mutt-ng will qualify all local addresses (ones without the @host por-
9094        tion) with the value of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section 7.4.95  , page 110)''.  If _\bu_\bn_\bs_\be_\bt,
9095        no addresses will be qualified.
9096
9097        _\b7_\b._\b4_\b._\b3_\b3_\b7  _\bu_\bs_\be_\b__\bf_\br_\bo_\bm
9098
9099        The Mutt Next Generation E-Mail Client                                      172
9100
9101        Type: boolean
9102
9103        Default: yes
9104
9105        When _\bs_\be_\bt, Mutt-ng will generate the ``From:'' header field when sending mes-
9106        sages. If _\bu_\bn_\bs_\be_\bt, no ``From:'' header field will be generated unless the user
9107        explicitly sets one using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37)'' command.
9108
9109        _\b7_\b._\b4_\b._\b3_\b3_\b8  _\bu_\bs_\be_\b__\bi_\bd_\bn
9110
9111        Type: boolean
9112
9113        Default: yes
9114
9115        Availability: IDN
9116
9117        When _\bs_\be_\bt, Mutt-ng will show you international domain names decoded.
9118
9119        N\bNo\bot\bte\be:\b: You can use IDNs for addresses even if this is _\bu_\bn_\bs_\be_\bt.  This variable only
9120        affects decoding.
9121
9122        _\b7_\b._\b4_\b._\b3_\b3_\b9  _\bu_\bs_\be_\b__\bi_\bp_\bv_\b6
9123
9124        Type: boolean
9125
9126        Default: yes
9127
9128        When _\bs_\be_\bt, Mutt-ng will look for IPv6 addresses of hosts it tries to contact.
9129        If this option is _\bu_\bn_\bs_\be_\bt, Mutt-ng will restrict itself to IPv4 addresses.  Nor-
9130        mally, the default should work.
9131
9132        _\b7_\b._\b4_\b._\b3_\b4_\b0  _\bv_\bi_\bs_\bu_\ba_\bl
9133
9134        Type: path
9135
9136        Default: ''
9137
9138        Specifies the visual editor to invoke when the _\b~_\bv command is given in the
9139        builtin editor.
9140
9141        _\b7_\b._\b4_\b._\b3_\b4_\b1  _\bw_\ba_\bi_\bt_\b__\bk_\be_\by
9142
9143        Type: boolean
9144
9145        Default: yes
9146
9147        Controls whether Mutt-ng will ask you to press a key after _\bs_\bh_\be_\bl_\bl_\b- _\be_\bs_\bc_\ba_\bp_\be, _\bp_\bi_\bp_\be_\b-
9148        _\bm_\be_\bs_\bs_\ba_\bg_\be, _\bp_\bi_\bp_\be_\b-_\be_\bn_\bt_\br_\by, _\bp_\br_\bi_\bn_\bt_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be, and _\bp_\br_\bi_\bn_\bt_\b-_\be_\bn_\bt_\br_\by commands.
9149
9150        It is also used when viewing attachments with ``_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page
9151        78)'', provided that the corresponding mailcap entry has a needsterminal flag,
9152        and the external program is interactive.
9153
9154        When _\bs_\be_\bt, Mutt-ng will always ask for a key. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will wait for
9155
9156        The Mutt Next Generation E-Mail Client                                      173
9157
9158        a key only if the external command returned a non-zero status.
9159
9160        _\b7_\b._\b4_\b._\b3_\b4_\b2  _\bw_\be_\be_\bd
9161
9162        Type: boolean
9163
9164        Default: yes
9165
9166        When _\bs_\be_\bt, Mutt-ng will weed headers when displaying, forwarding, printing, or
9167        replying to messages.
9168
9169        _\b7_\b._\b4_\b._\b3_\b4_\b3  _\bw_\br_\ba_\bp_\b__\bs_\be_\ba_\br_\bc_\bh
9170
9171        Type: boolean
9172
9173        Default: yes
9174
9175        Controls whether searches wrap around the end of the mailbox.
9176
9177        When _\bs_\be_\bt, searches will wrap around the first (or last) message. When _\bu_\bn_\bs_\be_\bt,
9178        searches will not wrap.
9179
9180        _\b7_\b._\b4_\b._\b3_\b4_\b4  _\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
9181
9182        Type: number
9183
9184        Default: 0
9185
9186        Controls the size of the margin remaining at the right side of the terminal
9187        when Mutt-ng's pager does smart wrapping.
9188
9189        _\b7_\b._\b4_\b._\b3_\b4_\b5  _\bw_\br_\bi_\bt_\be_\b__\bb_\bc_\bc
9190
9191        Type: boolean
9192
9193        Default: yes
9194
9195        Controls whether Mutt-ng writes out the Bcc header when preparing messages to
9196        be sent.  Exim users may wish to _\bu_\bn_\bs_\be_\bt this.
9197
9198        _\b7_\b._\b4_\b._\b3_\b4_\b6  _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc
9199
9200        Type: number
9201
9202        Default: 10
9203
9204        When writing a mailbox, a message will be printed every _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc messages to
9205        indicate progress.  If set to 0, only a single message will be displayed before
9206        writing a mailbox.
9207
9208        Also see the ``_\b$_\br_\be_\ba_\bd_\b__\bi_\bn_\bc (section 7.4.233  , page 145)'' variable.
9209
9210        _\b7_\b._\b4_\b._\b3_\b4_\b7  _\bx_\bt_\be_\br_\bm_\b__\bi_\bc_\bo_\bn
9211
9212        The Mutt Next Generation E-Mail Client                                      174
9213
9214        Type: string
9215
9216        Default: 'M%?n?AIL&ail?'
9217
9218        Controls the format of the X11 icon title, as long as _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (sec-
9219        tion 7.4.349  , page 174) is _\bs_\be_\bt. This string is identical in formatting to the
9220        one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.315  , page 164)''.
9221
9222        _\b7_\b._\b4_\b._\b3_\b4_\b8  _\bx_\bt_\be_\br_\bm_\b__\bl_\be_\ba_\bv_\be
9223
9224        Type: string
9225
9226        Default: ''
9227
9228        If _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.349  , page 174) is _\bs_\be_\bt, this string will be
9229        used to set the title when leaving mutt-ng. For terminal-based programs,
9230        there's no easy and portable way to read the current title so mutt-ng cannot
9231        read it upon startup and restore it when exiting.
9232
9233        Based on the xterm FAQ, the following might work:
9234
9235        set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME |
9236        cut -d ''' -f 2`'
9237
9238        _\b7_\b._\b4_\b._\b3_\b4_\b9  _\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs
9239
9240        Type: boolean
9241
9242        Default: no
9243
9244        Controls whether Mutt-ng sets the xterm title bar and icon name (as long as
9245        you're in an appropriate terminal). The default must be _\bu_\bn_\bs_\be_\bt to force in the
9246        validity checking.
9247
9248        _\b7_\b._\b4_\b._\b3_\b5_\b0  _\bx_\bt_\be_\br_\bm_\b__\bt_\bi_\bt_\bl_\be
9249
9250        Type: string
9251
9252        Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?'
9253
9254        Controls the format of the title bar of the xterm provided that
9255        _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.349  , page 174) has been _\bs_\be_\bt. This string is
9256        identical in formatting to the one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.315  ,
9257        page 164)''.
9258
9259        _\b7_\b._\b5  _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
9260
9261        The following is the list of available functions listed by the mapping in which
9262        they are available.  The default key setting is given, and an explanation of
9263        what the function does.  The key bindings of these functions can be changed
9264        with the _\bb_\bi_\bn_\bd (section 3.5  , page 26) command.
9265
9266        _\b7_\b._\b5_\b._\b1  _\bg_\be_\bn_\be_\br_\bi_\bc
9267
9268        The Mutt Next Generation E-Mail Client                                      175
9269
9270        The _\bg_\be_\bn_\be_\br_\bi_\bc menu is not a real menu, but specifies common functions (such as
9271        movement) available in all menus except for _\bp_\ba_\bg_\be_\br and _\be_\bd_\bi_\bt_\bo_\br.  Changing set-
9272        tings for this menu will affect the default bindings for all menus (except as
9273        noted).
9274
9275             bottom-page                L   move to the bottom of the page
9276             current-bottom     not bound   move current entry to bottom of page
9277             current-middle     not bound   move current entry to middle of page
9278             current-top        not bound   move current entry to top of page
9279             enter-command              :   enter a muttngrc command
9280             exit                       q   exit this menu
9281             first-entry                =   move to the first entry
9282             half-down                  ]   scroll down 1/2 page
9283             half-up                    [   scroll up 1/2 page
9284             help                       ?   this screen
9285             jump                  number   jump to an index number
9286             last-entry                 *   move to the last entry
9287             middle-page                M   move to the middle of the page
9288             next-entry                 j   move to the next entry
9289             next-line                  >   scroll down one line
9290             next-page                  z   move to the next page
9291             previous-entry             k   move to the previous entry
9292             previous-line              <   scroll up one line
9293             previous-page              Z   move to the previous page
9294             refresh                   ^L   clear and redraw the screen
9295             search                     /   search for a regular expression
9296             search-next                n   search for next match
9297             search-opposite    not bound   search for next match in opposite direction
9298             search-reverse         ESC /   search backwards for a regular expression
9299             select-entry             RET   select the current entry
9300             shell-escape               !   run a program in a subshell
9301             tag-entry                  t   toggle the tag on the current entry
9302             tag-prefix                 ;   apply next command to tagged entries
9303             tag-prefix-cond    not bound   apply next function ONLY to tagged messages
9304             top-page                   H   move to the top of the page
9305             what-key           not bound   display the keycode for a key press
9306
9307        _\b7_\b._\b5_\b._\b2  _\bi_\bn_\bd_\be_\bx
9308
9309        The Mutt Next Generation E-Mail Client                                      176
9310
9311             bounce-message             b   remail a message to another user
9312             change-folder              c   open a different folder
9313             change-folder-readonly ESC c   open a different folder in read only mode
9314             check-traditional-pgp  ESC P   check for classic pgp
9315             clear-flag                 W   clear a status flag from a message
9316             copy-message               C   copy a message to a file/mailbox
9317             create-alias               a   create an alias from a message sender
9318             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9319             decode-save            ESC s   decode a message and save it to a file/mailbox
9320             delete-message             d   delete the current entry
9321             delete-pattern             D   delete messages matching a pattern
9322             delete-subthread       ESC d   delete all messages in subthread
9323             delete-thread             ^D   delete all messages in thread
9324             display-address            @   display full address of sender
9325             display-toggle-weed        h   display message and toggle header weeding
9326             display-message          RET   display a message
9327             edit                       e   edit the current message
9328             edit-type                 ^E   edit the current message's Content-Type
9329             exit                       x   exit without saving changes
9330             extract-keys              ^K   extract PGP public keys
9331             fetch-mail                 G   retrieve mail from POP server
9332             flag-message               F   toggle a message's 'important' flag
9333             forget-passphrase         ^F   wipe PGP passphrase from memory
9334             forward-message            f   forward a message with comments
9335             group-reply                g   reply to all recipients
9336             limit                      l   show only messages matching a pattern
9337             list-reply                 L   reply to specified mailing list
9338             mail                       m   compose a new mail message
9339             mail-key               ESC k   mail a PGP public key
9340             next-new                 TAB   jump to the next new message
9341             next-subthread         ESC n   jump to the next subthread
9342             next-thread               ^N   jump to the next thread
9343             next-undeleted             j   move to the next undeleted message
9344             next-unread        not bound   jump to the next unread message
9345             parent-message             P   jump to parent message in thread
9346             pipe-message               |   pipe message/attachment to a shell command
9347             previous-new         ESC TAB   jump to the previous new message
9348             previous-page              Z   move to the previous page
9349             previous-subthread     ESC p   jump to previous subthread
9350             previous-thread           ^P   jump to previous thread
9351             previous-undeleted         k   move to the last undelete message
9352             previous-unread    not bound   jump to the previous unread message
9353             print-message              p   print the current entry
9354             query                      Q   query external program for addresses
9355             quit                       q   save changes to mailbox and quit
9356             read-subthread         ESC r   mark the current subthread as read
9357             read-thread               ^R   mark the current thread as read
9358             recall-message             R   recall a postponed message
9359             reply                      r   reply to a message
9360             resend-message         ESC e   resend message and preserve MIME structure
9361             save-message               s   save message/attachment to a file
9362             set-flag                   w   set a status flag on a message
9363             show-version               V   show the Mutt-ng version number and date
9364             show-limit             ESC l   show currently active limit pattern, if any
9365
9366        The Mutt Next Generation E-Mail Client                                      177
9367
9368             sort-mailbox               o   sort messages
9369             sort-reverse               O   sort messages in reverse order
9370             sync-mailbox               $   save changes to mailbox
9371             tag-pattern                T   tag messages matching a pattern
9372             tag-thread             ESC t   tag/untag all messages in the current thread
9373             toggle-new                 N   toggle a message's 'new' flag
9374             toggle-write               %   toggle whether the mailbox will be rewritten
9375             undelete-message           u   undelete the current entry
9376             undelete-pattern           U   undelete messages matching a pattern
9377             undelete-subthread     ESC u   undelete all messages in subthread
9378             undelete-thread           ^U   undelete all messages in thread
9379             untag-pattern             ^T   untag messages matching a pattern
9380             view-attachments           v   show MIME attachments
9381
9382        _\b7_\b._\b5_\b._\b3  _\bp_\ba_\bg_\be_\br
9383
9384        The Mutt Next Generation E-Mail Client                                      178
9385
9386             bottom             not bound   jump to the bottom of the message
9387             bounce-message             b   remail a message to another user
9388             change-folder              c   open a different folder
9389             change-folder-readonly ESC c   open a different folder in read only mode
9390             check-traditional-pgp  ESC P   check for classic pgp
9391             copy-message               C   copy a message to a file/mailbox
9392             create-alias               a   create an alias from a message sender
9393             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9394             decode-save            ESC s   decode a message and save it to a file/mailbox
9395             delete-message             d   delete the current entry
9396             delete-subthread       ESC d   delete all messages in subthread
9397             delete-thread             ^D   delete all messages in thread
9398             display-address            @   display full address of sender
9399             display-toggle-weed        h   display message and toggle header weeding
9400             edit                       e   edit the current message
9401             edit-type                 ^E   edit the current message's Content-Type
9402             enter-command              :   enter a muttngrc command
9403             exit                       i   return to the main-menu
9404             extract-keys              ^K   extract PGP public keys
9405             flag-message               F   toggle a message's 'important' flag
9406             forget-passphrase         ^F   wipe PGP passphrase from memory
9407             forward-message            f   forward a message with comments
9408             group-reply                g   reply to all recipients
9409             half-up            not bound   move up one-half page
9410             half-down          not bound   move down one-half page
9411             help                       ?   this screen
9412             list-reply                 L   reply to specified mailing list
9413             mail                       m   compose a new mail message
9414             mail-key               ESC k   mail a PGP public key
9415             mark-as-new                N   toggle a message's 'new' flag
9416             next-line                RET   scroll down one line
9417             next-entry                 J   move to the next entry
9418             next-new                 TAB   jump to the next new message
9419             next-page                      move to the next page
9420             next-subthread         ESC n   jump to the next subthread
9421             next-thread               ^N   jump to the next thread
9422             next-undeleted             j   move to the next undeleted message
9423             next-unread        not bound   jump to the next unread message
9424             parent-message             P   jump to parent message in thread
9425             pipe-message               |   pipe message/attachment to a shell command
9426             previous-line      BackSpace   scroll up one line
9427             previous-entry             K   move to the previous entry
9428             previous-new       not bound   jump to the previous new message
9429             previous-page              -   move to the previous page
9430             previous-subthread     ESC p   jump to previous subthread
9431             previous-thread           ^P   jump to previous thread
9432             previous-undeleted         k   move to the last undelete message
9433             previous-unread    not bound   jump to the previous unread message
9434             print-message              p   print the current entry
9435             quit                       Q   save changes to mailbox and quit
9436             read-subthread         ESC r   mark the current subthread as read
9437             read-thread               ^R   mark the current thread as read
9438             recall-message             R   recall a postponed message
9439             redraw-screen             ^L   clear and redraw the screen
9440
9441        The Mutt Next Generation E-Mail Client                                      179
9442
9443             reply                      r   reply to a message
9444             save-message               s   save message/attachment to a file
9445             search                     /   search for a regular expression
9446             search-next                n   search for next match
9447             search-opposite    not bound   search for next match in opposite direction
9448             search-reverse         ESC /   search backwards for a regular expression
9449             search-toggle              \   toggle search pattern coloring
9450             shell-escape               !   invoke a command in a subshell
9451             show-version               V   show the Mutt-ng version number and date
9452             skip-quoted                S   skip beyond quoted text
9453             sync-mailbox               $   save changes to mailbox
9454             tag-message                t   tag a message
9455             toggle-quoted              T   toggle display of quoted text
9456             top                        ^   jump to the top of the message
9457             undelete-message           u   undelete the current entry
9458             undelete-subthread     ESC u   undelete all messages in subthread
9459             undelete-thread           ^U   undelete all messages in thread
9460             view-attachments           v   show MIME attachments
9461
9462        _\b7_\b._\b5_\b._\b4  _\ba_\bl_\bi_\ba_\bs
9463
9464             search                     /   search for a regular expression
9465             search-next                n   search for next match
9466             search-reverse         ESC /   search backwards for a regular expression
9467
9468        _\b7_\b._\b5_\b._\b5  _\bq_\bu_\be_\br_\by
9469
9470             create-alias               a   create an alias from a message sender
9471             mail                       m   compose a new mail message
9472             query                      Q   query external program for addresses
9473             query-append               A   append new query results to current results
9474             search                     /   search for a regular expression
9475             search-next                n   search for next match
9476             search-opposite    not bound   search for next match in opposite direction
9477             search-reverse         ESC /   search backwards for a regular expression
9478
9479        _\b7_\b._\b5_\b._\b6  _\ba_\bt_\bt_\ba_\bc_\bh
9480
9481        The Mutt Next Generation E-Mail Client                                      180
9482
9483             bounce-message             b   remail a message to another user
9484             collapse-parts             v   toggle display of subparts
9485             delete-entry               d   delete the current entry
9486             display-toggle-weed        h   display message and toggle header weeding
9487             edit-type                 ^E   edit the current entry's Content-Type
9488             extract-keys              ^K   extract PGP public keys
9489             forward-message            f   forward a message with comments
9490             group-reply                g   reply to all recipients
9491             list-reply                 L   reply to specified mailing list
9492             pipe-entry                 |   pipe message/attachment to a shell command
9493             print-entry                p   print the current entry
9494             reply                      r   reply to a message
9495             resend-message         ESC e   resend message and preserve MIME structure
9496             save-entry                 s   save message/attachment to a file
9497             undelete-entry             u   undelete the current entry
9498             view-attach              RET   view attachment using mailcap entry if necessary
9499             view-mailcap               m   force viewing of attachment using mailcap
9500             view-text                  T   view attachment as text
9501
9502        _\b7_\b._\b5_\b._\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be
9503
9504        The Mutt Next Generation E-Mail Client                                      181
9505
9506             attach-file                a   attach a file(s) to this message
9507             attach-message             A   attach message(s) to this message
9508             attach-key             ESC k   attach a PGP public key
9509             copy-file                  C   save message/attachment to a file
9510             detach-file                D   delete the current entry
9511             display-toggle-weed        h   display message and toggle header weeding
9512             edit-bcc                   b   edit the BCC list
9513             edit-cc                    c   edit the CC list
9514             edit-description           d   edit attachment description
9515             edit-encoding             ^E   edit attachment transfer-encoding
9516             edit-fcc                   f   enter a file to save a copy of this message in
9517             edit-from              ESC f   edit the from: field
9518             edit-file               ^X e   edit the file to be attached
9519             edit-headers               E   edit the message with headers
9520             edit                       e   edit the message
9521             edit-mime                  m   edit attachment using mailcap entry
9522             edit-reply-to              r   edit the Reply-To field
9523             edit-subject               s   edit the subject of this message
9524             edit-to                    t   edit the TO list
9525             edit-type                 ^T   edit attachment type
9526             filter-entry               F   filter attachment through a shell command
9527             forget-passphrase         ^F   wipe PGP passphrase from memory
9528             ispell                     i   run ispell on the message
9529             new-mime                   n   compose new attachment using mailcap entry
9530             pgp-menu                   p   show PGP options
9531             pipe-entry                 |   pipe message/attachment to a shell command
9532             postpone-message           P   save this message to send later
9533             print-entry                l   print the current entry
9534             rename-file                R   rename/move an attached file
9535             send-message               y   send the message
9536             toggle-unlink              u   toggle whether to delete file after sending it
9537             view-attach              RET   view attachment using mailcap entry if necessary
9538             write-fcc         w   write the message to a folder
9539
9540        _\b7_\b._\b5_\b._\b8  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
9541
9542             delete-entry               d   delete the current entry
9543             undelete-entry             u   undelete the current entry
9544
9545        _\b7_\b._\b5_\b._\b9  _\bb_\br_\bo_\bw_\bs_\be_\br
9546
9547        The Mutt Next Generation E-Mail Client                                      182
9548
9549             change-dir                 c   change directories
9550             check-new                TAB   check mailboxes for new mail
9551             enter-mask                 m   enter a file mask
9552             search                     /   search for a regular expression
9553             search-next                n   search for next match
9554             search-reverse         ESC /   search backwards for a regular expression
9555             select-new                 N   select a new file in this directory
9556             sort                       o   sort messages
9557             sort-reverse               O   sort messages in reverse order
9558             toggle-mailboxes         TAB   toggle whether to browse mailboxes or all files
9559             view-file              SPACE   view file
9560             subscribe                  s   subscribe to current mailbox (IMAP Only)
9561             unsubscribe                u   unsubscribe to current mailbox (IMAP Only)
9562             toggle-subscribed          T   toggle view all/subscribed mailboxes (IMAP Only)
9563
9564        _\b7_\b._\b5_\b._\b1_\b0  _\bp_\bg_\bp
9565
9566             view-name                  %   view the key's user id
9567             verify-key                 c   verify a PGP public key
9568
9569        _\b7_\b._\b5_\b._\b1_\b1  _\be_\bd_\bi_\bt_\bo_\br
9570
9571             backspace          BackSpace   delete the char in front of the cursor
9572             backward-char             ^B   move the cursor one character to the left
9573             backward-word          ESC b   move the cursor to the previous word
9574             bol                       ^A   jump to the beginning of the line
9575             buffy-cycle            Space   cycle among incoming mailboxes
9576             capitalize-word        ESC c   uppercase the first character in the word
9577             complete                 TAB   complete filename or alias
9578             complete-query            ^T   complete address with query
9579             delete-char               ^D   delete the char under the cursor
9580             downcase-word          ESC l   lowercase all characters in current word
9581             eol                       ^E   jump to the end of the line
9582             forward-char              ^F   move the cursor one character to the right
9583             forward-word           ESC f   move the cursor to the next word
9584             history-down       not bound   scroll down through the history list
9585             history-up         not bound   scroll up through the history list
9586             kill-eol                  ^K   delete chars from cursor to end of line
9587             kill-eow               ESC d   delete chars from cursor to end of word
9588             kill-line                 ^U   delete all chars on the line
9589             kill-word                 ^W   delete the word in front of the cursor
9590             quote-char                ^V   quote the next typed key
9591             transpose-chars    not bound   transpose character under cursor with previous
9592             upcase-word            ESC u   uppercase all characters in current word
9593
9594        _\b8_\b.  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\by
9595
9596        The Mutt Next Generation E-Mail Client                                      183
9597
9598        _\b8_\b._\b1  _\bA_\bc_\bk_\bn_\bo_\bw_\bl_\be_\bd_\bg_\bm_\be_\bn_\bt_\bs
9599
9600        Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
9601        back in the ELM-ME days.
9602
9603        The following people have been very helpful to the development of Mutt:
9604
9605        Vikas Agnihotri <vikasa@writeme.com>,
9606
9607        Francois Berjon <Francois.Berjon@aar.alcatel-alsthom.fr>,
9608
9609        Aric Blumer <aric@fore.com>,
9610
9611        John Capo <jc@irbs.com>,
9612
9613        David Champion <dgc@uchicago.edu,
9614
9615        Brendan Cully <brendan@kublai.com>,
9616
9617        Liviu Daia <daia@stoilow.imar.ro>,
9618
9619        Thomas E. Dickey <dickey@herndon4.his.com>,
9620
9621        David DeSimone <fox@convex.hp.com>,
9622
9623        Nickolay N. Dudorov <nnd@wint.itfs.nsk.su>,
9624
9625        Ruslan Ermilov <ru@freebsd.org>,
9626
9627        Edmund Grimley Evans <edmundo@rano.org,
9628
9629        Michael Finken <finken@conware.de>,
9630
9631        Sven Guckes <guckes@math.fu-berlin.de>,
9632
9633        Lars Hecking <lhecking@nmrc.ie>,
9634
9635        Mark Holloman <holloman@nando.net>,
9636
9637        Andreas Holzmann <holzmann@fmi.uni-passau.de>,
9638
9639        Marco d'Itri <md@linux.it>,
9640
9641        Bjrn Jacke <bjacke@suse.com>,
9642
9643        Byrial Jensen <byrial@image.dk>,
9644
9645        David Jeske <jeske@igcom.net>,
9646
9647        Christophe Kalt <kalt@hugo.int-evry.fr>,
9648
9649        Tommi Komulainen <Tommi.Komulainen@iki.fi>,
9650
9651        Felix von Leitner (a.k.a ``Fefe'') <leitner@math.fu-berlin.de>,
9652
9653        The Mutt Next Generation E-Mail Client                                      184
9654
9655        Brandon Long <blong@fiction.net>,
9656
9657        Jimmy Mkel <jmy@flashback.net>,
9658
9659        Lars Marowsky-Bree <lmb@pointer.in-minden.de>,
9660
9661        Thomas ``Mike'' Michlmayr <mike@cosy.sbg.ac.at>,
9662
9663        Andrew W. Nosenko <awn@bcs.zp.ua>,
9664
9665        David O'Brien <obrien@Nuxi.cs.ucdavis.edu>,
9666
9667        Clint Olsen <olsenc@ichips.intel.com>,
9668
9669        Park Myeong Seok <pms@romance.kaist.ac.kr>,
9670
9671        Thomas Parmelan <tom@ankh.fr.eu.org>,
9672
9673        Ollivier Robert <roberto@keltia.freenix.fr>,
9674
9675        Thomas Roessler <roessler@does-not-exist.org>,
9676
9677        Roland Rosenfeld <roland@spinnaker.de>,
9678
9679        TAKIZAWA Takashi <taki@luna.email.ne.jp>,
9680
9681        Allain Thivillon <Allain.Thivillon@alma.fr>,
9682
9683        Gero Treuner <gero@faveve.uni-stuttgart.de>,
9684
9685        Vsevolod Volkov <vvv@lucky.net>,
9686
9687        Ken Weinert <kenw@ihs.com>
9688
9689        Mutt-ng is developed by the following people:
9690
9691        Andreas Krennmair <ak@synflood.at>
9692
9693        Nico Golde <nico@ngolde.de>
9694
9695        Rocco Rutte <pdmef@cs.tu-berlin.de>
9696
9697        The following people have been very helpful to the development of  Mutt-ng:
9698
9699        Christian Gall <cg@cgall.de>
9700
9701        Iain Lea <iain@bricbrac.de>
9702
9703        Andreas Kneib <akneib@gmx.net>
9704
9705        Carsten Schoelzki <cjs@weisshuhn.de>
9706
9707        Elimar Riesebieter <riesebie@lxtec.de>
9708
9709        The Mutt Next Generation E-Mail Client                                      185
9710
9711        _\b8_\b._\b2  _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt
9712
9713        This document was written in SGML, and then rendered using the sgml-tools pack-
9714        age.
9715
9716        The Mutt Next Generation E-Mail Client                                      186
9717
9718                                           CONTENTS
9719
9720        1.  Introduction   .......................................................... 1
9721            1.1   Overview   ........................................................ 1
9722            1.2   Mutt-ng Home Page   ............................................... 1
9723            1.3   Mailing Lists   ................................................... 1
9724            1.4   Software Distribution Sites   ..................................... 2
9725            1.5   IRC   ............................................................. 2
9726            1.6   Weblog   .......................................................... 2
9727            1.7   Copyright   ....................................................... 2
9728
9729        2.  Getting Started     ..................................................... 2
9730            2.1   Basic Concepts       .............................................. 2
9731                  2.1.1    Screens and Menus           3
9732                  2.1.2    Configuration           3
9733                  2.1.3    Functions           3
9734                  2.1.4    Interaction           4
9735                  2.1.5    Modularization           4
9736                  2.1.6    Patterns           4
9737            2.2   Screens and Menus       ........................................... 4
9738                  2.2.1    Index          4
9739                  2.2.2    Pager          5
9740                  2.2.3    File Browser           5
9741                  2.2.4    Sidebar           5
9742                  2.2.5    Help           5
9743                  2.2.6    Compose Menu             6
9744                  2.2.7    Alias Menu             6
9745                  2.2.8    Attachment Menu             6
9746                  2.2.9    Key Menu             6
9747            2.3   Moving Around in Menus   .......................................... 6
9748            2.4   Editing Input Fields   ............................................ 7
9749            2.5   Reading Mail - The Index and Pager   .............................. 8
9750                  2.5.1    The Message Index   8
9751                  2.5.2    The Pager   9
9752                  2.5.3    Threaded Mode   11
9753                  2.5.4    Miscellaneous Functions   11
9754            2.6   Sending Mail   ................................................... 14
9755                  2.6.1    Composing new messages     14
9756                  2.6.2    Replying         16
9757                  2.6.3    Editing the message header     17
9758                  2.6.4    Using Mutt-ng with PGP     18
9759                  2.6.5    Sending anonymous messages via mixmaster     19
9760            2.7   Forwarding and Bouncing Mail   ................................... 19
9761            2.8   Postponing Mail   ................................................ 20
9762
9763        3.  Configuration   ........................................................ 21
9764            3.1   Locations of Configuration Files   ............................... 21
9765            3.2   Basic Syntax of Initialization Files   ........................... 21
9766            3.3   Variable Expansion     ........................................... 23
9767                  3.3.1    Commands' Output        23
9768                  3.3.2    Environment Variables        23
9769
9770                                               i
9771
9772                  3.3.3    Configuration Variables        23
9773                  3.3.4    Self-Defined Variables        23
9774                  3.3.5    Type Conversions        25
9775            3.4   Defining/Using aliases   ......................................... 25
9776            3.5   Changing the default key bindings   .............................. 26
9777            3.6   Defining aliases for character sets    ........................... 28
9778            3.7   Setting variables based upon mailbox   ........................... 28
9779            3.8   Keyboard macros   ................................................ 29
9780            3.9   Using color and mono video attributes   .......................... 30
9781            3.10  Ignoring (weeding) unwanted message headers   .................... 32
9782            3.11  Alternative addresses   .......................................... 33
9783            3.12  Format = Flowed     .............................................. 33
9784                  3.12.1   Introduction         33
9785                  3.12.2   Receiving: Display Setup         33
9786                  3.12.3   Sending         34
9787                  3.12.4   Additional Notes    35
9788            3.13  Mailing lists   .................................................. 35
9789            3.14  Using Multiple spool mailboxes   ................................. 36
9790            3.15  Defining mailboxes which receive mail   .......................... 36
9791            3.16  User defined headers   ........................................... 37
9792            3.17  Defining the order of headers when viewing messages   ............ 38
9793            3.18  Specify default save filename   .................................. 38
9794            3.19  Specify default Fcc: mailbox when composing   .................... 38
9795            3.20  Specify default save filename and default Fcc: mailbox at once   . 39
9796            3.21  Change settings based upon message recipients   .................. 39
9797            3.22  Change settings before formatting a message   .................... 40
9798            3.23  Choosing the cryptographic key of the recipient   ................ 40
9799            3.24  Adding key sequences to the keyboard buffer   .................... 40
9800            3.25  Executing functions   ............................................ 41
9801            3.26  Message Scoring   ................................................ 41
9802            3.27  Spam detection   ................................................. 42
9803            3.28  Setting variables   .............................................. 44
9804            3.29  Reading initialization commands from another file   .............. 45
9805            3.30  Removing hooks   ................................................. 45
9806            3.31  Sharing Setups       ............................................. 45
9807                  3.31.1   Character Sets         45
9808                  3.31.2   Modularization           46
9809                  3.31.3   Conditional parts         46
9810            3.32  Obsolete Variables   ............................................. 48
9811
9812        4.  Advanced Usage   ....................................................... 48
9813            4.1   Regular Expressions   ............................................ 48
9814            4.2   Patterns   ....................................................... 51
9815                  4.2.1    Complex Patterns    51
9816                  4.2.2    Patterns and Dates    52
9817            4.3   Format Strings       ............................................. 52
9818                  4.3.1    Introduction           52
9819                  4.3.2    Conditional Expansion           54
9820                  4.3.3    Modifications and Padding           55
9821            4.4   Using Tags   ..................................................... 55
9822            4.5   Using Hooks   .................................................... 56
9823                  4.5.1    Message Matching in Hooks   57
9824            4.6   Using the sidebar   .............................................. 57
9825
9826                                               ii
9827
9828            4.7   External Address Queries   ....................................... 58
9829            4.8   Mailbox Formats   ................................................ 59
9830            4.9   Mailbox Shortcuts   .............................................. 60
9831            4.10  Handling Mailing Lists   ......................................... 60
9832            4.11  Editing threads   ................................................ 61
9833                  4.11.1   Linking threads   62
9834                  4.11.2   Breaking threads   62
9835            4.12  Delivery Status Notification (DSN) Support   ..................... 62
9836            4.13  POP3 Support (OPTIONAL)   ........................................ 62
9837            4.14  IMAP Support (OPTIONAL)   ........................................ 63
9838                  4.14.1   The Folder Browser   64
9839                  4.14.2   Authentication   64
9840            4.15  NNTP Support (OPTIONAL)   ........................................ 65
9841                  4.15.1   Again: Scoring       65
9842            4.16  SMTP Support (OPTIONAL)   ........................................ 66
9843            4.17  Managing multiple IMAP/POP/NNTP accounts (OPTIONAL)   ............ 67
9844            4.18  Start a WWW Browser on URLs (EXTERNAL)   ......................... 67
9845            4.19  Compressed folders Support (OPTIONAL)   .......................... 67
9846                  4.19.1   Open a compressed mailbox for reading   68
9847                  4.19.2   Write a compressed mailbox   68
9848                  4.19.3   Append a message to a compressed mailbox   69
9849                  4.19.4   Encrypted folders   70
9850
9851        5.  Mutt-ng's MIME Support   ............................................... 70
9852            5.1   Using MIME in Mutt   ............................................. 70
9853                  5.1.1    Viewing MIME messages in the pager   70
9854                  5.1.2    The Attachment Menu   71
9855                  5.1.3    The Compose Menu   71
9856            5.2   MIME Type configuration with mime.types   ........................ 71
9857            5.3   MIME Viewer configuration with mailcap   ......................... 72
9858                  5.3.1    The Basics of the mailcap file   73
9859                  5.3.2    Secure use of mailcap   74
9860                  5.3.3    Advanced mailcap Usage   74
9861                  5.3.4    Example mailcap files   77
9862            5.4   MIME Autoview   .................................................. 78
9863            5.5   MIME Multipart/Alternative   ..................................... 79
9864            5.6   MIME Lookup   .................................................... 79
9865
9866        6.  Security Considerations     ............................................ 80
9867            6.1   Passwords       .................................................. 80
9868            6.2   Temporary Files       ............................................ 80
9869            6.3   Information Leaks     ............................................ 80
9870                  6.3.1    Message-ID: headers         80
9871                  6.3.2    mailto:-style links         81
9872            6.4   External applications       ...................................... 81
9873                  6.4.1    mailcap           81
9874                  6.4.2    Other           82
9875
9876        7.  Reference   ............................................................ 82
9877            7.1   Command line options   ........................................... 82
9878            7.2   Patterns   ....................................................... 83
9879            7.3   Configuration Commands   ......................................... 85
9880            7.4   Configuration variables .......................................... 87
9881
9882                                              iii
9883
9884                  7.4.1    abort_noattach   88
9885                  7.4.2    abort_nosubject   89
9886                  7.4.3    abort_unmodified   89
9887                  7.4.4    agent_string   89
9888                  7.4.5    alias_file   89
9889                  7.4.6    alias_format   89
9890                  7.4.7    allow_8bit   90
9891                  7.4.8    allow_ansi   90
9892                  7.4.9    arrow_cursor   90
9893                  7.4.10   ascii_chars   91
9894                  7.4.11   askbcc   91
9895                  7.4.12   askcc   91
9896                  7.4.13   assumed_charset   91
9897                  7.4.14   attach_format   91
9898                  7.4.15   attach_remind_regexp   92
9899                  7.4.16   attach_sep   93
9900                  7.4.17   attach_split   93
9901                  7.4.18   attribution   93
9902                  7.4.19   auto_tag   93
9903                  7.4.20   autoedit   93
9904                  7.4.21   beep   94
9905                  7.4.22   beep_new   94
9906                  7.4.23   bounce   94
9907                  7.4.24   bounce_delivered   94
9908                  7.4.25   braille_friendly   94
9909                  7.4.26   certificate_file   95
9910                  7.4.27   charset   95
9911                  7.4.28   check_new   95
9912                  7.4.29   collapse_unread   95
9913                  7.4.30   compose_format   96
9914                  7.4.31   config_charset   96
9915                  7.4.32   confirmappend   96
9916                  7.4.33   confirmcreate   96
9917                  7.4.34   connect_timeout   96
9918                  7.4.35   content_type   97
9919                  7.4.36   copy   97
9920                  7.4.37   crypt_autoencrypt   97
9921                  7.4.38   crypt_autopgp   97
9922                  7.4.39   crypt_autosign   98
9923                  7.4.40   crypt_autosmime   98
9924                  7.4.41   crypt_replyencrypt   98
9925                  7.4.42   crypt_replysign   98
9926                  7.4.43   crypt_replysignencrypted   98
9927                  7.4.44   crypt_timestamp   99
9928                  7.4.45   crypt_use_gpgme   99
9929                  7.4.46   crypt_verify_sig   99
9930                  7.4.47   date_format   99
9931                  7.4.48   debug_level   100
9932                  7.4.49   default_hook   100
9933                  7.4.50   delete   100
9934                  7.4.51   delete_space   100
9935                  7.4.52   delete_untag   101
9936                  7.4.53   digest_collapse   101
9937
9938                                               iv
9939
9940                  7.4.54   display_filter   101
9941                  7.4.55   dotlock_program   101
9942                  7.4.56   dsn_notify   101
9943                  7.4.57   dsn_return   102
9944                  7.4.58   duplicate_threads   102
9945                  7.4.59   edit_headers   102
9946                  7.4.60   editor   102
9947                  7.4.61   editor_headers   102
9948                  7.4.62   encode_from   103
9949                  7.4.63   entropy_file   103
9950                  7.4.64   envelope_from   103
9951                  7.4.65   escape   103
9952                  7.4.66   fast_reply   104
9953                  7.4.67   fcc_attach   104
9954                  7.4.68   fcc_clear   104
9955                  7.4.69   file_charset   104
9956                  7.4.70   folder   104
9957                  7.4.71   folder_format   105
9958                  7.4.72   followup_to   106
9959                  7.4.73   force_buffy_check   106
9960                  7.4.74   force_name   106
9961                  7.4.75   forward_decode   106
9962                  7.4.76   forward_decrypt   107
9963                  7.4.77   forward_edit   107
9964                  7.4.78   forward_format   107
9965                  7.4.79   forward_quote   107
9966                  7.4.80   from   107
9967                  7.4.81   gecos_mask   108
9968                  7.4.82   hdrs   108
9969                  7.4.83   header   108
9970                  7.4.84   header_cache   108
9971                  7.4.85   header_cache_compress   109
9972                  7.4.86   help   109
9973                  7.4.87   hidden_host   109
9974                  7.4.88   hide_limited   109
9975                  7.4.89   hide_missing   109
9976                  7.4.90   hide_thread_subject   110
9977                  7.4.91   hide_top_limited   110
9978                  7.4.92   hide_top_missing   110
9979                  7.4.93   history   110
9980                  7.4.94   honor_followup_to   110
9981                  7.4.95   hostname   111
9982                  7.4.96   ignore_list_reply_to   111
9983                  7.4.97   imap_authenticators   111
9984                  7.4.98   imap_check_subscribed   111
9985                  7.4.99   imap_delim_chars   112
9986                  7.4.100  imap_headers   112
9987                  7.4.101  imap_home_namespace   112
9988                  7.4.102  imap_keepalive   112
9989                  7.4.103  imap_list_subscribed   113
9990                  7.4.104  imap_login   113
9991                  7.4.105  imap_mail_check   113
9992                  7.4.106  imap_pass   113
9993
9994                                               v
9995
9996                  7.4.107  imap_passive   114
9997                  7.4.108  imap_peek   114
9998                  7.4.109  imap_reconnect   114
9999                  7.4.110  imap_servernoise   114
10000                  7.4.111  imap_user   115
10001                  7.4.112  implicit_autoview   115
10002                  7.4.113  include   115
10003                  7.4.114  include_onlyfirst   115
10004                  7.4.115  indent_string   115
10005                  7.4.116  index_format   115
10006                  7.4.117  ispell   118
10007                  7.4.118  keep_flagged   118
10008                  7.4.119  list_reply   119
10009                  7.4.120  locale   119
10010                  7.4.121  mail_check   119
10011                  7.4.122  mailcap_path   119
10012                  7.4.123  mailcap_sanitize   119
10013                  7.4.124  maildir_header_cache_verify   119
10014                  7.4.125  maildir_trash   120
10015                  7.4.126  mark_old   120
10016                  7.4.127  markers   120
10017                  7.4.128  mask   120
10018                  7.4.129  max_display_recips   121
10019                  7.4.130  max_line_length   121
10020                  7.4.131  mbox   121
10021                  7.4.132  mbox_type   121
10022                  7.4.133  menu_context   121
10023                  7.4.134  menu_move_off   122
10024                  7.4.135  menu_scroll   122
10025                  7.4.136  message_format   122
10026                  7.4.137  meta_key   122
10027                  7.4.138  metoo   122
10028                  7.4.139  mh_purge   123
10029                  7.4.140  mh_seq_flagged   123
10030                  7.4.141  mh_seq_replied   123
10031                  7.4.142  mh_seq_unseen   123
10032                  7.4.143  mime_forward   123
10033                  7.4.144  mime_forward_decode   123
10034                  7.4.145  mime_forward_rest   124
10035                  7.4.146  mix_entry_format   124
10036                  7.4.147  mixmaster   124
10037                  7.4.148  move   124
10038                  7.4.149  msgid_format   125
10039                  7.4.150  narrow_tree   126
10040                  7.4.151  nntp_ask_followup_to   126
10041                  7.4.152  nntp_ask_x_comment_to   126
10042                  7.4.153  nntp_cache_dir   126
10043                  7.4.154  nntp_catchup   127
10044                  7.4.155  nntp_context   127
10045                  7.4.156  nntp_followup_to_poster   127
10046                  7.4.157  nntp_group_index_format   127
10047                  7.4.158  nntp_host   128
10048                  7.4.159  nntp_inews   128
10049
10050                                               vi
10051
10052                  7.4.160  nntp_load_description   128
10053                  7.4.161  nntp_mail_check   129
10054                  7.4.162  nntp_mime_subject   129
10055                  7.4.163  nntp_newsrc   129
10056                  7.4.164  nntp_pass   129
10057                  7.4.165  nntp_post_moderated   130
10058                  7.4.166  nntp_reconnect   130
10059                  7.4.167  nntp_save_unsubscribed   130
10060                  7.4.168  nntp_show_new_news   130
10061                  7.4.169  nntp_show_only_unread   131
10062                  7.4.170  nntp_user   131
10063                  7.4.171  nntp_x_comment_to   131
10064                  7.4.172  operating_system   131
10065                  7.4.173  pager   131
10066                  7.4.174  pager_context   132
10067                  7.4.175  pager_format   132
10068                  7.4.176  pager_index_lines   132
10069                  7.4.177  pager_stop   132
10070                  7.4.178  pgp_auto_decode   133
10071                  7.4.179  pgp_autoinline   133
10072                  7.4.180  pgp_check_exit   133
10073                  7.4.181  pgp_clearsign_command   133
10074                  7.4.182  pgp_decode_command   134
10075                  7.4.183  pgp_decrypt_command   134
10076                  7.4.184  pgp_encrypt_only_command   134
10077                  7.4.185  pgp_encrypt_sign_command   134
10078                  7.4.186  pgp_entry_format   135
10079                  7.4.187  pgp_export_command   135
10080                  7.4.188  pgp_getkeys_command   135
10081                  7.4.189  pgp_good_sign   136
10082                  7.4.190  pgp_ignore_subkeys   136
10083                  7.4.191  pgp_import_command   136
10084                  7.4.192  pgp_list_pubring_command   136
10085                  7.4.193  pgp_list_secring_command   136
10086                  7.4.194  pgp_long_ids   137
10087                  7.4.195  pgp_mime_auto   137
10088                  7.4.196  pgp_replyinline   137
10089                  7.4.197  pgp_retainable_sigs   137
10090                  7.4.198  pgp_show_unusable   138
10091                  7.4.199  pgp_sign_as   138
10092                  7.4.200  pgp_sign_command   138
10093                  7.4.201  pgp_sort_keys   138
10094                  7.4.202  pgp_strict_enc   139
10095                  7.4.203  pgp_timeout   139
10096                  7.4.204  pgp_use_gpg_agent   139
10097                  7.4.205  pgp_verify_command   139
10098                  7.4.206  pgp_verify_key_command   139
10099                  7.4.207  pipe_decode   139
10100                  7.4.208  pipe_sep   140
10101                  7.4.209  pipe_split   140
10102                  7.4.210  pop_auth_try_all   140
10103                  7.4.211  pop_authenticators   140
10104                  7.4.212  pop_delete   141
10105
10106                                              vii
10107
10108                  7.4.213  pop_host   141
10109                  7.4.214  pop_last   141
10110                  7.4.215  pop_mail_check   141
10111                  7.4.216  pop_pass   142
10112                  7.4.217  pop_reconnect   142
10113                  7.4.218  pop_user   142
10114                  7.4.219  post_indent_string   142
10115                  7.4.220  postpone   142
10116                  7.4.221  postponed   143
10117                  7.4.222  preconnect   143
10118                  7.4.223  print   143
10119                  7.4.224  print_command   143
10120                  7.4.225  print_decode   143
10121                  7.4.226  print_split   144
10122                  7.4.227  prompt_after   144
10123                  7.4.228  query_command   144
10124                  7.4.229  quit   144
10125                  7.4.230  quote_empty   145
10126                  7.4.231  quote_quoted   145
10127                  7.4.232  quote_regexp   145
10128                  7.4.233  read_inc   145
10129                  7.4.234  read_only   145
10130                  7.4.235  realname   146
10131                  7.4.236  recall   146
10132                  7.4.237  record   146
10133                  7.4.238  reply_regexp   146
10134                  7.4.239  reply_self   147
10135                  7.4.240  reply_to   147
10136                  7.4.241  resolve   147
10137                  7.4.242  reverse_alias   147
10138                  7.4.243  reverse_name   148
10139                  7.4.244  reverse_realname   148
10140                  7.4.245  rfc2047_parameters   148
10141                  7.4.246  save_address   148
10142                  7.4.247  save_empty   149
10143                  7.4.248  save_name   149
10144                  7.4.249  score   149
10145                  7.4.250  score_threshold_delete   149
10146                  7.4.251  score_threshold_flag   150
10147                  7.4.252  score_threshold_read   150
10148                  7.4.253  send_charset   150
10149                  7.4.254  sendmail   150
10150                  7.4.255  sendmail_wait   150
10151                  7.4.256  shell   151
10152                  7.4.257  sidebar_boundary   151
10153                  7.4.258  sidebar_delim   151
10154                  7.4.259  sidebar_newmail_only   151
10155                  7.4.260  sidebar_number_format   151
10156                  7.4.261  sidebar_shorten_hierarchy   152
10157                  7.4.262  sidebar_visible   152
10158                  7.4.263  sidebar_width   153
10159                  7.4.264  sig_dashes   153
10160                  7.4.265  sig_on_top   153
10161
10162                                              viii
10163
10164                  7.4.266  signature   153
10165                  7.4.267  signoff_string   153
10166                  7.4.268  simple_search   154
10167                  7.4.269  sleep_time   154
10168                  7.4.270  smart_wrap   154
10169                  7.4.271  smileys   154
10170                  7.4.272  smime_ask_cert_label   154
10171                  7.4.273  smime_ca_location   155
10172                  7.4.274  smime_certificates   155
10173                  7.4.275  smime_decrypt_command   155
10174                  7.4.276  smime_decrypt_use_default_key   156
10175                  7.4.277  smime_default_key   156
10176                  7.4.278  smime_encrypt_command   156
10177                  7.4.279  smime_encrypt_with   156
10178                  7.4.280  smime_get_cert_command   157
10179                  7.4.281  smime_get_cert_email_command   157
10180                  7.4.282  smime_get_signer_cert_command   157
10181                  7.4.283  smime_import_cert_command   157
10182                  7.4.284  smime_is_default   157
10183                  7.4.285  smime_keys   157
10184                  7.4.286  smime_pk7out_command   158
10185                  7.4.287  smime_sign_command   158
10186                  7.4.288  smime_sign_opaque_command   158
10187                  7.4.289  smime_timeout   158
10188                  7.4.290  smime_verify_command   158
10189                  7.4.291  smime_verify_opaque_command   159
10190                  7.4.292  smtp_envelope   159
10191                  7.4.293  smtp_host   159
10192                  7.4.294  smtp_pass   159
10193                  7.4.295  smtp_port   160
10194                  7.4.296  smtp_use_tls   160
10195                  7.4.297  smtp_user   160
10196                  7.4.298  sort   160
10197                  7.4.299  sort_alias   161
10198                  7.4.300  sort_aux   161
10199                  7.4.301  sort_browser   162
10200                  7.4.302  sort_re   162
10201                  7.4.303  spam_separator   162
10202                  7.4.304  spoolfile   162
10203                  7.4.305  ssl_ca_certificates_file   163
10204                  7.4.306  ssl_client_cert   163
10205                  7.4.307  ssl_force_tls   163
10206                  7.4.308  ssl_min_dh_prime_bits   163
10207                  7.4.309  ssl_starttls   163
10208                  7.4.310  ssl_use_sslv2   164
10209                  7.4.311  ssl_use_sslv3   164
10210                  7.4.312  ssl_use_tlsv1   164
10211                  7.4.313  ssl_usesystemcerts   164
10212                  7.4.314  status_chars   164
10213                  7.4.315  status_format   165
10214                  7.4.316  status_on_top   167
10215                  7.4.317  strict_mailto   167
10216                  7.4.318  strict_mime   167
10217
10218                                               ix
10219
10220                  7.4.319  strict_threads   168
10221                  7.4.320  strip_was   168
10222                  7.4.321  strip_was_regex   168
10223                  7.4.322  stuff_quoted   168
10224                  7.4.323  suspend   169
10225                  7.4.324  text_flowed   169
10226                  7.4.325  thorough_search   169
10227                  7.4.326  thread_received   169
10228                  7.4.327  tilde   169
10229                  7.4.328  timeout   170
10230                  7.4.329  tmpdir   170
10231                  7.4.330  to_chars   170
10232                  7.4.331  trash   170
10233                  7.4.332  tunnel   170
10234                  7.4.333  umask   171
10235                  7.4.334  uncollapse_jump   171
10236                  7.4.335  use_8bitmime   171
10237                  7.4.336  use_domain   171
10238                  7.4.337  use_from   171
10239                  7.4.338  use_idn   172
10240                  7.4.339  use_ipv6   172
10241                  7.4.340  visual   172
10242                  7.4.341  wait_key   172
10243                  7.4.342  weed   173
10244                  7.4.343  wrap_search   173
10245                  7.4.344  wrapmargin   173
10246                  7.4.345  write_bcc   173
10247                  7.4.346  write_inc   173
10248                  7.4.347  xterm_icon   173
10249                  7.4.348  xterm_leave   174
10250                  7.4.349  xterm_set_titles   174
10251                  7.4.350  xterm_title   174
10252            7.5   Functions ....................................................... 174
10253                  7.5.1    generic   174
10254                  7.5.2    index   175
10255                  7.5.3    pager   177
10256                  7.5.4    alias   179
10257                  7.5.5    query   179
10258                  7.5.6    attach   179
10259                  7.5.7    compose   180
10260                  7.5.8    postpone   181
10261                  7.5.9    browser   181
10262                  7.5.10   pgp   182
10263                  7.5.11   editor   182
10264
10265        8.  Miscellany ............................................................ 182
10266            8.1   Acknowledgments ................................................. 183
10267            8.2   About this document ............................................. 185
10268
10269                                               x
10270