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
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.4  , page 24) 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.327  , page 167) 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.8  , page 28) 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 76) 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.295  , page 157) 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.113  , page 113).  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.113  , page 113) 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.316  , page 165).
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.3  , page 23) command is added to
534        the file specified by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 7.4.4  , page 87) 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.4  , page 87) does not
536        add the aliases specified there-in, you must also _\bs_\bo_\bu_\br_\bc_\be (section 3.28  , page
537        43) 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.9  , page 30) 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 68), 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 69).  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.7  , page 27) 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.12  ,
607        page 33) 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.91  , page 108) 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.204  , page 136), _\b$_\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
617        (section 7.4.206  , page 137), _\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp (section 7.4.205  , page 137) and
618        _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.339  , page 169) 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.340  , page 170) 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.339  , page 169) 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.229  , page 142) 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.312  , page 162) 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.57  , page 100).
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.196  , page 135) 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.183  , page 132)) 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.143  ,
951        page 121)).  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.218  , page 140) 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.217  , page 139) 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 80) 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 83) to configure Mutt-ng.
1041
1042        _\b3_\b._\b2  _\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        83).  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        It is also possible to substitute the output of a Unix command in an initial-
1106        ization file.  This is accomplished by enclosing the command in backquotes
1107        (``).  For example,
1108
1109        The Mutt Next Generation E-Mail Client                                       23
1110
1111             my_hdr X-Operating-System: `uname -a`
1112
1113        The output of the Unix command ``uname -a'' will be substituted before the line
1114        is parsed.  Note that since initialization files are line oriented, only the
1115        first line of output from the Unix command will be substituted.
1116
1117        UNIX environments can be accessed like the way it is done in shells like sh and
1118        bash: Prepend the name of the environment by a ``$''.  For example,
1119
1120             set record=+sent_on_$HOSTNAME
1121
1122        This also applies for all configuration variables known to mutt-ng, for example
1123
1124             set imap_home_namespace = $folder
1125
1126        The commands understood by mutt are explained in the next paragraphs.  For a
1127        complete list, see the _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.3  , page 83).
1128
1129        _\b3_\b._\b3  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg_\b/_\bU_\bs_\bi_\bn_\bg _\ba_\bl_\bi_\ba_\bs_\be_\bs
1130
1131        Usage: alias _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
1132
1133        It's usually very cumbersome to remember or type out the address of someone you
1134        are communicating with.  Mutt-ng allows you to create ``aliases'' which map a
1135        short string to a full address.
1136
1137        N\bNo\bot\bte\be:\b: if you want to create an alias for a group (by specifying more than one
1138        address), you m\bmu\bus\bst\bt separate the addresses with a comma (``,'').
1139
1140        To remove an alias or aliases (``*'' means all aliases):
1141
1142        unalias [ * | _\bk_\be_\by _\b._\b._\b. ]
1143
1144             alias muttdude me@cs.hmc.edu (Michael Elkins)
1145             alias theguys manny, moe, jack
1146
1147        Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a spe-
1148        cial file.  The alias command can appear anywhere in a configuration file, as
1149        long as this file is _\bs_\bo_\bu_\br_\bc_\be_\bd (section 3.28  , page 43).  Consequently, you can
1150        have multiple alias files, or you can have all aliases defined in your muttrc.
1151
1152        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
1153        only one file, the one pointed to by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 7.4.4  , page 87)
1154        variable (which is ~/.muttrc by default). This file is not special either, in
1155        the sense that Mutt-ng will happily append aliases to any file, but in order
1156        for the new aliases to take effect you need to explicitly _\bs_\bo_\bu_\br_\bc_\be (section
1157        3.28  , page 43) this file too.
1158
1159        The Mutt Next Generation E-Mail Client                                       24
1160
1161        For example:
1162
1163             source /usr/local/share/Mutt-ng.aliases
1164             source ~/.mail_aliases
1165             set alias_file=~/.mail_aliases
1166
1167        To use aliases, you merely use the alias at any place in mutt where mutt
1168        prompts for addresses, such as the _\bT_\bo_\b: or _\bC_\bc_\b: prompt.  You can also enter
1169        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
1170        (section 7.4.57  , page 100) variable set.
1171
1172        In addition, at the various address prompts, you can use the tab character to
1173        expand a partial alias to the full alias.  If there are multiple matches, mutt
1174        will bring up a menu with the matching aliases.  In order to be presented with
1175        the full list of aliases, you must hit tab with out a partial alias, such as at
1176        the beginning of the prompt or after a comma denoting multiple addresses.
1177
1178        In the alias menu, you can select as many aliases as you want with the _\bs_\be_\bl_\be_\bc_\bt_\b-
1179        _\be_\bn_\bt_\br_\by key (default: RET), and use the _\be_\bx_\bi_\bt key (default: q) to return to the
1180        address prompt.
1181
1182        _\b3_\b._\b4  _\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
1183
1184        Usage: bind _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
1185
1186        This command allows you to change the default key bindings (operation invoked
1187        when pressing a key).
1188
1189        _\bm_\ba_\bp specifies in which menu the binding belongs.  Multiple maps may be speci-
1190        fied by separating them with commas (no additional whitespace is allowed). The
1191        currently defined maps are:
1192
1193              generic
1194                    This is not a real menu, but is used as a fallback for all of the
1195                    other menus except for the pager and editor modes.  If a key is not
1196                    defined in another menu, Mutt-ng will look for a binding to use in
1197                    this menu.  This allows you to bind a key to a certain function in
1198                    multiple menus instead of having multiple bind statements to accom-
1199                    plish the same task.
1200
1201              alias
1202                    The alias menu is the list of your personal aliases as defined in
1203                    your muttrc.  It is the mapping from a short alias name to the full
1204                    email address(es) of the recipient(s).
1205
1206              attach
1207                    The attachment menu is used to access the attachments on received
1208                    messages.
1209
1210        The Mutt Next Generation E-Mail Client                                       25
1211
1212              browser
1213                    The browser is used for both browsing the local directory struc-
1214                    ture, and for listing all of your incoming mailboxes.
1215
1216              editor
1217                    The editor is the line-based editor the user enters text data.
1218
1219              index
1220                    The index is the list of messages contained in a mailbox.
1221
1222              compose
1223                    The compose menu is the screen used when sending a new message.
1224
1225              pager
1226                    The pager is the mode used to display message/attachment data, and
1227                    help listings.
1228
1229              pgp
1230                    The pgp menu is used to select the OpenPGP keys used for encrypting
1231                    outgoing messages.
1232
1233              postpone
1234                    The postpone menu is similar to the index menu, except is used when
1235                    recalling a message the user was composing, but saved until later.
1236
1237        _\bk_\be_\by is the key (or key sequence) you wish to bind.  To specify a control char-
1238        acter, use the sequence _\b\_\bC_\bx, where _\bx is the letter of the control character
1239        (for example, to specify control-A use ``\Ca'').  Note that the case of _\bx as
1240        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
1241        alternative form is to specify the key as a three digit octal number prefixed
1242        with a ``\'' (for example _\b\_\b1_\b7_\b7 is equivalent to _\b\_\bc_\b?).
1243
1244        In addition, _\bk_\be_\by may consist of:
1245
1246        The Mutt Next Generation E-Mail Client                                       26
1247
1248             \t              tab
1249             <tab>           tab
1250             <backtab>       backtab / shift-tab
1251             \r              carriage return
1252             \n              newline
1253             \e              escape
1254             <esc>           escape
1255             <up>            up arrow
1256             <down>          down arrow
1257             <left>          left arrow
1258             <right>         right arrow
1259             <pageup>        Page Up
1260             <pagedown>      Page Down
1261             <backspace>     Backspace
1262             <delete>        Delete
1263             <insert>        Insert
1264             <enter>         Enter
1265             <return>        Return
1266             <home>          Home
1267             <end>           End
1268             <space>         Space bar
1269             <f1>            function key 1
1270             <f10>           function key 10
1271
1272        _\bk_\be_\by does not need to be enclosed in quotes unless it contains a space (`` '').
1273
1274        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn specifies which action to take when _\bk_\be_\by is pressed.  For a complete
1275        list of functions, see the _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 171).  The special
1276        function noop unbinds the specified key sequence.
1277
1278        _\b3_\b._\b5  _\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
1279
1280        Usage: charset-hook _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
1281
1282        Usage: iconv-hook _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
1283
1284        The charset-hook command defines an alias for a character set.  This is useful
1285        to properly display messages which are tagged with a character set name not
1286        known to mutt.
1287
1288        The iconv-hook command defines a system-specific name for a character set.
1289        This is helpful when your systems character conversion library insists on using
1290        strange, system-specific names for character sets.
1291
1292        _\b3_\b._\b6  _\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
1293
1294        Usage: folder-hook [!]_\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1295
1296        It is often desirable to change settings based on which mailbox you are
1297
1298        The Mutt Next Generation E-Mail Client                                       27
1299
1300        reading.  The folder-hook command provides a method by which you can execute
1301        any configuration command.  _\br_\be_\bg_\be_\bx_\bp is a regular expression specifying in which
1302        mailboxes to execute _\bc_\bo_\bm_\bm_\ba_\bn_\bd before loading.  If a mailbox matches multiple
1303        folder-hook's, they are executed in the order given in the muttrc.
1304
1305        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.301  , page
1306        159) at the beginning of the pattern, you must place it inside of double or
1307        single quotes in order to distinguish it from the logical _\bn_\bo_\bt operator for the
1308        expression.
1309
1310        Note that the settings are _\bn_\bo_\bt restored when you leave the mailbox.  For exam-
1311        ple, a command action to perform is to change the sorting method based upon the
1312        mailbox being read:
1313
1314             folder-hook mutt set sort=threads
1315
1316        However, the sorting method is not restored to its previous value when reading
1317        a different mailbox.  To specify a _\bd_\be_\bf_\ba_\bu_\bl_\bt command, use the pattern ``.'':
1318
1319             folder-hook . set sort=date-sent
1320
1321        _\b3_\b._\b7  _\bK_\be_\by_\bb_\bo_\ba_\br_\bd _\bm_\ba_\bc_\br_\bo_\bs
1322
1323        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 ]
1324
1325        Macros are useful when you would like a single key to perform a series of
1326        actions.  When you press _\bk_\be_\by in menu _\bm_\be_\bn_\bu, Mutt-ng will behave as if you had
1327        typed _\bs_\be_\bq_\bu_\be_\bn_\bc_\be.  So if you have a common sequence of commands you type, you can
1328        create a macro to execute those commands with a single key.
1329
1330        _\bm_\be_\bn_\bu is the _\bm_\ba_\bp (section 3.4  , page 24) which the macro will be bound.  Multi-
1331        ple maps may be specified by separating multiple menu arguments by commas.
1332        Whitespace may not be used in between the menu arguments and the commas sepa-
1333        rating them.
1334
1335        _\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
1336        3.4  , page 24).  There are some additions however.  The first is that control
1337        characters in _\bs_\be_\bq_\bu_\be_\bn_\bc_\be can also be specified as _\b^_\bx.  In order to get a caret
1338        (`^'') you need to use _\b^_\b^.  Secondly, to specify a certain key such as _\bu_\bp or to
1339        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
1340        _\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
1341        3.4  , page 24).  Functions are listed in the _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section
1342        7.5  , page 171).
1343
1344        The advantage with using function names directly is that the macros will work
1345        regardless of the current key bindings, so they are not dependent on the user
1346        having particular key definitions.  This makes them more robust and portable,
1347        and also facilitates defining of macros in files used by more than one user
1348
1349        The Mutt Next Generation E-Mail Client                                       28
1350
1351        (eg. the system Muttngrc).
1352
1353        Optionally you can specify a descriptive text after _\bs_\be_\bq_\bu_\be_\bn_\bc_\be, which is shown in
1354        the help screens.
1355
1356        N\bNo\bot\bte\be:\b: Macro definitions (if any) listed in the help screen(s), are silently
1357        truncated at the screen width, and are not wrapped.
1358
1359        _\b3_\b._\b8  _\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
1360
1361        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 ]
1362
1363        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
1364
1365        Usage: uncolor index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1366
1367        If your terminal supports color, you can spice up Mutt-ng by creating your own
1368        color scheme.  To define the color of an object (type of information), you must
1369        specify both a foreground color a\ban\bnd\bd a background color (it is not possible to
1370        only specify one or the other).
1371
1372        _\bo_\bb_\bj_\be_\bc_\bt can be one of:
1373
1374           +\bo attachment
1375
1376           +\bo body (match _\br_\be_\bg_\be_\bx_\bp in the body of messages)
1377
1378           +\bo bold (highlighting bold patterns in the body of messages)
1379
1380           +\bo error (error messages printed by Mutt-ng)
1381
1382           +\bo header (match _\br_\be_\bg_\be_\bx_\bp in the message header)
1383
1384           +\bo hdrdefault (default color of the message header in the pager)
1385
1386           +\bo index (match _\bp_\ba_\bt_\bt_\be_\br_\bn in the message index)
1387
1388           +\bo indicator (arrow or bar used to indicate the current item in a menu)
1389
1390           +\bo markers (the ``+'' markers at the beginning of wrapped lines in the pager)
1391
1392           +\bo message (informational messages)
1393
1394           +\bo normal
1395
1396           +\bo quoted (text matching _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.229  , page 142) in the
1397             body of a message)
1398
1399           +\bo quoted1, quoted2, ..., quotedN\bN (higher levels of quoting)
1400
1401           +\bo search (highlighting of words in the pager)
1402
1403        The Mutt Next Generation E-Mail Client                                       29
1404
1405           +\bo signature
1406
1407           +\bo status (mode lines used to display info about the mailbox or message)
1408
1409           +\bo tilde (the ``~'' used to pad blank lines in the pager)
1410
1411           +\bo tree (thread tree drawn in the message index and attachment menu)
1412
1413           +\bo underline (highlighting underlined patterns in the body of messages)
1414
1415        _\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:
1416
1417           +\bo white
1418
1419           +\bo black
1420
1421           +\bo green
1422
1423           +\bo magenta
1424
1425           +\bo blue
1426
1427           +\bo cyan
1428
1429           +\bo yellow
1430
1431           +\bo red
1432
1433           +\bo default
1434
1435           +\bo color_\bx
1436
1437        _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd can optionally be prefixed with the keyword bright to make the fore-
1438        ground color boldfaced (e.g., brightred).
1439
1440        If your terminal supports it, the special keyword _\bd_\be_\bf_\ba_\bu_\bl_\bt can be used as a
1441        transparent color.  The value _\bb_\br_\bi_\bg_\bh_\bt_\bd_\be_\bf_\ba_\bu_\bl_\bt is also valid.  If Mutt-ng is
1442        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-
1443        ment variable to the default colors of your terminal for this to work; for
1444        example (for Bourne-like shells):
1445
1446             set COLORFGBG="green;black"
1447             export COLORFGBG
1448
1449        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
1450        instead of _\bw_\bh_\bi_\bt_\be and _\by_\be_\bl_\bl_\bo_\bw when setting this variable.
1451
1452        N\bNo\bot\bte\be:\b: The uncolor command can be applied to the index object only.  It removes
1453        entries from the list. You m\bmu\bus\bst\bt specify the same pattern specified in the color
1454        command for it to be removed.  The pattern ``*'' is a special token which means
1455        to clear the color index list of all entries.
1456
1457        The Mutt Next Generation E-Mail Client                                       30
1458
1459        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
1460        number of colors supported by your terminal).  This is useful when you remap
1461        the colors for your display (for example by changing the color associated with
1462        _\bc_\bo_\bl_\bo_\br_\b2 for your xterm), since color names may then lose their normal meaning.
1463
1464        If your terminal does not support color, it is still possible change the video
1465        attributes through the use of the ``mono'' command:
1466
1467        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 ]
1468
1469        Usage: mono index _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be _\bp_\ba_\bt_\bt_\be_\br_\bn
1470
1471        Usage: unmono index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1472
1473        where _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be is one of the following:
1474
1475           +\bo none
1476
1477           +\bo bold
1478
1479           +\bo underline
1480
1481           +\bo reverse
1482
1483           +\bo standout
1484
1485        _\b3_\b._\b9  _\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
1486
1487        Usage: [un]ignore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1488
1489        Messages often have many header fields added by automatic processing systems,
1490        or which may not seem useful to display on the screen.  This command allows you
1491        to specify header fields which you don't normally want to see.
1492
1493        You do not need to specify the full header field name.  For example, ``ignore
1494        content-'' will ignore all header fields that begin with the pattern ``con-
1495        tent-''. ``ignore *'' will ignore all headers.
1496
1497        To remove a previously added token from the list, use the ``unignore'' command.
1498        The ``unignore'' command will make Mutt-ng display headers with the given pat-
1499        tern.  For example, if you do ``ignore x-'' it is possible to ``unignore x-
1500        mailer''.
1501
1502        ``unignore *'' will remove all tokens from the ignore list.
1503
1504        For example:
1505
1506             # Sven's draconian header weeding
1507             ignore *
1508             unignore from date subject to cc
1509             unignore organization organisation x-mailer: x-newsreader: x-mailing-list:
1510             unignore posted-to:
1511
1512        The Mutt Next Generation E-Mail Client                                       31
1513
1514        _\b3_\b._\b1_\b0  _\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be _\ba_\bd_\bd_\br_\be_\bs_\bs_\be_\bs
1515
1516        Usage: [un]alternates _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1517
1518        With various functions, mutt will treat messages differently, depending on
1519        whether you sent them or whether you received them from someone else.  For
1520        instance, when replying to a message that you sent to a different party, mutt
1521        will automatically suggest to send the response to the original message's
1522        recipients -- responding to yourself won't make much sense in many cases.  (See
1523        _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section 7.4.237  , page 144).)
1524
1525        Many users receive e-mail under a number of different addresses. To fully use
1526        mutt's features here, the program must be able to recognize what e-mail
1527        addresses you receive mail under. That's the purpose of the alternates command:
1528        It takes a list of regular expressions, each of which can identify an address
1529        under which you receive e-mail.
1530
1531        The unalternates command can be used to write exceptions to alternates pat-
1532        terns. If an address matches something in an alternates command, but you none-
1533        theless do not think it is from you, you can list a more precise pattern under
1534        an unalternates command.
1535
1536        To remove a regular expression from the alternates list, use the unalternates
1537        command with exactly the same _\br_\be_\bg_\be_\bx_\bp.  Likewise, if the _\br_\be_\bg_\be_\bx_\bp for a alternates
1538        command matches an entry on the unalternates list, that unalternates entry will
1539        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
1540        will be removed.
1541
1542        _\b3_\b._\b1_\b1  _\bF_\bo_\br_\bm_\ba_\bt _\b= _\bF_\bl_\bo_\bw_\be_\bd
1543
1544        _\b3_\b._\b1_\b1_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
1545
1546        Mutt-ng contains support for so-called format=flowed messages.  In the begin-
1547        ning of email, each message had a fixed line width, and it was enough for dis-
1548        playing them on fixed-size terminals. But times changed, and nowadays hardly
1549        anybody still uses fixed-size terminals: more people nowaydays use graphical
1550        user interfaces, with dynamically resizable windows. This led to the demand of
1551        a new email format that makes it possible for the email client to make the
1552        email look nice in a resizable window without breaking quoting levels and cre-
1553        ating an incompatible email format that can also be displayed nicely on old
1554        fixed-size terminals.
1555
1556        For introductory information on format=flowed messages, see
1557        <http://www.joeclark.org/ffaq.html>.
1558
1559        _\b3_\b._\b1_\b1_\b._\b2  _\bR_\be_\bc_\be_\bi_\bv_\bi_\bn_\bg_\b: _\bD_\bi_\bs_\bp_\bl_\ba_\by _\bS_\be_\bt_\bu_\bp
1560
1561        When you receive emails that are marked as format=flowed messages, and is for-
1562        matted correctly, mutt-ng will try to reformat the message to optimally fit on
1563        your terminal. If you want a fixed margin on the right side of your terminal,
1564        you can set the following:
1565
1566        The Mutt Next Generation E-Mail Client                                       32
1567
1568                 set wrapmargin = 10
1569
1570        The code above makes the line break 10 columns before the right side of the
1571        terminal.
1572
1573        If your terminal is so wide that the lines are embarrassingly long, you can
1574        also set a maximum line length:
1575
1576                 set max_line_length = 120
1577
1578        The example above will give you lines not longer than 120 characters.
1579
1580        When you view at format=flowed messages, you will often see the quoting hierar-
1581        chy like in the following example:
1582
1583                 >Bill, can you please send last month's progress report to Mr.
1584                 >Morgan? We also urgently need the cost estimation for the new
1585                 >production server that we want to set up before our customer's
1586                 >project will go live.
1587
1588        This obviously doesn't look very nice, and it makes it very hard to differenti-
1589        ate between text and quoting character. The solution is to configure mutt-ng to
1590        "stuff" the quoting:
1591
1592                 set stuff_quoted
1593
1594        This will lead to a nicer result that is easier to read:
1595
1596                 > Bill, can you please send last month's progress report to Mr.
1597                 > Morgan? We also urgently need the cost estimation for the new
1598                 > production server that we want to set up before our customer's
1599                 > project will go live.
1600
1601        _\b3_\b._\b1_\b1_\b._\b3  _\bS_\be_\bn_\bd_\bi_\bn_\bg
1602
1603        If you want mutt-ng to send emails with format=flowed set, you need to explic-
1604        itly set it:
1605
1606                 set text_flowed
1607
1608        The Mutt Next Generation E-Mail Client                                       33
1609
1610        Additionally, you have to use an editor which supports writing format=flowed-
1611        conforming emails. For vim, this is done by adding w to the formatoptions (see
1612        :h formatoptions and :h fo-table) when writing emails.
1613
1614        Also note that _\bf_\bo_\br_\bm_\ba_\bt_\b=_\bf_\bl_\bo_\bw_\be_\bd knows about ``space-stuffing'', that is, when
1615        sending messages, some kinds of lines have to be indented with a single space
1616        on the sending side. On the receiving side, the first space (if any) is
1617        removed. As a consequence and in addition to the above simple setting, please
1618        keep this in mind when making manual formattings within the editor. Also note
1619        that mutt-ng currently violates the standard (RfC 3676) as it does not space-
1620        stuff lines starting with:
1621
1622           +\bo > This is _\bn_\bo_\bt the quote character but a right angle used for other reasons
1623
1624           +\bo From with a trailing space.
1625
1626           +\bo just a space for formatting reasons
1627
1628        Please make sure that you manually prepend a space to each of them.
1629
1630        _\b3_\b._\b1_\b1_\b._\b4  _\bA_\bd_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bN_\bo_\bt_\be_\bs
1631
1632            "
1633
1634         For completeness, the _\b$_\bd_\be_\bl_\be_\bt_\be_\b__\bs_\bp_\ba_\bc_\be (section 7.4.49  , page 98) variable pro-
1635        vides the mechanism to generate a DelSp=yes parameter on _\bo_\bu_\bt_\bg_\bo_\bi_\bn_\bg messages.
1636        According to the standard, clients receiving a format=flowed messages should
1637        delete the last space of a flowed line but still interpret the line as flowed.
1638        Because flowed lines usually contain only one space at the end, this parameter
1639        would make the receiving client concatenate the last word of the previous with
1640        the first of the current line _\bw_\bi_\bt_\bh_\bo_\bu_\bt a space. This makes ordinary text unread-
1641        able and is intended for languages rarely using spaces. So please use this set-
1642        ting only if you're sure what you're doing.
1643
1644        _\b3_\b._\b1_\b2  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bl_\bi_\bs_\bt_\bs
1645
1646        Usage: [un]lists _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1647
1648        Usage: [un]subscribe _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1649
1650        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  ,
1651        page 58).  In order to take advantage of them, you must specify which addresses
1652        belong to mailing lists, and which mailing lists you are subscribed to.  Once
1653        you have done this, the _\bl_\bi_\bs_\bt_\b-_\br_\be_\bp_\bl_\by (section 2.5.4  , page 12) function will
1654        work for all known lists.  Additionally, when you send a message to a sub-
1655        scribed list, mutt will add a Mail-Followup-To header to tell other users' mail
1656        user agents not to send copies of replies to your personal address.   Note that
1657        the Mail-Followup-To header is a non-standard extension which is not supported
1658        by all mail user agents.  Adding it is not bullet-proof against receiving per-
1659        sonal CCs of list messages.  Also note that the generation of the Mail-Fol-
1660        lowup-To header is controlled by the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.69  , page 103)
1661        configuration variable.
1662
1663        The Mutt Next Generation E-Mail Client                                       34
1664
1665        More precisely, Mutt-ng maintains lists of patterns for the addresses of known
1666        and subscribed mailing lists.  Every subscribed mailing list is known. To mark
1667        a mailing list as known, use the ``lists'' command.  To mark it as subscribed,
1668        use ``subscribe''.
1669
1670        You can use regular expressions with both commands.  To mark all messages sent
1671        to a specific bug report's address on mutt's bug tracking system as list mail,
1672        for instance, you could say ``subscribe [0-9]*@bugs.guug.de''.  Often, it's
1673        sufficient to just give a portion of the list's e-mail address.
1674
1675        Specify as much of the address as you need to to remove ambiguity.  For exam-
1676        ple, if you've subscribed to the Mutt-ng mailing list, you will receive mail
1677        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
1678        list, you could add ``lists mutt-users'' to your initialization file.  To tell
1679        mutt that you are subscribed to it, add ``subscribe mutt-users'' to your ini-
1680        tialization file instead.  If you also happen to get mail from someone whose
1681        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-
1682        users@mutt\\.org'' or ``subscribe mutt-users@mutt\\.org'' to match only mail
1683        from the actual list.
1684
1685        The ``unlists'' command is used to remove a token from the list of known and
1686        subscribed mailing-lists. Use ``unlists *'' to remove all tokens.
1687
1688        To remove a mailing list from the list of subscribed mailing lists, but keep it
1689        on the list of known mailing lists, use ``unsubscribe''.
1690
1691        _\b3_\b._\b1_\b3  _\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
1692
1693        Usage: mbox-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1694
1695        This command is used to move read messages from a specified mailbox to a dif-
1696        ferent mailbox automatically when you quit or change folders.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a
1697        regular expression specifying the mailbox to treat as a ``spool'' mailbox and
1698        _\bm_\ba_\bi_\bl_\bb_\bo_\bx specifies where mail should be saved when read.
1699
1700        Unlike some of the other _\bh_\bo_\bo_\bk commands, only the _\bf_\bi_\br_\bs_\bt matching pattern is used
1701        (it is not possible to save read mail in more than a single mailbox).
1702
1703        _\b3_\b._\b1_\b4  _\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
1704
1705        Usage: [un]mailboxes [!]_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
1706
1707        This command specifies folders which can receive mail and which will be checked
1708        for new messages.  By default, the main menu status bar displays how many of
1709        these folders have new messages.
1710
1711        When changing folders, pressing _\bs_\bp_\ba_\bc_\be will cycle through folders with new mail.
1712
1713        Pressing TAB in the directory browser will bring up a menu showing the files
1714        specified by the mailboxes command, and indicate which contain new messages.
1715
1716        The Mutt Next Generation E-Mail Client                                       35
1717
1718        Mutt-ng will automatically enter this mode when invoked from the command line
1719        with the -y option.
1720
1721        The ``unmailboxes'' command is used to remove a token from the list of folders
1722        which receive mail. Use ``unmailboxes *'' to remove all tokens.
1723
1724        N\bNo\bot\bte\be:\b: new mail is detected by comparing the last modification time to the last
1725        access time.  Utilities like biff or frm or any other program which accesses
1726        the mailbox might cause Mutt-ng to never detect new mail for that mailbox if
1727        they do not properly reset the access time.  Backup tools are another common
1728        reason for updated access times.
1729
1730        N\bNo\bot\bte\be:\b: the filenames in the mailboxes command are resolved when the command is
1731        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
1732        58) (such as ``='' and ``!''), any variable definition that affect these char-
1733        acters (like _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.67  , page 102) and _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
1734        7.4.301  , page 159)) should be executed before the mailboxes command.
1735
1736        _\b3_\b._\b1_\b5  _\bU_\bs_\be_\br _\bd_\be_\bf_\bi_\bn_\be_\bd _\bh_\be_\ba_\bd_\be_\br_\bs
1737
1738        Usage:
1739
1740        my_hdr _\bs_\bt_\br_\bi_\bn_\bg
1741
1742        unmy_hdr _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
1743
1744        The ``my_hdr'' command allows you to create your own header fields which will
1745        be added to every message you send.
1746
1747        For example, if you would like to add an ``Organization:'' header field to all
1748        of your outgoing messages, you can put the command
1749
1750             my_hdr Organization: A Really Big Company, Anytown, USA
1751
1752        in your .muttrc.
1753
1754        N\bNo\bot\bte\be:\b:  space characters are _\bn_\bo_\bt allowed between the keyword and the colon
1755        (``:'').  The standard for electronic mail (RFC822) says that space is illegal
1756        there, so Mutt-ng enforces the rule.
1757
1758        If you would like to add a header field to a single message, you should either
1759        set the _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.57  , page 100) variable, or use the _\be_\bd_\bi_\bt_\b-
1760        _\bh_\be_\ba_\bd_\be_\br_\bs function (default: ``E'') in the send-menu so that you can edit the
1761        header of your message along with the body.
1762
1763        To remove user defined header fields, use the ``unmy_hdr'' command.  You may
1764        specify an asterisk (``*'') to remove all header fields, or the fields to
1765        remove.  For example, to remove all ``To'' and ``Cc'' header fields, you could
1766        use:
1767
1768        The Mutt Next Generation E-Mail Client                                       36
1769
1770             unmy_hdr to cc
1771
1772        _\b3_\b._\b1_\b6  _\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
1773
1774        Usage: hdr_order _\bh_\be_\ba_\bd_\be_\br_\b1 _\bh_\be_\ba_\bd_\be_\br_\b2 _\bh_\be_\ba_\bd_\be_\br_\b3
1775
1776        With this command, you can specify an order in which mutt will attempt to
1777        present headers to you when viewing messages.
1778
1779        ``unhdr_order *'' will clear all previous headers from the order list, thus
1780        removing the header order effects set by the system-wide startup file.
1781
1782             hdr_order From Date: From: To: Cc: Subject:
1783
1784        _\b3_\b._\b1_\b7  _\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
1785
1786        Usage: save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
1787
1788        This command is used to override the default filename used when saving mes-
1789        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:
1790        an address matching _\br_\be_\bg_\be_\bx_\bp or if you are the author and the message is
1791        addressed _\bt_\bo_\b: something matching _\br_\be_\bg_\be_\bx_\bp.
1792
1793        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 55) for information on the
1794        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1795
1796        Examples:
1797
1798             save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
1799             save-hook aol\\.com$ +spam
1800
1801        Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 37) command.
1802
1803        _\b3_\b._\b1_\b8  _\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
1804
1805        Usage: fcc-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1806
1807        This command is used to save outgoing mail in a mailbox other than _\b$_\br_\be_\bc_\bo_\br_\bd
1808        (section 7.4.234  , page 143).  Mutt-ng searches the initial list of message
1809        recipients for the first matching _\br_\be_\bg_\be_\bx_\bp and uses _\bm_\ba_\bi_\bl_\bb_\bo_\bx as the default Fcc:
1810        mailbox.  If no match is found the message will be saved to _\b$_\br_\be_\bc_\bo_\br_\bd (section
1811        7.4.234  , page 143) mailbox.
1812
1813        The Mutt Next Generation E-Mail Client                                       37
1814
1815        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 55) for information on the
1816        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1817
1818        Example: fcc-hook [@.]aol\\.com$ +spammers
1819
1820        The above will save a copy of all messages going to the aol.com domain to the
1821        `+spammers' mailbox by default.  Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  ,
1822        page 37) command.
1823
1824        _\b3_\b._\b1_\b9  _\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
1825
1826        Usage: fcc-save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1827
1828        This command is a shortcut, equivalent to doing both a _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section
1829        3.18  , page 36) and a _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 36) with its arguments.
1830
1831        _\b3_\b._\b2_\b0  _\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
1832
1833        Usage: reply-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1834
1835        Usage: send-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1836
1837        Usage: send2-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1838
1839        These commands can be used to execute arbitrary configuration commands based
1840        upon recipients of the message.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a regular expression matching the
1841        desired address.  _\bc_\bo_\bm_\bm_\ba_\bn_\bd is executed when _\br_\be_\bg_\be_\bx_\bp matches recipients of the
1842        message.
1843
1844        reply-hook is matched against the message you are _\br_\be_\bp_\bl_\by_\bi_\bn_\bg t\bto\bo, instead of the
1845        message you are _\bs_\be_\bn_\bd_\bi_\bn_\bg.  send-hook is matched against all messages, both _\bn_\be_\bw
1846        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
1847        the order specified in the users's configuration file.
1848
1849        send2-hook is matched every time a message is changed, either by editing it, or
1850        by using the compose menu to change its recipients or subject.  send2-hook is
1851        executed after send-hook, and can, e.g., be used to set parameters such as the
1852        _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.251  , page 147) variable depending on the message's
1853        sender address.
1854
1855        For each type of send-hook or reply-hook, when multiple matches occur, commands
1856        are executed in the order they are specified in the muttrc (for that type of
1857        hook).
1858
1859        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 55) for information on the
1860        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1861
1862        Example: send-hook mutt 'set mime_forward signature='''
1863
1864        Another typical use for this command is to change the values of the
1865
1866        The Mutt Next Generation E-Mail Client                                       38
1867
1868        _\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 7.4.17  , page 91), _\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.263  , page
1869        150) and _\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.117  , page 116) variables in order to change the
1870        language of the attributions and signatures based upon the recipients.
1871
1872        N\bNo\bot\bte\be:\b: the send-hook's are only executed ONCE after getting the initial list of
1873        recipients.  Adding a recipient after replying or editing the message will NOT
1874        cause any send-hook to be executed.  Also note that my_hdr commands which mod-
1875        ify recipient headers, or the message's subject, don't have any effect on the
1876        current message when executed from a send-hook.
1877
1878        _\b3_\b._\b2_\b1  _\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
1879
1880        Usage: message-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1881
1882        This command can be used to execute arbitrary configuration commands before
1883        viewing or formatting a message based upon information about the message.  _\bc_\bo_\bm_\b-
1884        _\bm_\ba_\bn_\bd is executed if the _\bp_\ba_\bt_\bt_\be_\br_\bn matches the message to be displayed. When mul-
1885        tiple matches occur, commands are executed in the order they are specified in
1886        the muttrc.
1887
1888        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 55) for information on the
1889        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1890
1891        Example:
1892
1893             message-hook ~A 'set pager=builtin'
1894             message-hook '~f freshmeat-news' 'set pager="less \"+/^  subject: .*\""'
1895
1896        _\b3_\b._\b2_\b2  _\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
1897
1898        Usage: crypt-hook _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\bi_\bd
1899
1900        When encrypting messages with PGP or OpenSSL, you may want to associate a cer-
1901        tain key with a given e-mail address automatically, either because the recipi-
1902        ent's public key can't be deduced from the destination address, or because, for
1903        some reasons, you need to override the key Mutt-ng would normally use.  The
1904        crypt-hook command provides a method by which you can specify the ID of the
1905        public key to be used when encrypting messages to a certain recipient.
1906
1907        The meaning of "key id" is to be taken broadly in this context:  You can either
1908        put a numerical key ID here, an e-mail address, or even just a real name.
1909
1910        _\b3_\b._\b2_\b3  _\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
1911
1912        Usage: push _\bs_\bt_\br_\bi_\bn_\bg
1913
1914        This command adds the named string to the keyboard buffer. The string may
1915
1916        The Mutt Next Generation E-Mail Client                                       39
1917
1918        contain control characters, key names and function names like the sequence
1919        string in the _\bm_\ba_\bc_\br_\bo (section 3.7  , page 27) command. You may use it to auto-
1920        matically run a sequence of commands at startup, or when entering certain fold-
1921        ers.
1922
1923        _\b3_\b._\b2_\b4  _\bE_\bx_\be_\bc_\bu_\bt_\bi_\bn_\bg _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
1924
1925        Usage: exec _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
1926
1927        This command can be used to execute any function. Functions are listed in the
1928        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 171).  ``exec function'' is equivalent
1929        to ``push <function>''.
1930
1931        _\b3_\b._\b2_\b5  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bS_\bc_\bo_\br_\bi_\bn_\bg
1932
1933        Usage: score _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
1934
1935        Usage: unscore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1936
1937        In situations where you have to cope with a lot of emails, e.g.  when you read
1938        many different mailing lists, and take part in discussions, it is always useful
1939        to have the important messages marked and the annoying messages or the ones
1940        that you aren't interested in deleted. For this purpose, mutt-ng features a
1941        mechanism called ``scoring''.
1942
1943        When you use scoring, every message has a base score of 0. You can then use the
1944        score command to define patterns and a positive or negative value associated
1945        with it. When a pattern matches a message, the message's score will be raised
1946        or lowered by the amount of the value associated with the pattern.
1947
1948             score "~f nion@muttng\.org" 50
1949             score "~f @sco\.com" -100
1950
1951        If the pattern matches, it is also possible to set the score value of the cur-
1952        rent message to a certain value and then stop evaluation:
1953
1954             score "~f santaclaus@northpole\.int" =666
1955
1956        What is important to note is that negative score values will be rounded up to
1957        0.
1958
1959        To make scoring actually useful, the score must be applied in some way.  That's
1960        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:
1961
1962           +\bo flag threshold: when a message has a score value equal or higher than the
1963             flag threshold, it will be flagged.
1964
1965        The Mutt Next Generation E-Mail Client                                       40
1966
1967           +\bo read threshold: when a message has a score value equal or lower than the
1968             read threshold, it will be marked as read.
1969
1970           +\bo delete threshold: when a message has a score value equal or lower than the
1971             delete threshold, it will be marked as deleted.
1972
1973        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-
1974        tion 7.4.248  , page 147), _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.249  , page 147),
1975        _\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.247  , page 146) and.  By default,
1976        _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.249  , page 147) and _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
1977        (section 7.4.247  , page 146) are set to -1, which means that in the default
1978        threshold configuration no message will ever get marked as read or deleted.
1979
1980        Scoring gets especially interesting when combined with the color command and
1981        the ~n pattern:
1982
1983             color   black   yellow  "~n 10-"
1984             color   red     yellow  "~n 100-"
1985
1986        The rules above mark all messages with a score between 10 and 99 with black and
1987        yellow, and messages with a score greater or equal 100 with red and yellow.
1988        This might be unusual to you if you're used to e.g. slrn's scoring mechanism,
1989        but it is more flexible, as it visually marks different scores.
1990
1991        _\b3_\b._\b2_\b6  _\bS_\bp_\ba_\bm _\bd_\be_\bt_\be_\bc_\bt_\bi_\bo_\bn
1992
1993        Usage: spam _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
1994
1995        Usage: nospam _\bp_\ba_\bt_\bt_\be_\br_\bn
1996
1997        Mutt-ng has generalized support for external spam-scoring filters.  By defining
1998        your spam patterns with the spam and nospam commands, you can _\bl_\bi_\bm_\bi_\bt, _\bs_\be_\ba_\br_\bc_\bh,
1999        and _\bs_\bo_\br_\bt your mail based on its spam attributes, as determined by the external
2000        filter. You also can display the spam attributes in your index display using
2001        the %H selector in the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113) variable.
2002        (Tip: try %?H?[%H] ?  to display spam tags only when they are defined for a
2003        given message.)
2004
2005        Your first step is to define your external filter's spam patterns using the
2006        spam command. _\bp_\ba_\bt_\bt_\be_\br_\bn should be a regular expression that matches a header in a
2007        mail message. If any message in the mailbox matches this regular expression, it
2008        will receive a ``spam tag'' or ``spam attribute'' (unless it also matches a
2009        nospam pattern -- see below.) The appearance of this attribute is entirely up
2010        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,
2011        but it also can include back-references from the _\bp_\ba_\bt_\bt_\be_\br_\bn expression. (A regular
2012        expression ``back-reference'' refers to a sub-expression contained within
2013        parentheses.) %1 is replaced with the first back-reference in the regex, %2
2014        with the second, etc.
2015
2016        If you're using multiple spam filters, a message can have more than one spam-
2017
2018        The Mutt Next Generation E-Mail Client                                       41
2019
2020        related header. You can define spam patterns for each filter you use. If a mes-
2021        sage matches two or more of these patterns, and the $spam_separator variable is
2022        set to a string, then the message's spam tag will consist of all the _\bf_\bo_\br_\bm_\ba_\bt
2023        strings joined together, with the value of $spam_separator separating them.
2024
2025        For example, suppose I use DCC, SpamAssassin, and PureMessage. I might define
2026        these spam settings:
2027
2028             spam "X-DCC-.*-Metrics:.*(....)=many"         "90+/DCC-%1"
2029             spam "X-Spam-Status: Yes"                     "90+/SA"
2030             spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM"
2031             set spam_separator=", "
2032
2033        If I then received a message that DCC registered with ``many'' hits under the
2034        ``Fuz2'' checksum, and that PureMessage registered with a 97% probability of
2035        being spam, that message's spam tag would read 90+/DCC-Fuz2, 97/PM. (The four
2036        characters before ``=many'' in a DCC report indicate the checksum used -- in
2037        this case, ``Fuz2''.)
2038
2039        If the $spam_separator variable is unset, then each spam pattern match super-
2040        sedes the previous one. Instead of getting joined _\bf_\bo_\br_\bm_\ba_\bt strings, you'll get
2041        only the last one to match.
2042
2043        The spam tag is what will be displayed in the index when you use %H in the
2044        $index_format variable. It's also the string that the ~H pattern-matching
2045        expression matches against for _\bs_\be_\ba_\br_\bc_\bh and _\bl_\bi_\bm_\bi_\bt functions. And it's what sort-
2046        ing by spam attribute will use as a sort key.
2047
2048        That's a pretty complicated example, and most people's actual environments will
2049        have only one spam filter. The simpler your configuration, the more effective
2050        mutt can be, especially when it comes to sorting.
2051
2052        Generally, when you sort by spam tag, mutt will sort _\bl_\be_\bx_\bi_\bc_\ba_\bl_\bl_\by -- that is, by
2053        ordering strings alphnumerically. However, if a spam tag begins with a number,
2054        mutt will sort numerically first, and lexically only when two numbers are equal
2055        in value. (This is like UNIX's sort -n.) A message with no spam attributes at
2056        all -- that is, one that didn't match _\ba_\bn_\by of your spam patterns -- is sorted at
2057        lowest priority. Numbers are sorted next, beginning with 0 and ranging upward.
2058        Finally, non-numeric strings are sorted, with ``a'' taking lower priority than
2059        ``z''. Clearly, in general, sorting by spam tags is most effective when you can
2060        coerce your filter to give you a raw number. But in case you can't, mutt can
2061        still do something useful.
2062
2063        The nospam command can be used to write exceptions to spam patterns. If a
2064        header pattern matches something in a spam command, but you nonetheless do not
2065        want it to receive a spam tag, you can list a more precise pattern under a
2066        nospam command.
2067
2068        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-
2069        ing spam list entry, the effect will be to remove the entry from the spam list,
2070        instead of adding an exception.  Likewise, if the _\bp_\ba_\bt_\bt_\be_\br_\bn for a spam command
2071        matches an entry on the nospam list, that nospam entry will be removed. If the
2072        _\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
2073
2074        The Mutt Next Generation E-Mail Client                                       42
2075
2076        might be the default action if you use spam and nospam in conjunction with a
2077        folder-hook.
2078
2079        You can have as many spam or nospam commands as you like.  You can even do your
2080        own primitive spam detection within mutt -- for example, if you consider all
2081        mail from MAILER-DAEMON to be spam, you can use a spam command like this:
2082
2083             spam "^From: .*MAILER-DAEMON"       "999"
2084
2085        _\b3_\b._\b2_\b7  _\bS_\be_\bt_\bt_\bi_\bn_\bg _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2086
2087        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 ... ]
2088
2089        Usage: toggle _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2090
2091        Usage: unset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2092
2093        Usage: reset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2094
2095        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  ,
2096        page 85).  There are four basic types of variables: boolean, number, string and
2097        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
2098        variables can be assigned a positive integer value.
2099
2100        _\bs_\bt_\br_\bi_\bn_\bg variables consist of any number of printable characters.  _\bs_\bt_\br_\bi_\bn_\bg_\bs must
2101        be enclosed in quotes if they contain spaces or tabs.  You may also use the
2102        ``C'' escape sequences \\b\n\bn and \\b\t\bt for newline and tab, respectively.
2103
2104        _\bq_\bu_\ba_\bd_\bo_\bp_\bt_\bi_\bo_\bn variables are used to control whether or not to be prompted for cer-
2105        tain actions, or to specify a default action.  A value of _\by_\be_\bs will cause the
2106        action to be carried out automatically as if you had answered yes to the ques-
2107        tion.  Similarly, a value of _\bn_\bo will cause the the action to be carried out as
2108        if you had answered ``no.''  A value of _\ba_\bs_\bk_\b-_\by_\be_\bs will cause a prompt with a
2109        default answer of ``yes'' and _\ba_\bs_\bk_\b-_\bn_\bo will provide a default answer of ``no.''
2110
2111        Prefixing a variable with ``no'' will unset it.  Example: set noaskbcc.
2112
2113        For _\bb_\bo_\bo_\bl_\be_\ba_\bn variables, you may optionally prefix the variable name with inv to
2114        toggle the value (on or off).  This is useful when writing macros.  Example:
2115        set invsmart_wrap.
2116
2117        The toggle command automatically prepends the inv prefix to all specified vari-
2118        ables.
2119
2120        The unset command automatically prepends the no prefix to all specified vari-
2121        ables.
2122
2123        Using the enter-command function in the _\bi_\bn_\bd_\be_\bx menu, you can query the value of
2124        a variable by prefixing the name of the variable with a question mark:
2125
2126        The Mutt Next Generation E-Mail Client                                       43
2127
2128             set ?allow_8bit
2129
2130        The question mark is actually only required for boolean and quadoption vari-
2131        ables.
2132
2133        The reset command resets all given variables to the compile time defaults
2134        (hopefully mentioned in this manual). If you use the command set and prefix the
2135        variable with ``&'' this has the same behavior as the reset command.
2136
2137        With the reset command there exists the special variable ``all'', which allows
2138        you to reset all variables to their system defaults.
2139
2140        _\b3_\b._\b2_\b8  _\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
2141
2142        Usage: source _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
2143
2144        This command allows the inclusion of initialization commands from other files.
2145        For example, I place all of my aliases in ~/.mail_aliases so that I can make my
2146        ~/.muttrc readable and keep my aliases private.
2147
2148        If the filename begins with a tilde (``~''), it will be expanded to the path of
2149        your home directory.
2150
2151        If the filename ends with a vertical bar (|), then _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be is considered to be
2152        an executable program from which to read input (eg.  source ~/bin/myscript|).
2153
2154        _\b3_\b._\b2_\b9  _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
2155
2156        Usage: unhook [ * | _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be ]
2157
2158        This command permits you to flush hooks you have previously defined.  You can
2159        either remove all hooks by giving the ``*'' character as an argument, or you
2160        can remove all hooks of a specific type by saying something like unhook send-
2161        hook.
2162
2163        _\b3_\b._\b3_\b0  _\bS_\bh_\ba_\br_\bi_\bn_\bg _\bS_\be_\bt_\bu_\bp_\bs
2164
2165        _\b3_\b._\b3_\b0_\b._\b1  _\bC_\bh_\ba_\br_\ba_\bc_\bt_\be_\br _\bS_\be_\bt_\bs
2166
2167        As users may run mutt-ng on different systems, the configuration must be main-
2168        tained because it's likely that people want to use the setup everywhere they
2169        use mutt-ng. And mutt-ng tries to help where it can.
2170
2171        To not produce conflicts with different character sets, mutt-ng allows users to
2172        specify in which character set their configuration files are encoded. Please
2173        note that while reading the configuration files, this is only respected after
2174        the corresponding declaration appears. It's advised to put the following at the
2175
2176        The Mutt Next Generation E-Mail Client                                       44
2177
2178        very beginning of a users muttngrc:
2179
2180             set config_charset = "..."
2181
2182        and replacing the dots with the actual character set. To avoid problems while
2183        maintaining the setup, vim user's may want to use modelines as show in:
2184
2185             # vim:fileencoding=...:
2186
2187        while, again, replacing the dots with the appropriate name. This tells vim as
2188        which character set to read and save the file.
2189
2190        _\b3_\b._\b3_\b0_\b._\b2  _\bM_\bo_\bd_\bu_\bl_\ba_\br_\bi_\bz_\ba_\bt_\bi_\bo_\bn
2191
2192        ``Modularization'' means to divide the setup into several files while sorting
2193        the options or commands by topic. Especially for longer setups (e.g. with many
2194        hooks), this helps maintaining it and solving trouble.
2195
2196        When using separation, setups may be, as a whole or in fractions, shared over
2197        different systems.
2198
2199        _\b3_\b._\b3_\b0_\b._\b3  _\bC_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bp_\ba_\br_\bt_\bs
2200
2201        When using a configuration on different systems, the user may not always have
2202        influence on how mutt-ng is installed and which features it includes.
2203
2204        To solve this, mutt-ng contain a feature based on the ``ifdef'' patch written
2205        for mutt. Its basic syntax is:
2206
2207             ifdef <item> <command>
2208             ifndef <item> <command>
2209
2210        ...whereby <item> can be one of:
2211
2212           +\bo a function name
2213
2214           +\bo a variable name
2215
2216           +\bo a menu name
2217
2218           +\bo a feature name
2219
2220        All available functions, variables and menus are documented elsewhere in this
2221        manual but ``features'' is specific to these two commands. To test for one,
2222
2223        The Mutt Next Generation E-Mail Client                                       45
2224
2225        prefix one of the following keywords with feature_:
2226
2227             ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl,
2228             gnutls, sasl, sasl2, libesmtp, compressed, color, classic_pgp,
2229             classic_smime, gpgme, header_cache
2230
2231        As an example, one can use the following in ~/.muttngrc:
2232
2233             ifdef feature_imap 'source ~/.mutt-ng/setup-imap'
2234             ifdef feature_pop  'source ~/.mutt-ng/setup-pop'
2235             ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp'
2236
2237        ...to only source ~/.mutt-ng/setup-imap if IMAP support is built in, only
2238        source ~/.mutt-ng/setup-pop if POP support is built in and only source ~/.mutt-
2239        ng/setup-nntp if NNTP support is built in.
2240
2241        An example for testing for variable names can be used if users use different
2242        revisions of mutt-ng whereby the older one may not have a certain variable. To
2243        test for the availability of _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.102  , page 110),
2244        use:
2245
2246             ifdef imap_mail_check 'set imap_mail_check = 300'
2247
2248        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
2249        (section 7.4.173  , page 129) only if the pager menu is available, use:
2250
2251             ifdef pager 'set pager_index_lines = 10'
2252
2253        For completeness, too, the opposite of ifdef is provided: ifndef which only
2254        executes the command if the test fails. For example, the following two examples
2255        are equivalent:
2256
2257             ifdef feature_ncurses 'source ~/.mutt-ng/setup-ncurses'
2258             ifndef feature_ncurses 'source ~/.mutt-ng/setup-slang'
2259
2260        ...and...
2261
2262             ifdef feature_slang 'source ~/.mutt-ng/setup-slang'
2263             ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
2264
2265        The Mutt Next Generation E-Mail Client                                       46
2266
2267        _\b3_\b._\b3_\b1  _\bO_\bb_\bs_\bo_\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2268
2269        In the process of ensuring and creating more consistency, many variables have
2270        been renamed and some of the old names were already removed. Please see _\bO_\bb_\bs_\bo_\b-
2271        _\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs (section 7.4  , page 85) for a complete list.
2272
2273        _\b4_\b.  _\bA_\bd_\bv_\ba_\bn_\bc_\be_\bd _\bU_\bs_\ba_\bg_\be
2274
2275        _\b4_\b._\b1  _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs
2276
2277        All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
2278        tion 7.2  , page 81) must be specified using regular expressions (regexp) in
2279        the ``POSIX extended'' syntax (which is more or less the syntax used by egrep
2280        and GNU awk).  For your convenience, we have included below a brief description
2281        of this syntax.
2282
2283        The search is case sensitive if the pattern contains at least one upper case
2284        letter, and case insensitive otherwise. Note that ``\'' must be quoted if used
2285        for a regular expression in an initialization command: ``\\''.
2286
2287        A regular expression is a pattern that describes a set of strings.  Regular
2288        expressions are constructed analogously to arithmetic expressions, by using
2289        various operators to combine smaller expressions.
2290
2291        Note that the regular expression can be enclosed/delimited by either ' or '
2292        which is useful if the regular expression includes a white-space character.
2293        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-
2294        tion on ' and ' delimiter processing.  To match a literal ' or ' you must pref-
2295        ace it with \ (backslash).
2296
2297        The fundamental building blocks are the regular expressions that match a single
2298        character.  Most characters, including all letters and digits, are regular
2299        expressions that match themselves.  Any metacharacter with special meaning may
2300        be quoted by preceding it with a backslash.
2301
2302        The period ``.'' matches any single character.  The caret ``^'' and the dollar
2303        sign ``$'' are metacharacters that respectively match the empty string at the
2304        beginning and end of a line.
2305
2306        A list of characters enclosed by ``['' and ``]'' matches any single character
2307        in that list; if the first character of the list is a caret ``^'' then it
2308        matches any character n\bno\bot\bt in the list.  For example, the regular expression
2309        [\b[0\b01\b12\b23\b34\b45\b56\b67\b78\b89\b9]\b] matches any single digit.  A range of ASCII characters may be
2310        specified by giving the first and last characters, separated by a hyphen ``-''.
2311        Most metacharacters lose their special meaning inside lists.  To include a lit-
2312        eral ``]'' place it first in the list.  Similarly, to include a literal ``^''
2313        place it anywhere but first.  Finally, to include a literal hyphen ``-'' place
2314        it last.
2315
2316        The Mutt Next Generation E-Mail Client                                       47
2317
2318        Certain named classes of characters are predefined.  Character classes consist
2319        of ``[:'', a keyword denoting the class, and ``:]''.  The following classes are
2320        defined by the POSIX standard:
2321
2322              [:alnum:]
2323                    Alphanumeric characters.
2324
2325              [:alpha:]
2326                    Alphabetic characters.
2327
2328              [:blank:]
2329                    Space or tab characters.
2330
2331              [:cntrl:]
2332                    Control characters.
2333
2334              [:digit:]
2335                    Numeric characters.
2336
2337              [:graph:]
2338                    Characters that are both printable and visible.  (A space is print-
2339                    able, but not visible, while an ``a'' is both.)
2340
2341              [:lower:]
2342                    Lower-case alphabetic characters.
2343
2344              [:print:]
2345                    Printable characters (characters that are not control characters.)
2346
2347              [:punct:]
2348                    Punctuation characters (characters that are not letter, digits,
2349                    control characters, or space characters).
2350
2351              [:space:]
2352                    Space characters (such as space, tab and formfeed, to name a few).
2353
2354              [:upper:]
2355                    Upper-case alphabetic characters.
2356
2357              [:xdigit:]
2358                    Characters that are hexadecimal digits.
2359
2360        A character class is only valid in a regular expression inside the brackets of
2361        a character list.  Note that the brackets in these class names are part of the
2362        symbolic names, and must be included in addition to the brackets delimiting the
2363        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].
2364
2365        Two additional special sequences can appear in character lists.  These apply to
2366        non-ASCII character sets, which can have single symbols (called collating ele-
2367        ments) that are represented with more than one character, as well as several
2368        characters that are equivalent for collating or sorting purposes:
2369
2370              Collating Symbols
2371                    A collating symbol is a multi-character collating element enclosed
2372
2373        The Mutt Next Generation E-Mail Client                                       48
2374
2375                    in ``[.'' and ``.]''.  For example, if ``ch'' is a collating ele-
2376                    ment, then [\b[[\b[.\b.c\bch\bh.\b.]\b]]\b] is a regexp that matches this collating ele-
2377                    ment, while [\b[c\bch\bh]\b] is a regexp that matches either ``c'' or ``h''.
2378
2379              Equivalence Classes
2380                    An equivalence class is a locale-specific name for a list of char-
2381                    acters that are equivalent. The name is enclosed in ``[='' and
2382                    ``=]''.  For example, the name ``e'' might be used to represent all
2383                    of ``'' ``'' and ``e''.  In this case, [\b[[\b[=\b=e\be=\b=]\b]]\b] is a regexp that
2384                    matches any of ``'', ``'' and ``e''.
2385
2386        A regular expression matching a single character may be followed by one of sev-
2387        eral repetition operators:
2388
2389              ?
2390                    The preceding item is optional and matched at most once.
2391
2392              *
2393                    The preceding item will be matched zero or more times.
2394
2395              +
2396                    The preceding item will be matched one or more times.
2397
2398              {n}
2399                    The preceding item is matched exactly _\bn times.
2400
2401              {n,}
2402                    The preceding item is matched _\bn or more times.
2403
2404              {,m}
2405                    The preceding item is matched at most _\bm times.
2406
2407              {n,m}
2408                    The preceding item is matched at least _\bn times, but no more than _\bm
2409                    times.
2410
2411        Two regular expressions may be concatenated; the resulting regular expression
2412        matches any string formed by concatenating two substrings that respectively
2413        match the concatenated subexpressions.
2414
2415        Two regular expressions may be joined by the infix operator ``|''; the result-
2416        ing regular expression matches any string matching either subexpression.
2417
2418        Repetition takes precedence over concatenation, which in turn takes precedence
2419        over alternation.  A whole subexpression may be enclosed in parentheses to
2420        override these precedence rules.
2421
2422        N\bNo\bot\bte\be:\b: If you compile Mutt-ng with the GNU _\br_\bx package, the following operators
2423        may also be used in regular expressions:
2424
2425              \\y
2426                    Matches the empty string at either the beginning or the end of a
2427                    word.
2428
2429        The Mutt Next Generation E-Mail Client                                       49
2430
2431              \\B
2432                    Matches the empty string within a word.
2433
2434              \\<
2435                    Matches the empty string at the beginning of a word.
2436
2437              \\>
2438                    Matches the empty string at the end of a word.
2439
2440              \\w
2441                    Matches any word-constituent character (letter, digit, or under-
2442                    score).
2443
2444              \\W
2445                    Matches any character that is not word-constituent.
2446
2447              \\`
2448                    Matches the empty string at the beginning of a buffer (string).
2449
2450              \\'
2451                    Matches the empty string at the end of a buffer.
2452
2453        Please note however that these operators are not defined by POSIX, so they may
2454        or may not be available in stock libraries on various systems.
2455
2456        _\b4_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2457
2458        Mutt-ng's pattern language provides a simple yet effective way to set up rules
2459        to match messages, e.g. for operations like tagging and scoring. A pattern con-
2460        sists of one or more sub-pattern, which can be logically grouped, ORed, and
2461        negated. For a complete listing of these patterns, please refer to table _\bP_\ba_\bt_\b-
2462        _\bt_\be_\br_\bn_\bs (section 7.2  , page 81) in the Reference chapter.
2463
2464        It must be noted that in this table, EXPR, USER, ID and SUBJECT are regular
2465        expressions. For ranges, the forms <[MAX], >>[MIN], [MIN]- and -[MAX] are also
2466        possible.
2467
2468        _\b4_\b._\b2_\b._\b1  _\bC_\bo_\bm_\bp_\bl_\be_\bx _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2469
2470        It is possible to combine several sub-patterns to a more complex pattern. The
2471        most simple possibility is to logically AND several patterns by stringing them
2472        together:
2473
2474             ~s 'SPAM' ~U
2475
2476        The pattern above matches all messages that contain ``SPAM'' in the subject and
2477        are unread.
2478
2479        To logical OR patterns, simply use the | operator. This one especially useful
2480        when using local groups:
2481
2482        The Mutt Next Generation E-Mail Client                                       50
2483
2484             ~f ("nion@muttng\.org"|"ak@muttng\.org"|"pdmef@muttng\.org")
2485             (~b mutt-ng|~s Mutt-ng)
2486             !~x '@synflood\.at'
2487
2488        The first pattern matches all messages that were sent by one of the mutt-ng
2489        maintainers, while the seconds pattern matches all messages that contain
2490        ``mutt-ng'' in the message body or ``Mutt-ng'' in the subject. The third pat-
2491        tern matches all messages that do not contain ``@synflood\.at'' in the Refer-
2492        ences: header, i.e.  messages that are not an (indirect) reply to one of my
2493        messages. A pattern can be logicall negated using the ! operator.
2494
2495        _\b4_\b._\b2_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs _\ba_\bn_\bd _\bD_\ba_\bt_\be_\bs
2496
2497        When using dates in patterns, the dates must be specified in a special format,
2498        i.e.  DD/MM/YYYY. If you don't specify month or year, they default to the cur-
2499        rent month or year. When using date ranges, and you specify only the minimum or
2500        the maximum, the specified date will be excluded, e.g. 01/06/2005- matches
2501        against all messages _\ba_\bf_\bt_\be_\br Juni 1st, 2005.
2502
2503        It is also possible to use so-called ``error margins'' when specifying date
2504        ranges.  You simply specify a date, and then the error margin. This margin
2505        needs to contain the information whether it goes ``forth'' or ``back'' in time,
2506        by using + and -.  Then follows a number and a unit, i.e. y for years, m for
2507        months, w for weeks and d for days. If you use the special * sign, it means
2508        that the error margin goes to both ``directions'' in time.
2509
2510             ~d 01/01/2005+1y
2511             ~d 18/10/2004-2w
2512             ~d 28/12/2004*1d
2513
2514        The first pattern matches all dates between January 1st, 2005 and January 1st
2515        2006.  The second pattern matches all dates between October 18th, 2004 and
2516        October 4th 2004 (2 weeks before 18/10/2004), while the third pattern matches
2517        all dates 1 day around December 28th, 2004 (i.e. Dec 27th, 28th and 29th).
2518
2519        Relative dates are also very important, as they make it possible to specify
2520        date ranges between a fixed number of units and the current date. How this
2521        works can be seen in the following example:
2522
2523             ~d >2w # messages older than two weeks
2524             ~d <3d # messages newer than 3 days
2525             ~d =1m # messages that are exactly one month old
2526
2527        _\b4_\b._\b3  _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs
2528
2529        _\b4_\b._\b3_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
2530
2531        The Mutt Next Generation E-Mail Client                                       51
2532
2533        The so called _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs offer great flexibility when configuring mutt-ng.
2534        In short, they describe what items to print out how in menus and status mes-
2535        sages.
2536
2537        Basically, they work as this: for different menus and bars, there's a variable
2538        specifying the layout. For every item available, there is a so called _\be_\bx_\bp_\ba_\bn_\bd_\bo.
2539
2540        For example, when running mutt-ng on different machines or different versions
2541        for testing purposes, it may be interesting to have the following information
2542        always printed on screen when one is in the index:
2543
2544           +\bo the current hostname
2545
2546           +\bo the current mutt-ng version number
2547
2548        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-
2549        _\bm_\ba_\bt (section 7.4.312  , page 162) variable. For the hostname and version
2550        string, there's an expando for $status_format: %h expands to the hostname and
2551        %v to the version string. When just configuring:
2552
2553             set status_format = "%v on %h: ..."
2554
2555        mutt-ng will replace the sequence %v with the version string and %h with the
2556        host's name. When you are, for example, running mutt-ng version 1.5.9i on host
2557        mailhost, you'll see the following when you're in the index:
2558
2559             Mutt-ng 1.5.9i on mailhost: ...
2560
2561        In the index, there're more useful information one could want to see:
2562
2563           +\bo which mailbox is open
2564
2565           +\bo how man new, flagged or postponed messages
2566
2567           +\bo ...
2568
2569        To include the mailbox' name is as easy as:
2570
2571             set status_format = "%v on %h: %B: ...
2572
2573        When the currently opened mailbox is Inbox, this will be expanded to:
2574
2575             Mutt-ng 1.5.9i on mailhost: Inbox: ...
2576
2577        For the number of certain types of messages, one more feature of the format
2578        strings is extremely useful. If there aren't messages of a certain type, it may
2579
2580        The Mutt Next Generation E-Mail Client                                       52
2581
2582        not be desired to print just that there aren't any but instead only print some-
2583        thing if there are any.
2584
2585        _\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
2586
2587        To only print the number of messages if there are new messages in the current
2588        mailbox, further extend $status_format to:
2589
2590             set status_format = "%v on %h: %B %?n?%n new? ...
2591
2592        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
2593        optionally printed nonzero, i.e.  a portion of the format string is only evalu-
2594        ated if the value of the expando is different from zero. The basic syntax is:
2595
2596             %?<item>?<string if nonzero>?
2597
2598        which tells mutt-ng to only look at <string if nonzero> if the value of the
2599        %<item%gt; expando is different from zero. In our example, we used n as the
2600        expando to check for and %n new as the optional nonzero string.
2601
2602        But this is not all: this feature only offers one alternative: ``print some-
2603        thing if not zero.'' Mutt-ng does, as you might guess, also provide a logically
2604        complete version: ``if zero, print something and else print something else.''
2605        This is achieved by the following syntax for those expandos which may be
2606        printed nonzero:
2607
2608             %?<item>?<string if nonzero>&<string if zero>?
2609
2610        Using this we can make mutt-ng to do the following:
2611
2612           +\bo  make it print ``_\bn new messages'' whereby _\bn is the count but only if there
2613             new ones
2614
2615           +\bo  and make it print ``no new messages'' if there aren't any
2616
2617        The corresponding configuration is:
2618
2619             set status_format = "%v on %h: %B: %?n?%n new messages&no new messages? ...
2620
2621        This doubles the use of the ``new messages'' string because it'll get always
2622        printed. Thus, it can be shortened to:
2623
2624             set status_format = "%v on %h: %B: %?n?%n&no? new messages ...
2625
2626        The Mutt Next Generation E-Mail Client                                       53
2627
2628        As you might see from this rather simple example, one can create very complex
2629        but fancy status messages. Please see the reference chapter for expandos and
2630        those which may be printed nonzero.
2631
2632        _\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
2633
2634        Besides the information given so far, there're even more features of format
2635        strings:
2636
2637           +\bo When specifying %_<item> instead of just %<item>, mutt-ng will convert all
2638             characters in the expansion of <item> to lowercase.
2639
2640           +\bo When specifying %:<item> instead of just %<item>, mutt-ng will convert all
2641             dots in the expansion of <item> to underscores (_).
2642
2643        Also, there's a feature called _\bP_\ba_\bd_\bd_\bi_\bn_\bg supplied by the following two expandos:
2644        %|X and %>X.
2645
2646              %|X
2647                    When this occurs, mutt-ng will fill the rest of the line with the
2648                    character X. In our example, filling the rest of the line with
2649                    dashes is done by setting:
2650
2651                         set status_format = "%v on %h: %B: %?n?%n&no? new messages %|-"
2652
2653              %>X
2654                    Since the previous expando stops at the end of line, there must be
2655                    a way to fill the gap between two items via the %>X expando: it
2656                    puts as many characters X in between two items so that the rest of
2657                    the line will be right-justified. For example, to not put the ver-
2658                    sion string and hostname of our example on the left but on the
2659                    right and fill the gap with spaces, one might use (note the space
2660                    after %>):
2661
2662                         set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)"
2663
2664        _\b4_\b._\b4  _\bU_\bs_\bi_\bn_\bg _\bT_\ba_\bg_\bs
2665
2666        Sometimes it is desirable to perform an operation on a group of messages all at
2667        once rather than one at a time.  An example might be to save messages to a
2668        mailing list to a separate folder, or to delete all messages with a given sub-
2669        ject.  To tag all messages matching a pattern, use the tag-pattern function,
2670        which is bound to ``shift-T'' by default.  Or you can select individual mes-
2671        sages by hand using the ``tag-message'' function, which is bound to ``t'' by
2672
2673        The Mutt Next Generation E-Mail Client                                       54
2674
2675        default.  See _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 81) for Mutt-ng's pattern matching
2676        syntax.
2677
2678        Once you have tagged the desired messages, you can use the ``tag-prefix'' oper-
2679        ator, which is the ``;'' (semicolon) key by default.  When the ``tag-prefix''
2680        operator is used, the n\bne\bex\bxt\bt operation will be applied to all tagged messages if
2681        that operation can be used in that manner.  If the _\b$_\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg (section 7.4.18  ,
2682        page 91) variable is set, the next operation applies to the tagged messages
2683        automatically, without requiring the ``tag-prefix''.
2684
2685        In _\bm_\ba_\bc_\br_\bo_\bs (section 3.7  , page 27) or _\bp_\bu_\bs_\bh (section 3.23  , page 38) commands,
2686        you can use the ``tag-prefix-cond'' operator.  If there are no tagged messages,
2687        mutt will "eat" the rest of the macro to abort it's execution.  Mutt-ng will
2688        stop "eating" the macro when it encounters the ``end-cond'' operator;  after
2689        this operator the rest of the macro will be executed as normal.
2690
2691        _\b4_\b._\b5  _\bU_\bs_\bi_\bn_\bg _\bH_\bo_\bo_\bk_\bs
2692
2693        A _\bh_\bo_\bo_\bk is a concept borrowed from the EMACS editor which allows you to execute
2694        arbitrary commands before performing some operation.  For example, you may wish
2695        to tailor your configuration based upon which mailbox you are reading, or to
2696        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
2697        _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 46) or _\bp_\ba_\bt_\bt_\be_\br_\bn (section 7.2  , page 81) along
2698        with a configuration option/command.  See
2699
2700           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 26)
2701
2702           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 37)
2703
2704           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 38)
2705
2706           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 36)
2707
2708           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 34)
2709
2710           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 36)
2711
2712           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 37)
2713
2714        for specific details on each type of _\bh_\bo_\bo_\bk available.
2715
2716        N\bNo\bot\bte\be:\b: if a hook changes configuration settings, these changes remain effective
2717        until the end of the current mutt session. As this is generally not desired, a
2718        default hook needs to be added before all other hooks to restore configuration
2719        defaults. Here is an example with send-hook and the my_hdr directive:
2720
2721             send-hook . 'unmy_hdr From:'
2722             send-hook ~C'^b@b\.b$' my_hdr from: c@c.c
2723
2724        The Mutt Next Generation E-Mail Client                                       55
2725
2726        _\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
2727
2728        Hooks that act upon messages (send-hook, save-hook, fcc-hook, message-hook) are
2729        evaluated in a slightly different manner.  For the other types of hooks, a _\br_\be_\bg_\b-
2730        _\bu_\bl_\ba_\br _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 46) is sufficient.  But in dealing with
2731        messages a finer grain of control is needed for matching since for different
2732        purposes you want to match different criteria.
2733
2734        Mutt-ng allows the use of the _\bs_\be_\ba_\br_\bc_\bh _\bp_\ba_\bt_\bt_\be_\br_\bn (section 7.2  , page 81) language
2735        for matching messages in hook commands.  This works in exactly the same way as
2736        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
2737        to those operators which match information mutt extracts from the header of the
2738        message (i.e.  from, to, cc, date, subject, etc.).
2739
2740        For example, if you wanted to set your return address based upon sending mail
2741        to a specific address, you could do something like:
2742
2743             send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>'
2744
2745        which would execute the given command when sending mail to _\bm_\be_\b@_\bc_\bs_\b._\bh_\bm_\bc_\b._\be_\bd_\bu.
2746
2747        However, it is not required that you write the pattern to match using the full
2748        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
2749        other hooks, in which case Mutt-ng will translate your pattern into the full
2750        language, using the translation specified by the _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section
2751        7.4.47  , page 97) variable.  The pattern is translated at the time the hook is
2752        declared, so the value of _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section 7.4.47  , page 97) that is in
2753        effect at that time will be used.
2754
2755        _\b4_\b._\b6  _\bU_\bs_\bi_\bn_\bg _\bt_\bh_\be _\bs_\bi_\bd_\be_\bb_\ba_\br
2756
2757        The sidebar, a feature specific to Mutt-ng, allows you to use a mailbox listing
2758        which looks very similar to the ones you probably know from GUI mail clients.
2759        The sidebar lists all specified mailboxes, shows the number in each and high-
2760        lights the ones with new email Use the following configuration commands:
2761
2762             set sidebar_visible="yes"
2763             set sidebar_width=25
2764
2765        If you want to specify the mailboxes you can do so with:
2766
2767             set mbox='=INBOX'
2768             mailboxes INBOX \
2769                       MBOX1 \
2770                       MBOX2 \
2771                       ...
2772
2773        You can also specify the colors for mailboxes with new mails by using:
2774
2775        The Mutt Next Generation E-Mail Client                                       56
2776
2777             color sidebar_new red black
2778             color sidebar white black
2779
2780        The available functions are:
2781
2782             sidebar-scroll-up      Scrolls the mailbox list up 1 page
2783             sidebar-scroll-down    Scrolls the mailbox list down 1 page
2784             sidebar-next           Highlights the next mailbox
2785             sidebar-next-new       Highlights the next mailbox with new mail
2786             sidebar-previous       Highlights the previous mailbox
2787             sidebar-open           Opens the currently highlighted mailbox
2788
2789        Reasonable key bindings look e.g. like this:
2790
2791             bind index \Cp sidebar-prev
2792             bind index \Cn sidebar-next
2793             bind index \Cb sidebar-open
2794             bind pager \Cp sidebar-prev
2795             bind pager \Cn sidebar-next
2796             bind pager \Cb sidebar-open
2797
2798             macro index B ':toggle sidebar_visible^M'
2799             macro pager B ':toggle sidebar_visible^M'
2800
2801        You can then go up and down by pressing Ctrl-P and Ctrl-N, and switch on and
2802        off the sidebar simply by pressing 'B'.
2803
2804        _\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
2805
2806        Mutt-ng supports connecting to external directory databases such as LDAP,
2807        ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using a
2808        simple interface.  Using the _\b$_\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.225  , page 141) vari-
2809        able, you specify the wrapper command to use.  For example:
2810
2811             set query_command = "mutt_ldap_query.pl '%s'"
2812
2813        The wrapper script should accept the query on the command-line.  It should
2814        return a one line message, then each matching response on a single line, each
2815        line containing a tab separated address then name then some other optional
2816        information.  On error, or if there are no matching addresses, return a non-
2817        zero exit code and a one line error message.
2818
2819        An example multiple response output:
2820
2821             Searching database ... 20 entries ... 3 matching:
2822             me@cs.hmc.edu           Michael Elkins  mutt dude
2823             blong@fiction.net       Brandon Long    mutt and more
2824
2825        The Mutt Next Generation E-Mail Client                                       57
2826
2827             roessler@guug.de        Thomas Roessler mutt pgp
2828
2829        There are two mechanisms for accessing the query function of mutt.  One is to
2830        do a query from the index menu using the query function (default: Q).  This
2831        will prompt for a query, then bring up the query menu which will list the
2832        matching responses.  From the query menu, you can select addresses to create
2833        aliases, or to mail.  You can tag multiple addresses to mail, start a new
2834        query, or have a new query appended to the current responses.
2835
2836        The other mechanism for accessing the query function is for address completion,
2837        similar to the alias completion.  In any prompt for address entry, you can use
2838        the complete-query function (default: ^T) to run a query based on the current
2839        address you have typed.  Like aliases, mutt will look for what you have typed
2840        back to the last space or comma.  If there is a single response for that query,
2841        mutt will expand the address in place.  If there are multiple responses, mutt
2842        will activate the query menu.  At the query menu, you can select one or more
2843        addresses to be added to the prompt.
2844
2845        _\b4_\b._\b8  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bF_\bo_\br_\bm_\ba_\bt_\bs
2846
2847        Mutt-ng supports reading and writing of four different mailbox formats: mbox,
2848        MMDF, MH and Maildir.  The mailbox type is autodetected, so there is no need to
2849        use a flag for different mailbox types.  When creating new mailboxes, Mutt-ng
2850        uses the default specified with the _\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.129  , page 118)
2851        variable.
2852
2853        m\bmb\bbo\box\bx.  This is the most widely used mailbox format for UNIX.  All messages are
2854        stored in a single file.  Each message has a line of the form:
2855
2856             From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
2857
2858        to denote the start of a new message (this is often referred to as the
2859        ``From_'' line).
2860
2861        M\bMM\bMD\bDF\bF.  This is a variant of the _\bm_\bb_\bo_\bx format.  Each message is surrounded by
2862        lines containing ``^A^A^A^A'' (four control-A's).
2863
2864        M\bMH\bH. A radical departure from _\bm_\bb_\bo_\bx and _\bM_\bM_\bD_\bF, a mailbox consists of a directory
2865        and each message is stored in a separate file.  The filename indicates the mes-
2866        sage number (however, this is may not correspond to the message number Mutt-ng
2867        displays). Deleted messages are renamed with a comma (,) prepended to the file-
2868        name. N\bNo\bot\bte\be:\b: Mutt detects this type of mailbox by looking for either
2869        .mh_sequences or .xmhcache (needed to distinguish normal directories from MH
2870        mailboxes).
2871
2872        M\bMa\bai\bil\bld\bdi\bir\br.  The newest of the mailbox formats, used by the Qmail MTA (a replace-
2873        ment for sendmail).  Similar to _\bM_\bH, except that it adds three subdirectories of
2874        the mailbox: _\bt_\bm_\bp, _\bn_\be_\bw and _\bc_\bu_\br.  Filenames for the messages are chosen in such a
2875        way they are unique, even when two programs are writing the mailbox over NFS,
2876
2877        The Mutt Next Generation E-Mail Client                                       58
2878
2879        which means that no file locking is needed.
2880
2881        _\b4_\b._\b9  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bS_\bh_\bo_\br_\bt_\bc_\bu_\bt_\bs
2882
2883        There are a number of built in shortcuts which refer to specific mailboxes.
2884        These shortcuts can be used anywhere you are prompted for a file or mailbox
2885        path.
2886
2887           +\bo ! -- refers to your _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.301  , page 159) (incoming)
2888             mailbox
2889
2890           +\bo > -- refers to your _\b$_\bm_\bb_\bo_\bx (section 7.4.128  , page 118) file
2891
2892           +\bo < -- refers to your _\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.234  , page 143) file
2893
2894           +\bo ^ -- refers to the current mailbox
2895
2896           +\bo - or !! -- refers to the file you've last visited
2897
2898           +\bo ~ -- refers to your home directory
2899
2900           +\bo = or + -- refers to your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.67  , page 102) directory
2901
2902           +\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.17  , page 36) as
2903             determined by the address of the alias
2904
2905        _\b4_\b._\b1_\b0  _\bH_\ba_\bn_\bd_\bl_\bi_\bn_\bg _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
2906
2907        Mutt-ng has a few configuration options that make dealing with large amounts of
2908        mail easier.  The first thing you must do is to let Mutt know what addresses
2909        you consider to be mailing lists (technically this does not have to be a mail-
2910        ing list, but that is what it is most often used for), and what lists you are
2911        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
2912        (section 3.12  , page 33) commands in your muttrc.
2913
2914        Now that Mutt-ng knows what your mailing lists are, it can do several things,
2915        the first of which is the ability to show the name of a list through which you
2916        received a message (i.e., of a subscribed list) in the _\bi_\bn_\bd_\be_\bx menu display.
2917        This is useful to distinguish between personal and list mail in the same mail-
2918        box.  In the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113) variable, the escape
2919        ``%L'' will return the string ``To <list>'' when ``list'' appears in the ``To''
2920        field, and ``Cc <list>'' when it appears in the ``Cc'' field (otherwise it
2921        returns the name of the author).
2922
2923        Often times the ``To'' and ``Cc'' fields in mailing list messages tend to get
2924        quite large. Most people do not bother to remove the author of the message they
2925        are reply to from the list, resulting in two or more copies being sent to that
2926        person.  The ``list-reply'' function, which by default is bound to ``L'' in the
2927        _\bi_\bn_\bd_\be_\bx menu and _\bp_\ba_\bg_\be_\br, helps reduce the clutter by only replying to the known
2928        mailing list addresses instead of all recipients (except as specified by Mail-
2929
2930        The Mutt Next Generation E-Mail Client                                       59
2931
2932        Followup-To, see below).
2933
2934        Mutt-ng also supports the Mail-Followup-To header.  When you send a message to
2935        a list of recipients which includes one or several subscribed mailing lists,
2936        and if the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.69  , page 103) option is set, mutt will
2937        generate a Mail-Followup-To header which contains all the recipients to whom
2938        you send this message, but not your address. This indicates that group-replies
2939        or list-replies (also known as ``followups'') to this message should only be
2940        sent to the original recipients of the message, and not separately to you -
2941        you'll receive your copy through one of the mailing lists you are subscribed
2942        to.
2943
2944        Conversely, when group-replying or list-replying to a message which has a Mail-
2945        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
2946        (section 7.4.91  , page 108) configuration variable is set.  Using list-reply
2947        will in this case also make sure that the reply goes to the mailing list, even
2948        if it's not specified in the list of recipients in the Mail-Followup-To.
2949
2950        Note that, when header editing is enabled, you can create a Mail-Followup-To
2951        header manually.  Mutt-ng will only auto-generate this header if it doesn't
2952        exist when you send the message.
2953
2954        The other method some mailing list admins use is to generate a ``Reply-To''
2955        field which points back to the mailing list address rather than the author of
2956        the message.  This can create problems when trying to reply directly to the
2957        author in private, since most mail clients will automatically reply to the
2958        address given in the ``Reply-To'' field.  Mutt-ng uses the _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section
2959        7.4.237  , page 144) variable to help decide which address to use.  If set to
2960        _\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
2961        use the address given in the ``Reply-To'' field, or reply directly to the
2962        address given in the ``From'' field.  When set to _\by_\be_\bs, the ``Reply-To'' field
2963        will be used when present.
2964
2965        The ``X-Label:'' header field can be used to further identify mailing lists or
2966        list subject matter (or just to annotate messages individually).  The
2967        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113) variable's ``%y'' and ``%Y''
2968        escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's
2969        pattern-matcher can match regular expressions to ``X-Label:'' fields with the
2970        ``~y'' selector.  ``X-Label:'' is not a standard message header field, but it
2971        can easily be inserted by procmail and other mail filtering agents.
2972
2973        Lastly, Mutt-ng has the ability to _\bs_\bo_\br_\bt (section 7.4.295  , page 157) the mail-
2974        box into _\bt_\bh_\br_\be_\ba_\bd_\bs (section 2.5.3  , page 11).  A thread is a group of messages
2975        which all relate to the same subject.  This is usually organized into a tree-
2976        like structure where a message and all of its replies are represented graphi-
2977        cally.  If you've ever used a threaded news client, this is the same concept.
2978        It makes dealing with large volume mailing lists easier because you can easily
2979        delete uninteresting threads and quickly find topics of value.
2980
2981        _\b4_\b._\b1_\b1  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2982
2983        Mutt-ng has the ability to dynamically restructure threads that are broken
2984
2985        The Mutt Next Generation E-Mail Client                                       60
2986
2987        either by misconfigured software or bad behavior from some correspondents. This
2988        allows to clean your mailboxes formats) from these annoyances which make it
2989        hard to follow a discussion.
2990
2991        _\b4_\b._\b1_\b1_\b._\b1  _\bL_\bi_\bn_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2992
2993        Some mailers tend to "forget" to correctly set the "In-Reply-To:" and "Refer-
2994        ences:" headers when replying to a message. This results in broken discussions
2995        because Mutt-ng has not enough information to guess the correct threading.  You
2996        can fix this by tagging the reply, then moving to the parent message and using
2997        the ``link-threads'' function (bound to & by default). The reply will then be
2998        connected to this "parent" message.
2999
3000        You can also connect multiple children at once, tagging them and using the tag-
3001        prefix command (';') or the auto_tag option.
3002
3003        _\b4_\b._\b1_\b1_\b._\b2  _\bB_\br_\be_\ba_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
3004
3005        On mailing lists, some people are in the bad habit of starting a new discussion
3006        by hitting "reply" to any message from the list and changing the subject to a
3007        totally unrelated one.  You can fix such threads by using the ``break-thread''
3008        function (bound by default to #), which will turn the subthread starting from
3009        the current message into a whole different thread.
3010
3011        _\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
3012
3013        RFC1894 defines a set of MIME content types for relaying information about the
3014        status of electronic mail messages.  These can be thought of as ``return
3015        receipts.''
3016
3017        Users can make use of it in one of the following two ways:
3018
3019           +\bo Berkeley sendmail 8.8.x currently has some command line options in which
3020             the mail client can make requests as to what type of status messages
3021             should be returned.
3022
3023           +\bo The SMTP support via libESMTP supports it, too.
3024
3025        To support this, there are two variables:
3026
3027           +\bo _\b$_\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by (section 7.4.54  , page 99) is used to request receipts for
3028             different results (such as failed message, message delivered, etc.).
3029
3030           +\bo _\b$_\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn (section 7.4.55  , page 99) requests how much of your message
3031             should be returned with the receipt (headers or full message).
3032
3033        Please see the reference chapter for possible values.
3034
3035        _\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)
3036
3037        The Mutt Next Generation E-Mail Client                                       61
3038
3039        If Mutt-ng was compiled with POP3 support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3040        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
3041        remote POP3 server and fetch mail for local browsing.
3042
3043        You can access the remote POP3 mailbox by selecting the folder
3044        pop://popserver/.
3045
3046        You can select an alternative port by specifying it with the server, i.e.:
3047        pop://popserver:port/.
3048
3049        You can also specify different username for each folder, i.e.: pop://user-
3050        name@popserver[:port]/.
3051
3052        Polling for new mail is more expensive over POP3 than locally. For this reason
3053        the frequency at which Mutt-ng will check for mail remotely can be controlled
3054        by the _\b$_\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.212  , page 138) variable, which defaults
3055        to every 60 seconds.
3056
3057        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3058        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to POP3 servers can be encrypted. This natu-
3059        rally requires that the server supports SSL encrypted connections. To access a
3060        folder with POP3/SSL, you should use pops: prefix, ie: pops://[user-
3061        name@]popserver[:port]/.
3062
3063        Another way to access your POP3 mail is the _\bf_\be_\bt_\bc_\bh_\b-_\bm_\ba_\bi_\bl function (default: G).
3064        It allows to connect to _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.210  , page 138), fetch all your
3065        new mail and place it in the local _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.301  , page 159).
3066        After this point, Mutt-ng runs exactly as if the mail had always been local.
3067
3068        N\bNo\bot\bte\be:\b: If you only need to fetch all messages to local mailbox you should con-
3069        sider using a specialized program, such as fetchmail
3070
3071        _\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)
3072
3073        If Mutt-ng was compiled with IMAP support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3074        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
3075        remote IMAP server.
3076
3077        You can access the remote inbox by selecting the folder
3078        imap://imapserver/INBOX, where imapserver is the name of the IMAP server and
3079        INBOX is the special name for your spool mailbox on the IMAP server. If you
3080        want to access another mail folder at the IMAP server, you should use
3081        imap://imapserver/path/to/folder where path/to/folder is the path of the folder
3082        you want to access.
3083
3084        You can select an alternative port by specifying it with the server, i.e.:
3085        imap://imapserver:port/INBOX.
3086
3087        You can also specify different username for each folder, i.e.: imap://user-
3088        name@imapserver[:port]/INBOX.
3089
3090        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3091
3092        The Mutt Next Generation E-Mail Client                                       62
3093
3094        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to IMAP servers can be encrypted. This natu-
3095        rally requires that the server supports SSL encrypted connections. To access a
3096        folder with IMAP/SSL, you should use imaps://[user-
3097        name@]imapserver[:port]/path/to/folder as your folder path.
3098
3099        Pine-compatible notation is also supported, i.e.  {[user-
3100        name@]imapserver[:port][/ssl]}path/to/folder
3101
3102        Note that not all servers use / as the hierarchy separator.  Mutt-ng should
3103        correctly notice which separator is being used by the server and convert paths
3104        accordingly.
3105
3106        When browsing folders on an IMAP server, you can toggle whether to look at only
3107        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
3108        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.100  , page 110)
3109        variable.
3110
3111        Polling for new mail on an IMAP server can cause noticeable delays. So, you'll
3112        want to carefully tune the _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.102  , page 110) and
3113        _\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.325  , page 166) variables.
3114
3115        Note that if you are using mbox as the mail store on UW servers prior to
3116        v12.250, the server has been reported to disconnect a client if another client
3117        selects the same folder.
3118
3119        _\b4_\b._\b1_\b4_\b._\b1  _\bT_\bh_\be _\bF_\bo_\bl_\bd_\be_\br _\bB_\br_\bo_\bw_\bs_\be_\br
3120
3121        As of version 1.2, mutt supports browsing mailboxes on an IMAP server. This is
3122        mostly the same as the local file browser, with the following differences:
3123
3124           +\bo Instead of file permissions, mutt displays the string "IMAP", possibly
3125             followed by the symbol "+", indicating that the entry contains both mes-
3126             sages and subfolders. On Cyrus-like servers folders will often contain
3127             both messages and subfolders.
3128
3129           +\bo For the case where an entry can contain both messages and subfolders, the
3130             selection key (bound to enter by default) will choose to descend into the
3131             subfolder view. If you wish to view the messages in that folder, you must
3132             use view-file instead (bound to space by default).
3133
3134           +\bo You can create, delete and rename mailboxes with the create-mailbox,
3135             delete-mailbox, and rename-mailbox commands (default bindings: C, d and r,
3136             respectively). You may also subscribe and unsubscribe to mailboxes (nor-
3137             mally these are bound to s and u, respectively).
3138
3139        _\b4_\b._\b1_\b4_\b._\b2  _\bA_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bi_\bo_\bn
3140
3141        Mutt-ng supports four authentication methods with IMAP servers: SASL, GSSAPI,
3142        CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add NTLM authentica-
3143        tion for you poor exchange users out there, but it has yet to be integrated
3144        into the main tree). There is also support for the pseudo-protocol ANONYMOUS,
3145        which allows you to log in to a public IMAP server without having an account.
3146        To use ANONYMOUS, simply make your username blank or "anonymous".
3147
3148        The Mutt Next Generation E-Mail Client                                       63
3149
3150        SASL is a special super-authenticator, which selects among several protocols
3151        (including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure method
3152        available on your host and the server. Using some of these methods (including
3153        DIGEST-MD5 and possibly GSSAPI), your entire session will be encrypted and
3154        invisible to those teeming network snoops. It is the best option if you have
3155        it. To use it, you must have the Cyrus SASL library installed on your system
3156        and compile mutt with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\ba_\bs_\bl flag.
3157
3158        Mutt-ng will try whichever methods are compiled in and available on the server,
3159        in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.
3160
3161        There are a few variables which control authentication:
3162
3163           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.108  , page 112) - controls the username under
3164             which you request authentication on the IMAP server, for all authentica-
3165             tors. This is overridden by an explicit username in the mailbox path (i.e.
3166             by using a mailbox name of the form {user@host}).
3167
3168           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.103  , page 111) - a password which you may pre-
3169             set, used by all authentication methods where a password is needed.
3170
3171           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs (section 7.4.94  , page 108) - a colon-delimited list
3172             of IMAP authentication methods to try, in the order you wish to try them.
3173             If specified, this overrides mutt's default (attempt everything, in the
3174             order listed above).
3175
3176        _\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)
3177
3178        If compiled with ``--enable-nntp'' option, Mutt-ng can read news from a
3179        newsserver via NNTP.  You can open a newsgroup with the ``change-newsgroup''
3180        function from the index/pager which is by default bound to i.
3181
3182        The Default newsserver can be obtained from the $NNTPSERVER environment vari-
3183        able. Like other news readers, info about subscribed newsgroups is saved in a
3184        file as specified by the _\b$_\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc (section 7.4.160  , page 126) variable.
3185        Article headers are cached and can be loaded from a file when a newsgroup is
3186        entered instead loading from newsserver; currently, this caching mechanism
3187        still is different from the header caching for maildir/IMAP.
3188
3189        _\b4_\b._\b1_\b5_\b._\b1  _\bA_\bg_\ba_\bi_\bn_\b: _\bS_\bc_\bo_\br_\bi_\bn_\bg
3190
3191        Especially for Usenet, people often ask for advanced filtering and scoring
3192        functionality. Of course, mutt-ng has scoring and allows a killfile, too. How
3193        to use a killfile has been discussed in _\bM_\be_\bs_\bs_\ba_\bg_\be _\bs_\bc_\bo_\br_\bi_\bn_\bg (section 3.25  , page
3194        39).
3195
3196        What has not been discusses in detail is mutt-ng's built-in realname filter.
3197        For may newsreaders including those for ``advanced users'' like _\bs_\bl_\br_\bn or _\bt_\bi_\bn,
3198        there are frequent request for such functionality. The solutions offered often
3199        are complicated regular expressions.
3200
3201        In mutt-ng this is as easy as
3202
3203        The Mutt Next Generation E-Mail Client                                       64
3204
3205             score ~* =42
3206
3207        This tells mutt-ng to apply a score of 42 to all messages whose sender speci-
3208        fied a valid realname and a valid email address. Using
3209
3210             score !~* =42
3211
3212        on the contrary applies a score of 42 to all messages _\bn_\bo_\bt matching those crite-
3213        ria which are very strict:
3214
3215           +\bo Email addresses must be valid according to RFC 2822, see <ftp://ftp.rfc-
3216             editor.org/in-notes/rfc2822.txt>
3217
3218           +\bo the name must consist of at least 2 fields whereby a field must not end in
3219             a dot. This means that ``Joe User'' and ``Joe A.  User'' are valid while
3220             ``J. User'' and ``J. A. User'' aren't.
3221
3222           +\bo it's assumed that users are interested in reading their own mail and mail
3223             from people who they have defined an alias for so that those 2 groups of
3224             messages are excluded from the strict rules.
3225
3226        _\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)
3227
3228        Mutt-ng can be built using a library called ``libESMTP'' which provides SMTP
3229        functionality. When configure was called with --with-libesmtp or the output
3230        muttng -v contains +USE_LIBESMTP, this will be or is the case already. The SMTP
3231        support includes support for Delivery Status Notification (see _\bD_\be_\bl_\bi_\bv_\be_\br_\by _\bS_\bt_\ba_\bt_\bu_\bs
3232        _\bN_\bo_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn (section 4.12  , page 60) section) as well as handling the 8BIT-
3233        MIME flag controlled via _\b$_\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be (section 7.4.332  , page 168).
3234
3235        To enable sending mail directly via SMTP without an MTA such as Postfix or
3236        SSMTP and the like, simply set the _\b$_\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.290  , page 156)
3237        variable pointing to your SMTP server.
3238
3239        Authentication mechanisms are available via the _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section 7.4.294  ,
3240        page 157) and _\b$_\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.291  , page 156) variables.
3241
3242        Transport Encryption via the StartTLS command is also available. For this to
3243        work, first of all Mutt-ng must be built with SSL or GNUTLS.  Secondly, the
3244        _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs (section 7.4.293  , page 157) variable must be either set to
3245        ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server
3246        supports it: for the second case, the connection will fail if it doesn't while
3247        switching back to unencrypted communication for the first one.
3248
3249        Some mail providers require user's to set a particular envelope sender, i.e.
3250
3251        The Mutt Next Generation E-Mail Client                                       65
3252
3253        they allow for only one value which may not be what the user wants to send as
3254        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.289  ,
3255        page 156) may be used to set the envelope different from the From: header.
3256
3257        _\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)
3258
3259        If you happen to have accounts on multiple IMAP and/or POP servers, you may
3260        find managing all the authentication settings inconvenient and error-prone.
3261        The account-hook command may help. This hook works like folder-hook but is
3262        invoked whenever you access a remote mailbox (including inside the folder
3263        browser), not just when you open the mailbox.
3264
3265        Some examples:
3266
3267             account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
3268             account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
3269             account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
3270
3271        _\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)
3272
3273        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
3274        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
3275        start a WWW browser on one of them.  This functionality is provided by the
3276        external urlview program which can be retrieved at ftp://ftp.mutt.org/mutt/con-
3277        trib/ and the configuration commands:
3278
3279             macro index \cb |urlview\n
3280             macro pager \cb |urlview\n
3281
3282        _\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)
3283
3284        If Mutt-ng was compiled with compressed folders support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\b-
3285        _\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
3286        an arbitrary format, provided that the user has a script to convert from/to
3287        this format to one of the accepted.
3288
3289        The most common use is to open compressed archived folders e.g. with gzip.
3290
3291        In addition, the user can provide a script that gets a folder in an accepted
3292        format and appends its context to the folder in the user-defined format, which
3293        may be faster than converting the entire folder to the accepted format, append-
3294        ing to it and converting back to the user-defined format.
3295
3296        There are three hooks defined (_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 66), _\bc_\bl_\bo_\bs_\be_\b-
3297        _\bh_\bo_\bo_\bk (section 4.19.2  , page 66) and _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 67))
3298        which define commands to uncompress and compress a folder and to append mes-
3299        sages to an existing compressed folder respectively.
3300
3301        The Mutt Next Generation E-Mail Client                                       66
3302
3303        For example:
3304
3305             open-hook \\.gz$ "gzip -cd %f > %t"
3306             close-hook \\.gz$ "gzip -c %t > %f"
3307             append-hook \\.gz$ "gzip -c %t >> %f"
3308
3309        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-
3310        tion 4.19.3  , page 67), the folder will be open and closed again each time you
3311        will add to it. If you omit _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 66) (or give
3312        empty command) , the folder will be open in the  mode. If you specify _\ba_\bp_\bp_\be_\bn_\bd_\b-
3313        _\bh_\bo_\bo_\bk (section 4.19.3  , page 67) though you'll be able to append to the folder.
3314
3315        Note that Mutt-ng will only try to use hooks if the file is not in one of the
3316        accepted formats. In particular, if the file is empty, mutt supposes it is not
3317        compressed. This is important because it allows the use of programs that do not
3318        have well defined extensions. Just use '.' as a regexp. But this may be sur-
3319        prising if your compressing script produces empty files. In this situation,
3320        unset _\b$_\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by (section 7.4.244  , page 146), so that the compressed file
3321        will be removed if you delete all of the messages.
3322
3323        _\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
3324
3325        Usage: open-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3326
3327        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd is the command that can be used for opening the folders whose names
3328        match _\br_\be_\bg_\be_\bx_\bp.
3329
3330        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the printf-like format string, and it should accept two
3331        parameters: %f, which is replaced with the (compressed) folder name, and %t
3332        which is replaced with the name of the temporary folder to which to write.
3333
3334        %f and %t can be repeated any number of times in the command string, and all of
3335        the entries are replaced with the appropriate folder name. In addition, %% is
3336        replaced by %, as in printf, and any other %anything is left as is.
3337
3338        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
3339        return non-zero exit status if it fails, so mutt knows something's wrong.
3340
3341        Example:
3342
3343             open-hook \\.gz$ "gzip -cd %f > %t"
3344
3345        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type.
3346
3347        _\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
3348
3349        Usage: close-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3350
3351        This is used to close the folder that was open with the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3352        4.19.1  , page 66) command after some changes were made to it.
3353
3354        The Mutt Next Generation E-Mail Client                                       67
3355
3356        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the command that can be used for closing the folders
3357        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
3358        4.19.1  , page 66) command. Temporary folder in this case is the folder previ-
3359        ously produced by the <_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 66) command.
3360
3361        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
3362        non-zero exit status if it fails, so mutt knows something's wrong.
3363
3364        Example:
3365
3366             close-hook \\.gz$ "gzip -c %t > %f"
3367
3368        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type, and the
3369        file can only be open in the readonly mode.
3370
3371        _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 66) is not called when you exit from the
3372        folder if the folder was not changed.
3373
3374        _\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
3375
3376        Usage: append-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3377
3378        This command is used for saving to an existing compressed folder.  The _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3379        is the command that can be used for appending to the folders whose names match
3380        _\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 66)
3381        command.  The temporary folder in this case contains the messages that are
3382        being appended.
3383
3384        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
3385        non-zero exit status if it fails, so mutt knows something's wrong.
3386
3387        Example:
3388
3389             append-hook \\.gz$ "gzip -c %t >> %f"
3390
3391        When _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 67) is used, the folder is not opened,
3392        which saves time, but this means that we can not find out what the folder type
3393        is. Thus the default (_\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.129  , page 118)) type is always
3394        supposed (i.e.  this is the format used for the temporary folder).
3395
3396        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  ,
3397        page 66) is called, and not _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 67). _\ba_\bp_\bp_\be_\bn_\bd_\b-
3398        _\bh_\bo_\bo_\bk (section 4.19.3  , page 67) is only for appending to existing folders.
3399
3400        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type. In this
3401        case, the folder will be open and closed again (using _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3402        4.19.1  , page 66) and _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 66)respectively) each
3403        time you will add to it.
3404
3405        The Mutt Next Generation E-Mail Client                                       68
3406
3407        _\b4_\b._\b1_\b9_\b._\b4  _\bE_\bn_\bc_\br_\by_\bp_\bt_\be_\bd _\bf_\bo_\bl_\bd_\be_\br_\bs
3408
3409        The compressed folders support can also be used to handle encrypted folders. If
3410        you want to encrypt a folder with PGP, you may want to use the following hooks:
3411
3412             open-hook  \\.pgp$ "pgp -f < %f > %t"
3413             close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
3414
3415        Please note, that PGP does not support appending to an encrypted folder, so
3416        there is no append-hook defined.
3417
3418        N\bNo\bot\bte\be:\b: the folder is temporary stored decrypted in the /tmp directory, where it
3419        can be read by your system administrator. So think about the security aspects
3420        of this.
3421
3422        _\b5_\b.  _\bM_\bu_\bt_\bt_\b-_\bn_\bg_\b'_\bs _\bM_\bI_\bM_\bE _\bS_\bu_\bp_\bp_\bo_\br_\bt
3423
3424        Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME
3425        MUA.  Every effort has been made to provide the functionality that the discern-
3426        ing MIME user requires, and the conformance to the standards wherever possible.
3427        When configuring Mutt-ng for MIME, there are two extra types of configuration
3428        files which Mutt-ng uses.  One is the mime.types file, which contains the map-
3429        ping of file extensions to IANA MIME types.  The other is the mailcap file,
3430        which specifies the external commands to use for handling specific MIME types.
3431
3432        _\b5_\b._\b1  _\bU_\bs_\bi_\bn_\bg _\bM_\bI_\bM_\bE _\bi_\bn _\bM_\bu_\bt_\bt
3433
3434        There are three areas/menus in Mutt-ng which deal with MIME, they are the pager
3435        (while viewing a message), the attachment menu and the compose menu.
3436
3437        _\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
3438
3439        When you select a message from the index and view it in the pager, Mutt decodes
3440        the message to a text representation.  Mutt-ng internally supports a number of
3441        MIME types, including text/plain, text/enriched, message/rfc822, and mes-
3442        sage/news.  In addition, the export controlled version of Mutt-ng recognizes a
3443        variety of PGP MIME types, including PGP/MIME and application/pgp.
3444
3445        Mutt-ng will denote attachments with a couple lines describing them.  These
3446        lines are of the form:
3447
3448             [-- Attachment #1: Description --]
3449             [-- Type: text/plain, Encoding: 7bit, Size: 10000 --]
3450
3451        Where the Description is the description or filename given for the attachment,
3452        and the Encoding is one of 7bit/8bit/quoted-printable/base64/binary.
3453
3454        The Mutt Next Generation E-Mail Client                                       69
3455
3456        If Mutt-ng cannot deal with a MIME type, it will display a message like:
3457
3458             [-- image/gif is unsupported (use 'v' to view this part) --]
3459
3460        _\b5_\b._\b1_\b._\b2  _\bT_\bh_\be _\bA_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bM_\be_\bn_\bu
3461
3462        The default binding for view-attachments is `v', which displays the attachment
3463        menu for a message.  The attachment menu displays a list of the attachments in
3464        a message.  From the attachment menu, you can save, print, pipe, delete, and
3465        view attachments.  You can apply these operations to a group of attachments at
3466        once, by tagging the attachments and by using the ``tag-prefix'' operator.  You
3467        can also reply to the current message from this menu, and only the current
3468        attachment (or the attachments tagged) will be quoted in your reply.  You can
3469        view attachments as text, or view them using the mailcap viewer definition.
3470
3471        Finally, you can apply the usual message-related functions (like _\br_\be_\bs_\be_\bn_\bd_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be
3472        (section 2.5.4  , page 13), and the reply and forward functions) to attachments
3473        of type message/rfc822.
3474
3475        See the help on the attachment menu for more information.
3476
3477        _\b5_\b._\b1_\b._\b3  _\bT_\bh_\be _\bC_\bo_\bm_\bp_\bo_\bs_\be _\bM_\be_\bn_\bu
3478
3479        The compose menu is the menu you see before you send a message.  It allows you
3480        to edit the recipient list, the subject, and other aspects of your message.  It
3481        also contains a list of the attachments of your message, including the main
3482        body.  From this menu, you can print, copy, filter, pipe, edit, compose,
3483        review, and rename an attachment or a list of tagged attachments.  You can also
3484        modifying the attachment information, notably the type, encoding and descrip-
3485        tion.
3486
3487        Attachments appear as follows:
3488
3489             -   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 <no description>
3490                 2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz <no description>
3491
3492        The '-' denotes that Mutt-ng will delete the file after sending (or postponing,
3493        or canceling) the message.  It can be toggled with the toggle-unlink command
3494        (default: u).  The next field is the MIME content-type, and can be changed with
3495        the edit-type command (default: ^T).  The next field is the encoding for the
3496        attachment, which allows a binary message to be encoded for transmission on
3497        7bit links.  It can be changed with the edit-encoding command (default: ^E).
3498        The next field is the size of the attachment, rounded to kilobytes or
3499        megabytes.  The next field is the filename, which can be changed with the
3500        rename-file command (default: R).  The final field is the description of the
3501        attachment, and can be changed with the edit-description command (default: d).
3502
3503        _\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
3504
3505        When you add an attachment to your mail message, Mutt-ng searches your personal
3506
3507        The Mutt Next Generation E-Mail Client                                       70
3508
3509        mime.types file at ${HOME}/.mime.types, and then the system mime.types file at
3510        /usr/local/share/mutt/mime.types or /etc/mime.types
3511
3512        The mime.types file consist of lines containing a MIME type and a space sepa-
3513        rated list of extensions.  For example:
3514
3515             application/postscript          ps eps
3516             application/pgp                 pgp
3517             audio/x-aiff                    aif aifc aiff
3518
3519        A sample mime.types file comes with the Mutt-ng distribution, and should con-
3520        tain most of the MIME types you are likely to use.
3521
3522        If Mutt-ng can not determine the mime type by the extension of the file you
3523        attach, it will look at the file.  If the file is free of binary information,
3524        Mutt-ng will assume that the file is plain text, and mark it as text/plain.  If
3525        the file contains binary information, then Mutt-ng will mark it as applica-
3526        tion/octet-stream.  You can change the MIME type that Mutt-ng assigns to an
3527        attachment by using the edit-type command from the compose menu (default: ^T).
3528        The MIME type is actually a major mime type followed by the sub-type, separated
3529        by a '/'. 6 major types: application, text, image, video, audio, and model have
3530        been approved after various internet discussions. Mutt-ng recognises all of
3531        these if the appropriate entry is found in the mime.types file. It also recog-
3532        nises other major mime types, such as the chemical type that is widely used in
3533        the molecular modelling community to pass molecular data in various forms to
3534        various molecular viewers. Non-recognised mime types should only be used if the
3535        recipient of the message is likely to be expecting such attachments.
3536
3537        _\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
3538
3539        Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix specific
3540        format specified in Appendix A of RFC 1524.  This file format is commonly
3541        referred to as the mailcap format.  Many MIME compliant programs utilize the
3542        mailcap format, allowing you to specify handling for all MIME types in one
3543        place for all programs.  Programs known to use this format include Netscape,
3544        XMosaic, lynx and metamail.
3545
3546        In order to handle various MIME types that Mutt-ng can not handle internally,
3547        Mutt-ng parses a series of external configuration files to find an external
3548        handler.  The default search string for these files is a colon delimited list
3549        set to
3550
3551             ${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
3552
3553        where $HOME is your home directory.
3554
3555        In particular, the metamail distribution will install a mailcap file, usually
3556        as /usr/local/etc/mailcap, which contains some baseline entries.
3557
3558        The Mutt Next Generation E-Mail Client                                       71
3559
3560        _\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
3561
3562        A mailcap file consists of a series of lines which are comments, blank, or def-
3563        initions.
3564
3565        A comment line consists of a # character followed by anything you want.
3566
3567        A blank line is blank.
3568
3569        A definition line consists of a content type, a view command, and any number of
3570        optional fields.  Each field of a definition line is divided by a semicolon ';'
3571        character.
3572
3573        The content type is specified in the MIME standard type/subtype method.  For
3574        example, text/plain, text/html, image/gif, etc.  In addition, the mailcap for-
3575        mat includes two formats for wildcards, one using the special '*' subtype, the
3576        other is the implicit wild, where you only include the major type.  For exam-
3577        ple, image/*, or video, will match all image types and video types, respec-
3578        tively.
3579
3580        The view command is a Unix command for viewing the type specified. There are
3581        two different types of commands supported. The default is to send the body of
3582        the MIME message to the command on stdin. You can change this behavior by using
3583        %s as a parameter to your view command.  This will cause Mutt-ng to save the
3584        body of the MIME message to a temporary file, and then call the view command
3585        with the %s replaced by the name of the temporary file. In both cases, Mutt-ng
3586        will turn over the terminal to the view program until the program quits, at
3587        which time Mutt will remove the temporary file if it exists.
3588
3589        So, in the simplest form, you can send a text/plain message to the external
3590        pager more on stdin:
3591
3592             text/plain; more
3593
3594        Or, you could send the message as a file:
3595
3596             text/plain; more %s
3597
3598        Perhaps you would like to use lynx to interactively view a text/html message:
3599
3600             text/html; lynx %s
3601
3602        In this case, lynx does not support viewing a file from stdin, so you must use
3603        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
3604        _\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
3605        _\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
3606        _\bv_\bi_\be_\bw _\bt_\bh_\be _\bo_\bb_\bj_\be_\bc_\bt_\b.
3607
3608        On the other hand, maybe you don't want to use lynx interactively, you just
3609        want to have it convert the text/html to text/plain, then you can use:
3610
3611        The Mutt Next Generation E-Mail Client                                       72
3612
3613             text/html; lynx -dump %s | more
3614
3615        Perhaps you wish to use lynx to view text/html files, and a pager on all other
3616        text formats, then you would use the following:
3617
3618             text/html; lynx %s
3619             text/*; more
3620
3621        This is the simplest form of a mailcap file.
3622
3623        _\b5_\b._\b3_\b._\b2  _\bS_\be_\bc_\bu_\br_\be _\bu_\bs_\be _\bo_\bf _\bm_\ba_\bi_\bl_\bc_\ba_\bp
3624
3625        The interpretation of shell meta-characters embedded in MIME parameters can
3626        lead to security problems in general.  Mutt-ng tries to quote parameters in
3627        expansion of %s syntaxes properly, and avoids risky characters by substituting
3628        them, see the _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 7.4.120  , page 117) variable.
3629
3630        Although mutt's procedures to invoke programs with mailcap seem to be safe,
3631        there are other applications parsing mailcap, maybe taking less care of it.
3632        Therefore you should pay attention to the following rules:
3633
3634        _\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
3635        double quotes.  Mutt-ng does this for you, the right way, as should any other
3636        program which interprets mailcap.  Don't put them into backtick expansions.  Be
3637        highly careful with eval statements, and avoid them if possible at all.  Trying
3638        to fix broken behaviour with quotes introduces new leaks - there is no alterna-
3639        tive to correct quoting in the first place.
3640
3641        If you have to use the %-expandos' values in context where you need quoting or
3642        backtick expansions, put that value into a shell variable and reference the
3643        shell variable where necessary, as in the following example (using $charset
3644        inside the backtick expansion is safe, since it is not itself subject to any
3645        further expansion):
3646
3647             text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \
3648                     && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1
3649
3650        _\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
3651
3652        _\b5_\b._\b3_\b._\b3_\b._\b1  _\bO_\bp_\bt_\bi_\bo_\bn_\ba_\bl _\bF_\bi_\be_\bl_\bd_\bs
3653
3654        In addition to the required content-type and view command fields, you can add
3655        semi-colon ';' separated fields to set flags and other options.  Mutt-ng recog-
3656        nizes the following optional fields:
3657
3658              copiousoutput
3659                    This flag tells Mutt-ng that the command passes possibly large
3660                    amounts of text on stdout.  This causes Mutt-ng to invoke a pager
3661                    (either the internal pager or the external pager defined by the
3662                    pager variable) on the output of the view command.  Without this
3663
3664        The Mutt Next Generation E-Mail Client                                       73
3665
3666                    flag, Mutt-ng assumes that the command is interactive.  One could
3667                    use this to replace the pipe to more in the lynx -dump example in
3668                    the Basic section:
3669
3670                         text/html; lynx -dump %s ; copiousoutput
3671
3672                    This will cause lynx to format the text/html output as text/plain
3673                    and Mutt-ng will use your standard pager to display the results.
3674
3675              needsterminal
3676                    Mutt-ng uses this flag when viewing attachments with _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (sec-
3677                    tion 5.4  , page 76), in order to decide whether it should honor
3678                    the setting of the _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.339  , page 169) variable
3679                    or not.  When an attachment is viewed using an interactive program,
3680                    and the corresponding mailcap entry has a _\bn_\be_\be_\bd_\bs_\bt_\be_\br_\bm_\bi_\bn_\ba_\bl flag, Mutt-
3681                    ng will use _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.339  , page 169) and the exit
3682                    status of the program to decide if it will ask you to press a key
3683                    after the external program has exited.  In all other situations it
3684                    will not prompt you for a key.
3685
3686              compose=<command>
3687                    This flag specifies the command to use to create a new attachment
3688                    of a specific MIME type.  Mutt-ng supports this from the compose
3689                    menu.
3690
3691              composetyped=<command>
3692                    This flag specifies the command to use to create a new attachment
3693                    of a specific MIME type.  This command differs from the compose
3694                    command in that mutt will expect standard MIME headers on the data.
3695                    This can be used to specify parameters, filename, description, etc.
3696                    for a new attachment.   Mutt-ng supports this from the compose
3697                    menu.
3698
3699              print=<command>
3700                    This flag specifies the command to use to print a specific MIME
3701                    type.  Mutt-ng supports this from the attachment and compose menus.
3702
3703              edit=<command>
3704                    This flag specifies the command to use to edit a specific MIME
3705                    type.  Mutt-ng supports this from the compose menu, and also uses
3706                    it to compose new attachments.  Mutt-ng will default to the defined
3707                    editor for text attachments.
3708
3709              nametemplate=<template>
3710                    This field specifies the format for the file denoted by %s in the
3711                    command fields.  Certain programs will require a certain file
3712                    extension, for instance, to correctly view a file.  For instance,
3713                    lynx will only interpret a file as text/html if the file ends in
3714                    .html.  So, you would specify lynx as a text/html viewer with a
3715                    line in the mailcap file like:
3716
3717                         text/html; lynx %s; nametemplate=%s.html
3718
3719        The Mutt Next Generation E-Mail Client                                       74
3720
3721              test=<command>
3722                    This field specifies a command to run to test whether this mailcap
3723                    entry should be used.  The command is defined with the command
3724                    expansion rules defined in the next section.  If the command
3725                    returns 0, then the test passed, and Mutt-ng uses this entry.  If
3726                    the command returns non-zero, then the test failed, and Mutt-ng
3727                    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
3728                    _\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:
3729
3730                         text/html; netscape -remote 'openURL(%s)' ; test=RunningX
3731                         text/html; lynx %s
3732
3733                    In this example, Mutt-ng will run the program RunningX which will
3734                    return 0 if the X Window manager is running, and non-zero if it
3735                    isn't.  If RunningX returns 0, then Mutt-ng will call netscape to
3736                    display the text/html object.  If RunningX doesn't return 0, then
3737                    Mutt-ng will go on to the next entry and use lynx to display the
3738                    text/html object.
3739
3740        _\b5_\b._\b3_\b._\b3_\b._\b2  _\bS_\be_\ba_\br_\bc_\bh _\bO_\br_\bd_\be_\br
3741
3742        When searching for an entry in the mailcap file, Mutt-ng will search for the
3743        most useful entry for its purpose.  For instance, if you are attempting to
3744        print an image/gif, and you have the following entries in your mailcap file,
3745        Mutt-ng will search for an entry with the print command:
3746
3747             image/*;        xv %s
3748             image/gif;      ; print= anytopnm %s | pnmtops | lpr; \
3749                             nametemplate=%s.gif
3750
3751        Mutt-ng will skip the image/* entry and use the image/gif entry with the print
3752        command.
3753
3754        In addition, you can use this with _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 76) to denote
3755        two commands for viewing an attachment, one to be viewed automatically, the
3756        other to be viewed interactively from the attachment menu.  In addition, you
3757        can then use the test feature to determine which viewer to use interactively
3758        depending on your environment.
3759
3760             text/html;      netscape -remote 'openURL(%s)' ; test=RunningX
3761             text/html;      lynx %s; nametemplate=%s.html
3762             text/html;      lynx -dump %s; nametemplate=%s.html; copiousoutput
3763
3764        For _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 76), Mutt-ng will choose the third entry
3765        because of the copiousoutput tag.  For interactive viewing, Mutt will run the
3766        program RunningX to determine if it should use the first entry.  If the program
3767        returns non-zero, Mutt-ng will use the second entry for interactive viewing.
3768
3769        _\b5_\b._\b3_\b._\b3_\b._\b3  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
3770
3771        The various commands defined in the mailcap files are passed to the /bin/sh
3772
3773        The Mutt Next Generation E-Mail Client                                       75
3774
3775        shell using the system() function.  Before the command is passed to /bin/sh -c,
3776        it is parsed to expand various special parameters with information from Mutt-
3777        ng.  The keywords Mutt-ng expands are:
3778
3779              %s
3780                    As seen in the basic mailcap section, this variable is expanded to
3781                    a filename specified by the calling program.  This file contains
3782                    the body of the message to view/print/edit or where the composing
3783                    program should place the results of composition.  In addition, the
3784                    use of this keyword causes Mutt-ng to not pass the body of the mes-
3785                    sage to the view/print/edit program on stdin.
3786
3787              %t
3788                    Mutt-ng will expand %t to the text representation of the content
3789                    type of the message in the same form as the first parameter of the
3790                    mailcap definition line, ie text/html or image/gif.
3791
3792              %{<parameter>}
3793                    Mutt-ng will expand this to the value of the specified parameter
3794                    from the Content-Type: line of the mail message.  For instance, if
3795                    Your mail message contains:
3796
3797                         Content-Type: text/plain; charset=iso-8859-1
3798
3799                    then Mutt-ng will expand %{charset} to iso-8859-1.  The default
3800                    metamail mailcap file uses this feature to test the charset to
3801                    spawn an xterm using the right charset to view the message.
3802
3803              \%
3804                    This will be replaced by a %
3805
3806        Mutt-ng does not currently support the %F and %n keywords specified in RFC
3807        1524.  The main purpose of these parameters is for multipart messages, which is
3808        handled internally by Mutt-ng.
3809
3810        _\b5_\b._\b3_\b._\b4  _\bE_\bx_\ba_\bm_\bp_\bl_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be_\bs
3811
3812        This mailcap file is fairly simple and standard:
3813
3814             # I'm always running X :)
3815             video/*;        xanim %s > /dev/null
3816             image/*;        xv %s > /dev/null
3817
3818             # I'm always running netscape (if my computer had more memory, maybe)
3819             text/html;      netscape -remote 'openURL(%s)'
3820
3821        This mailcap file shows quite a number of examples:
3822
3823        The Mutt Next Generation E-Mail Client                                       76
3824
3825             # Use xanim to view all videos   Xanim produces a header on startup,
3826             # send that to /dev/null so I don't see it
3827             video/*;        xanim %s > /dev/null
3828
3829             # Send html to a running netscape by remote
3830             text/html;      netscape -remote 'openURL(%s)'; test=RunningNetscape
3831
3832             # If I'm not running netscape but I am running X, start netscape on the
3833             # object
3834             text/html;      netscape %s; test=RunningX
3835
3836             # Else use lynx to view it as text
3837             text/html;      lynx %s
3838
3839             # This version would convert the text/html to text/plain
3840             text/html;      lynx -dump %s; copiousoutput
3841
3842             # I use enscript to print text in two columns to a page
3843             text/*;         more %s; print=enscript -2Gr %s
3844
3845             # Netscape adds a flag to tell itself to view jpegs internally
3846             image/jpeg;xv %s; x-mozilla-flags=internal
3847
3848             # Use xv to view images if I'm running X
3849             # In addition, this uses the \ to extend the line and set my editor
3850             # for images
3851             image/*;xv %s; test=RunningX; \
3852                     edit=xpaint %s
3853
3854             # Convert images to text using the netpbm tools
3855             image/*;  (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
3856             pbmtoascii -1x2 ) 2>&1 ; copiousoutput
3857
3858             # Send excel spreadsheets to my NT box
3859             application/ms-excel; open.pl %s
3860
3861        _\b5_\b._\b4  _\bM_\bI_\bM_\bE _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw
3862
3863        In addition to explicitly telling Mutt-ng to view an attachment with the MIME
3864        viewer defined in the mailcap file, Mutt-ng has support for automatically view-
3865        ing MIME attachments while in the pager.
3866
3867        To work, you must define a viewer in the mailcap file which uses the copi-
3868        ousoutput option to denote that it is non-interactive.  Usually, you also use
3869        the entry to convert the attachment to a text representation which you can view
3870        in the pager.
3871
3872        You then use the auto_view muttrc command to list the content-types that you
3873        wish to view automatically.
3874
3875        For instance, if you set auto_view to:
3876
3877        The Mutt Next Generation E-Mail Client                                       77
3878
3879             auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz
3880
3881        Mutt-ng could use the following mailcap entries to automatically view attach-
3882        ments of these types.
3883
3884             text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
3885             image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
3886             application/x-gunzip;   gzcat; copiousoutput
3887             application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput
3888             application/postscript; ps2ascii %s; copiousoutput
3889
3890        ``unauto_view'' can be used to remove previous entries from the autoview list.
3891        This can be used with message-hook to autoview messages based on size, etc.
3892        ``unauto_view *'' will remove all previous entries.
3893
3894        _\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
3895
3896        Mutt-ng has some heuristics for determining which attachment of a multi-
3897        part/alternative type to display.  First, mutt will check the alternative_order
3898        list to determine if one of the available types is preferred.  The alterna-
3899        tive_order list consists of a number of MIME types in order, including support
3900        for implicit and explicit wildcards, for example:
3901
3902             alternative_order text/enriched text/plain text application/postscript image/*
3903
3904        Next, mutt will check if any of the types have a defined _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section
3905        5.4  , page 76), and use that.  Failing that, Mutt-ng will look for any text
3906        type.  As a last attempt, mutt will look for any type it knows how to handle.
3907
3908        To remove a MIME type from the alternative_order list, use the unalterna-
3909        tive_order command.
3910
3911        _\b5_\b._\b6  _\bM_\bI_\bM_\bE _\bL_\bo_\bo_\bk_\bu_\bp
3912
3913        Mutt-ng's mime_lookup list specifies a list of mime-types that should not be
3914        treated according to their mailcap entry.  This option is designed to deal with
3915        binary types such as application/octet-stream.  When an attachment's mime-type
3916        is listed in mime_lookup, then the extension of the filename will be compared
3917        to the list of extensions in the mime.types file.  The mime-type associated
3918        with this extension will then be used to process the attachment according to
3919        the rules in the mailcap file and according to any other configuration options
3920        (such as auto_view) specified.  Common usage would be:
3921
3922             mime_lookup application/octet-stream application/X-Lotus-Manuscript
3923
3924        In addition, the unmime_lookup command may be used to disable this feature for
3925
3926        The Mutt Next Generation E-Mail Client                                       78
3927
3928        any particular mime-type if it had been set, for example, in a global muttrc.
3929
3930        _\b6_\b.  _\bS_\be_\bc_\bu_\br_\bi_\bt_\by _\bC_\bo_\bn_\bs_\bi_\bd_\be_\br_\ba_\bt_\bi_\bo_\bn_\bs
3931
3932        First of all, mutt-ng contains no security holes included by intention but may
3933        contain unknown security holes. As a consequence, please run mutt-ng only with
3934        as few permissions as possible.
3935
3936        Please do not run mutt-ng as the super user.
3937
3938        When configuring mutt-ng, there're some points to note about secure setups.
3939
3940        In practice, mutt-ng can be easily made as vulnerable as even the most insecure
3941        mail user agents (in their default configuration) just by changing mutt-ng's
3942        configuration files: it then can execute arbitrary programs and scripts
3943        attached to messages, send out private data on its own, etc. Although this is
3944        not believed to the common type of setup, please read this chapter carefully.
3945
3946        _\b6_\b._\b1  _\bP_\ba_\bs_\bs_\bw_\bo_\br_\bd_\bs
3947
3948        Although mutt-ng can be told the various passwords for accounts, please never
3949        store passwords in configuration files. Besides the fact that the system's
3950        operator can always read them, you could forget to replace the actual password
3951        with asterisks when reporting a bug or asking for help via, for example, a
3952        mailing list so that your mail including your password could be archived by
3953        internet search engines, etc. Please never store passwords on disk.
3954
3955        _\b6_\b._\b2  _\bT_\be_\bm_\bp_\bo_\br_\ba_\br_\by _\bF_\bi_\bl_\be_\bs
3956
3957        Mutt-ng uses many temporary files for viewing messages, verifying digital sig-
3958        natures, etc. The _\b$_\bu_\bm_\ba_\bs_\bk (section 7.4.330  , page 168) variable can be used to
3959        change the default permissions of these files. Please only change it if you
3960        really know what you are doing.  Also, a different location for these files may
3961        be desired which can be changed via the _\b$_\bt_\bm_\bp_\bd_\bi_\br (section 7.4.326  , page 167)
3962        variable.
3963
3964        _\b6_\b._\b3  _\bI_\bn_\bf_\bo_\br_\bm_\ba_\bt_\bi_\bo_\bn _\bL_\be_\ba_\bk_\bs
3965
3966        _\b6_\b._\b3_\b._\b1  _\bM_\be_\bs_\bs_\ba_\bg_\be_\b-_\bI_\bD_\b: _\bh_\be_\ba_\bd_\be_\br_\bs
3967
3968        In the default configuration, mutt-ng will leak some information to the outside
3969        world when sending messages: the generation of Message-ID: headers includes a
3970        step counter which is increased (and rotated) with every message sent. If you'd
3971        like to hide this information probably telling others how many mail you sent in
3972        which time, you at least need to remove the %P expando from the default setting
3973        of the _\b$_\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.146  , page 122) variable. Please make sure
3974        that you really know how local parts of these Message-ID: headers are composed.
3975
3976        The Mutt Next Generation E-Mail Client                                       79
3977
3978        _\b6_\b._\b3_\b._\b2  _\bm_\ba_\bi_\bl_\bt_\bo_\b:_\b-_\bs_\bt_\by_\bl_\be _\bl_\bi_\bn_\bk_\bs
3979
3980        As mutt-ng be can be set up to be the mail client to handle mailto: style links
3981        in websites, there're security considerations, too. To keep the old behavior by
3982        default, mutt-ng will be strict in interpreting them which means that arbitrary
3983        header fields can be embedded in these links which could override existing
3984        header fields or attach arbitrary files. This may be problematic if the
3985        _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.57  , page 100) variable is _\bu_\bn_\bs_\be_\bt, i.e. the user
3986        doesn't want to see header fields while editing the message.
3987
3988        For example, following a link like
3989
3990             mailto:joe@host?Attach=~/.gnupg/secring.gpg
3991
3992        will send out the user's private gnupg keyring to joe@host if the user doesn't
3993        follow the information on screen carefully enough.
3994
3995        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.314  , page 164) variable, mutt-
3996        ng will
3997
3998           +\bo be less strict when interpreting these links by prepending a X-Mailto-
3999             string to all header fields embedded in such a link _\ba_\bn_\bd
4000
4001           +\bo turn on the _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.57  , page 100) variable by force
4002             to let the user see all the headers (because they still may leak informa-
4003             tion.)
4004
4005        _\b6_\b._\b4  _\bE_\bx_\bt_\be_\br_\bn_\ba_\bl _\ba_\bp_\bp_\bl_\bi_\bc_\ba_\bt_\bi_\bo_\bn_\bs
4006
4007        Mutt-ng in many places has to rely on external applications or for convenience
4008        supports mechanisms involving external applications.
4009
4010        _\b6_\b._\b4_\b._\b1  _\bm_\ba_\bi_\bl_\bc_\ba_\bp
4011
4012        One of these is the mailcap mechanism as defined by RfC 1524. Mutt-ng can be
4013        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-
4014        cap files (see the _\b$_\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh (section 7.4.119  , page 116) variable for
4015        details.)
4016
4017        These utilities may have a variety of security vulnerabilities, including over-
4018        writing of arbitrary files, information leaks or other exploitable bugs.  These
4019        vulnerabilities may go unnoticed by the user, especially when they are called
4020        automatically (and without interactive prompting) from the mailcap file(s).
4021        When using mutt-ng's autoview mechanism in combination with mailcap files,
4022        please be sure to...
4023
4024           +\bo manually select trustworth applications with a reasonable calling sequence
4025
4026           +\bo periodically check the contents of mailcap files, especially after soft-
4027             ware installations or upgrades
4028
4029        The Mutt Next Generation E-Mail Client                                       80
4030
4031           +\bo keep the software packages referenced in the mailcap file up to date
4032
4033           +\bo leave the _\b$_\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 7.4.120  , page 117) variable in its
4034             default state to restrict mailcap expandos to a safe set of characters
4035
4036        _\b6_\b._\b4_\b._\b2  _\bO_\bt_\bh_\be_\br
4037
4038        Besides the mailcap mechanism, mutt-ng uses a number of other external utili-
4039        ties for operation.
4040
4041        The same security considerations apply for these as for tools involved via
4042        mailcap (for example, mutt-ng is vulnerable to Denial of Service Attacks with
4043        compressed folders support if the uncompressed mailbox is too large for the
4044        disk it is saved to.)
4045
4046        As already noted, most of these problems are not built in but caused by wrong
4047        configuration, so please check your configuration.
4048
4049        _\b7_\b.  _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be
4050
4051        _\b7_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs
4052
4053        Running mutt with no arguments will make Mutt-ng attempt to read your spool
4054        mailbox.  However, it is possible to read other mailboxes and to send messages
4055        from the command line as well.
4056
4057             -A      expand an alias
4058             -a      attach a file to a message
4059             -b      specify a blind carbon-copy (BCC) address
4060             -c      specify a carbon-copy (Cc) address
4061             -D      print the value of all variables on stdout
4062             -e      specify a config command to be run after initialization files are read
4063             -f      specify a mailbox to load
4064             -F      specify an alternate file to read initialization commands
4065             -h      print help on command line options
4066             -H      specify a draft file from which to read a header and body
4067             -i      specify a file to include in a message composition
4068             -m      specify a default mailbox type
4069             -n      do not read the system Muttngrc
4070             -p      recall a postponed message
4071             -Q      query a configuration variable
4072             -R      open mailbox in read-only mode
4073             -s      specify a subject (enclose in quotes if it contains spaces)
4074             -v      show version number and compile-time definitions
4075             -x      simulate the mailx(1) compose mode
4076             -y      show a menu containing the files specified by the mailboxes command
4077             -z      exit immediately if there are no messages in the mailbox
4078             -Z      open the first folder with new message,exit immediately if none
4079
4080        To read messages in a mailbox
4081
4082        The Mutt Next Generation E-Mail Client                                       81
4083
4084        mutt [ -nz ] [ -F _\bm_\bu_\bt_\bt_\br_\bc ] [ -m _\bt_\by_\bp_\be ] [ -f _\bm_\ba_\bi_\bl_\bb_\bo_\bx ]
4085
4086        To compose a new message
4087
4088        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-
4089        _\bj_\be_\bc_\bt ] _\ba_\bd_\bd_\br_\be_\bs_\bs [ _\ba_\bd_\bd_\br_\be_\bs_\bs ... ]
4090
4091        Mutt-ng also supports a ``batch'' mode to send prepared messages.  Simply redi-
4092        rect input from the file you wish to send.  For example,
4093
4094        mutt -s 'data set for run #2' professor@bigschool.edu < ~/run2.dat
4095
4096        This command will send a message to ``professor@bigschool.edu'' with a subject
4097        of ``data set for run #2''.  In the body of the message will be the contents of
4098        the file ``~/run2.dat''.
4099
4100        _\b7_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
4101
4102        The Mutt Next Generation E-Mail Client                                       82
4103
4104             ~A              all messages
4105             ~b EXPR         messages which contain EXPR in the message body
4106             ~B EXPR         messages which contain EXPR in the whole message
4107             ~c USER         messages carbon-copied to USER
4108             ~C EXPR         message is either to: or cc: EXPR
4109             ~D              deleted messages
4110             ~d [MIN]-[MAX]  messages with ``date-sent'' in a Date range
4111             ~E              expired messages
4112             ~e EXPR         message which contains EXPR in the ``Sender'' field
4113             ~F              flagged messages
4114             ~f USER         messages originating from USER
4115             ~g              cryptographically signed messages
4116             ~G              cryptographically encrypted messages
4117             ~H EXPR         messages with a spam attribute matching EXPR
4118             ~h EXPR         messages which contain EXPR in the message header
4119             ~k              message contains PGP key material
4120             ~i ID           message which match ID in the ``Message-ID'' field
4121             ~L EXPR         message is either originated or received by EXPR
4122             ~l              message is addressed to a known mailing list
4123             ~m [MIN]-[MAX]  message in the range MIN to MAX *)
4124             ~n [MIN]-[MAX]  messages with a score in the range MIN to MAX *)
4125             ~N              new messages
4126             ~O              old messages
4127             ~p              message is addressed to you (consults alternates)
4128             ~P              message is from you (consults alternates)
4129             ~Q              messages which have been replied to
4130             ~R              read messages
4131             ~r [MIN]-[MAX]  messages with ``date-received'' in a Date range
4132             ~S              superseded messages
4133             ~s SUBJECT      messages having SUBJECT in the ``Subject'' field.
4134             ~T              tagged messages
4135             ~t USER         messages addressed to USER
4136             ~U              unread messages
4137             ~v              message is part of a collapsed thread.
4138             ~V              cryptographically verified messages
4139             ~w EXPR         messages which contain EXPR in the `Newsgroups' field
4140                             (if compiled with NNTP support)
4141             ~x EXPR         messages which contain EXPR in the `References' field
4142             ~y EXPR         messages which contain EXPR in the `X-Label' field
4143             ~z [MIN]-[MAX]  messages with a size in the range MIN to MAX *)
4144             ~=              duplicated messages (see $duplicate_threads)
4145             ~$              unreferenced messages (requires threaded view)
4146             ~*              ``From'' contains realname and (syntactically) valid
4147                             address (excluded are addresses matching against
4148                             alternates or any alias)
4149
4150        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
4151        46).  Special attention has to be made when using regular expressions inside of
4152        patterns.  Specifically, Mutt-ng's parser for these patterns will strip one
4153        level of backslash (\), which is normally used for quoting.  If it is your
4154        intention to use a backslash in the regular expression, you will need to use
4155        two backslashes instead (\\).
4156
4157        The Mutt Next Generation E-Mail Client                                       83
4158
4159        *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too.
4160
4161        _\b7_\b._\b3  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs
4162
4163        The following are the commands understood by mutt.
4164
4165           +\bo _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\b-_\bh_\bo_\bo_\bk (section 4.17  , page 64) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4166
4167           +\bo _\ba_\bl_\bi_\ba_\bs (section 3.3  , page 23) _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
4168
4169           +\bo _\bu_\bn_\ba_\bl_\bi_\ba_\bs (section 3.3  , page 23) [ * | _\bk_\be_\by ... ]
4170
4171           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.10  , page 31) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4172
4173           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.10  , page 31) [ * | _\br_\be_\bg_\be_\bx_\bp ... ]
4174
4175           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 77) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4176
4177           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 77) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4178
4179           +\bo _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 67) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4180
4181           +\bo _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 76) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4182
4183           +\bo _\bu_\bn_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 76) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4184
4185           +\bo _\bb_\bi_\bn_\bd (section 3.4  , page 24) _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
4186
4187           +\bo _\bc_\bh_\ba_\br_\bs_\be_\bt_\b-_\bh_\bo_\bo_\bk (section 3.5  , page 26) _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
4188
4189           +\bo _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 66) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4190
4191           +\bo _\bc_\bo_\bl_\bo_\br (section 3.8  , page 28) _\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 ]
4192
4193           +\bo _\bu_\bn_\bc_\bo_\bl_\bo_\br (section 3.8  , page 28) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4194
4195           +\bo _\be_\bx_\be_\bc (section 3.24  , page 39) _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
4196
4197           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 36) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4198
4199           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 37) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4200
4201           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 26) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4202
4203           +\bo _\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.16  , page 36) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
4204
4205           +\bo _\bu_\bn_\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.16  , page 36) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
4206
4207           +\bo _\bi_\bc_\bo_\bn_\bv_\b-_\bh_\bo_\bo_\bk (section 3.5  , page 26) _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
4208
4209           +\bo _\bi_\bg_\bn_\bo_\br_\be (section 3.9  , page 30) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4210
4211        The Mutt Next Generation E-Mail Client                                       84
4212
4213           +\bo _\bu_\bn_\bi_\bg_\bn_\bo_\br_\be (section 3.9  , page 30) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4214
4215           +\bo _\bl_\bi_\bs_\bt_\bs (section 3.12  , page 33) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4216
4217           +\bo _\bu_\bn_\bl_\bi_\bs_\bt_\bs (section 3.12  , page 33) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4218
4219           +\bo _\bm_\ba_\bc_\br_\bo (section 3.7  , page 27) _\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 ]
4220
4221           +\bo _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.14  , page 34) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
4222
4223           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 34) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4224
4225           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 38) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4226
4227           +\bo _\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 77) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4228
4229           +\bo _\bu_\bn_\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 77) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4230
4231           +\bo _\bm_\bo_\bn_\bo (section 3.8  , page 28) _\bo_\bb_\bj_\be_\bc_\bt _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be [ _\br_\be_\bg_\be_\bx_\bp ]
4232
4233           +\bo _\bu_\bn_\bm_\bo_\bn_\bo (section 3.8  , page 28) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4234
4235           +\bo _\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 35) _\bs_\bt_\br_\bi_\bn_\bg
4236
4237           +\bo _\bu_\bn_\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 35) _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
4238
4239           +\bo _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 66) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4240
4241           +\bo _\bc_\br_\by_\bp_\bt_\b-_\bh_\bo_\bo_\bk (section 3.22  , page 38) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\b-_\bi_\bd
4242
4243           +\bo _\bp_\bu_\bs_\bh (section 3.23  , page 38) _\bs_\bt_\br_\bi_\bn_\bg
4244
4245           +\bo _\br_\be_\bs_\be_\bt (section 3.27  , page 42) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4246
4247           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 36) _\br_\be_\bg_\be_\bx_\bp _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4248
4249           +\bo _\bs_\bc_\bo_\br_\be (section 3.25  , page 39) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
4250
4251           +\bo _\bu_\bn_\bs_\bc_\bo_\br_\be (section 3.25  , page 39) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4252
4253           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 37) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4254
4255           +\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
4256
4257           +\bo _\bs_\be_\bt (section 3.27  , page 42) [no|inv]_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be[=_\bv_\ba_\bl_\bu_\be] [ _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4258
4259           +\bo _\bu_\bn_\bs_\be_\bt (section 3.27  , page 42) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4260
4261           +\bo _\bs_\bo_\bu_\br_\bc_\be (section 3.28  , page 43) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4262
4263           +\bo _\bs_\bp_\ba_\bm (section 3.26  , page 40) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
4264
4265           +\bo _\bn_\bo_\bs_\bp_\ba_\bm (section 3.26  , page 40) _\bp_\ba_\bt_\bt_\be_\br_\bn
4266
4267        The Mutt Next Generation E-Mail Client                                       85
4268
4269           +\bo _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.12  , page 33) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4270
4271           +\bo _\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.12  , page 33) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4272
4273           +\bo _\bt_\bo_\bg_\bg_\bl_\be (section 3.27  , page 42) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4274
4275           +\bo _\bu_\bn_\bh_\bo_\bo_\bk (section 3.29  , page 43) _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be
4276
4277        _\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
4278
4279        The following list contains all variables which, in the process of providing
4280        more consistency, have been renamed and are partially even removed already. The
4281        left column contains the old synonym variables, the right column the full/new
4282        name:
4283
4284        The Mutt Next Generation E-Mail Client                                       86
4285
4286             edit_hdrs               edit_headers
4287             forw_decode             forward_decode
4288             forw_format             forward_format
4289             forw_quote              forward_quote
4290             hdr_format              index_format
4291             indent_str              indent_string
4292             mime_fwd                mime_forward
4293             msg_format              message_format
4294             pgp_autosign            crypt_autosign
4295             pgp_autoencrypt         crypt_autoencrypt
4296             pgp_replyencrypt        crypt_replyencrypt
4297             pgp_replysign           crypt_replysign
4298             pgp_replysignencrypted  crypt_replysignencrypted
4299             pgp_verify_sig          crypt_verify_sig
4300             pgp_create_traditional  pgp_autoinline
4301             pgp_auto_traditional    pgp_replyinline
4302             forw_decrypt            forward_decrypt
4303             smime_sign_as           smime_default_key
4304             post_indent_str         post_indent_string
4305             print_cmd               print_command
4306             shorten_hierarchy       sidebar_shorten_hierarchy
4307             ask_followup_to         nntp_ask_followup_to
4308             ask_x_comment_to        nntp_ask_x_comment_to
4309             catchup_newsgroup       nntp_catchup
4310             followup_to_poster      nntp_followup_to_poster
4311             group_index_format      nntp_group_index_format
4312             inews                   nntp_inews
4313             mime_subject            nntp_mime_subject
4314             news_cache_dir          nntp_cache_dir
4315             news_server             nntp_host
4316             newsrc                  nntp_newsrc
4317             nntp_poll               nntp_mail_check
4318             pop_checkinterval       pop_mail_check
4319             post_moderated          nntp_post_moderated
4320             save_unsubscribed       nntp_save_unsubscribed
4321             show_new_news           nntp_show_new_news
4322             show_only_unread        nntp_show_only_unread
4323             x_comment_to            nntp_x_comment_to
4324             smtp_auth_username      smtp_user
4325             smtp_auth_password      smtp_pass
4326
4327        The contrib subdirectory contains a script named update-config.pl which eases
4328        migration.
4329
4330        A complete list of current variables follows.
4331
4332        _\b7_\b._\b4_\b._\b1  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\ba_\bt_\bt_\ba_\bc_\bh
4333
4334        Type: quadoption
4335
4336        Default: no
4337
4338        This variable specifies whether to abort sending if no attachment was made but
4339
4340        The Mutt Next Generation E-Mail Client                                       87
4341
4342        the content references them, i.e. the content matches the regular expression
4343        given in $attach_remind_regexp. If a match was found and this variable is set
4344        to _\by_\be_\bs, message sending will be aborted but the mail will be send nevertheless
4345        if set to _\bn_\bo.
4346
4347        This variable and $attach_remind_regexp are intended to remind the user to
4348        attach files if the message's text references them.
4349
4350        See also the $attach_remind_regexp variable.
4351
4352        _\b7_\b._\b4_\b._\b2  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\bs_\bu_\bb_\bj_\be_\bc_\bt
4353
4354        Type: quadoption
4355
4356        Default: ask-yes
4357
4358        If set to _\by_\be_\bs, when composing messages and no subject is given at the subject
4359        prompt, composition will be aborted.  If set to _\bn_\bo, composing messages with no
4360        subject given at the subject prompt will never be aborted.
4361
4362        _\b7_\b._\b4_\b._\b3  _\ba_\bb_\bo_\br_\bt_\b__\bu_\bn_\bm_\bo_\bd_\bi_\bf_\bi_\be_\bd
4363
4364        Type: quadoption
4365
4366        Default: yes
4367
4368        If set to _\by_\be_\bs, composition will automatically abort after editing the message
4369        body if no changes are made to the file (this check only happens after the
4370        _\bf_\bi_\br_\bs_\bt edit of the file).  When set to _\bn_\bo, composition will never be aborted.
4371
4372        _\b7_\b._\b4_\b._\b4  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be
4373
4374        Type: path
4375
4376        Default: '~/.muttngrc'
4377
4378        The default file in which to save aliases created by the ``_\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (sec-
4379        tion 2.5.4  , page 11)'' function.
4380
4381        N\bNo\bot\bte\be:\b: Mutt-ng will not automatically source this file; you must explicitly use
4382        the ``_\bs_\bo_\bu_\br_\bc_\be (section 3.28  , page 43)'' command for it to be executed.
4383
4384        _\b7_\b._\b4_\b._\b5  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
4385
4386        Type: string
4387
4388        Default: '%4n %2f %t %-10a   %r'
4389
4390        Specifies the format of the data displayed for the ``alias'' menu. The follow-
4391        ing printf(3)-style sequences are available:
4392
4393              %a
4394                    alias name
4395
4396        The Mutt Next Generation E-Mail Client                                       88
4397
4398              %f
4399                    flags - currently, a 'd' for an alias marked for deletion
4400
4401              %n
4402                    index number
4403
4404              %r
4405                    address which alias expands to
4406
4407              %t
4408                    character which indicates if the alias is tagged for inclusion
4409
4410        _\b7_\b._\b4_\b._\b6  _\ba_\bl_\bl_\bo_\bw_\b__\b8_\bb_\bi_\bt
4411
4412        Type: boolean
4413
4414        Default: yes
4415
4416        Controls whether 8-bit data is converted to 7-bit using either quoted-printable
4417        or base64 encoding when sending mail.
4418
4419        _\b7_\b._\b4_\b._\b7  _\ba_\bl_\bl_\bo_\bw_\b__\ba_\bn_\bs_\bi
4420
4421        Type: boolean
4422
4423        Default: no
4424
4425        Controls whether ANSI color codes in messages (and color tags in rich text mes-
4426        sages) are to be interpreted.  Messages containing these codes are rare, but if
4427        this option is set, their text will be colored accordingly. Note that this may
4428        override your color choices, and even present a security problem, since a mes-
4429        sage could include a line like ``[-- PGP output follows ...' and give it the
4430        same color as your attachment color.
4431
4432        _\b7_\b._\b4_\b._\b8  _\ba_\br_\br_\bo_\bw_\b__\bc_\bu_\br_\bs_\bo_\br
4433
4434        Type: boolean
4435
4436        Default: no
4437
4438        When _\bs_\be_\bt, an arrow (``->'') will be used to indicate the current entry in menus
4439        instead of highlighting the whole line.  On slow network or modem links this
4440        will make response faster because there is less that has to be redrawn on the
4441        screen when moving to the next or previous entries in the menu.
4442
4443        _\b7_\b._\b4_\b._\b9  _\ba_\bs_\bc_\bi_\bi_\b__\bc_\bh_\ba_\br_\bs
4444
4445        Type: boolean
4446
4447        Default: no
4448
4449        If _\bs_\be_\bt, Mutt-ng will use plain ASCII characters when displaying thread and
4450        attachment trees, instead of the default ACS characters.
4451
4452        The Mutt Next Generation E-Mail Client                                       89
4453
4454        _\b7_\b._\b4_\b._\b1_\b0  _\ba_\bs_\bk_\bb_\bc_\bc
4455
4456        Type: boolean
4457
4458        Default: no
4459
4460        If _\bs_\be_\bt, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before
4461        editing an outgoing message.
4462
4463        _\b7_\b._\b4_\b._\b1_\b1  _\ba_\bs_\bk_\bc_\bc
4464
4465        Type: boolean
4466
4467        Default: no
4468
4469        If _\bs_\be_\bt, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing
4470        the body of an outgoing message.
4471
4472        _\b7_\b._\b4_\b._\b1_\b2  _\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4473
4474        Type: string
4475
4476        Default: 'us-ascii'
4477
4478        This variable is a colon-separated list of character encoding schemes for mes-
4479        sages without character encoding indication.  Header field values and message
4480        body content without character encoding indication would be assumed that they
4481        are written in one of this list.  By default, all the header fields and message
4482        body without any charset indication are assumed to be in us-ascii.
4483
4484        For example, Japanese users might prefer this:
4485
4486        set assumed_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
4487
4488        However, only the first content is valid for the message body.  This variable
4489        is valid only if _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be (section 7.4.315  , page 164) is unset.
4490
4491        _\b7_\b._\b4_\b._\b1_\b3  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bf_\bo_\br_\bm_\ba_\bt
4492
4493        Type: string
4494
4495        Default: '%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] '
4496
4497        This variable describes the format of the ``attachment'' menu.  The following
4498        printf(3)-style sequences are understood:
4499
4500              %C
4501                    charset
4502
4503              %c
4504                    requires charset conversion (n or c)
4505
4506              %D
4507                    deleted flag
4508
4509        The Mutt Next Generation E-Mail Client                                       90
4510
4511              %d
4512                    description
4513
4514              %e
4515                    MIME Content-Transfer-Encoding: header field
4516
4517              %f
4518                    filename
4519
4520              %I
4521                    MIME Content-Disposition: header field (I=inline, A=attachment)
4522
4523              %m
4524                    major MIME type
4525
4526              %M
4527                    MIME subtype
4528
4529              %n
4530                    attachment number
4531
4532              %s
4533                    size
4534
4535              %t
4536                    tagged flag
4537
4538              %T
4539                    graphic tree characters
4540
4541              %u
4542                    unlink (=to delete) flag
4543
4544              %>X
4545                    right justify the rest of the string and pad with character 'X'
4546
4547              %|X
4548                    pad to the end of the line with character 'X'
4549
4550        _\b7_\b._\b4_\b._\b1_\b4  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\br_\be_\bm_\bi_\bn_\bd_\b__\br_\be_\bg_\be_\bx_\bp
4551
4552        Type: regular expression
4553
4554        Default: 'attach'
4555
4556        If this variable is non-empty, muttng will scan a message's contents before
4557        sending for this regular expression. If it is found, it will ask for what to do
4558        depending on the setting of $abort_noattach.
4559
4560        This variable and $abort_noattach are intended to remind the user to attach
4561        files if the message's text references them.
4562
4563        _\b7_\b._\b4_\b._\b1_\b5  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp
4564
4565        The Mutt Next Generation E-Mail Client                                       91
4566
4567        Type: string
4568
4569        Default: '\n'
4570
4571        The separator to add between attachments when operating (saving, printing, pip-
4572        ing, etc) on a list of tagged attachments.
4573
4574        _\b7_\b._\b4_\b._\b1_\b6  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\bp_\bl_\bi_\bt
4575
4576        Type: boolean
4577
4578        Default: yes
4579
4580        If this variable is _\bu_\bn_\bs_\be_\bt, when operating (saving, printing, piping, etc) on a
4581        list of tagged attachments, Mutt-ng will concatenate the attachments and will
4582        operate on them as a single attachment. The ``_\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp (section 7.4.15  ,
4583        page 91)'' separator is added after each attachment. When _\bs_\be_\bt, Mutt-ng will
4584        operate on the attachments one by one.
4585
4586        _\b7_\b._\b4_\b._\b1_\b7  _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn
4587
4588        Type: string
4589
4590        Default: 'On %d, %n wrote:'
4591
4592        This is the string that will precede a message which has been included in a
4593        reply.  For a full listing of defined printf(3)-like sequences see the section
4594        on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113)''.
4595
4596        _\b7_\b._\b4_\b._\b1_\b8  _\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg
4597
4598        Type: boolean
4599
4600        Default: no
4601
4602        When _\bs_\be_\bt, functions in the _\bi_\bn_\bd_\be_\bx menu which affect a message will be applied to
4603        all tagged messages (if there are any).  When unset, you must first use the
4604        ``tag-prefix'' function (default: ';') to make the next function apply to all
4605        tagged messages.
4606
4607        _\b7_\b._\b4_\b._\b1_\b9  _\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt
4608
4609        Type: boolean
4610
4611        Default: no
4612
4613        When _\bs_\be_\bt along with ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.57  , page 100)'', Mutt-ng
4614        will skip the initial send-menu and allow you to immediately begin editing the
4615        body of your message.  The send-menu may still be accessed once you have fin-
4616        ished editing the body of your message.
4617
4618        Also see ``_\b$_\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by (section 7.4.63  , page 101)''.
4619
4620        The Mutt Next Generation E-Mail Client                                       92
4621
4622        _\b7_\b._\b4_\b._\b2_\b0  _\bb_\be_\be_\bp
4623
4624        Type: boolean
4625
4626        Default: yes
4627
4628        When this variable is _\bs_\be_\bt, Mutt-ng will beep when an error occurs.
4629
4630        _\b7_\b._\b4_\b._\b2_\b1  _\bb_\be_\be_\bp_\b__\bn_\be_\bw
4631
4632        Type: boolean
4633
4634        Default: no
4635
4636        When this variable is _\bs_\be_\bt, Mutt-ng will beep whenever it prints a message noti-
4637        fying you of new mail.  This is independent of the setting of the ``_\b$_\bb_\be_\be_\bp (sec-
4638        tion 7.4.20  , page 92)'' variable.
4639
4640        _\b7_\b._\b4_\b._\b2_\b2  _\bb_\bo_\bu_\bn_\bc_\be
4641
4642        Type: quadoption
4643
4644        Default: ask-yes
4645
4646        Controls whether you will be asked to confirm bouncing messages.  If set to _\by_\be_\bs
4647        you don't get asked if you want to bounce a message. Setting this variable to
4648        _\bn_\bo is not generally useful, and thus not recommended, because you are unable to
4649        bounce messages.
4650
4651        _\b7_\b._\b4_\b._\b2_\b3  _\bb_\bo_\bu_\bn_\bc_\be_\b__\bd_\be_\bl_\bi_\bv_\be_\br_\be_\bd
4652
4653        Type: boolean
4654
4655        Default: yes
4656
4657        When this variable is _\bs_\be_\bt, Mutt-ng will include Delivered-To: header fields
4658        when bouncing messages.  Postfix users may wish to _\bu_\bn_\bs_\be_\bt this variable.
4659
4660        _\b7_\b._\b4_\b._\b2_\b4  _\bb_\br_\ba_\bi_\bl_\bl_\be_\b__\bf_\br_\bi_\be_\bn_\bd_\bl_\by
4661
4662        Type: boolean
4663
4664        Default: no
4665
4666        When this variable is set, mutt will place the cursor at the beginning of the
4667        current line in menus, even when the arrow_cursor variable is unset, making it
4668        easier for blind persons using Braille displays to follow these menus.  The
4669        option is disabled by default because many visual terminals don't permit making
4670        the cursor invisible.
4671
4672        _\b7_\b._\b4_\b._\b2_\b5  _\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\b__\bf_\bi_\bl_\be
4673
4674        Type: path
4675
4676        The Mutt Next Generation E-Mail Client                                       93
4677
4678        Default: '~/.mutt_certificates'
4679
4680        Availability: SSL or GNUTLS
4681
4682        This variable specifies the file where the certificates you trust are saved.
4683        When an unknown certificate is encountered, you are asked if you accept it or
4684        not. If you accept it, the certificate can also be saved in this file and fur-
4685        ther connections are automatically accepted.
4686
4687        You can also manually add CA certificates in this file. Any server certificate
4688        that is signed with one of these CA certificates are also automatically
4689        accepted.
4690
4691        Example: set certificate_file=~/.muttng/certificates
4692
4693        _\b7_\b._\b4_\b._\b2_\b6  _\bc_\bh_\ba_\br_\bs_\be_\bt
4694
4695        Type: string
4696
4697        Default: ''
4698
4699        Character set your terminal uses to display and enter textual data.
4700
4701        _\b7_\b._\b4_\b._\b2_\b7  _\bc_\bh_\be_\bc_\bk_\b__\bn_\be_\bw
4702
4703        Type: boolean
4704
4705        Default: yes
4706
4707        N\bNo\bot\bte\be:\b: this option only affects _\bm_\ba_\bi_\bl_\bd_\bi_\br and _\bM_\bH style mailboxes.
4708
4709        When _\bs_\be_\bt, Mutt-ng will check for new mail delivered while the mailbox is open.
4710        Especially with MH mailboxes, this operation can take quite some time since it
4711        involves scanning the directory and checking each file to see if it has already
4712        been looked at.  If it's _\bu_\bn_\bs_\be_\bt, no check for new mail is performed while the
4713        mailbox is open.
4714
4715        _\b7_\b._\b4_\b._\b2_\b8  _\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bu_\bn_\br_\be_\ba_\bd
4716
4717        Type: boolean
4718
4719        Default: yes
4720
4721        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not collapse a thread if it contains any unread mes-
4722        sages.
4723
4724        _\b7_\b._\b4_\b._\b2_\b9  _\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4725
4726        Type: string
4727
4728        Default: '-- Mutt-ng: Compose  [Approx. msg size: %l   Atts: %a]%>-'
4729
4730        Controls the format of the status line displayed in the ``compose'' menu.  This
4731        string is similar to ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.312  , page 162)'', but has
4732
4733        The Mutt Next Generation E-Mail Client                                       94
4734
4735        its own set of printf(3)-like sequences:
4736
4737              %a
4738                    total number of attachments
4739
4740              %h
4741                    local hostname
4742
4743              %l
4744                    approximate size (in bytes) of the current message
4745
4746              %v
4747                    Mutt-ng version string
4748
4749        See the text describing the ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.312  , page 162)''
4750        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.29  ,
4751        page 93)''.
4752
4753        _\b7_\b._\b4_\b._\b3_\b0  _\bc_\bo_\bn_\bf_\bi_\bg_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4754
4755        Type: string
4756
4757        Default: ''
4758
4759        When defined, Mutt-ng will recode commands in rc files from this encoding.
4760
4761        _\b7_\b._\b4_\b._\b3_\b1  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\ba_\bp_\bp_\be_\bn_\bd
4762
4763        Type: boolean
4764
4765        Default: yes
4766
4767        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when appending messages to an
4768        existing mailbox.
4769
4770        _\b7_\b._\b4_\b._\b3_\b2  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\bc_\br_\be_\ba_\bt_\be
4771
4772        Type: boolean
4773
4774        Default: yes
4775
4776        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when saving messages to a mail-
4777        box which does not yet exist before creating it.
4778
4779        _\b7_\b._\b4_\b._\b3_\b3  _\bc_\bo_\bn_\bn_\be_\bc_\bt_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
4780
4781        Type: number
4782
4783        Default: 30
4784
4785        Causes Mutt-ng to timeout a network connection (for IMAP or POP) after this
4786        many seconds if the connection is not able to be established.  A negative value
4787        causes Mutt-ng to wait indefinitely for the connection to succeed.
4788
4789        The Mutt Next Generation E-Mail Client                                       95
4790
4791        _\b7_\b._\b4_\b._\b3_\b4  _\bc_\bo_\bn_\bt_\be_\bn_\bt_\b__\bt_\by_\bp_\be
4792
4793        Type: string
4794
4795        Default: 'text/plain'
4796
4797        Sets the default Content-Type: header field for the body of newly composed mes-
4798        sages.
4799
4800        _\b7_\b._\b4_\b._\b3_\b5  _\bc_\bo_\bp_\by
4801
4802        Type: quadoption
4803
4804        Default: yes
4805
4806        This variable controls whether or not copies of your outgoing messages will be
4807        saved for later references.  Also see ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.234  , page
4808        143)'', ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.245  , page 146)'', ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section
4809        7.4.71  , page 103)'' and ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 36)''.
4810
4811        _\b7_\b._\b4_\b._\b3_\b6  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt
4812
4813        Type: boolean
4814
4815        Default: no
4816
4817        Setting this variable will cause Mutt-ng to always attempt to PGP encrypt out-
4818        going messages.  This is probably only useful in connection to the _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk
4819        command.  It can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when encryption is not
4820        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
4821        7.4.281  , page 154)'' is _\bs_\be_\bt, then OpenSSL is used instead to create S/MIME
4822        messages and settings can be overridden by use of the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto
4823        only)
4824
4825        _\b7_\b._\b4_\b._\b3_\b7  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bp_\bg_\bp
4826
4827        Type: boolean
4828
4829        Default: yes
4830
4831        This variable controls whether or not Mutt-ng may automatically enable PGP
4832        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
4833        7.4.36  , page 95)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 7.4.40  , page 96)'',
4834        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 7.4.38  , page 95)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
4835        7.4.41  , page 96)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.281  , page 154)''.
4836
4837        _\b7_\b._\b4_\b._\b3_\b8  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn
4838
4839        Type: boolean
4840
4841        Default: no
4842
4843        Setting this variable will cause Mutt-ng to always attempt to cryptographically
4844        sign outgoing messages.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when
4845
4846        The Mutt Next Generation E-Mail Client                                       96
4847
4848        signing is not required or encryption is requested as well. If
4849        ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.281  , page 154)'' is _\bs_\be_\bt, then OpenSSL is
4850        used instead to create S/MIME messages and settings can be overridden by use of
4851        the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto only)
4852
4853        _\b7_\b._\b4_\b._\b3_\b9  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bm_\bi_\bm_\be
4854
4855        Type: boolean
4856
4857        Default: yes
4858
4859        This variable controls whether or not Mutt-ng may automatically enable S/MIME
4860        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
4861        7.4.36  , page 95)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 7.4.40  , page 96)'',
4862        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 7.4.38  , page 95)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
4863        7.4.41  , page 96)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.281  , page 154)''.
4864
4865        _\b7_\b._\b4_\b._\b4_\b0  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt
4866
4867        Type: boolean
4868
4869        Default: yes
4870
4871        If _\bs_\be_\bt, automatically PGP or OpenSSL encrypt replies to messages which are
4872        encrypted.  (Crypto only)
4873
4874        _\b7_\b._\b4_\b._\b4_\b1  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn
4875
4876        Type: boolean
4877
4878        Default: no
4879
4880        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are signed.
4881
4882        N\bNo\bot\bte\be:\b: this does not work on messages that are encrypted a\ban\bnd\bd signed!  (Crypto
4883        only)
4884
4885        _\b7_\b._\b4_\b._\b4_\b2  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn_\be_\bn_\bc_\br_\by_\bp_\bt_\be_\bd
4886
4887        Type: boolean
4888
4889        Default: no
4890
4891        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are
4892        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
4893        7.4.40  , page 96)'', because it allows you to sign all messages which are
4894        automatically encrypted.  This works around the problem noted in
4895        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section 7.4.41  , page 96)'', that Mutt-ng is not able to
4896        find out whether an encrypted message is also signed.  (Crypto only)
4897
4898        _\b7_\b._\b4_\b._\b4_\b3  _\bc_\br_\by_\bp_\bt_\b__\bt_\bi_\bm_\be_\bs_\bt_\ba_\bm_\bp
4899
4900        Type: boolean
4901
4902        The Mutt Next Generation E-Mail Client                                       97
4903
4904        Default: yes
4905
4906        If _\bs_\be_\bt, Mutt-ng will include a time stamp in the lines surrounding PGP or
4907        S/MIME output, so spoofing such lines is more difficult.  If you are using col-
4908        ors to mark these lines, and rely on these, you may _\bu_\bn_\bs_\be_\bt this setting.
4909        (Crypto only)
4910
4911        _\b7_\b._\b4_\b._\b4_\b4  _\bc_\br_\by_\bp_\bt_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\bm_\be
4912
4913        Type: boolean
4914
4915        Default: no
4916
4917        This variable controls the use the GPGME enabled crypto backends.  If it is _\bs_\be_\bt
4918        and Mutt-ng was build with gpgme support, the gpgme code for S/MIME and PGP
4919        will be used instead of the classic code.
4920
4921        N\bNo\bot\bte\be: You need to use this option in your .muttngrc configuration file as it
4922        won't have any effect when used interactively.
4923
4924        _\b7_\b._\b4_\b._\b4_\b5  _\bc_\br_\by_\bp_\bt_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bs_\bi_\bg
4925
4926        Type: quadoption
4927
4928        Default: yes
4929
4930        If ``_\by_\be_\bs'', always attempt to verify PGP or S/MIME signatures.  If ``_\ba_\bs_\bk'', ask
4931        whether or not to verify the signature.  If ``_\bn_\bo'', never attempt to verify
4932        cryptographic signatures.  (Crypto only)
4933
4934        _\b7_\b._\b4_\b._\b4_\b6  _\bd_\ba_\bt_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4935
4936        Type: string
4937
4938        Default: '!%a, %b %d, %Y at %I:%M:%S%p %Z'
4939
4940        This variable controls the format of the date printed by the ``%d'' sequence in
4941        ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113)''.  This is passed to strftime(3)
4942        to process the date.
4943
4944        Unless the first character in the string is a bang (``!''), the month and week
4945        day names are expanded according to the locale specified in the variable
4946        ``_\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.117  , page 116)''. If the first character in the string
4947        is a bang, the bang is discarded, and the month and week day names in the rest
4948        of the string are expanded in the _\bC locale (that is in US English).
4949
4950        _\b7_\b._\b4_\b._\b4_\b7  _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk
4951
4952        Type: string
4953
4954        Default: '~f %s !~P | (~P ~C %s)'
4955
4956        This variable controls how send-hooks, message-hooks, save-hooks, and fcc-hooks
4957        will be interpreted if they are specified with only a simple regexp, instead of
4958
4959        The Mutt Next Generation E-Mail Client                                       98
4960
4961        a matching pattern.  The hooks are expanded when they are declared, so a hook
4962        will be interpreted according to the value of this variable at the time the
4963        hook is declared.  The default value matches if the message is either from a
4964        user matching the regular expression given, or if it is from you (if the from
4965        address matches ``alternates'') and is to or cc'ed to a user matching the given
4966        regular expression.
4967
4968        _\b7_\b._\b4_\b._\b4_\b8  _\bd_\be_\bl_\be_\bt_\be
4969
4970        Type: quadoption
4971
4972        Default: ask-yes
4973
4974        Controls whether or not messages are really deleted when closing or synchroniz-
4975        ing a mailbox.  If set to _\by_\be_\bs, messages marked for deleting will automatically
4976        be purged without prompting.  If set to _\bn_\bo, messages marked for deletion will
4977        be kept in the mailbox.
4978
4979        _\b7_\b._\b4_\b._\b4_\b9  _\bd_\be_\bl_\be_\bt_\be_\b__\bs_\bp_\ba_\bc_\be
4980
4981        Type: boolean
4982
4983        Default: no
4984
4985        When sending messages with format=flowed by _\bs_\be_\bt_\bt_\bi_\bn_\bg the $text_flowed variable,
4986        this variable specifies whether to also set the DelSp parameter to yes. If this
4987        is _\bu_\bn_\bs_\be_\bt, no additional parameter will be send as a value of no already is the
4988        default behavior.
4989
4990        N\bNo\bot\bte\be:\b: this variable only has an effect on _\bo_\bu_\bt_\bg_\bo_\bi_\bn_\bg messages (if $text_flowed is
4991        _\bs_\be_\bt) but not on incomming.
4992
4993        _\b7_\b._\b4_\b._\b5_\b0  _\bd_\be_\bl_\be_\bt_\be_\b__\bu_\bn_\bt_\ba_\bg
4994
4995        Type: boolean
4996
4997        Default: yes
4998
4999        If this option is _\bs_\be_\bt, Mutt-ng will untag messages when marking them for dele-
5000        tion.  This applies when you either explicitly delete a message, or when you
5001        save it to another folder.
5002
5003        _\b7_\b._\b4_\b._\b5_\b1  _\bd_\bi_\bg_\be_\bs_\bt_\b__\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be
5004
5005        Type: boolean
5006
5007        Default: yes
5008
5009        If this option is _\bs_\be_\bt, Mutt-ng's received-attachments menu will not show the
5010        subparts of individual messages in a multipart/digest.  To see these subparts,
5011        press 'v' on that menu.
5012
5013        _\b7_\b._\b4_\b._\b5_\b2  _\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br
5014
5015        The Mutt Next Generation E-Mail Client                                       99
5016
5017        Type: path
5018
5019        Default: ''
5020
5021        When _\bs_\be_\bt, specifies a command used to filter messages.  When a message is
5022        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.52  ,
5023        page 98), and the filtered message is read from the standard output.
5024
5025        _\b7_\b._\b4_\b._\b5_\b3  _\bd_\bo_\bt_\bl_\bo_\bc_\bk_\b__\bp_\br_\bo_\bg_\br_\ba_\bm
5026
5027        Type: path
5028
5029        Default: '/opt/freebsd4/mutt-ng/bin/muttng_dotlock'
5030
5031        Availability: Standalone and Dotlock
5032
5033        Contains the path of the muttng_dotlock(1) binary to be used by Mutt-ng.
5034
5035        _\b7_\b._\b4_\b._\b5_\b4  _\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by
5036
5037        Type: string
5038
5039        Default: ''
5040
5041        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
5042        or in connection with the SMTP support via libESMTP.
5043
5044        This variable sets the request for when notification is returned.  The string
5045        consists of a comma separated list (no spaces!) of one or more of the follow-
5046        ing: _\bn_\be_\bv_\be_\br, to never request notification, _\bf_\ba_\bi_\bl_\bu_\br_\be, to request notification on
5047        transmission failure, _\bd_\be_\bl_\ba_\by, to be notified of message delays, _\bs_\bu_\bc_\bc_\be_\bs_\bs, to be
5048        notified of successful transmission.
5049
5050        Example: set dsn_notify='failure,delay'
5051
5052        _\b7_\b._\b4_\b._\b5_\b5  _\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn
5053
5054        Type: string
5055
5056        Default: ''
5057
5058        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
5059        or in connection with the SMTP support via libESMTP.
5060
5061        This variable controls how much of your message is returned in DSN messages.
5062        It may be set to either _\bh_\bd_\br_\bs to return just the message header, or _\bf_\bu_\bl_\bl to
5063        return the full message.
5064
5065        Example: set dsn_return=hdrs
5066
5067        _\b7_\b._\b4_\b._\b5_\b6  _\bd_\bu_\bp_\bl_\bi_\bc_\ba_\bt_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
5068
5069        Type: boolean
5070
5071        The Mutt Next Generation E-Mail Client                                      100
5072
5073        Default: yes
5074
5075        This variable controls whether Mutt-ng, when sorting by threads, threads mes-
5076        sages with the same Message-Id: header field together.  If it is _\bs_\be_\bt, it will
5077        indicate that it thinks they are duplicates of each other with an equals sign
5078        in the thread diagram.
5079
5080        _\b7_\b._\b4_\b._\b5_\b7  _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5081
5082        Type: boolean
5083
5084        Default: no
5085
5086        This option allows you to edit the header of your outgoing messages along with
5087        the body of your message.
5088
5089        _\b7_\b._\b4_\b._\b5_\b8  _\be_\bd_\bi_\bt_\bo_\br
5090
5091        Type: path
5092
5093        Default: ''
5094
5095        This variable specifies which editor is used by Mutt-ng.  It defaults to the
5096        value of the $VISUAL, or $EDITOR, environment variable, or to the string 'vi'
5097        if neither of those are set.
5098
5099        _\b7_\b._\b4_\b._\b5_\b9  _\be_\bn_\bc_\bo_\bd_\be_\b__\bf_\br_\bo_\bm
5100
5101        Type: boolean
5102
5103        Default: no
5104
5105        When _\bs_\be_\bt, Mutt-ng will quoted-printable encode messages when they contain the
5106        string ``From '' (note the trailing space) in the beginning of a line. Useful
5107        to avoid the tampering certain mail delivery and transport agents tend to do
5108        with messages.
5109
5110        N\bNo\bot\bte\be:\b: as mutt-ng currently violates RfC3676 defining format=flowed, it's
5111        <em/strongly/ advised to _\bs_\be_\bt this option although discouraged by the standard.
5112        Alternatively, you must take care of space-stuffing <tt/From / lines (with a
5113        trailing space) yourself.
5114
5115        _\b7_\b._\b4_\b._\b6_\b0  _\be_\bn_\bt_\br_\bo_\bp_\by_\b__\bf_\bi_\bl_\be
5116
5117        Type: path
5118
5119        Default: ''
5120
5121        Availability: SSL
5122
5123        The file which includes random data that is used to initialize SSL library
5124        functions.
5125
5126        The Mutt Next Generation E-Mail Client                                      101
5127
5128        _\b7_\b._\b4_\b._\b6_\b1  _\be_\bn_\bv_\be_\bl_\bo_\bp_\be_\b__\bf_\br_\bo_\bm
5129
5130        Type: boolean
5131
5132        Default: no
5133
5134        When _\bs_\be_\bt, Mutt-ng will try to derive the message's _\be_\bn_\bv_\be_\bl_\bo_\bp_\be sender from the
5135        ``From:'' header field. Note that this information is passed to the sendmail
5136        command using the ``-f' command line switch, so don't set this option if you
5137        are using that switch in _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.251  , page 147) yourself, or
5138        if the sendmail on your machine doesn't support that command line switch.
5139
5140        _\b7_\b._\b4_\b._\b6_\b2  _\be_\bs_\bc_\ba_\bp_\be
5141
5142        Type: string
5143
5144        Default: '~'
5145
5146        Escape character to use for functions in the builtin editor.
5147
5148        _\b7_\b._\b4_\b._\b6_\b3  _\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5149
5150        Type: boolean
5151
5152        Default: no
5153
5154        When _\bs_\be_\bt, the initial prompt for recipients and subject are skipped when reply-
5155        ing to messages, and the initial prompt for subject is skipped when forwarding
5156        messages.
5157
5158        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.19  , page
5159        91)'' variable is _\bs_\be_\bt.
5160
5161        _\b7_\b._\b4_\b._\b6_\b4  _\bf_\bc_\bc_\b__\ba_\bt_\bt_\ba_\bc_\bh
5162
5163        Type: boolean
5164
5165        Default: yes
5166
5167        This variable controls whether or not attachments on outgoing messages are
5168        saved along with the main body of your message.
5169
5170        _\b7_\b._\b4_\b._\b6_\b5  _\bf_\bc_\bc_\b__\bc_\bl_\be_\ba_\br
5171
5172        Type: boolean
5173
5174        Default: no
5175
5176        When this variable is _\bs_\be_\bt, FCCs will be stored unencrypted and unsigned, even
5177        when the actual message is encrypted and/or signed.  (PGP only)
5178
5179        _\b7_\b._\b4_\b._\b6_\b6  _\bf_\bi_\bl_\be_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
5180
5181        Type: string
5182
5183        The Mutt Next Generation E-Mail Client                                      102
5184
5185        Default: ''
5186
5187        This variable is a colon-separated list of character encoding schemes for text
5188        file attatchments.  If _\bu_\bn_\bs_\be_\bt, _\b$_\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.26  , page 93) value will
5189        be used instead.  For example, the following configuration would work for
5190        Japanese text handling:
5191
5192        set file_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
5193
5194        Note: ``iso-2022-*'' must be put at the head of the value as shown above if
5195        included.
5196
5197        _\b7_\b._\b4_\b._\b6_\b7  _\bf_\bo_\bl_\bd_\be_\br
5198
5199        Type: path
5200
5201        Default: '~/Mail'
5202
5203        Specifies the default location of your mailboxes.  A ``+'' or ``='' at the
5204        beginning of a pathname will be expanded to the value of this variable.  Note
5205        that if you change this variable from the default value you need to make sure
5206        that the assignment occurs _\bb_\be_\bf_\bo_\br_\be you use ``+'' or ``='' for any other vari-
5207        ables since expansion takes place during the ``set'' command.
5208
5209        _\b7_\b._\b4_\b._\b6_\b8  _\bf_\bo_\bl_\bd_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
5210
5211        Type: string
5212
5213        Default: '%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f'
5214
5215        This variable allows you to customize the file browser display to your personal
5216        taste.  This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page
5217        113)'', but has its own set of printf(3)-like sequences:
5218
5219              %C
5220                    current file number
5221
5222              %d
5223                    date/time folder was last modified
5224
5225              %f
5226                    filename
5227
5228              %F
5229                    file permissions
5230
5231              %g
5232                    group name (or numeric gid, if missing)
5233
5234              %l
5235                    number of hard links
5236
5237              %N
5238                    N if folder has new mail, blank otherwise
5239
5240        The Mutt Next Generation E-Mail Client                                      103
5241
5242              %s
5243                    size in bytes
5244
5245              %t
5246                    * if the file is tagged, blank otherwise
5247
5248              %u
5249                    owner name (or numeric uid, if missing)
5250
5251              %>X
5252                    right justify the rest of the string and pad with character 'X'
5253
5254              %|X
5255                    pad to the end of the line with character 'X'
5256
5257        _\b7_\b._\b4_\b._\b6_\b9  _\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5258
5259        Type: boolean
5260
5261        Default: yes
5262
5263        Controls whether or not the Mail-Followup-To: header field is generated when
5264        sending mail.  When _\bs_\be_\bt, Mutt-ng will generate this field when you are replying
5265        to a known mailing list, specified with the ``subscribe'' or ``_\bl_\bi_\bs_\bt_\bs (section
5266        3.12  , page 33)'' commands or detected by common mailing list headers.
5267
5268        This field has two purposes.  First, preventing you from receiving duplicate
5269        copies of replies to messages which you send to mailing lists. Second, ensuring
5270        that you do get a reply separately for any messages sent to known lists to
5271        which you are not subscribed.  The header will contain only the list's address
5272        for subscribed lists, and both the list address and your own email address for
5273        unsubscribed lists.  Without this header, a group reply to your message sent to
5274        a subscribed list will be sent to both the list and your address, resulting in
5275        two copies of the same email for you.
5276
5277        _\b7_\b._\b4_\b._\b7_\b0  _\bf_\bo_\br_\bc_\be_\b__\bb_\bu_\bf_\bf_\by_\b__\bc_\bh_\be_\bc_\bk
5278
5279        Type: boolean
5280
5281        Default: no
5282
5283        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
5284        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
5285        already known to have new mail.
5286
5287        Also see the following variables: ``_\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.325  , page 166)'',
5288        ``_\b$_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.118  , page 116)'' and ``_\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section
5289        7.4.102  , page 110)''.
5290
5291        _\b7_\b._\b4_\b._\b7_\b1  _\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be
5292
5293        Type: boolean
5294
5295        Default: no
5296
5297        The Mutt Next Generation E-Mail Client                                      104
5298
5299        This variable is similar to ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.245  , page 146)'',
5300        except that Mutt-ng will store a copy of your outgoing message by the username
5301        of the address you are sending to even if that mailbox does not exist.
5302
5303        Also see the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.234  , page 143)'' variable.
5304
5305        _\b7_\b._\b4_\b._\b7_\b2  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
5306
5307        Type: boolean
5308
5309        Default: yes
5310
5311        Controls the decoding of complex MIME messages into text/plain when forwarding
5312        a message.  The message header is also RFC2047 decoded.  This variable is only
5313        used, if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.140  , page 120)'' is _\bu_\bn_\bs_\be_\bt, otherwise
5314        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.141  , page 121)'' is used instead.
5315
5316        _\b7_\b._\b4_\b._\b7_\b3  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\br_\by_\bp_\bt
5317
5318        Type: boolean
5319
5320        Default: yes
5321
5322        Controls the handling of encrypted messages when forwarding a message.  When
5323        _\bs_\be_\bt, the outer layer of encryption is stripped off.  This variable is only used
5324        if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.140  , page 120)'' is _\bs_\be_\bt and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
5325        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.141  , page 121)'' is _\bu_\bn_\bs_\be_\bt.  (PGP only)
5326
5327        _\b7_\b._\b4_\b._\b7_\b4  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\be_\bd_\bi_\bt
5328
5329        Type: quadoption
5330
5331        Default: yes
5332
5333        This quadoption controls whether or not the user is automatically placed in the
5334        editor when forwarding messages.  For those who always want to forward with no
5335        modification, use a setting of _\bn_\bo.
5336
5337        _\b7_\b._\b4_\b._\b7_\b5  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
5338
5339        Type: string
5340
5341        Default: '[%a: %s]'
5342
5343        This variable controls the default subject when forwarding a message.  It uses
5344        the same format sequences as the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page
5345        113)'' variable.
5346
5347        _\b7_\b._\b4_\b._\b7_\b6  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bq_\bu_\bo_\bt_\be
5348
5349        Type: boolean
5350
5351        Default: no
5352
5353        The Mutt Next Generation E-Mail Client                                      105
5354
5355        When _\bs_\be_\bt forwarded messages included in the main body of the message (when
5356        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.140  , page 120)'' is _\bu_\bn_\bs_\be_\bt) will be quoted using
5357        ``_\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.112  , page 113)''.
5358
5359        _\b7_\b._\b4_\b._\b7_\b7  _\bf_\br_\bo_\bm
5360
5361        Type: e-mail address
5362
5363        Default: ''
5364
5365        This variable contains a default from address.  It can be overridden using
5366        my_hdr (including from send-hooks) and ``_\b$_\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.240  , page
5367        145)''.  This variable is ignored if ``_\b$_\bu_\bs_\be_\b__\bf_\br_\bo_\bm (section 7.4.334  , page
5368        168)'' is unset.
5369
5370        E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar
5371        <foo@bar.fb>' when replying to the mutt-ng developer's mailing list and Mutt-ng
5372        takes this email address.
5373
5374        Defaults to the contents of the environment variable $EMAIL.
5375
5376        _\b7_\b._\b4_\b._\b7_\b8  _\bg_\be_\bc_\bo_\bs_\b__\bm_\ba_\bs_\bk
5377
5378        Type: regular expression
5379
5380        Default: '^[^,]*'
5381
5382        A regular expression used by Mutt-ng to parse the GECOS field of a password
5383        entry when expanding the alias.  By default the regular expression is set to
5384        ``^[^,]*'' which will return the string up to the first ``,'' encountered.  If
5385        the GECOS field contains a string like 'lastname, firstname' then you should
5386        do: set gecos_mask='.*'.
5387
5388        This can be useful if you see the following behavior: you address a e-mail to
5389        user ID stevef whose full name is Steve Franklin.  If Mutt-ng expands stevef to
5390        ``Franklin'' stevef@foo.bar then you should set the gecos_mask to a regular
5391        expression that will match the whole name so Mutt-ng will expand ``Franklin''
5392        to ``Franklin, Steve''.
5393
5394        _\b7_\b._\b4_\b._\b7_\b9  _\bh_\bd_\br_\bs
5395
5396        Type: boolean
5397
5398        Default: yes
5399
5400        When _\bu_\bn_\bs_\be_\bt, the header fields normally added by the ``_\bm_\by_\b__\bh_\bd_\br (section 3.15  ,
5401        page 35)'' command are not created.  This variable _\bm_\bu_\bs_\bt be _\bu_\bn_\bs_\be_\bt before compos-
5402        ing a new message or replying in order to take effect.  If _\bs_\be_\bt, the user
5403        defined header fields are added to every new message.
5404
5405        _\b7_\b._\b4_\b._\b8_\b0  _\bh_\be_\ba_\bd_\be_\br
5406
5407        Type: boolean
5408
5409        The Mutt Next Generation E-Mail Client                                      106
5410
5411        Default: no
5412
5413        When _\bs_\be_\bt, this variable causes Mutt-ng to include the header of the message you
5414        are replying to into the edit buffer.  The ``_\b$_\bw_\be_\be_\bd (section 7.4.340  , page
5415        170)'' setting applies.
5416
5417        _\b7_\b._\b4_\b._\b8_\b1  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be
5418
5419        Type: path
5420
5421        Default: ''
5422
5423        Availability: Header Cache
5424
5425        The _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 7.4.81  , page 106) variable points to the header
5426        cache database.
5427
5428        If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 7.4.81  , page 106) points to a directory it will
5429        contain a header cache database  per folder. If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section
5430        7.4.81  , page 106) points to a file that file will be a single global header
5431        cache. By default it is _\bu_\bn_\bs_\be_\bt so no header caching will be used.
5432
5433        _\b7_\b._\b4_\b._\b8_\b2  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be_\b__\bc_\bo_\bm_\bp_\br_\be_\bs_\bs
5434
5435        Type: boolean
5436
5437        Default: no
5438
5439        If enabled the header cache will be compressed. So only one fifth of the usual
5440        diskspace is used, but the uncompression can result in a slower open of the
5441        cached folder.
5442
5443        _\b7_\b._\b4_\b._\b8_\b3  _\bh_\be_\bl_\bp
5444
5445        Type: boolean
5446
5447        Default: yes
5448
5449        When _\bs_\be_\bt, help lines describing the bindings for the major functions provided
5450        by each menu are displayed on the first line of the screen.
5451
5452        N\bNo\bot\bte\be:\b: The binding will not be displayed correctly if the function is bound to a
5453        sequence rather than a single keystroke.  Also, the help line may not be
5454        updated if a binding is changed while Mutt-ng is running.  Since this variable
5455        is primarily aimed at new users, neither of these should present a major prob-
5456        lem.
5457
5458        _\b7_\b._\b4_\b._\b8_\b4  _\bh_\bi_\bd_\bd_\be_\bn_\b__\bh_\bo_\bs_\bt
5459
5460        Type: boolean
5461
5462        Default: no
5463
5464        When _\bs_\be_\bt, Mutt-ng will skip the host name part of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section
5465
5466        The Mutt Next Generation E-Mail Client                                      107
5467
5468        7.4.92  , page 108)'' variable when adding the domain part to addresses.  This
5469        variable does not affect the generation of Message-ID: header fields, and it
5470        will not lead to the cut-off of first-level domains.
5471
5472        _\b7_\b._\b4_\b._\b8_\b5  _\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5473
5474        Type: boolean
5475
5476        Default: no
5477
5478        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5479        limiting, in the thread tree.
5480
5481        _\b7_\b._\b4_\b._\b8_\b6  _\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5482
5483        Type: boolean
5484
5485        Default: yes
5486
5487        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages in the thread
5488        tree.
5489
5490        _\b7_\b._\b4_\b._\b8_\b7  _\bh_\bi_\bd_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
5491
5492        Type: boolean
5493
5494        Default: yes
5495
5496        When _\bs_\be_\bt, Mutt-ng will not show the subject of messages in the thread tree that
5497        have the same subject as their parent or closest previously displayed sibling.
5498
5499        _\b7_\b._\b4_\b._\b8_\b8  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5500
5501        Type: boolean
5502
5503        Default: no
5504
5505        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5506        limiting, at the top of threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\b-
5507        _\bi_\bn_\bg (section 7.4.86  , page 107) is set, this option will have no effect.
5508
5509        _\b7_\b._\b4_\b._\b8_\b9  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5510
5511        Type: boolean
5512
5513        Default: yes
5514
5515        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages at the top of
5516        threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd (section 7.4.85  ,
5517        page 107) is _\bs_\be_\bt, this option will have no effect.
5518
5519        _\b7_\b._\b4_\b._\b9_\b0  _\bh_\bi_\bs_\bt_\bo_\br_\by
5520
5521        Type: number
5522
5523        The Mutt Next Generation E-Mail Client                                      108
5524
5525        Default: 10
5526
5527        This variable controls the size (in number of strings remembered) of the string
5528        history buffer. The buffer is cleared each time the variable is changed.
5529
5530        _\b7_\b._\b4_\b._\b9_\b1  _\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5531
5532        Type: quadoption
5533
5534        Default: yes
5535
5536        This variable controls whether or not a Mail-Followup-To: header field is hon-
5537        ored when group-replying to a message.
5538
5539        _\b7_\b._\b4_\b._\b9_\b2  _\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be
5540
5541        Type: string
5542
5543        Default: ''
5544
5545        Specifies the hostname to use after the ``@'' in local e-mail addresses and
5546        during generation of Message-Id: headers.
5547
5548        Please be sure to really know what you are doing when changing this variable to
5549        configure a custom domain part of Message-IDs.
5550
5551        _\b7_\b._\b4_\b._\b9_\b3  _\bi_\bg_\bn_\bo_\br_\be_\b__\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by_\b__\bt_\bo
5552
5553        Type: boolean
5554
5555        Default: no
5556
5557        Affects the behaviour of the _\br_\be_\bp_\bl_\by function when replying to messages from
5558        mailing lists.  When _\bs_\be_\bt, if the ``Reply-To:'' header field is set to the same
5559        value as the ``To:'' header field, Mutt-ng assumes that the ``Reply-To:''
5560        header field was set by the mailing list to automate responses to the list, and
5561        will ignore this field.  To direct a response to the mailing list when this
5562        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
5563        sender and the list.
5564
5565        _\b7_\b._\b4_\b._\b9_\b4  _\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
5566
5567        Type: string
5568
5569        Default: ''
5570
5571        Availability: IMAP
5572
5573        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
5574        use to log in to an IMAP server, in the order Mutt-ng should try them.  Authen-
5575        tication methods are either ``login'' or the right side of an IMAP ``AUTH=''
5576        capability string, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''. This param-
5577        eter is case-insensitive.
5578
5579        The Mutt Next Generation E-Mail Client                                      109
5580
5581        If this parameter is _\bu_\bn_\bs_\be_\bt (the default) Mutt-ng will try all available meth-
5582        ods, in order from most-secure to least-secure.
5583
5584        Example: set imap_authenticators='gssapi:cram-md5:login'
5585
5586        N\bNo\bot\bte\be:\b: Mutt-ng will only fall back to other authentication methods if the previ-
5587        ous methods are unavailable. If a method is available but authentication fails,
5588        Mutt-ng will not connect to the IMAP server.
5589
5590        _\b7_\b._\b4_\b._\b9_\b5  _\bi_\bm_\ba_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5591
5592        Type: boolean
5593
5594        Default: no
5595
5596        When _\bs_\be_\bt, mutt will fetch the set of subscribed folders from your server on
5597        connection, and add them to the set of mailboxes it polls for new mail. See
5598        also the ``_\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.14  , page 34)'' command.
5599
5600        _\b7_\b._\b4_\b._\b9_\b6  _\bi_\bm_\ba_\bp_\b__\bd_\be_\bl_\bi_\bm_\b__\bc_\bh_\ba_\br_\bs
5601
5602        Type: string
5603
5604        Default: '/.'
5605
5606        Availability: IMAP
5607
5608        This contains the list of characters which you would like to treat as folder
5609        separators for displaying IMAP paths. In particular it helps in using the '='
5610        shortcut for your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.67  , page 102) variable.
5611
5612        _\b7_\b._\b4_\b._\b9_\b7  _\bi_\bm_\ba_\bp_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5613
5614        Type: string
5615
5616        Default: ''
5617
5618        Availability: IMAP
5619
5620        Mutt-ng requests these header fields in addition to the default headers (``DATE
5621        FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-
5622        REPLY-TO REPLY-TO LINES X-LABEL'') from IMAP servers before displaying the
5623        ``index'' menu. You may want to add more headers for spam detection.
5624
5625        N\bNo\bot\bte\be:\b: This is a space separated list.
5626
5627        _\b7_\b._\b4_\b._\b9_\b8  _\bi_\bm_\ba_\bp_\b__\bh_\bo_\bm_\be_\b__\bn_\ba_\bm_\be_\bs_\bp_\ba_\bc_\be
5628
5629        Type: string
5630
5631        Default: ''
5632
5633        Availability: IMAP
5634
5635        The Mutt Next Generation E-Mail Client                                      110
5636
5637        You normally want to see your personal folders alongside your INBOX in the IMAP
5638        browser. If you see something else, you may set this variable to the IMAP path
5639        to your folders.
5640
5641        _\b7_\b._\b4_\b._\b9_\b9  _\bi_\bm_\ba_\bp_\b__\bk_\be_\be_\bp_\ba_\bl_\bi_\bv_\be
5642
5643        Type: number
5644
5645        Default: 900
5646
5647        Availability: IMAP
5648
5649        This variable specifies the maximum amount of time in seconds that Mutt-ng will
5650        wait before polling open IMAP connections, to prevent the server from closing
5651        them before Mutt-ng has finished with them.
5652
5653        The default is well within the RFC-specified minimum amount of time (30 min-
5654        utes) before a server is allowed to do this, but in practice the RFC does get
5655        violated every now and then.
5656
5657        Reduce this number if you find yourself getting disconnected from your IMAP
5658        server due to inactivity.
5659
5660        _\b7_\b._\b4_\b._\b1_\b0_\b0  _\bi_\bm_\ba_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5661
5662        Type: boolean
5663
5664        Default: no
5665
5666        Availability: IMAP
5667
5668        This variable configures whether IMAP folder browsing will look for only sub-
5669        scribed folders or all folders.  This can be toggled in the IMAP browser with
5670        the _\bt_\bo_\bg_\bg_\bl_\be_\b-_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd function.
5671
5672        _\b7_\b._\b4_\b._\b1_\b0_\b1  _\bi_\bm_\ba_\bp_\b__\bl_\bo_\bg_\bi_\bn
5673
5674        Type: string
5675
5676        Default: ''
5677
5678        Availability: IMAP
5679
5680        Your login name on the IMAP server.
5681
5682        This variable defaults to the value of ``_\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.108  , page
5683        112).''
5684
5685        _\b7_\b._\b4_\b._\b1_\b0_\b2  _\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5686
5687        Type: number
5688
5689        Default: 300
5690
5691        The Mutt Next Generation E-Mail Client                                      111
5692
5693        This variable configures how often (in seconds) Mutt-ng should look for new
5694        mail in IMAP folders. This is split from the ``_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.118  ,
5695        page 116)'' variable to generate less traffic and get more accurate information
5696        for local folders.
5697
5698        _\b7_\b._\b4_\b._\b1_\b0_\b3  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs
5699
5700        Type: string
5701
5702        Default: ''
5703
5704        Availability: IMAP
5705
5706        Specifies the password for your IMAP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt
5707        you for your password when you invoke the fetch-mail function.
5708
5709        W\bWa\bar\brn\bni\bin\bng\bg: you should only use this option when you are on a fairly secure
5710        machine, because the superuser can read your configuration even if you are the
5711        only one who can read the file.
5712
5713        _\b7_\b._\b4_\b._\b1_\b0_\b4  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs_\bi_\bv_\be
5714
5715        Type: boolean
5716
5717        Default: yes
5718
5719        Availability: IMAP
5720
5721        When _\bs_\be_\bt, Mutt-ng will not open new IMAP connections to check for new mail.
5722        Mutt-ng will only check for new mail over existing IMAP connections.  This is
5723        useful if you don't want to be prompted to user/password pairs on Mutt-ng invo-
5724        cation, or if opening the connection is slow.
5725
5726        _\b7_\b._\b4_\b._\b1_\b0_\b5  _\bi_\bm_\ba_\bp_\b__\bp_\be_\be_\bk
5727
5728        Type: boolean
5729
5730        Default: yes
5731
5732        Availability: IMAP
5733
5734        If _\bs_\be_\bt, Mutt-ng will avoid implicitly marking your mail as read whenever you
5735        fetch a message from the server. This is generally a good thing, but can make
5736        closing an IMAP folder somewhat slower. This option exists to appease speed
5737        freaks.
5738
5739        _\b7_\b._\b4_\b._\b1_\b0_\b6  _\bi_\bm_\ba_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
5740
5741        Type: quadoption
5742
5743        Default: ask-yes
5744
5745        Availability: IMAP
5746
5747        The Mutt Next Generation E-Mail Client                                      112
5748
5749        Controls whether or not Mutt-ng will try to reconnect to IMAP server when the
5750        connection is lost.
5751
5752        _\b7_\b._\b4_\b._\b1_\b0_\b7  _\bi_\bm_\ba_\bp_\b__\bs_\be_\br_\bv_\be_\br_\bn_\bo_\bi_\bs_\be
5753
5754        Type: boolean
5755
5756        Default: yes
5757
5758        Availability: IMAP
5759
5760        When _\bs_\be_\bt, Mutt-ng will display warning messages from the IMAP server as error
5761        messages. Since these messages are often harmless, or generated due to configu-
5762        ration problems on the server which are out of the users' hands, you may wish
5763        to suppress them at some point.
5764
5765        _\b7_\b._\b4_\b._\b1_\b0_\b8  _\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br
5766
5767        Type: string
5768
5769        Default: ''
5770
5771        Availability: IMAP
5772
5773        The name of the user whose mail you intend to access on the IMAP server.
5774
5775        This variable defaults to your user name on the local machine.
5776
5777        _\b7_\b._\b4_\b._\b1_\b0_\b9  _\bi_\bm_\bp_\bl_\bi_\bc_\bi_\bt_\b__\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw
5778
5779        Type: boolean
5780
5781        Default: no
5782
5783        If _\bs_\be_\bt, Mutt-ng will look for a mailcap entry with the ``copiousoutput'' flag
5784        set for _\be_\bv_\be_\br_\by MIME attachment it doesn't have an internal viewer defined for.
5785        If such an entry is found, Mutt-ng will use the viewer defined in that entry to
5786        convert the body part to text form.
5787
5788        _\b7_\b._\b4_\b._\b1_\b1_\b0  _\bi_\bn_\bc_\bl_\bu_\bd_\be
5789
5790        Type: quadoption
5791
5792        Default: ask-yes
5793
5794        Controls whether or not a copy of the message(s) you are replying to is
5795        included in your reply.
5796
5797        _\b7_\b._\b4_\b._\b1_\b1_\b1  _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b__\bo_\bn_\bl_\by_\bf_\bi_\br_\bs_\bt
5798
5799        Type: boolean
5800
5801        Default: no
5802
5803        The Mutt Next Generation E-Mail Client                                      113
5804
5805        Controls whether or not Mutt-ng includes only the first attachment of the mes-
5806        sage you are replying.
5807
5808        _\b7_\b._\b4_\b._\b1_\b1_\b2  _\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
5809
5810        Type: string
5811
5812        Default: '> '
5813
5814        Specifies the string to prepend to each line of text quoted in a message to
5815        which you are replying.  You are strongly encouraged not to change this value,
5816        as it tends to agitate the more fanatical netizens.
5817
5818        _\b7_\b._\b4_\b._\b1_\b1_\b3  _\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
5819
5820        Type: string
5821
5822        Default: '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
5823
5824        This variable allows you to customize the message index display to your per-
5825        sonal taste.
5826
5827        ``Format strings'' are similar to the strings used in the ``C'' function
5828        printf(3) to format output (see the man page for more detail).  The following
5829        sequences are defined in Mutt-ng:
5830
5831              %a
5832                    address of the author
5833
5834              %A
5835                    reply-to address (if present; otherwise: address of author)
5836
5837              %b
5838                    filename of the original message folder (think mailBox)
5839
5840              %B
5841                    the list to which the letter was sent, or else the folder name
5842                    (%b).
5843
5844              %c
5845                    number of characters (bytes) in the message
5846
5847              %C
5848                    current message number
5849
5850              %d
5851                    date and time of the message in the format specified by ``date_for-
5852                    mat'' converted to sender's time zone
5853
5854              %D
5855                    date and time of the message in the format specified by ``date_for-
5856                    mat'' converted to the local time zone
5857
5858        The Mutt Next Generation E-Mail Client                                      114
5859
5860              %e
5861                    current message number in thread
5862
5863              %E
5864                    number of messages in current thread
5865
5866              %f
5867                    entire From: line (address + real name)
5868
5869              %F
5870                    author name, or recipient name if the message is from you
5871
5872              %H
5873                    spam attribute(s) of this message
5874
5875              %g
5876                    newsgroup name (if compiled with nntp support)
5877
5878              %i
5879                    message-id of the current message
5880
5881              %l
5882                    number of lines in the message (does not work with maildir, mh, and
5883                    possibly IMAP folders)
5884
5885              %L
5886                    If an address in the To or CC header field matches an address
5887                    defined by the users ``subscribe'' command, this displays 'To
5888                    <list-name>', otherwise the same as %F.
5889
5890              %m
5891                    total number of message in the mailbox
5892
5893              %M
5894                    number of hidden messages if the thread is collapsed.
5895
5896              %N
5897                    message score
5898
5899              %n
5900                    author's real name (or address if missing)
5901
5902              %O
5903                    (_O_riginal save folder)  Where Mutt-ng would formerly have stashed
5904                    the message: list name or recipient name if no list
5905
5906              %s
5907                    subject of the message
5908
5909              %S
5910                    status of the message (N/D/d/!/r/*)
5911
5912              %t
5913                    `to:' field (recipients)
5914
5915        The Mutt Next Generation E-Mail Client                                      115
5916
5917              %T
5918                    the appropriate character from the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.327  ,
5919                    page 167) string
5920
5921              %u
5922                    user (login) name of the author
5923
5924              %v
5925                    first name of the author, or the recipient if the message is from
5926                    you
5927
5928              %W
5929                    name of organization of author (`organization:' field)
5930
5931              %y
5932                    `x-label:' field, if present
5933
5934              %Y
5935                    `x-label' field, if present, and (1) not at part of a thread tree,
5936                    (2) at the top of a thread, or (3) `x-label' is different from pre-
5937                    ceding message's `x-label'.
5938
5939              %Z
5940                    message status flags
5941
5942              %{fmt}
5943                    the date and time of the message is converted to sender's time
5944                    zone, and ``fmt'' is expanded by the library function ``strftime'';
5945                    a leading bang disables locales
5946
5947              %[fmt]
5948                    the date and time of the message is converted to the local time
5949                    zone, and ``fmt'' is expanded by the library function ``strftime'';
5950                    a leading bang disables locales
5951
5952              %(fmt)
5953                    the local date and time when the message was received.  ``fmt'' is
5954                    expanded by the library function ``strftime''; a leading bang dis-
5955                    ables locales
5956
5957              %<fmt>
5958                    the current local time. ``fmt'' is expanded by the library function
5959                    ``strftime''; a leading bang disables locales.
5960
5961              %>X
5962                    right justify the rest of the string and pad with character 'X'
5963
5964              %|X
5965                    pad to the end of the line with character 'X'
5966
5967        See also: ``_\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.327  , page 167)''.
5968
5969        _\b7_\b._\b4_\b._\b1_\b1_\b4  _\bi_\bs_\bp_\be_\bl_\bl
5970
5971        The Mutt Next Generation E-Mail Client                                      116
5972
5973        Type: path
5974
5975        Default: 'ispell'
5976
5977        How to invoke ispell (GNU's spell-checking software).
5978
5979        _\b7_\b._\b4_\b._\b1_\b1_\b5  _\bk_\be_\be_\bp_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
5980
5981        Type: boolean
5982
5983        Default: no
5984
5985        If _\bs_\be_\bt, read messages marked as flagged will not be moved from your spool mail-
5986        box to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.128  , page 118)'' mailbox, or as a result of
5987        a ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 34)'' command.
5988
5989        _\b7_\b._\b4_\b._\b1_\b1_\b6  _\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5990
5991        Type: quadoption
5992
5993        Default: no
5994
5995        When _\bs_\be_\bt, address replies to the mailing list the original message came from
5996        (instead to the author only). Setting this option to ``_\ba_\bs_\bk_\b-_\by_\be_\bs'' or ``_\ba_\bs_\bk_\b-_\bn_\bo''
5997        will ask if you really intended to reply to the author only.
5998
5999        _\b7_\b._\b4_\b._\b1_\b1_\b7  _\bl_\bo_\bc_\ba_\bl_\be
6000
6001        Type: string
6002
6003        Default: 'C'
6004
6005        The locale used by strftime(3) to format dates. Legal values are the strings
6006        your system accepts for the locale variable LC_TIME.
6007
6008        _\b7_\b._\b4_\b._\b1_\b1_\b8  _\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6009
6010        Type: number
6011
6012        Default: 5
6013
6014        This variable configures how often (in seconds) Mutt-ng should look for new
6015        mail.
6016
6017        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
6018        7.4.102  , page 110).
6019
6020        _\b7_\b._\b4_\b._\b1_\b1_\b9  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh
6021
6022        Type: string
6023
6024        Default: ''
6025
6026        This variable specifies which files to consult when attempting to display MIME
6027
6028        The Mutt Next Generation E-Mail Client                                      117
6029
6030        bodies not directly supported by Mutt-ng.
6031
6032        _\b7_\b._\b4_\b._\b1_\b2_\b0  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be
6033
6034        Type: boolean
6035
6036        Default: yes
6037
6038        If _\bs_\be_\bt, Mutt-ng will restrict possible characters in mailcap % expandos to a
6039        well-defined set of safe characters.  This is the safe setting, but we are not
6040        sure it doesn't break some more advanced MIME stuff.
6041
6042        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!
6043
6044        _\b7_\b._\b4_\b._\b1_\b2_\b1  _\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
6045
6046        Type: boolean
6047
6048        Default: yes
6049
6050        Availability: Header Cache
6051
6052        Check for Maildir unaware programs other than Mutt-ng having modified maildir
6053        files when the header cache is in use. This incurs one stat(2) per message
6054        every time the folder is opened.
6055
6056        _\b7_\b._\b4_\b._\b1_\b2_\b2  _\bm_\ba_\bi_\bl_\bd_\bi_\br_\b__\bt_\br_\ba_\bs_\bh
6057
6058        Type: boolean
6059
6060        Default: no
6061
6062        If _\bs_\be_\bt, messages marked as deleted will be saved with the maildir (T)rashed
6063        flag instead of physically deleted.
6064
6065        N\bNO\bOT\bTE\bE:\b: this only applies to maildir-style mailboxes. Setting it will have no
6066        effect on other mailbox types.
6067
6068        It is similiar to the trash option.
6069
6070        _\b7_\b._\b4_\b._\b1_\b2_\b3  _\bm_\ba_\br_\bk_\b__\bo_\bl_\bd
6071
6072        Type: boolean
6073
6074        Default: yes
6075
6076        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
6077        mailbox without reading them.
6078
6079        With this option _\bs_\be_\bt, the next time you start Mutt-ng, the messages will show
6080        up with an 'O' next to them in the ``index'' menu, indicating that they are
6081        old.
6082
6083        The Mutt Next Generation E-Mail Client                                      118
6084
6085        _\b7_\b._\b4_\b._\b1_\b2_\b4  _\bm_\ba_\br_\bk_\be_\br_\bs
6086
6087        Type: boolean
6088
6089        Default: yes
6090
6091        Controls the display of wrapped lines in the internal pager. If set, a ``+''
6092        marker is displayed at the beginning of wrapped lines. Also see the
6093        ``_\b$_\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp (section 7.4.267  , page 151)'' variable.
6094
6095        _\b7_\b._\b4_\b._\b1_\b2_\b5  _\bm_\ba_\bs_\bk
6096
6097        Type: regular expression
6098
6099        Default: '!^\.[^.]'
6100
6101        A regular expression used in the file browser, optionally preceded by the _\bn_\bo_\bt
6102        operator ``!''.  Only files whose names match this mask will be shown. The
6103        match is always case-sensitive.
6104
6105        _\b7_\b._\b4_\b._\b1_\b2_\b6  _\bm_\ba_\bx_\b__\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\br_\be_\bc_\bi_\bp_\bs
6106
6107        Type: number
6108
6109        Default: 0
6110
6111        When set non-zero, this specifies the maximum number of recipient header lines
6112        (To:, Cc: and Bcc:) to display in the pager if header weeding is turned on. In
6113        case the number of lines exeeds its value, the last line will have 3 dots
6114        appended.
6115
6116        _\b7_\b._\b4_\b._\b1_\b2_\b7  _\bm_\ba_\bx_\b__\bl_\bi_\bn_\be_\b__\bl_\be_\bn_\bg_\bt_\bh
6117
6118        Type: number
6119
6120        Default: 0
6121
6122        When _\bs_\be_\bt, the maximum line length for displaying ``format = flowed'' messages
6123        is limited to this length. A value of 0 (which is also the default) means that
6124        the maximum line length is determined by the terminal width and _\b$_\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
6125        (section 7.4.342  , page 170).
6126
6127        _\b7_\b._\b4_\b._\b1_\b2_\b8  _\bm_\bb_\bo_\bx
6128
6129        Type: path
6130
6131        Default: '~/mbox'
6132
6133        This specifies the folder into which read mail in your ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
6134        7.4.301  , page 159)'' folder will be appended.
6135
6136        _\b7_\b._\b4_\b._\b1_\b2_\b9  _\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be
6137
6138        Type: folder magic
6139
6140        The Mutt Next Generation E-Mail Client                                      119
6141
6142        Default: mbox
6143
6144        The default mailbox type used when creating new folders. May be any of mbox,
6145        MMDF, MH and Maildir.
6146
6147        _\b7_\b._\b4_\b._\b1_\b3_\b0  _\bm_\be_\bn_\bu_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6148
6149        Type: number
6150
6151        Default: 0
6152
6153        This variable controls the number of lines of context that are given when
6154        scrolling through menus. (Similar to ``_\b$_\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.171  , page
6155        129)''.)
6156
6157        _\b7_\b._\b4_\b._\b1_\b3_\b1  _\bm_\be_\bn_\bu_\b__\bm_\bo_\bv_\be_\b__\bo_\bf_\bf
6158
6159        Type: boolean
6160
6161        Default: yes
6162
6163        When _\bu_\bn_\bs_\be_\bt, the bottom entry of menus will never scroll up past the bottom of
6164        the screen, unless there are less entries than lines.  When _\bs_\be_\bt, the bottom
6165        entry may move off the bottom.
6166
6167        _\b7_\b._\b4_\b._\b1_\b3_\b2  _\bm_\be_\bn_\bu_\b__\bs_\bc_\br_\bo_\bl_\bl
6168
6169        Type: boolean
6170
6171        Default: no
6172
6173        When _\bs_\be_\bt, menus will be scrolled up or down one line when you attempt to move
6174        across a screen boundary.  If _\bu_\bn_\bs_\be_\bt, the screen is cleared and the next or pre-
6175        vious page of the menu is displayed (useful for slow links to avoid many
6176        redraws).
6177
6178        _\b7_\b._\b4_\b._\b1_\b3_\b3  _\bm_\be_\bs_\bs_\ba_\bg_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
6179
6180        Type: string
6181
6182        Default: '%s'
6183
6184        This is the string displayed in the ``attachment'' menu for attachments of type
6185        message/rfc822.  For a full listing of defined printf(3)-like sequences see the
6186        section on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113)''.
6187
6188        _\b7_\b._\b4_\b._\b1_\b3_\b4  _\bm_\be_\bt_\ba_\b__\bk_\be_\by
6189
6190        Type: boolean
6191
6192        Default: no
6193
6194        If _\bs_\be_\bt, forces Mutt-ng to interpret keystrokes with the high bit (bit 8) set as
6195        if the user had pressed the ESC key and whatever key remains after having the
6196
6197        The Mutt Next Generation E-Mail Client                                      120
6198
6199        high bit removed.  For example, if the key pressed has an ASCII value of 0xf4,
6200        then this is treated as if the user had pressed ESC then ``x''.  This is
6201        because the result of removing the high bit from ``0xf4'' is ``0x74'', which is
6202        the ASCII character ``x''.
6203
6204        _\b7_\b._\b4_\b._\b1_\b3_\b5  _\bm_\be_\bt_\bo_\bo
6205
6206        Type: boolean
6207
6208        Default: no
6209
6210        If _\bu_\bn_\bs_\be_\bt, Mutt-ng will remove your address (see the ``alternates'' command)
6211        from the list of recipients when replying to a message.
6212
6213        _\b7_\b._\b4_\b._\b1_\b3_\b6  _\bm_\bh_\b__\bp_\bu_\br_\bg_\be
6214
6215        Type: boolean
6216
6217        Default: no
6218
6219        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will mimic mh's behaviour and rename deleted messages to
6220        _\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-
6221        able is set, the message files will simply be deleted.
6222
6223        _\b7_\b._\b4_\b._\b1_\b3_\b7  _\bm_\bh_\b__\bs_\be_\bq_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
6224
6225        Type: string
6226
6227        Default: 'flagged'
6228
6229        The name of the MH sequence used for flagged messages.
6230
6231        _\b7_\b._\b4_\b._\b1_\b3_\b8  _\bm_\bh_\b__\bs_\be_\bq_\b__\br_\be_\bp_\bl_\bi_\be_\bd
6232
6233        Type: string
6234
6235        Default: 'replied'
6236
6237        The name of the MH sequence used to tag replied messages.
6238
6239        _\b7_\b._\b4_\b._\b1_\b3_\b9  _\bm_\bh_\b__\bs_\be_\bq_\b__\bu_\bn_\bs_\be_\be_\bn
6240
6241        Type: string
6242
6243        Default: 'unseen'
6244
6245        The name of the MH sequence used for unseen messages.
6246
6247        _\b7_\b._\b4_\b._\b1_\b4_\b0  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd
6248
6249        Type: quadoption
6250
6251        Default: no
6252
6253        The Mutt Next Generation E-Mail Client                                      121
6254
6255        When _\bs_\be_\bt, the message you are forwarding will be attached as a separate MIME
6256        part instead of included in the main body of the message.
6257
6258        This is useful for forwarding MIME messages so the receiver can properly view
6259        the message as it was delivered to you. If you like to switch between MIME and
6260        not MIME from mail to mail, set this variable to ask-no or ask-yes.
6261
6262        Also see ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.72  , page 104)'' and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
6263        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.141  , page 121)''.
6264
6265        _\b7_\b._\b4_\b._\b1_\b4_\b1  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
6266
6267        Type: boolean
6268
6269        Default: no
6270
6271        Controls the decoding of complex MIME messages into text/plain when forwarding
6272        a message while ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.140  , page 120)'' is _\bs_\be_\bt. Other-
6273        wise ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.72  , page 104)'' is used instead.
6274
6275        _\b7_\b._\b4_\b._\b1_\b4_\b2  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\br_\be_\bs_\bt
6276
6277        Type: quadoption
6278
6279        Default: yes
6280
6281        When forwarding multiple attachments of a MIME message from the recvattach
6282        menu, attachments which cannot be decoded in a reasonable manner will be
6283        attached to the newly composed message if this option is set.
6284
6285        _\b7_\b._\b4_\b._\b1_\b4_\b3  _\bm_\bi_\bx_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
6286
6287        Type: string
6288
6289        Default: '%4n %c %-16s %a'
6290
6291        Availability: Mixmaster
6292
6293        This variable describes the format of a remailer line on the mixmaster chain
6294        selection screen.  The following printf(3)-like sequences are supported:
6295
6296              %n
6297                    The running number on the menu.
6298
6299              %c
6300                    Remailer capabilities.
6301
6302              %s
6303                    The remailer's short name.
6304
6305              %a
6306                    The remailer's e-mail address.
6307
6308        The Mutt Next Generation E-Mail Client                                      122
6309
6310        _\b7_\b._\b4_\b._\b1_\b4_\b4  _\bm_\bi_\bx_\bm_\ba_\bs_\bt_\be_\br
6311
6312        Type: path
6313
6314        Default: 'mixmaster'
6315
6316        Availability: Mixmaster
6317
6318        This variable contains the path to the Mixmaster binary on your system.  It is
6319        used with various sets of parameters to gather the list of known remailers, and
6320        to finally send a message through the mixmaster chain.
6321
6322        _\b7_\b._\b4_\b._\b1_\b4_\b5  _\bm_\bo_\bv_\be
6323
6324        Type: quadoption
6325
6326        Default: ask-no
6327
6328        Controls whether or not Mutt-ng will move read messages from your spool mailbox
6329        to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.128  , page 118)'' mailbox, or as a result of a
6330        ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 34)'' command.
6331
6332        _\b7_\b._\b4_\b._\b1_\b4_\b6  _\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
6333
6334        Type: string
6335
6336        Default: '%Y%m%d%h%M%s.G%P%p'
6337
6338        This is the format for the ``local part'' of the Message-Id: header field gen-
6339        erated by Mutt-ng. If this variable is empty, no Message-Id: headers will be
6340        generated. The '%' character marks that certain data will be added to the
6341        string, similar to printf(3). The following characters are allowed:
6342
6343              %d
6344                    the current day of month
6345
6346              %h
6347                    the current hour
6348
6349              %m
6350                    the current month
6351
6352              %M
6353                    the current minute
6354
6355              %O
6356                    the current UNIX timestamp (octal)
6357
6358              %p
6359                    the process ID
6360
6361              %P
6362                    the current Message-ID prefix (a character rotating with every Mes-
6363                    sage-ID being generated)
6364
6365        The Mutt Next Generation E-Mail Client                                      123
6366
6367              %r
6368                    a random integer value (decimal)
6369
6370              %R
6371                    a random integer value (hexadecimal)
6372
6373              %s
6374                    the current second
6375
6376              %T
6377                    the current UNIX timestamp (decimal)
6378
6379              %X
6380                    the current UNIX timestamp (hexadecimal)
6381
6382              %Y
6383                    the current year (Y2K compliant)
6384
6385              %%
6386                    the '%' character
6387
6388        N\bNo\bot\bte\be:\b: Please only change this setting if you know what you are doing.  Also
6389        make sure to consult RFC2822 to produce technically _\bv_\ba_\bl_\bi_\bd strings.
6390
6391        _\b7_\b._\b4_\b._\b1_\b4_\b7  _\bn_\ba_\br_\br_\bo_\bw_\b__\bt_\br_\be_\be
6392
6393        Type: boolean
6394
6395        Default: no
6396
6397        This variable, when _\bs_\be_\bt, makes the thread tree narrower, allowing deeper
6398        threads to fit on the screen.
6399
6400        _\b7_\b._\b4_\b._\b1_\b4_\b8  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
6401
6402        Type: boolean
6403
6404        Default: no
6405
6406        Availability: NNTP
6407
6408        If _\bs_\be_\bt, Mutt-ng will prompt you for the Followup-To: header field before edit-
6409        ing the body of an outgoing news article.
6410
6411        _\b7_\b._\b4_\b._\b1_\b4_\b9  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6412
6413        Type: boolean
6414
6415        Default: no
6416
6417        Availability: NNTP
6418
6419        If _\bs_\be_\bt, Mutt-ng will prompt you for the X-Comment-To: header field before edit-
6420        ing the body of an outgoing news article.
6421
6422        The Mutt Next Generation E-Mail Client                                      124
6423
6424        _\b7_\b._\b4_\b._\b1_\b5_\b0  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br
6425
6426        Type: path
6427
6428        Default: '~/.muttng'
6429
6430        Availability: NNTP
6431
6432        This variable points to directory where Mutt-ng will cache news article head-
6433        ers. If _\bu_\bn_\bs_\be_\bt, headers will not be saved at all and will be reloaded each time
6434        when you enter a newsgroup.
6435
6436        As for the header caching in connection with IMAP and/or Maildir, this drasti-
6437        cally increases speed and lowers traffic.
6438
6439        _\b7_\b._\b4_\b._\b1_\b5_\b1  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bt_\bc_\bh_\bu_\bp
6440
6441        Type: quadoption
6442
6443        Default: ask-yes
6444
6445        Availability: NNTP
6446
6447        If this variable is _\bs_\be_\bt, Mutt-ng will mark all articles in a newsgroup as read
6448        when you leaving it.
6449
6450        _\b7_\b._\b4_\b._\b1_\b5_\b2  _\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6451
6452        Type: number
6453
6454        Default: 1000
6455
6456        Availability: NNTP
6457
6458        This variable controls how many news articles to cache per newsgroup (if
6459        caching is enabled, see _\b$_\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section 7.4.150  , page 123)) and how
6460        many news articles to show in the ``index'' menu.
6461
6462        If there're more articles than defined with _\b$_\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.152  ,
6463        page 124), all older ones will be removed/not shown in the index.
6464
6465        _\b7_\b._\b4_\b._\b1_\b5_\b3  _\bn_\bn_\bt_\bp_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo_\b__\bp_\bo_\bs_\bt_\be_\br
6466
6467        Type: quadoption
6468
6469        Default: ask-yes
6470
6471        Availability: NNTP
6472
6473        If this variable is _\bs_\be_\bt and the keyword 'poster' is present in the Followup-To:
6474        header field, a follow-up to the newsgroup is not permitted.  The message will
6475        be mailed to the submitter of the message via mail.
6476
6477        The Mutt Next Generation E-Mail Client                                      125
6478
6479        _\b7_\b._\b4_\b._\b1_\b5_\b4  _\bn_\bn_\bt_\bp_\b__\bg_\br_\bo_\bu_\bp_\b__\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
6480
6481        Type: string
6482
6483        Default: '%4C %M%N %5s  %-45.45f %d'
6484
6485        Availability: NNTP
6486
6487        This variable allows you to customize the newsgroup browser display to your
6488        personal taste.  This string is similar to ``_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  ,
6489        page 113)'', but has its own set of printf(3)-like sequences:
6490
6491             %C      current newsgroup number
6492             %d      description of newsgroup (retrieved from server)
6493             %f      newsgroup name
6494             %M      ``-'' if newsgroup not allowed for direct post (moderated for example)
6495             %N      ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
6496             %n      number of new articles in newsgroup
6497             %s      number of unread articles in newsgroup
6498             %>X     right justify the rest of the string and pad with character "X"
6499             %|X     pad to the end of the line with character "X"
6500
6501        _\b7_\b._\b4_\b._\b1_\b5_\b5  _\bn_\bn_\bt_\bp_\b__\bh_\bo_\bs_\bt
6502
6503        Type: string
6504
6505        Default: ''
6506
6507        Availability: NNTP
6508
6509        This variable specifies the name (or address) of the NNTP server to be used.
6510
6511        It defaults to the value specified via the environment variable $NNTPSERVER or
6512        contained in the file /etc/nntpserver.
6513
6514        You can also specify a username and an alternative port for each newsserver,
6515        e.g.
6516
6517        [nntp[s]://][username[:password]@]newsserver[:port]
6518
6519        N\bNo\bot\bte\be:\b: Using a password as shown and stored in a configuration file presents a
6520        security risk since the superuser of your machine may read it regardless of the
6521        file's permissions.
6522
6523        _\b7_\b._\b4_\b._\b1_\b5_\b6  _\bn_\bn_\bt_\bp_\b__\bi_\bn_\be_\bw_\bs
6524
6525        Type: path
6526
6527        Default: ''
6528
6529        Availability: NNTP
6530
6531        The Mutt Next Generation E-Mail Client                                      126
6532
6533        If _\bs_\be_\bt, specifies the program and arguments used to deliver news posted by
6534        Mutt-ng.  Otherwise, Mutt-ng posts article using current connection.  The fol-
6535        lowing printf(3)-style sequence is understood:
6536
6537             %s      newsserver name
6538
6539        Example: set inews='/usr/local/bin/inews -hS'
6540
6541        _\b7_\b._\b4_\b._\b1_\b5_\b7  _\bn_\bn_\bt_\bp_\b__\bl_\bo_\ba_\bd_\b__\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn
6542
6543        Type: boolean
6544
6545        Default: yes
6546
6547        Availability: NNTP
6548
6549        This variable controls whether or not descriptions for newsgroups are to be
6550        loaded when subscribing to a newsgroup.
6551
6552        _\b7_\b._\b4_\b._\b1_\b5_\b8  _\bn_\bn_\bt_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6553
6554        Type: number
6555
6556        Default: 60
6557
6558        Availability: NNTP
6559
6560        The time in seconds until any operations on a newsgroup except posting a new
6561        article will cause a recheck for new news. If set to 0, Mutt-ng will recheck on
6562        each operation in index (stepping, read article, etc.).
6563
6564        _\b7_\b._\b4_\b._\b1_\b5_\b9  _\bn_\bn_\bt_\bp_\b__\bm_\bi_\bm_\be_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
6565
6566        Type: boolean
6567
6568        Default: yes
6569
6570        Availability: NNTP
6571
6572        If _\bu_\bn_\bs_\be_\bt, an 8-bit ``Subject:'' header field in a news article will not be
6573        encoded according to RFC2047.
6574
6575        N\bNo\bot\bte\be:\b: Only change this setting if you know what you are doing.
6576
6577        _\b7_\b._\b4_\b._\b1_\b6_\b0  _\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc
6578
6579        Type: path
6580
6581        Default: '~/.newsrc'
6582
6583        Availability: NNTP
6584
6585        The Mutt Next Generation E-Mail Client                                      127
6586
6587        This file contains information about subscribed newsgroup and articles read so
6588        far.
6589
6590        To ease the use of multiple news servers, the following printf(3)-style
6591        sequence is understood:
6592
6593             %s      newsserver name
6594
6595        _\b7_\b._\b4_\b._\b1_\b6_\b1  _\bn_\bn_\bt_\bp_\b__\bp_\ba_\bs_\bs
6596
6597        Type: string
6598
6599        Default: ''
6600
6601        Availability: NNTP
6602
6603        Your password for NNTP account.
6604
6605        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
6606        the superuser of your machine may read it regardless of the file's permissions.
6607
6608        _\b7_\b._\b4_\b._\b1_\b6_\b2  _\bn_\bn_\bt_\bp_\b__\bp_\bo_\bs_\bt_\b__\bm_\bo_\bd_\be_\br_\ba_\bt_\be_\bd
6609
6610        Type: quadoption
6611
6612        Default: ask-yes
6613
6614        Availability: NNTP
6615
6616        If set to _\by_\be_\bs, Mutt-ng will post articles to newsgroup that have not permis-
6617        sions to post (e.g. moderated).
6618
6619        N\bNo\bot\bte\be:\b: if the newsserver does not support posting to that newsgroup or a group
6620        is totally read-only, that posting will not have any effect.
6621
6622        _\b7_\b._\b4_\b._\b1_\b6_\b3  _\bn_\bn_\bt_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
6623
6624        Type: quadoption
6625
6626        Default: ask-yes
6627
6628        Availability: NNTP
6629
6630        Controls whether or not Mutt-ng will try to reconnect to a newsserver when the
6631        was connection lost.
6632
6633        _\b7_\b._\b4_\b._\b1_\b6_\b4  _\bn_\bn_\bt_\bp_\b__\bs_\ba_\bv_\be_\b__\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
6634
6635        Type: boolean
6636
6637        Default: no
6638
6639        The Mutt Next Generation E-Mail Client                                      128
6640
6641        Availability: NNTP
6642
6643        When _\bs_\be_\bt, info about unsubscribed newsgroups will be saved into the ``newsrc''
6644        file and into the news cache.
6645
6646        _\b7_\b._\b4_\b._\b1_\b6_\b5  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bn_\be_\bw_\b__\bn_\be_\bw_\bs
6647
6648        Type: boolean
6649
6650        Default: yes
6651
6652        Availability: NNTP
6653
6654        If _\bs_\be_\bt, the newsserver will be asked for new newsgroups on entering the
6655        browser.  Otherwise, it will be done only once for a newsserver.  Also controls
6656        whether or not the number of new articles of subscribed newsgroups will be
6657        checked.
6658
6659        _\b7_\b._\b4_\b._\b1_\b6_\b6  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bo_\bn_\bl_\by_\b__\bu_\bn_\br_\be_\ba_\bd
6660
6661        Type: boolean
6662
6663        Default: no
6664
6665        Availability: NNTP
6666
6667        If _\bs_\be_\bt, only subscribed newsgroups that contain unread articles will be dis-
6668        played in the newsgroup browser.
6669
6670        _\b7_\b._\b4_\b._\b1_\b6_\b7  _\bn_\bn_\bt_\bp_\b__\bu_\bs_\be_\br
6671
6672        Type: string
6673
6674        Default: ''
6675
6676        Availability: NNTP
6677
6678        Your login name on the NNTP server.  If _\bu_\bn_\bs_\be_\bt and the server requires authen-
6679        tification, Mutt-ng will prompt you for your account name.
6680
6681        _\b7_\b._\b4_\b._\b1_\b6_\b8  _\bn_\bn_\bt_\bp_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6682
6683        Type: boolean
6684
6685        Default: no
6686
6687        Availability: NNTP
6688
6689        If _\bs_\be_\bt, Mutt-ng will add a ``X-Comment-To:'' header field (that contains full
6690        name of the original article author) to articles that you followup to.
6691
6692        _\b7_\b._\b4_\b._\b1_\b6_\b9  _\bo_\bp_\be_\br_\ba_\bt_\bi_\bn_\bg_\b__\bs_\by_\bs_\bt_\be_\bm
6693
6694        Type: string
6695
6696        The Mutt Next Generation E-Mail Client                                      129
6697
6698        Default: ''
6699
6700        This specifies the operating system name for the User-Agent: header field. If
6701        this is _\bu_\bn_\bs_\be_\bt, it will be set to the operating system name that uname(2)
6702        returns. If uname(2) fails, ``UNIX'' will be used.
6703
6704        It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''.
6705
6706        _\b7_\b._\b4_\b._\b1_\b7_\b0  _\bp_\ba_\bg_\be_\br
6707
6708        Type: path
6709
6710        Default: 'builtin'
6711
6712        This variable specifies which pager you would like to use to view messages.
6713        ``builtin'' means to use the builtin pager, otherwise this variable should
6714        specify the pathname of the external pager you would like to use.
6715
6716        Using an external pager may have some disadvantages: Additional keystrokes are
6717        necessary because you can't call Mutt-ng functions directly from the pager, and
6718        screen resizes cause lines longer than the screen width to be badly formatted
6719        in the help menu.
6720
6721        _\b7_\b._\b4_\b._\b1_\b7_\b1  _\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6722
6723        Type: number
6724
6725        Default: 0
6726
6727        This variable controls the number of lines of context that are given when dis-
6728        playing the next or previous page in the internal pager.  By default, Mutt-ng
6729        will display the line after the last one on the screen at the top of the next
6730        page (0 lines of context).
6731
6732        _\b7_\b._\b4_\b._\b1_\b7_\b2  _\bp_\ba_\bg_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
6733
6734        Type: string
6735
6736        Default: '-%Z- %C/%m: %-20.20n   %s'
6737
6738        This variable controls the format of the one-line message ``status'' displayed
6739        before each message in either the internal or an external pager.  The valid
6740        sequences are listed in the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113)''
6741        section.
6742
6743        _\b7_\b._\b4_\b._\b1_\b7_\b3  _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs
6744
6745        Type: number
6746
6747        Default: 0
6748
6749        Determines the number of lines of a mini-index which is shown when in the
6750        pager.  The current message, unless near the top or bottom of the folder, will
6751        be roughly one third of the way down this mini-index, giving the reader the
6752
6753        The Mutt Next Generation E-Mail Client                                      130
6754
6755        context of a few messages before and after the message.  This is useful, for
6756        example, to determine how many messages remain to be read in the current
6757        thread.  One of the lines is reserved for the status bar from the index, so a
6758        _\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
6759        0 results in no index being shown.  If the number of messages in the current
6760        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
6761        lines as it needs.
6762
6763        _\b7_\b._\b4_\b._\b1_\b7_\b4  _\bp_\ba_\bg_\be_\br_\b__\bs_\bt_\bo_\bp
6764
6765        Type: boolean
6766
6767        Default: no
6768
6769        When _\bs_\be_\bt, the internal-pager will n\bno\bot\bt move to the next message when you are at
6770        the end of a message and invoke the _\bn_\be_\bx_\bt_\b-_\bp_\ba_\bg_\be function.
6771
6772        _\b7_\b._\b4_\b._\b1_\b7_\b5  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\b__\bd_\be_\bc_\bo_\bd_\be
6773
6774        Type: boolean
6775
6776        Default: no
6777
6778        If _\bs_\be_\bt, Mutt-ng will automatically attempt to decrypt traditional PGP messages
6779        whenever the user performs an operation which ordinarily would result in the
6780        contents of the message being operated on.  For example, if the user displays a
6781        pgp-traditional message which has not been manually checked with the check-tra-
6782        ditional-pgp function, Mutt-ng will automatically check the message for tradi-
6783        tional pgp.
6784
6785        _\b7_\b._\b4_\b._\b1_\b7_\b6  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\bi_\bn_\bl_\bi_\bn_\be
6786
6787        Type: boolean
6788
6789        Default: no
6790
6791        This option controls whether Mutt-ng generates old-style inline (traditional)
6792        PGP encrypted or signed messages under certain circumstances.  This can be
6793        overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not required.
6794
6795        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
6796        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
6797        ing PGP/MIME messages when inline (traditional) would not work.  See also:
6798        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.192  , page 134)''.
6799
6800        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.
6801        (PGP only)
6802
6803        _\b7_\b._\b4_\b._\b1_\b7_\b7  _\bp_\bg_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\be_\bx_\bi_\bt
6804
6805        Type: boolean
6806
6807        Default: yes
6808
6809        The Mutt Next Generation E-Mail Client                                      131
6810
6811        If _\bs_\be_\bt, Mutt-ng will check the exit code of the PGP subprocess when signing or
6812        encrypting.  A non-zero exit code means that the subprocess failed.  (PGP only)
6813
6814        _\b7_\b._\b4_\b._\b1_\b7_\b8  _\bp_\bg_\bp_\b__\bc_\bl_\be_\ba_\br_\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6815
6816        Type: string
6817
6818        Default: ''
6819
6820        This format is used to create a old-style ``clearsigned'' PGP message.
6821
6822        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)
6823
6824        _\b7_\b._\b4_\b._\b1_\b7_\b9  _\bp_\bg_\bp_\b__\bd_\be_\bc_\bo_\bd_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6825
6826        Type: string
6827
6828        Default: ''
6829
6830        This format strings specifies a command which is used to decode application/pgp
6831        attachments.
6832
6833        The PGP command formats have their own set of printf(3)-like sequences:
6834
6835              %p
6836                    Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
6837                    string otherwise. Note: This may be used with a %? construct.
6838
6839              %f
6840                    Expands to the name of a file containing a message.
6841
6842              %s
6843                    Expands to the name of a file containing the signature part of a
6844                    multipart/signed attachment when verifying it.
6845
6846              %a
6847                    The value of _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 7.4.196  , page 135).
6848
6849              %r
6850                    One or more key IDs.
6851
6852        For examples on how to configure these formats for the various versions of PGP
6853        which are floating around, see the pgp*.rc and gpg.rc files in the samples/
6854        subdirectory which has been installed on your system alongside the documenta-
6855        tion.  (PGP only)
6856
6857        _\b7_\b._\b4_\b._\b1_\b8_\b0  _\bp_\bg_\bp_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6858
6859        Type: string
6860
6861        Default: ''
6862
6863        This command is used to decrypt a PGP encrypted message.  (PGP only)
6864
6865        The Mutt Next Generation E-Mail Client                                      132
6866
6867        _\b7_\b._\b4_\b._\b1_\b8_\b1  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bo_\bn_\bl_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6868
6869        Type: string
6870
6871        Default: ''
6872
6873        This command is used to encrypt a body part without signing it.  (PGP only)
6874
6875        _\b7_\b._\b4_\b._\b1_\b8_\b2  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6876
6877        Type: string
6878
6879        Default: ''
6880
6881        This command is used to both sign and encrypt a body part.  (PGP only)
6882
6883        _\b7_\b._\b4_\b._\b1_\b8_\b3  _\bp_\bg_\bp_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
6884
6885        Type: string
6886
6887        Default: '%4n %t%f %4l/0x%k %-4a %2c %u'
6888
6889        This variable allows you to customize the PGP key selection menu to your per-
6890        sonal taste. This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page
6891        113)'', but has its own set of printf(3)-like sequences:
6892
6893              %n
6894                    number
6895
6896              %k
6897                    key id
6898
6899              %u
6900                    user id
6901
6902              %a
6903                    algorithm
6904
6905              %l
6906                    key length
6907
6908              %f
6909                    flags
6910
6911              %c
6912                    capabilities
6913
6914              %t
6915                    trust/validity of the key-uid association
6916
6917              %[<s>]
6918                    date of the key where <s> is an strftime(3) expression
6919
6920        (PGP only)
6921
6922        The Mutt Next Generation E-Mail Client                                      133
6923
6924        _\b7_\b._\b4_\b._\b1_\b8_\b4  _\bp_\bg_\bp_\b__\be_\bx_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6925
6926        Type: string
6927
6928        Default: ''
6929
6930        This command is used to export a public key from the user's key ring.  (PGP
6931        only)
6932
6933        _\b7_\b._\b4_\b._\b1_\b8_\b5  _\bp_\bg_\bp_\b__\bg_\be_\bt_\bk_\be_\by_\bs_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6934
6935        Type: string
6936
6937        Default: ''
6938
6939        This command is invoked whenever Mutt-ng will need public key information.  %r
6940        is the only printf(3)-like sequence used with this format.  (PGP only)
6941
6942        _\b7_\b._\b4_\b._\b1_\b8_\b6  _\bp_\bg_\bp_\b__\bg_\bo_\bo_\bd_\b__\bs_\bi_\bg_\bn
6943
6944        Type: regular expression
6945
6946        Default: ''
6947
6948        If you assign a text to this variable, then a PGP signature is only considered
6949        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.202  , page 136)
6950        contains the text. Use this variable if the exit code from the command is 0
6951        even for bad signatures.  (PGP only)
6952
6953        _\b7_\b._\b4_\b._\b1_\b8_\b7  _\bp_\bg_\bp_\b__\bi_\bg_\bn_\bo_\br_\be_\b__\bs_\bu_\bb_\bk_\be_\by_\bs
6954
6955        Type: boolean
6956
6957        Default: yes
6958
6959        Setting this variable will cause Mutt-ng to ignore OpenPGP subkeys. Instead,
6960        the principal key will inherit the subkeys' capabilities. _\bU_\bn_\bs_\be_\bt this if you
6961        want to play interesting key selection games.  (PGP only)
6962
6963        _\b7_\b._\b4_\b._\b1_\b8_\b8  _\bp_\bg_\bp_\b__\bi_\bm_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6964
6965        Type: string
6966
6967        Default: ''
6968
6969        This command is used to import a key from a message into the user's public key
6970        ring.  (PGP only)
6971
6972        _\b7_\b._\b4_\b._\b1_\b8_\b9  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bp_\bu_\bb_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6973
6974        Type: string
6975
6976        Default: ''
6977
6978        The Mutt Next Generation E-Mail Client                                      134
6979
6980        This command is used to list the public key ring's contents.  The output format
6981        must be analogous to the one used by gpg --list-keys --with-colons.
6982
6983        This format is also generated by the pgpring utility which comes with Mutt-ng.
6984        (PGP only)
6985
6986        _\b7_\b._\b4_\b._\b1_\b9_\b0  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\be_\bc_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6987
6988        Type: string
6989
6990        Default: ''
6991
6992        This command is used to list the secret key ring's contents.  The output format
6993        must be analogous to the one used by gpg --list-keys --with-colons.
6994
6995        This format is also generated by the pgpring utility which comes with Mutt-ng.
6996        (PGP only)
6997
6998        _\b7_\b._\b4_\b._\b1_\b9_\b1  _\bp_\bg_\bp_\b__\bl_\bo_\bn_\bg_\b__\bi_\bd_\bs
6999
7000        Type: boolean
7001
7002        Default: no
7003
7004        If _\bs_\be_\bt, use 64 bit PGP key IDs. _\bU_\bn_\bs_\be_\bt uses the normal 32 bit Key IDs.  (PGP
7005        only)
7006
7007        _\b7_\b._\b4_\b._\b1_\b9_\b2  _\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo
7008
7009        Type: quadoption
7010
7011        Default: ask-yes
7012
7013        This option controls whether Mutt-ng will prompt you for automatically sending
7014        a (signed/encrypted) message using PGP/MIME when inline (traditional) fails
7015        (for any reason).
7016
7017        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.
7018        (PGP only)
7019
7020        _\b7_\b._\b4_\b._\b1_\b9_\b3  _\bp_\bg_\bp_\b__\br_\be_\bp_\bl_\by_\bi_\bn_\bl_\bi_\bn_\be
7021
7022        Type: boolean
7023
7024        Default: no
7025
7026        Setting this variable will cause Mutt-ng to always attempt to create an inline
7027        (traditional) message when replying to a message which is PGP encrypted/signed
7028        inline.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not
7029        required.  This option does not automatically detect if the (replied-to) mes-
7030        sage is inline; instead it relies on Mutt-ng internals for previously
7031        checked/flagged messages.
7032
7033        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
7034
7035        The Mutt Next Generation E-Mail Client                                      135
7036
7037        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
7038        ing PGP/MIME messages when inline (traditional) would not work.  See also:
7039        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.192  , page 134)''.
7040
7041        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.
7042        (PGP only)
7043
7044        _\b7_\b._\b4_\b._\b1_\b9_\b4  _\bp_\bg_\bp_\b__\br_\be_\bt_\ba_\bi_\bn_\ba_\bb_\bl_\be_\b__\bs_\bi_\bg_\bs
7045
7046        Type: boolean
7047
7048        Default: no
7049
7050        If _\bs_\be_\bt, signed and encrypted messages will consist of nested multipart/signed
7051        and multipart/encrypted body parts.
7052
7053        This is useful for applications like encrypted and signed mailing lists, where
7054        the outer layer (multipart/encrypted) can be easily removed, while the inner
7055        multipart/signed part is retained.  (PGP only)
7056
7057        _\b7_\b._\b4_\b._\b1_\b9_\b5  _\bp_\bg_\bp_\b__\bs_\bh_\bo_\bw_\b__\bu_\bn_\bu_\bs_\ba_\bb_\bl_\be
7058
7059        Type: boolean
7060
7061        Default: yes
7062
7063        If _\bs_\be_\bt, Mutt-ng will display non-usable keys on the PGP key selection menu.
7064        This includes keys which have been revoked, have expired, or have been marked
7065        as ``disabled'' by the user.  (PGP only)
7066
7067        _\b7_\b._\b4_\b._\b1_\b9_\b6  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs
7068
7069        Type: string
7070
7071        Default: ''
7072
7073        If you have more than one key pair, this option allows you to specify which of
7074        your private keys to use.  It is recommended that you use the keyid form to
7075        specify your key (e.g., ``0x00112233'').  (PGP only)
7076
7077        _\b7_\b._\b4_\b._\b1_\b9_\b7  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7078
7079        Type: string
7080
7081        Default: ''
7082
7083        This command is used to create the detached PGP signature for a multi-
7084        part/signed PGP/MIME body part.  (PGP only)
7085
7086        _\b7_\b._\b4_\b._\b1_\b9_\b8  _\bp_\bg_\bp_\b__\bs_\bo_\br_\bt_\b__\bk_\be_\by_\bs
7087
7088        Type: sort order
7089
7090        Default: address
7091
7092        The Mutt Next Generation E-Mail Client                                      136
7093
7094        Specifies how the entries in the ``pgp keys'' menu are sorted. The following
7095        are legal values:
7096
7097              address
7098                    sort alphabetically by user id
7099
7100              keyid
7101                    sort alphabetically by key id
7102
7103              date
7104                    sort by key creation date
7105
7106              trust
7107                    sort by the trust of the key
7108
7109        If you prefer reverse order of the above values, prefix it with ``reverse-''.
7110        (PGP only)
7111
7112        _\b7_\b._\b4_\b._\b1_\b9_\b9  _\bp_\bg_\bp_\b__\bs_\bt_\br_\bi_\bc_\bt_\b__\be_\bn_\bc
7113
7114        Type: boolean
7115
7116        Default: yes
7117
7118        If _\bs_\be_\bt, Mutt-ng will automatically encode PGP/MIME signed messages as quoted-
7119        printable.  Please note that unsetting this variable may lead to problems with
7120        non-verifyable PGP signatures, so only change this if you know what you are
7121        doing.  (PGP only)
7122
7123        _\b7_\b._\b4_\b._\b2_\b0_\b0  _\bp_\bg_\bp_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
7124
7125        Type: number
7126
7127        Default: 300
7128
7129        The number of seconds after which a cached passphrase will expire if not used.
7130        Default: 300.  (PGP only)
7131
7132        _\b7_\b._\b4_\b._\b2_\b0_\b1  _\bp_\bg_\bp_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\b__\ba_\bg_\be_\bn_\bt
7133
7134        Type: boolean
7135
7136        Default: no
7137
7138        If _\bs_\be_\bt, Mutt-ng will use a possibly-running gpg-agent process.  (PGP only)
7139
7140        _\b7_\b._\b4_\b._\b2_\b0_\b2  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7141
7142        Type: string
7143
7144        Default: ''
7145
7146        This command is used to verify PGP signatures.  (PGP only)
7147
7148        The Mutt Next Generation E-Mail Client                                      137
7149
7150        _\b7_\b._\b4_\b._\b2_\b0_\b3  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bk_\be_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7151
7152        Type: string
7153
7154        Default: ''
7155
7156        This command is used to verify key information from the key selection menu.
7157        (PGP only)
7158
7159        _\b7_\b._\b4_\b._\b2_\b0_\b4  _\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be
7160
7161        Type: boolean
7162
7163        Default: no
7164
7165        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
7166        pipe the messages without any preprocessing. When _\bs_\be_\bt, Mutt-ng will weed head-
7167        ers and will attempt to PGP/MIME decode the messages first.
7168
7169        _\b7_\b._\b4_\b._\b2_\b0_\b5  _\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7170
7171        Type: string
7172
7173        Default: '\n'
7174
7175        The separator to add between messages when piping a list of tagged messages to
7176        an external Unix command.
7177
7178        _\b7_\b._\b4_\b._\b2_\b0_\b6  _\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
7179
7180        Type: boolean
7181
7182        Default: no
7183
7184        Used in connection with the _\bp_\bi_\bp_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be command and the ``tag- prefix'' or
7185        ``tag-prefix-cond'' operators.  If this variable is _\bu_\bn_\bs_\be_\bt, when piping a list
7186        of tagged messages Mutt-ng will concatenate the messages and will pipe them as
7187        a single folder.  When _\bs_\be_\bt, Mutt-ng will pipe the messages one by one.  In both
7188        cases the messages are piped in the current sorted order, and the ``_\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7189        (section 7.4.205  , page 137)'' separator is added after each message.
7190
7191        _\b7_\b._\b4_\b._\b2_\b0_\b7  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\b__\bt_\br_\by_\b__\ba_\bl_\bl
7192
7193        Type: boolean
7194
7195        Default: yes
7196
7197        Availability: POP
7198
7199        If _\bs_\be_\bt, Mutt-ng will try all available methods. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will only
7200        fall back to other authentication methods if the previous methods are unavail-
7201        able. If a method is available but authentication fails, Mutt-ng will not con-
7202        nect to the POP server.
7203
7204        The Mutt Next Generation E-Mail Client                                      138
7205
7206        _\b7_\b._\b4_\b._\b2_\b0_\b8  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
7207
7208        Type: string
7209
7210        Default: ''
7211
7212        Availability: POP
7213
7214        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
7215        use to log in to an POP server, in the order Mutt-ng should try them.  Authen-
7216        tication methods are either ``user'', ``apop'' or any SASL mechanism, eg
7217        ``digest-md5'', ``gssapi'' or ``cram-md5''.
7218
7219        This parameter is case-insensitive. If this parameter is _\bu_\bn_\bs_\be_\bt (the default)
7220        Mutt-ng will try all available methods, in order from most-secure to least-
7221        secure.
7222
7223        Example: set pop_authenticators='digest-md5:apop:user'
7224
7225        _\b7_\b._\b4_\b._\b2_\b0_\b9  _\bp_\bo_\bp_\b__\bd_\be_\bl_\be_\bt_\be
7226
7227        Type: quadoption
7228
7229        Default: ask-no
7230
7231        Availability: POP
7232
7233        If _\bs_\be_\bt, Mutt-ng will delete successfully downloaded messages from the POP
7234        server when using the ``fetch-mail'' function.  When _\bu_\bn_\bs_\be_\bt, Mutt-ng will down-
7235        load messages but also leave them on the POP server.
7236
7237        _\b7_\b._\b4_\b._\b2_\b1_\b0  _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt
7238
7239        Type: string
7240
7241        Default: ''
7242
7243        Availability: POP
7244
7245        The name of your POP server for the ``fetch-mail'' function.  You can also
7246        specify an alternative port, username and password, i.e.:
7247
7248        [pop[s]://][username[:password]@]popserver[:port]
7249
7250        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7251        the superuser of your machine may read it regardless of the file's permissions.
7252
7253        _\b7_\b._\b4_\b._\b2_\b1_\b1  _\bp_\bo_\bp_\b__\bl_\ba_\bs_\bt
7254
7255        Type: boolean
7256
7257        Default: no
7258
7259        Availability: POP
7260
7261        The Mutt Next Generation E-Mail Client                                      139
7262
7263        If this variable is _\bs_\be_\bt, Mutt-ng will try to use the ``LAST'' POP command for
7264        retrieving only unread messages from the POP server when using the ``fetch-
7265        mail'' function.
7266
7267        _\b7_\b._\b4_\b._\b2_\b1_\b2  _\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
7268
7269        Type: number
7270
7271        Default: 60
7272
7273        Availability: POP
7274
7275        This variable configures how often (in seconds) POP should look for new mail.
7276
7277        _\b7_\b._\b4_\b._\b2_\b1_\b3  _\bp_\bo_\bp_\b__\bp_\ba_\bs_\bs
7278
7279        Type: string
7280
7281        Default: ''
7282
7283        Availability: POP
7284
7285        Specifies the password for your POP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt you
7286        for your password when you open POP mailbox.
7287
7288        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7289        the superuser of your machine may read it regardless of the file's permissions.
7290
7291        _\b7_\b._\b4_\b._\b2_\b1_\b4  _\bp_\bo_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7292
7293        Type: quadoption
7294
7295        Default: ask-yes
7296
7297        Availability: POP
7298
7299        Controls whether or not Mutt-ng will try to reconnect to a POP server when the
7300        connection is lost.
7301
7302        _\b7_\b._\b4_\b._\b2_\b1_\b5  _\bp_\bo_\bp_\b__\bu_\bs_\be_\br
7303
7304        Type: string
7305
7306        Default: ''
7307
7308        Availability: POP
7309
7310        Your login name on the POP server.
7311
7312        This variable defaults to your user name on the local machine.
7313
7314        _\b7_\b._\b4_\b._\b2_\b1_\b6  _\bp_\bo_\bs_\bt_\b__\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
7315
7316        Type: string
7317
7318        The Mutt Next Generation E-Mail Client                                      140
7319
7320        Default: ''
7321
7322        Similar to the ``_\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 7.4.17  , page 91)'' variable, Mutt-ng
7323        will append this string after the inclusion of a message which is being replied
7324        to.
7325
7326        _\b7_\b._\b4_\b._\b2_\b1_\b7  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
7327
7328        Type: quadoption
7329
7330        Default: ask-yes
7331
7332        Controls whether or not messages are saved in the ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section
7333        7.4.218  , page 140)'' mailbox when you elect not to send immediately.
7334
7335        _\b7_\b._\b4_\b._\b2_\b1_\b8  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd
7336
7337        Type: path
7338
7339        Default: '~/postponed'
7340
7341        Mutt-ng allows you to indefinitely ``_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.217  , page 139)
7342        sending a message'' which you are editing.  When you choose to postpone a mes-
7343        sage, Mutt-ng saves it in the mailbox specified by this variable.  Also see the
7344        ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.217  , page 139)'' variable.
7345
7346        _\b7_\b._\b4_\b._\b2_\b1_\b9  _\bp_\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7347
7348        Type: string
7349
7350        Default: ''
7351
7352        If _\bs_\be_\bt, a shell command to be executed if Mutt-ng fails to establish a connec-
7353        tion to the server. This is useful for setting up secure connections, e.g. with
7354        ssh(1). If the command returns a  nonzero status, Mutt-ng gives up opening the
7355        server. Example:
7356
7357        preconnect='ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 <
7358        /dev/null > /dev/null'
7359
7360        Mailbox ``foo'' on mailhost.net can now be reached as ``{localhost:1234}foo''.
7361
7362        N\bNo\bot\bte\be:\b: For this example to work, you must be able to log in to the remote
7363        machine without having to enter a password.
7364
7365        _\b7_\b._\b4_\b._\b2_\b2_\b0  _\bp_\br_\bi_\bn_\bt
7366
7367        Type: quadoption
7368
7369        Default: ask-no
7370
7371        Controls whether or not Mutt-ng really prints messages.  This is set to _\ba_\bs_\bk_\b-_\bn_\bo
7372        by default, because some people accidentally hit ``p'' often.
7373
7374        The Mutt Next Generation E-Mail Client                                      141
7375
7376        _\b7_\b._\b4_\b._\b2_\b2_\b1  _\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7377
7378        Type: path
7379
7380        Default: 'lpr'
7381
7382        This specifies the command pipe that should be used to print messages.
7383
7384        _\b7_\b._\b4_\b._\b2_\b2_\b2  _\bp_\br_\bi_\bn_\bt_\b__\bd_\be_\bc_\bo_\bd_\be
7385
7386        Type: boolean
7387
7388        Default: yes
7389
7390        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7391        message is decoded before it is passed to the external command specified by
7392        _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.221  , page 140).  If this option is _\bu_\bn_\bs_\be_\bt, no pro-
7393        cessing will be applied to the message when printing it.  The latter setting
7394        may be useful if you are using some advanced printer filter which is able to
7395        properly format e-mail messages for printing.
7396
7397        _\b7_\b._\b4_\b._\b2_\b2_\b3  _\bp_\br_\bi_\bn_\bt_\b__\bs_\bp_\bl_\bi_\bt
7398
7399        Type: boolean
7400
7401        Default: no
7402
7403        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7404        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.221  , page 140) is executed
7405        once for each message which is to be printed.  If this option is _\bu_\bn_\bs_\be_\bt, the
7406        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.221  , page 140) is executed
7407        only once, and all the messages are concatenated, with a form feed as the mes-
7408        sage separator.
7409
7410        Those who use the enscript(1) program's mail-printing mode will most likely
7411        want to set this option.
7412
7413        _\b7_\b._\b4_\b._\b2_\b2_\b4  _\bp_\br_\bo_\bm_\bp_\bt_\b__\ba_\bf_\bt_\be_\br
7414
7415        Type: boolean
7416
7417        Default: yes
7418
7419        If you use an _\be_\bx_\bt_\be_\br_\bn_\ba_\bl ``_\b$_\bp_\ba_\bg_\be_\br (section 7.4.170  , page 129)'', setting this
7420        variable will cause Mutt-ng to prompt you for a command when the pager exits
7421        rather than returning to the index menu.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will return to the
7422        index menu when the external pager exits.
7423
7424        _\b7_\b._\b4_\b._\b2_\b2_\b5  _\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7425
7426        Type: path
7427
7428        Default: ''
7429
7430        The Mutt Next Generation E-Mail Client                                      142
7431
7432        This specifies the command that Mutt-ng will use to make external address
7433        queries.  The string should contain a %s, which will be substituted with the
7434        query string the user types.  See ``_\bq_\bu_\be_\br_\by (section 4.7  , page 56)'' for more
7435        information.
7436
7437        _\b7_\b._\b4_\b._\b2_\b2_\b6  _\bq_\bu_\bi_\bt
7438
7439        Type: quadoption
7440
7441        Default: yes
7442
7443        This variable controls whether ``quit'' and ``exit'' actually quit from Mutt-
7444        ng.  If it set to _\by_\be_\bs, they do quit, if it is set to _\bn_\bo, they have no effect,
7445        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
7446        you try to quit.
7447
7448        _\b7_\b._\b4_\b._\b2_\b2_\b7  _\bq_\bu_\bo_\bt_\be_\b__\be_\bm_\bp_\bt_\by
7449
7450        Type: boolean
7451
7452        Default: yes
7453
7454        Controls whether or not empty lines will be quoted using ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (sec-
7455        tion 7.4.112  , page 113)''.
7456
7457        _\b7_\b._\b4_\b._\b2_\b2_\b8  _\bq_\bu_\bo_\bt_\be_\b__\bq_\bu_\bo_\bt_\be_\bd
7458
7459        Type: boolean
7460
7461        Default: no
7462
7463        Controls how quoted lines will be quoted. If _\bs_\be_\bt, one quote character will be
7464        added to the end of existing prefix.  Otherwise, quoted lines will be prepended
7465        by ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.112  , page 113)''.
7466
7467        _\b7_\b._\b4_\b._\b2_\b2_\b9  _\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp
7468
7469        Type: regular expression
7470
7471        Default: '^([ \t]*[|>:}#])+'
7472
7473        A regular expression used in the internal-pager to determine quoted sections of
7474        text in the body of a message.
7475
7476        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
7477        set this to a regular expression that matches _\be_\bx_\ba_\bc_\bt_\bl_\by the quote characters at
7478        the beginning of quoted lines.
7479
7480        _\b7_\b._\b4_\b._\b2_\b3_\b0  _\br_\be_\ba_\bd_\b__\bi_\bn_\bc
7481
7482        Type: number
7483
7484        Default: 10
7485
7486        The Mutt Next Generation E-Mail Client                                      143
7487
7488        If set to a value greater than 0, Mutt-ng will display which message it is cur-
7489        rently on when reading a mailbox.  The message is printed after _\br_\be_\ba_\bd_\b__\bi_\bn_\bc mes-
7490        sages have been read (e.g., if set to 25, Mutt-ng will print a message when it
7491        reads message 25, and then again when it gets to message 50).  This variable is
7492        meant to indicate progress when reading large mailboxes which may take some
7493        time.  When set to 0, only a single message will appear before the reading the
7494        mailbox.
7495
7496        Also see the ``_\b$_\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc (section 7.4.344  , page 170)'' variable.
7497
7498        _\b7_\b._\b4_\b._\b2_\b3_\b1  _\br_\be_\ba_\bd_\b__\bo_\bn_\bl_\by
7499
7500        Type: boolean
7501
7502        Default: no
7503
7504        If set, all folders are opened in read-only mode.
7505
7506        _\b7_\b._\b4_\b._\b2_\b3_\b2  _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7507
7508        Type: string
7509
7510        Default: ''
7511
7512        This variable specifies what ``real'' or ``personal'' name should be used when
7513        sending messages.
7514
7515        By default, this is the GECOS field from /etc/passwd.
7516
7517        _\bN_\bo_\bt_\be_\b: This variable will _\bn_\bo_\bt be used when the user has set a real name in the
7518        _\b$_\bf_\br_\bo_\bm (section 7.4.77  , page 105) variable.
7519
7520        _\b7_\b._\b4_\b._\b2_\b3_\b3  _\br_\be_\bc_\ba_\bl_\bl
7521
7522        Type: quadoption
7523
7524        Default: ask-yes
7525
7526        Controls whether or not Mutt-ng recalls postponed messages when composing a new
7527        message.  Also see ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 7.4.218  , page 140)''.
7528
7529        Setting this variable to _\by_\be_\bs is not generally useful, and thus not recommended.
7530
7531        _\b7_\b._\b4_\b._\b2_\b3_\b4  _\br_\be_\bc_\bo_\br_\bd
7532
7533        Type: path
7534
7535        Default: ''
7536
7537        This specifies the file into which your outgoing messages should be appended.
7538        (This is meant as the primary method for saving a copy of your messages, but
7539        another way to do this is using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 35)'' com-
7540        mand to create a Bcc: header field with your email address in it.)
7541
7542        The Mutt Next Generation E-Mail Client                                      144
7543
7544        The value of _\b$_\br_\be_\bc_\bo_\br_\bd _\b(_\bs_\be_\bc_\bt_\bi_\bo_\bn _\b7_\b._\b4_\b._\b2_\b3_\b4  _\b, _\bp_\ba_\bg_\be _\b1_\b4_\b3_\b) is overridden by the
7545        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.71  , page 103)'' and ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section
7546        7.4.245  , page 146)'' variables, and the ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page
7547        36)'' command.
7548
7549        _\b7_\b._\b4_\b._\b2_\b3_\b5  _\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp
7550
7551        Type: regular expression
7552
7553        Default: '^(re([\[0-9\]+])*|aw):[ \t]*'
7554
7555        A regular expression used to recognize reply messages when threading and reply-
7556        ing. The default value corresponds to the English ``Re:'' and the German
7557        ``Aw:''.
7558
7559        _\b7_\b._\b4_\b._\b2_\b3_\b6  _\br_\be_\bp_\bl_\by_\b__\bs_\be_\bl_\bf
7560
7561        Type: boolean
7562
7563        Default: no
7564
7565        If _\bu_\bn_\bs_\be_\bt and you are replying to a message sent by you, Mutt-ng will assume
7566        that you want to reply to the recipients of that message rather than to your-
7567        self.
7568
7569        _\b7_\b._\b4_\b._\b2_\b3_\b7  _\br_\be_\bp_\bl_\by_\b__\bt_\bo
7570
7571        Type: quadoption
7572
7573        Default: ask-yes
7574
7575        If _\bs_\be_\bt, when replying to a message, Mutt-ng will use the address listed in the
7576        ``Reply-To:'' header field as the recipient of the reply.  If _\bu_\bn_\bs_\be_\bt, it will
7577        use the address in the ``From:'' header field instead.
7578
7579        This option is useful for reading a mailing list that sets the ``Reply-To:''
7580        header field to the list address and you want to send a private message to the
7581        author of a message.
7582
7583        _\b7_\b._\b4_\b._\b2_\b3_\b8  _\br_\be_\bs_\bo_\bl_\bv_\be
7584
7585        Type: boolean
7586
7587        Default: yes
7588
7589        When set, the cursor will be automatically advanced to the next (possibly
7590        undeleted) message whenever a command that modifies the current message is exe-
7591        cuted.
7592
7593        _\b7_\b._\b4_\b._\b2_\b3_\b9  _\br_\be_\bv_\be_\br_\bs_\be_\b__\ba_\bl_\bi_\ba_\bs
7594
7595        Type: boolean
7596
7597        Default: no
7598
7599        The Mutt Next Generation E-Mail Client                                      145
7600
7601        This variable controls whether or not Mutt-ng will display the ``personal''
7602        name from your aliases in the index menu if it finds an alias that matches the
7603        message's sender.  For example, if you have the following alias:
7604
7605        alias juser abd30425@somewhere.net (Joe User)
7606
7607        and then you receive mail which contains the following header:
7608
7609        From: abd30425@somewhere.net
7610
7611        It would be displayed in the index menu as ``Joe User'' instead of
7612        ``abd30425@somewhere.net.''  This is useful when the person's e-mail address is
7613        not human friendly (like CompuServe addresses).
7614
7615        _\b7_\b._\b4_\b._\b2_\b4_\b0  _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be
7616
7617        Type: boolean
7618
7619        Default: no
7620
7621        It may sometimes arrive that you receive mail to a certain machine, move the
7622        messages to another machine, and reply to some the messages from there.  If
7623        this variable is _\bs_\be_\bt, the default From: line of the reply messages is built
7624        using the address where you received the messages you are replying to i\bif\bf that
7625        address matches your alternates.  If the variable is _\bu_\bn_\bs_\be_\bt, or the address that
7626        would be used doesn't match your alternates, the From: line will use your
7627        address on the current machine.
7628
7629        _\b7_\b._\b4_\b._\b2_\b4_\b1  _\br_\be_\bv_\be_\br_\bs_\be_\b__\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7630
7631        Type: boolean
7632
7633        Default: yes
7634
7635        This variable fine-tunes the behaviour of the _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.240  ,
7636        page 145) feature.  When it is _\bs_\be_\bt, Mutt-ng will use the address from incoming
7637        messages as-is, possibly including eventual real names.  When it is _\bu_\bn_\bs_\be_\bt,
7638        Mutt-ng will override any such real names with the setting of the _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7639        (section 7.4.232  , page 143) variable.
7640
7641        _\b7_\b._\b4_\b._\b2_\b4_\b2  _\br_\bf_\bc_\b2_\b0_\b4_\b7_\b__\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br_\bs
7642
7643        Type: boolean
7644
7645        Default: no
7646
7647        When this variable is _\bs_\be_\bt, Mutt-ng will decode RFC-2047-encoded MIME parame-
7648        ters. You want to set this variable when Mutt-ng suggests you to save attach-
7649        ments to files named like this:
7650
7651        =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
7652
7653        When this variable is _\bs_\be_\bt interactively, the change doesn't have the desired
7654        effect before you have changed folders.
7655
7656        The Mutt Next Generation E-Mail Client                                      146
7657
7658        Note that this use of RFC 2047's encoding is explicitly, prohibited by the
7659        standard, but nevertheless encountered in the wild.
7660
7661        Also note that setting this parameter will _\bn_\bo_\bt have the effect that Mutt-ng
7662        _\bg_\be_\bn_\be_\br_\ba_\bt_\be_\bs this kind of encoding.  Instead, Mutt-ng will unconditionally use the
7663        encoding specified in RFC 2231.
7664
7665        _\b7_\b._\b4_\b._\b2_\b4_\b3  _\bs_\ba_\bv_\be_\b__\ba_\bd_\bd_\br_\be_\bs_\bs
7666
7667        Type: boolean
7668
7669        Default: no
7670
7671        If _\bs_\be_\bt, Mutt-ng will take the sender's full address when choosing a default
7672        folder for saving a mail. If ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.245  , page 146)'' or
7673        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.71  , page 103)'' is _\bs_\be_\bt too, the selection of the
7674        fcc folder will be changed as well.
7675
7676        _\b7_\b._\b4_\b._\b2_\b4_\b4  _\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by
7677
7678        Type: boolean
7679
7680        Default: yes
7681
7682        When _\bu_\bn_\bs_\be_\bt, mailboxes which contain no saved messages will be removed when
7683        closed (the exception is ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.301  , page 159)'' which is
7684        never removed).  If _\bs_\be_\bt, mailboxes are never removed.
7685
7686        N\bNo\bot\bte\be:\b: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH
7687        and Maildir directories.
7688
7689        _\b7_\b._\b4_\b._\b2_\b4_\b5  _\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be
7690
7691        Type: boolean
7692
7693        Default: no
7694
7695        This variable controls how copies of outgoing messages are saved.  When set, a
7696        check is made to see if a mailbox specified by the recipient address exists
7697        (this is done by searching for a mailbox in the ``_\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.67  ,
7698        page 102)'' directory with the _\bu_\bs_\be_\br_\bn_\ba_\bm_\be part of the recipient address).  If the
7699        mailbox exists, the outgoing message will be saved to that mailbox, otherwise
7700        the message is saved to the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.234  , page 143)'' mailbox.
7701
7702        Also see the ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.71  , page 103)'' variable.
7703
7704        _\b7_\b._\b4_\b._\b2_\b4_\b6  _\bs_\bc_\bo_\br_\be
7705
7706        Type: boolean
7707
7708        Default: yes
7709
7710        When this variable is _\bu_\bn_\bs_\be_\bt, scoring is turned off.  This can be useful to
7711        selectively disable scoring for certain folders when the
7712
7713        The Mutt Next Generation E-Mail Client                                      147
7714
7715        ``_\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.247  , page 146)'' variable and friends
7716        are used.
7717
7718        _\b7_\b._\b4_\b._\b2_\b4_\b7  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
7719
7720        Type: number
7721
7722        Default: -1
7723
7724        Messages which have been assigned a score equal to or lower than the value of
7725        this variable are automatically marked for deletion by Mutt-ng.  Since Mutt-ng
7726        scores are always greater than or equal to zero, the default setting of this
7727        variable will never mark a message for deletion.
7728
7729        _\b7_\b._\b4_\b._\b2_\b4_\b8  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bf_\bl_\ba_\bg
7730
7731        Type: number
7732
7733        Default: 9999
7734
7735        Messages which have been assigned a score greater than or equal to this vari-
7736        able's value are automatically marked ``flagged''.
7737
7738        _\b7_\b._\b4_\b._\b2_\b4_\b9  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd
7739
7740        Type: number
7741
7742        Default: -1
7743
7744        Messages which have been assigned a score equal to or lower than the value of
7745        this variable are automatically marked as read by Mutt-ng.  Since Mutt-ng
7746        scores are always greater than or equal to zero, the default setting of this
7747        variable will never mark a message read.
7748
7749        _\b7_\b._\b4_\b._\b2_\b5_\b0  _\bs_\be_\bn_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
7750
7751        Type: string
7752
7753        Default: 'us-ascii:iso-8859-1:utf-8'
7754
7755        A list of character sets for outgoing messages. Mutt-ng will use the first
7756        character set into which the text can be converted exactly.  If your ``_\b$_\bc_\bh_\ba_\br_\bs_\be_\bt
7757        (section 7.4.26  , page 93)'' is not iso-8859-1 and recipients may not under-
7758        stand UTF-8, it is advisable to include in the list an appropriate widely used
7759        standard character set (such as iso-8859-2, koi8-r or iso-2022-jp) either
7760        instead of or after iso-8859-1.
7761
7762        _\b7_\b._\b4_\b._\b2_\b5_\b1  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl
7763
7764        Type: path
7765
7766        Default: '/usr/sbin/sendmail -oem -oi'
7767
7768        Specifies the program and arguments used to deliver mail sent by Mutt-ng.
7769
7770        The Mutt Next Generation E-Mail Client                                      148
7771
7772        Mutt-ng expects that the specified program interprets additional arguments as
7773        recipient addresses.
7774
7775        _\b7_\b._\b4_\b._\b2_\b5_\b2  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl_\b__\bw_\ba_\bi_\bt
7776
7777        Type: number
7778
7779        Default: 0
7780
7781        Specifies the number of seconds to wait for the ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.251  ,
7782        page 147)'' process to finish before giving up and putting delivery in the
7783        background.
7784
7785        Mutt-ng interprets the value of this variable as follows:
7786
7787              >0
7788                    number of seconds to wait for sendmail to finish before continuing
7789
7790              0
7791                    wait forever for sendmail to finish
7792
7793              <0
7794                    always put sendmail in the background without waiting
7795
7796        Note that if you specify a value other than 0, the output of the child process
7797        will be put in a temporary file.  If there is some error, you will be informed
7798        as to where to find the output.
7799
7800        _\b7_\b._\b4_\b._\b2_\b5_\b3  _\bs_\bh_\be_\bl_\bl
7801
7802        Type: path
7803
7804        Default: ''
7805
7806        Command to use when spawning a subshell.  By default, the user's login shell
7807        from /etc/passwd is used.
7808
7809        _\b7_\b._\b4_\b._\b2_\b5_\b4  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by
7810
7811        Type: string
7812
7813        Default: '.'
7814
7815        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
7816        7.4.258  , page 149) is _\bs_\be_\bt, this variable specifies the characters at which to
7817        split a folder name into ``hierarchy items.''
7818
7819        _\b7_\b._\b4_\b._\b2_\b5_\b5  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bd_\be_\bl_\bi_\bm
7820
7821        Type: string
7822
7823        Default: '|'
7824
7825        This specifies the delimiter between the sidebar (if visible) and other
7826
7827        The Mutt Next Generation E-Mail Client                                      149
7828
7829        screens.
7830
7831        _\b7_\b._\b4_\b._\b2_\b5_\b6  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\be_\bw_\bm_\ba_\bi_\bl_\b__\bo_\bn_\bl_\by
7832
7833        Type: boolean
7834
7835        Default: no
7836
7837        If _\bs_\be_\bt, only folders with new mail will be shown in the sidebar.
7838
7839        _\b7_\b._\b4_\b._\b2_\b5_\b7  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\bu_\bm_\bb_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
7840
7841        Type: string
7842
7843        Default: '%m%?n?(%n)?%?f?[%f]?'
7844
7845        This variable controls how message counts are printed when the sidebar is
7846        enabled. If this variable is _\be_\bm_\bp_\bt_\by (_\ba_\bn_\bd _\bo_\bn_\bl_\by _\bi_\bf), no numbers will be printed
7847        _\ba_\bn_\bd mutt-ng won't frequently count mail (which may be a great speedup esp. with
7848        mbox-style mailboxes.)
7849
7850        The following printf(3)-like sequences are supported all of which may be
7851        printed non-zero:
7852
7853              %d
7854                    Number of deleted messages. 1)
7855
7856              %F
7857                    Number of flagged messages.
7858
7859              %m
7860                    Total number of messages.
7861
7862              %M
7863                    Total number of messages shown, i.e. not hidden by a limit. 1)
7864
7865              %n
7866                    Number of new messages.
7867
7868              %t
7869                    Number of tagged messages. 1)
7870
7871        1) These expandos only have a non-zero value for the current mailbox and will
7872        always be zero otherwise.
7873
7874        _\b7_\b._\b4_\b._\b2_\b5_\b8  _\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
7875
7876        Type: boolean
7877
7878        Default: no
7879
7880        When _\bs_\be_\bt, the ``hierarchy'' of the sidebar entries will be shortened only if
7881        they cannot be printed in full length (because ``_\b$_\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh (section
7882        7.4.260  , page 150)'' is set to a too low value). For example, if the
7883
7884        The Mutt Next Generation E-Mail Client                                      150
7885
7886        newsgroup name ``de.alt.sysadmin.recovery'' doesn't fit on the screen, it'll
7887        get shortened ``d.a.s.recovery'' while ``de.alt.d0'' still would and thus will
7888        not get shortened.
7889
7890        At which characters this compression is done is controled via the _\b$_\bs_\bi_\bd_\be_\b-
7891        _\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by (section 7.4.254  , page 148) variable.
7892
7893        _\b7_\b._\b4_\b._\b2_\b5_\b9  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bv_\bi_\bs_\bi_\bb_\bl_\be
7894
7895        Type: boolean
7896
7897        Default: no
7898
7899        This specifies whether or not to show the sidebar (a list of folders specified
7900        with the ``mailboxes'' command).
7901
7902        _\b7_\b._\b4_\b._\b2_\b6_\b0  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh
7903
7904        Type: number
7905
7906        Default: 0
7907
7908        The width of the sidebar.
7909
7910        _\b7_\b._\b4_\b._\b2_\b6_\b1  _\bs_\bi_\bg_\b__\bd_\ba_\bs_\bh_\be_\bs
7911
7912        Type: boolean
7913
7914        Default: yes
7915
7916        If set, a line containing ``-- '' (dash, dash, space) will be inserted before
7917        your ``_\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.263  , page 150)''.  It is s\bst\btr\bro\bon\bng\bgl\bly\by recommended
7918        that you not unset this variable unless your ``signature'' contains just your
7919        name. The reason for this is because many software packages use ``-- \n'' to
7920        detect your signature.
7921
7922        For example, Mutt-ng has the ability to highlight the signature in a different
7923        color in the builtin pager.
7924
7925        _\b7_\b._\b4_\b._\b2_\b6_\b2  _\bs_\bi_\bg_\b__\bo_\bn_\b__\bt_\bo_\bp
7926
7927        Type: boolean
7928
7929        Default: no
7930
7931        If _\bs_\be_\bt, the signature will be included before any quoted or forwarded text.  It
7932        is s\bst\btr\bro\bon\bng\bgl\bly\by recommended that you do not set this variable unless you really
7933        know what you are doing, and are prepared to take some heat from netiquette
7934        guardians.
7935
7936        _\b7_\b._\b4_\b._\b2_\b6_\b3  _\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be
7937
7938        Type: path
7939
7940        The Mutt Next Generation E-Mail Client                                      151
7941
7942        Default: '~/.signature'
7943
7944        Specifies the filename of your signature, which is appended to all outgoing
7945        messages.   If the filename ends with a pipe (``|''), it is assumed that file-
7946        name is a shell command and input should be read from its stdout.
7947
7948        _\b7_\b._\b4_\b._\b2_\b6_\b4  _\bs_\bi_\bg_\bn_\bo_\bf_\bf_\b__\bs_\bt_\br_\bi_\bn_\bg
7949
7950        Type: string
7951
7952        Default: ''
7953
7954        If _\bs_\be_\bt, this string will be inserted before the signature. This is useful for
7955        people that want to sign off every message they send with their name.
7956
7957        If you want to insert your website's URL, additional contact information or
7958        witty quotes into your mails, better use a signature file instead of the sig-
7959        noff string.
7960
7961        _\b7_\b._\b4_\b._\b2_\b6_\b5  _\bs_\bi_\bm_\bp_\bl_\be_\b__\bs_\be_\ba_\br_\bc_\bh
7962
7963        Type: string
7964
7965        Default: '~f %s | ~s %s'
7966
7967        Specifies how Mutt-ng should expand a simple search into a real search pattern.
7968        A simple search is one that does not contain any of the ~ operators.  See
7969        ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 81)'' for more information on search patterns.
7970
7971        For example, if you simply type ``joe'' at a search or limit prompt, Mutt-ng
7972        will automatically expand it to the value specified by this variable.  For the
7973        default value it would be:
7974
7975        ~f joe | ~s joe
7976
7977        _\b7_\b._\b4_\b._\b2_\b6_\b6  _\bs_\bl_\be_\be_\bp_\b__\bt_\bi_\bm_\be
7978
7979        Type: number
7980
7981        Default: 1
7982
7983        Specifies time, in seconds, to pause while displaying certain informational
7984        messages, while moving from folder to folder and after expunging messages from
7985        the current folder.  The default is to pause one second, so a value of zero for
7986        this option suppresses the pause.
7987
7988        _\b7_\b._\b4_\b._\b2_\b6_\b7  _\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp
7989
7990        Type: boolean
7991
7992        Default: yes
7993
7994        Controls the display of lines longer than the screen width in the internal
7995        pager. If _\bs_\be_\bt, long lines are wrapped at a word boundary.  If _\bu_\bn_\bs_\be_\bt, lines are
7996
7997        The Mutt Next Generation E-Mail Client                                      152
7998
7999        simply wrapped at the screen edge. Also see the ``_\b$_\bm_\ba_\br_\bk_\be_\br_\bs (section 7.4.124  ,
8000        page 117)'' variable.
8001
8002        _\b7_\b._\b4_\b._\b2_\b6_\b8  _\bs_\bm_\bi_\bl_\be_\by_\bs
8003
8004        Type: regular expression
8005
8006        Default: '(>From )|(:[-^]?[][)(><}{|/DP])'
8007
8008        The _\bp_\ba_\bg_\be_\br uses this variable to catch some common false positives of
8009        ``_\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.229  , page 142)'', most notably smileys in the
8010        beginning of a line
8011
8012        _\b7_\b._\b4_\b._\b2_\b6_\b9  _\bs_\bm_\bi_\bm_\be_\b__\ba_\bs_\bk_\b__\bc_\be_\br_\bt_\b__\bl_\ba_\bb_\be_\bl
8013
8014        Type: boolean
8015
8016        Default: yes
8017
8018        This flag controls whether you want to be asked to enter a label for a certifi-
8019        cate about to be added to the database or not. It is _\bs_\be_\bt by default.  (S/MIME
8020        only)
8021
8022        _\b7_\b._\b4_\b._\b2_\b7_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn
8023
8024        Type: path
8025
8026        Default: ''
8027
8028        This variable contains the name of either a directory, or a file which contains
8029        trusted certificates for use with OpenSSL.  (S/MIME only)
8030
8031        _\b7_\b._\b4_\b._\b2_\b7_\b1  _\bs_\bm_\bi_\bm_\be_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs
8032
8033        Type: path
8034
8035        Default: ''
8036
8037        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage
8038        and retrieval of keys by itself. This is very basic right now, and keys and
8039        certificates are stored in two different directories, both named as the hash-
8040        value retrieved from OpenSSL. There is an index file which contains mailbox-
8041        address keyid pairs, and which can be manually edited. This one points to the
8042        location of the certificates.  (S/MIME only)
8043
8044        _\b7_\b._\b4_\b._\b2_\b7_\b2  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8045
8046        Type: string
8047
8048        Default: ''
8049
8050        This format string specifies a command which is used to decrypt application/x-
8051        pkcs7-mime attachments.
8052
8053        The Mutt Next Generation E-Mail Client                                      153
8054
8055        The OpenSSL command formats have their own set of printf(3)-like sequences sim-
8056        ilar to PGP's:
8057
8058              %f
8059                    Expands to the name of a file containing a message.
8060
8061              %s
8062                    Expands to the name of a file containing the signature part of a
8063                    multipart/signed attachment when verifying it.
8064
8065              %k
8066                    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.274  ,
8067                    page 153)
8068
8069              %c
8070                    One or more certificate IDs.
8071
8072              %a
8073                    The algorithm used for encryption.
8074
8075              %C
8076                    CA location:  Depending on whether _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section
8077                    7.4.270  , page 152) points to a directory or file, this expands to
8078                    '-CApath _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.270  , page 152)' or
8079                    '-CAfile _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.270  , page 152)'.
8080
8081        For examples on how to configure these formats, see the smime.rc in the sam-
8082        ples/ subdirectory which has been installed on your system alongside the docu-
8083        mentation.  (S/MIME only)
8084
8085        _\b7_\b._\b4_\b._\b2_\b7_\b3  _\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
8086
8087        Type: boolean
8088
8089        Default: yes
8090
8091        If _\bs_\be_\bt (default) this tells Mutt-ng to use the default key for decryption. Oth-
8092        erwise, if manage multiple certificate-key-pairs, Mutt-ng will try to use the
8093        mailbox-address to determine the key to use. It will ask you to supply a key,
8094        if it can't find one.  (S/MIME only)
8095
8096        _\b7_\b._\b4_\b._\b2_\b7_\b4  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by
8097
8098        Type: string
8099
8100        Default: ''
8101
8102        This is the default key-pair to use for signing. This must be set to the keyid
8103        (the hash-value that OpenSSL generates) to work properly (S/MIME only)
8104
8105        _\b7_\b._\b4_\b._\b2_\b7_\b5  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8106
8107        Type: string
8108
8109        The Mutt Next Generation E-Mail Client                                      154
8110
8111        Default: ''
8112
8113        This command is used to create encrypted S/MIME messages.  (S/MIME only)
8114
8115        _\b7_\b._\b4_\b._\b2_\b7_\b6  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bw_\bi_\bt_\bh
8116
8117        Type: string
8118
8119        Default: ''
8120
8121        This sets the algorithm that should be used for encryption.  Valid choices are
8122        ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``\frc2-128''.
8123
8124        If _\bu_\bn_\bs_\be_\bt ``_\b3_\bd_\be_\bs'' (TripleDES) is used.  (S/MIME only)
8125
8126        _\b7_\b._\b4_\b._\b2_\b7_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bg_\be_\bt_\b__\bc_\be_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8127
8128        Type: string
8129
8130        Default: ''
8131
8132        This command is used to extract X509 certificates from a PKCS7 structure.
8133        (S/MIME only)
8134
8135        _\b7_\b._\b4_\b._\b2_\b7_\b8  _\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
8136
8137        Type: string
8138
8139        Default: ''
8140
8141        This command is used to extract the mail address(es) used for storing X509 cer-
8142        tificates, and for verification purposes (to check whether the certificate was
8143        issued for the sender's mailbox).  (S/MIME only)
8144
8145        _\b7_\b._\b4_\b._\b2_\b7_\b9  _\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
8146
8147        Type: string
8148
8149        Default: ''
8150
8151        This command is used to extract only the signers X509 certificate from a S/MIME
8152        signature, so that the certificate's owner may get compared to the email's
8153        ``From:'' header field.  (S/MIME only)
8154
8155        _\b7_\b._\b4_\b._\b2_\b8_\b0  _\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
8156
8157        Type: string
8158
8159        Default: ''
8160
8161        This command is used to import a certificate via smime_keysng.  (S/MIME only)
8162
8163        _\b7_\b._\b4_\b._\b2_\b8_\b1  _\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt
8164
8165        The Mutt Next Generation E-Mail Client                                      155
8166
8167        Type: boolean
8168
8169        Default: no
8170
8171        The default behaviour of Mutt-ng is to use PGP on all auto-sign/encryption
8172        operations. To override and to use OpenSSL instead this must be _\bs_\be_\bt.
8173
8174        However, this has no effect while replying, since Mutt-ng will automatically
8175        select the same application that was used to sign/encrypt the original message.
8176
8177        (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-
8178        tion 7.4.39  , page 96).)  (S/MIME only)
8179
8180        _\b7_\b._\b4_\b._\b2_\b8_\b2  _\bs_\bm_\bi_\bm_\be_\b__\bk_\be_\by_\bs
8181
8182        Type: path
8183
8184        Default: ''
8185
8186        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage ad
8187        retrieval of keys/certs by itself. This is very basic right now, and stores
8188        keys and certificates in two different directories, both named as the hash-
8189        value retrieved from OpenSSL. There is an index file which contains mailbox-
8190        address keyid pair, and which can be manually edited. This one points to the
8191        location of the private keys.  (S/MIME only)
8192
8193        _\b7_\b._\b4_\b._\b2_\b8_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bp_\bk_\b7_\bo_\bu_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8194
8195        Type: string
8196
8197        Default: ''
8198
8199        This command is used to extract PKCS7 structures of S/MIME signatures, in order
8200        to extract the public X509 certificate(s).  (S/MIME only)
8201
8202        _\b7_\b._\b4_\b._\b2_\b8_\b4  _\bs_\bm_\bi_\bm_\be_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8203
8204        Type: string
8205
8206        Default: ''
8207
8208        This command is used to created S/MIME signatures of type multipart/signed,
8209        which can be read by all mail clients.  (S/MIME only)
8210
8211        _\b7_\b._\b4_\b._\b2_\b8_\b5  _\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
8212
8213        Type: string
8214
8215        Default: ''
8216
8217        This command is used to created S/MIME signatures of type application/x-
8218        pkcs7-signature, which can only be handled by mail clients supporting the
8219        S/MIME extension.  (S/MIME only)
8220
8221        The Mutt Next Generation E-Mail Client                                      156
8222
8223        _\b7_\b._\b4_\b._\b2_\b8_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
8224
8225        Type: number
8226
8227        Default: 300
8228
8229        The number of seconds after which a cached passphrase will expire if not used.
8230        (S/MIME only)
8231
8232        _\b7_\b._\b4_\b._\b2_\b8_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8233
8234        Type: string
8235
8236        Default: ''
8237
8238        This command is used to verify S/MIME signatures of type multipart/signed.
8239        (S/MIME only)
8240
8241        _\b7_\b._\b4_\b._\b2_\b8_\b8  _\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
8242
8243        Type: string
8244
8245        Default: ''
8246
8247        This command is used to verify S/MIME signatures of type application/x-
8248        pkcs7-mime.  (S/MIME only)
8249
8250        _\b7_\b._\b4_\b._\b2_\b8_\b9  _\bs_\bm_\bt_\bp_\b__\be_\bn_\bv_\be_\bl_\bo_\bp_\be
8251
8252        Type: string
8253
8254        Default: ''
8255
8256        Availability: SMTP
8257
8258        If this variable is non-empty, it'll be used as the envelope sender. If it's
8259        empty (the default), the value of the regular From: header will be used.
8260
8261        This may be necessary as some providers don't allow for arbitrary values as the
8262        envelope sender but only a particular one which may not be the same as the
8263        user's desired From: header.
8264
8265        _\b7_\b._\b4_\b._\b2_\b9_\b0  _\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt
8266
8267        Type: string
8268
8269        Default: ''
8270
8271        Availability: SMTP
8272
8273        Defines the SMTP host which will be used to deliver mail, as opposed to invok-
8274        ing the sendmail binary.  Setting this variable overrides the value of ``_\b$_\bs_\be_\bn_\bd_\b-
8275        _\bm_\ba_\bi_\bl (section 7.4.251  , page 147)'', and any associated variables.
8276
8277        The Mutt Next Generation E-Mail Client                                      157
8278
8279        _\b7_\b._\b4_\b._\b2_\b9_\b1  _\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs
8280
8281        Type: string
8282
8283        Default: ''
8284
8285        Availability: SMTP
8286
8287        Defines the password to use with SMTP AUTH.  If ``_\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section
8288        7.4.294  , page 157)'' is set, but this variable is not, you will be prompted
8289        for a password when sending.
8290
8291        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
8292        the superuser of your machine may read it regardless of the file's permissions.
8293
8294        _\b7_\b._\b4_\b._\b2_\b9_\b2  _\bs_\bm_\bt_\bp_\b__\bp_\bo_\br_\bt
8295
8296        Type: number
8297
8298        Default: 25
8299
8300        Availability: SMTP
8301
8302        Defines the port that the SMTP host is listening on for mail delivery.  Must be
8303        specified as a number.
8304
8305        Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers
8306        will probably desire 587, the mail submission port.
8307
8308        _\b7_\b._\b4_\b._\b2_\b9_\b3  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs
8309
8310        Type: string
8311
8312        Default: ''
8313
8314        Availability: SMTP (and SSL)
8315
8316        Defines wether to use STARTTLS. If this option is set to ``_\br_\be_\bq_\bu_\bi_\br_\be_\bd'' and the
8317        server does not support STARTTLS or there is an error in the TLS Handshake, the
8318        connection will fail. Setting this to ``_\be_\bn_\ba_\bb_\bl_\be_\bd'' will try to start TLS and
8319        continue without TLS in case of an error.  Muttng still needs to have SSL sup-
8320        port enabled in order to use it.
8321
8322        _\b7_\b._\b4_\b._\b2_\b9_\b4  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br
8323
8324        Type: string
8325
8326        Default: ''
8327
8328        Availability: SMTP
8329
8330        Defines the username to use with SMTP AUTH.  Setting this variable will cause
8331        Mutt-ng to attempt to use SMTP AUTH when sending.
8332
8333        The Mutt Next Generation E-Mail Client                                      158
8334
8335        _\b7_\b._\b4_\b._\b2_\b9_\b5  _\bs_\bo_\br_\bt
8336
8337        Type: sort order
8338
8339        Default: date
8340
8341        Specifies how to sort messages in the _\bi_\bn_\bd_\be_\bx menu.  Valid values are:
8342
8343                date or date-sent
8344                date-received
8345                from
8346                mailbox-order (unsorted)
8347                score
8348                size
8349                spam
8350                subject
8351                threads
8352                to
8353
8354        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8355        (example: set sort=reverse-date-sent).
8356
8357        _\b7_\b._\b4_\b._\b2_\b9_\b6  _\bs_\bo_\br_\bt_\b__\ba_\bl_\bi_\ba_\bs
8358
8359        Type: sort order
8360
8361        Default: alias
8362
8363        Specifies how the entries in the ``alias'' menu are sorted.  The following are
8364        legal values:
8365
8366                address (sort alphabetically by email address)
8367                alias (sort alphabetically by alias name)
8368                unsorted (leave in order specified in .muttrc)
8369
8370        _\b7_\b._\b4_\b._\b2_\b9_\b7  _\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8371
8372        Type: sort order
8373
8374        Default: date
8375
8376        When sorting by threads, this variable controls how threads are sorted in rela-
8377        tion to other threads, and how the branches of the thread trees are sorted.
8378        This can be set to any value that ``_\b$_\bs_\bo_\br_\bt (section 7.4.295  , page 157)'' can,
8379        except threads (in that case, Mutt-ng will just use date-sent).  You can also
8380        specify the ``last-'' prefix in addition to ``reverse-'' prefix, but last- must
8381        come after reverse-.  The last- prefix causes messages to be sorted against its
8382        siblings by which has the last descendant, using the rest of sort_aux as an
8383        ordering.
8384
8385        The Mutt Next Generation E-Mail Client                                      159
8386
8387        For instance, set sort_aux=last-date-received would mean that if a new message
8388        is received in a thread, that thread becomes the last one displayed (or the
8389        first, if you have set sort=reverse-threads.)
8390
8391        N\bNo\bot\bte\be:\b: For reversed ``_\b$_\bs_\bo_\br_\bt (section 7.4.295  , page 157)'' order _\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8392        (section 7.4.297  , page 158) is reversed again (which is not the right thing
8393        to do, but kept to not break any existing configuration setting).
8394
8395        _\b7_\b._\b4_\b._\b2_\b9_\b8  _\bs_\bo_\br_\bt_\b__\bb_\br_\bo_\bw_\bs_\be_\br
8396
8397        Type: sort order
8398
8399        Default: alpha
8400
8401        Specifies how to sort entries in the file browser.  By default, the entries are
8402        sorted alphabetically.  Valid values:
8403
8404                alpha (alphabetically)
8405                date
8406                size
8407                unsorted
8408
8409        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8410        (example: set sort_browser=reverse-date).
8411
8412        _\b7_\b._\b4_\b._\b2_\b9_\b9  _\bs_\bo_\br_\bt_\b__\br_\be
8413
8414        Type: boolean
8415
8416        Default: yes
8417
8418        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
8419        (section 7.4.316  , page 165)'' _\bu_\bn_\bs_\be_\bt. In that case, it changes the heuristic
8420        Mutt-ng uses to thread messages by subject.  With _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.299  ,
8421        page 159) _\bs_\be_\bt, Mutt-ng will only attach a message as the child of another mes-
8422        sage by subject if the subject of the child message starts with a substring
8423        matching the setting of ``_\b$_\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.235  , page 143)''. With
8424        _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.299  , page 159) _\bu_\bn_\bs_\be_\bt, Mutt-ng will attach the message
8425        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
8426        7.4.235  , page 143)'' parts of both messages are identical.
8427
8428        _\b7_\b._\b4_\b._\b3_\b0_\b0  _\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br
8429
8430        Type: string
8431
8432        Default: ','
8433
8434        ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.300  , page 159)'' controls what happens when
8435        multiple spam headers are matched: if _\bu_\bn_\bs_\be_\bt, each successive header will over-
8436        write any previous matches value for the spam label. If _\bs_\be_\bt, each successive
8437        match will append to the previous, using ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.300  ,
8438        page 159)'' as a separator.
8439
8440        The Mutt Next Generation E-Mail Client                                      160
8441
8442        _\b7_\b._\b4_\b._\b3_\b0_\b1  _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be
8443
8444        Type: path
8445
8446        Default: ''
8447
8448        If your spool mailbox is in a non-default place where Mutt-ng cannot find it,
8449        you can specify its location with this variable.  Mutt-ng will automatically
8450        set this variable to the value of the environment variable $MAIL if it is not
8451        set.
8452
8453        _\b7_\b._\b4_\b._\b3_\b0_\b2  _\bs_\bs_\bl_\b__\bc_\ba_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs_\b__\bf_\bi_\bl_\be
8454
8455        Type: path
8456
8457        Default: ''
8458
8459        This variable specifies a file containing trusted CA certificates.  Any server
8460        certificate that is signed with one of these CA certificates are also automati-
8461        cally accepted.
8462
8463        Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
8464
8465        _\b7_\b._\b4_\b._\b3_\b0_\b3  _\bs_\bs_\bl_\b__\bc_\bl_\bi_\be_\bn_\bt_\b__\bc_\be_\br_\bt
8466
8467        Type: path
8468
8469        Default: ''
8470
8471        Availability: SSL
8472
8473        The file containing a client certificate and its associated private key.
8474
8475        _\b7_\b._\b4_\b._\b3_\b0_\b4  _\bs_\bs_\bl_\b__\bf_\bo_\br_\bc_\be_\b__\bt_\bl_\bs
8476
8477        Type: boolean
8478
8479        Default: no
8480
8481        If this variable is _\bs_\be_\bt, mutt-ng will require that all connections to remote
8482        servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
8483        server does not advertise the capability, since it would otherwise have to
8484        abort the connection anyway. This option supersedes ``_\b$_\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs (section
8485        7.4.306  , page 160)''.
8486
8487        _\b7_\b._\b4_\b._\b3_\b0_\b5  _\bs_\bs_\bl_\b__\bm_\bi_\bn_\b__\bd_\bh_\b__\bp_\br_\bi_\bm_\be_\b__\bb_\bi_\bt_\bs
8488
8489        Type: number
8490
8491        Default: 0
8492
8493        Availability: GNUTLS
8494
8495        This variable specifies the minimum acceptable prime size (in bits) for use in
8496
8497        The Mutt Next Generation E-Mail Client                                      161
8498
8499        any Diffie-Hellman key exchange. A value of 0 will use the default from the
8500        GNUTLS library.
8501
8502        _\b7_\b._\b4_\b._\b3_\b0_\b6  _\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs
8503
8504        Type: quadoption
8505
8506        Default: yes
8507
8508        Availability: SSL or GNUTLS
8509
8510        If _\bs_\be_\bt (the default), Mutt-ng will attempt to use STARTTLS on servers advertis-
8511        ing the capability. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not attempt to use STARTTLS
8512        regardless of the server's capabilities.
8513
8514        _\b7_\b._\b4_\b._\b3_\b0_\b7  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b2
8515
8516        Type: boolean
8517
8518        Default: yes
8519
8520        Availability: SSL
8521
8522        This variables specifies whether to attempt to use SSLv2 in the SSL authentica-
8523        tion process.
8524
8525        _\b7_\b._\b4_\b._\b3_\b0_\b8  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b3
8526
8527        Type: boolean
8528
8529        Default: yes
8530
8531        Availability: SSL or GNUTLS
8532
8533        This variables specifies whether to attempt to use SSLv3 in the SSL authentica-
8534        tion process.
8535
8536        _\b7_\b._\b4_\b._\b3_\b0_\b9  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bt_\bl_\bs_\bv_\b1
8537
8538        Type: boolean
8539
8540        Default: yes
8541
8542        Availability: SSL or GNUTLS
8543
8544        This variables specifies whether to attempt to use TLSv1 in the SSL authentica-
8545        tion process.
8546
8547        _\b7_\b._\b4_\b._\b3_\b1_\b0  _\bs_\bs_\bl_\b__\bu_\bs_\be_\bs_\by_\bs_\bt_\be_\bm_\bc_\be_\br_\bt_\bs
8548
8549        Type: boolean
8550
8551        Default: yes
8552
8553        The Mutt Next Generation E-Mail Client                                      162
8554
8555        Availability: SSL
8556
8557        If set to _\by_\be_\bs, Mutt-ng will use CA certificates in the system-wide certificate
8558        store when checking if server certificate is signed by a trusted CA.
8559
8560        _\b7_\b._\b4_\b._\b3_\b1_\b1  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs
8561
8562        Type: string
8563
8564        Default: '-*%A'
8565
8566        Controls the characters used by the ``%r'' indicator in ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (sec-
8567        tion 7.4.312  , page 162)''. The first character is used when the mailbox is
8568        unchanged. The second is used when the mailbox has been changed, and it needs
8569        to be resynchronized. The third is used if the mailbox is in read-only mode, or
8570        if the mailbox will not be written when exiting that mailbox (You can toggle
8571        whether to write changes to a mailbox with the toggle-write operation, bound by
8572        default to ``%'').  The fourth  is used to indicate that the current folder has
8573        been opened in attach-message mode (Certain operations like composing a new
8574        mail, replying, forwarding, etc. are not permitted in this mode).
8575
8576        _\b7_\b._\b4_\b._\b3_\b1_\b2  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
8577
8578        Type: string
8579
8580        Default: '-%r-Mutt-ng: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d?
8581        Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l?
8582        %l?]---(%s/%S)-%>-(%P)---'
8583
8584        Controls the format of the status line displayed in the _\bi_\bn_\bd_\be_\bx menu.  This
8585        string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.113  , page 113)'', but has
8586        its own set of printf(3)-like sequences:
8587
8588              %b
8589                    number of mailboxes with new mail *
8590
8591              %B
8592                    the short pathname of the current mailbox
8593
8594              %d
8595                    number of deleted messages *
8596
8597              %f
8598                    the full pathname of the current mailbox
8599
8600              %F
8601                    number of flagged messages *
8602
8603              %h
8604                    local hostname
8605
8606              %l
8607                    size (in bytes) of the current mailbox *
8608
8609        The Mutt Next Generation E-Mail Client                                      163
8610
8611              %L
8612                    size (in bytes) of the messages shown (i.e., which match the cur-
8613                    rent limit) *
8614
8615              %m
8616                    the number of messages in the mailbox *
8617
8618              %M
8619                    the number of messages shown (i.e., which match the current limit)
8620                    *
8621
8622              %n
8623                    number of new messages in the mailbox *
8624
8625              %o
8626                    number of old unread messages *
8627
8628              %p
8629                    number of postponed messages *
8630
8631              %P
8632                    percentage of the way through the index
8633
8634              %r
8635                    modified/read-only/won't-write/attach-message indicator, according
8636                    to _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs (section 7.4.311  , page 161)
8637
8638              %s
8639                    current sorting mode (_\b$_\bs_\bo_\br_\bt (section 7.4.295  , page 157))
8640
8641              %S
8642                    current aux sorting method (_\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx (section 7.4.297  , page
8643                    158))
8644
8645              %t
8646                    number of tagged messages *
8647
8648              %u
8649                    number of unread messages *
8650
8651              %v
8652                    Mutt-ng version string
8653
8654              %V
8655                    currently active limit pattern, if any *
8656
8657              %>X
8658                    right justify the rest of the string and pad with 'X'
8659
8660              %|X
8661                    pad to the end of the line with 'X'
8662
8663        * = can be optionally printed if nonzero
8664
8665        The Mutt Next Generation E-Mail Client                                      164
8666
8667        Some of the above sequences can be used to optionally print a string if their
8668        value is nonzero.  For example, you may only want to see the number of flagged
8669        messages if such messages exist, since zero is not particularly meaningful.  To
8670        optionally print a string based upon one of the above sequences, the following
8671        construct is used
8672
8673        %?<sequence_char>?<optional_string>?
8674
8675        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
8676        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
8677        m\bma\bay\by contain other sequences as well as normal text, but you may n\bno\bot\bt nest
8678        optional strings.
8679
8680        Here is an example illustrating how to optionally print the number of new mes-
8681        sages in a mailbox:
8682
8683        %?n?%n new messages.?
8684
8685        Additionally you can switch between two strings, the first one, if a value is
8686        zero, the second one, if the value is nonzero, by using the following con-
8687        struct:
8688
8689        %?<sequence_char>?<if_string>&<else_string>?
8690
8691        You can additionally force the result of any printf(3)-like sequence to be low-
8692        ercase by prefixing the sequence character with an underscore (_) sign.  For
8693        example, if you want to display the local hostname in lowercase, you would use:
8694
8695        %_h
8696
8697        If you prefix the sequence character with a colon (:) character, Mutt-ng will
8698        replace any dots in the expansion by underscores. This might be helpful with
8699        IMAP folders that don't like dots in folder names.
8700
8701        _\b7_\b._\b4_\b._\b3_\b1_\b3  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bo_\bn_\b__\bt_\bo_\bp
8702
8703        Type: boolean
8704
8705        Default: no
8706
8707        Setting this variable causes the ``status bar'' to be displayed on the first
8708        line of the screen rather than near the bottom.
8709
8710        _\b7_\b._\b4_\b._\b3_\b1_\b4  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo
8711
8712        Type: boolean
8713
8714        Default: yes
8715
8716        With mailto: style links, a body as well as arbitrary header information may be
8717        embedded. This may lead to (user) headers being overwriten without note if
8718        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.57  , page 100)'' is unset.
8719
8720        If this variable is _\bs_\be_\bt, mutt-ng is strict and allows anything to be changed.
8721
8722        The Mutt Next Generation E-Mail Client                                      165
8723
8724        If it's _\bu_\bn_\bs_\be_\bt, all headers given will be prefixed with ``X-Mailto-'' and the
8725        message including headers will be shown in the editor regardless of what
8726        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.57  , page 100)'' is set to.
8727
8728        _\b7_\b._\b4_\b._\b3_\b1_\b5  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be
8729
8730        Type: boolean
8731
8732        Default: yes
8733
8734        When _\bu_\bn_\bs_\be_\bt, non MIME-compliant messages that doesn't have any charset indica-
8735        tion in the ``Content-Type:'' header field can be displayed (non MIME-compliant
8736        messages are often generated by old mailers or buggy mailers like MS Outlook
8737        Express).  See also _\b$_\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.12  , page 89).
8738
8739        This option also replaces linear-white-space between encoded-word and *text to
8740        a single space to prevent the display of MIME-encoded ``Subject:'' header field
8741        from being devided into multiple lines.
8742
8743        _\b7_\b._\b4_\b._\b3_\b1_\b6  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
8744
8745        Type: boolean
8746
8747        Default: no
8748
8749        If _\bs_\be_\bt, threading will only make use of the ``In-Reply-To:'' and ``Refer-
8750        ences:'' header fields when you ``_\b$_\bs_\bo_\br_\bt (section 7.4.295  , page 157)'' by mes-
8751        sage threads.  By default, messages with the same subject are grouped together
8752        in ``pseudo threads.''  This may not always be desirable, such as in a personal
8753        mailbox where you might have several unrelated messages with the subject ``hi''
8754        which will get grouped together.
8755
8756        _\b7_\b._\b4_\b._\b3_\b1_\b7  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs
8757
8758        Type: boolean
8759
8760        Default: no
8761
8762        When _\bs_\be_\bt, mutt-ng will remove the trailing part of the ``Subject:'' line which
8763        matches _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx (section 7.4.318  , page 165) when replying. This is
8764        useful to properly react on subject changes and reduce ``subject noise.'' (esp.
8765        in Usenet)
8766
8767        _\b7_\b._\b4_\b._\b3_\b1_\b8  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx
8768
8769        Type: regular expression
8770
8771        Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$'
8772
8773        When non-empty and _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs (section 7.4.317  , page 165) is _\bs_\be_\bt, mutt-ng
8774        will remove this trailing part of the ``Subject'' line when replying if it
8775        won't be empty afterwards.
8776
8777        The Mutt Next Generation E-Mail Client                                      166
8778
8779        _\b7_\b._\b4_\b._\b3_\b1_\b9  _\bs_\bt_\bu_\bf_\bf_\b__\bq_\bu_\bo_\bt_\be_\bd
8780
8781        Type: boolean
8782
8783        Default: no
8784
8785        If _\bs_\be_\bt, attachments with flowed format will have their quoting ``stuffed'',
8786        i.e. a space will be inserted between the quote characters and the actual text.
8787
8788        _\b7_\b._\b4_\b._\b3_\b2_\b0  _\bs_\bu_\bs_\bp_\be_\bn_\bd
8789
8790        Type: boolean
8791
8792        Default: yes
8793
8794        When _\bu_\bn_\bs_\be_\bt, Mutt-ng won't stop when the user presses the terminal's _\bs_\bu_\bs_\bp key,
8795        usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a com-
8796        mand like ``xterm -e muttng.''
8797
8798        _\b7_\b._\b4_\b._\b3_\b2_\b1  _\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd
8799
8800        Type: boolean
8801
8802        Default: no
8803
8804        When _\bs_\be_\bt, Mutt-ng will generate text/plain; format=flowed attachments.  This
8805        format is easier to handle for some mailing software, and generally just looks
8806        like ordinary text.  To actually make use of this format's features, you'll
8807        need support in your editor.
8808
8809        Note that _\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.112  , page 113) is ignored when this
8810        option is set.
8811
8812        _\b7_\b._\b4_\b._\b3_\b2_\b2  _\bt_\bh_\bo_\br_\bo_\bu_\bg_\bh_\b__\bs_\be_\ba_\br_\bc_\bh
8813
8814        Type: boolean
8815
8816        Default: no
8817
8818        Affects the ~b and ~h search operations described in section ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
8819        tion 7.2  , page 81)'' above.  If _\bs_\be_\bt, the headers and attachments of messages
8820        to be searched are decoded before searching.  If _\bu_\bn_\bs_\be_\bt, messages are searched
8821        as they appear in the folder.
8822
8823        _\b7_\b._\b4_\b._\b3_\b2_\b3  _\bt_\bh_\br_\be_\ba_\bd_\b__\br_\be_\bc_\be_\bi_\bv_\be_\bd
8824
8825        Type: boolean
8826
8827        Default: no
8828
8829        When _\bs_\be_\bt, Mutt-ng uses the date received rather than the date sent to thread
8830        messages by subject.
8831
8832        The Mutt Next Generation E-Mail Client                                      167
8833
8834        _\b7_\b._\b4_\b._\b3_\b2_\b4  _\bt_\bi_\bl_\bd_\be
8835
8836        Type: boolean
8837
8838        Default: no
8839
8840        When _\bs_\be_\bt, the internal-pager will pad blank lines to the bottom of the screen
8841        with a tilde (~).
8842
8843        _\b7_\b._\b4_\b._\b3_\b2_\b5  _\bt_\bi_\bm_\be_\bo_\bu_\bt
8844
8845        Type: number
8846
8847        Default: 600
8848
8849        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
8850        pressed in the main menu before timing out and checking for new mail.  A value
8851        of zero or less will cause Mutt-ng to never time out.
8852
8853        _\b7_\b._\b4_\b._\b3_\b2_\b6  _\bt_\bm_\bp_\bd_\bi_\br
8854
8855        Type: path
8856
8857        Default: ''
8858
8859        This variable allows you to specify where Mutt-ng will place its temporary
8860        files needed for displaying and composing messages.  If this variable is not
8861        set, the environment variable $TMPDIR is used.  If $TMPDIR is not set then
8862        '/tmp' is used.
8863
8864        _\b7_\b._\b4_\b._\b3_\b2_\b7  _\bt_\bo_\b__\bc_\bh_\ba_\br_\bs
8865
8866        Type: string
8867
8868        Default: ' +TCFL'
8869
8870        Controls the character used to indicate mail addressed to you.  The first char-
8871        acter is the one used when the mail is NOT addressed to your address (default:
8872        space).  The second is used when you are the only recipient of the message
8873        (default: +).  The third is when your address appears in the ``To:'' header
8874        field, but you are not the only recipient of the message (default: T).  The
8875        fourth character is used when your address is specified in the ``Cc:'' header
8876        field, but you are not the only recipient.  The fifth character is used to
8877        indicate mail that was sent by _\by_\bo_\bu.  The sixth character is used to indicate
8878        when a mail was sent to a mailing-list you're subscribe to (default: L).
8879
8880        _\b7_\b._\b4_\b._\b3_\b2_\b8  _\bt_\br_\ba_\bs_\bh
8881
8882        Type: path
8883
8884        Default: ''
8885
8886        If _\bs_\be_\bt, this variable specifies the path of the trash folder where the mails
8887        marked for deletion will be moved, instead of being irremediably purged.
8888
8889        The Mutt Next Generation E-Mail Client                                      168
8890
8891        N\bNo\bot\bte\be: When you delete a message in the trash folder, it is really deleted, so
8892        that there is no way to recover mail.
8893
8894        _\b7_\b._\b4_\b._\b3_\b2_\b9  _\bt_\bu_\bn_\bn_\be_\bl
8895
8896        Type: string
8897
8898        Default: ''
8899
8900        Setting this variable will cause Mutt-ng to open a pipe to a command instead of
8901        a raw socket. You may be able to use this to set up preauthenticated connec-
8902        tions to your IMAP/POP3 server. Example:
8903
8904        tunnel='ssh -q mailhost.net /usr/local/libexec/imapd'
8905
8906        N\bNo\bot\bte\be:\b: For this example to work you must be able to log in to the remote machine
8907        without having to enter a password.
8908
8909        _\b7_\b._\b4_\b._\b3_\b3_\b0  _\bu_\bm_\ba_\bs_\bk
8910
8911        Type: number
8912
8913        Default: 0077
8914
8915        This sets the umask that will be used by Mutt-ng when creating all kinds of
8916        files. If _\bu_\bn_\bs_\be_\bt, the default value is 077.
8917
8918        _\b7_\b._\b4_\b._\b3_\b3_\b1  _\bu_\bn_\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bj_\bu_\bm_\bp
8919
8920        Type: boolean
8921
8922        Default: no
8923
8924        When _\bs_\be_\bt, Mutt-ng will jump to the next unread message, if any, when the cur-
8925        rent thread is _\bu_\bncollapsed.
8926
8927        _\b7_\b._\b4_\b._\b3_\b3_\b2  _\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be
8928
8929        Type: boolean
8930
8931        Default: no
8932
8933        W\bWa\bar\brn\bni\bin\bng\bg:\b: do not set this variable unless you are using a version of sendmail
8934        which supports the -B8BITMIME flag (such as sendmail 8.8.x) or in connection
8935        with the SMTP support via libESMTP.  Otherwise you may not be able to send
8936        mail.
8937
8938        When _\bs_\be_\bt, Mutt-ng will either invoke ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.251  , page
8939        147)'' with the -B8BITMIME flag when sending 8-bit messages to enable ESMTP
8940        negotiation or tell libESMTP to do so.
8941
8942        _\b7_\b._\b4_\b._\b3_\b3_\b3  _\bu_\bs_\be_\b__\bd_\bo_\bm_\ba_\bi_\bn
8943
8944        Type: boolean
8945
8946        The Mutt Next Generation E-Mail Client                                      169
8947
8948        Default: yes
8949
8950        When _\bs_\be_\bt, Mutt-ng will qualify all local addresses (ones without the @host por-
8951        tion) with the value of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section 7.4.92  , page 108)''.  If _\bu_\bn_\bs_\be_\bt,
8952        no addresses will be qualified.
8953
8954        _\b7_\b._\b4_\b._\b3_\b3_\b4  _\bu_\bs_\be_\b__\bf_\br_\bo_\bm
8955
8956        Type: boolean
8957
8958        Default: yes
8959
8960        When _\bs_\be_\bt, Mutt-ng will generate the ``From:'' header field when sending mes-
8961        sages. If _\bu_\bn_\bs_\be_\bt, no ``From:'' header field will be generated unless the user
8962        explicitly sets one using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 35)'' command.
8963
8964        _\b7_\b._\b4_\b._\b3_\b3_\b5  _\bu_\bs_\be_\b__\bi_\bd_\bn
8965
8966        Type: boolean
8967
8968        Default: yes
8969
8970        Availability: IDN
8971
8972        When _\bs_\be_\bt, Mutt-ng will show you international domain names decoded.
8973
8974        N\bNo\bot\bte\be:\b: You can use IDNs for addresses even if this is _\bu_\bn_\bs_\be_\bt.  This variable only
8975        affects decoding.
8976
8977        _\b7_\b._\b4_\b._\b3_\b3_\b6  _\bu_\bs_\be_\b__\bi_\bp_\bv_\b6
8978
8979        Type: boolean
8980
8981        Default: yes
8982
8983        When _\bs_\be_\bt, Mutt-ng will look for IPv6 addresses of hosts it tries to contact.
8984        If this option is _\bu_\bn_\bs_\be_\bt, Mutt-ng will restrict itself to IPv4 addresses.  Nor-
8985        mally, the default should work.
8986
8987        _\b7_\b._\b4_\b._\b3_\b3_\b7  _\bu_\bs_\be_\br_\b__\ba_\bg_\be_\bn_\bt
8988
8989        Type: boolean
8990
8991        Default: yes
8992
8993        When _\bs_\be_\bt, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indi-
8994        cating which version of Mutt-ng was used for composing them.
8995
8996        _\b7_\b._\b4_\b._\b3_\b3_\b8  _\bv_\bi_\bs_\bu_\ba_\bl
8997
8998        Type: path
8999
9000        Default: ''
9001
9002        The Mutt Next Generation E-Mail Client                                      170
9003
9004        Specifies the visual editor to invoke when the _\b~_\bv command is given in the
9005        builtin editor.
9006
9007        _\b7_\b._\b4_\b._\b3_\b3_\b9  _\bw_\ba_\bi_\bt_\b__\bk_\be_\by
9008
9009        Type: boolean
9010
9011        Default: yes
9012
9013        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-
9014        _\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.
9015
9016        It is also used when viewing attachments with ``_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page
9017        76)'', provided that the corresponding mailcap entry has a needsterminal flag,
9018        and the external program is interactive.
9019
9020        When _\bs_\be_\bt, Mutt-ng will always ask for a key. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will wait for
9021        a key only if the external command returned a non-zero status.
9022
9023        _\b7_\b._\b4_\b._\b3_\b4_\b0  _\bw_\be_\be_\bd
9024
9025        Type: boolean
9026
9027        Default: yes
9028
9029        When _\bs_\be_\bt, Mutt-ng will weed headers when displaying, forwarding, printing, or
9030        replying to messages.
9031
9032        _\b7_\b._\b4_\b._\b3_\b4_\b1  _\bw_\br_\ba_\bp_\b__\bs_\be_\ba_\br_\bc_\bh
9033
9034        Type: boolean
9035
9036        Default: yes
9037
9038        Controls whether searches wrap around the end of the mailbox.
9039
9040        When _\bs_\be_\bt, searches will wrap around the first (or last) message. When _\bu_\bn_\bs_\be_\bt,
9041        searches will not wrap.
9042
9043        _\b7_\b._\b4_\b._\b3_\b4_\b2  _\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
9044
9045        Type: number
9046
9047        Default: 0
9048
9049        Controls the size of the margin remaining at the right side of the terminal
9050        when Mutt-ng's pager does smart wrapping.
9051
9052        _\b7_\b._\b4_\b._\b3_\b4_\b3  _\bw_\br_\bi_\bt_\be_\b__\bb_\bc_\bc
9053
9054        Type: boolean
9055
9056        Default: yes
9057
9058        The Mutt Next Generation E-Mail Client                                      171
9059
9060        Controls whether Mutt-ng writes out the Bcc header when preparing messages to
9061        be sent.  Exim users may wish to _\bu_\bn_\bs_\be_\bt this.
9062
9063        _\b7_\b._\b4_\b._\b3_\b4_\b4  _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc
9064
9065        Type: number
9066
9067        Default: 10
9068
9069        When writing a mailbox, a message will be printed every _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc messages to
9070        indicate progress.  If set to 0, only a single message will be displayed before
9071        writing a mailbox.
9072
9073        Also see the ``_\b$_\br_\be_\ba_\bd_\b__\bi_\bn_\bc (section 7.4.230  , page 142)'' variable.
9074
9075        _\b7_\b._\b4_\b._\b3_\b4_\b5  _\bx_\bt_\be_\br_\bm_\b__\bi_\bc_\bo_\bn
9076
9077        Type: string
9078
9079        Default: 'M%?n?AIL&ail?'
9080
9081        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-
9082        tion 7.4.347  , page 171) is _\bs_\be_\bt. This string is identical in formatting to the
9083        one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.312  , page 162)''.
9084
9085        _\b7_\b._\b4_\b._\b3_\b4_\b6  _\bx_\bt_\be_\br_\bm_\b__\bl_\be_\ba_\bv_\be
9086
9087        Type: string
9088
9089        Default: ''
9090
9091        If _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.347  , page 171) is _\bs_\be_\bt, this string will be
9092        used to set the title when leaving mutt-ng. For terminal-based programs,
9093        there's no easy and portable way to read the current title so mutt-ng cannot
9094        read it upon startup and restore it when exiting.
9095
9096        Based on the xterm FAQ, the following might work:
9097
9098        set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME |
9099        cut -d ''' -f 2`'
9100
9101        _\b7_\b._\b4_\b._\b3_\b4_\b7  _\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs
9102
9103        Type: boolean
9104
9105        Default: no
9106
9107        Controls whether Mutt-ng sets the xterm title bar and icon name (as long as
9108        you're in an appropriate terminal). The default must be _\bu_\bn_\bs_\be_\bt to force in the
9109        validity checking.
9110
9111        _\b7_\b._\b4_\b._\b3_\b4_\b8  _\bx_\bt_\be_\br_\bm_\b__\bt_\bi_\bt_\bl_\be
9112
9113        Type: string
9114
9115        The Mutt Next Generation E-Mail Client                                      172
9116
9117        Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?'
9118
9119        Controls the format of the title bar of the xterm provided that
9120        _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.347  , page 171) has been _\bs_\be_\bt. This string is
9121        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.312  ,
9122        page 162)''.
9123
9124        _\b7_\b._\b5  _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
9125
9126        The following is the list of available functions listed by the mapping in which
9127        they are available.  The default key setting is given, and an explanation of
9128        what the function does.  The key bindings of these functions can be changed
9129        with the _\bb_\bi_\bn_\bd (section 3.4  , page 24) command.
9130
9131        _\b7_\b._\b5_\b._\b1  _\bg_\be_\bn_\be_\br_\bi_\bc
9132
9133        The _\bg_\be_\bn_\be_\br_\bi_\bc menu is not a real menu, but specifies common functions (such as
9134        movement) available in all menus except for _\bp_\ba_\bg_\be_\br and _\be_\bd_\bi_\bt_\bo_\br.  Changing set-
9135        tings for this menu will affect the default bindings for all menus (except as
9136        noted).
9137
9138             bottom-page                L   move to the bottom of the page
9139             current-bottom     not bound   move current entry to bottom of page
9140             current-middle     not bound   move current entry to middle of page
9141             current-top        not bound   move current entry to top of page
9142             enter-command              :   enter a muttngrc command
9143             exit                       q   exit this menu
9144             first-entry                =   move to the first entry
9145             half-down                  ]   scroll down 1/2 page
9146             half-up                    [   scroll up 1/2 page
9147             help                       ?   this screen
9148             jump                  number   jump to an index number
9149             last-entry                 *   move to the last entry
9150             middle-page                M   move to the middle of the page
9151             next-entry                 j   move to the next entry
9152             next-line                  >   scroll down one line
9153             next-page                  z   move to the next page
9154             previous-entry             k   move to the previous entry
9155             previous-line              <   scroll up one line
9156             previous-page              Z   move to the previous page
9157             refresh                   ^L   clear and redraw the screen
9158             search                     /   search for a regular expression
9159             search-next                n   search for next match
9160             search-opposite    not bound   search for next match in opposite direction
9161             search-reverse         ESC /   search backwards for a regular expression
9162             select-entry             RET   select the current entry
9163             shell-escape               !   run a program in a subshell
9164             tag-entry                  t   toggle the tag on the current entry
9165             tag-prefix                 ;   apply next command to tagged entries
9166             tag-prefix-cond    not bound   apply next function ONLY to tagged messages
9167             top-page                   H   move to the top of the page
9168             what-key           not bound   display the keycode for a key press
9169
9170        The Mutt Next Generation E-Mail Client                                      173
9171
9172        _\b7_\b._\b5_\b._\b2  _\bi_\bn_\bd_\be_\bx
9173
9174        The Mutt Next Generation E-Mail Client                                      174
9175
9176             bounce-message             b   remail a message to another user
9177             change-folder              c   open a different folder
9178             change-folder-readonly ESC c   open a different folder in read only mode
9179             check-traditional-pgp  ESC P   check for classic pgp
9180             clear-flag                 W   clear a status flag from a message
9181             copy-message               C   copy a message to a file/mailbox
9182             create-alias               a   create an alias from a message sender
9183             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9184             decode-save            ESC s   decode a message and save it to a file/mailbox
9185             delete-message             d   delete the current entry
9186             delete-pattern             D   delete messages matching a pattern
9187             delete-subthread       ESC d   delete all messages in subthread
9188             delete-thread             ^D   delete all messages in thread
9189             display-address            @   display full address of sender
9190             display-toggle-weed        h   display message and toggle header weeding
9191             display-message          RET   display a message
9192             edit                       e   edit the current message
9193             edit-type                 ^E   edit the current message's Content-Type
9194             exit                       x   exit without saving changes
9195             extract-keys              ^K   extract PGP public keys
9196             fetch-mail                 G   retrieve mail from POP server
9197             flag-message               F   toggle a message's 'important' flag
9198             forget-passphrase         ^F   wipe PGP passphrase from memory
9199             forward-message            f   forward a message with comments
9200             group-reply                g   reply to all recipients
9201             limit                      l   show only messages matching a pattern
9202             list-reply                 L   reply to specified mailing list
9203             mail                       m   compose a new mail message
9204             mail-key               ESC k   mail a PGP public key
9205             next-new                 TAB   jump to the next new message
9206             next-subthread         ESC n   jump to the next subthread
9207             next-thread               ^N   jump to the next thread
9208             next-undeleted             j   move to the next undeleted message
9209             next-unread        not bound   jump to the next unread message
9210             parent-message             P   jump to parent message in thread
9211             pipe-message               |   pipe message/attachment to a shell command
9212             previous-new         ESC TAB   jump to the previous new message
9213             previous-page              Z   move to the previous page
9214             previous-subthread     ESC p   jump to previous subthread
9215             previous-thread           ^P   jump to previous thread
9216             previous-undeleted         k   move to the last undelete message
9217             previous-unread    not bound   jump to the previous unread message
9218             print-message              p   print the current entry
9219             query                      Q   query external program for addresses
9220             quit                       q   save changes to mailbox and quit
9221             read-subthread         ESC r   mark the current subthread as read
9222             read-thread               ^R   mark the current thread as read
9223             recall-message             R   recall a postponed message
9224             reply                      r   reply to a message
9225             resend-message         ESC e   resend message and preserve MIME structure
9226             save-message               s   save message/attachment to a file
9227             set-flag                   w   set a status flag on a message
9228             show-version               V   show the Mutt-ng version number and date
9229             show-limit             ESC l   show currently active limit pattern, if any
9230
9231        The Mutt Next Generation E-Mail Client                                      175
9232
9233             sort-mailbox               o   sort messages
9234             sort-reverse               O   sort messages in reverse order
9235             sync-mailbox               $   save changes to mailbox
9236             tag-pattern                T   tag messages matching a pattern
9237             tag-thread             ESC t   tag/untag all messages in the current thread
9238             toggle-new                 N   toggle a message's 'new' flag
9239             toggle-write               %   toggle whether the mailbox will be rewritten
9240             undelete-message           u   undelete the current entry
9241             undelete-pattern           U   undelete messages matching a pattern
9242             undelete-subthread     ESC u   undelete all messages in subthread
9243             undelete-thread           ^U   undelete all messages in thread
9244             untag-pattern             ^T   untag messages matching a pattern
9245             view-attachments           v   show MIME attachments
9246
9247        _\b7_\b._\b5_\b._\b3  _\bp_\ba_\bg_\be_\br
9248
9249        The Mutt Next Generation E-Mail Client                                      176
9250
9251             bottom             not bound   jump to the bottom of the message
9252             bounce-message             b   remail a message to another user
9253             change-folder              c   open a different folder
9254             change-folder-readonly ESC c   open a different folder in read only mode
9255             check-traditional-pgp  ESC P   check for classic pgp
9256             copy-message               C   copy a message to a file/mailbox
9257             create-alias               a   create an alias from a message sender
9258             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9259             decode-save            ESC s   decode a message and save it to a file/mailbox
9260             delete-message             d   delete the current entry
9261             delete-subthread       ESC d   delete all messages in subthread
9262             delete-thread             ^D   delete all messages in thread
9263             display-address            @   display full address of sender
9264             display-toggle-weed        h   display message and toggle header weeding
9265             edit                       e   edit the current message
9266             edit-type                 ^E   edit the current message's Content-Type
9267             enter-command              :   enter a muttngrc command
9268             exit                       i   return to the main-menu
9269             extract-keys              ^K   extract PGP public keys
9270             flag-message               F   toggle a message's 'important' flag
9271             forget-passphrase         ^F   wipe PGP passphrase from memory
9272             forward-message            f   forward a message with comments
9273             group-reply                g   reply to all recipients
9274             half-up            not bound   move up one-half page
9275             half-down          not bound   move down one-half page
9276             help                       ?   this screen
9277             list-reply                 L   reply to specified mailing list
9278             mail                       m   compose a new mail message
9279             mail-key               ESC k   mail a PGP public key
9280             mark-as-new                N   toggle a message's 'new' flag
9281             next-line                RET   scroll down one line
9282             next-entry                 J   move to the next entry
9283             next-new                 TAB   jump to the next new message
9284             next-page                      move to the next page
9285             next-subthread         ESC n   jump to the next subthread
9286             next-thread               ^N   jump to the next thread
9287             next-undeleted             j   move to the next undeleted message
9288             next-unread        not bound   jump to the next unread message
9289             parent-message             P   jump to parent message in thread
9290             pipe-message               |   pipe message/attachment to a shell command
9291             previous-line      BackSpace   scroll up one line
9292             previous-entry             K   move to the previous entry
9293             previous-new       not bound   jump to the previous new message
9294             previous-page              -   move to the previous page
9295             previous-subthread     ESC p   jump to previous subthread
9296             previous-thread           ^P   jump to previous thread
9297             previous-undeleted         k   move to the last undelete message
9298             previous-unread    not bound   jump to the previous unread message
9299             print-message              p   print the current entry
9300             quit                       Q   save changes to mailbox and quit
9301             read-subthread         ESC r   mark the current subthread as read
9302             read-thread               ^R   mark the current thread as read
9303             recall-message             R   recall a postponed message
9304             redraw-screen             ^L   clear and redraw the screen
9305
9306        The Mutt Next Generation E-Mail Client                                      177
9307
9308             reply                      r   reply to a message
9309             save-message               s   save message/attachment to a file
9310             search                     /   search for a regular expression
9311             search-next                n   search for next match
9312             search-opposite    not bound   search for next match in opposite direction
9313             search-reverse         ESC /   search backwards for a regular expression
9314             search-toggle              \   toggle search pattern coloring
9315             shell-escape               !   invoke a command in a subshell
9316             show-version               V   show the Mutt-ng version number and date
9317             skip-quoted                S   skip beyond quoted text
9318             sync-mailbox               $   save changes to mailbox
9319             tag-message                t   tag a message
9320             toggle-quoted              T   toggle display of quoted text
9321             top                        ^   jump to the top of the message
9322             undelete-message           u   undelete the current entry
9323             undelete-subthread     ESC u   undelete all messages in subthread
9324             undelete-thread           ^U   undelete all messages in thread
9325             view-attachments           v   show MIME attachments
9326
9327        _\b7_\b._\b5_\b._\b4  _\ba_\bl_\bi_\ba_\bs
9328
9329             search                     /   search for a regular expression
9330             search-next                n   search for next match
9331             search-reverse         ESC /   search backwards for a regular expression
9332
9333        _\b7_\b._\b5_\b._\b5  _\bq_\bu_\be_\br_\by
9334
9335             create-alias               a   create an alias from a message sender
9336             mail                       m   compose a new mail message
9337             query                      Q   query external program for addresses
9338             query-append               A   append new query results to current results
9339             search                     /   search for a regular expression
9340             search-next                n   search for next match
9341             search-opposite    not bound   search for next match in opposite direction
9342             search-reverse         ESC /   search backwards for a regular expression
9343
9344        _\b7_\b._\b5_\b._\b6  _\ba_\bt_\bt_\ba_\bc_\bh
9345
9346        The Mutt Next Generation E-Mail Client                                      178
9347
9348             bounce-message             b   remail a message to another user
9349             collapse-parts             v   toggle display of subparts
9350             delete-entry               d   delete the current entry
9351             display-toggle-weed        h   display message and toggle header weeding
9352             edit-type                 ^E   edit the current entry's Content-Type
9353             extract-keys              ^K   extract PGP public keys
9354             forward-message            f   forward a message with comments
9355             group-reply                g   reply to all recipients
9356             list-reply                 L   reply to specified mailing list
9357             pipe-entry                 |   pipe message/attachment to a shell command
9358             print-entry                p   print the current entry
9359             reply                      r   reply to a message
9360             resend-message         ESC e   resend message and preserve MIME structure
9361             save-entry                 s   save message/attachment to a file
9362             undelete-entry             u   undelete the current entry
9363             view-attach              RET   view attachment using mailcap entry if necessary
9364             view-mailcap               m   force viewing of attachment using mailcap
9365             view-text                  T   view attachment as text
9366
9367        _\b7_\b._\b5_\b._\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be
9368
9369        The Mutt Next Generation E-Mail Client                                      179
9370
9371             attach-file                a   attach a file(s) to this message
9372             attach-message             A   attach message(s) to this message
9373             attach-key             ESC k   attach a PGP public key
9374             copy-file                  C   save message/attachment to a file
9375             detach-file                D   delete the current entry
9376             display-toggle-weed        h   display message and toggle header weeding
9377             edit-bcc                   b   edit the BCC list
9378             edit-cc                    c   edit the CC list
9379             edit-description           d   edit attachment description
9380             edit-encoding             ^E   edit attachment transfer-encoding
9381             edit-fcc                   f   enter a file to save a copy of this message in
9382             edit-from              ESC f   edit the from: field
9383             edit-file               ^X e   edit the file to be attached
9384             edit-headers               E   edit the message with headers
9385             edit                       e   edit the message
9386             edit-mime                  m   edit attachment using mailcap entry
9387             edit-reply-to              r   edit the Reply-To field
9388             edit-subject               s   edit the subject of this message
9389             edit-to                    t   edit the TO list
9390             edit-type                 ^T   edit attachment type
9391             filter-entry               F   filter attachment through a shell command
9392             forget-passphrase         ^F   wipe PGP passphrase from memory
9393             ispell                     i   run ispell on the message
9394             new-mime                   n   compose new attachment using mailcap entry
9395             pgp-menu                   p   show PGP options
9396             pipe-entry                 |   pipe message/attachment to a shell command
9397             postpone-message           P   save this message to send later
9398             print-entry                l   print the current entry
9399             rename-file                R   rename/move an attached file
9400             send-message               y   send the message
9401             toggle-unlink              u   toggle whether to delete file after sending it
9402             view-attach              RET   view attachment using mailcap entry if necessary
9403             write-fcc         w   write the message to a folder
9404
9405        _\b7_\b._\b5_\b._\b8  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
9406
9407             delete-entry               d   delete the current entry
9408             undelete-entry             u   undelete the current entry
9409
9410        _\b7_\b._\b5_\b._\b9  _\bb_\br_\bo_\bw_\bs_\be_\br
9411
9412        The Mutt Next Generation E-Mail Client                                      180
9413
9414             change-dir                 c   change directories
9415             check-new                TAB   check mailboxes for new mail
9416             enter-mask                 m   enter a file mask
9417             search                     /   search for a regular expression
9418             search-next                n   search for next match
9419             search-reverse         ESC /   search backwards for a regular expression
9420             select-new                 N   select a new file in this directory
9421             sort                       o   sort messages
9422             sort-reverse               O   sort messages in reverse order
9423             toggle-mailboxes         TAB   toggle whether to browse mailboxes or all files
9424             view-file              SPACE   view file
9425             subscribe                  s   subscribe to current mailbox (IMAP Only)
9426             unsubscribe                u   unsubscribe to current mailbox (IMAP Only)
9427             toggle-subscribed          T   toggle view all/subscribed mailboxes (IMAP Only)
9428
9429        _\b7_\b._\b5_\b._\b1_\b0  _\bp_\bg_\bp
9430
9431             view-name                  %   view the key's user id
9432             verify-key                 c   verify a PGP public key
9433
9434        _\b7_\b._\b5_\b._\b1_\b1  _\be_\bd_\bi_\bt_\bo_\br
9435
9436             backspace          BackSpace   delete the char in front of the cursor
9437             backward-char             ^B   move the cursor one character to the left
9438             backward-word          ESC b   move the cursor to the previous word
9439             bol                       ^A   jump to the beginning of the line
9440             buffy-cycle            Space   cycle among incoming mailboxes
9441             capitalize-word        ESC c   uppercase the first character in the word
9442             complete                 TAB   complete filename or alias
9443             complete-query            ^T   complete address with query
9444             delete-char               ^D   delete the char under the cursor
9445             downcase-word          ESC l   lowercase all characters in current word
9446             eol                       ^E   jump to the end of the line
9447             forward-char              ^F   move the cursor one character to the right
9448             forward-word           ESC f   move the cursor to the next word
9449             history-down       not bound   scroll down through the history list
9450             history-up         not bound   scroll up through the history list
9451             kill-eol                  ^K   delete chars from cursor to end of line
9452             kill-eow               ESC d   delete chars from cursor to end of word
9453             kill-line                 ^U   delete all chars on the line
9454             kill-word                 ^W   delete the word in front of the cursor
9455             quote-char                ^V   quote the next typed key
9456             transpose-chars    not bound   transpose character under cursor with previous
9457             upcase-word            ESC u   uppercase all characters in current word
9458
9459        _\b8_\b.  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\by
9460
9461        The Mutt Next Generation E-Mail Client                                      181
9462
9463        _\b8_\b._\b1  _\bA_\bc_\bk_\bn_\bo_\bw_\bl_\be_\bd_\bg_\bm_\be_\bn_\bt_\bs
9464
9465        Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
9466        back in the ELM-ME days.
9467
9468        The following people have been very helpful to the development of Mutt:
9469
9470        Vikas Agnihotri <vikasa@writeme.com>,
9471
9472        Francois Berjon <Francois.Berjon@aar.alcatel-alsthom.fr>,
9473
9474        Aric Blumer <aric@fore.com>,
9475
9476        John Capo <jc@irbs.com>,
9477
9478        David Champion <dgc@uchicago.edu,
9479
9480        Brendan Cully <brendan@kublai.com>,
9481
9482        Liviu Daia <daia@stoilow.imar.ro>,
9483
9484        Thomas E. Dickey <dickey@herndon4.his.com>,
9485
9486        David DeSimone <fox@convex.hp.com>,
9487
9488        Nickolay N. Dudorov <nnd@wint.itfs.nsk.su>,
9489
9490        Ruslan Ermilov <ru@freebsd.org>,
9491
9492        Edmund Grimley Evans <edmundo@rano.org,
9493
9494        Michael Finken <finken@conware.de>,
9495
9496        Sven Guckes <guckes@math.fu-berlin.de>,
9497
9498        Lars Hecking <lhecking@nmrc.ie>,
9499
9500        Mark Holloman <holloman@nando.net>,
9501
9502        Andreas Holzmann <holzmann@fmi.uni-passau.de>,
9503
9504        Marco d'Itri <md@linux.it>,
9505
9506        Bjrn Jacke <bjacke@suse.com>,
9507
9508        Byrial Jensen <byrial@image.dk>,
9509
9510        David Jeske <jeske@igcom.net>,
9511
9512        Christophe Kalt <kalt@hugo.int-evry.fr>,
9513
9514        Tommi Komulainen <Tommi.Komulainen@iki.fi>,
9515
9516        Felix von Leitner (a.k.a ``Fefe'') <leitner@math.fu-berlin.de>,
9517
9518        The Mutt Next Generation E-Mail Client                                      182
9519
9520        Brandon Long <blong@fiction.net>,
9521
9522        Jimmy Mkel <jmy@flashback.net>,
9523
9524        Lars Marowsky-Bree <lmb@pointer.in-minden.de>,
9525
9526        Thomas ``Mike'' Michlmayr <mike@cosy.sbg.ac.at>,
9527
9528        Andrew W. Nosenko <awn@bcs.zp.ua>,
9529
9530        David O'Brien <obrien@Nuxi.cs.ucdavis.edu>,
9531
9532        Clint Olsen <olsenc@ichips.intel.com>,
9533
9534        Park Myeong Seok <pms@romance.kaist.ac.kr>,
9535
9536        Thomas Parmelan <tom@ankh.fr.eu.org>,
9537
9538        Ollivier Robert <roberto@keltia.freenix.fr>,
9539
9540        Thomas Roessler <roessler@does-not-exist.org>,
9541
9542        Roland Rosenfeld <roland@spinnaker.de>,
9543
9544        TAKIZAWA Takashi <taki@luna.email.ne.jp>,
9545
9546        Allain Thivillon <Allain.Thivillon@alma.fr>,
9547
9548        Gero Treuner <gero@faveve.uni-stuttgart.de>,
9549
9550        Vsevolod Volkov <vvv@lucky.net>,
9551
9552        Ken Weinert <kenw@ihs.com>
9553
9554        Mutt-ng is developed by the following people:
9555
9556        Andreas Krennmair <ak@synflood.at>
9557
9558        Nico Golde <nico@ngolde.de>
9559
9560        Rocco Rutte <pdmef@cs.tu-berlin.de>
9561
9562        The following people have been very helpful to the development of  Mutt-ng:
9563
9564        Christian Gall <cg@cgall.de>
9565
9566        Iain Lea <iain@bricbrac.de>
9567
9568        Andreas Kneib <akneib@gmx.net>
9569
9570        Carsten Schoelzki <cjs@weisshuhn.de>
9571
9572        Elimar Riesebieter <riesebie@lxtec.de>
9573
9574        The Mutt Next Generation E-Mail Client                                      183
9575
9576        _\b8_\b._\b2  _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt
9577
9578        This document was written in SGML, and then rendered using the sgml-tools pack-
9579        age.
9580
9581        The Mutt Next Generation E-Mail Client                                      184
9582
9583                                           CONTENTS
9584
9585        1.  Introduction   .......................................................... 1
9586            1.1   Overview   ........................................................ 1
9587            1.2   Mutt-ng Home Page   ............................................... 1
9588            1.3   Mailing Lists   ................................................... 1
9589            1.4   Software Distribution Sites   ..................................... 2
9590            1.5   IRC   ............................................................. 2
9591            1.6   Weblog   .......................................................... 2
9592            1.7   Copyright   ....................................................... 2
9593
9594        2.  Getting Started     ..................................................... 2
9595            2.1   Basic Concepts       .............................................. 2
9596                  2.1.1    Screens and Menus           3
9597                  2.1.2    Configuration           3
9598                  2.1.3    Functions           3
9599                  2.1.4    Interaction           4
9600                  2.1.5    Modularization           4
9601                  2.1.6    Patterns           4
9602            2.2   Screens and Menus       ........................................... 4
9603                  2.2.1    Index          4
9604                  2.2.2    Pager          5
9605                  2.2.3    File Browser           5
9606                  2.2.4    Sidebar           5
9607                  2.2.5    Help           5
9608                  2.2.6    Compose Menu             6
9609                  2.2.7    Alias Menu             6
9610                  2.2.8    Attachment Menu             6
9611                  2.2.9    Key Menu             6
9612            2.3   Moving Around in Menus   .......................................... 6
9613            2.4   Editing Input Fields   ............................................ 7
9614            2.5   Reading Mail - The Index and Pager   .............................. 8
9615                  2.5.1    The Message Index   8
9616                  2.5.2    The Pager   9
9617                  2.5.3    Threaded Mode   11
9618                  2.5.4    Miscellaneous Functions   11
9619            2.6   Sending Mail   ................................................... 14
9620                  2.6.1    Composing new messages     14
9621                  2.6.2    Replying         16
9622                  2.6.3    Editing the message header     17
9623                  2.6.4    Using Mutt-ng with PGP     18
9624                  2.6.5    Sending anonymous messages via mixmaster     19
9625            2.7   Forwarding and Bouncing Mail   ................................... 19
9626            2.8   Postponing Mail   ................................................ 20
9627
9628        3.  Configuration   ........................................................ 21
9629            3.1   Locations of Configuration Files   ............................... 21
9630            3.2   Syntax of Initialization Files   ................................. 21
9631            3.3   Defining/Using aliases   ......................................... 23
9632            3.4   Changing the default key bindings   .............................. 24
9633            3.5   Defining aliases for character sets    ........................... 26
9634
9635                                               i
9636
9637            3.6   Setting variables based upon mailbox   ........................... 26
9638            3.7   Keyboard macros   ................................................ 27
9639            3.8   Using color and mono video attributes   .......................... 28
9640            3.9   Ignoring (weeding) unwanted message headers   .................... 30
9641            3.10  Alternative addresses   .......................................... 31
9642            3.11  Format = Flowed     .............................................. 31
9643                  3.11.1   Introduction         31
9644                  3.11.2   Receiving: Display Setup         31
9645                  3.11.3   Sending         32
9646                  3.11.4   Additional Notes    33
9647            3.12  Mailing lists   .................................................. 33
9648            3.13  Using Multiple spool mailboxes   ................................. 34
9649            3.14  Defining mailboxes which receive mail   .......................... 34
9650            3.15  User defined headers   ........................................... 35
9651            3.16  Defining the order of headers when viewing messages   ............ 36
9652            3.17  Specify default save filename   .................................. 36
9653            3.18  Specify default Fcc: mailbox when composing   .................... 36
9654            3.19  Specify default save filename and default Fcc: mailbox at once   . 37
9655            3.20  Change settings based upon message recipients   .................. 37
9656            3.21  Change settings before formatting a message   .................... 38
9657            3.22  Choosing the cryptographic key of the recipient   ................ 38
9658            3.23  Adding key sequences to the keyboard buffer   .................... 38
9659            3.24  Executing functions   ............................................ 39
9660            3.25  Message Scoring   ................................................ 39
9661            3.26  Spam detection   ................................................. 40
9662            3.27  Setting variables   .............................................. 42
9663            3.28  Reading initialization commands from another file   .............. 43
9664            3.29  Removing hooks   ................................................. 43
9665            3.30  Sharing Setups       ............................................. 43
9666                  3.30.1   Character Sets         43
9667                  3.30.2   Modularization           44
9668                  3.30.3   Conditional parts         44
9669            3.31  Obsolete Variables   ............................................. 46
9670
9671        4.  Advanced Usage   ....................................................... 46
9672            4.1   Regular Expressions   ............................................ 46
9673            4.2   Patterns   ....................................................... 49
9674                  4.2.1    Complex Patterns    49
9675                  4.2.2    Patterns and Dates    50
9676            4.3   Format Strings       ............................................. 50
9677                  4.3.1    Introduction           50
9678                  4.3.2    Conditional Expansion           52
9679                  4.3.3    Modifications and Padding           53
9680            4.4   Using Tags   ..................................................... 53
9681            4.5   Using Hooks   .................................................... 54
9682                  4.5.1    Message Matching in Hooks   55
9683            4.6   Using the sidebar   .............................................. 55
9684            4.7   External Address Queries   ....................................... 56
9685            4.8   Mailbox Formats   ................................................ 57
9686            4.9   Mailbox Shortcuts   .............................................. 58
9687            4.10  Handling Mailing Lists   ......................................... 58
9688            4.11  Editing threads   ................................................ 59
9689                  4.11.1   Linking threads   60
9690
9691                                               ii
9692
9693                  4.11.2   Breaking threads   60
9694            4.12  Delivery Status Notification (DSN) Support   ..................... 60
9695            4.13  POP3 Support (OPTIONAL)   ........................................ 60
9696            4.14  IMAP Support (OPTIONAL)   ........................................ 61
9697                  4.14.1   The Folder Browser   62
9698                  4.14.2   Authentication   62
9699            4.15  NNTP Support (OPTIONAL)   ........................................ 63
9700                  4.15.1   Again: Scoring       63
9701            4.16  SMTP Support (OPTIONAL)   ........................................ 64
9702            4.17  Managing multiple IMAP/POP/NNTP accounts (OPTIONAL)   ............ 65
9703            4.18  Start a WWW Browser on URLs (EXTERNAL)   ......................... 65
9704            4.19  Compressed folders Support (OPTIONAL)   .......................... 65
9705                  4.19.1   Open a compressed mailbox for reading   66
9706                  4.19.2   Write a compressed mailbox   66
9707                  4.19.3   Append a message to a compressed mailbox   67
9708                  4.19.4   Encrypted folders   68
9709
9710        5.  Mutt-ng's MIME Support   ............................................... 68
9711            5.1   Using MIME in Mutt   ............................................. 68
9712                  5.1.1    Viewing MIME messages in the pager   68
9713                  5.1.2    The Attachment Menu   69
9714                  5.1.3    The Compose Menu   69
9715            5.2   MIME Type configuration with mime.types   ........................ 69
9716            5.3   MIME Viewer configuration with mailcap   ......................... 70
9717                  5.3.1    The Basics of the mailcap file   71
9718                  5.3.2    Secure use of mailcap   72
9719                  5.3.3    Advanced mailcap Usage   72
9720                  5.3.4    Example mailcap files   75
9721            5.4   MIME Autoview   .................................................. 76
9722            5.5   MIME Multipart/Alternative   ..................................... 77
9723            5.6   MIME Lookup   .................................................... 77
9724
9725        6.  Security Considerations     ............................................ 78
9726            6.1   Passwords       .................................................. 78
9727            6.2   Temporary Files       ............................................ 78
9728            6.3   Information Leaks     ............................................ 78
9729                  6.3.1    Message-ID: headers         78
9730                  6.3.2    mailto:-style links         79
9731            6.4   External applications       ...................................... 79
9732                  6.4.1    mailcap           79
9733                  6.4.2    Other           80
9734
9735        7.  Reference   ............................................................ 80
9736            7.1   Command line options   ........................................... 80
9737            7.2   Patterns   ....................................................... 81
9738            7.3   Configuration Commands   ......................................... 83
9739            7.4   Configuration variables .......................................... 85
9740                  7.4.1    abort_noattach   86
9741                  7.4.2    abort_nosubject   87
9742                  7.4.3    abort_unmodified   87
9743                  7.4.4    alias_file   87
9744                  7.4.5    alias_format   87
9745                  7.4.6    allow_8bit   88
9746
9747                                              iii
9748
9749                  7.4.7    allow_ansi   88
9750                  7.4.8    arrow_cursor   88
9751                  7.4.9    ascii_chars   88
9752                  7.4.10   askbcc   89
9753                  7.4.11   askcc   89
9754                  7.4.12   assumed_charset   89
9755                  7.4.13   attach_format   89
9756                  7.4.14   attach_remind_regexp   90
9757                  7.4.15   attach_sep   90
9758                  7.4.16   attach_split   91
9759                  7.4.17   attribution   91
9760                  7.4.18   auto_tag   91
9761                  7.4.19   autoedit   91
9762                  7.4.20   beep   92
9763                  7.4.21   beep_new   92
9764                  7.4.22   bounce   92
9765                  7.4.23   bounce_delivered   92
9766                  7.4.24   braille_friendly   92
9767                  7.4.25   certificate_file   92
9768                  7.4.26   charset   93
9769                  7.4.27   check_new   93
9770                  7.4.28   collapse_unread   93
9771                  7.4.29   compose_format   93
9772                  7.4.30   config_charset   94
9773                  7.4.31   confirmappend   94
9774                  7.4.32   confirmcreate   94
9775                  7.4.33   connect_timeout   94
9776                  7.4.34   content_type   95
9777                  7.4.35   copy   95
9778                  7.4.36   crypt_autoencrypt   95
9779                  7.4.37   crypt_autopgp   95
9780                  7.4.38   crypt_autosign   95
9781                  7.4.39   crypt_autosmime   96
9782                  7.4.40   crypt_replyencrypt   96
9783                  7.4.41   crypt_replysign   96
9784                  7.4.42   crypt_replysignencrypted   96
9785                  7.4.43   crypt_timestamp   96
9786                  7.4.44   crypt_use_gpgme   97
9787                  7.4.45   crypt_verify_sig   97
9788                  7.4.46   date_format   97
9789                  7.4.47   default_hook   97
9790                  7.4.48   delete   98
9791                  7.4.49   delete_space   98
9792                  7.4.50   delete_untag   98
9793                  7.4.51   digest_collapse   98
9794                  7.4.52   display_filter   98
9795                  7.4.53   dotlock_program   99
9796                  7.4.54   dsn_notify   99
9797                  7.4.55   dsn_return   99
9798                  7.4.56   duplicate_threads   99
9799                  7.4.57   edit_headers   100
9800                  7.4.58   editor   100
9801                  7.4.59   encode_from   100
9802
9803                                               iv
9804
9805                  7.4.60   entropy_file   100
9806                  7.4.61   envelope_from   101
9807                  7.4.62   escape   101
9808                  7.4.63   fast_reply   101
9809                  7.4.64   fcc_attach   101
9810                  7.4.65   fcc_clear   101
9811                  7.4.66   file_charset   101
9812                  7.4.67   folder   102
9813                  7.4.68   folder_format   102
9814                  7.4.69   followup_to   103
9815                  7.4.70   force_buffy_check   103
9816                  7.4.71   force_name   103
9817                  7.4.72   forward_decode   104
9818                  7.4.73   forward_decrypt   104
9819                  7.4.74   forward_edit   104
9820                  7.4.75   forward_format   104
9821                  7.4.76   forward_quote   104
9822                  7.4.77   from   105
9823                  7.4.78   gecos_mask   105
9824                  7.4.79   hdrs   105
9825                  7.4.80   header   105
9826                  7.4.81   header_cache   106
9827                  7.4.82   header_cache_compress   106
9828                  7.4.83   help   106
9829                  7.4.84   hidden_host   106
9830                  7.4.85   hide_limited   107
9831                  7.4.86   hide_missing   107
9832                  7.4.87   hide_thread_subject   107
9833                  7.4.88   hide_top_limited   107
9834                  7.4.89   hide_top_missing   107
9835                  7.4.90   history   107
9836                  7.4.91   honor_followup_to   108
9837                  7.4.92   hostname   108
9838                  7.4.93   ignore_list_reply_to   108
9839                  7.4.94   imap_authenticators   108
9840                  7.4.95   imap_check_subscribed   109
9841                  7.4.96   imap_delim_chars   109
9842                  7.4.97   imap_headers   109
9843                  7.4.98   imap_home_namespace   109
9844                  7.4.99   imap_keepalive   110
9845                  7.4.100  imap_list_subscribed   110
9846                  7.4.101  imap_login   110
9847                  7.4.102  imap_mail_check   110
9848                  7.4.103  imap_pass   111
9849                  7.4.104  imap_passive   111
9850                  7.4.105  imap_peek   111
9851                  7.4.106  imap_reconnect   111
9852                  7.4.107  imap_servernoise   112
9853                  7.4.108  imap_user   112
9854                  7.4.109  implicit_autoview   112
9855                  7.4.110  include   112
9856                  7.4.111  include_onlyfirst   112
9857                  7.4.112  indent_string   113
9858
9859                                               v
9860
9861                  7.4.113  index_format   113
9862                  7.4.114  ispell   115
9863                  7.4.115  keep_flagged   116
9864                  7.4.116  list_reply   116
9865                  7.4.117  locale   116
9866                  7.4.118  mail_check   116
9867                  7.4.119  mailcap_path   116
9868                  7.4.120  mailcap_sanitize   117
9869                  7.4.121  maildir_header_cache_verify   117
9870                  7.4.122  maildir_trash   117
9871                  7.4.123  mark_old   117
9872                  7.4.124  markers   118
9873                  7.4.125  mask   118
9874                  7.4.126  max_display_recips   118
9875                  7.4.127  max_line_length   118
9876                  7.4.128  mbox   118
9877                  7.4.129  mbox_type   118
9878                  7.4.130  menu_context   119
9879                  7.4.131  menu_move_off   119
9880                  7.4.132  menu_scroll   119
9881                  7.4.133  message_format   119
9882                  7.4.134  meta_key   119
9883                  7.4.135  metoo   120
9884                  7.4.136  mh_purge   120
9885                  7.4.137  mh_seq_flagged   120
9886                  7.4.138  mh_seq_replied   120
9887                  7.4.139  mh_seq_unseen   120
9888                  7.4.140  mime_forward   120
9889                  7.4.141  mime_forward_decode   121
9890                  7.4.142  mime_forward_rest   121
9891                  7.4.143  mix_entry_format   121
9892                  7.4.144  mixmaster   122
9893                  7.4.145  move   122
9894                  7.4.146  msgid_format   122
9895                  7.4.147  narrow_tree   123
9896                  7.4.148  nntp_ask_followup_to   123
9897                  7.4.149  nntp_ask_x_comment_to   123
9898                  7.4.150  nntp_cache_dir   124
9899                  7.4.151  nntp_catchup   124
9900                  7.4.152  nntp_context   124
9901                  7.4.153  nntp_followup_to_poster   124
9902                  7.4.154  nntp_group_index_format   125
9903                  7.4.155  nntp_host   125
9904                  7.4.156  nntp_inews   125
9905                  7.4.157  nntp_load_description   126
9906                  7.4.158  nntp_mail_check   126
9907                  7.4.159  nntp_mime_subject   126
9908                  7.4.160  nntp_newsrc   126
9909                  7.4.161  nntp_pass   127
9910                  7.4.162  nntp_post_moderated   127
9911                  7.4.163  nntp_reconnect   127
9912                  7.4.164  nntp_save_unsubscribed   127
9913                  7.4.165  nntp_show_new_news   128
9914
9915                                               vi
9916
9917                  7.4.166  nntp_show_only_unread   128
9918                  7.4.167  nntp_user   128
9919                  7.4.168  nntp_x_comment_to   128
9920                  7.4.169  operating_system   128
9921                  7.4.170  pager   129
9922                  7.4.171  pager_context   129
9923                  7.4.172  pager_format   129
9924                  7.4.173  pager_index_lines   129
9925                  7.4.174  pager_stop   130
9926                  7.4.175  pgp_auto_decode   130
9927                  7.4.176  pgp_autoinline   130
9928                  7.4.177  pgp_check_exit   130
9929                  7.4.178  pgp_clearsign_command   131
9930                  7.4.179  pgp_decode_command   131
9931                  7.4.180  pgp_decrypt_command   131
9932                  7.4.181  pgp_encrypt_only_command   132
9933                  7.4.182  pgp_encrypt_sign_command   132
9934                  7.4.183  pgp_entry_format   132
9935                  7.4.184  pgp_export_command   133
9936                  7.4.185  pgp_getkeys_command   133
9937                  7.4.186  pgp_good_sign   133
9938                  7.4.187  pgp_ignore_subkeys   133
9939                  7.4.188  pgp_import_command   133
9940                  7.4.189  pgp_list_pubring_command   133
9941                  7.4.190  pgp_list_secring_command   134
9942                  7.4.191  pgp_long_ids   134
9943                  7.4.192  pgp_mime_auto   134
9944                  7.4.193  pgp_replyinline   134
9945                  7.4.194  pgp_retainable_sigs   135
9946                  7.4.195  pgp_show_unusable   135
9947                  7.4.196  pgp_sign_as   135
9948                  7.4.197  pgp_sign_command   135
9949                  7.4.198  pgp_sort_keys   135
9950                  7.4.199  pgp_strict_enc   136
9951                  7.4.200  pgp_timeout   136
9952                  7.4.201  pgp_use_gpg_agent   136
9953                  7.4.202  pgp_verify_command   136
9954                  7.4.203  pgp_verify_key_command   137
9955                  7.4.204  pipe_decode   137
9956                  7.4.205  pipe_sep   137
9957                  7.4.206  pipe_split   137
9958                  7.4.207  pop_auth_try_all   137
9959                  7.4.208  pop_authenticators   138
9960                  7.4.209  pop_delete   138
9961                  7.4.210  pop_host   138
9962                  7.4.211  pop_last   138
9963                  7.4.212  pop_mail_check   139
9964                  7.4.213  pop_pass   139
9965                  7.4.214  pop_reconnect   139
9966                  7.4.215  pop_user   139
9967                  7.4.216  post_indent_string   139
9968                  7.4.217  postpone   140
9969                  7.4.218  postponed   140
9970
9971                                              vii
9972
9973                  7.4.219  preconnect   140
9974                  7.4.220  print   140
9975                  7.4.221  print_command   141
9976                  7.4.222  print_decode   141
9977                  7.4.223  print_split   141
9978                  7.4.224  prompt_after   141
9979                  7.4.225  query_command   141
9980                  7.4.226  quit   142
9981                  7.4.227  quote_empty   142
9982                  7.4.228  quote_quoted   142
9983                  7.4.229  quote_regexp   142
9984                  7.4.230  read_inc   142
9985                  7.4.231  read_only   143
9986                  7.4.232  realname   143
9987                  7.4.233  recall   143
9988                  7.4.234  record   143
9989                  7.4.235  reply_regexp   144
9990                  7.4.236  reply_self   144
9991                  7.4.237  reply_to   144
9992                  7.4.238  resolve   144
9993                  7.4.239  reverse_alias   144
9994                  7.4.240  reverse_name   145
9995                  7.4.241  reverse_realname   145
9996                  7.4.242  rfc2047_parameters   145
9997                  7.4.243  save_address   146
9998                  7.4.244  save_empty   146
9999                  7.4.245  save_name   146
10000                  7.4.246  score   146
10001                  7.4.247  score_threshold_delete   147
10002                  7.4.248  score_threshold_flag   147
10003                  7.4.249  score_threshold_read   147
10004                  7.4.250  send_charset   147
10005                  7.4.251  sendmail   147
10006                  7.4.252  sendmail_wait   148
10007                  7.4.253  shell   148
10008                  7.4.254  sidebar_boundary   148
10009                  7.4.255  sidebar_delim   148
10010                  7.4.256  sidebar_newmail_only   149
10011                  7.4.257  sidebar_number_format   149
10012                  7.4.258  sidebar_shorten_hierarchy   149
10013                  7.4.259  sidebar_visible   150
10014                  7.4.260  sidebar_width   150
10015                  7.4.261  sig_dashes   150
10016                  7.4.262  sig_on_top   150
10017                  7.4.263  signature   150
10018                  7.4.264  signoff_string   151
10019                  7.4.265  simple_search   151
10020                  7.4.266  sleep_time   151
10021                  7.4.267  smart_wrap   151
10022                  7.4.268  smileys   152
10023                  7.4.269  smime_ask_cert_label   152
10024                  7.4.270  smime_ca_location   152
10025                  7.4.271  smime_certificates   152
10026
10027                                              viii
10028
10029                  7.4.272  smime_decrypt_command   152
10030                  7.4.273  smime_decrypt_use_default_key   153
10031                  7.4.274  smime_default_key   153
10032                  7.4.275  smime_encrypt_command   153
10033                  7.4.276  smime_encrypt_with   154
10034                  7.4.277  smime_get_cert_command   154
10035                  7.4.278  smime_get_cert_email_command   154
10036                  7.4.279  smime_get_signer_cert_command   154
10037                  7.4.280  smime_import_cert_command   154
10038                  7.4.281  smime_is_default   154
10039                  7.4.282  smime_keys   155
10040                  7.4.283  smime_pk7out_command   155
10041                  7.4.284  smime_sign_command   155
10042                  7.4.285  smime_sign_opaque_command   155
10043                  7.4.286  smime_timeout   156
10044                  7.4.287  smime_verify_command   156
10045                  7.4.288  smime_verify_opaque_command   156
10046                  7.4.289  smtp_envelope   156
10047                  7.4.290  smtp_host   156
10048                  7.4.291  smtp_pass   157
10049                  7.4.292  smtp_port   157
10050                  7.4.293  smtp_use_tls   157
10051                  7.4.294  smtp_user   157
10052                  7.4.295  sort   158
10053                  7.4.296  sort_alias   158
10054                  7.4.297  sort_aux   158
10055                  7.4.298  sort_browser   159
10056                  7.4.299  sort_re   159
10057                  7.4.300  spam_separator   159
10058                  7.4.301  spoolfile   160
10059                  7.4.302  ssl_ca_certificates_file   160
10060                  7.4.303  ssl_client_cert   160
10061                  7.4.304  ssl_force_tls   160
10062                  7.4.305  ssl_min_dh_prime_bits   160
10063                  7.4.306  ssl_starttls   161
10064                  7.4.307  ssl_use_sslv2   161
10065                  7.4.308  ssl_use_sslv3   161
10066                  7.4.309  ssl_use_tlsv1   161
10067                  7.4.310  ssl_usesystemcerts   161
10068                  7.4.311  status_chars   162
10069                  7.4.312  status_format   162
10070                  7.4.313  status_on_top   164
10071                  7.4.314  strict_mailto   164
10072                  7.4.315  strict_mime   165
10073                  7.4.316  strict_threads   165
10074                  7.4.317  strip_was   165
10075                  7.4.318  strip_was_regex   165
10076                  7.4.319  stuff_quoted   166
10077                  7.4.320  suspend   166
10078                  7.4.321  text_flowed   166
10079                  7.4.322  thorough_search   166
10080                  7.4.323  thread_received   166
10081                  7.4.324  tilde   167
10082
10083                                               ix
10084
10085                  7.4.325  timeout   167
10086                  7.4.326  tmpdir   167
10087                  7.4.327  to_chars   167
10088                  7.4.328  trash   167
10089                  7.4.329  tunnel   168
10090                  7.4.330  umask   168
10091                  7.4.331  uncollapse_jump   168
10092                  7.4.332  use_8bitmime   168
10093                  7.4.333  use_domain   168
10094                  7.4.334  use_from   169
10095                  7.4.335  use_idn   169
10096                  7.4.336  use_ipv6   169
10097                  7.4.337  user_agent   169
10098                  7.4.338  visual   169
10099                  7.4.339  wait_key   170
10100                  7.4.340  weed   170
10101                  7.4.341  wrap_search   170
10102                  7.4.342  wrapmargin   170
10103                  7.4.343  write_bcc   170
10104                  7.4.344  write_inc   171
10105                  7.4.345  xterm_icon   171
10106                  7.4.346  xterm_leave   171
10107                  7.4.347  xterm_set_titles   171
10108                  7.4.348  xterm_title   171
10109            7.5   Functions ....................................................... 172
10110                  7.5.1    generic   172
10111                  7.5.2    index   173
10112                  7.5.3    pager   175
10113                  7.5.4    alias   177
10114                  7.5.5    query   177
10115                  7.5.6    attach   177
10116                  7.5.7    compose   178
10117                  7.5.8    postpone   179
10118                  7.5.9    browser   179
10119                  7.5.10   pgp   180
10120                  7.5.11   editor   180
10121
10122        8.  Miscellany ............................................................ 180
10123            8.1   Acknowledgments ................................................. 181
10124            8.2   About this document ............................................. 183
10125
10126                                               x
10127