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.323  , page 165) 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 27) 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 75) 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.291  , page 155) 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.110  , page 111).  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.110  , page 111) 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.312  , page 163).
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.3  , page 86) 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.3  , page 86) does not
536        add the aliases specified there-in, you must also _\bs_\bo_\bu_\br_\bc_\be (section 3.28  , page
537        42) 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 67), 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 68).  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 32) 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.88  , page 106) 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.201  , page 135), _\b$_\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
617        (section 7.4.203  , page 135), _\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp (section 7.4.202  , page 135) and
618        _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.335  , page 167) 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.336  , page 168) 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.335  , page 167) 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.226  , page 140) 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.308  , page 160) 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.54  , page 98).
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.193  , page 133) 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.180  , page 130)) 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.140  ,
951        page 119)).  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.215  , page 138) 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.214  , page 138) 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 79) 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 82) 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        82).  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        The commands understood by mutt are explained in the next paragraphs.  For a
1123        complete list, see the _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.3  , page 82).
1124
1125        _\b3_\b._\b3  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg_\b/_\bU_\bs_\bi_\bn_\bg _\ba_\bl_\bi_\ba_\bs_\be_\bs
1126
1127        Usage: alias _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
1128
1129        It's usually very cumbersome to remember or type out the address of someone you
1130        are communicating with.  Mutt-ng allows you to create ``aliases'' which map a
1131        short string to a full address.
1132
1133        N\bNo\bot\bte\be:\b: if you want to create an alias for a group (by specifying more than one
1134        address), you m\bmu\bus\bst\bt separate the addresses with a comma (``,'').
1135
1136        To remove an alias or aliases (``*'' means all aliases):
1137
1138        unalias [ * | _\bk_\be_\by _\b._\b._\b. ]
1139
1140             alias muttdude me@cs.hmc.edu (Michael Elkins)
1141             alias theguys manny, moe, jack
1142
1143        Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a spe-
1144        cial file.  The alias command can appear anywhere in a configuration file, as
1145        long as this file is _\bs_\bo_\bu_\br_\bc_\be_\bd (section 3.28  , page 42).  Consequently, you can
1146        have multiple alias files, or you can have all aliases defined in your muttrc.
1147
1148        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
1149        only one file, the one pointed to by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 7.4.3  , page 86)
1150        variable (which is ~/.muttrc by default). This file is not special either, in
1151        the sense that Mutt-ng will happily append aliases to any file, but in order
1152        for the new aliases to take effect you need to explicitly _\bs_\bo_\bu_\br_\bc_\be (section
1153        3.28  , page 42) this file too.
1154
1155        For example:
1156
1157        The Mutt Next Generation E-Mail Client                                       24
1158
1159             source /usr/local/share/Mutt-ng.aliases
1160             source ~/.mail_aliases
1161             set alias_file=~/.mail_aliases
1162
1163        To use aliases, you merely use the alias at any place in mutt where mutt
1164        prompts for addresses, such as the _\bT_\bo_\b: or _\bC_\bc_\b: prompt.  You can also enter
1165        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
1166        (section 7.4.54  , page 98) variable set.
1167
1168        In addition, at the various address prompts, you can use the tab character to
1169        expand a partial alias to the full alias.  If there are multiple matches, mutt
1170        will bring up a menu with the matching aliases.  In order to be presented with
1171        the full list of aliases, you must hit tab with out a partial alias, such as at
1172        the beginning of the prompt or after a comma denoting multiple addresses.
1173
1174        In the alias menu, you can select as many aliases as you want with the _\bs_\be_\bl_\be_\bc_\bt_\b-
1175        _\be_\bn_\bt_\br_\by key (default: RET), and use the _\be_\bx_\bi_\bt key (default: q) to return to the
1176        address prompt.
1177
1178        _\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
1179
1180        Usage: bind _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
1181
1182        This command allows you to change the default key bindings (operation invoked
1183        when pressing a key).
1184
1185        _\bm_\ba_\bp specifies in which menu the binding belongs.  Multiple maps may be speci-
1186        fied by separating them with commas (no additional whitespace is allowed). The
1187        currently defined maps are:
1188
1189              generic
1190                    This is not a real menu, but is used as a fallback for all of the
1191                    other menus except for the pager and editor modes.  If a key is not
1192                    defined in another menu, Mutt-ng will look for a binding to use in
1193                    this menu.  This allows you to bind a key to a certain function in
1194                    multiple menus instead of having multiple bind statements to accom-
1195                    plish the same task.
1196
1197              alias
1198                    The alias menu is the list of your personal aliases as defined in
1199                    your muttrc.  It is the mapping from a short alias name to the full
1200                    email address(es) of the recipient(s).
1201
1202              attach
1203                    The attachment menu is used to access the attachments on received
1204                    messages.
1205
1206              browser
1207                    The browser is used for both browsing the local directory
1208
1209        The Mutt Next Generation E-Mail Client                                       25
1210
1211                    structure, and for listing all of your incoming mailboxes.
1212
1213              editor
1214                    The editor is the line-based editor the user enters text data.
1215
1216              index
1217                    The index is the list of messages contained in a mailbox.
1218
1219              compose
1220                    The compose menu is the screen used when sending a new message.
1221
1222              pager
1223                    The pager is the mode used to display message/attachment data, and
1224                    help listings.
1225
1226              pgp
1227                    The pgp menu is used to select the OpenPGP keys used for encrypting
1228                    outgoing messages.
1229
1230              postpone
1231                    The postpone menu is similar to the index menu, except is used when
1232                    recalling a message the user was composing, but saved until later.
1233
1234        _\bk_\be_\by is the key (or key sequence) you wish to bind.  To specify a control char-
1235        acter, use the sequence _\b\_\bC_\bx, where _\bx is the letter of the control character
1236        (for example, to specify control-A use ``\Ca'').  Note that the case of _\bx as
1237        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
1238        alternative form is to specify the key as a three digit octal number prefixed
1239        with a ``\'' (for example _\b\_\b1_\b7_\b7 is equivalent to _\b\_\bc_\b?).
1240
1241        In addition, _\bk_\be_\by may consist of:
1242
1243        The Mutt Next Generation E-Mail Client                                       26
1244
1245             \t              tab
1246             <tab>           tab
1247             <backtab>       backtab / shift-tab
1248             \r              carriage return
1249             \n              newline
1250             \e              escape
1251             <esc>           escape
1252             <up>            up arrow
1253             <down>          down arrow
1254             <left>          left arrow
1255             <right>         right arrow
1256             <pageup>        Page Up
1257             <pagedown>      Page Down
1258             <backspace>     Backspace
1259             <delete>        Delete
1260             <insert>        Insert
1261             <enter>         Enter
1262             <return>        Return
1263             <home>          Home
1264             <end>           End
1265             <space>         Space bar
1266             <f1>            function key 1
1267             <f10>           function key 10
1268
1269        _\bk_\be_\by does not need to be enclosed in quotes unless it contains a space (`` '').
1270
1271        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn specifies which action to take when _\bk_\be_\by is pressed.  For a complete
1272        list of functions, see the _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 169).  The special
1273        function noop unbinds the specified key sequence.
1274
1275        _\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
1276
1277        Usage: charset-hook _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
1278
1279        Usage: iconv-hook _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
1280
1281        The charset-hook command defines an alias for a character set.  This is useful
1282        to properly display messages which are tagged with a character set name not
1283        known to mutt.
1284
1285        The iconv-hook command defines a system-specific name for a character set.
1286        This is helpful when your systems character conversion library insists on using
1287        strange, system-specific names for character sets.
1288
1289        _\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
1290
1291        Usage: folder-hook [!]_\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1292
1293        It is often desirable to change settings based on which mailbox you are
1294
1295        The Mutt Next Generation E-Mail Client                                       27
1296
1297        reading.  The folder-hook command provides a method by which you can execute
1298        any configuration command.  _\br_\be_\bg_\be_\bx_\bp is a regular expression specifying in which
1299        mailboxes to execute _\bc_\bo_\bm_\bm_\ba_\bn_\bd before loading.  If a mailbox matches multiple
1300        folder-hook's, they are executed in the order given in the muttrc.
1301
1302        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.297  , page
1303        157) at the beginning of the pattern, you must place it inside of double or
1304        single quotes in order to distinguish it from the logical _\bn_\bo_\bt operator for the
1305        expression.
1306
1307        Note that the settings are _\bn_\bo_\bt restored when you leave the mailbox.  For exam-
1308        ple, a command action to perform is to change the sorting method based upon the
1309        mailbox being read:
1310
1311             folder-hook mutt set sort=threads
1312
1313        However, the sorting method is not restored to its previous value when reading
1314        a different mailbox.  To specify a _\bd_\be_\bf_\ba_\bu_\bl_\bt command, use the pattern ``.'':
1315
1316             folder-hook . set sort=date-sent
1317
1318        _\b3_\b._\b7  _\bK_\be_\by_\bb_\bo_\ba_\br_\bd _\bm_\ba_\bc_\br_\bo_\bs
1319
1320        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 ]
1321
1322        Macros are useful when you would like a single key to perform a series of
1323        actions.  When you press _\bk_\be_\by in menu _\bm_\be_\bn_\bu, Mutt-ng will behave as if you had
1324        typed _\bs_\be_\bq_\bu_\be_\bn_\bc_\be.  So if you have a common sequence of commands you type, you can
1325        create a macro to execute those commands with a single key.
1326
1327        _\bm_\be_\bn_\bu is the _\bm_\ba_\bp (section 3.4  , page 24) which the macro will be bound.  Multi-
1328        ple maps may be specified by separating multiple menu arguments by commas.
1329        Whitespace may not be used in between the menu arguments and the commas sepa-
1330        rating them.
1331
1332        _\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
1333        3.4  , page 24).  There are some additions however.  The first is that control
1334        characters in _\bs_\be_\bq_\bu_\be_\bn_\bc_\be can also be specified as _\b^_\bx.  In order to get a caret
1335        (`^'') you need to use _\b^_\b^.  Secondly, to specify a certain key such as _\bu_\bp or to
1336        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
1337        _\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
1338        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
1339        7.5  , page 169).
1340
1341        The advantage with using function names directly is that the macros will work
1342        regardless of the current key bindings, so they are not dependent on the user
1343        having particular key definitions.  This makes them more robust and portable,
1344        and also facilitates defining of macros in files used by more than one user
1345
1346        The Mutt Next Generation E-Mail Client                                       28
1347
1348        (eg. the system Muttngrc).
1349
1350        Optionally you can specify a descriptive text after _\bs_\be_\bq_\bu_\be_\bn_\bc_\be, which is shown in
1351        the help screens.
1352
1353        N\bNo\bot\bte\be:\b: Macro definitions (if any) listed in the help screen(s), are silently
1354        truncated at the screen width, and are not wrapped.
1355
1356        _\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
1357
1358        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 ]
1359
1360        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
1361
1362        Usage: uncolor index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1363
1364        If your terminal supports color, you can spice up Mutt-ng by creating your own
1365        color scheme.  To define the color of an object (type of information), you must
1366        specify both a foreground color a\ban\bnd\bd a background color (it is not possible to
1367        only specify one or the other).
1368
1369        _\bo_\bb_\bj_\be_\bc_\bt can be one of:
1370
1371           +\bo attachment
1372
1373           +\bo body (match _\br_\be_\bg_\be_\bx_\bp in the body of messages)
1374
1375           +\bo bold (highlighting bold patterns in the body of messages)
1376
1377           +\bo error (error messages printed by Mutt-ng)
1378
1379           +\bo header (match _\br_\be_\bg_\be_\bx_\bp in the message header)
1380
1381           +\bo hdrdefault (default color of the message header in the pager)
1382
1383           +\bo index (match _\bp_\ba_\bt_\bt_\be_\br_\bn in the message index)
1384
1385           +\bo indicator (arrow or bar used to indicate the current item in a menu)
1386
1387           +\bo markers (the ``+'' markers at the beginning of wrapped lines in the pager)
1388
1389           +\bo message (informational messages)
1390
1391           +\bo normal
1392
1393           +\bo quoted (text matching _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.226  , page 140) in the
1394             body of a message)
1395
1396           +\bo quoted1, quoted2, ..., quotedN\bN (higher levels of quoting)
1397
1398           +\bo search (highlighting of words in the pager)
1399
1400        The Mutt Next Generation E-Mail Client                                       29
1401
1402           +\bo signature
1403
1404           +\bo status (mode lines used to display info about the mailbox or message)
1405
1406           +\bo tilde (the ``~'' used to pad blank lines in the pager)
1407
1408           +\bo tree (thread tree drawn in the message index and attachment menu)
1409
1410           +\bo underline (highlighting underlined patterns in the body of messages)
1411
1412        _\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:
1413
1414           +\bo white
1415
1416           +\bo black
1417
1418           +\bo green
1419
1420           +\bo magenta
1421
1422           +\bo blue
1423
1424           +\bo cyan
1425
1426           +\bo yellow
1427
1428           +\bo red
1429
1430           +\bo default
1431
1432           +\bo color_\bx
1433
1434        _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd can optionally be prefixed with the keyword bright to make the fore-
1435        ground color boldfaced (e.g., brightred).
1436
1437        If your terminal supports it, the special keyword _\bd_\be_\bf_\ba_\bu_\bl_\bt can be used as a
1438        transparent color.  The value _\bb_\br_\bi_\bg_\bh_\bt_\bd_\be_\bf_\ba_\bu_\bl_\bt is also valid.  If Mutt-ng is
1439        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-
1440        ment variable to the default colors of your terminal for this to work; for
1441        example (for Bourne-like shells):
1442
1443             set COLORFGBG="green;black"
1444             export COLORFGBG
1445
1446        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
1447        instead of _\bw_\bh_\bi_\bt_\be and _\by_\be_\bl_\bl_\bo_\bw when setting this variable.
1448
1449        N\bNo\bot\bte\be:\b: The uncolor command can be applied to the index object only.  It removes
1450        entries from the list. You m\bmu\bus\bst\bt specify the same pattern specified in the color
1451        command for it to be removed.  The pattern ``*'' is a special token which means
1452        to clear the color index list of all entries.
1453
1454        The Mutt Next Generation E-Mail Client                                       30
1455
1456        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
1457        number of colors supported by your terminal).  This is useful when you remap
1458        the colors for your display (for example by changing the color associated with
1459        _\bc_\bo_\bl_\bo_\br_\b2 for your xterm), since color names may then lose their normal meaning.
1460
1461        If your terminal does not support color, it is still possible change the video
1462        attributes through the use of the ``mono'' command:
1463
1464        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 ]
1465
1466        Usage: mono index _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be _\bp_\ba_\bt_\bt_\be_\br_\bn
1467
1468        Usage: unmono index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1469
1470        where _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be is one of the following:
1471
1472           +\bo none
1473
1474           +\bo bold
1475
1476           +\bo underline
1477
1478           +\bo reverse
1479
1480           +\bo standout
1481
1482        _\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
1483
1484        Usage: [un]ignore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1485
1486        Messages often have many header fields added by automatic processing systems,
1487        or which may not seem useful to display on the screen.  This command allows you
1488        to specify header fields which you don't normally want to see.
1489
1490        You do not need to specify the full header field name.  For example, ``ignore
1491        content-'' will ignore all header fields that begin with the pattern ``con-
1492        tent-''. ``ignore *'' will ignore all headers.
1493
1494        To remove a previously added token from the list, use the ``unignore'' command.
1495        The ``unignore'' command will make Mutt-ng display headers with the given pat-
1496        tern.  For example, if you do ``ignore x-'' it is possible to ``unignore x-
1497        mailer''.
1498
1499        ``unignore *'' will remove all tokens from the ignore list.
1500
1501        For example:
1502
1503             # Sven's draconian header weeding
1504             ignore *
1505             unignore from date subject to cc
1506             unignore organization organisation x-mailer: x-newsreader: x-mailing-list:
1507             unignore posted-to:
1508
1509        The Mutt Next Generation E-Mail Client                                       31
1510
1511        _\b3_\b._\b1_\b0  _\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be _\ba_\bd_\bd_\br_\be_\bs_\bs_\be_\bs
1512
1513        Usage: [un]alternates _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1514
1515        With various functions, mutt will treat messages differently, depending on
1516        whether you sent them or whether you received them from someone else.  For
1517        instance, when replying to a message that you sent to a different party, mutt
1518        will automatically suggest to send the response to the original message's
1519        recipients -- responding to yourself won't make much sense in many cases.  (See
1520        _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section 7.4.234  , page 142).)
1521
1522        Many users receive e-mail under a number of different addresses. To fully use
1523        mutt's features here, the program must be able to recognize what e-mail
1524        addresses you receive mail under. That's the purpose of the alternates command:
1525        It takes a list of regular expressions, each of which can identify an address
1526        under which you receive e-mail.
1527
1528        The unalternates command can be used to write exceptions to alternates pat-
1529        terns. If an address matches something in an alternates command, but you none-
1530        theless do not think it is from you, you can list a more precise pattern under
1531        an unalternates command.
1532
1533        To remove a regular expression from the alternates list, use the unalternates
1534        command with exactly the same _\br_\be_\bg_\be_\bx_\bp.  Likewise, if the _\br_\be_\bg_\be_\bx_\bp for a alternates
1535        command matches an entry on the unalternates list, that unalternates entry will
1536        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
1537        will be removed.
1538
1539        _\b3_\b._\b1_\b1  _\bF_\bo_\br_\bm_\ba_\bt _\b= _\bF_\bl_\bo_\bw_\be_\bd
1540
1541        Mutt-ng contains support for so-called format=flowed messages.  In the begin-
1542        ning of email, each message had a fixed line width, and it was enough for dis-
1543        playing them on fixed-size terminals. But times changed, and nowadays hardly
1544        anybody still uses fixed-size terminals: more people nowaydays use graphical
1545        user interfaces, with dynamically resizable windows. This led to the demand of
1546        a new email format that makes it possible for the email client to make the
1547        email look nice in a resizable window without breaking quoting levels and cre-
1548        ating an incompatible email format that can also be displayed nicely on old
1549        fixed-size terminals.
1550
1551        For introductory information on format=flowed messages, see
1552        <http://www.joeclark.org/ffaq.html>.
1553
1554        When you receive emails that are marked as format=flowed messages, and is for-
1555        matted correctly, mutt-ng will try to reformat the message to optimally fit on
1556        your terminal. If you want a fixed margin on the right side of your terminal,
1557        you can set the following:
1558
1559             set wrapmargin = 10
1560
1561        The Mutt Next Generation E-Mail Client                                       32
1562
1563        The code above makes the line break 10 columns before the right side of the
1564        terminal.
1565
1566        If your terminal is so wide that the lines are embarrassingly long, you can
1567        also set a maximum line length:
1568
1569             set max_line_length = 120
1570
1571        The example above will give you lines not longer than 120 characters.
1572
1573        When you view at format=flowed messages, you will often see the quoting hierar-
1574        chy like in the following example:
1575
1576             >Bill, can you please send last month's progress report to Mr.
1577             >Morgan? We also urgently need the cost estimation for the new
1578             >production server that we want to set up before our customer's
1579             >project will go live.
1580
1581        This obviously doesn't look very nice, and it makes it very hard to differenti-
1582        ate between text and quoting character. The solution is to configure mutt-ng to
1583        "stuff" the quoting:
1584
1585             set stuff_quoted
1586
1587        This will lead to a nicer result that is easier to read:
1588
1589             > Bill, can you please send last month's progress report to Mr.
1590             > Morgan? We also urgently need the cost estimation for the new
1591             > production server that we want to set up before our customer's
1592             > project will go live.
1593
1594        If you want mutt-ng to send emails with format=flowed set, you need to explic-
1595        itly set it:
1596
1597             set text_flowed
1598
1599        Additionally, you have to use an editor which supports writing format=flowed-
1600        conforming emails. For vim, this is done by adding w to the formatoptions (see
1601        :h formatoptions and :h fo-table) when writing emails.
1602
1603        _\b3_\b._\b1_\b2  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bl_\bi_\bs_\bt_\bs
1604
1605        The Mutt Next Generation E-Mail Client                                       33
1606
1607        Usage: [un]lists _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1608
1609        Usage: [un]subscribe _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1610
1611        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  ,
1612        page 57).  In order to take advantage of them, you must specify which addresses
1613        belong to mailing lists, and which mailing lists you are subscribed to.  Once
1614        you have done this, the _\bl_\bi_\bs_\bt_\b-_\br_\be_\bp_\bl_\by (section 2.5.4  , page 12) function will
1615        work for all known lists.  Additionally, when you send a message to a sub-
1616        scribed list, mutt will add a Mail-Followup-To header to tell other users' mail
1617        user agents not to send copies of replies to your personal address.   Note that
1618        the Mail-Followup-To header is a non-standard extension which is not supported
1619        by all mail user agents.  Adding it is not bullet-proof against receiving per-
1620        sonal CCs of list messages.  Also note that the generation of the Mail-Fol-
1621        lowup-To header is controlled by the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.66  , page 101)
1622        configuration variable.
1623
1624        More precisely, Mutt-ng maintains lists of patterns for the addresses of known
1625        and subscribed mailing lists.  Every subscribed mailing list is known. To mark
1626        a mailing list as known, use the ``lists'' command.  To mark it as subscribed,
1627        use ``subscribe''.
1628
1629        You can use regular expressions with both commands.  To mark all messages sent
1630        to a specific bug report's address on mutt's bug tracking system as list mail,
1631        for instance, you could say ``subscribe [0-9]*@bugs.guug.de''.  Often, it's
1632        sufficient to just give a portion of the list's e-mail address.
1633
1634        Specify as much of the address as you need to to remove ambiguity.  For exam-
1635        ple, if you've subscribed to the Mutt-ng mailing list, you will receive mail
1636        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
1637        list, you could add ``lists mutt-users'' to your initialization file.  To tell
1638        mutt that you are subscribed to it, add ``subscribe mutt-users'' to your ini-
1639        tialization file instead.  If you also happen to get mail from someone whose
1640        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-
1641        users@mutt\\.org'' or ``subscribe mutt-users@mutt\\.org'' to match only mail
1642        from the actual list.
1643
1644        The ``unlists'' command is used to remove a token from the list of known and
1645        subscribed mailing-lists. Use ``unlists *'' to remove all tokens.
1646
1647        To remove a mailing list from the list of subscribed mailing lists, but keep it
1648        on the list of known mailing lists, use ``unsubscribe''.
1649
1650        _\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
1651
1652        Usage: mbox-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1653
1654        This command is used to move read messages from a specified mailbox to a dif-
1655        ferent mailbox automatically when you quit or change folders.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a
1656        regular expression specifying the mailbox to treat as a ``spool'' mailbox and
1657        _\bm_\ba_\bi_\bl_\bb_\bo_\bx specifies where mail should be saved when read.
1658
1659        The Mutt Next Generation E-Mail Client                                       34
1660
1661        Unlike some of the other _\bh_\bo_\bo_\bk commands, only the _\bf_\bi_\br_\bs_\bt matching pattern is used
1662        (it is not possible to save read mail in more than a single mailbox).
1663
1664        _\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
1665
1666        Usage: [un]mailboxes [!]_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
1667
1668        This command specifies folders which can receive mail and which will be checked
1669        for new messages.  By default, the main menu status bar displays how many of
1670        these folders have new messages.
1671
1672        When changing folders, pressing _\bs_\bp_\ba_\bc_\be will cycle through folders with new mail.
1673
1674        Pressing TAB in the directory browser will bring up a menu showing the files
1675        specified by the mailboxes command, and indicate which contain new messages.
1676        Mutt-ng will automatically enter this mode when invoked from the command line
1677        with the -y option.
1678
1679        The ``unmailboxes'' command is used to remove a token from the list of folders
1680        which receive mail. Use ``unmailboxes *'' to remove all tokens.
1681
1682        N\bNo\bot\bte\be:\b: new mail is detected by comparing the last modification time to the last
1683        access time.  Utilities like biff or frm or any other program which accesses
1684        the mailbox might cause Mutt-ng to never detect new mail for that mailbox if
1685        they do not properly reset the access time.  Backup tools are another common
1686        reason for updated access times.
1687
1688        N\bNo\bot\bte\be:\b: the filenames in the mailboxes command are resolved when the command is
1689        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
1690        56) (such as ``='' and ``!''), any variable definition that affect these char-
1691        acters (like _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.64  , page 100) and _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
1692        7.4.297  , page 157)) should be executed before the mailboxes command.
1693
1694        _\b3_\b._\b1_\b5  _\bU_\bs_\be_\br _\bd_\be_\bf_\bi_\bn_\be_\bd _\bh_\be_\ba_\bd_\be_\br_\bs
1695
1696        Usage:
1697
1698        my_hdr _\bs_\bt_\br_\bi_\bn_\bg
1699
1700        unmy_hdr _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
1701
1702        The ``my_hdr'' command allows you to create your own header fields which will
1703        be added to every message you send.
1704
1705        For example, if you would like to add an ``Organization:'' header field to all
1706        of your outgoing messages, you can put the command
1707
1708             my_hdr Organization: A Really Big Company, Anytown, USA
1709
1710        The Mutt Next Generation E-Mail Client                                       35
1711
1712        in your .muttrc.
1713
1714        N\bNo\bot\bte\be:\b:  space characters are _\bn_\bo_\bt allowed between the keyword and the colon
1715        (``:'').  The standard for electronic mail (RFC822) says that space is illegal
1716        there, so Mutt-ng enforces the rule.
1717
1718        If you would like to add a header field to a single message, you should either
1719        set the _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.54  , page 98) variable, or use the _\be_\bd_\bi_\bt_\b-
1720        _\bh_\be_\ba_\bd_\be_\br_\bs function (default: ``E'') in the send-menu so that you can edit the
1721        header of your message along with the body.
1722
1723        To remove user defined header fields, use the ``unmy_hdr'' command.  You may
1724        specify an asterisk (``*'') to remove all header fields, or the fields to
1725        remove.  For example, to remove all ``To'' and ``Cc'' header fields, you could
1726        use:
1727
1728             unmy_hdr to cc
1729
1730        _\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
1731
1732        Usage: hdr_order _\bh_\be_\ba_\bd_\be_\br_\b1 _\bh_\be_\ba_\bd_\be_\br_\b2 _\bh_\be_\ba_\bd_\be_\br_\b3
1733
1734        With this command, you can specify an order in which mutt will attempt to
1735        present headers to you when viewing messages.
1736
1737        ``unhdr_order *'' will clear all previous headers from the order list, thus
1738        removing the header order effects set by the system-wide startup file.
1739
1740             hdr_order From Date: From: To: Cc: Subject:
1741
1742        _\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
1743
1744        Usage: save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
1745
1746        This command is used to override the default filename used when saving mes-
1747        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:
1748        an address matching _\br_\be_\bg_\be_\bx_\bp or if you are the author and the message is
1749        addressed _\bt_\bo_\b: something matching _\br_\be_\bg_\be_\bx_\bp.
1750
1751        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 53) for information on the
1752        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1753
1754        Examples:
1755
1756             save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
1757
1758        The Mutt Next Generation E-Mail Client                                       36
1759
1760             save-hook aol\\.com$ +spam
1761
1762        Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 36) command.
1763
1764        _\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
1765
1766        Usage: fcc-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1767
1768        This command is used to save outgoing mail in a mailbox other than _\b$_\br_\be_\bc_\bo_\br_\bd
1769        (section 7.4.231  , page 141).  Mutt-ng searches the initial list of message
1770        recipients for the first matching _\br_\be_\bg_\be_\bx_\bp and uses _\bm_\ba_\bi_\bl_\bb_\bo_\bx as the default Fcc:
1771        mailbox.  If no match is found the message will be saved to _\b$_\br_\be_\bc_\bo_\br_\bd (section
1772        7.4.231  , page 141) mailbox.
1773
1774        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 53) for information on the
1775        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1776
1777        Example: fcc-hook [@.]aol\\.com$ +spammers
1778
1779        The above will save a copy of all messages going to the aol.com domain to the
1780        `+spammers' mailbox by default.  Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  ,
1781        page 36) command.
1782
1783        _\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
1784
1785        Usage: fcc-save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1786
1787        This command is a shortcut, equivalent to doing both a _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section
1788        3.18  , page 35) and a _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 35) with its arguments.
1789
1790        _\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
1791
1792        Usage: reply-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1793
1794        Usage: send-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1795
1796        Usage: send2-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1797
1798        These commands can be used to execute arbitrary configuration commands based
1799        upon recipients of the message.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a regular expression matching the
1800        desired address.  _\bc_\bo_\bm_\bm_\ba_\bn_\bd is executed when _\br_\be_\bg_\be_\bx_\bp matches recipients of the
1801        message.
1802
1803        reply-hook is matched against the message you are _\br_\be_\bp_\bl_\by_\bi_\bn_\bg t\bto\bo, instead of the
1804        message you are _\bs_\be_\bn_\bd_\bi_\bn_\bg.  send-hook is matched against all messages, both _\bn_\be_\bw
1805        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
1806        the order specified in the users's configuration file.
1807
1808        The Mutt Next Generation E-Mail Client                                       37
1809
1810        send2-hook is matched every time a message is changed, either by editing it, or
1811        by using the compose menu to change its recipients or subject.  send2-hook is
1812        executed after send-hook, and can, e.g., be used to set parameters such as the
1813        _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.248  , page 145) variable depending on the message's
1814        sender address.
1815
1816        For each type of send-hook or reply-hook, when multiple matches occur, commands
1817        are executed in the order they are specified in the muttrc (for that type of
1818        hook).
1819
1820        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 53) for information on the
1821        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1822
1823        Example: send-hook mutt 'set mime_forward signature='''
1824
1825        Another typical use for this command is to change the values of the _\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\b-
1826        _\bt_\bi_\bo_\bn (section 7.4.15  , page 89), _\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.260  , page 148) and
1827        _\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.114  , page 114) variables in order to change the language
1828        of the attributions and signatures based upon the recipients.
1829
1830        N\bNo\bot\bte\be:\b: the send-hook's are only executed ONCE after getting the initial list of
1831        recipients.  Adding a recipient after replying or editing the message will NOT
1832        cause any send-hook to be executed.  Also note that my_hdr commands which mod-
1833        ify recipient headers, or the message's subject, don't have any effect on the
1834        current message when executed from a send-hook.
1835
1836        _\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
1837
1838        Usage: message-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1839
1840        This command can be used to execute arbitrary configuration commands before
1841        viewing or formatting a message based upon information about the message.  _\bc_\bo_\bm_\b-
1842        _\bm_\ba_\bn_\bd is executed if the _\bp_\ba_\bt_\bt_\be_\br_\bn matches the message to be displayed. When mul-
1843        tiple matches occur, commands are executed in the order they are specified in
1844        the muttrc.
1845
1846        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 53) for information on the
1847        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1848
1849        Example:
1850
1851             message-hook ~A 'set pager=builtin'
1852             message-hook '~f freshmeat-news' 'set pager="less \"+/^  subject: .*\""'
1853
1854        _\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
1855
1856        Usage: crypt-hook _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\bi_\bd
1857
1858        When encrypting messages with PGP or OpenSSL, you may want to associate a
1859
1860        The Mutt Next Generation E-Mail Client                                       38
1861
1862        certain key with a given e-mail address automatically, either because the
1863        recipient's public key can't be deduced from the destination address, or
1864        because, for some reasons, you need to override the key Mutt-ng would normally
1865        use.  The crypt-hook command provides a method by which you can specify the ID
1866        of the public key to be used when encrypting messages to a certain recipient.
1867
1868        The meaning of "key id" is to be taken broadly in this context:  You can either
1869        put a numerical key ID here, an e-mail address, or even just a real name.
1870
1871        _\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
1872
1873        Usage: push _\bs_\bt_\br_\bi_\bn_\bg
1874
1875        This command adds the named string to the keyboard buffer. The string may con-
1876        tain control characters, key names and function names like the sequence string
1877        in the _\bm_\ba_\bc_\br_\bo (section 3.7  , page 27) command. You may use it to automatically
1878        run a sequence of commands at startup, or when entering certain folders.
1879
1880        _\b3_\b._\b2_\b4  _\bE_\bx_\be_\bc_\bu_\bt_\bi_\bn_\bg _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
1881
1882        Usage: exec _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
1883
1884        This command can be used to execute any function. Functions are listed in the
1885        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 7.5  , page 169).  ``exec function'' is equivalent
1886        to ``push <function>''.
1887
1888        _\b3_\b._\b2_\b5  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bS_\bc_\bo_\br_\bi_\bn_\bg
1889
1890        Usage: score _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
1891
1892        Usage: unscore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1893
1894        In situations where you have to cope with a lot of emails, e.g.  when you read
1895        many different mailing lists, and take part in discussions, it is always useful
1896        to have the important messages marked and the annoying messages or the ones
1897        that you aren't interested in deleted. For this purpose, mutt-ng features a
1898        mechanism called ``scoring''.
1899
1900        When you use scoring, every message has a base score of 0. You can then use the
1901        score command to define patterns and a positive or negative value associated
1902        with it. When a pattern matches a message, the message's score will be raised
1903        or lowered by the amount of the value associated with the pattern.
1904
1905             score "~f nion@muttng\.org" 50
1906             score "~f @sco\.com" -100
1907
1908        The Mutt Next Generation E-Mail Client                                       39
1909
1910        If the pattern matches, it is also possible to set the score value of the cur-
1911        rent message to a certain value and then stop evaluation:
1912
1913             score "~f santaclaus@northpole\.int" =666
1914
1915        What is important to note is that negative score values will be rounded up to
1916        0.
1917
1918        To make scoring actually useful, the score must be applied in some way.  That's
1919        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:
1920
1921           +\bo flag threshold: when a message has a score value equal or higher than the
1922             flag threshold, it will be flagged.
1923
1924           +\bo read threshold: when a message has a score value equal or lower than the
1925             read threshold, it will be marked as read.
1926
1927           +\bo delete threshold: when a message has a score value equal or lower than the
1928             delete threshold, it will be marked as deleted.
1929
1930        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-
1931        tion 7.4.245  , page 145), _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.246  , page 145),
1932        _\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.244  , page 145) and.  By default,
1933        _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd (section 7.4.246  , page 145) and _\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
1934        (section 7.4.244  , page 145) are set to -1, which means that in the default
1935        threshold configuration no message will ever get marked as read or deleted.
1936
1937        Scoring gets especially interesting when combined with the color command and
1938        the ~n pattern:
1939
1940             color   black   yellow  "~n 10-"
1941             color   red     yellow  "~n 100-"
1942
1943        The rules above mark all messages with a score between 10 and 99 with black and
1944        yellow, and messages with a score greater or equal 100 with red and yellow.
1945        This might be unusual to you if you're used to e.g. slrn's scoring mechanism,
1946        but it is more flexible, as it visually marks different scores.
1947
1948        _\b3_\b._\b2_\b6  _\bS_\bp_\ba_\bm _\bd_\be_\bt_\be_\bc_\bt_\bi_\bo_\bn
1949
1950        Usage: spam _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
1951
1952        Usage: nospam _\bp_\ba_\bt_\bt_\be_\br_\bn
1953
1954        Mutt-ng has generalized support for external spam-scoring filters.  By defining
1955        your spam patterns with the spam and nospam commands, you can _\bl_\bi_\bm_\bi_\bt, _\bs_\be_\ba_\br_\bc_\bh,
1956        and _\bs_\bo_\br_\bt your mail based on its spam attributes, as determined by the external
1957        filter. You also can display the spam attributes in your index display using
1958
1959        The Mutt Next Generation E-Mail Client                                       40
1960
1961        the %H selector in the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111) variable.
1962        (Tip: try %?H?[%H] ?  to display spam tags only when they are defined for a
1963        given message.)
1964
1965        Your first step is to define your external filter's spam patterns using the
1966        spam command. _\bp_\ba_\bt_\bt_\be_\br_\bn should be a regular expression that matches a header in a
1967        mail message. If any message in the mailbox matches this regular expression, it
1968        will receive a ``spam tag'' or ``spam attribute'' (unless it also matches a
1969        nospam pattern -- see below.) The appearance of this attribute is entirely up
1970        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,
1971        but it also can include back-references from the _\bp_\ba_\bt_\bt_\be_\br_\bn expression. (A regular
1972        expression ``back-reference'' refers to a sub-expression contained within
1973        parentheses.) %1 is replaced with the first back-reference in the regex, %2
1974        with the second, etc.
1975
1976        If you're using multiple spam filters, a message can have more than one spam-
1977        related header. You can define spam patterns for each filter you use. If a mes-
1978        sage matches two or more of these patterns, and the $spam_separator variable is
1979        set to a string, then the message's spam tag will consist of all the _\bf_\bo_\br_\bm_\ba_\bt
1980        strings joined together, with the value of $spam_separator separating them.
1981
1982        For example, suppose I use DCC, SpamAssassin, and PureMessage. I might define
1983        these spam settings:
1984
1985             spam "X-DCC-.*-Metrics:.*(....)=many"         "90+/DCC-%1"
1986             spam "X-Spam-Status: Yes"                     "90+/SA"
1987             spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM"
1988             set spam_separator=", "
1989
1990        If I then received a message that DCC registered with ``many'' hits under the
1991        ``Fuz2'' checksum, and that PureMessage registered with a 97% probability of
1992        being spam, that message's spam tag would read 90+/DCC-Fuz2, 97/PM. (The four
1993        characters before ``=many'' in a DCC report indicate the checksum used -- in
1994        this case, ``Fuz2''.)
1995
1996        If the $spam_separator variable is unset, then each spam pattern match super-
1997        sedes the previous one. Instead of getting joined _\bf_\bo_\br_\bm_\ba_\bt strings, you'll get
1998        only the last one to match.
1999
2000        The spam tag is what will be displayed in the index when you use %H in the
2001        $index_format variable. It's also the string that the ~H pattern-matching
2002        expression matches against for _\bs_\be_\ba_\br_\bc_\bh and _\bl_\bi_\bm_\bi_\bt functions. And it's what sort-
2003        ing by spam attribute will use as a sort key.
2004
2005        That's a pretty complicated example, and most people's actual environments will
2006        have only one spam filter. The simpler your configuration, the more effective
2007        mutt can be, especially when it comes to sorting.
2008
2009        Generally, when you sort by spam tag, mutt will sort _\bl_\be_\bx_\bi_\bc_\ba_\bl_\bl_\by -- that is, by
2010        ordering strings alphnumerically. However, if a spam tag begins with a number,
2011        mutt will sort numerically first, and lexically only when two numbers are equal
2012        in value. (This is like UNIX's sort -n.) A message with no spam attributes at
2013        all -- that is, one that didn't match _\ba_\bn_\by of your spam patterns -- is sorted at
2014
2015        The Mutt Next Generation E-Mail Client                                       41
2016
2017        lowest priority. Numbers are sorted next, beginning with 0 and ranging upward.
2018        Finally, non-numeric strings are sorted, with ``a'' taking lower priority than
2019        ``z''. Clearly, in general, sorting by spam tags is most effective when you can
2020        coerce your filter to give you a raw number. But in case you can't, mutt can
2021        still do something useful.
2022
2023        The nospam command can be used to write exceptions to spam patterns. If a
2024        header pattern matches something in a spam command, but you nonetheless do not
2025        want it to receive a spam tag, you can list a more precise pattern under a
2026        nospam command.
2027
2028        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-
2029        ing spam list entry, the effect will be to remove the entry from the spam list,
2030        instead of adding an exception.  Likewise, if the _\bp_\ba_\bt_\bt_\be_\br_\bn for a spam command
2031        matches an entry on the nospam list, that nospam entry will be removed. If the
2032        _\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
2033        might be the default action if you use spam and nospam in conjunction with a
2034        folder-hook.
2035
2036        You can have as many spam or nospam commands as you like.  You can even do your
2037        own primitive spam detection within mutt -- for example, if you consider all
2038        mail from MAILER-DAEMON to be spam, you can use a spam command like this:
2039
2040             spam "^From: .*MAILER-DAEMON"       "999"
2041
2042        _\b3_\b._\b2_\b7  _\bS_\be_\bt_\bt_\bi_\bn_\bg _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2043
2044        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 ... ]
2045
2046        Usage: toggle _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2047
2048        Usage: unset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2049
2050        Usage: reset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
2051
2052        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  ,
2053        page 84).  There are four basic types of variables: boolean, number, string and
2054        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
2055        variables can be assigned a positive integer value.
2056
2057        _\bs_\bt_\br_\bi_\bn_\bg variables consist of any number of printable characters.  _\bs_\bt_\br_\bi_\bn_\bg_\bs must
2058        be enclosed in quotes if they contain spaces or tabs.  You may also use the
2059        ``C'' escape sequences \\b\n\bn and \\b\t\bt for newline and tab, respectively.
2060
2061        _\bq_\bu_\ba_\bd_\bo_\bp_\bt_\bi_\bo_\bn variables are used to control whether or not to be prompted for cer-
2062        tain actions, or to specify a default action.  A value of _\by_\be_\bs will cause the
2063        action to be carried out automatically as if you had answered yes to the ques-
2064        tion.  Similarly, a value of _\bn_\bo will cause the the action to be carried out as
2065        if you had answered ``no.''  A value of _\ba_\bs_\bk_\b-_\by_\be_\bs will cause a prompt with a
2066        default answer of ``yes'' and _\ba_\bs_\bk_\b-_\bn_\bo will provide a default answer of ``no.''
2067
2068        The Mutt Next Generation E-Mail Client                                       42
2069
2070        Prefixing a variable with ``no'' will unset it.  Example: set noaskbcc.
2071
2072        For _\bb_\bo_\bo_\bl_\be_\ba_\bn variables, you may optionally prefix the variable name with inv to
2073        toggle the value (on or off).  This is useful when writing macros.  Example:
2074        set invsmart_wrap.
2075
2076        The toggle command automatically prepends the inv prefix to all specified vari-
2077        ables.
2078
2079        The unset command automatically prepends the no prefix to all specified vari-
2080        ables.
2081
2082        Using the enter-command function in the _\bi_\bn_\bd_\be_\bx menu, you can query the value of
2083        a variable by prefixing the name of the variable with a question mark:
2084
2085             set ?allow_8bit
2086
2087        The question mark is actually only required for boolean and quadoption vari-
2088        ables.
2089
2090        The reset command resets all given variables to the compile time defaults
2091        (hopefully mentioned in this manual). If you use the command set and prefix the
2092        variable with ``&'' this has the same behavior as the reset command.
2093
2094        With the reset command there exists the special variable ``all'', which allows
2095        you to reset all variables to their system defaults.
2096
2097        _\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
2098
2099        Usage: source _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
2100
2101        This command allows the inclusion of initialization commands from other files.
2102        For example, I place all of my aliases in ~/.mail_aliases so that I can make my
2103        ~/.muttrc readable and keep my aliases private.
2104
2105        If the filename begins with a tilde (``~''), it will be expanded to the path of
2106        your home directory.
2107
2108        If the filename ends with a vertical bar (|), then _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be is considered to be
2109        an executable program from which to read input (eg.  source ~/bin/myscript|).
2110
2111        _\b3_\b._\b2_\b9  _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
2112
2113        Usage: unhook [ * | _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be ]
2114
2115        This command permits you to flush hooks you have previously defined.  You can
2116        either remove all hooks by giving the ``*'' character as an argument, or you
2117        can remove all hooks of a specific type by saying something like unhook send-
2118
2119        The Mutt Next Generation E-Mail Client                                       43
2120
2121        hook.
2122
2123        _\b3_\b._\b3_\b0  _\bS_\bh_\ba_\br_\bi_\bn_\bg _\bS_\be_\bt_\bu_\bp_\bs
2124
2125        _\b3_\b._\b3_\b0_\b._\b1  _\bC_\bh_\ba_\br_\ba_\bc_\bt_\be_\br _\bS_\be_\bt_\bs
2126
2127        As users may run mutt-ng on different systems, the configuration must be main-
2128        tained because it's likely that people want to use the setup everywhere they
2129        use mutt-ng. And mutt-ng tries to help where it can.
2130
2131        To not produce conflicts with different character sets, mutt-ng allows users to
2132        specify in which character set their configuration files are encoded. Please
2133        note that while reading the configuration files, this is only respected after
2134        the corresponding declaration appears. It's advised to put the following at the
2135        very beginning of a users muttngrc:
2136
2137             set config_charset = "..."
2138
2139        and replacing the dots with the actual character set. To avoid problems while
2140        maintaining the setup, vim user's may want to use modelines as show in:
2141
2142             # vim:fileencoding=...:
2143
2144        while, again, replacing the dots with the appropriate name. This tells vim as
2145        which character set to read and save the file.
2146
2147        _\b3_\b._\b3_\b0_\b._\b2  _\bM_\bo_\bd_\bu_\bl_\ba_\br_\bi_\bz_\ba_\bt_\bi_\bo_\bn
2148
2149        ``Modularization'' means to divide the setup into several files while sorting
2150        the options or commands by topic. Especially for longer setups (e.g. with many
2151        hooks), this helps maintaining it and solving trouble.
2152
2153        When using separation, setups may be, as a whole or in fractions, shared over
2154        different systems.
2155
2156        _\b3_\b._\b3_\b0_\b._\b3  _\bC_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl _\bp_\ba_\br_\bt_\bs
2157
2158        When using a configuration on different systems, the user may not always have
2159        influence on how mutt-ng is installed and which features it includes.
2160
2161        To solve this, mutt-ng contain a feature based on the ``ifdef'' patch written
2162        for mutt. Its basic syntax is:
2163
2164        The Mutt Next Generation E-Mail Client                                       44
2165
2166             ifdef <item> <command>
2167             ifndef <item> <command>
2168
2169        ...whereby <item> can be one of:
2170
2171           +\bo a function name
2172
2173           +\bo a variable name
2174
2175           +\bo a menu name
2176
2177           +\bo a feature name
2178
2179        All available functions, variables and menus are documented elsewhere in this
2180        manual but ``features'' is specific to these two commands. To test for one,
2181        prefix one of the following keywords with feature_:
2182
2183             ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl,
2184             gnutls, sasl, sasl2, libesmtp, compressed, color, classic_pgp,
2185             classic_smime, gpgme, header_cache
2186
2187        As an example, one can use the following in ~/.muttngrc:
2188
2189             ifdef feature_imap 'source ~/.mutt-ng/setup-imap'
2190             ifdef feature_pop  'source ~/.mutt-ng/setup-pop'
2191             ifdef feature_nntp 'source ~/.mutt-ng/setup-nntp'
2192
2193        ...to only source ~/.mutt-ng/setup-imap if IMAP support is built in, only
2194        source ~/.mutt-ng/setup-pop if POP support is built in and only source ~/.mutt-
2195        ng/setup-nntp if NNTP support is built in.
2196
2197        An example for testing for variable names can be used if users use different
2198        revisions of mutt-ng whereby the older one may not have a certain variable. To
2199        test for the availability of _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.99  , page 108),
2200        use:
2201
2202             ifdef imap_mail_check 'set imap_mail_check = 300'
2203
2204        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
2205        (section 7.4.170  , page 127) only if the pager menu is available, use:
2206
2207             ifdef pager 'set pager_index_lines = 10'
2208
2209        For completeness, too, the opposite of ifdef is provided: ifndef which only
2210        executes the command if the test fails. For example, the following two examples
2211
2212        The Mutt Next Generation E-Mail Client                                       45
2213
2214        are equivalent:
2215
2216             ifdef feature_ncurses 'source ~/.mutt-ng/setup-ncurses'
2217             ifndef feature_ncurses 'source ~/.mutt-ng/setup-slang'
2218
2219        ...and...
2220
2221             ifdef feature_slang 'source ~/.mutt-ng/setup-slang'
2222             ifndef feature_slang 'source ~/.mutt-ng/setup-ncurses'
2223
2224        _\b3_\b._\b3_\b1  _\bO_\bb_\bs_\bo_\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
2225
2226        In the process of ensuring and creating more consistency, many variables have
2227        been renamed and some of the old names were already removed. Please see _\bO_\bb_\bs_\bo_\b-
2228        _\bl_\be_\bt_\be _\bV_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs (section 7.4  , page 84) for a complete list.
2229
2230        _\b4_\b.  _\bA_\bd_\bv_\ba_\bn_\bc_\be_\bd _\bU_\bs_\ba_\bg_\be
2231
2232        _\b4_\b._\b1  _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs
2233
2234        All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
2235        tion 7.2  , page 80) must be specified using regular expressions (regexp) in
2236        the ``POSIX extended'' syntax (which is more or less the syntax used by egrep
2237        and GNU awk).  For your convenience, we have included below a brief description
2238        of this syntax.
2239
2240        The search is case sensitive if the pattern contains at least one upper case
2241        letter, and case insensitive otherwise. Note that ``\'' must be quoted if used
2242        for a regular expression in an initialization command: ``\\''.
2243
2244        A regular expression is a pattern that describes a set of strings.  Regular
2245        expressions are constructed analogously to arithmetic expressions, by using
2246        various operators to combine smaller expressions.
2247
2248        Note that the regular expression can be enclosed/delimited by either ' or '
2249        which is useful if the regular expression includes a white-space character.
2250        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-
2251        tion on ' and ' delimiter processing.  To match a literal ' or ' you must pref-
2252        ace it with \ (backslash).
2253
2254        The fundamental building blocks are the regular expressions that match a single
2255
2256        The Mutt Next Generation E-Mail Client                                       46
2257
2258        character.  Most characters, including all letters and digits, are regular
2259        expressions that match themselves.  Any metacharacter with special meaning may
2260        be quoted by preceding it with a backslash.
2261
2262        The period ``.'' matches any single character.  The caret ``^'' and the dollar
2263        sign ``$'' are metacharacters that respectively match the empty string at the
2264        beginning and end of a line.
2265
2266        A list of characters enclosed by ``['' and ``]'' matches any single character
2267        in that list; if the first character of the list is a caret ``^'' then it
2268        matches any character n\bno\bot\bt in the list.  For example, the regular expression
2269        [\b[0\b01\b12\b23\b34\b45\b56\b67\b78\b89\b9]\b] matches any single digit.  A range of ASCII characters may be
2270        specified by giving the first and last characters, separated by a hyphen ``-''.
2271        Most metacharacters lose their special meaning inside lists.  To include a lit-
2272        eral ``]'' place it first in the list.  Similarly, to include a literal ``^''
2273        place it anywhere but first.  Finally, to include a literal hyphen ``-'' place
2274        it last.
2275
2276        Certain named classes of characters are predefined.  Character classes consist
2277        of ``[:'', a keyword denoting the class, and ``:]''.  The following classes are
2278        defined by the POSIX standard:
2279
2280              [:alnum:]
2281                    Alphanumeric characters.
2282
2283              [:alpha:]
2284                    Alphabetic characters.
2285
2286              [:blank:]
2287                    Space or tab characters.
2288
2289              [:cntrl:]
2290                    Control characters.
2291
2292              [:digit:]
2293                    Numeric characters.
2294
2295              [:graph:]
2296                    Characters that are both printable and visible.  (A space is print-
2297                    able, but not visible, while an ``a'' is both.)
2298
2299              [:lower:]
2300                    Lower-case alphabetic characters.
2301
2302              [:print:]
2303                    Printable characters (characters that are not control characters.)
2304
2305              [:punct:]
2306                    Punctuation characters (characters that are not letter, digits,
2307                    control characters, or space characters).
2308
2309              [:space:]
2310                    Space characters (such as space, tab and formfeed, to name a few).
2311
2312        The Mutt Next Generation E-Mail Client                                       47
2313
2314              [:upper:]
2315                    Upper-case alphabetic characters.
2316
2317              [:xdigit:]
2318                    Characters that are hexadecimal digits.
2319
2320        A character class is only valid in a regular expression inside the brackets of
2321        a character list.  Note that the brackets in these class names are part of the
2322        symbolic names, and must be included in addition to the brackets delimiting the
2323        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].
2324
2325        Two additional special sequences can appear in character lists.  These apply to
2326        non-ASCII character sets, which can have single symbols (called collating ele-
2327        ments) that are represented with more than one character, as well as several
2328        characters that are equivalent for collating or sorting purposes:
2329
2330              Collating Symbols
2331                    A collating symbol is a multi-character collating element enclosed
2332                    in ``[.'' and ``.]''.  For example, if ``ch'' is a collating ele-
2333                    ment, then [\b[[\b[.\b.c\bch\bh.\b.]\b]]\b] is a regexp that matches this collating ele-
2334                    ment, while [\b[c\bch\bh]\b] is a regexp that matches either ``c'' or ``h''.
2335
2336              Equivalence Classes
2337                    An equivalence class is a locale-specific name for a list of char-
2338                    acters that are equivalent. The name is enclosed in ``[='' and
2339                    ``=]''.  For example, the name ``e'' might be used to represent all
2340                    of ``'' ``'' and ``e''.  In this case, [\b[[\b[=\b=e\be=\b=]\b]]\b] is a regexp that
2341                    matches any of ``'', ``'' and ``e''.
2342
2343        A regular expression matching a single character may be followed by one of sev-
2344        eral repetition operators:
2345
2346              ?
2347                    The preceding item is optional and matched at most once.
2348
2349              *
2350                    The preceding item will be matched zero or more times.
2351
2352              +
2353                    The preceding item will be matched one or more times.
2354
2355              {n}
2356                    The preceding item is matched exactly _\bn times.
2357
2358              {n,}
2359                    The preceding item is matched _\bn or more times.
2360
2361              {,m}
2362                    The preceding item is matched at most _\bm times.
2363
2364              {n,m}
2365                    The preceding item is matched at least _\bn times, but no more than _\bm
2366                    times.
2367
2368        The Mutt Next Generation E-Mail Client                                       48
2369
2370        Two regular expressions may be concatenated; the resulting regular expression
2371        matches any string formed by concatenating two substrings that respectively
2372        match the concatenated subexpressions.
2373
2374        Two regular expressions may be joined by the infix operator ``|''; the result-
2375        ing regular expression matches any string matching either subexpression.
2376
2377        Repetition takes precedence over concatenation, which in turn takes precedence
2378        over alternation.  A whole subexpression may be enclosed in parentheses to
2379        override these precedence rules.
2380
2381        N\bNo\bot\bte\be:\b: If you compile Mutt-ng with the GNU _\br_\bx package, the following operators
2382        may also be used in regular expressions:
2383
2384              \\y
2385                    Matches the empty string at either the beginning or the end of a
2386                    word.
2387
2388              \\B
2389                    Matches the empty string within a word.
2390
2391              \\<
2392                    Matches the empty string at the beginning of a word.
2393
2394              \\>
2395                    Matches the empty string at the end of a word.
2396
2397              \\w
2398                    Matches any word-constituent character (letter, digit, or under-
2399                    score).
2400
2401              \\W
2402                    Matches any character that is not word-constituent.
2403
2404              \\`
2405                    Matches the empty string at the beginning of a buffer (string).
2406
2407              \\'
2408                    Matches the empty string at the end of a buffer.
2409
2410        Please note however that these operators are not defined by POSIX, so they may
2411        or may not be available in stock libraries on various systems.
2412
2413        _\b4_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2414
2415        Mutt-ng's pattern language provides a simple yet effective way to set up rules
2416        to match messages, e.g. for operations like tagging and scoring. A pattern con-
2417        sists of one or more sub-pattern, which can be logically grouped, ORed, and
2418        negated. For a complete listing of these patterns, please refer to table _\bP_\ba_\bt_\b-
2419        _\bt_\be_\br_\bn_\bs (section 7.2  , page 80) in the Reference chapter.
2420
2421        It must be noted that in this table, EXPR, USER, ID and SUBJECT are regular
2422
2423        The Mutt Next Generation E-Mail Client                                       49
2424
2425        expressions. For ranges, the forms <[MAX], >>[MIN], [MIN]- and -[MAX] are also
2426        possible.
2427
2428        _\b4_\b._\b2_\b._\b1  _\bC_\bo_\bm_\bp_\bl_\be_\bx _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2429
2430        It is possible to combine several sub-patterns to a more complex pattern. The
2431        most simple possibility is to logically AND several patterns by stringing them
2432        together:
2433
2434             ~s 'SPAM' ~U
2435
2436        The pattern above matches all messages that contain ``SPAM'' in the subject and
2437        are unread.
2438
2439        To logical OR patterns, simply use the | operator. This one especially useful
2440        when using local groups:
2441
2442             ~f ("nion@muttng\.org"|"ak@muttng\.org"|"pdmef@muttng\.org")
2443             (~b mutt-ng|~s Mutt-ng)
2444             !~x '@synflood\.at'
2445
2446        The first pattern matches all messages that were sent by one of the mutt-ng
2447        maintainers, while the seconds pattern matches all messages that contain
2448        ``mutt-ng'' in the message body or ``Mutt-ng'' in the subject. The third pat-
2449        tern matches all messages that do not contain ``@synflood\.at'' in the Refer-
2450        ences: header, i.e.  messages that are not an (indirect) reply to one of my
2451        messages. A pattern can be logicall negated using the ! operator.
2452
2453        _\b4_\b._\b2_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs _\ba_\bn_\bd _\bD_\ba_\bt_\be_\bs
2454
2455        When using dates in patterns, the dates must be specified in a special format,
2456        i.e.  DD/MM/YYYY. If you don't specify month or year, they default to the cur-
2457        rent month or year. When using date ranges, and you specify only the minimum or
2458        the maximum, the specified date will be excluded, e.g. 01/06/2005- matches
2459        against all messages _\ba_\bf_\bt_\be_\br Juni 1st, 2005.
2460
2461        It is also possible to use so-called ``error margins'' when specifying date
2462        ranges.  You simply specify a date, and then the error margin. This margin
2463        needs to contain the information whether it goes ``forth'' or ``back'' in time,
2464        by using + and -.  Then follows a number and a unit, i.e. y for years, m for
2465        months, w for weeks and d for days. If you use the special * sign, it means
2466        that the error margin goes to both ``directions'' in time.
2467
2468             ~d 01/01/2005+1y
2469             ~d 18/10/2004-2w
2470             ~d 28/12/2004*1d
2471
2472        The first pattern matches all dates between January 1st, 2005 and January 1st
2473
2474        The Mutt Next Generation E-Mail Client                                       50
2475
2476        2006.  The second pattern matches all dates between October 18th, 2004 and
2477        October 4th 2004 (2 weeks before 18/10/2004), while the third pattern matches
2478        all dates 1 day around December 28th, 2004 (i.e. Dec 27th, 28th and 29th).
2479
2480        Relative dates are also very important, as they make it possible to specify
2481        date ranges between a fixed number of units and the current date. How this
2482        works can be seen in the following example:
2483
2484             ~d >2w # messages older than two weeks
2485             ~d <3d # messages newer than 3 days
2486             ~d =1m # messages that are exactly one month old
2487
2488        _\b4_\b._\b3  _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs
2489
2490        _\b4_\b._\b3_\b._\b1  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
2491
2492        The so called _\bF_\bo_\br_\bm_\ba_\bt _\bS_\bt_\br_\bi_\bn_\bg_\bs offer great flexibility when configuring mutt-ng.
2493        In short, they describe what items to print out how in menus and status mes-
2494        sages.
2495
2496        Basically, they work as this: for different menus and bars, there's a variable
2497        specifying the layout. For every item available, there is a so called _\be_\bx_\bp_\ba_\bn_\bd_\bo.
2498
2499        For example, when running mutt-ng on different machines or different versions
2500        for testing purposes, it may be interesting to have the following information
2501        always printed on screen when one is in the index:
2502
2503           +\bo the current hostname
2504
2505           +\bo the current mutt-ng version number
2506
2507        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-
2508        _\bm_\ba_\bt (section 7.4.308  , page 160) variable. For the hostname and version
2509        string, there's an expando for $status_format: %h expands to the hostname and
2510        %v to the version string. When just configuring:
2511
2512             set status_format = "%v on %h: ..."
2513
2514        mutt-ng will replace the sequence %v with the version string and %h with the
2515        host's name. When you are, for example, running mutt-ng version 1.5.9i on host
2516        mailhost, you'll see the following when you're in the index:
2517
2518             Mutt-ng 1.5.9i on mailhost: ...
2519
2520        In the index, there're more useful information one could want to see:
2521
2522        The Mutt Next Generation E-Mail Client                                       51
2523
2524           +\bo which mailbox is open
2525
2526           +\bo how man new, flagged or postponed messages
2527
2528           +\bo ...
2529
2530        To include the mailbox' name is as easy as:
2531
2532             set status_format = "%v on %h: %B: ...
2533
2534        When the currently opened mailbox is Inbox, this will be expanded to:
2535
2536             Mutt-ng 1.5.9i on mailhost: Inbox: ...
2537
2538        For the number of certain types of messages, one more feature of the format
2539        strings is extremely useful. If there aren't messages of a certain type, it may
2540        not be desired to print just that there aren't any but instead only print some-
2541        thing if there are any.
2542
2543        _\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
2544
2545        To only print the number of messages if there are new messages in the current
2546        mailbox, further extend $status_format to:
2547
2548             set status_format = "%v on %h: %B %?n?%n new? ...
2549
2550        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
2551        optionally printed nonzero, i.e.  a portion of the format string is only evalu-
2552        ated if the value of the expando is different from zero. The basic syntax is:
2553
2554             %?<item>?<string if nonzero>?
2555
2556        which tells mutt-ng to only look at <string if nonzero> if the value of the
2557        %<item%gt; expando is different from zero. In our example, we used n as the
2558        expando to check for and %n new as the optional nonzero string.
2559
2560        But this is not all: this feature only offers one alternative: ``print some-
2561        thing if not zero.'' Mutt-ng does, as you might guess, also provide a logically
2562        complete version: ``if zero, print something and else print something else.''
2563        This is achieved by the following syntax for those expandos which may be
2564        printed nonzero:
2565
2566             %?<item>?<string if nonzero>&<string if zero>?
2567
2568        The Mutt Next Generation E-Mail Client                                       52
2569
2570        Using this we can make mutt-ng to do the following:
2571
2572           +\bo  make it print ``_\bn new messages'' whereby _\bn is the count but only if there
2573             new ones
2574
2575           +\bo  and make it print ``no new messages'' if there aren't any
2576
2577        The corresponding configuration is:
2578
2579             set status_format = "%v on %h: %B: %?n?%n new messages&no new messages? ...
2580
2581        This doubles the use of the ``new messages'' string because it'll get always
2582        printed. Thus, it can be shortened to:
2583
2584             set status_format = "%v on %h: %B: %?n?%n&no? new messages ...
2585
2586        As you might see from this rather simple example, one can create very complex
2587        but fancy status messages. Please see the reference chapter for expandos and
2588        those which may be printed nonzero.
2589
2590        _\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
2591
2592        Besides the information given so far, there're even more features of format
2593        strings:
2594
2595           +\bo When specifying %_<item> instead of just %<item>, mutt-ng will convert all
2596             characters in the expansion of <item> to lowercase.
2597
2598           +\bo When specifying %:<item> instead of just %<item>, mutt-ng will convert all
2599             dots in the expansion of <item> to underscores (_).
2600
2601        Also, there's a feature called _\bP_\ba_\bd_\bd_\bi_\bn_\bg supplied by the following two expandos:
2602        %|X and %>X.
2603
2604              %|X
2605                    When this occurs, mutt-ng will fill the rest of the line with the
2606                    character X. In our example, filling the rest of the line with
2607                    dashes is done by setting:
2608
2609                         set status_format = "%v on %h: %B: %?n?%n&no? new messages %|-"
2610
2611              %>X
2612                    Since the previous expando stops at the end of line, there must be
2613                    a way to fill the gap between two items via the %>X expando: it
2614                    puts as many characters X in between two items so that the rest of
2615                    the line will be right-justified. For example, to not put the
2616
2617        The Mutt Next Generation E-Mail Client                                       53
2618
2619                    version string and hostname of our example on the left but on the
2620                    right and fill the gap with spaces, one might use (note the space
2621                    after %>):
2622
2623                         set status_format = "%B: %?n?%n&no? new messages %> (%v on %h)"
2624
2625        _\b4_\b._\b4  _\bU_\bs_\bi_\bn_\bg _\bT_\ba_\bg_\bs
2626
2627        Sometimes it is desirable to perform an operation on a group of messages all at
2628        once rather than one at a time.  An example might be to save messages to a
2629        mailing list to a separate folder, or to delete all messages with a given sub-
2630        ject.  To tag all messages matching a pattern, use the tag-pattern function,
2631        which is bound to ``shift-T'' by default.  Or you can select individual mes-
2632        sages by hand using the ``tag-message'' function, which is bound to ``t'' by
2633        default.  See _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 80) for Mutt-ng's pattern matching
2634        syntax.
2635
2636        Once you have tagged the desired messages, you can use the ``tag-prefix'' oper-
2637        ator, which is the ``;'' (semicolon) key by default.  When the ``tag-prefix''
2638        operator is used, the n\bne\bex\bxt\bt operation will be applied to all tagged messages if
2639        that operation can be used in that manner.  If the _\b$_\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg (section 7.4.16  ,
2640        page 90) variable is set, the next operation applies to the tagged messages
2641        automatically, without requiring the ``tag-prefix''.
2642
2643        In _\bm_\ba_\bc_\br_\bo_\bs (section 3.7  , page 27) or _\bp_\bu_\bs_\bh (section 3.23  , page 37) commands,
2644        you can use the ``tag-prefix-cond'' operator.  If there are no tagged messages,
2645        mutt will "eat" the rest of the macro to abort it's execution.  Mutt-ng will
2646        stop "eating" the macro when it encounters the ``end-cond'' operator;  after
2647        this operator the rest of the macro will be executed as normal.
2648
2649        _\b4_\b._\b5  _\bU_\bs_\bi_\bn_\bg _\bH_\bo_\bo_\bk_\bs
2650
2651        A _\bh_\bo_\bo_\bk is a concept borrowed from the EMACS editor which allows you to execute
2652        arbitrary commands before performing some operation.  For example, you may wish
2653        to tailor your configuration based upon which mailbox you are reading, or to
2654        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
2655        _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 44) or _\bp_\ba_\bt_\bt_\be_\br_\bn (section 7.2  , page 80) along
2656        with a configuration option/command.  See
2657
2658           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.6  , page 26)
2659
2660           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 36)
2661
2662           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 37)
2663
2664        The Mutt Next Generation E-Mail Client                                       54
2665
2666           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 35)
2667
2668           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 33)
2669
2670           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 35)
2671
2672           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 36)
2673
2674        for specific details on each type of _\bh_\bo_\bo_\bk available.
2675
2676        N\bNo\bot\bte\be:\b: if a hook changes configuration settings, these changes remain effective
2677        until the end of the current mutt session. As this is generally not desired, a
2678        default hook needs to be added before all other hooks to restore configuration
2679        defaults. Here is an example with send-hook and the my_hdr directive:
2680
2681             send-hook . 'unmy_hdr From:'
2682             send-hook ~C'^b@b\.b$' my_hdr from: c@c.c
2683
2684        _\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
2685
2686        Hooks that act upon messages (send-hook, save-hook, fcc-hook, message-hook) are
2687        evaluated in a slightly different manner.  For the other types of hooks, a _\br_\be_\bg_\b-
2688        _\bu_\bl_\ba_\br _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 44) is sufficient.  But in dealing with
2689        messages a finer grain of control is needed for matching since for different
2690        purposes you want to match different criteria.
2691
2692        Mutt-ng allows the use of the _\bs_\be_\ba_\br_\bc_\bh _\bp_\ba_\bt_\bt_\be_\br_\bn (section 7.2  , page 80) language
2693        for matching messages in hook commands.  This works in exactly the same way as
2694        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
2695        to those operators which match information mutt extracts from the header of the
2696        message (i.e.  from, to, cc, date, subject, etc.).
2697
2698        For example, if you wanted to set your return address based upon sending mail
2699        to a specific address, you could do something like:
2700
2701             send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>'
2702
2703        which would execute the given command when sending mail to _\bm_\be_\b@_\bc_\bs_\b._\bh_\bm_\bc_\b._\be_\bd_\bu.
2704
2705        However, it is not required that you write the pattern to match using the full
2706        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
2707        other hooks, in which case Mutt-ng will translate your pattern into the full
2708        language, using the translation specified by the _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section
2709        7.4.45  , page 96) variable.  The pattern is translated at the time the hook is
2710        declared, so the value of _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section 7.4.45  , page 96) that is in
2711        effect at that time will be used.
2712
2713        _\b4_\b._\b6  _\bU_\bs_\bi_\bn_\bg _\bt_\bh_\be _\bs_\bi_\bd_\be_\bb_\ba_\br
2714
2715        The Mutt Next Generation E-Mail Client                                       55
2716
2717        The sidebar, a feature specific to Mutt-ng, allows you to use a mailbox listing
2718        which looks very similar to the ones you probably know from GUI mail clients.
2719        The sidebar lists all specified mailboxes, shows the number in each and high-
2720        lights the ones with new email Use the following configuration commands:
2721
2722             set sidebar_visible="yes"
2723             set sidebar_width=25
2724
2725        If you want to specify the mailboxes you can do so with:
2726
2727             set mbox='=INBOX'
2728             mailboxes INBOX \
2729                       MBOX1 \
2730                       MBOX2 \
2731                       ...
2732
2733        You can also specify the colors for mailboxes with new mails by using:
2734
2735             color sidebar_new red black
2736             color sidebar white black
2737
2738        The available functions are:
2739
2740             sidebar-scroll-up      Scrolls the mailbox list up 1 page
2741             sidebar-scroll-down    Scrolls the mailbox list down 1 page
2742             sidebar-next           Highlights the next mailbox
2743             sidebar-next-new       Highlights the next mailbox with new mail
2744             sidebar-previous       Highlights the previous mailbox
2745             sidebar-open           Opens the currently highlighted mailbox
2746
2747        Reasonable key bindings look e.g. like this:
2748
2749             bind index \Cp sidebar-prev
2750             bind index \Cn sidebar-next
2751             bind index \Cb sidebar-open
2752             bind pager \Cp sidebar-prev
2753             bind pager \Cn sidebar-next
2754             bind pager \Cb sidebar-open
2755
2756             macro index B ':toggle sidebar_visible^M'
2757             macro pager B ':toggle sidebar_visible^M'
2758
2759        You can then go up and down by pressing Ctrl-P and Ctrl-N, and switch on and
2760        off the sidebar simply by pressing 'B'.
2761
2762        _\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
2763
2764        The Mutt Next Generation E-Mail Client                                       56
2765
2766        Mutt-ng supports connecting to external directory databases such as LDAP,
2767        ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using a
2768        simple interface.  Using the _\b$_\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.222  , page 139) vari-
2769        able, you specify the wrapper command to use.  For example:
2770
2771             set query_command = "mutt_ldap_query.pl '%s'"
2772
2773        The wrapper script should accept the query on the command-line.  It should
2774        return a one line message, then each matching response on a single line, each
2775        line containing a tab separated address then name then some other optional
2776        information.  On error, or if there are no matching addresses, return a non-
2777        zero exit code and a one line error message.
2778
2779        An example multiple response output:
2780
2781             Searching database ... 20 entries ... 3 matching:
2782             me@cs.hmc.edu           Michael Elkins  mutt dude
2783             blong@fiction.net       Brandon Long    mutt and more
2784             roessler@guug.de        Thomas Roessler mutt pgp
2785
2786        There are two mechanisms for accessing the query function of mutt.  One is to
2787        do a query from the index menu using the query function (default: Q).  This
2788        will prompt for a query, then bring up the query menu which will list the
2789        matching responses.  From the query menu, you can select addresses to create
2790        aliases, or to mail.  You can tag multiple addresses to mail, start a new
2791        query, or have a new query appended to the current responses.
2792
2793        The other mechanism for accessing the query function is for address completion,
2794        similar to the alias completion.  In any prompt for address entry, you can use
2795        the complete-query function (default: ^T) to run a query based on the current
2796        address you have typed.  Like aliases, mutt will look for what you have typed
2797        back to the last space or comma.  If there is a single response for that query,
2798        mutt will expand the address in place.  If there are multiple responses, mutt
2799        will activate the query menu.  At the query menu, you can select one or more
2800        addresses to be added to the prompt.
2801
2802        _\b4_\b._\b8  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bF_\bo_\br_\bm_\ba_\bt_\bs
2803
2804        Mutt-ng supports reading and writing of four different mailbox formats: mbox,
2805        MMDF, MH and Maildir.  The mailbox type is autodetected, so there is no need to
2806        use a flag for different mailbox types.  When creating new mailboxes, Mutt-ng
2807        uses the default specified with the _\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.126  , page 116)
2808        variable.
2809
2810        m\bmb\bbo\box\bx.  This is the most widely used mailbox format for UNIX.  All messages are
2811        stored in a single file.  Each message has a line of the form:
2812
2813             From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
2814
2815        The Mutt Next Generation E-Mail Client                                       57
2816
2817        to denote the start of a new message (this is often referred to as the
2818        ``From_'' line).
2819
2820        M\bMM\bMD\bDF\bF.  This is a variant of the _\bm_\bb_\bo_\bx format.  Each message is surrounded by
2821        lines containing ``^A^A^A^A'' (four control-A's).
2822
2823        M\bMH\bH. A radical departure from _\bm_\bb_\bo_\bx and _\bM_\bM_\bD_\bF, a mailbox consists of a directory
2824        and each message is stored in a separate file.  The filename indicates the mes-
2825        sage number (however, this is may not correspond to the message number Mutt-ng
2826        displays). Deleted messages are renamed with a comma (,) prepended to the file-
2827        name. N\bNo\bot\bte\be:\b: Mutt detects this type of mailbox by looking for either
2828        .mh_sequences or .xmhcache (needed to distinguish normal directories from MH
2829        mailboxes).
2830
2831        M\bMa\bai\bil\bld\bdi\bir\br.  The newest of the mailbox formats, used by the Qmail MTA (a replace-
2832        ment for sendmail).  Similar to _\bM_\bH, except that it adds three subdirectories of
2833        the mailbox: _\bt_\bm_\bp, _\bn_\be_\bw and _\bc_\bu_\br.  Filenames for the messages are chosen in such a
2834        way they are unique, even when two programs are writing the mailbox over NFS,
2835        which means that no file locking is needed.
2836
2837        _\b4_\b._\b9  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bS_\bh_\bo_\br_\bt_\bc_\bu_\bt_\bs
2838
2839        There are a number of built in shortcuts which refer to specific mailboxes.
2840        These shortcuts can be used anywhere you are prompted for a file or mailbox
2841        path.
2842
2843           +\bo ! -- refers to your _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.297  , page 157) (incoming)
2844             mailbox
2845
2846           +\bo > -- refers to your _\b$_\bm_\bb_\bo_\bx (section 7.4.125  , page 116) file
2847
2848           +\bo < -- refers to your _\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.231  , page 141) file
2849
2850           +\bo ^ -- refers to the current mailbox
2851
2852           +\bo - or !! -- refers to the file you've last visited
2853
2854           +\bo ~ -- refers to your home directory
2855
2856           +\bo = or + -- refers to your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.64  , page 100) directory
2857
2858           +\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 35) as
2859             determined by the address of the alias
2860
2861        _\b4_\b._\b1_\b0  _\bH_\ba_\bn_\bd_\bl_\bi_\bn_\bg _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
2862
2863        Mutt-ng has a few configuration options that make dealing with large amounts of
2864        mail easier.  The first thing you must do is to let Mutt know what addresses
2865        you consider to be mailing lists (technically this does not have to be a mail-
2866        ing list, but that is what it is most often used for), and what lists you are
2867
2868        The Mutt Next Generation E-Mail Client                                       58
2869
2870        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
2871        (section 3.12  , page 32) commands in your muttrc.
2872
2873        Now that Mutt-ng knows what your mailing lists are, it can do several things,
2874        the first of which is the ability to show the name of a list through which you
2875        received a message (i.e., of a subscribed list) in the _\bi_\bn_\bd_\be_\bx menu display.
2876        This is useful to distinguish between personal and list mail in the same mail-
2877        box.  In the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111) variable, the escape
2878        ``%L'' will return the string ``To <list>'' when ``list'' appears in the ``To''
2879        field, and ``Cc <list>'' when it appears in the ``Cc'' field (otherwise it
2880        returns the name of the author).
2881
2882        Often times the ``To'' and ``Cc'' fields in mailing list messages tend to get
2883        quite large. Most people do not bother to remove the author of the message they
2884        are reply to from the list, resulting in two or more copies being sent to that
2885        person.  The ``list-reply'' function, which by default is bound to ``L'' in the
2886        _\bi_\bn_\bd_\be_\bx menu and _\bp_\ba_\bg_\be_\br, helps reduce the clutter by only replying to the known
2887        mailing list addresses instead of all recipients (except as specified by Mail-
2888        Followup-To, see below).
2889
2890        Mutt-ng also supports the Mail-Followup-To header.  When you send a message to
2891        a list of recipients which includes one or several subscribed mailing lists,
2892        and if the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 7.4.66  , page 101) option is set, mutt will
2893        generate a Mail-Followup-To header which contains all the recipients to whom
2894        you send this message, but not your address. This indicates that group-replies
2895        or list-replies (also known as ``followups'') to this message should only be
2896        sent to the original recipients of the message, and not separately to you -
2897        you'll receive your copy through one of the mailing lists you are subscribed
2898        to.
2899
2900        Conversely, when group-replying or list-replying to a message which has a Mail-
2901        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
2902        (section 7.4.88  , page 106) configuration variable is set.  Using list-reply
2903        will in this case also make sure that the reply goes to the mailing list, even
2904        if it's not specified in the list of recipients in the Mail-Followup-To.
2905
2906        Note that, when header editing is enabled, you can create a Mail-Followup-To
2907        header manually.  Mutt-ng will only auto-generate this header if it doesn't
2908        exist when you send the message.
2909
2910        The other method some mailing list admins use is to generate a ``Reply-To''
2911        field which points back to the mailing list address rather than the author of
2912        the message.  This can create problems when trying to reply directly to the
2913        author in private, since most mail clients will automatically reply to the
2914        address given in the ``Reply-To'' field.  Mutt-ng uses the _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section
2915        7.4.234  , page 142) variable to help decide which address to use.  If set to
2916        _\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
2917        use the address given in the ``Reply-To'' field, or reply directly to the
2918        address given in the ``From'' field.  When set to _\by_\be_\bs, the ``Reply-To'' field
2919        will be used when present.
2920
2921        The ``X-Label:'' header field can be used to further identify mailing lists or
2922        list subject matter (or just to annotate messages individually).  The
2923        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111) variable's ``%y'' and ``%Y''
2924
2925        The Mutt Next Generation E-Mail Client                                       59
2926
2927        escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's
2928        pattern-matcher can match regular expressions to ``X-Label:'' fields with the
2929        ``~y'' selector.  ``X-Label:'' is not a standard message header field, but it
2930        can easily be inserted by procmail and other mail filtering agents.
2931
2932        Lastly, Mutt-ng has the ability to _\bs_\bo_\br_\bt (section 7.4.291  , page 155) the mail-
2933        box into _\bt_\bh_\br_\be_\ba_\bd_\bs (section 2.5.3  , page 11).  A thread is a group of messages
2934        which all relate to the same subject.  This is usually organized into a tree-
2935        like structure where a message and all of its replies are represented graphi-
2936        cally.  If you've ever used a threaded news client, this is the same concept.
2937        It makes dealing with large volume mailing lists easier because you can easily
2938        delete uninteresting threads and quickly find topics of value.
2939
2940        _\b4_\b._\b1_\b1  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2941
2942        Mutt-ng has the ability to dynamically restructure threads that are broken
2943        either by misconfigured software or bad behavior from some correspondents. This
2944        allows to clean your mailboxes formats) from these annoyances which make it
2945        hard to follow a discussion.
2946
2947        _\b4_\b._\b1_\b1_\b._\b1  _\bL_\bi_\bn_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2948
2949        Some mailers tend to "forget" to correctly set the "In-Reply-To:" and "Refer-
2950        ences:" headers when replying to a message. This results in broken discussions
2951        because Mutt-ng has not enough information to guess the correct threading.  You
2952        can fix this by tagging the reply, then moving to the parent message and using
2953        the ``link-threads'' function (bound to & by default). The reply will then be
2954        connected to this "parent" message.
2955
2956        You can also connect multiple children at once, tagging them and using the tag-
2957        prefix command (';') or the auto_tag option.
2958
2959        _\b4_\b._\b1_\b1_\b._\b2  _\bB_\br_\be_\ba_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2960
2961        On mailing lists, some people are in the bad habit of starting a new discussion
2962        by hitting "reply" to any message from the list and changing the subject to a
2963        totally unrelated one.  You can fix such threads by using the ``break-thread''
2964        function (bound by default to #), which will turn the subthread starting from
2965        the current message into a whole different thread.
2966
2967        _\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
2968
2969        RFC1894 defines a set of MIME content types for relaying information about the
2970        status of electronic mail messages.  These can be thought of as ``return
2971        receipts.''
2972
2973        Users can make use of it in one of the following two ways:
2974
2975           +\bo Berkeley sendmail 8.8.x currently has some command line options in which
2976             the mail client can make requests as to what type of status messages
2977
2978        The Mutt Next Generation E-Mail Client                                       60
2979
2980             should be returned.
2981
2982           +\bo The SMTP support via libESMTP supports it, too.
2983
2984        To support this, there are two variables:
2985
2986           +\bo _\b$_\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by (section 7.4.51  , page 97) is used to request receipts for
2987             different results (such as failed message, message delivered, etc.).
2988
2989           +\bo _\b$_\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn (section 7.4.52  , page 97) requests how much of your message
2990             should be returned with the receipt (headers or full message).
2991
2992        Please see the reference chapter for possible values.
2993
2994        _\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)
2995
2996        If Mutt-ng was compiled with POP3 support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
2997        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
2998        remote POP3 server and fetch mail for local browsing.
2999
3000        You can access the remote POP3 mailbox by selecting the folder
3001        pop://popserver/.
3002
3003        You can select an alternative port by specifying it with the server, i.e.:
3004        pop://popserver:port/.
3005
3006        You can also specify different username for each folder, i.e.: pop://user-
3007        name@popserver[:port]/.
3008
3009        Polling for new mail is more expensive over POP3 than locally. For this reason
3010        the frequency at which Mutt-ng will check for mail remotely can be controlled
3011        by the _\b$_\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.209  , page 137) variable, which defaults
3012        to every 60 seconds.
3013
3014        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3015        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to POP3 servers can be encrypted. This natu-
3016        rally requires that the server supports SSL encrypted connections. To access a
3017        folder with POP3/SSL, you should use pops: prefix, ie: pops://[user-
3018        name@]popserver[:port]/.
3019
3020        Another way to access your POP3 mail is the _\bf_\be_\bt_\bc_\bh_\b-_\bm_\ba_\bi_\bl function (default: G).
3021        It allows to connect to _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.207  , page 136), fetch all your
3022        new mail and place it in the local _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.297  , page 157).
3023        After this point, Mutt-ng runs exactly as if the mail had always been local.
3024
3025        N\bNo\bot\bte\be:\b: If you only need to fetch all messages to local mailbox you should con-
3026        sider using a specialized program, such as fetchmail
3027
3028        _\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)
3029
3030        The Mutt Next Generation E-Mail Client                                       61
3031
3032        If Mutt-ng was compiled with IMAP support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3033        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
3034        remote IMAP server.
3035
3036        You can access the remote inbox by selecting the folder
3037        imap://imapserver/INBOX, where imapserver is the name of the IMAP server and
3038        INBOX is the special name for your spool mailbox on the IMAP server. If you
3039        want to access another mail folder at the IMAP server, you should use
3040        imap://imapserver/path/to/folder where path/to/folder is the path of the folder
3041        you want to access.
3042
3043        You can select an alternative port by specifying it with the server, i.e.:
3044        imap://imapserver:port/INBOX.
3045
3046        You can also specify different username for each folder, i.e.: imap://user-
3047        name@imapserver[:port]/INBOX.
3048
3049        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
3050        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to IMAP servers can be encrypted. This natu-
3051        rally requires that the server supports SSL encrypted connections. To access a
3052        folder with IMAP/SSL, you should use imaps://[user-
3053        name@]imapserver[:port]/path/to/folder as your folder path.
3054
3055        Pine-compatible notation is also supported, i.e.  {[user-
3056        name@]imapserver[:port][/ssl]}path/to/folder
3057
3058        Note that not all servers use / as the hierarchy separator.  Mutt-ng should
3059        correctly notice which separator is being used by the server and convert paths
3060        accordingly.
3061
3062        When browsing folders on an IMAP server, you can toggle whether to look at only
3063        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
3064        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.97  , page 108) vari-
3065        able.
3066
3067        Polling for new mail on an IMAP server can cause noticeable delays. So, you'll
3068        want to carefully tune the _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.99  , page 108) and
3069        _\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.321  , page 164) variables.
3070
3071        Note that if you are using mbox as the mail store on UW servers prior to
3072        v12.250, the server has been reported to disconnect a client if another client
3073        selects the same folder.
3074
3075        _\b4_\b._\b1_\b4_\b._\b1  _\bT_\bh_\be _\bF_\bo_\bl_\bd_\be_\br _\bB_\br_\bo_\bw_\bs_\be_\br
3076
3077        As of version 1.2, mutt supports browsing mailboxes on an IMAP server. This is
3078        mostly the same as the local file browser, with the following differences:
3079
3080           +\bo Instead of file permissions, mutt displays the string "IMAP", possibly
3081             followed by the symbol "+", indicating that the entry contains both mes-
3082             sages and subfolders. On Cyrus-like servers folders will often contain
3083             both messages and subfolders.
3084
3085        The Mutt Next Generation E-Mail Client                                       62
3086
3087           +\bo For the case where an entry can contain both messages and subfolders, the
3088             selection key (bound to enter by default) will choose to descend into the
3089             subfolder view. If you wish to view the messages in that folder, you must
3090             use view-file instead (bound to space by default).
3091
3092           +\bo You can create, delete and rename mailboxes with the create-mailbox,
3093             delete-mailbox, and rename-mailbox commands (default bindings: C, d and r,
3094             respectively). You may also subscribe and unsubscribe to mailboxes (nor-
3095             mally these are bound to s and u, respectively).
3096
3097        _\b4_\b._\b1_\b4_\b._\b2  _\bA_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bi_\bo_\bn
3098
3099        Mutt-ng supports four authentication methods with IMAP servers: SASL, GSSAPI,
3100        CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add NTLM authentica-
3101        tion for you poor exchange users out there, but it has yet to be integrated
3102        into the main tree). There is also support for the pseudo-protocol ANONYMOUS,
3103        which allows you to log in to a public IMAP server without having an account.
3104        To use ANONYMOUS, simply make your username blank or "anonymous".
3105
3106        SASL is a special super-authenticator, which selects among several protocols
3107        (including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure method
3108        available on your host and the server. Using some of these methods (including
3109        DIGEST-MD5 and possibly GSSAPI), your entire session will be encrypted and
3110        invisible to those teeming network snoops. It is the best option if you have
3111        it. To use it, you must have the Cyrus SASL library installed on your system
3112        and compile mutt with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\ba_\bs_\bl flag.
3113
3114        Mutt-ng will try whichever methods are compiled in and available on the server,
3115        in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.
3116
3117        There are a few variables which control authentication:
3118
3119           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.105  , page 110) - controls the username under
3120             which you request authentication on the IMAP server, for all authentica-
3121             tors. This is overridden by an explicit username in the mailbox path (i.e.
3122             by using a mailbox name of the form {user@host}).
3123
3124           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.100  , page 109) - a password which you may pre-
3125             set, used by all authentication methods where a password is needed.
3126
3127           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs (section 7.4.91  , page 106) - a colon-delimited list
3128             of IMAP authentication methods to try, in the order you wish to try them.
3129             If specified, this overrides mutt's default (attempt everything, in the
3130             order listed above).
3131
3132        _\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)
3133
3134        If compiled with ``--enable-nntp'' option, Mutt-ng can read news from a
3135        newsserver via NNTP.  You can open a newsgroup with the ``change-newsgroup''
3136        function from the index/pager which is by default bound to i.
3137
3138        The Default newsserver can be obtained from the $NNTPSERVER environment
3139
3140        The Mutt Next Generation E-Mail Client                                       63
3141
3142        variable. Like other news readers, info about subscribed newsgroups is saved in
3143        a file as specified by the _\b$_\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc (section 7.4.157  , page 124) variable.
3144        Article headers are cached and can be loaded from a file when a newsgroup is
3145        entered instead loading from newsserver; currently, this caching mechanism
3146        still is different from the header caching for maildir/IMAP.
3147
3148        _\b4_\b._\b1_\b5_\b._\b1  _\bA_\bg_\ba_\bi_\bn_\b: _\bS_\bc_\bo_\br_\bi_\bn_\bg
3149
3150        Especially for Usenet, people often ask for advanced filtering and scoring
3151        functionality. Of course, mutt-ng has scoring and allows a killfile, too. How
3152        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
3153        38).
3154
3155        What has not been discusses in detail is mutt-ng's built-in realname filter.
3156        For may newsreaders including those for ``advanced users'' like _\bs_\bl_\br_\bn or _\bt_\bi_\bn,
3157        there are frequent request for such functionality. The solutions offered often
3158        are complicated regular expressions.
3159
3160        In mutt-ng this is as easy as
3161
3162             score ~* =42
3163
3164        This tells mutt-ng to apply a score of 42 to all messages whose sender speci-
3165        fied a valid realname and a valid email address. Using
3166
3167             score !~* =42
3168
3169        on the contrary applies a score of 42 to all messages _\bn_\bo_\bt matching those crite-
3170        ria which are very strict:
3171
3172           +\bo Email addresses must be valid according to RFC 2822, see <ftp://ftp.rfc-
3173             editor.org/in-notes/rfc2822.txt>
3174
3175           +\bo the name must consist of at least 2 fields whereby a field must not end in
3176             a dot. This means that ``Joe User'' and ``Joe A.  User'' are valid while
3177             ``J. User'' and ``J. A. User'' aren't.
3178
3179           +\bo it's assumed that users are interested in reading their own mail and mail
3180             from people who they have defined an alias for so that those 2 groups of
3181             messages are excluded from the strict rules.
3182
3183        _\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)
3184
3185        Mutt-ng can be built using a library called ``libESMTP'' which provides SMTP
3186
3187        The Mutt Next Generation E-Mail Client                                       64
3188
3189        functionality. When configure was called with --with-libesmtp or the output
3190        muttng -v contains +USE_LIBESMTP, this will be or is the case already. The SMTP
3191        support includes support for Delivery Status Notification (see _\bD_\be_\bl_\bi_\bv_\be_\br_\by _\bS_\bt_\ba_\bt_\bu_\bs
3192        _\bN_\bo_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\bi_\bo_\bn (section 4.12  , page 59) section) as well as handling the 8BIT-
3193        MIME flag controlled via _\b$_\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be (section 7.4.328  , page 166).
3194
3195        To enable sending mail directly via SMTP without an MTA such as Postfix or
3196        SSMTP and the like, simply set the _\b$_\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt (section 7.4.286  , page 154)
3197        variable pointing to your SMTP server.
3198
3199        Authentication mechanisms are available via the _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section 7.4.290  ,
3200        page 155) and _\b$_\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs (section 7.4.287  , page 154) variables.
3201
3202        Transport Encryption via the StartTLS command is also available. For this to
3203        work, first of all Mutt-ng must be built with SSL or GNUTLS.  Secondly, the
3204        _\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs (section 7.4.289  , page 155) variable must be either set to
3205        ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server
3206        supports it: for the second case, the connection will fail if it doesn't while
3207        switching back to unencrypted communication for the first one.
3208
3209        Some mail providers require user's to set a particular envelope sender, i.e.
3210        they allow for only one value which may not be what the user wants to send as
3211        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.285  ,
3212        page 154) may be used to set the envelope different from the From: header.
3213
3214        _\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)
3215
3216        If you happen to have accounts on multiple IMAP and/or POP servers, you may
3217        find managing all the authentication settings inconvenient and error-prone.
3218        The account-hook command may help. This hook works like folder-hook but is
3219        invoked whenever you access a remote mailbox (including inside the folder
3220        browser), not just when you open the mailbox.
3221
3222        Some examples:
3223
3224             account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
3225             account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
3226             account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
3227
3228        _\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)
3229
3230        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
3231        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
3232        start a WWW browser on one of them.  This functionality is provided by the
3233        external urlview program which can be retrieved at ftp://ftp.mutt.org/mutt/con-
3234        trib/ and the configuration commands:
3235
3236             macro index \cb |urlview\n
3237             macro pager \cb |urlview\n
3238
3239        The Mutt Next Generation E-Mail Client                                       65
3240
3241        _\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)
3242
3243        If Mutt-ng was compiled with compressed folders support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\b-
3244        _\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
3245        an arbitrary format, provided that the user has a script to convert from/to
3246        this format to one of the accepted.
3247
3248        The most common use is to open compressed archived folders e.g. with gzip.
3249
3250        In addition, the user can provide a script that gets a folder in an accepted
3251        format and appends its context to the folder in the user-defined format, which
3252        may be faster than converting the entire folder to the accepted format, append-
3253        ing to it and converting back to the user-defined format.
3254
3255        There are three hooks defined (_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 65), _\bc_\bl_\bo_\bs_\be_\b-
3256        _\bh_\bo_\bo_\bk (section 4.19.2  , page 65) and _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 66))
3257        which define commands to uncompress and compress a folder and to append mes-
3258        sages to an existing compressed folder respectively.
3259
3260        For example:
3261
3262             open-hook \\.gz$ "gzip -cd %f > %t"
3263             close-hook \\.gz$ "gzip -c %t > %f"
3264             append-hook \\.gz$ "gzip -c %t >> %f"
3265
3266        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-
3267        tion 4.19.3  , page 66), the folder will be open and closed again each time you
3268        will add to it. If you omit _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 65) (or give
3269        empty command) , the folder will be open in the  mode. If you specify _\ba_\bp_\bp_\be_\bn_\bd_\b-
3270        _\bh_\bo_\bo_\bk (section 4.19.3  , page 66) though you'll be able to append to the folder.
3271
3272        Note that Mutt-ng will only try to use hooks if the file is not in one of the
3273        accepted formats. In particular, if the file is empty, mutt supposes it is not
3274        compressed. This is important because it allows the use of programs that do not
3275        have well defined extensions. Just use '.' as a regexp. But this may be sur-
3276        prising if your compressing script produces empty files. In this situation,
3277        unset _\b$_\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by (section 7.4.241  , page 144), so that the compressed file
3278        will be removed if you delete all of the messages.
3279
3280        _\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
3281
3282        Usage: open-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3283
3284        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd is the command that can be used for opening the folders whose names
3285        match _\br_\be_\bg_\be_\bx_\bp.
3286
3287        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the printf-like format string, and it should accept two
3288        parameters: %f, which is replaced with the (compressed) folder name, and %t
3289        which is replaced with the name of the temporary folder to which to write.
3290
3291        %f and %t can be repeated any number of times in the command string, and all of
3292        the entries are replaced with the appropriate folder name. In addition, %% is
3293
3294        The Mutt Next Generation E-Mail Client                                       66
3295
3296        replaced by %, as in printf, and any other %anything is left as is.
3297
3298        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
3299        return non-zero exit status if it fails, so mutt knows something's wrong.
3300
3301        Example:
3302
3303             open-hook \\.gz$ "gzip -cd %f > %t"
3304
3305        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type.
3306
3307        _\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
3308
3309        Usage: close-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3310
3311        This is used to close the folder that was open with the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3312        4.19.1  , page 65) command after some changes were made to it.
3313
3314        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the command that can be used for closing the folders
3315        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
3316        4.19.1  , page 65) command. Temporary folder in this case is the folder previ-
3317        ously produced by the <_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 65) command.
3318
3319        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
3320        non-zero exit status if it fails, so mutt knows something's wrong.
3321
3322        Example:
3323
3324             close-hook \\.gz$ "gzip -c %t > %f"
3325
3326        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type, and the
3327        file can only be open in the readonly mode.
3328
3329        _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 65) is not called when you exit from the
3330        folder if the folder was not changed.
3331
3332        _\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
3333
3334        Usage: append-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
3335
3336        This command is used for saving to an existing compressed folder.  The _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3337        is the command that can be used for appending to the folders whose names match
3338        _\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 65)
3339        command.  The temporary folder in this case contains the messages that are
3340        being appended.
3341
3342        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
3343        non-zero exit status if it fails, so mutt knows something's wrong.
3344
3345        Example:
3346
3347        The Mutt Next Generation E-Mail Client                                       67
3348
3349             append-hook \\.gz$ "gzip -c %t >> %f"
3350
3351        When _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 66) is used, the folder is not opened,
3352        which saves time, but this means that we can not find out what the folder type
3353        is. Thus the default (_\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 7.4.126  , page 116)) type is always
3354        supposed (i.e.  this is the format used for the temporary folder).
3355
3356        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  ,
3357        page 65) is called, and not _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 66). _\ba_\bp_\bp_\be_\bn_\bd_\b-
3358        _\bh_\bo_\bo_\bk (section 4.19.3  , page 66) is only for appending to existing folders.
3359
3360        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type. In this
3361        case, the folder will be open and closed again (using _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
3362        4.19.1  , page 65) and _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 65)respectively) each
3363        time you will add to it.
3364
3365        _\b4_\b._\b1_\b9_\b._\b4  _\bE_\bn_\bc_\br_\by_\bp_\bt_\be_\bd _\bf_\bo_\bl_\bd_\be_\br_\bs
3366
3367        The compressed folders support can also be used to handle encrypted folders. If
3368        you want to encrypt a folder with PGP, you may want to use the following hooks:
3369
3370             open-hook  \\.pgp$ "pgp -f < %f > %t"
3371             close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
3372
3373        Please note, that PGP does not support appending to an encrypted folder, so
3374        there is no append-hook defined.
3375
3376        N\bNo\bot\bte\be:\b: the folder is temporary stored decrypted in the /tmp directory, where it
3377        can be read by your system administrator. So think about the security aspects
3378        of this.
3379
3380        _\b5_\b.  _\bM_\bu_\bt_\bt_\b-_\bn_\bg_\b'_\bs _\bM_\bI_\bM_\bE _\bS_\bu_\bp_\bp_\bo_\br_\bt
3381
3382        Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME
3383        MUA.  Every effort has been made to provide the functionality that the discern-
3384        ing MIME user requires, and the conformance to the standards wherever possible.
3385        When configuring Mutt-ng for MIME, there are two extra types of configuration
3386        files which Mutt-ng uses.  One is the mime.types file, which contains the map-
3387        ping of file extensions to IANA MIME types.  The other is the mailcap file,
3388        which specifies the external commands to use for handling specific MIME types.
3389
3390        _\b5_\b._\b1  _\bU_\bs_\bi_\bn_\bg _\bM_\bI_\bM_\bE _\bi_\bn _\bM_\bu_\bt_\bt
3391
3392        There are three areas/menus in Mutt-ng which deal with MIME, they are the pager
3393        (while viewing a message), the attachment menu and the compose menu.
3394
3395        The Mutt Next Generation E-Mail Client                                       68
3396
3397        _\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
3398
3399        When you select a message from the index and view it in the pager, Mutt decodes
3400        the message to a text representation.  Mutt-ng internally supports a number of
3401        MIME types, including text/plain, text/enriched, message/rfc822, and mes-
3402        sage/news.  In addition, the export controlled version of Mutt-ng recognizes a
3403        variety of PGP MIME types, including PGP/MIME and application/pgp.
3404
3405        Mutt-ng will denote attachments with a couple lines describing them.  These
3406        lines are of the form:
3407
3408             [-- Attachment #1: Description --]
3409             [-- Type: text/plain, Encoding: 7bit, Size: 10000 --]
3410
3411        Where the Description is the description or filename given for the attachment,
3412        and the Encoding is one of 7bit/8bit/quoted-printable/base64/binary.
3413
3414        If Mutt-ng cannot deal with a MIME type, it will display a message like:
3415
3416             [-- image/gif is unsupported (use 'v' to view this part) --]
3417
3418        _\b5_\b._\b1_\b._\b2  _\bT_\bh_\be _\bA_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bM_\be_\bn_\bu
3419
3420        The default binding for view-attachments is `v', which displays the attachment
3421        menu for a message.  The attachment menu displays a list of the attachments in
3422        a message.  From the attachment menu, you can save, print, pipe, delete, and
3423        view attachments.  You can apply these operations to a group of attachments at
3424        once, by tagging the attachments and by using the ``tag-prefix'' operator.  You
3425        can also reply to the current message from this menu, and only the current
3426        attachment (or the attachments tagged) will be quoted in your reply.  You can
3427        view attachments as text, or view them using the mailcap viewer definition.
3428
3429        Finally, you can apply the usual message-related functions (like _\br_\be_\bs_\be_\bn_\bd_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be
3430        (section 2.5.4  , page 13), and the reply and forward functions) to attachments
3431        of type message/rfc822.
3432
3433        See the help on the attachment menu for more information.
3434
3435        _\b5_\b._\b1_\b._\b3  _\bT_\bh_\be _\bC_\bo_\bm_\bp_\bo_\bs_\be _\bM_\be_\bn_\bu
3436
3437        The compose menu is the menu you see before you send a message.  It allows you
3438        to edit the recipient list, the subject, and other aspects of your message.  It
3439        also contains a list of the attachments of your message, including the main
3440        body.  From this menu, you can print, copy, filter, pipe, edit, compose,
3441        review, and rename an attachment or a list of tagged attachments.  You can also
3442        modifying the attachment information, notably the type, encoding and descrip-
3443        tion.
3444
3445        Attachments appear as follows:
3446
3447             -   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 <no description>
3448                 2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz <no description>
3449
3450        The Mutt Next Generation E-Mail Client                                       69
3451
3452        The '-' denotes that Mutt-ng will delete the file after sending (or postponing,
3453        or canceling) the message.  It can be toggled with the toggle-unlink command
3454        (default: u).  The next field is the MIME content-type, and can be changed with
3455        the edit-type command (default: ^T).  The next field is the encoding for the
3456        attachment, which allows a binary message to be encoded for transmission on
3457        7bit links.  It can be changed with the edit-encoding command (default: ^E).
3458        The next field is the size of the attachment, rounded to kilobytes or
3459        megabytes.  The next field is the filename, which can be changed with the
3460        rename-file command (default: R).  The final field is the description of the
3461        attachment, and can be changed with the edit-description command (default: d).
3462
3463        _\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
3464
3465        When you add an attachment to your mail message, Mutt-ng searches your personal
3466        mime.types file at ${HOME}/.mime.types, and then the system mime.types file at
3467        /usr/local/share/mutt/mime.types or /etc/mime.types
3468
3469        The mime.types file consist of lines containing a MIME type and a space sepa-
3470        rated list of extensions.  For example:
3471
3472             application/postscript          ps eps
3473             application/pgp                 pgp
3474             audio/x-aiff                    aif aifc aiff
3475
3476        A sample mime.types file comes with the Mutt-ng distribution, and should con-
3477        tain most of the MIME types you are likely to use.
3478
3479        If Mutt-ng can not determine the mime type by the extension of the file you
3480        attach, it will look at the file.  If the file is free of binary information,
3481        Mutt-ng will assume that the file is plain text, and mark it as text/plain.  If
3482        the file contains binary information, then Mutt-ng will mark it as applica-
3483        tion/octet-stream.  You can change the MIME type that Mutt-ng assigns to an
3484        attachment by using the edit-type command from the compose menu (default: ^T).
3485        The MIME type is actually a major mime type followed by the sub-type, separated
3486        by a '/'. 6 major types: application, text, image, video, audio, and model have
3487        been approved after various internet discussions. Mutt-ng recognises all of
3488        these if the appropriate entry is found in the mime.types file. It also recog-
3489        nises other major mime types, such as the chemical type that is widely used in
3490        the molecular modelling community to pass molecular data in various forms to
3491        various molecular viewers. Non-recognised mime types should only be used if the
3492        recipient of the message is likely to be expecting such attachments.
3493
3494        _\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
3495
3496        Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix specific
3497        format specified in Appendix A of RFC 1524.  This file format is commonly
3498        referred to as the mailcap format.  Many MIME compliant programs utilize the
3499        mailcap format, allowing you to specify handling for all MIME types in one
3500        place for all programs.  Programs known to use this format include Netscape,
3501
3502        The Mutt Next Generation E-Mail Client                                       70
3503
3504        XMosaic, lynx and metamail.
3505
3506        In order to handle various MIME types that Mutt-ng can not handle internally,
3507        Mutt-ng parses a series of external configuration files to find an external
3508        handler.  The default search string for these files is a colon delimited list
3509        set to
3510
3511             ${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
3512
3513        where $HOME is your home directory.
3514
3515        In particular, the metamail distribution will install a mailcap file, usually
3516        as /usr/local/etc/mailcap, which contains some baseline entries.
3517
3518        _\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
3519
3520        A mailcap file consists of a series of lines which are comments, blank, or def-
3521        initions.
3522
3523        A comment line consists of a # character followed by anything you want.
3524
3525        A blank line is blank.
3526
3527        A definition line consists of a content type, a view command, and any number of
3528        optional fields.  Each field of a definition line is divided by a semicolon ';'
3529        character.
3530
3531        The content type is specified in the MIME standard type/subtype method.  For
3532        example, text/plain, text/html, image/gif, etc.  In addition, the mailcap for-
3533        mat includes two formats for wildcards, one using the special '*' subtype, the
3534        other is the implicit wild, where you only include the major type.  For exam-
3535        ple, image/*, or video, will match all image types and video types, respec-
3536        tively.
3537
3538        The view command is a Unix command for viewing the type specified. There are
3539        two different types of commands supported. The default is to send the body of
3540        the MIME message to the command on stdin. You can change this behavior by using
3541        %s as a parameter to your view command.  This will cause Mutt-ng to save the
3542        body of the MIME message to a temporary file, and then call the view command
3543        with the %s replaced by the name of the temporary file. In both cases, Mutt-ng
3544        will turn over the terminal to the view program until the program quits, at
3545        which time Mutt will remove the temporary file if it exists.
3546
3547        So, in the simplest form, you can send a text/plain message to the external
3548        pager more on stdin:
3549
3550             text/plain; more
3551
3552        Or, you could send the message as a file:
3553
3554             text/plain; more %s
3555
3556        The Mutt Next Generation E-Mail Client                                       71
3557
3558        Perhaps you would like to use lynx to interactively view a text/html message:
3559
3560             text/html; lynx %s
3561
3562        In this case, lynx does not support viewing a file from stdin, so you must use
3563        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
3564        _\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
3565        _\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
3566        _\bv_\bi_\be_\bw _\bt_\bh_\be _\bo_\bb_\bj_\be_\bc_\bt_\b.
3567
3568        On the other hand, maybe you don't want to use lynx interactively, you just
3569        want to have it convert the text/html to text/plain, then you can use:
3570
3571             text/html; lynx -dump %s | more
3572
3573        Perhaps you wish to use lynx to view text/html files, and a pager on all other
3574        text formats, then you would use the following:
3575
3576             text/html; lynx %s
3577             text/*; more
3578
3579        This is the simplest form of a mailcap file.
3580
3581        _\b5_\b._\b3_\b._\b2  _\bS_\be_\bc_\bu_\br_\be _\bu_\bs_\be _\bo_\bf _\bm_\ba_\bi_\bl_\bc_\ba_\bp
3582
3583        The interpretation of shell meta-characters embedded in MIME parameters can
3584        lead to security problems in general.  Mutt-ng tries to quote parameters in
3585        expansion of %s syntaxes properly, and avoids risky characters by substituting
3586        them, see the _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 7.4.117  , page 115) variable.
3587
3588        Although mutt's procedures to invoke programs with mailcap seem to be safe,
3589        there are other applications parsing mailcap, maybe taking less care of it.
3590        Therefore you should pay attention to the following rules:
3591
3592        _\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
3593        double quotes.  Mutt-ng does this for you, the right way, as should any other
3594        program which interprets mailcap.  Don't put them into backtick expansions.  Be
3595        highly careful with eval statements, and avoid them if possible at all.  Trying
3596        to fix broken behaviour with quotes introduces new leaks - there is no alterna-
3597        tive to correct quoting in the first place.
3598
3599        If you have to use the %-expandos' values in context where you need quoting or
3600        backtick expansions, put that value into a shell variable and reference the
3601        shell variable where necessary, as in the following example (using $charset
3602        inside the backtick expansion is safe, since it is not itself subject to any
3603        further expansion):
3604
3605             text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \
3606                     && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1
3607
3608        The Mutt Next Generation E-Mail Client                                       72
3609
3610        _\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
3611
3612        _\b5_\b._\b3_\b._\b3_\b._\b1  _\bO_\bp_\bt_\bi_\bo_\bn_\ba_\bl _\bF_\bi_\be_\bl_\bd_\bs
3613
3614        In addition to the required content-type and view command fields, you can add
3615        semi-colon ';' separated fields to set flags and other options.  Mutt-ng recog-
3616        nizes the following optional fields:
3617
3618              copiousoutput
3619                    This flag tells Mutt-ng that the command passes possibly large
3620                    amounts of text on stdout.  This causes Mutt-ng to invoke a pager
3621                    (either the internal pager or the external pager defined by the
3622                    pager variable) on the output of the view command.  Without this
3623                    flag, Mutt-ng assumes that the command is interactive.  One could
3624                    use this to replace the pipe to more in the lynx -dump example in
3625                    the Basic section:
3626
3627                         text/html; lynx -dump %s ; copiousoutput
3628
3629                    This will cause lynx to format the text/html output as text/plain
3630                    and Mutt-ng will use your standard pager to display the results.
3631
3632              needsterminal
3633                    Mutt-ng uses this flag when viewing attachments with _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (sec-
3634                    tion 5.4  , page 75), in order to decide whether it should honor
3635                    the setting of the _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.335  , page 167) variable
3636                    or not.  When an attachment is viewed using an interactive program,
3637                    and the corresponding mailcap entry has a _\bn_\be_\be_\bd_\bs_\bt_\be_\br_\bm_\bi_\bn_\ba_\bl flag, Mutt-
3638                    ng will use _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 7.4.335  , page 167) and the exit
3639                    status of the program to decide if it will ask you to press a key
3640                    after the external program has exited.  In all other situations it
3641                    will not prompt you for a key.
3642
3643              compose=<command>
3644                    This flag specifies the command to use to create a new attachment
3645                    of a specific MIME type.  Mutt-ng supports this from the compose
3646                    menu.
3647
3648              composetyped=<command>
3649                    This flag specifies the command to use to create a new attachment
3650                    of a specific MIME type.  This command differs from the compose
3651                    command in that mutt will expect standard MIME headers on the data.
3652                    This can be used to specify parameters, filename, description, etc.
3653                    for a new attachment.   Mutt-ng supports this from the compose
3654                    menu.
3655
3656              print=<command>
3657                    This flag specifies the command to use to print a specific MIME
3658                    type.  Mutt-ng supports this from the attachment and compose menus.
3659
3660              edit=<command>
3661                    This flag specifies the command to use to edit a specific MIME
3662                    type.  Mutt-ng supports this from the compose menu, and also uses
3663
3664        The Mutt Next Generation E-Mail Client                                       73
3665
3666                    it to compose new attachments.  Mutt-ng will default to the defined
3667                    editor for text attachments.
3668
3669              nametemplate=<template>
3670                    This field specifies the format for the file denoted by %s in the
3671                    command fields.  Certain programs will require a certain file
3672                    extension, for instance, to correctly view a file.  For instance,
3673                    lynx will only interpret a file as text/html if the file ends in
3674                    .html.  So, you would specify lynx as a text/html viewer with a
3675                    line in the mailcap file like:
3676
3677                         text/html; lynx %s; nametemplate=%s.html
3678
3679              test=<command>
3680                    This field specifies a command to run to test whether this mailcap
3681                    entry should be used.  The command is defined with the command
3682                    expansion rules defined in the next section.  If the command
3683                    returns 0, then the test passed, and Mutt-ng uses this entry.  If
3684                    the command returns non-zero, then the test failed, and Mutt-ng
3685                    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
3686                    _\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:
3687
3688                         text/html; netscape -remote 'openURL(%s)' ; test=RunningX
3689                         text/html; lynx %s
3690
3691                    In this example, Mutt-ng will run the program RunningX which will
3692                    return 0 if the X Window manager is running, and non-zero if it
3693                    isn't.  If RunningX returns 0, then Mutt-ng will call netscape to
3694                    display the text/html object.  If RunningX doesn't return 0, then
3695                    Mutt-ng will go on to the next entry and use lynx to display the
3696                    text/html object.
3697
3698        _\b5_\b._\b3_\b._\b3_\b._\b2  _\bS_\be_\ba_\br_\bc_\bh _\bO_\br_\bd_\be_\br
3699
3700        When searching for an entry in the mailcap file, Mutt-ng will search for the
3701        most useful entry for its purpose.  For instance, if you are attempting to
3702        print an image/gif, and you have the following entries in your mailcap file,
3703        Mutt-ng will search for an entry with the print command:
3704
3705             image/*;        xv %s
3706             image/gif;      ; print= anytopnm %s | pnmtops | lpr; \
3707                             nametemplate=%s.gif
3708
3709        Mutt-ng will skip the image/* entry and use the image/gif entry with the print
3710        command.
3711
3712        In addition, you can use this with _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 75) to denote
3713        two commands for viewing an attachment, one to be viewed automatically, the
3714        other to be viewed interactively from the attachment menu.  In addition, you
3715        can then use the test feature to determine which viewer to use interactively
3716        depending on your environment.
3717
3718        The Mutt Next Generation E-Mail Client                                       74
3719
3720             text/html;      netscape -remote 'openURL(%s)' ; test=RunningX
3721             text/html;      lynx %s; nametemplate=%s.html
3722             text/html;      lynx -dump %s; nametemplate=%s.html; copiousoutput
3723
3724        For _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 75), Mutt-ng will choose the third entry
3725        because of the copiousoutput tag.  For interactive viewing, Mutt will run the
3726        program RunningX to determine if it should use the first entry.  If the program
3727        returns non-zero, Mutt-ng will use the second entry for interactive viewing.
3728
3729        _\b5_\b._\b3_\b._\b3_\b._\b3  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
3730
3731        The various commands defined in the mailcap files are passed to the /bin/sh
3732        shell using the system() function.  Before the command is passed to /bin/sh -c,
3733        it is parsed to expand various special parameters with information from Mutt-
3734        ng.  The keywords Mutt-ng expands are:
3735
3736              %s
3737                    As seen in the basic mailcap section, this variable is expanded to
3738                    a filename specified by the calling program.  This file contains
3739                    the body of the message to view/print/edit or where the composing
3740                    program should place the results of composition.  In addition, the
3741                    use of this keyword causes Mutt-ng to not pass the body of the mes-
3742                    sage to the view/print/edit program on stdin.
3743
3744              %t
3745                    Mutt-ng will expand %t to the text representation of the content
3746                    type of the message in the same form as the first parameter of the
3747                    mailcap definition line, ie text/html or image/gif.
3748
3749              %{<parameter>}
3750                    Mutt-ng will expand this to the value of the specified parameter
3751                    from the Content-Type: line of the mail message.  For instance, if
3752                    Your mail message contains:
3753
3754                         Content-Type: text/plain; charset=iso-8859-1
3755
3756                    then Mutt-ng will expand %{charset} to iso-8859-1.  The default
3757                    metamail mailcap file uses this feature to test the charset to
3758                    spawn an xterm using the right charset to view the message.
3759
3760              \%
3761                    This will be replaced by a %
3762
3763        Mutt-ng does not currently support the %F and %n keywords specified in RFC
3764        1524.  The main purpose of these parameters is for multipart messages, which is
3765        handled internally by Mutt-ng.
3766
3767        _\b5_\b._\b3_\b._\b4  _\bE_\bx_\ba_\bm_\bp_\bl_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be_\bs
3768
3769        This mailcap file is fairly simple and standard:
3770
3771        The Mutt Next Generation E-Mail Client                                       75
3772
3773             # I'm always running X :)
3774             video/*;        xanim %s > /dev/null
3775             image/*;        xv %s > /dev/null
3776
3777             # I'm always running netscape (if my computer had more memory, maybe)
3778             text/html;      netscape -remote 'openURL(%s)'
3779
3780        This mailcap file shows quite a number of examples:
3781
3782             # Use xanim to view all videos   Xanim produces a header on startup,
3783             # send that to /dev/null so I don't see it
3784             video/*;        xanim %s > /dev/null
3785
3786             # Send html to a running netscape by remote
3787             text/html;      netscape -remote 'openURL(%s)'; test=RunningNetscape
3788
3789             # If I'm not running netscape but I am running X, start netscape on the
3790             # object
3791             text/html;      netscape %s; test=RunningX
3792
3793             # Else use lynx to view it as text
3794             text/html;      lynx %s
3795
3796             # This version would convert the text/html to text/plain
3797             text/html;      lynx -dump %s; copiousoutput
3798
3799             # I use enscript to print text in two columns to a page
3800             text/*;         more %s; print=enscript -2Gr %s
3801
3802             # Netscape adds a flag to tell itself to view jpegs internally
3803             image/jpeg;xv %s; x-mozilla-flags=internal
3804
3805             # Use xv to view images if I'm running X
3806             # In addition, this uses the \ to extend the line and set my editor
3807             # for images
3808             image/*;xv %s; test=RunningX; \
3809                     edit=xpaint %s
3810
3811             # Convert images to text using the netpbm tools
3812             image/*;  (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
3813             pbmtoascii -1x2 ) 2>&1 ; copiousoutput
3814
3815             # Send excel spreadsheets to my NT box
3816             application/ms-excel; open.pl %s
3817
3818        _\b5_\b._\b4  _\bM_\bI_\bM_\bE _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw
3819
3820        In addition to explicitly telling Mutt-ng to view an attachment with the MIME
3821        viewer defined in the mailcap file, Mutt-ng has support for automatically
3822
3823        The Mutt Next Generation E-Mail Client                                       76
3824
3825        viewing MIME attachments while in the pager.
3826
3827        To work, you must define a viewer in the mailcap file which uses the copi-
3828        ousoutput option to denote that it is non-interactive.  Usually, you also use
3829        the entry to convert the attachment to a text representation which you can view
3830        in the pager.
3831
3832        You then use the auto_view muttrc command to list the content-types that you
3833        wish to view automatically.
3834
3835        For instance, if you set auto_view to:
3836
3837             auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz
3838
3839        Mutt-ng could use the following mailcap entries to automatically view attach-
3840        ments of these types.
3841
3842             text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
3843             image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
3844             application/x-gunzip;   gzcat; copiousoutput
3845             application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput
3846             application/postscript; ps2ascii %s; copiousoutput
3847
3848        ``unauto_view'' can be used to remove previous entries from the autoview list.
3849        This can be used with message-hook to autoview messages based on size, etc.
3850        ``unauto_view *'' will remove all previous entries.
3851
3852        _\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
3853
3854        Mutt-ng has some heuristics for determining which attachment of a multi-
3855        part/alternative type to display.  First, mutt will check the alternative_order
3856        list to determine if one of the available types is preferred.  The alterna-
3857        tive_order list consists of a number of MIME types in order, including support
3858        for implicit and explicit wildcards, for example:
3859
3860             alternative_order text/enriched text/plain text application/postscript image/*
3861
3862        Next, mutt will check if any of the types have a defined _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section
3863        5.4  , page 75), and use that.  Failing that, Mutt-ng will look for any text
3864        type.  As a last attempt, mutt will look for any type it knows how to handle.
3865
3866        To remove a MIME type from the alternative_order list, use the unalterna-
3867        tive_order command.
3868
3869        _\b5_\b._\b6  _\bM_\bI_\bM_\bE _\bL_\bo_\bo_\bk_\bu_\bp
3870
3871        Mutt-ng's mime_lookup list specifies a list of mime-types that should not be
3872
3873        The Mutt Next Generation E-Mail Client                                       77
3874
3875        treated according to their mailcap entry.  This option is designed to deal with
3876        binary types such as application/octet-stream.  When an attachment's mime-type
3877        is listed in mime_lookup, then the extension of the filename will be compared
3878        to the list of extensions in the mime.types file.  The mime-type associated
3879        with this extension will then be used to process the attachment according to
3880        the rules in the mailcap file and according to any other configuration options
3881        (such as auto_view) specified.  Common usage would be:
3882
3883             mime_lookup application/octet-stream application/X-Lotus-Manuscript
3884
3885        In addition, the unmime_lookup command may be used to disable this feature for
3886        any particular mime-type if it had been set, for example, in a global muttrc.
3887
3888        _\b6_\b.  _\bS_\be_\bc_\bu_\br_\bi_\bt_\by _\bC_\bo_\bn_\bs_\bi_\bd_\be_\br_\ba_\bt_\bi_\bo_\bn_\bs
3889
3890        First of all, mutt-ng contains no security holes included by intention but may
3891        contain unknown security holes. As a consequence, please run mutt-ng only with
3892        as few permissions as possible.
3893
3894        Please do not run mutt-ng as the super user.
3895
3896        When configuring mutt-ng, there're some points to note about secure setups.
3897
3898        In practice, mutt-ng can be easily made as vulnerable as even the most insecure
3899        mail user agents (in their default configuration) just by changing mutt-ng's
3900        configuration files: it then can execute arbitrary programs and scripts
3901        attached to messages, send out private data on its own, etc. Although this is
3902        not believed to the common type of setup, please read this chapter carefully.
3903
3904        _\b6_\b._\b1  _\bP_\ba_\bs_\bs_\bw_\bo_\br_\bd_\bs
3905
3906        Although mutt-ng can be told the various passwords for accounts, please never
3907        store passwords in configuration files. Besides the fact that the system's
3908        operator can always read them, you could forget to replace the actual password
3909        with asterisks when reporting a bug or asking for help via, for example, a
3910        mailing list so that your mail including your password could be archived by
3911        internet search engines, etc. Please never store passwords on disk.
3912
3913        _\b6_\b._\b2  _\bT_\be_\bm_\bp_\bo_\br_\ba_\br_\by _\bF_\bi_\bl_\be_\bs
3914
3915        Mutt-ng uses many temporary files for viewing messages, verifying digital sig-
3916        natures, etc. The _\b$_\bu_\bm_\ba_\bs_\bk (section 7.4.326  , page 166) variable can be used to
3917        change the default permissions of these files. Please only change it if you
3918        really know what you are doing.  Also, a different location for these files may
3919        be desired which can be changed via the _\b$_\bt_\bm_\bp_\bd_\bi_\br (section 7.4.322  , page 165)
3920        variable.
3921
3922        The Mutt Next Generation E-Mail Client                                       78
3923
3924        _\b6_\b._\b3  _\bI_\bn_\bf_\bo_\br_\bm_\ba_\bt_\bi_\bo_\bn _\bL_\be_\ba_\bk_\bs
3925
3926        _\b6_\b._\b3_\b._\b1  _\bM_\be_\bs_\bs_\ba_\bg_\be_\b-_\bI_\bD_\b: _\bh_\be_\ba_\bd_\be_\br_\bs
3927
3928        In the default configuration, mutt-ng will leak some information to the outside
3929        world when sending messages: the generation of Message-ID: headers includes a
3930        step counter which is increased (and rotated) with every message sent. If you'd
3931        like to hide this information probably telling others how many mail you sent in
3932        which time, you at least need to remove the %P expando from the default setting
3933        of the _\b$_\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.143  , page 120) variable. Please make sure
3934        that you really know how local parts of these Message-ID: headers are composed.
3935
3936        _\b6_\b._\b3_\b._\b2  _\bm_\ba_\bi_\bl_\bt_\bo_\b:_\b-_\bs_\bt_\by_\bl_\be _\bl_\bi_\bn_\bk_\bs
3937
3938        As mutt-ng be can be set up to be the mail client to handle mailto: style links
3939        in websites, there're security considerations, too. To keep the old behavior by
3940        default, mutt-ng will be strict in interpreting them which means that arbitrary
3941        header fields can be embedded in these links which could override existing
3942        header fields or attach arbitrary files. This may be problematic if the
3943        _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.54  , page 98) variable is _\bu_\bn_\bs_\be_\bt, i.e. the user
3944        doesn't want to see header fields while editing the message.
3945
3946        For example, following a link like
3947
3948             mailto:joe@host?Attach=~/.gnupg/secring.gpg
3949
3950        will send out the user's private gnupg keyring to joe@host if the user doesn't
3951        follow the information on screen carefully enough.
3952
3953        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.310  , page 162) variable, mutt-
3954        ng will
3955
3956           +\bo be less strict when interpreting these links by prepending a X-Mailto-
3957             string to all header fields embedded in such a link _\ba_\bn_\bd
3958
3959           +\bo turn on the _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.54  , page 98) variable by force to
3960             let the user see all the headers (because they still may leak informa-
3961             tion.)
3962
3963        _\b6_\b._\b4  _\bE_\bx_\bt_\be_\br_\bn_\ba_\bl _\ba_\bp_\bp_\bl_\bi_\bc_\ba_\bt_\bi_\bo_\bn_\bs
3964
3965        Mutt-ng in many places has to rely on external applications or for convenience
3966        supports mechanisms involving external applications.
3967
3968        _\b6_\b._\b4_\b._\b1  _\bm_\ba_\bi_\bl_\bc_\ba_\bp
3969
3970        One of these is the mailcap mechanism as defined by RfC 1524. Mutt-ng can be
3971        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-
3972        cap files (see the _\b$_\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh (section 7.4.116  , page 114) variable for
3973        details.)
3974
3975        These utilities may have a variety of security vulnerabilities, including
3976
3977        The Mutt Next Generation E-Mail Client                                       79
3978
3979        overwriting of arbitrary files, information leaks or other exploitable bugs.
3980        These vulnerabilities may go unnoticed by the user, especially when they are
3981        called automatically (and without interactive prompting) from the mailcap
3982        file(s). When using mutt-ng's autoview mechanism in combination with mailcap
3983        files, please be sure to...
3984
3985           +\bo manually select trustworth applications with a reasonable calling sequence
3986
3987           +\bo periodically check the contents of mailcap files, especially after soft-
3988             ware installations or upgrades
3989
3990           +\bo keep the software packages referenced in the mailcap file up to date
3991
3992           +\bo leave the _\b$_\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 7.4.117  , page 115) variable in its
3993             default state to restrict mailcap expandos to a safe set of characters
3994
3995        _\b6_\b._\b4_\b._\b2  _\bO_\bt_\bh_\be_\br
3996
3997        Besides the mailcap mechanism, mutt-ng uses a number of other external utili-
3998        ties for operation.
3999
4000        The same security considerations apply for these as for tools involved via
4001        mailcap (for example, mutt-ng is vulnerable to Denial of Service Attacks with
4002        compressed folders support if the uncompressed mailbox is too large for the
4003        disk it is saved to.)
4004
4005        As already noted, most of these problems are not built in but caused by wrong
4006        configuration, so please check your configuration.
4007
4008        _\b7_\b.  _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be
4009
4010        _\b7_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs
4011
4012        Running mutt with no arguments will make Mutt-ng attempt to read your spool
4013        mailbox.  However, it is possible to read other mailboxes and to send messages
4014        from the command line as well.
4015
4016        The Mutt Next Generation E-Mail Client                                       80
4017
4018             -A      expand an alias
4019             -a      attach a file to a message
4020             -b      specify a blind carbon-copy (BCC) address
4021             -c      specify a carbon-copy (Cc) address
4022             -D      print the value of all variables on stdout
4023             -e      specify a config command to be run after initialization files are read
4024             -f      specify a mailbox to load
4025             -F      specify an alternate file to read initialization commands
4026             -h      print help on command line options
4027             -H      specify a draft file from which to read a header and body
4028             -i      specify a file to include in a message composition
4029             -m      specify a default mailbox type
4030             -n      do not read the system Muttngrc
4031             -p      recall a postponed message
4032             -Q      query a configuration variable
4033             -R      open mailbox in read-only mode
4034             -s      specify a subject (enclose in quotes if it contains spaces)
4035             -v      show version number and compile-time definitions
4036             -x      simulate the mailx(1) compose mode
4037             -y      show a menu containing the files specified by the mailboxes command
4038             -z      exit immediately if there are no messages in the mailbox
4039             -Z      open the first folder with new message,exit immediately if none
4040
4041        To read messages in a mailbox
4042
4043        mutt [ -nz ] [ -F _\bm_\bu_\bt_\bt_\br_\bc ] [ -m _\bt_\by_\bp_\be ] [ -f _\bm_\ba_\bi_\bl_\bb_\bo_\bx ]
4044
4045        To compose a new message
4046
4047        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-
4048        _\bj_\be_\bc_\bt ] _\ba_\bd_\bd_\br_\be_\bs_\bs [ _\ba_\bd_\bd_\br_\be_\bs_\bs ... ]
4049
4050        Mutt-ng also supports a ``batch'' mode to send prepared messages.  Simply redi-
4051        rect input from the file you wish to send.  For example,
4052
4053        mutt -s 'data set for run #2' professor@bigschool.edu < ~/run2.dat
4054
4055        This command will send a message to ``professor@bigschool.edu'' with a subject
4056        of ``data set for run #2''.  In the body of the message will be the contents of
4057        the file ``~/run2.dat''.
4058
4059        _\b7_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
4060
4061        The Mutt Next Generation E-Mail Client                                       81
4062
4063             ~A              all messages
4064             ~b EXPR         messages which contain EXPR in the message body
4065             ~B EXPR         messages which contain EXPR in the whole message
4066             ~c USER         messages carbon-copied to USER
4067             ~C EXPR         message is either to: or cc: EXPR
4068             ~D              deleted messages
4069             ~d [MIN]-[MAX]  messages with ``date-sent'' in a Date range
4070             ~E              expired messages
4071             ~e EXPR         message which contains EXPR in the ``Sender'' field
4072             ~F              flagged messages
4073             ~f USER         messages originating from USER
4074             ~g              cryptographically signed messages
4075             ~G              cryptographically encrypted messages
4076             ~H EXPR         messages with a spam attribute matching EXPR
4077             ~h EXPR         messages which contain EXPR in the message header
4078             ~k              message contains PGP key material
4079             ~i ID           message which match ID in the ``Message-ID'' field
4080             ~L EXPR         message is either originated or received by EXPR
4081             ~l              message is addressed to a known mailing list
4082             ~m [MIN]-[MAX]  message in the range MIN to MAX *)
4083             ~n [MIN]-[MAX]  messages with a score in the range MIN to MAX *)
4084             ~N              new messages
4085             ~O              old messages
4086             ~p              message is addressed to you (consults alternates)
4087             ~P              message is from you (consults alternates)
4088             ~Q              messages which have been replied to
4089             ~R              read messages
4090             ~r [MIN]-[MAX]  messages with ``date-received'' in a Date range
4091             ~S              superseded messages
4092             ~s SUBJECT      messages having SUBJECT in the ``Subject'' field.
4093             ~T              tagged messages
4094             ~t USER         messages addressed to USER
4095             ~U              unread messages
4096             ~v              message is part of a collapsed thread.
4097             ~V              cryptographically verified messages
4098             ~w EXPR         messages which contain EXPR in the `Newsgroups' field
4099                             (if compiled with NNTP support)
4100             ~x EXPR         messages which contain EXPR in the `References' field
4101             ~y EXPR         messages which contain EXPR in the `X-Label' field
4102             ~z [MIN]-[MAX]  messages with a size in the range MIN to MAX *)
4103             ~=              duplicated messages (see $duplicate_threads)
4104             ~$              unreferenced messages (requires threaded view)
4105             ~*              ``From'' contains realname and (syntactically) valid
4106                             address (excluded are addresses matching against
4107                             alternates or any alias)
4108
4109        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
4110        44).  Special attention has to be made when using regular expressions inside of
4111        patterns.  Specifically, Mutt-ng's parser for these patterns will strip one
4112        level of backslash (\), which is normally used for quoting.  If it is your
4113        intention to use a backslash in the regular expression, you will need to use
4114        two backslashes instead (\\).
4115
4116        The Mutt Next Generation E-Mail Client                                       82
4117
4118        *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too.
4119
4120        _\b7_\b._\b3  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs
4121
4122        The following are the commands understood by mutt.
4123
4124           +\bo _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\b-_\bh_\bo_\bo_\bk (section 4.17  , page 63) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4125
4126           +\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, ... ]
4127
4128           +\bo _\bu_\bn_\ba_\bl_\bi_\ba_\bs (section 3.3  , page 23) [ * | _\bk_\be_\by ... ]
4129
4130           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.10  , page 30) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4131
4132           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.10  , page 30) [ * | _\br_\be_\bg_\be_\bx_\bp ... ]
4133
4134           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 76) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4135
4136           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 76) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4137
4138           +\bo _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.19.3  , page 66) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4139
4140           +\bo _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 75) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4141
4142           +\bo _\bu_\bn_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 75) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4143
4144           +\bo _\bb_\bi_\bn_\bd (section 3.4  , page 24) _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
4145
4146           +\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
4147
4148           +\bo _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.19.2  , page 65) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4149
4150           +\bo _\bc_\bo_\bl_\bo_\br (section 3.8  , page 27) _\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 ]
4151
4152           +\bo _\bu_\bn_\bc_\bo_\bl_\bo_\br (section 3.8  , page 27) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4153
4154           +\bo _\be_\bx_\be_\bc (section 3.24  , page 37) _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
4155
4156           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 35) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4157
4158           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 36) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4159
4160           +\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
4161
4162           +\bo _\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.16  , page 35) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
4163
4164           +\bo _\bu_\bn_\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.16  , page 35) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
4165
4166           +\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
4167
4168           +\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 ... ]
4169
4170        The Mutt Next Generation E-Mail Client                                       83
4171
4172           +\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 ... ]
4173
4174           +\bo _\bl_\bi_\bs_\bt_\bs (section 3.12  , page 32) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4175
4176           +\bo _\bu_\bn_\bl_\bi_\bs_\bt_\bs (section 3.12  , page 32) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4177
4178           +\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 ]
4179
4180           +\bo _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.14  , page 33) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
4181
4182           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 33) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
4183
4184           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.21  , page 37) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4185
4186           +\bo _\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 76) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4187
4188           +\bo _\bu_\bn_\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 76) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
4189
4190           +\bo _\bm_\bo_\bn_\bo (section 3.8  , page 27) _\bo_\bb_\bj_\be_\bc_\bt _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be [ _\br_\be_\bg_\be_\bx_\bp ]
4191
4192           +\bo _\bu_\bn_\bm_\bo_\bn_\bo (section 3.8  , page 27) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4193
4194           +\bo _\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 34) _\bs_\bt_\br_\bi_\bn_\bg
4195
4196           +\bo _\bu_\bn_\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 34) _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
4197
4198           +\bo _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.19.1  , page 65) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4199
4200           +\bo _\bc_\br_\by_\bp_\bt_\b-_\bh_\bo_\bo_\bk (section 3.22  , page 37) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\b-_\bi_\bd
4201
4202           +\bo _\bp_\bu_\bs_\bh (section 3.23  , page 37) _\bs_\bt_\br_\bi_\bn_\bg
4203
4204           +\bo _\br_\be_\bs_\be_\bt (section 3.27  , page 41) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4205
4206           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 35) _\br_\be_\bg_\be_\bx_\bp _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4207
4208           +\bo _\bs_\bc_\bo_\br_\be (section 3.25  , page 38) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
4209
4210           +\bo _\bu_\bn_\bs_\bc_\bo_\br_\be (section 3.25  , page 38) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
4211
4212           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 36) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
4213
4214           +\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
4215
4216           +\bo _\bs_\be_\bt (section 3.27  , page 41) [no|inv]_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be[=_\bv_\ba_\bl_\bu_\be] [ _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4217
4218           +\bo _\bu_\bn_\bs_\be_\bt (section 3.27  , page 41) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4219
4220           +\bo _\bs_\bo_\bu_\br_\bc_\be (section 3.28  , page 42) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
4221
4222           +\bo _\bs_\bp_\ba_\bm (section 3.26  , page 39) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
4223
4224           +\bo _\bn_\bo_\bs_\bp_\ba_\bm (section 3.26  , page 39) _\bp_\ba_\bt_\bt_\be_\br_\bn
4225
4226        The Mutt Next Generation E-Mail Client                                       84
4227
4228           +\bo _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.12  , page 32) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4229
4230           +\bo _\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.12  , page 32) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
4231
4232           +\bo _\bt_\bo_\bg_\bg_\bl_\be (section 3.27  , page 41) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
4233
4234           +\bo _\bu_\bn_\bh_\bo_\bo_\bk (section 3.29  , page 42) _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be
4235
4236        _\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
4237
4238        The following list contains all variables which, in the process of providing
4239        more consistency, have been renamed and are partially even removed already. The
4240        left column contains the old synonym variables, the right column the full/new
4241        name:
4242
4243        The Mutt Next Generation E-Mail Client                                       85
4244
4245             edit_hdrs               edit_headers
4246             forw_decode             forward_decode
4247             forw_format             forward_format
4248             forw_quote              forward_quote
4249             hdr_format              index_format
4250             indent_str              indent_string
4251             mime_fwd                mime_forward
4252             msg_format              message_format
4253             pgp_autosign            crypt_autosign
4254             pgp_autoencrypt         crypt_autoencrypt
4255             pgp_replyencrypt        crypt_replyencrypt
4256             pgp_replysign           crypt_replysign
4257             pgp_replysignencrypted  crypt_replysignencrypted
4258             pgp_verify_sig          crypt_verify_sig
4259             pgp_create_traditional  pgp_autoinline
4260             pgp_auto_traditional    pgp_replyinline
4261             forw_decrypt            forward_decrypt
4262             smime_sign_as           smime_default_key
4263             post_indent_str         post_indent_string
4264             print_cmd               print_command
4265             shorten_hierarchy       sidebar_shorten_hierarchy
4266             ask_followup_to         nntp_ask_followup_to
4267             ask_x_comment_to        nntp_ask_x_comment_to
4268             catchup_newsgroup       nntp_catchup
4269             followup_to_poster      nntp_followup_to_poster
4270             group_index_format      nntp_group_index_format
4271             inews                   nntp_inews
4272             mime_subject            nntp_mime_subject
4273             news_cache_dir          nntp_cache_dir
4274             news_server             nntp_host
4275             newsrc                  nntp_newsrc
4276             nntp_poll               nntp_mail_check
4277             pop_checkinterval       pop_mail_check
4278             post_moderated          nntp_post_moderated
4279             save_unsubscribed       nntp_save_unsubscribed
4280             show_new_news           nntp_show_new_news
4281             show_only_unread        nntp_show_only_unread
4282             x_comment_to            nntp_x_comment_to
4283             smtp_auth_username      smtp_user
4284             smtp_auth_password      smtp_pass
4285             signoff_string          post_indent_string
4286
4287        The contrib subdirectory contains a script named update-config.pl which eases
4288        migration.
4289
4290        A complete list of current variables follows.
4291
4292        _\b7_\b._\b4_\b._\b1  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\bs_\bu_\bb_\bj_\be_\bc_\bt
4293
4294        Type: quadoption
4295
4296        Default: ask-yes
4297
4298        The Mutt Next Generation E-Mail Client                                       86
4299
4300        If set to _\by_\be_\bs, when composing messages and no subject is given at the subject
4301        prompt, composition will be aborted.  If set to _\bn_\bo, composing messages with no
4302        subject given at the subject prompt will never be aborted.
4303
4304        _\b7_\b._\b4_\b._\b2  _\ba_\bb_\bo_\br_\bt_\b__\bu_\bn_\bm_\bo_\bd_\bi_\bf_\bi_\be_\bd
4305
4306        Type: quadoption
4307
4308        Default: yes
4309
4310        If set to _\by_\be_\bs, composition will automatically abort after editing the message
4311        body if no changes are made to the file (this check only happens after the
4312        _\bf_\bi_\br_\bs_\bt edit of the file).  When set to _\bn_\bo, composition will never be aborted.
4313
4314        _\b7_\b._\b4_\b._\b3  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be
4315
4316        Type: path
4317
4318        Default: '~/.muttngrc'
4319
4320        The default file in which to save aliases created by the ``_\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (sec-
4321        tion 2.5.4  , page 11)'' function.
4322
4323        N\bNo\bot\bte\be:\b: Mutt-ng will not automatically source this file; you must explicitly use
4324        the ``_\bs_\bo_\bu_\br_\bc_\be (section 3.28  , page 42)'' command for it to be executed.
4325
4326        _\b7_\b._\b4_\b._\b4  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
4327
4328        Type: string
4329
4330        Default: '%4n %2f %t %-10a   %r'
4331
4332        Specifies the format of the data displayed for the ``alias'' menu. The follow-
4333        ing printf(3)-style sequences are available:
4334
4335              %a
4336                    alias name
4337
4338              %f
4339                    flags - currently, a 'd' for an alias marked for deletion
4340
4341              %n
4342                    index number
4343
4344              %r
4345                    address which alias expands to
4346
4347              %t
4348                    character which indicates if the alias is tagged for inclusion
4349
4350        _\b7_\b._\b4_\b._\b5  _\ba_\bl_\bl_\bo_\bw_\b__\b8_\bb_\bi_\bt
4351
4352        Type: boolean
4353
4354        The Mutt Next Generation E-Mail Client                                       87
4355
4356        Default: yes
4357
4358        Controls whether 8-bit data is converted to 7-bit using either quoted-printable
4359        or base64 encoding when sending mail.
4360
4361        _\b7_\b._\b4_\b._\b6  _\ba_\bl_\bl_\bo_\bw_\b__\ba_\bn_\bs_\bi
4362
4363        Type: boolean
4364
4365        Default: no
4366
4367        Controls whether ANSI color codes in messages (and color tags in rich text mes-
4368        sages) are to be interpreted.  Messages containing these codes are rare, but if
4369        this option is set, their text will be colored accordingly. Note that this may
4370        override your color choices, and even present a security problem, since a mes-
4371        sage could include a line like ``[-- PGP output follows ...' and give it the
4372        same color as your attachment color.
4373
4374        _\b7_\b._\b4_\b._\b7  _\ba_\br_\br_\bo_\bw_\b__\bc_\bu_\br_\bs_\bo_\br
4375
4376        Type: boolean
4377
4378        Default: no
4379
4380        When _\bs_\be_\bt, an arrow (``->'') will be used to indicate the current entry in menus
4381        instead of highlighting the whole line.  On slow network or modem links this
4382        will make response faster because there is less that has to be redrawn on the
4383        screen when moving to the next or previous entries in the menu.
4384
4385        _\b7_\b._\b4_\b._\b8  _\ba_\bs_\bc_\bi_\bi_\b__\bc_\bh_\ba_\br_\bs
4386
4387        Type: boolean
4388
4389        Default: no
4390
4391        If _\bs_\be_\bt, Mutt-ng will use plain ASCII characters when displaying thread and
4392        attachment trees, instead of the default ACS characters.
4393
4394        _\b7_\b._\b4_\b._\b9  _\ba_\bs_\bk_\bb_\bc_\bc
4395
4396        Type: boolean
4397
4398        Default: no
4399
4400        If _\bs_\be_\bt, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before
4401        editing an outgoing message.
4402
4403        _\b7_\b._\b4_\b._\b1_\b0  _\ba_\bs_\bk_\bc_\bc
4404
4405        Type: boolean
4406
4407        Default: no
4408
4409        If _\bs_\be_\bt, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing
4410
4411        The Mutt Next Generation E-Mail Client                                       88
4412
4413        the body of an outgoing message.
4414
4415        _\b7_\b._\b4_\b._\b1_\b1  _\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4416
4417        Type: string
4418
4419        Default: 'us-ascii'
4420
4421        This variable is a colon-separated list of character encoding schemes for mes-
4422        sages without character encoding indication.  Header field values and message
4423        body content without character encoding indication would be assumed that they
4424        are written in one of this list.  By default, all the header fields and message
4425        body without any charset indication are assumed to be in us-ascii.
4426
4427        For example, Japanese users might prefer this:
4428
4429        set assumed_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
4430
4431        However, only the first content is valid for the message body.  This variable
4432        is valid only if _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be (section 7.4.311  , page 162) is unset.
4433
4434        _\b7_\b._\b4_\b._\b1_\b2  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bf_\bo_\br_\bm_\ba_\bt
4435
4436        Type: string
4437
4438        Default: '%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] '
4439
4440        This variable describes the format of the ``attachment'' menu.  The following
4441        printf(3)-style sequences are understood:
4442
4443              %C
4444                    charset
4445
4446              %c
4447                    requires charset conversion (n or c)
4448
4449              %D
4450                    deleted flag
4451
4452              %d
4453                    description
4454
4455              %e
4456                    MIME Content-Transfer-Encoding: header field
4457
4458              %f
4459                    filename
4460
4461              %I
4462                    MIME Content-Disposition: header field (I=inline, A=attachment)
4463
4464              %m
4465                    major MIME type
4466
4467        The Mutt Next Generation E-Mail Client                                       89
4468
4469              %M
4470                    MIME subtype
4471
4472              %n
4473                    attachment number
4474
4475              %s
4476                    size
4477
4478              %t
4479                    tagged flag
4480
4481              %T
4482                    graphic tree characters
4483
4484              %u
4485                    unlink (=to delete) flag
4486
4487              %>X
4488                    right justify the rest of the string and pad with character 'X'
4489
4490              %|X
4491                    pad to the end of the line with character 'X'
4492
4493        _\b7_\b._\b4_\b._\b1_\b3  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp
4494
4495        Type: string
4496
4497        Default: '\n'
4498
4499        The separator to add between attachments when operating (saving, printing, pip-
4500        ing, etc) on a list of tagged attachments.
4501
4502        _\b7_\b._\b4_\b._\b1_\b4  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\bp_\bl_\bi_\bt
4503
4504        Type: boolean
4505
4506        Default: yes
4507
4508        If this variable is _\bu_\bn_\bs_\be_\bt, when operating (saving, printing, piping, etc) on a
4509        list of tagged attachments, Mutt-ng will concatenate the attachments and will
4510        operate on them as a single attachment. The ``_\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp (section 7.4.13  ,
4511        page 89)'' separator is added after each attachment. When _\bs_\be_\bt, Mutt-ng will
4512        operate on the attachments one by one.
4513
4514        _\b7_\b._\b4_\b._\b1_\b5  _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn
4515
4516        Type: string
4517
4518        Default: 'On %d, %n wrote:'
4519
4520        This is the string that will precede a message which has been included in a
4521        reply.  For a full listing of defined printf(3)-like sequences see the section
4522        on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111)''.
4523
4524        The Mutt Next Generation E-Mail Client                                       90
4525
4526        _\b7_\b._\b4_\b._\b1_\b6  _\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg
4527
4528        Type: boolean
4529
4530        Default: no
4531
4532        When _\bs_\be_\bt, functions in the _\bi_\bn_\bd_\be_\bx menu which affect a message will be applied to
4533        all tagged messages (if there are any).  When unset, you must first use the
4534        ``tag-prefix'' function (default: ';') to make the next function apply to all
4535        tagged messages.
4536
4537        _\b7_\b._\b4_\b._\b1_\b7  _\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt
4538
4539        Type: boolean
4540
4541        Default: no
4542
4543        When _\bs_\be_\bt along with ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.54  , page 98)'', Mutt-ng will
4544        skip the initial send-menu and allow you to immediately begin editing the body
4545        of your message.  The send-menu may still be accessed once you have finished
4546        editing the body of your message.
4547
4548        Also see ``_\b$_\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by (section 7.4.60  , page 99)''.
4549
4550        _\b7_\b._\b4_\b._\b1_\b8  _\bb_\be_\be_\bp
4551
4552        Type: boolean
4553
4554        Default: yes
4555
4556        When this variable is _\bs_\be_\bt, Mutt-ng will beep when an error occurs.
4557
4558        _\b7_\b._\b4_\b._\b1_\b9  _\bb_\be_\be_\bp_\b__\bn_\be_\bw
4559
4560        Type: boolean
4561
4562        Default: no
4563
4564        When this variable is _\bs_\be_\bt, Mutt-ng will beep whenever it prints a message noti-
4565        fying you of new mail.  This is independent of the setting of the ``_\b$_\bb_\be_\be_\bp (sec-
4566        tion 7.4.18  , page 90)'' variable.
4567
4568        _\b7_\b._\b4_\b._\b2_\b0  _\bb_\bo_\bu_\bn_\bc_\be
4569
4570        Type: quadoption
4571
4572        Default: ask-yes
4573
4574        Controls whether you will be asked to confirm bouncing messages.  If set to _\by_\be_\bs
4575        you don't get asked if you want to bounce a message. Setting this variable to
4576        _\bn_\bo is not generally useful, and thus not recommended, because you are unable to
4577        bounce messages.
4578
4579        The Mutt Next Generation E-Mail Client                                       91
4580
4581        _\b7_\b._\b4_\b._\b2_\b1  _\bb_\bo_\bu_\bn_\bc_\be_\b__\bd_\be_\bl_\bi_\bv_\be_\br_\be_\bd
4582
4583        Type: boolean
4584
4585        Default: yes
4586
4587        When this variable is _\bs_\be_\bt, Mutt-ng will include Delivered-To: header fields
4588        when bouncing messages.  Postfix users may wish to _\bu_\bn_\bs_\be_\bt this variable.
4589
4590        _\b7_\b._\b4_\b._\b2_\b2  _\bb_\br_\ba_\bi_\bl_\bl_\be_\b__\bf_\br_\bi_\be_\bn_\bd_\bl_\by
4591
4592        Type: boolean
4593
4594        Default: no
4595
4596        When this variable is set, mutt will place the cursor at the beginning of the
4597        current line in menus, even when the arrow_cursor variable is unset, making it
4598        easier for blind persons using Braille displays to follow these menus.  The
4599        option is disabled by default because many visual terminals don't permit making
4600        the cursor invisible.
4601
4602        _\b7_\b._\b4_\b._\b2_\b3  _\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\b__\bf_\bi_\bl_\be
4603
4604        Type: path
4605
4606        Default: '~/.mutt_certificates'
4607
4608        Availability: SSL or GNUTLS
4609
4610        This variable specifies the file where the certificates you trust are saved.
4611        When an unknown certificate is encountered, you are asked if you accept it or
4612        not. If you accept it, the certificate can also be saved in this file and fur-
4613        ther connections are automatically accepted.
4614
4615        You can also manually add CA certificates in this file. Any server certificate
4616        that is signed with one of these CA certificates are also automatically
4617        accepted.
4618
4619        Example: set certificate_file=~/.muttng/certificates
4620
4621        _\b7_\b._\b4_\b._\b2_\b4  _\bc_\bh_\ba_\br_\bs_\be_\bt
4622
4623        Type: string
4624
4625        Default: ''
4626
4627        Character set your terminal uses to display and enter textual data.
4628
4629        _\b7_\b._\b4_\b._\b2_\b5  _\bc_\bh_\be_\bc_\bk_\b__\bn_\be_\bw
4630
4631        Type: boolean
4632
4633        Default: yes
4634
4635        The Mutt Next Generation E-Mail Client                                       92
4636
4637        N\bNo\bot\bte\be:\b: this option only affects _\bm_\ba_\bi_\bl_\bd_\bi_\br and _\bM_\bH style mailboxes.
4638
4639        When _\bs_\be_\bt, Mutt-ng will check for new mail delivered while the mailbox is open.
4640        Especially with MH mailboxes, this operation can take quite some time since it
4641        involves scanning the directory and checking each file to see if it has already
4642        been looked at.  If it's _\bu_\bn_\bs_\be_\bt, no check for new mail is performed while the
4643        mailbox is open.
4644
4645        _\b7_\b._\b4_\b._\b2_\b6  _\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bu_\bn_\br_\be_\ba_\bd
4646
4647        Type: boolean
4648
4649        Default: yes
4650
4651        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not collapse a thread if it contains any unread mes-
4652        sages.
4653
4654        _\b7_\b._\b4_\b._\b2_\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4655
4656        Type: string
4657
4658        Default: '-- Mutt-ng: Compose  [Approx. msg size: %l   Atts: %a]%>-'
4659
4660        Controls the format of the status line displayed in the ``compose'' menu.  This
4661        string is similar to ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.308  , page 160)'', but has
4662        its own set of printf(3)-like sequences:
4663
4664              %a
4665                    total number of attachments
4666
4667              %h
4668                    local hostname
4669
4670              %l
4671                    approximate size (in bytes) of the current message
4672
4673              %v
4674                    Mutt-ng version string
4675
4676        See the text describing the ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.308  , page 160)''
4677        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.27  ,
4678        page 92)''.
4679
4680        _\b7_\b._\b4_\b._\b2_\b8  _\bc_\bo_\bn_\bf_\bi_\bg_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4681
4682        Type: string
4683
4684        Default: ''
4685
4686        When defined, Mutt-ng will recode commands in rc files from this encoding.
4687
4688        _\b7_\b._\b4_\b._\b2_\b9  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\ba_\bp_\bp_\be_\bn_\bd
4689
4690        Type: boolean
4691
4692        The Mutt Next Generation E-Mail Client                                       93
4693
4694        Default: yes
4695
4696        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when appending messages to an
4697        existing mailbox.
4698
4699        _\b7_\b._\b4_\b._\b3_\b0  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\bc_\br_\be_\ba_\bt_\be
4700
4701        Type: boolean
4702
4703        Default: yes
4704
4705        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when saving messages to a mail-
4706        box which does not yet exist before creating it.
4707
4708        _\b7_\b._\b4_\b._\b3_\b1  _\bc_\bo_\bn_\bn_\be_\bc_\bt_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
4709
4710        Type: number
4711
4712        Default: 30
4713
4714        Causes Mutt-ng to timeout a network connection (for IMAP or POP) after this
4715        many seconds if the connection is not able to be established.  A negative value
4716        causes Mutt-ng to wait indefinitely for the connection to succeed.
4717
4718        _\b7_\b._\b4_\b._\b3_\b2  _\bc_\bo_\bn_\bt_\be_\bn_\bt_\b__\bt_\by_\bp_\be
4719
4720        Type: string
4721
4722        Default: 'text/plain'
4723
4724        Sets the default Content-Type: header field for the body of newly composed mes-
4725        sages.
4726
4727        _\b7_\b._\b4_\b._\b3_\b3  _\bc_\bo_\bp_\by
4728
4729        Type: quadoption
4730
4731        Default: yes
4732
4733        This variable controls whether or not copies of your outgoing messages will be
4734        saved for later references.  Also see ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.231  , page
4735        141)'', ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.242  , page 144)'', ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section
4736        7.4.68  , page 102)'' and ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 35)''.
4737
4738        _\b7_\b._\b4_\b._\b3_\b4  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt
4739
4740        Type: boolean
4741
4742        Default: no
4743
4744        Setting this variable will cause Mutt-ng to always attempt to PGP encrypt out-
4745        going messages.  This is probably only useful in connection to the _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk
4746        command.  It can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when encryption is not
4747        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
4748
4749        The Mutt Next Generation E-Mail Client                                       94
4750
4751        7.4.277  , page 152)'' is _\bs_\be_\bt, then OpenSSL is used instead to create S/MIME
4752        messages and settings can be overridden by use of the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto
4753        only)
4754
4755        _\b7_\b._\b4_\b._\b3_\b5  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bp_\bg_\bp
4756
4757        Type: boolean
4758
4759        Default: yes
4760
4761        This variable controls whether or not Mutt-ng may automatically enable PGP
4762        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
4763        7.4.34  , page 93)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 7.4.38  , page 94)'',
4764        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 7.4.36  , page 94)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
4765        7.4.39  , page 94)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.277  , page 152)''.
4766
4767        _\b7_\b._\b4_\b._\b3_\b6  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn
4768
4769        Type: boolean
4770
4771        Default: no
4772
4773        Setting this variable will cause Mutt-ng to always attempt to cryptographically
4774        sign outgoing messages.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when
4775        signing is not required or encryption is requested as well. If
4776        ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.277  , page 152)'' is _\bs_\be_\bt, then OpenSSL is
4777        used instead to create S/MIME messages and settings can be overridden by use of
4778        the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto only)
4779
4780        _\b7_\b._\b4_\b._\b3_\b7  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bm_\bi_\bm_\be
4781
4782        Type: boolean
4783
4784        Default: yes
4785
4786        This variable controls whether or not Mutt-ng may automatically enable S/MIME
4787        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
4788        7.4.34  , page 93)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 7.4.38  , page 94)'',
4789        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 7.4.36  , page 94)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
4790        7.4.39  , page 94)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 7.4.277  , page 152)''.
4791
4792        _\b7_\b._\b4_\b._\b3_\b8  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt
4793
4794        Type: boolean
4795
4796        Default: yes
4797
4798        If _\bs_\be_\bt, automatically PGP or OpenSSL encrypt replies to messages which are
4799        encrypted.  (Crypto only)
4800
4801        _\b7_\b._\b4_\b._\b3_\b9  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn
4802
4803        Type: boolean
4804
4805        The Mutt Next Generation E-Mail Client                                       95
4806
4807        Default: no
4808
4809        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are signed.
4810
4811        N\bNo\bot\bte\be:\b: this does not work on messages that are encrypted a\ban\bnd\bd signed!  (Crypto
4812        only)
4813
4814        _\b7_\b._\b4_\b._\b4_\b0  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn_\be_\bn_\bc_\br_\by_\bp_\bt_\be_\bd
4815
4816        Type: boolean
4817
4818        Default: no
4819
4820        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are
4821        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
4822        7.4.38  , page 94)'', because it allows you to sign all messages which are
4823        automatically encrypted.  This works around the problem noted in
4824        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section 7.4.39  , page 94)'', that Mutt-ng is not able to
4825        find out whether an encrypted message is also signed.  (Crypto only)
4826
4827        _\b7_\b._\b4_\b._\b4_\b1  _\bc_\br_\by_\bp_\bt_\b__\bt_\bi_\bm_\be_\bs_\bt_\ba_\bm_\bp
4828
4829        Type: boolean
4830
4831        Default: yes
4832
4833        If _\bs_\be_\bt, Mutt-ng will include a time stamp in the lines surrounding PGP or
4834        S/MIME output, so spoofing such lines is more difficult.  If you are using col-
4835        ors to mark these lines, and rely on these, you may _\bu_\bn_\bs_\be_\bt this setting.
4836        (Crypto only)
4837
4838        _\b7_\b._\b4_\b._\b4_\b2  _\bc_\br_\by_\bp_\bt_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\bm_\be
4839
4840        Type: boolean
4841
4842        Default: no
4843
4844        This variable controls the use the GPGME enabled crypto backends.  If it is _\bs_\be_\bt
4845        and Mutt-ng was build with gpgme support, the gpgme code for S/MIME and PGP
4846        will be used instead of the classic code.
4847
4848        N\bNo\bot\bte\be: You need to use this option in your .muttngrc configuration file as it
4849        won't have any effect when used interactively.
4850
4851        _\b7_\b._\b4_\b._\b4_\b3  _\bc_\br_\by_\bp_\bt_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bs_\bi_\bg
4852
4853        Type: quadoption
4854
4855        Default: yes
4856
4857        If ``_\by_\be_\bs'', always attempt to verify PGP or S/MIME signatures.  If ``_\ba_\bs_\bk'', ask
4858        whether or not to verify the signature.  If ``_\bn_\bo'', never attempt to verify
4859        cryptographic signatures.  (Crypto only)
4860
4861        The Mutt Next Generation E-Mail Client                                       96
4862
4863        _\b7_\b._\b4_\b._\b4_\b4  _\bd_\ba_\bt_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4864
4865        Type: string
4866
4867        Default: '!%a, %b %d, %Y at %I:%M:%S%p %Z'
4868
4869        This variable controls the format of the date printed by the ``%d'' sequence in
4870        ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111)''.  This is passed to strftime(3)
4871        to process the date.
4872
4873        Unless the first character in the string is a bang (``!''), the month and week
4874        day names are expanded according to the locale specified in the variable
4875        ``_\b$_\bl_\bo_\bc_\ba_\bl_\be (section 7.4.114  , page 114)''. If the first character in the string
4876        is a bang, the bang is discarded, and the month and week day names in the rest
4877        of the string are expanded in the _\bC locale (that is in US English).
4878
4879        _\b7_\b._\b4_\b._\b4_\b5  _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk
4880
4881        Type: string
4882
4883        Default: '~f %s !~P | (~P ~C %s)'
4884
4885        This variable controls how send-hooks, message-hooks, save-hooks, and fcc-hooks
4886        will be interpreted if they are specified with only a simple regexp, instead of
4887        a matching pattern.  The hooks are expanded when they are declared, so a hook
4888        will be interpreted according to the value of this variable at the time the
4889        hook is declared.  The default value matches if the message is either from a
4890        user matching the regular expression given, or if it is from you (if the from
4891        address matches ``alternates'') and is to or cc'ed to a user matching the given
4892        regular expression.
4893
4894        _\b7_\b._\b4_\b._\b4_\b6  _\bd_\be_\bl_\be_\bt_\be
4895
4896        Type: quadoption
4897
4898        Default: ask-yes
4899
4900        Controls whether or not messages are really deleted when closing or synchroniz-
4901        ing a mailbox.  If set to _\by_\be_\bs, messages marked for deleting will automatically
4902        be purged without prompting.  If set to _\bn_\bo, messages marked for deletion will
4903        be kept in the mailbox.
4904
4905        _\b7_\b._\b4_\b._\b4_\b7  _\bd_\be_\bl_\be_\bt_\be_\b__\bu_\bn_\bt_\ba_\bg
4906
4907        Type: boolean
4908
4909        Default: yes
4910
4911        If this option is _\bs_\be_\bt, Mutt-ng will untag messages when marking them for dele-
4912        tion.  This applies when you either explicitly delete a message, or when you
4913        save it to another folder.
4914
4915        _\b7_\b._\b4_\b._\b4_\b8  _\bd_\bi_\bg_\be_\bs_\bt_\b__\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be
4916
4917        The Mutt Next Generation E-Mail Client                                       97
4918
4919        Type: boolean
4920
4921        Default: yes
4922
4923        If this option is _\bs_\be_\bt, Mutt-ng's received-attachments menu will not show the
4924        subparts of individual messages in a multipart/digest.  To see these subparts,
4925        press 'v' on that menu.
4926
4927        _\b7_\b._\b4_\b._\b4_\b9  _\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br
4928
4929        Type: path
4930
4931        Default: ''
4932
4933        When _\bs_\be_\bt, specifies a command used to filter messages.  When a message is
4934        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.49  ,
4935        page 97), and the filtered message is read from the standard output.
4936
4937        _\b7_\b._\b4_\b._\b5_\b0  _\bd_\bo_\bt_\bl_\bo_\bc_\bk_\b__\bp_\br_\bo_\bg_\br_\ba_\bm
4938
4939        Type: path
4940
4941        Default: '/opt/freebsd4/mutt-ng/bin/muttng_dotlock'
4942
4943        Availability: Standalone and Dotlock
4944
4945        Contains the path of the muttng_dotlock(1) binary to be used by Mutt-ng.
4946
4947        _\b7_\b._\b4_\b._\b5_\b1  _\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by
4948
4949        Type: string
4950
4951        Default: ''
4952
4953        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
4954        or in connection with the SMTP support via libESMTP.
4955
4956        This variable sets the request for when notification is returned.  The string
4957        consists of a comma separated list (no spaces!) of one or more of the follow-
4958        ing: _\bn_\be_\bv_\be_\br, to never request notification, _\bf_\ba_\bi_\bl_\bu_\br_\be, to request notification on
4959        transmission failure, _\bd_\be_\bl_\ba_\by, to be notified of message delays, _\bs_\bu_\bc_\bc_\be_\bs_\bs, to be
4960        notified of successful transmission.
4961
4962        Example: set dsn_notify='failure,delay'
4963
4964        _\b7_\b._\b4_\b._\b5_\b2  _\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn
4965
4966        Type: string
4967
4968        Default: ''
4969
4970        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or greater
4971        or in connection with the SMTP support via libESMTP.
4972
4973        The Mutt Next Generation E-Mail Client                                       98
4974
4975        This variable controls how much of your message is returned in DSN messages.
4976        It may be set to either _\bh_\bd_\br_\bs to return just the message header, or _\bf_\bu_\bl_\bl to
4977        return the full message.
4978
4979        Example: set dsn_return=hdrs
4980
4981        _\b7_\b._\b4_\b._\b5_\b3  _\bd_\bu_\bp_\bl_\bi_\bc_\ba_\bt_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
4982
4983        Type: boolean
4984
4985        Default: yes
4986
4987        This variable controls whether Mutt-ng, when sorting by threads, threads mes-
4988        sages with the same Message-Id: header field together.  If it is _\bs_\be_\bt, it will
4989        indicate that it thinks they are duplicates of each other with an equals sign
4990        in the thread diagram.
4991
4992        _\b7_\b._\b4_\b._\b5_\b4  _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs
4993
4994        Type: boolean
4995
4996        Default: no
4997
4998        This option allows you to edit the header of your outgoing messages along with
4999        the body of your message.
5000
5001        _\b7_\b._\b4_\b._\b5_\b5  _\be_\bd_\bi_\bt_\bo_\br
5002
5003        Type: path
5004
5005        Default: ''
5006
5007        This variable specifies which editor is used by Mutt-ng.  It defaults to the
5008        value of the $VISUAL, or $EDITOR, environment variable, or to the string 'vi'
5009        if neither of those are set.
5010
5011        _\b7_\b._\b4_\b._\b5_\b6  _\be_\bn_\bc_\bo_\bd_\be_\b__\bf_\br_\bo_\bm
5012
5013        Type: boolean
5014
5015        Default: no
5016
5017        When _\bs_\be_\bt, Mutt-ng will quoted-printable encode messages when they contain the
5018        string ``From '' (note the trailing space) in the beginning of a line. Useful
5019        to avoid the tampering certain mail delivery and transport agents tend to do
5020        with messages.
5021
5022        _\b7_\b._\b4_\b._\b5_\b7  _\be_\bn_\bt_\br_\bo_\bp_\by_\b__\bf_\bi_\bl_\be
5023
5024        Type: path
5025
5026        Default: ''
5027
5028        Availability: SSL
5029
5030        The Mutt Next Generation E-Mail Client                                       99
5031
5032        The file which includes random data that is used to initialize SSL library
5033        functions.
5034
5035        _\b7_\b._\b4_\b._\b5_\b8  _\be_\bn_\bv_\be_\bl_\bo_\bp_\be_\b__\bf_\br_\bo_\bm
5036
5037        Type: boolean
5038
5039        Default: no
5040
5041        When _\bs_\be_\bt, Mutt-ng will try to derive the message's _\be_\bn_\bv_\be_\bl_\bo_\bp_\be sender from the
5042        ``From:'' header field. Note that this information is passed to the sendmail
5043        command using the ``-f' command line switch, so don't set this option if you
5044        are using that switch in _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.248  , page 145) yourself, or
5045        if the sendmail on your machine doesn't support that command line switch.
5046
5047        _\b7_\b._\b4_\b._\b5_\b9  _\be_\bs_\bc_\ba_\bp_\be
5048
5049        Type: string
5050
5051        Default: '~'
5052
5053        Escape character to use for functions in the builtin editor.
5054
5055        _\b7_\b._\b4_\b._\b6_\b0  _\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5056
5057        Type: boolean
5058
5059        Default: no
5060
5061        When _\bs_\be_\bt, the initial prompt for recipients and subject are skipped when reply-
5062        ing to messages, and the initial prompt for subject is skipped when forwarding
5063        messages.
5064
5065        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.17  , page
5066        90)'' variable is _\bs_\be_\bt.
5067
5068        _\b7_\b._\b4_\b._\b6_\b1  _\bf_\bc_\bc_\b__\ba_\bt_\bt_\ba_\bc_\bh
5069
5070        Type: boolean
5071
5072        Default: yes
5073
5074        This variable controls whether or not attachments on outgoing messages are
5075        saved along with the main body of your message.
5076
5077        _\b7_\b._\b4_\b._\b6_\b2  _\bf_\bc_\bc_\b__\bc_\bl_\be_\ba_\br
5078
5079        Type: boolean
5080
5081        Default: no
5082
5083        When this variable is _\bs_\be_\bt, FCCs will be stored unencrypted and unsigned, even
5084        when the actual message is encrypted and/or signed.  (PGP only)
5085
5086        The Mutt Next Generation E-Mail Client                                      100
5087
5088        _\b7_\b._\b4_\b._\b6_\b3  _\bf_\bi_\bl_\be_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
5089
5090        Type: string
5091
5092        Default: ''
5093
5094        This variable is a colon-separated list of character encoding schemes for text
5095        file attatchments.  If _\bu_\bn_\bs_\be_\bt, _\b$_\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.24  , page 91) value will
5096        be used instead.  For example, the following configuration would work for
5097        Japanese text handling:
5098
5099        set file_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
5100
5101        Note: ``iso-2022-*'' must be put at the head of the value as shown above if
5102        included.
5103
5104        _\b7_\b._\b4_\b._\b6_\b4  _\bf_\bo_\bl_\bd_\be_\br
5105
5106        Type: path
5107
5108        Default: '~/Mail'
5109
5110        Specifies the default location of your mailboxes.  A ``+'' or ``='' at the
5111        beginning of a pathname will be expanded to the value of this variable.  Note
5112        that if you change this variable from the default value you need to make sure
5113        that the assignment occurs _\bb_\be_\bf_\bo_\br_\be you use ``+'' or ``='' for any other vari-
5114        ables since expansion takes place during the ``set'' command.
5115
5116        _\b7_\b._\b4_\b._\b6_\b5  _\bf_\bo_\bl_\bd_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
5117
5118        Type: string
5119
5120        Default: '%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f'
5121
5122        This variable allows you to customize the file browser display to your personal
5123        taste.  This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page
5124        111)'', but has its own set of printf(3)-like sequences:
5125
5126              %C
5127                    current file number
5128
5129              %d
5130                    date/time folder was last modified
5131
5132              %f
5133                    filename
5134
5135              %F
5136                    file permissions
5137
5138              %g
5139                    group name (or numeric gid, if missing)
5140
5141        The Mutt Next Generation E-Mail Client                                      101
5142
5143              %l
5144                    number of hard links
5145
5146              %N
5147                    N if folder has new mail, blank otherwise
5148
5149              %s
5150                    size in bytes
5151
5152              %t
5153                    * if the file is tagged, blank otherwise
5154
5155              %u
5156                    owner name (or numeric uid, if missing)
5157
5158              %>X
5159                    right justify the rest of the string and pad with character 'X'
5160
5161              %|X
5162                    pad to the end of the line with character 'X'
5163
5164        _\b7_\b._\b4_\b._\b6_\b6  _\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5165
5166        Type: boolean
5167
5168        Default: yes
5169
5170        Controls whether or not the Mail-Followup-To: header field is generated when
5171        sending mail.  When _\bs_\be_\bt, Mutt-ng will generate this field when you are replying
5172        to a known mailing list, specified with the ``subscribe'' or ``_\bl_\bi_\bs_\bt_\bs (section
5173        3.12  , page 32)'' commands or detected by common mailing list headers.
5174
5175        This field has two purposes.  First, preventing you from receiving duplicate
5176        copies of replies to messages which you send to mailing lists. Second, ensuring
5177        that you do get a reply separately for any messages sent to known lists to
5178        which you are not subscribed.  The header will contain only the list's address
5179        for subscribed lists, and both the list address and your own email address for
5180        unsubscribed lists.  Without this header, a group reply to your message sent to
5181        a subscribed list will be sent to both the list and your address, resulting in
5182        two copies of the same email for you.
5183
5184        _\b7_\b._\b4_\b._\b6_\b7  _\bf_\bo_\br_\bc_\be_\b__\bb_\bu_\bf_\bf_\by_\b__\bc_\bh_\be_\bc_\bk
5185
5186        Type: boolean
5187
5188        Default: no
5189
5190        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
5191        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
5192        already known to have new mail.
5193
5194        Also see the following variables: ``_\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 7.4.321  , page 164)'',
5195        ``_\b$_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.115  , page 114)'' and ``_\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section
5196        7.4.99  , page 108)''.
5197
5198        The Mutt Next Generation E-Mail Client                                      102
5199
5200        _\b7_\b._\b4_\b._\b6_\b8  _\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be
5201
5202        Type: boolean
5203
5204        Default: no
5205
5206        This variable is similar to ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.242  , page 144)'',
5207        except that Mutt-ng will store a copy of your outgoing message by the username
5208        of the address you are sending to even if that mailbox does not exist.
5209
5210        Also see the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.231  , page 141)'' variable.
5211
5212        _\b7_\b._\b4_\b._\b6_\b9  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
5213
5214        Type: boolean
5215
5216        Default: yes
5217
5218        Controls the decoding of complex MIME messages into text/plain when forwarding
5219        a message.  The message header is also RFC2047 decoded.  This variable is only
5220        used, if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.137  , page 118)'' is _\bu_\bn_\bs_\be_\bt, otherwise
5221        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.138  , page 119)'' is used instead.
5222
5223        _\b7_\b._\b4_\b._\b7_\b0  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\br_\by_\bp_\bt
5224
5225        Type: boolean
5226
5227        Default: yes
5228
5229        Controls the handling of encrypted messages when forwarding a message.  When
5230        _\bs_\be_\bt, the outer layer of encryption is stripped off.  This variable is only used
5231        if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.137  , page 118)'' is _\bs_\be_\bt and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
5232        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.138  , page 119)'' is _\bu_\bn_\bs_\be_\bt.  (PGP only)
5233
5234        _\b7_\b._\b4_\b._\b7_\b1  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\be_\bd_\bi_\bt
5235
5236        Type: quadoption
5237
5238        Default: yes
5239
5240        This quadoption controls whether or not the user is automatically placed in the
5241        editor when forwarding messages.  For those who always want to forward with no
5242        modification, use a setting of _\bn_\bo.
5243
5244        _\b7_\b._\b4_\b._\b7_\b2  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
5245
5246        Type: string
5247
5248        Default: '[%a: %s]'
5249
5250        This variable controls the default subject when forwarding a message.  It uses
5251        the same format sequences as the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page
5252        111)'' variable.
5253
5254        The Mutt Next Generation E-Mail Client                                      103
5255
5256        _\b7_\b._\b4_\b._\b7_\b3  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bq_\bu_\bo_\bt_\be
5257
5258        Type: boolean
5259
5260        Default: no
5261
5262        When _\bs_\be_\bt forwarded messages included in the main body of the message (when
5263        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.137  , page 118)'' is _\bu_\bn_\bs_\be_\bt) will be quoted using
5264        ``_\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.109  , page 111)''.
5265
5266        _\b7_\b._\b4_\b._\b7_\b4  _\bf_\br_\bo_\bm
5267
5268        Type: e-mail address
5269
5270        Default: ''
5271
5272        This variable contains a default from address.  It can be overridden using
5273        my_hdr (including from send-hooks) and ``_\b$_\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.237  , page
5274        143)''.  This variable is ignored if ``_\b$_\bu_\bs_\be_\b__\bf_\br_\bo_\bm (section 7.4.330  , page
5275        166)'' is unset.
5276
5277        E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar
5278        <foo@bar.fb>' when replying to the mutt-ng developer's mailing list and Mutt-ng
5279        takes this email address.
5280
5281        Defaults to the contents of the environment variable $EMAIL.
5282
5283        _\b7_\b._\b4_\b._\b7_\b5  _\bg_\be_\bc_\bo_\bs_\b__\bm_\ba_\bs_\bk
5284
5285        Type: regular expression
5286
5287        Default: '^[^,]*'
5288
5289        A regular expression used by Mutt-ng to parse the GECOS field of a password
5290        entry when expanding the alias.  By default the regular expression is set to
5291        ``^[^,]*'' which will return the string up to the first ``,'' encountered.  If
5292        the GECOS field contains a string like 'lastname, firstname' then you should
5293        do: set gecos_mask='.*'.
5294
5295        This can be useful if you see the following behavior: you address a e-mail to
5296        user ID stevef whose full name is Steve Franklin.  If Mutt-ng expands stevef to
5297        ``Franklin'' stevef@foo.bar then you should set the gecos_mask to a regular
5298        expression that will match the whole name so Mutt-ng will expand ``Franklin''
5299        to ``Franklin, Steve''.
5300
5301        _\b7_\b._\b4_\b._\b7_\b6  _\bh_\bd_\br_\bs
5302
5303        Type: boolean
5304
5305        Default: yes
5306
5307        When _\bu_\bn_\bs_\be_\bt, the header fields normally added by the ``_\bm_\by_\b__\bh_\bd_\br (section 3.15  ,
5308        page 34)'' command are not created.  This variable _\bm_\bu_\bs_\bt be _\bu_\bn_\bs_\be_\bt before compos-
5309        ing a new message or replying in order to take effect.  If _\bs_\be_\bt, the user
5310
5311        The Mutt Next Generation E-Mail Client                                      104
5312
5313        defined header fields are added to every new message.
5314
5315        _\b7_\b._\b4_\b._\b7_\b7  _\bh_\be_\ba_\bd_\be_\br
5316
5317        Type: boolean
5318
5319        Default: no
5320
5321        When _\bs_\be_\bt, this variable causes Mutt-ng to include the header of the message you
5322        are replying to into the edit buffer.  The ``_\b$_\bw_\be_\be_\bd (section 7.4.336  , page
5323        168)'' setting applies.
5324
5325        _\b7_\b._\b4_\b._\b7_\b8  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be
5326
5327        Type: path
5328
5329        Default: ''
5330
5331        Availability: Header Cache
5332
5333        The _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 7.4.78  , page 104) variable points to the header
5334        cache database.
5335
5336        If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 7.4.78  , page 104) points to a directory it will
5337        contain a header cache database  per folder. If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section
5338        7.4.78  , page 104) points to a file that file will be a single global header
5339        cache. By default it is _\bu_\bn_\bs_\be_\bt so no header caching will be used.
5340
5341        _\b7_\b._\b4_\b._\b7_\b9  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be_\b__\bc_\bo_\bm_\bp_\br_\be_\bs_\bs
5342
5343        Type: boolean
5344
5345        Default: no
5346
5347        If enabled the header cache will be compressed. So only one fifth of the usual
5348        diskspace is used, but the uncompression can result in a slower open of the
5349        cached folder.
5350
5351        _\b7_\b._\b4_\b._\b8_\b0  _\bh_\be_\bl_\bp
5352
5353        Type: boolean
5354
5355        Default: yes
5356
5357        When _\bs_\be_\bt, help lines describing the bindings for the major functions provided
5358        by each menu are displayed on the first line of the screen.
5359
5360        N\bNo\bot\bte\be:\b: The binding will not be displayed correctly if the function is bound to a
5361        sequence rather than a single keystroke.  Also, the help line may not be
5362        updated if a binding is changed while Mutt-ng is running.  Since this variable
5363        is primarily aimed at new users, neither of these should present a major prob-
5364        lem.
5365
5366        The Mutt Next Generation E-Mail Client                                      105
5367
5368        _\b7_\b._\b4_\b._\b8_\b1  _\bh_\bi_\bd_\bd_\be_\bn_\b__\bh_\bo_\bs_\bt
5369
5370        Type: boolean
5371
5372        Default: no
5373
5374        When _\bs_\be_\bt, Mutt-ng will skip the host name part of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section
5375        7.4.89  , page 106)'' variable when adding the domain part to addresses.  This
5376        variable does not affect the generation of Message-ID: header fields, and it
5377        will not lead to the cut-off of first-level domains.
5378
5379        _\b7_\b._\b4_\b._\b8_\b2  _\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5380
5381        Type: boolean
5382
5383        Default: no
5384
5385        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5386        limiting, in the thread tree.
5387
5388        _\b7_\b._\b4_\b._\b8_\b3  _\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5389
5390        Type: boolean
5391
5392        Default: yes
5393
5394        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages in the thread
5395        tree.
5396
5397        _\b7_\b._\b4_\b._\b8_\b4  _\bh_\bi_\bd_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
5398
5399        Type: boolean
5400
5401        Default: yes
5402
5403        When _\bs_\be_\bt, Mutt-ng will not show the subject of messages in the thread tree that
5404        have the same subject as their parent or closest previously displayed sibling.
5405
5406        _\b7_\b._\b4_\b._\b8_\b5  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
5407
5408        Type: boolean
5409
5410        Default: no
5411
5412        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
5413        limiting, at the top of threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\b-
5414        _\bi_\bn_\bg (section 7.4.83  , page 105) is set, this option will have no effect.
5415
5416        _\b7_\b._\b4_\b._\b8_\b6  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
5417
5418        Type: boolean
5419
5420        Default: yes
5421
5422        The Mutt Next Generation E-Mail Client                                      106
5423
5424        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages at the top of
5425        threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd (section 7.4.82  ,
5426        page 105) is _\bs_\be_\bt, this option will have no effect.
5427
5428        _\b7_\b._\b4_\b._\b8_\b7  _\bh_\bi_\bs_\bt_\bo_\br_\by
5429
5430        Type: number
5431
5432        Default: 10
5433
5434        This variable controls the size (in number of strings remembered) of the string
5435        history buffer. The buffer is cleared each time the variable is changed.
5436
5437        _\b7_\b._\b4_\b._\b8_\b8  _\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5438
5439        Type: quadoption
5440
5441        Default: yes
5442
5443        This variable controls whether or not a Mail-Followup-To: header field is hon-
5444        ored when group-replying to a message.
5445
5446        _\b7_\b._\b4_\b._\b8_\b9  _\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be
5447
5448        Type: string
5449
5450        Default: ''
5451
5452        Specifies the hostname to use after the ``@'' in local e-mail addresses and
5453        during generation of Message-Id: headers.
5454
5455        Please be sure to really know what you are doing when changing this variable to
5456        configure a custom domain part of Message-IDs.
5457
5458        _\b7_\b._\b4_\b._\b9_\b0  _\bi_\bg_\bn_\bo_\br_\be_\b__\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by_\b__\bt_\bo
5459
5460        Type: boolean
5461
5462        Default: no
5463
5464        Affects the behaviour of the _\br_\be_\bp_\bl_\by function when replying to messages from
5465        mailing lists.  When _\bs_\be_\bt, if the ``Reply-To:'' header field is set to the same
5466        value as the ``To:'' header field, Mutt-ng assumes that the ``Reply-To:''
5467        header field was set by the mailing list to automate responses to the list, and
5468        will ignore this field.  To direct a response to the mailing list when this
5469        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
5470        sender and the list.
5471
5472        _\b7_\b._\b4_\b._\b9_\b1  _\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
5473
5474        Type: string
5475
5476        Default: ''
5477
5478        The Mutt Next Generation E-Mail Client                                      107
5479
5480        Availability: IMAP
5481
5482        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
5483        use to log in to an IMAP server, in the order Mutt-ng should try them.  Authen-
5484        tication methods are either ``login'' or the right side of an IMAP ``AUTH=''
5485        capability string, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''. This param-
5486        eter is case-insensitive.
5487
5488        If this parameter is _\bu_\bn_\bs_\be_\bt (the default) Mutt-ng will try all available meth-
5489        ods, in order from most-secure to least-secure.
5490
5491        Example: set imap_authenticators='gssapi:cram-md5:login'
5492
5493        N\bNo\bot\bte\be:\b: Mutt-ng will only fall back to other authentication methods if the previ-
5494        ous methods are unavailable. If a method is available but authentication fails,
5495        Mutt-ng will not connect to the IMAP server.
5496
5497        _\b7_\b._\b4_\b._\b9_\b2  _\bi_\bm_\ba_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5498
5499        Type: boolean
5500
5501        Default: no
5502
5503        When _\bs_\be_\bt, mutt will fetch the set of subscribed folders from your server on
5504        connection, and add them to the set of mailboxes it polls for new mail. See
5505        also the ``_\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.14  , page 33)'' command.
5506
5507        _\b7_\b._\b4_\b._\b9_\b3  _\bi_\bm_\ba_\bp_\b__\bd_\be_\bl_\bi_\bm_\b__\bc_\bh_\ba_\br_\bs
5508
5509        Type: string
5510
5511        Default: '/.'
5512
5513        Availability: IMAP
5514
5515        This contains the list of characters which you would like to treat as folder
5516        separators for displaying IMAP paths. In particular it helps in using the '='
5517        shortcut for your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.64  , page 100) variable.
5518
5519        _\b7_\b._\b4_\b._\b9_\b4  _\bi_\bm_\ba_\bp_\b__\bh_\be_\ba_\bd_\be_\br_\bs
5520
5521        Type: string
5522
5523        Default: ''
5524
5525        Availability: IMAP
5526
5527        Mutt-ng requests these header fields in addition to the default headers (``DATE
5528        FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-
5529        REPLY-TO REPLY-TO LINES X-LABEL'') from IMAP servers before displaying the
5530        ``index'' menu. You may want to add more headers for spam detection.
5531
5532        N\bNo\bot\bte\be:\b: This is a space separated list.
5533
5534        The Mutt Next Generation E-Mail Client                                      108
5535
5536        _\b7_\b._\b4_\b._\b9_\b5  _\bi_\bm_\ba_\bp_\b__\bh_\bo_\bm_\be_\b__\bn_\ba_\bm_\be_\bs_\bp_\ba_\bc_\be
5537
5538        Type: string
5539
5540        Default: ''
5541
5542        Availability: IMAP
5543
5544        You normally want to see your personal folders alongside your INBOX in the IMAP
5545        browser. If you see something else, you may set this variable to the IMAP path
5546        to your folders.
5547
5548        _\b7_\b._\b4_\b._\b9_\b6  _\bi_\bm_\ba_\bp_\b__\bk_\be_\be_\bp_\ba_\bl_\bi_\bv_\be
5549
5550        Type: number
5551
5552        Default: 900
5553
5554        Availability: IMAP
5555
5556        This variable specifies the maximum amount of time in seconds that Mutt-ng will
5557        wait before polling open IMAP connections, to prevent the server from closing
5558        them before Mutt-ng has finished with them.
5559
5560        The default is well within the RFC-specified minimum amount of time (30 min-
5561        utes) before a server is allowed to do this, but in practice the RFC does get
5562        violated every now and then.
5563
5564        Reduce this number if you find yourself getting disconnected from your IMAP
5565        server due to inactivity.
5566
5567        _\b7_\b._\b4_\b._\b9_\b7  _\bi_\bm_\ba_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5568
5569        Type: boolean
5570
5571        Default: no
5572
5573        Availability: IMAP
5574
5575        This variable configures whether IMAP folder browsing will look for only sub-
5576        scribed folders or all folders.  This can be toggled in the IMAP browser with
5577        the _\bt_\bo_\bg_\bg_\bl_\be_\b-_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd function.
5578
5579        _\b7_\b._\b4_\b._\b9_\b8  _\bi_\bm_\ba_\bp_\b__\bl_\bo_\bg_\bi_\bn
5580
5581        Type: string
5582
5583        Default: ''
5584
5585        Availability: IMAP
5586
5587        Your login name on the IMAP server.
5588
5589        This variable defaults to the value of ``_\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 7.4.105  , page
5590
5591        The Mutt Next Generation E-Mail Client                                      109
5592
5593        110).''
5594
5595        _\b7_\b._\b4_\b._\b9_\b9  _\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5596
5597        Type: number
5598
5599        Default: 300
5600
5601        This variable configures how often (in seconds) Mutt-ng should look for new
5602        mail in IMAP folders. This is split from the ``_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 7.4.115  ,
5603        page 114)'' variable to generate less traffic and get more accurate information
5604        for local folders.
5605
5606        _\b7_\b._\b4_\b._\b1_\b0_\b0  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs
5607
5608        Type: string
5609
5610        Default: ''
5611
5612        Availability: IMAP
5613
5614        Specifies the password for your IMAP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt
5615        you for your password when you invoke the fetch-mail function.
5616
5617        W\bWa\bar\brn\bni\bin\bng\bg: you should only use this option when you are on a fairly secure
5618        machine, because the superuser can read your configuration even if you are the
5619        only one who can read the file.
5620
5621        _\b7_\b._\b4_\b._\b1_\b0_\b1  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs_\bi_\bv_\be
5622
5623        Type: boolean
5624
5625        Default: yes
5626
5627        Availability: IMAP
5628
5629        When _\bs_\be_\bt, Mutt-ng will not open new IMAP connections to check for new mail.
5630        Mutt-ng will only check for new mail over existing IMAP connections.  This is
5631        useful if you don't want to be prompted to user/password pairs on Mutt-ng invo-
5632        cation, or if opening the connection is slow.
5633
5634        _\b7_\b._\b4_\b._\b1_\b0_\b2  _\bi_\bm_\ba_\bp_\b__\bp_\be_\be_\bk
5635
5636        Type: boolean
5637
5638        Default: yes
5639
5640        Availability: IMAP
5641
5642        If _\bs_\be_\bt, Mutt-ng will avoid implicitly marking your mail as read whenever you
5643        fetch a message from the server. This is generally a good thing, but can make
5644        closing an IMAP folder somewhat slower. This option exists to appease speed
5645        freaks.
5646
5647        The Mutt Next Generation E-Mail Client                                      110
5648
5649        _\b7_\b._\b4_\b._\b1_\b0_\b3  _\bi_\bm_\ba_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
5650
5651        Type: quadoption
5652
5653        Default: ask-yes
5654
5655        Availability: IMAP
5656
5657        Controls whether or not Mutt-ng will try to reconnect to IMAP server when the
5658        connection is lost.
5659
5660        _\b7_\b._\b4_\b._\b1_\b0_\b4  _\bi_\bm_\ba_\bp_\b__\bs_\be_\br_\bv_\be_\br_\bn_\bo_\bi_\bs_\be
5661
5662        Type: boolean
5663
5664        Default: yes
5665
5666        Availability: IMAP
5667
5668        When _\bs_\be_\bt, Mutt-ng will display warning messages from the IMAP server as error
5669        messages. Since these messages are often harmless, or generated due to configu-
5670        ration problems on the server which are out of the users' hands, you may wish
5671        to suppress them at some point.
5672
5673        _\b7_\b._\b4_\b._\b1_\b0_\b5  _\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br
5674
5675        Type: string
5676
5677        Default: ''
5678
5679        Availability: IMAP
5680
5681        The name of the user whose mail you intend to access on the IMAP server.
5682
5683        This variable defaults to your user name on the local machine.
5684
5685        _\b7_\b._\b4_\b._\b1_\b0_\b6  _\bi_\bm_\bp_\bl_\bi_\bc_\bi_\bt_\b__\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw
5686
5687        Type: boolean
5688
5689        Default: no
5690
5691        If _\bs_\be_\bt, Mutt-ng will look for a mailcap entry with the ``copiousoutput'' flag
5692        set for _\be_\bv_\be_\br_\by MIME attachment it doesn't have an internal viewer defined for.
5693        If such an entry is found, Mutt-ng will use the viewer defined in that entry to
5694        convert the body part to text form.
5695
5696        _\b7_\b._\b4_\b._\b1_\b0_\b7  _\bi_\bn_\bc_\bl_\bu_\bd_\be
5697
5698        Type: quadoption
5699
5700        Default: ask-yes
5701
5702        Controls whether or not a copy of the message(s) you are replying to is
5703
5704        The Mutt Next Generation E-Mail Client                                      111
5705
5706        included in your reply.
5707
5708        _\b7_\b._\b4_\b._\b1_\b0_\b8  _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b__\bo_\bn_\bl_\by_\bf_\bi_\br_\bs_\bt
5709
5710        Type: boolean
5711
5712        Default: no
5713
5714        Controls whether or not Mutt-ng includes only the first attachment of the mes-
5715        sage you are replying.
5716
5717        _\b7_\b._\b4_\b._\b1_\b0_\b9  _\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
5718
5719        Type: string
5720
5721        Default: '> '
5722
5723        Specifies the string to prepend to each line of text quoted in a message to
5724        which you are replying.  You are strongly encouraged not to change this value,
5725        as it tends to agitate the more fanatical netizens.
5726
5727        _\b7_\b._\b4_\b._\b1_\b1_\b0  _\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
5728
5729        Type: string
5730
5731        Default: '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
5732
5733        This variable allows you to customize the message index display to your per-
5734        sonal taste.
5735
5736        ``Format strings'' are similar to the strings used in the ``C'' function
5737        printf(3) to format output (see the man page for more detail).  The following
5738        sequences are defined in Mutt-ng:
5739
5740              %a
5741                    address of the author
5742
5743              %A
5744                    reply-to address (if present; otherwise: address of author)
5745
5746              %b
5747                    filename of the original message folder (think mailBox)
5748
5749              %B
5750                    the list to which the letter was sent, or else the folder name
5751                    (%b).
5752
5753              %c
5754                    number of characters (bytes) in the message
5755
5756              %C
5757                    current message number
5758
5759        The Mutt Next Generation E-Mail Client                                      112
5760
5761              %d
5762                    date and time of the message in the format specified by ``date_for-
5763                    mat'' converted to sender's time zone
5764
5765              %D
5766                    date and time of the message in the format specified by ``date_for-
5767                    mat'' converted to the local time zone
5768
5769              %e
5770                    current message number in thread
5771
5772              %E
5773                    number of messages in current thread
5774
5775              %f
5776                    entire From: line (address + real name)
5777
5778              %F
5779                    author name, or recipient name if the message is from you
5780
5781              %H
5782                    spam attribute(s) of this message
5783
5784              %g
5785                    newsgroup name (if compiled with nntp support)
5786
5787              %i
5788                    message-id of the current message
5789
5790              %l
5791                    number of lines in the message (does not work with maildir, mh, and
5792                    possibly IMAP folders)
5793
5794              %L
5795                    If an address in the To or CC header field matches an address
5796                    defined by the users ``subscribe'' command, this displays 'To
5797                    <list-name>', otherwise the same as %F.
5798
5799              %m
5800                    total number of message in the mailbox
5801
5802              %M
5803                    number of hidden messages if the thread is collapsed.
5804
5805              %N
5806                    message score
5807
5808              %n
5809                    author's real name (or address if missing)
5810
5811              %O
5812                    (_O_riginal save folder)  Where Mutt-ng would formerly have stashed
5813                    the message: list name or recipient name if no list
5814
5815        The Mutt Next Generation E-Mail Client                                      113
5816
5817              %s
5818                    subject of the message
5819
5820              %S
5821                    status of the message (N/D/d/!/r/*)
5822
5823              %t
5824                    `to:' field (recipients)
5825
5826              %T
5827                    the appropriate character from the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.323  ,
5828                    page 165) string
5829
5830              %u
5831                    user (login) name of the author
5832
5833              %v
5834                    first name of the author, or the recipient if the message is from
5835                    you
5836
5837              %W
5838                    name of organization of author (`organization:' field)
5839
5840              %y
5841                    `x-label:' field, if present
5842
5843              %Y
5844                    `x-label' field, if present, and (1) not at part of a thread tree,
5845                    (2) at the top of a thread, or (3) `x-label' is different from pre-
5846                    ceding message's `x-label'.
5847
5848              %Z
5849                    message status flags
5850
5851              %{fmt}
5852                    the date and time of the message is converted to sender's time
5853                    zone, and ``fmt'' is expanded by the library function ``strftime'';
5854                    a leading bang disables locales
5855
5856              %[fmt]
5857                    the date and time of the message is converted to the local time
5858                    zone, and ``fmt'' is expanded by the library function ``strftime'';
5859                    a leading bang disables locales
5860
5861              %(fmt)
5862                    the local date and time when the message was received.  ``fmt'' is
5863                    expanded by the library function ``strftime''; a leading bang dis-
5864                    ables locales
5865
5866              %<fmt>
5867                    the current local time. ``fmt'' is expanded by the library function
5868                    ``strftime''; a leading bang disables locales.
5869
5870        The Mutt Next Generation E-Mail Client                                      114
5871
5872              %>X
5873                    right justify the rest of the string and pad with character 'X'
5874
5875              %|X
5876                    pad to the end of the line with character 'X'
5877
5878        See also: ``_\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 7.4.323  , page 165)''.
5879
5880        _\b7_\b._\b4_\b._\b1_\b1_\b1  _\bi_\bs_\bp_\be_\bl_\bl
5881
5882        Type: path
5883
5884        Default: 'ispell'
5885
5886        How to invoke ispell (GNU's spell-checking software).
5887
5888        _\b7_\b._\b4_\b._\b1_\b1_\b2  _\bk_\be_\be_\bp_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
5889
5890        Type: boolean
5891
5892        Default: no
5893
5894        If _\bs_\be_\bt, read messages marked as flagged will not be moved from your spool mail-
5895        box to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.125  , page 116)'' mailbox, or as a result of
5896        a ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 33)'' command.
5897
5898        _\b7_\b._\b4_\b._\b1_\b1_\b3  _\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5899
5900        Type: quadoption
5901
5902        Default: no
5903
5904        When _\bs_\be_\bt, address replies to the mailing list the original message came from
5905        (instead to the author only). Setting this option to ``_\ba_\bs_\bk_\b-_\by_\be_\bs'' or ``_\ba_\bs_\bk_\b-_\bn_\bo''
5906        will ask if you really intended to reply to the author only.
5907
5908        _\b7_\b._\b4_\b._\b1_\b1_\b4  _\bl_\bo_\bc_\ba_\bl_\be
5909
5910        Type: string
5911
5912        Default: 'C'
5913
5914        The locale used by strftime(3) to format dates. Legal values are the strings
5915        your system accepts for the locale variable LC_TIME.
5916
5917        _\b7_\b._\b4_\b._\b1_\b1_\b5  _\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5918
5919        Type: number
5920
5921        Default: 5
5922
5923        This variable configures how often (in seconds) Mutt-ng should look for new
5924        mail.
5925
5926        The Mutt Next Generation E-Mail Client                                      115
5927
5928        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
5929        7.4.99  , page 108).
5930
5931        _\b7_\b._\b4_\b._\b1_\b1_\b6  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh
5932
5933        Type: string
5934
5935        Default: ''
5936
5937        This variable specifies which files to consult when attempting to display MIME
5938        bodies not directly supported by Mutt-ng.
5939
5940        _\b7_\b._\b4_\b._\b1_\b1_\b7  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be
5941
5942        Type: boolean
5943
5944        Default: yes
5945
5946        If _\bs_\be_\bt, Mutt-ng will restrict possible characters in mailcap % expandos to a
5947        well-defined set of safe characters.  This is the safe setting, but we are not
5948        sure it doesn't break some more advanced MIME stuff.
5949
5950        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!
5951
5952        _\b7_\b._\b4_\b._\b1_\b1_\b8  _\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
5953
5954        Type: boolean
5955
5956        Default: yes
5957
5958        Availability: Header Cache
5959
5960        Check for Maildir unaware programs other than Mutt-ng having modified maildir
5961        files when the header cache is in use. This incurs one stat(2) per message
5962        every time the folder is opened.
5963
5964        _\b7_\b._\b4_\b._\b1_\b1_\b9  _\bm_\ba_\bi_\bl_\bd_\bi_\br_\b__\bt_\br_\ba_\bs_\bh
5965
5966        Type: boolean
5967
5968        Default: no
5969
5970        If _\bs_\be_\bt, messages marked as deleted will be saved with the maildir (T)rashed
5971        flag instead of physically deleted.
5972
5973        N\bNO\bOT\bTE\bE:\b: this only applies to maildir-style mailboxes. Setting it will have no
5974        effect on other mailbox types.
5975
5976        It is similiar to the trash option.
5977
5978        _\b7_\b._\b4_\b._\b1_\b2_\b0  _\bm_\ba_\br_\bk_\b__\bo_\bl_\bd
5979
5980        Type: boolean
5981
5982        The Mutt Next Generation E-Mail Client                                      116
5983
5984        Default: yes
5985
5986        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
5987        mailbox without reading them.
5988
5989        With this option _\bs_\be_\bt, the next time you start Mutt-ng, the messages will show
5990        up with an 'O' next to them in the ``index'' menu, indicating that they are
5991        old.
5992
5993        _\b7_\b._\b4_\b._\b1_\b2_\b1  _\bm_\ba_\br_\bk_\be_\br_\bs
5994
5995        Type: boolean
5996
5997        Default: yes
5998
5999        Controls the display of wrapped lines in the internal pager. If set, a ``+''
6000        marker is displayed at the beginning of wrapped lines. Also see the
6001        ``_\b$_\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp (section 7.4.263  , page 149)'' variable.
6002
6003        _\b7_\b._\b4_\b._\b1_\b2_\b2  _\bm_\ba_\bs_\bk
6004
6005        Type: regular expression
6006
6007        Default: '!^\.[^.]'
6008
6009        A regular expression used in the file browser, optionally preceded by the _\bn_\bo_\bt
6010        operator ``!''.  Only files whose names match this mask will be shown. The
6011        match is always case-sensitive.
6012
6013        _\b7_\b._\b4_\b._\b1_\b2_\b3  _\bm_\ba_\bx_\b__\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\br_\be_\bc_\bi_\bp_\bs
6014
6015        Type: number
6016
6017        Default: 0
6018
6019        When set non-zero, this specifies the maximum number of recipient header lines
6020        (To:, Cc: and Bcc:) to display in the pager if header weeding is turned on. In
6021        case the number of lines exeeds its value, the last line will have 3 dots
6022        appended.
6023
6024        _\b7_\b._\b4_\b._\b1_\b2_\b4  _\bm_\ba_\bx_\b__\bl_\bi_\bn_\be_\b__\bl_\be_\bn_\bg_\bt_\bh
6025
6026        Type: number
6027
6028        Default: 0
6029
6030        When _\bs_\be_\bt, the maximum line length for displaying ``format = flowed'' messages
6031        is limited to this length. A value of 0 (which is also the default) means that
6032        the maximum line length is determined by the terminal width and _\b$_\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
6033        (section 7.4.338  , page 168).
6034
6035        _\b7_\b._\b4_\b._\b1_\b2_\b5  _\bm_\bb_\bo_\bx
6036
6037        Type: path
6038
6039        The Mutt Next Generation E-Mail Client                                      117
6040
6041        Default: '~/mbox'
6042
6043        This specifies the folder into which read mail in your ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
6044        7.4.297  , page 157)'' folder will be appended.
6045
6046        _\b7_\b._\b4_\b._\b1_\b2_\b6  _\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be
6047
6048        Type: folder magic
6049
6050        Default: mbox
6051
6052        The default mailbox type used when creating new folders. May be any of mbox,
6053        MMDF, MH and Maildir.
6054
6055        _\b7_\b._\b4_\b._\b1_\b2_\b7  _\bm_\be_\bn_\bu_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6056
6057        Type: number
6058
6059        Default: 0
6060
6061        This variable controls the number of lines of context that are given when
6062        scrolling through menus. (Similar to ``_\b$_\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.168  , page
6063        127)''.)
6064
6065        _\b7_\b._\b4_\b._\b1_\b2_\b8  _\bm_\be_\bn_\bu_\b__\bm_\bo_\bv_\be_\b__\bo_\bf_\bf
6066
6067        Type: boolean
6068
6069        Default: yes
6070
6071        When _\bu_\bn_\bs_\be_\bt, the bottom entry of menus will never scroll up past the bottom of
6072        the screen, unless there are less entries than lines.  When _\bs_\be_\bt, the bottom
6073        entry may move off the bottom.
6074
6075        _\b7_\b._\b4_\b._\b1_\b2_\b9  _\bm_\be_\bn_\bu_\b__\bs_\bc_\br_\bo_\bl_\bl
6076
6077        Type: boolean
6078
6079        Default: no
6080
6081        When _\bs_\be_\bt, menus will be scrolled up or down one line when you attempt to move
6082        across a screen boundary.  If _\bu_\bn_\bs_\be_\bt, the screen is cleared and the next or pre-
6083        vious page of the menu is displayed (useful for slow links to avoid many
6084        redraws).
6085
6086        _\b7_\b._\b4_\b._\b1_\b3_\b0  _\bm_\be_\bs_\bs_\ba_\bg_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
6087
6088        Type: string
6089
6090        Default: '%s'
6091
6092        This is the string displayed in the ``attachment'' menu for attachments of type
6093        message/rfc822.  For a full listing of defined printf(3)-like sequences see the
6094        section on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111)''.
6095
6096        The Mutt Next Generation E-Mail Client                                      118
6097
6098        _\b7_\b._\b4_\b._\b1_\b3_\b1  _\bm_\be_\bt_\ba_\b__\bk_\be_\by
6099
6100        Type: boolean
6101
6102        Default: no
6103
6104        If _\bs_\be_\bt, forces Mutt-ng to interpret keystrokes with the high bit (bit 8) set as
6105        if the user had pressed the ESC key and whatever key remains after having the
6106        high bit removed.  For example, if the key pressed has an ASCII value of 0xf4,
6107        then this is treated as if the user had pressed ESC then ``x''.  This is
6108        because the result of removing the high bit from ``0xf4'' is ``0x74'', which is
6109        the ASCII character ``x''.
6110
6111        _\b7_\b._\b4_\b._\b1_\b3_\b2  _\bm_\be_\bt_\bo_\bo
6112
6113        Type: boolean
6114
6115        Default: no
6116
6117        If _\bu_\bn_\bs_\be_\bt, Mutt-ng will remove your address (see the ``alternates'' command)
6118        from the list of recipients when replying to a message.
6119
6120        _\b7_\b._\b4_\b._\b1_\b3_\b3  _\bm_\bh_\b__\bp_\bu_\br_\bg_\be
6121
6122        Type: boolean
6123
6124        Default: no
6125
6126        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will mimic mh's behaviour and rename deleted messages to
6127        _\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-
6128        able is set, the message files will simply be deleted.
6129
6130        _\b7_\b._\b4_\b._\b1_\b3_\b4  _\bm_\bh_\b__\bs_\be_\bq_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
6131
6132        Type: string
6133
6134        Default: 'flagged'
6135
6136        The name of the MH sequence used for flagged messages.
6137
6138        _\b7_\b._\b4_\b._\b1_\b3_\b5  _\bm_\bh_\b__\bs_\be_\bq_\b__\br_\be_\bp_\bl_\bi_\be_\bd
6139
6140        Type: string
6141
6142        Default: 'replied'
6143
6144        The name of the MH sequence used to tag replied messages.
6145
6146        _\b7_\b._\b4_\b._\b1_\b3_\b6  _\bm_\bh_\b__\bs_\be_\bq_\b__\bu_\bn_\bs_\be_\be_\bn
6147
6148        Type: string
6149
6150        Default: 'unseen'
6151
6152        The Mutt Next Generation E-Mail Client                                      119
6153
6154        The name of the MH sequence used for unseen messages.
6155
6156        _\b7_\b._\b4_\b._\b1_\b3_\b7  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd
6157
6158        Type: quadoption
6159
6160        Default: no
6161
6162        When _\bs_\be_\bt, the message you are forwarding will be attached as a separate MIME
6163        part instead of included in the main body of the message.
6164
6165        This is useful for forwarding MIME messages so the receiver can properly view
6166        the message as it was delivered to you. If you like to switch between MIME and
6167        not MIME from mail to mail, set this variable to ask-no or ask-yes.
6168
6169        Also see ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.69  , page 102)'' and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
6170        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.138  , page 119)''.
6171
6172        _\b7_\b._\b4_\b._\b1_\b3_\b8  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
6173
6174        Type: boolean
6175
6176        Default: no
6177
6178        Controls the decoding of complex MIME messages into text/plain when forwarding
6179        a message while ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 7.4.137  , page 118)'' is _\bs_\be_\bt. Other-
6180        wise ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 7.4.69  , page 102)'' is used instead.
6181
6182        _\b7_\b._\b4_\b._\b1_\b3_\b9  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\br_\be_\bs_\bt
6183
6184        Type: quadoption
6185
6186        Default: yes
6187
6188        When forwarding multiple attachments of a MIME message from the recvattach
6189        menu, attachments which cannot be decoded in a reasonable manner will be
6190        attached to the newly composed message if this option is set.
6191
6192        _\b7_\b._\b4_\b._\b1_\b4_\b0  _\bm_\bi_\bx_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
6193
6194        Type: string
6195
6196        Default: '%4n %c %-16s %a'
6197
6198        Availability: Mixmaster
6199
6200        This variable describes the format of a remailer line on the mixmaster chain
6201        selection screen.  The following printf(3)-like sequences are supported:
6202
6203              %n
6204                    The running number on the menu.
6205
6206              %c
6207                    Remailer capabilities.
6208
6209        The Mutt Next Generation E-Mail Client                                      120
6210
6211              %s
6212                    The remailer's short name.
6213
6214              %a
6215                    The remailer's e-mail address.
6216
6217        _\b7_\b._\b4_\b._\b1_\b4_\b1  _\bm_\bi_\bx_\bm_\ba_\bs_\bt_\be_\br
6218
6219        Type: path
6220
6221        Default: 'mixmaster'
6222
6223        Availability: Mixmaster
6224
6225        This variable contains the path to the Mixmaster binary on your system.  It is
6226        used with various sets of parameters to gather the list of known remailers, and
6227        to finally send a message through the mixmaster chain.
6228
6229        _\b7_\b._\b4_\b._\b1_\b4_\b2  _\bm_\bo_\bv_\be
6230
6231        Type: quadoption
6232
6233        Default: ask-no
6234
6235        Controls whether or not Mutt-ng will move read messages from your spool mailbox
6236        to your ``_\b$_\bm_\bb_\bo_\bx (section 7.4.125  , page 116)'' mailbox, or as a result of a
6237        ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.13  , page 33)'' command.
6238
6239        _\b7_\b._\b4_\b._\b1_\b4_\b3  _\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
6240
6241        Type: string
6242
6243        Default: '%Y%m%d%h%M%s.G%P%p'
6244
6245        This is the format for the ``local part'' of the Message-Id: header field gen-
6246        erated by Mutt-ng. If this variable is empty, no Message-Id: headers will be
6247        generated. The '%' character marks that certain data will be added to the
6248        string, similar to printf(3). The following characters are allowed:
6249
6250              %d
6251                    the current day of month
6252
6253              %h
6254                    the current hour
6255
6256              %m
6257                    the current month
6258
6259              %M
6260                    the current minute
6261
6262              %O
6263                    the current UNIX timestamp (octal)
6264
6265        The Mutt Next Generation E-Mail Client                                      121
6266
6267              %p
6268                    the process ID
6269
6270              %P
6271                    the current Message-ID prefix (a character rotating with every Mes-
6272                    sage-ID being generated)
6273
6274              %r
6275                    a random integer value (decimal)
6276
6277              %R
6278                    a random integer value (hexadecimal)
6279
6280              %s
6281                    the current second
6282
6283              %T
6284                    the current UNIX timestamp (decimal)
6285
6286              %X
6287                    the current UNIX timestamp (hexadecimal)
6288
6289              %Y
6290                    the current year (Y2K compliant)
6291
6292              %%
6293                    the '%' character
6294
6295        N\bNo\bot\bte\be:\b: Please only change this setting if you know what you are doing.  Also
6296        make sure to consult RFC2822 to produce technically _\bv_\ba_\bl_\bi_\bd strings.
6297
6298        _\b7_\b._\b4_\b._\b1_\b4_\b4  _\bn_\ba_\br_\br_\bo_\bw_\b__\bt_\br_\be_\be
6299
6300        Type: boolean
6301
6302        Default: no
6303
6304        This variable, when _\bs_\be_\bt, makes the thread tree narrower, allowing deeper
6305        threads to fit on the screen.
6306
6307        _\b7_\b._\b4_\b._\b1_\b4_\b5  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
6308
6309        Type: boolean
6310
6311        Default: no
6312
6313        Availability: NNTP
6314
6315        If _\bs_\be_\bt, Mutt-ng will prompt you for the Followup-To: header field before edit-
6316        ing the body of an outgoing news article.
6317
6318        _\b7_\b._\b4_\b._\b1_\b4_\b6  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6319
6320        Type: boolean
6321
6322        The Mutt Next Generation E-Mail Client                                      122
6323
6324        Default: no
6325
6326        Availability: NNTP
6327
6328        If _\bs_\be_\bt, Mutt-ng will prompt you for the X-Comment-To: header field before edit-
6329        ing the body of an outgoing news article.
6330
6331        _\b7_\b._\b4_\b._\b1_\b4_\b7  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br
6332
6333        Type: path
6334
6335        Default: '~/.muttng'
6336
6337        Availability: NNTP
6338
6339        This variable points to directory where Mutt-ng will cache news article head-
6340        ers. If _\bu_\bn_\bs_\be_\bt, headers will not be saved at all and will be reloaded each time
6341        when you enter a newsgroup.
6342
6343        As for the header caching in connection with IMAP and/or Maildir, this drasti-
6344        cally increases speed and lowers traffic.
6345
6346        _\b7_\b._\b4_\b._\b1_\b4_\b8  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bt_\bc_\bh_\bu_\bp
6347
6348        Type: quadoption
6349
6350        Default: ask-yes
6351
6352        Availability: NNTP
6353
6354        If this variable is _\bs_\be_\bt, Mutt-ng will mark all articles in a newsgroup as read
6355        when you leaving it.
6356
6357        _\b7_\b._\b4_\b._\b1_\b4_\b9  _\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6358
6359        Type: number
6360
6361        Default: 1000
6362
6363        Availability: NNTP
6364
6365        This variable controls how many news articles to cache per newsgroup (if
6366        caching is enabled, see _\b$_\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section 7.4.147  , page 122)) and how
6367        many news articles to show in the ``index'' menu.
6368
6369        If there're more articles than defined with _\b$_\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 7.4.149  ,
6370        page 122), all older ones will be removed/not shown in the index.
6371
6372        _\b7_\b._\b4_\b._\b1_\b5_\b0  _\bn_\bn_\bt_\bp_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo_\b__\bp_\bo_\bs_\bt_\be_\br
6373
6374        Type: quadoption
6375
6376        Default: ask-yes
6377
6378        The Mutt Next Generation E-Mail Client                                      123
6379
6380        Availability: NNTP
6381
6382        If this variable is _\bs_\be_\bt and the keyword 'poster' is present in the Followup-To:
6383        header field, a follow-up to the newsgroup is not permitted.  The message will
6384        be mailed to the submitter of the message via mail.
6385
6386        _\b7_\b._\b4_\b._\b1_\b5_\b1  _\bn_\bn_\bt_\bp_\b__\bg_\br_\bo_\bu_\bp_\b__\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
6387
6388        Type: string
6389
6390        Default: '%4C %M%N %5s  %-45.45f %d'
6391
6392        Availability: NNTP
6393
6394        This variable allows you to customize the newsgroup browser display to your
6395        personal taste.  This string is similar to ``_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  ,
6396        page 111)'', but has its own set of printf(3)-like sequences:
6397
6398             %C      current newsgroup number
6399             %d      description of newsgroup (retrieved from server)
6400             %f      newsgroup name
6401             %M      ``-'' if newsgroup not allowed for direct post (moderated for example)
6402             %N      ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
6403             %n      number of new articles in newsgroup
6404             %s      number of unread articles in newsgroup
6405             %>X     right justify the rest of the string and pad with character "X"
6406             %|X     pad to the end of the line with character "X"
6407
6408        _\b7_\b._\b4_\b._\b1_\b5_\b2  _\bn_\bn_\bt_\bp_\b__\bh_\bo_\bs_\bt
6409
6410        Type: string
6411
6412        Default: ''
6413
6414        Availability: NNTP
6415
6416        This variable specifies the name (or address) of the NNTP server to be used.
6417
6418        It defaults to the value specified via the environment variable $NNTPSERVER or
6419        contained in the file /etc/nntpserver.
6420
6421        You can also specify a username and an alternative port for each newsserver,
6422        e.g.
6423
6424        [nntp[s]://][username[:password]@]newsserver[:port]
6425
6426        N\bNo\bot\bte\be:\b: Using a password as shown and stored in a configuration file presents a
6427        security risk since the superuser of your machine may read it regardless of the
6428        file's permissions.
6429
6430        _\b7_\b._\b4_\b._\b1_\b5_\b3  _\bn_\bn_\bt_\bp_\b__\bi_\bn_\be_\bw_\bs
6431
6432        The Mutt Next Generation E-Mail Client                                      124
6433
6434        Type: path
6435
6436        Default: ''
6437
6438        Availability: NNTP
6439
6440        If _\bs_\be_\bt, specifies the program and arguments used to deliver news posted by
6441        Mutt-ng.  Otherwise, Mutt-ng posts article using current connection.  The fol-
6442        lowing printf(3)-style sequence is understood:
6443
6444             %s      newsserver name
6445
6446        Example: set inews='/usr/local/bin/inews -hS'
6447
6448        _\b7_\b._\b4_\b._\b1_\b5_\b4  _\bn_\bn_\bt_\bp_\b__\bl_\bo_\ba_\bd_\b__\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn
6449
6450        Type: boolean
6451
6452        Default: yes
6453
6454        Availability: NNTP
6455
6456        This variable controls whether or not descriptions for newsgroups are to be
6457        loaded when subscribing to a newsgroup.
6458
6459        _\b7_\b._\b4_\b._\b1_\b5_\b5  _\bn_\bn_\bt_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6460
6461        Type: number
6462
6463        Default: 60
6464
6465        Availability: NNTP
6466
6467        The time in seconds until any operations on a newsgroup except posting a new
6468        article will cause a recheck for new news. If set to 0, Mutt-ng will recheck on
6469        each operation in index (stepping, read article, etc.).
6470
6471        _\b7_\b._\b4_\b._\b1_\b5_\b6  _\bn_\bn_\bt_\bp_\b__\bm_\bi_\bm_\be_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
6472
6473        Type: boolean
6474
6475        Default: yes
6476
6477        Availability: NNTP
6478
6479        If _\bu_\bn_\bs_\be_\bt, an 8-bit ``Subject:'' header field in a news article will not be
6480        encoded according to RFC2047.
6481
6482        N\bNo\bot\bte\be:\b: Only change this setting if you know what you are doing.
6483
6484        _\b7_\b._\b4_\b._\b1_\b5_\b7  _\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc
6485
6486        The Mutt Next Generation E-Mail Client                                      125
6487
6488        Type: path
6489
6490        Default: '~/.newsrc'
6491
6492        Availability: NNTP
6493
6494        This file contains information about subscribed newsgroup and articles read so
6495        far.
6496
6497        To ease the use of multiple news servers, the following printf(3)-style
6498        sequence is understood:
6499
6500             %s      newsserver name
6501
6502        _\b7_\b._\b4_\b._\b1_\b5_\b8  _\bn_\bn_\bt_\bp_\b__\bp_\ba_\bs_\bs
6503
6504        Type: string
6505
6506        Default: ''
6507
6508        Availability: NNTP
6509
6510        Your password for NNTP account.
6511
6512        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
6513        the superuser of your machine may read it regardless of the file's permissions.
6514
6515        _\b7_\b._\b4_\b._\b1_\b5_\b9  _\bn_\bn_\bt_\bp_\b__\bp_\bo_\bs_\bt_\b__\bm_\bo_\bd_\be_\br_\ba_\bt_\be_\bd
6516
6517        Type: quadoption
6518
6519        Default: ask-yes
6520
6521        Availability: NNTP
6522
6523        If set to _\by_\be_\bs, Mutt-ng will post articles to newsgroup that have not permis-
6524        sions to post (e.g. moderated).
6525
6526        N\bNo\bot\bte\be:\b: if the newsserver does not support posting to that newsgroup or a group
6527        is totally read-only, that posting will not have any effect.
6528
6529        _\b7_\b._\b4_\b._\b1_\b6_\b0  _\bn_\bn_\bt_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
6530
6531        Type: quadoption
6532
6533        Default: ask-yes
6534
6535        Availability: NNTP
6536
6537        Controls whether or not Mutt-ng will try to reconnect to a newsserver when the
6538        was connection lost.
6539
6540        The Mutt Next Generation E-Mail Client                                      126
6541
6542        _\b7_\b._\b4_\b._\b1_\b6_\b1  _\bn_\bn_\bt_\bp_\b__\bs_\ba_\bv_\be_\b__\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
6543
6544        Type: boolean
6545
6546        Default: no
6547
6548        Availability: NNTP
6549
6550        When _\bs_\be_\bt, info about unsubscribed newsgroups will be saved into the ``newsrc''
6551        file and into the news cache.
6552
6553        _\b7_\b._\b4_\b._\b1_\b6_\b2  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bn_\be_\bw_\b__\bn_\be_\bw_\bs
6554
6555        Type: boolean
6556
6557        Default: yes
6558
6559        Availability: NNTP
6560
6561        If _\bs_\be_\bt, the newsserver will be asked for new newsgroups on entering the
6562        browser.  Otherwise, it will be done only once for a newsserver.  Also controls
6563        whether or not the number of new articles of subscribed newsgroups will be
6564        checked.
6565
6566        _\b7_\b._\b4_\b._\b1_\b6_\b3  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bo_\bn_\bl_\by_\b__\bu_\bn_\br_\be_\ba_\bd
6567
6568        Type: boolean
6569
6570        Default: no
6571
6572        Availability: NNTP
6573
6574        If _\bs_\be_\bt, only subscribed newsgroups that contain unread articles will be dis-
6575        played in the newsgroup browser.
6576
6577        _\b7_\b._\b4_\b._\b1_\b6_\b4  _\bn_\bn_\bt_\bp_\b__\bu_\bs_\be_\br
6578
6579        Type: string
6580
6581        Default: ''
6582
6583        Availability: NNTP
6584
6585        Your login name on the NNTP server.  If _\bu_\bn_\bs_\be_\bt and the server requires authen-
6586        tification, Mutt-ng will prompt you for your account name.
6587
6588        _\b7_\b._\b4_\b._\b1_\b6_\b5  _\bn_\bn_\bt_\bp_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
6589
6590        Type: boolean
6591
6592        Default: no
6593
6594        Availability: NNTP
6595
6596        The Mutt Next Generation E-Mail Client                                      127
6597
6598        If _\bs_\be_\bt, Mutt-ng will add a ``X-Comment-To:'' header field (that contains full
6599        name of the original article author) to articles that you followup to.
6600
6601        _\b7_\b._\b4_\b._\b1_\b6_\b6  _\bo_\bp_\be_\br_\ba_\bt_\bi_\bn_\bg_\b__\bs_\by_\bs_\bt_\be_\bm
6602
6603        Type: string
6604
6605        Default: ''
6606
6607        This specifies the operating system name for the User-Agent: header field. If
6608        this is _\bu_\bn_\bs_\be_\bt, it will be set to the operating system name that uname(2)
6609        returns. If uname(2) fails, ``UNIX'' will be used.
6610
6611        It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''.
6612
6613        _\b7_\b._\b4_\b._\b1_\b6_\b7  _\bp_\ba_\bg_\be_\br
6614
6615        Type: path
6616
6617        Default: 'builtin'
6618
6619        This variable specifies which pager you would like to use to view messages.
6620        ``builtin'' means to use the builtin pager, otherwise this variable should
6621        specify the pathname of the external pager you would like to use.
6622
6623        Using an external pager may have some disadvantages: Additional keystrokes are
6624        necessary because you can't call Mutt-ng functions directly from the pager, and
6625        screen resizes cause lines longer than the screen width to be badly formatted
6626        in the help menu.
6627
6628        _\b7_\b._\b4_\b._\b1_\b6_\b8  _\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
6629
6630        Type: number
6631
6632        Default: 0
6633
6634        This variable controls the number of lines of context that are given when dis-
6635        playing the next or previous page in the internal pager.  By default, Mutt-ng
6636        will display the line after the last one on the screen at the top of the next
6637        page (0 lines of context).
6638
6639        _\b7_\b._\b4_\b._\b1_\b6_\b9  _\bp_\ba_\bg_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
6640
6641        Type: string
6642
6643        Default: '-%Z- %C/%m: %-20.20n   %s'
6644
6645        This variable controls the format of the one-line message ``status'' displayed
6646        before each message in either the internal or an external pager.  The valid
6647        sequences are listed in the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111)''
6648        section.
6649
6650        _\b7_\b._\b4_\b._\b1_\b7_\b0  _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs
6651
6652        The Mutt Next Generation E-Mail Client                                      128
6653
6654        Type: number
6655
6656        Default: 0
6657
6658        Determines the number of lines of a mini-index which is shown when in the
6659        pager.  The current message, unless near the top or bottom of the folder, will
6660        be roughly one third of the way down this mini-index, giving the reader the
6661        context of a few messages before and after the message.  This is useful, for
6662        example, to determine how many messages remain to be read in the current
6663        thread.  One of the lines is reserved for the status bar from the index, so a
6664        _\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
6665        0 results in no index being shown.  If the number of messages in the current
6666        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
6667        lines as it needs.
6668
6669        _\b7_\b._\b4_\b._\b1_\b7_\b1  _\bp_\ba_\bg_\be_\br_\b__\bs_\bt_\bo_\bp
6670
6671        Type: boolean
6672
6673        Default: no
6674
6675        When _\bs_\be_\bt, the internal-pager will n\bno\bot\bt move to the next message when you are at
6676        the end of a message and invoke the _\bn_\be_\bx_\bt_\b-_\bp_\ba_\bg_\be function.
6677
6678        _\b7_\b._\b4_\b._\b1_\b7_\b2  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\b__\bd_\be_\bc_\bo_\bd_\be
6679
6680        Type: boolean
6681
6682        Default: no
6683
6684        If _\bs_\be_\bt, Mutt-ng will automatically attempt to decrypt traditional PGP messages
6685        whenever the user performs an operation which ordinarily would result in the
6686        contents of the message being operated on.  For example, if the user displays a
6687        pgp-traditional message which has not been manually checked with the check-tra-
6688        ditional-pgp function, Mutt-ng will automatically check the message for tradi-
6689        tional pgp.
6690
6691        _\b7_\b._\b4_\b._\b1_\b7_\b3  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\bi_\bn_\bl_\bi_\bn_\be
6692
6693        Type: boolean
6694
6695        Default: no
6696
6697        This option controls whether Mutt-ng generates old-style inline (traditional)
6698        PGP encrypted or signed messages under certain circumstances.  This can be
6699        overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not required.
6700
6701        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
6702        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
6703        ing PGP/MIME messages when inline (traditional) would not work.  See also:
6704        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.189  , page 132)''.
6705
6706        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.
6707        (PGP only)
6708
6709        The Mutt Next Generation E-Mail Client                                      129
6710
6711        _\b7_\b._\b4_\b._\b1_\b7_\b4  _\bp_\bg_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\be_\bx_\bi_\bt
6712
6713        Type: boolean
6714
6715        Default: yes
6716
6717        If _\bs_\be_\bt, Mutt-ng will check the exit code of the PGP subprocess when signing or
6718        encrypting.  A non-zero exit code means that the subprocess failed.  (PGP only)
6719
6720        _\b7_\b._\b4_\b._\b1_\b7_\b5  _\bp_\bg_\bp_\b__\bc_\bl_\be_\ba_\br_\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6721
6722        Type: string
6723
6724        Default: ''
6725
6726        This format is used to create a old-style ``clearsigned'' PGP message.
6727
6728        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)
6729
6730        _\b7_\b._\b4_\b._\b1_\b7_\b6  _\bp_\bg_\bp_\b__\bd_\be_\bc_\bo_\bd_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6731
6732        Type: string
6733
6734        Default: ''
6735
6736        This format strings specifies a command which is used to decode application/pgp
6737        attachments.
6738
6739        The PGP command formats have their own set of printf(3)-like sequences:
6740
6741              %p
6742                    Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
6743                    string otherwise. Note: This may be used with a %? construct.
6744
6745              %f
6746                    Expands to the name of a file containing a message.
6747
6748              %s
6749                    Expands to the name of a file containing the signature part of a
6750                    multipart/signed attachment when verifying it.
6751
6752              %a
6753                    The value of _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 7.4.193  , page 133).
6754
6755              %r
6756                    One or more key IDs.
6757
6758        For examples on how to configure these formats for the various versions of PGP
6759        which are floating around, see the pgp*.rc and gpg.rc files in the samples/
6760        subdirectory which has been installed on your system alongside the documenta-
6761        tion.  (PGP only)
6762
6763        _\b7_\b._\b4_\b._\b1_\b7_\b7  _\bp_\bg_\bp_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6764
6765        The Mutt Next Generation E-Mail Client                                      130
6766
6767        Type: string
6768
6769        Default: ''
6770
6771        This command is used to decrypt a PGP encrypted message.  (PGP only)
6772
6773        _\b7_\b._\b4_\b._\b1_\b7_\b8  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bo_\bn_\bl_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6774
6775        Type: string
6776
6777        Default: ''
6778
6779        This command is used to encrypt a body part without signing it.  (PGP only)
6780
6781        _\b7_\b._\b4_\b._\b1_\b7_\b9  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6782
6783        Type: string
6784
6785        Default: ''
6786
6787        This command is used to both sign and encrypt a body part.  (PGP only)
6788
6789        _\b7_\b._\b4_\b._\b1_\b8_\b0  _\bp_\bg_\bp_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
6790
6791        Type: string
6792
6793        Default: '%4n %t%f %4l/0x%k %-4a %2c %u'
6794
6795        This variable allows you to customize the PGP key selection menu to your per-
6796        sonal taste. This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page
6797        111)'', but has its own set of printf(3)-like sequences:
6798
6799              %n
6800                    number
6801
6802              %k
6803                    key id
6804
6805              %u
6806                    user id
6807
6808              %a
6809                    algorithm
6810
6811              %l
6812                    key length
6813
6814              %f
6815                    flags
6816
6817              %c
6818                    capabilities
6819
6820        The Mutt Next Generation E-Mail Client                                      131
6821
6822              %t
6823                    trust/validity of the key-uid association
6824
6825              %[<s>]
6826                    date of the key where <s> is an strftime(3) expression
6827
6828        (PGP only)
6829
6830        _\b7_\b._\b4_\b._\b1_\b8_\b1  _\bp_\bg_\bp_\b__\be_\bx_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6831
6832        Type: string
6833
6834        Default: ''
6835
6836        This command is used to export a public key from the user's key ring.  (PGP
6837        only)
6838
6839        _\b7_\b._\b4_\b._\b1_\b8_\b2  _\bp_\bg_\bp_\b__\bg_\be_\bt_\bk_\be_\by_\bs_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6840
6841        Type: string
6842
6843        Default: ''
6844
6845        This command is invoked whenever Mutt-ng will need public key information.  %r
6846        is the only printf(3)-like sequence used with this format.  (PGP only)
6847
6848        _\b7_\b._\b4_\b._\b1_\b8_\b3  _\bp_\bg_\bp_\b__\bg_\bo_\bo_\bd_\b__\bs_\bi_\bg_\bn
6849
6850        Type: regular expression
6851
6852        Default: ''
6853
6854        If you assign a text to this variable, then a PGP signature is only considered
6855        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.199  , page 134)
6856        contains the text. Use this variable if the exit code from the command is 0
6857        even for bad signatures.  (PGP only)
6858
6859        _\b7_\b._\b4_\b._\b1_\b8_\b4  _\bp_\bg_\bp_\b__\bi_\bg_\bn_\bo_\br_\be_\b__\bs_\bu_\bb_\bk_\be_\by_\bs
6860
6861        Type: boolean
6862
6863        Default: yes
6864
6865        Setting this variable will cause Mutt-ng to ignore OpenPGP subkeys. Instead,
6866        the principal key will inherit the subkeys' capabilities. _\bU_\bn_\bs_\be_\bt this if you
6867        want to play interesting key selection games.  (PGP only)
6868
6869        _\b7_\b._\b4_\b._\b1_\b8_\b5  _\bp_\bg_\bp_\b__\bi_\bm_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6870
6871        Type: string
6872
6873        Default: ''
6874
6875        This command is used to import a key from a message into the user's public key
6876
6877        The Mutt Next Generation E-Mail Client                                      132
6878
6879        ring.  (PGP only)
6880
6881        _\b7_\b._\b4_\b._\b1_\b8_\b6  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bp_\bu_\bb_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6882
6883        Type: string
6884
6885        Default: ''
6886
6887        This command is used to list the public key ring's contents.  The output format
6888        must be analogous to the one used by gpg --list-keys --with-colons.
6889
6890        This format is also generated by the pgpring utility which comes with Mutt-ng.
6891        (PGP only)
6892
6893        _\b7_\b._\b4_\b._\b1_\b8_\b7  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\be_\bc_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6894
6895        Type: string
6896
6897        Default: ''
6898
6899        This command is used to list the secret key ring's contents.  The output format
6900        must be analogous to the one used by gpg --list-keys --with-colons.
6901
6902        This format is also generated by the pgpring utility which comes with Mutt-ng.
6903        (PGP only)
6904
6905        _\b7_\b._\b4_\b._\b1_\b8_\b8  _\bp_\bg_\bp_\b__\bl_\bo_\bn_\bg_\b__\bi_\bd_\bs
6906
6907        Type: boolean
6908
6909        Default: no
6910
6911        If _\bs_\be_\bt, use 64 bit PGP key IDs. _\bU_\bn_\bs_\be_\bt uses the normal 32 bit Key IDs.  (PGP
6912        only)
6913
6914        _\b7_\b._\b4_\b._\b1_\b8_\b9  _\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo
6915
6916        Type: quadoption
6917
6918        Default: ask-yes
6919
6920        This option controls whether Mutt-ng will prompt you for automatically sending
6921        a (signed/encrypted) message using PGP/MIME when inline (traditional) fails
6922        (for any reason).
6923
6924        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.
6925        (PGP only)
6926
6927        _\b7_\b._\b4_\b._\b1_\b9_\b0  _\bp_\bg_\bp_\b__\br_\be_\bp_\bl_\by_\bi_\bn_\bl_\bi_\bn_\be
6928
6929        Type: boolean
6930
6931        Default: no
6932
6933        The Mutt Next Generation E-Mail Client                                      133
6934
6935        Setting this variable will cause Mutt-ng to always attempt to create an inline
6936        (traditional) message when replying to a message which is PGP encrypted/signed
6937        inline.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not
6938        required.  This option does not automatically detect if the (replied-to) mes-
6939        sage is inline; instead it relies on Mutt-ng internals for previously
6940        checked/flagged messages.
6941
6942        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
6943        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
6944        ing PGP/MIME messages when inline (traditional) would not work.  See also:
6945        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 7.4.189  , page 132)''.
6946
6947        Also note that using the old-style PGP message format is s\bst\btr\bro\bon\bng\bgl\bly\by d\bde\bep\bpr\bre\bec\bca\bat\bte\bed\bd.
6948        (PGP only)
6949
6950        _\b7_\b._\b4_\b._\b1_\b9_\b1  _\bp_\bg_\bp_\b__\br_\be_\bt_\ba_\bi_\bn_\ba_\bb_\bl_\be_\b__\bs_\bi_\bg_\bs
6951
6952        Type: boolean
6953
6954        Default: no
6955
6956        If _\bs_\be_\bt, signed and encrypted messages will consist of nested multipart/signed
6957        and multipart/encrypted body parts.
6958
6959        This is useful for applications like encrypted and signed mailing lists, where
6960        the outer layer (multipart/encrypted) can be easily removed, while the inner
6961        multipart/signed part is retained.  (PGP only)
6962
6963        _\b7_\b._\b4_\b._\b1_\b9_\b2  _\bp_\bg_\bp_\b__\bs_\bh_\bo_\bw_\b__\bu_\bn_\bu_\bs_\ba_\bb_\bl_\be
6964
6965        Type: boolean
6966
6967        Default: yes
6968
6969        If _\bs_\be_\bt, Mutt-ng will display non-usable keys on the PGP key selection menu.
6970        This includes keys which have been revoked, have expired, or have been marked
6971        as ``disabled'' by the user.  (PGP only)
6972
6973        _\b7_\b._\b4_\b._\b1_\b9_\b3  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs
6974
6975        Type: string
6976
6977        Default: ''
6978
6979        If you have more than one key pair, this option allows you to specify which of
6980        your private keys to use.  It is recommended that you use the keyid form to
6981        specify your key (e.g., ``0x00112233'').  (PGP only)
6982
6983        _\b7_\b._\b4_\b._\b1_\b9_\b4  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6984
6985        Type: string
6986
6987        Default: ''
6988
6989        The Mutt Next Generation E-Mail Client                                      134
6990
6991        This command is used to create the detached PGP signature for a multi-
6992        part/signed PGP/MIME body part.  (PGP only)
6993
6994        _\b7_\b._\b4_\b._\b1_\b9_\b5  _\bp_\bg_\bp_\b__\bs_\bo_\br_\bt_\b__\bk_\be_\by_\bs
6995
6996        Type: sort order
6997
6998        Default: address
6999
7000        Specifies how the entries in the ``pgp keys'' menu are sorted. The following
7001        are legal values:
7002
7003              address
7004                    sort alphabetically by user id
7005
7006              keyid
7007                    sort alphabetically by key id
7008
7009              date
7010                    sort by key creation date
7011
7012              trust
7013                    sort by the trust of the key
7014
7015        If you prefer reverse order of the above values, prefix it with ``reverse-''.
7016        (PGP only)
7017
7018        _\b7_\b._\b4_\b._\b1_\b9_\b6  _\bp_\bg_\bp_\b__\bs_\bt_\br_\bi_\bc_\bt_\b__\be_\bn_\bc
7019
7020        Type: boolean
7021
7022        Default: yes
7023
7024        If _\bs_\be_\bt, Mutt-ng will automatically encode PGP/MIME signed messages as quoted-
7025        printable.  Please note that unsetting this variable may lead to problems with
7026        non-verifyable PGP signatures, so only change this if you know what you are
7027        doing.  (PGP only)
7028
7029        _\b7_\b._\b4_\b._\b1_\b9_\b7  _\bp_\bg_\bp_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
7030
7031        Type: number
7032
7033        Default: 300
7034
7035        The number of seconds after which a cached passphrase will expire if not used.
7036        Default: 300.  (PGP only)
7037
7038        _\b7_\b._\b4_\b._\b1_\b9_\b8  _\bp_\bg_\bp_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\b__\ba_\bg_\be_\bn_\bt
7039
7040        Type: boolean
7041
7042        Default: no
7043
7044        If _\bs_\be_\bt, Mutt-ng will use a possibly-running gpg-agent process.  (PGP only)
7045
7046        The Mutt Next Generation E-Mail Client                                      135
7047
7048        _\b7_\b._\b4_\b._\b1_\b9_\b9  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7049
7050        Type: string
7051
7052        Default: ''
7053
7054        This command is used to verify PGP signatures.  (PGP only)
7055
7056        _\b7_\b._\b4_\b._\b2_\b0_\b0  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bk_\be_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7057
7058        Type: string
7059
7060        Default: ''
7061
7062        This command is used to verify key information from the key selection menu.
7063        (PGP only)
7064
7065        _\b7_\b._\b4_\b._\b2_\b0_\b1  _\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be
7066
7067        Type: boolean
7068
7069        Default: no
7070
7071        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
7072        pipe the messages without any preprocessing. When _\bs_\be_\bt, Mutt-ng will weed head-
7073        ers and will attempt to PGP/MIME decode the messages first.
7074
7075        _\b7_\b._\b4_\b._\b2_\b0_\b2  _\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7076
7077        Type: string
7078
7079        Default: '\n'
7080
7081        The separator to add between messages when piping a list of tagged messages to
7082        an external Unix command.
7083
7084        _\b7_\b._\b4_\b._\b2_\b0_\b3  _\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
7085
7086        Type: boolean
7087
7088        Default: no
7089
7090        Used in connection with the _\bp_\bi_\bp_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be command and the ``tag- prefix'' or
7091        ``tag-prefix-cond'' operators.  If this variable is _\bu_\bn_\bs_\be_\bt, when piping a list
7092        of tagged messages Mutt-ng will concatenate the messages and will pipe them as
7093        a single folder.  When _\bs_\be_\bt, Mutt-ng will pipe the messages one by one.  In both
7094        cases the messages are piped in the current sorted order, and the ``_\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp
7095        (section 7.4.202  , page 135)'' separator is added after each message.
7096
7097        _\b7_\b._\b4_\b._\b2_\b0_\b4  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\b__\bt_\br_\by_\b__\ba_\bl_\bl
7098
7099        Type: boolean
7100
7101        Default: yes
7102
7103        The Mutt Next Generation E-Mail Client                                      136
7104
7105        Availability: POP
7106
7107        If _\bs_\be_\bt, Mutt-ng will try all available methods. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will only
7108        fall back to other authentication methods if the previous methods are unavail-
7109        able. If a method is available but authentication fails, Mutt-ng will not con-
7110        nect to the POP server.
7111
7112        _\b7_\b._\b4_\b._\b2_\b0_\b5  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
7113
7114        Type: string
7115
7116        Default: ''
7117
7118        Availability: POP
7119
7120        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
7121        use to log in to an POP server, in the order Mutt-ng should try them.  Authen-
7122        tication methods are either ``user'', ``apop'' or any SASL mechanism, eg
7123        ``digest-md5'', ``gssapi'' or ``cram-md5''.
7124
7125        This parameter is case-insensitive. If this parameter is _\bu_\bn_\bs_\be_\bt (the default)
7126        Mutt-ng will try all available methods, in order from most-secure to least-
7127        secure.
7128
7129        Example: set pop_authenticators='digest-md5:apop:user'
7130
7131        _\b7_\b._\b4_\b._\b2_\b0_\b6  _\bp_\bo_\bp_\b__\bd_\be_\bl_\be_\bt_\be
7132
7133        Type: quadoption
7134
7135        Default: ask-no
7136
7137        Availability: POP
7138
7139        If _\bs_\be_\bt, Mutt-ng will delete successfully downloaded messages from the POP
7140        server when using the ``fetch-mail'' function.  When _\bu_\bn_\bs_\be_\bt, Mutt-ng will down-
7141        load messages but also leave them on the POP server.
7142
7143        _\b7_\b._\b4_\b._\b2_\b0_\b7  _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt
7144
7145        Type: string
7146
7147        Default: ''
7148
7149        Availability: POP
7150
7151        The name of your POP server for the ``fetch-mail'' function.  You can also
7152        specify an alternative port, username and password, i.e.:
7153
7154        [pop[s]://][username[:password]@]popserver[:port]
7155
7156        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7157        the superuser of your machine may read it regardless of the file's permissions.
7158
7159        The Mutt Next Generation E-Mail Client                                      137
7160
7161        _\b7_\b._\b4_\b._\b2_\b0_\b8  _\bp_\bo_\bp_\b__\bl_\ba_\bs_\bt
7162
7163        Type: boolean
7164
7165        Default: no
7166
7167        Availability: POP
7168
7169        If this variable is _\bs_\be_\bt, Mutt-ng will try to use the ``LAST'' POP command for
7170        retrieving only unread messages from the POP server when using the ``fetch-
7171        mail'' function.
7172
7173        _\b7_\b._\b4_\b._\b2_\b0_\b9  _\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
7174
7175        Type: number
7176
7177        Default: 60
7178
7179        Availability: POP
7180
7181        This variable configures how often (in seconds) POP should look for new mail.
7182
7183        _\b7_\b._\b4_\b._\b2_\b1_\b0  _\bp_\bo_\bp_\b__\bp_\ba_\bs_\bs
7184
7185        Type: string
7186
7187        Default: ''
7188
7189        Availability: POP
7190
7191        Specifies the password for your POP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt you
7192        for your password when you open POP mailbox.
7193
7194        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7195        the superuser of your machine may read it regardless of the file's permissions.
7196
7197        _\b7_\b._\b4_\b._\b2_\b1_\b1  _\bp_\bo_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7198
7199        Type: quadoption
7200
7201        Default: ask-yes
7202
7203        Availability: POP
7204
7205        Controls whether or not Mutt-ng will try to reconnect to a POP server when the
7206        connection is lost.
7207
7208        _\b7_\b._\b4_\b._\b2_\b1_\b2  _\bp_\bo_\bp_\b__\bu_\bs_\be_\br
7209
7210        Type: string
7211
7212        Default: ''
7213
7214        Availability: POP
7215
7216        The Mutt Next Generation E-Mail Client                                      138
7217
7218        Your login name on the POP server.
7219
7220        This variable defaults to your user name on the local machine.
7221
7222        _\b7_\b._\b4_\b._\b2_\b1_\b3  _\bp_\bo_\bs_\bt_\b__\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
7223
7224        Type: string
7225
7226        Default: ''
7227
7228        Similar to the ``_\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 7.4.15  , page 89)'' variable, Mutt-ng
7229        will append this string after the inclusion of a message which is being replied
7230        to.
7231
7232        _\b7_\b._\b4_\b._\b2_\b1_\b4  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
7233
7234        Type: quadoption
7235
7236        Default: ask-yes
7237
7238        Controls whether or not messages are saved in the ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section
7239        7.4.215  , page 138)'' mailbox when you elect not to send immediately.
7240
7241        _\b7_\b._\b4_\b._\b2_\b1_\b5  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd
7242
7243        Type: path
7244
7245        Default: '~/postponed'
7246
7247        Mutt-ng allows you to indefinitely ``_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.214  , page 138)
7248        sending a message'' which you are editing.  When you choose to postpone a mes-
7249        sage, Mutt-ng saves it in the mailbox specified by this variable.  Also see the
7250        ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 7.4.214  , page 138)'' variable.
7251
7252        _\b7_\b._\b4_\b._\b2_\b1_\b6  _\bp_\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
7253
7254        Type: string
7255
7256        Default: ''
7257
7258        If _\bs_\be_\bt, a shell command to be executed if Mutt-ng fails to establish a connec-
7259        tion to the server. This is useful for setting up secure connections, e.g. with
7260        ssh(1). If the command returns a  nonzero status, Mutt-ng gives up opening the
7261        server. Example:
7262
7263        preconnect='ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 <
7264        /dev/null > /dev/null'
7265
7266        Mailbox ``foo'' on mailhost.net can now be reached as ``{localhost:1234}foo''.
7267
7268        N\bNo\bot\bte\be:\b: For this example to work, you must be able to log in to the remote
7269        machine without having to enter a password.
7270
7271        The Mutt Next Generation E-Mail Client                                      139
7272
7273        _\b7_\b._\b4_\b._\b2_\b1_\b7  _\bp_\br_\bi_\bn_\bt
7274
7275        Type: quadoption
7276
7277        Default: ask-no
7278
7279        Controls whether or not Mutt-ng really prints messages.  This is set to _\ba_\bs_\bk_\b-_\bn_\bo
7280        by default, because some people accidentally hit ``p'' often.
7281
7282        _\b7_\b._\b4_\b._\b2_\b1_\b8  _\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7283
7284        Type: path
7285
7286        Default: 'lpr'
7287
7288        This specifies the command pipe that should be used to print messages.
7289
7290        _\b7_\b._\b4_\b._\b2_\b1_\b9  _\bp_\br_\bi_\bn_\bt_\b__\bd_\be_\bc_\bo_\bd_\be
7291
7292        Type: boolean
7293
7294        Default: yes
7295
7296        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7297        message is decoded before it is passed to the external command specified by
7298        _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.218  , page 139).  If this option is _\bu_\bn_\bs_\be_\bt, no pro-
7299        cessing will be applied to the message when printing it.  The latter setting
7300        may be useful if you are using some advanced printer filter which is able to
7301        properly format e-mail messages for printing.
7302
7303        _\b7_\b._\b4_\b._\b2_\b2_\b0  _\bp_\br_\bi_\bn_\bt_\b__\bs_\bp_\bl_\bi_\bt
7304
7305        Type: boolean
7306
7307        Default: no
7308
7309        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
7310        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.218  , page 139) is executed
7311        once for each message which is to be printed.  If this option is _\bu_\bn_\bs_\be_\bt, the
7312        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 7.4.218  , page 139) is executed
7313        only once, and all the messages are concatenated, with a form feed as the mes-
7314        sage separator.
7315
7316        Those who use the enscript(1) program's mail-printing mode will most likely
7317        want to set this option.
7318
7319        _\b7_\b._\b4_\b._\b2_\b2_\b1  _\bp_\br_\bo_\bm_\bp_\bt_\b__\ba_\bf_\bt_\be_\br
7320
7321        Type: boolean
7322
7323        Default: yes
7324
7325        If you use an _\be_\bx_\bt_\be_\br_\bn_\ba_\bl ``_\b$_\bp_\ba_\bg_\be_\br (section 7.4.167  , page 127)'', setting this
7326        variable will cause Mutt-ng to prompt you for a command when the pager exits
7327
7328        The Mutt Next Generation E-Mail Client                                      140
7329
7330        rather than returning to the index menu.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will return to the
7331        index menu when the external pager exits.
7332
7333        _\b7_\b._\b4_\b._\b2_\b2_\b2  _\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7334
7335        Type: path
7336
7337        Default: ''
7338
7339        This specifies the command that Mutt-ng will use to make external address
7340        queries.  The string should contain a %s, which will be substituted with the
7341        query string the user types.  See ``_\bq_\bu_\be_\br_\by (section 4.7  , page 55)'' for more
7342        information.
7343
7344        _\b7_\b._\b4_\b._\b2_\b2_\b3  _\bq_\bu_\bi_\bt
7345
7346        Type: quadoption
7347
7348        Default: yes
7349
7350        This variable controls whether ``quit'' and ``exit'' actually quit from Mutt-
7351        ng.  If it set to _\by_\be_\bs, they do quit, if it is set to _\bn_\bo, they have no effect,
7352        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
7353        you try to quit.
7354
7355        _\b7_\b._\b4_\b._\b2_\b2_\b4  _\bq_\bu_\bo_\bt_\be_\b__\be_\bm_\bp_\bt_\by
7356
7357        Type: boolean
7358
7359        Default: yes
7360
7361        Controls whether or not empty lines will be quoted using ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (sec-
7362        tion 7.4.109  , page 111)''.
7363
7364        _\b7_\b._\b4_\b._\b2_\b2_\b5  _\bq_\bu_\bo_\bt_\be_\b__\bq_\bu_\bo_\bt_\be_\bd
7365
7366        Type: boolean
7367
7368        Default: no
7369
7370        Controls how quoted lines will be quoted. If _\bs_\be_\bt, one quote character will be
7371        added to the end of existing prefix.  Otherwise, quoted lines will be prepended
7372        by ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.109  , page 111)''.
7373
7374        _\b7_\b._\b4_\b._\b2_\b2_\b6  _\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp
7375
7376        Type: regular expression
7377
7378        Default: '^([ \t]*[|>:}#])+'
7379
7380        A regular expression used in the internal-pager to determine quoted sections of
7381        text in the body of a message.
7382
7383        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
7384
7385        The Mutt Next Generation E-Mail Client                                      141
7386
7387        set this to a regular expression that matches _\be_\bx_\ba_\bc_\bt_\bl_\by the quote characters at
7388        the beginning of quoted lines.
7389
7390        _\b7_\b._\b4_\b._\b2_\b2_\b7  _\br_\be_\ba_\bd_\b__\bi_\bn_\bc
7391
7392        Type: number
7393
7394        Default: 10
7395
7396        If set to a value greater than 0, Mutt-ng will display which message it is cur-
7397        rently on when reading a mailbox.  The message is printed after _\br_\be_\ba_\bd_\b__\bi_\bn_\bc mes-
7398        sages have been read (e.g., if set to 25, Mutt-ng will print a message when it
7399        reads message 25, and then again when it gets to message 50).  This variable is
7400        meant to indicate progress when reading large mailboxes which may take some
7401        time.  When set to 0, only a single message will appear before the reading the
7402        mailbox.
7403
7404        Also see the ``_\b$_\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc (section 7.4.340  , page 168)'' variable.
7405
7406        _\b7_\b._\b4_\b._\b2_\b2_\b8  _\br_\be_\ba_\bd_\b__\bo_\bn_\bl_\by
7407
7408        Type: boolean
7409
7410        Default: no
7411
7412        If set, all folders are opened in read-only mode.
7413
7414        _\b7_\b._\b4_\b._\b2_\b2_\b9  _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7415
7416        Type: string
7417
7418        Default: ''
7419
7420        This variable specifies what ``real'' or ``personal'' name should be used when
7421        sending messages.
7422
7423        By default, this is the GECOS field from /etc/passwd.
7424
7425        _\bN_\bo_\bt_\be_\b: This variable will _\bn_\bo_\bt be used when the user has set a real name in the
7426        _\b$_\bf_\br_\bo_\bm (section 7.4.74  , page 103) variable.
7427
7428        _\b7_\b._\b4_\b._\b2_\b3_\b0  _\br_\be_\bc_\ba_\bl_\bl
7429
7430        Type: quadoption
7431
7432        Default: ask-yes
7433
7434        Controls whether or not Mutt-ng recalls postponed messages when composing a new
7435        message.  Also see ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 7.4.215  , page 138)''.
7436
7437        Setting this variable to _\by_\be_\bs is not generally useful, and thus not recommended.
7438
7439        _\b7_\b._\b4_\b._\b2_\b3_\b1  _\br_\be_\bc_\bo_\br_\bd
7440
7441        The Mutt Next Generation E-Mail Client                                      142
7442
7443        Type: path
7444
7445        Default: ''
7446
7447        This specifies the file into which your outgoing messages should be appended.
7448        (This is meant as the primary method for saving a copy of your messages, but
7449        another way to do this is using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 34)'' com-
7450        mand to create a Bcc: header field with your email address in it.)
7451
7452        The value of _\b$_\br_\be_\bc_\bo_\br_\bd _\b(_\bs_\be_\bc_\bt_\bi_\bo_\bn _\b7_\b._\b4_\b._\b2_\b3_\b1  _\b, _\bp_\ba_\bg_\be _\b1_\b4_\b1_\b) is overridden by the
7453        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.68  , page 102)'' and ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section
7454        7.4.242  , page 144)'' variables, and the ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.18  , page
7455        35)'' command.
7456
7457        _\b7_\b._\b4_\b._\b2_\b3_\b2  _\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp
7458
7459        Type: regular expression
7460
7461        Default: '^(re([\[0-9\]+])*|aw):[ \t]*'
7462
7463        A regular expression used to recognize reply messages when threading and reply-
7464        ing. The default value corresponds to the English ``Re:'' and the German
7465        ``Aw:''.
7466
7467        _\b7_\b._\b4_\b._\b2_\b3_\b3  _\br_\be_\bp_\bl_\by_\b__\bs_\be_\bl_\bf
7468
7469        Type: boolean
7470
7471        Default: no
7472
7473        If _\bu_\bn_\bs_\be_\bt and you are replying to a message sent by you, Mutt-ng will assume
7474        that you want to reply to the recipients of that message rather than to your-
7475        self.
7476
7477        _\b7_\b._\b4_\b._\b2_\b3_\b4  _\br_\be_\bp_\bl_\by_\b__\bt_\bo
7478
7479        Type: quadoption
7480
7481        Default: ask-yes
7482
7483        If _\bs_\be_\bt, when replying to a message, Mutt-ng will use the address listed in the
7484        ``Reply-To:'' header field as the recipient of the reply.  If _\bu_\bn_\bs_\be_\bt, it will
7485        use the address in the ``From:'' header field instead.
7486
7487        This option is useful for reading a mailing list that sets the ``Reply-To:''
7488        header field to the list address and you want to send a private message to the
7489        author of a message.
7490
7491        _\b7_\b._\b4_\b._\b2_\b3_\b5  _\br_\be_\bs_\bo_\bl_\bv_\be
7492
7493        Type: boolean
7494
7495        Default: yes
7496
7497        The Mutt Next Generation E-Mail Client                                      143
7498
7499        When set, the cursor will be automatically advanced to the next (possibly
7500        undeleted) message whenever a command that modifies the current message is exe-
7501        cuted.
7502
7503        _\b7_\b._\b4_\b._\b2_\b3_\b6  _\br_\be_\bv_\be_\br_\bs_\be_\b__\ba_\bl_\bi_\ba_\bs
7504
7505        Type: boolean
7506
7507        Default: no
7508
7509        This variable controls whether or not Mutt-ng will display the ``personal''
7510        name from your aliases in the index menu if it finds an alias that matches the
7511        message's sender.  For example, if you have the following alias:
7512
7513        alias juser abd30425@somewhere.net (Joe User)
7514
7515        and then you receive mail which contains the following header:
7516
7517        From: abd30425@somewhere.net
7518
7519        It would be displayed in the index menu as ``Joe User'' instead of
7520        ``abd30425@somewhere.net.''  This is useful when the person's e-mail address is
7521        not human friendly (like CompuServe addresses).
7522
7523        _\b7_\b._\b4_\b._\b2_\b3_\b7  _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be
7524
7525        Type: boolean
7526
7527        Default: no
7528
7529        It may sometimes arrive that you receive mail to a certain machine, move the
7530        messages to another machine, and reply to some the messages from there.  If
7531        this variable is _\bs_\be_\bt, the default From: line of the reply messages is built
7532        using the address where you received the messages you are replying to i\bif\bf that
7533        address matches your alternates.  If the variable is _\bu_\bn_\bs_\be_\bt, or the address that
7534        would be used doesn't match your alternates, the From: line will use your
7535        address on the current machine.
7536
7537        _\b7_\b._\b4_\b._\b2_\b3_\b8  _\br_\be_\bv_\be_\br_\bs_\be_\b__\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7538
7539        Type: boolean
7540
7541        Default: yes
7542
7543        This variable fine-tunes the behaviour of the _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 7.4.237  ,
7544        page 143) feature.  When it is _\bs_\be_\bt, Mutt-ng will use the address from incoming
7545        messages as-is, possibly including eventual real names.  When it is _\bu_\bn_\bs_\be_\bt,
7546        Mutt-ng will override any such real names with the setting of the _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
7547        (section 7.4.229  , page 141) variable.
7548
7549        _\b7_\b._\b4_\b._\b2_\b3_\b9  _\br_\bf_\bc_\b2_\b0_\b4_\b7_\b__\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br_\bs
7550
7551        Type: boolean
7552
7553        The Mutt Next Generation E-Mail Client                                      144
7554
7555        Default: no
7556
7557        When this variable is _\bs_\be_\bt, Mutt-ng will decode RFC-2047-encoded MIME parame-
7558        ters. You want to set this variable when Mutt-ng suggests you to save attach-
7559        ments to files named like this:
7560
7561        =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
7562
7563        When this variable is _\bs_\be_\bt interactively, the change doesn't have the desired
7564        effect before you have changed folders.
7565
7566        Note that this use of RFC 2047's encoding is explicitly, prohibited by the
7567        standard, but nevertheless encountered in the wild.
7568
7569        Also note that setting this parameter will _\bn_\bo_\bt have the effect that Mutt-ng
7570        _\bg_\be_\bn_\be_\br_\ba_\bt_\be_\bs this kind of encoding.  Instead, Mutt-ng will unconditionally use the
7571        encoding specified in RFC 2231.
7572
7573        _\b7_\b._\b4_\b._\b2_\b4_\b0  _\bs_\ba_\bv_\be_\b__\ba_\bd_\bd_\br_\be_\bs_\bs
7574
7575        Type: boolean
7576
7577        Default: no
7578
7579        If _\bs_\be_\bt, Mutt-ng will take the sender's full address when choosing a default
7580        folder for saving a mail. If ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 7.4.242  , page 144)'' or
7581        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.68  , page 102)'' is _\bs_\be_\bt too, the selection of the
7582        fcc folder will be changed as well.
7583
7584        _\b7_\b._\b4_\b._\b2_\b4_\b1  _\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by
7585
7586        Type: boolean
7587
7588        Default: yes
7589
7590        When _\bu_\bn_\bs_\be_\bt, mailboxes which contain no saved messages will be removed when
7591        closed (the exception is ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 7.4.297  , page 157)'' which is
7592        never removed).  If _\bs_\be_\bt, mailboxes are never removed.
7593
7594        N\bNo\bot\bte\be:\b: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH
7595        and Maildir directories.
7596
7597        _\b7_\b._\b4_\b._\b2_\b4_\b2  _\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be
7598
7599        Type: boolean
7600
7601        Default: no
7602
7603        This variable controls how copies of outgoing messages are saved.  When set, a
7604        check is made to see if a mailbox specified by the recipient address exists
7605        (this is done by searching for a mailbox in the ``_\b$_\bf_\bo_\bl_\bd_\be_\br (section 7.4.64  ,
7606        page 100)'' directory with the _\bu_\bs_\be_\br_\bn_\ba_\bm_\be part of the recipient address).  If the
7607        mailbox exists, the outgoing message will be saved to that mailbox, otherwise
7608        the message is saved to the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 7.4.231  , page 141)'' mailbox.
7609
7610        The Mutt Next Generation E-Mail Client                                      145
7611
7612        Also see the ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 7.4.68  , page 102)'' variable.
7613
7614        _\b7_\b._\b4_\b._\b2_\b4_\b3  _\bs_\bc_\bo_\br_\be
7615
7616        Type: boolean
7617
7618        Default: yes
7619
7620        When this variable is _\bu_\bn_\bs_\be_\bt, scoring is turned off.  This can be useful to
7621        selectively disable scoring for certain folders when the ``_\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\b-
7622        _\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be (section 7.4.244  , page 145)'' variable and friends are used.
7623
7624        _\b7_\b._\b4_\b._\b2_\b4_\b4  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
7625
7626        Type: number
7627
7628        Default: -1
7629
7630        Messages which have been assigned a score equal to or lower than the value of
7631        this variable are automatically marked for deletion by Mutt-ng.  Since Mutt-ng
7632        scores are always greater than or equal to zero, the default setting of this
7633        variable will never mark a message for deletion.
7634
7635        _\b7_\b._\b4_\b._\b2_\b4_\b5  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bf_\bl_\ba_\bg
7636
7637        Type: number
7638
7639        Default: 9999
7640
7641        Messages which have been assigned a score greater than or equal to this vari-
7642        able's value are automatically marked ``flagged''.
7643
7644        _\b7_\b._\b4_\b._\b2_\b4_\b6  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd
7645
7646        Type: number
7647
7648        Default: -1
7649
7650        Messages which have been assigned a score equal to or lower than the value of
7651        this variable are automatically marked as read by Mutt-ng.  Since Mutt-ng
7652        scores are always greater than or equal to zero, the default setting of this
7653        variable will never mark a message read.
7654
7655        _\b7_\b._\b4_\b._\b2_\b4_\b7  _\bs_\be_\bn_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
7656
7657        Type: string
7658
7659        Default: 'us-ascii:iso-8859-1:utf-8'
7660
7661        A list of character sets for outgoing messages. Mutt-ng will use the first
7662        character set into which the text can be converted exactly.  If your ``_\b$_\bc_\bh_\ba_\br_\bs_\be_\bt
7663        (section 7.4.24  , page 91)'' is not iso-8859-1 and recipients may not under-
7664        stand UTF-8, it is advisable to include in the list an appropriate widely used
7665        standard character set (such as iso-8859-2, koi8-r or iso-2022-jp) either
7666
7667        The Mutt Next Generation E-Mail Client                                      146
7668
7669        instead of or after iso-8859-1.
7670
7671        _\b7_\b._\b4_\b._\b2_\b4_\b8  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl
7672
7673        Type: path
7674
7675        Default: '/usr/sbin/sendmail -oem -oi'
7676
7677        Specifies the program and arguments used to deliver mail sent by Mutt-ng.
7678        Mutt-ng expects that the specified program interprets additional arguments as
7679        recipient addresses.
7680
7681        _\b7_\b._\b4_\b._\b2_\b4_\b9  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl_\b__\bw_\ba_\bi_\bt
7682
7683        Type: number
7684
7685        Default: 0
7686
7687        Specifies the number of seconds to wait for the ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.248  ,
7688        page 145)'' process to finish before giving up and putting delivery in the
7689        background.
7690
7691        Mutt-ng interprets the value of this variable as follows:
7692
7693              >0
7694                    number of seconds to wait for sendmail to finish before continuing
7695
7696              0
7697                    wait forever for sendmail to finish
7698
7699              <0
7700                    always put sendmail in the background without waiting
7701
7702        Note that if you specify a value other than 0, the output of the child process
7703        will be put in a temporary file.  If there is some error, you will be informed
7704        as to where to find the output.
7705
7706        _\b7_\b._\b4_\b._\b2_\b5_\b0  _\bs_\bh_\be_\bl_\bl
7707
7708        Type: path
7709
7710        Default: ''
7711
7712        Command to use when spawning a subshell.  By default, the user's login shell
7713        from /etc/passwd is used.
7714
7715        _\b7_\b._\b4_\b._\b2_\b5_\b1  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by
7716
7717        Type: string
7718
7719        Default: '.'
7720
7721        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
7722        7.4.255  , page 147) is _\bs_\be_\bt, this variable specifies the characters at which to
7723
7724        The Mutt Next Generation E-Mail Client                                      147
7725
7726        split a folder name into ``hierarchy items.''
7727
7728        _\b7_\b._\b4_\b._\b2_\b5_\b2  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bd_\be_\bl_\bi_\bm
7729
7730        Type: string
7731
7732        Default: '|'
7733
7734        This specifies the delimiter between the sidebar (if visible) and other
7735        screens.
7736
7737        _\b7_\b._\b4_\b._\b2_\b5_\b3  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\be_\bw_\bm_\ba_\bi_\bl_\b__\bo_\bn_\bl_\by
7738
7739        Type: boolean
7740
7741        Default: no
7742
7743        If _\bs_\be_\bt, only folders with new mail will be shown in the sidebar.
7744
7745        _\b7_\b._\b4_\b._\b2_\b5_\b4  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\bu_\bm_\bb_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
7746
7747        Type: string
7748
7749        Default: '%m%?n?(%n)?%?f?[%f]?'
7750
7751        This variable controls how message counts are printed when the sidebar is
7752        enabled. If this variable is _\be_\bm_\bp_\bt_\by (_\ba_\bn_\bd _\bo_\bn_\bl_\by _\bi_\bf), no numbers will be printed
7753        _\ba_\bn_\bd mutt-ng won't frequently count mail (which may be a great speedup esp. with
7754        mbox-style mailboxes.)
7755
7756        The following printf(3)-like sequences are supported all of which may be
7757        printed non-zero:
7758
7759              %d
7760                    Number of deleted messages. 1)
7761
7762              %F
7763                    Number of flagged messages.
7764
7765              %m
7766                    Total number of messages.
7767
7768              %M
7769                    Total number of messages shown, i.e. not hidden by a limit. 1)
7770
7771              %n
7772                    Number of new messages.
7773
7774              %t
7775                    Number of tagged messages. 1)
7776
7777        1) These expandos only have a non-zero value for the current mailbox and will
7778        always be zero otherwise.
7779
7780        The Mutt Next Generation E-Mail Client                                      148
7781
7782        _\b7_\b._\b4_\b._\b2_\b5_\b5  _\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
7783
7784        Type: boolean
7785
7786        Default: no
7787
7788        When _\bs_\be_\bt, the ``hierarchy'' of the sidebar entries will be shortened only if
7789        they cannot be printed in full length (because ``_\b$_\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh (section
7790        7.4.257  , page 148)'' is set to a too low value). For example, if the news-
7791        group name ``de.alt.sysadmin.recovery'' doesn't fit on the screen, it'll get
7792        shortened ``d.a.s.recovery'' while ``de.alt.d0'' still would and thus will not
7793        get shortened.
7794
7795        At which characters this compression is done is controled via the _\b$_\bs_\bi_\bd_\be_\b-
7796        _\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by (section 7.4.251  , page 146) variable.
7797
7798        _\b7_\b._\b4_\b._\b2_\b5_\b6  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bv_\bi_\bs_\bi_\bb_\bl_\be
7799
7800        Type: boolean
7801
7802        Default: no
7803
7804        This specifies whether or not to show the sidebar (a list of folders specified
7805        with the ``mailboxes'' command).
7806
7807        _\b7_\b._\b4_\b._\b2_\b5_\b7  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh
7808
7809        Type: number
7810
7811        Default: 0
7812
7813        The width of the sidebar.
7814
7815        _\b7_\b._\b4_\b._\b2_\b5_\b8  _\bs_\bi_\bg_\b__\bd_\ba_\bs_\bh_\be_\bs
7816
7817        Type: boolean
7818
7819        Default: yes
7820
7821        If set, a line containing ``-- '' (dash, dash, space) will be inserted before
7822        your ``_\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 7.4.260  , page 148)''.  It is s\bst\btr\bro\bon\bng\bgl\bly\by recommended
7823        that you not unset this variable unless your ``signature'' contains just your
7824        name. The reason for this is because many software packages use ``-- \n'' to
7825        detect your signature.
7826
7827        For example, Mutt-ng has the ability to highlight the signature in a different
7828        color in the builtin pager.
7829
7830        _\b7_\b._\b4_\b._\b2_\b5_\b9  _\bs_\bi_\bg_\b__\bo_\bn_\b__\bt_\bo_\bp
7831
7832        Type: boolean
7833
7834        Default: no
7835
7836        The Mutt Next Generation E-Mail Client                                      149
7837
7838        If _\bs_\be_\bt, the signature will be included before any quoted or forwarded text.  It
7839        is s\bst\btr\bro\bon\bng\bgl\bly\by recommended that you do not set this variable unless you really
7840        know what you are doing, and are prepared to take some heat from netiquette
7841        guardians.
7842
7843        _\b7_\b._\b4_\b._\b2_\b6_\b0  _\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be
7844
7845        Type: path
7846
7847        Default: '~/.signature'
7848
7849        Specifies the filename of your signature, which is appended to all outgoing
7850        messages.   If the filename ends with a pipe (``|''), it is assumed that file-
7851        name is a shell command and input should be read from its stdout.
7852
7853        _\b7_\b._\b4_\b._\b2_\b6_\b1  _\bs_\bi_\bm_\bp_\bl_\be_\b__\bs_\be_\ba_\br_\bc_\bh
7854
7855        Type: string
7856
7857        Default: '~f %s | ~s %s'
7858
7859        Specifies how Mutt-ng should expand a simple search into a real search pattern.
7860        A simple search is one that does not contain any of the ~ operators.  See
7861        ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 7.2  , page 80)'' for more information on search patterns.
7862
7863        For example, if you simply type ``joe'' at a search or limit prompt, Mutt-ng
7864        will automatically expand it to the value specified by this variable.  For the
7865        default value it would be:
7866
7867        ~f joe | ~s joe
7868
7869        _\b7_\b._\b4_\b._\b2_\b6_\b2  _\bs_\bl_\be_\be_\bp_\b__\bt_\bi_\bm_\be
7870
7871        Type: number
7872
7873        Default: 1
7874
7875        Specifies time, in seconds, to pause while displaying certain informational
7876        messages, while moving from folder to folder and after expunging messages from
7877        the current folder.  The default is to pause one second, so a value of zero for
7878        this option suppresses the pause.
7879
7880        _\b7_\b._\b4_\b._\b2_\b6_\b3  _\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp
7881
7882        Type: boolean
7883
7884        Default: yes
7885
7886        Controls the display of lines longer than the screen width in the internal
7887        pager. If _\bs_\be_\bt, long lines are wrapped at a word boundary.  If _\bu_\bn_\bs_\be_\bt, lines are
7888        simply wrapped at the screen edge. Also see the ``_\b$_\bm_\ba_\br_\bk_\be_\br_\bs (section 7.4.121  ,
7889        page 116)'' variable.
7890
7891        The Mutt Next Generation E-Mail Client                                      150
7892
7893        _\b7_\b._\b4_\b._\b2_\b6_\b4  _\bs_\bm_\bi_\bl_\be_\by_\bs
7894
7895        Type: regular expression
7896
7897        Default: '(>From )|(:[-^]?[][)(><}{|/DP])'
7898
7899        The _\bp_\ba_\bg_\be_\br uses this variable to catch some common false positives of
7900        ``_\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.226  , page 140)'', most notably smileys in the
7901        beginning of a line
7902
7903        _\b7_\b._\b4_\b._\b2_\b6_\b5  _\bs_\bm_\bi_\bm_\be_\b__\ba_\bs_\bk_\b__\bc_\be_\br_\bt_\b__\bl_\ba_\bb_\be_\bl
7904
7905        Type: boolean
7906
7907        Default: yes
7908
7909        This flag controls whether you want to be asked to enter a label for a certifi-
7910        cate about to be added to the database or not. It is _\bs_\be_\bt by default.  (S/MIME
7911        only)
7912
7913        _\b7_\b._\b4_\b._\b2_\b6_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn
7914
7915        Type: path
7916
7917        Default: ''
7918
7919        This variable contains the name of either a directory, or a file which contains
7920        trusted certificates for use with OpenSSL.  (S/MIME only)
7921
7922        _\b7_\b._\b4_\b._\b2_\b6_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs
7923
7924        Type: path
7925
7926        Default: ''
7927
7928        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage
7929        and retrieval of keys by itself. This is very basic right now, and keys and
7930        certificates are stored in two different directories, both named as the hash-
7931        value retrieved from OpenSSL. There is an index file which contains mailbox-
7932        address keyid pairs, and which can be manually edited. This one points to the
7933        location of the certificates.  (S/MIME only)
7934
7935        _\b7_\b._\b4_\b._\b2_\b6_\b8  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7936
7937        Type: string
7938
7939        Default: ''
7940
7941        This format string specifies a command which is used to decrypt application/x-
7942        pkcs7-mime attachments.
7943
7944        The OpenSSL command formats have their own set of printf(3)-like sequences sim-
7945        ilar to PGP's:
7946
7947        The Mutt Next Generation E-Mail Client                                      151
7948
7949              %f
7950                    Expands to the name of a file containing a message.
7951
7952              %s
7953                    Expands to the name of a file containing the signature part of a
7954                    multipart/signed attachment when verifying it.
7955
7956              %k
7957                    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.270  ,
7958                    page 151)
7959
7960              %c
7961                    One or more certificate IDs.
7962
7963              %a
7964                    The algorithm used for encryption.
7965
7966              %C
7967                    CA location:  Depending on whether _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section
7968                    7.4.266  , page 150) points to a directory or file, this expands to
7969                    '-CApath _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.266  , page 150)' or
7970                    '-CAfile _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 7.4.266  , page 150)'.
7971
7972        For examples on how to configure these formats, see the smime.rc in the sam-
7973        ples/ subdirectory which has been installed on your system alongside the docu-
7974        mentation.  (S/MIME only)
7975
7976        _\b7_\b._\b4_\b._\b2_\b6_\b9  _\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
7977
7978        Type: boolean
7979
7980        Default: yes
7981
7982        If _\bs_\be_\bt (default) this tells Mutt-ng to use the default key for decryption. Oth-
7983        erwise, if manage multiple certificate-key-pairs, Mutt-ng will try to use the
7984        mailbox-address to determine the key to use. It will ask you to supply a key,
7985        if it can't find one.  (S/MIME only)
7986
7987        _\b7_\b._\b4_\b._\b2_\b7_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by
7988
7989        Type: string
7990
7991        Default: ''
7992
7993        This is the default key-pair to use for signing. This must be set to the keyid
7994        (the hash-value that OpenSSL generates) to work properly (S/MIME only)
7995
7996        _\b7_\b._\b4_\b._\b2_\b7_\b1  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7997
7998        Type: string
7999
8000        Default: ''
8001
8002        This command is used to create encrypted S/MIME messages.  (S/MIME only)
8003
8004        The Mutt Next Generation E-Mail Client                                      152
8005
8006        _\b7_\b._\b4_\b._\b2_\b7_\b2  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bw_\bi_\bt_\bh
8007
8008        Type: string
8009
8010        Default: ''
8011
8012        This sets the algorithm that should be used for encryption.  Valid choices are
8013        ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``\frc2-128''.
8014
8015        If _\bu_\bn_\bs_\be_\bt ``_\b3_\bd_\be_\bs'' (TripleDES) is used.  (S/MIME only)
8016
8017        _\b7_\b._\b4_\b._\b2_\b7_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bg_\be_\bt_\b__\bc_\be_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8018
8019        Type: string
8020
8021        Default: ''
8022
8023        This command is used to extract X509 certificates from a PKCS7 structure.
8024        (S/MIME only)
8025
8026        _\b7_\b._\b4_\b._\b2_\b7_\b4  _\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
8027
8028        Type: string
8029
8030        Default: ''
8031
8032        This command is used to extract the mail address(es) used for storing X509 cer-
8033        tificates, and for verification purposes (to check whether the certificate was
8034        issued for the sender's mailbox).  (S/MIME only)
8035
8036        _\b7_\b._\b4_\b._\b2_\b7_\b5  _\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
8037
8038        Type: string
8039
8040        Default: ''
8041
8042        This command is used to extract only the signers X509 certificate from a S/MIME
8043        signature, so that the certificate's owner may get compared to the email's
8044        ``From:'' header field.  (S/MIME only)
8045
8046        _\b7_\b._\b4_\b._\b2_\b7_\b6  _\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
8047
8048        Type: string
8049
8050        Default: ''
8051
8052        This command is used to import a certificate via smime_keysng.  (S/MIME only)
8053
8054        _\b7_\b._\b4_\b._\b2_\b7_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt
8055
8056        Type: boolean
8057
8058        Default: no
8059
8060        The Mutt Next Generation E-Mail Client                                      153
8061
8062        The default behaviour of Mutt-ng is to use PGP on all auto-sign/encryption
8063        operations. To override and to use OpenSSL instead this must be _\bs_\be_\bt.
8064
8065        However, this has no effect while replying, since Mutt-ng will automatically
8066        select the same application that was used to sign/encrypt the original message.
8067
8068        (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-
8069        tion 7.4.37  , page 94).)  (S/MIME only)
8070
8071        _\b7_\b._\b4_\b._\b2_\b7_\b8  _\bs_\bm_\bi_\bm_\be_\b__\bk_\be_\by_\bs
8072
8073        Type: path
8074
8075        Default: ''
8076
8077        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage ad
8078        retrieval of keys/certs by itself. This is very basic right now, and stores
8079        keys and certificates in two different directories, both named as the hash-
8080        value retrieved from OpenSSL. There is an index file which contains mailbox-
8081        address keyid pair, and which can be manually edited. This one points to the
8082        location of the private keys.  (S/MIME only)
8083
8084        _\b7_\b._\b4_\b._\b2_\b7_\b9  _\bs_\bm_\bi_\bm_\be_\b__\bp_\bk_\b7_\bo_\bu_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8085
8086        Type: string
8087
8088        Default: ''
8089
8090        This command is used to extract PKCS7 structures of S/MIME signatures, in order
8091        to extract the public X509 certificate(s).  (S/MIME only)
8092
8093        _\b7_\b._\b4_\b._\b2_\b8_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8094
8095        Type: string
8096
8097        Default: ''
8098
8099        This command is used to created S/MIME signatures of type multipart/signed,
8100        which can be read by all mail clients.  (S/MIME only)
8101
8102        _\b7_\b._\b4_\b._\b2_\b8_\b1  _\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
8103
8104        Type: string
8105
8106        Default: ''
8107
8108        This command is used to created S/MIME signatures of type application/x-
8109        pkcs7-signature, which can only be handled by mail clients supporting the
8110        S/MIME extension.  (S/MIME only)
8111
8112        _\b7_\b._\b4_\b._\b2_\b8_\b2  _\bs_\bm_\bi_\bm_\be_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
8113
8114        Type: number
8115
8116        The Mutt Next Generation E-Mail Client                                      154
8117
8118        Default: 300
8119
8120        The number of seconds after which a cached passphrase will expire if not used.
8121        (S/MIME only)
8122
8123        _\b7_\b._\b4_\b._\b2_\b8_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
8124
8125        Type: string
8126
8127        Default: ''
8128
8129        This command is used to verify S/MIME signatures of type multipart/signed.
8130        (S/MIME only)
8131
8132        _\b7_\b._\b4_\b._\b2_\b8_\b4  _\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
8133
8134        Type: string
8135
8136        Default: ''
8137
8138        This command is used to verify S/MIME signatures of type application/x-
8139        pkcs7-mime.  (S/MIME only)
8140
8141        _\b7_\b._\b4_\b._\b2_\b8_\b5  _\bs_\bm_\bt_\bp_\b__\be_\bn_\bv_\be_\bl_\bo_\bp_\be
8142
8143        Type: string
8144
8145        Default: ''
8146
8147        Availability: SMTP
8148
8149        If this variable is non-empty, it'll be used as the envelope sender. If it's
8150        empty (the default), the value of the regular From: header will be used.
8151
8152        This may be necessary as some providers don't allow for arbitrary values as the
8153        envelope sender but only a particular one which may not be the same as the
8154        user's desired From: header.
8155
8156        _\b7_\b._\b4_\b._\b2_\b8_\b6  _\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt
8157
8158        Type: string
8159
8160        Default: ''
8161
8162        Availability: SMTP
8163
8164        Defines the SMTP host which will be used to deliver mail, as opposed to invok-
8165        ing the sendmail binary.  Setting this variable overrides the value of ``_\b$_\bs_\be_\bn_\bd_\b-
8166        _\bm_\ba_\bi_\bl (section 7.4.248  , page 145)'', and any associated variables.
8167
8168        _\b7_\b._\b4_\b._\b2_\b8_\b7  _\bs_\bm_\bt_\bp_\b__\bp_\ba_\bs_\bs
8169
8170        Type: string
8171
8172        The Mutt Next Generation E-Mail Client                                      155
8173
8174        Default: ''
8175
8176        Availability: SMTP
8177
8178        Defines the password to use with SMTP AUTH.  If ``_\b$_\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br (section
8179        7.4.290  , page 155)'' is set, but this variable is not, you will be prompted
8180        for a password when sending.
8181
8182        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
8183        the superuser of your machine may read it regardless of the file's permissions.
8184
8185        _\b7_\b._\b4_\b._\b2_\b8_\b8  _\bs_\bm_\bt_\bp_\b__\bp_\bo_\br_\bt
8186
8187        Type: number
8188
8189        Default: 25
8190
8191        Availability: SMTP
8192
8193        Defines the port that the SMTP host is listening on for mail delivery.  Must be
8194        specified as a number.
8195
8196        Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers
8197        will probably desire 587, the mail submission port.
8198
8199        _\b7_\b._\b4_\b._\b2_\b8_\b9  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\b__\bt_\bl_\bs
8200
8201        Type: string
8202
8203        Default: ''
8204
8205        Availability: SMTP (and SSL)
8206
8207        Defines wether to use STARTTLS. If this option is set to ``_\br_\be_\bq_\bu_\bi_\br_\be_\bd'' and the
8208        server does not support STARTTLS or there is an error in the TLS Handshake, the
8209        connection will fail. Setting this to ``_\be_\bn_\ba_\bb_\bl_\be_\bd'' will try to start TLS and
8210        continue without TLS in case of an error.  Muttng still needs to have SSL sup-
8211        port enabled in order to use it.
8212
8213        _\b7_\b._\b4_\b._\b2_\b9_\b0  _\bs_\bm_\bt_\bp_\b__\bu_\bs_\be_\br
8214
8215        Type: string
8216
8217        Default: ''
8218
8219        Availability: SMTP
8220
8221        Defines the username to use with SMTP AUTH.  Setting this variable will cause
8222        Mutt-ng to attempt to use SMTP AUTH when sending.
8223
8224        _\b7_\b._\b4_\b._\b2_\b9_\b1  _\bs_\bo_\br_\bt
8225
8226        Type: sort order
8227
8228        The Mutt Next Generation E-Mail Client                                      156
8229
8230        Default: date
8231
8232        Specifies how to sort messages in the _\bi_\bn_\bd_\be_\bx menu.  Valid values are:
8233
8234                date or date-sent
8235                date-received
8236                from
8237                mailbox-order (unsorted)
8238                score
8239                size
8240                spam
8241                subject
8242                threads
8243                to
8244
8245        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8246        (example: set sort=reverse-date-sent).
8247
8248        _\b7_\b._\b4_\b._\b2_\b9_\b2  _\bs_\bo_\br_\bt_\b__\ba_\bl_\bi_\ba_\bs
8249
8250        Type: sort order
8251
8252        Default: alias
8253
8254        Specifies how the entries in the ``alias'' menu are sorted.  The following are
8255        legal values:
8256
8257                address (sort alphabetically by email address)
8258                alias (sort alphabetically by alias name)
8259                unsorted (leave in order specified in .muttrc)
8260
8261        _\b7_\b._\b4_\b._\b2_\b9_\b3  _\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8262
8263        Type: sort order
8264
8265        Default: date
8266
8267        When sorting by threads, this variable controls how threads are sorted in rela-
8268        tion to other threads, and how the branches of the thread trees are sorted.
8269        This can be set to any value that ``_\b$_\bs_\bo_\br_\bt (section 7.4.291  , page 155)'' can,
8270        except threads (in that case, Mutt-ng will just use date-sent).  You can also
8271        specify the ``last-'' prefix in addition to ``reverse-'' prefix, but last- must
8272        come after reverse-.  The last- prefix causes messages to be sorted against its
8273        siblings by which has the last descendant, using the rest of sort_aux as an
8274        ordering.
8275
8276        For instance, set sort_aux=last-date-received would mean that if a new message
8277        is received in a thread, that thread becomes the last one displayed (or the
8278        first, if you have set sort=reverse-threads.)
8279
8280        The Mutt Next Generation E-Mail Client                                      157
8281
8282        N\bNo\bot\bte\be:\b: For reversed ``_\b$_\bs_\bo_\br_\bt (section 7.4.291  , page 155)'' order _\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
8283        (section 7.4.293  , page 156) is reversed again (which is not the right thing
8284        to do, but kept to not break any existing configuration setting).
8285
8286        _\b7_\b._\b4_\b._\b2_\b9_\b4  _\bs_\bo_\br_\bt_\b__\bb_\br_\bo_\bw_\bs_\be_\br
8287
8288        Type: sort order
8289
8290        Default: alpha
8291
8292        Specifies how to sort entries in the file browser.  By default, the entries are
8293        sorted alphabetically.  Valid values:
8294
8295                alpha (alphabetically)
8296                date
8297                size
8298                unsorted
8299
8300        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
8301        (example: set sort_browser=reverse-date).
8302
8303        _\b7_\b._\b4_\b._\b2_\b9_\b5  _\bs_\bo_\br_\bt_\b__\br_\be
8304
8305        Type: boolean
8306
8307        Default: yes
8308
8309        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
8310        (section 7.4.312  , page 163)'' _\bu_\bn_\bs_\be_\bt. In that case, it changes the heuristic
8311        Mutt-ng uses to thread messages by subject.  With _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.295  ,
8312        page 157) _\bs_\be_\bt, Mutt-ng will only attach a message as the child of another mes-
8313        sage by subject if the subject of the child message starts with a substring
8314        matching the setting of ``_\b$_\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp (section 7.4.232  , page 142)''. With
8315        _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 7.4.295  , page 157) _\bu_\bn_\bs_\be_\bt, Mutt-ng will attach the message
8316        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
8317        7.4.232  , page 142)'' parts of both messages are identical.
8318
8319        _\b7_\b._\b4_\b._\b2_\b9_\b6  _\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br
8320
8321        Type: string
8322
8323        Default: ','
8324
8325        ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.296  , page 157)'' controls what happens when
8326        multiple spam headers are matched: if _\bu_\bn_\bs_\be_\bt, each successive header will over-
8327        write any previous matches value for the spam label. If _\bs_\be_\bt, each successive
8328        match will append to the previous, using ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 7.4.296  ,
8329        page 157)'' as a separator.
8330
8331        _\b7_\b._\b4_\b._\b2_\b9_\b7  _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be
8332
8333        Type: path
8334
8335        The Mutt Next Generation E-Mail Client                                      158
8336
8337        Default: ''
8338
8339        If your spool mailbox is in a non-default place where Mutt-ng cannot find it,
8340        you can specify its location with this variable.  Mutt-ng will automatically
8341        set this variable to the value of the environment variable $MAIL if it is not
8342        set.
8343
8344        _\b7_\b._\b4_\b._\b2_\b9_\b8  _\bs_\bs_\bl_\b__\bc_\ba_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs_\b__\bf_\bi_\bl_\be
8345
8346        Type: path
8347
8348        Default: ''
8349
8350        This variable specifies a file containing trusted CA certificates.  Any server
8351        certificate that is signed with one of these CA certificates are also automati-
8352        cally accepted.
8353
8354        Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
8355
8356        _\b7_\b._\b4_\b._\b2_\b9_\b9  _\bs_\bs_\bl_\b__\bc_\bl_\bi_\be_\bn_\bt_\b__\bc_\be_\br_\bt
8357
8358        Type: path
8359
8360        Default: ''
8361
8362        Availability: SSL
8363
8364        The file containing a client certificate and its associated private key.
8365
8366        _\b7_\b._\b4_\b._\b3_\b0_\b0  _\bs_\bs_\bl_\b__\bf_\bo_\br_\bc_\be_\b__\bt_\bl_\bs
8367
8368        Type: boolean
8369
8370        Default: no
8371
8372        If this variable is _\bs_\be_\bt, mutt-ng will require that all connections to remote
8373        servers be encrypted. Furthermore it will attempt to negotiate TLS even if the
8374        server does not advertise the capability, since it would otherwise have to
8375        abort the connection anyway. This option supersedes ``_\b$_\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs (section
8376        7.4.302  , page 158)''.
8377
8378        _\b7_\b._\b4_\b._\b3_\b0_\b1  _\bs_\bs_\bl_\b__\bm_\bi_\bn_\b__\bd_\bh_\b__\bp_\br_\bi_\bm_\be_\b__\bb_\bi_\bt_\bs
8379
8380        Type: number
8381
8382        Default: 0
8383
8384        Availability: GNUTLS
8385
8386        This variable specifies the minimum acceptable prime size (in bits) for use in
8387        any Diffie-Hellman key exchange. A value of 0 will use the default from the
8388        GNUTLS library.
8389
8390        The Mutt Next Generation E-Mail Client                                      159
8391
8392        _\b7_\b._\b4_\b._\b3_\b0_\b2  _\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs
8393
8394        Type: quadoption
8395
8396        Default: yes
8397
8398        Availability: SSL or GNUTLS
8399
8400        If _\bs_\be_\bt (the default), Mutt-ng will attempt to use STARTTLS on servers advertis-
8401        ing the capability. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not attempt to use STARTTLS
8402        regardless of the server's capabilities.
8403
8404        _\b7_\b._\b4_\b._\b3_\b0_\b3  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b2
8405
8406        Type: boolean
8407
8408        Default: yes
8409
8410        Availability: SSL
8411
8412        This variables specifies whether to attempt to use SSLv2 in the SSL authentica-
8413        tion process.
8414
8415        _\b7_\b._\b4_\b._\b3_\b0_\b4  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b3
8416
8417        Type: boolean
8418
8419        Default: yes
8420
8421        Availability: SSL or GNUTLS
8422
8423        This variables specifies whether to attempt to use SSLv3 in the SSL authentica-
8424        tion process.
8425
8426        _\b7_\b._\b4_\b._\b3_\b0_\b5  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bt_\bl_\bs_\bv_\b1
8427
8428        Type: boolean
8429
8430        Default: yes
8431
8432        Availability: SSL or GNUTLS
8433
8434        This variables specifies whether to attempt to use TLSv1 in the SSL authentica-
8435        tion process.
8436
8437        _\b7_\b._\b4_\b._\b3_\b0_\b6  _\bs_\bs_\bl_\b__\bu_\bs_\be_\bs_\by_\bs_\bt_\be_\bm_\bc_\be_\br_\bt_\bs
8438
8439        Type: boolean
8440
8441        Default: yes
8442
8443        Availability: SSL
8444
8445        If set to _\by_\be_\bs, Mutt-ng will use CA certificates in the system-wide certificate
8446
8447        The Mutt Next Generation E-Mail Client                                      160
8448
8449        store when checking if server certificate is signed by a trusted CA.
8450
8451        _\b7_\b._\b4_\b._\b3_\b0_\b7  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs
8452
8453        Type: string
8454
8455        Default: '-*%A'
8456
8457        Controls the characters used by the ``%r'' indicator in ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (sec-
8458        tion 7.4.308  , page 160)''. The first character is used when the mailbox is
8459        unchanged. The second is used when the mailbox has been changed, and it needs
8460        to be resynchronized. The third is used if the mailbox is in read-only mode, or
8461        if the mailbox will not be written when exiting that mailbox (You can toggle
8462        whether to write changes to a mailbox with the toggle-write operation, bound by
8463        default to ``%'').  The fourth  is used to indicate that the current folder has
8464        been opened in attach-message mode (Certain operations like composing a new
8465        mail, replying, forwarding, etc. are not permitted in this mode).
8466
8467        _\b7_\b._\b4_\b._\b3_\b0_\b8  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
8468
8469        Type: string
8470
8471        Default: '-%r-Mutt-ng: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d?
8472        Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l?
8473        %l?]---(%s/%S)-%>-(%P)---'
8474
8475        Controls the format of the status line displayed in the _\bi_\bn_\bd_\be_\bx menu.  This
8476        string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.110  , page 111)'', but has
8477        its own set of printf(3)-like sequences:
8478
8479              %b
8480                    number of mailboxes with new mail *
8481
8482              %B
8483                    the short pathname of the current mailbox
8484
8485              %d
8486                    number of deleted messages *
8487
8488              %f
8489                    the full pathname of the current mailbox
8490
8491              %F
8492                    number of flagged messages *
8493
8494              %h
8495                    local hostname
8496
8497              %l
8498                    size (in bytes) of the current mailbox *
8499
8500              %L
8501                    size (in bytes) of the messages shown (i.e., which match the cur-
8502                    rent limit) *
8503
8504        The Mutt Next Generation E-Mail Client                                      161
8505
8506              %m
8507                    the number of messages in the mailbox *
8508
8509              %M
8510                    the number of messages shown (i.e., which match the current limit)
8511                    *
8512
8513              %n
8514                    number of new messages in the mailbox *
8515
8516              %o
8517                    number of old unread messages *
8518
8519              %p
8520                    number of postponed messages *
8521
8522              %P
8523                    percentage of the way through the index
8524
8525              %r
8526                    modified/read-only/won't-write/attach-message indicator, according
8527                    to _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs (section 7.4.307  , page 159)
8528
8529              %s
8530                    current sorting mode (_\b$_\bs_\bo_\br_\bt (section 7.4.291  , page 155))
8531
8532              %S
8533                    current aux sorting method (_\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx (section 7.4.293  , page
8534                    156))
8535
8536              %t
8537                    number of tagged messages *
8538
8539              %u
8540                    number of unread messages *
8541
8542              %v
8543                    Mutt-ng version string
8544
8545              %V
8546                    currently active limit pattern, if any *
8547
8548              %>X
8549                    right justify the rest of the string and pad with 'X'
8550
8551              %|X
8552                    pad to the end of the line with 'X'
8553
8554        * = can be optionally printed if nonzero
8555
8556        Some of the above sequences can be used to optionally print a string if their
8557        value is nonzero.  For example, you may only want to see the number of flagged
8558        messages if such messages exist, since zero is not particularly meaningful.  To
8559        optionally print a string based upon one of the above sequences, the following
8560
8561        The Mutt Next Generation E-Mail Client                                      162
8562
8563        construct is used
8564
8565        %?<sequence_char>?<optional_string>?
8566
8567        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
8568        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
8569        m\bma\bay\by contain other sequences as well as normal text, but you may n\bno\bot\bt nest
8570        optional strings.
8571
8572        Here is an example illustrating how to optionally print the number of new mes-
8573        sages in a mailbox:
8574
8575        %?n?%n new messages.?
8576
8577        Additionally you can switch between two strings, the first one, if a value is
8578        zero, the second one, if the value is nonzero, by using the following con-
8579        struct:
8580
8581        %?<sequence_char>?<if_string>&<else_string>?
8582
8583        You can additionally force the result of any printf(3)-like sequence to be low-
8584        ercase by prefixing the sequence character with an underscore (_) sign.  For
8585        example, if you want to display the local hostname in lowercase, you would use:
8586
8587        %_h
8588
8589        If you prefix the sequence character with a colon (:) character, Mutt-ng will
8590        replace any dots in the expansion by underscores. This might be helpful with
8591        IMAP folders that don't like dots in folder names.
8592
8593        _\b7_\b._\b4_\b._\b3_\b0_\b9  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bo_\bn_\b__\bt_\bo_\bp
8594
8595        Type: boolean
8596
8597        Default: no
8598
8599        Setting this variable causes the ``status bar'' to be displayed on the first
8600        line of the screen rather than near the bottom.
8601
8602        _\b7_\b._\b4_\b._\b3_\b1_\b0  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo
8603
8604        Type: boolean
8605
8606        Default: yes
8607
8608        With mailto: style links, a body as well as arbitrary header information may be
8609        embedded. This may lead to (user) headers being overwriten without note if
8610        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.54  , page 98)'' is unset.
8611
8612        If this variable is _\bs_\be_\bt, mutt-ng is strict and allows anything to be changed.
8613        If it's _\bu_\bn_\bs_\be_\bt, all headers given will be prefixed with ``X-Mailto-'' and the
8614        message including headers will be shown in the editor regardless of what
8615        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 7.4.54  , page 98)'' is set to.
8616
8617        The Mutt Next Generation E-Mail Client                                      163
8618
8619        _\b7_\b._\b4_\b._\b3_\b1_\b1  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be
8620
8621        Type: boolean
8622
8623        Default: yes
8624
8625        When _\bu_\bn_\bs_\be_\bt, non MIME-compliant messages that doesn't have any charset indica-
8626        tion in the ``Content-Type:'' header field can be displayed (non MIME-compliant
8627        messages are often generated by old mailers or buggy mailers like MS Outlook
8628        Express).  See also _\b$_\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt (section 7.4.11  , page 88).
8629
8630        This option also replaces linear-white-space between encoded-word and *text to
8631        a single space to prevent the display of MIME-encoded ``Subject:'' header field
8632        from being devided into multiple lines.
8633
8634        _\b7_\b._\b4_\b._\b3_\b1_\b2  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
8635
8636        Type: boolean
8637
8638        Default: no
8639
8640        If _\bs_\be_\bt, threading will only make use of the ``In-Reply-To:'' and ``Refer-
8641        ences:'' header fields when you ``_\b$_\bs_\bo_\br_\bt (section 7.4.291  , page 155)'' by mes-
8642        sage threads.  By default, messages with the same subject are grouped together
8643        in ``pseudo threads.''  This may not always be desirable, such as in a personal
8644        mailbox where you might have several unrelated messages with the subject ``hi''
8645        which will get grouped together.
8646
8647        _\b7_\b._\b4_\b._\b3_\b1_\b3  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs
8648
8649        Type: boolean
8650
8651        Default: no
8652
8653        When _\bs_\be_\bt, mutt-ng will remove the trailing part of the ``Subject:'' line which
8654        matches _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx (section 7.4.314  , page 163) when replying. This is
8655        useful to properly react on subject changes and reduce ``subject noise.'' (esp.
8656        in Usenet)
8657
8658        _\b7_\b._\b4_\b._\b3_\b1_\b4  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx
8659
8660        Type: regular expression
8661
8662        Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$'
8663
8664        When non-empty and _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs (section 7.4.313  , page 163) is _\bs_\be_\bt, mutt-ng
8665        will remove this trailing part of the ``Subject'' line when replying if it
8666        won't be empty afterwards.
8667
8668        _\b7_\b._\b4_\b._\b3_\b1_\b5  _\bs_\bt_\bu_\bf_\bf_\b__\bq_\bu_\bo_\bt_\be_\bd
8669
8670        Type: boolean
8671
8672        Default: no
8673
8674        The Mutt Next Generation E-Mail Client                                      164
8675
8676        If _\bs_\be_\bt, attachments with flowed format will have their quoting ``stuffed'',
8677        i.e. a space will be inserted between the quote characters and the actual text.
8678
8679        _\b7_\b._\b4_\b._\b3_\b1_\b6  _\bs_\bu_\bs_\bp_\be_\bn_\bd
8680
8681        Type: boolean
8682
8683        Default: yes
8684
8685        When _\bu_\bn_\bs_\be_\bt, Mutt-ng won't stop when the user presses the terminal's _\bs_\bu_\bs_\bp key,
8686        usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a com-
8687        mand like ``xterm -e muttng.''
8688
8689        _\b7_\b._\b4_\b._\b3_\b1_\b7  _\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd
8690
8691        Type: boolean
8692
8693        Default: no
8694
8695        When _\bs_\be_\bt, Mutt-ng will generate text/plain; format=flowed attachments.  This
8696        format is easier to handle for some mailing software, and generally just looks
8697        like ordinary text.  To actually make use of this format's features, you'll
8698        need support in your editor.
8699
8700        Note that _\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 7.4.109  , page 111) is ignored when this
8701        option is set.
8702
8703        _\b7_\b._\b4_\b._\b3_\b1_\b8  _\bt_\bh_\bo_\br_\bo_\bu_\bg_\bh_\b__\bs_\be_\ba_\br_\bc_\bh
8704
8705        Type: boolean
8706
8707        Default: no
8708
8709        Affects the ~b and ~h search operations described in section ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
8710        tion 7.2  , page 80)'' above.  If _\bs_\be_\bt, the headers and attachments of messages
8711        to be searched are decoded before searching.  If _\bu_\bn_\bs_\be_\bt, messages are searched
8712        as they appear in the folder.
8713
8714        _\b7_\b._\b4_\b._\b3_\b1_\b9  _\bt_\bh_\br_\be_\ba_\bd_\b__\br_\be_\bc_\be_\bi_\bv_\be_\bd
8715
8716        Type: boolean
8717
8718        Default: no
8719
8720        When _\bs_\be_\bt, Mutt-ng uses the date received rather than the date sent to thread
8721        messages by subject.
8722
8723        _\b7_\b._\b4_\b._\b3_\b2_\b0  _\bt_\bi_\bl_\bd_\be
8724
8725        Type: boolean
8726
8727        Default: no
8728
8729        When _\bs_\be_\bt, the internal-pager will pad blank lines to the bottom of the screen
8730
8731        The Mutt Next Generation E-Mail Client                                      165
8732
8733        with a tilde (~).
8734
8735        _\b7_\b._\b4_\b._\b3_\b2_\b1  _\bt_\bi_\bm_\be_\bo_\bu_\bt
8736
8737        Type: number
8738
8739        Default: 600
8740
8741        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
8742        pressed in the main menu before timing out and checking for new mail.  A value
8743        of zero or less will cause Mutt-ng to never time out.
8744
8745        _\b7_\b._\b4_\b._\b3_\b2_\b2  _\bt_\bm_\bp_\bd_\bi_\br
8746
8747        Type: path
8748
8749        Default: ''
8750
8751        This variable allows you to specify where Mutt-ng will place its temporary
8752        files needed for displaying and composing messages.  If this variable is not
8753        set, the environment variable $TMPDIR is used.  If $TMPDIR is not set then
8754        '/tmp' is used.
8755
8756        _\b7_\b._\b4_\b._\b3_\b2_\b3  _\bt_\bo_\b__\bc_\bh_\ba_\br_\bs
8757
8758        Type: string
8759
8760        Default: ' +TCFL'
8761
8762        Controls the character used to indicate mail addressed to you.  The first char-
8763        acter is the one used when the mail is NOT addressed to your address (default:
8764        space).  The second is used when you are the only recipient of the message
8765        (default: +).  The third is when your address appears in the ``To:'' header
8766        field, but you are not the only recipient of the message (default: T).  The
8767        fourth character is used when your address is specified in the ``Cc:'' header
8768        field, but you are not the only recipient.  The fifth character is used to
8769        indicate mail that was sent by _\by_\bo_\bu.  The sixth character is used to indicate
8770        when a mail was sent to a mailing-list you're subscribe to (default: L).
8771
8772        _\b7_\b._\b4_\b._\b3_\b2_\b4  _\bt_\br_\ba_\bs_\bh
8773
8774        Type: path
8775
8776        Default: ''
8777
8778        If _\bs_\be_\bt, this variable specifies the path of the trash folder where the mails
8779        marked for deletion will be moved, instead of being irremediably purged.
8780
8781        N\bNo\bot\bte\be: When you delete a message in the trash folder, it is really deleted, so
8782        that there is no way to recover mail.
8783
8784        _\b7_\b._\b4_\b._\b3_\b2_\b5  _\bt_\bu_\bn_\bn_\be_\bl
8785
8786        Type: string
8787
8788        The Mutt Next Generation E-Mail Client                                      166
8789
8790        Default: ''
8791
8792        Setting this variable will cause Mutt-ng to open a pipe to a command instead of
8793        a raw socket. You may be able to use this to set up preauthenticated connec-
8794        tions to your IMAP/POP3 server. Example:
8795
8796        tunnel='ssh -q mailhost.net /usr/local/libexec/imapd'
8797
8798        N\bNo\bot\bte\be:\b: For this example to work you must be able to log in to the remote machine
8799        without having to enter a password.
8800
8801        _\b7_\b._\b4_\b._\b3_\b2_\b6  _\bu_\bm_\ba_\bs_\bk
8802
8803        Type: number
8804
8805        Default: 0077
8806
8807        This sets the umask that will be used by Mutt-ng when creating all kinds of
8808        files. If _\bu_\bn_\bs_\be_\bt, the default value is 077.
8809
8810        _\b7_\b._\b4_\b._\b3_\b2_\b7  _\bu_\bn_\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bj_\bu_\bm_\bp
8811
8812        Type: boolean
8813
8814        Default: no
8815
8816        When _\bs_\be_\bt, Mutt-ng will jump to the next unread message, if any, when the cur-
8817        rent thread is _\bu_\bncollapsed.
8818
8819        _\b7_\b._\b4_\b._\b3_\b2_\b8  _\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be
8820
8821        Type: boolean
8822
8823        Default: no
8824
8825        W\bWa\bar\brn\bni\bin\bng\bg:\b: do not set this variable unless you are using a version of sendmail
8826        which supports the -B8BITMIME flag (such as sendmail 8.8.x) or in connection
8827        with the SMTP support via libESMTP.  Otherwise you may not be able to send
8828        mail.
8829
8830        When _\bs_\be_\bt, Mutt-ng will either invoke ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 7.4.248  , page
8831        145)'' with the -B8BITMIME flag when sending 8-bit messages to enable ESMTP
8832        negotiation or tell libESMTP to do so.
8833
8834        _\b7_\b._\b4_\b._\b3_\b2_\b9  _\bu_\bs_\be_\b__\bd_\bo_\bm_\ba_\bi_\bn
8835
8836        Type: boolean
8837
8838        Default: yes
8839
8840        When _\bs_\be_\bt, Mutt-ng will qualify all local addresses (ones without the @host por-
8841        tion) with the value of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section 7.4.89  , page 106)''.  If _\bu_\bn_\bs_\be_\bt,
8842        no addresses will be qualified.
8843
8844        The Mutt Next Generation E-Mail Client                                      167
8845
8846        _\b7_\b._\b4_\b._\b3_\b3_\b0  _\bu_\bs_\be_\b__\bf_\br_\bo_\bm
8847
8848        Type: boolean
8849
8850        Default: yes
8851
8852        When _\bs_\be_\bt, Mutt-ng will generate the ``From:'' header field when sending mes-
8853        sages. If _\bu_\bn_\bs_\be_\bt, no ``From:'' header field will be generated unless the user
8854        explicitly sets one using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.15  , page 34)'' command.
8855
8856        _\b7_\b._\b4_\b._\b3_\b3_\b1  _\bu_\bs_\be_\b__\bi_\bd_\bn
8857
8858        Type: boolean
8859
8860        Default: yes
8861
8862        Availability: IDN
8863
8864        When _\bs_\be_\bt, Mutt-ng will show you international domain names decoded.
8865
8866        N\bNo\bot\bte\be:\b: You can use IDNs for addresses even if this is _\bu_\bn_\bs_\be_\bt.  This variable only
8867        affects decoding.
8868
8869        _\b7_\b._\b4_\b._\b3_\b3_\b2  _\bu_\bs_\be_\b__\bi_\bp_\bv_\b6
8870
8871        Type: boolean
8872
8873        Default: yes
8874
8875        When _\bs_\be_\bt, Mutt-ng will look for IPv6 addresses of hosts it tries to contact.
8876        If this option is _\bu_\bn_\bs_\be_\bt, Mutt-ng will restrict itself to IPv4 addresses.  Nor-
8877        mally, the default should work.
8878
8879        _\b7_\b._\b4_\b._\b3_\b3_\b3  _\bu_\bs_\be_\br_\b__\ba_\bg_\be_\bn_\bt
8880
8881        Type: boolean
8882
8883        Default: yes
8884
8885        When _\bs_\be_\bt, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indi-
8886        cating which version of Mutt-ng was used for composing them.
8887
8888        _\b7_\b._\b4_\b._\b3_\b3_\b4  _\bv_\bi_\bs_\bu_\ba_\bl
8889
8890        Type: path
8891
8892        Default: ''
8893
8894        Specifies the visual editor to invoke when the _\b~_\bv command is given in the
8895        builtin editor.
8896
8897        _\b7_\b._\b4_\b._\b3_\b3_\b5  _\bw_\ba_\bi_\bt_\b__\bk_\be_\by
8898
8899        Type: boolean
8900
8901        The Mutt Next Generation E-Mail Client                                      168
8902
8903        Default: yes
8904
8905        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-
8906        _\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.
8907
8908        It is also used when viewing attachments with ``_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page
8909        75)'', provided that the corresponding mailcap entry has a needsterminal flag,
8910        and the external program is interactive.
8911
8912        When _\bs_\be_\bt, Mutt-ng will always ask for a key. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will wait for
8913        a key only if the external command returned a non-zero status.
8914
8915        _\b7_\b._\b4_\b._\b3_\b3_\b6  _\bw_\be_\be_\bd
8916
8917        Type: boolean
8918
8919        Default: yes
8920
8921        When _\bs_\be_\bt, Mutt-ng will weed headers when displaying, forwarding, printing, or
8922        replying to messages.
8923
8924        _\b7_\b._\b4_\b._\b3_\b3_\b7  _\bw_\br_\ba_\bp_\b__\bs_\be_\ba_\br_\bc_\bh
8925
8926        Type: boolean
8927
8928        Default: yes
8929
8930        Controls whether searches wrap around the end of the mailbox.
8931
8932        When _\bs_\be_\bt, searches will wrap around the first (or last) message. When _\bu_\bn_\bs_\be_\bt,
8933        searches will not wrap.
8934
8935        _\b7_\b._\b4_\b._\b3_\b3_\b8  _\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
8936
8937        Type: number
8938
8939        Default: 0
8940
8941        Controls the size of the margin remaining at the right side of the terminal
8942        when Mutt-ng's pager does smart wrapping.
8943
8944        _\b7_\b._\b4_\b._\b3_\b3_\b9  _\bw_\br_\bi_\bt_\be_\b__\bb_\bc_\bc
8945
8946        Type: boolean
8947
8948        Default: yes
8949
8950        Controls whether Mutt-ng writes out the Bcc header when preparing messages to
8951        be sent.  Exim users may wish to _\bu_\bn_\bs_\be_\bt this.
8952
8953        _\b7_\b._\b4_\b._\b3_\b4_\b0  _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc
8954
8955        Type: number
8956
8957        The Mutt Next Generation E-Mail Client                                      169
8958
8959        Default: 10
8960
8961        When writing a mailbox, a message will be printed every _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc messages to
8962        indicate progress.  If set to 0, only a single message will be displayed before
8963        writing a mailbox.
8964
8965        Also see the ``_\b$_\br_\be_\ba_\bd_\b__\bi_\bn_\bc (section 7.4.227  , page 140)'' variable.
8966
8967        _\b7_\b._\b4_\b._\b3_\b4_\b1  _\bx_\bt_\be_\br_\bm_\b__\bi_\bc_\bo_\bn
8968
8969        Type: string
8970
8971        Default: 'M%?n?AIL&ail?'
8972
8973        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-
8974        tion 7.4.343  , page 169) is _\bs_\be_\bt. This string is identical in formatting to the
8975        one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 7.4.308  , page 160)''.
8976
8977        _\b7_\b._\b4_\b._\b3_\b4_\b2  _\bx_\bt_\be_\br_\bm_\b__\bl_\be_\ba_\bv_\be
8978
8979        Type: string
8980
8981        Default: ''
8982
8983        If _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.343  , page 169) is _\bs_\be_\bt, this string will be
8984        used to set the title when leaving mutt-ng. For terminal-based programs,
8985        there's no easy and portable way to read the current title so mutt-ng cannot
8986        read it upon startup and restore it when exiting.
8987
8988        Based on the xterm FAQ, the following might work:
8989
8990        set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME |
8991        cut -d ''' -f 2`'
8992
8993        _\b7_\b._\b4_\b._\b3_\b4_\b3  _\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs
8994
8995        Type: boolean
8996
8997        Default: no
8998
8999        Controls whether Mutt-ng sets the xterm title bar and icon name (as long as
9000        you're in an appropriate terminal). The default must be _\bu_\bn_\bs_\be_\bt to force in the
9001        validity checking.
9002
9003        _\b7_\b._\b4_\b._\b3_\b4_\b4  _\bx_\bt_\be_\br_\bm_\b__\bt_\bi_\bt_\bl_\be
9004
9005        Type: string
9006
9007        Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?'
9008
9009        Controls the format of the title bar of the xterm provided that
9010        _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 7.4.343  , page 169) has been _\bs_\be_\bt. This string is
9011        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.308  ,
9012        page 160)''.
9013
9014        The Mutt Next Generation E-Mail Client                                      170
9015
9016        _\b7_\b._\b5  _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
9017
9018        The following is the list of available functions listed by the mapping in which
9019        they are available.  The default key setting is given, and an explanation of
9020        what the function does.  The key bindings of these functions can be changed
9021        with the _\bb_\bi_\bn_\bd (section 3.4  , page 24) command.
9022
9023        _\b7_\b._\b5_\b._\b1  _\bg_\be_\bn_\be_\br_\bi_\bc
9024
9025        The _\bg_\be_\bn_\be_\br_\bi_\bc menu is not a real menu, but specifies common functions (such as
9026        movement) available in all menus except for _\bp_\ba_\bg_\be_\br and _\be_\bd_\bi_\bt_\bo_\br.  Changing set-
9027        tings for this menu will affect the default bindings for all menus (except as
9028        noted).
9029
9030             bottom-page                L   move to the bottom of the page
9031             current-bottom     not bound   move current entry to bottom of page
9032             current-middle     not bound   move current entry to middle of page
9033             current-top        not bound   move current entry to top of page
9034             enter-command              :   enter a muttngrc command
9035             exit                       q   exit this menu
9036             first-entry                =   move to the first entry
9037             half-down                  ]   scroll down 1/2 page
9038             half-up                    [   scroll up 1/2 page
9039             help                       ?   this screen
9040             jump                  number   jump to an index number
9041             last-entry                 *   move to the last entry
9042             middle-page                M   move to the middle of the page
9043             next-entry                 j   move to the next entry
9044             next-line                  >   scroll down one line
9045             next-page                  z   move to the next page
9046             previous-entry             k   move to the previous entry
9047             previous-line              <   scroll up one line
9048             previous-page              Z   move to the previous page
9049             refresh                   ^L   clear and redraw the screen
9050             search                     /   search for a regular expression
9051             search-next                n   search for next match
9052             search-opposite    not bound   search for next match in opposite direction
9053             search-reverse         ESC /   search backwards for a regular expression
9054             select-entry             RET   select the current entry
9055             shell-escape               !   run a program in a subshell
9056             tag-entry                  t   toggle the tag on the current entry
9057             tag-prefix                 ;   apply next command to tagged entries
9058             tag-prefix-cond    not bound   apply next function ONLY to tagged messages
9059             top-page                   H   move to the top of the page
9060             what-key           not bound   display the keycode for a key press
9061
9062        _\b7_\b._\b5_\b._\b2  _\bi_\bn_\bd_\be_\bx
9063
9064        The Mutt Next Generation E-Mail Client                                      171
9065
9066             bounce-message             b   remail a message to another user
9067             change-folder              c   open a different folder
9068             change-folder-readonly ESC c   open a different folder in read only mode
9069             check-traditional-pgp  ESC P   check for classic pgp
9070             clear-flag                 W   clear a status flag from a message
9071             copy-message               C   copy a message to a file/mailbox
9072             create-alias               a   create an alias from a message sender
9073             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9074             decode-save            ESC s   decode a message and save it to a file/mailbox
9075             delete-message             d   delete the current entry
9076             delete-pattern             D   delete messages matching a pattern
9077             delete-subthread       ESC d   delete all messages in subthread
9078             delete-thread             ^D   delete all messages in thread
9079             display-address            @   display full address of sender
9080             display-toggle-weed        h   display message and toggle header weeding
9081             display-message          RET   display a message
9082             edit                       e   edit the current message
9083             edit-type                 ^E   edit the current message's Content-Type
9084             exit                       x   exit without saving changes
9085             extract-keys              ^K   extract PGP public keys
9086             fetch-mail                 G   retrieve mail from POP server
9087             flag-message               F   toggle a message's 'important' flag
9088             forget-passphrase         ^F   wipe PGP passphrase from memory
9089             forward-message            f   forward a message with comments
9090             group-reply                g   reply to all recipients
9091             limit                      l   show only messages matching a pattern
9092             list-reply                 L   reply to specified mailing list
9093             mail                       m   compose a new mail message
9094             mail-key               ESC k   mail a PGP public key
9095             next-new                 TAB   jump to the next new message
9096             next-subthread         ESC n   jump to the next subthread
9097             next-thread               ^N   jump to the next thread
9098             next-undeleted             j   move to the next undeleted message
9099             next-unread        not bound   jump to the next unread message
9100             parent-message             P   jump to parent message in thread
9101             pipe-message               |   pipe message/attachment to a shell command
9102             previous-new         ESC TAB   jump to the previous new message
9103             previous-page              Z   move to the previous page
9104             previous-subthread     ESC p   jump to previous subthread
9105             previous-thread           ^P   jump to previous thread
9106             previous-undeleted         k   move to the last undelete message
9107             previous-unread    not bound   jump to the previous unread message
9108             print-message              p   print the current entry
9109             query                      Q   query external program for addresses
9110             quit                       q   save changes to mailbox and quit
9111             read-subthread         ESC r   mark the current subthread as read
9112             read-thread               ^R   mark the current thread as read
9113             recall-message             R   recall a postponed message
9114             reply                      r   reply to a message
9115             resend-message         ESC e   resend message and preserve MIME structure
9116             save-message               s   save message/attachment to a file
9117             set-flag                   w   set a status flag on a message
9118             show-version               V   show the Mutt-ng version number and date
9119             show-limit             ESC l   show currently active limit pattern, if any
9120
9121        The Mutt Next Generation E-Mail Client                                      172
9122
9123             sort-mailbox               o   sort messages
9124             sort-reverse               O   sort messages in reverse order
9125             sync-mailbox               $   save changes to mailbox
9126             tag-pattern                T   tag messages matching a pattern
9127             tag-thread             ESC t   tag/untag all messages in the current thread
9128             toggle-new                 N   toggle a message's 'new' flag
9129             toggle-write               %   toggle whether the mailbox will be rewritten
9130             undelete-message           u   undelete the current entry
9131             undelete-pattern           U   undelete messages matching a pattern
9132             undelete-subthread     ESC u   undelete all messages in subthread
9133             undelete-thread           ^U   undelete all messages in thread
9134             untag-pattern             ^T   untag messages matching a pattern
9135             view-attachments           v   show MIME attachments
9136
9137        _\b7_\b._\b5_\b._\b3  _\bp_\ba_\bg_\be_\br
9138
9139        The Mutt Next Generation E-Mail Client                                      173
9140
9141             bottom             not bound   jump to the bottom of the message
9142             bounce-message             b   remail a message to another user
9143             change-folder              c   open a different folder
9144             change-folder-readonly ESC c   open a different folder in read only mode
9145             check-traditional-pgp  ESC P   check for classic pgp
9146             copy-message               C   copy a message to a file/mailbox
9147             create-alias               a   create an alias from a message sender
9148             decode-copy            ESC C   decode a message and copy it to a file/mailbox
9149             decode-save            ESC s   decode a message and save it to a file/mailbox
9150             delete-message             d   delete the current entry
9151             delete-subthread       ESC d   delete all messages in subthread
9152             delete-thread             ^D   delete all messages in thread
9153             display-address            @   display full address of sender
9154             display-toggle-weed        h   display message and toggle header weeding
9155             edit                       e   edit the current message
9156             edit-type                 ^E   edit the current message's Content-Type
9157             enter-command              :   enter a muttngrc command
9158             exit                       i   return to the main-menu
9159             extract-keys              ^K   extract PGP public keys
9160             flag-message               F   toggle a message's 'important' flag
9161             forget-passphrase         ^F   wipe PGP passphrase from memory
9162             forward-message            f   forward a message with comments
9163             group-reply                g   reply to all recipients
9164             half-up            not bound   move up one-half page
9165             half-down          not bound   move down one-half page
9166             help                       ?   this screen
9167             list-reply                 L   reply to specified mailing list
9168             mail                       m   compose a new mail message
9169             mail-key               ESC k   mail a PGP public key
9170             mark-as-new                N   toggle a message's 'new' flag
9171             next-line                RET   scroll down one line
9172             next-entry                 J   move to the next entry
9173             next-new                 TAB   jump to the next new message
9174             next-page                      move to the next page
9175             next-subthread         ESC n   jump to the next subthread
9176             next-thread               ^N   jump to the next thread
9177             next-undeleted             j   move to the next undeleted message
9178             next-unread        not bound   jump to the next unread message
9179             parent-message             P   jump to parent message in thread
9180             pipe-message               |   pipe message/attachment to a shell command
9181             previous-line      BackSpace   scroll up one line
9182             previous-entry             K   move to the previous entry
9183             previous-new       not bound   jump to the previous new message
9184             previous-page              -   move to the previous page
9185             previous-subthread     ESC p   jump to previous subthread
9186             previous-thread           ^P   jump to previous thread
9187             previous-undeleted         k   move to the last undelete message
9188             previous-unread    not bound   jump to the previous unread message
9189             print-message              p   print the current entry
9190             quit                       Q   save changes to mailbox and quit
9191             read-subthread         ESC r   mark the current subthread as read
9192             read-thread               ^R   mark the current thread as read
9193             recall-message             R   recall a postponed message
9194             redraw-screen             ^L   clear and redraw the screen
9195
9196        The Mutt Next Generation E-Mail Client                                      174
9197
9198             reply                      r   reply to a message
9199             save-message               s   save message/attachment to a file
9200             search                     /   search for a regular expression
9201             search-next                n   search for next match
9202             search-opposite    not bound   search for next match in opposite direction
9203             search-reverse         ESC /   search backwards for a regular expression
9204             search-toggle              \   toggle search pattern coloring
9205             shell-escape               !   invoke a command in a subshell
9206             show-version               V   show the Mutt-ng version number and date
9207             skip-quoted                S   skip beyond quoted text
9208             sync-mailbox               $   save changes to mailbox
9209             tag-message                t   tag a message
9210             toggle-quoted              T   toggle display of quoted text
9211             top                        ^   jump to the top of the message
9212             undelete-message           u   undelete the current entry
9213             undelete-subthread     ESC u   undelete all messages in subthread
9214             undelete-thread           ^U   undelete all messages in thread
9215             view-attachments           v   show MIME attachments
9216
9217        _\b7_\b._\b5_\b._\b4  _\ba_\bl_\bi_\ba_\bs
9218
9219             search                     /   search for a regular expression
9220             search-next                n   search for next match
9221             search-reverse         ESC /   search backwards for a regular expression
9222
9223        _\b7_\b._\b5_\b._\b5  _\bq_\bu_\be_\br_\by
9224
9225             create-alias               a   create an alias from a message sender
9226             mail                       m   compose a new mail message
9227             query                      Q   query external program for addresses
9228             query-append               A   append new query results to current results
9229             search                     /   search for a regular expression
9230             search-next                n   search for next match
9231             search-opposite    not bound   search for next match in opposite direction
9232             search-reverse         ESC /   search backwards for a regular expression
9233
9234        _\b7_\b._\b5_\b._\b6  _\ba_\bt_\bt_\ba_\bc_\bh
9235
9236        The Mutt Next Generation E-Mail Client                                      175
9237
9238             bounce-message             b   remail a message to another user
9239             collapse-parts             v   toggle display of subparts
9240             delete-entry               d   delete the current entry
9241             display-toggle-weed        h   display message and toggle header weeding
9242             edit-type                 ^E   edit the current entry's Content-Type
9243             extract-keys              ^K   extract PGP public keys
9244             forward-message            f   forward a message with comments
9245             group-reply                g   reply to all recipients
9246             list-reply                 L   reply to specified mailing list
9247             pipe-entry                 |   pipe message/attachment to a shell command
9248             print-entry                p   print the current entry
9249             reply                      r   reply to a message
9250             resend-message         ESC e   resend message and preserve MIME structure
9251             save-entry                 s   save message/attachment to a file
9252             undelete-entry             u   undelete the current entry
9253             view-attach              RET   view attachment using mailcap entry if necessary
9254             view-mailcap               m   force viewing of attachment using mailcap
9255             view-text                  T   view attachment as text
9256
9257        _\b7_\b._\b5_\b._\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be
9258
9259        The Mutt Next Generation E-Mail Client                                      176
9260
9261             attach-file                a   attach a file(s) to this message
9262             attach-message             A   attach message(s) to this message
9263             attach-key             ESC k   attach a PGP public key
9264             copy-file                  C   save message/attachment to a file
9265             detach-file                D   delete the current entry
9266             display-toggle-weed        h   display message and toggle header weeding
9267             edit-bcc                   b   edit the BCC list
9268             edit-cc                    c   edit the CC list
9269             edit-description           d   edit attachment description
9270             edit-encoding             ^E   edit attachment transfer-encoding
9271             edit-fcc                   f   enter a file to save a copy of this message in
9272             edit-from              ESC f   edit the from: field
9273             edit-file               ^X e   edit the file to be attached
9274             edit-headers               E   edit the message with headers
9275             edit                       e   edit the message
9276             edit-mime                  m   edit attachment using mailcap entry
9277             edit-reply-to              r   edit the Reply-To field
9278             edit-subject               s   edit the subject of this message
9279             edit-to                    t   edit the TO list
9280             edit-type                 ^T   edit attachment type
9281             filter-entry               F   filter attachment through a shell command
9282             forget-passphrase         ^F   wipe PGP passphrase from memory
9283             ispell                     i   run ispell on the message
9284             new-mime                   n   compose new attachment using mailcap entry
9285             pgp-menu                   p   show PGP options
9286             pipe-entry                 |   pipe message/attachment to a shell command
9287             postpone-message           P   save this message to send later
9288             print-entry                l   print the current entry
9289             rename-file                R   rename/move an attached file
9290             send-message               y   send the message
9291             toggle-unlink              u   toggle whether to delete file after sending it
9292             view-attach              RET   view attachment using mailcap entry if necessary
9293             write-fcc         w   write the message to a folder
9294
9295        _\b7_\b._\b5_\b._\b8  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
9296
9297             delete-entry               d   delete the current entry
9298             undelete-entry             u   undelete the current entry
9299
9300        _\b7_\b._\b5_\b._\b9  _\bb_\br_\bo_\bw_\bs_\be_\br
9301
9302        The Mutt Next Generation E-Mail Client                                      177
9303
9304             change-dir                 c   change directories
9305             check-new                TAB   check mailboxes for new mail
9306             enter-mask                 m   enter a file mask
9307             search                     /   search for a regular expression
9308             search-next                n   search for next match
9309             search-reverse         ESC /   search backwards for a regular expression
9310             select-new                 N   select a new file in this directory
9311             sort                       o   sort messages
9312             sort-reverse               O   sort messages in reverse order
9313             toggle-mailboxes         TAB   toggle whether to browse mailboxes or all files
9314             view-file              SPACE   view file
9315             subscribe                  s   subscribe to current mailbox (IMAP Only)
9316             unsubscribe                u   unsubscribe to current mailbox (IMAP Only)
9317             toggle-subscribed          T   toggle view all/subscribed mailboxes (IMAP Only)
9318
9319        _\b7_\b._\b5_\b._\b1_\b0  _\bp_\bg_\bp
9320
9321             view-name                  %   view the key's user id
9322             verify-key                 c   verify a PGP public key
9323
9324        _\b7_\b._\b5_\b._\b1_\b1  _\be_\bd_\bi_\bt_\bo_\br
9325
9326             backspace          BackSpace   delete the char in front of the cursor
9327             backward-char             ^B   move the cursor one character to the left
9328             backward-word          ESC b   move the cursor to the previous word
9329             bol                       ^A   jump to the beginning of the line
9330             buffy-cycle            Space   cycle among incoming mailboxes
9331             capitalize-word        ESC c   uppercase the first character in the word
9332             complete                 TAB   complete filename or alias
9333             complete-query            ^T   complete address with query
9334             delete-char               ^D   delete the char under the cursor
9335             downcase-word          ESC l   lowercase all characters in current word
9336             eol                       ^E   jump to the end of the line
9337             forward-char              ^F   move the cursor one character to the right
9338             forward-word           ESC f   move the cursor to the next word
9339             history-down       not bound   scroll down through the history list
9340             history-up         not bound   scroll up through the history list
9341             kill-eol                  ^K   delete chars from cursor to end of line
9342             kill-eow               ESC d   delete chars from cursor to end of word
9343             kill-line                 ^U   delete all chars on the line
9344             kill-word                 ^W   delete the word in front of the cursor
9345             quote-char                ^V   quote the next typed key
9346             transpose-chars    not bound   transpose character under cursor with previous
9347             upcase-word            ESC u   uppercase all characters in current word
9348
9349        _\b8_\b.  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\by
9350
9351        The Mutt Next Generation E-Mail Client                                      178
9352
9353        _\b8_\b._\b1  _\bA_\bc_\bk_\bn_\bo_\bw_\bl_\be_\bd_\bg_\bm_\be_\bn_\bt_\bs
9354
9355        Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
9356        back in the ELM-ME days.
9357
9358        The following people have been very helpful to the development of Mutt:
9359
9360        Vikas Agnihotri <vikasa@writeme.com>,
9361
9362        Francois Berjon <Francois.Berjon@aar.alcatel-alsthom.fr>,
9363
9364        Aric Blumer <aric@fore.com>,
9365
9366        John Capo <jc@irbs.com>,
9367
9368        David Champion <dgc@uchicago.edu,
9369
9370        Brendan Cully <brendan@kublai.com>,
9371
9372        Liviu Daia <daia@stoilow.imar.ro>,
9373
9374        Thomas E. Dickey <dickey@herndon4.his.com>,
9375
9376        David DeSimone <fox@convex.hp.com>,
9377
9378        Nickolay N. Dudorov <nnd@wint.itfs.nsk.su>,
9379
9380        Ruslan Ermilov <ru@freebsd.org>,
9381
9382        Edmund Grimley Evans <edmundo@rano.org,
9383
9384        Michael Finken <finken@conware.de>,
9385
9386        Sven Guckes <guckes@math.fu-berlin.de>,
9387
9388        Lars Hecking <lhecking@nmrc.ie>,
9389
9390        Mark Holloman <holloman@nando.net>,
9391
9392        Andreas Holzmann <holzmann@fmi.uni-passau.de>,
9393
9394        Marco d'Itri <md@linux.it>,
9395
9396        Bjrn Jacke <bjacke@suse.com>,
9397
9398        Byrial Jensen <byrial@image.dk>,
9399
9400        David Jeske <jeske@igcom.net>,
9401
9402        Christophe Kalt <kalt@hugo.int-evry.fr>,
9403
9404        Tommi Komulainen <Tommi.Komulainen@iki.fi>,
9405
9406        Felix von Leitner (a.k.a ``Fefe'') <leitner@math.fu-berlin.de>,
9407
9408        The Mutt Next Generation E-Mail Client                                      179
9409
9410        Brandon Long <blong@fiction.net>,
9411
9412        Jimmy Mkel <jmy@flashback.net>,
9413
9414        Lars Marowsky-Bree <lmb@pointer.in-minden.de>,
9415
9416        Thomas ``Mike'' Michlmayr <mike@cosy.sbg.ac.at>,
9417
9418        Andrew W. Nosenko <awn@bcs.zp.ua>,
9419
9420        David O'Brien <obrien@Nuxi.cs.ucdavis.edu>,
9421
9422        Clint Olsen <olsenc@ichips.intel.com>,
9423
9424        Park Myeong Seok <pms@romance.kaist.ac.kr>,
9425
9426        Thomas Parmelan <tom@ankh.fr.eu.org>,
9427
9428        Ollivier Robert <roberto@keltia.freenix.fr>,
9429
9430        Thomas Roessler <roessler@does-not-exist.org>,
9431
9432        Roland Rosenfeld <roland@spinnaker.de>,
9433
9434        TAKIZAWA Takashi <taki@luna.email.ne.jp>,
9435
9436        Allain Thivillon <Allain.Thivillon@alma.fr>,
9437
9438        Gero Treuner <gero@faveve.uni-stuttgart.de>,
9439
9440        Vsevolod Volkov <vvv@lucky.net>,
9441
9442        Ken Weinert <kenw@ihs.com>
9443
9444        Mutt-ng is developed by the following people:
9445
9446        Andreas Krennmair <ak@synflood.at>
9447
9448        Nico Golde <nico@ngolde.de>
9449
9450        Rocco Rutte <pdmef@cs.tu-berlin.de>
9451
9452        The following people have been very helpful to the development of  Mutt-ng:
9453
9454        Christian Gall <cg@cgall.de>
9455
9456        Iain Lea <iain@bricbrac.de>
9457
9458        Andreas Kneib <akneib@gmx.net>
9459
9460        Carsten Schoelzki <cjs@weisshuhn.de>
9461
9462        Elimar Riesebieter <riesebie@lxtec.de>
9463
9464        The Mutt Next Generation E-Mail Client                                      180
9465
9466        _\b8_\b._\b2  _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt
9467
9468        This document was written in SGML, and then rendered using the sgml-tools pack-
9469        age.
9470
9471        The Mutt Next Generation E-Mail Client                                      181
9472
9473                                           CONTENTS
9474
9475        1.  Introduction   .......................................................... 1
9476            1.1   Overview   ........................................................ 1
9477            1.2   Mutt-ng Home Page   ............................................... 1
9478            1.3   Mailing Lists   ................................................... 1
9479            1.4   Software Distribution Sites   ..................................... 2
9480            1.5   IRC   ............................................................. 2
9481            1.6   Weblog   .......................................................... 2
9482            1.7   Copyright   ....................................................... 2
9483
9484        2.  Getting Started     ..................................................... 2
9485            2.1   Basic Concepts       .............................................. 2
9486                  2.1.1    Screens and Menus           3
9487                  2.1.2    Configuration           3
9488                  2.1.3    Functions           3
9489                  2.1.4    Interaction           4
9490                  2.1.5    Modularization           4
9491                  2.1.6    Patterns           4
9492            2.2   Screens and Menus       ........................................... 4
9493                  2.2.1    Index          4
9494                  2.2.2    Pager          5
9495                  2.2.3    File Browser           5
9496                  2.2.4    Sidebar           5
9497                  2.2.5    Help           5
9498                  2.2.6    Compose Menu             6
9499                  2.2.7    Alias Menu             6
9500                  2.2.8    Attachment Menu             6
9501                  2.2.9    Key Menu             6
9502            2.3   Moving Around in Menus   .......................................... 6
9503            2.4   Editing Input Fields   ............................................ 7
9504            2.5   Reading Mail - The Index and Pager   .............................. 8
9505                  2.5.1    The Message Index   8
9506                  2.5.2    The Pager   9
9507                  2.5.3    Threaded Mode   11
9508                  2.5.4    Miscellaneous Functions   11
9509            2.6   Sending Mail   ................................................... 14
9510                  2.6.1    Composing new messages     14
9511                  2.6.2    Replying         16
9512                  2.6.3    Editing the message header     17
9513                  2.6.4    Using Mutt-ng with PGP     18
9514                  2.6.5    Sending anonymous messages via mixmaster     19
9515            2.7   Forwarding and Bouncing Mail   ................................... 19
9516            2.8   Postponing Mail   ................................................ 20
9517
9518        3.  Configuration   ........................................................ 21
9519            3.1   Locations of Configuration Files   ............................... 21
9520            3.2   Syntax of Initialization Files   ................................. 21
9521            3.3   Defining/Using aliases   ......................................... 23
9522            3.4   Changing the default key bindings   .............................. 24
9523            3.5   Defining aliases for character sets    ........................... 26
9524
9525                                               i
9526
9527            3.6   Setting variables based upon mailbox   ........................... 26
9528            3.7   Keyboard macros   ................................................ 27
9529            3.8   Using color and mono video attributes   .......................... 28
9530            3.9   Ignoring (weeding) unwanted message headers   .................... 30
9531            3.10  Alternative addresses   .......................................... 31
9532            3.11  Format = Flowed   ................................................ 31
9533            3.12  Mailing lists   .................................................. 32
9534            3.13  Using Multiple spool mailboxes   ................................. 33
9535            3.14  Defining mailboxes which receive mail   .......................... 34
9536            3.15  User defined headers   ........................................... 34
9537            3.16  Defining the order of headers when viewing messages   ............ 35
9538            3.17  Specify default save filename   .................................. 35
9539            3.18  Specify default Fcc: mailbox when composing   .................... 36
9540            3.19  Specify default save filename and default Fcc: mailbox at once   . 36
9541            3.20  Change settings based upon message recipients   .................. 36
9542            3.21  Change settings before formatting a message   .................... 37
9543            3.22  Choosing the cryptographic key of the recipient   ................ 37
9544            3.23  Adding key sequences to the keyboard buffer   .................... 38
9545            3.24  Executing functions   ............................................ 38
9546            3.25  Message Scoring   ................................................ 38
9547            3.26  Spam detection   ................................................. 39
9548            3.27  Setting variables   .............................................. 41
9549            3.28  Reading initialization commands from another file   .............. 42
9550            3.29  Removing hooks   ................................................. 42
9551            3.30  Sharing Setups       ............................................. 43
9552                  3.30.1   Character Sets         43
9553                  3.30.2   Modularization           43
9554                  3.30.3   Conditional parts         43
9555            3.31  Obsolete Variables   ............................................. 45
9556
9557        4.  Advanced Usage   ....................................................... 45
9558            4.1   Regular Expressions   ............................................ 45
9559            4.2   Patterns   ....................................................... 48
9560                  4.2.1    Complex Patterns    49
9561                  4.2.2    Patterns and Dates    49
9562            4.3   Format Strings       ............................................. 50
9563                  4.3.1    Introduction           50
9564                  4.3.2    Conditional Expansion           51
9565                  4.3.3    Modifications and Padding           52
9566            4.4   Using Tags   ..................................................... 53
9567            4.5   Using Hooks   .................................................... 53
9568                  4.5.1    Message Matching in Hooks   54
9569            4.6   Using the sidebar   .............................................. 54
9570            4.7   External Address Queries   ....................................... 55
9571            4.8   Mailbox Formats   ................................................ 56
9572            4.9   Mailbox Shortcuts   .............................................. 57
9573            4.10  Handling Mailing Lists   ......................................... 57
9574            4.11  Editing threads   ................................................ 59
9575                  4.11.1   Linking threads   59
9576                  4.11.2   Breaking threads   59
9577            4.12  Delivery Status Notification (DSN) Support   ..................... 59
9578            4.13  POP3 Support (OPTIONAL)   ........................................ 60
9579            4.14  IMAP Support (OPTIONAL)   ........................................ 60
9580
9581                                               ii
9582
9583                  4.14.1   The Folder Browser   61
9584                  4.14.2   Authentication   62
9585            4.15  NNTP Support (OPTIONAL)   ........................................ 62
9586                  4.15.1   Again: Scoring       63
9587            4.16  SMTP Support (OPTIONAL)   ........................................ 63
9588            4.17  Managing multiple IMAP/POP/NNTP accounts (OPTIONAL)   ............ 64
9589            4.18  Start a WWW Browser on URLs (EXTERNAL)   ......................... 64
9590            4.19  Compressed folders Support (OPTIONAL)   .......................... 65
9591                  4.19.1   Open a compressed mailbox for reading   65
9592                  4.19.2   Write a compressed mailbox   66
9593                  4.19.3   Append a message to a compressed mailbox   66
9594                  4.19.4   Encrypted folders   67
9595
9596        5.  Mutt-ng's MIME Support   ............................................... 67
9597            5.1   Using MIME in Mutt   ............................................. 67
9598                  5.1.1    Viewing MIME messages in the pager   68
9599                  5.1.2    The Attachment Menu   68
9600                  5.1.3    The Compose Menu   68
9601            5.2   MIME Type configuration with mime.types   ........................ 69
9602            5.3   MIME Viewer configuration with mailcap   ......................... 69
9603                  5.3.1    The Basics of the mailcap file   70
9604                  5.3.2    Secure use of mailcap   71
9605                  5.3.3    Advanced mailcap Usage   72
9606                  5.3.4    Example mailcap files   74
9607            5.4   MIME Autoview   .................................................. 75
9608            5.5   MIME Multipart/Alternative   ..................................... 76
9609            5.6   MIME Lookup   .................................................... 76
9610
9611        6.  Security Considerations     ............................................ 77
9612            6.1   Passwords       .................................................. 77
9613            6.2   Temporary Files       ............................................ 77
9614            6.3   Information Leaks     ............................................ 78
9615                  6.3.1    Message-ID: headers         78
9616                  6.3.2    mailto:-style links         78
9617            6.4   External applications       ...................................... 78
9618                  6.4.1    mailcap           78
9619                  6.4.2    Other           79
9620
9621        7.  Reference   ............................................................ 79
9622            7.1   Command line options   ........................................... 79
9623            7.2   Patterns   ....................................................... 80
9624            7.3   Configuration Commands   ......................................... 82
9625            7.4   Configuration variables   ........................................ 84
9626                  7.4.1    abort_nosubject   85
9627                  7.4.2    abort_unmodified   86
9628                  7.4.3    alias_file   86
9629                  7.4.4    alias_format   86
9630                  7.4.5    allow_8bit   86
9631                  7.4.6    allow_ansi   87
9632                  7.4.7    arrow_cursor   87
9633                  7.4.8    ascii_chars   87
9634                  7.4.9    askbcc   87
9635                  7.4.10   askcc   87
9636
9637                                              iii
9638
9639                  7.4.11   assumed_charset   88
9640                  7.4.12   attach_format   88
9641                  7.4.13   attach_sep   89
9642                  7.4.14   attach_split   89
9643                  7.4.15   attribution   89
9644                  7.4.16   auto_tag   90
9645                  7.4.17   autoedit   90
9646                  7.4.18   beep   90
9647                  7.4.19   beep_new   90
9648                  7.4.20   bounce   90
9649                  7.4.21   bounce_delivered   91
9650                  7.4.22   braille_friendly   91
9651                  7.4.23   certificate_file   91
9652                  7.4.24   charset   91
9653                  7.4.25   check_new   91
9654                  7.4.26   collapse_unread   92
9655                  7.4.27   compose_format   92
9656                  7.4.28   config_charset   92
9657                  7.4.29   confirmappend   92
9658                  7.4.30   confirmcreate   93
9659                  7.4.31   connect_timeout   93
9660                  7.4.32   content_type   93
9661                  7.4.33   copy   93
9662                  7.4.34   crypt_autoencrypt   93
9663                  7.4.35   crypt_autopgp   94
9664                  7.4.36   crypt_autosign   94
9665                  7.4.37   crypt_autosmime   94
9666                  7.4.38   crypt_replyencrypt   94
9667                  7.4.39   crypt_replysign   94
9668                  7.4.40   crypt_replysignencrypted   95
9669                  7.4.41   crypt_timestamp   95
9670                  7.4.42   crypt_use_gpgme   95
9671                  7.4.43   crypt_verify_sig   95
9672                  7.4.44   date_format   96
9673                  7.4.45   default_hook   96
9674                  7.4.46   delete   96
9675                  7.4.47   delete_untag   96
9676                  7.4.48   digest_collapse   96
9677                  7.4.49   display_filter   97
9678                  7.4.50   dotlock_program   97
9679                  7.4.51   dsn_notify   97
9680                  7.4.52   dsn_return   97
9681                  7.4.53   duplicate_threads   98
9682                  7.4.54   edit_headers   98
9683                  7.4.55   editor   98
9684                  7.4.56   encode_from   98
9685                  7.4.57   entropy_file   98
9686                  7.4.58   envelope_from   99
9687                  7.4.59   escape   99
9688                  7.4.60   fast_reply   99
9689                  7.4.61   fcc_attach   99
9690                  7.4.62   fcc_clear   99
9691                  7.4.63   file_charset   100
9692
9693                                               iv
9694
9695                  7.4.64   folder   100
9696                  7.4.65   folder_format   100
9697                  7.4.66   followup_to   101
9698                  7.4.67   force_buffy_check   101
9699                  7.4.68   force_name   102
9700                  7.4.69   forward_decode   102
9701                  7.4.70   forward_decrypt   102
9702                  7.4.71   forward_edit   102
9703                  7.4.72   forward_format   102
9704                  7.4.73   forward_quote   103
9705                  7.4.74   from   103
9706                  7.4.75   gecos_mask   103
9707                  7.4.76   hdrs   103
9708                  7.4.77   header   104
9709                  7.4.78   header_cache   104
9710                  7.4.79   header_cache_compress   104
9711                  7.4.80   help   104
9712                  7.4.81   hidden_host   105
9713                  7.4.82   hide_limited   105
9714                  7.4.83   hide_missing   105
9715                  7.4.84   hide_thread_subject   105
9716                  7.4.85   hide_top_limited   105
9717                  7.4.86   hide_top_missing   105
9718                  7.4.87   history   106
9719                  7.4.88   honor_followup_to   106
9720                  7.4.89   hostname   106
9721                  7.4.90   ignore_list_reply_to   106
9722                  7.4.91   imap_authenticators   106
9723                  7.4.92   imap_check_subscribed   107
9724                  7.4.93   imap_delim_chars   107
9725                  7.4.94   imap_headers   107
9726                  7.4.95   imap_home_namespace   108
9727                  7.4.96   imap_keepalive   108
9728                  7.4.97   imap_list_subscribed   108
9729                  7.4.98   imap_login   108
9730                  7.4.99   imap_mail_check   109
9731                  7.4.100  imap_pass   109
9732                  7.4.101  imap_passive   109
9733                  7.4.102  imap_peek   109
9734                  7.4.103  imap_reconnect   110
9735                  7.4.104  imap_servernoise   110
9736                  7.4.105  imap_user   110
9737                  7.4.106  implicit_autoview   110
9738                  7.4.107  include   110
9739                  7.4.108  include_onlyfirst   111
9740                  7.4.109  indent_string   111
9741                  7.4.110  index_format   111
9742                  7.4.111  ispell   114
9743                  7.4.112  keep_flagged   114
9744                  7.4.113  list_reply   114
9745                  7.4.114  locale   114
9746                  7.4.115  mail_check   114
9747                  7.4.116  mailcap_path   115
9748
9749                                               v
9750
9751                  7.4.117  mailcap_sanitize   115
9752                  7.4.118  maildir_header_cache_verify   115
9753                  7.4.119  maildir_trash   115
9754                  7.4.120  mark_old   115
9755                  7.4.121  markers   116
9756                  7.4.122  mask   116
9757                  7.4.123  max_display_recips   116
9758                  7.4.124  max_line_length   116
9759                  7.4.125  mbox   116
9760                  7.4.126  mbox_type   117
9761                  7.4.127  menu_context   117
9762                  7.4.128  menu_move_off   117
9763                  7.4.129  menu_scroll   117
9764                  7.4.130  message_format   117
9765                  7.4.131  meta_key   118
9766                  7.4.132  metoo   118
9767                  7.4.133  mh_purge   118
9768                  7.4.134  mh_seq_flagged   118
9769                  7.4.135  mh_seq_replied   118
9770                  7.4.136  mh_seq_unseen   118
9771                  7.4.137  mime_forward   119
9772                  7.4.138  mime_forward_decode   119
9773                  7.4.139  mime_forward_rest   119
9774                  7.4.140  mix_entry_format   119
9775                  7.4.141  mixmaster   120
9776                  7.4.142  move   120
9777                  7.4.143  msgid_format   120
9778                  7.4.144  narrow_tree   121
9779                  7.4.145  nntp_ask_followup_to   121
9780                  7.4.146  nntp_ask_x_comment_to   121
9781                  7.4.147  nntp_cache_dir   122
9782                  7.4.148  nntp_catchup   122
9783                  7.4.149  nntp_context   122
9784                  7.4.150  nntp_followup_to_poster   122
9785                  7.4.151  nntp_group_index_format   123
9786                  7.4.152  nntp_host   123
9787                  7.4.153  nntp_inews   123
9788                  7.4.154  nntp_load_description   124
9789                  7.4.155  nntp_mail_check   124
9790                  7.4.156  nntp_mime_subject   124
9791                  7.4.157  nntp_newsrc   124
9792                  7.4.158  nntp_pass   125
9793                  7.4.159  nntp_post_moderated   125
9794                  7.4.160  nntp_reconnect   125
9795                  7.4.161  nntp_save_unsubscribed   126
9796                  7.4.162  nntp_show_new_news   126
9797                  7.4.163  nntp_show_only_unread   126
9798                  7.4.164  nntp_user   126
9799                  7.4.165  nntp_x_comment_to   126
9800                  7.4.166  operating_system   127
9801                  7.4.167  pager   127
9802                  7.4.168  pager_context   127
9803                  7.4.169  pager_format   127
9804
9805                                               vi
9806
9807                  7.4.170  pager_index_lines   127
9808                  7.4.171  pager_stop   128
9809                  7.4.172  pgp_auto_decode   128
9810                  7.4.173  pgp_autoinline   128
9811                  7.4.174  pgp_check_exit   129
9812                  7.4.175  pgp_clearsign_command   129
9813                  7.4.176  pgp_decode_command   129
9814                  7.4.177  pgp_decrypt_command   129
9815                  7.4.178  pgp_encrypt_only_command   130
9816                  7.4.179  pgp_encrypt_sign_command   130
9817                  7.4.180  pgp_entry_format   130
9818                  7.4.181  pgp_export_command   131
9819                  7.4.182  pgp_getkeys_command   131
9820                  7.4.183  pgp_good_sign   131
9821                  7.4.184  pgp_ignore_subkeys   131
9822                  7.4.185  pgp_import_command   131
9823                  7.4.186  pgp_list_pubring_command   132
9824                  7.4.187  pgp_list_secring_command   132
9825                  7.4.188  pgp_long_ids   132
9826                  7.4.189  pgp_mime_auto   132
9827                  7.4.190  pgp_replyinline   132
9828                  7.4.191  pgp_retainable_sigs   133
9829                  7.4.192  pgp_show_unusable   133
9830                  7.4.193  pgp_sign_as   133
9831                  7.4.194  pgp_sign_command   133
9832                  7.4.195  pgp_sort_keys   134
9833                  7.4.196  pgp_strict_enc   134
9834                  7.4.197  pgp_timeout   134
9835                  7.4.198  pgp_use_gpg_agent   134
9836                  7.4.199  pgp_verify_command   135
9837                  7.4.200  pgp_verify_key_command   135
9838                  7.4.201  pipe_decode   135
9839                  7.4.202  pipe_sep   135
9840                  7.4.203  pipe_split   135
9841                  7.4.204  pop_auth_try_all   135
9842                  7.4.205  pop_authenticators   136
9843                  7.4.206  pop_delete   136
9844                  7.4.207  pop_host   136
9845                  7.4.208  pop_last   137
9846                  7.4.209  pop_mail_check   137
9847                  7.4.210  pop_pass   137
9848                  7.4.211  pop_reconnect   137
9849                  7.4.212  pop_user   137
9850                  7.4.213  post_indent_string   138
9851                  7.4.214  postpone   138
9852                  7.4.215  postponed   138
9853                  7.4.216  preconnect   138
9854                  7.4.217  print   139
9855                  7.4.218  print_command   139
9856                  7.4.219  print_decode   139
9857                  7.4.220  print_split   139
9858                  7.4.221  prompt_after   139
9859                  7.4.222  query_command   140
9860
9861                                              vii
9862
9863                  7.4.223  quit   140
9864                  7.4.224  quote_empty   140
9865                  7.4.225  quote_quoted   140
9866                  7.4.226  quote_regexp   140
9867                  7.4.227  read_inc   141
9868                  7.4.228  read_only   141
9869                  7.4.229  realname   141
9870                  7.4.230  recall   141
9871                  7.4.231  record   141
9872                  7.4.232  reply_regexp   142
9873                  7.4.233  reply_self   142
9874                  7.4.234  reply_to   142
9875                  7.4.235  resolve   142
9876                  7.4.236  reverse_alias   143
9877                  7.4.237  reverse_name   143
9878                  7.4.238  reverse_realname   143
9879                  7.4.239  rfc2047_parameters   143
9880                  7.4.240  save_address   144
9881                  7.4.241  save_empty   144
9882                  7.4.242  save_name   144
9883                  7.4.243  score   145
9884                  7.4.244  score_threshold_delete   145
9885                  7.4.245  score_threshold_flag   145
9886                  7.4.246  score_threshold_read   145
9887                  7.4.247  send_charset   145
9888                  7.4.248  sendmail   146
9889                  7.4.249  sendmail_wait   146
9890                  7.4.250  shell   146
9891                  7.4.251  sidebar_boundary   146
9892                  7.4.252  sidebar_delim   147
9893                  7.4.253  sidebar_newmail_only   147
9894                  7.4.254  sidebar_number_format   147
9895                  7.4.255  sidebar_shorten_hierarchy   148
9896                  7.4.256  sidebar_visible   148
9897                  7.4.257  sidebar_width   148
9898                  7.4.258  sig_dashes   148
9899                  7.4.259  sig_on_top   148
9900                  7.4.260  signature   149
9901                  7.4.261  simple_search   149
9902                  7.4.262  sleep_time   149
9903                  7.4.263  smart_wrap   149
9904                  7.4.264  smileys   150
9905                  7.4.265  smime_ask_cert_label   150
9906                  7.4.266  smime_ca_location   150
9907                  7.4.267  smime_certificates   150
9908                  7.4.268  smime_decrypt_command   150
9909                  7.4.269  smime_decrypt_use_default_key   151
9910                  7.4.270  smime_default_key   151
9911                  7.4.271  smime_encrypt_command   151
9912                  7.4.272  smime_encrypt_with   152
9913                  7.4.273  smime_get_cert_command   152
9914                  7.4.274  smime_get_cert_email_command   152
9915                  7.4.275  smime_get_signer_cert_command   152
9916
9917                                              viii
9918
9919                  7.4.276  smime_import_cert_command   152
9920                  7.4.277  smime_is_default   152
9921                  7.4.278  smime_keys   153
9922                  7.4.279  smime_pk7out_command   153
9923                  7.4.280  smime_sign_command   153
9924                  7.4.281  smime_sign_opaque_command   153
9925                  7.4.282  smime_timeout   153
9926                  7.4.283  smime_verify_command   154
9927                  7.4.284  smime_verify_opaque_command   154
9928                  7.4.285  smtp_envelope   154
9929                  7.4.286  smtp_host   154
9930                  7.4.287  smtp_pass   154
9931                  7.4.288  smtp_port   155
9932                  7.4.289  smtp_use_tls   155
9933                  7.4.290  smtp_user   155
9934                  7.4.291  sort   155
9935                  7.4.292  sort_alias   156
9936                  7.4.293  sort_aux   156
9937                  7.4.294  sort_browser   157
9938                  7.4.295  sort_re   157
9939                  7.4.296  spam_separator   157
9940                  7.4.297  spoolfile   157
9941                  7.4.298  ssl_ca_certificates_file   158
9942                  7.4.299  ssl_client_cert   158
9943                  7.4.300  ssl_force_tls   158
9944                  7.4.301  ssl_min_dh_prime_bits   158
9945                  7.4.302  ssl_starttls   159
9946                  7.4.303  ssl_use_sslv2   159
9947                  7.4.304  ssl_use_sslv3   159
9948                  7.4.305  ssl_use_tlsv1   159
9949                  7.4.306  ssl_usesystemcerts   159
9950                  7.4.307  status_chars   160
9951                  7.4.308  status_format   160
9952                  7.4.309  status_on_top   162
9953                  7.4.310  strict_mailto   162
9954                  7.4.311  strict_mime   163
9955                  7.4.312  strict_threads   163
9956                  7.4.313  strip_was   163
9957                  7.4.314  strip_was_regex   163
9958                  7.4.315  stuff_quoted   163
9959                  7.4.316  suspend   164
9960                  7.4.317  text_flowed   164
9961                  7.4.318  thorough_search   164
9962                  7.4.319  thread_received   164
9963                  7.4.320  tilde   164
9964                  7.4.321  timeout   165
9965                  7.4.322  tmpdir   165
9966                  7.4.323  to_chars   165
9967                  7.4.324  trash   165
9968                  7.4.325  tunnel   165
9969                  7.4.326  umask   166
9970                  7.4.327  uncollapse_jump   166
9971                  7.4.328  use_8bitmime   166
9972
9973                                               ix
9974
9975                  7.4.329  use_domain   166
9976                  7.4.330  use_from   167
9977                  7.4.331  use_idn   167
9978                  7.4.332  use_ipv6   167
9979                  7.4.333  user_agent   167
9980                  7.4.334  visual   167
9981                  7.4.335  wait_key   167
9982                  7.4.336  weed   168
9983                  7.4.337  wrap_search   168
9984                  7.4.338  wrapmargin   168
9985                  7.4.339  write_bcc   168
9986                  7.4.340  write_inc   168
9987                  7.4.341  xterm_icon   169
9988                  7.4.342  xterm_leave   169
9989                  7.4.343  xterm_set_titles   169
9990                  7.4.344  xterm_title   169
9991            7.5   Functions ....................................................... 170
9992                  7.5.1    generic   170
9993                  7.5.2    index   170
9994                  7.5.3    pager   172
9995                  7.5.4    alias   174
9996                  7.5.5    query   174
9997                  7.5.6    attach   174
9998                  7.5.7    compose   175
9999                  7.5.8    postpone   176
10000                  7.5.9    browser   176
10001                  7.5.10   pgp   177
10002                  7.5.11   editor   177
10003
10004        8.  Miscellany ............................................................ 177
10005            8.1   Acknowledgments ................................................. 178
10006            8.2   About this document ............................................. 180
10007
10008                                               x
10009