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-r465
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 27) 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.336  , page 171) 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.304  , page 161) 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.325  , page 168).
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 26) 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 71), 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 36) 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.213  , page 140), _\b$_\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
617        (section 7.4.215  , page 141), _\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp (section 7.4.214  , page 140) and
618        _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.347  , page 173) 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.348  , page 173) 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.347  , page 173) 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.238  , page 146) 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.321  , page 165) 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.205  , page 139) 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.192  , page 135)) 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.227  , page 143) 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.226  , page 143) 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  _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn _\bw_\bi_\bt_\bh_\bi_\bn _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
1111
1112        Besides just assign static content to variables, there's plenty of ways of
1113        adding external and more or less dynamic content.
1114
1115        _\b3_\b._\b3_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs_\b' _\bO_\bu_\bt_\bp_\bu_\bt
1116
1117        It is possible to substitute the output of a Unix command in an initialization
1118        file.  This is accomplished by enclosing the command in backquotes (``) as in,
1119        for example:
1120
1121             my_hdr X-Operating-System: `uname -a`
1122
1123        The output of the Unix command ``uname -a'' will be substituted before the line
1124        is parsed. Note that since initialization files are line oriented, only the
1125        first line of output from the Unix command will be substituted.
1126
1127        _\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
1128
1129        UNIX environments can be accessed like the way it is done in shells like sh and
1130        bash: Prepend the name of the environment by a ``$'' sign. For example,
1131
1132             set record=+sent_on_$HOSTNAME
1133
1134        sets the _\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.243  , page 147) variable to the string _\b+_\bs_\be_\bn_\bt_\b__\bo_\bn_\b_
1135        and appends the value of the evironment variable $HOSTNAME.
1136
1137        N\bNo\bot\bte\be:\b: There will be no warning if an environment variable is not defined. The
1138        result will of the expansion will then be empty.
1139
1140        _\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
1141
1142        As for environment variables, the values of all configuration variables as
1143        string can be used in the same way, too. For example,
1144
1145             set imap_home_namespace = $folder
1146
1147        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
1148        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.
1149
1150        N\bNo\bot\bte\be:\b: There're no logical links established in such cases so that the the value
1151        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
1152        _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) gets changed.
1153
1154        N\bNo\bot\bte\be:\b: There will be no warning if a configuration variable is not defined or is
1155        empty. The result will of the expansion will then be empty.
1156
1157        The Mutt Next Generation E-Mail Client                                       24
1158
1159        _\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
1160
1161        Mutt-ng flexibly allows users to define their own variables. To avoid conflicts
1162        with the standard set and to prevent misleading error messages, there's a
1163        reserved namespace for them: all user-defined variables must be prefixed with
1164        user_ and can be used just like any ordinary configuration or environment vari-
1165        able.
1166
1167        For example, to view the manual, users can either define two macros like the
1168        following
1169
1170             macro generic <F1> "!less -r /path/to/manual" "Show manual"
1171             macro pager <F1> "!less -r /path/to/manual" "Show manual"
1172
1173        for generic, pager and index. The alternative is to define a custom variable
1174        like so:
1175
1176             set user_manualcmd = "!less -r /path/to_manual"
1177             macro generic <F1> "$user_manualcmd<enter>" "Show manual"
1178             macro pager <F1> "$user_manualcmd<enter>" "Show manual"
1179             macro index <F1> "$user_manualcmd<enter>" "Show manual"
1180
1181        to re-use the command sequence as in:
1182
1183             macro index <F2> "$user_manualcmd | grep '\^[ ]\\+~. '" "Show Patterns"
1184
1185        Using this feature, arbitrary sequences can be defined once and recalled and
1186        reused where necessary. More advanced scenarios could include to save a vari-
1187        able's value at the beginning of macro sequence and restore it at end.
1188
1189        When the variable is first defined, the first value it gets assigned is also
1190        the initial value to which it can be reset using the reset command.
1191
1192        The complete removal is done via the unset keyword.
1193
1194        After the following sequence:
1195
1196             set user_foo = 42
1197             set user_foo = 666
1198
1199        the variable $user_foo has a current value of 666 and an initial of 42. The
1200        query
1201
1202             set ?user_foo
1203
1204        The Mutt Next Generation E-Mail Client                                       25
1205
1206        will show 666. After doing the reset via
1207
1208             reset user_foo
1209
1210        a following query will give 42 as the result. After unsetting it via
1211
1212             unset user_foo
1213
1214        any query or operation (except the noted expansion within other statements)
1215        will lead to an error message.
1216
1217        _\b3_\b._\b3_\b._\b5  _\bP_\br_\be_\b-_\bD_\be_\bf_\bi_\bn_\be_\bd _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
1218
1219        In order to allow users to share one setup over a number of different machines
1220        without having to change its contents, there's a number of pre-defined vari-
1221        ables. These are prefixed with muttng_ and are read-only, i.e. they cannot be
1222        set, unset or reset. The reference chapter lists all available variables.
1223
1224         _\bP_\bl_\be_\ba_\bs_\be _\bc_\bo_\bn_\bs_\bu_\bl_\bt _\bt_\bh_\be _\bl_\bo_\bc_\ba_\bl _\bc_\bo_\bp_\by _\bo_\bf _\by_\bo_\bu_\br _\bm_\ba_\bn_\bu_\ba_\bl _\bf_\bo_\br _\bt_\bh_\be_\bi_\br _\bv_\ba_\bl_\bu_\be_\bs _\ba_\bs _\bt_\bh_\be_\by _\bm_\ba_\by _\bd_\bi_\bf_\b-
1225        _\bf_\be_\br _\bf_\br_\bo_\bm _\bd_\bi_\bf_\bf_\be_\br_\be_\bn_\bt _\bm_\ba_\bn_\bu_\ba_\bl _\bs_\bo_\bu_\br_\bc_\be_\bs_\b. Where the manual is installed in can be
1226        queried (already using such a variable) by running:
1227
1228             muttng -Q muttng_docdir
1229
1230        To extend the example for viewing the manual via self-defined variables, it can
1231        be made more readable and more portable by changing the real path in:
1232
1233             set user_manualcmd = '!less -r /path/to_manual'
1234
1235        to:
1236
1237             set user_manualcmd = "!less -r $muttng_docdir/manual.txt"
1238
1239        which works everywhere if a manual is installed.
1240
1241        _\bN_\bo_\bt_\be_\b: _\bt_\bh_\bi_\bs _\bi_\bs _\ba _\bd_\br_\ba_\bf_\bt _\bf_\be_\ba_\bt_\bu_\br_\be _\ba_\bn_\bd _\bm_\ba_\by_\bb_\be _\bs_\bu_\bb_\bj_\be_\bc_\bt _\bt_\bo _\bc_\bh_\ba_\bn_\bg_\be _\bi_\bn _\bt_\bh_\be _\bn_\be_\ba_\br _\bf_\bu_\bt_\bu_\br_\be_\b.
1242
1243        _\b3_\b._\b3_\b._\b6  _\bT_\by_\bp_\be _\bC_\bo_\bn_\bv_\be_\br_\bs_\bi_\bo_\bn_\bs
1244
1245        A note about variable's types during conversion: internally values are stored
1246        in internal types but for any dump/query or set operation they're converted to
1247        and from string. That means that there's no need to worry about types when ref-
1248        erencing any variable.  As an example, the following can be used without harm
1249        (besides makeing muttng very likely behave strange):
1250
1251        The Mutt Next Generation E-Mail Client                                       26
1252
1253             set read_inc = 100
1254             set folder = $read_inc
1255             set read_inc = $folder
1256             set user_magic_number = 42
1257             set folder = $user_magic_number
1258
1259        _\b3_\b._\b4  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg_\b/_\bU_\bs_\bi_\bn_\bg _\ba_\bl_\bi_\ba_\bs_\be_\bs
1260
1261        Usage: alias _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
1262
1263        It's usually very cumbersome to remember or type out the address of someone you
1264        are communicating with.  Mutt-ng allows you to create ``aliases'' which map a
1265        short string to a full address.
1266
1267        N\bNo\bot\bte\be:\b: if you want to create an alias for a group (by specifying more than one
1268        address), you m\bmu\bus\bst\bt separate the addresses with a comma (``,'').
1269
1270        To remove an alias or aliases (``*'' means all aliases):
1271
1272        unalias [ * | _\bk_\be_\by _\b._\b._\b. ]
1273
1274             alias muttdude me@cs.hmc.edu (Michael Elkins)
1275             alias theguys manny, moe, jack
1276
1277        Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a spe-
1278        cial file.  The alias command can appear anywhere in a configuration file, as
1279        long as this file is _\bs_\bo_\bu_\br_\bc_\be_\bd (section 3.29  , page 45).  Consequently, you can
1280        have multiple alias files, or you can have all aliases defined in your muttrc.
1281
1282        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
1283        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)
1284        variable (which is ~/.muttrc by default). This file is not special either, in
1285        the sense that Mutt-ng will happily append aliases to any file, but in order
1286        for the new aliases to take effect you need to explicitly _\bs_\bo_\bu_\br_\bc_\be (section
1287        3.29  , page 45) this file too.
1288
1289        For example:
1290
1291             source /usr/local/share/Mutt-ng.aliases
1292             source ~/.mail_aliases
1293             set alias_file=~/.mail_aliases
1294
1295        To use aliases, you merely use the alias at any place in mutt where mutt
1296        prompts for addresses, such as the _\bT_\bo_\b: or _\bC_\bc_\b: prompt.  You can also enter
1297        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
1298        (section 7.4.59  , page 102) variable set.
1299
1300        In addition, at the various address prompts, you can use the tab character to
1301        expand a partial alias to the full alias.  If there are multiple matches, mutt
1302
1303        The Mutt Next Generation E-Mail Client                                       27
1304
1305        will bring up a menu with the matching aliases.  In order to be presented with
1306        the full list of aliases, you must hit tab with out a partial alias, such as at
1307        the beginning of the prompt or after a comma denoting multiple addresses.
1308
1309        In the alias menu, you can select as many aliases as you want with the _\bs_\be_\bl_\be_\bc_\bt_\b-
1310        _\be_\bn_\bt_\br_\by key (default: RET), and use the _\be_\bx_\bi_\bt key (default: q) to return to the
1311        address prompt.
1312
1313        _\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
1314
1315        Usage: bind _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
1316
1317        This command allows you to change the default key bindings (operation invoked
1318        when pressing a key).
1319
1320        _\bm_\ba_\bp specifies in which menu the binding belongs.  Multiple maps may be speci-
1321        fied by separating them with commas (no additional whitespace is allowed). The
1322        currently defined maps are:
1323
1324              generic
1325                    This is not a real menu, but is used as a fallback for all of the
1326                    other menus except for the pager and editor modes.  If a key is not
1327                    defined in another menu, Mutt-ng will look for a binding to use in
1328                    this menu.  This allows you to bind a key to a certain function in
1329                    multiple menus instead of having multiple bind statements to accom-
1330                    plish the same task.
1331
1332              alias
1333                    The alias menu is the list of your personal aliases as defined in
1334                    your muttrc.  It is the mapping from a short alias name to the full
1335                    email address(es) of the recipient(s).
1336
1337              attach
1338                    The attachment menu is used to access the attachments on received
1339                    messages.
1340
1341              browser
1342                    The browser is used for both browsing the local directory struc-
1343                    ture, and for listing all of your incoming mailboxes.
1344
1345              editor
1346                    The editor is the line-based editor the user enters text data.
1347
1348              index
1349                    The index is the list of messages contained in a mailbox.
1350
1351              compose
1352                    The compose menu is the screen used when sending a new message.
1353
1354        The Mutt Next Generation E-Mail Client                                       28
1355
1356              pager
1357                    The pager is the mode used to display message/attachment data, and
1358                    help listings.
1359
1360              pgp
1361                    The pgp menu is used to select the OpenPGP keys used for encrypting
1362                    outgoing messages.
1363
1364              postpone
1365                    The postpone menu is similar to the index menu, except is used when
1366                    recalling a message the user was composing, but saved until later.
1367
1368        _\bk_\be_\by is the key (or key sequence) you wish to bind.  To specify a control char-
1369        acter, use the sequence _\b\_\bC_\bx, where _\bx is the letter of the control character
1370        (for example, to specify control-A use ``\Ca'').  Note that the case of _\bx as
1371        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
1372        alternative form is to specify the key as a three digit octal number prefixed
1373        with a ``\'' (for example _\b\_\b1_\b7_\b7 is equivalent to _\b\_\bc_\b?).
1374
1375        In addition, _\bk_\be_\by may consist of:
1376
1377             \t              tab
1378             <tab>           tab
1379             <backtab>       backtab / shift-tab
1380             \r              carriage return
1381             \n              newline
1382             \e              escape
1383             <esc>           escape
1384             <up>            up arrow
1385             <down>          down arrow
1386             <left>          left arrow
1387             <right>         right arrow
1388             <pageup>        Page Up
1389             <pagedown>      Page Down
1390             <backspace>     Backspace
1391             <delete>        Delete
1392             <insert>        Insert
1393             <enter>         Enter
1394             <return>        Return
1395             <home>          Home
1396             <end>           End
1397             <space>         Space bar
1398             <f1>            function key 1
1399             <f10>           function key 10
1400
1401        _\bk_\be_\by does not need to be enclosed in quotes unless it contains a space (`` '').
1402
1403        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn specifies which action to take when _\bk_\be_\by is pressed.  For a complete
1404        list of functions, see the _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 175).  The special
1405        function noop unbinds the specified key sequence.
1406
1407        The Mutt Next Generation E-Mail Client                                       29
1408
1409        _\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
1410
1411        Usage: charset-hook _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
1412
1413        Usage: iconv-hook _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
1414
1415        The charset-hook command defines an alias for a character set.  This is useful
1416        to properly display messages which are tagged with a character set name not
1417        known to mutt.
1418
1419        The iconv-hook command defines a system-specific name for a character set.
1420        This is helpful when your systems character conversion library insists on using
1421        strange, system-specific names for character sets.
1422
1423        _\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
1424
1425        Usage: folder-hook [!]_\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1426
1427        It is often desirable to change settings based on which mailbox you are read-
1428        ing.  The folder-hook command provides a method by which you can execute any
1429        configuration command.  _\br_\be_\bg_\be_\bx_\bp is a regular expression specifying in which
1430        mailboxes to execute _\bc_\bo_\bm_\bm_\ba_\bn_\bd before loading.  If a mailbox matches multiple
1431        folder-hook's, they are executed in the order given in the muttrc.
1432
1433        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.310  , page
1434        163) at the beginning of the pattern, you must place it inside of double or
1435        single quotes in order to distinguish it from the logical _\bn_\bo_\bt operator for the
1436        expression.
1437
1438        Note that the settings are _\bn_\bo_\bt restored when you leave the mailbox.  For exam-
1439        ple, a command action to perform is to change the sorting method based upon the
1440        mailbox being read:
1441
1442             folder-hook mutt set sort=threads
1443
1444        However, the sorting method is not restored to its previous value when reading
1445        a different mailbox.  To specify a _\bd_\be_\bf_\ba_\bu_\bl_\bt command, use the pattern ``.'':
1446
1447             folder-hook . set sort=date-sent
1448
1449        _\b3_\b._\b8  _\bK_\be_\by_\bb_\bo_\ba_\br_\bd _\bm_\ba_\bc_\br_\bo_\bs
1450
1451        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 ]
1452
1453        Macros are useful when you would like a single key to perform a series of
1454        actions.  When you press _\bk_\be_\by in menu _\bm_\be_\bn_\bu, Mutt-ng will behave as if you had
1455
1456        The Mutt Next Generation E-Mail Client                                       30
1457
1458        typed _\bs_\be_\bq_\bu_\be_\bn_\bc_\be.  So if you have a common sequence of commands you type, you can
1459        create a macro to execute those commands with a single key.
1460
1461        _\bm_\be_\bn_\bu is the _\bm_\ba_\bp (section 3.5  , page 27) which the macro will be bound.  Multi-
1462        ple maps may be specified by separating multiple menu arguments by commas.
1463        Whitespace may not be used in between the menu arguments and the commas sepa-
1464        rating them.
1465
1466        _\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
1467        3.5  , page 27).  There are some additions however.  The first is that control
1468        characters in _\bs_\be_\bq_\bu_\be_\bn_\bc_\be can also be specified as _\b^_\bx.  In order to get a caret
1469        (`^'') you need to use _\b^_\b^.  Secondly, to specify a certain key such as _\bu_\bp or to
1470        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
1471        _\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
1472        3.5  , page 27).  Functions are listed in the _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section
1473        7.5  , page 175).
1474
1475        The advantage with using function names directly is that the macros will work
1476        regardless of the current key bindings, so they are not dependent on the user
1477        having particular key definitions.  This makes them more robust and portable,
1478        and also facilitates defining of macros in files used by more than one user
1479        (eg. the system Muttngrc).
1480
1481        Optionally you can specify a descriptive text after _\bs_\be_\bq_\bu_\be_\bn_\bc_\be, which is shown in
1482        the help screens.
1483
1484        N\bNo\bot\bte\be:\b: Macro definitions (if any) listed in the help screen(s), are silently
1485        truncated at the screen width, and are not wrapped.
1486
1487        _\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
1488
1489        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 ]
1490
1491        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
1492
1493        Usage: uncolor index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1494
1495        If your terminal supports color, you can spice up Mutt-ng by creating your own
1496        color scheme.  To define the color of an object (type of information), you must
1497        specify both a foreground color a\ban\bnd\bd a background color (it is not possible to
1498        only specify one or the other).
1499
1500        _\bo_\bb_\bj_\be_\bc_\bt can be one of:
1501
1502           +\bo attachment
1503
1504           +\bo body (match _\br_\be_\bg_\be_\bx_\bp in the body of messages)
1505
1506           +\bo bold (highlighting bold patterns in the body of messages)
1507
1508           +\bo error (error messages printed by Mutt-ng)
1509
1510        The Mutt Next Generation E-Mail Client                                       31
1511
1512           +\bo header (match _\br_\be_\bg_\be_\bx_\bp in the message header)
1513
1514           +\bo hdrdefault (default color of the message header in the pager)
1515
1516           +\bo index (match _\bp_\ba_\bt_\bt_\be_\br_\bn in the message index)
1517
1518           +\bo indicator (arrow or bar used to indicate the current item in a menu)
1519
1520           +\bo markers (the ``+'' markers at the beginning of wrapped lines in the pager)
1521
1522           +\bo message (informational messages)
1523
1524           +\bo normal
1525
1526           +\bo quoted (text matching _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.238  , page 146) in the
1527             body of a message)
1528
1529           +\bo quoted1, quoted2, ..., quotedN\bN (higher levels of quoting)
1530
1531           +\bo search (highlighting of words in the pager)
1532
1533           +\bo signature
1534
1535           +\bo status (mode lines used to display info about the mailbox or message)
1536
1537           +\bo tilde (the ``~'' used to pad blank lines in the pager)
1538
1539           +\bo tree (thread tree drawn in the message index and attachment menu)
1540
1541           +\bo underline (highlighting underlined patterns in the body of messages)
1542
1543        _\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:
1544
1545           +\bo white
1546
1547           +\bo black
1548
1549           +\bo green
1550
1551           +\bo magenta
1552
1553           +\bo blue
1554
1555           +\bo cyan
1556
1557           +\bo yellow
1558
1559           +\bo red
1560
1561           +\bo default
1562
1563           +\bo color_\bx
1564
1565        _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd can optionally be prefixed with the keyword bright to make the
1566
1567        The Mutt Next Generation E-Mail Client                                       32
1568
1569        foreground color boldfaced (e.g., brightred).
1570
1571        If your terminal supports it, the special keyword _\bd_\be_\bf_\ba_\bu_\bl_\bt can be used as a
1572        transparent color.  The value _\bb_\br_\bi_\bg_\bh_\bt_\bd_\be_\bf_\ba_\bu_\bl_\bt is also valid.  If Mutt-ng is
1573        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-
1574        ment variable to the default colors of your terminal for this to work; for
1575        example (for Bourne-like shells):
1576
1577             set COLORFGBG="green;black"
1578             export COLORFGBG
1579
1580        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
1581        instead of _\bw_\bh_\bi_\bt_\be and _\by_\be_\bl_\bl_\bo_\bw when setting this variable.
1582
1583        N\bNo\bot\bte\be:\b: The uncolor command can be applied to the index object only.  It removes
1584        entries from the list. You m\bmu\bus\bst\bt specify the same pattern specified in the color
1585        command for it to be removed.  The pattern ``*'' is a special token which means
1586        to clear the color index list of all entries.
1587
1588        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
1589        number of colors supported by your terminal).  This is useful when you remap
1590        the colors for your display (for example by changing the color associated with
1591        _\bc_\bo_\bl_\bo_\br_\b2 for your xterm), since color names may then lose their normal meaning.
1592
1593        If your terminal does not support color, it is still possible change the video
1594        attributes through the use of the ``mono'' command:
1595
1596        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 ]
1597
1598        Usage: mono index _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be _\bp_\ba_\bt_\bt_\be_\br_\bn
1599
1600        Usage: unmono index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1601
1602        where _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be is one of the following:
1603
1604           +\bo none
1605
1606           +\bo bold
1607
1608           +\bo underline
1609
1610           +\bo reverse
1611
1612           +\bo standout
1613
1614        _\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
1615
1616        Usage: [un]ignore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1617
1618        Messages often have many header fields added by automatic processing systems,
1619
1620        The Mutt Next Generation E-Mail Client                                       33
1621
1622        or which may not seem useful to display on the screen.  This command allows you
1623        to specify header fields which you don't normally want to see.
1624
1625        You do not need to specify the full header field name.  For example, ``ignore
1626        content-'' will ignore all header fields that begin with the pattern ``con-
1627        tent-''. ``ignore *'' will ignore all headers.
1628
1629        To remove a previously added token from the list, use the ``unignore'' command.
1630        The ``unignore'' command will make Mutt-ng display headers with the given pat-
1631        tern.  For example, if you do ``ignore x-'' it is possible to ``unignore x-
1632        mailer''.
1633
1634        ``unignore *'' will remove all tokens from the ignore list.
1635
1636        For example:
1637
1638             # Sven's draconian header weeding
1639             ignore *
1640             unignore from date subject to cc
1641             unignore organization organisation x-mailer: x-newsreader: x-mailing-list:
1642             unignore posted-to:
1643
1644        _\b3_\b._\b1_\b1  _\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be _\ba_\bd_\bd_\br_\be_\bs_\bs_\be_\bs
1645
1646        Usage: [un]alternates _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1647
1648        With various functions, mutt will treat messages differently, depending on
1649        whether you sent them or whether you received them from someone else.  For
1650        instance, when replying to a message that you sent to a different party, mutt
1651        will automatically suggest to send the response to the original message's
1652        recipients -- responding to yourself won't make much sense in many cases.  (See
1653        _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section 7.4.246  , page 148).)
1654
1655        Many users receive e-mail under a number of different addresses. To fully use
1656        mutt's features here, the program must be able to recognize what e-mail
1657        addresses you receive mail under. That's the purpose of the alternates command:
1658        It takes a list of regular expressions, each of which can identify an address
1659        under which you receive e-mail.
1660
1661        The unalternates command can be used to write exceptions to alternates pat-
1662        terns. If an address matches something in an alternates command, but you none-
1663        theless do not think it is from you, you can list a more precise pattern under
1664        an unalternates command.
1665
1666        To remove a regular expression from the alternates list, use the unalternates
1667        command with exactly the same _\br_\be_\bg_\be_\bx_\bp.  Likewise, if the _\br_\be_\bg_\be_\bx_\bp for a alternates
1668        command matches an entry on the unalternates list, that unalternates entry will
1669        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
1670        will be removed.
1671
1672        The Mutt Next Generation E-Mail Client                                       34
1673
1674        _\b3_\b._\b1_\b2  _\bF_\bo_\br_\bm_\ba_\bt _\b= _\bF_\bl_\bo_\bw_\be_\bd
1675
1676        _\b3_\b._\b1_\b2_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
1677
1678        Mutt-ng contains support for so-called format=flowed messages.  In the begin-
1679        ning of email, each message had a fixed line width, and it was enough for dis-
1680        playing them on fixed-size terminals. But times changed, and nowadays hardly
1681        anybody still uses fixed-size terminals: more people nowaydays use graphical
1682        user interfaces, with dynamically resizable windows. This led to the demand of
1683        a new email format that makes it possible for the email client to make the
1684        email look nice in a resizable window without breaking quoting levels and cre-
1685        ating an incompatible email format that can also be displayed nicely on old
1686        fixed-size terminals.
1687
1688        For introductory information on format=flowed messages, see
1689        <http://www.joeclark.org/ffaq.html>.
1690
1691        _\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
1692
1693        When you receive emails that are marked as format=flowed messages, and is for-
1694        matted correctly, mutt-ng will try to reformat the message to optimally fit on
1695        your terminal. If you want a fixed margin on the right side of your terminal,
1696        you can set the following:
1697
1698                 set wrapmargin = 10
1699
1700        The code above makes the line break 10 columns before the right side of the
1701        terminal.
1702
1703        If your terminal is so wide that the lines are embarrassingly long, you can
1704        also set a maximum line length:
1705
1706                 set max_line_length = 120
1707
1708        The example above will give you lines not longer than 120 characters.
1709
1710        When you view at format=flowed messages, you will often see the quoting hierar-
1711        chy like in the following example:
1712
1713                 >Bill, can you please send last month's progress report to Mr.
1714                 >Morgan? We also urgently need the cost estimation for the new
1715                 >production server that we want to set up before our customer's
1716                 >project will go live.
1717
1718        This obviously doesn't look very nice, and it makes it very hard to
1719
1720        The Mutt Next Generation E-Mail Client                                       35
1721
1722        differentiate between text and quoting character. The solution is to configure
1723        mutt-ng to "stuff" the quoting:
1724
1725                 set stuff_quoted
1726
1727        This will lead to a nicer result that is easier to read:
1728
1729                 > Bill, can you please send last month's progress report to Mr.
1730                 > Morgan? We also urgently need the cost estimation for the new
1731                 > production server that we want to set up before our customer's
1732                 > project will go live.
1733
1734        _\b3_\b._\b1_\b2_\b._\b3  _\bS_\be_\bn_\bd_\bi_\bn_\bg
1735
1736        If you want mutt-ng to send emails with format=flowed set, you need to explic-
1737        itly set it:
1738
1739                 set text_flowed
1740
1741        Additionally, you have to use an editor which supports writing format=flowed-
1742        conforming emails. For vim, this is done by adding w to the formatoptions (see
1743        :h formatoptions and :h fo-table) when writing emails.
1744
1745        Also note that _\bf_\bo_\br_\bm_\ba_\bt_\b=_\bf_\bl_\bo_\bw_\be_\bd knows about ``space-stuffing'', that is, when
1746        sending messages, some kinds of lines have to be indented with a single space
1747        on the sending side. On the receiving side, the first space (if any) is
1748        removed. As a consequence and in addition to the above simple setting, please
1749        keep this in mind when making manual formattings within the editor. Also note
1750        that mutt-ng currently violates the standard (RfC 3676) as it does not space-
1751        stuff lines starting with:
1752
1753           +\bo > This is _\bn_\bo_\bt the quote character but a right angle used for other reasons
1754
1755           +\bo From with a trailing space.
1756
1757           +\bo just a space for formatting reasons
1758
1759        Please make sure that you manually prepend a space to each of them.
1760
1761        _\b3_\b._\b1_\b2_\b._\b4  _\bA_\bd_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bN_\bo_\bt_\be_\bs
1762
1763            "
1764
1765         For completeness, the _\b$_\bd_\be_\bl_\be_\bt_\be_\b__\bs_\bp_\ba_\bc_\be (section 7.4.51  , page 100) variable pro-
1766        vides the mechanism to generate a DelSp=yes parameter on _\bo_\bu_\bt_\bg_\bo_\bi_\bn_\bg messages.
1767
1768        The Mutt Next Generation E-Mail Client                                       36
1769
1770        According to the standard, clients receiving a format=flowed messages should
1771        delete the last space of a flowed line but still interpret the line as flowed.
1772        Because flowed lines usually contain only one space at the end, this parameter
1773        would make the receiving client concatenate the last word of the previous with
1774        the first of the current line _\bw_\bi_\bt_\bh_\bo_\bu_\bt a space. This makes ordinary text unread-
1775        able and is intended for languages rarely using spaces. So please use this set-
1776        ting only if you're sure what you're doing.
1777
1778        _\b3_\b._\b1_\b3  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bl_\bi_\bs_\bt_\bs
1779
1780        Usage: [un]lists _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1781
1782        Usage: [un]subscribe _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1783
1784        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  ,
1785        page 60).  In order to take advantage of them, you must specify which addresses
1786        belong to mailing lists, and which mailing lists you are subscribed to.  Once
1787        you have done this, the _\bl_\bi_\bs_\bt_\b-_\br_\be_\bp_\bl_\by (section 2.5.4  , page 12) function will
1788        work for all known lists.  Additionally, when you send a message to a sub-
1789        scribed list, mutt will add a Mail-Followup-To header to tell other users' mail
1790        user agents not to send copies of replies to your personal address.   Note that
1791        the Mail-Followup-To header is a non-standard extension which is not supported
1792        by all mail user agents.  Adding it is not bullet-proof against receiving per-
1793        sonal CCs of list messages.  Also note that the generation of the Mail-Fol-
1794        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)
1795        configuration variable.
1796
1797        More precisely, Mutt-ng maintains lists of patterns for the addresses of known
1798        and subscribed mailing lists.  Every subscribed mailing list is known. To mark
1799        a mailing list as known, use the ``lists'' command.  To mark it as subscribed,
1800        use ``subscribe''.
1801
1802        You can use regular expressions with both commands.  To mark all messages sent
1803        to a specific bug report's address on mutt's bug tracking system as list mail,
1804        for instance, you could say ``subscribe [0-9]*@bugs.guug.de''.  Often, it's
1805        sufficient to just give a portion of the list's e-mail address.
1806
1807        Specify as much of the address as you need to to remove ambiguity.  For exam-
1808        ple, if you've subscribed to the Mutt-ng mailing list, you will receive mail
1809        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
1810        list, you could add ``lists mutt-users'' to your initialization file.  To tell
1811        mutt that you are subscribed to it, add ``subscribe mutt-users'' to your ini-
1812        tialization file instead.  If you also happen to get mail from someone whose
1813        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-
1814        users@mutt\\.org'' or ``subscribe mutt-users@mutt\\.org'' to match only mail
1815        from the actual list.
1816
1817        The ``unlists'' command is used to remove a token from the list of known and
1818        subscribed mailing-lists. Use ``unlists *'' to remove all tokens.
1819
1820        To remove a mailing list from the list of subscribed mailing lists, but keep it
1821        on the list of known mailing lists, use ``unsubscribe''.
1822
1823        The Mutt Next Generation E-Mail Client                                       37
1824
1825        _\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
1826
1827        Usage: mbox-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1828
1829        This command is used to move read messages from a specified mailbox to a dif-
1830        ferent mailbox automatically when you quit or change folders.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a
1831        regular expression specifying the mailbox to treat as a ``spool'' mailbox and
1832        _\bm_\ba_\bi_\bl_\bb_\bo_\bx specifies where mail should be saved when read.
1833
1834        Unlike some of the other _\bh_\bo_\bo_\bk commands, only the _\bf_\bi_\br_\bs_\bt matching pattern is used
1835        (it is not possible to save read mail in more than a single mailbox).
1836
1837        _\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
1838
1839        Usage: [un]mailboxes [!]_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
1840
1841        This command specifies folders which can receive mail and which will be checked
1842        for new messages.  By default, the main menu status bar displays how many of
1843        these folders have new messages.
1844
1845        When changing folders, pressing _\bs_\bp_\ba_\bc_\be will cycle through folders with new mail.
1846
1847        Pressing TAB in the directory browser will bring up a menu showing the files
1848        specified by the mailboxes command, and indicate which contain new messages.
1849        Mutt-ng will automatically enter this mode when invoked from the command line
1850        with the -y option.
1851
1852        The ``unmailboxes'' command is used to remove a token from the list of folders
1853        which receive mail. Use ``unmailboxes *'' to remove all tokens.
1854
1855        N\bNo\bot\bte\be:\b: new mail is detected by comparing the last modification time to the last
1856        access time.  Utilities like biff or frm or any other program which accesses
1857        the mailbox might cause Mutt-ng to never detect new mail for that mailbox if
1858        they do not properly reset the access time.  Backup tools are another common
1859        reason for updated access times.
1860
1861        N\bNo\bot\bte\be:\b: the filenames in the mailboxes command are resolved when the command is
1862        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
1863        60) (such as ``='' and ``!''), any variable definition that affect these char-
1864        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
1865        7.4.310  , page 163)) should be executed before the mailboxes command.
1866
1867        _\b3_\b._\b1_\b6  _\bU_\bs_\be_\br _\bd_\be_\bf_\bi_\bn_\be_\bd _\bh_\be_\ba_\bd_\be_\br_\bs
1868
1869        Usage:
1870
1871        my_hdr _\bs_\bt_\br_\bi_\bn_\bg
1872
1873        unmy_hdr _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
1874
1875        The Mutt Next Generation E-Mail Client                                       38
1876
1877        The ``my_hdr'' command allows you to create your own header fields which will
1878        be added to every message you send.
1879
1880        For example, if you would like to add an ``Organization:'' header field to all
1881        of your outgoing messages, you can put the command
1882
1883             my_hdr Organization: A Really Big Company, Anytown, USA
1884
1885        in your .muttrc.
1886
1887        N\bNo\bot\bte\be:\b:  space characters are _\bn_\bo_\bt allowed between the keyword and the colon
1888        (``:'').  The standard for electronic mail (RFC822) says that space is illegal
1889        there, so Mutt-ng enforces the rule.
1890
1891        If you would like to add a header field to a single message, you should either
1892        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-
1893        _\bh_\be_\ba_\bd_\be_\br_\bs function (default: ``E'') in the send-menu so that you can edit the
1894        header of your message along with the body.
1895
1896        To remove user defined header fields, use the ``unmy_hdr'' command.  You may
1897        specify an asterisk (``*'') to remove all header fields, or the fields to
1898        remove.  For example, to remove all ``To'' and ``Cc'' header fields, you could
1899        use:
1900
1901             unmy_hdr to cc
1902
1903        _\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
1904
1905        Usage: hdr_order _\bh_\be_\ba_\bd_\be_\br_\b1 _\bh_\be_\ba_\bd_\be_\br_\b2 _\bh_\be_\ba_\bd_\be_\br_\b3
1906
1907        With this command, you can specify an order in which mutt will attempt to
1908        present headers to you when viewing messages.
1909
1910        ``unhdr_order *'' will clear all previous headers from the order list, thus
1911        removing the header order effects set by the system-wide startup file.
1912
1913             hdr_order From Date: From: To: Cc: Subject:
1914
1915        _\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
1916
1917        Usage: save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
1918
1919        This command is used to override the default filename used when saving mes-
1920        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:
1921
1922        The Mutt Next Generation E-Mail Client                                       39
1923
1924        an address matching _\br_\be_\bg_\be_\bx_\bp or if you are the author and the message is
1925        addressed _\bt_\bo_\b: something matching _\br_\be_\bg_\be_\bx_\bp.
1926
1927        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
1928        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1929
1930        Examples:
1931
1932             save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
1933             save-hook aol\\.com$ +spam
1934
1935        Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 39) command.
1936
1937        _\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
1938
1939        Usage: fcc-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1940
1941        This command is used to save outgoing mail in a mailbox other than _\b$_\br_\be_\bc_\bo_\br_\bd
1942        (section 7.4.243  , page 147).  Mutt-ng searches the initial list of message
1943        recipients for the first matching _\br_\be_\bg_\be_\bx_\bp and uses _\bm_\ba_\bi_\bl_\bb_\bo_\bx as the default Fcc:
1944        mailbox.  If no match is found the message will be saved to _\b$_\br_\be_\bc_\bo_\br_\bd (section
1945        7.4.243  , page 147) mailbox.
1946
1947        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
1948        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1949
1950        Example: fcc-hook [@.]aol\\.com$ +spammers
1951
1952        The above will save a copy of all messages going to the aol.com domain to the
1953        `+spammers' mailbox by default.  Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  ,
1954        page 39) command.
1955
1956        _\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
1957
1958        Usage: fcc-save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1959
1960        This command is a shortcut, equivalent to doing both a _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section
1961        3.19  , page 39) and a _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 38) with its arguments.
1962
1963        _\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
1964
1965        Usage: reply-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1966
1967        Usage: send-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1968
1969        Usage: send2-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1970
1971        The Mutt Next Generation E-Mail Client                                       40
1972
1973        These commands can be used to execute arbitrary configuration commands based
1974        upon recipients of the message.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a regular expression matching the
1975        desired address.  _\bc_\bo_\bm_\bm_\ba_\bn_\bd is executed when _\br_\be_\bg_\be_\bx_\bp matches recipients of the
1976        message.
1977
1978        reply-hook is matched against the message you are _\br_\be_\bp_\bl_\by_\bi_\bn_\bg t\bto\bo, instead of the
1979        message you are _\bs_\be_\bn_\bd_\bi_\bn_\bg.  send-hook is matched against all messages, both _\bn_\be_\bw
1980        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
1981        the order specified in the users's configuration file.
1982
1983        send2-hook is matched every time a message is changed, either by editing it, or
1984        by using the compose menu to change its recipients or subject.  send2-hook is
1985        executed after send-hook, and can, e.g., be used to set parameters such as the
1986        _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.260  , page 151) variable depending on the message's
1987        sender address.
1988
1989        For each type of send-hook or reply-hook, when multiple matches occur, commands
1990        are executed in the order they are specified in the muttrc (for that type of
1991        hook).
1992
1993        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
1994        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1995
1996        Example: send-hook mutt 'set mime_forward signature='''
1997
1998        Another typical use for this command is to change the values of the _\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\b-
1999        _\bt_\bi_\bo_\bn (section 7.4.18  , page 93), _\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.272  , page 154) and
2000        _\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.120  , page 119) variables in order to change the language
2001        of the attributions and signatures based upon the recipients.
2002
2003        N\bNo\bot\bte\be:\b: the send-hook's are only executed ONCE after getting the initial list of
2004        recipients.  Adding a recipient after replying or editing the message will NOT
2005        cause any send-hook to be executed.  Also note that my_hdr commands which mod-
2006        ify recipient headers, or the message's subject, don't have any effect on the
2007        current message when executed from a send-hook.
2008
2009        _\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
2010
2011        Usage: message-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
2012
2013        This command can be used to execute arbitrary configuration commands before
2014        viewing or formatting a message based upon information about the message.  _\bc_\bo_\bm_\b-
2015        _\bm_\ba_\bn_\bd is executed if the _\bp_\ba_\bt_\bt_\be_\br_\bn matches the message to be displayed. When mul-
2016        tiple matches occur, commands are executed in the order they are specified in
2017        the muttrc.
2018
2019        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
2020        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
2021
2022        Example:
2023
2024             message-hook ~A 'set pager=builtin'
2025
2026        The Mutt Next Generation E-Mail Client                                       41
2027
2028             message-hook '~f freshmeat-news' 'set pager="less \"+/^  subject: .*\""'
2029
2030        _\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
2031
2032        Usage: crypt-hook _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\bi_\bd
2033
2034        When encrypting messages with PGP or OpenSSL, you may want to associate a cer-
2035        tain key with a given e-mail address automatically, either because the recipi-
2036        ent's public key can't be deduced from the destination address, or because, for
2037        some reasons, you need to override the key Mutt-ng would normally use.  The
2038        crypt-hook command provides a method by which you can specify the ID of the
2039        public key to be used when encrypting messages to a certain recipient.
2040
2041        The meaning of "key id" is to be taken broadly in this context:  You can either
2042        put a numerical key ID here, an e-mail address, or even just a real name.
2043
2044        _\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
2045
2046        Usage: push _\bs_\bt_\br_\bi_\bn_\bg
2047
2048        This command adds the named string to the keyboard buffer. The string may con-
2049        tain control characters, key names and function names like the sequence string
2050        in the _\bm_\ba_\bc_\br_\bo (section 3.8  , page 29) command. You may use it to automatically
2051        run a sequence of commands at startup, or when entering certain folders.
2052
2053        _\b3_\b._\b2_\b5  _\bE_\bx_\be_\bc_\bu_\bt_\bi_\bn_\bg _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
2054
2055        Usage: exec _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
2056
2057        This command can be used to execute any function. Functions are listed in the
2058        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 175).  ``exec function'' is equivalent
2059        to ``push <function>''.
2060
2061        _\b3_\b._\b2_\b6  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bS_\bc_\bo_\br_\bi_\bn_\bg
2062
2063        Usage: score _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
2064
2065        Usage: unscore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
2066
2067        In situations where you have to cope with a lot of emails, e.g.  when you read
2068        many different mailing lists, and take part in discussions, it is always useful
2069        to have the important messages marked and the annoying messages or the ones
2070        that you aren't interested in deleted. For this purpose, mutt-ng features a
2071        mechanism called ``scoring''.
2072
2073        The Mutt Next Generation E-Mail Client                                       42
2074
2075        When you use scoring, every message has a base score of 0. You can then use the
2076        score command to define patterns and a positive or negative value associated
2077        with it. When a pattern matches a message, the message's score will be raised
2078        or lowered by the amount of the value associated with the pattern.
2079
2080             score "~f nion@muttng\.org" 50
2081             score "~f @sco\.com" -100
2082
2083        If the pattern matches, it is also possible to set the score value of the cur-
2084        rent message to a certain value and then stop evaluation:
2085
2086             score "~f santaclaus@northpole\.int" =666
2087
2088        What is important to note is that negative score values will be rounded up to
2089        0.
2090
2091        To make scoring actually useful, the score must be applied in some way.  That's
2092        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:
2093
2094           +\bo flag threshold: when a message has a score value equal or higher than the
2095             flag threshold, it will be flagged.
2096
2097           +\bo read threshold: when a message has a score value equal or lower than the
2098             read threshold, it will be marked as read.
2099
2100           +\bo delete threshold: when a message has a score value equal or lower than the
2101             delete threshold, it will be marked as deleted.
2102
2103        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-
2104        tion 7.4.257  , page 150), _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.258  , page 151),
2105        _\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.256  , page 150) and.  By default,
2106        _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.258  , page 151) and _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
2107        (section 7.4.256  , page 150) are set to -1, which means that in the default
2108        threshold configuration no message will ever get marked as read or deleted.
2109
2110        Scoring gets especially interesting when combined with the color command and
2111        the ~n pattern:
2112
2113             color index  black   yellow  "~n 10-"
2114             color index  red     yellow  "~n 100-"
2115
2116        The rules above mark all messages with a score between 10 and 99 with black and
2117        yellow, and messages with a score greater or equal 100 with red and yellow.
2118        This might be unusual to you if you're used to e.g. slrn's scoring mechanism,
2119        but it is more flexible, as it visually marks different scores.
2120
2121        The Mutt Next Generation E-Mail Client                                       43
2122
2123        _\b3_\b._\b2_\b7  _\bS_\bp_\ba_\bm _\bd_\be_\bt_\be_\bc_\bt_\bi_\bo_\bn
2124
2125        Usage: spam _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
2126
2127        Usage: nospam _\bp_\ba_\bt_\bt_\be_\br_\bn
2128
2129        Mutt-ng has generalized support for external spam-scoring filters.  By defining
2130        your spam patterns with the spam and nospam commands, you can _\bl_\bi_\bm_\bi_\bt, _\bs_\be_\ba_\br_\bc_\bh,
2131        and _\bs_\bo_\br_\bt your mail based on its spam attributes, as determined by the external
2132        filter. You also can display the spam attributes in your index display using
2133        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.
2134        (Tip: try %?H?[%H] ?  to display spam tags only when they are defined for a
2135        given message.)
2136
2137        Your first step is to define your external filter's spam patterns using the
2138        spam command. _\bp_\ba_\bt_\bt_\be_\br_\bn should be a regular expression that matches a header in a
2139        mail message. If any message in the mailbox matches this regular expression, it
2140        will receive a ``spam tag'' or ``spam attribute'' (unless it also matches a
2141        nospam pattern -- see below.) The appearance of this attribute is entirely up
2142        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,
2143        but it also can include back-references from the _\bp_\ba_\bt_\bt_\be_\br_\bn expression. (A regular
2144        expression ``back-reference'' refers to a sub-expression contained within
2145        parentheses.) %1 is replaced with the first back-reference in the regex, %2
2146        with the second, etc.
2147
2148        If you're using multiple spam filters, a message can have more than one spam-
2149        related header. You can define spam patterns for each filter you use. If a mes-
2150        sage matches two or more of these patterns, and the $spam_separator variable is
2151        set to a string, then the message's spam tag will consist of all the _\bf_\bo_\br_\bm_\ba_\bt
2152        strings joined together, with the value of $spam_separator separating them.
2153
2154        For example, suppose I use DCC, SpamAssassin, and PureMessage. I might define
2155        these spam settings:
2156
2157             spam "X-DCC-.*-Metrics:.*(....)=many"         "90+/DCC-%1"
2158             spam "X-Spam-Status: Yes"                     "90+/SA"
2159             spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM"
2160             set spam_separator=", "
2161
2162        If I then received a message that DCC registered with ``many'' hits under the
2163        ``Fuz2'' checksum, and that PureMessage registered with a 97% probability of
2164        being spam, that message's spam tag would read 90+/DCC-Fuz2, 97/PM. (The four
2165        characters before ``=many'' in a DCC report indicate the checksum used -- in
2166        this case, ``Fuz2''.)
2167
2168        If the $spam_separator variable is unset, then each spam pattern match super-
2169        sedes the previous one. Instead of getting joined _\bf_\bo_\br_\bm_\ba_\bt strings, you'll get
2170        only the last one to match.
2171
2172        The spam tag is what will be displayed in the index when you use %H in the
2173        $index_format variable. It's also the string that the ~H pattern-matching
2174        expression matches against for _\bs_\be_\ba_\br_\bc_\bh and _\bl_\bi_\bm_\bi_\bt functions. And it's what sort-
2175        ing by spam attribute will use as a sort key.
2176
2177        The Mutt Next Generation E-Mail Client                                       44
2178
2179        That's a pretty complicated example, and most people's actual environments will
2180        have only one spam filter. The simpler your configuration, the more effective
2181        mutt can be, especially when it comes to sorting.
2182
2183        Generally, when you sort by spam tag, mutt will sort _\bl_\be_\bx_\bi_\bc_\ba_\bl_\bl_\by -- that is, by
2184        ordering strings alphnumerically. However, if a spam tag begins with a number,
2185        mutt will sort numerically first, and lexically only when two numbers are equal
2186        in value. (This is like UNIX's sort -n.) A message with no spam attributes at
2187        all -- that is, one that didn't match _\ba_\bn_\by of your spam patterns -- is sorted at
2188        lowest priority. Numbers are sorted next, beginning with 0 and ranging upward.
2189        Finally, non-numeric strings are sorted, with ``a'' taking lower priority than
2190        ``z''. Clearly, in general, sorting by spam tags is most effective when you can
2191        coerce your filter to give you a raw number. But in case you can't, mutt can
2192        still do something useful.
2193
2194        The nospam command can be used to write exceptions to spam patterns. If a
2195        header pattern matches something in a spam command, but you nonetheless do not
2196        want it to receive a spam tag, you can list a more precise pattern under a
2197        nospam command.
2198
2199        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-
2200        ing spam list entry, the effect will be to remove the entry from the spam list,
2201        instead of adding an exception.  Likewise, if the _\bp_\ba_\bt_\bt_\be_\br_\bn for a spam command
2202        matches an entry on the nospam list, that nospam entry will be removed. If the
2203        _\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
2204        might be the default action if you use spam and nospam in conjunction with a
2205        folder-hook.
2206
2207        You can have as many spam or nospam commands as you like.  You can even do your
2208        own primitive spam detection within mutt -- for example, if you consider all
2209        mail from MAILER-DAEMON to be spam, you can use a spam command like this:
2210
2211             spam "^From: .*MAILER-DAEMON"       "999"
2212
2213        _\b3_\b._\b2_\b8  _\bS_\be_\bt_\bt_\bi_\bn_\bg _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2214
2215        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 ... ]
2216
2217        Usage: toggle _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2218
2219        Usage: unset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2220
2221        Usage: reset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2222
2223        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  ,
2224        page 87).  There are four basic types of variables: boolean, number, string and
2225        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
2226        variables can be assigned a positive integer value.
2227
2228        _\bs_\bt_\br_\bi_\bn_\bg variables consist of any number of printable characters.  _\bs_\bt_\br_\bi_\bn_\bg_\bs must
2229
2230        The Mutt Next Generation E-Mail Client                                       45
2231
2232        be enclosed in quotes if they contain spaces or tabs.  You may also use the
2233        ``C'' escape sequences \\b\n\bn and \\b\t\bt for newline and tab, respectively.
2234
2235        _\bq_\bu_\ba_\bd_\bo_\bp_\bt_\bi_\bo_\bn variables are used to control whether or not to be prompted for cer-
2236        tain actions, or to specify a default action.  A value of _\by_\be_\bs will cause the
2237        action to be carried out automatically as if you had answered yes to the ques-
2238        tion.  Similarly, a value of _\bn_\bo will cause the the action to be carried out as
2239        if you had answered ``no.''  A value of _\ba_\bs_\bk_\b-_\by_\be_\bs will cause a prompt with a
2240        default answer of ``yes'' and _\ba_\bs_\bk_\b-_\bn_\bo will provide a default answer of ``no.''
2241
2242        Prefixing a variable with ``no'' will unset it.  Example: set noaskbcc.
2243
2244        For _\bb_\bo_\bo_\bl_\be_\ba_\bn variables, you may optionally prefix the variable name with inv to
2245        toggle the value (on or off).  This is useful when writing macros.  Example:
2246        set invsmart_wrap.
2247
2248        The toggle command automatically prepends the inv prefix to all specified vari-
2249        ables.
2250
2251        The unset command automatically prepends the no prefix to all specified vari-
2252        ables.
2253
2254        Using the enter-command function in the _\bi_\bn_\bd_\be_\bx menu, you can query the value of
2255        a variable by prefixing the name of the variable with a question mark:
2256
2257             set ?allow_8bit
2258
2259        The question mark is actually only required for boolean and quadoption vari-
2260        ables.
2261
2262        The reset command resets all given variables to the compile time defaults
2263        (hopefully mentioned in this manual). If you use the command set and prefix the
2264        variable with ``&'' this has the same behavior as the reset command.
2265
2266        With the reset command there exists the special variable ``all'', which allows
2267        you to reset all variables to their system defaults.
2268
2269        _\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
2270
2271        Usage: source _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
2272
2273        This command allows the inclusion of initialization commands from other files.
2274        For example, I place all of my aliases in ~/.mail_aliases so that I can make my
2275        ~/.muttrc readable and keep my aliases private.
2276
2277        If the filename begins with a tilde (``~''), it will be expanded to the path of
2278        your home directory.
2279
2280        If the filename ends with a vertical bar (|), then _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be is considered to be
2281        an executable program from which to read input (eg.  source ~/bin/myscript|).
2282
2283        The Mutt Next Generation E-Mail Client                                       46
2284
2285        _\b3_\b._\b3_\b0  _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
2286
2287        Usage: unhook [ * | _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be ]
2288
2289        This command permits you to flush hooks you have previously defined.  You can
2290        either remove all hooks by giving the ``*'' character as an argument, or you
2291        can remove all hooks of a specific type by saying something like unhook send-
2292        hook.
2293
2294        _\b3_\b._\b3_\b1  _\bS_\bh_\ba_\br_\bi_\bn_\bg _\bS_\be_\bt_\bu_\bp_\bs
2295
2296        _\b3_\b._\b3_\b1_\b._\b1  _\bC_\bh_\ba_\br_\ba_\bc_\bt_\be_\br _\bS_\be_\bt_\bs
2297
2298        As users may run mutt-ng on different systems, the configuration must be main-
2299        tained because it's likely that people want to use the setup everywhere they
2300        use mutt-ng. And mutt-ng tries to help where it can.
2301
2302        To not produce conflicts with different character sets, mutt-ng allows users to
2303        specify in which character set their configuration files are encoded. Please
2304        note that while reading the configuration files, this is only respected after
2305        the corresponding declaration appears. It's advised to put the following at the
2306        very beginning of a users muttngrc:
2307
2308             set config_charset = "..."
2309
2310        and replacing the dots with the actual character set. To avoid problems while
2311        maintaining the setup, vim user's may want to use modelines as show in:
2312
2313             # vim:fileencoding=...:
2314
2315        while, again, replacing the dots with the appropriate name. This tells vim as
2316        which character set to read and save the file.
2317
2318        _\b3_\b._\b3_\b1_\b._\b2  _\bM_\bo_\bd_\bu_\bl_\ba_\br_\bi_\bz_\ba_\bt_\bi_\bo_\bn
2319
2320        ``Modularization'' means to divide the setup into several files while sorting
2321        the options or commands by topic. Especially for longer setups (e.g. with many
2322        hooks), this helps maintaining it and solving trouble.
2323
2324        When using separation, setups may be, as a whole or in fractions, shared over
2325        different systems.
2326
2327        _\b3_\b._\b3_\b1_\b._\b3  _\bC_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bp_\ba_\br_\bt_\bs
2328
2329        The Mutt Next Generation E-Mail Client                                       47
2330
2331        When using a configuration on different systems, the user may not always have
2332        influence on how mutt-ng is installed and which features it includes.
2333
2334        To solve this, mutt-ng contain a feature based on the ``ifdef'' patch written
2335        for mutt. Its basic syntax is:
2336
2337             ifdef <item> <command>
2338             ifndef <item> <command>
2339
2340        ...whereby <item> can be one of:
2341
2342           +\bo a function name
2343
2344           +\bo a variable name
2345
2346           +\bo a menu name
2347
2348           +\bo a feature name
2349
2350        All available functions, variables and menus are documented elsewhere in this
2351        manual but ``features'' is specific to these two commands. To test for one,
2352        prefix one of the following keywords with feature_:
2353
2354             ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl,
2355             gnutls, sasl, sasl2, libesmtp, compressed, color, classic_pgp,
2356             classic_smime, gpgme, header_cache
2357
2358        As an example, one can use the following in ~/.muttngrc:
2359
2360             ifdef feature_imap 'source ~/.mutt-ng/setup-imap'
2361             ifdef feature_pop  'source ~/.mutt-ng/setup-pop'
2362             ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp'
2363
2364        ...to only source ~/.mutt-ng/setup-imap if IMAP support is built in, only
2365        source ~/.mutt-ng/setup-pop if POP support is built in and only source ~/.mutt-
2366        ng/setup-nntp if NNTP support is built in.
2367
2368        An example for testing for variable names can be used if users use different
2369        revisions of mutt-ng whereby the older one may not have a certain variable. To
2370        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),
2371        use:
2372
2373             ifdef imap_mail_check 'set imap_mail_check = 300'
2374
2375        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
2376        (section 7.4.182  , page 133) only if the pager menu is available, use:
2377
2378        The Mutt Next Generation E-Mail Client                                       48
2379
2380             ifdef pager 'set pager_index_lines = 10'
2381
2382        For completeness, too, the opposite of ifdef is provided: ifndef which only
2383        executes the command if the test fails. For example, the following two examples
2384        are equivalent:
2385
2386             ifdef feature_ncurses 'source ~/.mutt-ng/setup-ncurses'
2387             ifndef feature_ncurses 'source ~/.mutt-ng/setup-slang'
2388
2389        ...and...
2390
2391             ifdef feature_slang 'source ~/.mutt-ng/setup-slang'
2392             ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
2393
2394        _\b3_\b._\b3_\b2  _\bO_\bb_\bs_\bo_\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2395
2396        In the process of ensuring and creating more consistency, many variables have
2397        been renamed and some of the old names were already removed. Please see _\bO_\bb_\bs_\bo_\b-
2398        _\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs (section 7.4  , page 87) for a complete list.
2399
2400        _\b4_\b.  _\bA_\bd_\bv_\ba_\bn_\bc_\be_\bd _\bU_\bs_\ba_\bg_\be
2401
2402        _\b4_\b._\b1  _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs
2403
2404        All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
2405        tion 7.2  , page 83) must be specified using regular expressions (regexp) in
2406        the ``POSIX extended'' syntax (which is more or less the syntax used by egrep
2407        and GNU awk).  For your convenience, we have included below a brief description
2408        of this syntax.
2409
2410        The search is case sensitive if the pattern contains at least one upper case
2411        letter, and case insensitive otherwise. Note that ``\'' must be quoted if used
2412        for a regular expression in an initialization command: ``\\''.
2413
2414        A regular expression is a pattern that describes a set of strings.  Regular
2415        expressions are constructed analogously to arithmetic expressions, by using
2416        various operators to combine smaller expressions.
2417
2418        Note that the regular expression can be enclosed/delimited by either ' or '
2419        which is useful if the regular expression includes a white-space character.
2420
2421        The Mutt Next Generation E-Mail Client                                       49
2422
2423        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-
2424        tion on ' and ' delimiter processing.  To match a literal ' or ' you must pref-
2425        ace it with \ (backslash).
2426
2427        The fundamental building blocks are the regular expressions that match a single
2428        character.  Most characters, including all letters and digits, are regular
2429        expressions that match themselves.  Any metacharacter with special meaning may
2430        be quoted by preceding it with a backslash.
2431
2432        The period ``.'' matches any single character.  The caret ``^'' and the dollar
2433        sign ``$'' are metacharacters that respectively match the empty string at the
2434        beginning and end of a line.
2435
2436        A list of characters enclosed by ``['' and ``]'' matches any single character
2437        in that list; if the first character of the list is a caret ``^'' then it
2438        matches any character n\bno\bot\bt in the list.  For example, the regular expression
2439        [\b[0\b01\b12\b23\b34\b45\b56\b67\b78\b89\b9]\b] matches any single digit.  A range of ASCII characters may be
2440        specified by giving the first and last characters, separated by a hyphen ``-''.
2441        Most metacharacters lose their special meaning inside lists.  To include a lit-
2442        eral ``]'' place it first in the list.  Similarly, to include a literal ``^''
2443        place it anywhere but first.  Finally, to include a literal hyphen ``-'' place
2444        it last.
2445
2446        Certain named classes of characters are predefined.  Character classes consist
2447        of ``[:'', a keyword denoting the class, and ``:]''.  The following classes are
2448        defined by the POSIX standard:
2449
2450              [:alnum:]
2451                    Alphanumeric characters.
2452
2453              [:alpha:]
2454                    Alphabetic characters.
2455
2456              [:blank:]
2457                    Space or tab characters.
2458
2459              [:cntrl:]
2460                    Control characters.
2461
2462              [:digit:]
2463                    Numeric characters.
2464
2465              [:graph:]
2466                    Characters that are both printable and visible.  (A space is print-
2467                    able, but not visible, while an ``a'' is both.)
2468
2469              [:lower:]
2470                    Lower-case alphabetic characters.
2471
2472              [:print:]
2473                    Printable characters (characters that are not control characters.)
2474
2475              [:punct:]
2476                    Punctuation characters (characters that are not letter, digits,
2477
2478        The Mutt Next Generation E-Mail Client                                       50
2479
2480                    control characters, or space characters).
2481
2482              [:space:]
2483                    Space characters (such as space, tab and formfeed, to name a few).
2484
2485              [:upper:]
2486                    Upper-case alphabetic characters.
2487
2488              [:xdigit:]
2489                    Characters that are hexadecimal digits.
2490
2491        A character class is only valid in a regular expression inside the brackets of
2492        a character list.  Note that the brackets in these class names are part of the
2493        symbolic names, and must be included in addition to the brackets delimiting the
2494        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].
2495
2496        Two additional special sequences can appear in character lists.  These apply to
2497        non-ASCII character sets, which can have single symbols (called collating ele-
2498        ments) that are represented with more than one character, as well as several
2499        characters that are equivalent for collating or sorting purposes:
2500
2501              Collating Symbols
2502                    A collating symbol is a multi-character collating element enclosed
2503                    in ``[.'' and ``.]''.  For example, if ``ch'' is a collating ele-
2504                    ment, then [\b[[\b[.\b.c\bch\bh.\b.]\b]]\b] is a regexp that matches this collating ele-
2505                    ment, while [\b[c\bch\bh]\b] is a regexp that matches either ``c'' or ``h''.
2506
2507              Equivalence Classes
2508                    An equivalence class is a locale-specific name for a list of char-
2509                    acters that are equivalent. The name is enclosed in ``[='' and
2510                    ``=]''.  For example, the name ``e'' might be used to represent all
2511                    of ``'' ``'' and ``e''.  In this case, [\b[[\b[=\b=e\be=\b=]\b]]\b] is a regexp that
2512                    matches any of ``'', ``'' and ``e''.
2513
2514        A regular expression matching a single character may be followed by one of sev-
2515        eral repetition operators:
2516
2517              ?
2518                    The preceding item is optional and matched at most once.
2519
2520              *
2521                    The preceding item will be matched zero or more times.
2522
2523              +
2524                    The preceding item will be matched one or more times.
2525
2526              {n}
2527                    The preceding item is matched exactly _\bn times.
2528
2529              {n,}
2530                    The preceding item is matched _\bn or more times.
2531
2532              {,m}
2533                    The preceding item is matched at most _\bm times.
2534
2535        The Mutt Next Generation E-Mail Client                                       51
2536
2537              {n,m}
2538                    The preceding item is matched at least _\bn times, but no more than _\bm
2539                    times.
2540
2541        Two regular expressions may be concatenated; the resulting regular expression
2542        matches any string formed by concatenating two substrings that respectively
2543        match the concatenated subexpressions.
2544
2545        Two regular expressions may be joined by the infix operator ``|''; the result-
2546        ing regular expression matches any string matching either subexpression.
2547
2548        Repetition takes precedence over concatenation, which in turn takes precedence
2549        over alternation.  A whole subexpression may be enclosed in parentheses to
2550        override these precedence rules.
2551
2552        N\bNo\bot\bte\be:\b: If you compile Mutt-ng with the GNU _\br_\bx package, the following operators
2553        may also be used in regular expressions:
2554
2555              \\y
2556                    Matches the empty string at either the beginning or the end of a
2557                    word.
2558
2559              \\B
2560                    Matches the empty string within a word.
2561
2562              \\<
2563                    Matches the empty string at the beginning of a word.
2564
2565              \\>
2566                    Matches the empty string at the end of a word.
2567
2568              \\w
2569                    Matches any word-constituent character (letter, digit, or under-
2570                    score).
2571
2572              \\W
2573                    Matches any character that is not word-constituent.
2574
2575              \\`
2576                    Matches the empty string at the beginning of a buffer (string).
2577
2578              \\'
2579                    Matches the empty string at the end of a buffer.
2580
2581        Please note however that these operators are not defined by POSIX, so they may
2582        or may not be available in stock libraries on various systems.
2583
2584        _\b4_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2585
2586        Mutt-ng's pattern language provides a simple yet effective way to set up rules
2587        to match messages, e.g. for operations like tagging and scoring. A pattern con-
2588        sists of one or more sub-pattern, which can be logically grouped, ORed, and
2589
2590        The Mutt Next Generation E-Mail Client                                       52
2591
2592        negated. For a complete listing of these patterns, please refer to table _\bP_\ba_\bt_\b-
2593        _\bt_\be_\br_\bn_\bs (section 7.2  , page 83) in the Reference chapter.
2594
2595        It must be noted that in this table, EXPR, USER, ID and SUBJECT are regular
2596        expressions. For ranges, the forms <[MAX], >>[MIN], [MIN]- and -[MAX] are also
2597        possible.
2598
2599        _\b4_\b._\b2_\b._\b1  _\bC_\bo_\bm_\bp_\bl_\be_\bx _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2600
2601        It is possible to combine several sub-patterns to a more complex pattern. The
2602        most simple possibility is to logically AND several patterns by stringing them
2603        together:
2604
2605             ~s 'SPAM' ~U
2606
2607        The pattern above matches all messages that contain ``SPAM'' in the subject and
2608        are unread.
2609
2610        To logical OR patterns, simply use the | operator. This one especially useful
2611        when using local groups:
2612
2613             ~f ("nion@muttng\.org"|"ak@muttng\.org"|"pdmef@muttng\.org")
2614             (~b mutt-ng|~s Mutt-ng)
2615             !~x '@synflood\.at'
2616
2617        The first pattern matches all messages that were sent by one of the mutt-ng
2618        maintainers, while the seconds pattern matches all messages that contain
2619        ``mutt-ng'' in the message body or ``Mutt-ng'' in the subject. The third pat-
2620        tern matches all messages that do not contain ``@synflood\.at'' in the Refer-
2621        ences: header, i.e.  messages that are not an (indirect) reply to one of my
2622        messages. A pattern can be logicall negated using the ! operator.
2623
2624        _\b4_\b._\b2_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs _\ba_\bn_\bd _\bD_\ba_\bt_\be_\bs
2625
2626        When using dates in patterns, the dates must be specified in a special format,
2627        i.e.  DD/MM/YYYY. If you don't specify month or year, they default to the cur-
2628        rent month or year. When using date ranges, and you specify only the minimum or
2629        the maximum, the specified date will be excluded, e.g. 01/06/2005- matches
2630        against all messages _\ba_\bf_\bt_\be_\br Juni 1st, 2005.
2631
2632        It is also possible to use so-called ``error margins'' when specifying date
2633        ranges.  You simply specify a date, and then the error margin. This margin
2634        needs to contain the information whether it goes ``forth'' or ``back'' in time,
2635        by using + and -.  Then follows a number and a unit, i.e. y for years, m for
2636        months, w for weeks and d for days. If you use the special * sign, it means
2637        that the error margin goes to both ``directions'' in time.
2638
2639             ~d 01/01/2005+1y
2640             ~d 18/10/2004-2w
2641
2642        The Mutt Next Generation E-Mail Client                                       53
2643
2644             ~d 28/12/2004*1d
2645
2646        The first pattern matches all dates between January 1st, 2005 and January 1st
2647        2006.  The second pattern matches all dates between October 18th, 2004 and
2648        October 4th 2004 (2 weeks before 18/10/2004), while the third pattern matches
2649        all dates 1 day around December 28th, 2004 (i.e. Dec 27th, 28th and 29th).
2650
2651        Relative dates are also very important, as they make it possible to specify
2652        date ranges between a fixed number of units and the current date. How this
2653        works can be seen in the following example:
2654
2655             ~d >2w # messages older than two weeks
2656             ~d <3d # messages newer than 3 days
2657             ~d =1m # messages that are exactly one month old
2658
2659        _\b4_\b._\b3  _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs
2660
2661        _\b4_\b._\b3_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
2662
2663        The so called _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs offer great flexibility when configuring mutt-ng.
2664        In short, they describe what items to print out how in menus and status mes-
2665        sages.
2666
2667        Basically, they work as this: for different menus and bars, there's a variable
2668        specifying the layout. For every item available, there is a so called _\be_\bx_\bp_\ba_\bn_\bd_\bo.
2669
2670        For example, when running mutt-ng on different machines or different versions
2671        for testing purposes, it may be interesting to have the following information
2672        always printed on screen when one is in the index:
2673
2674           +\bo the current hostname
2675
2676           +\bo the current mutt-ng version number
2677
2678        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-
2679        _\bm_\ba_\bt (section 7.4.321  , page 165) variable. For the hostname and version
2680        string, there's an expando for $status_format: %h expands to the hostname and
2681        %v to the version string. When just configuring:
2682
2683             set status_format = "%v on %h: ..."
2684
2685        mutt-ng will replace the sequence %v with the version string and %h with the
2686        host's name. When you are, for example, running mutt-ng version 1.5.9i on host
2687        mailhost, you'll see the following when you're in the index:
2688
2689             Mutt-ng 1.5.9i on mailhost: ...
2690
2691        The Mutt Next Generation E-Mail Client                                       54
2692
2693        In the index, there're more useful information one could want to see:
2694
2695           +\bo which mailbox is open
2696
2697           +\bo how man new, flagged or postponed messages
2698
2699           +\bo ...
2700
2701        To include the mailbox' name is as easy as:
2702
2703             set status_format = "%v on %h: %B: ...
2704
2705        When the currently opened mailbox is Inbox, this will be expanded to:
2706
2707             Mutt-ng 1.5.9i on mailhost: Inbox: ...
2708
2709        For the number of certain types of messages, one more feature of the format
2710        strings is extremely useful. If there aren't messages of a certain type, it may
2711        not be desired to print just that there aren't any but instead only print some-
2712        thing if there are any.
2713
2714        _\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
2715
2716        To only print the number of messages if there are new messages in the current
2717        mailbox, further extend $status_format to:
2718
2719             set status_format = "%v on %h: %B %?n?%n new? ...
2720
2721        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
2722        optionally printed nonzero, i.e.  a portion of the format string is only evalu-
2723        ated if the value of the expando is different from zero. The basic syntax is:
2724
2725             %?<item>?<string if nonzero>?
2726
2727        which tells mutt-ng to only look at <string if nonzero> if the value of the
2728        %<item%gt; expando is different from zero. In our example, we used n as the
2729        expando to check for and %n new as the optional nonzero string.
2730
2731        But this is not all: this feature only offers one alternative: ``print some-
2732        thing if not zero.'' Mutt-ng does, as you might guess, also provide a logically
2733        complete version: ``if zero, print something and else print something else.''
2734        This is achieved by the following syntax for those expandos which may be
2735        printed nonzero:
2736
2737        The Mutt Next Generation E-Mail Client                                       55
2738
2739             %?<item>?<string if nonzero>&<string if zero>?
2740
2741        Using this we can make mutt-ng to do the following:
2742
2743           +\bo  make it print ``_\bn new messages'' whereby _\bn is the count but only if there
2744             new ones
2745
2746           +\bo  and make it print ``no new messages'' if there aren't any
2747
2748        The corresponding configuration is:
2749
2750             set status_format = "%v on %h: %B: %?n?%n new messages&no new messages? ...
2751
2752        This doubles the use of the ``new messages'' string because it'll get always
2753        printed. Thus, it can be shortened to:
2754
2755             set status_format = "%v on %h: %B: %?n?%n&no? new messages ...
2756
2757        As you might see from this rather simple example, one can create very complex
2758        but fancy status messages. Please see the reference chapter for expandos and
2759        those which may be printed nonzero.
2760
2761        _\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
2762
2763        Besides the information given so far, there're even more features of format
2764        strings:
2765
2766           +\bo When specifying %_<item> instead of just %<item>, mutt-ng will convert all
2767             characters in the expansion of <item> to lowercase.
2768
2769           +\bo When specifying %:<item> instead of just %<item>, mutt-ng will convert all
2770             dots in the expansion of <item> to underscores (_).
2771
2772        Also, there's a feature called _\bP_\ba_\bd_\bd_\bi_\bn_\bg supplied by the following two expandos:
2773        %|X and %>X.
2774
2775              %|X
2776                    When this occurs, mutt-ng will fill the rest of the line with the
2777                    character X. In our example, filling the rest of the line with
2778                    dashes is done by setting:
2779
2780                         set status_format = "%v on %h: %B: %?n?%n&no? new messages %|-"
2781
2782              %>X
2783                    Since the previous expando stops at the end of line, there must be
2784
2785        The Mutt Next Generation E-Mail Client                                       56
2786
2787                    a way to fill the gap between two items via the %>X expando: it
2788                    puts as many characters X in between two items so that the rest of
2789                    the line will be right-justified. For example, to not put the ver-
2790                    sion string and hostname of our example on the left but on the
2791                    right and fill the gap with spaces, one might use (note the space
2792                    after %>):
2793
2794                         set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)"
2795
2796        _\b4_\b._\b4  _\bU_\bs_\bi_\bn_\bg _\bT_\ba_\bg_\bs
2797
2798        Sometimes it is desirable to perform an operation on a group of messages all at
2799        once rather than one at a time.  An example might be to save messages to a
2800        mailing list to a separate folder, or to delete all messages with a given sub-
2801        ject.  To tag all messages matching a pattern, use the tag-pattern function,
2802        which is bound to ``shift-T'' by default.  Or you can select individual mes-
2803        sages by hand using the ``tag-message'' function, which is bound to ``t'' by
2804        default.  See _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 83) for Mutt-ng's pattern matching
2805        syntax.
2806
2807        Once you have tagged the desired messages, you can use the ``tag-prefix'' oper-
2808        ator, which is the ``;'' (semicolon) key by default.  When the ``tag-prefix''
2809        operator is used, the n\bne\bex\bxt\bt operation will be applied to all tagged messages if
2810        that operation can be used in that manner.  If the _\b$_\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg (section 7.4.19  ,
2811        page 93) variable is set, the next operation applies to the tagged messages
2812        automatically, without requiring the ``tag-prefix''.
2813
2814        In _\bm_\ba_\bc_\br_\bo_\bs (section 3.8  , page 29) or _\bp_\bu_\bs_\bh (section 3.24  , page 41) commands,
2815        you can use the ``tag-prefix-cond'' operator.  If there are no tagged messages,
2816        mutt will "eat" the rest of the macro to abort it's execution.  Mutt-ng will
2817        stop "eating" the macro when it encounters the ``end-cond'' operator;  after
2818        this operator the rest of the macro will be executed as normal.
2819
2820        _\b4_\b._\b5  _\bU_\bs_\bi_\bn_\bg _\bH_\bo_\bo_\bk_\bs
2821
2822        A _\bh_\bo_\bo_\bk is a concept borrowed from the EMACS editor which allows you to execute
2823        arbitrary commands before performing some operation.  For example, you may wish
2824        to tailor your configuration based upon which mailbox you are reading, or to
2825        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
2826        _\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
2827        with a configuration option/command.  See
2828
2829           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.7  , page 29)
2830
2831           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 39)
2832
2833        The Mutt Next Generation E-Mail Client                                       57
2834
2835           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.22  , page 40)
2836
2837           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 38)
2838
2839           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 37)
2840
2841           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 39)
2842
2843           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 39)
2844
2845        for specific details on each type of _\bh_\bo_\bo_\bk available.
2846
2847        N\bNo\bot\bte\be:\b: if a hook changes configuration settings, these changes remain effective
2848        until the end of the current mutt session. As this is generally not desired, a
2849        default hook needs to be added before all other hooks to restore configuration
2850        defaults. Here is an example with send-hook and the my_hdr directive:
2851
2852             send-hook . 'unmy_hdr From:'
2853             send-hook ~C'^b@b\.b$' my_hdr from: c@c.c
2854
2855        _\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
2856
2857        Hooks that act upon messages (send-hook, save-hook, fcc-hook, message-hook) are
2858        evaluated in a slightly different manner.  For the other types of hooks, a _\br_\be_\bg_\b-
2859        _\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
2860        messages a finer grain of control is needed for matching since for different
2861        purposes you want to match different criteria.
2862
2863        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
2864        for matching messages in hook commands.  This works in exactly the same way as
2865        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
2866        to those operators which match information mutt extracts from the header of the
2867        message (i.e.  from, to, cc, date, subject, etc.).
2868
2869        For example, if you wanted to set your return address based upon sending mail
2870        to a specific address, you could do something like:
2871
2872             send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>'
2873
2874        which would execute the given command when sending mail to _\bm_\be_\b@_\bc_\bs_\b._\bh_\bm_\bc_\b._\be_\bd_\bu.
2875
2876        However, it is not required that you write the pattern to match using the full
2877        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
2878        other hooks, in which case Mutt-ng will translate your pattern into the full
2879        language, using the translation specified by the _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section
2880        7.4.49  , page 100) variable.  The pattern is translated at the time the hook
2881        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
2882        in effect at that time will be used.
2883
2884        The Mutt Next Generation E-Mail Client                                       58
2885
2886        _\b4_\b._\b6  _\bU_\bs_\bi_\bn_\bg _\bt_\bh_\be _\bs_\bi_\bd_\be_\bb_\ba_\br
2887
2888        The sidebar, a feature specific to Mutt-ng, allows you to use a mailbox listing
2889        which looks very similar to the ones you probably know from GUI mail clients.
2890        The sidebar lists all specified mailboxes, shows the number in each and high-
2891        lights the ones with new email Use the following configuration commands:
2892
2893             set sidebar_visible="yes"
2894             set sidebar_width=25
2895
2896        If you want to specify the mailboxes you can do so with:
2897
2898             set mbox='=INBOX'
2899             mailboxes INBOX \
2900                       MBOX1 \
2901                       MBOX2 \
2902                       ...
2903
2904        You can also specify the colors for mailboxes with new mails by using:
2905
2906             color sidebar_new red black
2907             color sidebar white black
2908
2909        The available functions are:
2910
2911             sidebar-scroll-up      Scrolls the mailbox list up 1 page
2912             sidebar-scroll-down    Scrolls the mailbox list down 1 page
2913             sidebar-next           Highlights the next mailbox
2914             sidebar-next-new       Highlights the next mailbox with new mail
2915             sidebar-previous       Highlights the previous mailbox
2916             sidebar-open           Opens the currently highlighted mailbox
2917
2918        Reasonable key bindings look e.g. like this:
2919
2920             bind index \Cp sidebar-prev
2921             bind index \Cn sidebar-next
2922             bind index \Cb sidebar-open
2923             bind pager \Cp sidebar-prev
2924             bind pager \Cn sidebar-next
2925             bind pager \Cb sidebar-open
2926
2927             macro index B ':toggle sidebar_visible^M'
2928             macro pager B ':toggle sidebar_visible^M'
2929
2930        You can then go up and down by pressing Ctrl-P and Ctrl-N, and switch on and
2931        off the sidebar simply by pressing 'B'.
2932
2933        The Mutt Next Generation E-Mail Client                                       59
2934
2935        _\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
2936
2937        Mutt-ng supports connecting to external directory databases such as LDAP,
2938        ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using a
2939        simple interface.  Using the _\b$_\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.234  , page 145) vari-
2940        able, you specify the wrapper command to use.  For example:
2941
2942             set query_command = "mutt_ldap_query.pl '%s'"
2943
2944        The wrapper script should accept the query on the command-line.  It should
2945        return a one line message, then each matching response on a single line, each
2946        line containing a tab separated address then name then some other optional
2947        information.  On error, or if there are no matching addresses, return a non-
2948        zero exit code and a one line error message.
2949
2950        An example multiple response output:
2951
2952             Searching database ... 20 entries ... 3 matching:
2953             me@cs.hmc.edu           Michael Elkins  mutt dude
2954             blong@fiction.net       Brandon Long    mutt and more
2955             roessler@guug.de        Thomas Roessler mutt pgp
2956
2957        There are two mechanisms for accessing the query function of mutt.  One is to
2958        do a query from the index menu using the query function (default: Q).  This
2959        will prompt for a query, then bring up the query menu which will list the
2960        matching responses.  From the query menu, you can select addresses to create
2961        aliases, or to mail.  You can tag multiple addresses to mail, start a new
2962        query, or have a new query appended to the current responses.
2963
2964        The other mechanism for accessing the query function is for address completion,
2965        similar to the alias completion.  In any prompt for address entry, you can use
2966        the complete-query function (default: ^T) to run a query based on the current
2967        address you have typed.  Like aliases, mutt will look for what you have typed
2968        back to the last space or comma.  If there is a single response for that query,
2969        mutt will expand the address in place.  If there are multiple responses, mutt
2970        will activate the query menu.  At the query menu, you can select one or more
2971        addresses to be added to the prompt.
2972
2973        _\b4_\b._\b8  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bF_\bo_\br_\bm_\ba_\bt_\bs
2974
2975        Mutt-ng supports reading and writing of four different mailbox formats: mbox,
2976        MMDF, MH and Maildir.  The mailbox type is autodetected, so there is no need to
2977        use a flag for different mailbox types.  When creating new mailboxes, Mutt-ng
2978        uses the default specified with the _\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.132  , page 121)
2979        variable.
2980
2981        m\bmb\bbo\box\bx.  This is the most widely used mailbox format for UNIX.  All messages are
2982        stored in a single file.  Each message has a line of the form:
2983
2984        The Mutt Next Generation E-Mail Client                                       60
2985
2986             From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
2987
2988        to denote the start of a new message (this is often referred to as the
2989        ``From_'' line).
2990
2991        M\bMM\bMD\bDF\bF.  This is a variant of the _\bm_\bb_\bo_\bx format.  Each message is surrounded by
2992        lines containing ``^A^A^A^A'' (four control-A's).
2993
2994        M\bMH\bH. A radical departure from _\bm_\bb_\bo_\bx and _\bM_\bM_\bD_\bF, a mailbox consists of a directory
2995        and each message is stored in a separate file.  The filename indicates the mes-
2996        sage number (however, this is may not correspond to the message number Mutt-ng
2997        displays). Deleted messages are renamed with a comma (,) prepended to the file-
2998        name. N\bNo\bot\bte\be:\b: Mutt detects this type of mailbox by looking for either
2999        .mh_sequences or .xmhcache (needed to distinguish normal directories from MH
3000        mailboxes).
3001
3002        M\bMa\bai\bil\bld\bdi\bir\br.  The newest of the mailbox formats, used by the Qmail MTA (a replace-
3003        ment for sendmail).  Similar to _\bM_\bH, except that it adds three subdirectories of
3004        the mailbox: _\bt_\bm_\bp, _\bn_\be_\bw and _\bc_\bu_\br.  Filenames for the messages are chosen in such a
3005        way they are unique, even when two programs are writing the mailbox over NFS,
3006        which means that no file locking is needed.
3007
3008        _\b4_\b._\b9  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bS_\bh_\bo_\br_\bt_\bc_\bu_\bt_\bs
3009
3010        There are a number of built in shortcuts which refer to specific mailboxes.
3011        These shortcuts can be used anywhere you are prompted for a file or mailbox
3012        path.
3013
3014           +\bo ! -- refers to your _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.310  , page 163) (incoming)
3015             mailbox
3016
3017           +\bo > -- refers to your _\b$_\bm_\bb_\bo_\bx (section 7.4.131  , page 121) file
3018
3019           +\bo < -- refers to your _\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.243  , page 147) file
3020
3021           +\bo ^ -- refers to the current mailbox
3022
3023           +\bo - or !! -- refers to the file you've last visited
3024
3025           +\bo ~ -- refers to your home directory
3026
3027           +\bo = or + -- refers to your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) directory
3028
3029           +\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
3030             determined by the address of the alias
3031
3032        _\b4_\b._\b1_\b0  _\bH_\ba_\bn_\bd_\bl_\bi_\bn_\bg _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
3033
3034        Mutt-ng has a few configuration options that make dealing with large amounts of
3035
3036        The Mutt Next Generation E-Mail Client                                       61
3037
3038        mail easier.  The first thing you must do is to let Mutt know what addresses
3039        you consider to be mailing lists (technically this does not have to be a mail-
3040        ing list, but that is what it is most often used for), and what lists you are
3041        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
3042        (section 3.13  , page 36) commands in your muttrc.
3043
3044        Now that Mutt-ng knows what your mailing lists are, it can do several things,
3045        the first of which is the ability to show the name of a list through which you
3046        received a message (i.e., of a subscribed list) in the _\bi_\bn_\bd_\be_\bx menu display.
3047        This is useful to distinguish between personal and list mail in the same mail-
3048        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
3049        ``%L'' will return the string ``To <list>'' when ``list'' appears in the ``To''
3050        field, and ``Cc <list>'' when it appears in the ``Cc'' field (otherwise it
3051        returns the name of the author).
3052
3053        Often times the ``To'' and ``Cc'' fields in mailing list messages tend to get
3054        quite large. Most people do not bother to remove the author of the message they
3055        are reply to from the list, resulting in two or more copies being sent to that
3056        person.  The ``list-reply'' function, which by default is bound to ``L'' in the
3057        _\bi_\bn_\bd_\be_\bx menu and _\bp_\ba_\bg_\be_\br, helps reduce the clutter by only replying to the known
3058        mailing list addresses instead of all recipients (except as specified by Mail-
3059        Followup-To, see below).
3060
3061        Mutt-ng also supports the Mail-Followup-To header.  When you send a message to
3062        a list of recipients which includes one or several subscribed mailing lists,
3063        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
3064        generate a Mail-Followup-To header which contains all the recipients to whom
3065        you send this message, but not your address. This indicates that group-replies
3066        or list-replies (also known as ``followups'') to this message should only be
3067        sent to the original recipients of the message, and not separately to you -
3068        you'll receive your copy through one of the mailing lists you are subscribed
3069        to.
3070
3071        Conversely, when group-replying or list-replying to a message which has a Mail-
3072        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
3073        (section 7.4.94  , page 110) configuration variable is set.  Using list-reply
3074        will in this case also make sure that the reply goes to the mailing list, even
3075        if it's not specified in the list of recipients in the Mail-Followup-To.
3076
3077        Note that, when header editing is enabled, you can create a Mail-Followup-To
3078        header manually.  Mutt-ng will only auto-generate this header if it doesn't
3079        exist when you send the message.
3080
3081        The other method some mailing list admins use is to generate a ``Reply-To''
3082        field which points back to the mailing list address rather than the author of
3083        the message.  This can create problems when trying to reply directly to the
3084        author in private, since most mail clients will automatically reply to the
3085        address given in the ``Reply-To'' field.  Mutt-ng uses the _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section
3086        7.4.246  , page 148) variable to help decide which address to use.  If set to
3087        _\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
3088        use the address given in the ``Reply-To'' field, or reply directly to the
3089        address given in the ``From'' field.  When set to _\by_\be_\bs, the ``Reply-To'' field
3090        will be used when present.
3091
3092        The Mutt Next Generation E-Mail Client                                       62
3093
3094        The ``X-Label:'' header field can be used to further identify mailing lists or
3095        list subject matter (or just to annotate messages individually).  The
3096        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115) variable's ``%y'' and ``%Y''
3097        escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's
3098        pattern-matcher can match regular expressions to ``X-Label:'' fields with the
3099        ``~y'' selector.  ``X-Label:'' is not a standard message header field, but it
3100        can easily be inserted by procmail and other mail filtering agents.
3101
3102        Lastly, Mutt-ng has the ability to _\bs_\bo_\br_\bt (section 7.4.304  , page 161) the mail-
3103        box into _\bt_\bh_\br_\be_\ba_\bd_\bs (section 2.5.3  , page 11).  A thread is a group of messages
3104        which all relate to the same subject.  This is usually organized into a tree-
3105        like structure where a message and all of its replies are represented graphi-
3106        cally.  If you've ever used a threaded news client, this is the same concept.
3107        It makes dealing with large volume mailing lists easier because you can easily
3108        delete uninteresting threads and quickly find topics of value.
3109
3110        _\b4_\b._\b1_\b1  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3111
3112        Mutt-ng has the ability to dynamically restructure threads that are broken
3113        either by misconfigured software or bad behavior from some correspondents. This
3114        allows to clean your mailboxes formats) from these annoyances which make it
3115        hard to follow a discussion.
3116
3117        _\b4_\b._\b1_\b1_\b._\b1  _\bL_\bi_\bn_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3118
3119        Some mailers tend to "forget" to correctly set the "In-Reply-To:" and "Refer-
3120        ences:" headers when replying to a message. This results in broken discussions
3121        because Mutt-ng has not enough information to guess the correct threading.  You
3122        can fix this by tagging the reply, then moving to the parent message and using
3123        the ``link-threads'' function (bound to & by default). The reply will then be
3124        connected to this "parent" message.
3125
3126        You can also connect multiple children at once, tagging them and using the tag-
3127        prefix command (';') or the auto_tag option.
3128
3129        _\b4_\b._\b1_\b1_\b._\b2  _\bB_\br_\be_\ba_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3130
3131        On mailing lists, some people are in the bad habit of starting a new discussion
3132        by hitting "reply" to any message from the list and changing the subject to a
3133        totally unrelated one.  You can fix such threads by using the ``break-thread''
3134        function (bound by default to #), which will turn the subthread starting from
3135        the current message into a whole different thread.
3136
3137        _\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
3138
3139        RFC1894 defines a set of MIME content types for relaying information about the
3140        status of electronic mail messages.  These can be thought of as ``return
3141        receipts.''
3142
3143        Users can make use of it in one of the following two ways:
3144
3145        The Mutt Next Generation E-Mail Client                                       63
3146
3147           +\bo Berkeley sendmail 8.8.x currently has some command line options in which
3148             the mail client can make requests as to what type of status messages
3149             should be returned.
3150
3151           +\bo The SMTP support via libESMTP supports it, too.
3152
3153        To support this, there are two variables:
3154
3155           +\bo _\b$_\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by (section 7.4.56  , page 101) is used to request receipts for
3156             different results (such as failed message, message delivered, etc.).
3157
3158           +\bo _\b$_\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn (section 7.4.57  , page 102) requests how much of your message
3159             should be returned with the receipt (headers or full message).
3160
3161        Please see the reference chapter for possible values.
3162
3163        _\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)
3164
3165        If Mutt-ng was compiled with POP3 support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3166        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
3167        remote POP3 server and fetch mail for local browsing.
3168
3169        You can access the remote POP3 mailbox by selecting the folder
3170        pop://popserver/.
3171
3172        You can select an alternative port by specifying it with the server, i.e.:
3173        pop://popserver:port/.
3174
3175        You can also specify different username for each folder, i.e.: pop://user-
3176        name@popserver[:port]/.
3177
3178        Polling for new mail is more expensive over POP3 than locally. For this reason
3179        the frequency at which Mutt-ng will check for mail remotely can be controlled
3180        by the _\b$_\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.221  , page 142) variable, which defaults
3181        to every 60 seconds.
3182
3183        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3184        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to POP3 servers can be encrypted. This natu-
3185        rally requires that the server supports SSL encrypted connections. To access a
3186        folder with POP3/SSL, you should use pops: prefix, ie: pops://[user-
3187        name@]popserver[:port]/.
3188
3189        Another way to access your POP3 mail is the _\bf_\be_\bt_\bc_\bh_\b-_\bm_\ba_\bi_\bl function (default: G).
3190        It allows to connect to _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.219  , page 142), fetch all your
3191        new mail and place it in the local _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.310  , page 163).
3192        After this point, Mutt-ng runs exactly as if the mail had always been local.
3193
3194        N\bNo\bot\bte\be:\b: If you only need to fetch all messages to local mailbox you should con-
3195        sider using a specialized program, such as fetchmail
3196
3197        The Mutt Next Generation E-Mail Client                                       64
3198
3199        _\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)
3200
3201        If Mutt-ng was compiled with IMAP support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3202        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
3203        remote IMAP server.
3204
3205        You can access the remote inbox by selecting the folder
3206        imap://imapserver/INBOX, where imapserver is the name of the IMAP server and
3207        INBOX is the special name for your spool mailbox on the IMAP server. If you
3208        want to access another mail folder at the IMAP server, you should use
3209        imap://imapserver/path/to/folder where path/to/folder is the path of the folder
3210        you want to access.
3211
3212        You can select an alternative port by specifying it with the server, i.e.:
3213        imap://imapserver:port/INBOX.
3214
3215        You can also specify different username for each folder, i.e.: imap://user-
3216        name@imapserver[:port]/INBOX.
3217
3218        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3219        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to IMAP servers can be encrypted. This natu-
3220        rally requires that the server supports SSL encrypted connections. To access a
3221        folder with IMAP/SSL, you should use imaps://[user-
3222        name@]imapserver[:port]/path/to/folder as your folder path.
3223
3224        Pine-compatible notation is also supported, i.e.  {[user-
3225        name@]imapserver[:port][/ssl]}path/to/folder
3226
3227        Note that not all servers use / as the hierarchy separator.  Mutt-ng should
3228        correctly notice which separator is being used by the server and convert paths
3229        accordingly.
3230
3231        When browsing folders on an IMAP server, you can toggle whether to look at only
3232        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
3233        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)
3234        variable.
3235
3236        Polling for new mail on an IMAP server can cause noticeable delays. So, you'll
3237        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
3238        _\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.334  , page 170) variables.
3239
3240        Note that if you are using mbox as the mail store on UW servers prior to
3241        v12.250, the server has been reported to disconnect a client if another client
3242        selects the same folder.
3243
3244        _\b4_\b._\b1_\b4_\b._\b1  _\bT_\bh_\be _\bF_\bo_\bl_\bd_\be_\br _\bB_\br_\bo_\bw_\bs_\be_\br
3245
3246        As of version 1.2, mutt supports browsing mailboxes on an IMAP server. This is
3247        mostly the same as the local file browser, with the following differences:
3248
3249           +\bo Instead of file permissions, mutt displays the string "IMAP", possibly
3250             followed by the symbol "+", indicating that the entry contains both mes-
3251             sages and subfolders. On Cyrus-like servers folders will often contain
3252             both messages and subfolders.
3253
3254        The Mutt Next Generation E-Mail Client                                       65
3255
3256           +\bo For the case where an entry can contain both messages and subfolders, the
3257             selection key (bound to enter by default) will choose to descend into the
3258             subfolder view. If you wish to view the messages in that folder, you must
3259             use view-file instead (bound to space by default).
3260
3261           +\bo You can create, delete and rename mailboxes with the create-mailbox,
3262             delete-mailbox, and rename-mailbox commands (default bindings: C, d and r,
3263             respectively). You may also subscribe and unsubscribe to mailboxes (nor-
3264             mally these are bound to s and u, respectively).
3265
3266        _\b4_\b._\b1_\b4_\b._\b2  _\bA_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bi_\bo_\bn
3267
3268        Mutt-ng supports four authentication methods with IMAP servers: SASL, GSSAPI,
3269        CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add NTLM authentica-
3270        tion for you poor exchange users out there, but it has yet to be integrated
3271        into the main tree). There is also support for the pseudo-protocol ANONYMOUS,
3272        which allows you to log in to a public IMAP server without having an account.
3273        To use ANONYMOUS, simply make your username blank or "anonymous".
3274
3275        SASL is a special super-authenticator, which selects among several protocols
3276        (including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure method
3277        available on your host and the server. Using some of these methods (including
3278        DIGEST-MD5 and possibly GSSAPI), your entire session will be encrypted and
3279        invisible to those teeming network snoops. It is the best option if you have
3280        it. To use it, you must have the Cyrus SASL library installed on your system
3281        and compile mutt with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\ba_\bs_\bl flag.
3282
3283        Mutt-ng will try whichever methods are compiled in and available on the server,
3284        in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.
3285
3286        There are a few variables which control authentication:
3287
3288           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.111  , page 114) - controls the username under
3289             which you request authentication on the IMAP server, for all authentica-
3290             tors. This is overridden by an explicit username in the mailbox path (i.e.
3291             by using a mailbox name of the form {user@host}).
3292
3293           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.106  , page 113) - a password which you may pre-
3294             set, used by all authentication methods where a password is needed.
3295
3296           +\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
3297             of IMAP authentication methods to try, in the order you wish to try them.
3298             If specified, this overrides mutt's default (attempt everything, in the
3299             order listed above).
3300
3301        _\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)
3302
3303        If compiled with ``--enable-nntp'' option, Mutt-ng can read news from a
3304        newsserver via NNTP.  You can open a newsgroup with the ``change-newsgroup''
3305        function from the index/pager which is by default bound to i.
3306
3307        The Default newsserver can be obtained from the $NNTPSERVER environment
3308
3309        The Mutt Next Generation E-Mail Client                                       66
3310
3311        variable. Like other news readers, info about subscribed newsgroups is saved in
3312        a file as specified by the _\b$_\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc (section 7.4.169  , page 130) variable.
3313        Article headers are cached and can be loaded from a file when a newsgroup is
3314        entered instead loading from newsserver; currently, this caching mechanism
3315        still is different from the header caching for maildir/IMAP.
3316
3317        _\b4_\b._\b1_\b5_\b._\b1  _\bA_\bg_\ba_\bi_\bn_\b: _\bS_\bc_\bo_\br_\bi_\bn_\bg
3318
3319        Especially for Usenet, people often ask for advanced filtering and scoring
3320        functionality. Of course, mutt-ng has scoring and allows a killfile, too. How
3321        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
3322        41).
3323
3324        What has not been discusses in detail is mutt-ng's built-in realname filter.
3325        For may newsreaders including those for ``advanced users'' like _\bs_\bl_\br_\bn or _\bt_\bi_\bn,
3326        there are frequent request for such functionality. The solutions offered often
3327        are complicated regular expressions.
3328
3329        In mutt-ng this is as easy as
3330
3331             score ~* =42
3332
3333        This tells mutt-ng to apply a score of 42 to all messages whose sender speci-
3334        fied a valid realname and a valid email address. Using
3335
3336             score !~* =42
3337
3338        on the contrary applies a score of 42 to all messages _\bn_\bo_\bt matching those crite-
3339        ria which are very strict:
3340
3341           +\bo Email addresses must be valid according to RFC 2822, see <ftp://ftp.rfc-
3342             editor.org/in-notes/rfc2822.txt>
3343
3344           +\bo the name must consist of at least 2 fields whereby a field must not end in
3345             a dot. This means that ``Joe User'' and ``Joe A.  User'' are valid while
3346             ``J. User'' and ``J. A. User'' aren't.
3347
3348           +\bo it's assumed that users are interested in reading their own mail and mail
3349             from people who they have defined an alias for so that those 2 groups of
3350             messages are excluded from the strict rules.
3351
3352        _\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)
3353
3354        Mutt-ng can be built using a library called ``libESMTP'' which provides SMTP
3355
3356        The Mutt Next Generation E-Mail Client                                       67
3357
3358        functionality. When configure was called with --with-libesmtp or the output
3359        muttng -v contains +USE_LIBESMTP, this will be or is the case already. The SMTP
3360        support includes support for Delivery Status Notification (see _\bD_\be_\bl_\bi_\bv_\be_\br_\by _\bS_\bt_\ba_\bt_\bu_\bs
3361        _\bN_\bo_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn (section 4.12  , page 62) section) as well as handling the 8BIT-
3362        MIME flag controlled via _\b$_\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be (section 7.4.341  , page 172).
3363
3364        To enable sending mail directly via SMTP without an MTA such as Postfix or
3365        SSMTP and the like, simply set the _\b$_\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.299  , page 160)
3366        variable pointing to your SMTP server.
3367
3368        Authentication mechanisms are available via the _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section 7.4.303  ,
3369        page 161) and _\b$_\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.300  , page 160) variables.
3370
3371        Transport Encryption via the StartTLS command is also available. For this to
3372        work, first of all Mutt-ng must be built with SSL or GNUTLS.  Secondly, the
3373        _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs (section 7.4.302  , page 161) variable must be either set to
3374        ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server
3375        supports it: for the second case, the connection will fail if it doesn't while
3376        switching back to unencrypted communication for the first one.
3377
3378        Some mail providers require user's to set a particular envelope sender, i.e.
3379        they allow for only one value which may not be what the user wants to send as
3380        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.298  ,
3381        page 160) may be used to set the envelope different from the From: header.
3382
3383        _\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)
3384
3385        If you happen to have accounts on multiple IMAP and/or POP servers, you may
3386        find managing all the authentication settings inconvenient and error-prone.
3387        The account-hook command may help. This hook works like folder-hook but is
3388        invoked whenever you access a remote mailbox (including inside the folder
3389        browser), not just when you open the mailbox.
3390
3391        Some examples:
3392
3393             account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
3394             account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
3395             account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
3396
3397        _\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)
3398
3399        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
3400        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
3401        start a WWW browser on one of them.  This functionality is provided by the
3402        external urlview program which can be retrieved at ftp://ftp.mutt.org/mutt/con-
3403        trib/ and the configuration commands:
3404
3405             macro index \cb |urlview\n
3406             macro pager \cb |urlview\n
3407
3408        The Mutt Next Generation E-Mail Client                                       68
3409
3410        _\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)
3411
3412        If Mutt-ng was compiled with compressed folders support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\b-
3413        _\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
3414        an arbitrary format, provided that the user has a script to convert from/to
3415        this format to one of the accepted.
3416
3417        The most common use is to open compressed archived folders e.g. with gzip.
3418
3419        In addition, the user can provide a script that gets a folder in an accepted
3420        format and appends its context to the folder in the user-defined format, which
3421        may be faster than converting the entire folder to the accepted format, append-
3422        ing to it and converting back to the user-defined format.
3423
3424        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-
3425        _\bh_\bo_\bo_\bk (section 4.19.2  , page 69) and _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 69))
3426        which define commands to uncompress and compress a folder and to append mes-
3427        sages to an existing compressed folder respectively.
3428
3429        For example:
3430
3431             open-hook \\.gz$ "gzip -cd %f > %t"
3432             close-hook \\.gz$ "gzip -c %t > %f"
3433             append-hook \\.gz$ "gzip -c %t >> %f"
3434
3435        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-
3436        tion 4.19.3  , page 69), the folder will be open and closed again each time you
3437        will add to it. If you omit _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 69) (or give
3438        empty command) , the folder will be open in the  mode. If you specify _\ba_\bp_\bp_\be_\bn_\bd_\b-
3439        _\bh_\bo_\bo_\bk (section 4.19.3  , page 69) though you'll be able to append to the folder.
3440
3441        Note that Mutt-ng will only try to use hooks if the file is not in one of the
3442        accepted formats. In particular, if the file is empty, mutt supposes it is not
3443        compressed. This is important because it allows the use of programs that do not
3444        have well defined extensions. Just use '.' as a regexp. But this may be sur-
3445        prising if your compressing script produces empty files. In this situation,
3446        unset _\b$_\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by (section 7.4.253  , page 149), so that the compressed file
3447        will be removed if you delete all of the messages.
3448
3449        _\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
3450
3451        Usage: open-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3452
3453        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd is the command that can be used for opening the folders whose names
3454        match _\br_\be_\bg_\be_\bx_\bp.
3455
3456        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the printf-like format string, and it should accept two
3457        parameters: %f, which is replaced with the (compressed) folder name, and %t
3458        which is replaced with the name of the temporary folder to which to write.
3459
3460        %f and %t can be repeated any number of times in the command string, and all of
3461        the entries are replaced with the appropriate folder name. In addition, %% is
3462
3463        The Mutt Next Generation E-Mail Client                                       69
3464
3465        replaced by %, as in printf, and any other %anything is left as is.
3466
3467        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
3468        return non-zero exit status if it fails, so mutt knows something's wrong.
3469
3470        Example:
3471
3472             open-hook \\.gz$ "gzip -cd %f > %t"
3473
3474        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type.
3475
3476        _\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
3477
3478        Usage: close-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3479
3480        This is used to close the folder that was open with the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3481        4.19.1  , page 68) command after some changes were made to it.
3482
3483        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the command that can be used for closing the folders
3484        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
3485        4.19.1  , page 68) command. Temporary folder in this case is the folder previ-
3486        ously produced by the <_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 68) command.
3487
3488        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
3489        non-zero exit status if it fails, so mutt knows something's wrong.
3490
3491        Example:
3492
3493             close-hook \\.gz$ "gzip -c %t > %f"
3494
3495        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type, and the
3496        file can only be open in the readonly mode.
3497
3498        _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 69) is not called when you exit from the
3499        folder if the folder was not changed.
3500
3501        _\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
3502
3503        Usage: append-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3504
3505        This command is used for saving to an existing compressed folder.  The _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3506        is the command that can be used for appending to the folders whose names match
3507        _\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)
3508        command.  The temporary folder in this case contains the messages that are
3509        being appended.
3510
3511        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
3512        non-zero exit status if it fails, so mutt knows something's wrong.
3513
3514        Example:
3515
3516        The Mutt Next Generation E-Mail Client                                       70
3517
3518             append-hook \\.gz$ "gzip -c %t >> %f"
3519
3520        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,
3521        which saves time, but this means that we can not find out what the folder type
3522        is. Thus the default (_\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.132  , page 121)) type is always
3523        supposed (i.e.  this is the format used for the temporary folder).
3524
3525        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  ,
3526        page 69) 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-
3527        _\bh_\bo_\bo_\bk (section 4.19.3  , page 69) is only for appending to existing folders.
3528
3529        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type. In this
3530        case, the folder will be open and closed again (using _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3531        4.19.1  , page 68) and _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 69)respectively) each
3532        time you will add to it.
3533
3534        _\b4_\b._\b1_\b9_\b._\b4  _\bE_\bn_\bc_\br_\by_\bp_\bt_\be_\bd _\bf_\bo_\bl_\bd_\be_\br_\bs
3535
3536        The compressed folders support can also be used to handle encrypted folders. If
3537        you want to encrypt a folder with PGP, you may want to use the following hooks:
3538
3539             open-hook  \\.pgp$ "pgp -f < %f > %t"
3540             close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
3541
3542        Please note, that PGP does not support appending to an encrypted folder, so
3543        there is no append-hook defined.
3544
3545        N\bNo\bot\bte\be:\b: the folder is temporary stored decrypted in the /tmp directory, where it
3546        can be read by your system administrator. So think about the security aspects
3547        of this.
3548
3549        _\b5_\b.  _\bM_\bu_\bt_\bt_\b-_\bn_\bg_\b'_\bs _\bM_\bI_\bM_\bE _\bS_\bu_\bp_\bp_\bo_\br_\bt
3550
3551        Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME
3552        MUA.  Every effort has been made to provide the functionality that the discern-
3553        ing MIME user requires, and the conformance to the standards wherever possible.
3554        When configuring Mutt-ng for MIME, there are two extra types of configuration
3555        files which Mutt-ng uses.  One is the mime.types file, which contains the map-
3556        ping of file extensions to IANA MIME types.  The other is the mailcap file,
3557        which specifies the external commands to use for handling specific MIME types.
3558
3559        _\b5_\b._\b1  _\bU_\bs_\bi_\bn_\bg _\bM_\bI_\bM_\bE _\bi_\bn _\bM_\bu_\bt_\bt
3560
3561        There are three areas/menus in Mutt-ng which deal with MIME, they are the pager
3562        (while viewing a message), the attachment menu and the compose menu.
3563
3564        The Mutt Next Generation E-Mail Client                                       71
3565
3566        _\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
3567
3568        When you select a message from the index and view it in the pager, Mutt decodes
3569        the message to a text representation.  Mutt-ng internally supports a number of
3570        MIME types, including text/plain, text/enriched, message/rfc822, and mes-
3571        sage/news.  In addition, the export controlled version of Mutt-ng recognizes a
3572        variety of PGP MIME types, including PGP/MIME and application/pgp.
3573
3574        Mutt-ng will denote attachments with a couple lines describing them.  These
3575        lines are of the form:
3576
3577             [-- Attachment #1: Description --]
3578             [-- Type: text/plain, Encoding: 7bit, Size: 10000 --]
3579
3580        Where the Description is the description or filename given for the attachment,
3581        and the Encoding is one of 7bit/8bit/quoted-printable/base64/binary.
3582
3583        If Mutt-ng cannot deal with a MIME type, it will display a message like:
3584
3585             [-- image/gif is unsupported (use 'v' to view this part) --]
3586
3587        _\b5_\b._\b1_\b._\b2  _\bT_\bh_\be _\bA_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bM_\be_\bn_\bu
3588
3589        The default binding for view-attachments is `v', which displays the attachment
3590        menu for a message.  The attachment menu displays a list of the attachments in
3591        a message.  From the attachment menu, you can save, print, pipe, delete, and
3592        view attachments.  You can apply these operations to a group of attachments at
3593        once, by tagging the attachments and by using the ``tag-prefix'' operator.  You
3594        can also reply to the current message from this menu, and only the current
3595        attachment (or the attachments tagged) will be quoted in your reply.  You can
3596        view attachments as text, or view them using the mailcap viewer definition.
3597
3598        Finally, you can apply the usual message-related functions (like _\br_\be_\bs_\be_\bn_\bd_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be
3599        (section 2.5.4  , page 13), and the reply and forward functions) to attachments
3600        of type message/rfc822.
3601
3602        See the help on the attachment menu for more information.
3603
3604        _\b5_\b._\b1_\b._\b3  _\bT_\bh_\be _\bC_\bo_\bm_\bp_\bo_\bs_\be _\bM_\be_\bn_\bu
3605
3606        The compose menu is the menu you see before you send a message.  It allows you
3607        to edit the recipient list, the subject, and other aspects of your message.  It
3608        also contains a list of the attachments of your message, including the main
3609        body.  From this menu, you can print, copy, filter, pipe, edit, compose,
3610        review, and rename an attachment or a list of tagged attachments.  You can also
3611        modifying the attachment information, notably the type, encoding and descrip-
3612        tion.
3613
3614        Attachments appear as follows:
3615
3616             -   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 <no description>
3617                 2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz <no description>
3618
3619        The Mutt Next Generation E-Mail Client                                       72
3620
3621        The '-' denotes that Mutt-ng will delete the file after sending (or postponing,
3622        or canceling) the message.  It can be toggled with the toggle-unlink command
3623        (default: u).  The next field is the MIME content-type, and can be changed with
3624        the edit-type command (default: ^T).  The next field is the encoding for the
3625        attachment, which allows a binary message to be encoded for transmission on
3626        7bit links.  It can be changed with the edit-encoding command (default: ^E).
3627        The next field is the size of the attachment, rounded to kilobytes or
3628        megabytes.  The next field is the filename, which can be changed with the
3629        rename-file command (default: R).  The final field is the description of the
3630        attachment, and can be changed with the edit-description command (default: d).
3631
3632        _\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
3633
3634        When you add an attachment to your mail message, Mutt-ng searches your personal
3635        mime.types file at ${HOME}/.mime.types, and then the system mime.types file at
3636        /usr/local/share/mutt/mime.types or /etc/mime.types
3637
3638        The mime.types file consist of lines containing a MIME type and a space sepa-
3639        rated list of extensions.  For example:
3640
3641             application/postscript          ps eps
3642             application/pgp                 pgp
3643             audio/x-aiff                    aif aifc aiff
3644
3645        A sample mime.types file comes with the Mutt-ng distribution, and should con-
3646        tain most of the MIME types you are likely to use.
3647
3648        If Mutt-ng can not determine the mime type by the extension of the file you
3649        attach, it will look at the file.  If the file is free of binary information,
3650        Mutt-ng will assume that the file is plain text, and mark it as text/plain.  If
3651        the file contains binary information, then Mutt-ng will mark it as applica-
3652        tion/octet-stream.  You can change the MIME type that Mutt-ng assigns to an
3653        attachment by using the edit-type command from the compose menu (default: ^T).
3654        The MIME type is actually a major mime type followed by the sub-type, separated
3655        by a '/'. 6 major types: application, text, image, video, audio, and model have
3656        been approved after various internet discussions. Mutt-ng recognises all of
3657        these if the appropriate entry is found in the mime.types file. It also recog-
3658        nises other major mime types, such as the chemical type that is widely used in
3659        the molecular modelling community to pass molecular data in various forms to
3660        various molecular viewers. Non-recognised mime types should only be used if the
3661        recipient of the message is likely to be expecting such attachments.
3662
3663        _\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
3664
3665        Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix specific
3666        format specified in Appendix A of RFC 1524.  This file format is commonly
3667        referred to as the mailcap format.  Many MIME compliant programs utilize the
3668        mailcap format, allowing you to specify handling for all MIME types in one
3669        place for all programs.  Programs known to use this format include Netscape,
3670
3671        The Mutt Next Generation E-Mail Client                                       73
3672
3673        XMosaic, lynx and metamail.
3674
3675        In order to handle various MIME types that Mutt-ng can not handle internally,
3676        Mutt-ng parses a series of external configuration files to find an external
3677        handler.  The default search string for these files is a colon delimited list
3678        set to
3679
3680             ${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
3681
3682        where $HOME is your home directory.
3683
3684        In particular, the metamail distribution will install a mailcap file, usually
3685        as /usr/local/etc/mailcap, which contains some baseline entries.
3686
3687        _\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
3688
3689        A mailcap file consists of a series of lines which are comments, blank, or def-
3690        initions.
3691
3692        A comment line consists of a # character followed by anything you want.
3693
3694        A blank line is blank.
3695
3696        A definition line consists of a content type, a view command, and any number of
3697        optional fields.  Each field of a definition line is divided by a semicolon ';'
3698        character.
3699
3700        The content type is specified in the MIME standard type/subtype method.  For
3701        example, text/plain, text/html, image/gif, etc.  In addition, the mailcap for-
3702        mat includes two formats for wildcards, one using the special '*' subtype, the
3703        other is the implicit wild, where you only include the major type.  For exam-
3704        ple, image/*, or video, will match all image types and video types, respec-
3705        tively.
3706
3707        The view command is a Unix command for viewing the type specified. There are
3708        two different types of commands supported. The default is to send the body of
3709        the MIME message to the command on stdin. You can change this behavior by using
3710        %s as a parameter to your view command.  This will cause Mutt-ng to save the
3711        body of the MIME message to a temporary file, and then call the view command
3712        with the %s replaced by the name of the temporary file. In both cases, Mutt-ng
3713        will turn over the terminal to the view program until the program quits, at
3714        which time Mutt will remove the temporary file if it exists.
3715
3716        So, in the simplest form, you can send a text/plain message to the external
3717        pager more on stdin:
3718
3719             text/plain; more
3720
3721        Or, you could send the message as a file:
3722
3723             text/plain; more %s
3724
3725        The Mutt Next Generation E-Mail Client                                       74
3726
3727        Perhaps you would like to use lynx to interactively view a text/html message:
3728
3729             text/html; lynx %s
3730
3731        In this case, lynx does not support viewing a file from stdin, so you must use
3732        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
3733        _\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
3734        _\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
3735        _\bv_\bi_\be_\bw _\bt_\bh_\be _\bo_\bb_\bj_\be_\bc_\bt_\b.
3736
3737        On the other hand, maybe you don't want to use lynx interactively, you just
3738        want to have it convert the text/html to text/plain, then you can use:
3739
3740             text/html; lynx -dump %s | more
3741
3742        Perhaps you wish to use lynx to view text/html files, and a pager on all other
3743        text formats, then you would use the following:
3744
3745             text/html; lynx %s
3746             text/*; more
3747
3748        This is the simplest form of a mailcap file.
3749
3750        _\b5_\b._\b3_\b._\b2  _\bS_\be_\bc_\bu_\br_\be _\bu_\bs_\be _\bo_\bf _\bm_\ba_\bi_\bl_\bc_\ba_\bp
3751
3752        The interpretation of shell meta-characters embedded in MIME parameters can
3753        lead to security problems in general.  Mutt-ng tries to quote parameters in
3754        expansion of %s syntaxes properly, and avoids risky characters by substituting
3755        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.
3756
3757        Although mutt's procedures to invoke programs with mailcap seem to be safe,
3758        there are other applications parsing mailcap, maybe taking less care of it.
3759        Therefore you should pay attention to the following rules:
3760
3761        _\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
3762        double quotes.  Mutt-ng does this for you, the right way, as should any other
3763        program which interprets mailcap.  Don't put them into backtick expansions.  Be
3764        highly careful with eval statements, and avoid them if possible at all.  Trying
3765        to fix broken behaviour with quotes introduces new leaks - there is no alterna-
3766        tive to correct quoting in the first place.
3767
3768        If you have to use the %-expandos' values in context where you need quoting or
3769        backtick expansions, put that value into a shell variable and reference the
3770        shell variable where necessary, as in the following example (using $charset
3771        inside the backtick expansion is safe, since it is not itself subject to any
3772        further expansion):
3773
3774             text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \
3775                     && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1
3776
3777        The Mutt Next Generation E-Mail Client                                       75
3778
3779        _\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
3780
3781        _\b5_\b._\b3_\b._\b3_\b._\b1  _\bO_\bp_\bt_\bi_\bo_\bn_\ba_\bl _\bF_\bi_\be_\bl_\bd_\bs
3782
3783        In addition to the required content-type and view command fields, you can add
3784        semi-colon ';' separated fields to set flags and other options.  Mutt-ng recog-
3785        nizes the following optional fields:
3786
3787              copiousoutput
3788                    This flag tells Mutt-ng that the command passes possibly large
3789                    amounts of text on stdout.  This causes Mutt-ng to invoke a pager
3790                    (either the internal pager or the external pager defined by the
3791                    pager variable) on the output of the view command.  Without this
3792                    flag, Mutt-ng assumes that the command is interactive.  One could
3793                    use this to replace the pipe to more in the lynx -dump example in
3794                    the Basic section:
3795
3796                         text/html; lynx -dump %s ; copiousoutput
3797
3798                    This will cause lynx to format the text/html output as text/plain
3799                    and Mutt-ng will use your standard pager to display the results.
3800
3801              needsterminal
3802                    Mutt-ng uses this flag when viewing attachments with _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (sec-
3803                    tion 5.4  , page 78), in order to decide whether it should honor
3804                    the setting of the _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.347  , page 173) variable
3805                    or not.  When an attachment is viewed using an interactive program,
3806                    and the corresponding mailcap entry has a _\bn_\be_\be_\bd_\bs_\bt_\be_\br_\bm_\bi_\bn_\ba_\bl flag, Mutt-
3807                    ng will use _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.347  , page 173) and the exit
3808                    status of the program to decide if it will ask you to press a key
3809                    after the external program has exited.  In all other situations it
3810                    will not prompt you for a key.
3811
3812              compose=<command>
3813                    This flag specifies the command to use to create a new attachment
3814                    of a specific MIME type.  Mutt-ng supports this from the compose
3815                    menu.
3816
3817              composetyped=<command>
3818                    This flag specifies the command to use to create a new attachment
3819                    of a specific MIME type.  This command differs from the compose
3820                    command in that mutt will expect standard MIME headers on the data.
3821                    This can be used to specify parameters, filename, description, etc.
3822                    for a new attachment.   Mutt-ng supports this from the compose
3823                    menu.
3824
3825              print=<command>
3826                    This flag specifies the command to use to print a specific MIME
3827                    type.  Mutt-ng supports this from the attachment and compose menus.
3828
3829              edit=<command>
3830                    This flag specifies the command to use to edit a specific MIME
3831                    type.  Mutt-ng supports this from the compose menu, and also uses
3832
3833        The Mutt Next Generation E-Mail Client                                       76
3834
3835                    it to compose new attachments.  Mutt-ng will default to the defined
3836                    editor for text attachments.
3837
3838              nametemplate=<template>
3839                    This field specifies the format for the file denoted by %s in the
3840                    command fields.  Certain programs will require a certain file
3841                    extension, for instance, to correctly view a file.  For instance,
3842                    lynx will only interpret a file as text/html if the file ends in
3843                    .html.  So, you would specify lynx as a text/html viewer with a
3844                    line in the mailcap file like:
3845
3846                         text/html; lynx %s; nametemplate=%s.html
3847
3848              test=<command>
3849                    This field specifies a command to run to test whether this mailcap
3850                    entry should be used.  The command is defined with the command
3851                    expansion rules defined in the next section.  If the command
3852                    returns 0, then the test passed, and Mutt-ng uses this entry.  If
3853                    the command returns non-zero, then the test failed, and Mutt-ng
3854                    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
3855                    _\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:
3856
3857                         text/html; netscape -remote 'openURL(%s)' ; test=RunningX
3858                         text/html; lynx %s
3859
3860                    In this example, Mutt-ng will run the program RunningX which will
3861                    return 0 if the X Window manager is running, and non-zero if it
3862                    isn't.  If RunningX returns 0, then Mutt-ng will call netscape to
3863                    display the text/html object.  If RunningX doesn't return 0, then
3864                    Mutt-ng will go on to the next entry and use lynx to display the
3865                    text/html object.
3866
3867        _\b5_\b._\b3_\b._\b3_\b._\b2  _\bS_\be_\ba_\br_\bc_\bh _\bO_\br_\bd_\be_\br
3868
3869        When searching for an entry in the mailcap file, Mutt-ng will search for the
3870        most useful entry for its purpose.  For instance, if you are attempting to
3871        print an image/gif, and you have the following entries in your mailcap file,
3872        Mutt-ng will search for an entry with the print command:
3873
3874             image/*;        xv %s
3875             image/gif;      ; print= anytopnm %s | pnmtops | lpr; \
3876                             nametemplate=%s.gif
3877
3878        Mutt-ng will skip the image/* entry and use the image/gif entry with the print
3879        command.
3880
3881        In addition, you can use this with _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 78) to denote
3882        two commands for viewing an attachment, one to be viewed automatically, the
3883        other to be viewed interactively from the attachment menu.  In addition, you
3884        can then use the test feature to determine which viewer to use interactively
3885        depending on your environment.
3886
3887        The Mutt Next Generation E-Mail Client                                       77
3888
3889             text/html;      netscape -remote 'openURL(%s)' ; test=RunningX
3890             text/html;      lynx %s; nametemplate=%s.html
3891             text/html;      lynx -dump %s; nametemplate=%s.html; copiousoutput
3892
3893        For _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 78), Mutt-ng will choose the third entry
3894        because of the copiousoutput tag.  For interactive viewing, Mutt will run the
3895        program RunningX to determine if it should use the first entry.  If the program
3896        returns non-zero, Mutt-ng will use the second entry for interactive viewing.
3897
3898        _\b5_\b._\b3_\b._\b3_\b._\b3  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
3899
3900        The various commands defined in the mailcap files are passed to the /bin/sh
3901        shell using the system() function.  Before the command is passed to /bin/sh -c,
3902        it is parsed to expand various special parameters with information from Mutt-
3903        ng.  The keywords Mutt-ng expands are:
3904
3905              %s
3906                    As seen in the basic mailcap section, this variable is expanded to
3907                    a filename specified by the calling program.  This file contains
3908                    the body of the message to view/print/edit or where the composing
3909                    program should place the results of composition.  In addition, the
3910                    use of this keyword causes Mutt-ng to not pass the body of the mes-
3911                    sage to the view/print/edit program on stdin.
3912
3913              %t
3914                    Mutt-ng will expand %t to the text representation of the content
3915                    type of the message in the same form as the first parameter of the
3916                    mailcap definition line, ie text/html or image/gif.
3917
3918              %{<parameter>}
3919                    Mutt-ng will expand this to the value of the specified parameter
3920                    from the Content-Type: line of the mail message.  For instance, if
3921                    Your mail message contains:
3922
3923                         Content-Type: text/plain; charset=iso-8859-1
3924
3925                    then Mutt-ng will expand %{charset} to iso-8859-1.  The default
3926                    metamail mailcap file uses this feature to test the charset to
3927                    spawn an xterm using the right charset to view the message.
3928
3929              \%
3930                    This will be replaced by a %
3931
3932        Mutt-ng does not currently support the %F and %n keywords specified in RFC
3933        1524.  The main purpose of these parameters is for multipart messages, which is
3934        handled internally by Mutt-ng.
3935
3936        _\b5_\b._\b3_\b._\b4  _\bE_\bx_\ba_\bm_\bp_\bl_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be_\bs
3937
3938        This mailcap file is fairly simple and standard:
3939
3940        The Mutt Next Generation E-Mail Client                                       78
3941
3942             # I'm always running X :)
3943             video/*;        xanim %s > /dev/null
3944             image/*;        xv %s > /dev/null
3945
3946             # I'm always running netscape (if my computer had more memory, maybe)
3947             text/html;      netscape -remote 'openURL(%s)'
3948
3949        This mailcap file shows quite a number of examples:
3950
3951             # Use xanim to view all videos   Xanim produces a header on startup,
3952             # send that to /dev/null so I don't see it
3953             video/*;        xanim %s > /dev/null
3954
3955             # Send html to a running netscape by remote
3956             text/html;      netscape -remote 'openURL(%s)'; test=RunningNetscape
3957
3958             # If I'm not running netscape but I am running X, start netscape on the
3959             # object
3960             text/html;      netscape %s; test=RunningX
3961
3962             # Else use lynx to view it as text
3963             text/html;      lynx %s
3964
3965             # This version would convert the text/html to text/plain
3966             text/html;      lynx -dump %s; copiousoutput
3967
3968             # I use enscript to print text in two columns to a page
3969             text/*;         more %s; print=enscript -2Gr %s
3970
3971             # Netscape adds a flag to tell itself to view jpegs internally
3972             image/jpeg;xv %s; x-mozilla-flags=internal
3973
3974             # Use xv to view images if I'm running X
3975             # In addition, this uses the \ to extend the line and set my editor
3976             # for images
3977             image/*;xv %s; test=RunningX; \
3978                     edit=xpaint %s
3979
3980             # Convert images to text using the netpbm tools
3981             image/*;  (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
3982             pbmtoascii -1x2 ) 2>&1 ; copiousoutput
3983
3984             # Send excel spreadsheets to my NT box
3985             application/ms-excel; open.pl %s
3986
3987        _\b5_\b._\b4  _\bM_\bI_\bM_\bE _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw
3988
3989        In addition to explicitly telling Mutt-ng to view an attachment with the MIME
3990        viewer defined in the mailcap file, Mutt-ng has support for automatically
3991
3992        The Mutt Next Generation E-Mail Client                                       79
3993
3994        viewing MIME attachments while in the pager.
3995
3996        To work, you must define a viewer in the mailcap file which uses the copi-
3997        ousoutput option to denote that it is non-interactive.  Usually, you also use
3998        the entry to convert the attachment to a text representation which you can view
3999        in the pager.
4000
4001        You then use the auto_view muttrc command to list the content-types that you
4002        wish to view automatically.
4003
4004        For instance, if you set auto_view to:
4005
4006             auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz
4007
4008        Mutt-ng could use the following mailcap entries to automatically view attach-
4009        ments of these types.
4010
4011             text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
4012             image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
4013             application/x-gunzip;   gzcat; copiousoutput
4014             application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput
4015             application/postscript; ps2ascii %s; copiousoutput
4016
4017        ``unauto_view'' can be used to remove previous entries from the autoview list.
4018        This can be used with message-hook to autoview messages based on size, etc.
4019        ``unauto_view *'' will remove all previous entries.
4020
4021        _\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
4022
4023        Mutt-ng has some heuristics for determining which attachment of a multi-
4024        part/alternative type to display.  First, mutt will check the alternative_order
4025        list to determine if one of the available types is preferred.  The alterna-
4026        tive_order list consists of a number of MIME types in order, including support
4027        for implicit and explicit wildcards, for example:
4028
4029             alternative_order text/enriched text/plain text application/postscript image/*
4030
4031        Next, mutt will check if any of the types have a defined _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section
4032        5.4  , page 78), and use that.  Failing that, Mutt-ng will look for any text
4033        type.  As a last attempt, mutt will look for any type it knows how to handle.
4034
4035        To remove a MIME type from the alternative_order list, use the unalterna-
4036        tive_order command.
4037
4038        _\b5_\b._\b6  _\bM_\bI_\bM_\bE _\bL_\bo_\bo_\bk_\bu_\bp
4039
4040        Mutt-ng's mime_lookup list specifies a list of mime-types that should not be
4041
4042        The Mutt Next Generation E-Mail Client                                       80
4043
4044        treated according to their mailcap entry.  This option is designed to deal with
4045        binary types such as application/octet-stream.  When an attachment's mime-type
4046        is listed in mime_lookup, then the extension of the filename will be compared
4047        to the list of extensions in the mime.types file.  The mime-type associated
4048        with this extension will then be used to process the attachment according to
4049        the rules in the mailcap file and according to any other configuration options
4050        (such as auto_view) specified.  Common usage would be:
4051
4052             mime_lookup application/octet-stream application/X-Lotus-Manuscript
4053
4054        In addition, the unmime_lookup command may be used to disable this feature for
4055        any particular mime-type if it had been set, for example, in a global muttrc.
4056
4057        _\b6_\b.  _\bS_\be_\bc_\bu_\br_\bi_\bt_\by _\bC_\bo_\bn_\bs_\bi_\bd_\be_\br_\ba_\bt_\bi_\bo_\bn_\bs
4058
4059        First of all, mutt-ng contains no security holes included by intention but may
4060        contain unknown security holes. As a consequence, please run mutt-ng only with
4061        as few permissions as possible.
4062
4063        Please do not run mutt-ng as the super user.
4064
4065        When configuring mutt-ng, there're some points to note about secure setups.
4066
4067        In practice, mutt-ng can be easily made as vulnerable as even the most insecure
4068        mail user agents (in their default configuration) just by changing mutt-ng's
4069        configuration files: it then can execute arbitrary programs and scripts
4070        attached to messages, send out private data on its own, etc. Although this is
4071        not believed to the common type of setup, please read this chapter carefully.
4072
4073        _\b6_\b._\b1  _\bP_\ba_\bs_\bs_\bw_\bo_\br_\bd_\bs
4074
4075        Although mutt-ng can be told the various passwords for accounts, please never
4076        store passwords in configuration files. Besides the fact that the system's
4077        operator can always read them, you could forget to replace the actual password
4078        with asterisks when reporting a bug or asking for help via, for example, a
4079        mailing list so that your mail including your password could be archived by
4080        internet search engines, etc. Please never store passwords on disk.
4081
4082        _\b6_\b._\b2  _\bT_\be_\bm_\bp_\bo_\br_\ba_\br_\by _\bF_\bi_\bl_\be_\bs
4083
4084        Mutt-ng uses many temporary files for viewing messages, verifying digital sig-
4085        natures, etc. The _\b$_\bu_\bm_\ba_\bs_\bk (section 7.4.339  , page 171) variable can be used to
4086        change the default permissions of these files. Please only change it if you
4087        really know what you are doing.  Also, a different location for these files may
4088        be desired which can be changed via the _\b$_\bt_\bm_\bp_\bd_\bi_\br (section 7.4.335  , page 170)
4089        variable.
4090
4091        The Mutt Next Generation E-Mail Client                                       81
4092
4093        _\b6_\b._\b3  _\bI_\bn_\bf_\bo_\br_\bm_\ba_\bt_\bi_\bo_\bn _\bL_\be_\ba_\bk_\bs
4094
4095        _\b6_\b._\b3_\b._\b1  _\bM_\be_\bs_\bs_\ba_\bg_\be_\b-_\bI_\bD_\b: _\bh_\be_\ba_\bd_\be_\br_\bs
4096
4097        In the default configuration, mutt-ng will leak some information to the outside
4098        world when sending messages: the generation of Message-ID: headers includes a
4099        step counter which is increased (and rotated) with every message sent. If you'd
4100        like to hide this information probably telling others how many mail you sent in
4101        which time, you at least need to remove the %P expando from the default setting
4102        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
4103        that you really know how local parts of these Message-ID: headers are composed.
4104
4105        _\b6_\b._\b3_\b._\b2  _\bm_\ba_\bi_\bl_\bt_\bo_\b:_\b-_\bs_\bt_\by_\bl_\be _\bl_\bi_\bn_\bk_\bs
4106
4107        As mutt-ng be can be set up to be the mail client to handle mailto: style links
4108        in websites, there're security considerations, too. To keep the old behavior by
4109        default, mutt-ng will be strict in interpreting them which means that arbitrary
4110        header fields can be embedded in these links which could override existing
4111        header fields or attach arbitrary files. This may be problematic if the
4112        _\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
4113        doesn't want to see header fields while editing the message.
4114
4115        For example, following a link like
4116
4117             mailto:joe@host?Attach=~/.gnupg/secring.gpg
4118
4119        will send out the user's private gnupg keyring to joe@host if the user doesn't
4120        follow the information on screen carefully enough.
4121
4122        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.323  , page 168) variable, mutt-
4123        ng will
4124
4125           +\bo be less strict when interpreting these links by prepending a X-Mailto-
4126             string to all header fields embedded in such a link _\ba_\bn_\bd
4127
4128           +\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
4129             to let the user see all the headers (because they still may leak informa-
4130             tion.)
4131
4132        _\b6_\b._\b4  _\bE_\bx_\bt_\be_\br_\bn_\ba_\bl _\ba_\bp_\bp_\bl_\bi_\bc_\ba_\bt_\bi_\bo_\bn_\bs
4133
4134        Mutt-ng in many places has to rely on external applications or for convenience
4135        supports mechanisms involving external applications.
4136
4137        _\b6_\b._\b4_\b._\b1  _\bm_\ba_\bi_\bl_\bc_\ba_\bp
4138
4139        One of these is the mailcap mechanism as defined by RfC 1524. Mutt-ng can be
4140        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-
4141        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
4142        details.)
4143
4144        These utilities may have a variety of security vulnerabilities, including
4145
4146        The Mutt Next Generation E-Mail Client                                       82
4147
4148        overwriting of arbitrary files, information leaks or other exploitable bugs.
4149        These vulnerabilities may go unnoticed by the user, especially when they are
4150        called automatically (and without interactive prompting) from the mailcap
4151        file(s). When using mutt-ng's autoview mechanism in combination with mailcap
4152        files, please be sure to...
4153
4154           +\bo manually select trustworth applications with a reasonable calling sequence
4155
4156           +\bo periodically check the contents of mailcap files, especially after soft-
4157             ware installations or upgrades
4158
4159           +\bo keep the software packages referenced in the mailcap file up to date
4160
4161           +\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
4162             default state to restrict mailcap expandos to a safe set of characters
4163
4164        _\b6_\b._\b4_\b._\b2  _\bO_\bt_\bh_\be_\br
4165
4166        Besides the mailcap mechanism, mutt-ng uses a number of other external utili-
4167        ties for operation.
4168
4169        The same security considerations apply for these as for tools involved via
4170        mailcap (for example, mutt-ng is vulnerable to Denial of Service Attacks with
4171        compressed folders support if the uncompressed mailbox is too large for the
4172        disk it is saved to.)
4173
4174        As already noted, most of these problems are not built in but caused by wrong
4175        configuration, so please check your configuration.
4176
4177        _\b7_\b.  _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be
4178
4179        _\b7_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs
4180
4181        Running mutt with no arguments will make Mutt-ng attempt to read your spool
4182        mailbox.  However, it is possible to read other mailboxes and to send messages
4183        from the command line as well.
4184
4185        The Mutt Next Generation E-Mail Client                                       83
4186
4187             -A      expand an alias
4188             -a      attach a file to a message
4189             -b      specify a blind carbon-copy (BCC) address
4190             -c      specify a carbon-copy (Cc) address
4191             -e      specify a config command to be run after initialization files are read
4192             -f      specify a mailbox to load
4193             -F      specify an alternate file to read initialization commands
4194             -h      print help on command line options
4195             -H      specify a draft file from which to read a header and body
4196             -i      specify a file to include in a message composition
4197             -m      specify a default mailbox type
4198             -n      do not read the system Muttngrc
4199             -p      recall a postponed message
4200             -Q      query a configuration variable
4201             -R      open mailbox in read-only mode
4202             -s      specify a subject (enclose in quotes if it contains spaces)
4203             -t      dump the value of all variables to stdout
4204             -T      dump the value of all changed variables to stdout
4205             -v      show version number and compile-time definitions
4206             -x      simulate the mailx(1) compose mode
4207             -y      show a menu containing the files specified by the mailboxes command
4208             -z      exit immediately if there are no messages in the mailbox
4209             -Z      open the first folder with new message,exit immediately if none
4210
4211        To read messages in a mailbox
4212
4213        mutt [ -nz ] [ -F _\bm_\bu_\bt_\bt_\br_\bc ] [ -m _\bt_\by_\bp_\be ] [ -f _\bm_\ba_\bi_\bl_\bb_\bo_\bx ]
4214
4215        To compose a new message
4216
4217        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-
4218        _\bj_\be_\bc_\bt ] _\ba_\bd_\bd_\br_\be_\bs_\bs [ _\ba_\bd_\bd_\br_\be_\bs_\bs ... ]
4219
4220        Mutt-ng also supports a ``batch'' mode to send prepared messages.  Simply redi-
4221        rect input from the file you wish to send.  For example,
4222
4223        mutt -s 'data set for run #2' professor@bigschool.edu < ~/run2.dat
4224
4225        This command will send a message to ``professor@bigschool.edu'' with a subject
4226        of ``data set for run #2''.  In the body of the message will be the contents of
4227        the file ``~/run2.dat''.
4228
4229        _\b7_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
4230
4231        The Mutt Next Generation E-Mail Client                                       84
4232
4233             ~A              all messages
4234             ~b EXPR         messages which contain EXPR in the message body
4235             ~B EXPR         messages which contain EXPR in the whole message
4236             ~c USER         messages carbon-copied to USER
4237             ~C EXPR         message is either to: or cc: EXPR
4238             ~D              deleted messages
4239             ~d [MIN]-[MAX]  messages with ``date-sent'' in a Date range
4240             ~E              expired messages
4241             ~e EXPR         message which contains EXPR in the ``Sender'' field
4242             ~F              flagged messages
4243             ~f USER         messages originating from USER
4244             ~g              cryptographically signed messages
4245             ~G              cryptographically encrypted messages
4246             ~H EXPR         messages with a spam attribute matching EXPR
4247             ~h EXPR         messages which contain EXPR in the message header
4248             ~k              message contains PGP key material
4249             ~i ID           message which match ID in the ``Message-ID'' field
4250             ~L EXPR         message is either originated or received by EXPR
4251             ~l              message is addressed to a known mailing list
4252             ~m [MIN]-[MAX]  message in the range MIN to MAX *)
4253             ~M              multipart messages
4254             ~n [MIN]-[MAX]  messages with a score in the range MIN to MAX *)
4255             ~N              new messages
4256             ~O              old messages
4257             ~p              message is addressed to you (consults alternates)
4258             ~P              message is from you (consults alternates)
4259             ~Q              messages which have been replied to
4260             ~R              read messages
4261             ~r [MIN]-[MAX]  messages with ``date-received'' in a Date range
4262             ~S              superseded messages
4263             ~s SUBJECT      messages having SUBJECT in the ``Subject'' field.
4264             ~T              tagged messages
4265             ~t USER         messages addressed to USER
4266             ~U              unread messages
4267             ~v              message is part of a collapsed thread.
4268             ~V              cryptographically verified messages
4269             ~w EXPR         messages which contain EXPR in the `Newsgroups' field
4270                             (if compiled with NNTP support)
4271             ~x EXPR         messages which contain EXPR in the `References' field
4272             ~y EXPR         messages which contain EXPR in the `X-Label' field
4273             ~z [MIN]-[MAX]  messages with a size in the range MIN to MAX *)
4274             ~=              duplicated messages (see $duplicate_threads)
4275             ~$              unreferenced messages (requires threaded view)
4276             ~*              ``From'' contains realname and (syntactically) valid
4277                             address (excluded are addresses matching against
4278                             alternates or any alias)
4279
4280        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
4281        48).  Special attention has to be made when using regular expressions inside of
4282        patterns.  Specifically, Mutt-ng's parser for these patterns will strip one
4283        level of backslash (\), which is normally used for quoting.  If it is your
4284        intention to use a backslash in the regular expression, you will need to use
4285        two backslashes instead (\\).
4286
4287        The Mutt Next Generation E-Mail Client                                       85
4288
4289        *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too.
4290
4291        _\b7_\b._\b3  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs
4292
4293        The following are the commands understood by mutt.
4294
4295           +\bo _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\b-_\bh_\bo_\bo_\bk (section 4.17  , page 67) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4296
4297           +\bo _\ba_\bl_\bi_\ba_\bs (section 3.4  , page 26) _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
4298
4299           +\bo _\bu_\bn_\ba_\bl_\bi_\ba_\bs (section 3.4  , page 26) [ * | _\bk_\be_\by ... ]
4300
4301           +\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 ... ]
4302
4303           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.11  , page 33) [ * | _\br_\be_\bg_\be_\bx_\bp ... ]
4304
4305           +\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 ... ]
4306
4307           +\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 ... ]
4308
4309           +\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
4310
4311           +\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 ... ]
4312
4313           +\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 ... ]
4314
4315           +\bo _\bb_\bi_\bn_\bd (section 3.5  , page 27) _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
4316
4317           +\bo _\bc_\bh_\ba_\br_\bs_\be_\bt_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 29) _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
4318
4319           +\bo _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 69) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4320
4321           +\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 ]
4322
4323           +\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 ... ]
4324
4325           +\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 ... ]
4326
4327           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 39) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4328
4329           +\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
4330
4331           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.7  , page 29) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4332
4333           +\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 ... ]
4334
4335           +\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 ... ]
4336
4337           +\bo _\bi_\bc_\bo_\bn_\bv_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 29) _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
4338
4339           +\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 ... ]
4340
4341        The Mutt Next Generation E-Mail Client                                       86
4342
4343           +\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 ... ]
4344
4345           +\bo _\bl_\bi_\bs_\bt_\bs (section 3.13  , page 36) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4346
4347           +\bo _\bu_\bn_\bl_\bi_\bs_\bt_\bs (section 3.13  , page 36) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4348
4349           +\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 ]
4350
4351           +\bo _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.15  , page 37) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
4352
4353           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 37) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4354
4355           +\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
4356
4357           +\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 ... ]
4358
4359           +\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 ... ]
4360
4361           +\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 ]
4362
4363           +\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 ... ]
4364
4365           +\bo _\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37) _\bs_\bt_\br_\bi_\bn_\bg
4366
4367           +\bo _\bu_\bn_\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37) _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
4368
4369           +\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
4370
4371           +\bo _\bc_\br_\by_\bp_\bt_\b-_\bh_\bo_\bo_\bk (section 3.23  , page 41) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\b-_\bi_\bd
4372
4373           +\bo _\bp_\bu_\bs_\bh (section 3.24  , page 41) _\bs_\bt_\br_\bi_\bn_\bg
4374
4375           +\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 ... ]
4376
4377           +\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
4378
4379           +\bo _\bs_\bc_\bo_\br_\be (section 3.26  , page 41) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
4380
4381           +\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 ... ]
4382
4383           +\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
4384
4385           +\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
4386
4387           +\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 ... ]
4388
4389           +\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 ... ]
4390
4391           +\bo _\bs_\bo_\bu_\br_\bc_\be (section 3.29  , page 45) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4392
4393           +\bo _\bs_\bp_\ba_\bm (section 3.27  , page 42) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
4394
4395           +\bo _\bn_\bo_\bs_\bp_\ba_\bm (section 3.27  , page 42) _\bp_\ba_\bt_\bt_\be_\br_\bn
4396
4397        The Mutt Next Generation E-Mail Client                                       87
4398
4399           +\bo _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.13  , page 36) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4400
4401           +\bo _\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.13  , page 36) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4402
4403           +\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 ... ]
4404
4405           +\bo _\bu_\bn_\bh_\bo_\bo_\bk (section 3.30  , page 46) _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be
4406
4407        _\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
4408
4409        The following list contains all variables which, in the process of providing
4410        more consistency, have been renamed and are partially even removed already. The
4411        left column contains the old synonym variables, the right column the full/new
4412        name:
4413
4414        The Mutt Next Generation E-Mail Client                                       88
4415
4416             edit_hdrs               edit_headers
4417             forw_decode             forward_decode
4418             forw_format             forward_format
4419             forw_quote              forward_quote
4420             hdr_format              index_format
4421             indent_str              indent_string
4422             mime_fwd                mime_forward
4423             msg_format              message_format
4424             pgp_autosign            crypt_autosign
4425             pgp_autoencrypt         crypt_autoencrypt
4426             pgp_replyencrypt        crypt_replyencrypt
4427             pgp_replysign           crypt_replysign
4428             pgp_replysignencrypted  crypt_replysignencrypted
4429             pgp_verify_sig          crypt_verify_sig
4430             pgp_create_traditional  pgp_autoinline
4431             pgp_auto_traditional    pgp_replyinline
4432             forw_decrypt            forward_decrypt
4433             smime_sign_as           smime_default_key
4434             post_indent_str         post_indent_string
4435             print_cmd               print_command
4436             shorten_hierarchy       sidebar_shorten_hierarchy
4437             ask_followup_to         nntp_ask_followup_to
4438             ask_x_comment_to        nntp_ask_x_comment_to
4439             catchup_newsgroup       nntp_catchup
4440             followup_to_poster      nntp_followup_to_poster
4441             group_index_format      nntp_group_index_format
4442             inews                   nntp_inews
4443             mime_subject            nntp_mime_subject
4444             news_cache_dir          nntp_cache_dir
4445             news_server             nntp_host
4446             newsrc                  nntp_newsrc
4447             nntp_poll               nntp_mail_check
4448             pop_checkinterval       pop_mail_check
4449             post_moderated          nntp_post_moderated
4450             save_unsubscribed       nntp_save_unsubscribed
4451             show_new_news           nntp_show_new_news
4452             show_only_unread        nntp_show_only_unread
4453             x_comment_to            nntp_x_comment_to
4454             smtp_auth_username      smtp_user
4455             smtp_auth_password      smtp_pass
4456
4457        The contrib subdirectory contains a script named update-config.pl which eases
4458        migration.
4459
4460        A complete list of current variables follows.
4461
4462        _\b7_\b._\b4_\b._\b1  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\ba_\bt_\bt_\ba_\bc_\bh
4463
4464        Type: quadoption
4465
4466        Default: no
4467
4468        This variable specifies whether to abort sending if no attachment was made but
4469
4470        The Mutt Next Generation E-Mail Client                                       89
4471
4472        the content references them, i.e. the content matches the regular expression
4473        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
4474        found and this variable is set to _\by_\be_\bs, message sending will be aborted but the
4475        mail will be send nevertheless if set to _\bn_\bo.
4476
4477        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
4478        intended to remind the user to attach files if the message's text references
4479        them.
4480
4481        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.
4482
4483        _\b7_\b._\b4_\b._\b2  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\bs_\bu_\bb_\bj_\be_\bc_\bt
4484
4485        Type: quadoption
4486
4487        Default: ask-yes
4488
4489        If set to _\by_\be_\bs, when composing messages and no subject is given at the subject
4490        prompt, composition will be aborted.  If set to _\bn_\bo, composing messages with no
4491        subject given at the subject prompt will never be aborted.
4492
4493        _\b7_\b._\b4_\b._\b3  _\ba_\bb_\bo_\br_\bt_\b__\bu_\bn_\bm_\bo_\bd_\bi_\bf_\bi_\be_\bd
4494
4495        Type: quadoption
4496
4497        Default: yes
4498
4499        If set to _\by_\be_\bs, composition will automatically abort after editing the message
4500        body if no changes are made to the file (this check only happens after the
4501        _\bf_\bi_\br_\bs_\bt edit of the file).  When set to _\bn_\bo, composition will never be aborted.
4502
4503        _\b7_\b._\b4_\b._\b4  _\ba_\bg_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
4504
4505        Type: boolean
4506
4507        Default: yes
4508
4509        When _\bs_\be_\bt, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indi-
4510        cating which version of Mutt-ng was used for composing them.
4511
4512        _\b7_\b._\b4_\b._\b5  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be
4513
4514        Type: path
4515
4516        Default: '~/.muttngrc'
4517
4518        The default file in which to save aliases created by the ``_\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (sec-
4519        tion 2.5.4  , page 11)'' function.
4520
4521        N\bNo\bot\bte\be:\b: Mutt-ng will not automatically source this file; you must explicitly use
4522        the ``_\bs_\bo_\bu_\br_\bc_\be (section 3.29  , page 45)'' command for it to be executed.
4523
4524        _\b7_\b._\b4_\b._\b6  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
4525
4526        The Mutt Next Generation E-Mail Client                                       90
4527
4528        Type: string
4529
4530        Default: '%4n %2f %t %-10a   %r'
4531
4532        Specifies the format of the data displayed for the ``alias'' menu. The follow-
4533        ing printf(3)-style sequences are available:
4534
4535              %a
4536                    alias name
4537
4538              %f
4539                    flags - currently, a 'd' for an alias marked for deletion
4540
4541              %n
4542                    index number
4543
4544              %r
4545                    address which alias expands to
4546
4547              %t
4548                    character which indicates if the alias is tagged for inclusion
4549
4550        _\b7_\b._\b4_\b._\b7  _\ba_\bl_\bl_\bo_\bw_\b__\b8_\bb_\bi_\bt
4551
4552        Type: boolean
4553
4554        Default: yes
4555
4556        Controls whether 8-bit data is converted to 7-bit using either quoted-printable
4557        or base64 encoding when sending mail.
4558
4559        _\b7_\b._\b4_\b._\b8  _\ba_\bl_\bl_\bo_\bw_\b__\ba_\bn_\bs_\bi
4560
4561        Type: boolean
4562
4563        Default: no
4564
4565        Controls whether ANSI color codes in messages (and color tags in rich text mes-
4566        sages) are to be interpreted.  Messages containing these codes are rare, but if
4567        this option is set, their text will be colored accordingly. Note that this may
4568        override your color choices, and even present a security problem, since a mes-
4569        sage could include a line like ``[-- PGP output follows ...' and give it the
4570        same color as your attachment color.
4571
4572        _\b7_\b._\b4_\b._\b9  _\ba_\br_\br_\bo_\bw_\b__\bc_\bu_\br_\bs_\bo_\br
4573
4574        Type: boolean
4575
4576        Default: no
4577
4578        When _\bs_\be_\bt, an arrow (``->'') will be used to indicate the current entry in menus
4579        instead of highlighting the whole line.  On slow network or modem links this
4580        will make response faster because there is less that has to be redrawn on the
4581        screen when moving to the next or previous entries in the menu.
4582
4583        The Mutt Next Generation E-Mail Client                                       91
4584
4585        _\b7_\b._\b4_\b._\b1_\b0  _\ba_\bs_\bc_\bi_\bi_\b__\bc_\bh_\ba_\br_\bs
4586
4587        Type: boolean
4588
4589        Default: no
4590
4591        If _\bs_\be_\bt, Mutt-ng will use plain ASCII characters when displaying thread and
4592        attachment trees, instead of the default ACS characters.
4593
4594        _\b7_\b._\b4_\b._\b1_\b1  _\ba_\bs_\bk_\bb_\bc_\bc
4595
4596        Type: boolean
4597
4598        Default: no
4599
4600        If _\bs_\be_\bt, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before
4601        editing an outgoing message.
4602
4603        _\b7_\b._\b4_\b._\b1_\b2  _\ba_\bs_\bk_\bc_\bc
4604
4605        Type: boolean
4606
4607        Default: no
4608
4609        If _\bs_\be_\bt, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing
4610        the body of an outgoing message.
4611
4612        _\b7_\b._\b4_\b._\b1_\b3  _\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4613
4614        Type: string
4615
4616        Default: 'us-ascii'
4617
4618        This variable is a colon-separated list of character encoding schemes for mes-
4619        sages without character encoding indication.  Header field values and message
4620        body content without character encoding indication would be assumed that they
4621        are written in one of this list.  By default, all the header fields and message
4622        body without any charset indication are assumed to be in us-ascii.
4623
4624        For example, Japanese users might prefer this:
4625
4626        set assumed_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
4627
4628        However, only the first content is valid for the message body.  This variable
4629        is valid only if _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be (section 7.4.324  , page 168) is unset.
4630
4631        _\b7_\b._\b4_\b._\b1_\b4  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bf_\bo_\br_\bm_\ba_\bt
4632
4633        Type: string
4634
4635        Default: '%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] '
4636
4637        This variable describes the format of the ``attachment'' menu.  The following
4638        printf(3)-style sequences are understood:
4639
4640        The Mutt Next Generation E-Mail Client                                       92
4641
4642              %C
4643                    charset
4644
4645              %c
4646                    requires charset conversion (n or c)
4647
4648              %D
4649                    deleted flag
4650
4651              %d
4652                    description
4653
4654              %e
4655                    MIME Content-Transfer-Encoding: header field
4656
4657              %f
4658                    filename
4659
4660              %I
4661                    MIME Content-Disposition: header field (I=inline, A=attachment)
4662
4663              %m
4664                    major MIME type
4665
4666              %M
4667                    MIME subtype
4668
4669              %n
4670                    attachment number
4671
4672              %s
4673                    size
4674
4675              %t
4676                    tagged flag
4677
4678              %T
4679                    graphic tree characters
4680
4681              %u
4682                    unlink (=to delete) flag
4683
4684              %>X
4685                    right justify the rest of the string and pad with character 'X'
4686
4687              %|X
4688                    pad to the end of the line with character 'X'
4689
4690        _\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
4691
4692        Type: regular expression
4693
4694        Default: 'attach'
4695
4696        The Mutt Next Generation E-Mail Client                                       93
4697
4698        If this variable is non-empty, muttng will scan a message's contents before
4699        sending for this regular expression. If it is found, it will ask for what to do
4700        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).
4701
4702        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
4703        remind the user to attach files if the message's text references them.
4704
4705        _\b7_\b._\b4_\b._\b1_\b6  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp
4706
4707        Type: string
4708
4709        Default: '\n'
4710
4711        The separator to add between attachments when operating (saving, printing, pip-
4712        ing, etc) on a list of tagged attachments.
4713
4714        _\b7_\b._\b4_\b._\b1_\b7  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\bp_\bl_\bi_\bt
4715
4716        Type: boolean
4717
4718        Default: yes
4719
4720        If this variable is _\bu_\bn_\bs_\be_\bt, when operating (saving, printing, piping, etc) on a
4721        list of tagged attachments, Mutt-ng will concatenate the attachments and will
4722        operate on them as a single attachment. The ``_\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp (section 7.4.16  ,
4723        page 93)'' separator is added after each attachment. When _\bs_\be_\bt, Mutt-ng will
4724        operate on the attachments one by one.
4725
4726        _\b7_\b._\b4_\b._\b1_\b8  _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn
4727
4728        Type: string
4729
4730        Default: 'On %d, %n wrote:'
4731
4732        This is the string that will precede a message which has been included in a
4733        reply.  For a full listing of defined printf(3)-like sequences see the section
4734        on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''.
4735
4736        _\b7_\b._\b4_\b._\b1_\b9  _\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg
4737
4738        Type: boolean
4739
4740        Default: no
4741
4742        When _\bs_\be_\bt, functions in the _\bi_\bn_\bd_\be_\bx menu which affect a message will be applied to
4743        all tagged messages (if there are any).  When unset, you must first use the
4744        ``tag-prefix'' function (default: ';') to make the next function apply to all
4745        tagged messages.
4746
4747        _\b7_\b._\b4_\b._\b2_\b0  _\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt
4748
4749        Type: boolean
4750
4751        Default: no
4752
4753        The Mutt Next Generation E-Mail Client                                       94
4754
4755        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
4756        will skip the initial send-menu and allow you to immediately begin editing the
4757        body of your message.  The send-menu may still be accessed once you have fin-
4758        ished editing the body of your message.
4759
4760        Also see ``_\b$_\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by (section 7.4.66  , page 104)''.
4761
4762        _\b7_\b._\b4_\b._\b2_\b1  _\bb_\be_\be_\bp
4763
4764        Type: boolean
4765
4766        Default: yes
4767
4768        When this variable is _\bs_\be_\bt, Mutt-ng will beep when an error occurs.
4769
4770        _\b7_\b._\b4_\b._\b2_\b2  _\bb_\be_\be_\bp_\b__\bn_\be_\bw
4771
4772        Type: boolean
4773
4774        Default: no
4775
4776        When this variable is _\bs_\be_\bt, Mutt-ng will beep whenever it prints a message noti-
4777        fying you of new mail.  This is independent of the setting of the ``_\b$_\bb_\be_\be_\bp (sec-
4778        tion 7.4.21  , page 94)'' variable.
4779
4780        _\b7_\b._\b4_\b._\b2_\b3  _\bb_\bo_\bu_\bn_\bc_\be
4781
4782        Type: quadoption
4783
4784        Default: ask-yes
4785
4786        Controls whether you will be asked to confirm bouncing messages.  If set to _\by_\be_\bs
4787        you don't get asked if you want to bounce a message. Setting this variable to
4788        _\bn_\bo is not generally useful, and thus not recommended, because you are unable to
4789        bounce messages.
4790
4791        _\b7_\b._\b4_\b._\b2_\b4  _\bb_\bo_\bu_\bn_\bc_\be_\b__\bd_\be_\bl_\bi_\bv_\be_\br_\be_\bd
4792
4793        Type: boolean
4794
4795        Default: yes
4796
4797        When this variable is _\bs_\be_\bt, Mutt-ng will include Delivered-To: header fields
4798        when bouncing messages.  Postfix users may wish to _\bu_\bn_\bs_\be_\bt this variable.
4799
4800        _\b7_\b._\b4_\b._\b2_\b5  _\bb_\br_\ba_\bi_\bl_\bl_\be_\b__\bf_\br_\bi_\be_\bn_\bd_\bl_\by
4801
4802        Type: boolean
4803
4804        Default: no
4805
4806        When this variable is set, mutt will place the cursor at the beginning of the
4807        current line in menus, even when the arrow_cursor variable is unset, making it
4808        easier for blind persons using Braille displays to follow these menus.  The
4809
4810        The Mutt Next Generation E-Mail Client                                       95
4811
4812        option is disabled by default because many visual terminals don't permit making
4813        the cursor invisible.
4814
4815        _\b7_\b._\b4_\b._\b2_\b6  _\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\b__\bf_\bi_\bl_\be
4816
4817        Type: path
4818
4819        Default: '~/.mutt_certificates'
4820
4821        Availability: SSL or GNUTLS
4822
4823        This variable specifies the file where the certificates you trust are saved.
4824        When an unknown certificate is encountered, you are asked if you accept it or
4825        not. If you accept it, the certificate can also be saved in this file and fur-
4826        ther connections are automatically accepted.
4827
4828        You can also manually add CA certificates in this file. Any server certificate
4829        that is signed with one of these CA certificates are also automatically
4830        accepted.
4831
4832        Example: set certificate_file=~/.muttng/certificates
4833
4834        _\b7_\b._\b4_\b._\b2_\b7  _\bc_\bh_\ba_\br_\bs_\be_\bt
4835
4836        Type: string
4837
4838        Default: ''
4839
4840        Character set your terminal uses to display and enter textual data.
4841
4842        _\b7_\b._\b4_\b._\b2_\b8  _\bc_\bh_\be_\bc_\bk_\b__\bn_\be_\bw
4843
4844        Type: boolean
4845
4846        Default: yes
4847
4848        N\bNo\bot\bte\be:\b: this option only affects _\bm_\ba_\bi_\bl_\bd_\bi_\br and _\bM_\bH style mailboxes.
4849
4850        When _\bs_\be_\bt, Mutt-ng will check for new mail delivered while the mailbox is open.
4851        Especially with MH mailboxes, this operation can take quite some time since it
4852        involves scanning the directory and checking each file to see if it has already
4853        been looked at.  If it's _\bu_\bn_\bs_\be_\bt, no check for new mail is performed while the
4854        mailbox is open.
4855
4856        _\b7_\b._\b4_\b._\b2_\b9  _\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bu_\bn_\br_\be_\ba_\bd
4857
4858        Type: boolean
4859
4860        Default: yes
4861
4862        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not collapse a thread if it contains any unread mes-
4863        sages.
4864
4865        The Mutt Next Generation E-Mail Client                                       96
4866
4867        _\b7_\b._\b4_\b._\b3_\b0  _\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4868
4869        Type: string
4870
4871        Default: '-- Mutt-ng: Compose  [Approx. msg size: %l   Atts: %a]%>-'
4872
4873        Controls the format of the status line displayed in the ``compose'' menu.  This
4874        string is similar to ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.321  , page 165)'', but has
4875        its own set of printf(3)-like sequences:
4876
4877              %a
4878                    total number of attachments
4879
4880              %h
4881                    local hostname
4882
4883              %l
4884                    approximate size (in bytes) of the current message
4885
4886              %v
4887                    Mutt-ng version string
4888
4889        See the text describing the ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.321  , page 165)''
4890        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  ,
4891        page 96)''.
4892
4893        _\b7_\b._\b4_\b._\b3_\b1  _\bc_\bo_\bn_\bf_\bi_\bg_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4894
4895        Type: string
4896
4897        Default: ''
4898
4899        When defined, Mutt-ng will recode commands in rc files from this encoding.
4900
4901        _\b7_\b._\b4_\b._\b3_\b2  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\ba_\bp_\bp_\be_\bn_\bd
4902
4903        Type: boolean
4904
4905        Default: yes
4906
4907        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when appending messages to an
4908        existing mailbox.
4909
4910        _\b7_\b._\b4_\b._\b3_\b3  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\bc_\br_\be_\ba_\bt_\be
4911
4912        Type: boolean
4913
4914        Default: yes
4915
4916        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when saving messages to a mail-
4917        box which does not yet exist before creating it.
4918
4919        _\b7_\b._\b4_\b._\b3_\b4  _\bc_\bo_\bn_\bn_\be_\bc_\bt_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
4920
4921        The Mutt Next Generation E-Mail Client                                       97
4922
4923        Type: number
4924
4925        Default: 30
4926
4927        Causes Mutt-ng to timeout a network connection (for IMAP or POP) after this
4928        many seconds if the connection is not able to be established.  A negative value
4929        causes Mutt-ng to wait indefinitely for the connection to succeed.
4930
4931        _\b7_\b._\b4_\b._\b3_\b5  _\bc_\bo_\bn_\bt_\be_\bn_\bt_\b__\bt_\by_\bp_\be
4932
4933        Type: string
4934
4935        Default: 'text/plain'
4936
4937        Sets the default Content-Type: header field for the body of newly composed mes-
4938        sages.
4939
4940        _\b7_\b._\b4_\b._\b3_\b6  _\bc_\bo_\bp_\by
4941
4942        Type: quadoption
4943
4944        Default: yes
4945
4946        This variable controls whether or not copies of your outgoing messages will be
4947        saved for later references.  Also see ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.243  , page
4948        147)'', ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.254  , page 150)'', ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section
4949        7.4.74  , page 106)'' and ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 39)''.
4950
4951        _\b7_\b._\b4_\b._\b3_\b7  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt
4952
4953        Type: boolean
4954
4955        Default: no
4956
4957        Setting this variable will cause Mutt-ng to always attempt to PGP encrypt out-
4958        going messages.  This is probably only useful in connection to the _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk
4959        command.  It can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when encryption is not
4960        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
4961        7.4.290  , page 158)'' is _\bs_\be_\bt, then OpenSSL is used instead to create S/MIME
4962        messages and settings can be overridden by use of the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto
4963        only)
4964
4965        _\b7_\b._\b4_\b._\b3_\b8  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bp_\bg_\bp
4966
4967        Type: boolean
4968
4969        Default: yes
4970
4971        This variable controls whether or not Mutt-ng may automatically enable PGP
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.290  , page 158)''.
4976
4977        The Mutt Next Generation E-Mail Client                                       98
4978
4979        _\b7_\b._\b4_\b._\b3_\b9  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn
4980
4981        Type: boolean
4982
4983        Default: no
4984
4985        Setting this variable will cause Mutt-ng to always attempt to cryptographically
4986        sign outgoing messages.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when
4987        signing is not required or encryption is requested as well. If
4988        ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.290  , page 158)'' is _\bs_\be_\bt, then OpenSSL is
4989        used instead to create S/MIME messages and settings can be overridden by use of
4990        the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto only)
4991
4992        _\b7_\b._\b4_\b._\b4_\b0  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bm_\bi_\bm_\be
4993
4994        Type: boolean
4995
4996        Default: yes
4997
4998        This variable controls whether or not Mutt-ng may automatically enable S/MIME
4999        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
5000        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)'',
5001        ``_\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
5002        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.290  , page 158)''.
5003
5004        _\b7_\b._\b4_\b._\b4_\b1  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt
5005
5006        Type: boolean
5007
5008        Default: yes
5009
5010        If _\bs_\be_\bt, automatically PGP or OpenSSL encrypt replies to messages which are
5011        encrypted.  (Crypto only)
5012
5013        _\b7_\b._\b4_\b._\b4_\b2  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn
5014
5015        Type: boolean
5016
5017        Default: no
5018
5019        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are signed.
5020
5021        N\bNo\bot\bte\be:\b: this does not work on messages that are encrypted a\ban\bnd\bd signed!  (Crypto
5022        only)
5023
5024        _\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
5025
5026        Type: boolean
5027
5028        Default: no
5029
5030        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are
5031        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
5032        7.4.41  , page 98)'', because it allows you to sign all messages which are
5033
5034        The Mutt Next Generation E-Mail Client                                       99
5035
5036        automatically encrypted.  This works around the problem noted in
5037        ``_\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
5038        find out whether an encrypted message is also signed.  (Crypto only)
5039
5040        _\b7_\b._\b4_\b._\b4_\b4  _\bc_\br_\by_\bp_\bt_\b__\bt_\bi_\bm_\be_\bs_\bt_\ba_\bm_\bp
5041
5042        Type: boolean
5043
5044        Default: yes
5045
5046        If _\bs_\be_\bt, Mutt-ng will include a time stamp in the lines surrounding PGP or
5047        S/MIME output, so spoofing such lines is more difficult.  If you are using col-
5048        ors to mark these lines, and rely on these, you may _\bu_\bn_\bs_\be_\bt this setting.
5049        (Crypto only)
5050
5051        _\b7_\b._\b4_\b._\b4_\b5  _\bc_\br_\by_\bp_\bt_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\bm_\be
5052
5053        Type: boolean
5054
5055        Default: no
5056
5057        This variable controls the use the GPGME enabled crypto backends.  If it is _\bs_\be_\bt
5058        and Mutt-ng was build with gpgme support, the gpgme code for S/MIME and PGP
5059        will be used instead of the classic code.
5060
5061        N\bNo\bot\bte\be: You need to use this option in your .muttngrc configuration file as it
5062        won't have any effect when used interactively.
5063
5064        _\b7_\b._\b4_\b._\b4_\b6  _\bc_\br_\by_\bp_\bt_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bs_\bi_\bg
5065
5066        Type: quadoption
5067
5068        Default: yes
5069
5070        If ``_\by_\be_\bs'', always attempt to verify PGP or S/MIME signatures.  If ``_\ba_\bs_\bk'', ask
5071        whether or not to verify the signature.  If ``_\bn_\bo'', never attempt to verify
5072        cryptographic signatures.  (Crypto only)
5073
5074        _\b7_\b._\b4_\b._\b4_\b7  _\bd_\ba_\bt_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
5075
5076        Type: string
5077
5078        Default: '!%a, %b %d, %Y at %I:%M:%S%p %Z'
5079
5080        This variable controls the format of the date printed by the ``%d'' sequence in
5081        ``_\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)
5082        to process the date.
5083
5084        Unless the first character in the string is a bang (``!''), the month and week
5085        day names are expanded according to the locale specified in the variable
5086        ``_\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.120  , page 119)''. If the first character in the string
5087        is a bang, the bang is discarded, and the month and week day names in the rest
5088        of the string are expanded in the _\bC locale (that is in US English).
5089
5090        The Mutt Next Generation E-Mail Client                                      100
5091
5092        _\b7_\b._\b4_\b._\b4_\b8  _\bd_\be_\bb_\bu_\bg_\b__\bl_\be_\bv_\be_\bl
5093
5094        Type: number
5095
5096        Default: 0
5097
5098        Availability: debug
5099
5100        This variable specifies the current debug level and may be used to increase or
5101        decrease the verbosity level during runtime. It overrides the level given with
5102        the -d command line option.
5103
5104        Currently, this number must be >= 0 and <= 5 and muttng must be started with -d
5105        to enable debugging at all; enabling at runtime is not possible.
5106
5107        _\b7_\b._\b4_\b._\b4_\b9  _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk
5108
5109        Type: string
5110
5111        Default: '~f %s !~P | (~P ~C %s)'
5112
5113        This variable controls how send-hooks, message-hooks, save-hooks, and fcc-hooks
5114        will be interpreted if they are specified with only a simple regexp, instead of
5115        a matching pattern.  The hooks are expanded when they are declared, so a hook
5116        will be interpreted according to the value of this variable at the time the
5117        hook is declared.  The default value matches if the message is either from a
5118        user matching the regular expression given, or if it is from you (if the from
5119        address matches ``alternates'') and is to or cc'ed to a user matching the given
5120        regular expression.
5121
5122        _\b7_\b._\b4_\b._\b5_\b0  _\bd_\be_\bl_\be_\bt_\be
5123
5124        Type: quadoption
5125
5126        Default: ask-yes
5127
5128        Controls whether or not messages are really deleted when closing or synchroniz-
5129        ing a mailbox.  If set to _\by_\be_\bs, messages marked for deleting will automatically
5130        be purged without prompting.  If set to _\bn_\bo, messages marked for deletion will
5131        be kept in the mailbox.
5132
5133        _\b7_\b._\b4_\b._\b5_\b1  _\bd_\be_\bl_\be_\bt_\be_\b__\bs_\bp_\ba_\bc_\be
5134
5135        Type: boolean
5136
5137        Default: no
5138
5139        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
5140        7.4.330  , page 169) variable, this variable specifies whether to also set the
5141        DelSp parameter to yes. If this is _\bu_\bn_\bs_\be_\bt, no additional parameter will be send
5142        as a value of no already is the default behavior.
5143
5144        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
5145        (section 7.4.330  , page 169) is _\bs_\be_\bt) but not on incomming.
5146
5147        The Mutt Next Generation E-Mail Client                                      101
5148
5149        _\b7_\b._\b4_\b._\b5_\b2  _\bd_\be_\bl_\be_\bt_\be_\b__\bu_\bn_\bt_\ba_\bg
5150
5151        Type: boolean
5152
5153        Default: yes
5154
5155        If this option is _\bs_\be_\bt, Mutt-ng will untag messages when marking them for dele-
5156        tion.  This applies when you either explicitly delete a message, or when you
5157        save it to another folder.
5158
5159        _\b7_\b._\b4_\b._\b5_\b3  _\bd_\bi_\bg_\be_\bs_\bt_\b__\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be
5160
5161        Type: boolean
5162
5163        Default: yes
5164
5165        If this option is _\bs_\be_\bt, Mutt-ng's received-attachments menu will not show the
5166        subparts of individual messages in a multipart/digest.  To see these subparts,
5167        press 'v' on that menu.
5168
5169        _\b7_\b._\b4_\b._\b5_\b4  _\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br
5170
5171        Type: path
5172
5173        Default: ''
5174
5175        When _\bs_\be_\bt, specifies a command used to filter messages.  When a message is
5176        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  ,
5177        page 101), and the filtered message is read from the standard output.
5178
5179        _\b7_\b._\b4_\b._\b5_\b5  _\bd_\bo_\bt_\bl_\bo_\bc_\bk_\b__\bp_\br_\bo_\bg_\br_\ba_\bm
5180
5181        Type: path
5182
5183        Default: '$muttng_bindir/muttng_dotlock'
5184
5185        Availability: Standalone and Dotlock
5186
5187        Contains the path of the muttng_dotlock(1) binary to be used by Mutt-ng.
5188
5189        _\b7_\b._\b4_\b._\b5_\b6  _\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by
5190
5191        Type: string
5192
5193        Default: ''
5194
5195        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
5196        or in connection with the SMTP support via libESMTP.
5197
5198        This variable sets the request for when notification is returned.  The string
5199        consists of a comma separated list (no spaces!) of one or more of the follow-
5200        ing: _\bn_\be_\bv_\be_\br, to never request notification, _\bf_\ba_\bi_\bl_\bu_\br_\be, to request notification on
5201        transmission failure, _\bd_\be_\bl_\ba_\by, to be notified of message delays, _\bs_\bu_\bc_\bc_\be_\bs_\bs, to be
5202        notified of successful transmission.
5203
5204        The Mutt Next Generation E-Mail Client                                      102
5205
5206        Example: set dsn_notify='failure,delay'
5207
5208        _\b7_\b._\b4_\b._\b5_\b7  _\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn
5209
5210        Type: string
5211
5212        Default: ''
5213
5214        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
5215        or in connection with the SMTP support via libESMTP.
5216
5217        This variable controls how much of your message is returned in DSN messages.
5218        It may be set to either _\bh_\bd_\br_\bs to return just the message header, or _\bf_\bu_\bl_\bl to
5219        return the full message.
5220
5221        Example: set dsn_return=hdrs
5222
5223        _\b7_\b._\b4_\b._\b5_\b8  _\bd_\bu_\bp_\bl_\bi_\bc_\ba_\bt_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
5224
5225        Type: boolean
5226
5227        Default: yes
5228
5229        This variable controls whether Mutt-ng, when sorting by threads, threads mes-
5230        sages with the same Message-Id: header field together.  If it is _\bs_\be_\bt, it will
5231        indicate that it thinks they are duplicates of each other with an equals sign
5232        in the thread diagram.
5233
5234        _\b7_\b._\b4_\b._\b5_\b9  _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5235
5236        Type: boolean
5237
5238        Default: no
5239
5240        This option allows you to edit the header of your outgoing messages along with
5241        the body of your message.
5242
5243        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
5244        7.4.61  , page 102) option.
5245
5246        _\b7_\b._\b4_\b._\b6_\b0  _\be_\bd_\bi_\bt_\bo_\br
5247
5248        Type: path
5249
5250        Default: ''
5251
5252        This variable specifies which editor is used by Mutt-ng.  It defaults to the
5253        value of the $VISUAL, or $EDITOR, environment variable, or to the string 'vi'
5254        if neither of those are set.
5255
5256        _\b7_\b._\b4_\b._\b6_\b1  _\be_\bd_\bi_\bt_\bo_\br_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5257
5258        Type: string
5259
5260        The Mutt Next Generation E-Mail Client                                      103
5261
5262        Default: 'From: To: Cc: Bcc: Subject: Reply-To: Newsgroups: Followup-To: X-Com-
5263        ment-To:'
5264
5265        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
5266        specifies which _\bn_\bo_\bn_\b-_\be_\bm_\bp_\bt_\by header fields to edit in addition to user-defined
5267        headers.
5268
5269        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
5270        force because _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo (section 7.4.323  , page 168) is _\bu_\bn_\bs_\be_\bt, this
5271        option has no effect.
5272
5273        _\b7_\b._\b4_\b._\b6_\b2  _\be_\bn_\bc_\bo_\bd_\be_\b__\bf_\br_\bo_\bm
5274
5275        Type: boolean
5276
5277        Default: no
5278
5279        When _\bs_\be_\bt, Mutt-ng will quoted-printable encode messages when they contain the
5280        string ``From '' (note the trailing space) in the beginning of a line. Useful
5281        to avoid the tampering certain mail delivery and transport agents tend to do
5282        with messages.
5283
5284        N\bNo\bot\bte\be:\b: as mutt-ng currently violates RfC3676 defining format=flowed, it's
5285        <em/strongly/ advised to _\bs_\be_\bt this option although discouraged by the standard.
5286        Alternatively, you must take care of space-stuffing <tt/From / lines (with a
5287        trailing space) yourself.
5288
5289        _\b7_\b._\b4_\b._\b6_\b3  _\be_\bn_\bt_\br_\bo_\bp_\by_\b__\bf_\bi_\bl_\be
5290
5291        Type: path
5292
5293        Default: ''
5294
5295        Availability: SSL
5296
5297        The file which includes random data that is used to initialize SSL library
5298        functions.
5299
5300        _\b7_\b._\b4_\b._\b6_\b4  _\be_\bn_\bv_\be_\bl_\bo_\bp_\be_\b__\bf_\br_\bo_\bm
5301
5302        Type: boolean
5303
5304        Default: no
5305
5306        When _\bs_\be_\bt, Mutt-ng will try to derive the message's _\be_\bn_\bv_\be_\bl_\bo_\bp_\be sender from the
5307        ``From:'' header field. Note that this information is passed to the sendmail
5308        command using the ``-f' command line switch, so don't set this option if you
5309        are using that switch in _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.260  , page 151) yourself, or
5310        if the sendmail on your machine doesn't support that command line switch.
5311
5312        _\b7_\b._\b4_\b._\b6_\b5  _\be_\bs_\bc_\ba_\bp_\be
5313
5314        Type: string
5315
5316        The Mutt Next Generation E-Mail Client                                      104
5317
5318        Default: '~'
5319
5320        Escape character to use for functions in the builtin editor.
5321
5322        _\b7_\b._\b4_\b._\b6_\b6  _\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5323
5324        Type: boolean
5325
5326        Default: no
5327
5328        When _\bs_\be_\bt, the initial prompt for recipients and subject are skipped when reply-
5329        ing to messages, and the initial prompt for subject is skipped when forwarding
5330        messages.
5331
5332        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
5333        93)'' variable is _\bs_\be_\bt.
5334
5335        _\b7_\b._\b4_\b._\b6_\b7  _\bf_\bc_\bc_\b__\ba_\bt_\bt_\ba_\bc_\bh
5336
5337        Type: boolean
5338
5339        Default: yes
5340
5341        This variable controls whether or not attachments on outgoing messages are
5342        saved along with the main body of your message.
5343
5344        _\b7_\b._\b4_\b._\b6_\b8  _\bf_\bc_\bc_\b__\bc_\bl_\be_\ba_\br
5345
5346        Type: boolean
5347
5348        Default: no
5349
5350        When this variable is _\bs_\be_\bt, FCCs will be stored unencrypted and unsigned, even
5351        when the actual message is encrypted and/or signed.  (PGP only)
5352
5353        _\b7_\b._\b4_\b._\b6_\b9  _\bf_\bi_\bl_\be_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
5354
5355        Type: string
5356
5357        Default: ''
5358
5359        This variable is a colon-separated list of character encoding schemes for text
5360        file attatchments.  If _\bu_\bn_\bs_\be_\bt, _\b$_\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.27  , page 95) value will
5361        be used instead.  For example, the following configuration would work for
5362        Japanese text handling:
5363
5364        set file_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
5365
5366        Note: ``iso-2022-*'' must be put at the head of the value as shown above if
5367        included.
5368
5369        _\b7_\b._\b4_\b._\b7_\b0  _\bf_\bo_\bl_\bd_\be_\br
5370
5371        Type: path
5372
5373        The Mutt Next Generation E-Mail Client                                      105
5374
5375        Default: '~/Mail'
5376
5377        Specifies the default location of your mailboxes.  A ``+'' or ``='' at the
5378        beginning of a pathname will be expanded to the value of this variable.  Note
5379        that if you change this variable from the default value you need to make sure
5380        that the assignment occurs _\bb_\be_\bf_\bo_\br_\be you use ``+'' or ``='' for any other vari-
5381        ables since expansion takes place during the ``set'' command.
5382
5383        _\b7_\b._\b4_\b._\b7_\b1  _\bf_\bo_\bl_\bd_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
5384
5385        Type: string
5386
5387        Default: '%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f'
5388
5389        This variable allows you to customize the file browser display to your personal
5390        taste.  This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page
5391        115)'', but has its own set of printf(3)-like sequences:
5392
5393              %C
5394                    current file number
5395
5396              %d
5397                    date/time folder was last modified
5398
5399              %f
5400                    filename
5401
5402              %F
5403                    file permissions
5404
5405              %g
5406                    group name (or numeric gid, if missing)
5407
5408              %l
5409                    number of hard links
5410
5411              %N
5412                    N if folder has new mail, blank otherwise
5413
5414              %s
5415                    size in bytes
5416
5417              %t
5418                    * if the file is tagged, blank otherwise
5419
5420              %u
5421                    owner name (or numeric uid, if missing)
5422
5423              %>X
5424                    right justify the rest of the string and pad with character 'X'
5425
5426              %|X
5427                    pad to the end of the line with character 'X'
5428
5429        The Mutt Next Generation E-Mail Client                                      106
5430
5431        _\b7_\b._\b4_\b._\b7_\b2  _\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5432
5433        Type: boolean
5434
5435        Default: yes
5436
5437        Controls whether or not the Mail-Followup-To: header field is generated when
5438        sending mail.  When _\bs_\be_\bt, Mutt-ng will generate this field when you are replying
5439        to a known mailing list, specified with the ``subscribe'' or ``_\bl_\bi_\bs_\bt_\bs (section
5440        3.13  , page 36)'' commands or detected by common mailing list headers.
5441
5442        This field has two purposes.  First, preventing you from receiving duplicate
5443        copies of replies to messages which you send to mailing lists. Second, ensuring
5444        that you do get a reply separately for any messages sent to known lists to
5445        which you are not subscribed.  The header will contain only the list's address
5446        for subscribed lists, and both the list address and your own email address for
5447        unsubscribed lists.  Without this header, a group reply to your message sent to
5448        a subscribed list will be sent to both the list and your address, resulting in
5449        two copies of the same email for you.
5450
5451        _\b7_\b._\b4_\b._\b7_\b3  _\bf_\bo_\br_\bc_\be_\b__\bb_\bu_\bf_\bf_\by_\b__\bc_\bh_\be_\bc_\bk
5452
5453        Type: boolean
5454
5455        Default: no
5456
5457        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
5458        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
5459        already known to have new mail.
5460
5461        Also see the following variables: ``_\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.334  , page 170)'',
5462        ``_\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
5463        7.4.105  , page 113)''.
5464
5465        _\b7_\b._\b4_\b._\b7_\b4  _\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be
5466
5467        Type: boolean
5468
5469        Default: no
5470
5471        This variable is similar to ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.254  , page 150)'',
5472        except that Mutt-ng will store a copy of your outgoing message by the username
5473        of the address you are sending to even if that mailbox does not exist.
5474
5475        Also see the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.243  , page 147)'' variable.
5476
5477        _\b7_\b._\b4_\b._\b7_\b5  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
5478
5479        Type: boolean
5480
5481        Default: yes
5482
5483        Controls the decoding of complex MIME messages into text/plain when forwarding
5484        a message.  The message header is also RFC2047 decoded.  This variable is only
5485
5486        The Mutt Next Generation E-Mail Client                                      107
5487
5488        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
5489        ``_\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.
5490
5491        _\b7_\b._\b4_\b._\b7_\b6  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\br_\by_\bp_\bt
5492
5493        Type: boolean
5494
5495        Default: yes
5496
5497        Controls the handling of encrypted messages when forwarding a message.  When
5498        _\bs_\be_\bt, the outer layer of encryption is stripped off.  This variable is only used
5499        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-
5500        _\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)
5501
5502        _\b7_\b._\b4_\b._\b7_\b7  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\be_\bd_\bi_\bt
5503
5504        Type: quadoption
5505
5506        Default: yes
5507
5508        This quadoption controls whether or not the user is automatically placed in the
5509        editor when forwarding messages.  For those who always want to forward with no
5510        modification, use a setting of _\bn_\bo.
5511
5512        _\b7_\b._\b4_\b._\b7_\b8  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
5513
5514        Type: string
5515
5516        Default: '[%a: %s]'
5517
5518        This variable controls the default subject when forwarding a message.  It uses
5519        the same format sequences as the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page
5520        115)'' variable.
5521
5522        _\b7_\b._\b4_\b._\b7_\b9  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bq_\bu_\bo_\bt_\be
5523
5524        Type: boolean
5525
5526        Default: no
5527
5528        When _\bs_\be_\bt forwarded messages included in the main body of the message (when
5529        ``_\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
5530        ``_\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.115  , page 115)''.
5531
5532        _\b7_\b._\b4_\b._\b8_\b0  _\bf_\br_\bo_\bm
5533
5534        Type: e-mail address
5535
5536        Default: ''
5537
5538        This variable contains a default from address.  It can be overridden using
5539        my_hdr (including from send-hooks) and ``_\b$_\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.249  , page
5540        148)''.  This variable is ignored if ``_\b$_\bu_\bs_\be_\b__\bf_\br_\bo_\bm (section 7.4.343  , page
5541        172)'' is unset.
5542
5543        The Mutt Next Generation E-Mail Client                                      108
5544
5545        E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar
5546        <foo@bar.fb>' when replying to the mutt-ng developer's mailing list and Mutt-ng
5547        takes this email address.
5548
5549        Defaults to the contents of the environment variable $EMAIL.
5550
5551        _\b7_\b._\b4_\b._\b8_\b1  _\bg_\be_\bc_\bo_\bs_\b__\bm_\ba_\bs_\bk
5552
5553        Type: regular expression
5554
5555        Default: '^[^,]*'
5556
5557        A regular expression used by Mutt-ng to parse the GECOS field of a password
5558        entry when expanding the alias.  By default the regular expression is set to
5559        ``^[^,]*'' which will return the string up to the first ``,'' encountered.  If
5560        the GECOS field contains a string like 'lastname, firstname' then you should
5561        do: set gecos_mask='.*'.
5562
5563        This can be useful if you see the following behavior: you address a e-mail to
5564        user ID stevef whose full name is Steve Franklin.  If Mutt-ng expands stevef to
5565        ``Franklin'' stevef@foo.bar then you should set the gecos_mask to a regular
5566        expression that will match the whole name so Mutt-ng will expand ``Franklin''
5567        to ``Franklin, Steve''.
5568
5569        _\b7_\b._\b4_\b._\b8_\b2  _\bh_\bd_\br_\bs
5570
5571        Type: boolean
5572
5573        Default: yes
5574
5575        When _\bu_\bn_\bs_\be_\bt, the header fields normally added by the ``_\bm_\by_\b__\bh_\bd_\br (section 3.16  ,
5576        page 37)'' command are not created.  This variable _\bm_\bu_\bs_\bt be _\bu_\bn_\bs_\be_\bt before compos-
5577        ing a new message or replying in order to take effect.  If _\bs_\be_\bt, the user
5578        defined header fields are added to every new message.
5579
5580        _\b7_\b._\b4_\b._\b8_\b3  _\bh_\be_\ba_\bd_\be_\br
5581
5582        Type: boolean
5583
5584        Default: no
5585
5586        When _\bs_\be_\bt, this variable causes Mutt-ng to include the header of the message you
5587        are replying to into the edit buffer.  The ``_\b$_\bw_\be_\be_\bd (section 7.4.348  , page
5588        173)'' setting applies.
5589
5590        _\b7_\b._\b4_\b._\b8_\b4  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be
5591
5592        Type: path
5593
5594        Default: ''
5595
5596        Availability: Header Cache
5597
5598        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
5599
5600        The Mutt Next Generation E-Mail Client                                      109
5601
5602        cache database.
5603
5604        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
5605        contain a header cache database  per folder. If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section
5606        7.4.84  , page 108) points to a file that file will be a single global header
5607        cache. By default it is _\bu_\bn_\bs_\be_\bt so no header caching will be used.
5608
5609        _\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
5610
5611        Type: boolean
5612
5613        Default: no
5614
5615        If enabled the header cache will be compressed. So only one fifth of the usual
5616        diskspace is used, but the uncompression can result in a slower open of the
5617        cached folder.
5618
5619        _\b7_\b._\b4_\b._\b8_\b6  _\bh_\be_\bl_\bp
5620
5621        Type: boolean
5622
5623        Default: yes
5624
5625        When _\bs_\be_\bt, help lines describing the bindings for the major functions provided
5626        by each menu are displayed on the first line of the screen.
5627
5628        N\bNo\bot\bte\be:\b: The binding will not be displayed correctly if the function is bound to a
5629        sequence rather than a single keystroke.  Also, the help line may not be
5630        updated if a binding is changed while Mutt-ng is running.  Since this variable
5631        is primarily aimed at new users, neither of these should present a major prob-
5632        lem.
5633
5634        _\b7_\b._\b4_\b._\b8_\b7  _\bh_\bi_\bd_\bd_\be_\bn_\b__\bh_\bo_\bs_\bt
5635
5636        Type: boolean
5637
5638        Default: no
5639
5640        When _\bs_\be_\bt, Mutt-ng will skip the host name part of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section
5641        7.4.95  , page 110)'' variable when adding the domain part to addresses.  This
5642        variable does not affect the generation of Message-ID: header fields, and it
5643        will not lead to the cut-off of first-level domains.
5644
5645        _\b7_\b._\b4_\b._\b8_\b8  _\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5646
5647        Type: boolean
5648
5649        Default: no
5650
5651        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5652        limiting, in the thread tree.
5653
5654        _\b7_\b._\b4_\b._\b8_\b9  _\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5655
5656        The Mutt Next Generation E-Mail Client                                      110
5657
5658        Type: boolean
5659
5660        Default: yes
5661
5662        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages in the thread
5663        tree.
5664
5665        _\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
5666
5667        Type: boolean
5668
5669        Default: yes
5670
5671        When _\bs_\be_\bt, Mutt-ng will not show the subject of messages in the thread tree that
5672        have the same subject as their parent or closest previously displayed sibling.
5673
5674        _\b7_\b._\b4_\b._\b9_\b1  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5675
5676        Type: boolean
5677
5678        Default: no
5679
5680        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5681        limiting, at the top of threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\b-
5682        _\bi_\bn_\bg (section 7.4.89  , page 109) is set, this option will have no effect.
5683
5684        _\b7_\b._\b4_\b._\b9_\b2  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5685
5686        Type: boolean
5687
5688        Default: yes
5689
5690        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages at the top of
5691        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  ,
5692        page 109) is _\bs_\be_\bt, this option will have no effect.
5693
5694        _\b7_\b._\b4_\b._\b9_\b3  _\bh_\bi_\bs_\bt_\bo_\br_\by
5695
5696        Type: number
5697
5698        Default: 10
5699
5700        This variable controls the size (in number of strings remembered) of the string
5701        history buffer. The buffer is cleared each time the variable is changed.
5702
5703        _\b7_\b._\b4_\b._\b9_\b4  _\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5704
5705        Type: quadoption
5706
5707        Default: yes
5708
5709        This variable controls whether or not a Mail-Followup-To: header field is hon-
5710        ored when group-replying to a message.
5711
5712        The Mutt Next Generation E-Mail Client                                      111
5713
5714        _\b7_\b._\b4_\b._\b9_\b5  _\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be
5715
5716        Type: string
5717
5718        Default: ''
5719
5720        Specifies the hostname to use after the ``@'' in local e-mail addresses and
5721        during generation of Message-Id: headers.
5722
5723        Please be sure to really know what you are doing when changing this variable to
5724        configure a custom domain part of Message-IDs.
5725
5726        _\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
5727
5728        Type: boolean
5729
5730        Default: no
5731
5732        Affects the behaviour of the _\br_\be_\bp_\bl_\by function when replying to messages from
5733        mailing lists.  When _\bs_\be_\bt, if the ``Reply-To:'' header field is set to the same
5734        value as the ``To:'' header field, Mutt-ng assumes that the ``Reply-To:''
5735        header field was set by the mailing list to automate responses to the list, and
5736        will ignore this field.  To direct a response to the mailing list when this
5737        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
5738        sender and the list.
5739
5740        _\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
5741
5742        Type: string
5743
5744        Default: ''
5745
5746        Availability: IMAP
5747
5748        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
5749        use to log in to an IMAP server, in the order Mutt-ng should try them.  Authen-
5750        tication methods are either ``login'' or the right side of an IMAP ``AUTH=''
5751        capability string, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''. This param-
5752        eter is case-insensitive.
5753
5754        If this parameter is _\bu_\bn_\bs_\be_\bt (the default) Mutt-ng will try all available meth-
5755        ods, in order from most-secure to least-secure.
5756
5757        Example: set imap_authenticators='gssapi:cram-md5:login'
5758
5759        N\bNo\bot\bte\be:\b: Mutt-ng will only fall back to other authentication methods if the previ-
5760        ous methods are unavailable. If a method is available but authentication fails,
5761        Mutt-ng will not connect to the IMAP server.
5762
5763        _\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
5764
5765        Type: boolean
5766
5767        Default: no
5768
5769        The Mutt Next Generation E-Mail Client                                      112
5770
5771        When _\bs_\be_\bt, mutt will fetch the set of subscribed folders from your server on
5772        connection, and add them to the set of mailboxes it polls for new mail. See
5773        also the ``_\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.15  , page 37)'' command.
5774
5775        _\b7_\b._\b4_\b._\b9_\b9  _\bi_\bm_\ba_\bp_\b__\bd_\be_\bl_\bi_\bm_\b__\bc_\bh_\ba_\br_\bs
5776
5777        Type: string
5778
5779        Default: '/.'
5780
5781        Availability: IMAP
5782
5783        This contains the list of characters which you would like to treat as folder
5784        separators for displaying IMAP paths. In particular it helps in using the '='
5785        shortcut for your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  , page 104) variable.
5786
5787        _\b7_\b._\b4_\b._\b1_\b0_\b0  _\bi_\bm_\ba_\bp_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5788
5789        Type: string
5790
5791        Default: ''
5792
5793        Availability: IMAP
5794
5795        Mutt-ng requests these header fields in addition to the default headers (``DATE
5796        FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-
5797        REPLY-TO REPLY-TO LINES X-LABEL'') from IMAP servers before displaying the
5798        ``index'' menu. You may want to add more headers for spam detection.
5799
5800        N\bNo\bot\bte\be:\b: This is a space separated list.
5801
5802        _\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
5803
5804        Type: string
5805
5806        Default: ''
5807
5808        Availability: IMAP
5809
5810        You normally want to see your personal folders alongside your INBOX in the IMAP
5811        browser. If you see something else, you may set this variable to the IMAP path
5812        to your folders.
5813
5814        _\b7_\b._\b4_\b._\b1_\b0_\b2  _\bi_\bm_\ba_\bp_\b__\bk_\be_\be_\bp_\ba_\bl_\bi_\bv_\be
5815
5816        Type: number
5817
5818        Default: 900
5819
5820        Availability: IMAP
5821
5822        This variable specifies the maximum amount of time in seconds that Mutt-ng will
5823        wait before polling open IMAP connections, to prevent the server from closing
5824        them before Mutt-ng has finished with them.
5825
5826        The Mutt Next Generation E-Mail Client                                      113
5827
5828        The default is well within the RFC-specified minimum amount of time (30 min-
5829        utes) before a server is allowed to do this, but in practice the RFC does get
5830        violated every now and then.
5831
5832        Reduce this number if you find yourself getting disconnected from your IMAP
5833        server due to inactivity.
5834
5835        _\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
5836
5837        Type: boolean
5838
5839        Default: no
5840
5841        Availability: IMAP
5842
5843        This variable configures whether IMAP folder browsing will look for only sub-
5844        scribed folders or all folders.  This can be toggled in the IMAP browser with
5845        the _\bt_\bo_\bg_\bg_\bl_\be_\b-_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd function.
5846
5847        _\b7_\b._\b4_\b._\b1_\b0_\b4  _\bi_\bm_\ba_\bp_\b__\bl_\bo_\bg_\bi_\bn
5848
5849        Type: string
5850
5851        Default: ''
5852
5853        Availability: IMAP
5854
5855        Your login name on the IMAP server.
5856
5857        This variable defaults to the value of ``_\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.111  , page
5858        114).''
5859
5860        _\b7_\b._\b4_\b._\b1_\b0_\b5  _\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5861
5862        Type: number
5863
5864        Default: 300
5865
5866        This variable configures how often (in seconds) Mutt-ng should look for new
5867        mail in IMAP folders. This is split from the ``_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.121  ,
5868        page 119)'' variable to generate less traffic and get more accurate information
5869        for local folders.
5870
5871        _\b7_\b._\b4_\b._\b1_\b0_\b6  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs
5872
5873        Type: string
5874
5875        Default: ''
5876
5877        Availability: IMAP
5878
5879        Specifies the password for your IMAP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt
5880        you for your password when you invoke the fetch-mail function.
5881
5882        The Mutt Next Generation E-Mail Client                                      114
5883
5884        W\bWa\bar\brn\bni\bin\bng\bg: you should only use this option when you are on a fairly secure
5885        machine, because the superuser can read your configuration even if you are the
5886        only one who can read the file.
5887
5888        _\b7_\b._\b4_\b._\b1_\b0_\b7  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs_\bi_\bv_\be
5889
5890        Type: boolean
5891
5892        Default: yes
5893
5894        Availability: IMAP
5895
5896        When _\bs_\be_\bt, Mutt-ng will not open new IMAP connections to check for new mail.
5897        Mutt-ng will only check for new mail over existing IMAP connections.  This is
5898        useful if you don't want to be prompted to user/password pairs on Mutt-ng invo-
5899        cation, or if opening the connection is slow.
5900
5901        _\b7_\b._\b4_\b._\b1_\b0_\b8  _\bi_\bm_\ba_\bp_\b__\bp_\be_\be_\bk
5902
5903        Type: boolean
5904
5905        Default: yes
5906
5907        Availability: IMAP
5908
5909        If _\bs_\be_\bt, Mutt-ng will avoid implicitly marking your mail as read whenever you
5910        fetch a message from the server. This is generally a good thing, but can make
5911        closing an IMAP folder somewhat slower. This option exists to appease speed
5912        freaks.
5913
5914        _\b7_\b._\b4_\b._\b1_\b0_\b9  _\bi_\bm_\ba_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
5915
5916        Type: quadoption
5917
5918        Default: ask-yes
5919
5920        Availability: IMAP
5921
5922        Controls whether or not Mutt-ng will try to reconnect to IMAP server when the
5923        connection is lost.
5924
5925        _\b7_\b._\b4_\b._\b1_\b1_\b0  _\bi_\bm_\ba_\bp_\b__\bs_\be_\br_\bv_\be_\br_\bn_\bo_\bi_\bs_\be
5926
5927        Type: boolean
5928
5929        Default: yes
5930
5931        Availability: IMAP
5932
5933        When _\bs_\be_\bt, Mutt-ng will display warning messages from the IMAP server as error
5934        messages. Since these messages are often harmless, or generated due to configu-
5935        ration problems on the server which are out of the users' hands, you may wish
5936        to suppress them at some point.
5937
5938        The Mutt Next Generation E-Mail Client                                      115
5939
5940        _\b7_\b._\b4_\b._\b1_\b1_\b1  _\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br
5941
5942        Type: string
5943
5944        Default: ''
5945
5946        Availability: IMAP
5947
5948        The name of the user whose mail you intend to access on the IMAP server.
5949
5950        This variable defaults to your user name on the local machine.
5951
5952        _\b7_\b._\b4_\b._\b1_\b1_\b2  _\bi_\bm_\bp_\bl_\bi_\bc_\bi_\bt_\b__\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw
5953
5954        Type: boolean
5955
5956        Default: no
5957
5958        If _\bs_\be_\bt, Mutt-ng will look for a mailcap entry with the ``copiousoutput'' flag
5959        set for _\be_\bv_\be_\br_\by MIME attachment it doesn't have an internal viewer defined for.
5960        If such an entry is found, Mutt-ng will use the viewer defined in that entry to
5961        convert the body part to text form.
5962
5963        _\b7_\b._\b4_\b._\b1_\b1_\b3  _\bi_\bn_\bc_\bl_\bu_\bd_\be
5964
5965        Type: quadoption
5966
5967        Default: ask-yes
5968
5969        Controls whether or not a copy of the message(s) you are replying to is
5970        included in your reply.
5971
5972        _\b7_\b._\b4_\b._\b1_\b1_\b4  _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b__\bo_\bn_\bl_\by_\bf_\bi_\br_\bs_\bt
5973
5974        Type: boolean
5975
5976        Default: no
5977
5978        Controls whether or not Mutt-ng includes only the first attachment of the mes-
5979        sage you are replying.
5980
5981        _\b7_\b._\b4_\b._\b1_\b1_\b5  _\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
5982
5983        Type: string
5984
5985        Default: '> '
5986
5987        Specifies the string to prepend to each line of text quoted in a message to
5988        which you are replying.  You are strongly encouraged not to change this value,
5989        as it tends to agitate the more fanatical netizens.
5990
5991        _\b7_\b._\b4_\b._\b1_\b1_\b6  _\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
5992
5993        Type: string
5994
5995        The Mutt Next Generation E-Mail Client                                      116
5996
5997        Default: '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
5998
5999        This variable allows you to customize the message index display to your per-
6000        sonal taste.
6001
6002        ``Format strings'' are similar to the strings used in the ``C'' function
6003        printf(3) to format output (see the man page for more detail).  The following
6004        sequences are defined in Mutt-ng:
6005
6006              %a
6007                    address of the author
6008
6009              %A
6010                    reply-to address (if present; otherwise: address of author)
6011
6012              %b
6013                    filename of the original message folder (think mailBox)
6014
6015              %B
6016                    the list to which the letter was sent, or else the folder name
6017                    (%b).
6018
6019              %c
6020                    number of characters (bytes) in the message
6021
6022              %C
6023                    current message number
6024
6025              %d
6026                    date and time of the message in the format specified by ``date_for-
6027                    mat'' converted to sender's time zone
6028
6029              %D
6030                    date and time of the message in the format specified by ``date_for-
6031                    mat'' converted to the local time zone
6032
6033              %e
6034                    current message number in thread
6035
6036              %E
6037                    number of messages in current thread
6038
6039              %f
6040                    entire From: line (address + real name)
6041
6042              %F
6043                    author name, or recipient name if the message is from you
6044
6045              %H
6046                    spam attribute(s) of this message
6047
6048              %g
6049                    newsgroup name (if compiled with nntp support)
6050
6051        The Mutt Next Generation E-Mail Client                                      117
6052
6053              %i
6054                    message-id of the current message
6055
6056              %l
6057                    number of lines in the message (does not work with maildir, mh, and
6058                    possibly IMAP folders)
6059
6060              %L
6061                    If an address in the To or CC header field matches an address
6062                    defined by the users ``subscribe'' command, this displays 'To
6063                    <list-name>', otherwise the same as %F.
6064
6065              %m
6066                    total number of message in the mailbox
6067
6068              %M
6069                    number of hidden messages if the thread is collapsed.
6070
6071              %N
6072                    message score
6073
6074              %n
6075                    author's real name (or address if missing)
6076
6077              %O
6078                    (_O_riginal save folder)  Where Mutt-ng would formerly have stashed
6079                    the message: list name or recipient name if no list
6080
6081              %s
6082                    subject of the message
6083
6084              %S
6085                    status of the message (N/D/d/!/r/*)
6086
6087              %t
6088                    `to:' field (recipients)
6089
6090              %T
6091                    the appropriate character from the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.336  ,
6092                    page 171) string
6093
6094              %u
6095                    user (login) name of the author
6096
6097              %v
6098                    first name of the author, or the recipient if the message is from
6099                    you
6100
6101              %W
6102                    name of organization of author (`organization:' field)
6103
6104              %y
6105                    `x-label:' field, if present
6106
6107        The Mutt Next Generation E-Mail Client                                      118
6108
6109              %Y
6110                    `x-label' field, if present, and (1) not at part of a thread tree,
6111                    (2) at the top of a thread, or (3) `x-label' is different from pre-
6112                    ceding message's `x-label'.
6113
6114              %Z
6115                    message status flags
6116
6117              %{fmt}
6118                    the date and time of the message is converted to sender's time
6119                    zone, and ``fmt'' is expanded by the library function ``strftime'';
6120                    a leading bang disables locales
6121
6122              %[fmt]
6123                    the date and time of the message is converted to the local time
6124                    zone, and ``fmt'' is expanded by the library function ``strftime'';
6125                    a leading bang disables locales
6126
6127              %(fmt)
6128                    the local date and time when the message was received.  ``fmt'' is
6129                    expanded by the library function ``strftime''; a leading bang dis-
6130                    ables locales
6131
6132              %<fmt>
6133                    the current local time. ``fmt'' is expanded by the library function
6134                    ``strftime''; a leading bang disables locales.
6135
6136              %>X
6137                    right justify the rest of the string and pad with character 'X'
6138
6139              %|X
6140                    pad to the end of the line with character 'X'
6141
6142        See also: ``_\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.336  , page 171)''.
6143
6144        _\b7_\b._\b4_\b._\b1_\b1_\b7  _\bi_\bs_\bp_\be_\bl_\bl
6145
6146        Type: path
6147
6148        Default: 'ispell'
6149
6150        How to invoke ispell (GNU's spell-checking software).
6151
6152        _\b7_\b._\b4_\b._\b1_\b1_\b8  _\bk_\be_\be_\bp_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
6153
6154        Type: boolean
6155
6156        Default: no
6157
6158        If _\bs_\be_\bt, read messages marked as flagged will not be moved from your spool mail-
6159        box to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.131  , page 121)'' mailbox, or as a result of
6160        a ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 37)'' command.
6161
6162        The Mutt Next Generation E-Mail Client                                      119
6163
6164        _\b7_\b._\b4_\b._\b1_\b1_\b9  _\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by
6165
6166        Type: quadoption
6167
6168        Default: no
6169
6170        When _\bs_\be_\bt, address replies to the mailing list the original message came from
6171        (instead to the author only). Setting this option to ``_\ba_\bs_\bk_\b-_\by_\be_\bs'' or ``_\ba_\bs_\bk_\b-_\bn_\bo''
6172        will ask if you really intended to reply to the author only.
6173
6174        _\b7_\b._\b4_\b._\b1_\b2_\b0  _\bl_\bo_\bc_\ba_\bl_\be
6175
6176        Type: string
6177
6178        Default: 'C'
6179
6180        The locale used by strftime(3) to format dates. Legal values are the strings
6181        your system accepts for the locale variable LC_TIME.
6182
6183        _\b7_\b._\b4_\b._\b1_\b2_\b1  _\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6184
6185        Type: number
6186
6187        Default: 5
6188
6189        This variable configures how often (in seconds) Mutt-ng should look for new
6190        mail.
6191
6192        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
6193        7.4.105  , page 113).
6194
6195        _\b7_\b._\b4_\b._\b1_\b2_\b2  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh
6196
6197        Type: string
6198
6199        Default: ''
6200
6201        This variable specifies which files to consult when attempting to display MIME
6202        bodies not directly supported by Mutt-ng.
6203
6204        _\b7_\b._\b4_\b._\b1_\b2_\b3  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be
6205
6206        Type: boolean
6207
6208        Default: yes
6209
6210        If _\bs_\be_\bt, Mutt-ng will restrict possible characters in mailcap % expandos to a
6211        well-defined set of safe characters.  This is the safe setting, but we are not
6212        sure it doesn't break some more advanced MIME stuff.
6213
6214        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!
6215
6216        _\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
6217
6218        The Mutt Next Generation E-Mail Client                                      120
6219
6220        Type: boolean
6221
6222        Default: yes
6223
6224        Availability: Header Cache
6225
6226        Check for Maildir unaware programs other than Mutt-ng having modified maildir
6227        files when the header cache is in use. This incurs one stat(2) per message
6228        every time the folder is opened.
6229
6230        _\b7_\b._\b4_\b._\b1_\b2_\b5  _\bm_\ba_\bi_\bl_\bd_\bi_\br_\b__\bt_\br_\ba_\bs_\bh
6231
6232        Type: boolean
6233
6234        Default: no
6235
6236        If _\bs_\be_\bt, messages marked as deleted will be saved with the maildir (T)rashed
6237        flag instead of physically deleted.
6238
6239        N\bNO\bOT\bTE\bE:\b: this only applies to maildir-style mailboxes. Setting it will have no
6240        effect on other mailbox types.
6241
6242        It is similiar to the trash option.
6243
6244        _\b7_\b._\b4_\b._\b1_\b2_\b6  _\bm_\ba_\br_\bk_\b__\bo_\bl_\bd
6245
6246        Type: boolean
6247
6248        Default: yes
6249
6250        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
6251        mailbox without reading them.
6252
6253        With this option _\bs_\be_\bt, the next time you start Mutt-ng, the messages will show
6254        up with an 'O' next to them in the ``index'' menu, indicating that they are
6255        old.
6256
6257        _\b7_\b._\b4_\b._\b1_\b2_\b7  _\bm_\ba_\br_\bk_\be_\br_\bs
6258
6259        Type: boolean
6260
6261        Default: yes
6262
6263        Controls the display of wrapped lines in the internal pager. If set, a ``+''
6264        marker is displayed at the beginning of wrapped lines. Also see the
6265        ``_\b$_\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp (section 7.4.276  , page 155)'' variable.
6266
6267        _\b7_\b._\b4_\b._\b1_\b2_\b8  _\bm_\ba_\bs_\bk
6268
6269        Type: regular expression
6270
6271        Default: '!^\.[^.]'
6272
6273        A regular expression used in the file browser, optionally preceded by the _\bn_\bo_\bt
6274
6275        The Mutt Next Generation E-Mail Client                                      121
6276
6277        operator ``!''.  Only files whose names match this mask will be shown. The
6278        match is always case-sensitive.
6279
6280        _\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
6281
6282        Type: number
6283
6284        Default: 0
6285
6286        When set non-zero, this specifies the maximum number of recipient header lines
6287        (To:, Cc: and Bcc:) to display in the pager if header weeding is turned on. In
6288        case the number of lines exeeds its value, the last line will have 3 dots
6289        appended.
6290
6291        _\b7_\b._\b4_\b._\b1_\b3_\b0  _\bm_\ba_\bx_\b__\bl_\bi_\bn_\be_\b__\bl_\be_\bn_\bg_\bt_\bh
6292
6293        Type: number
6294
6295        Default: 0
6296
6297        When _\bs_\be_\bt, the maximum line length for displaying ``format = flowed'' messages
6298        is limited to this length. A value of 0 (which is also the default) means that
6299        the maximum line length is determined by the terminal width and _\b$_\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
6300        (section 7.4.350  , page 174).
6301
6302        _\b7_\b._\b4_\b._\b1_\b3_\b1  _\bm_\bb_\bo_\bx
6303
6304        Type: path
6305
6306        Default: '~/mbox'
6307
6308        This specifies the folder into which read mail in your ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
6309        7.4.310  , page 163)'' folder will be appended.
6310
6311        _\b7_\b._\b4_\b._\b1_\b3_\b2  _\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be
6312
6313        Type: folder magic
6314
6315        Default: mbox
6316
6317        The default mailbox type used when creating new folders. May be any of mbox,
6318        MMDF, MH and Maildir.
6319
6320        _\b7_\b._\b4_\b._\b1_\b3_\b3  _\bm_\be_\bn_\bu_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6321
6322        Type: number
6323
6324        Default: 0
6325
6326        This variable controls the number of lines of context that are given when
6327        scrolling through menus. (Similar to ``_\b$_\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.180  , page
6328        133)''.)
6329
6330        The Mutt Next Generation E-Mail Client                                      122
6331
6332        _\b7_\b._\b4_\b._\b1_\b3_\b4  _\bm_\be_\bn_\bu_\b__\bm_\bo_\bv_\be_\b__\bo_\bf_\bf
6333
6334        Type: boolean
6335
6336        Default: yes
6337
6338        When _\bu_\bn_\bs_\be_\bt, the bottom entry of menus will never scroll up past the bottom of
6339        the screen, unless there are less entries than lines.  When _\bs_\be_\bt, the bottom
6340        entry may move off the bottom.
6341
6342        _\b7_\b._\b4_\b._\b1_\b3_\b5  _\bm_\be_\bn_\bu_\b__\bs_\bc_\br_\bo_\bl_\bl
6343
6344        Type: boolean
6345
6346        Default: no
6347
6348        When _\bs_\be_\bt, menus will be scrolled up or down one line when you attempt to move
6349        across a screen boundary.  If _\bu_\bn_\bs_\be_\bt, the screen is cleared and the next or pre-
6350        vious page of the menu is displayed (useful for slow links to avoid many
6351        redraws).
6352
6353        _\b7_\b._\b4_\b._\b1_\b3_\b6  _\bm_\be_\bs_\bs_\ba_\bg_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
6354
6355        Type: string
6356
6357        Default: '%s'
6358
6359        This is the string displayed in the ``attachment'' menu for attachments of type
6360        message/rfc822.  For a full listing of defined printf(3)-like sequences see the
6361        section on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''.
6362
6363        _\b7_\b._\b4_\b._\b1_\b3_\b7  _\bm_\be_\bt_\ba_\b__\bk_\be_\by
6364
6365        Type: boolean
6366
6367        Default: no
6368
6369        If _\bs_\be_\bt, forces Mutt-ng to interpret keystrokes with the high bit (bit 8) set as
6370        if the user had pressed the ESC key and whatever key remains after having the
6371        high bit removed.  For example, if the key pressed has an ASCII value of 0xf4,
6372        then this is treated as if the user had pressed ESC then ``x''.  This is
6373        because the result of removing the high bit from ``0xf4'' is ``0x74'', which is
6374        the ASCII character ``x''.
6375
6376        _\b7_\b._\b4_\b._\b1_\b3_\b8  _\bm_\be_\bt_\bo_\bo
6377
6378        Type: boolean
6379
6380        Default: no
6381
6382        If _\bu_\bn_\bs_\be_\bt, Mutt-ng will remove your address (see the ``alternates'' command)
6383        from the list of recipients when replying to a message.
6384
6385        The Mutt Next Generation E-Mail Client                                      123
6386
6387        _\b7_\b._\b4_\b._\b1_\b3_\b9  _\bm_\bh_\b__\bp_\bu_\br_\bg_\be
6388
6389        Type: boolean
6390
6391        Default: no
6392
6393        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will mimic mh's behaviour and rename deleted messages to
6394        _\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-
6395        able is set, the message files will simply be deleted.
6396
6397        _\b7_\b._\b4_\b._\b1_\b4_\b0  _\bm_\bh_\b__\bs_\be_\bq_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
6398
6399        Type: string
6400
6401        Default: 'flagged'
6402
6403        The name of the MH sequence used for flagged messages.
6404
6405        _\b7_\b._\b4_\b._\b1_\b4_\b1  _\bm_\bh_\b__\bs_\be_\bq_\b__\br_\be_\bp_\bl_\bi_\be_\bd
6406
6407        Type: string
6408
6409        Default: 'replied'
6410
6411        The name of the MH sequence used to tag replied messages.
6412
6413        _\b7_\b._\b4_\b._\b1_\b4_\b2  _\bm_\bh_\b__\bs_\be_\bq_\b__\bu_\bn_\bs_\be_\be_\bn
6414
6415        Type: string
6416
6417        Default: 'unseen'
6418
6419        The name of the MH sequence used for unseen messages.
6420
6421        _\b7_\b._\b4_\b._\b1_\b4_\b3  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd
6422
6423        Type: quadoption
6424
6425        Default: no
6426
6427        When _\bs_\be_\bt, the message you are forwarding will be attached as a separate MIME
6428        part instead of included in the main body of the message.
6429
6430        This is useful for forwarding MIME messages so the receiver can properly view
6431        the message as it was delivered to you. If you like to switch between MIME and
6432        not MIME from mail to mail, set this variable to ask-no or ask-yes.
6433
6434        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-
6435        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.144  , page 123)''.
6436
6437        _\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
6438
6439        Type: boolean
6440
6441        The Mutt Next Generation E-Mail Client                                      124
6442
6443        Default: no
6444
6445        Controls the decoding of complex MIME messages into text/plain when forwarding
6446        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-
6447        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.
6448
6449        _\b7_\b._\b4_\b._\b1_\b4_\b5  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\br_\be_\bs_\bt
6450
6451        Type: quadoption
6452
6453        Default: yes
6454
6455        When forwarding multiple attachments of a MIME message from the recvattach
6456        menu, attachments which cannot be decoded in a reasonable manner will be
6457        attached to the newly composed message if this option is set.
6458
6459        _\b7_\b._\b4_\b._\b1_\b4_\b6  _\bm_\bi_\bx_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
6460
6461        Type: string
6462
6463        Default: '%4n %c %-16s %a'
6464
6465        Availability: Mixmaster
6466
6467        This variable describes the format of a remailer line on the mixmaster chain
6468        selection screen.  The following printf(3)-like sequences are supported:
6469
6470              %n
6471                    The running number on the menu.
6472
6473              %c
6474                    Remailer capabilities.
6475
6476              %s
6477                    The remailer's short name.
6478
6479              %a
6480                    The remailer's e-mail address.
6481
6482        _\b7_\b._\b4_\b._\b1_\b4_\b7  _\bm_\bi_\bx_\bm_\ba_\bs_\bt_\be_\br
6483
6484        Type: path
6485
6486        Default: 'mixmaster'
6487
6488        Availability: Mixmaster
6489
6490        This variable contains the path to the Mixmaster binary on your system.  It is
6491        used with various sets of parameters to gather the list of known remailers, and
6492        to finally send a message through the mixmaster chain.
6493
6494        _\b7_\b._\b4_\b._\b1_\b4_\b8  _\bm_\bo_\bv_\be
6495
6496        Type: quadoption
6497
6498        The Mutt Next Generation E-Mail Client                                      125
6499
6500        Default: ask-no
6501
6502        Controls whether or not Mutt-ng will move read messages from your spool mailbox
6503        to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.131  , page 121)'' mailbox, or as a result of a
6504        ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.14  , page 37)'' command.
6505
6506        _\b7_\b._\b4_\b._\b1_\b4_\b9  _\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
6507
6508        Type: string
6509
6510        Default: '%Y%m%d%h%M%s.G%P%p'
6511
6512        This is the format for the ``local part'' of the Message-Id: header field gen-
6513        erated by Mutt-ng. If this variable is empty, no Message-Id: headers will be
6514        generated. The '%' character marks that certain data will be added to the
6515        string, similar to printf(3). The following characters are allowed:
6516
6517              %d
6518                    the current day of month
6519
6520              %h
6521                    the current hour
6522
6523              %m
6524                    the current month
6525
6526              %M
6527                    the current minute
6528
6529              %O
6530                    the current UNIX timestamp (octal)
6531
6532              %p
6533                    the process ID
6534
6535              %P
6536                    the current Message-ID prefix (a character rotating with every Mes-
6537                    sage-ID being generated)
6538
6539              %r
6540                    a random integer value (decimal)
6541
6542              %R
6543                    a random integer value (hexadecimal)
6544
6545              %s
6546                    the current second
6547
6548              %T
6549                    the current UNIX timestamp (decimal)
6550
6551              %X
6552                    the current UNIX timestamp (hexadecimal)
6553
6554        The Mutt Next Generation E-Mail Client                                      126
6555
6556              %Y
6557                    the current year (Y2K compliant)
6558
6559              %%
6560                    the '%' character
6561
6562        N\bNo\bot\bte\be:\b: Please only change this setting if you know what you are doing.  Also
6563        make sure to consult RFC2822 to produce technically _\bv_\ba_\bl_\bi_\bd strings.
6564
6565        _\b7_\b._\b4_\b._\b1_\b5_\b0  _\bm_\bu_\bt_\bt_\bn_\bg_\b__\bb_\bi_\bn_\bd_\bi_\br
6566
6567        Type: system property
6568
6569        Value: /opt/freebsd4/mutt-ng/bin
6570
6571        _\bT_\bh_\bi_\bs _\bi_\bs _\ba _\br_\be_\ba_\bd_\b-_\bo_\bn_\bl_\by _\bs_\by_\bs_\bt_\be_\bm _\bp_\br_\bo_\bp_\be_\br_\bt_\by _\ba_\bn_\bd _\bs_\bp_\be_\bc_\bi_\bf_\bi_\be_\bs _\bt_\bh_\be _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by _\bc_\bo_\bn_\bt_\ba_\bi_\bn_\bi_\bn_\bg _\bt_\bh_\be
6572        _\bm_\bu_\bt_\bt_\bn_\bg _\bb_\bi_\bn_\ba_\br_\by_\b.
6573
6574        _\b7_\b._\b4_\b._\b1_\b5_\b1  _\bm_\bu_\bt_\bt_\bn_\bg_\b__\bd_\bo_\bc_\bd_\bi_\br
6575
6576        Type: system property
6577
6578        Value: /opt/freebsd4/mutt-ng/doc/muttng
6579
6580        _\bT_\bh_\bi_\bs _\bi_\bs _\ba _\br_\be_\ba_\bd_\b-_\bo_\bn_\bl_\by _\bs_\by_\bs_\bt_\be_\bm _\bp_\br_\bo_\bp_\be_\br_\bt_\by _\ba_\bn_\bd _\bs_\bp_\be_\bc_\bi_\bf_\bi_\be_\bs _\bt_\bh_\be _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by _\bc_\bo_\bn_\bt_\ba_\bi_\bn_\bi_\bn_\bg _\bt_\bh_\be
6581        _\bm_\bu_\bt_\bt_\bn_\bg _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt_\ba_\bt_\bi_\bo_\bn_\b.
6582
6583        _\b7_\b._\b4_\b._\b1_\b5_\b2  _\bm_\bu_\bt_\bt_\bn_\bg_\b__\bh_\bc_\ba_\bc_\bh_\be_\b__\bb_\ba_\bc_\bk_\be_\bn_\bd
6584
6585        Type: system property
6586
6587        Value: qdbm
6588
6589        _\bT_\bh_\bi_\bs _\bi_\bs _\ba _\br_\be_\ba_\bd_\b-_\bo_\bn_\bl_\by _\bs_\by_\bs_\bt_\be_\bm _\bp_\br_\bo_\bp_\be_\br_\bt_\by _\ba_\bn_\bd _\bs_\bp_\be_\bc_\bi_\bf_\bi_\be_\bs _\bt_\bh_\be _\bh_\be_\ba_\bd_\be_\br _\bc_\bh_\ba_\bc_\bh_\bi_\bn_\bg_\b'_\bs _\bd_\ba_\bt_\ba_\b-
6590        _\bb_\ba_\bs_\be _\bb_\ba_\bc_\bk_\be_\bn_\bd_\b.
6591
6592        _\b7_\b._\b4_\b._\b1_\b5_\b3  _\bm_\bu_\bt_\bt_\bn_\bg_\b__\br_\be_\bv_\bi_\bs_\bi_\bo_\bn
6593
6594        Type: system property
6595
6596        Value: 465
6597
6598        _\bT_\bh_\bi_\bs _\bi_\bs _\ba _\br_\be_\ba_\bd_\b-_\bo_\bn_\bl_\by _\bs_\by_\bs_\bt_\be_\bm _\bp_\br_\bo_\bp_\be_\br_\bt_\by _\ba_\bn_\bd _\bs_\bp_\be_\bc_\bi_\bf_\bi_\be_\bs _\bm_\bu_\bt_\bt_\bn_\bg_\b'_\bs _\bs_\bu_\bb_\bv_\be_\br_\bs_\bi_\bo_\bn _\br_\be_\bv_\bi_\bs_\bi_\bo_\bn
6599        _\bs_\bt_\br_\bi_\bn_\bg_\b.
6600
6601        _\b7_\b._\b4_\b._\b1_\b5_\b4  _\bm_\bu_\bt_\bt_\bn_\bg_\b__\bs_\by_\bs_\bc_\bo_\bn_\bf_\bd_\bi_\br
6602
6603        Type: system property
6604
6605        Value: /opt/freebsd4/mutt-ng/etc
6606
6607        _\bT_\bh_\bi_\bs _\bi_\bs _\ba _\br_\be_\ba_\bd_\b-_\bo_\bn_\bl_\by _\bs_\by_\bs_\bt_\be_\bm _\bp_\br_\bo_\bp_\be_\br_\bt_\by _\ba_\bn_\bd _\bs_\bp_\be_\bc_\bi_\bf_\bi_\be_\bs _\bt_\bh_\be _\bd_\bi_\br_\be_\bc_\bt_\bo_\br_\by _\bc_\bo_\bn_\bt_\ba_\bi_\bn_\bi_\bn_\bg _\bt_\bh_\be
6608        _\bm_\bu_\bt_\bt_\bn_\bg _\bs_\by_\bs_\bt_\be_\bm_\b-_\bw_\bi_\bd_\be _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn_\b.
6609
6610        The Mutt Next Generation E-Mail Client                                      127
6611
6612        _\b7_\b._\b4_\b._\b1_\b5_\b5  _\bm_\bu_\bt_\bt_\bn_\bg_\b__\bv_\be_\br_\bs_\bi_\bo_\bn
6613
6614        Type: system property
6615
6616        Value: devel
6617
6618        _\bT_\bh_\bi_\bs _\bi_\bs _\ba _\br_\be_\ba_\bd_\b-_\bo_\bn_\bl_\by _\bs_\by_\bs_\bt_\be_\bm _\bp_\br_\bo_\bp_\be_\br_\bt_\by _\ba_\bn_\bd _\bs_\bp_\be_\bc_\bi_\bf_\bi_\be_\bs _\bm_\bu_\bt_\bt_\bn_\bg_\b'_\bs _\bv_\be_\br_\bs_\bi_\bo_\bn _\bs_\bt_\br_\bi_\bn_\bg_\b.
6619
6620        _\b7_\b._\b4_\b._\b1_\b5_\b6  _\bn_\ba_\br_\br_\bo_\bw_\b__\bt_\br_\be_\be
6621
6622        Type: boolean
6623
6624        Default: no
6625
6626        This variable, when _\bs_\be_\bt, makes the thread tree narrower, allowing deeper
6627        threads to fit on the screen.
6628
6629        _\b7_\b._\b4_\b._\b1_\b5_\b7  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
6630
6631        Type: boolean
6632
6633        Default: no
6634
6635        Availability: NNTP
6636
6637        If _\bs_\be_\bt, Mutt-ng will prompt you for the Followup-To: header field before edit-
6638        ing the body of an outgoing news article.
6639
6640        _\b7_\b._\b4_\b._\b1_\b5_\b8  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6641
6642        Type: boolean
6643
6644        Default: no
6645
6646        Availability: NNTP
6647
6648        If _\bs_\be_\bt, Mutt-ng will prompt you for the X-Comment-To: header field before edit-
6649        ing the body of an outgoing news article.
6650
6651        _\b7_\b._\b4_\b._\b1_\b5_\b9  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br
6652
6653        Type: path
6654
6655        Default: '~/.muttng'
6656
6657        Availability: NNTP
6658
6659        This variable points to directory where Mutt-ng will cache news article head-
6660        ers. If _\bu_\bn_\bs_\be_\bt, headers will not be saved at all and will be reloaded each time
6661        when you enter a newsgroup.
6662
6663        As for the header caching in connection with IMAP and/or Maildir, this drasti-
6664        cally increases speed and lowers traffic.
6665
6666        The Mutt Next Generation E-Mail Client                                      128
6667
6668        _\b7_\b._\b4_\b._\b1_\b6_\b0  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bt_\bc_\bh_\bu_\bp
6669
6670        Type: quadoption
6671
6672        Default: ask-yes
6673
6674        Availability: NNTP
6675
6676        If this variable is _\bs_\be_\bt, Mutt-ng will mark all articles in a newsgroup as read
6677        when you leaving it.
6678
6679        _\b7_\b._\b4_\b._\b1_\b6_\b1  _\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6680
6681        Type: number
6682
6683        Default: 1000
6684
6685        Availability: NNTP
6686
6687        This variable controls how many news articles to cache per newsgroup (if
6688        caching is enabled, see _\b$_\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section 7.4.159  , page 127)) and how
6689        many news articles to show in the ``index'' menu.
6690
6691        If there're more articles than defined with _\b$_\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.161  ,
6692        page 128), all older ones will be removed/not shown in the index.
6693
6694        _\b7_\b._\b4_\b._\b1_\b6_\b2  _\bn_\bn_\bt_\bp_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo_\b__\bp_\bo_\bs_\bt_\be_\br
6695
6696        Type: quadoption
6697
6698        Default: ask-yes
6699
6700        Availability: NNTP
6701
6702        If this variable is _\bs_\be_\bt and the keyword 'poster' is present in the Followup-To:
6703        header field, a follow-up to the newsgroup is not permitted.  The message will
6704        be mailed to the submitter of the message via mail.
6705
6706        _\b7_\b._\b4_\b._\b1_\b6_\b3  _\bn_\bn_\bt_\bp_\b__\bg_\br_\bo_\bu_\bp_\b__\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
6707
6708        Type: string
6709
6710        Default: '%4C %M%N %5s  %-45.45f %d'
6711
6712        Availability: NNTP
6713
6714        This variable allows you to customize the newsgroup browser display to your
6715        personal taste.  This string is similar to ``_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  ,
6716        page 115)'', but has its own set of printf(3)-like sequences:
6717
6718        The Mutt Next Generation E-Mail Client                                      129
6719
6720             %C      current newsgroup number
6721             %d      description of newsgroup (retrieved from server)
6722             %f      newsgroup name
6723             %M      ``-'' if newsgroup not allowed for direct post (moderated for example)
6724             %N      ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
6725             %n      number of new articles in newsgroup
6726             %s      number of unread articles in newsgroup
6727             %>X     right justify the rest of the string and pad with character "X"
6728             %|X     pad to the end of the line with character "X"
6729
6730        _\b7_\b._\b4_\b._\b1_\b6_\b4  _\bn_\bn_\bt_\bp_\b__\bh_\bo_\bs_\bt
6731
6732        Type: string
6733
6734        Default: ''
6735
6736        Availability: NNTP
6737
6738        This variable specifies the name (or address) of the NNTP server to be used.
6739
6740        It defaults to the value specified via the environment variable $NNTPSERVER or
6741        contained in the file /etc/nntpserver.
6742
6743        You can also specify a username and an alternative port for each newsserver,
6744        e.g.
6745
6746        [nntp[s]://][username[:password]@]newsserver[:port]
6747
6748        N\bNo\bot\bte\be:\b: Using a password as shown and stored in a configuration file presents a
6749        security risk since the superuser of your machine may read it regardless of the
6750        file's permissions.
6751
6752        _\b7_\b._\b4_\b._\b1_\b6_\b5  _\bn_\bn_\bt_\bp_\b__\bi_\bn_\be_\bw_\bs
6753
6754        Type: path
6755
6756        Default: ''
6757
6758        Availability: NNTP
6759
6760        If _\bs_\be_\bt, specifies the program and arguments used to deliver news posted by
6761        Mutt-ng.  Otherwise, Mutt-ng posts article using current connection.  The fol-
6762        lowing printf(3)-style sequence is understood:
6763
6764             %s      newsserver name
6765
6766        Example: set inews='/usr/local/bin/inews -hS'
6767
6768        _\b7_\b._\b4_\b._\b1_\b6_\b6  _\bn_\bn_\bt_\bp_\b__\bl_\bo_\ba_\bd_\b__\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn
6769
6770        Type: boolean
6771
6772        The Mutt Next Generation E-Mail Client                                      130
6773
6774        Default: yes
6775
6776        Availability: NNTP
6777
6778        This variable controls whether or not descriptions for newsgroups are to be
6779        loaded when subscribing to a newsgroup.
6780
6781        _\b7_\b._\b4_\b._\b1_\b6_\b7  _\bn_\bn_\bt_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6782
6783        Type: number
6784
6785        Default: 60
6786
6787        Availability: NNTP
6788
6789        The time in seconds until any operations on a newsgroup except posting a new
6790        article will cause a recheck for new news. If set to 0, Mutt-ng will recheck on
6791        each operation in index (stepping, read article, etc.).
6792
6793        _\b7_\b._\b4_\b._\b1_\b6_\b8  _\bn_\bn_\bt_\bp_\b__\bm_\bi_\bm_\be_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
6794
6795        Type: boolean
6796
6797        Default: yes
6798
6799        Availability: NNTP
6800
6801        If _\bu_\bn_\bs_\be_\bt, an 8-bit ``Subject:'' header field in a news article will not be
6802        encoded according to RFC2047.
6803
6804        N\bNo\bot\bte\be:\b: Only change this setting if you know what you are doing.
6805
6806        _\b7_\b._\b4_\b._\b1_\b6_\b9  _\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc
6807
6808        Type: path
6809
6810        Default: '~/.newsrc'
6811
6812        Availability: NNTP
6813
6814        This file contains information about subscribed newsgroup and articles read so
6815        far.
6816
6817        To ease the use of multiple news servers, the following printf(3)-style
6818        sequence is understood:
6819
6820             %s      newsserver name
6821
6822        _\b7_\b._\b4_\b._\b1_\b7_\b0  _\bn_\bn_\bt_\bp_\b__\bp_\ba_\bs_\bs
6823
6824        Type: string
6825
6826        The Mutt Next Generation E-Mail Client                                      131
6827
6828        Default: ''
6829
6830        Availability: NNTP
6831
6832        Your password for NNTP account.
6833
6834        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
6835        the superuser of your machine may read it regardless of the file's permissions.
6836
6837        _\b7_\b._\b4_\b._\b1_\b7_\b1  _\bn_\bn_\bt_\bp_\b__\bp_\bo_\bs_\bt_\b__\bm_\bo_\bd_\be_\br_\ba_\bt_\be_\bd
6838
6839        Type: quadoption
6840
6841        Default: ask-yes
6842
6843        Availability: NNTP
6844
6845        If set to _\by_\be_\bs, Mutt-ng will post articles to newsgroup that have not permis-
6846        sions to post (e.g. moderated).
6847
6848        N\bNo\bot\bte\be:\b: if the newsserver does not support posting to that newsgroup or a group
6849        is totally read-only, that posting will not have any effect.
6850
6851        _\b7_\b._\b4_\b._\b1_\b7_\b2  _\bn_\bn_\bt_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
6852
6853        Type: quadoption
6854
6855        Default: ask-yes
6856
6857        Availability: NNTP
6858
6859        Controls whether or not Mutt-ng will try to reconnect to a newsserver when the
6860        was connection lost.
6861
6862        _\b7_\b._\b4_\b._\b1_\b7_\b3  _\bn_\bn_\bt_\bp_\b__\bs_\ba_\bv_\be_\b__\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
6863
6864        Type: boolean
6865
6866        Default: no
6867
6868        Availability: NNTP
6869
6870        When _\bs_\be_\bt, info about unsubscribed newsgroups will be saved into the ``newsrc''
6871        file and into the news cache.
6872
6873        _\b7_\b._\b4_\b._\b1_\b7_\b4  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bn_\be_\bw_\b__\bn_\be_\bw_\bs
6874
6875        Type: boolean
6876
6877        Default: yes
6878
6879        Availability: NNTP
6880
6881        If _\bs_\be_\bt, the newsserver will be asked for new newsgroups on entering the
6882
6883        The Mutt Next Generation E-Mail Client                                      132
6884
6885        browser.  Otherwise, it will be done only once for a newsserver.  Also controls
6886        whether or not the number of new articles of subscribed newsgroups will be
6887        checked.
6888
6889        _\b7_\b._\b4_\b._\b1_\b7_\b5  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bo_\bn_\bl_\by_\b__\bu_\bn_\br_\be_\ba_\bd
6890
6891        Type: boolean
6892
6893        Default: no
6894
6895        Availability: NNTP
6896
6897        If _\bs_\be_\bt, only subscribed newsgroups that contain unread articles will be dis-
6898        played in the newsgroup browser.
6899
6900        _\b7_\b._\b4_\b._\b1_\b7_\b6  _\bn_\bn_\bt_\bp_\b__\bu_\bs_\be_\br
6901
6902        Type: string
6903
6904        Default: ''
6905
6906        Availability: NNTP
6907
6908        Your login name on the NNTP server.  If _\bu_\bn_\bs_\be_\bt and the server requires authen-
6909        tification, Mutt-ng will prompt you for your account name.
6910
6911        _\b7_\b._\b4_\b._\b1_\b7_\b7  _\bn_\bn_\bt_\bp_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6912
6913        Type: boolean
6914
6915        Default: no
6916
6917        Availability: NNTP
6918
6919        If _\bs_\be_\bt, Mutt-ng will add a ``X-Comment-To:'' header field (that contains full
6920        name of the original article author) to articles that you followup to.
6921
6922        _\b7_\b._\b4_\b._\b1_\b7_\b8  _\bo_\bp_\be_\br_\ba_\bt_\bi_\bn_\bg_\b__\bs_\by_\bs_\bt_\be_\bm
6923
6924        Type: string
6925
6926        Default: ''
6927
6928        This specifies the operating system name for the User-Agent: header field. If
6929        this is _\bu_\bn_\bs_\be_\bt, it will be set to the operating system name that uname(2)
6930        returns. If uname(2) fails, ``UNIX'' will be used.
6931
6932        It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''.
6933
6934        _\b7_\b._\b4_\b._\b1_\b7_\b9  _\bp_\ba_\bg_\be_\br
6935
6936        Type: path
6937
6938        Default: 'builtin'
6939
6940        The Mutt Next Generation E-Mail Client                                      133
6941
6942        This variable specifies which pager you would like to use to view messages.
6943        ``builtin'' means to use the builtin pager, otherwise this variable should
6944        specify the pathname of the external pager you would like to use.
6945
6946        Using an external pager may have some disadvantages: Additional keystrokes are
6947        necessary because you can't call Mutt-ng functions directly from the pager, and
6948        screen resizes cause lines longer than the screen width to be badly formatted
6949        in the help menu.
6950
6951        _\b7_\b._\b4_\b._\b1_\b8_\b0  _\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6952
6953        Type: number
6954
6955        Default: 0
6956
6957        This variable controls the number of lines of context that are given when dis-
6958        playing the next or previous page in the internal pager.  By default, Mutt-ng
6959        will display the line after the last one on the screen at the top of the next
6960        page (0 lines of context).
6961
6962        _\b7_\b._\b4_\b._\b1_\b8_\b1  _\bp_\ba_\bg_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
6963
6964        Type: string
6965
6966        Default: '-%Z- %C/%m: %-20.20n   %s'
6967
6968        This variable controls the format of the one-line message ``status'' displayed
6969        before each message in either the internal or an external pager.  The valid
6970        sequences are listed in the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.116  , page 115)''
6971        section.
6972
6973        _\b7_\b._\b4_\b._\b1_\b8_\b2  _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs
6974
6975        Type: number
6976
6977        Default: 0
6978
6979        Determines the number of lines of a mini-index which is shown when in the
6980        pager.  The current message, unless near the top or bottom of the folder, will
6981        be roughly one third of the way down this mini-index, giving the reader the
6982        context of a few messages before and after the message.  This is useful, for
6983        example, to determine how many messages remain to be read in the current
6984        thread.  One of the lines is reserved for the status bar from the index, so a
6985        _\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
6986        0 results in no index being shown.  If the number of messages in the current
6987        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
6988        lines as it needs.
6989
6990        _\b7_\b._\b4_\b._\b1_\b8_\b3  _\bp_\ba_\bg_\be_\br_\b__\bs_\bt_\bo_\bp
6991
6992        Type: boolean
6993
6994        Default: no
6995
6996        The Mutt Next Generation E-Mail Client                                      134
6997
6998        When _\bs_\be_\bt, the internal-pager will n\bno\bot\bt move to the next message when you are at
6999        the end of a message and invoke the _\bn_\be_\bx_\bt_\b-_\bp_\ba_\bg_\be function.
7000
7001        _\b7_\b._\b4_\b._\b1_\b8_\b4  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\b__\bd_\be_\bc_\bo_\bd_\be
7002
7003        Type: boolean
7004
7005        Default: no
7006
7007        If _\bs_\be_\bt, Mutt-ng will automatically attempt to decrypt traditional PGP messages
7008        whenever the user performs an operation which ordinarily would result in the
7009        contents of the message being operated on.  For example, if the user displays a
7010        pgp-traditional message which has not been manually checked with the check-tra-
7011        ditional-pgp function, Mutt-ng will automatically check the message for tradi-
7012        tional pgp.
7013
7014        _\b7_\b._\b4_\b._\b1_\b8_\b5  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\bi_\bn_\bl_\bi_\bn_\be
7015
7016        Type: boolean
7017
7018        Default: no
7019
7020        This option controls whether Mutt-ng generates old-style inline (traditional)
7021        PGP encrypted or signed messages under certain circumstances.  This can be
7022        overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not required.
7023
7024        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
7025        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
7026        ing PGP/MIME messages when inline (traditional) would not work.  See also:
7027        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.201  , page 138)''.
7028
7029        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.
7030        (PGP only)
7031
7032        _\b7_\b._\b4_\b._\b1_\b8_\b6  _\bp_\bg_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\be_\bx_\bi_\bt
7033
7034        Type: boolean
7035
7036        Default: yes
7037
7038        If _\bs_\be_\bt, Mutt-ng will check the exit code of the PGP subprocess when signing or
7039        encrypting.  A non-zero exit code means that the subprocess failed.  (PGP only)
7040
7041        _\b7_\b._\b4_\b._\b1_\b8_\b7  _\bp_\bg_\bp_\b__\bc_\bl_\be_\ba_\br_\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7042
7043        Type: string
7044
7045        Default: ''
7046
7047        This format is used to create a old-style ``clearsigned'' PGP message.
7048
7049        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)
7050
7051        The Mutt Next Generation E-Mail Client                                      135
7052
7053        _\b7_\b._\b4_\b._\b1_\b8_\b8  _\bp_\bg_\bp_\b__\bd_\be_\bc_\bo_\bd_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7054
7055        Type: string
7056
7057        Default: ''
7058
7059        This format strings specifies a command which is used to decode application/pgp
7060        attachments.
7061
7062        The PGP command formats have their own set of printf(3)-like sequences:
7063
7064              %p
7065                    Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
7066                    string otherwise. Note: This may be used with a %? construct.
7067
7068              %f
7069                    Expands to the name of a file containing a message.
7070
7071              %s
7072                    Expands to the name of a file containing the signature part of a
7073                    multipart/signed attachment when verifying it.
7074
7075              %a
7076                    The value of _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 7.4.205  , page 139).
7077
7078              %r
7079                    One or more key IDs.
7080
7081        For examples on how to configure these formats for the various versions of PGP
7082        which are floating around, see the pgp*.rc and gpg.rc files in the samples/
7083        subdirectory which has been installed on your system alongside the documenta-
7084        tion.  (PGP only)
7085
7086        _\b7_\b._\b4_\b._\b1_\b8_\b9  _\bp_\bg_\bp_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7087
7088        Type: string
7089
7090        Default: ''
7091
7092        This command is used to decrypt a PGP encrypted message.  (PGP only)
7093
7094        _\b7_\b._\b4_\b._\b1_\b9_\b0  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bo_\bn_\bl_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7095
7096        Type: string
7097
7098        Default: ''
7099
7100        This command is used to encrypt a body part without signing it.  (PGP only)
7101
7102        _\b7_\b._\b4_\b._\b1_\b9_\b1  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7103
7104        Type: string
7105
7106        Default: ''
7107
7108        The Mutt Next Generation E-Mail Client                                      136
7109
7110        This command is used to both sign and encrypt a body part.  (PGP only)
7111
7112        _\b7_\b._\b4_\b._\b1_\b9_\b2  _\bp_\bg_\bp_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
7113
7114        Type: string
7115
7116        Default: '%4n %t%f %4l/0x%k %-4a %2c %u'
7117
7118        This variable allows you to customize the PGP key selection menu to your per-
7119        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
7120        115)'', but has its own set of printf(3)-like sequences:
7121
7122              %n
7123                    number
7124
7125              %k
7126                    key id
7127
7128              %u
7129                    user id
7130
7131              %a
7132                    algorithm
7133
7134              %l
7135                    key length
7136
7137              %f
7138                    flags
7139
7140              %c
7141                    capabilities
7142
7143              %t
7144                    trust/validity of the key-uid association
7145
7146              %[<s>]
7147                    date of the key where <s> is an strftime(3) expression
7148
7149        (PGP only)
7150
7151        _\b7_\b._\b4_\b._\b1_\b9_\b3  _\bp_\bg_\bp_\b__\be_\bx_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7152
7153        Type: string
7154
7155        Default: ''
7156
7157        This command is used to export a public key from the user's key ring.  (PGP
7158        only)
7159
7160        _\b7_\b._\b4_\b._\b1_\b9_\b4  _\bp_\bg_\bp_\b__\bg_\be_\bt_\bk_\be_\by_\bs_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7161
7162        Type: string
7163
7164        The Mutt Next Generation E-Mail Client                                      137
7165
7166        Default: ''
7167
7168        This command is invoked whenever Mutt-ng will need public key information.  %r
7169        is the only printf(3)-like sequence used with this format.  (PGP only)
7170
7171        _\b7_\b._\b4_\b._\b1_\b9_\b5  _\bp_\bg_\bp_\b__\bg_\bo_\bo_\bd_\b__\bs_\bi_\bg_\bn
7172
7173        Type: regular expression
7174
7175        Default: ''
7176
7177        If you assign a text to this variable, then a PGP signature is only considered
7178        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.211  , page 140)
7179        contains the text. Use this variable if the exit code from the command is 0
7180        even for bad signatures.  (PGP only)
7181
7182        _\b7_\b._\b4_\b._\b1_\b9_\b6  _\bp_\bg_\bp_\b__\bi_\bg_\bn_\bo_\br_\be_\b__\bs_\bu_\bb_\bk_\be_\by_\bs
7183
7184        Type: boolean
7185
7186        Default: yes
7187
7188        Setting this variable will cause Mutt-ng to ignore OpenPGP subkeys. Instead,
7189        the principal key will inherit the subkeys' capabilities. _\bU_\bn_\bs_\be_\bt this if you
7190        want to play interesting key selection games.  (PGP only)
7191
7192        _\b7_\b._\b4_\b._\b1_\b9_\b7  _\bp_\bg_\bp_\b__\bi_\bm_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7193
7194        Type: string
7195
7196        Default: ''
7197
7198        This command is used to import a key from a message into the user's public key
7199        ring.  (PGP only)
7200
7201        _\b7_\b._\b4_\b._\b1_\b9_\b8  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bp_\bu_\bb_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7202
7203        Type: string
7204
7205        Default: ''
7206
7207        This command is used to list the public key ring's contents.  The output format
7208        must be analogous to the one used by gpg --list-keys --with-colons.
7209
7210        This format is also generated by the pgpring utility which comes with Mutt-ng.
7211        (PGP only)
7212
7213        _\b7_\b._\b4_\b._\b1_\b9_\b9  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\be_\bc_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7214
7215        Type: string
7216
7217        Default: ''
7218
7219        This command is used to list the secret key ring's contents.  The output format
7220
7221        The Mutt Next Generation E-Mail Client                                      138
7222
7223        must be analogous to the one used by gpg --list-keys --with-colons.
7224
7225        This format is also generated by the pgpring utility which comes with Mutt-ng.
7226        (PGP only)
7227
7228        _\b7_\b._\b4_\b._\b2_\b0_\b0  _\bp_\bg_\bp_\b__\bl_\bo_\bn_\bg_\b__\bi_\bd_\bs
7229
7230        Type: boolean
7231
7232        Default: no
7233
7234        If _\bs_\be_\bt, use 64 bit PGP key IDs. _\bU_\bn_\bs_\be_\bt uses the normal 32 bit Key IDs.  (PGP
7235        only)
7236
7237        _\b7_\b._\b4_\b._\b2_\b0_\b1  _\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo
7238
7239        Type: quadoption
7240
7241        Default: ask-yes
7242
7243        This option controls whether Mutt-ng will prompt you for automatically sending
7244        a (signed/encrypted) message using PGP/MIME when inline (traditional) fails
7245        (for any reason).
7246
7247        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.
7248        (PGP only)
7249
7250        _\b7_\b._\b4_\b._\b2_\b0_\b2  _\bp_\bg_\bp_\b__\br_\be_\bp_\bl_\by_\bi_\bn_\bl_\bi_\bn_\be
7251
7252        Type: boolean
7253
7254        Default: no
7255
7256        Setting this variable will cause Mutt-ng to always attempt to create an inline
7257        (traditional) message when replying to a message which is PGP encrypted/signed
7258        inline.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not
7259        required.  This option does not automatically detect if the (replied-to) mes-
7260        sage is inline; instead it relies on Mutt-ng internals for previously
7261        checked/flagged messages.
7262
7263        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
7264        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
7265        ing PGP/MIME messages when inline (traditional) would not work.  See also:
7266        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.201  , page 138)''.
7267
7268        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.
7269        (PGP only)
7270
7271        _\b7_\b._\b4_\b._\b2_\b0_\b3  _\bp_\bg_\bp_\b__\br_\be_\bt_\ba_\bi_\bn_\ba_\bb_\bl_\be_\b__\bs_\bi_\bg_\bs
7272
7273        Type: boolean
7274
7275        Default: no
7276
7277        The Mutt Next Generation E-Mail Client                                      139
7278
7279        If _\bs_\be_\bt, signed and encrypted messages will consist of nested multipart/signed
7280        and multipart/encrypted body parts.
7281
7282        This is useful for applications like encrypted and signed mailing lists, where
7283        the outer layer (multipart/encrypted) can be easily removed, while the inner
7284        multipart/signed part is retained.  (PGP only)
7285
7286        _\b7_\b._\b4_\b._\b2_\b0_\b4  _\bp_\bg_\bp_\b__\bs_\bh_\bo_\bw_\b__\bu_\bn_\bu_\bs_\ba_\bb_\bl_\be
7287
7288        Type: boolean
7289
7290        Default: yes
7291
7292        If _\bs_\be_\bt, Mutt-ng will display non-usable keys on the PGP key selection menu.
7293        This includes keys which have been revoked, have expired, or have been marked
7294        as ``disabled'' by the user.  (PGP only)
7295
7296        _\b7_\b._\b4_\b._\b2_\b0_\b5  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs
7297
7298        Type: string
7299
7300        Default: ''
7301
7302        If you have more than one key pair, this option allows you to specify which of
7303        your private keys to use.  It is recommended that you use the keyid form to
7304        specify your key (e.g., ``0x00112233'').  (PGP only)
7305
7306        _\b7_\b._\b4_\b._\b2_\b0_\b6  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7307
7308        Type: string
7309
7310        Default: ''
7311
7312        This command is used to create the detached PGP signature for a multi-
7313        part/signed PGP/MIME body part.  (PGP only)
7314
7315        _\b7_\b._\b4_\b._\b2_\b0_\b7  _\bp_\bg_\bp_\b__\bs_\bo_\br_\bt_\b__\bk_\be_\by_\bs
7316
7317        Type: sort order
7318
7319        Default: address
7320
7321        Specifies how the entries in the ``pgp keys'' menu are sorted. The following
7322        are legal values:
7323
7324              address
7325                    sort alphabetically by user id
7326
7327              keyid
7328                    sort alphabetically by key id
7329
7330              date
7331                    sort by key creation date
7332
7333        The Mutt Next Generation E-Mail Client                                      140
7334
7335              trust
7336                    sort by the trust of the key
7337
7338        If you prefer reverse order of the above values, prefix it with ``reverse-''.
7339        (PGP only)
7340
7341        _\b7_\b._\b4_\b._\b2_\b0_\b8  _\bp_\bg_\bp_\b__\bs_\bt_\br_\bi_\bc_\bt_\b__\be_\bn_\bc
7342
7343        Type: boolean
7344
7345        Default: yes
7346
7347        If _\bs_\be_\bt, Mutt-ng will automatically encode PGP/MIME signed messages as quoted-
7348        printable.  Please note that unsetting this variable may lead to problems with
7349        non-verifyable PGP signatures, so only change this if you know what you are
7350        doing.  (PGP only)
7351
7352        _\b7_\b._\b4_\b._\b2_\b0_\b9  _\bp_\bg_\bp_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
7353
7354        Type: number
7355
7356        Default: 300
7357
7358        The number of seconds after which a cached passphrase will expire if not used.
7359        Default: 300.  (PGP only)
7360
7361        _\b7_\b._\b4_\b._\b2_\b1_\b0  _\bp_\bg_\bp_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\b__\ba_\bg_\be_\bn_\bt
7362
7363        Type: boolean
7364
7365        Default: no
7366
7367        If _\bs_\be_\bt, Mutt-ng will use a possibly-running gpg-agent process.  (PGP only)
7368
7369        _\b7_\b._\b4_\b._\b2_\b1_\b1  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7370
7371        Type: string
7372
7373        Default: ''
7374
7375        This command is used to verify PGP signatures.  (PGP only)
7376
7377        _\b7_\b._\b4_\b._\b2_\b1_\b2  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bk_\be_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7378
7379        Type: string
7380
7381        Default: ''
7382
7383        This command is used to verify key information from the key selection menu.
7384        (PGP only)
7385
7386        _\b7_\b._\b4_\b._\b2_\b1_\b3  _\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be
7387
7388        Type: boolean
7389
7390        The Mutt Next Generation E-Mail Client                                      141
7391
7392        Default: no
7393
7394        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
7395        pipe the messages without any preprocessing. When _\bs_\be_\bt, Mutt-ng will weed head-
7396        ers and will attempt to PGP/MIME decode the messages first.
7397
7398        _\b7_\b._\b4_\b._\b2_\b1_\b4  _\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7399
7400        Type: string
7401
7402        Default: '\n'
7403
7404        The separator to add between messages when piping a list of tagged messages to
7405        an external Unix command.
7406
7407        _\b7_\b._\b4_\b._\b2_\b1_\b5  _\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
7408
7409        Type: boolean
7410
7411        Default: no
7412
7413        Used in connection with the _\bp_\bi_\bp_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be command and the ``tag- prefix'' or
7414        ``tag-prefix-cond'' operators.  If this variable is _\bu_\bn_\bs_\be_\bt, when piping a list
7415        of tagged messages Mutt-ng will concatenate the messages and will pipe them as
7416        a single folder.  When _\bs_\be_\bt, Mutt-ng will pipe the messages one by one.  In both
7417        cases the messages are piped in the current sorted order, and the ``_\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7418        (section 7.4.214  , page 140)'' separator is added after each message.
7419
7420        _\b7_\b._\b4_\b._\b2_\b1_\b6  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\b__\bt_\br_\by_\b__\ba_\bl_\bl
7421
7422        Type: boolean
7423
7424        Default: yes
7425
7426        Availability: POP
7427
7428        If _\bs_\be_\bt, Mutt-ng will try all available methods. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will only
7429        fall back to other authentication methods if the previous methods are unavail-
7430        able. If a method is available but authentication fails, Mutt-ng will not con-
7431        nect to the POP server.
7432
7433        _\b7_\b._\b4_\b._\b2_\b1_\b7  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
7434
7435        Type: string
7436
7437        Default: ''
7438
7439        Availability: POP
7440
7441        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
7442        use to log in to an POP server, in the order Mutt-ng should try them.  Authen-
7443        tication methods are either ``user'', ``apop'' or any SASL mechanism, eg
7444        ``digest-md5'', ``gssapi'' or ``cram-md5''.
7445
7446        The Mutt Next Generation E-Mail Client                                      142
7447
7448        This parameter is case-insensitive. If this parameter is _\bu_\bn_\bs_\be_\bt (the default)
7449        Mutt-ng will try all available methods, in order from most-secure to least-
7450        secure.
7451
7452        Example: set pop_authenticators='digest-md5:apop:user'
7453
7454        _\b7_\b._\b4_\b._\b2_\b1_\b8  _\bp_\bo_\bp_\b__\bd_\be_\bl_\be_\bt_\be
7455
7456        Type: quadoption
7457
7458        Default: ask-no
7459
7460        Availability: POP
7461
7462        If _\bs_\be_\bt, Mutt-ng will delete successfully downloaded messages from the POP
7463        server when using the ``fetch-mail'' function.  When _\bu_\bn_\bs_\be_\bt, Mutt-ng will down-
7464        load messages but also leave them on the POP server.
7465
7466        _\b7_\b._\b4_\b._\b2_\b1_\b9  _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt
7467
7468        Type: string
7469
7470        Default: ''
7471
7472        Availability: POP
7473
7474        The name of your POP server for the ``fetch-mail'' function.  You can also
7475        specify an alternative port, username and password, i.e.:
7476
7477        [pop[s]://][username[:password]@]popserver[:port]
7478
7479        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7480        the superuser of your machine may read it regardless of the file's permissions.
7481
7482        _\b7_\b._\b4_\b._\b2_\b2_\b0  _\bp_\bo_\bp_\b__\bl_\ba_\bs_\bt
7483
7484        Type: boolean
7485
7486        Default: no
7487
7488        Availability: POP
7489
7490        If this variable is _\bs_\be_\bt, Mutt-ng will try to use the ``LAST'' POP command for
7491        retrieving only unread messages from the POP server when using the ``fetch-
7492        mail'' function.
7493
7494        _\b7_\b._\b4_\b._\b2_\b2_\b1  _\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
7495
7496        Type: number
7497
7498        Default: 60
7499
7500        Availability: POP
7501
7502        The Mutt Next Generation E-Mail Client                                      143
7503
7504        This variable configures how often (in seconds) POP should look for new mail.
7505
7506        _\b7_\b._\b4_\b._\b2_\b2_\b2  _\bp_\bo_\bp_\b__\bp_\ba_\bs_\bs
7507
7508        Type: string
7509
7510        Default: ''
7511
7512        Availability: POP
7513
7514        Specifies the password for your POP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt you
7515        for your password when you open POP mailbox.
7516
7517        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7518        the superuser of your machine may read it regardless of the file's permissions.
7519
7520        _\b7_\b._\b4_\b._\b2_\b2_\b3  _\bp_\bo_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7521
7522        Type: quadoption
7523
7524        Default: ask-yes
7525
7526        Availability: POP
7527
7528        Controls whether or not Mutt-ng will try to reconnect to a POP server when the
7529        connection is lost.
7530
7531        _\b7_\b._\b4_\b._\b2_\b2_\b4  _\bp_\bo_\bp_\b__\bu_\bs_\be_\br
7532
7533        Type: string
7534
7535        Default: ''
7536
7537        Availability: POP
7538
7539        Your login name on the POP server.
7540
7541        This variable defaults to your user name on the local machine.
7542
7543        _\b7_\b._\b4_\b._\b2_\b2_\b5  _\bp_\bo_\bs_\bt_\b__\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
7544
7545        Type: string
7546
7547        Default: ''
7548
7549        Similar to the ``_\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 7.4.18  , page 93)'' variable, Mutt-ng
7550        will append this string after the inclusion of a message which is being replied
7551        to.
7552
7553        _\b7_\b._\b4_\b._\b2_\b2_\b6  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
7554
7555        Type: quadoption
7556
7557        Default: ask-yes
7558
7559        The Mutt Next Generation E-Mail Client                                      144
7560
7561        Controls whether or not messages are saved in the ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section
7562        7.4.227  , page 143)'' mailbox when you elect not to send immediately.
7563
7564        _\b7_\b._\b4_\b._\b2_\b2_\b7  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd
7565
7566        Type: path
7567
7568        Default: '~/postponed'
7569
7570        Mutt-ng allows you to indefinitely ``_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.226  , page 143)
7571        sending a message'' which you are editing.  When you choose to postpone a mes-
7572        sage, Mutt-ng saves it in the mailbox specified by this variable.  Also see the
7573        ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.226  , page 143)'' variable.
7574
7575        _\b7_\b._\b4_\b._\b2_\b2_\b8  _\bp_\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7576
7577        Type: string
7578
7579        Default: ''
7580
7581        If _\bs_\be_\bt, a shell command to be executed if Mutt-ng fails to establish a connec-
7582        tion to the server. This is useful for setting up secure connections, e.g. with
7583        ssh(1). If the command returns a  nonzero status, Mutt-ng gives up opening the
7584        server. Example:
7585
7586        preconnect='ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 <
7587        /dev/null > /dev/null'
7588
7589        Mailbox ``foo'' on mailhost.net can now be reached as ``{localhost:1234}foo''.
7590
7591        N\bNo\bot\bte\be:\b: For this example to work, you must be able to log in to the remote
7592        machine without having to enter a password.
7593
7594        _\b7_\b._\b4_\b._\b2_\b2_\b9  _\bp_\br_\bi_\bn_\bt
7595
7596        Type: quadoption
7597
7598        Default: ask-no
7599
7600        Controls whether or not Mutt-ng really prints messages.  This is set to _\ba_\bs_\bk_\b-_\bn_\bo
7601        by default, because some people accidentally hit ``p'' often.
7602
7603        _\b7_\b._\b4_\b._\b2_\b3_\b0  _\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7604
7605        Type: path
7606
7607        Default: 'lpr'
7608
7609        This specifies the command pipe that should be used to print messages.
7610
7611        _\b7_\b._\b4_\b._\b2_\b3_\b1  _\bp_\br_\bi_\bn_\bt_\b__\bd_\be_\bc_\bo_\bd_\be
7612
7613        Type: boolean
7614
7615        The Mutt Next Generation E-Mail Client                                      145
7616
7617        Default: yes
7618
7619        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7620        message is decoded before it is passed to the external command specified by
7621        _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.230  , page 144).  If this option is _\bu_\bn_\bs_\be_\bt, no pro-
7622        cessing will be applied to the message when printing it.  The latter setting
7623        may be useful if you are using some advanced printer filter which is able to
7624        properly format e-mail messages for printing.
7625
7626        _\b7_\b._\b4_\b._\b2_\b3_\b2  _\bp_\br_\bi_\bn_\bt_\b__\bs_\bp_\bl_\bi_\bt
7627
7628        Type: boolean
7629
7630        Default: no
7631
7632        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7633        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.230  , page 144) is executed
7634        once for each message which is to be printed.  If this option is _\bu_\bn_\bs_\be_\bt, the
7635        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.230  , page 144) is executed
7636        only once, and all the messages are concatenated, with a form feed as the mes-
7637        sage separator.
7638
7639        Those who use the enscript(1) program's mail-printing mode will most likely
7640        want to set this option.
7641
7642        _\b7_\b._\b4_\b._\b2_\b3_\b3  _\bp_\br_\bo_\bm_\bp_\bt_\b__\ba_\bf_\bt_\be_\br
7643
7644        Type: boolean
7645
7646        Default: yes
7647
7648        If you use an _\be_\bx_\bt_\be_\br_\bn_\ba_\bl ``_\b$_\bp_\ba_\bg_\be_\br (section 7.4.179  , page 132)'', setting this
7649        variable will cause Mutt-ng to prompt you for a command when the pager exits
7650        rather than returning to the index menu.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will return to the
7651        index menu when the external pager exits.
7652
7653        _\b7_\b._\b4_\b._\b2_\b3_\b4  _\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7654
7655        Type: path
7656
7657        Default: ''
7658
7659        This specifies the command that Mutt-ng will use to make external address
7660        queries.  The string should contain a %s, which will be substituted with the
7661        query string the user types.  See ``_\bq_\bu_\be_\br_\by (section 4.7  , page 58)'' for more
7662        information.
7663
7664        _\b7_\b._\b4_\b._\b2_\b3_\b5  _\bq_\bu_\bi_\bt
7665
7666        Type: quadoption
7667
7668        Default: yes
7669
7670        This variable controls whether ``quit'' and ``exit'' actually quit from Mutt-
7671
7672        The Mutt Next Generation E-Mail Client                                      146
7673
7674        ng.  If it set to _\by_\be_\bs, they do quit, if it is set to _\bn_\bo, they have no effect,
7675        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
7676        you try to quit.
7677
7678        _\b7_\b._\b4_\b._\b2_\b3_\b6  _\bq_\bu_\bo_\bt_\be_\b__\be_\bm_\bp_\bt_\by
7679
7680        Type: boolean
7681
7682        Default: yes
7683
7684        Controls whether or not empty lines will be quoted using ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (sec-
7685        tion 7.4.115  , page 115)''.
7686
7687        _\b7_\b._\b4_\b._\b2_\b3_\b7  _\bq_\bu_\bo_\bt_\be_\b__\bq_\bu_\bo_\bt_\be_\bd
7688
7689        Type: boolean
7690
7691        Default: no
7692
7693        Controls how quoted lines will be quoted. If _\bs_\be_\bt, one quote character will be
7694        added to the end of existing prefix.  Otherwise, quoted lines will be prepended
7695        by ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.115  , page 115)''.
7696
7697        _\b7_\b._\b4_\b._\b2_\b3_\b8  _\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp
7698
7699        Type: regular expression
7700
7701        Default: '^([ \t]*[|>:}#])+'
7702
7703        A regular expression used in the internal-pager to determine quoted sections of
7704        text in the body of a message.
7705
7706        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
7707        set this to a regular expression that matches _\be_\bx_\ba_\bc_\bt_\bl_\by the quote characters at
7708        the beginning of quoted lines.
7709
7710        _\b7_\b._\b4_\b._\b2_\b3_\b9  _\br_\be_\ba_\bd_\b__\bi_\bn_\bc
7711
7712        Type: number
7713
7714        Default: 10
7715
7716        If set to a value greater than 0, Mutt-ng will display which message it is cur-
7717        rently on when reading a mailbox.  The message is printed after _\br_\be_\ba_\bd_\b__\bi_\bn_\bc mes-
7718        sages have been read (e.g., if set to 25, Mutt-ng will print a message when it
7719        reads message 25, and then again when it gets to message 50).  This variable is
7720        meant to indicate progress when reading large mailboxes which may take some
7721        time.  When set to 0, only a single message will appear before the reading the
7722        mailbox.
7723
7724        Also see the ``_\b$_\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc (section 7.4.352  , page 174)'' variable.
7725
7726        _\b7_\b._\b4_\b._\b2_\b4_\b0  _\br_\be_\ba_\bd_\b__\bo_\bn_\bl_\by
7727
7728        The Mutt Next Generation E-Mail Client                                      147
7729
7730        Type: boolean
7731
7732        Default: no
7733
7734        If set, all folders are opened in read-only mode.
7735
7736        _\b7_\b._\b4_\b._\b2_\b4_\b1  _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7737
7738        Type: string
7739
7740        Default: ''
7741
7742        This variable specifies what ``real'' or ``personal'' name should be used when
7743        sending messages.
7744
7745        By default, this is the GECOS field from /etc/passwd.
7746
7747        _\bN_\bo_\bt_\be_\b: This variable will _\bn_\bo_\bt be used when the user has set a real name in the
7748        _\b$_\bf_\br_\bo_\bm (section 7.4.80  , page 107) variable.
7749
7750        _\b7_\b._\b4_\b._\b2_\b4_\b2  _\br_\be_\bc_\ba_\bl_\bl
7751
7752        Type: quadoption
7753
7754        Default: ask-yes
7755
7756        Controls whether or not Mutt-ng recalls postponed messages when composing a new
7757        message.  Also see ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 7.4.227  , page 143)''.
7758
7759        Setting this variable to _\by_\be_\bs is not generally useful, and thus not recommended.
7760
7761        _\b7_\b._\b4_\b._\b2_\b4_\b3  _\br_\be_\bc_\bo_\br_\bd
7762
7763        Type: path
7764
7765        Default: ''
7766
7767        This specifies the file into which your outgoing messages should be appended.
7768        (This is meant as the primary method for saving a copy of your messages, but
7769        another way to do this is using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37)'' com-
7770        mand to create a Bcc: header field with your email address in it.)
7771
7772        The value of _\b$_\br_\be_\bc_\bo_\br_\bd _\b(_\bs_\be_\bc_\bt_\bi_\bo_\bn _\b7_\b._\b4_\b._\b2_\b4_\b3  _\b, _\bp_\ba_\bg_\be _\b1_\b4_\b7_\b) is overridden by the
7773        ``_\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
7774        7.4.254  , page 150)'' variables, and the ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.19  , page
7775        39)'' command.
7776
7777        _\b7_\b._\b4_\b._\b2_\b4_\b4  _\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp
7778
7779        Type: regular expression
7780
7781        Default: '^(re([\[0-9\]+])*|aw):[ \t]*'
7782
7783        A regular expression used to recognize reply messages when threading and
7784
7785        The Mutt Next Generation E-Mail Client                                      148
7786
7787        replying. The default value corresponds to the English ``Re:'' and the German
7788        ``Aw:''.
7789
7790        _\b7_\b._\b4_\b._\b2_\b4_\b5  _\br_\be_\bp_\bl_\by_\b__\bs_\be_\bl_\bf
7791
7792        Type: boolean
7793
7794        Default: no
7795
7796        If _\bu_\bn_\bs_\be_\bt and you are replying to a message sent by you, Mutt-ng will assume
7797        that you want to reply to the recipients of that message rather than to your-
7798        self.
7799
7800        _\b7_\b._\b4_\b._\b2_\b4_\b6  _\br_\be_\bp_\bl_\by_\b__\bt_\bo
7801
7802        Type: quadoption
7803
7804        Default: ask-yes
7805
7806        If _\bs_\be_\bt, when replying to a message, Mutt-ng will use the address listed in the
7807        ``Reply-To:'' header field as the recipient of the reply.  If _\bu_\bn_\bs_\be_\bt, it will
7808        use the address in the ``From:'' header field instead.
7809
7810        This option is useful for reading a mailing list that sets the ``Reply-To:''
7811        header field to the list address and you want to send a private message to the
7812        author of a message.
7813
7814        _\b7_\b._\b4_\b._\b2_\b4_\b7  _\br_\be_\bs_\bo_\bl_\bv_\be
7815
7816        Type: boolean
7817
7818        Default: yes
7819
7820        When set, the cursor will be automatically advanced to the next (possibly
7821        undeleted) message whenever a command that modifies the current message is exe-
7822        cuted.
7823
7824        _\b7_\b._\b4_\b._\b2_\b4_\b8  _\br_\be_\bv_\be_\br_\bs_\be_\b__\ba_\bl_\bi_\ba_\bs
7825
7826        Type: boolean
7827
7828        Default: no
7829
7830        This variable controls whether or not Mutt-ng will display the ``personal''
7831        name from your aliases in the index menu if it finds an alias that matches the
7832        message's sender.  For example, if you have the following alias:
7833
7834        alias juser abd30425@somewhere.net (Joe User)
7835
7836        and then you receive mail which contains the following header:
7837
7838        From: abd30425@somewhere.net
7839
7840        It would be displayed in the index menu as ``Joe User'' instead of
7841
7842        The Mutt Next Generation E-Mail Client                                      149
7843
7844        ``abd30425@somewhere.net.''  This is useful when the person's e-mail address is
7845        not human friendly (like CompuServe addresses).
7846
7847        _\b7_\b._\b4_\b._\b2_\b4_\b9  _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be
7848
7849        Type: boolean
7850
7851        Default: no
7852
7853        It may sometimes arrive that you receive mail to a certain machine, move the
7854        messages to another machine, and reply to some the messages from there.  If
7855        this variable is _\bs_\be_\bt, the default From: line of the reply messages is built
7856        using the address where you received the messages you are replying to i\bif\bf that
7857        address matches your alternates.  If the variable is _\bu_\bn_\bs_\be_\bt, or the address that
7858        would be used doesn't match your alternates, the From: line will use your
7859        address on the current machine.
7860
7861        _\b7_\b._\b4_\b._\b2_\b5_\b0  _\br_\be_\bv_\be_\br_\bs_\be_\b__\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7862
7863        Type: boolean
7864
7865        Default: yes
7866
7867        This variable fine-tunes the behaviour of the _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.249  ,
7868        page 148) feature.  When it is _\bs_\be_\bt, Mutt-ng will use the address from incoming
7869        messages as-is, possibly including eventual real names.  When it is _\bu_\bn_\bs_\be_\bt,
7870        Mutt-ng will override any such real names with the setting of the _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7871        (section 7.4.241  , page 146) variable.
7872
7873        _\b7_\b._\b4_\b._\b2_\b5_\b1  _\br_\bf_\bc_\b2_\b0_\b4_\b7_\b__\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br_\bs
7874
7875        Type: boolean
7876
7877        Default: no
7878
7879        When this variable is _\bs_\be_\bt, Mutt-ng will decode RFC-2047-encoded MIME parame-
7880        ters. You want to set this variable when Mutt-ng suggests you to save attach-
7881        ments to files named like this:
7882
7883        =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
7884
7885        When this variable is _\bs_\be_\bt interactively, the change doesn't have the desired
7886        effect before you have changed folders.
7887
7888        Note that this use of RFC 2047's encoding is explicitly, prohibited by the
7889        standard, but nevertheless encountered in the wild.
7890
7891        Also note that setting this parameter will _\bn_\bo_\bt have the effect that Mutt-ng
7892        _\bg_\be_\bn_\be_\br_\ba_\bt_\be_\bs this kind of encoding.  Instead, Mutt-ng will unconditionally use the
7893        encoding specified in RFC 2231.
7894
7895        _\b7_\b._\b4_\b._\b2_\b5_\b2  _\bs_\ba_\bv_\be_\b__\ba_\bd_\bd_\br_\be_\bs_\bs
7896
7897        Type: boolean
7898
7899        The Mutt Next Generation E-Mail Client                                      150
7900
7901        Default: no
7902
7903        If _\bs_\be_\bt, Mutt-ng will take the sender's full address when choosing a default
7904        folder for saving a mail. If ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.254  , page 150)'' or
7905        ``_\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
7906        fcc folder will be changed as well.
7907
7908        _\b7_\b._\b4_\b._\b2_\b5_\b3  _\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by
7909
7910        Type: boolean
7911
7912        Default: yes
7913
7914        When _\bu_\bn_\bs_\be_\bt, mailboxes which contain no saved messages will be removed when
7915        closed (the exception is ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.310  , page 163)'' which is
7916        never removed).  If _\bs_\be_\bt, mailboxes are never removed.
7917
7918        N\bNo\bot\bte\be:\b: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH
7919        and Maildir directories.
7920
7921        _\b7_\b._\b4_\b._\b2_\b5_\b4  _\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be
7922
7923        Type: boolean
7924
7925        Default: no
7926
7927        This variable controls how copies of outgoing messages are saved.  When set, a
7928        check is made to see if a mailbox specified by the recipient address exists
7929        (this is done by searching for a mailbox in the ``_\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.70  ,
7930        page 104)'' directory with the _\bu_\bs_\be_\br_\bn_\ba_\bm_\be part of the recipient address).  If the
7931        mailbox exists, the outgoing message will be saved to that mailbox, otherwise
7932        the message is saved to the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.243  , page 147)'' mailbox.
7933
7934        Also see the ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.74  , page 106)'' variable.
7935
7936        _\b7_\b._\b4_\b._\b2_\b5_\b5  _\bs_\bc_\bo_\br_\be
7937
7938        Type: boolean
7939
7940        Default: yes
7941
7942        When this variable is _\bu_\bn_\bs_\be_\bt, scoring is turned off.  This can be useful to
7943        selectively disable scoring for certain folders when the ``_\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\b-
7944        _\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be (section 7.4.256  , page 150)'' variable and friends are used.
7945
7946        _\b7_\b._\b4_\b._\b2_\b5_\b6  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
7947
7948        Type: number
7949
7950        Default: -1
7951
7952        Messages which have been assigned a score equal to or lower than the value of
7953        this variable are automatically marked for deletion by Mutt-ng.  Since Mutt-ng
7954        scores are always greater than or equal to zero, the default setting of this
7955
7956        The Mutt Next Generation E-Mail Client                                      151
7957
7958        variable will never mark a message for deletion.
7959
7960        _\b7_\b._\b4_\b._\b2_\b5_\b7  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bf_\bl_\ba_\bg
7961
7962        Type: number
7963
7964        Default: 9999
7965
7966        Messages which have been assigned a score greater than or equal to this vari-
7967        able's value are automatically marked ``flagged''.
7968
7969        _\b7_\b._\b4_\b._\b2_\b5_\b8  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd
7970
7971        Type: number
7972
7973        Default: -1
7974
7975        Messages which have been assigned a score equal to or lower than the value of
7976        this variable are automatically marked as read by Mutt-ng.  Since Mutt-ng
7977        scores are always greater than or equal to zero, the default setting of this
7978        variable will never mark a message read.
7979
7980        _\b7_\b._\b4_\b._\b2_\b5_\b9  _\bs_\be_\bn_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
7981
7982        Type: string
7983
7984        Default: 'us-ascii:iso-8859-1:utf-8'
7985
7986        A list of character sets for outgoing messages. Mutt-ng will use the first
7987        character set into which the text can be converted exactly.  If your ``_\b$_\bc_\bh_\ba_\br_\bs_\be_\bt
7988        (section 7.4.27  , page 95)'' is not iso-8859-1 and recipients may not under-
7989        stand UTF-8, it is advisable to include in the list an appropriate widely used
7990        standard character set (such as iso-8859-2, koi8-r or iso-2022-jp) either
7991        instead of or after iso-8859-1.
7992
7993        _\b7_\b._\b4_\b._\b2_\b6_\b0  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl
7994
7995        Type: path
7996
7997        Default: '/usr/sbin/sendmail -oem -oi'
7998
7999        Specifies the program and arguments used to deliver mail sent by Mutt-ng.
8000        Mutt-ng expects that the specified program interprets additional arguments as
8001        recipient addresses.
8002
8003        _\b7_\b._\b4_\b._\b2_\b6_\b1  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl_\b__\bw_\ba_\bi_\bt
8004
8005        Type: number
8006
8007        Default: 0
8008
8009        Specifies the number of seconds to wait for the ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.260  ,
8010        page 151)'' process to finish before giving up and putting delivery in the
8011        background.
8012
8013        The Mutt Next Generation E-Mail Client                                      152
8014
8015        Mutt-ng interprets the value of this variable as follows:
8016
8017              >0
8018                    number of seconds to wait for sendmail to finish before continuing
8019
8020              0
8021                    wait forever for sendmail to finish
8022
8023              <0
8024                    always put sendmail in the background without waiting
8025
8026        Note that if you specify a value other than 0, the output of the child process
8027        will be put in a temporary file.  If there is some error, you will be informed
8028        as to where to find the output.
8029
8030        _\b7_\b._\b4_\b._\b2_\b6_\b2  _\bs_\bh_\be_\bl_\bl
8031
8032        Type: path
8033
8034        Default: ''
8035
8036        Command to use when spawning a subshell.  By default, the user's login shell
8037        from /etc/passwd is used.
8038
8039        _\b7_\b._\b4_\b._\b2_\b6_\b3  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by
8040
8041        Type: string
8042
8043        Default: '.'
8044
8045        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
8046        7.4.267  , page 153) is _\bs_\be_\bt, this variable specifies the characters at which to
8047        split a folder name into ``hierarchy items.''
8048
8049        _\b7_\b._\b4_\b._\b2_\b6_\b4  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bd_\be_\bl_\bi_\bm
8050
8051        Type: string
8052
8053        Default: '|'
8054
8055        This specifies the delimiter between the sidebar (if visible) and other
8056        screens.
8057
8058        _\b7_\b._\b4_\b._\b2_\b6_\b5  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\be_\bw_\bm_\ba_\bi_\bl_\b__\bo_\bn_\bl_\by
8059
8060        Type: boolean
8061
8062        Default: no
8063
8064        If _\bs_\be_\bt, only folders with new mail will be shown in the sidebar.
8065
8066        _\b7_\b._\b4_\b._\b2_\b6_\b6  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\bu_\bm_\bb_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
8067
8068        Type: string
8069
8070        The Mutt Next Generation E-Mail Client                                      153
8071
8072        Default: '%m%?n?(%n)?%?f?[%f]?'
8073
8074        This variable controls how message counts are printed when the sidebar is
8075        enabled. If this variable is _\be_\bm_\bp_\bt_\by (_\ba_\bn_\bd _\bo_\bn_\bl_\by _\bi_\bf), no numbers will be printed
8076        _\ba_\bn_\bd mutt-ng won't frequently count mail (which may be a great speedup esp. with
8077        mbox-style mailboxes.)
8078
8079        The following printf(3)-like sequences are supported all of which may be
8080        printed non-zero:
8081
8082              %d
8083                    Number of deleted messages. 1)
8084
8085              %F
8086                    Number of flagged messages.
8087
8088              %m
8089                    Total number of messages.
8090
8091              %M
8092                    Total number of messages shown, i.e. not hidden by a limit. 1)
8093
8094              %n
8095                    Number of new messages.
8096
8097              %t
8098                    Number of tagged messages. 1)
8099
8100        1) These expandos only have a non-zero value for the current mailbox and will
8101        always be zero otherwise.
8102
8103        _\b7_\b._\b4_\b._\b2_\b6_\b7  _\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
8104
8105        Type: boolean
8106
8107        Default: no
8108
8109        When _\bs_\be_\bt, the ``hierarchy'' of the sidebar entries will be shortened only if
8110        they cannot be printed in full length (because ``_\b$_\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh (section
8111        7.4.269  , page 153)'' is set to a too low value). For example, if the news-
8112        group name ``de.alt.sysadmin.recovery'' doesn't fit on the screen, it'll get
8113        shortened ``d.a.s.recovery'' while ``de.alt.d0'' still would and thus will not
8114        get shortened.
8115
8116        At which characters this compression is done is controled via the _\b$_\bs_\bi_\bd_\be_\b-
8117        _\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by (section 7.4.263  , page 152) variable.
8118
8119        _\b7_\b._\b4_\b._\b2_\b6_\b8  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bv_\bi_\bs_\bi_\bb_\bl_\be
8120
8121        Type: boolean
8122
8123        Default: no
8124
8125        This specifies whether or not to show the sidebar (a list of folders specified
8126
8127        The Mutt Next Generation E-Mail Client                                      154
8128
8129        with the ``mailboxes'' command).
8130
8131        _\b7_\b._\b4_\b._\b2_\b6_\b9  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh
8132
8133        Type: number
8134
8135        Default: 0
8136
8137        The width of the sidebar.
8138
8139        _\b7_\b._\b4_\b._\b2_\b7_\b0  _\bs_\bi_\bg_\b__\bd_\ba_\bs_\bh_\be_\bs
8140
8141        Type: boolean
8142
8143        Default: yes
8144
8145        If set, a line containing ``-- '' (dash, dash, space) will be inserted before
8146        your ``_\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.272  , page 154)''.  It is s\bst\btr\bro\bon\bng\bgl\bly\by recommended
8147        that you not unset this variable unless your ``signature'' contains just your
8148        name. The reason for this is because many software packages use ``-- \n'' to
8149        detect your signature.
8150
8151        For example, Mutt-ng has the ability to highlight the signature in a different
8152        color in the builtin pager.
8153
8154        _\b7_\b._\b4_\b._\b2_\b7_\b1  _\bs_\bi_\bg_\b__\bo_\bn_\b__\bt_\bo_\bp
8155
8156        Type: boolean
8157
8158        Default: no
8159
8160        If _\bs_\be_\bt, the signature will be included before any quoted or forwarded text.  It
8161        is s\bst\btr\bro\bon\bng\bgl\bly\by recommended that you do not set this variable unless you really
8162        know what you are doing, and are prepared to take some heat from netiquette
8163        guardians.
8164
8165        _\b7_\b._\b4_\b._\b2_\b7_\b2  _\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be
8166
8167        Type: path
8168
8169        Default: '~/.signature'
8170
8171        Specifies the filename of your signature, which is appended to all outgoing
8172        messages.   If the filename ends with a pipe (``|''), it is assumed that file-
8173        name is a shell command and input should be read from its stdout.
8174
8175        _\b7_\b._\b4_\b._\b2_\b7_\b3  _\bs_\bi_\bg_\bn_\bo_\bf_\bf_\b__\bs_\bt_\br_\bi_\bn_\bg
8176
8177        Type: string
8178
8179        Default: ''
8180
8181        If _\bs_\be_\bt, this string will be inserted before the signature. This is useful for
8182        people that want to sign off every message they send with their name.
8183
8184        The Mutt Next Generation E-Mail Client                                      155
8185
8186        If you want to insert your website's URL, additional contact information or
8187        witty quotes into your mails, better use a signature file instead of the sig-
8188        noff string.
8189
8190        _\b7_\b._\b4_\b._\b2_\b7_\b4  _\bs_\bi_\bm_\bp_\bl_\be_\b__\bs_\be_\ba_\br_\bc_\bh
8191
8192        Type: string
8193
8194        Default: '~f %s | ~s %s'
8195
8196        Specifies how Mutt-ng should expand a simple search into a real search pattern.
8197        A simple search is one that does not contain any of the ~ operators.  See
8198        ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 83)'' for more information on search patterns.
8199
8200        For example, if you simply type ``joe'' at a search or limit prompt, Mutt-ng
8201        will automatically expand it to the value specified by this variable.  For the
8202        default value it would be:
8203
8204        ~f joe | ~s joe
8205
8206        _\b7_\b._\b4_\b._\b2_\b7_\b5  _\bs_\bl_\be_\be_\bp_\b__\bt_\bi_\bm_\be
8207
8208        Type: number
8209
8210        Default: 1
8211
8212        Specifies time, in seconds, to pause while displaying certain informational
8213        messages, while moving from folder to folder and after expunging messages from
8214        the current folder.  The default is to pause one second, so a value of zero for
8215        this option suppresses the pause.
8216
8217        _\b7_\b._\b4_\b._\b2_\b7_\b6  _\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp
8218
8219        Type: boolean
8220
8221        Default: yes
8222
8223        Controls the display of lines longer than the screen width in the internal
8224        pager. If _\bs_\be_\bt, long lines are wrapped at a word boundary.  If _\bu_\bn_\bs_\be_\bt, lines are
8225        simply wrapped at the screen edge. Also see the ``_\b$_\bm_\ba_\br_\bk_\be_\br_\bs (section 7.4.127  ,
8226        page 120)'' variable.
8227
8228        _\b7_\b._\b4_\b._\b2_\b7_\b7  _\bs_\bm_\bi_\bl_\be_\by_\bs
8229
8230        Type: regular expression
8231
8232        Default: '(>From )|(:[-^]?[][)(><}{|/DP])'
8233
8234        The _\bp_\ba_\bg_\be_\br uses this variable to catch some common false positives of
8235        ``_\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.238  , page 146)'', most notably smileys in the
8236        beginning of a line
8237
8238        _\b7_\b._\b4_\b._\b2_\b7_\b8  _\bs_\bm_\bi_\bm_\be_\b__\ba_\bs_\bk_\b__\bc_\be_\br_\bt_\b__\bl_\ba_\bb_\be_\bl
8239
8240        The Mutt Next Generation E-Mail Client                                      156
8241
8242        Type: boolean
8243
8244        Default: yes
8245
8246        This flag controls whether you want to be asked to enter a label for a certifi-
8247        cate about to be added to the database or not. It is _\bs_\be_\bt by default.  (S/MIME
8248        only)
8249
8250        _\b7_\b._\b4_\b._\b2_\b7_\b9  _\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn
8251
8252        Type: path
8253
8254        Default: ''
8255
8256        This variable contains the name of either a directory, or a file which contains
8257        trusted certificates for use with OpenSSL.  (S/MIME only)
8258
8259        _\b7_\b._\b4_\b._\b2_\b8_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs
8260
8261        Type: path
8262
8263        Default: ''
8264
8265        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage
8266        and retrieval of keys by itself. This is very basic right now, and keys and
8267        certificates are stored in two different directories, both named as the hash-
8268        value retrieved from OpenSSL. There is an index file which contains mailbox-
8269        address keyid pairs, and which can be manually edited. This one points to the
8270        location of the certificates.  (S/MIME only)
8271
8272        _\b7_\b._\b4_\b._\b2_\b8_\b1  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8273
8274        Type: string
8275
8276        Default: ''
8277
8278        This format string specifies a command which is used to decrypt application/x-
8279        pkcs7-mime attachments.
8280
8281        The OpenSSL command formats have their own set of printf(3)-like sequences sim-
8282        ilar to PGP's:
8283
8284              %f
8285                    Expands to the name of a file containing a message.
8286
8287              %s
8288                    Expands to the name of a file containing the signature part of a
8289                    multipart/signed attachment when verifying it.
8290
8291              %k
8292                    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.283  ,
8293                    page 157)
8294
8295        The Mutt Next Generation E-Mail Client                                      157
8296
8297              %c
8298                    One or more certificate IDs.
8299
8300              %a
8301                    The algorithm used for encryption.
8302
8303              %C
8304                    CA location:  Depending on whether _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section
8305                    7.4.279  , page 156) points to a directory or file, this expands to
8306                    '-CApath _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.279  , page 156)' or
8307                    '-CAfile _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.279  , page 156)'.
8308
8309        For examples on how to configure these formats, see the smime.rc in the sam-
8310        ples/ subdirectory which has been installed on your system alongside the docu-
8311        mentation.  (S/MIME only)
8312
8313        _\b7_\b._\b4_\b._\b2_\b8_\b2  _\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
8314
8315        Type: boolean
8316
8317        Default: yes
8318
8319        If _\bs_\be_\bt (default) this tells Mutt-ng to use the default key for decryption. Oth-
8320        erwise, if manage multiple certificate-key-pairs, Mutt-ng will try to use the
8321        mailbox-address to determine the key to use. It will ask you to supply a key,
8322        if it can't find one.  (S/MIME only)
8323
8324        _\b7_\b._\b4_\b._\b2_\b8_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by
8325
8326        Type: string
8327
8328        Default: ''
8329
8330        This is the default key-pair to use for signing. This must be set to the keyid
8331        (the hash-value that OpenSSL generates) to work properly (S/MIME only)
8332
8333        _\b7_\b._\b4_\b._\b2_\b8_\b4  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8334
8335        Type: string
8336
8337        Default: ''
8338
8339        This command is used to create encrypted S/MIME messages.  (S/MIME only)
8340
8341        _\b7_\b._\b4_\b._\b2_\b8_\b5  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bw_\bi_\bt_\bh
8342
8343        Type: string
8344
8345        Default: ''
8346
8347        This sets the algorithm that should be used for encryption.  Valid choices are
8348        ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``\frc2-128''.
8349
8350        If _\bu_\bn_\bs_\be_\bt ``_\b3_\bd_\be_\bs'' (TripleDES) is used.  (S/MIME only)
8351
8352        The Mutt Next Generation E-Mail Client                                      158
8353
8354        _\b7_\b._\b4_\b._\b2_\b8_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bg_\be_\bt_\b__\bc_\be_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8355
8356        Type: string
8357
8358        Default: ''
8359
8360        This command is used to extract X509 certificates from a PKCS7 structure.
8361        (S/MIME only)
8362
8363        _\b7_\b._\b4_\b._\b2_\b8_\b7  _\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
8364
8365        Type: string
8366
8367        Default: ''
8368
8369        This command is used to extract the mail address(es) used for storing X509 cer-
8370        tificates, and for verification purposes (to check whether the certificate was
8371        issued for the sender's mailbox).  (S/MIME only)
8372
8373        _\b7_\b._\b4_\b._\b2_\b8_\b8  _\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
8374
8375        Type: string
8376
8377        Default: ''
8378
8379        This command is used to extract only the signers X509 certificate from a S/MIME
8380        signature, so that the certificate's owner may get compared to the email's
8381        ``From:'' header field.  (S/MIME only)
8382
8383        _\b7_\b._\b4_\b._\b2_\b8_\b9  _\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
8384
8385        Type: string
8386
8387        Default: ''
8388
8389        This command is used to import a certificate via smime_keysng.  (S/MIME only)
8390
8391        _\b7_\b._\b4_\b._\b2_\b9_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt
8392
8393        Type: boolean
8394
8395        Default: no
8396
8397        The default behaviour of Mutt-ng is to use PGP on all auto-sign/encryption
8398        operations. To override and to use OpenSSL instead this must be _\bs_\be_\bt.
8399
8400        However, this has no effect while replying, since Mutt-ng will automatically
8401        select the same application that was used to sign/encrypt the original message.
8402
8403        (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-
8404        tion 7.4.40  , page 98).)  (S/MIME only)
8405
8406        _\b7_\b._\b4_\b._\b2_\b9_\b1  _\bs_\bm_\bi_\bm_\be_\b__\bk_\be_\by_\bs
8407
8408        The Mutt Next Generation E-Mail Client                                      159
8409
8410        Type: path
8411
8412        Default: ''
8413
8414        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage ad
8415        retrieval of keys/certs by itself. This is very basic right now, and stores
8416        keys and certificates in two different directories, both named as the hash-
8417        value retrieved from OpenSSL. There is an index file which contains mailbox-
8418        address keyid pair, and which can be manually edited. This one points to the
8419        location of the private keys.  (S/MIME only)
8420
8421        _\b7_\b._\b4_\b._\b2_\b9_\b2  _\bs_\bm_\bi_\bm_\be_\b__\bp_\bk_\b7_\bo_\bu_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8422
8423        Type: string
8424
8425        Default: ''
8426
8427        This command is used to extract PKCS7 structures of S/MIME signatures, in order
8428        to extract the public X509 certificate(s).  (S/MIME only)
8429
8430        _\b7_\b._\b4_\b._\b2_\b9_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8431
8432        Type: string
8433
8434        Default: ''
8435
8436        This command is used to created S/MIME signatures of type multipart/signed,
8437        which can be read by all mail clients.  (S/MIME only)
8438
8439        _\b7_\b._\b4_\b._\b2_\b9_\b4  _\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
8440
8441        Type: string
8442
8443        Default: ''
8444
8445        This command is used to created S/MIME signatures of type application/x-
8446        pkcs7-signature, which can only be handled by mail clients supporting the
8447        S/MIME extension.  (S/MIME only)
8448
8449        _\b7_\b._\b4_\b._\b2_\b9_\b5  _\bs_\bm_\bi_\bm_\be_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
8450
8451        Type: number
8452
8453        Default: 300
8454
8455        The number of seconds after which a cached passphrase will expire if not used.
8456        (S/MIME only)
8457
8458        _\b7_\b._\b4_\b._\b2_\b9_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8459
8460        Type: string
8461
8462        Default: ''
8463
8464        The Mutt Next Generation E-Mail Client                                      160
8465
8466        This command is used to verify S/MIME signatures of type multipart/signed.
8467        (S/MIME only)
8468
8469        _\b7_\b._\b4_\b._\b2_\b9_\b7  _\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
8470
8471        Type: string
8472
8473        Default: ''
8474
8475        This command is used to verify S/MIME signatures of type application/x-
8476        pkcs7-mime.  (S/MIME only)
8477
8478        _\b7_\b._\b4_\b._\b2_\b9_\b8  _\bs_\bm_\bt_\bp_\b__\be_\bn_\bv_\be_\bl_\bo_\bp_\be
8479
8480        Type: string
8481
8482        Default: ''
8483
8484        Availability: SMTP
8485
8486        If this variable is non-empty, it'll be used as the envelope sender. If it's
8487        empty (the default), the value of the regular From: header will be used.
8488
8489        This may be necessary as some providers don't allow for arbitrary values as the
8490        envelope sender but only a particular one which may not be the same as the
8491        user's desired From: header.
8492
8493        _\b7_\b._\b4_\b._\b2_\b9_\b9  _\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt
8494
8495        Type: string
8496
8497        Default: ''
8498
8499        Availability: SMTP
8500
8501        Defines the SMTP host which will be used to deliver mail, as opposed to invok-
8502        ing the sendmail binary.  Setting this variable overrides the value of ``_\b$_\bs_\be_\bn_\bd_\b-
8503        _\bm_\ba_\bi_\bl (section 7.4.260  , page 151)'', and any associated variables.
8504
8505        _\b7_\b._\b4_\b._\b3_\b0_\b0  _\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs
8506
8507        Type: string
8508
8509        Default: ''
8510
8511        Availability: SMTP
8512
8513        Defines the password to use with SMTP AUTH.  If ``_\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section
8514        7.4.303  , page 161)'' is set, but this variable is not, you will be prompted
8515        for a password when sending.
8516
8517        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
8518        the superuser of your machine may read it regardless of the file's permissions.
8519
8520        The Mutt Next Generation E-Mail Client                                      161
8521
8522        _\b7_\b._\b4_\b._\b3_\b0_\b1  _\bs_\bm_\bt_\bp_\b__\bp_\bo_\br_\bt
8523
8524        Type: number
8525
8526        Default: 25
8527
8528        Availability: SMTP
8529
8530        Defines the port that the SMTP host is listening on for mail delivery.  Must be
8531        specified as a number.
8532
8533        Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers
8534        will probably desire 587, the mail submission port.
8535
8536        _\b7_\b._\b4_\b._\b3_\b0_\b2  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs
8537
8538        Type: string
8539
8540        Default: ''
8541
8542        Availability: SMTP (and SSL)
8543
8544        Defines wether to use STARTTLS. If this option is set to ``_\br_\be_\bq_\bu_\bi_\br_\be_\bd'' and the
8545        server does not support STARTTLS or there is an error in the TLS Handshake, the
8546        connection will fail. Setting this to ``_\be_\bn_\ba_\bb_\bl_\be_\bd'' will try to start TLS and
8547        continue without TLS in case of an error.  Muttng still needs to have SSL sup-
8548        port enabled in order to use it.
8549
8550        _\b7_\b._\b4_\b._\b3_\b0_\b3  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br
8551
8552        Type: string
8553
8554        Default: ''
8555
8556        Availability: SMTP
8557
8558        Defines the username to use with SMTP AUTH.  Setting this variable will cause
8559        Mutt-ng to attempt to use SMTP AUTH when sending.
8560
8561        _\b7_\b._\b4_\b._\b3_\b0_\b4  _\bs_\bo_\br_\bt
8562
8563        Type: sort order
8564
8565        Default: date
8566
8567        Specifies how to sort messages in the _\bi_\bn_\bd_\be_\bx menu.  Valid values are:
8568
8569        The Mutt Next Generation E-Mail Client                                      162
8570
8571                date or date-sent
8572                date-received
8573                from
8574                mailbox-order (unsorted)
8575                score
8576                size
8577                spam
8578                subject
8579                threads
8580                to
8581
8582        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8583        (example: set sort=reverse-date-sent).
8584
8585        _\b7_\b._\b4_\b._\b3_\b0_\b5  _\bs_\bo_\br_\bt_\b__\ba_\bl_\bi_\ba_\bs
8586
8587        Type: sort order
8588
8589        Default: alias
8590
8591        Specifies how the entries in the ``alias'' menu are sorted.  The following are
8592        legal values:
8593
8594                address (sort alphabetically by email address)
8595                alias (sort alphabetically by alias name)
8596                unsorted (leave in order specified in .muttrc)
8597
8598        _\b7_\b._\b4_\b._\b3_\b0_\b6  _\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8599
8600        Type: sort order
8601
8602        Default: date
8603
8604        When sorting by threads, this variable controls how threads are sorted in rela-
8605        tion to other threads, and how the branches of the thread trees are sorted.
8606        This can be set to any value that ``_\b$_\bs_\bo_\br_\bt (section 7.4.304  , page 161)'' can,
8607        except threads (in that case, Mutt-ng will just use date-sent).  You can also
8608        specify the ``last-'' prefix in addition to ``reverse-'' prefix, but last- must
8609        come after reverse-.  The last- prefix causes messages to be sorted against its
8610        siblings by which has the last descendant, using the rest of sort_aux as an
8611        ordering.
8612
8613        For instance, set sort_aux=last-date-received would mean that if a new message
8614        is received in a thread, that thread becomes the last one displayed (or the
8615        first, if you have set sort=reverse-threads.)
8616
8617        N\bNo\bot\bte\be:\b: For reversed ``_\b$_\bs_\bo_\br_\bt (section 7.4.304  , page 161)'' order _\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8618        (section 7.4.306  , page 162) is reversed again (which is not the right thing
8619        to do, but kept to not break any existing configuration setting).
8620
8621        The Mutt Next Generation E-Mail Client                                      163
8622
8623        _\b7_\b._\b4_\b._\b3_\b0_\b7  _\bs_\bo_\br_\bt_\b__\bb_\br_\bo_\bw_\bs_\be_\br
8624
8625        Type: sort order
8626
8627        Default: alpha
8628
8629        Specifies how to sort entries in the file browser.  By default, the entries are
8630        sorted alphabetically.  Valid values:
8631
8632                alpha (alphabetically)
8633                date
8634                size
8635                unsorted
8636
8637        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8638        (example: set sort_browser=reverse-date).
8639
8640        _\b7_\b._\b4_\b._\b3_\b0_\b8  _\bs_\bo_\br_\bt_\b__\br_\be
8641
8642        Type: boolean
8643
8644        Default: yes
8645
8646        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
8647        (section 7.4.325  , page 168)'' _\bu_\bn_\bs_\be_\bt. In that case, it changes the heuristic
8648        Mutt-ng uses to thread messages by subject.  With _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.308  ,
8649        page 163) _\bs_\be_\bt, Mutt-ng will only attach a message as the child of another mes-
8650        sage by subject if the subject of the child message starts with a substring
8651        matching the setting of ``_\b$_\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.244  , page 147)''. With
8652        _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.308  , page 163) _\bu_\bn_\bs_\be_\bt, Mutt-ng will attach the message
8653        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
8654        7.4.244  , page 147)'' parts of both messages are identical.
8655
8656        _\b7_\b._\b4_\b._\b3_\b0_\b9  _\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br
8657
8658        Type: string
8659
8660        Default: ','
8661
8662        ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.309  , page 163)'' controls what happens when
8663        multiple spam headers are matched: if _\bu_\bn_\bs_\be_\bt, each successive header will over-
8664        write any previous matches value for the spam label. If _\bs_\be_\bt, each successive
8665        match will append to the previous, using ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.309  ,
8666        page 163)'' as a separator.
8667
8668        _\b7_\b._\b4_\b._\b3_\b1_\b0  _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be
8669
8670        Type: path
8671
8672        Default: ''
8673
8674        If your spool mailbox is in a non-default place where Mutt-ng cannot find it,
8675
8676        The Mutt Next Generation E-Mail Client                                      164
8677
8678        you can specify its location with this variable.  Mutt-ng will automatically
8679        set this variable to the value of the environment variable $MAIL if it is not
8680        set.
8681
8682        _\b7_\b._\b4_\b._\b3_\b1_\b1  _\bs_\bs_\bl_\b__\bc_\ba_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs_\b__\bf_\bi_\bl_\be
8683
8684        Type: path
8685
8686        Default: ''
8687
8688        This variable specifies a file containing trusted CA certificates.  Any server
8689        certificate that is signed with one of these CA certificates are also automati-
8690        cally accepted.
8691
8692        Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
8693
8694        _\b7_\b._\b4_\b._\b3_\b1_\b2  _\bs_\bs_\bl_\b__\bc_\bl_\bi_\be_\bn_\bt_\b__\bc_\be_\br_\bt
8695
8696        Type: path
8697
8698        Default: ''
8699
8700        Availability: SSL
8701
8702        The file containing a client certificate and its associated private key.
8703
8704        _\b7_\b._\b4_\b._\b3_\b1_\b3  _\bs_\bs_\bl_\b__\bf_\bo_\br_\bc_\be_\b__\bt_\bl_\bs
8705
8706        Type: boolean
8707
8708        Default: no
8709
8710        If this variable is _\bs_\be_\bt, mutt-ng will require that all connections to remote
8711        servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
8712        server does not advertise the capability, since it would otherwise have to
8713        abort the connection anyway. This option supersedes ``_\b$_\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs (section
8714        7.4.315  , page 164)''.
8715
8716        _\b7_\b._\b4_\b._\b3_\b1_\b4  _\bs_\bs_\bl_\b__\bm_\bi_\bn_\b__\bd_\bh_\b__\bp_\br_\bi_\bm_\be_\b__\bb_\bi_\bt_\bs
8717
8718        Type: number
8719
8720        Default: 0
8721
8722        Availability: GNUTLS
8723
8724        This variable specifies the minimum acceptable prime size (in bits) for use in
8725        any Diffie-Hellman key exchange. A value of 0 will use the default from the
8726        GNUTLS library.
8727
8728        _\b7_\b._\b4_\b._\b3_\b1_\b5  _\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs
8729
8730        Type: quadoption
8731
8732        The Mutt Next Generation E-Mail Client                                      165
8733
8734        Default: yes
8735
8736        Availability: SSL or GNUTLS
8737
8738        If _\bs_\be_\bt (the default), Mutt-ng will attempt to use STARTTLS on servers advertis-
8739        ing the capability. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not attempt to use STARTTLS
8740        regardless of the server's capabilities.
8741
8742        _\b7_\b._\b4_\b._\b3_\b1_\b6  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b2
8743
8744        Type: boolean
8745
8746        Default: yes
8747
8748        Availability: SSL
8749
8750        This variables specifies whether to attempt to use SSLv2 in the SSL authentica-
8751        tion process.
8752
8753        _\b7_\b._\b4_\b._\b3_\b1_\b7  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b3
8754
8755        Type: boolean
8756
8757        Default: yes
8758
8759        Availability: SSL or GNUTLS
8760
8761        This variables specifies whether to attempt to use SSLv3 in the SSL authentica-
8762        tion process.
8763
8764        _\b7_\b._\b4_\b._\b3_\b1_\b8  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bt_\bl_\bs_\bv_\b1
8765
8766        Type: boolean
8767
8768        Default: yes
8769
8770        Availability: SSL or GNUTLS
8771
8772        This variables specifies whether to attempt to use TLSv1 in the SSL authentica-
8773        tion process.
8774
8775        _\b7_\b._\b4_\b._\b3_\b1_\b9  _\bs_\bs_\bl_\b__\bu_\bs_\be_\bs_\by_\bs_\bt_\be_\bm_\bc_\be_\br_\bt_\bs
8776
8777        Type: boolean
8778
8779        Default: yes
8780
8781        Availability: SSL
8782
8783        If set to _\by_\be_\bs, Mutt-ng will use CA certificates in the system-wide certificate
8784        store when checking if server certificate is signed by a trusted CA.
8785
8786        _\b7_\b._\b4_\b._\b3_\b2_\b0  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs
8787
8788        The Mutt Next Generation E-Mail Client                                      166
8789
8790        Type: string
8791
8792        Default: '-*%A'
8793
8794        Controls the characters used by the ``%r'' indicator in ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (sec-
8795        tion 7.4.321  , page 165)''. The first character is used when the mailbox is
8796        unchanged. The second is used when the mailbox has been changed, and it needs
8797        to be resynchronized. The third is used if the mailbox is in read-only mode, or
8798        if the mailbox will not be written when exiting that mailbox (You can toggle
8799        whether to write changes to a mailbox with the toggle-write operation, bound by
8800        default to ``%'').  The fourth  is used to indicate that the current folder has
8801        been opened in attach-message mode (Certain operations like composing a new
8802        mail, replying, forwarding, etc. are not permitted in this mode).
8803
8804        _\b7_\b._\b4_\b._\b3_\b2_\b1  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
8805
8806        Type: string
8807
8808        Default: '-%r-Mutt-ng: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d?
8809        Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l?
8810        %l?]---(%s/%S)-%>-(%P)---'
8811
8812        Controls the format of the status line displayed in the _\bi_\bn_\bd_\be_\bx menu.  This
8813        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
8814        its own set of printf(3)-like sequences:
8815
8816              %b
8817                    number of mailboxes with new mail *
8818
8819              %B
8820                    the short pathname of the current mailbox
8821
8822              %d
8823                    number of deleted messages *
8824
8825              %f
8826                    the full pathname of the current mailbox
8827
8828              %F
8829                    number of flagged messages *
8830
8831              %h
8832                    local hostname
8833
8834              %l
8835                    size (in bytes) of the current mailbox *
8836
8837              %L
8838                    size (in bytes) of the messages shown (i.e., which match the cur-
8839                    rent limit) *
8840
8841              %m
8842                    the number of messages in the mailbox *
8843
8844        The Mutt Next Generation E-Mail Client                                      167
8845
8846              %M
8847                    the number of messages shown (i.e., which match the current limit)
8848                    *
8849
8850              %n
8851                    number of new messages in the mailbox *
8852
8853              %o
8854                    number of old unread messages *
8855
8856              %p
8857                    number of postponed messages *
8858
8859              %P
8860                    percentage of the way through the index
8861
8862              %r
8863                    modified/read-only/won't-write/attach-message indicator, according
8864                    to _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs (section 7.4.320  , page 165)
8865
8866              %s
8867                    current sorting mode (_\b$_\bs_\bo_\br_\bt (section 7.4.304  , page 161))
8868
8869              %S
8870                    current aux sorting method (_\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx (section 7.4.306  , page
8871                    162))
8872
8873              %t
8874                    number of tagged messages *
8875
8876              %u
8877                    number of unread messages *
8878
8879              %v
8880                    Mutt-ng version string
8881
8882              %V
8883                    currently active limit pattern, if any *
8884
8885              %>X
8886                    right justify the rest of the string and pad with 'X'
8887
8888              %|X
8889                    pad to the end of the line with 'X'
8890
8891        * = can be optionally printed if nonzero
8892
8893        Some of the above sequences can be used to optionally print a string if their
8894        value is nonzero.  For example, you may only want to see the number of flagged
8895        messages if such messages exist, since zero is not particularly meaningful.  To
8896        optionally print a string based upon one of the above sequences, the following
8897        construct is used
8898
8899        %?<sequence_char>?<optional_string>?
8900
8901        The Mutt Next Generation E-Mail Client                                      168
8902
8903        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
8904        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
8905        m\bma\bay\by contain other sequences as well as normal text, but you may n\bno\bot\bt nest
8906        optional strings.
8907
8908        Here is an example illustrating how to optionally print the number of new mes-
8909        sages in a mailbox:
8910
8911        %?n?%n new messages.?
8912
8913        Additionally you can switch between two strings, the first one, if a value is
8914        zero, the second one, if the value is nonzero, by using the following con-
8915        struct:
8916
8917        %?<sequence_char>?<if_string>&<else_string>?
8918
8919        You can additionally force the result of any printf(3)-like sequence to be low-
8920        ercase by prefixing the sequence character with an underscore (_) sign.  For
8921        example, if you want to display the local hostname in lowercase, you would use:
8922
8923        %_h
8924
8925        If you prefix the sequence character with a colon (:) character, Mutt-ng will
8926        replace any dots in the expansion by underscores. This might be helpful with
8927        IMAP folders that don't like dots in folder names.
8928
8929        _\b7_\b._\b4_\b._\b3_\b2_\b2  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bo_\bn_\b__\bt_\bo_\bp
8930
8931        Type: boolean
8932
8933        Default: no
8934
8935        Setting this variable causes the ``status bar'' to be displayed on the first
8936        line of the screen rather than near the bottom.
8937
8938        _\b7_\b._\b4_\b._\b3_\b2_\b3  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo
8939
8940        Type: boolean
8941
8942        Default: yes
8943
8944        With mailto: style links, a body as well as arbitrary header information may be
8945        embedded. This may lead to (user) headers being overwriten without note if
8946        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102)'' is unset.
8947
8948        If this variable is _\bs_\be_\bt, mutt-ng is strict and allows anything to be changed.
8949        If it's _\bu_\bn_\bs_\be_\bt, all headers given will be prefixed with ``X-Mailto-'' and the
8950        message including headers will be shown in the editor regardless of what
8951        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.59  , page 102)'' is set to.
8952
8953        _\b7_\b._\b4_\b._\b3_\b2_\b4  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be
8954
8955        Type: boolean
8956
8957        The Mutt Next Generation E-Mail Client                                      169
8958
8959        Default: yes
8960
8961        When _\bu_\bn_\bs_\be_\bt, non MIME-compliant messages that doesn't have any charset indica-
8962        tion in the ``Content-Type:'' header field can be displayed (non MIME-compliant
8963        messages are often generated by old mailers or buggy mailers like MS Outlook
8964        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).
8965
8966        This option also replaces linear-white-space between encoded-word and *text to
8967        a single space to prevent the display of MIME-encoded ``Subject:'' header field
8968        from being devided into multiple lines.
8969
8970        _\b7_\b._\b4_\b._\b3_\b2_\b5  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
8971
8972        Type: boolean
8973
8974        Default: no
8975
8976        If _\bs_\be_\bt, threading will only make use of the ``In-Reply-To:'' and ``Refer-
8977        ences:'' header fields when you ``_\b$_\bs_\bo_\br_\bt (section 7.4.304  , page 161)'' by mes-
8978        sage threads.  By default, messages with the same subject are grouped together
8979        in ``pseudo threads.''  This may not always be desirable, such as in a personal
8980        mailbox where you might have several unrelated messages with the subject ``hi''
8981        which will get grouped together.
8982
8983        _\b7_\b._\b4_\b._\b3_\b2_\b6  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs
8984
8985        Type: boolean
8986
8987        Default: no
8988
8989        When _\bs_\be_\bt, mutt-ng will remove the trailing part of the ``Subject:'' line which
8990        matches _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx (section 7.4.327  , page 169) when replying. This is
8991        useful to properly react on subject changes and reduce ``subject noise.'' (esp.
8992        in Usenet)
8993
8994        _\b7_\b._\b4_\b._\b3_\b2_\b7  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx
8995
8996        Type: regular expression
8997
8998        Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$'
8999
9000        When non-empty and _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs (section 7.4.326  , page 169) is _\bs_\be_\bt, mutt-ng
9001        will remove this trailing part of the ``Subject'' line when replying if it
9002        won't be empty afterwards.
9003
9004        _\b7_\b._\b4_\b._\b3_\b2_\b8  _\bs_\bt_\bu_\bf_\bf_\b__\bq_\bu_\bo_\bt_\be_\bd
9005
9006        Type: boolean
9007
9008        Default: no
9009
9010        If _\bs_\be_\bt, attachments with flowed format will have their quoting ``stuffed'',
9011        i.e. a space will be inserted between the quote characters and the actual text.
9012
9013        The Mutt Next Generation E-Mail Client                                      170
9014
9015        _\b7_\b._\b4_\b._\b3_\b2_\b9  _\bs_\bu_\bs_\bp_\be_\bn_\bd
9016
9017        Type: boolean
9018
9019        Default: yes
9020
9021        When _\bu_\bn_\bs_\be_\bt, Mutt-ng won't stop when the user presses the terminal's _\bs_\bu_\bs_\bp key,
9022        usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a com-
9023        mand like ``xterm -e muttng.''
9024
9025        _\b7_\b._\b4_\b._\b3_\b3_\b0  _\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd
9026
9027        Type: boolean
9028
9029        Default: no
9030
9031        When _\bs_\be_\bt, Mutt-ng will generate text/plain; format=flowed attachments.  This
9032        format is easier to handle for some mailing software, and generally just looks
9033        like ordinary text.  To actually make use of this format's features, you'll
9034        need support in your editor.
9035
9036        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
9037        option is set.
9038
9039        _\b7_\b._\b4_\b._\b3_\b3_\b1  _\bt_\bh_\bo_\br_\bo_\bu_\bg_\bh_\b__\bs_\be_\ba_\br_\bc_\bh
9040
9041        Type: boolean
9042
9043        Default: no
9044
9045        Affects the ~b and ~h search operations described in section ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
9046        tion 7.2  , page 83)'' above.  If _\bs_\be_\bt, the headers and attachments of messages
9047        to be searched are decoded before searching.  If _\bu_\bn_\bs_\be_\bt, messages are searched
9048        as they appear in the folder.
9049
9050        _\b7_\b._\b4_\b._\b3_\b3_\b2  _\bt_\bh_\br_\be_\ba_\bd_\b__\br_\be_\bc_\be_\bi_\bv_\be_\bd
9051
9052        Type: boolean
9053
9054        Default: no
9055
9056        When _\bs_\be_\bt, Mutt-ng uses the date received rather than the date sent to thread
9057        messages by subject.
9058
9059        _\b7_\b._\b4_\b._\b3_\b3_\b3  _\bt_\bi_\bl_\bd_\be
9060
9061        Type: boolean
9062
9063        Default: no
9064
9065        When _\bs_\be_\bt, the internal-pager will pad blank lines to the bottom of the screen
9066        with a tilde (~).
9067
9068        The Mutt Next Generation E-Mail Client                                      171
9069
9070        _\b7_\b._\b4_\b._\b3_\b3_\b4  _\bt_\bi_\bm_\be_\bo_\bu_\bt
9071
9072        Type: number
9073
9074        Default: 600
9075
9076        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
9077        pressed in the main menu before timing out and checking for new mail.  A value
9078        of zero or less will cause Mutt-ng to never time out.
9079
9080        _\b7_\b._\b4_\b._\b3_\b3_\b5  _\bt_\bm_\bp_\bd_\bi_\br
9081
9082        Type: path
9083
9084        Default: ''
9085
9086        This variable allows you to specify where Mutt-ng will place its temporary
9087        files needed for displaying and composing messages.  If this variable is not
9088        set, the environment variable $TMPDIR is used.  If $TMPDIR is not set then
9089        '/tmp' is used.
9090
9091        _\b7_\b._\b4_\b._\b3_\b3_\b6  _\bt_\bo_\b__\bc_\bh_\ba_\br_\bs
9092
9093        Type: string
9094
9095        Default: ' +TCFL'
9096
9097        Controls the character used to indicate mail addressed to you.  The first char-
9098        acter is the one used when the mail is NOT addressed to your address (default:
9099        space).  The second is used when you are the only recipient of the message
9100        (default: +).  The third is when your address appears in the ``To:'' header
9101        field, but you are not the only recipient of the message (default: T).  The
9102        fourth character is used when your address is specified in the ``Cc:'' header
9103        field, but you are not the only recipient.  The fifth character is used to
9104        indicate mail that was sent by _\by_\bo_\bu.  The sixth character is used to indicate
9105        when a mail was sent to a mailing-list you're subscribe to (default: L).
9106
9107        _\b7_\b._\b4_\b._\b3_\b3_\b7  _\bt_\br_\ba_\bs_\bh
9108
9109        Type: path
9110
9111        Default: ''
9112
9113        If _\bs_\be_\bt, this variable specifies the path of the trash folder where the mails
9114        marked for deletion will be moved, instead of being irremediably purged.
9115
9116        N\bNo\bot\bte\be: When you delete a message in the trash folder, it is really deleted, so
9117        that there is no way to recover mail.
9118
9119        _\b7_\b._\b4_\b._\b3_\b3_\b8  _\bt_\bu_\bn_\bn_\be_\bl
9120
9121        Type: string
9122
9123        Default: ''
9124
9125        The Mutt Next Generation E-Mail Client                                      172
9126
9127        Setting this variable will cause Mutt-ng to open a pipe to a command instead of
9128        a raw socket. You may be able to use this to set up preauthenticated connec-
9129        tions to your IMAP/POP3 server. Example:
9130
9131        tunnel='ssh -q mailhost.net /usr/local/libexec/imapd'
9132
9133        N\bNo\bot\bte\be:\b: For this example to work you must be able to log in to the remote machine
9134        without having to enter a password.
9135
9136        _\b7_\b._\b4_\b._\b3_\b3_\b9  _\bu_\bm_\ba_\bs_\bk
9137
9138        Type: number
9139
9140        Default: 0077
9141
9142        This sets the umask that will be used by Mutt-ng when creating all kinds of
9143        files. If _\bu_\bn_\bs_\be_\bt, the default value is 077.
9144
9145        _\b7_\b._\b4_\b._\b3_\b4_\b0  _\bu_\bn_\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bj_\bu_\bm_\bp
9146
9147        Type: boolean
9148
9149        Default: no
9150
9151        When _\bs_\be_\bt, Mutt-ng will jump to the next unread message, if any, when the cur-
9152        rent thread is _\bu_\bncollapsed.
9153
9154        _\b7_\b._\b4_\b._\b3_\b4_\b1  _\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be
9155
9156        Type: boolean
9157
9158        Default: no
9159
9160        W\bWa\bar\brn\bni\bin\bng\bg:\b: do not set this variable unless you are using a version of sendmail
9161        which supports the -B8BITMIME flag (such as sendmail 8.8.x) or in connection
9162        with the SMTP support via libESMTP.  Otherwise you may not be able to send
9163        mail.
9164
9165        When _\bs_\be_\bt, Mutt-ng will either invoke ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.260  , page
9166        151)'' with the -B8BITMIME flag when sending 8-bit messages to enable ESMTP
9167        negotiation or tell libESMTP to do so.
9168
9169        _\b7_\b._\b4_\b._\b3_\b4_\b2  _\bu_\bs_\be_\b__\bd_\bo_\bm_\ba_\bi_\bn
9170
9171        Type: boolean
9172
9173        Default: yes
9174
9175        When _\bs_\be_\bt, Mutt-ng will qualify all local addresses (ones without the @host por-
9176        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,
9177        no addresses will be qualified.
9178
9179        _\b7_\b._\b4_\b._\b3_\b4_\b3  _\bu_\bs_\be_\b__\bf_\br_\bo_\bm
9180
9181        The Mutt Next Generation E-Mail Client                                      173
9182
9183        Type: boolean
9184
9185        Default: yes
9186
9187        When _\bs_\be_\bt, Mutt-ng will generate the ``From:'' header field when sending mes-
9188        sages. If _\bu_\bn_\bs_\be_\bt, no ``From:'' header field will be generated unless the user
9189        explicitly sets one using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.16  , page 37)'' command.
9190
9191        _\b7_\b._\b4_\b._\b3_\b4_\b4  _\bu_\bs_\be_\b__\bi_\bd_\bn
9192
9193        Type: boolean
9194
9195        Default: yes
9196
9197        Availability: IDN
9198
9199        When _\bs_\be_\bt, Mutt-ng will show you international domain names decoded.
9200
9201        N\bNo\bot\bte\be:\b: You can use IDNs for addresses even if this is _\bu_\bn_\bs_\be_\bt.  This variable only
9202        affects decoding.
9203
9204        _\b7_\b._\b4_\b._\b3_\b4_\b5  _\bu_\bs_\be_\b__\bi_\bp_\bv_\b6
9205
9206        Type: boolean
9207
9208        Default: yes
9209
9210        When _\bs_\be_\bt, Mutt-ng will look for IPv6 addresses of hosts it tries to contact.
9211        If this option is _\bu_\bn_\bs_\be_\bt, Mutt-ng will restrict itself to IPv4 addresses.  Nor-
9212        mally, the default should work.
9213
9214        _\b7_\b._\b4_\b._\b3_\b4_\b6  _\bv_\bi_\bs_\bu_\ba_\bl
9215
9216        Type: path
9217
9218        Default: ''
9219
9220        Specifies the visual editor to invoke when the _\b~_\bv command is given in the
9221        builtin editor.
9222
9223        _\b7_\b._\b4_\b._\b3_\b4_\b7  _\bw_\ba_\bi_\bt_\b__\bk_\be_\by
9224
9225        Type: boolean
9226
9227        Default: yes
9228
9229        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-
9230        _\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.
9231
9232        It is also used when viewing attachments with ``_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page
9233        78)'', provided that the corresponding mailcap entry has a needsterminal flag,
9234        and the external program is interactive.
9235
9236        When _\bs_\be_\bt, Mutt-ng will always ask for a key. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will wait for
9237
9238        The Mutt Next Generation E-Mail Client                                      174
9239
9240        a key only if the external command returned a non-zero status.
9241
9242        _\b7_\b._\b4_\b._\b3_\b4_\b8  _\bw_\be_\be_\bd
9243
9244        Type: boolean
9245
9246        Default: yes
9247
9248        When _\bs_\be_\bt, Mutt-ng will weed headers when displaying, forwarding, printing, or
9249        replying to messages.
9250
9251        _\b7_\b._\b4_\b._\b3_\b4_\b9  _\bw_\br_\ba_\bp_\b__\bs_\be_\ba_\br_\bc_\bh
9252
9253        Type: boolean
9254
9255        Default: yes
9256
9257        Controls whether searches wrap around the end of the mailbox.
9258
9259        When _\bs_\be_\bt, searches will wrap around the first (or last) message. When _\bu_\bn_\bs_\be_\bt,
9260        searches will not wrap.
9261
9262        _\b7_\b._\b4_\b._\b3_\b5_\b0  _\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
9263
9264        Type: number
9265
9266        Default: 0
9267
9268        Controls the size of the margin remaining at the right side of the terminal
9269        when Mutt-ng's pager does smart wrapping.
9270
9271        _\b7_\b._\b4_\b._\b3_\b5_\b1  _\bw_\br_\bi_\bt_\be_\b__\bb_\bc_\bc
9272
9273        Type: boolean
9274
9275        Default: yes
9276
9277        Controls whether Mutt-ng writes out the Bcc header when preparing messages to
9278        be sent.  Exim users may wish to _\bu_\bn_\bs_\be_\bt this.
9279
9280        _\b7_\b._\b4_\b._\b3_\b5_\b2  _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc
9281
9282        Type: number
9283
9284        Default: 10
9285
9286        When writing a mailbox, a message will be printed every _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc messages to
9287        indicate progress.  If set to 0, only a single message will be displayed before
9288        writing a mailbox.
9289
9290        Also see the ``_\b$_\br_\be_\ba_\bd_\b__\bi_\bn_\bc (section 7.4.239  , page 146)'' variable.
9291
9292        _\b7_\b._\b4_\b._\b3_\b5_\b3  _\bx_\bt_\be_\br_\bm_\b__\bi_\bc_\bo_\bn
9293
9294        The Mutt Next Generation E-Mail Client                                      175
9295
9296        Type: string
9297
9298        Default: 'M%?n?AIL&ail?'
9299
9300        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-
9301        tion 7.4.355  , page 175) is _\bs_\be_\bt. This string is identical in formatting to the
9302        one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.321  , page 165)''.
9303
9304        _\b7_\b._\b4_\b._\b3_\b5_\b4  _\bx_\bt_\be_\br_\bm_\b__\bl_\be_\ba_\bv_\be
9305
9306        Type: string
9307
9308        Default: ''
9309
9310        If _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.355  , page 175) is _\bs_\be_\bt, this string will be
9311        used to set the title when leaving mutt-ng. For terminal-based programs,
9312        there's no easy and portable way to read the current title so mutt-ng cannot
9313        read it upon startup and restore it when exiting.
9314
9315        Based on the xterm FAQ, the following might work:
9316
9317        set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME |
9318        cut -d ''' -f 2`'
9319
9320        _\b7_\b._\b4_\b._\b3_\b5_\b5  _\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs
9321
9322        Type: boolean
9323
9324        Default: no
9325
9326        Controls whether Mutt-ng sets the xterm title bar and icon name (as long as
9327        you're in an appropriate terminal). The default must be _\bu_\bn_\bs_\be_\bt to force in the
9328        validity checking.
9329
9330        _\b7_\b._\b4_\b._\b3_\b5_\b6  _\bx_\bt_\be_\br_\bm_\b__\bt_\bi_\bt_\bl_\be
9331
9332        Type: string
9333
9334        Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?'
9335
9336        Controls the format of the title bar of the xterm provided that
9337        _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.355  , page 175) has been _\bs_\be_\bt. This string is
9338        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.321  ,
9339        page 165)''.
9340
9341        _\b7_\b._\b5  _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
9342
9343        The following is the list of available functions listed by the mapping in which
9344        they are available.  The default key setting is given, and an explanation of
9345        what the function does.  The key bindings of these functions can be changed
9346        with the _\bb_\bi_\bn_\bd (section 3.5  , page 27) command.
9347
9348        _\b7_\b._\b5_\b._\b1  _\bg_\be_\bn_\be_\br_\bi_\bc
9349
9350        The Mutt Next Generation E-Mail Client                                      176
9351
9352        The _\bg_\be_\bn_\be_\br_\bi_\bc menu is not a real menu, but specifies common functions (such as
9353        movement) available in all menus except for _\bp_\ba_\bg_\be_\br and _\be_\bd_\bi_\bt_\bo_\br.  Changing set-
9354        tings for this menu will affect the default bindings for all menus (except as
9355        noted).
9356
9357             bottom-page                L   move to the bottom of the page
9358             current-bottom     not bound   move current entry to bottom of page
9359             current-middle     not bound   move current entry to middle of page
9360             current-top        not bound   move current entry to top of page
9361             enter-command              :   enter a muttngrc command
9362             exit                       q   exit this menu
9363             first-entry                =   move to the first entry
9364             half-down                  ]   scroll down 1/2 page
9365             half-up                    [   scroll up 1/2 page
9366             help                       ?   this screen
9367             jump                  number   jump to an index number
9368             last-entry                 *   move to the last entry
9369             middle-page                M   move to the middle of the page
9370             next-entry                 j   move to the next entry
9371             next-line                  >   scroll down one line
9372             next-page                  z   move to the next page
9373             previous-entry             k   move to the previous entry
9374             previous-line              <   scroll up one line
9375             previous-page              Z   move to the previous page
9376             refresh                   ^L   clear and redraw the screen
9377             search                     /   search for a regular expression
9378             search-next                n   search for next match
9379             search-opposite    not bound   search for next match in opposite direction
9380             search-reverse         ESC /   search backwards for a regular expression
9381             select-entry             RET   select the current entry
9382             shell-escape               !   run a program in a subshell
9383             tag-entry                  t   toggle the tag on the current entry
9384             tag-prefix                 ;   apply next command to tagged entries
9385             tag-prefix-cond    not bound   apply next function ONLY to tagged messages
9386             top-page                   H   move to the top of the page
9387             what-key           not bound   display the keycode for a key press
9388
9389        _\b7_\b._\b5_\b._\b2  _\bi_\bn_\bd_\be_\bx
9390
9391        The Mutt Next Generation E-Mail Client                                      177
9392
9393             bounce-message             b   remail a message to another user
9394             change-folder              c   open a different folder
9395             change-folder-readonly ESC c   open a different folder in read only mode
9396             check-traditional-pgp  ESC P   check for classic pgp
9397             clear-flag                 W   clear a status flag from a message
9398             copy-message               C   copy a message to a file/mailbox
9399             create-alias               a   create an alias from a message sender
9400             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9401             decode-save            ESC s   decode a message and save it to a file/mailbox
9402             delete-message             d   delete the current entry
9403             delete-pattern             D   delete messages matching a pattern
9404             delete-subthread       ESC d   delete all messages in subthread
9405             delete-thread             ^D   delete all messages in thread
9406             display-address            @   display full address of sender
9407             display-toggle-weed        h   display message and toggle header weeding
9408             display-message          RET   display a message
9409             edit                       e   edit the current message
9410             edit-type                 ^E   edit the current message's Content-Type
9411             exit                       x   exit without saving changes
9412             extract-keys              ^K   extract PGP public keys
9413             fetch-mail                 G   retrieve mail from POP server
9414             flag-message               F   toggle a message's 'important' flag
9415             forget-passphrase         ^F   wipe PGP passphrase from memory
9416             forward-message            f   forward a message with comments
9417             group-reply                g   reply to all recipients
9418             limit                      l   show only messages matching a pattern
9419             list-reply                 L   reply to specified mailing list
9420             mail                       m   compose a new mail message
9421             mail-key               ESC k   mail a PGP public key
9422             next-new                 TAB   jump to the next new message
9423             next-subthread         ESC n   jump to the next subthread
9424             next-thread               ^N   jump to the next thread
9425             next-undeleted             j   move to the next undeleted message
9426             next-unread        not bound   jump to the next unread message
9427             parent-message             P   jump to parent message in thread
9428             pipe-message               |   pipe message/attachment to a shell command
9429             previous-new         ESC TAB   jump to the previous new message
9430             previous-page              Z   move to the previous page
9431             previous-subthread     ESC p   jump to previous subthread
9432             previous-thread           ^P   jump to previous thread
9433             previous-undeleted         k   move to the last undelete message
9434             previous-unread    not bound   jump to the previous unread message
9435             print-message              p   print the current entry
9436             query                      Q   query external program for addresses
9437             quit                       q   save changes to mailbox and quit
9438             read-subthread         ESC r   mark the current subthread as read
9439             read-thread               ^R   mark the current thread as read
9440             recall-message             R   recall a postponed message
9441             reply                      r   reply to a message
9442             resend-message         ESC e   resend message and preserve MIME structure
9443             save-message               s   save message/attachment to a file
9444             set-flag                   w   set a status flag on a message
9445             show-version               V   show the Mutt-ng version number and date
9446             show-limit             ESC l   show currently active limit pattern, if any
9447
9448        The Mutt Next Generation E-Mail Client                                      178
9449
9450             sort-mailbox               o   sort messages
9451             sort-reverse               O   sort messages in reverse order
9452             sync-mailbox               $   save changes to mailbox
9453             tag-pattern                T   tag messages matching a pattern
9454             tag-thread             ESC t   tag/untag all messages in the current thread
9455             toggle-new                 N   toggle a message's 'new' flag
9456             toggle-write               %   toggle whether the mailbox will be rewritten
9457             undelete-message           u   undelete the current entry
9458             undelete-pattern           U   undelete messages matching a pattern
9459             undelete-subthread     ESC u   undelete all messages in subthread
9460             undelete-thread           ^U   undelete all messages in thread
9461             untag-pattern             ^T   untag messages matching a pattern
9462             view-attachments           v   show MIME attachments
9463
9464        _\b7_\b._\b5_\b._\b3  _\bp_\ba_\bg_\be_\br
9465
9466        The Mutt Next Generation E-Mail Client                                      179
9467
9468             bottom             not bound   jump to the bottom of the message
9469             bounce-message             b   remail a message to another user
9470             change-folder              c   open a different folder
9471             change-folder-readonly ESC c   open a different folder in read only mode
9472             check-traditional-pgp  ESC P   check for classic pgp
9473             copy-message               C   copy a message to a file/mailbox
9474             create-alias               a   create an alias from a message sender
9475             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9476             decode-save            ESC s   decode a message and save it to a file/mailbox
9477             delete-message             d   delete the current entry
9478             delete-subthread       ESC d   delete all messages in subthread
9479             delete-thread             ^D   delete all messages in thread
9480             display-address            @   display full address of sender
9481             display-toggle-weed        h   display message and toggle header weeding
9482             edit                       e   edit the current message
9483             edit-type                 ^E   edit the current message's Content-Type
9484             enter-command              :   enter a muttngrc command
9485             exit                       i   return to the main-menu
9486             extract-keys              ^K   extract PGP public keys
9487             flag-message               F   toggle a message's 'important' flag
9488             forget-passphrase         ^F   wipe PGP passphrase from memory
9489             forward-message            f   forward a message with comments
9490             group-reply                g   reply to all recipients
9491             half-up            not bound   move up one-half page
9492             half-down          not bound   move down one-half page
9493             help                       ?   this screen
9494             list-reply                 L   reply to specified mailing list
9495             mail                       m   compose a new mail message
9496             mail-key               ESC k   mail a PGP public key
9497             mark-as-new                N   toggle a message's 'new' flag
9498             next-line                RET   scroll down one line
9499             next-entry                 J   move to the next entry
9500             next-new                 TAB   jump to the next new message
9501             next-page                      move to the next page
9502             next-subthread         ESC n   jump to the next subthread
9503             next-thread               ^N   jump to the next thread
9504             next-undeleted             j   move to the next undeleted message
9505             next-unread        not bound   jump to the next unread message
9506             parent-message             P   jump to parent message in thread
9507             pipe-message               |   pipe message/attachment to a shell command
9508             previous-line      BackSpace   scroll up one line
9509             previous-entry             K   move to the previous entry
9510             previous-new       not bound   jump to the previous new message
9511             previous-page              -   move to the previous page
9512             previous-subthread     ESC p   jump to previous subthread
9513             previous-thread           ^P   jump to previous thread
9514             previous-undeleted         k   move to the last undelete message
9515             previous-unread    not bound   jump to the previous unread message
9516             print-message              p   print the current entry
9517             quit                       Q   save changes to mailbox and quit
9518             read-subthread         ESC r   mark the current subthread as read
9519             read-thread               ^R   mark the current thread as read
9520             recall-message             R   recall a postponed message
9521             redraw-screen             ^L   clear and redraw the screen
9522
9523        The Mutt Next Generation E-Mail Client                                      180
9524
9525             reply                      r   reply to a message
9526             save-message               s   save message/attachment to a file
9527             search                     /   search for a regular expression
9528             search-next                n   search for next match
9529             search-opposite    not bound   search for next match in opposite direction
9530             search-reverse         ESC /   search backwards for a regular expression
9531             search-toggle              \   toggle search pattern coloring
9532             shell-escape               !   invoke a command in a subshell
9533             show-version               V   show the Mutt-ng version number and date
9534             skip-quoted                S   skip beyond quoted text
9535             sync-mailbox               $   save changes to mailbox
9536             tag-message                t   tag a message
9537             toggle-quoted              T   toggle display of quoted text
9538             top                        ^   jump to the top of the message
9539             undelete-message           u   undelete the current entry
9540             undelete-subthread     ESC u   undelete all messages in subthread
9541             undelete-thread           ^U   undelete all messages in thread
9542             view-attachments           v   show MIME attachments
9543
9544        _\b7_\b._\b5_\b._\b4  _\ba_\bl_\bi_\ba_\bs
9545
9546             search                     /   search for a regular expression
9547             search-next                n   search for next match
9548             search-reverse         ESC /   search backwards for a regular expression
9549
9550        _\b7_\b._\b5_\b._\b5  _\bq_\bu_\be_\br_\by
9551
9552             create-alias               a   create an alias from a message sender
9553             mail                       m   compose a new mail message
9554             query                      Q   query external program for addresses
9555             query-append               A   append new query results to current results
9556             search                     /   search for a regular expression
9557             search-next                n   search for next match
9558             search-opposite    not bound   search for next match in opposite direction
9559             search-reverse         ESC /   search backwards for a regular expression
9560
9561        _\b7_\b._\b5_\b._\b6  _\ba_\bt_\bt_\ba_\bc_\bh
9562
9563        The Mutt Next Generation E-Mail Client                                      181
9564
9565             bounce-message             b   remail a message to another user
9566             collapse-parts             v   toggle display of subparts
9567             delete-entry               d   delete the current entry
9568             display-toggle-weed        h   display message and toggle header weeding
9569             edit-type                 ^E   edit the current entry's Content-Type
9570             extract-keys              ^K   extract PGP public keys
9571             forward-message            f   forward a message with comments
9572             group-reply                g   reply to all recipients
9573             list-reply                 L   reply to specified mailing list
9574             pipe-entry                 |   pipe message/attachment to a shell command
9575             print-entry                p   print the current entry
9576             reply                      r   reply to a message
9577             resend-message         ESC e   resend message and preserve MIME structure
9578             save-entry                 s   save message/attachment to a file
9579             undelete-entry             u   undelete the current entry
9580             view-attach              RET   view attachment using mailcap entry if necessary
9581             view-mailcap               m   force viewing of attachment using mailcap
9582             view-text                  T   view attachment as text
9583
9584        _\b7_\b._\b5_\b._\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be
9585
9586        The Mutt Next Generation E-Mail Client                                      182
9587
9588             attach-file                a   attach a file(s) to this message
9589             attach-message             A   attach message(s) to this message
9590             attach-key             ESC k   attach a PGP public key
9591             copy-file                  C   save message/attachment to a file
9592             detach-file                D   delete the current entry
9593             display-toggle-weed        h   display message and toggle header weeding
9594             edit-bcc                   b   edit the BCC list
9595             edit-cc                    c   edit the CC list
9596             edit-description           d   edit attachment description
9597             edit-encoding             ^E   edit attachment transfer-encoding
9598             edit-fcc                   f   enter a file to save a copy of this message in
9599             edit-from              ESC f   edit the from: field
9600             edit-file               ^X e   edit the file to be attached
9601             edit-headers               E   edit the message with headers
9602             edit                       e   edit the message
9603             edit-mime                  m   edit attachment using mailcap entry
9604             edit-reply-to              r   edit the Reply-To field
9605             edit-subject               s   edit the subject of this message
9606             edit-to                    t   edit the TO list
9607             edit-type                 ^T   edit attachment type
9608             filter-entry               F   filter attachment through a shell command
9609             forget-passphrase         ^F   wipe PGP passphrase from memory
9610             ispell                     i   run ispell on the message
9611             new-mime                   n   compose new attachment using mailcap entry
9612             pgp-menu                   p   show PGP options
9613             pipe-entry                 |   pipe message/attachment to a shell command
9614             postpone-message           P   save this message to send later
9615             print-entry                l   print the current entry
9616             rename-file                R   rename/move an attached file
9617             send-message               y   send the message
9618             toggle-unlink              u   toggle whether to delete file after sending it
9619             view-attach              RET   view attachment using mailcap entry if necessary
9620             write-fcc         w   write the message to a folder
9621
9622        _\b7_\b._\b5_\b._\b8  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
9623
9624             delete-entry               d   delete the current entry
9625             undelete-entry             u   undelete the current entry
9626
9627        _\b7_\b._\b5_\b._\b9  _\bb_\br_\bo_\bw_\bs_\be_\br
9628
9629        The Mutt Next Generation E-Mail Client                                      183
9630
9631             change-dir                 c   change directories
9632             check-new                TAB   check mailboxes for new mail
9633             enter-mask                 m   enter a file mask
9634             search                     /   search for a regular expression
9635             search-next                n   search for next match
9636             search-reverse         ESC /   search backwards for a regular expression
9637             select-new                 N   select a new file in this directory
9638             sort                       o   sort messages
9639             sort-reverse               O   sort messages in reverse order
9640             toggle-mailboxes         TAB   toggle whether to browse mailboxes or all files
9641             view-file              SPACE   view file
9642             subscribe                  s   subscribe to current mailbox (IMAP Only)
9643             unsubscribe                u   unsubscribe to current mailbox (IMAP Only)
9644             toggle-subscribed          T   toggle view all/subscribed mailboxes (IMAP Only)
9645
9646        _\b7_\b._\b5_\b._\b1_\b0  _\bp_\bg_\bp
9647
9648             view-name                  %   view the key's user id
9649             verify-key                 c   verify a PGP public key
9650
9651        _\b7_\b._\b5_\b._\b1_\b1  _\be_\bd_\bi_\bt_\bo_\br
9652
9653             backspace          BackSpace   delete the char in front of the cursor
9654             backward-char             ^B   move the cursor one character to the left
9655             backward-word          ESC b   move the cursor to the previous word
9656             bol                       ^A   jump to the beginning of the line
9657             buffy-cycle            Space   cycle among incoming mailboxes
9658             capitalize-word        ESC c   uppercase the first character in the word
9659             complete                 TAB   complete filename or alias
9660             complete-query            ^T   complete address with query
9661             delete-char               ^D   delete the char under the cursor
9662             downcase-word          ESC l   lowercase all characters in current word
9663             eol                       ^E   jump to the end of the line
9664             forward-char              ^F   move the cursor one character to the right
9665             forward-word           ESC f   move the cursor to the next word
9666             history-down       not bound   scroll down through the history list
9667             history-up         not bound   scroll up through the history list
9668             kill-eol                  ^K   delete chars from cursor to end of line
9669             kill-eow               ESC d   delete chars from cursor to end of word
9670             kill-line                 ^U   delete all chars on the line
9671             kill-word                 ^W   delete the word in front of the cursor
9672             quote-char                ^V   quote the next typed key
9673             transpose-chars    not bound   transpose character under cursor with previous
9674             upcase-word            ESC u   uppercase all characters in current word
9675
9676        _\b8_\b.  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\by
9677
9678        The Mutt Next Generation E-Mail Client                                      184
9679
9680        _\b8_\b._\b1  _\bA_\bc_\bk_\bn_\bo_\bw_\bl_\be_\bd_\bg_\bm_\be_\bn_\bt_\bs
9681
9682        Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
9683        back in the ELM-ME days.
9684
9685        The following people have been very helpful to the development of Mutt:
9686
9687        Vikas Agnihotri <vikasa@writeme.com>,
9688
9689        Francois Berjon <Francois.Berjon@aar.alcatel-alsthom.fr>,
9690
9691        Aric Blumer <aric@fore.com>,
9692
9693        John Capo <jc@irbs.com>,
9694
9695        David Champion <dgc@uchicago.edu,
9696
9697        Brendan Cully <brendan@kublai.com>,
9698
9699        Liviu Daia <daia@stoilow.imar.ro>,
9700
9701        Thomas E. Dickey <dickey@herndon4.his.com>,
9702
9703        David DeSimone <fox@convex.hp.com>,
9704
9705        Nickolay N. Dudorov <nnd@wint.itfs.nsk.su>,
9706
9707        Ruslan Ermilov <ru@freebsd.org>,
9708
9709        Edmund Grimley Evans <edmundo@rano.org,
9710
9711        Michael Finken <finken@conware.de>,
9712
9713        Sven Guckes <guckes@math.fu-berlin.de>,
9714
9715        Lars Hecking <lhecking@nmrc.ie>,
9716
9717        Mark Holloman <holloman@nando.net>,
9718
9719        Andreas Holzmann <holzmann@fmi.uni-passau.de>,
9720
9721        Marco d'Itri <md@linux.it>,
9722
9723        Bjrn Jacke <bjacke@suse.com>,
9724
9725        Byrial Jensen <byrial@image.dk>,
9726
9727        David Jeske <jeske@igcom.net>,
9728
9729        Christophe Kalt <kalt@hugo.int-evry.fr>,
9730
9731        Tommi Komulainen <Tommi.Komulainen@iki.fi>,
9732
9733        Felix von Leitner (a.k.a ``Fefe'') <leitner@math.fu-berlin.de>,
9734
9735        The Mutt Next Generation E-Mail Client                                      185
9736
9737        Brandon Long <blong@fiction.net>,
9738
9739        Jimmy Mkel <jmy@flashback.net>,
9740
9741        Lars Marowsky-Bree <lmb@pointer.in-minden.de>,
9742
9743        Thomas ``Mike'' Michlmayr <mike@cosy.sbg.ac.at>,
9744
9745        Andrew W. Nosenko <awn@bcs.zp.ua>,
9746
9747        David O'Brien <obrien@Nuxi.cs.ucdavis.edu>,
9748
9749        Clint Olsen <olsenc@ichips.intel.com>,
9750
9751        Park Myeong Seok <pms@romance.kaist.ac.kr>,
9752
9753        Thomas Parmelan <tom@ankh.fr.eu.org>,
9754
9755        Ollivier Robert <roberto@keltia.freenix.fr>,
9756
9757        Thomas Roessler <roessler@does-not-exist.org>,
9758
9759        Roland Rosenfeld <roland@spinnaker.de>,
9760
9761        TAKIZAWA Takashi <taki@luna.email.ne.jp>,
9762
9763        Allain Thivillon <Allain.Thivillon@alma.fr>,
9764
9765        Gero Treuner <gero@faveve.uni-stuttgart.de>,
9766
9767        Vsevolod Volkov <vvv@lucky.net>,
9768
9769        Ken Weinert <kenw@ihs.com>
9770
9771        Mutt-ng is developed by the following people:
9772
9773        Andreas Krennmair <ak@synflood.at>
9774
9775        Nico Golde <nico@ngolde.de>
9776
9777        Rocco Rutte <pdmef@cs.tu-berlin.de>
9778
9779        The following people have been very helpful to the development of  Mutt-ng:
9780
9781        Christian Gall <cg@cgall.de>
9782
9783        Iain Lea <iain@bricbrac.de>
9784
9785        Andreas Kneib <akneib@gmx.net>
9786
9787        Carsten Schoelzki <cjs@weisshuhn.de>
9788
9789        Elimar Riesebieter <riesebie@lxtec.de>
9790
9791        The Mutt Next Generation E-Mail Client                                      186
9792
9793        _\b8_\b._\b2  _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt
9794
9795        This document was written in SGML, and then rendered using the sgml-tools pack-
9796        age.
9797
9798        The Mutt Next Generation E-Mail Client                                      187
9799
9800                                           CONTENTS
9801
9802        1.  Introduction   .......................................................... 1
9803            1.1   Overview   ........................................................ 1
9804            1.2   Mutt-ng Home Page   ............................................... 1
9805            1.3   Mailing Lists   ................................................... 1
9806            1.4   Software Distribution Sites   ..................................... 2
9807            1.5   IRC   ............................................................. 2
9808            1.6   Weblog   .......................................................... 2
9809            1.7   Copyright   ....................................................... 2
9810
9811        2.  Getting Started     ..................................................... 2
9812            2.1   Basic Concepts       .............................................. 2
9813                  2.1.1    Screens and Menus           3
9814                  2.1.2    Configuration           3
9815                  2.1.3    Functions           3
9816                  2.1.4    Interaction           4
9817                  2.1.5    Modularization           4
9818                  2.1.6    Patterns           4
9819            2.2   Screens and Menus       ........................................... 4
9820                  2.2.1    Index          4
9821                  2.2.2    Pager          5
9822                  2.2.3    File Browser           5
9823                  2.2.4    Sidebar           5
9824                  2.2.5    Help           5
9825                  2.2.6    Compose Menu             6
9826                  2.2.7    Alias Menu             6
9827                  2.2.8    Attachment Menu             6
9828                  2.2.9    Key Menu             6
9829            2.3   Moving Around in Menus   .......................................... 6
9830            2.4   Editing Input Fields   ............................................ 7
9831            2.5   Reading Mail - The Index and Pager   .............................. 8
9832                  2.5.1    The Message Index   8
9833                  2.5.2    The Pager   9
9834                  2.5.3    Threaded Mode   11
9835                  2.5.4    Miscellaneous Functions   11
9836            2.6   Sending Mail   ................................................... 14
9837                  2.6.1    Composing new messages     14
9838                  2.6.2    Replying         16
9839                  2.6.3    Editing the message header     17
9840                  2.6.4    Using Mutt-ng with PGP     18
9841                  2.6.5    Sending anonymous messages via mixmaster     19
9842            2.7   Forwarding and Bouncing Mail   ................................... 19
9843            2.8   Postponing Mail   ................................................ 20
9844
9845        3.  Configuration   ........................................................ 21
9846            3.1   Locations of Configuration Files   ............................... 21
9847            3.2   Basic Syntax of Initialization Files   ........................... 21
9848            3.3   Expansion within variables     ................................... 23
9849                  3.3.1    Commands' Output        23
9850                  3.3.2    Environment Variables        23
9851
9852                                               i
9853
9854                  3.3.3    Configuration Variables        23
9855                  3.3.4    Self-Defined Variables        24
9856                  3.3.5    Pre-Defined Variables        25
9857                  3.3.6    Type Conversions        25
9858            3.4   Defining/Using aliases   ......................................... 26
9859            3.5   Changing the default key bindings   .............................. 27
9860            3.6   Defining aliases for character sets    ........................... 29
9861            3.7   Setting variables based upon mailbox   ........................... 29
9862            3.8   Keyboard macros   ................................................ 29
9863            3.9   Using color and mono video attributes   .......................... 30
9864            3.10  Ignoring (weeding) unwanted message headers   .................... 32
9865            3.11  Alternative addresses   .......................................... 33
9866            3.12  Format = Flowed     .............................................. 34
9867                  3.12.1   Introduction         34
9868                  3.12.2   Receiving: Display Setup         34
9869                  3.12.3   Sending         35
9870                  3.12.4   Additional Notes    35
9871            3.13  Mailing lists   .................................................. 36
9872            3.14  Using Multiple spool mailboxes   ................................. 37
9873            3.15  Defining mailboxes which receive mail   .......................... 37
9874            3.16  User defined headers   ........................................... 37
9875            3.17  Defining the order of headers when viewing messages   ............ 38
9876            3.18  Specify default save filename   .................................. 38
9877            3.19  Specify default Fcc: mailbox when composing   .................... 39
9878            3.20  Specify default save filename and default Fcc: mailbox at once   . 39
9879            3.21  Change settings based upon message recipients   .................. 39
9880            3.22  Change settings before formatting a message   .................... 40
9881            3.23  Choosing the cryptographic key of the recipient   ................ 41
9882            3.24  Adding key sequences to the keyboard buffer   .................... 41
9883            3.25  Executing functions   ............................................ 41
9884            3.26  Message Scoring   ................................................ 41
9885            3.27  Spam detection   ................................................. 43
9886            3.28  Setting variables   .............................................. 44
9887            3.29  Reading initialization commands from another file   .............. 45
9888            3.30  Removing hooks   ................................................. 46
9889            3.31  Sharing Setups       ............................................. 46
9890                  3.31.1   Character Sets         46
9891                  3.31.2   Modularization           46
9892                  3.31.3   Conditional parts         46
9893            3.32  Obsolete Variables   ............................................. 48
9894
9895        4.  Advanced Usage   ....................................................... 48
9896            4.1   Regular Expressions   ............................................ 48
9897            4.2   Patterns   ....................................................... 51
9898                  4.2.1    Complex Patterns    52
9899                  4.2.2    Patterns and Dates    52
9900            4.3   Format Strings       ............................................. 53
9901                  4.3.1    Introduction           53
9902                  4.3.2    Conditional Expansion           54
9903                  4.3.3    Modifications and Padding           55
9904            4.4   Using Tags   ..................................................... 56
9905            4.5   Using Hooks   .................................................... 56
9906                  4.5.1    Message Matching in Hooks   57
9907
9908                                               ii
9909
9910            4.6   Using the sidebar   .............................................. 58
9911            4.7   External Address Queries   ....................................... 59
9912            4.8   Mailbox Formats   ................................................ 59
9913            4.9   Mailbox Shortcuts   .............................................. 60
9914            4.10  Handling Mailing Lists   ......................................... 60
9915            4.11  Editing threads   ................................................ 62
9916                  4.11.1   Linking threads   62
9917                  4.11.2   Breaking threads   62
9918            4.12  Delivery Status Notification (DSN) Support   ..................... 62
9919            4.13  POP3 Support (OPTIONAL)   ........................................ 63
9920            4.14  IMAP Support (OPTIONAL)   ........................................ 64
9921                  4.14.1   The Folder Browser   64
9922                  4.14.2   Authentication   65
9923            4.15  NNTP Support (OPTIONAL)   ........................................ 65
9924                  4.15.1   Again: Scoring       66
9925            4.16  SMTP Support (OPTIONAL)   ........................................ 66
9926            4.17  Managing multiple IMAP/POP/NNTP accounts (OPTIONAL)   ............ 67
9927            4.18  Start a WWW Browser on URLs (EXTERNAL)   ......................... 67
9928            4.19  Compressed folders Support (OPTIONAL)   .......................... 68
9929                  4.19.1   Open a compressed mailbox for reading   68
9930                  4.19.2   Write a compressed mailbox   69
9931                  4.19.3   Append a message to a compressed mailbox   69
9932                  4.19.4   Encrypted folders   70
9933
9934        5.  Mutt-ng's MIME Support   ............................................... 70
9935            5.1   Using MIME in Mutt   ............................................. 70
9936                  5.1.1    Viewing MIME messages in the pager   71
9937                  5.1.2    The Attachment Menu   71
9938                  5.1.3    The Compose Menu   71
9939            5.2   MIME Type configuration with mime.types   ........................ 72
9940            5.3   MIME Viewer configuration with mailcap   ......................... 72
9941                  5.3.1    The Basics of the mailcap file   73
9942                  5.3.2    Secure use of mailcap   74
9943                  5.3.3    Advanced mailcap Usage   75
9944                  5.3.4    Example mailcap files   77
9945            5.4   MIME Autoview   .................................................. 78
9946            5.5   MIME Multipart/Alternative   ..................................... 79
9947            5.6   MIME Lookup   .................................................... 79
9948
9949        6.  Security Considerations     ............................................ 80
9950            6.1   Passwords       .................................................. 80
9951            6.2   Temporary Files       ............................................ 80
9952            6.3   Information Leaks     ............................................ 81
9953                  6.3.1    Message-ID: headers         81
9954                  6.3.2    mailto:-style links         81
9955            6.4   External applications       ...................................... 81
9956                  6.4.1    mailcap           81
9957                  6.4.2    Other           82
9958
9959        7.  Reference   ............................................................ 82
9960            7.1   Command line options   ........................................... 82
9961            7.2   Patterns   ....................................................... 83
9962            7.3   Configuration Commands   ......................................... 85
9963
9964                                              iii
9965
9966            7.4   Configuration variables .......................................... 87
9967                  7.4.1    abort_noattach   88
9968                  7.4.2    abort_nosubject   89
9969                  7.4.3    abort_unmodified   89
9970                  7.4.4    agent_string   89
9971                  7.4.5    alias_file   89
9972                  7.4.6    alias_format   89
9973                  7.4.7    allow_8bit   90
9974                  7.4.8    allow_ansi   90
9975                  7.4.9    arrow_cursor   90
9976                  7.4.10   ascii_chars   91
9977                  7.4.11   askbcc   91
9978                  7.4.12   askcc   91
9979                  7.4.13   assumed_charset   91
9980                  7.4.14   attach_format   91
9981                  7.4.15   attach_remind_regexp   92
9982                  7.4.16   attach_sep   93
9983                  7.4.17   attach_split   93
9984                  7.4.18   attribution   93
9985                  7.4.19   auto_tag   93
9986                  7.4.20   autoedit   93
9987                  7.4.21   beep   94
9988                  7.4.22   beep_new   94
9989                  7.4.23   bounce   94
9990                  7.4.24   bounce_delivered   94
9991                  7.4.25   braille_friendly   94
9992                  7.4.26   certificate_file   95
9993                  7.4.27   charset   95
9994                  7.4.28   check_new   95
9995                  7.4.29   collapse_unread   95
9996                  7.4.30   compose_format   96
9997                  7.4.31   config_charset   96
9998                  7.4.32   confirmappend   96
9999                  7.4.33   confirmcreate   96
10000                  7.4.34   connect_timeout   96
10001                  7.4.35   content_type   97
10002                  7.4.36   copy   97
10003                  7.4.37   crypt_autoencrypt   97
10004                  7.4.38   crypt_autopgp   97
10005                  7.4.39   crypt_autosign   98
10006                  7.4.40   crypt_autosmime   98
10007                  7.4.41   crypt_replyencrypt   98
10008                  7.4.42   crypt_replysign   98
10009                  7.4.43   crypt_replysignencrypted   98
10010                  7.4.44   crypt_timestamp   99
10011                  7.4.45   crypt_use_gpgme   99
10012                  7.4.46   crypt_verify_sig   99
10013                  7.4.47   date_format   99
10014                  7.4.48   debug_level   100
10015                  7.4.49   default_hook   100
10016                  7.4.50   delete   100
10017                  7.4.51   delete_space   100
10018                  7.4.52   delete_untag   101
10019
10020                                               iv
10021
10022                  7.4.53   digest_collapse   101
10023                  7.4.54   display_filter   101
10024                  7.4.55   dotlock_program   101
10025                  7.4.56   dsn_notify   101
10026                  7.4.57   dsn_return   102
10027                  7.4.58   duplicate_threads   102
10028                  7.4.59   edit_headers   102
10029                  7.4.60   editor   102
10030                  7.4.61   editor_headers   102
10031                  7.4.62   encode_from   103
10032                  7.4.63   entropy_file   103
10033                  7.4.64   envelope_from   103
10034                  7.4.65   escape   103
10035                  7.4.66   fast_reply   104
10036                  7.4.67   fcc_attach   104
10037                  7.4.68   fcc_clear   104
10038                  7.4.69   file_charset   104
10039                  7.4.70   folder   104
10040                  7.4.71   folder_format   105
10041                  7.4.72   followup_to   106
10042                  7.4.73   force_buffy_check   106
10043                  7.4.74   force_name   106
10044                  7.4.75   forward_decode   106
10045                  7.4.76   forward_decrypt   107
10046                  7.4.77   forward_edit   107
10047                  7.4.78   forward_format   107
10048                  7.4.79   forward_quote   107
10049                  7.4.80   from   107
10050                  7.4.81   gecos_mask   108
10051                  7.4.82   hdrs   108
10052                  7.4.83   header   108
10053                  7.4.84   header_cache   108
10054                  7.4.85   header_cache_compress   109
10055                  7.4.86   help   109
10056                  7.4.87   hidden_host   109
10057                  7.4.88   hide_limited   109
10058                  7.4.89   hide_missing   109
10059                  7.4.90   hide_thread_subject   110
10060                  7.4.91   hide_top_limited   110
10061                  7.4.92   hide_top_missing   110
10062                  7.4.93   history   110
10063                  7.4.94   honor_followup_to   110
10064                  7.4.95   hostname   111
10065                  7.4.96   ignore_list_reply_to   111
10066                  7.4.97   imap_authenticators   111
10067                  7.4.98   imap_check_subscribed   111
10068                  7.4.99   imap_delim_chars   112
10069                  7.4.100  imap_headers   112
10070                  7.4.101  imap_home_namespace   112
10071                  7.4.102  imap_keepalive   112
10072                  7.4.103  imap_list_subscribed   113
10073                  7.4.104  imap_login   113
10074                  7.4.105  imap_mail_check   113
10075
10076                                               v
10077
10078                  7.4.106  imap_pass   113
10079                  7.4.107  imap_passive   114
10080                  7.4.108  imap_peek   114
10081                  7.4.109  imap_reconnect   114
10082                  7.4.110  imap_servernoise   114
10083                  7.4.111  imap_user   115
10084                  7.4.112  implicit_autoview   115
10085                  7.4.113  include   115
10086                  7.4.114  include_onlyfirst   115
10087                  7.4.115  indent_string   115
10088                  7.4.116  index_format   115
10089                  7.4.117  ispell   118
10090                  7.4.118  keep_flagged   118
10091                  7.4.119  list_reply   119
10092                  7.4.120  locale   119
10093                  7.4.121  mail_check   119
10094                  7.4.122  mailcap_path   119
10095                  7.4.123  mailcap_sanitize   119
10096                  7.4.124  maildir_header_cache_verify   119
10097                  7.4.125  maildir_trash   120
10098                  7.4.126  mark_old   120
10099                  7.4.127  markers   120
10100                  7.4.128  mask   120
10101                  7.4.129  max_display_recips   121
10102                  7.4.130  max_line_length   121
10103                  7.4.131  mbox   121
10104                  7.4.132  mbox_type   121
10105                  7.4.133  menu_context   121
10106                  7.4.134  menu_move_off   122
10107                  7.4.135  menu_scroll   122
10108                  7.4.136  message_format   122
10109                  7.4.137  meta_key   122
10110                  7.4.138  metoo   122
10111                  7.4.139  mh_purge   123
10112                  7.4.140  mh_seq_flagged   123
10113                  7.4.141  mh_seq_replied   123
10114                  7.4.142  mh_seq_unseen   123
10115                  7.4.143  mime_forward   123
10116                  7.4.144  mime_forward_decode   123
10117                  7.4.145  mime_forward_rest   124
10118                  7.4.146  mix_entry_format   124
10119                  7.4.147  mixmaster   124
10120                  7.4.148  move   124
10121                  7.4.149  msgid_format   125
10122                  7.4.150  muttng_bindir   126
10123                  7.4.151  muttng_docdir   126
10124                  7.4.152  muttng_hcache_backend   126
10125                  7.4.153  muttng_revision   126
10126                  7.4.154  muttng_sysconfdir   126
10127                  7.4.155  muttng_version   127
10128                  7.4.156  narrow_tree   127
10129                  7.4.157  nntp_ask_followup_to   127
10130                  7.4.158  nntp_ask_x_comment_to   127
10131
10132                                               vi
10133
10134                  7.4.159  nntp_cache_dir   127
10135                  7.4.160  nntp_catchup   128
10136                  7.4.161  nntp_context   128
10137                  7.4.162  nntp_followup_to_poster   128
10138                  7.4.163  nntp_group_index_format   128
10139                  7.4.164  nntp_host   129
10140                  7.4.165  nntp_inews   129
10141                  7.4.166  nntp_load_description   129
10142                  7.4.167  nntp_mail_check   130
10143                  7.4.168  nntp_mime_subject   130
10144                  7.4.169  nntp_newsrc   130
10145                  7.4.170  nntp_pass   130
10146                  7.4.171  nntp_post_moderated   131
10147                  7.4.172  nntp_reconnect   131
10148                  7.4.173  nntp_save_unsubscribed   131
10149                  7.4.174  nntp_show_new_news   131
10150                  7.4.175  nntp_show_only_unread   132
10151                  7.4.176  nntp_user   132
10152                  7.4.177  nntp_x_comment_to   132
10153                  7.4.178  operating_system   132
10154                  7.4.179  pager   132
10155                  7.4.180  pager_context   133
10156                  7.4.181  pager_format   133
10157                  7.4.182  pager_index_lines   133
10158                  7.4.183  pager_stop   133
10159                  7.4.184  pgp_auto_decode   134
10160                  7.4.185  pgp_autoinline   134
10161                  7.4.186  pgp_check_exit   134
10162                  7.4.187  pgp_clearsign_command   134
10163                  7.4.188  pgp_decode_command   135
10164                  7.4.189  pgp_decrypt_command   135
10165                  7.4.190  pgp_encrypt_only_command   135
10166                  7.4.191  pgp_encrypt_sign_command   135
10167                  7.4.192  pgp_entry_format   136
10168                  7.4.193  pgp_export_command   136
10169                  7.4.194  pgp_getkeys_command   136
10170                  7.4.195  pgp_good_sign   137
10171                  7.4.196  pgp_ignore_subkeys   137
10172                  7.4.197  pgp_import_command   137
10173                  7.4.198  pgp_list_pubring_command   137
10174                  7.4.199  pgp_list_secring_command   137
10175                  7.4.200  pgp_long_ids   138
10176                  7.4.201  pgp_mime_auto   138
10177                  7.4.202  pgp_replyinline   138
10178                  7.4.203  pgp_retainable_sigs   138
10179                  7.4.204  pgp_show_unusable   139
10180                  7.4.205  pgp_sign_as   139
10181                  7.4.206  pgp_sign_command   139
10182                  7.4.207  pgp_sort_keys   139
10183                  7.4.208  pgp_strict_enc   140
10184                  7.4.209  pgp_timeout   140
10185                  7.4.210  pgp_use_gpg_agent   140
10186                  7.4.211  pgp_verify_command   140
10187
10188                                              vii
10189
10190                  7.4.212  pgp_verify_key_command   140
10191                  7.4.213  pipe_decode   140
10192                  7.4.214  pipe_sep   141
10193                  7.4.215  pipe_split   141
10194                  7.4.216  pop_auth_try_all   141
10195                  7.4.217  pop_authenticators   141
10196                  7.4.218  pop_delete   142
10197                  7.4.219  pop_host   142
10198                  7.4.220  pop_last   142
10199                  7.4.221  pop_mail_check   142
10200                  7.4.222  pop_pass   143
10201                  7.4.223  pop_reconnect   143
10202                  7.4.224  pop_user   143
10203                  7.4.225  post_indent_string   143
10204                  7.4.226  postpone   143
10205                  7.4.227  postponed   144
10206                  7.4.228  preconnect   144
10207                  7.4.229  print   144
10208                  7.4.230  print_command   144
10209                  7.4.231  print_decode   144
10210                  7.4.232  print_split   145
10211                  7.4.233  prompt_after   145
10212                  7.4.234  query_command   145
10213                  7.4.235  quit   145
10214                  7.4.236  quote_empty   146
10215                  7.4.237  quote_quoted   146
10216                  7.4.238  quote_regexp   146
10217                  7.4.239  read_inc   146
10218                  7.4.240  read_only   146
10219                  7.4.241  realname   147
10220                  7.4.242  recall   147
10221                  7.4.243  record   147
10222                  7.4.244  reply_regexp   147
10223                  7.4.245  reply_self   148
10224                  7.4.246  reply_to   148
10225                  7.4.247  resolve   148
10226                  7.4.248  reverse_alias   148
10227                  7.4.249  reverse_name   149
10228                  7.4.250  reverse_realname   149
10229                  7.4.251  rfc2047_parameters   149
10230                  7.4.252  save_address   149
10231                  7.4.253  save_empty   150
10232                  7.4.254  save_name   150
10233                  7.4.255  score   150
10234                  7.4.256  score_threshold_delete   150
10235                  7.4.257  score_threshold_flag   151
10236                  7.4.258  score_threshold_read   151
10237                  7.4.259  send_charset   151
10238                  7.4.260  sendmail   151
10239                  7.4.261  sendmail_wait   151
10240                  7.4.262  shell   152
10241                  7.4.263  sidebar_boundary   152
10242                  7.4.264  sidebar_delim   152
10243
10244                                              viii
10245
10246                  7.4.265  sidebar_newmail_only   152
10247                  7.4.266  sidebar_number_format   152
10248                  7.4.267  sidebar_shorten_hierarchy   153
10249                  7.4.268  sidebar_visible   153
10250                  7.4.269  sidebar_width   154
10251                  7.4.270  sig_dashes   154
10252                  7.4.271  sig_on_top   154
10253                  7.4.272  signature   154
10254                  7.4.273  signoff_string   154
10255                  7.4.274  simple_search   155
10256                  7.4.275  sleep_time   155
10257                  7.4.276  smart_wrap   155
10258                  7.4.277  smileys   155
10259                  7.4.278  smime_ask_cert_label   155
10260                  7.4.279  smime_ca_location   156
10261                  7.4.280  smime_certificates   156
10262                  7.4.281  smime_decrypt_command   156
10263                  7.4.282  smime_decrypt_use_default_key   157
10264                  7.4.283  smime_default_key   157
10265                  7.4.284  smime_encrypt_command   157
10266                  7.4.285  smime_encrypt_with   157
10267                  7.4.286  smime_get_cert_command   158
10268                  7.4.287  smime_get_cert_email_command   158
10269                  7.4.288  smime_get_signer_cert_command   158
10270                  7.4.289  smime_import_cert_command   158
10271                  7.4.290  smime_is_default   158
10272                  7.4.291  smime_keys   158
10273                  7.4.292  smime_pk7out_command   159
10274                  7.4.293  smime_sign_command   159
10275                  7.4.294  smime_sign_opaque_command   159
10276                  7.4.295  smime_timeout   159
10277                  7.4.296  smime_verify_command   159
10278                  7.4.297  smime_verify_opaque_command   160
10279                  7.4.298  smtp_envelope   160
10280                  7.4.299  smtp_host   160
10281                  7.4.300  smtp_pass   160
10282                  7.4.301  smtp_port   161
10283                  7.4.302  smtp_use_tls   161
10284                  7.4.303  smtp_user   161
10285                  7.4.304  sort   161
10286                  7.4.305  sort_alias   162
10287                  7.4.306  sort_aux   162
10288                  7.4.307  sort_browser   163
10289                  7.4.308  sort_re   163
10290                  7.4.309  spam_separator   163
10291                  7.4.310  spoolfile   163
10292                  7.4.311  ssl_ca_certificates_file   164
10293                  7.4.312  ssl_client_cert   164
10294                  7.4.313  ssl_force_tls   164
10295                  7.4.314  ssl_min_dh_prime_bits   164
10296                  7.4.315  ssl_starttls   164
10297                  7.4.316  ssl_use_sslv2   165
10298                  7.4.317  ssl_use_sslv3   165
10299
10300                                               ix
10301
10302                  7.4.318  ssl_use_tlsv1   165
10303                  7.4.319  ssl_usesystemcerts   165
10304                  7.4.320  status_chars   165
10305                  7.4.321  status_format   166
10306                  7.4.322  status_on_top   168
10307                  7.4.323  strict_mailto   168
10308                  7.4.324  strict_mime   168
10309                  7.4.325  strict_threads   169
10310                  7.4.326  strip_was   169
10311                  7.4.327  strip_was_regex   169
10312                  7.4.328  stuff_quoted   169
10313                  7.4.329  suspend   170
10314                  7.4.330  text_flowed   170
10315                  7.4.331  thorough_search   170
10316                  7.4.332  thread_received   170
10317                  7.4.333  tilde   170
10318                  7.4.334  timeout   171
10319                  7.4.335  tmpdir   171
10320                  7.4.336  to_chars   171
10321                  7.4.337  trash   171
10322                  7.4.338  tunnel   171
10323                  7.4.339  umask   172
10324                  7.4.340  uncollapse_jump   172
10325                  7.4.341  use_8bitmime   172
10326                  7.4.342  use_domain   172
10327                  7.4.343  use_from   172
10328                  7.4.344  use_idn   173
10329                  7.4.345  use_ipv6   173
10330                  7.4.346  visual   173
10331                  7.4.347  wait_key   173
10332                  7.4.348  weed   174
10333                  7.4.349  wrap_search   174
10334                  7.4.350  wrapmargin   174
10335                  7.4.351  write_bcc   174
10336                  7.4.352  write_inc   174
10337                  7.4.353  xterm_icon   174
10338                  7.4.354  xterm_leave   175
10339                  7.4.355  xterm_set_titles   175
10340                  7.4.356  xterm_title   175
10341            7.5   Functions ....................................................... 175
10342                  7.5.1    generic   175
10343                  7.5.2    index   176
10344                  7.5.3    pager   178
10345                  7.5.4    alias   180
10346                  7.5.5    query   180
10347                  7.5.6    attach   180
10348                  7.5.7    compose   181
10349                  7.5.8    postpone   182
10350                  7.5.9    browser   182
10351                  7.5.10   pgp   183
10352                  7.5.11   editor   183
10353
10354        8.  Miscellany ............................................................ 183
10355
10356                                               x
10357
10358            8.1   Acknowledgments ................................................. 184
10359            8.2   About this document ............................................. 186
10360
10361                                               xi
10362