21cbd6ff891cd354873cafe7ef2e1064c66faf3c
[apps/madmutt.git] / doc / manual.txt
1
2                                   T\bTh\bhe\be M\bMu\but\btt\bt-\b-n\bng\bg E\bE-\b-M\bMa\bai\bil\bl C\bCl\bli\bie\ben\bnt\bt
3
4                         by Michael Elkins <me@cs.hmc.edu> and others.
5
6                                      version devel-r371
7
8                                           A\bAb\bbs\bst\btr\bra\bac\bct\bt
9
10             ``All mail clients suck.  This one just sucks less.'' -me, circa 1995
11
12        _\b1_\b.  _\bI_\bn_\bt_\br_\bo_\bd_\bu_\bc_\bt_\bi_\bo_\bn
13
14        M\bMu\but\btt\bt-\b-n\bng\bg is a small but very powerful text-based MIME mail client.  Mutt-ng is
15        highly configurable, and is well suited to the mail power user with advanced
16        features like key bindings, keyboard macros, mail threading, regular expression
17        searches and a powerful pattern matching language for selecting groups of mes-
18        sages.
19
20        This documentation additionally contains documentation to M\bMu\but\btt\bt-\b-N\bNG\bG, a fork from
21        Mutt with the goal to fix all the little annoyances of Mutt, to integrate all
22        the Mutt patches that are floating around in the web, and to add other new fea-
23        tures. Features specific to Mutt-ng will be discussed in an extra section.
24        Don't be confused when most of the documentation talk about Mutt and not Mutt-
25        ng, Mutt-ng contains all Mutt features, plus many more.
26
27        _\b1_\b._\b1  _\bM_\bu_\bt_\bt_\b-_\bn_\bg _\bH_\bo_\bm_\be _\bP_\ba_\bg_\be
28
29        http://www.muttng.org
30
31        _\b1_\b._\b2  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
32
33           +\bo mutt-ng-users@lists.berlios.de -- This is where the mutt-ng user support
34             happens.
35
36           +\bo mutt-ng-devel@lists.berlios.de -- The development mailing list for mutt-ng
37
38        _\b1_\b._\b3  _\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
39
40        So far, there are no official releases of Mutt-ng, but you can download daily
41        snapshots from http://mutt-ng.berlios.de/snapshots/
42
43        The Mutt-ng E-Mail Client                                                     1
44
45        The Mutt-ng E-Mail Client                                                     2
46
47        _\b1_\b._\b4  _\bI_\bR_\bC
48
49        Visit channel _\b#_\bm_\bu_\bt_\bt_\bn_\bg on irc.freenode.net (www.freenode.net) to chat with other
50        people interested in Mutt-ng.
51
52        _\b1_\b._\b5  _\bW_\be_\bb_\bl_\bo_\bg
53
54        If you want to read fresh news about the latest development in Mutt-ng, and get
55        informed about stuff like interesting, Mutt-ng-related articles and packages
56        for your favorite distribution, you can read and/or subscribe to our Mutt-ng
57        development weblog.
58
59        _\b1_\b._\b6  _\bC_\bo_\bp_\by_\br_\bi_\bg_\bh_\bt
60
61        Mutt is Copyright (C) 1996-2000 Michael R. Elkins <me@cs.hmc.edu> and others
62
63        This program is free software; you can redistribute it and/or modify it under
64        the terms of the GNU General Public License as published by the Free Software
65        Foundation; either version 2 of the License, or (at your option) any later ver-
66        sion.
67
68        This program is distributed in the hope that it will be useful, but WITHOUT ANY
69        WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
70        PARTICULAR PURPOSE.  See the GNU General Public License for more details.
71
72        You should have received a copy of the GNU General Public License along with
73        this program; if not, write to the Free Software Foundation, Inc., 59 Temple
74        Place - Suite 330, Boston, MA  02111, USA.
75
76        _\b2_\b.  _\bG_\be_\bt_\bt_\bi_\bn_\bg _\bS_\bt_\ba_\br_\bt_\be_\bd
77
78        This section is intended as a brief overview of how to use Mutt-ng.  There are
79        many other features which are described elsewhere in the manual.  <-- There is
80        even more information available in the Mutt FAQ and various web pages.  See the
81        Mutt Page for more details.  -->
82
83        The key bindings described in this section are the defaults as distributed.
84        Your local system administrator may have altered the defaults for your site.
85        You can always type ``?'' in any menu to display the current bindings.
86
87        The first thing you need to do is invoke mutt-ng simply by typing muttng at the
88        command line.  There are various command-line options, see either the muttng
89        man page or the _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 6.1  , page 62).
90
91        If you have used mutt in the past the easiest thing to have a proper configura-
92        tion file is to source  /.muttrc in  /.muttngrc.
93
94        _\b2_\b._\b1  _\bM_\bo_\bv_\bi_\bn_\bg _\bA_\br_\bo_\bu_\bn_\bd _\bi_\bn _\bM_\be_\bn_\bu_\bs
95
96        Information is presented in menus, very similar to ELM.  Here is a table show-
97        ing the common keys used to navigate menus in Mutt-ng.
98
99        The Mutt-ng E-Mail Client                                                     3
100
101             j or Down       next-entry      move to the next entry
102             k or Up         previous-entry  move to the previous entry
103             z or PageDn     page-down       go to the next page
104             Z or PageUp     page-up         go to the previous page
105             = or Home       first-entry     jump to the first entry
106             * or End        last-entry      jump to the last entry
107             q               quit            exit the current menu
108             ?               help            list all key bindings for the current menu
109
110        _\b2_\b._\b2  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bI_\bn_\bp_\bu_\bt _\bF_\bi_\be_\bl_\bd_\bs
111
112        Mutt-ng has a builtin line editor which is used as the primary way to input
113        textual data such as email addresses or filenames.  The keys used to move
114        around while editing are very similar to those of Emacs.
115
116             ^A or <Home>    bol             move to the start of the line
117             ^B or <Left>    backward-char   move back one char
118             Esc B          backward-word  move back one word
119             ^D or <Delete>  delete-char     delete the char under the cursor
120             ^E or <End>     eol             move to the end of the line
121             ^F or <Right>   forward-char    move forward one char
122             Esc F          forward-word   move forward one word
123             <Tab>           complete        complete filename or alias
124             ^T              complete-query  complete address with query
125             ^K              kill-eol        delete to the end of the line
126             ESC d          kill-eow  delete to the end of the word
127             ^W              kill-word       kill the word in front of the cursor
128             ^U              kill-line       delete entire line
129             ^V              quote-char      quote the next typed key
130             <Up>            history-up      recall previous string from history
131             <Down>          history-down    recall next string from history
132             <BackSpace>     backspace       kill the char in front of the cursor
133             Esc u          upcase-word    convert word to upper case
134             Esc l          downcase-word  convert word to lower case
135             Esc c          capitalize-word capitalize the word
136             ^G              n/a             abort
137             <Return>        n/a             finish editing
138
139        You can remap the _\be_\bd_\bi_\bt_\bo_\br functions using the _\bb_\bi_\bn_\bd (section 3.3  , page 17) com-
140        mand.  For example, to make the _\bD_\be_\bl_\be_\bt_\be key delete the character in front of the
141        cursor rather than under, you could use
142
143        bind editor <delete> backspace
144
145        _\b2_\b._\b3  _\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
146
147        Similar to many other mail clients, there are two modes in which mail is read
148        in Mutt-ng.  The first is the index of messages in the mailbox, which is called
149        the ``index'' in Mutt-ng.  The second mode is the display of the message con-
150        tents.  This is called the ``pager.''
151
152        The Mutt-ng E-Mail Client                                                     4
153
154        The next few sections describe the functions provided in each of these modes.
155
156        _\b2_\b._\b3_\b._\b1  _\bT_\bh_\be _\bM_\be_\bs_\bs_\ba_\bg_\be _\bI_\bn_\bd_\be_\bx
157
158             c               change to a different mailbox
159             ESC c           change to a folder in read-only mode
160             C               copy the current message to another mailbox
161             ESC C           decode a message and copy it to a folder
162             ESC s           decode a message and save it to a folder
163             D               delete messages matching a pattern
164             d               delete the current message
165             F               mark as important
166             l               show messages matching a pattern
167             N               mark message as new
168             o               change the current sort method
169             O               reverse sort the mailbox
170             q               save changes and exit
171             s               save-message
172             T               tag messages matching a pattern
173             t               toggle the tag on a message
174             ESC t           toggle tag on entire message thread
175             U               undelete messages matching a pattern
176             u               undelete-message
177             v               view-attachments
178             x               abort changes and exit
179             <Return>        display-message
180             <Tab>           jump to the next new message
181             @               show the author's full e-mail address
182             $               save changes to mailbox
183             /               search
184             ESC /           search-reverse
185             ^L              clear and redraw the screen
186             ^T              untag messages matching a pattern
187
188        _\b2_\b._\b3_\b._\b1_\b._\b1  _\bS_\bt_\ba_\bt_\bu_\bs _\bF_\bl_\ba_\bg_\bs
189
190        In addition to who sent the message and the subject, a short summary of the
191        disposition of each message is printed beside the message number.  Zero or more
192        of the following ``flags'' may appear, which mean:
193
194              D
195                    message is deleted (is marked for deletion)
196
197              d
198                    message have attachments marked for deletion
199
200              K
201                    contains a PGP public key
202
203              N
204                    message is new
205
206        The Mutt-ng E-Mail Client                                                     5
207
208              O
209                    message is old
210
211              P
212                    message is PGP encrypted
213
214              r
215                    message has been replied to
216
217              S
218                    message is signed, and the signature is succesfully verified
219
220              s
221                    message is signed
222
223              !
224                    message is flagged
225
226              *
227                    message is tagged
228
229        Some of the status flags can be turned on or off using
230
231           +\bo s\bse\bet\bt-\b-f\bfl\bla\bag\bg (default: w)
232
233           +\bo c\bcl\ble\bea\bar\br-\b-f\bfl\bla\bag\bg (default: W)
234
235        Furthermore, the following flags reflect who the message is addressed to.  They
236        can be customized with the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 6.3.320  , page 143) variable.
237
238              +
239                    message is to you and you only
240
241              T
242                    message is to you, but also to or cc'ed to others
243
244              C
245                    message is cc'ed to you
246
247              F
248                    message is from you
249
250              L
251                    message is sent to a subscribed mailing list
252
253        _\b2_\b._\b3_\b._\b2  _\bT_\bh_\be _\bP_\ba_\bg_\be_\br
254
255        By default, Mutt-ng uses its builtin pager to display the body of messages.
256        The pager is very similar to the Unix program _\bl_\be_\bs_\bs though not nearly as fea-
257        tureful.
258
259        The Mutt-ng E-Mail Client                                                     6
260
261             <Return>        go down one line
262             <Space>         display the next page (or next message if at the end of a message)
263             -               go back to the previous page
264             n               search for next match
265             S               skip beyond quoted text
266             T               toggle display of quoted text
267             ?               show key bindings
268             /               search for a regular expression (pattern)
269             ESC /           search backwards for a regular expression
270             \               toggle search pattern coloring
271             ^               jump to the top of the message
272
273        In addition, many of the functions from the _\bi_\bn_\bd_\be_\bx are available in the pager,
274        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
275        external pager to view messages).
276
277        Also, the internal pager supports a couple other advanced features. For one, it
278        will accept and translate the ``standard'' nroff sequences for bold and under-
279        line. These sequences are a series of either the letter, backspace (^H), the
280        letter again for bold or the letter, backspace, ``_'' for denoting underline.
281        Mutt-ng will attempt to display these in bold and underline respectively if
282        your terminal supports them. If not, you can use the bold and underline _\bc_\bo_\bl_\bo_\br
283        (section 3.7  , page 21) objects to specify a color or mono attribute for them.
284
285        Additionally, the internal pager supports the ANSI escape sequences for charac-
286        ter attributes.  Mutt-ng translates them into the correct color and character
287        settings.  The sequences Mutt-ng supports are:
288
289             ESC [ Ps;Ps;Ps;...;Ps m
290             where Ps =
291             0    All Attributes Off
292             1    Bold on
293             4    Underline on
294             5    Blink on
295             7    Reverse video on
296             3x   Foreground color is x
297             4x   Background color is x
298
299             Colors are
300             0    black
301             1    red
302             2    green
303             3    yellow
304             4    blue
305             5    magenta
306             6    cyan
307             7    white
308
309        Mutt-ng uses these attributes for handling text/enriched messages, and they can
310        also be used by an external _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 60) script for high-
311        lighting purposes.  N\bNo\bot\bte\be:\b: If you change the colors for your display, for
312
313        The Mutt-ng E-Mail Client                                                     7
314
315        example by changing the color associated with color2 for your xterm, then that
316        color will be used instead of green.
317
318        _\b2_\b._\b3_\b._\b3  _\bT_\bh_\br_\be_\ba_\bd_\be_\bd _\bM_\bo_\bd_\be
319
320        When the mailbox is _\bs_\bo_\br_\bt_\be_\bd (section 6.3.289  , page 134) by _\bt_\bh_\br_\be_\ba_\bd_\bs, there are
321        a few additional functions available in the _\bi_\bn_\bd_\be_\bx and _\bp_\ba_\bg_\be_\br modes.
322
323             ^D      delete-thread           delete all messages in the current thread
324             ^U      undelete-thread         undelete all messages in the current thread
325             ^N      next-thread             jump to the start of the next thread
326             ^P      previous-thread         jump to the start of the previous thread
327             ^R      read-thread             mark the current thread as read
328             ESC d   delete-subthread        delete all messages in the current subthread
329             ESC u   undelete-subthread      undelete all messages in the current subthread
330             ESC n   next-subthread          jump to the start of the next subthread
331             ESC p   previous-subthread      jump to the start of the previous subthread
332             ESC r   read-subthread          mark the current subthread as read
333             ESC t   tag-thread              toggle the tag on the current thread
334             ESC v     collapse-thread          toggle collapse for the current thread
335             ESC V     collapse-all        toggle collapse for all threads
336             P       parent-message          jump to parent message in thread
337
338        N\bNo\bot\bte\be:\b: Collapsing a thread displays only the first message in the thread and
339        hides the others. This is useful when threads contain so many messages that you
340        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-
341        tion 6.3.110  , page 90).  For example, you could use "%?M?(#%03M)&(%4l)?" in
342        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90) to optionally display the number of
343        hidden messages if the thread is collapsed.
344
345        See also: _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs (section 6.3.309  , page 141).
346
347        _\b2_\b._\b3_\b._\b4  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\be_\bo_\bu_\bs _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
348
349        c\bcr\bre\bea\bat\bte\be-\b-a\bal\bli\bia\bas\bs
350         (default: a)
351
352        Creates a new alias based upon the current message (or prompts for a new one).
353        Once editing is complete, an _\ba_\bl_\bi_\ba_\bs (section 3.2  , page 16) command is added to
354        the file specified by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 6.3.3  , page 65) variable for
355        future use. N\bNo\bot\bte\be:\b: Specifying an _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 6.3.3  , page 65) does not
356        add the aliases specified there-in, you must also _\bs_\bo_\bu_\br_\bc_\be (section 3.26  , page
357        32) the file.
358
359        c\bch\bhe\bec\bck\bk-\b-t\btr\bra\bad\bdi\bit\bti\bio\bon\bna\bal\bl-\b-p\bpg\bgp\bp
360         (default: ESC P)
361
362        This function will search the current message for content signed or encrypted
363        with PGP the "traditional" way, that is, without proper MIME tagging.  Techni-
364        cally, this function will temporarily change the MIME content types of the body
365        parts containing PGP data; this is similar to the _\be_\bd_\bi_\bt_\b-_\bt_\by_\bp_\be (section 2.3.4  ,
366        page 8) function's effect.
367
368        The Mutt-ng E-Mail Client                                                     8
369
370        d\bdi\bis\bsp\bpl\bla\bay\by-\b-t\bto\bog\bgg\bgl\ble\be-\b-w\bwe\bee\bed\bd
371         (default: h)
372
373        Toggles the weeding of message header fields specified by _\bi_\bg_\bn_\bo_\br_\be (section
374        3.8  , page 23) commands.
375
376        e\bed\bdi\bit\bt
377         (default: e)
378
379        This command (available in the ``index'' and ``pager'') allows you to edit the
380        raw current message as it's present in the mail folder.  After you have fin-
381        ished editing, the changed message will be appended to the current folder, and
382        the original message will be marked for deletion.
383
384        e\bed\bdi\bit\bt-\b-t\bty\byp\bpe\be
385
386        (default: ^E on the attachment menu, and in the pager and index menus; ^T on
387        the compose menu)
388
389        This command is used to temporarily edit an attachment's content type to fix,
390        for instance, bogus character set parameters.  When invoked from the index or
391        from the pager, you'll have the opportunity to edit the top-level attachment's
392        content type.  On the _\ba_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bm_\be_\bn_\bu (section 5.1.2  , page 53), you can
393        change any attachment's content type. These changes are not persistent, and get
394        lost upon changing folders.
395
396        Note that this command is also available on the _\bc_\bo_\bm_\bp_\bo_\bs_\be _\bm_\be_\bn_\bu (section 5.1.3  ,
397        page 53).  There, it's used to fine-tune the properties of attachments you are
398        going to send.
399
400        e\ben\bnt\bte\ber\br-\b-c\bco\bom\bmm\bma\ban\bnd\bd
401         (default: ``:'')
402
403        This command is used to execute any command you would normally put in a config-
404        uration file.  A common use is to check the settings of variables, or in con-
405        junction with _\bm_\ba_\bc_\br_\bo_\bs (section 3.6  , page 20) to change settings on the fly.
406
407        e\bex\bxt\btr\bra\bac\bct\bt-\b-k\bke\bey\bys\bs
408         (default: ^K)
409
410        This command extracts PGP public keys from the current or tagged message(s) and
411        adds them to your PGP public key ring.
412
413        f\bfo\bor\brg\bge\bet\bt-\b-p\bpa\bas\bss\bsp\bph\bhr\bra\bas\bse\be
414         (default: ^F)
415
416        This command wipes the passphrase(s) from memory. It is useful, if you mis-
417        spelled the passphrase.
418
419        l\bli\bis\bst\bt-\b-r\bre\bep\bpl\bly\by
420         (default: L)
421
422        Reply to the current or tagged message(s) by extracting any addresses which
423
424        The Mutt-ng E-Mail Client                                                     9
425
426        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.10  ,
427        page 24) commands, but also honor any Mail-Followup-To header(s) if the
428        _\b$_\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 6.3.88  , page 85) configuration variable is set.
429        Using this when replying to messages posted to mailing lists helps avoid dupli-
430        cate copies being sent to the author of the message you are replying to.
431
432        p\bpi\bip\bpe\be-\b-m\bme\bes\bss\bsa\bag\bge\be
433         (default: |)
434
435        Asks for an external Unix command and pipes the current or tagged message(s) to
436        it.  The variables _\b$_\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.200  , page 113), _\b$_\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
437        (section 6.3.202  , page 114), _\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp (section 6.3.201  , page 114) and
438        _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 6.3.332  , page 145) control the exact behavior of this
439        function.
440
441        r\bre\bes\bse\ben\bnd\bd-\b-m\bme\bes\bss\bsa\bag\bge\be
442         (default: ESC e)
443
444        With resend-message, mutt takes the current message as a template for a new
445        message.  This function is best described as "recall from arbitrary folders".
446        It can conveniently be used to forward MIME messages while preserving the orig-
447        inal mail structure. Note that the amount of headers included here depends on
448        the value of the _\b$_\bw_\be_\be_\bd (section 6.3.333  , page 146) variable.
449
450        This function is also available from the attachment menu. You can use this to
451        easily resend a message which was included with a bounce message as a mes-
452        sage/rfc822 body part.
453
454        s\bsh\bhe\bel\bll\bl-\b-e\bes\bsc\bca\bap\bpe\be
455         (default: !)
456
457        Asks for an external Unix command and executes it.  The _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section
458        6.3.332  , page 145) can be used to control whether Mutt-ng will wait for a key
459        to be pressed when the command returns (presumably to let the user read the
460        output of the command), based on the return status of the named command.
461
462        t\bto\bog\bgg\bgl\ble\be-\b-q\bqu\buo\bot\bte\bed\bd
463         (default: T)
464
465        The _\bp_\ba_\bg_\be_\br uses the _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 6.3.225  , page 119) variable to
466        detect quoted text when displaying the body of the message.  This function tog-
467        gles the display of the quoted material in the message.  It is particularly
468        useful when are interested in just the response and there is a large amount of
469        quoted text in the way.
470
471        s\bsk\bki\bip\bp-\b-q\bqu\buo\bot\bte\bed\bd
472         (default: S)
473
474        This function will go to the next line of non-quoted text which come after a
475        line of quoted text in the internal pager.
476
477        _\b2_\b._\b4  _\bS_\be_\bn_\bd_\bi_\bn_\bg _\bM_\ba_\bi_\bl
478
479        The following bindings are available in the _\bi_\bn_\bd_\be_\bx for sending messages.
480
481        The Mutt-ng E-Mail Client                                                    10
482
483             m       compose         compose a new message
484             r       reply           reply to sender
485             g       group-reply     reply to all recipients
486             L       list-reply      reply to mailing list address
487             f       forward         forward message
488             b       bounce          bounce (remail) message
489             ESC k   mail-key        mail a PGP public key to someone
490
491        Bouncing a message sends the message as is to the recipient you specify.  For-
492        warding a message allows you to add comments or modify the message you are for-
493        warding.  These items are discussed in greater detail in the next chapter
494        _\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.5  , page 13).
495
496        Mutt-ng will then enter the _\bc_\bo_\bm_\bp_\bo_\bs_\be menu and prompt you for the recipients to
497        place on the ``To:'' header field.  Next, it will ask you for the ``Subject:''
498        field for the message, providing a default if you are replying to or forwarding
499        a message.  See also _\b$_\ba_\bs_\bk_\bc_\bc (section 6.3.10  , page 67), _\b$_\ba_\bs_\bk_\bb_\bc_\bc (section
500        6.3.9  , page 66), _\b$_\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt (section 6.3.17  , page 69), _\b$_\bb_\bo_\bu_\bn_\bc_\be (section
501        6.3.20  , page 69), and _\b$_\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by (section 6.3.60  , page 78) for changing
502        how Mutt-ng asks these questions.
503
504        Mutt-ng will then automatically start your _\b$_\be_\bd_\bi_\bt_\bo_\br (section 6.3.55  , page 77)
505        on the message body.  If the _\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 6.3.54  , page 77) variable
506        is set, the headers will be at the top of the message in your editor.  Any mes-
507        sages you are replying to will be added in sort order to the message, with
508        appropriate _\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 6.3.15  , page 68), _\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section
509        6.3.109  , page 90) and _\b$_\bp_\bo_\bs_\bt_\b__\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 6.3.212  , page 116).
510        When forwarding a message, if the _\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  , page 97)
511        variable is unset, a copy of the forwarded message will be included.  If you
512        have specified a _\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 6.3.259  , page 127), it will be appended
513        to the message.
514
515        Once you have finished editing the body of your mail message, you are returned
516        to the _\bc_\bo_\bm_\bp_\bo_\bs_\be menu.  The following options are available:
517
518        The Mutt-ng E-Mail Client                                                    11
519
520             a       attach-file             attach a file
521             A    attach-message      attach message(s) to the message
522             ESC k   attach-key              attach a PGP public key
523             d       edit-description        edit description on attachment
524             D       detach-file             detach a file
525             t       edit-to                 edit the To field
526             ESC f   edit-from               edit the From field
527             r       edit-reply-to           edit the Reply-To field
528             c       edit-cc                 edit the Cc field
529             b       edit-bcc                edit the Bcc field
530             y       send-message            send the message
531             s       edit-subject            edit the Subject
532             S       smime-menu              select S/MIME options
533             f       edit-fcc                specify an ``Fcc'' mailbox
534             p       pgp-menu                select PGP options
535             P       postpone-message        postpone this message until later
536             q       quit                    quit (abort) sending the message
537             w    write-fcc      write the message to a folder
538             i       ispell                  check spelling (if available on your system)
539             ^F      forget-passphrase       wipe passphrase(s) from memory
540
541        N\bNo\bot\bte\be:\b: The attach-message function will prompt you for a folder to attach mes-
542        sages from. You can now tag messages in that folder and they will be attached
543        to the message you are sending. Note that certain operations like composing a
544        new mail, replying, forwarding, etc. are not permitted when you are in that
545        folder. The %r in _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.305  , page 138) will change to a
546        'A' to indicate that you are in attach-message mode.
547
548        _\b2_\b._\b4_\b._\b1  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\be _\bm_\be_\bs_\bs_\ba_\bg_\be _\bh_\be_\ba_\bd_\be_\br
549
550        When editing the header of your outgoing message, there are a couple of special
551        features available.
552
553        If you specify
554
555        Fcc: _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
556
557        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
558        the _\bc_\bo_\bm_\bp_\bo_\bs_\be menu.
559
560        You can also attach files to your message by specifying
561
562        Attach: _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be  [ _\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn ]
563
564        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
565        use as the description of the attached file.
566
567        When replying to messages, if you remove the _\bI_\bn_\b-_\bR_\be_\bp_\bl_\by_\b-_\bT_\bo_\b: field from the header
568        field, Mutt-ng will not generate a _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be_\bs_\b: field, which allows you to cre-
569        ate a new message thread.
570
571        Also see _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 6.3.54  , page 77).
572
573        The Mutt-ng E-Mail Client                                                    12
574
575        _\b2_\b._\b4_\b._\b2  _\bU_\bs_\bi_\bn_\bg _\bM_\bu_\bt_\bt_\b-_\bn_\bg _\bw_\bi_\bt_\bh _\bP_\bG_\bP
576
577        If you want to use PGP, you can specify
578
579        Pgp: [ E | S | S_\b<_\bi_\bd_\b> ]
580
581        ``E'' encrypts, ``S'' signs and ``S<id>'' signs with the given key, setting
582        _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 6.3.192  , page 112) permanently.
583
584        If you have told mutt to PGP encrypt a message, it will guide you through a key
585        selection process when you try to send the message.  Mutt-ng will not ask you
586        any questions about keys which have a certified user ID matching one of the
587        message recipients' mail addresses.  However, there may be situations in which
588        there are several keys, weakly certified user ID fields, or where no matching
589        keys can be found.
590
591        In these cases, you are dropped into a menu with a list of keys from which you
592        can select one.  When you quit this menu, or mutt can't find any matching keys,
593        you are prompted for a user ID.  You can, as usually, abort this prompt using
594        ^G.  When you do so, mutt will return to the compose screen.
595
596        Once you have successfully finished the key selection, the message will be
597        encrypted using the selected public keys, and sent out.
598
599        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-
600        _\bm_\ba_\bt (section 6.3.179  , page 109)) have obvious meanings.  But some explana-
601        tions on the capabilities, flags, and validity fields are in order.
602
603        The flags sequence (%f) will expand to one of the following flags:
604
605             R            The key has been revoked and can't be used.
606             X            The key is expired and can't be used.
607             d            You have marked the key as disabled.
608             c            There are unknown critical self-signature
609                          packets.
610
611        The capabilities field (%c) expands to a two-character sequence representing a
612        key's capabilities.  The first character gives the key's encryption capabili-
613        ties: A minus sign (-\b-) means that the key cannot be used for encryption.  A dot
614        (.\b.) means that it's marked as a signature key in one of the user IDs, but may
615        also be used for encryption.  The letter e\be indicates that this key can be used
616        for encryption.
617
618        The second character indicates the key's signing capabilities.  Once again, a
619        ``-\b-'' implies ``not for signing'', ``.\b.'' implies that the key is marked as an
620        encryption key in one of the user-ids, and ``s\bs'' denotes a key which can be
621        used for signing.
622
623        Finally, the validity field (%t) indicates how well-certified a user-id is.  A
624        question mark (?\b?) indicates undefined validity, a minus character (-\b-) marks an
625        untrusted association, a space character means a partially trusted association,
626        and a plus character (+\b+) indicates complete validity.
627
628        The Mutt-ng E-Mail Client                                                    13
629
630        _\b2_\b._\b4_\b._\b3  _\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_\b.
631
632        You may also have configured mutt to co-operate with Mixmaster, an anonymous
633        remailer.  Mixmaster permits you to send your messages anonymously using a
634        chain of remailers. Mixmaster support in mutt is for mixmaster version 2.04
635        (beta 45 appears to be the latest) and 2.03.  It does not support earlier ver-
636        sions or the later so-called version 3 betas, of which the latest appears to be
637        called 2.9b23.
638
639        To use it, you'll have to obey certain restrictions.  Most important, you can-
640        not use the Cc and Bcc headers.  To tell Mutt-ng to use mixmaster, you have to
641        select a remailer chain, using the mix function on the compose menu.
642
643        The chain selection screen is divided into two parts.  In the (larger) upper
644        part, you get a list of remailers you may use.  In the lower part, you see the
645        currently selected chain of remailers.
646
647        You can navigate in the chain using the chain-prev and chain-next functions,
648        which are by default bound to the left and right arrows and to the h and l keys
649        (think vi keyboard bindings).  To insert a remailer at the current chain posi-
650        tion, use the insert function.  To append a remailer behind the current chain
651        position, use select-entry or append.  You can also delete entries from the
652        chain, using the corresponding function.  Finally, to abandon your changes,
653        leave the menu, or accept them pressing (by default) the Return key.
654
655        Note that different remailers do have different capabilities, indicated in the
656        %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 6.3.139  ,
657        page 98)).  Most important is the ``middleman'' capability, indicated by a cap-
658        ital ``M'': This means that the remailer in question cannot be used as the
659        final element of a chain, but will only forward messages to other mixmaster
660        remailers.  For details on the other capabilities, please have a look at the
661        mixmaster documentation.
662
663        _\b2_\b._\b5  _\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
664
665        Bouncing and forwarding let you send an existing message to recipients that you
666        specify.  Bouncing a message uses the _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 6.3.247  , page 124)
667        command to send a copy to alternative addresses as if they were the message's
668        original recipients.  Forwarding a message, on the other hand, allows you to
669        modify the message before it is resent (for example, by adding your own com-
670        ments).
671
672        The following keys are bound by default:
673
674             f       forward         forward message
675             b       bounce          bounce (remail) message
676
677        Forwarding can be done by including the original message in the new message's
678        body (surrounded by indicating lines) or including it as a MIME attachment,
679        depending on the value of the _\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  , page 97) vari-
680        able.  Decoding of attachments, like in the pager, can be controlled by the
681        _\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.69  , page 81) and _\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section
682
683        The Mutt-ng E-Mail Client                                                    14
684
685        6.3.137  , page 98) variables, respectively.  The desired forwarding format may
686        depend on the content, therefore _\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd is a quadoption which, for exam-
687        ple, can be set to ``ask-no''.
688
689        The inclusion of headers is controlled by the current setting of the _\b$_\bw_\be_\be_\bd
690        (section 6.3.333  , page 146) variable, unless _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  ,
691        page 97) is set.
692
693        Editing the message to forward follows the same procedure as sending or reply-
694        ing to a message does.
695
696        _\b2_\b._\b6  _\bP_\bo_\bs_\bt_\bp_\bo_\bn_\bi_\bn_\bg _\bM_\ba_\bi_\bl
697
698        At times it is desirable to delay sending a message that you have already begun
699        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,
700        the body of your message and attachments are stored in the mailbox specified by
701        the _\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 6.3.214  , page 117) variable.  This means that you can
702        recall the message even if you exit Mutt-ng and then restart it at a later
703        time.
704
705        Once a message is postponed, there are several ways to resume it.  From the
706        command line you can use the ``-p'' option, or if you _\bc_\bo_\bm_\bp_\bo_\bs_\be a new message
707        from the _\bi_\bn_\bd_\be_\bx or _\bp_\ba_\bg_\be_\br you will be prompted if postponed messages exist.  If
708        multiple messages are currently postponed, the _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd menu will pop up and
709        you can select which message you would like to resume.
710
711        N\bNo\bot\bte\be:\b: If you postpone a reply to a message, the reply setting of the message is
712        only updated when you actually finish the message and send it.  Also, you must
713        be in the same folder with the message you replied to for the status of the
714        message to be updated.
715
716        See also the _\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 6.3.213  , page 116) quad-option.
717
718        _\b2_\b._\b7  _\bR_\be_\ba_\bd_\bi_\bn_\bg _\bn_\be_\bw_\bs _\bv_\bi_\ba _\bN_\bN_\bT_\bP
719
720        If compiled with ``--enable-nntp'' option, Mutt-ng can read news from
721        newsserver via NNTP.  You can open a newsgroup with function ``change-news-
722        group'' (default: i).  Default newsserver can be obtained from _\bN_\bN_\bT_\bP_\bS_\bE_\bR_\bV_\bE_\bR envi-
723        ronment variable.  Like other news readers, info about subscribed newsgroups is
724        saved in file by _\b$_\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc (section 6.3.156  , page 103) variable. Article
725        headers are cached and can be loaded from file when newsgroup entered instead
726        loading from newsserver.
727
728        _\b3_\b.  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn
729
730        While the default configuration (or ``preferences'') make Mutt-ng usable right
731        out of the box, it is often desirable to tailor Mutt-ng to suit your own
732        tastes. When Mutt-ng is first invoked, it will attempt to read the ``system''
733        configuration file (defaults set by your local system administrator), unless
734        the ``-n'' _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be (section 6.1  , page 62) option is specified.  This
735        file is typically /usr/local/share/muttng/Muttngrc or /etc/Muttngrc, Mutt-ng
736        users will find this file in /usr/local/share/muttng/Muttrc or /etc/Muttngrc.
737        Mutt will next look for a file named .muttrc in your home directory, Mutt-ng
738
739        The Mutt-ng E-Mail Client                                                    15
740
741        will look for .muttngrc.  If this file does not exist and your home directory
742        has a subdirectory named .mutt, mutt try to load a file named .muttng/muttngrc.
743
744        .muttrc (or .muttngrc for Mutt-ng) is the file where you will usually place
745        your _\bc_\bo_\bm_\bm_\ba_\bn_\bd_\bs (section 6.2  , page 62) to configure Mutt-ng.
746
747        In addition, mutt supports version specific configuration files that are parsed
748        instead of the default files as explained above.  For instance, if your system
749        has a Muttrc-0.88 file in the system configuration directory, and you are run-
750        ning version 0.88 of mutt, this file will be sourced instead of the Muttngrc
751        file.  The same is true of the user configuration file, if you have a file
752        .muttrc-0.88.6 in your home directory, when you run mutt version 0.88.6, it
753        will source this file instead of the default .muttrc file.  The version number
754        is the same which is visible using the ``-v'' _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be (section 6.1  , page
755        62) switch or using the show-version key (default: V) from the index menu.
756
757        _\b3_\b._\b1  _\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
758
759        An initialization file consists of a series of _\bc_\bo_\bm_\bm_\ba_\bn_\bd_\bs (section 6.2  , page
760        62).  Each line of the file may contain one or more commands.  When multiple
761        commands are used, they must be separated by a semicolon (;).
762
763             set realname='Mutt-ng user' ; ignore x-
764
765        The hash mark, or pound sign (``#''), is used as a ``comment'' character. You
766        can use it to annotate your initialization file. All text after the comment
767        character to the end of the line is ignored. For example,
768
769             my_hdr X-Disclaimer: Why are you listening to me? # This is a comment
770
771        Single quotes (') and double quotes (') can be used to quote strings which con-
772        tain spaces or other special characters.  The difference between the two types
773        of quotes is similar to that of many popular shell programs, namely that a sin-
774        gle quote is used to specify a literal string (one that is not interpreted for
775        shell variables or quoting with a backslash [see next paragraph]), while double
776        quotes indicate a string for which should be evaluated.  For example, backtics
777        are evaluated inside of double quotes, but n\bno\bot\bt for single quotes.
778
779        \ quotes the next character, just as in shells such as bash and zsh.  For exam-
780        ple, if want to put quotes ``''' inside of a string, you can use ``\'' to force
781        the next character to be a literal instead of interpreted character.
782
783             set realname="Michael \"MuttDude\" Elkins"
784
785        ``\\'' means to insert a literal ``\'' into the line.  ``\n'' and ``\r'' have
786        their usual C meanings of linefeed and carriage-return, respectively.
787
788        A \ at the end of a line can be used to split commands over multiple lines,
789        provided that the split points don't appear in the middle of command names.
790
791        The Mutt-ng E-Mail Client                                                    16
792
793        Please note that, unlike the various shells, mutt-ng interprets a ``\'' at the
794        end of a line also in comments. This allows you to disable a command split over
795        multiple lines with only one ``#''.
796
797             # folder-hook . \
798               set realname="Michael \"MuttDude\" Elkins"
799
800        When testing your config files, beware the following caveat. The backslash at
801        the end of the commented line extends the current line with the next line -
802        then referred to as a ``continuation line''.  As the first line is commented
803        with a hash (#) all following continuation lines are also part of a comment and
804        therefore are ignored, too. So take care of comments when continuation lines
805        are involved within your setup files!
806
807        Abstract example:
808
809             line1\
810             line2a # line2b\
811             line3\
812             line4
813             line5
814
815        line1 ``continues'' until line4. however, the part after the # is a comment
816        which includes line3 and line4. line5 is a new line of its own and thus is
817        interpreted again.
818
819        It is also possible to substitute the output of a Unix command in an initial-
820        ization file.  This is accomplished by enclosing the command in backquotes
821        (``).  For example,
822
823             my_hdr X-Operating-System: `uname -a`
824
825        The output of the Unix command ``uname -a'' will be substituted before the line
826        is parsed.  Note that since initialization files are line oriented, only the
827        first line of output from the Unix command will be substituted.
828
829        UNIX environments can be accessed like the way it is done in shells like sh and
830        bash: Prepend the name of the environment by a ``$''.  For example,
831
832             set record=+sent_on_$HOSTNAME
833
834        The commands understood by mutt are explained in the next paragraphs.  For a
835        complete list, see the _\bc_\bo_\bm_\bm_\ba_\bn_\bd _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 6.2  , page 62).
836
837        _\b3_\b._\b2  _\bD_\be_\bf_\bi_\bn_\bi_\bn_\bg_\b/_\bU_\bs_\bi_\bn_\bg _\ba_\bl_\bi_\ba_\bs_\be_\bs
838
839        Usage: alias _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
840
841        The Mutt-ng E-Mail Client                                                    17
842
843        It's usually very cumbersome to remember or type out the address of someone you
844        are communicating with.  Mutt-ng allows you to create ``aliases'' which map a
845        short string to a full address.
846
847        N\bNo\bot\bte\be:\b: if you want to create an alias for a group (by specifying more than one
848        address), you m\bmu\bus\bst\bt separate the addresses with a comma (``,'').
849
850        To remove an alias or aliases (``*'' means all aliases):
851
852        unalias [ * | _\bk_\be_\by _\b._\b._\b. ]
853
854             alias muttdude me@cs.hmc.edu (Michael Elkins)
855             alias theguys manny, moe, jack
856
857        Unlike other mailers, Mutt-ng doesn't require aliases to be defined in a spe-
858        cial file.  The alias command can appear anywhere in a configuration file, as
859        long as this file is _\bs_\bo_\bu_\br_\bc_\be_\bd (section 3.26  , page 32).  Consequently, you can
860        have multiple alias files, or you can have all aliases defined in your muttrc.
861
862        On the other hand, the _\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (section 2.3.4  , page 7) function can use
863        only one file, the one pointed to by the _\b$_\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be (section 6.3.3  , page 65)
864        variable (which is ~/.muttrc by default). This file is not special either, in
865        the sense that Mutt-ng will happily append aliases to any file, but in order
866        for the new aliases to take effect you need to explicitly _\bs_\bo_\bu_\br_\bc_\be (section
867        3.26  , page 32) this file too.
868
869        For example:
870
871             source /usr/local/share/Mutt-ng.aliases
872             source ~/.mail_aliases
873             set alias_file=~/.mail_aliases
874
875        To use aliases, you merely use the alias at any place in mutt where mutt
876        prompts for addresses, such as the _\bT_\bo_\b: or _\bC_\bc_\b: prompt.  You can also enter
877        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
878        (section 6.3.54  , page 77) variable set.
879
880        In addition, at the various address prompts, you can use the tab character to
881        expand a partial alias to the full alias.  If there are multiple matches, mutt
882        will bring up a menu with the matching aliases.  In order to be presented with
883        the full list of aliases, you must hit tab with out a partial alias, such as at
884        the beginning of the prompt or after a comma denoting multiple addresses.
885
886        In the alias menu, you can select as many aliases as you want with the _\bs_\be_\bl_\be_\bc_\bt_\b-
887        _\be_\bn_\bt_\br_\by key (default: RET), and use the _\be_\bx_\bi_\bt key (default: q) to return to the
888        address prompt.
889
890        _\b3_\b._\b3  _\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
891
892        Usage: bind _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
893
894        The Mutt-ng E-Mail Client                                                    18
895
896        This command allows you to change the default key bindings (operation invoked
897        when pressing a key).
898
899        _\bm_\ba_\bp specifies in which menu the binding belongs.  Multiple maps may be speci-
900        fied by separating them with commas (no additional whitespace is allowed). The
901        currently defined maps are:
902
903              generic
904                    This is not a real menu, but is used as a fallback for all of the
905                    other menus except for the pager and editor modes.  If a key is not
906                    defined in another menu, Mutt-ng will look for a binding to use in
907                    this menu.  This allows you to bind a key to a certain function in
908                    multiple menus instead of having multiple bind statements to accom-
909                    plish the same task.
910
911              alias
912                    The alias menu is the list of your personal aliases as defined in
913                    your muttrc.  It is the mapping from a short alias name to the full
914                    email address(es) of the recipient(s).
915
916              attach
917                    The attachment menu is used to access the attachments on received
918                    messages.
919
920              browser
921                    The browser is used for both browsing the local directory struc-
922                    ture, and for listing all of your incoming mailboxes.
923
924              editor
925                    The editor is the line-based editor the user enters text data.
926
927              index
928                    The index is the list of messages contained in a mailbox.
929
930              compose
931                    The compose menu is the screen used when sending a new message.
932
933              pager
934                    The pager is the mode used to display message/attachment data, and
935                    help listings.
936
937              pgp
938                    The pgp menu is used to select the OpenPGP keys used for encrypting
939                    outgoing messages.
940
941              postpone
942                    The postpone menu is similar to the index menu, except is used when
943                    recalling a message the user was composing, but saved until later.
944
945        _\bk_\be_\by is the key (or key sequence) you wish to bind.  To specify a control char-
946        acter, use the sequence _\b\_\bC_\bx, where _\bx is the letter of the control character
947        (for example, to specify control-A use ``\Ca'').  Note that the case of _\bx as
948
949        The Mutt-ng E-Mail Client                                                    19
950
951        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
952        alternative form is to specify the key as a three digit octal number prefixed
953        with a ``\'' (for example _\b\_\b1_\b7_\b7 is equivalent to _\b\_\bc_\b?).
954
955        In addition, _\bk_\be_\by may consist of:
956
957             \t              tab
958             <tab>           tab
959             <backtab>       backtab / shift-tab
960             \r              carriage return
961             \n              newline
962             \e              escape
963             <esc>           escape
964             <up>            up arrow
965             <down>          down arrow
966             <left>          left arrow
967             <right>         right arrow
968             <pageup>        Page Up
969             <pagedown>      Page Down
970             <backspace>     Backspace
971             <delete>        Delete
972             <insert>        Insert
973             <enter>         Enter
974             <return>        Return
975             <home>          Home
976             <end>           End
977             <space>         Space bar
978             <f1>            function key 1
979             <f10>           function key 10
980
981        _\bk_\be_\by does not need to be enclosed in quotes unless it contains a space (`` '').
982
983        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn specifies which action to take when _\bk_\be_\by is pressed.  For a complete
984        list of functions, see the _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 6.4  , page 147).  The special
985        function noop unbinds the specified key sequence.
986
987        _\b3_\b._\b4  _\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
988
989        Usage: charset-hook _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
990
991        Usage: iconv-hook _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
992
993        The charset-hook command defines an alias for a character set.  This is useful
994        to properly display messages which are tagged with a character set name not
995        known to mutt.
996
997        The iconv-hook command defines a system-specific name for a character set.
998        This is helpful when your systems character conversion library insists on using
999        strange, system-specific names for character sets.
1000
1001        _\b3_\b._\b5  _\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
1002
1003        The Mutt-ng E-Mail Client                                                    20
1004
1005        Usage: folder-hook [!]_\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1006
1007        It is often desirable to change settings based on which mailbox you are read-
1008        ing.  The folder-hook command provides a method by which you can execute any
1009        configuration command.  _\br_\be_\bg_\be_\bx_\bp is a regular expression specifying in which
1010        mailboxes to execute _\bc_\bo_\bm_\bm_\ba_\bn_\bd before loading.  If a mailbox matches multiple
1011        folder-hook's, they are executed in the order given in the muttrc.
1012
1013        N\bNo\bot\bte\be:\b: if you use the ``!'' shortcut for _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 6.3.295  , page
1014        136) at the beginning of the pattern, you must place it inside of double or
1015        single quotes in order to distinguish it from the logical _\bn_\bo_\bt operator for the
1016        expression.
1017
1018        Note that the settings are _\bn_\bo_\bt restored when you leave the mailbox.  For exam-
1019        ple, a command action to perform is to change the sorting method based upon the
1020        mailbox being read:
1021
1022             folder-hook mutt set sort=threads
1023
1024        However, the sorting method is not restored to its previous value when reading
1025        a different mailbox.  To specify a _\bd_\be_\bf_\ba_\bu_\bl_\bt command, use the pattern ``.'':
1026
1027             folder-hook . set sort=date-sent
1028
1029        _\b3_\b._\b6  _\bK_\be_\by_\bb_\bo_\ba_\br_\bd _\bm_\ba_\bc_\br_\bo_\bs
1030
1031        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 ]
1032
1033        Macros are useful when you would like a single key to perform a series of
1034        actions.  When you press _\bk_\be_\by in menu _\bm_\be_\bn_\bu, Mutt-ng will behave as if you had
1035        typed _\bs_\be_\bq_\bu_\be_\bn_\bc_\be.  So if you have a common sequence of commands you type, you can
1036        create a macro to execute those commands with a single key.
1037
1038        _\bm_\be_\bn_\bu is the _\bm_\ba_\bp (section 3.3  , page 17) which the macro will be bound.  Multi-
1039        ple maps may be specified by separating multiple menu arguments by commas.
1040        Whitespace may not be used in between the menu arguments and the commas sepa-
1041        rating them.
1042
1043        _\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
1044        3.3  , page 17).  There are some additions however.  The first is that control
1045        characters in _\bs_\be_\bq_\bu_\be_\bn_\bc_\be can also be specified as _\b^_\bx.  In order to get a caret
1046        (`^'') you need to use _\b^_\b^.  Secondly, to specify a certain key such as _\bu_\bp or to
1047        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
1048        _\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
1049        3.3  , page 17).  Functions are listed in the _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section
1050        6.4  , page 147).
1051
1052        The advantage with using function names directly is that the macros will work
1053        regardless of the current key bindings, so they are not dependent on the user
1054        having particular key definitions.  This makes them more robust and portable,
1055
1056        The Mutt-ng E-Mail Client                                                    21
1057
1058        and also facilitates defining of macros in files used by more than one user
1059        (eg. the system Muttngrc).
1060
1061        Optionally you can specify a descriptive text after _\bs_\be_\bq_\bu_\be_\bn_\bc_\be, which is shown in
1062        the help screens.
1063
1064        N\bNo\bot\bte\be:\b: Macro definitions (if any) listed in the help screen(s), are silently
1065        truncated at the screen width, and are not wrapped.
1066
1067        _\b3_\b._\b7  _\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
1068
1069        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 ]
1070
1071        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
1072
1073        Usage: uncolor index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1074
1075        If your terminal supports color, you can spice up Mutt-ng by creating your own
1076        color scheme.  To define the color of an object (type of information), you must
1077        specify both a foreground color a\ban\bnd\bd a background color (it is not possible to
1078        only specify one or the other).
1079
1080        _\bo_\bb_\bj_\be_\bc_\bt can be one of:
1081
1082           +\bo attachment
1083
1084           +\bo body (match _\br_\be_\bg_\be_\bx_\bp in the body of messages)
1085
1086           +\bo bold (highlighting bold patterns in the body of messages)
1087
1088           +\bo error (error messages printed by Mutt-ng)
1089
1090           +\bo header (match _\br_\be_\bg_\be_\bx_\bp in the message header)
1091
1092           +\bo hdrdefault (default color of the message header in the pager)
1093
1094           +\bo index (match _\bp_\ba_\bt_\bt_\be_\br_\bn in the message index)
1095
1096           +\bo indicator (arrow or bar used to indicate the current item in a menu)
1097
1098           +\bo markers (the ``+'' markers at the beginning of wrapped lines in the pager)
1099
1100           +\bo message (informational messages)
1101
1102           +\bo normal
1103
1104           +\bo quoted (text matching _\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 6.3.225  , page 119) in the
1105             body of a message)
1106
1107           +\bo quoted1, quoted2, ..., quotedN\bN (higher levels of quoting)
1108
1109           +\bo search (highlighting of words in the pager)
1110
1111        The Mutt-ng E-Mail Client                                                    22
1112
1113           +\bo signature
1114
1115           +\bo status (mode lines used to display info about the mailbox or message)
1116
1117           +\bo tilde (the ``~'' used to pad blank lines in the pager)
1118
1119           +\bo tree (thread tree drawn in the message index and attachment menu)
1120
1121           +\bo underline (highlighting underlined patterns in the body of messages)
1122
1123        _\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:
1124
1125           +\bo white
1126
1127           +\bo black
1128
1129           +\bo green
1130
1131           +\bo magenta
1132
1133           +\bo blue
1134
1135           +\bo cyan
1136
1137           +\bo yellow
1138
1139           +\bo red
1140
1141           +\bo default
1142
1143           +\bo color_\bx
1144
1145        _\bf_\bo_\br_\be_\bg_\br_\bo_\bu_\bn_\bd can optionally be prefixed with the keyword bright to make the fore-
1146        ground color boldfaced (e.g., brightred).
1147
1148        If your terminal supports it, the special keyword _\bd_\be_\bf_\ba_\bu_\bl_\bt can be used as a
1149        transparent color.  The value _\bb_\br_\bi_\bg_\bh_\bt_\bd_\be_\bf_\ba_\bu_\bl_\bt is also valid.  If Mutt-ng is
1150        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-
1151        ment variable to the default colors of your terminal for this to work; for
1152        example (for Bourne-like shells):
1153
1154             set COLORFGBG="green;black"
1155             export COLORFGBG
1156
1157        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
1158        instead of _\bw_\bh_\bi_\bt_\be and _\by_\be_\bl_\bl_\bo_\bw when setting this variable.
1159
1160        N\bNo\bot\bte\be:\b: The uncolor command can be applied to the index object only.  It removes
1161        entries from the list. You m\bmu\bus\bst\bt specify the same pattern specified in the color
1162        command for it to be removed.  The pattern ``*'' is a special token which means
1163        to clear the color index list of all entries.
1164
1165        The Mutt-ng E-Mail Client                                                    23
1166
1167        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
1168        number of colors supported by your terminal).  This is useful when you remap
1169        the colors for your display (for example by changing the color associated with
1170        _\bc_\bo_\bl_\bo_\br_\b2 for your xterm), since color names may then lose their normal meaning.
1171
1172        If your terminal does not support color, it is still possible change the video
1173        attributes through the use of the ``mono'' command:
1174
1175        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 ]
1176
1177        Usage: mono index _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be _\bp_\ba_\bt_\bt_\be_\br_\bn
1178
1179        Usage: unmono index _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ...  ]
1180
1181        where _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be is one of the following:
1182
1183           +\bo none
1184
1185           +\bo bold
1186
1187           +\bo underline
1188
1189           +\bo reverse
1190
1191           +\bo standout
1192
1193        _\b3_\b._\b8  _\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
1194
1195        Usage: [un]ignore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1196
1197        Messages often have many header fields added by automatic processing systems,
1198        or which may not seem useful to display on the screen.  This command allows you
1199        to specify header fields which you don't normally want to see.
1200
1201        You do not need to specify the full header field name.  For example, ``ignore
1202        content-'' will ignore all header fields that begin with the pattern ``con-
1203        tent-''. ``ignore *'' will ignore all headers.
1204
1205        To remove a previously added token from the list, use the ``unignore'' command.
1206        The ``unignore'' command will make Mutt-ng display headers with the given pat-
1207        tern.  For example, if you do ``ignore x-'' it is possible to ``unignore x-
1208        mailer''.
1209
1210        ``unignore *'' will remove all tokens from the ignore list.
1211
1212        For example:
1213
1214             # Sven's draconian header weeding
1215             ignore *
1216             unignore from date subject to cc
1217             unignore organization organisation x-mailer: x-newsreader: x-mailing-list:
1218             unignore posted-to:
1219
1220        The Mutt-ng E-Mail Client                                                    24
1221
1222        _\b3_\b._\b9  _\bA_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be _\ba_\bd_\bd_\br_\be_\bs_\bs_\be_\bs
1223
1224        Usage: [un]alternates _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1225
1226        With various functions, mutt will treat messages differently, depending on
1227        whether you sent them or whether you received them from someone else.  For
1228        instance, when replying to a message that you sent to a different party, mutt
1229        will automatically suggest to send the response to the original message's
1230        recipients -- responding to yourself won't make much sense in many cases.  (See
1231        _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section 6.3.233  , page 121).)
1232
1233        Many users receive e-mail under a number of different addresses. To fully use
1234        mutt's features here, the program must be able to recognize what e-mail
1235        addresses you receive mail under. That's the purpose of the alternates command:
1236        It takes a list of regular expressions, each of which can identify an address
1237        under which you receive e-mail.
1238
1239        The unalternates command can be used to write exceptions to alternates pat-
1240        terns. If an address matches something in an alternates command, but you none-
1241        theless do not think it is from you, you can list a more precise pattern under
1242        an unalternates command.
1243
1244        To remove a regular expression from the alternates list, use the unalternates
1245        command with exactly the same _\br_\be_\bg_\be_\bx_\bp.  Likewise, if the _\br_\be_\bg_\be_\bx_\bp for a alternates
1246        command matches an entry on the unalternates list, that unalternates entry will
1247        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
1248        will be removed.
1249
1250        _\b3_\b._\b1_\b0  _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bl_\bi_\bs_\bt_\bs
1251
1252        Usage: [un]lists _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1253
1254        Usage: [un]subscribe _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
1255
1256        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.9  , page
1257        44).  In order to take advantage of them, you must specify which addresses
1258        belong to mailing lists, and which mailing lists you are subscribed to.  Once
1259        you have done this, the _\bl_\bi_\bs_\bt_\b-_\br_\be_\bp_\bl_\by (section 2.3.4  , page 8) function will work
1260        for all known lists.  Additionally, when you send a message to a subscribed
1261        list, mutt will add a Mail-Followup-To header to tell other users' mail user
1262        agents not to send copies of replies to your personal address.   Note that the
1263        Mail-Followup-To header is a non-standard extension which is not supported by
1264        all mail user agents.  Adding it is not bullet-proof against receiving personal
1265        CCs of list messages.  Also note that the generation of the Mail-Followup-To
1266        header is controlled by the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 6.3.66  , page 80) configura-
1267        tion variable.
1268
1269        More precisely, Mutt-ng maintains lists of patterns for the addresses of known
1270        and subscribed mailing lists.  Every subscribed mailing list is known. To mark
1271        a mailing list as known, use the ``lists'' command.  To mark it as subscribed,
1272        use ``subscribe''.
1273
1274        You can use regular expressions with both commands.  To mark all messages sent
1275        to a specific bug report's address on mutt's bug tracking system as list mail,
1276
1277        The Mutt-ng E-Mail Client                                                    25
1278
1279        for instance, you could say ``subscribe [0-9]*@bugs.guug.de''.  Often, it's
1280        sufficient to just give a portion of the list's e-mail address.
1281
1282        Specify as much of the address as you need to to remove ambiguity.  For exam-
1283        ple, if you've subscribed to the Mutt-ng mailing list, you will receive mail
1284        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
1285        list, you could add ``lists mutt-users'' to your initialization file.  To tell
1286        mutt that you are subscribed to it, add ``subscribe mutt-users'' to your ini-
1287        tialization file instead.  If you also happen to get mail from someone whose
1288        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-
1289        users@mutt\\.org'' or ``subscribe mutt-users@mutt\\.org'' to match only mail
1290        from the actual list.
1291
1292        The ``unlists'' command is used to remove a token from the list of known and
1293        subscribed mailing-lists. Use ``unlists *'' to remove all tokens.
1294
1295        To remove a mailing list from the list of subscribed mailing lists, but keep it
1296        on the list of known mailing lists, use ``unsubscribe''.
1297
1298        _\b3_\b._\b1_\b1  _\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
1299
1300        Usage: mbox-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1301
1302        This command is used to move read messages from a specified mailbox to a dif-
1303        ferent mailbox automatically when you quit or change folders.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a
1304        regular expression specifying the mailbox to treat as a ``spool'' mailbox and
1305        _\bm_\ba_\bi_\bl_\bb_\bo_\bx specifies where mail should be saved when read.
1306
1307        Unlike some of the other _\bh_\bo_\bo_\bk commands, only the _\bf_\bi_\br_\bs_\bt matching pattern is used
1308        (it is not possible to save read mail in more than a single mailbox).
1309
1310        _\b3_\b._\b1_\b2  _\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
1311
1312        Usage: [un]mailboxes [!]_\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
1313
1314        This command specifies folders which can receive mail and which will be checked
1315        for new messages.  By default, the main menu status bar displays how many of
1316        these folders have new messages.
1317
1318        When changing folders, pressing _\bs_\bp_\ba_\bc_\be will cycle through folders with new mail.
1319
1320        Pressing TAB in the directory browser will bring up a menu showing the files
1321        specified by the mailboxes command, and indicate which contain new messages.
1322        Mutt-ng will automatically enter this mode when invoked from the command line
1323        with the -y option.
1324
1325        The ``unmailboxes'' command is used to remove a token from the list of folders
1326        which receive mail. Use ``unmailboxes *'' to remove all tokens.
1327
1328        N\bNo\bot\bte\be:\b: new mail is detected by comparing the last modification time to the last
1329        access time.  Utilities like biff or frm or any other program which accesses
1330        the mailbox might cause Mutt-ng to never detect new mail for that mailbox if
1331        they do not properly reset the access time.  Backup tools are another common
1332        reason for updated access times.
1333
1334        The Mutt-ng E-Mail Client                                                    26
1335
1336        N\bNo\bot\bte\be:\b: the filenames in the mailboxes command are resolved when the command is
1337        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.8  , page
1338        44) (such as ``='' and ``!''), any variable definition that affect these char-
1339        acters (like _\b$_\bf_\bo_\bl_\bd_\be_\br (section 6.3.64  , page 79) and _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
1340        6.3.295  , page 136)) should be executed before the mailboxes command.
1341
1342        _\b3_\b._\b1_\b3  _\bU_\bs_\be_\br _\bd_\be_\bf_\bi_\bn_\be_\bd _\bh_\be_\ba_\bd_\be_\br_\bs
1343
1344        Usage:
1345
1346        my_hdr _\bs_\bt_\br_\bi_\bn_\bg
1347
1348        unmy_hdr _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
1349
1350        The ``my_hdr'' command allows you to create your own header fields which will
1351        be added to every message you send.
1352
1353        For example, if you would like to add an ``Organization:'' header field to all
1354        of your outgoing messages, you can put the command
1355
1356             my_hdr Organization: A Really Big Company, Anytown, USA
1357
1358        in your .muttrc.
1359
1360        N\bNo\bot\bte\be:\b:  space characters are _\bn_\bo_\bt allowed between the keyword and the colon
1361        (``:'').  The standard for electronic mail (RFC822) says that space is illegal
1362        there, so Mutt-ng enforces the rule.
1363
1364        If you would like to add a header field to a single message, you should either
1365        set the _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 6.3.54  , page 77) variable, or use the _\be_\bd_\bi_\bt_\b-
1366        _\bh_\be_\ba_\bd_\be_\br_\bs function (default: ``E'') in the send-menu so that you can edit the
1367        header of your message along with the body.
1368
1369        To remove user defined header fields, use the ``unmy_hdr'' command.  You may
1370        specify an asterisk (``*'') to remove all header fields, or the fields to
1371        remove.  For example, to remove all ``To'' and ``Cc'' header fields, you could
1372        use:
1373
1374             unmy_hdr to cc
1375
1376        _\b3_\b._\b1_\b4  _\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
1377
1378        Usage: hdr_order _\bh_\be_\ba_\bd_\be_\br_\b1 _\bh_\be_\ba_\bd_\be_\br_\b2 _\bh_\be_\ba_\bd_\be_\br_\b3
1379
1380        With this command, you can specify an order in which mutt will attempt to
1381        present headers to you when viewing messages.
1382
1383        ``unhdr_order *'' will clear all previous headers from the order list, thus
1384        removing the header order effects set by the system-wide startup file.
1385
1386        The Mutt-ng E-Mail Client                                                    27
1387
1388             hdr_order From Date: From: To: Cc: Subject:
1389
1390        _\b3_\b._\b1_\b5  _\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
1391
1392        Usage: save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
1393
1394        This command is used to override the default filename used when saving mes-
1395        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:
1396        an address matching _\br_\be_\bg_\be_\bx_\bp or if you are the author and the message is
1397        addressed _\bt_\bo_\b: something matching _\br_\be_\bg_\be_\bx_\bp.
1398
1399        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.4.1  , page 41) for information on the
1400        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1401
1402        Examples:
1403
1404             save-hook me@(turing\\.)?cs\\.hmc\\.edu$ +elkins
1405             save-hook aol\\.com$ +spam
1406
1407        Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 27) command.
1408
1409        _\b3_\b._\b1_\b6  _\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
1410
1411        Usage: fcc-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1412
1413        This command is used to save outgoing mail in a mailbox other than _\b$_\br_\be_\bc_\bo_\br_\bd
1414        (section 6.3.230  , page 120).  Mutt-ng searches the initial list of message
1415        recipients for the first matching _\br_\be_\bg_\be_\bx_\bp and uses _\bm_\ba_\bi_\bl_\bb_\bo_\bx as the default Fcc:
1416        mailbox.  If no match is found the message will be saved to _\b$_\br_\be_\bc_\bo_\br_\bd (section
1417        6.3.230  , page 120) mailbox.
1418
1419        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.4.1  , page 41) for information on the
1420        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1421
1422        Example: fcc-hook [@.]aol\\.com$ +spammers
1423
1424        The above will save a copy of all messages going to the aol.com domain to the
1425        `+spammers' mailbox by default.  Also see the _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  ,
1426        page 27) command.
1427
1428        _\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 _\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
1429
1430        Usage: fcc-save-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
1431
1432        This command is a shortcut, equivalent to doing both a _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section
1433        3.16  , page 27) and a _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.15  , page 26) with its arguments.
1434
1435        _\b3_\b._\b1_\b8  _\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
1436
1437        Usage: reply-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1438
1439        The Mutt-ng E-Mail Client                                                    28
1440
1441        Usage: send-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1442
1443        Usage: send2-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1444
1445        These commands can be used to execute arbitrary configuration commands based
1446        upon recipients of the message.  _\bp_\ba_\bt_\bt_\be_\br_\bn is a regular expression matching the
1447        desired address.  _\bc_\bo_\bm_\bm_\ba_\bn_\bd is executed when _\br_\be_\bg_\be_\bx_\bp matches recipients of the
1448        message.
1449
1450        reply-hook is matched against the message you are _\br_\be_\bp_\bl_\by_\bi_\bn_\bg t\bto\bo, instead of the
1451        message you are _\bs_\be_\bn_\bd_\bi_\bn_\bg.  send-hook is matched against all messages, both _\bn_\be_\bw
1452        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
1453        the order specified in the users's configuration file.
1454
1455        send2-hook is matched every time a message is changed, either by editing it, or
1456        by using the compose menu to change its recipients or subject.  send2-hook is
1457        executed after send-hook, and can, e.g., be used to set parameters such as the
1458        _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 6.3.247  , page 124) variable depending on the message's
1459        sender address.
1460
1461        For each type of send-hook or reply-hook, when multiple matches occur, commands
1462        are executed in the order they are specified in the muttrc (for that type of
1463        hook).
1464
1465        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.4.1  , page 41) for information on the
1466        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1467
1468        Example: send-hook mutt 'set mime_forward signature='''
1469
1470        Another typical use for this command is to change the values of the _\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\b-
1471        _\bt_\bi_\bo_\bn (section 6.3.15  , page 68), _\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 6.3.259  , page 127) and
1472        _\b$_\bl_\bo_\bc_\ba_\bl_\be (section 6.3.114  , page 93) variables in order to change the language
1473        of the attributions and signatures based upon the recipients.
1474
1475        N\bNo\bot\bte\be:\b: the send-hook's are only executed ONCE after getting the initial list of
1476        recipients.  Adding a recipient after replying or editing the message will NOT
1477        cause any send-hook to be executed.  Also note that my_hdr commands which mod-
1478        ify recipient headers, or the message's subject, don't have any effect on the
1479        current message when executed from a send-hook.
1480
1481        _\b3_\b._\b1_\b9  _\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
1482
1483        Usage: message-hook [!]_\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1484
1485        This command can be used to execute arbitrary configuration commands before
1486        viewing or formatting a message based upon information about the message.  _\bc_\bo_\bm_\b-
1487        _\bm_\ba_\bn_\bd is executed if the _\bp_\ba_\bt_\bt_\be_\br_\bn matches the message to be displayed. When mul-
1488        tiple matches occur, commands are executed in the order they are specified in
1489        the muttrc.
1490
1491        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.4.1  , page 41) for information on the
1492        exact format of _\bp_\ba_\bt_\bt_\be_\br_\bn.
1493
1494        Example:
1495
1496        The Mutt-ng E-Mail Client                                                    29
1497
1498             message-hook ~A 'set pager=builtin'
1499             message-hook '~f freshmeat-news' 'set pager="less \"+/^  subject: .*\""'
1500
1501        _\b3_\b._\b2_\b0  _\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
1502
1503        Usage: crypt-hook _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\bi_\bd
1504
1505        When encrypting messages with PGP or OpenSSL, you may want to associate a cer-
1506        tain key with a given e-mail address automatically, either because the recipi-
1507        ent's public key can't be deduced from the destination address, or because, for
1508        some reasons, you need to override the key Mutt-ng would normally use.  The
1509        crypt-hook command provides a method by which you can specify the ID of the
1510        public key to be used when encrypting messages to a certain recipient.
1511
1512        The meaning of "key id" is to be taken broadly in this context:  You can either
1513        put a numerical key ID here, an e-mail address, or even just a real name.
1514
1515        _\b3_\b._\b2_\b1  _\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
1516
1517        Usage: push _\bs_\bt_\br_\bi_\bn_\bg
1518
1519        This command adds the named string to the keyboard buffer. The string may con-
1520        tain control characters, key names and function names like the sequence string
1521        in the _\bm_\ba_\bc_\br_\bo (section 3.6  , page 20) command. You may use it to automatically
1522        run a sequence of commands at startup, or when entering certain folders.
1523
1524        _\b3_\b._\b2_\b2  _\bE_\bx_\be_\bc_\bu_\bt_\bi_\bn_\bg _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
1525
1526        Usage: exec _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
1527
1528        This command can be used to execute any function. Functions are listed in the
1529        _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn _\br_\be_\bf_\be_\br_\be_\bn_\bc_\be (section 6.4  , page 147).  ``exec function'' is equivalent
1530        to ``push <function>''.
1531
1532        _\b3_\b._\b2_\b3  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bS_\bc_\bo_\br_\bi_\bn_\bg
1533
1534        Usage: score _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
1535
1536        Usage: unscore _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
1537
1538        The score commands adds _\bv_\ba_\bl_\bu_\be to a message's score if _\bp_\ba_\bt_\bt_\be_\br_\bn matches it.  _\bp_\ba_\bt_\b-
1539        _\bt_\be_\br_\bn is a string in the format described in the _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 4.2  , page
1540        36) section (note: For efficiency reasons, patterns which scan information not
1541        available in the index, such as ~b, ~B or ~h, may not be used).  _\bv_\ba_\bl_\bu_\be is a
1542        positive or negative integer.  A message's final score is the sum total of all
1543        matching score entries.  However, you may optionally prefix _\bv_\ba_\bl_\bu_\be with an equal
1544        sign (=) to cause evaluation to stop at a particular entry if there is a match.
1545        Negative final scores are rounded up to 0.
1546
1547        The unscore command removes score entries from the list.  You m\bmu\bus\bst\bt specify the
1548        same pattern specified in the score command for it to be removed.  The pattern
1549        ``*'' is a special token which means to clear the list of all score entries.
1550
1551        The Mutt-ng E-Mail Client                                                    30
1552
1553        _\b3_\b._\b2_\b4  _\bS_\bp_\ba_\bm _\bd_\be_\bt_\be_\bc_\bt_\bi_\bo_\bn
1554
1555        Usage: spam _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
1556
1557        Usage: nospam _\bp_\ba_\bt_\bt_\be_\br_\bn
1558
1559        Mutt-ng has generalized support for external spam-scoring filters.  By defining
1560        your spam patterns with the spam and nospam commands, you can _\bl_\bi_\bm_\bi_\bt, _\bs_\be_\ba_\br_\bc_\bh,
1561        and _\bs_\bo_\br_\bt your mail based on its spam attributes, as determined by the external
1562        filter. You also can display the spam attributes in your index display using
1563        the %H selector in the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90) variable.
1564        (Tip: try %?H?[%H] ?  to display spam tags only when they are defined for a
1565        given message.)
1566
1567        Your first step is to define your external filter's spam patterns using the
1568        spam command. _\bp_\ba_\bt_\bt_\be_\br_\bn should be a regular expression that matches a header in a
1569        mail message. If any message in the mailbox matches this regular expression, it
1570        will receive a ``spam tag'' or ``spam attribute'' (unless it also matches a
1571        nospam pattern -- see below.) The appearance of this attribute is entirely up
1572        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,
1573        but it also can include back-references from the _\bp_\ba_\bt_\bt_\be_\br_\bn expression. (A regular
1574        expression ``back-reference'' refers to a sub-expression contained within
1575        parentheses.) %1 is replaced with the first back-reference in the regex, %2
1576        with the second, etc.
1577
1578        If you're using multiple spam filters, a message can have more than one spam-
1579        related header. You can define spam patterns for each filter you use. If a mes-
1580        sage matches two or more of these patterns, and the $spam_separator variable is
1581        set to a string, then the message's spam tag will consist of all the _\bf_\bo_\br_\bm_\ba_\bt
1582        strings joined together, with the value of $spam_separator separating them.
1583
1584        For example, suppose I use DCC, SpamAssassin, and PureMessage. I might define
1585        these spam settings:
1586
1587             spam "X-DCC-.*-Metrics:.*(....)=many"         "90+/DCC-%1"
1588             spam "X-Spam-Status: Yes"                     "90+/SA"
1589             spam "X-PerlMX-Spam: .*Probability=([0-9]+)%" "%1/PM"
1590             set spam_separator=", "
1591
1592        If I then received a message that DCC registered with ``many'' hits under the
1593        ``Fuz2'' checksum, and that PureMessage registered with a 97% probability of
1594        being spam, that message's spam tag would read 90+/DCC-Fuz2, 97/PM. (The four
1595        characters before ``=many'' in a DCC report indicate the checksum used -- in
1596        this case, ``Fuz2''.)
1597
1598        If the $spam_separator variable is unset, then each spam pattern match super-
1599        sedes the previous one. Instead of getting joined _\bf_\bo_\br_\bm_\ba_\bt strings, you'll get
1600        only the last one to match.
1601
1602        The spam tag is what will be displayed in the index when you use %H in the
1603        $index_format variable. It's also the string that the ~H pattern-matching
1604        expression matches against for _\bs_\be_\ba_\br_\bc_\bh and _\bl_\bi_\bm_\bi_\bt functions. And it's what sort-
1605        ing by spam attribute will use as a sort key.
1606
1607        The Mutt-ng E-Mail Client                                                    31
1608
1609        That's a pretty complicated example, and most people's actual environments will
1610        have only one spam filter. The simpler your configuration, the more effective
1611        mutt can be, especially when it comes to sorting.
1612
1613        Generally, when you sort by spam tag, mutt will sort _\bl_\be_\bx_\bi_\bc_\ba_\bl_\bl_\by -- that is, by
1614        ordering strings alphnumerically. However, if a spam tag begins with a number,
1615        mutt will sort numerically first, and lexically only when two numbers are equal
1616        in value. (This is like UNIX's sort -n.) A message with no spam attributes at
1617        all -- that is, one that didn't match _\ba_\bn_\by of your spam patterns -- is sorted at
1618        lowest priority. Numbers are sorted next, beginning with 0 and ranging upward.
1619        Finally, non-numeric strings are sorted, with ``a'' taking lower priority than
1620        ``z''. Clearly, in general, sorting by spam tags is most effective when you can
1621        coerce your filter to give you a raw number. But in case you can't, mutt can
1622        still do something useful.
1623
1624        The nospam command can be used to write exceptions to spam patterns. If a
1625        header pattern matches something in a spam command, but you nonetheless do not
1626        want it to receive a spam tag, you can list a more precise pattern under a
1627        nospam command.
1628
1629        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-
1630        ing spam list entry, the effect will be to remove the entry from the spam list,
1631        instead of adding an exception.  Likewise, if the _\bp_\ba_\bt_\bt_\be_\br_\bn for a spam command
1632        matches an entry on the nospam list, that nospam entry will be removed. If the
1633        _\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
1634        might be the default action if you use spam and nospam in conjunction with a
1635        folder-hook.
1636
1637        You can have as many spam or nospam commands as you like.  You can even do your
1638        own primitive spam detection within mutt -- for example, if you consider all
1639        mail from MAILER-DAEMON to be spam, you can use a spam command like this:
1640
1641             spam "^From: .*MAILER-DAEMON"       "999"
1642
1643        _\b3_\b._\b2_\b5  _\bS_\be_\bt_\bt_\bi_\bn_\bg _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
1644
1645        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 ... ]
1646
1647        Usage: toggle _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
1648
1649        Usage: unset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
1650
1651        Usage: reset _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
1652
1653        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 6.3  ,
1654        page 65).  There are four basic types of variables: boolean, number, string and
1655        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
1656        variables can be assigned a positive integer value.
1657
1658        _\bs_\bt_\br_\bi_\bn_\bg variables consist of any number of printable characters.  _\bs_\bt_\br_\bi_\bn_\bg_\bs must
1659        be enclosed in quotes if they contain spaces or tabs.  You may also use the
1660        ``C'' escape sequences \\b\n\bn and \\b\t\bt for newline and tab, respectively.
1661
1662        The Mutt-ng E-Mail Client                                                    32
1663
1664        _\bq_\bu_\ba_\bd_\bo_\bp_\bt_\bi_\bo_\bn variables are used to control whether or not to be prompted for cer-
1665        tain actions, or to specify a default action.  A value of _\by_\be_\bs will cause the
1666        action to be carried out automatically as if you had answered yes to the ques-
1667        tion.  Similarly, a value of _\bn_\bo will cause the the action to be carried out as
1668        if you had answered ``no.''  A value of _\ba_\bs_\bk_\b-_\by_\be_\bs will cause a prompt with a
1669        default answer of ``yes'' and _\ba_\bs_\bk_\b-_\bn_\bo will provide a default answer of ``no.''
1670
1671        Prefixing a variable with ``no'' will unset it.  Example: set noaskbcc.
1672
1673        For _\bb_\bo_\bo_\bl_\be_\ba_\bn variables, you may optionally prefix the variable name with inv to
1674        toggle the value (on or off).  This is useful when writing macros.  Example:
1675        set invsmart_wrap.
1676
1677        The toggle command automatically prepends the inv prefix to all specified vari-
1678        ables.
1679
1680        The unset command automatically prepends the no prefix to all specified vari-
1681        ables.
1682
1683        Using the enter-command function in the _\bi_\bn_\bd_\be_\bx menu, you can query the value of
1684        a variable by prefixing the name of the variable with a question mark:
1685
1686             set ?allow_8bit
1687
1688        The question mark is actually only required for boolean and quadoption vari-
1689        ables.
1690
1691        The reset command resets all given variables to the compile time defaults
1692        (hopefully mentioned in this manual). If you use the command set and prefix the
1693        variable with ``&'' this has the same behavior as the reset command.
1694
1695        With the reset command there exists the special variable ``all'', which allows
1696        you to reset all variables to their system defaults.
1697
1698        _\b3_\b._\b2_\b6  _\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
1699
1700        Usage: source _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
1701
1702        This command allows the inclusion of initialization commands from other files.
1703        For example, I place all of my aliases in ~/.mail_aliases so that I can make my
1704        ~/.muttrc readable and keep my aliases private.
1705
1706        If the filename begins with a tilde (``~''), it will be expanded to the path of
1707        your home directory.
1708
1709        If the filename ends with a vertical bar (|), then _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be is considered to be
1710        an executable program from which to read input (eg.  source ~/bin/myscript|).
1711
1712        _\b3_\b._\b2_\b7  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\bi_\bn_\bg _\bf_\be_\ba_\bt_\bu_\br_\be_\bs _\bc_\bo_\bn_\bd_\bi_\bt_\bi_\bo_\bn_\ba_\bl_\bl_\by
1713
1714        Usage: ifdef _\bi_\bt_\be_\bm _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1715
1716        The Mutt-ng E-Mail Client                                                    33
1717
1718        Usage: ifndef _\bi_\bt_\be_\bm _\bc_\bo_\bm_\bm_\ba_\bn_\bd
1719
1720        These commands allow testing for a variable, function or certain feature being
1721        available or not respectively, before actually executing the command given.
1722
1723        ifdef (short for ``if defined'') only executes the command upon availability
1724        while ifndef (short for ``if not defined'') does if not. The _\bc_\bo_\bm_\bm_\ba_\bn_\bd may be any
1725        valid fraction of a configuration file.
1726
1727        All names of variables, functions and menus may be tested. Additionally, the
1728        following compile-features may be tested when prefixed with 'feature_':
1729        ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, gnutls,
1730        sasl, sasl2, libesmtp, compressed, color, classic_pgp, classic_smime, gpgme,
1731        header_cache, gdbm, qdbm and db4.
1732
1733        Examples follow.
1734
1735        To only source a file with IMAP related settings if IMAP support is compiled
1736        in, use:
1737
1738             ifdef feature_imap 'source ~/.mutt-ng/imap_setup'
1739             # or
1740             # ifdef imap_user 'source ~/.mutt-ng/imap_setup'
1741             # or
1742             # ...
1743
1744        To exit mutt-ng directly if no NNTP support is compiled in:
1745
1746             ifndef feature_nntp 'push q'
1747             # or
1748             # ifndef newsrc 'push q'
1749             # or
1750             # ...
1751
1752        To only set the _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.99  , page 88) variable if the
1753        system's mutt-ng is aware of it, use:
1754
1755             ifdef imap_mail_check 'set imap_mail_check=500'
1756
1757        _\b3_\b._\b2_\b8  _\bR_\be_\bm_\bo_\bv_\bi_\bn_\bg _\bh_\bo_\bo_\bk_\bs
1758
1759        Usage: unhook [ * | _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be ]
1760
1761        This command permits you to flush hooks you have previously defined.  You can
1762        either remove all hooks by giving the ``*'' character as an argument, or you
1763        can remove all hooks of a specific type by saying something like unhook send-
1764        hook.
1765
1766        _\b4_\b.  _\bA_\bd_\bv_\ba_\bn_\bc_\be_\bd _\bU_\bs_\ba_\bg_\be
1767
1768        The Mutt-ng E-Mail Client                                                    34
1769
1770        _\b4_\b._\b1  _\bR_\be_\bg_\bu_\bl_\ba_\br _\bE_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn_\bs
1771
1772        All string patterns in Mutt-ng including those in more complex _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
1773        tion 4.2  , page 36) must be specified using regular expressions (regexp) in
1774        the ``POSIX extended'' syntax (which is more or less the syntax used by egrep
1775        and GNU awk).  For your convenience, we have included below a brief description
1776        of this syntax.
1777
1778        The search is case sensitive if the pattern contains at least one upper case
1779        letter, and case insensitive otherwise. Note that ``\'' must be quoted if used
1780        for a regular expression in an initialization command: ``\\''.
1781
1782        A regular expression is a pattern that describes a set of strings.  Regular
1783        expressions are constructed analogously to arithmetic expressions, by using
1784        various operators to combine smaller expressions.
1785
1786        Note that the regular expression can be enclosed/delimited by either ' or '
1787        which is useful if the regular expression includes a white-space character.
1788        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.1  , page 14) for more informa-
1789        tion on ' and ' delimiter processing.  To match a literal ' or ' you must pref-
1790        ace it with \ (backslash).
1791
1792        The fundamental building blocks are the regular expressions that match a single
1793        character.  Most characters, including all letters and digits, are regular
1794        expressions that match themselves.  Any metacharacter with special meaning may
1795        be quoted by preceding it with a backslash.
1796
1797        The period ``.'' matches any single character.  The caret ``^'' and the dollar
1798        sign ``$'' are metacharacters that respectively match the empty string at the
1799        beginning and end of a line.
1800
1801        A list of characters enclosed by ``['' and ``]'' matches any single character
1802        in that list; if the first character of the list is a caret ``^'' then it
1803        matches any character n\bno\bot\bt in the list.  For example, the regular expression
1804        [\b[0\b01\b12\b23\b34\b45\b56\b67\b78\b89\b9]\b] matches any single digit.  A range of ASCII characters may be
1805        specified by giving the first and last characters, separated by a hyphen ``-''.
1806        Most metacharacters lose their special meaning inside lists.  To include a lit-
1807        eral ``]'' place it first in the list.  Similarly, to include a literal ``^''
1808        place it anywhere but first.  Finally, to include a literal hyphen ``-'' place
1809        it last.
1810
1811        Certain named classes of characters are predefined.  Character classes consist
1812        of ``[:'', a keyword denoting the class, and ``:]''.  The following classes are
1813        defined by the POSIX standard:
1814
1815              [:alnum:]
1816                    Alphanumeric characters.
1817
1818              [:alpha:]
1819                    Alphabetic characters.
1820
1821              [:blank:]
1822                    Space or tab characters.
1823
1824        The Mutt-ng E-Mail Client                                                    35
1825
1826              [:cntrl:]
1827                    Control characters.
1828
1829              [:digit:]
1830                    Numeric characters.
1831
1832              [:graph:]
1833                    Characters that are both printable and visible.  (A space is print-
1834                    able, but not visible, while an ``a'' is both.)
1835
1836              [:lower:]
1837                    Lower-case alphabetic characters.
1838
1839              [:print:]
1840                    Printable characters (characters that are not control characters.)
1841
1842              [:punct:]
1843                    Punctuation characters (characters that are not letter, digits,
1844                    control characters, or space characters).
1845
1846              [:space:]
1847                    Space characters (such as space, tab and formfeed, to name a few).
1848
1849              [:upper:]
1850                    Upper-case alphabetic characters.
1851
1852              [:xdigit:]
1853                    Characters that are hexadecimal digits.
1854
1855        A character class is only valid in a regular expression inside the brackets of
1856        a character list.  Note that the brackets in these class names are part of the
1857        symbolic names, and must be included in addition to the brackets delimiting the
1858        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].
1859
1860        Two additional special sequences can appear in character lists.  These apply to
1861        non-ASCII character sets, which can have single symbols (called collating ele-
1862        ments) that are represented with more than one character, as well as several
1863        characters that are equivalent for collating or sorting purposes:
1864
1865              Collating Symbols
1866                    A collating symbol is a multi-character collating element enclosed
1867                    in ``[.'' and ``.]''.  For example, if ``ch'' is a collating ele-
1868                    ment, then [\b[[\b[.\b.c\bch\bh.\b.]\b]]\b] is a regexp that matches this collating ele-
1869                    ment, while [\b[c\bch\bh]\b] is a regexp that matches either ``c'' or ``h''.
1870
1871              Equivalence Classes
1872                    An equivalence class is a locale-specific name for a list of char-
1873                    acters that are equivalent. The name is enclosed in ``[='' and
1874                    ``=]''.  For example, the name ``e'' might be used to represent all
1875                    of ``'' ``'' and ``e''.  In this case, [\b[[\b[=\b=e\be=\b=]\b]]\b] is a regexp that
1876                    matches any of ``'', ``'' and ``e''.
1877
1878        A regular expression matching a single character may be followed by one of sev-
1879        eral repetition operators:
1880
1881        The Mutt-ng E-Mail Client                                                    36
1882
1883              ?
1884                    The preceding item is optional and matched at most once.
1885
1886              *
1887                    The preceding item will be matched zero or more times.
1888
1889              +
1890                    The preceding item will be matched one or more times.
1891
1892              {n}
1893                    The preceding item is matched exactly _\bn times.
1894
1895              {n,}
1896                    The preceding item is matched _\bn or more times.
1897
1898              {,m}
1899                    The preceding item is matched at most _\bm times.
1900
1901              {n,m}
1902                    The preceding item is matched at least _\bn times, but no more than _\bm
1903                    times.
1904
1905        Two regular expressions may be concatenated; the resulting regular expression
1906        matches any string formed by concatenating two substrings that respectively
1907        match the concatenated subexpressions.
1908
1909        Two regular expressions may be joined by the infix operator ``|''; the result-
1910        ing regular expression matches any string matching either subexpression.
1911
1912        Repetition takes precedence over concatenation, which in turn takes precedence
1913        over alternation.  A whole subexpression may be enclosed in parentheses to
1914        override these precedence rules.
1915
1916        N\bNo\bot\bte\be:\b: If you compile Mutt-ng with the GNU _\br_\bx package, the following operators
1917        may also be used in regular expressions:
1918
1919              \\y
1920                    Matches the empty string at either the beginning or the end of a
1921                    word.
1922
1923              \\B
1924                    Matches the empty string within a word.
1925
1926              \\<
1927                    Matches the empty string at the beginning of a word.
1928
1929              \\>
1930                    Matches the empty string at the end of a word.
1931
1932              \\w
1933                    Matches any word-constituent character (letter, digit, or under-
1934                    score).
1935
1936        The Mutt-ng E-Mail Client                                                    37
1937
1938              \\W
1939                    Matches any character that is not word-constituent.
1940
1941              \\`
1942                    Matches the empty string at the beginning of a buffer (string).
1943
1944              \\'
1945                    Matches the empty string at the end of a buffer.
1946
1947        Please note however that these operators are not defined by POSIX, so they may
1948        or may not be available in stock libraries on various systems.
1949
1950        _\b4_\b._\b2  _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
1951
1952        Many of Mutt-ng's commands allow you to specify a pattern to match (limit, tag-
1953        pattern, delete-pattern, etc.).  There are several ways to select messages:
1954
1955        The Mutt-ng E-Mail Client                                                    38
1956
1957             ~A              all messages
1958             ~b EXPR         messages which contain EXPR in the message body
1959             ~B EXPR         messages which contain EXPR in the whole message
1960             ~c USER         messages carbon-copied to USER
1961             ~C EXPR         message is either to: or cc: EXPR
1962             ~D              deleted messages
1963             ~d [MIN]-[MAX]  messages with ``date-sent'' in a Date range
1964             ~E              expired messages
1965             ~e EXPR         message which contains EXPR in the ``Sender'' field
1966             ~F              flagged messages
1967             ~f USER         messages originating from USER
1968             ~g              cryptographically signed messages
1969             ~G              cryptographically encrypted messages
1970             ~H EXPR         messages with a spam attribute matching EXPR
1971             ~h EXPR         messages which contain EXPR in the message header
1972             ~k              message contains PGP key material
1973             ~i ID           message which match ID in the ``Message-ID'' field
1974             ~L EXPR         message is either originated or received by EXPR
1975             ~l              message is addressed to a known mailing list
1976             ~m [MIN]-[MAX]  message in the range MIN to MAX *)
1977             ~n [MIN]-[MAX]  messages with a score in the range MIN to MAX *)
1978             ~N              new messages
1979             ~O              old messages
1980             ~p              message is addressed to you (consults alternates)
1981             ~P              message is from you (consults alternates)
1982             ~Q              messages which have been replied to
1983             ~R              read messages
1984             ~r [MIN]-[MAX]  messages with ``date-received'' in a Date range
1985             ~S              superseded messages
1986             ~s SUBJECT      messages having SUBJECT in the ``Subject'' field.
1987             ~T              tagged messages
1988             ~t USER         messages addressed to USER
1989             ~U              unread messages
1990             ~v              message is part of a collapsed thread.
1991             ~V              cryptographically verified messages
1992             ~w EXPR         messages which contain EXPR in the `Newsgroups' field
1993                             (if compiled with NNTP support)
1994             ~x EXPR         messages which contain EXPR in the `References' field
1995             ~y EXPR         messages which contain EXPR in the `X-Label' field
1996             ~z [MIN]-[MAX]  messages with a size in the range MIN to MAX *)
1997             ~=              duplicated messages (see $duplicate_threads)
1998             ~$              unreferenced messages (requires threaded view)
1999             ~*              ``From'' contains realname and (syntactically) valid
2000                             address (excluded are addresses matching against
2001                             alternates or any alias)
2002
2003        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
2004        33).  Special attention has to be made when using regular expressions inside of
2005        patterns.  Specifically, Mutt-ng's parser for these patterns will strip one
2006        level of backslash (\), which is normally used for quoting.  If it is your
2007        intention to use a backslash in the regular expression, you will need to use
2008        two backslashes instead (\\).
2009
2010        The Mutt-ng E-Mail Client                                                    39
2011
2012        *) The forms <[MAX], >[MIN], [MIN]- and -[MAX] are allowed, too.
2013
2014        _\b4_\b._\b2_\b._\b1  _\bP_\ba_\bt_\bt_\be_\br_\bn _\bM_\bo_\bd_\bi_\bf_\bi_\be_\br
2015
2016        Note that patterns matching 'lists' of addresses (notably c,C,p,P and t) match
2017        if there is at least one match in the whole list. If you want to make sure that
2018        all elements of that list match, you need to prefix your pattern with ^.  This
2019        example matches all mails which only has recipients from Germany.
2020
2021             ^~C \.de$
2022
2023        _\b4_\b._\b2_\b._\b2  _\bC_\bo_\bm_\bp_\bl_\be_\bx _\bP_\ba_\bt_\bt_\be_\br_\bn_\bs
2024
2025        Logical AND is performed by specifying more than one criterion.  For example:
2026
2027             ~t mutt ~f elkins
2028
2029        would select messages which contain the word ``mutt'' in the list of recipients
2030        a\ban\bnd\bd that have the word ``elkins'' in the ``From'' header field.
2031
2032        Mutt-ng also recognizes the following operators to create more complex search
2033        patterns:
2034
2035           +\bo ! -- logical NOT operator
2036
2037           +\bo | -- logical OR operator
2038
2039           +\bo () -- logical grouping operator
2040
2041        Here is an example illustrating a complex search pattern.  This pattern will
2042        select all messages which do not contain ``mutt'' in the ``To'' or ``Cc'' field
2043        and which are from ``elkins''.
2044
2045             !(~t mutt|~c mutt) ~f elkins
2046
2047        Here is an example using white space in the regular expression (note the ' and
2048        ' delimiters).  For this to match, the mail's subject must match the ``^Junk
2049        +From +Me$'' and it must be from either ``Jim +Somebody'' or ``Ed +Some-
2050        oneElse'':
2051
2052              '~s "^Junk +From +Me$" ~f ("Jim +Somebody"|"Ed +SomeoneElse")'
2053
2054        Note that if a regular expression contains parenthesis, or a vertical bar
2055        ("|"), you m\bmu\bus\bst\bt enclose the expression in double or single quotes since those
2056        characters are also used to separate different parts of Mutt-ng's pattern lan-
2057        guage.  For example,
2058
2059        The Mutt-ng E-Mail Client                                                    40
2060
2061             ~f "me@(mutt\.org|cs\.hmc\.edu)"
2062
2063        Without the quotes, the parenthesis wouldn't end.  This would be separated to
2064        two OR'd patterns: _\b~_\bf _\bm_\be_\b@_\b(_\bm_\bu_\bt_\bt_\b\_\b._\bo_\br_\bg and _\bc_\bs_\b\_\b._\bh_\bm_\bc_\b\_\b._\be_\bd_\bu_\b). They are never what you
2065        want.
2066
2067        _\b4_\b._\b2_\b._\b3  _\bS_\be_\ba_\br_\bc_\bh_\bi_\bn_\bg _\bb_\by _\bD_\ba_\bt_\be
2068
2069        Mutt-ng supports two types of dates, _\ba_\bb_\bs_\bo_\bl_\bu_\bt_\be and _\br_\be_\bl_\ba_\bt_\bi_\bv_\be.
2070
2071        A\bAb\bbs\bso\bol\blu\but\bte\be.  Dates m\bmu\bus\bst\bt be in DD/MM/YY format (month and year are optional,
2072        defaulting to the current month and year).  An example of a valid range of
2073        dates is:
2074
2075             Limit to messages matching: ~d 20/1/95-31/10
2076
2077        If you omit the minimum (first) date, and just specify ``-DD/MM/YY'', all mes-
2078        sages _\bb_\be_\bf_\bo_\br_\be the given date will be selected.  If you omit the maximum (second)
2079        date, and specify ``DD/MM/YY-'', all messages _\ba_\bf_\bt_\be_\br the given date will be
2080        selected.  If you specify a single date with no dash (``-''), only messages
2081        sent on the given date will be selected.
2082
2083        E\bEr\brr\bro\bor\br M\bMa\bar\brg\bgi\bin\bns\bs.  You can add error margins to absolute dates.  An error margin
2084        is a sign (+ or -), followed by a digit, followed by one of the following
2085        units:
2086
2087             y    years
2088             m    months
2089             w    weeks
2090             d    days
2091
2092        As a special case, you can replace the sign by a ``*'' character, which is
2093        equivalent to giving identical plus and minus error margins.
2094
2095        Example: To select any messages two weeks around January 15, 2001, you'd use
2096        the following pattern:
2097
2098             Limit to messages matching: ~d 15/1/2001*2w
2099
2100        R\bRe\bel\bla\bat\bti\biv\bve\be.  This type of date is relative to the current date, and may be speci-
2101        fied as:
2102
2103           +\bo >_\bo_\bf_\bf_\bs_\be_\bt (messages older than _\bo_\bf_\bf_\bs_\be_\bt units)
2104
2105           +\bo <_\bo_\bf_\bf_\bs_\be_\bt (messages newer than _\bo_\bf_\bf_\bs_\be_\bt units)
2106
2107           +\bo =_\bo_\bf_\bf_\bs_\be_\bt (messages exactly _\bo_\bf_\bf_\bs_\be_\bt units old)
2108
2109        The Mutt-ng E-Mail Client                                                    41
2110
2111        _\bo_\bf_\bf_\bs_\be_\bt is specified as a positive number with one of the following units:
2112
2113             y       years
2114             m       months
2115             w       weeks
2116             d       days
2117
2118        Example: to select messages less than 1 month old, you would use
2119
2120             Limit to messages matching: ~d <1m
2121
2122        N\bNo\bot\bte\be:\b: all dates used when searching are relative to the l\blo\boc\bca\bal\bl time zone, so
2123        unless you change the setting of your _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page
2124        90) to include a %[...] format, these are n\bno\bot\bt the dates shown in the main
2125        index.
2126
2127        _\b4_\b._\b3  _\bU_\bs_\bi_\bn_\bg _\bT_\ba_\bg_\bs
2128
2129        Sometimes it is desirable to perform an operation on a group of messages all at
2130        once rather than one at a time.  An example might be to save messages to a
2131        mailing list to a separate folder, or to delete all messages with a given sub-
2132        ject.  To tag all messages matching a pattern, use the tag-pattern function,
2133        which is bound to ``shift-T'' by default.  Or you can select individual mes-
2134        sages by hand using the ``tag-message'' function, which is bound to ``t'' by
2135        default.  See _\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 4.2  , page 36) for Mutt-ng's pattern matching
2136        syntax.
2137
2138        Once you have tagged the desired messages, you can use the ``tag-prefix'' oper-
2139        ator, which is the ``;'' (semicolon) key by default.  When the ``tag-prefix''
2140        operator is used, the n\bne\bex\bxt\bt operation will be applied to all tagged messages if
2141        that operation can be used in that manner.  If the _\b$_\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg (section 6.3.16  ,
2142        page 69) variable is set, the next operation applies to the tagged messages
2143        automatically, without requiring the ``tag-prefix''.
2144
2145        In _\bm_\ba_\bc_\br_\bo_\bs (section 3.6  , page 20) or _\bp_\bu_\bs_\bh (section 3.21  , page 29) commands,
2146        you can use the ``tag-prefix-cond'' operator.  If there are no tagged messages,
2147        mutt will "eat" the rest of the macro to abort it's execution.  Mutt-ng will
2148        stop "eating" the macro when it encounters the ``end-cond'' operator;  after
2149        this operator the rest of the macro will be executed as normal.
2150
2151        _\b4_\b._\b4  _\bU_\bs_\bi_\bn_\bg _\bH_\bo_\bo_\bk_\bs
2152
2153        A _\bh_\bo_\bo_\bk is a concept borrowed from the EMACS editor which allows you to execute
2154        arbitrary commands before performing some operation.  For example, you may wish
2155        to tailor your configuration based upon which mailbox you are reading, or to
2156        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
2157        _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 33) or _\bp_\ba_\bt_\bt_\be_\br_\bn (section 4.2  , page 36) along
2158        with a configuration option/command.  See
2159
2160           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.5  , page 19)
2161
2162        The Mutt-ng E-Mail Client                                                    42
2163
2164           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 27)
2165
2166           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 28)
2167
2168           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.15  , page 26)
2169
2170           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.11  , page 25)
2171
2172           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.16  , page 27)
2173
2174           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 27)
2175
2176        for specific details on each type of _\bh_\bo_\bo_\bk available.
2177
2178        N\bNo\bot\bte\be:\b: if a hook changes configuration settings, these changes remain effective
2179        until the end of the current mutt session. As this is generally not desired, a
2180        default hook needs to be added before all other hooks to restore configuration
2181        defaults. Here is an example with send-hook and the my_hdr directive:
2182
2183             send-hook . 'unmy_hdr From:'
2184             send-hook ~C'^b@b\.b$' my_hdr from: c@c.c
2185
2186        _\b4_\b._\b4_\b._\b1  _\bM_\be_\bs_\bs_\ba_\bg_\be _\bM_\ba_\bt_\bc_\bh_\bi_\bn_\bg _\bi_\bn _\bH_\bo_\bo_\bk_\bs
2187
2188        Hooks that act upon messages (send-hook, save-hook, fcc-hook, message-hook) are
2189        evaluated in a slightly different manner.  For the other types of hooks, a _\br_\be_\bg_\b-
2190        _\bu_\bl_\ba_\br _\be_\bx_\bp_\br_\be_\bs_\bs_\bi_\bo_\bn (section 4.1  , page 33) is sufficient.  But in dealing with
2191        messages a finer grain of control is needed for matching since for different
2192        purposes you want to match different criteria.
2193
2194        Mutt-ng allows the use of the _\bs_\be_\ba_\br_\bc_\bh _\bp_\ba_\bt_\bt_\be_\br_\bn (section 4.2  , page 36) language
2195        for matching messages in hook commands.  This works in exactly the same way as
2196        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
2197        to those operators which match information mutt extracts from the header of the
2198        message (i.e.  from, to, cc, date, subject, etc.).
2199
2200        For example, if you wanted to set your return address based upon sending mail
2201        to a specific address, you could do something like:
2202
2203             send-hook '~t ^me@cs\.hmc\.edu$' 'my_hdr From: Mutt-ng User <user@host>'
2204
2205        which would execute the given command when sending mail to _\bm_\be_\b@_\bc_\bs_\b._\bh_\bm_\bc_\b._\be_\bd_\bu.
2206
2207        However, it is not required that you write the pattern to match using the full
2208        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
2209        other hooks, in which case Mutt-ng will translate your pattern into the full
2210        language, using the translation specified by the _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section
2211        6.3.45  , page 75) variable.  The pattern is translated at the time the hook is
2212        declared, so the value of _\b$_\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk (section 6.3.45  , page 75) that is in
2213        effect at that time will be used.
2214
2215        The Mutt-ng E-Mail Client                                                    43
2216
2217        _\b4_\b._\b5  _\bU_\bs_\bi_\bn_\bg _\bt_\bh_\be _\bs_\bi_\bd_\be_\bb_\ba_\br
2218
2219        The sidebar, a feature specific to Mutt-ng, allows you to use a mailbox listing
2220        which looks very similar to the ones you probably know from GUI mail clients.
2221        The sidebar lists all specified mailboxes, shows the number in each and high-
2222        lights the ones with new email Use the following configuration commands:
2223
2224             set sidebar_visible="yes"
2225             set sidebar_width=25
2226
2227        If you want to specify the mailboxes you can do so with:
2228
2229             set mbox='=INBOX'
2230             mailboxes INBOX \
2231                       MBOX1 \
2232                       MBOX2 \
2233                       ...
2234
2235        You can also specify the colors for mailboxes with new mails by using:
2236
2237             color sidebar_new red black
2238             color sidebar white black
2239
2240        The available functions are:
2241
2242             sidebar-scroll-up      Scrolls the mailbox list up 1 page
2243             sidebar-scroll-down    Scrolls the mailbox list down 1 page
2244             sidebar-next           Highlights the next mailbox
2245             sidebar-next-new       Highlights the next mailbox with new mail
2246             sidebar-previous       Highlights the previous mailbox
2247             sidebar-open           Opens the currently highlighted mailbox
2248
2249        Reasonable key bindings look e.g. like this:
2250
2251             bind index \Cp sidebar-prev
2252             bind index \Cn sidebar-next
2253             bind index \Cb sidebar-open
2254             bind pager \Cp sidebar-prev
2255             bind pager \Cn sidebar-next
2256             bind pager \Cb sidebar-open
2257
2258             macro index B ':toggle sidebar_visible^M'
2259             macro pager B ':toggle sidebar_visible^M'
2260
2261        You can then go up and down by pressing Ctrl-P and Ctrl-N, and switch on and
2262        off the sidebar simply by pressing 'B'.
2263
2264        _\b4_\b._\b6  _\bE_\bx_\bt_\be_\br_\bn_\ba_\bl _\bA_\bd_\bd_\br_\be_\bs_\bs _\bQ_\bu_\be_\br_\bi_\be_\bs
2265
2266        The Mutt-ng E-Mail Client                                                    44
2267
2268        Mutt-ng supports connecting to external directory databases such as LDAP,
2269        ph/qi, bbdb, or NIS through a wrapper script which connects to mutt using a
2270        simple interface.  Using the _\b$_\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 6.3.221  , page 118) vari-
2271        able, you specify the wrapper command to use.  For example:
2272
2273             set query_command = "mutt_ldap_query.pl '%s'"
2274
2275        The wrapper script should accept the query on the command-line.  It should
2276        return a one line message, then each matching response on a single line, each
2277        line containing a tab separated address then name then some other optional
2278        information.  On error, or if there are no matching addresses, return a non-
2279        zero exit code and a one line error message.
2280
2281        An example multiple response output:
2282
2283             Searching database ... 20 entries ... 3 matching:
2284             me@cs.hmc.edu           Michael Elkins  mutt dude
2285             blong@fiction.net       Brandon Long    mutt and more
2286             roessler@guug.de        Thomas Roessler mutt pgp
2287
2288        There are two mechanisms for accessing the query function of mutt.  One is to
2289        do a query from the index menu using the query function (default: Q).  This
2290        will prompt for a query, then bring up the query menu which will list the
2291        matching responses.  From the query menu, you can select addresses to create
2292        aliases, or to mail.  You can tag multiple addresses to mail, start a new
2293        query, or have a new query appended to the current responses.
2294
2295        The other mechanism for accessing the query function is for address completion,
2296        similar to the alias completion.  In any prompt for address entry, you can use
2297        the complete-query function (default: ^T) to run a query based on the current
2298        address you have typed.  Like aliases, mutt will look for what you have typed
2299        back to the last space or comma.  If there is a single response for that query,
2300        mutt will expand the address in place.  If there are multiple responses, mutt
2301        will activate the query menu.  At the query menu, you can select one or more
2302        addresses to be added to the prompt.
2303
2304        _\b4_\b._\b7  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bF_\bo_\br_\bm_\ba_\bt_\bs
2305
2306        Mutt-ng supports reading and writing of four different mailbox formats: mbox,
2307        MMDF, MH and Maildir.  The mailbox type is autodetected, so there is no need to
2308        use a flag for different mailbox types.  When creating new mailboxes, Mutt-ng
2309        uses the default specified with the _\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 6.3.125  , page 95)
2310        variable.
2311
2312        m\bmb\bbo\box\bx.  This is the most widely used mailbox format for UNIX.  All messages are
2313        stored in a single file.  Each message has a line of the form:
2314
2315             From me@cs.hmc.edu Fri, 11 Apr 1997 11:44:56 PST
2316
2317        The Mutt-ng E-Mail Client                                                    45
2318
2319        to denote the start of a new message (this is often referred to as the
2320        ``From_'' line).
2321
2322        M\bMM\bMD\bDF\bF.  This is a variant of the _\bm_\bb_\bo_\bx format.  Each message is surrounded by
2323        lines containing ``^A^A^A^A'' (four control-A's).
2324
2325        M\bMH\bH. A radical departure from _\bm_\bb_\bo_\bx and _\bM_\bM_\bD_\bF, a mailbox consists of a directory
2326        and each message is stored in a separate file.  The filename indicates the mes-
2327        sage number (however, this is may not correspond to the message number Mutt-ng
2328        displays). Deleted messages are renamed with a comma (,) prepended to the file-
2329        name. N\bNo\bot\bte\be:\b: Mutt detects this type of mailbox by looking for either
2330        .mh_sequences or .xmhcache (needed to distinguish normal directories from MH
2331        mailboxes).
2332
2333        M\bMa\bai\bil\bld\bdi\bir\br.  The newest of the mailbox formats, used by the Qmail MTA (a replace-
2334        ment for sendmail).  Similar to _\bM_\bH, except that it adds three subdirectories of
2335        the mailbox: _\bt_\bm_\bp, _\bn_\be_\bw and _\bc_\bu_\br.  Filenames for the messages are chosen in such a
2336        way they are unique, even when two programs are writing the mailbox over NFS,
2337        which means that no file locking is needed.
2338
2339        _\b4_\b._\b8  _\bM_\ba_\bi_\bl_\bb_\bo_\bx _\bS_\bh_\bo_\br_\bt_\bc_\bu_\bt_\bs
2340
2341        There are a number of built in shortcuts which refer to specific mailboxes.
2342        These shortcuts can be used anywhere you are prompted for a file or mailbox
2343        path.
2344
2345           +\bo ! -- refers to your _\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 6.3.295  , page 136) (incoming)
2346             mailbox
2347
2348           +\bo > -- refers to your _\b$_\bm_\bb_\bo_\bx (section 6.3.124  , page 95) file
2349
2350           +\bo < -- refers to your _\b$_\br_\be_\bc_\bo_\br_\bd (section 6.3.230  , page 120) file
2351
2352           +\bo ^ -- refers to the current mailbox
2353
2354           +\bo - or !! -- refers to the file you've last visited
2355
2356           +\bo ~ -- refers to your home directory
2357
2358           +\bo = or + -- refers to your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 6.3.64  , page 79) directory
2359
2360           +\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.15  , page 26) as
2361             determined by the address of the alias
2362
2363        _\b4_\b._\b9  _\bH_\ba_\bn_\bd_\bl_\bi_\bn_\bg _\bM_\ba_\bi_\bl_\bi_\bn_\bg _\bL_\bi_\bs_\bt_\bs
2364
2365        Mutt-ng has a few configuration options that make dealing with large amounts of
2366        mail easier.  The first thing you must do is to let Mutt know what addresses
2367        you consider to be mailing lists (technically this does not have to be a mail-
2368        ing list, but that is what it is most often used for), and what lists you are
2369        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
2370        (section 3.10  , page 24) commands in your muttrc.
2371
2372        Now that Mutt-ng knows what your mailing lists are, it can do several things,
2373
2374        The Mutt-ng E-Mail Client                                                    46
2375
2376        the first of which is the ability to show the name of a list through which you
2377        received a message (i.e., of a subscribed list) in the _\bi_\bn_\bd_\be_\bx menu display.
2378        This is useful to distinguish between personal and list mail in the same mail-
2379        box.  In the _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90) variable, the escape
2380        ``%L'' will return the string ``To <list>'' when ``list'' appears in the ``To''
2381        field, and ``Cc <list>'' when it appears in the ``Cc'' field (otherwise it
2382        returns the name of the author).
2383
2384        Often times the ``To'' and ``Cc'' fields in mailing list messages tend to get
2385        quite large. Most people do not bother to remove the author of the message they
2386        are reply to from the list, resulting in two or more copies being sent to that
2387        person.  The ``list-reply'' function, which by default is bound to ``L'' in the
2388        _\bi_\bn_\bd_\be_\bx menu and _\bp_\ba_\bg_\be_\br, helps reduce the clutter by only replying to the known
2389        mailing list addresses instead of all recipients (except as specified by Mail-
2390        Followup-To, see below).
2391
2392        Mutt-ng also supports the Mail-Followup-To header.  When you send a message to
2393        a list of recipients which includes one or several subscribed mailing lists,
2394        and if the _\b$_\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo (section 6.3.66  , page 80) option is set, mutt will
2395        generate a Mail-Followup-To header which contains all the recipients to whom
2396        you send this message, but not your address. This indicates that group-replies
2397        or list-replies (also known as ``followups'') to this message should only be
2398        sent to the original recipients of the message, and not separately to you -
2399        you'll receive your copy through one of the mailing lists you are subscribed
2400        to.
2401
2402        Conversely, when group-replying or list-replying to a message which has a Mail-
2403        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
2404        (section 6.3.88  , page 85) configuration variable is set.  Using list-reply
2405        will in this case also make sure that the reply goes to the mailing list, even
2406        if it's not specified in the list of recipients in the Mail-Followup-To.
2407
2408        Note that, when header editing is enabled, you can create a Mail-Followup-To
2409        header manually.  Mutt-ng will only auto-generate this header if it doesn't
2410        exist when you send the message.
2411
2412        The other method some mailing list admins use is to generate a ``Reply-To''
2413        field which points back to the mailing list address rather than the author of
2414        the message.  This can create problems when trying to reply directly to the
2415        author in private, since most mail clients will automatically reply to the
2416        address given in the ``Reply-To'' field.  Mutt-ng uses the _\b$_\br_\be_\bp_\bl_\by_\b__\bt_\bo (section
2417        6.3.233  , page 121) variable to help decide which address to use.  If set to
2418        _\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
2419        use the address given in the ``Reply-To'' field, or reply directly to the
2420        address given in the ``From'' field.  When set to _\by_\be_\bs, the ``Reply-To'' field
2421        will be used when present.
2422
2423        The ``X-Label:'' header field can be used to further identify mailing lists or
2424        list subject matter (or just to annotate messages individually).  The
2425        _\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90) variable's ``%y'' and ``%Y'' escapes
2426        can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's pattern-
2427        matcher can match regular expressions to ``X-Label:'' fields with the `` y''
2428        selector.  ``X-Label:'' is not a standard message header field, but it can eas-
2429        ily be inserted by procmail and other mail filtering agents.
2430
2431        The Mutt-ng E-Mail Client                                                    47
2432
2433        Lastly, Mutt-ng has the ability to _\bs_\bo_\br_\bt (section 6.3.289  , page 134) the mail-
2434        box into _\bt_\bh_\br_\be_\ba_\bd_\bs (section 2.3.3  , page 7).  A thread is a group of messages
2435        which all relate to the same subject.  This is usually organized into a tree-
2436        like structure where a message and all of its replies are represented graphi-
2437        cally.  If you've ever used a threaded news client, this is the same concept.
2438        It makes dealing with large volume mailing lists easier because you can easily
2439        delete uninteresting threads and quickly find topics of value.
2440
2441        _\b4_\b._\b1_\b0  _\bE_\bd_\bi_\bt_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2442
2443        Mutt-ng has the ability to dynamically restructure threads that are broken
2444        either by misconfigured software or bad behavior from some correspondents. This
2445        allows to clean your mailboxes formats) from these annoyances which make it
2446        hard to follow a discussion.
2447
2448        _\b4_\b._\b1_\b0_\b._\b1  _\bL_\bi_\bn_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2449
2450        Some mailers tend to "forget" to correctly set the "In-Reply-To:" and "Refer-
2451        ences:" headers when replying to a message. This results in broken discussions
2452        because Mutt-ng has not enough information to guess the correct threading.  You
2453        can fix this by tagging the reply, then moving to the parent message and using
2454        the ``link-threads'' function (bound to & by default). The reply will then be
2455        connected to this "parent" message.
2456
2457        You can also connect multiple children at once, tagging them and using the tag-
2458        prefix command (';') or the auto_tag option.
2459
2460        _\b4_\b._\b1_\b0_\b._\b2  _\bB_\br_\be_\ba_\bk_\bi_\bn_\bg _\bt_\bh_\br_\be_\ba_\bd_\bs
2461
2462        On mailing lists, some people are in the bad habit of starting a new discussion
2463        by hitting "reply" to any message from the list and changing the subject to a
2464        totally unrelated one.  You can fix such threads by using the ``break-thread''
2465        function (bound by default to #), which will turn the subthread starting from
2466        the current message into a whole different thread.
2467
2468        _\b4_\b._\b1_\b1  _\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
2469
2470        RFC1894 defines a set of MIME content types for relaying information about the
2471        status of electronic mail messages.  These can be thought of as ``return
2472        receipts.'' Berkeley sendmail 8.8.x currently has some command line options in
2473        which the mail client can make requests as to what type of status messages
2474        should be returned.
2475
2476        To support this, there are two variables. _\b$_\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by (section 6.3.51  , page
2477        76) is used to request receipts for different results (such as failed message,
2478        message delivered, etc.).  _\b$_\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn (section 6.3.52  , page 76) requests how
2479        much of your message should be returned with the receipt (headers or full mes-
2480        sage).  Refer to the man page on sendmail for more details on DSN.
2481
2482        _\b4_\b._\b1_\b2  _\bP_\bO_\bP_\b3 _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
2483
2484        If Mutt-ng was compiled with POP3 support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
2485        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
2486        remote POP3 server and fetch mail for local browsing.
2487
2488        The Mutt-ng E-Mail Client                                                    48
2489
2490        You can access the remote POP3 mailbox by selecting the folder
2491        pop://popserver/.
2492
2493        You can select an alternative port by specifying it with the server, i.e.:
2494        pop://popserver:port/.
2495
2496        You can also specify different username for each folder, i.e.: pop://user-
2497        name@popserver[:port]/.
2498
2499        Polling for new mail is more expensive over POP3 than locally. For this reason
2500        the frequency at which Mutt-ng will check for mail remotely can be controlled
2501        by the _\b$_\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.208  , page 115) variable, which defaults
2502        to every 60 seconds.
2503
2504        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
2505        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to POP3 servers can be encrypted. This natu-
2506        rally requires that the server supports SSL encrypted connections. To access a
2507        folder with POP3/SSL, you should use pops: prefix, ie: pops://[user-
2508        name@]popserver[:port]/.
2509
2510        Another way to access your POP3 mail is the _\bf_\be_\bt_\bc_\bh_\b-_\bm_\ba_\bi_\bl function (default: G).
2511        It allows to connect to _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt (section 6.3.206  , page 115), fetch all your
2512        new mail and place it in the local _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 6.3.295  , page 136).
2513        After this point, Mutt-ng runs exactly as if the mail had always been local.
2514
2515        N\bNo\bot\bte\be:\b: If you only need to fetch all messages to local mailbox you should con-
2516        sider using a specialized program, such as fetchmail
2517
2518        _\b4_\b._\b1_\b3  _\bI_\bM_\bA_\bP _\bS_\bu_\bp_\bp_\bo_\br_\bt _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
2519
2520        If Mutt-ng was compiled with IMAP support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
2521        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
2522        remote IMAP server.
2523
2524        You can access the remote inbox by selecting the folder
2525        imap://imapserver/INBOX, where imapserver is the name of the IMAP server and
2526        INBOX is the special name for your spool mailbox on the IMAP server. If you
2527        want to access another mail folder at the IMAP server, you should use
2528        imap://imapserver/path/to/folder where path/to/folder is the path of the folder
2529        you want to access.
2530
2531        You can select an alternative port by specifying it with the server, i.e.:
2532        imap://imapserver:port/INBOX.
2533
2534        You can also specify different username for each folder, i.e.: imap://user-
2535        name@imapserver[:port]/INBOX.
2536
2537        If Mutt-ng was compiled with SSL support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\bu_\br_\be script with
2538        the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\bs_\bl flag), connections to IMAP servers can be encrypted. This natu-
2539        rally requires that the server supports SSL encrypted connections. To access a
2540        folder with IMAP/SSL, you should use imaps://[user-
2541        name@]imapserver[:port]/path/to/folder as your folder path.
2542
2543        Pine-compatible notation is also supported, i.e.
2544
2545        The Mutt-ng E-Mail Client                                                    49
2546
2547        {[username@]imapserver[:port][/ssl]}path/to/folder
2548
2549        Note that not all servers use / as the hierarchy separator.  Mutt-ng should
2550        correctly notice which separator is being used by the server and convert paths
2551        accordingly.
2552
2553        When browsing folders on an IMAP server, you can toggle whether to look at only
2554        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
2555        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 6.3.97  , page 87) vari-
2556        able.
2557
2558        Polling for new mail on an IMAP server can cause noticeable delays. So, you'll
2559        want to carefully tune the _\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.99  , page 88) and
2560        _\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 6.3.318  , page 142) variables.
2561
2562        Note that if you are using mbox as the mail store on UW servers prior to
2563        v12.250, the server has been reported to disconnect a client if another client
2564        selects the same folder.
2565
2566        _\b4_\b._\b1_\b3_\b._\b1  _\bT_\bh_\be _\bF_\bo_\bl_\bd_\be_\br _\bB_\br_\bo_\bw_\bs_\be_\br
2567
2568        As of version 1.2, mutt supports browsing mailboxes on an IMAP server. This is
2569        mostly the same as the local file browser, with the following differences:
2570
2571           +\bo Instead of file permissions, mutt displays the string "IMAP", possibly
2572             followed by the symbol "+", indicating that the entry contains both mes-
2573             sages and subfolders. On Cyrus-like servers folders will often contain
2574             both messages and subfolders.
2575
2576           +\bo For the case where an entry can contain both messages and subfolders, the
2577             selection key (bound to enter by default) will choose to descend into the
2578             subfolder view. If you wish to view the messages in that folder, you must
2579             use view-file instead (bound to space by default).
2580
2581           +\bo You can create, delete and rename mailboxes with the create-mailbox,
2582             delete-mailbox, and rename-mailbox commands (default bindings: C, d and r,
2583             respectively). You may also subscribe and unsubscribe to mailboxes (nor-
2584             mally these are bound to s and u, respectively).
2585
2586        _\b4_\b._\b1_\b3_\b._\b2  _\bA_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bi_\bo_\bn
2587
2588        Mutt-ng supports four authentication methods with IMAP servers: SASL, GSSAPI,
2589        CRAM-MD5, and LOGIN (there is a patch by Grant Edwards to add NTLM authentica-
2590        tion for you poor exchange users out there, but it has yet to be integrated
2591        into the main tree). There is also support for the pseudo-protocol ANONYMOUS,
2592        which allows you to log in to a public IMAP server without having an account.
2593        To use ANONYMOUS, simply make your username blank or "anonymous".
2594
2595        SASL is a special super-authenticator, which selects among several protocols
2596        (including GSSAPI, CRAM-MD5, ANONYMOUS, and DIGEST-MD5) the most secure method
2597        available on your host and the server. Using some of these methods (including
2598        DIGEST-MD5 and possibly GSSAPI), your entire session will be encrypted and
2599        invisible to those teeming network snoops. It is the best option if you have
2600        it. To use it, you must have the Cyrus SASL library installed on your system
2601
2602        The Mutt-ng E-Mail Client                                                    50
2603
2604        and compile mutt with the _\b-_\b-_\bw_\bi_\bt_\bh_\b-_\bs_\ba_\bs_\bl flag.
2605
2606        Mutt-ng will try whichever methods are compiled in and available on the server,
2607        in the following order: SASL, ANONYMOUS, GSSAPI, CRAM-MD5, LOGIN.
2608
2609        There are a few variables which control authentication:
2610
2611           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 6.3.105  , page 89) - controls the username under
2612             which you request authentication on the IMAP server, for all authentica-
2613             tors. This is overridden by an explicit username in the mailbox path (i.e.
2614             by using a mailbox name of the form {user@host}).
2615
2616           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs (section 6.3.100  , page 88) - a password which you may preset,
2617             used by all authentication methods where a password is needed.
2618
2619           +\bo _\b$_\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs (section 6.3.91  , page 85) - a colon-delimited list
2620             of IMAP authentication methods to try, in the order you wish to try them.
2621             If specified, this overrides mutt's default (attempt everything, in the
2622             order listed above).
2623
2624        _\b4_\b._\b1_\b4  _\bM_\ba_\bn_\ba_\bg_\bi_\bn_\bg _\bm_\bu_\bl_\bt_\bi_\bp_\bl_\be _\bI_\bM_\bA_\bP_\b/_\bP_\bO_\bP _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\bs _\b(_\bO_\bP_\bT_\bI_\bO_\bN_\bA_\bL_\b)
2625
2626        If you happen to have accounts on multiple IMAP and/or POP servers, you may
2627        find managing all the authentication settings inconvenient and error-prone.
2628        The account-hook command may help. This hook works like folder-hook but is
2629        invoked whenever you access a remote mailbox (including inside the folder
2630        browser), not just when you open the mailbox.
2631
2632        Some examples:
2633
2634             account-hook . 'unset imap_user; unset imap_pass; unset tunnel'
2635             account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo'
2636             account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"'
2637
2638        _\b4_\b._\b1_\b5  _\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)
2639
2640        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
2641        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
2642        start a WWW browser on one of them.  This functionality is provided by the
2643        external urlview program which can be retrieved at ftp://ftp.mutt.org/mutt/con-
2644        trib/ and the configuration commands:
2645
2646             macro index \cb |urlview\n
2647             macro pager \cb |urlview\n
2648
2649        _\b4_\b._\b1_\b6  _\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)
2650
2651        If Mutt-ng was compiled with compressed folders support (by running the _\bc_\bo_\bn_\bf_\bi_\bg_\b-
2652        _\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
2653        an arbitrary format, provided that the user has a script to convert from/to
2654        this format to one of the accepted.
2655
2656        The Mutt-ng E-Mail Client                                                    51
2657
2658        The most common use is to open compressed archived folders e.g. with gzip.
2659
2660        In addition, the user can provide a script that gets a folder in an accepted
2661        format and appends its context to the folder in the user-defined format, which
2662        may be faster than converting the entire folder to the accepted format, append-
2663        ing to it and converting back to the user-defined format.
2664
2665        There are three hooks defined (_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.16.1  , page 50), _\bc_\bl_\bo_\bs_\be_\b-
2666        _\bh_\bo_\bo_\bk (section 4.16.2  , page 51) and _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.16.3  , page 51))
2667        which define commands to uncompress and compress a folder and to append mes-
2668        sages to an existing compressed folder respectively.
2669
2670        For example:
2671
2672             open-hook \\.gz$ "gzip -cd %f > %t"
2673             close-hook \\.gz$ "gzip -c %t > %f"
2674             append-hook \\.gz$ "gzip -c %t >> %f"
2675
2676        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-
2677        tion 4.16.3  , page 51), the folder will be open and closed again each time you
2678        will add to it. If you omit _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.16.2  , page 51) (or give
2679        empty command) , the folder will be open in the  mode. If you specify _\ba_\bp_\bp_\be_\bn_\bd_\b-
2680        _\bh_\bo_\bo_\bk (section 4.16.3  , page 51) though you'll be able to append to the folder.
2681
2682        Note that Mutt-ng will only try to use hooks if the file is not in one of the
2683        accepted formats. In particular, if the file is empty, mutt supposes it is not
2684        compressed. This is important because it allows the use of programs that do not
2685        have well defined extensions. Just use '.' as a regexp. But this may be sur-
2686        prising if your compressing script produces empty files. In this situation,
2687        unset _\b$_\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by (section 6.3.240  , page 123), so that the compressed file
2688        will be removed if you delete all of the messages.
2689
2690        _\b4_\b._\b1_\b6_\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
2691
2692        Usage: open-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
2693
2694        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd is the command that can be used for opening the folders whose names
2695        match _\br_\be_\bg_\be_\bx_\bp.
2696
2697        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the printf-like format string, and it should accept two
2698        parameters: %f, which is replaced with the (compressed) folder name, and %t
2699        which is replaced with the name of the temporary folder to which to write.
2700
2701        %f and %t can be repeated any number of times in the command string, and all of
2702        the entries are replaced with the appropriate folder name. In addition, %% is
2703        replaced by %, as in printf, and any other %anything is left as is.
2704
2705        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
2706        return non-zero exit status if it fails, so mutt knows something's wrong.
2707
2708        Example:
2709
2710        The Mutt-ng E-Mail Client                                                    52
2711
2712             open-hook \\.gz$ "gzip -cd %f > %t"
2713
2714        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type.
2715
2716        _\b4_\b._\b1_\b6_\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
2717
2718        Usage: close-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
2719
2720        This is used to close the folder that was open with the _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
2721        4.16.1  , page 50) command after some changes were made to it.
2722
2723        The _\bc_\bo_\bm_\bm_\ba_\bn_\bd string is the command that can be used for closing the folders
2724        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
2725        4.16.1  , page 50) command. Temporary folder in this case is the folder previ-
2726        ously produced by the <_\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.16.1  , page 50) command.
2727
2728        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
2729        non-zero exit status if it fails, so mutt knows something's wrong.
2730
2731        Example:
2732
2733             close-hook \\.gz$ "gzip -c %t > %f"
2734
2735        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type, and the
2736        file can only be open in the readonly mode.
2737
2738        _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.16.2  , page 51) is not called when you exit from the
2739        folder if the folder was not changed.
2740
2741        _\b4_\b._\b1_\b6_\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
2742
2743        Usage: append-hook _\br_\be_\bg_\be_\bx_\bp '_\bc_\bo_\bm_\bm_\ba_\bn_\bd'
2744
2745        This command is used for saving to an existing compressed folder.  The _\bc_\bo_\bm_\bm_\ba_\bn_\bd
2746        is the command that can be used for appending to the folders whose names match
2747        _\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.16.1  , page 50)
2748        command.  The temporary folder in this case contains the messages that are
2749        being appended.
2750
2751        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
2752        non-zero exit status if it fails, so mutt knows something's wrong.
2753
2754        Example:
2755
2756             append-hook \\.gz$ "gzip -c %t >> %f"
2757
2758        When _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.16.3  , page 51) is used, the folder is not opened,
2759        which saves time, but this means that we can not find out what the folder type
2760        is. Thus the default (_\b$_\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be (section 6.3.125  , page 95)) type is always
2761
2762        The Mutt-ng E-Mail Client                                                    53
2763
2764        supposed (i.e.  this is the format used for the temporary folder).
2765
2766        If the file does not exist when you save to it, _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.16.2  ,
2767        page 51) is called, and not _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.16.3  , page 51). _\ba_\bp_\bp_\be_\bn_\bd_\b-
2768        _\bh_\bo_\bo_\bk (section 4.16.3  , page 51) is only for appending to existing folders.
2769
2770        If the _\bc_\bo_\bm_\bm_\ba_\bn_\bd is empty, this operation is disabled for this file type. In this
2771        case, the folder will be open and closed again (using _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section
2772        4.16.1  , page 50) and _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.16.2  , page 51)respectively) each
2773        time you will add to it.
2774
2775        _\b4_\b._\b1_\b6_\b._\b4  _\bE_\bn_\bc_\br_\by_\bp_\bt_\be_\bd _\bf_\bo_\bl_\bd_\be_\br_\bs
2776
2777        The compressed folders support can also be used to handle encrypted folders. If
2778        you want to encrypt a folder with PGP, you may want to use the following hooks:
2779
2780             open-hook  \\.pgp$ "pgp -f < %f > %t"
2781             close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f"
2782
2783        Please note, that PGP does not support appending to an encrypted folder, so
2784        there is no append-hook defined.
2785
2786        N\bNo\bot\bte\be:\b: the folder is temporary stored decrypted in the /tmp directory, where it
2787        can be read by your system administrator. So think about the security aspects
2788        of this.
2789
2790        _\b5_\b.  _\bM_\bu_\bt_\bt_\b-_\bn_\bg_\b'_\bs _\bM_\bI_\bM_\bE _\bS_\bu_\bp_\bp_\bo_\br_\bt
2791
2792        Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME
2793        MUA.  Every effort has been made to provide the functionality that the discern-
2794        ing MIME user requires, and the conformance to the standards wherever possible.
2795        When configuring Mutt-ng for MIME, there are two extra types of configuration
2796        files which Mutt-ng uses.  One is the mime.types file, which contains the map-
2797        ping of file extensions to IANA MIME types.  The other is the mailcap file,
2798        which specifies the external commands to use for handling specific MIME types.
2799
2800        _\b5_\b._\b1  _\bU_\bs_\bi_\bn_\bg _\bM_\bI_\bM_\bE _\bi_\bn _\bM_\bu_\bt_\bt
2801
2802        There are three areas/menus in Mutt-ng which deal with MIME, they are the pager
2803        (while viewing a message), the attachment menu and the compose menu.
2804
2805        _\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
2806
2807        When you select a message from the index and view it in the pager, Mutt decodes
2808        the message to a text representation.  Mutt-ng internally supports a number of
2809        MIME types, including text/plain, text/enriched, message/rfc822, and mes-
2810        sage/news.  In addition, the export controlled version of Mutt-ng recognizes a
2811        variety of PGP MIME types, including PGP/MIME and application/pgp.
2812
2813        Mutt-ng will denote attachments with a couple lines describing them.  These
2814        lines are of the form:
2815
2816        The Mutt-ng E-Mail Client                                                    54
2817
2818             [-- Attachment #1: Description --]
2819             [-- Type: text/plain, Encoding: 7bit, Size: 10000 --]
2820
2821        Where the Description is the description or filename given for the attachment,
2822        and the Encoding is one of 7bit/8bit/quoted-printable/base64/binary.
2823
2824        If Mutt-ng cannot deal with a MIME type, it will display a message like:
2825
2826             [-- image/gif is unsupported (use 'v' to view this part) --]
2827
2828        _\b5_\b._\b1_\b._\b2  _\bT_\bh_\be _\bA_\bt_\bt_\ba_\bc_\bh_\bm_\be_\bn_\bt _\bM_\be_\bn_\bu
2829
2830        The default binding for view-attachments is `v', which displays the attachment
2831        menu for a message.  The attachment menu displays a list of the attachments in
2832        a message.  From the attachment menu, you can save, print, pipe, delete, and
2833        view attachments.  You can apply these operations to a group of attachments at
2834        once, by tagging the attachments and by using the ``tag-prefix'' operator.  You
2835        can also reply to the current message from this menu, and only the current
2836        attachment (or the attachments tagged) will be quoted in your reply.  You can
2837        view attachments as text, or view them using the mailcap viewer definition.
2838
2839        Finally, you can apply the usual message-related functions (like _\br_\be_\bs_\be_\bn_\bd_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be
2840        (section 2.3.4  , page 9), and the reply and forward functions) to attachments
2841        of type message/rfc822.
2842
2843        See the help on the attachment menu for more information.
2844
2845        _\b5_\b._\b1_\b._\b3  _\bT_\bh_\be _\bC_\bo_\bm_\bp_\bo_\bs_\be _\bM_\be_\bn_\bu
2846
2847        The compose menu is the menu you see before you send a message.  It allows you
2848        to edit the recipient list, the subject, and other aspects of your message.  It
2849        also contains a list of the attachments of your message, including the main
2850        body.  From this menu, you can print, copy, filter, pipe, edit, compose,
2851        review, and rename an attachment or a list of tagged attachments.  You can also
2852        modifying the attachment information, notably the type, encoding and descrip-
2853        tion.
2854
2855        Attachments appear as follows:
2856
2857             -   1 [text/plain, 7bit, 1K]             /tmp/mutt-euler-8082-0 <no description>
2858                 2 [applica/x-gunzip, base64, 422K]   ~/src/mutt-0.85.tar.gz <no description>
2859
2860        The '-' denotes that Mutt-ng will delete the file after sending (or postponing,
2861        or canceling) the message.  It can be toggled with the toggle-unlink command
2862        (default: u).  The next field is the MIME content-type, and can be changed with
2863        the edit-type command (default: ^T).  The next field is the encoding for the
2864        attachment, which allows a binary message to be encoded for transmission on
2865        7bit links.  It can be changed with the edit-encoding command (default: ^E).
2866        The next field is the size of the attachment, rounded to kilobytes or
2867        megabytes.  The next field is the filename, which can be changed with the
2868        rename-file command (default: R).  The final field is the description of the
2869
2870        The Mutt-ng E-Mail Client                                                    55
2871
2872        attachment, and can be changed with the edit-description command (default: d).
2873
2874        _\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
2875
2876        When you add an attachment to your mail message, Mutt-ng searches your personal
2877        mime.types file at ${HOME}/.mime.types, and then the system mime.types file at
2878        /usr/local/share/mutt/mime.types or /etc/mime.types
2879
2880        The mime.types file consist of lines containing a MIME type and a space sepa-
2881        rated list of extensions.  For example:
2882
2883             application/postscript          ps eps
2884             application/pgp                 pgp
2885             audio/x-aiff                    aif aifc aiff
2886
2887        A sample mime.types file comes with the Mutt-ng distribution, and should con-
2888        tain most of the MIME types you are likely to use.
2889
2890        If Mutt-ng can not determine the mime type by the extension of the file you
2891        attach, it will look at the file.  If the file is free of binary information,
2892        Mutt-ng will assume that the file is plain text, and mark it as text/plain.  If
2893        the file contains binary information, then Mutt-ng will mark it as applica-
2894        tion/octet-stream.  You can change the MIME type that Mutt-ng assigns to an
2895        attachment by using the edit-type command from the compose menu (default: ^T).
2896        The MIME type is actually a major mime type followed by the sub-type, separated
2897        by a '/'. 6 major types: application, text, image, video, audio, and model have
2898        been approved after various internet discussions. Mutt-ng recognises all of
2899        these if the appropriate entry is found in the mime.types file. It also recog-
2900        nises other major mime types, such as the chemical type that is widely used in
2901        the molecular modelling community to pass molecular data in various forms to
2902        various molecular viewers. Non-recognised mime types should only be used if the
2903        recipient of the message is likely to be expecting such attachments.
2904
2905        _\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
2906
2907        Mutt-ng supports RFC 1524 MIME Configuration, in particular the Unix specific
2908        format specified in Appendix A of RFC 1524.  This file format is commonly
2909        referred to as the mailcap format.  Many MIME compliant programs utilize the
2910        mailcap format, allowing you to specify handling for all MIME types in one
2911        place for all programs.  Programs known to use this format include Netscape,
2912        XMosaic, lynx and metamail.
2913
2914        In order to handle various MIME types that Mutt-ng can not handle internally,
2915        Mutt-ng parses a series of external configuration files to find an external
2916        handler.  The default search string for these files is a colon delimited list
2917        set to
2918
2919             ${HOME}/.mailcap:/usr/local/share/mutt/mailcap:/etc/mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
2920
2921        where $HOME is your home directory.
2922
2923        In particular, the metamail distribution will install a mailcap file, usually
2924
2925        The Mutt-ng E-Mail Client                                                    56
2926
2927        as /usr/local/etc/mailcap, which contains some baseline entries.
2928
2929        _\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
2930
2931        A mailcap file consists of a series of lines which are comments, blank, or def-
2932        initions.
2933
2934        A comment line consists of a # character followed by anything you want.
2935
2936        A blank line is blank.
2937
2938        A definition line consists of a content type, a view command, and any number of
2939        optional fields.  Each field of a definition line is divided by a semicolon ';'
2940        character.
2941
2942        The content type is specified in the MIME standard type/subtype method.  For
2943        example, text/plain, text/html, image/gif, etc.  In addition, the mailcap for-
2944        mat includes two formats for wildcards, one using the special '*' subtype, the
2945        other is the implicit wild, where you only include the major type.  For exam-
2946        ple, image/*, or video, will match all image types and video types, respec-
2947        tively.
2948
2949        The view command is a Unix command for viewing the type specified. There are
2950        two different types of commands supported. The default is to send the body of
2951        the MIME message to the command on stdin. You can change this behavior by using
2952        %s as a parameter to your view command.  This will cause Mutt-ng to save the
2953        body of the MIME message to a temporary file, and then call the view command
2954        with the %s replaced by the name of the temporary file. In both cases, Mutt-ng
2955        will turn over the terminal to the view program until the program quits, at
2956        which time Mutt will remove the temporary file if it exists.
2957
2958        So, in the simplest form, you can send a text/plain message to the external
2959        pager more on stdin:
2960
2961             text/plain; more
2962
2963        Or, you could send the message as a file:
2964
2965             text/plain; more %s
2966
2967        Perhaps you would like to use lynx to interactively view a text/html message:
2968
2969             text/html; lynx %s
2970
2971        In this case, lynx does not support viewing a file from stdin, so you must use
2972        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
2973        _\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
2974        _\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
2975        _\bv_\bi_\be_\bw _\bt_\bh_\be _\bo_\bb_\bj_\be_\bc_\bt_\b.
2976
2977        On the other hand, maybe you don't want to use lynx interactively, you just
2978
2979        The Mutt-ng E-Mail Client                                                    57
2980
2981        want to have it convert the text/html to text/plain, then you can use:
2982
2983             text/html; lynx -dump %s | more
2984
2985        Perhaps you wish to use lynx to view text/html files, and a pager on all other
2986        text formats, then you would use the following:
2987
2988             text/html; lynx %s
2989             text/*; more
2990
2991        This is the simplest form of a mailcap file.
2992
2993        _\b5_\b._\b3_\b._\b2  _\bS_\be_\bc_\bu_\br_\be _\bu_\bs_\be _\bo_\bf _\bm_\ba_\bi_\bl_\bc_\ba_\bp
2994
2995        The interpretation of shell meta-characters embedded in MIME parameters can
2996        lead to security problems in general.  Mutt-ng tries to quote parameters in
2997        expansion of %s syntaxes properly, and avoids risky characters by substituting
2998        them, see the _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be (section 6.3.117  , page 94) variable.
2999
3000        Although mutt's procedures to invoke programs with mailcap seem to be safe,
3001        there are other applications parsing mailcap, maybe taking less care of it.
3002        Therefore you should pay attention to the following rules:
3003
3004        _\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
3005        double quotes.  Mutt-ng does this for you, the right way, as should any other
3006        program which interprets mailcap.  Don't put them into backtick expansions.  Be
3007        highly careful with eval statements, and avoid them if possible at all.  Trying
3008        to fix broken behaviour with quotes introduces new leaks - there is no alterna-
3009        tive to correct quoting in the first place.
3010
3011        If you have to use the %-expandos' values in context where you need quoting or
3012        backtick expansions, put that value into a shell variable and reference the
3013        shell variable where necessary, as in the following example (using $charset
3014        inside the backtick expansion is safe, since it is not itself subject to any
3015        further expansion):
3016
3017             text/test-mailcap-bug; cat %s; copiousoutput; test=charset=%{charset} \
3018                     && test "`echo $charset | tr '[A-Z]' '[a-z]'`" != iso-8859-1
3019
3020        _\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
3021
3022        _\b5_\b._\b3_\b._\b3_\b._\b1  _\bO_\bp_\bt_\bi_\bo_\bn_\ba_\bl _\bF_\bi_\be_\bl_\bd_\bs
3023
3024        In addition to the required content-type and view command fields, you can add
3025        semi-colon ';' separated fields to set flags and other options.  Mutt-ng recog-
3026        nizes the following optional fields:
3027
3028              copiousoutput
3029                    This flag tells Mutt-ng that the command passes possibly large
3030                    amounts of text on stdout.  This causes Mutt-ng to invoke a pager
3031
3032        The Mutt-ng E-Mail Client                                                    58
3033
3034                    (either the internal pager or the external pager defined by the
3035                    pager variable) on the output of the view command.  Without this
3036                    flag, Mutt-ng assumes that the command is interactive.  One could
3037                    use this to replace the pipe to more in the lynx -dump example in
3038                    the Basic section:
3039
3040                         text/html; lynx -dump %s ; copiousoutput
3041
3042                    This will cause lynx to format the text/html output as text/plain
3043                    and Mutt-ng will use your standard pager to display the results.
3044
3045              needsterminal
3046                    Mutt-ng uses this flag when viewing attachments with _\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw (sec-
3047                    tion 5.4  , page 60), in order to decide whether it should honor
3048                    the setting of the _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 6.3.332  , page 145) variable
3049                    or not.  When an attachment is viewed using an interactive program,
3050                    and the corresponding mailcap entry has a _\bn_\be_\be_\bd_\bs_\bt_\be_\br_\bm_\bi_\bn_\ba_\bl flag, Mutt-
3051                    ng will use _\b$_\bw_\ba_\bi_\bt_\b__\bk_\be_\by (section 6.3.332  , page 145) and the exit
3052                    status of the program to decide if it will ask you to press a key
3053                    after the external program has exited.  In all other situations it
3054                    will not prompt you for a key.
3055
3056              compose=<command>
3057                    This flag specifies the command to use to create a new attachment
3058                    of a specific MIME type.  Mutt-ng supports this from the compose
3059                    menu.
3060
3061              composetyped=<command>
3062                    This flag specifies the command to use to create a new attachment
3063                    of a specific MIME type.  This command differs from the compose
3064                    command in that mutt will expect standard MIME headers on the data.
3065                    This can be used to specify parameters, filename, description, etc.
3066                    for a new attachment.   Mutt-ng supports this from the compose
3067                    menu.
3068
3069              print=<command>
3070                    This flag specifies the command to use to print a specific MIME
3071                    type.  Mutt-ng supports this from the attachment and compose menus.
3072
3073              edit=<command>
3074                    This flag specifies the command to use to edit a specific MIME
3075                    type.  Mutt-ng supports this from the compose menu, and also uses
3076                    it to compose new attachments.  Mutt-ng will default to the defined
3077                    editor for text attachments.
3078
3079              nametemplate=<template>
3080                    This field specifies the format for the file denoted by %s in the
3081                    command fields.  Certain programs will require a certain file
3082                    extension, for instance, to correctly view a file.  For instance,
3083                    lynx will only interpret a file as text/html if the file ends in
3084                    .html.  So, you would specify lynx as a text/html viewer with a
3085                    line in the mailcap file like:
3086
3087        The Mutt-ng E-Mail Client                                                    59
3088
3089                         text/html; lynx %s; nametemplate=%s.html
3090
3091              test=<command>
3092                    This field specifies a command to run to test whether this mailcap
3093                    entry should be used.  The command is defined with the command
3094                    expansion rules defined in the next section.  If the command
3095                    returns 0, then the test passed, and Mutt-ng uses this entry.  If
3096                    the command returns non-zero, then the test failed, and Mutt-ng
3097                    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
3098                    _\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:
3099
3100                         text/html; netscape -remote 'openURL(%s)' ; test=RunningX
3101                         text/html; lynx %s
3102
3103                    In this example, Mutt-ng will run the program RunningX which will
3104                    return 0 if the X Window manager is running, and non-zero if it
3105                    isn't.  If RunningX returns 0, then Mutt-ng will call netscape to
3106                    display the text/html object.  If RunningX doesn't return 0, then
3107                    Mutt-ng will go on to the next entry and use lynx to display the
3108                    text/html object.
3109
3110        _\b5_\b._\b3_\b._\b3_\b._\b2  _\bS_\be_\ba_\br_\bc_\bh _\bO_\br_\bd_\be_\br
3111
3112        When searching for an entry in the mailcap file, Mutt-ng will search for the
3113        most useful entry for its purpose.  For instance, if you are attempting to
3114        print an image/gif, and you have the following entries in your mailcap file,
3115        Mutt-ng will search for an entry with the print command:
3116
3117             image/*;        xv %s
3118             image/gif;      ; print= anytopnm %s | pnmtops | lpr; \
3119                             nametemplate=%s.gif
3120
3121        Mutt-ng will skip the image/* entry and use the image/gif entry with the print
3122        command.
3123
3124        In addition, you can use this with _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 60) to denote
3125        two commands for viewing an attachment, one to be viewed automatically, the
3126        other to be viewed interactively from the attachment menu.  In addition, you
3127        can then use the test feature to determine which viewer to use interactively
3128        depending on your environment.
3129
3130             text/html;      netscape -remote 'openURL(%s)' ; test=RunningX
3131             text/html;      lynx %s; nametemplate=%s.html
3132             text/html;      lynx -dump %s; nametemplate=%s.html; copiousoutput
3133
3134        For _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw (section 5.4  , page 60), Mutt-ng will choose the third entry
3135        because of the copiousoutput tag.  For interactive viewing, Mutt will run the
3136        program RunningX to determine if it should use the first entry.  If the program
3137        returns non-zero, Mutt-ng will use the second entry for interactive viewing.
3138
3139        The Mutt-ng E-Mail Client                                                    60
3140
3141        _\b5_\b._\b3_\b._\b3_\b._\b3  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bE_\bx_\bp_\ba_\bn_\bs_\bi_\bo_\bn
3142
3143        The various commands defined in the mailcap files are passed to the /bin/sh
3144        shell using the system() function.  Before the command is passed to /bin/sh -c,
3145        it is parsed to expand various special parameters with information from Mutt-
3146        ng.  The keywords Mutt-ng expands are:
3147
3148              %s
3149                    As seen in the basic mailcap section, this variable is expanded to
3150                    a filename specified by the calling program.  This file contains
3151                    the body of the message to view/print/edit or where the composing
3152                    program should place the results of composition.  In addition, the
3153                    use of this keyword causes Mutt-ng to not pass the body of the mes-
3154                    sage to the view/print/edit program on stdin.
3155
3156              %t
3157                    Mutt-ng will expand %t to the text representation of the content
3158                    type of the message in the same form as the first parameter of the
3159                    mailcap definition line, ie text/html or image/gif.
3160
3161              %{<parameter>}
3162                    Mutt-ng will expand this to the value of the specified parameter
3163                    from the Content-Type: line of the mail message.  For instance, if
3164                    Your mail message contains:
3165
3166                         Content-Type: text/plain; charset=iso-8859-1
3167
3168                    then Mutt-ng will expand %{charset} to iso-8859-1.  The default
3169                    metamail mailcap file uses this feature to test the charset to
3170                    spawn an xterm using the right charset to view the message.
3171
3172              \%
3173                    This will be replaced by a %
3174
3175        Mutt-ng does not currently support the %F and %n keywords specified in RFC
3176        1524.  The main purpose of these parameters is for multipart messages, which is
3177        handled internally by Mutt-ng.
3178
3179        _\b5_\b._\b3_\b._\b4  _\bE_\bx_\ba_\bm_\bp_\bl_\be _\bm_\ba_\bi_\bl_\bc_\ba_\bp _\bf_\bi_\bl_\be_\bs
3180
3181        This mailcap file is fairly simple and standard:
3182
3183             # I'm always running X :)
3184             video/*;        xanim %s > /dev/null
3185             image/*;        xv %s > /dev/null
3186
3187             # I'm always running netscape (if my computer had more memory, maybe)
3188             text/html;      netscape -remote 'openURL(%s)'
3189
3190        This mailcap file shows quite a number of examples:
3191
3192        The Mutt-ng E-Mail Client                                                    61
3193
3194             # Use xanim to view all videos   Xanim produces a header on startup,
3195             # send that to /dev/null so I don't see it
3196             video/*;        xanim %s > /dev/null
3197
3198             # Send html to a running netscape by remote
3199             text/html;      netscape -remote 'openURL(%s)'; test=RunningNetscape
3200
3201             # If I'm not running netscape but I am running X, start netscape on the
3202             # object
3203             text/html;      netscape %s; test=RunningX
3204
3205             # Else use lynx to view it as text
3206             text/html;      lynx %s
3207
3208             # This version would convert the text/html to text/plain
3209             text/html;      lynx -dump %s; copiousoutput
3210
3211             # I use enscript to print text in two columns to a page
3212             text/*;         more %s; print=enscript -2Gr %s
3213
3214             # Netscape adds a flag to tell itself to view jpegs internally
3215             image/jpeg;xv %s; x-mozilla-flags=internal
3216
3217             # Use xv to view images if I'm running X
3218             # In addition, this uses the \ to extend the line and set my editor
3219             # for images
3220             image/*;xv %s; test=RunningX; \
3221                     edit=xpaint %s
3222
3223             # Convert images to text using the netpbm tools
3224             image/*;  (anytopnm %s | pnmscale -xysize 80 46 | ppmtopgm | pgmtopbm |
3225             pbmtoascii -1x2 ) 2>&1 ; copiousoutput
3226
3227             # Send excel spreadsheets to my NT box
3228             application/ms-excel; open.pl %s
3229
3230        _\b5_\b._\b4  _\bM_\bI_\bM_\bE _\bA_\bu_\bt_\bo_\bv_\bi_\be_\bw
3231
3232        In addition to explicitly telling Mutt-ng to view an attachment with the MIME
3233        viewer defined in the mailcap file, Mutt-ng has support for automatically view-
3234        ing MIME attachments while in the pager.
3235
3236        To work, you must define a viewer in the mailcap file which uses the copi-
3237        ousoutput option to denote that it is non-interactive.  Usually, you also use
3238        the entry to convert the attachment to a text representation which you can view
3239        in the pager.
3240
3241        You then use the auto_view muttrc command to list the content-types that you
3242        wish to view automatically.
3243
3244        For instance, if you set auto_view to:
3245
3246             auto_view text/html application/x-gunzip application/postscript image/gif application/x-tar-gz
3247
3248        The Mutt-ng E-Mail Client                                                    62
3249
3250        Mutt-ng could use the following mailcap entries to automatically view attach-
3251        ments of these types.
3252
3253             text/html;      lynx -dump %s; copiousoutput; nametemplate=%s.html
3254             image/*;        anytopnm %s | pnmscale -xsize 80 -ysize 50 | ppmtopgm | pgmtopbm | pbmtoascii ; copiousoutput
3255             application/x-gunzip;   gzcat; copiousoutput
3256             application/x-tar-gz; gunzip -c %s | tar -tf - ; copiousoutput
3257             application/postscript; ps2ascii %s; copiousoutput
3258
3259        ``unauto_view'' can be used to remove previous entries from the autoview list.
3260        This can be used with message-hook to autoview messages based on size, etc.
3261        ``unauto_view *'' will remove all previous entries.
3262
3263        _\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
3264
3265        Mutt-ng has some heuristics for determining which attachment of a multi-
3266        part/alternative type to display.  First, mutt will check the alternative_order
3267        list to determine if one of the available types is preferred.  The alterna-
3268        tive_order list consists of a number of MIME types in order, including support
3269        for implicit and explicit wildcards, for example:
3270
3271             alternative_order text/enriched text/plain text application/postscript image/*
3272
3273        Next, mutt will check if any of the types have a defined _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section
3274        5.4  , page 60), and use that.  Failing that, Mutt-ng will look for any text
3275        type.  As a last attempt, mutt will look for any type it knows how to handle.
3276
3277        To remove a MIME type from the alternative_order list, use the unalterna-
3278        tive_order command.
3279
3280        _\b5_\b._\b6  _\bM_\bI_\bM_\bE _\bL_\bo_\bo_\bk_\bu_\bp
3281
3282        Mutt-ng's mime_lookup list specifies a list of mime-types that should not be
3283        treated according to their mailcap entry.  This option is designed to deal with
3284        binary types such as application/octet-stream.  When an attachment's mime-type
3285        is listed in mime_lookup, then the extension of the filename will be compared
3286        to the list of extensions in the mime.types file.  The mime-type associated
3287        with this extension will then be used to process the attachment according to
3288        the rules in the mailcap file and according to any other configuration options
3289        (such as auto_view) specified.  Common usage would be:
3290
3291             mime_lookup application/octet-stream application/X-Lotus-Manuscript
3292
3293        In addition, the unmime_lookup command may be used to disable this feature for
3294        any particular mime-type if it had been set, for example, in a global muttrc.
3295
3296        _\b6_\b.  _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be
3297
3298        _\b6_\b._\b1  _\bC_\bo_\bm_\bm_\ba_\bn_\bd _\bl_\bi_\bn_\be _\bo_\bp_\bt_\bi_\bo_\bn_\bs
3299
3300        The Mutt-ng E-Mail Client                                                    63
3301
3302        Running mutt with no arguments will make Mutt-ng attempt to read your spool
3303        mailbox.  However, it is possible to read other mailboxes and to send messages
3304        from the command line as well.
3305
3306             -A   expand an alias
3307             -a      attach a file to a message
3308             -b      specify a blind carbon-copy (BCC) address
3309             -c      specify a carbon-copy (Cc) address
3310             -D      print the value of all variables on stdout
3311             -e      specify a config command to be run after initialization files are read
3312             -f      specify a mailbox to load
3313             -F      specify an alternate file to read initialization commands
3314             -h      print help on command line options
3315             -H      specify a draft file from which to read a header and body
3316             -i      specify a file to include in a message composition
3317             -m      specify a default mailbox type
3318             -n      do not read the system Muttngrc
3319             -p      recall a postponed message
3320             -Q      query a configuration variable
3321             -R      open mailbox in read-only mode
3322             -s      specify a subject (enclose in quotes if it contains spaces)
3323             -v      show version number and compile-time definitions
3324             -x      simulate the mailx(1) compose mode
3325             -y      show a menu containing the files specified by the mailboxes command
3326             -z      exit immediately if there are no messages in the mailbox
3327             -Z      open the first folder with new message,exit immediately if none
3328
3329        To read messages in a mailbox
3330
3331        mutt [ -nz ] [ -F _\bm_\bu_\bt_\bt_\br_\bc ] [ -m _\bt_\by_\bp_\be ] [ -f _\bm_\ba_\bi_\bl_\bb_\bo_\bx ]
3332
3333        To compose a new message
3334
3335        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-
3336        _\bj_\be_\bc_\bt ] _\ba_\bd_\bd_\br_\be_\bs_\bs [ _\ba_\bd_\bd_\br_\be_\bs_\bs ... ]
3337
3338        Mutt-ng also supports a ``batch'' mode to send prepared messages.  Simply redi-
3339        rect input from the file you wish to send.  For example,
3340
3341        mutt -s 'data set for run #2' professor@bigschool.edu < ~/run2.dat
3342
3343        This command will send a message to ``professor@bigschool.edu'' with a subject
3344        of ``data set for run #2''.  In the body of the message will be the contents of
3345        the file ``~/run2.dat''.
3346
3347        _\b6_\b._\b2  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bC_\bo_\bm_\bm_\ba_\bn_\bd_\bs
3348
3349        The following are the commands understood by mutt.
3350
3351           +\bo _\ba_\bc_\bc_\bo_\bu_\bn_\bt_\b-_\bh_\bo_\bo_\bk (section 4.14  , page 49) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3352
3353        The Mutt-ng E-Mail Client                                                    64
3354
3355           +\bo _\ba_\bl_\bi_\ba_\bs (section 3.2  , page 16) _\bk_\be_\by _\ba_\bd_\bd_\br_\be_\bs_\bs [ , _\ba_\bd_\bd_\br_\be_\bs_\bs, ... ]
3356
3357           +\bo _\bu_\bn_\ba_\bl_\bi_\ba_\bs (section 3.2  , page 16) [ * | _\bk_\be_\by ... ]
3358
3359           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.9  , page 23) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
3360
3361           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\be_\bs (section 3.9  , page 23) [ * | _\br_\be_\bg_\be_\bx_\bp ... ]
3362
3363           +\bo _\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 61) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
3364
3365           +\bo _\bu_\bn_\ba_\bl_\bt_\be_\br_\bn_\ba_\bt_\bi_\bv_\be_\b__\bo_\br_\bd_\be_\br (section 5.5  , page 61) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
3366
3367           +\bo _\ba_\bp_\bp_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 4.16.3  , page 51) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3368
3369           +\bo _\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 60) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
3370
3371           +\bo _\bu_\bn_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page 60) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
3372
3373           +\bo _\bb_\bi_\bn_\bd (section 3.3  , page 17) _\bm_\ba_\bp _\bk_\be_\by _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn
3374
3375           +\bo _\bc_\bh_\ba_\br_\bs_\be_\bt_\b-_\bh_\bo_\bo_\bk (section 3.4  , page 19) _\ba_\bl_\bi_\ba_\bs _\bc_\bh_\ba_\br_\bs_\be_\bt
3376
3377           +\bo _\bc_\bl_\bo_\bs_\be_\b-_\bh_\bo_\bo_\bk (section 4.16.2  , page 51) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3378
3379           +\bo _\bc_\bo_\bl_\bo_\br (section 3.7  , page 21) _\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 ]
3380
3381           +\bo _\bu_\bn_\bc_\bo_\bl_\bo_\br (section 3.7  , page 21) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
3382
3383           +\bo _\be_\bx_\be_\bc (section 3.22  , page 29) _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn [ _\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn ... ]
3384
3385           +\bo _\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.16  , page 27) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
3386
3387           +\bo _\bf_\bc_\bc_\b-_\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.17  , page 27) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
3388
3389           +\bo _\bf_\bo_\bl_\bd_\be_\br_\b-_\bh_\bo_\bo_\bk (section 3.5  , page 19) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3390
3391           +\bo _\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.14  , page 26) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
3392
3393           +\bo _\bu_\bn_\bh_\bd_\br_\b__\bo_\br_\bd_\be_\br (section 3.14  , page 26) _\bh_\be_\ba_\bd_\be_\br [ _\bh_\be_\ba_\bd_\be_\br ... ]
3394
3395           +\bo _\bi_\bc_\bo_\bn_\bv_\b-_\bh_\bo_\bo_\bk (section 3.4  , page 19) _\bc_\bh_\ba_\br_\bs_\be_\bt _\bl_\bo_\bc_\ba_\bl_\b-_\bc_\bh_\ba_\br_\bs_\be_\bt
3396
3397           +\bo _\bi_\bg_\bn_\bo_\br_\be (section 3.8  , page 23) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
3398
3399           +\bo _\bu_\bn_\bi_\bg_\bn_\bo_\br_\be (section 3.8  , page 23) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
3400
3401           +\bo _\bl_\bi_\bs_\bt_\bs (section 3.10  , page 24) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
3402
3403           +\bo _\bu_\bn_\bl_\bi_\bs_\bt_\bs (section 3.10  , page 24) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
3404
3405           +\bo _\bm_\ba_\bc_\br_\bo (section 3.6  , page 20) _\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 ]
3406
3407           +\bo _\bm_\ba_\bi_\bl_\bb_\bo_\bx_\be_\bs (section 3.12  , page 25) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be [ _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be ... ]
3408
3409        The Mutt-ng E-Mail Client                                                    65
3410
3411           +\bo _\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.11  , page 25) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bm_\ba_\bi_\bl_\bb_\bo_\bx
3412
3413           +\bo _\bm_\be_\bs_\bs_\ba_\bg_\be_\b-_\bh_\bo_\bo_\bk (section 3.19  , page 28) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3414
3415           +\bo _\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 61) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
3416
3417           +\bo _\bu_\bn_\bm_\bi_\bm_\be_\b__\bl_\bo_\bo_\bk_\bu_\bp (section 5.6  , page 61) _\bm_\bi_\bm_\be_\bt_\by_\bp_\be [ _\bm_\bi_\bm_\be_\bt_\by_\bp_\be ... ]
3418
3419           +\bo _\bm_\bo_\bn_\bo (section 3.7  , page 21) _\bo_\bb_\bj_\be_\bc_\bt _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\be [ _\br_\be_\bg_\be_\bx_\bp ]
3420
3421           +\bo _\bu_\bn_\bm_\bo_\bn_\bo (section 3.7  , page 21) _\bi_\bn_\bd_\be_\bx _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
3422
3423           +\bo _\bm_\by_\b__\bh_\bd_\br (section 3.13  , page 25) _\bs_\bt_\br_\bi_\bn_\bg
3424
3425           +\bo _\bu_\bn_\bm_\by_\b__\bh_\bd_\br (section 3.13  , page 25) _\bf_\bi_\be_\bl_\bd [ _\bf_\bi_\be_\bl_\bd ... ]
3426
3427           +\bo _\bo_\bp_\be_\bn_\b-_\bh_\bo_\bo_\bk (section 4.16.1  , page 50) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3428
3429           +\bo _\bc_\br_\by_\bp_\bt_\b-_\bh_\bo_\bo_\bk (section 3.20  , page 28) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bk_\be_\by_\b-_\bi_\bd
3430
3431           +\bo _\bp_\bu_\bs_\bh (section 3.21  , page 29) _\bs_\bt_\br_\bi_\bn_\bg
3432
3433           +\bo _\br_\be_\bs_\be_\bt (section 3.25  , page 31) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
3434
3435           +\bo _\bs_\ba_\bv_\be_\b-_\bh_\bo_\bo_\bk (section 3.15  , page 26) _\br_\be_\bg_\be_\bx_\bp _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
3436
3437           +\bo _\bs_\bc_\bo_\br_\be (section 3.23  , page 29) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bv_\ba_\bl_\bu_\be
3438
3439           +\bo _\bu_\bn_\bs_\bc_\bo_\br_\be (section 3.23  , page 29) _\bp_\ba_\bt_\bt_\be_\br_\bn [ _\bp_\ba_\bt_\bt_\be_\br_\bn ... ]
3440
3441           +\bo _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk (section 3.18  , page 27) _\br_\be_\bg_\be_\bx_\bp _\bc_\bo_\bm_\bm_\ba_\bn_\bd
3442
3443           +\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
3444
3445           +\bo _\bs_\be_\bt (section 3.25  , page 31) [no|inv]_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be[=_\bv_\ba_\bl_\bu_\be] [ _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
3446
3447           +\bo _\bu_\bn_\bs_\be_\bt (section 3.25  , page 31) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
3448
3449           +\bo _\bs_\bo_\bu_\br_\bc_\be (section 3.26  , page 32) _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
3450
3451           +\bo _\bs_\bp_\ba_\bm (section 3.24  , page 29) _\bp_\ba_\bt_\bt_\be_\br_\bn _\bf_\bo_\br_\bm_\ba_\bt
3452
3453           +\bo _\bn_\bo_\bs_\bp_\ba_\bm (section 3.24  , page 29) _\bp_\ba_\bt_\bt_\be_\br_\bn
3454
3455           +\bo _\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.10  , page 24) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
3456
3457           +\bo _\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be (section 3.10  , page 24) _\br_\be_\bg_\be_\bx_\bp [ _\br_\be_\bg_\be_\bx_\bp ... ]
3458
3459           +\bo _\bt_\bo_\bg_\bg_\bl_\be (section 3.25  , page 31) _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be [_\bv_\ba_\br_\bi_\ba_\bb_\bl_\be ... ]
3460
3461           +\bo _\bu_\bn_\bh_\bo_\bo_\bk (section 3.28  , page 33) _\bh_\bo_\bo_\bk_\b-_\bt_\by_\bp_\be
3462
3463        _\b6_\b._\b3  _\bC_\bo_\bn_\bf_\bi_\bg_\bu_\br_\ba_\bt_\bi_\bo_\bn _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\bs
3464
3465        The Mutt-ng E-Mail Client                                                    66
3466
3467        _\b6_\b._\b3_\b._\b1  _\ba_\bb_\bo_\br_\bt_\b__\bn_\bo_\bs_\bu_\bb_\bj_\be_\bc_\bt
3468
3469        Type: quadoption
3470
3471        Default: ask-yes
3472
3473        If set to _\by_\be_\bs, when composing messages and no subject is given at the subject
3474        prompt, composition will be aborted.  If set to _\bn_\bo, composing messages with no
3475        subject given at the subject prompt will never be aborted.
3476
3477        _\b6_\b._\b3_\b._\b2  _\ba_\bb_\bo_\br_\bt_\b__\bu_\bn_\bm_\bo_\bd_\bi_\bf_\bi_\be_\bd
3478
3479        Type: quadoption
3480
3481        Default: yes
3482
3483        If set to _\by_\be_\bs, composition will automatically abort after editing the message
3484        body if no changes are made to the file (this check only happens after the
3485        _\bf_\bi_\br_\bs_\bt edit of the file).  When set to _\bn_\bo, composition will never be aborted.
3486
3487        _\b6_\b._\b3_\b._\b3  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bi_\bl_\be
3488
3489        Type: path
3490
3491        Default: '~/.muttngrc'
3492
3493        The default file in which to save aliases created by the ``_\bc_\br_\be_\ba_\bt_\be_\b-_\ba_\bl_\bi_\ba_\bs (sec-
3494        tion 2.3.4  , page 7)'' function.
3495
3496        N\bNo\bot\bte\be:\b: Mutt-ng will not automatically source this file; you must explicitly use
3497        the ``_\bs_\bo_\bu_\br_\bc_\be (section 3.26  , page 32)'' command for it to be executed.
3498
3499        _\b6_\b._\b3_\b._\b4  _\ba_\bl_\bi_\ba_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
3500
3501        Type: string
3502
3503        Default: '%4n %2f %t %-10a   %r'
3504
3505        Specifies the format of the data displayed for the ``alias'' menu. The follow-
3506        ing printf(3)-style sequences are available:
3507
3508              %a
3509                    alias name
3510
3511              %f
3512                    flags - currently, a 'd' for an alias marked for deletion
3513
3514              %n
3515                    index number
3516
3517              %r
3518                    address which alias expands to
3519
3520        The Mutt-ng E-Mail Client                                                    67
3521
3522              %t
3523                    character which indicates if the alias is tagged for inclusion
3524
3525        _\b6_\b._\b3_\b._\b5  _\ba_\bl_\bl_\bo_\bw_\b__\b8_\bb_\bi_\bt
3526
3527        Type: boolean
3528
3529        Default: yes
3530
3531        Controls whether 8-bit data is converted to 7-bit using either quoted-printable
3532        or base64 encoding when sending mail.
3533
3534        _\b6_\b._\b3_\b._\b6  _\ba_\bl_\bl_\bo_\bw_\b__\ba_\bn_\bs_\bi
3535
3536        Type: boolean
3537
3538        Default: no
3539
3540        Controls whether ANSI color codes in messages (and color tags in rich text mes-
3541        sages) are to be interpreted.  Messages containing these codes are rare, but if
3542        this option is set, their text will be colored accordingly. Note that this may
3543        override your color choices, and even present a security problem, since a mes-
3544        sage could include a line like ``[-- PGP output follows ...' and give it the
3545        same color as your attachment color.
3546
3547        _\b6_\b._\b3_\b._\b7  _\ba_\br_\br_\bo_\bw_\b__\bc_\bu_\br_\bs_\bo_\br
3548
3549        Type: boolean
3550
3551        Default: no
3552
3553        When _\bs_\be_\bt, an arrow (``->'') will be used to indicate the current entry in menus
3554        instead of highlighting the whole line.  On slow network or modem links this
3555        will make response faster because there is less that has to be redrawn on the
3556        screen when moving to the next or previous entries in the menu.
3557
3558        _\b6_\b._\b3_\b._\b8  _\ba_\bs_\bc_\bi_\bi_\b__\bc_\bh_\ba_\br_\bs
3559
3560        Type: boolean
3561
3562        Default: no
3563
3564        If _\bs_\be_\bt, Mutt-ng will use plain ASCII characters when displaying thread and
3565        attachment trees, instead of the default ACS characters.
3566
3567        _\b6_\b._\b3_\b._\b9  _\ba_\bs_\bk_\bb_\bc_\bc
3568
3569        Type: boolean
3570
3571        Default: no
3572
3573        If _\bs_\be_\bt, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before
3574        editing an outgoing message.
3575
3576        The Mutt-ng E-Mail Client                                                    68
3577
3578        _\b6_\b._\b3_\b._\b1_\b0  _\ba_\bs_\bk_\bc_\bc
3579
3580        Type: boolean
3581
3582        Default: no
3583
3584        If _\bs_\be_\bt, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing
3585        the body of an outgoing message.
3586
3587        _\b6_\b._\b3_\b._\b1_\b1  _\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
3588
3589        Type: string
3590
3591        Default: 'us-ascii'
3592
3593        This variable is a colon-separated list of character encoding schemes for mes-
3594        sages without character encoding indication.  Header field values and message
3595        body content without character encoding indication would be assumed that they
3596        are written in one of this list.  By default, all the header fields and message
3597        body without any charset indication are assumed to be in us-ascii.
3598
3599        For example, Japanese users might prefer this:
3600
3601        set assumed_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
3602
3603        However, only the first content is valid for the message body.  This variable
3604        is valid only if _\b$_\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be (section 6.3.308  , page 140) is unset.
3605
3606        _\b6_\b._\b3_\b._\b1_\b2  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bf_\bo_\br_\bm_\ba_\bt
3607
3608        Type: string
3609
3610        Default: '%u%D%I %t%4n %T%.40d%> [%.7m/%.10M, %.6e%?C?, %C?, %s] '
3611
3612        This variable describes the format of the ``attachment'' menu.  The following
3613        printf(3)-style sequences are understood:
3614
3615              %C
3616                    charset
3617
3618              %c
3619                    requires charset conversion (n or c)
3620
3621              %D
3622                    deleted flag
3623
3624              %d
3625                    description
3626
3627              %e
3628                    MIME Content-Transfer-Encoding: header field
3629
3630              %f
3631                    filename
3632
3633        The Mutt-ng E-Mail Client                                                    69
3634
3635              %I
3636                    MIME Content-Disposition: header field (I=inline, A=attachment)
3637
3638              %m
3639                    major MIME type
3640
3641              %M
3642                    MIME subtype
3643
3644              %n
3645                    attachment number
3646
3647              %s
3648                    size
3649
3650              %t
3651                    tagged flag
3652
3653              %T
3654                    graphic tree characters
3655
3656              %u
3657                    unlink (=to delete) flag
3658
3659              %>X
3660                    right justify the rest of the string and pad with character 'X'
3661
3662              %|X
3663                    pad to the end of the line with character 'X'
3664
3665        _\b6_\b._\b3_\b._\b1_\b3  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp
3666
3667        Type: string
3668
3669        Default: '\n'
3670
3671        The separator to add between attachments when operating (saving, printing, pip-
3672        ing, etc) on a list of tagged attachments.
3673
3674        _\b6_\b._\b3_\b._\b1_\b4  _\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\bp_\bl_\bi_\bt
3675
3676        Type: boolean
3677
3678        Default: yes
3679
3680        If this variable is _\bu_\bn_\bs_\be_\bt, when operating (saving, printing, piping, etc) on a
3681        list of tagged attachments, Mutt-ng will concatenate the attachments and will
3682        operate on them as a single attachment. The ``_\b$_\ba_\bt_\bt_\ba_\bc_\bh_\b__\bs_\be_\bp (section 6.3.13  ,
3683        page 68)'' separator is added after each attachment. When _\bs_\be_\bt, Mutt-ng will
3684        operate on the attachments one by one.
3685
3686        _\b6_\b._\b3_\b._\b1_\b5  _\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn
3687
3688        Type: string
3689
3690        The Mutt-ng E-Mail Client                                                    70
3691
3692        Default: 'On %d, %n wrote:'
3693
3694        This is the string that will precede a message which has been included in a
3695        reply.  For a full listing of defined printf(3)-like sequences see the section
3696        on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90)''.
3697
3698        _\b6_\b._\b3_\b._\b1_\b6  _\ba_\bu_\bt_\bo_\b__\bt_\ba_\bg
3699
3700        Type: boolean
3701
3702        Default: no
3703
3704        When _\bs_\be_\bt, functions in the _\bi_\bn_\bd_\be_\bx menu which affect a message will be applied to
3705        all tagged messages (if there are any).  When unset, you must first use the
3706        ``tag-prefix'' function (default: ';') to make the next function apply to all
3707        tagged messages.
3708
3709        _\b6_\b._\b3_\b._\b1_\b7  _\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt
3710
3711        Type: boolean
3712
3713        Default: no
3714
3715        When _\bs_\be_\bt along with ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 6.3.54  , page 77)'', Mutt-ng will
3716        skip the initial send-menu and allow you to immediately begin editing the body
3717        of your message.  The send-menu may still be accessed once you have finished
3718        editing the body of your message.
3719
3720        Also see ``_\b$_\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by (section 6.3.60  , page 78)''.
3721
3722        _\b6_\b._\b3_\b._\b1_\b8  _\bb_\be_\be_\bp
3723
3724        Type: boolean
3725
3726        Default: yes
3727
3728        When this variable is _\bs_\be_\bt, Mutt-ng will beep when an error occurs.
3729
3730        _\b6_\b._\b3_\b._\b1_\b9  _\bb_\be_\be_\bp_\b__\bn_\be_\bw
3731
3732        Type: boolean
3733
3734        Default: no
3735
3736        When this variable is _\bs_\be_\bt, Mutt-ng will beep whenever it prints a message noti-
3737        fying you of new mail.  This is independent of the setting of the ``_\b$_\bb_\be_\be_\bp (sec-
3738        tion 6.3.18  , page 69)'' variable.
3739
3740        _\b6_\b._\b3_\b._\b2_\b0  _\bb_\bo_\bu_\bn_\bc_\be
3741
3742        Type: quadoption
3743
3744        Default: ask-yes
3745
3746        The Mutt-ng E-Mail Client                                                    71
3747
3748        Controls whether you will be asked to confirm bouncing messages.  If set to _\by_\be_\bs
3749        you don't get asked if you want to bounce a message. Setting this variable to
3750        _\bn_\bo is not generally useful, and thus not recommended, because you are unable to
3751        bounce messages.
3752
3753        _\b6_\b._\b3_\b._\b2_\b1  _\bb_\bo_\bu_\bn_\bc_\be_\b__\bd_\be_\bl_\bi_\bv_\be_\br_\be_\bd
3754
3755        Type: boolean
3756
3757        Default: yes
3758
3759        When this variable is _\bs_\be_\bt, Mutt-ng will include Delivered-To: header fields
3760        when bouncing messages.  Postfix users may wish to _\bu_\bn_\bs_\be_\bt this variable.
3761
3762        _\b6_\b._\b3_\b._\b2_\b2  _\bb_\br_\ba_\bi_\bl_\bl_\be_\b__\bf_\br_\bi_\be_\bn_\bd_\bl_\by
3763
3764        Type: boolean
3765
3766        Default: no
3767
3768        When this variable is set, mutt will place the cursor at the beginning of the
3769        current line in menus, even when the arrow_cursor variable is unset, making it
3770        easier for blind persons using Braille displays to follow these menus.  The
3771        option is disabled by default because many visual terminals don't permit making
3772        the cursor invisible.
3773
3774        _\b6_\b._\b3_\b._\b2_\b3  _\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\b__\bf_\bi_\bl_\be
3775
3776        Type: path
3777
3778        Default: '~/.mutt_certificates'
3779
3780        Availability: SSL or GNUTLS
3781
3782        This variable specifies the file where the certificates you trust are saved.
3783        When an unknown certificate is encountered, you are asked if you accept it or
3784        not. If you accept it, the certificate can also be saved in this file and fur-
3785        ther connections are automatically accepted.
3786
3787        You can also manually add CA certificates in this file. Any server certificate
3788        that is signed with one of these CA certificates are also automatically
3789        accepted.
3790
3791        Example: set certificate_file=~/.muttng/certificates
3792
3793        _\b6_\b._\b3_\b._\b2_\b4  _\bc_\bh_\ba_\br_\bs_\be_\bt
3794
3795        Type: string
3796
3797        Default: ''
3798
3799        Character set your terminal uses to display and enter textual data.
3800
3801        The Mutt-ng E-Mail Client                                                    72
3802
3803        _\b6_\b._\b3_\b._\b2_\b5  _\bc_\bh_\be_\bc_\bk_\b__\bn_\be_\bw
3804
3805        Type: boolean
3806
3807        Default: yes
3808
3809        N\bNo\bot\bte\be:\b: this option only affects _\bm_\ba_\bi_\bl_\bd_\bi_\br and _\bM_\bH style mailboxes.
3810
3811        When _\bs_\be_\bt, Mutt-ng will check for new mail delivered while the mailbox is open.
3812        Especially with MH mailboxes, this operation can take quite some time since it
3813        involves scanning the directory and checking each file to see if it has already
3814        been looked at.  If it's _\bu_\bn_\bs_\be_\bt, no check for new mail is performed while the
3815        mailbox is open.
3816
3817        _\b6_\b._\b3_\b._\b2_\b6  _\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bu_\bn_\br_\be_\ba_\bd
3818
3819        Type: boolean
3820
3821        Default: yes
3822
3823        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not collapse a thread if it contains any unread mes-
3824        sages.
3825
3826        _\b6_\b._\b3_\b._\b2_\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
3827
3828        Type: string
3829
3830        Default: '-- Mutt-ng: Compose  [Approx. msg size: %l   Atts: %a]%>-'
3831
3832        Controls the format of the status line displayed in the ``compose'' menu.  This
3833        string is similar to ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.305  , page 138)'', but has
3834        its own set of printf(3)-like sequences:
3835
3836              %a
3837                    total number of attachments
3838
3839              %h
3840                    local hostname
3841
3842              %l
3843                    approximate size (in bytes) of the current message
3844
3845              %v
3846                    Mutt-ng version string
3847
3848        See the text describing the ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.305  , page 138)''
3849        option for more information on how to set ``_\b$_\bc_\bo_\bm_\bp_\bo_\bs_\be_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.27  ,
3850        page 71)''.
3851
3852        _\b6_\b._\b3_\b._\b2_\b8  _\bc_\bo_\bn_\bf_\bi_\bg_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
3853
3854        Type: string
3855
3856        Default: ''
3857
3858        The Mutt-ng E-Mail Client                                                    73
3859
3860        When defined, Mutt-ng will recode commands in rc files from this encoding.
3861
3862        _\b6_\b._\b3_\b._\b2_\b9  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\ba_\bp_\bp_\be_\bn_\bd
3863
3864        Type: boolean
3865
3866        Default: yes
3867
3868        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when appending messages to an
3869        existing mailbox.
3870
3871        _\b6_\b._\b3_\b._\b3_\b0  _\bc_\bo_\bn_\bf_\bi_\br_\bm_\bc_\br_\be_\ba_\bt_\be
3872
3873        Type: boolean
3874
3875        Default: yes
3876
3877        When _\bs_\be_\bt, Mutt-ng will prompt for confirmation when saving messages to a mail-
3878        box which does not yet exist before creating it.
3879
3880        _\b6_\b._\b3_\b._\b3_\b1  _\bc_\bo_\bn_\bn_\be_\bc_\bt_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
3881
3882        Type: number
3883
3884        Default: 30
3885
3886        Causes Mutt-ng to timeout a network connection (for IMAP or POP) after this
3887        many seconds if the connection is not able to be established.  A negative value
3888        causes Mutt-ng to wait indefinitely for the connection to succeed.
3889
3890        _\b6_\b._\b3_\b._\b3_\b2  _\bc_\bo_\bn_\bt_\be_\bn_\bt_\b__\bt_\by_\bp_\be
3891
3892        Type: string
3893
3894        Default: 'text/plain'
3895
3896        Sets the default Content-Type: header field for the body of newly composed mes-
3897        sages.
3898
3899        _\b6_\b._\b3_\b._\b3_\b3  _\bc_\bo_\bp_\by
3900
3901        Type: quadoption
3902
3903        Default: yes
3904
3905        This variable controls whether or not copies of your outgoing messages will be
3906        saved for later references.  Also see ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 6.3.230  , page
3907        120)'', ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 6.3.241  , page 123)'', ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section
3908        6.3.68  , page 81)'' and ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.16  , page 27)''.
3909
3910        _\b6_\b._\b3_\b._\b3_\b4  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\be_\bn_\bc_\br_\by_\bp_\bt
3911
3912        Type: boolean
3913
3914        The Mutt-ng E-Mail Client                                                    74
3915
3916        Default: no
3917
3918        Setting this variable will cause Mutt-ng to always attempt to PGP encrypt out-
3919        going messages.  This is probably only useful in connection to the _\bs_\be_\bn_\bd_\b-_\bh_\bo_\bo_\bk
3920        command.  It can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when encryption is not
3921        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
3922        6.3.277  , page 131)'' is _\bs_\be_\bt, then OpenSSL is used instead to create S/MIME
3923        messages and settings can be overridden by use of the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto
3924        only)
3925
3926        _\b6_\b._\b3_\b._\b3_\b5  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bp_\bg_\bp
3927
3928        Type: boolean
3929
3930        Default: yes
3931
3932        This variable controls whether or not Mutt-ng may automatically enable PGP
3933        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
3934        6.3.34  , page 72)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 6.3.38  , page 73)'',
3935        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 6.3.36  , page 73)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
3936        6.3.39  , page 74)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 6.3.277  , page 131)''.
3937
3938        _\b6_\b._\b3_\b._\b3_\b6  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn
3939
3940        Type: boolean
3941
3942        Default: no
3943
3944        Setting this variable will cause Mutt-ng to always attempt to cryptographically
3945        sign outgoing messages.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when
3946        signing is not required or encryption is requested as well. If
3947        ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 6.3.277  , page 131)'' is _\bs_\be_\bt, then OpenSSL is
3948        used instead to create S/MIME messages and settings can be overridden by use of
3949        the _\bs_\bm_\bi_\bm_\be_\b-_\bm_\be_\bn_\bu.  (Crypto only)
3950
3951        _\b6_\b._\b3_\b._\b3_\b7  _\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bm_\bi_\bm_\be
3952
3953        Type: boolean
3954
3955        Default: yes
3956
3957        This variable controls whether or not Mutt-ng may automatically enable S/MIME
3958        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
3959        6.3.34  , page 72)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt (section 6.3.38  , page 73)'',
3960        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\ba_\bu_\bt_\bo_\bs_\bi_\bg_\bn (section 6.3.36  , page 73)'', ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section
3961        6.3.39  , page 74)'' and ``_\b$_\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt (section 6.3.277  , page 131)''.
3962
3963        _\b6_\b._\b3_\b._\b3_\b8  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\be_\bn_\bc_\br_\by_\bp_\bt
3964
3965        Type: boolean
3966
3967        Default: yes
3968
3969        If _\bs_\be_\bt, automatically PGP or OpenSSL encrypt replies to messages which are
3970
3971        The Mutt-ng E-Mail Client                                                    75
3972
3973        encrypted.  (Crypto only)
3974
3975        _\b6_\b._\b3_\b._\b3_\b9  _\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn
3976
3977        Type: boolean
3978
3979        Default: no
3980
3981        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are signed.
3982
3983        N\bNo\bot\bte\be:\b: this does not work on messages that are encrypted a\ban\bnd\bd signed!  (Crypto
3984        only)
3985
3986        _\b6_\b._\b3_\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
3987
3988        Type: boolean
3989
3990        Default: no
3991
3992        If _\bs_\be_\bt, automatically PGP or OpenSSL sign replies to messages which are
3993        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
3994        6.3.38  , page 73)'', because it allows you to sign all messages which are
3995        automatically encrypted.  This works around the problem noted in
3996        ``_\b$_\bc_\br_\by_\bp_\bt_\b__\br_\be_\bp_\bl_\by_\bs_\bi_\bg_\bn (section 6.3.39  , page 74)'', that Mutt-ng is not able to
3997        find out whether an encrypted message is also signed.  (Crypto only)
3998
3999        _\b6_\b._\b3_\b._\b4_\b1  _\bc_\br_\by_\bp_\bt_\b__\bt_\bi_\bm_\be_\bs_\bt_\ba_\bm_\bp
4000
4001        Type: boolean
4002
4003        Default: yes
4004
4005        If _\bs_\be_\bt, Mutt-ng will include a time stamp in the lines surrounding PGP or
4006        S/MIME output, so spoofing such lines is more difficult.  If you are using col-
4007        ors to mark these lines, and rely on these, you may _\bu_\bn_\bs_\be_\bt this setting.
4008        (Crypto only)
4009
4010        _\b6_\b._\b3_\b._\b4_\b2  _\bc_\br_\by_\bp_\bt_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\bm_\be
4011
4012        Type: boolean
4013
4014        Default: no
4015
4016        This variable controls the use the GPGME enabled crypto backends.  If it is _\bs_\be_\bt
4017        and Mutt-ng was build with gpgme support, the gpgme code for S/MIME and PGP
4018        will be used instead of the classic code.
4019
4020        N\bNo\bot\bte\be: You need to use this option in your .muttngrc configuration file as it
4021        won't have any effect when used interactively.
4022
4023        _\b6_\b._\b3_\b._\b4_\b3  _\bc_\br_\by_\bp_\bt_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bs_\bi_\bg
4024
4025        Type: quadoption
4026
4027        The Mutt-ng E-Mail Client                                                    76
4028
4029        Default: yes
4030
4031        If ``_\by_\be_\bs'', always attempt to verify PGP or S/MIME signatures.  If ``_\ba_\bs_\bk'', ask
4032        whether or not to verify the signature.  If ``_\bn_\bo'', never attempt to verify
4033        cryptographic signatures.  (Crypto only)
4034
4035        _\b6_\b._\b3_\b._\b4_\b4  _\bd_\ba_\bt_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
4036
4037        Type: string
4038
4039        Default: '!%a, %b %d, %Y at %I:%M:%S%p %Z'
4040
4041        This variable controls the format of the date printed by the ``%d'' sequence in
4042        ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90)''.  This is passed to strftime(3)
4043        to process the date.
4044
4045        Unless the first character in the string is a bang (``!''), the month and week
4046        day names are expanded according to the locale specified in the variable
4047        ``_\b$_\bl_\bo_\bc_\ba_\bl_\be (section 6.3.114  , page 93)''. If the first character in the string
4048        is a bang, the bang is discarded, and the month and week day names in the rest
4049        of the string are expanded in the _\bC locale (that is in US English).
4050
4051        _\b6_\b._\b3_\b._\b4_\b5  _\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bh_\bo_\bo_\bk
4052
4053        Type: string
4054
4055        Default: '~f %s !~P | (~P ~C %s)'
4056
4057        This variable controls how send-hooks, message-hooks, save-hooks, and fcc-hooks
4058        will be interpreted if they are specified with only a simple regexp, instead of
4059        a matching pattern.  The hooks are expanded when they are declared, so a hook
4060        will be interpreted according to the value of this variable at the time the
4061        hook is declared.  The default value matches if the message is either from a
4062        user matching the regular expression given, or if it is from you (if the from
4063        address matches ``alternates'') and is to or cc'ed to a user matching the given
4064        regular expression.
4065
4066        _\b6_\b._\b3_\b._\b4_\b6  _\bd_\be_\bl_\be_\bt_\be
4067
4068        Type: quadoption
4069
4070        Default: ask-yes
4071
4072        Controls whether or not messages are really deleted when closing or synchroniz-
4073        ing a mailbox.  If set to _\by_\be_\bs, messages marked for deleting will automatically
4074        be purged without prompting.  If set to _\bn_\bo, messages marked for deletion will
4075        be kept in the mailbox.
4076
4077        _\b6_\b._\b3_\b._\b4_\b7  _\bd_\be_\bl_\be_\bt_\be_\b__\bu_\bn_\bt_\ba_\bg
4078
4079        Type: boolean
4080
4081        Default: yes
4082
4083        The Mutt-ng E-Mail Client                                                    77
4084
4085        If this option is _\bs_\be_\bt, Mutt-ng will untag messages when marking them for dele-
4086        tion.  This applies when you either explicitly delete a message, or when you
4087        save it to another folder.
4088
4089        _\b6_\b._\b3_\b._\b4_\b8  _\bd_\bi_\bg_\be_\bs_\bt_\b__\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be
4090
4091        Type: boolean
4092
4093        Default: yes
4094
4095        If this option is _\bs_\be_\bt, Mutt-ng's received-attachments menu will not show the
4096        subparts of individual messages in a multipart/digest.  To see these subparts,
4097        press 'v' on that menu.
4098
4099        _\b6_\b._\b3_\b._\b4_\b9  _\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br
4100
4101        Type: path
4102
4103        Default: ''
4104
4105        When _\bs_\be_\bt, specifies a command used to filter messages.  When a message is
4106        viewed it is passed as standard input to _\b$_\bd_\bi_\bs_\bp_\bl_\ba_\by_\b__\bf_\bi_\bl_\bt_\be_\br (section 6.3.49  ,
4107        page 76), and the filtered message is read from the standard output.
4108
4109        _\b6_\b._\b3_\b._\b5_\b0  _\bd_\bo_\bt_\bl_\bo_\bc_\bk_\b__\bp_\br_\bo_\bg_\br_\ba_\bm
4110
4111        Type: path
4112
4113        Default: '/opt/freebsd4/mutt-ng/bin/muttng_dotlock'
4114
4115        Availability: Standalone and Dotlock
4116
4117        Contains the path of the muttng_dotlock(1) binary to be used by Mutt-ng.
4118
4119        _\b6_\b._\b3_\b._\b5_\b1  _\bd_\bs_\bn_\b__\bn_\bo_\bt_\bi_\bf_\by
4120
4121        Type: string
4122
4123        Default: ''
4124
4125        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or
4126        greater.
4127
4128        This variable sets the request for when notification is returned.  The string
4129        consists of a comma separated list (no spaces!) of one or more of the follow-
4130        ing: _\bn_\be_\bv_\be_\br, to never request notification, _\bf_\ba_\bi_\bl_\bu_\br_\be, to request notification on
4131        transmission failure, _\bd_\be_\bl_\ba_\by, to be notified of message delays, _\bs_\bu_\bc_\bc_\be_\bs_\bs, to be
4132        notified of successful transmission.
4133
4134        Example: set dsn_notify='failure,delay'
4135
4136        _\b6_\b._\b3_\b._\b5_\b2  _\bd_\bs_\bn_\b__\br_\be_\bt_\bu_\br_\bn
4137
4138        Type: string
4139
4140        The Mutt-ng E-Mail Client                                                    78
4141
4142        Default: ''
4143
4144        N\bNo\bot\bte\be:\b: you should not enable this unless you are using Sendmail 8.8.x or
4145        greater.
4146
4147        This variable controls how much of your message is returned in DSN messages.
4148        It may be set to either _\bh_\bd_\br_\bs to return just the message header, or _\bf_\bu_\bl_\bl to
4149        return the full message.
4150
4151        Example: set dsn_return=hdrs
4152
4153        _\b6_\b._\b3_\b._\b5_\b3  _\bd_\bu_\bp_\bl_\bi_\bc_\ba_\bt_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
4154
4155        Type: boolean
4156
4157        Default: yes
4158
4159        This variable controls whether Mutt-ng, when sorting by threads, threads mes-
4160        sages with the same Message-Id: header field together.  If it is _\bs_\be_\bt, it will
4161        indicate that it thinks they are duplicates of each other with an equals sign
4162        in the thread diagram.
4163
4164        _\b6_\b._\b3_\b._\b5_\b4  _\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs
4165
4166        Type: boolean
4167
4168        Default: no
4169
4170        This option allows you to edit the header of your outgoing messages along with
4171        the body of your message.
4172
4173        _\b6_\b._\b3_\b._\b5_\b5  _\be_\bd_\bi_\bt_\bo_\br
4174
4175        Type: path
4176
4177        Default: ''
4178
4179        This variable specifies which editor is used by Mutt-ng.  It defaults to the
4180        value of the $VISUAL, or $EDITOR, environment variable, or to the string 'vi'
4181        if neither of those are set.
4182
4183        _\b6_\b._\b3_\b._\b5_\b6  _\be_\bn_\bc_\bo_\bd_\be_\b__\bf_\br_\bo_\bm
4184
4185        Type: boolean
4186
4187        Default: no
4188
4189        When _\bs_\be_\bt, Mutt-ng will quoted-printable encode messages when they contain the
4190        string ``From '' (note the trailing space) in the beginning of a line. Useful
4191        to avoid the tampering certain mail delivery and transport agents tend to do
4192        with messages.
4193
4194        _\b6_\b._\b3_\b._\b5_\b7  _\be_\bn_\bt_\br_\bo_\bp_\by_\b__\bf_\bi_\bl_\be
4195
4196        The Mutt-ng E-Mail Client                                                    79
4197
4198        Type: path
4199
4200        Default: ''
4201
4202        Availability: SSL
4203
4204        The file which includes random data that is used to initialize SSL library
4205        functions.
4206
4207        _\b6_\b._\b3_\b._\b5_\b8  _\be_\bn_\bv_\be_\bl_\bo_\bp_\be_\b__\bf_\br_\bo_\bm
4208
4209        Type: boolean
4210
4211        Default: no
4212
4213        When _\bs_\be_\bt, Mutt-ng will try to derive the message's _\be_\bn_\bv_\be_\bl_\bo_\bp_\be sender from the
4214        ``From:'' header field. Note that this information is passed to the sendmail
4215        command using the ``-f' command line switch, so don't set this option if you
4216        are using that switch in _\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 6.3.247  , page 124) yourself, or
4217        if the sendmail on your machine doesn't support that command line switch.
4218
4219        _\b6_\b._\b3_\b._\b5_\b9  _\be_\bs_\bc_\ba_\bp_\be
4220
4221        Type: string
4222
4223        Default: '~'
4224
4225        Escape character to use for functions in the builtin editor.
4226
4227        _\b6_\b._\b3_\b._\b6_\b0  _\bf_\ba_\bs_\bt_\b__\br_\be_\bp_\bl_\by
4228
4229        Type: boolean
4230
4231        Default: no
4232
4233        When _\bs_\be_\bt, the initial prompt for recipients and subject are skipped when reply-
4234        ing to messages, and the initial prompt for subject is skipped when forwarding
4235        messages.
4236
4237        N\bNo\bot\bte\be:\b: this variable has no effect when the ``_\b$_\ba_\bu_\bt_\bo_\be_\bd_\bi_\bt (section 6.3.17  , page
4238        69)'' variable is _\bs_\be_\bt.
4239
4240        _\b6_\b._\b3_\b._\b6_\b1  _\bf_\bc_\bc_\b__\ba_\bt_\bt_\ba_\bc_\bh
4241
4242        Type: boolean
4243
4244        Default: yes
4245
4246        This variable controls whether or not attachments on outgoing messages are
4247        saved along with the main body of your message.
4248
4249        _\b6_\b._\b3_\b._\b6_\b2  _\bf_\bc_\bc_\b__\bc_\bl_\be_\ba_\br
4250
4251        Type: boolean
4252
4253        The Mutt-ng E-Mail Client                                                    80
4254
4255        Default: no
4256
4257        When this variable is _\bs_\be_\bt, FCCs will be stored unencrypted and unsigned, even
4258        when the actual message is encrypted and/or signed.  (PGP only)
4259
4260        _\b6_\b._\b3_\b._\b6_\b3  _\bf_\bi_\bl_\be_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
4261
4262        Type: string
4263
4264        Default: ''
4265
4266        This variable is a colon-separated list of character encoding schemes for text
4267        file attatchments.  If _\bu_\bn_\bs_\be_\bt, _\b$_\bc_\bh_\ba_\br_\bs_\be_\bt (section 6.3.24  , page 70) value will
4268        be used instead.  For example, the following configuration would work for
4269        Japanese text handling:
4270
4271        set file_charset='iso-2022-jp:euc-jp:shift_jis:utf-8'
4272
4273        Note: ``iso-2022-*'' must be put at the head of the value as shown above if
4274        included.
4275
4276        _\b6_\b._\b3_\b._\b6_\b4  _\bf_\bo_\bl_\bd_\be_\br
4277
4278        Type: path
4279
4280        Default: '~/Mail'
4281
4282        Specifies the default location of your mailboxes.  A ``+'' or ``='' at the
4283        beginning of a pathname will be expanded to the value of this variable.  Note
4284        that if you change this variable from the default value you need to make sure
4285        that the assignment occurs _\bb_\be_\bf_\bo_\br_\be you use ``+'' or ``='' for any other vari-
4286        ables since expansion takes place during the ``set'' command.
4287
4288        _\b6_\b._\b3_\b._\b6_\b5  _\bf_\bo_\bl_\bd_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
4289
4290        Type: string
4291
4292        Default: '%2C %t %N %F %2l %-8.8u %-8.8g %8s %d %f'
4293
4294        This variable allows you to customize the file browser display to your personal
4295        taste.  This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page
4296        90)'', but has its own set of printf(3)-like sequences:
4297
4298              %C
4299                    current file number
4300
4301              %d
4302                    date/time folder was last modified
4303
4304              %f
4305                    filename
4306
4307              %F
4308                    file permissions
4309
4310        The Mutt-ng E-Mail Client                                                    81
4311
4312              %g
4313                    group name (or numeric gid, if missing)
4314
4315              %l
4316                    number of hard links
4317
4318              %N
4319                    N if folder has new mail, blank otherwise
4320
4321              %s
4322                    size in bytes
4323
4324              %t
4325                    * if the file is tagged, blank otherwise
4326
4327              %u
4328                    owner name (or numeric uid, if missing)
4329
4330              %>X
4331                    right justify the rest of the string and pad with character 'X'
4332
4333              %|X
4334                    pad to the end of the line with character 'X'
4335
4336        _\b6_\b._\b3_\b._\b6_\b6  _\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
4337
4338        Type: boolean
4339
4340        Default: yes
4341
4342        Controls whether or not the Mail-Followup-To: header field is generated when
4343        sending mail.  When _\bs_\be_\bt, Mutt-ng will generate this field when you are replying
4344        to a known mailing list, specified with the ``subscribe'' or ``_\bl_\bi_\bs_\bt_\bs (section
4345        3.10  , page 24)'' commands or detected by common mailing list headers.
4346
4347        This field has two purposes.  First, preventing you from receiving duplicate
4348        copies of replies to messages which you send to mailing lists. Second, ensuring
4349        that you do get a reply separately for any messages sent to known lists to
4350        which you are not subscribed.  The header will contain only the list's address
4351        for subscribed lists, and both the list address and your own email address for
4352        unsubscribed lists.  Without this header, a group reply to your message sent to
4353        a subscribed list will be sent to both the list and your address, resulting in
4354        two copies of the same email for you.
4355
4356        _\b6_\b._\b3_\b._\b6_\b7  _\bf_\bo_\br_\bc_\be_\b__\bb_\bu_\bf_\bf_\by_\b__\bc_\bh_\be_\bc_\bk
4357
4358        Type: boolean
4359
4360        Default: no
4361
4362        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
4363        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
4364        already known to have new mail.
4365
4366        The Mutt-ng E-Mail Client                                                    82
4367
4368        Also see the following variables: ``_\b$_\bt_\bi_\bm_\be_\bo_\bu_\bt (section 6.3.318  , page 142)'',
4369        ``_\b$_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.115  , page 93)'' and ``_\b$_\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section
4370        6.3.99  , page 88)''.
4371
4372        _\b6_\b._\b3_\b._\b6_\b8  _\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be
4373
4374        Type: boolean
4375
4376        Default: no
4377
4378        This variable is similar to ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 6.3.241  , page 123)'',
4379        except that Mutt-ng will store a copy of your outgoing message by the username
4380        of the address you are sending to even if that mailbox does not exist.
4381
4382        Also see the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 6.3.230  , page 120)'' variable.
4383
4384        _\b6_\b._\b3_\b._\b6_\b9  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
4385
4386        Type: boolean
4387
4388        Default: yes
4389
4390        Controls the decoding of complex MIME messages into text/plain when forwarding
4391        a message.  The message header is also RFC2047 decoded.  This variable is only
4392        used, if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  , page 97)'' is _\bu_\bn_\bs_\be_\bt, otherwise
4393        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.137  , page 98)'' is used instead.
4394
4395        _\b6_\b._\b3_\b._\b7_\b0  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\br_\by_\bp_\bt
4396
4397        Type: boolean
4398
4399        Default: yes
4400
4401        Controls the handling of encrypted messages when forwarding a message.  When
4402        _\bs_\be_\bt, the outer layer of encryption is stripped off.  This variable is only used
4403        if ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  , page 97)'' is _\bs_\be_\bt and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
4404        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.137  , page 98)'' is _\bu_\bn_\bs_\be_\bt.  (PGP only)
4405
4406        _\b6_\b._\b3_\b._\b7_\b1  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\be_\bd_\bi_\bt
4407
4408        Type: quadoption
4409
4410        Default: yes
4411
4412        This quadoption controls whether or not the user is automatically placed in the
4413        editor when forwarding messages.  For those who always want to forward with no
4414        modification, use a setting of _\bn_\bo.
4415
4416        _\b6_\b._\b3_\b._\b7_\b2  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
4417
4418        Type: string
4419
4420        Default: '[%a: %s]'
4421
4422        The Mutt-ng E-Mail Client                                                    83
4423
4424        This variable controls the default subject when forwarding a message.  It uses
4425        the same format sequences as the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90)''
4426        variable.
4427
4428        _\b6_\b._\b3_\b._\b7_\b3  _\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bq_\bu_\bo_\bt_\be
4429
4430        Type: boolean
4431
4432        Default: no
4433
4434        When _\bs_\be_\bt forwarded messages included in the main body of the message (when
4435        ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  , page 97)'' is _\bu_\bn_\bs_\be_\bt) will be quoted using
4436        ``_\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 6.3.109  , page 90)''.
4437
4438        _\b6_\b._\b3_\b._\b7_\b4  _\bf_\br_\bo_\bm
4439
4440        Type: e-mail address
4441
4442        Default: ''
4443
4444        This variable contains a default from address.  It can be overridden using
4445        my_hdr (including from send-hooks) and ``_\b$_\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 6.3.236  , page
4446        122)''.  This variable is ignored if ``_\b$_\bu_\bs_\be_\b__\bf_\br_\bo_\bm (section 6.3.327  , page
4447        144)'' is unset.
4448
4449        E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar
4450        <foo@bar.fb>' when replying to the mutt-ng developer's mailing list and Mutt-ng
4451        takes this email address.
4452
4453        Defaults to the contents of the environment variable $EMAIL.
4454
4455        _\b6_\b._\b3_\b._\b7_\b5  _\bg_\be_\bc_\bo_\bs_\b__\bm_\ba_\bs_\bk
4456
4457        Type: regular expression
4458
4459        Default: '^[^,]*'
4460
4461        A regular expression used by Mutt-ng to parse the GECOS field of a password
4462        entry when expanding the alias.  By default the regular expression is set to
4463        ``^[^,]*'' which will return the string up to the first ``,'' encountered.  If
4464        the GECOS field contains a string like 'lastname, firstname' then you should
4465        do: set gecos_mask='.*'.
4466
4467        This can be useful if you see the following behavior: you address a e-mail to
4468        user ID stevef whose full name is Steve Franklin.  If Mutt-ng expands stevef to
4469        ``Franklin'' stevef@foo.bar then you should set the gecos_mask to a regular
4470        expression that will match the whole name so Mutt-ng will expand ``Franklin''
4471        to ``Franklin, Steve''.
4472
4473        _\b6_\b._\b3_\b._\b7_\b6  _\bh_\bd_\br_\bs
4474
4475        Type: boolean
4476
4477        Default: yes
4478
4479        The Mutt-ng E-Mail Client                                                    84
4480
4481        When _\bu_\bn_\bs_\be_\bt, the header fields normally added by the ``_\bm_\by_\b__\bh_\bd_\br (section 3.13  ,
4482        page 25)'' command are not created.  This variable _\bm_\bu_\bs_\bt be _\bu_\bn_\bs_\be_\bt before compos-
4483        ing a new message or replying in order to take effect.  If _\bs_\be_\bt, the user
4484        defined header fields are added to every new message.
4485
4486        _\b6_\b._\b3_\b._\b7_\b7  _\bh_\be_\ba_\bd_\be_\br
4487
4488        Type: boolean
4489
4490        Default: no
4491
4492        When _\bs_\be_\bt, this variable causes Mutt-ng to include the header of the message you
4493        are replying to into the edit buffer.  The ``_\b$_\bw_\be_\be_\bd (section 6.3.333  , page
4494        146)'' setting applies.
4495
4496        _\b6_\b._\b3_\b._\b7_\b8  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be
4497
4498        Type: path
4499
4500        Default: ''
4501
4502        Availability: Header Cache
4503
4504        The _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 6.3.78  , page 83) variable points to the header
4505        cache database.
4506
4507        If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 6.3.78  , page 83) points to a directory it will con-
4508        tain a header cache database  per folder. If _\b$_\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be (section 6.3.78  ,
4509        page 83) points to a file that file will be a single global header cache. By
4510        default it is _\bu_\bn_\bs_\be_\bt so no header caching will be used.
4511
4512        _\b6_\b._\b3_\b._\b7_\b9  _\bh_\be_\ba_\bd_\be_\br_\b__\bc_\ba_\bc_\bh_\be_\b__\bc_\bo_\bm_\bp_\br_\be_\bs_\bs
4513
4514        Type: boolean
4515
4516        Default: no
4517
4518        If enabled the header cache will be compressed. So only one fifth of the usual
4519        diskspace is used, but the uncompression can result in a slower open of the
4520        cached folder.
4521
4522        _\b6_\b._\b3_\b._\b8_\b0  _\bh_\be_\bl_\bp
4523
4524        Type: boolean
4525
4526        Default: yes
4527
4528        When _\bs_\be_\bt, help lines describing the bindings for the major functions provided
4529        by each menu are displayed on the first line of the screen.
4530
4531        N\bNo\bot\bte\be:\b: The binding will not be displayed correctly if the function is bound to a
4532        sequence rather than a single keystroke.  Also, the help line may not be
4533        updated if a binding is changed while Mutt-ng is running.  Since this variable
4534        is primarily aimed at new users, neither of these should present a major
4535
4536        The Mutt-ng E-Mail Client                                                    85
4537
4538        problem.
4539
4540        _\b6_\b._\b3_\b._\b8_\b1  _\bh_\bi_\bd_\bd_\be_\bn_\b__\bh_\bo_\bs_\bt
4541
4542        Type: boolean
4543
4544        Default: no
4545
4546        When _\bs_\be_\bt, Mutt-ng will skip the host name part of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section
4547        6.3.89  , page 85)'' variable when adding the domain part to addresses.  This
4548        variable does not affect the generation of Message-ID: header fields, and it
4549        will not lead to the cut-off of first-level domains.
4550
4551        _\b6_\b._\b3_\b._\b8_\b2  _\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
4552
4553        Type: boolean
4554
4555        Default: no
4556
4557        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
4558        limiting, in the thread tree.
4559
4560        _\b6_\b._\b3_\b._\b8_\b3  _\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
4561
4562        Type: boolean
4563
4564        Default: yes
4565
4566        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages in the thread
4567        tree.
4568
4569        _\b6_\b._\b3_\b._\b8_\b4  _\bh_\bi_\bd_\be_\b__\bt_\bh_\br_\be_\ba_\bd_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
4570
4571        Type: boolean
4572
4573        Default: yes
4574
4575        When _\bs_\be_\bt, Mutt-ng will not show the subject of messages in the thread tree that
4576        have the same subject as their parent or closest previously displayed sibling.
4577
4578        _\b6_\b._\b3_\b._\b8_\b5  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd
4579
4580        Type: boolean
4581
4582        Default: no
4583
4584        When _\bs_\be_\bt, Mutt-ng will not show the presence of messages that are hidden by
4585        limiting, at the top of threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bm_\bi_\bs_\bs_\b-
4586        _\bi_\bn_\bg (section 6.3.83  , page 84) is set, this option will have no effect.
4587
4588        _\b6_\b._\b3_\b._\b8_\b6  _\bh_\bi_\bd_\be_\b__\bt_\bo_\bp_\b__\bm_\bi_\bs_\bs_\bi_\bn_\bg
4589
4590        Type: boolean
4591
4592        The Mutt-ng E-Mail Client                                                    86
4593
4594        Default: yes
4595
4596        When _\bs_\be_\bt, Mutt-ng will not show the presence of missing messages at the top of
4597        threads in the thread tree.  Note that when _\b$_\bh_\bi_\bd_\be_\b__\bl_\bi_\bm_\bi_\bt_\be_\bd (section 6.3.82  ,
4598        page 84) is _\bs_\be_\bt, this option will have no effect.
4599
4600        _\b6_\b._\b3_\b._\b8_\b7  _\bh_\bi_\bs_\bt_\bo_\br_\by
4601
4602        Type: number
4603
4604        Default: 10
4605
4606        This variable controls the size (in number of strings remembered) of the string
4607        history buffer. The buffer is cleared each time the variable is changed.
4608
4609        _\b6_\b._\b3_\b._\b8_\b8  _\bh_\bo_\bn_\bo_\br_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
4610
4611        Type: quadoption
4612
4613        Default: yes
4614
4615        This variable controls whether or not a Mail-Followup-To: header field is hon-
4616        ored when group-replying to a message.
4617
4618        _\b6_\b._\b3_\b._\b8_\b9  _\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be
4619
4620        Type: string
4621
4622        Default: ''
4623
4624        Specifies the hostname to use after the ``@'' in local e-mail addresses and
4625        during generation of Message-Id: headers.
4626
4627        Please be sure to really know what you are doing when changing this variable to
4628        configure a custom domain part of Message-IDs.
4629
4630        _\b6_\b._\b3_\b._\b9_\b0  _\bi_\bg_\bn_\bo_\br_\be_\b__\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by_\b__\bt_\bo
4631
4632        Type: boolean
4633
4634        Default: no
4635
4636        Affects the behaviour of the _\br_\be_\bp_\bl_\by function when replying to messages from
4637        mailing lists.  When _\bs_\be_\bt, if the ``Reply-To:'' header field is set to the same
4638        value as the ``To:'' header field, Mutt-ng assumes that the ``Reply-To:''
4639        header field was set by the mailing list to automate responses to the list, and
4640        will ignore this field.  To direct a response to the mailing list when this
4641        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
4642        sender and the list.
4643
4644        _\b6_\b._\b3_\b._\b9_\b1  _\bi_\bm_\ba_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
4645
4646        Type: string
4647
4648        The Mutt-ng E-Mail Client                                                    87
4649
4650        Default: ''
4651
4652        Availability: IMAP
4653
4654        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
4655        use to log in to an IMAP server, in the order Mutt-ng should try them.  Authen-
4656        tication methods are either ``login'' or the right side of an IMAP ``AUTH=''
4657        capability string, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''. This param-
4658        eter is case-insensitive.
4659
4660        If this parameter is _\bu_\bn_\bs_\be_\bt (the default) Mutt-ng will try all available meth-
4661        ods, in order from most-secure to least-secure.
4662
4663        Example: set imap_authenticators='gssapi:cram-md5:login'
4664
4665        N\bNo\bot\bte\be:\b: Mutt-ng will only fall back to other authentication methods if the previ-
4666        ous methods are unavailable. If a method is available but authentication fails,
4667        Mutt-ng will not connect to the IMAP server.
4668
4669        _\b6_\b._\b3_\b._\b9_\b2  _\bi_\bm_\ba_\bp_\b__\bd_\be_\bl_\bi_\bm_\b__\bc_\bh_\ba_\br_\bs
4670
4671        Type: string
4672
4673        Default: '/.'
4674
4675        Availability: IMAP
4676
4677        This contains the list of characters which you would like to treat as folder
4678        separators for displaying IMAP paths. In particular it helps in using the '='
4679        shortcut for your _\b$_\bf_\bo_\bl_\bd_\be_\br (section 6.3.64  , page 79) variable.
4680
4681        _\b6_\b._\b3_\b._\b9_\b3  _\bi_\bm_\ba_\bp_\b__\bf_\bo_\br_\bc_\be_\b__\bs_\bs_\bl
4682
4683        Type: boolean
4684
4685        Default: no
4686
4687        Availability: IMAP and SSL or IMAP and GNUTLS
4688
4689        If this variable is _\bs_\be_\bt, Mutt-ng will always use SSL when connecting to IMAP
4690        servers.
4691
4692        _\b6_\b._\b3_\b._\b9_\b4  _\bi_\bm_\ba_\bp_\b__\bh_\be_\ba_\bd_\be_\br_\bs
4693
4694        Type: string
4695
4696        Default: ''
4697
4698        Availability: IMAP
4699
4700        Mutt-ng requests these header fields in addition to the default headers (``DATE
4701        FROM SUBJECT TO CC MESSAGE-ID REFERENCES CONTENT-TYPE CONTENT-DESCRIPTION IN-
4702        REPLY-TO REPLY-TO LINES X-LABEL'') from IMAP servers before displaying the
4703        ``index'' menu. You may want to add more headers for spam detection.
4704
4705        The Mutt-ng E-Mail Client                                                    88
4706
4707        N\bNo\bot\bte\be:\b: This is a space separated list.
4708
4709        _\b6_\b._\b3_\b._\b9_\b5  _\bi_\bm_\ba_\bp_\b__\bh_\bo_\bm_\be_\b__\bn_\ba_\bm_\be_\bs_\bp_\ba_\bc_\be
4710
4711        Type: string
4712
4713        Default: ''
4714
4715        Availability: IMAP
4716
4717        You normally want to see your personal folders alongside your INBOX in the IMAP
4718        browser. If you see something else, you may set this variable to the IMAP path
4719        to your folders.
4720
4721        _\b6_\b._\b3_\b._\b9_\b6  _\bi_\bm_\ba_\bp_\b__\bk_\be_\be_\bp_\ba_\bl_\bi_\bv_\be
4722
4723        Type: number
4724
4725        Default: 900
4726
4727        Availability: IMAP
4728
4729        This variable specifies the maximum amount of time in seconds that Mutt-ng will
4730        wait before polling open IMAP connections, to prevent the server from closing
4731        them before Mutt-ng has finished with them.
4732
4733        The default is well within the RFC-specified minimum amount of time (30 min-
4734        utes) before a server is allowed to do this, but in practice the RFC does get
4735        violated every now and then.
4736
4737        Reduce this number if you find yourself getting disconnected from your IMAP
4738        server due to inactivity.
4739
4740        _\b6_\b._\b3_\b._\b9_\b7  _\bi_\bm_\ba_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
4741
4742        Type: boolean
4743
4744        Default: no
4745
4746        Availability: IMAP
4747
4748        This variable configures whether IMAP folder browsing will look for only sub-
4749        scribed folders or all folders.  This can be toggled in the IMAP browser with
4750        the _\bt_\bo_\bg_\bg_\bl_\be_\b-_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd function.
4751
4752        _\b6_\b._\b3_\b._\b9_\b8  _\bi_\bm_\ba_\bp_\b__\bl_\bo_\bg_\bi_\bn
4753
4754        Type: string
4755
4756        Default: ''
4757
4758        Availability: IMAP
4759
4760        Your login name on the IMAP server.
4761
4762        The Mutt-ng E-Mail Client                                                    89
4763
4764        This variable defaults to the value of ``_\b$_\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br (section 6.3.105  , page
4765        89).''
4766
4767        _\b6_\b._\b3_\b._\b9_\b9  _\bi_\bm_\ba_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
4768
4769        Type: number
4770
4771        Default: 300
4772
4773        This variable configures how often (in seconds) Mutt-ng should look for new
4774        mail in IMAP folders. This is split from the ``_\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk (section 6.3.115  ,
4775        page 93)'' variable to generate less traffic and get more accurate information
4776        for local folders.
4777
4778        _\b6_\b._\b3_\b._\b1_\b0_\b0  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs
4779
4780        Type: string
4781
4782        Default: ''
4783
4784        Availability: IMAP
4785
4786        Specifies the password for your IMAP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt
4787        you for your password when you invoke the fetch-mail function.
4788
4789        W\bWa\bar\brn\bni\bin\bng\bg: you should only use this option when you are on a fairly secure
4790        machine, because the superuser can read your configuration even if you are the
4791        only one who can read the file.
4792
4793        _\b6_\b._\b3_\b._\b1_\b0_\b1  _\bi_\bm_\ba_\bp_\b__\bp_\ba_\bs_\bs_\bi_\bv_\be
4794
4795        Type: boolean
4796
4797        Default: yes
4798
4799        Availability: IMAP
4800
4801        When _\bs_\be_\bt, Mutt-ng will not open new IMAP connections to check for new mail.
4802        Mutt-ng will only check for new mail over existing IMAP connections.  This is
4803        useful if you don't want to be prompted to user/password pairs on Mutt-ng invo-
4804        cation, or if opening the connection is slow.
4805
4806        _\b6_\b._\b3_\b._\b1_\b0_\b2  _\bi_\bm_\ba_\bp_\b__\bp_\be_\be_\bk
4807
4808        Type: boolean
4809
4810        Default: yes
4811
4812        Availability: IMAP
4813
4814        If _\bs_\be_\bt, Mutt-ng will avoid implicitly marking your mail as read whenever you
4815        fetch a message from the server. This is generally a good thing, but can make
4816        closing an IMAP folder somewhat slower. This option exists to appease speed
4817        freaks.
4818
4819        The Mutt-ng E-Mail Client                                                    90
4820
4821        _\b6_\b._\b3_\b._\b1_\b0_\b3  _\bi_\bm_\ba_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
4822
4823        Type: quadoption
4824
4825        Default: ask-yes
4826
4827        Availability: IMAP
4828
4829        Controls whether or not Mutt-ng will try to reconnect to IMAP server when the
4830        connection is lost.
4831
4832        _\b6_\b._\b3_\b._\b1_\b0_\b4  _\bi_\bm_\ba_\bp_\b__\bs_\be_\br_\bv_\be_\br_\bn_\bo_\bi_\bs_\be
4833
4834        Type: boolean
4835
4836        Default: yes
4837
4838        Availability: IMAP
4839
4840        When _\bs_\be_\bt, Mutt-ng will display warning messages from the IMAP server as error
4841        messages. Since these messages are often harmless, or generated due to configu-
4842        ration problems on the server which are out of the users' hands, you may wish
4843        to suppress them at some point.
4844
4845        _\b6_\b._\b3_\b._\b1_\b0_\b5  _\bi_\bm_\ba_\bp_\b__\bu_\bs_\be_\br
4846
4847        Type: string
4848
4849        Default: ''
4850
4851        Availability: IMAP
4852
4853        The name of the user whose mail you intend to access on the IMAP server.
4854
4855        This variable defaults to your user name on the local machine.
4856
4857        _\b6_\b._\b3_\b._\b1_\b0_\b6  _\bi_\bm_\bp_\bl_\bi_\bc_\bi_\bt_\b__\ba_\bu_\bt_\bo_\bv_\bi_\be_\bw
4858
4859        Type: boolean
4860
4861        Default: no
4862
4863        If _\bs_\be_\bt, Mutt-ng will look for a mailcap entry with the ``copiousoutput'' flag
4864        set for _\be_\bv_\be_\br_\by MIME attachment it doesn't have an internal viewer defined for.
4865        If such an entry is found, Mutt-ng will use the viewer defined in that entry to
4866        convert the body part to text form.
4867
4868        _\b6_\b._\b3_\b._\b1_\b0_\b7  _\bi_\bn_\bc_\bl_\bu_\bd_\be
4869
4870        Type: quadoption
4871
4872        Default: ask-yes
4873
4874        Controls whether or not a copy of the message(s) you are replying to is
4875
4876        The Mutt-ng E-Mail Client                                                    91
4877
4878        included in your reply.
4879
4880        _\b6_\b._\b3_\b._\b1_\b0_\b8  _\bi_\bn_\bc_\bl_\bu_\bd_\be_\b__\bo_\bn_\bl_\by_\bf_\bi_\br_\bs_\bt
4881
4882        Type: boolean
4883
4884        Default: no
4885
4886        Controls whether or not Mutt-ng includes only the first attachment of the mes-
4887        sage you are replying.
4888
4889        _\b6_\b._\b3_\b._\b1_\b0_\b9  _\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
4890
4891        Type: string
4892
4893        Default: '> '
4894
4895        Specifies the string to prepend to each line of text quoted in a message to
4896        which you are replying.  You are strongly encouraged not to change this value,
4897        as it tends to agitate the more fanatical netizens.
4898
4899        _\b6_\b._\b3_\b._\b1_\b1_\b0  _\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
4900
4901        Type: string
4902
4903        Default: '%4C %Z %{%b %d} %-15.15L (%?l?%4l&%4c?) %s'
4904
4905        This variable allows you to customize the message index display to your per-
4906        sonal taste.
4907
4908        ``Format strings'' are similar to the strings used in the ``C'' function
4909        printf(3) to format output (see the man page for more detail).  The following
4910        sequences are defined in Mutt-ng:
4911
4912              %a
4913                    address of the author
4914
4915              %A
4916                    reply-to address (if present; otherwise: address of author)
4917
4918              %b
4919                    filename of the original message folder (think mailBox)
4920
4921              %B
4922                    the list to which the letter was sent, or else the folder name
4923                    (%b).
4924
4925              %c
4926                    number of characters (bytes) in the message
4927
4928              %C
4929                    current message number
4930
4931        The Mutt-ng E-Mail Client                                                    92
4932
4933              %d
4934                    date and time of the message in the format specified by ``date_for-
4935                    mat'' converted to sender's time zone
4936
4937              %D
4938                    date and time of the message in the format specified by ``date_for-
4939                    mat'' converted to the local time zone
4940
4941              %e
4942                    current message number in thread
4943
4944              %E
4945                    number of messages in current thread
4946
4947              %f
4948                    entire From: line (address + real name)
4949
4950              %F
4951                    author name, or recipient name if the message is from you
4952
4953              %H
4954                    spam attribute(s) of this message
4955
4956              %g
4957                    newsgroup name (if compiled with nntp support)
4958
4959              %i
4960                    message-id of the current message
4961
4962              %l
4963                    number of lines in the message (does not work with maildir, mh, and
4964                    possibly IMAP folders)
4965
4966              %L
4967                    If an address in the To or CC header field matches an address
4968                    defined by the users ``subscribe'' command, this displays 'To
4969                    <list-name>', otherwise the same as %F.
4970
4971              %m
4972                    total number of message in the mailbox
4973
4974              %M
4975                    number of hidden messages if the thread is collapsed.
4976
4977              %N
4978                    message score
4979
4980              %n
4981                    author's real name (or address if missing)
4982
4983              %O
4984                    (_O_riginal save folder)  Where Mutt-ng would formerly have stashed
4985                    the message: list name or recipient name if no list
4986
4987        The Mutt-ng E-Mail Client                                                    93
4988
4989              %s
4990                    subject of the message
4991
4992              %S
4993                    status of the message (N/D/d/!/r/*)
4994
4995              %t
4996                    `to:' field (recipients)
4997
4998              %T
4999                    the appropriate character from the _\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 6.3.320  ,
5000                    page 143) string
5001
5002              %u
5003                    user (login) name of the author
5004
5005              %v
5006                    first name of the author, or the recipient if the message is from
5007                    you
5008
5009              %W
5010                    name of organization of author (`organization:' field)
5011
5012              %y
5013                    `x-label:' field, if present
5014
5015              %Y
5016                    `x-label' field, if present, and (1) not at part of a thread tree,
5017                    (2) at the top of a thread, or (3) `x-label' is different from pre-
5018                    ceding message's `x-label'.
5019
5020              %Z
5021                    message status flags
5022
5023              %{fmt}
5024                    the date and time of the message is converted to sender's time
5025                    zone, and ``fmt'' is expanded by the library function ``strftime'';
5026                    a leading bang disables locales
5027
5028              %[fmt]
5029                    the date and time of the message is converted to the local time
5030                    zone, and ``fmt'' is expanded by the library function ``strftime'';
5031                    a leading bang disables locales
5032
5033              %(fmt)
5034                    the local date and time when the message was received.  ``fmt'' is
5035                    expanded by the library function ``strftime''; a leading bang dis-
5036                    ables locales
5037
5038              %<fmt>
5039                    the current local time. ``fmt'' is expanded by the library function
5040                    ``strftime''; a leading bang disables locales.
5041
5042        The Mutt-ng E-Mail Client                                                    94
5043
5044              %>X
5045                    right justify the rest of the string and pad with character 'X'
5046
5047              %|X
5048                    pad to the end of the line with character 'X'
5049
5050        See also: ``_\b$_\bt_\bo_\b__\bc_\bh_\ba_\br_\bs (section 6.3.320  , page 143)''.
5051
5052        _\b6_\b._\b3_\b._\b1_\b1_\b1  _\bi_\bs_\bp_\be_\bl_\bl
5053
5054        Type: path
5055
5056        Default: 'ispell'
5057
5058        How to invoke ispell (GNU's spell-checking software).
5059
5060        _\b6_\b._\b3_\b._\b1_\b1_\b2  _\bk_\be_\be_\bp_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
5061
5062        Type: boolean
5063
5064        Default: no
5065
5066        If _\bs_\be_\bt, read messages marked as flagged will not be moved from your spool mail-
5067        box to your ``_\b$_\bm_\bb_\bo_\bx (section 6.3.124  , page 95)'' mailbox, or as a result of a
5068        ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.11  , page 25)'' command.
5069
5070        _\b6_\b._\b3_\b._\b1_\b1_\b3  _\bl_\bi_\bs_\bt_\b__\br_\be_\bp_\bl_\by
5071
5072        Type: quadoption
5073
5074        Default: no
5075
5076        When _\bs_\be_\bt, address replies to the mailing list the original message came from
5077        (instead to the author only). Setting this option to ``_\ba_\bs_\bk_\b-_\by_\be_\bs'' or ``_\ba_\bs_\bk_\b-_\bn_\bo''
5078        will ask if you really intended to reply to the author only.
5079
5080        _\b6_\b._\b3_\b._\b1_\b1_\b4  _\bl_\bo_\bc_\ba_\bl_\be
5081
5082        Type: string
5083
5084        Default: 'C'
5085
5086        The locale used by strftime(3) to format dates. Legal values are the strings
5087        your system accepts for the locale variable LC_TIME.
5088
5089        _\b6_\b._\b3_\b._\b1_\b1_\b5  _\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5090
5091        Type: number
5092
5093        Default: 5
5094
5095        This variable configures how often (in seconds) Mutt-ng should look for new
5096        mail.
5097
5098        The Mutt-ng E-Mail Client                                                    95
5099
5100        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
5101        6.3.99  , page 88).
5102
5103        _\b6_\b._\b3_\b._\b1_\b1_\b6  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bp_\ba_\bt_\bh
5104
5105        Type: string
5106
5107        Default: ''
5108
5109        This variable specifies which files to consult when attempting to display MIME
5110        bodies not directly supported by Mutt-ng.
5111
5112        _\b6_\b._\b3_\b._\b1_\b1_\b7  _\bm_\ba_\bi_\bl_\bc_\ba_\bp_\b__\bs_\ba_\bn_\bi_\bt_\bi_\bz_\be
5113
5114        Type: boolean
5115
5116        Default: yes
5117
5118        If _\bs_\be_\bt, Mutt-ng will restrict possible characters in mailcap % expandos to a
5119        well-defined set of safe characters.  This is the safe setting, but we are not
5120        sure it doesn't break some more advanced MIME stuff.
5121
5122        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!
5123
5124        _\b6_\b._\b3_\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
5125
5126        Type: boolean
5127
5128        Default: yes
5129
5130        Availability: Header Cache
5131
5132        Check for Maildir unaware programs other than Mutt-ng having modified maildir
5133        files when the header cache is in use. This incurs one stat(2) per message
5134        every time the folder is opened.
5135
5136        _\b6_\b._\b3_\b._\b1_\b1_\b9  _\bm_\ba_\bi_\bl_\bd_\bi_\br_\b__\bt_\br_\ba_\bs_\bh
5137
5138        Type: boolean
5139
5140        Default: no
5141
5142        If _\bs_\be_\bt, messages marked as deleted will be saved with the maildir (T)rashed
5143        flag instead of physically deleted.
5144
5145        N\bNO\bOT\bTE\bE:\b: this only applies to maildir-style mailboxes. Setting it will have no
5146        effect on other mailbox types.
5147
5148        It is similiar to the trash option.
5149
5150        _\b6_\b._\b3_\b._\b1_\b2_\b0  _\bm_\ba_\br_\bk_\b__\bo_\bl_\bd
5151
5152        Type: boolean
5153
5154        The Mutt-ng E-Mail Client                                                    96
5155
5156        Default: yes
5157
5158        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
5159        mailbox without reading them.
5160
5161        With this option _\bs_\be_\bt, the next time you start Mutt-ng, the messages will show
5162        up with an 'O' next to them in the ``index'' menu, indicating that they are
5163        old.
5164
5165        _\b6_\b._\b3_\b._\b1_\b2_\b1  _\bm_\ba_\br_\bk_\be_\br_\bs
5166
5167        Type: boolean
5168
5169        Default: yes
5170
5171        Controls the display of wrapped lines in the internal pager. If set, a ``+''
5172        marker is displayed at the beginning of wrapped lines. Also see the
5173        ``_\b$_\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp (section 6.3.263  , page 128)'' variable.
5174
5175        _\b6_\b._\b3_\b._\b1_\b2_\b2  _\bm_\ba_\bs_\bk
5176
5177        Type: regular expression
5178
5179        Default: '!^\.[^.]'
5180
5181        A regular expression used in the file browser, optionally preceded by the _\bn_\bo_\bt
5182        operator ``!''.  Only files whose names match this mask will be shown. The
5183        match is always case-sensitive.
5184
5185        _\b6_\b._\b3_\b._\b1_\b2_\b3  _\bm_\ba_\bx_\b__\bl_\bi_\bn_\be_\b__\bl_\be_\bn_\bg_\bt_\bh
5186
5187        Type: number
5188
5189        Default: 0
5190
5191        When _\bs_\be_\bt, the maximum line length for displaying ``format = flowed'' messages
5192        is limited to this length. A value of 0 (which is also the default) means that
5193        the maximum line length is determined by the terminal width and _\b$_\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
5194        (section 6.3.335  , page 146).
5195
5196        _\b6_\b._\b3_\b._\b1_\b2_\b4  _\bm_\bb_\bo_\bx
5197
5198        Type: path
5199
5200        Default: '~/mbox'
5201
5202        This specifies the folder into which read mail in your ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section
5203        6.3.295  , page 136)'' folder will be appended.
5204
5205        _\b6_\b._\b3_\b._\b1_\b2_\b5  _\bm_\bb_\bo_\bx_\b__\bt_\by_\bp_\be
5206
5207        Type: folder magic
5208
5209        Default: mbox
5210
5211        The Mutt-ng E-Mail Client                                                    97
5212
5213        The default mailbox type used when creating new folders. May be any of mbox,
5214        MMDF, MH and Maildir.
5215
5216        _\b6_\b._\b3_\b._\b1_\b2_\b6  _\bm_\be_\bn_\bu_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
5217
5218        Type: number
5219
5220        Default: 0
5221
5222        This variable controls the number of lines of context that are given when
5223        scrolling through menus. (Similar to ``_\b$_\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 6.3.167  , page
5224        106)''.)
5225
5226        _\b6_\b._\b3_\b._\b1_\b2_\b7  _\bm_\be_\bn_\bu_\b__\bm_\bo_\bv_\be_\b__\bo_\bf_\bf
5227
5228        Type: boolean
5229
5230        Default: yes
5231
5232        When _\bu_\bn_\bs_\be_\bt, the bottom entry of menus will never scroll up past the bottom of
5233        the screen, unless there are less entries than lines.  When _\bs_\be_\bt, the bottom
5234        entry may move off the bottom.
5235
5236        _\b6_\b._\b3_\b._\b1_\b2_\b8  _\bm_\be_\bn_\bu_\b__\bs_\bc_\br_\bo_\bl_\bl
5237
5238        Type: boolean
5239
5240        Default: no
5241
5242        When _\bs_\be_\bt, menus will be scrolled up or down one line when you attempt to move
5243        across a screen boundary.  If _\bu_\bn_\bs_\be_\bt, the screen is cleared and the next or pre-
5244        vious page of the menu is displayed (useful for slow links to avoid many
5245        redraws).
5246
5247        _\b6_\b._\b3_\b._\b1_\b2_\b9  _\bm_\be_\bs_\bs_\ba_\bg_\be_\b__\bf_\bo_\br_\bm_\ba_\bt
5248
5249        Type: string
5250
5251        Default: '%s'
5252
5253        This is the string displayed in the ``attachment'' menu for attachments of type
5254        message/rfc822.  For a full listing of defined printf(3)-like sequences see the
5255        section on ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90)''.
5256
5257        _\b6_\b._\b3_\b._\b1_\b3_\b0  _\bm_\be_\bt_\ba_\b__\bk_\be_\by
5258
5259        Type: boolean
5260
5261        Default: no
5262
5263        If _\bs_\be_\bt, forces Mutt-ng to interpret keystrokes with the high bit (bit 8) set as
5264        if the user had pressed the ESC key and whatever key remains after having the
5265        high bit removed.  For example, if the key pressed has an ASCII value of 0xf4,
5266        then this is treated as if the user had pressed ESC then ``x''.  This is
5267
5268        The Mutt-ng E-Mail Client                                                    98
5269
5270        because the result of removing the high bit from ``0xf4'' is ``0x74'', which is
5271        the ASCII character ``x''.
5272
5273        _\b6_\b._\b3_\b._\b1_\b3_\b1  _\bm_\be_\bt_\bo_\bo
5274
5275        Type: boolean
5276
5277        Default: no
5278
5279        If _\bu_\bn_\bs_\be_\bt, Mutt-ng will remove your address (see the ``alternates'' command)
5280        from the list of recipients when replying to a message.
5281
5282        _\b6_\b._\b3_\b._\b1_\b3_\b2  _\bm_\bh_\b__\bp_\bu_\br_\bg_\be
5283
5284        Type: boolean
5285
5286        Default: no
5287
5288        When _\bu_\bn_\bs_\be_\bt, Mutt-ng will mimic mh's behaviour and rename deleted messages to
5289        _\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-
5290        able is set, the message files will simply be deleted.
5291
5292        _\b6_\b._\b3_\b._\b1_\b3_\b3  _\bm_\bh_\b__\bs_\be_\bq_\b__\bf_\bl_\ba_\bg_\bg_\be_\bd
5293
5294        Type: string
5295
5296        Default: 'flagged'
5297
5298        The name of the MH sequence used for flagged messages.
5299
5300        _\b6_\b._\b3_\b._\b1_\b3_\b4  _\bm_\bh_\b__\bs_\be_\bq_\b__\br_\be_\bp_\bl_\bi_\be_\bd
5301
5302        Type: string
5303
5304        Default: 'replied'
5305
5306        The name of the MH sequence used to tag replied messages.
5307
5308        _\b6_\b._\b3_\b._\b1_\b3_\b5  _\bm_\bh_\b__\bs_\be_\bq_\b__\bu_\bn_\bs_\be_\be_\bn
5309
5310        Type: string
5311
5312        Default: 'unseen'
5313
5314        The name of the MH sequence used for unseen messages.
5315
5316        _\b6_\b._\b3_\b._\b1_\b3_\b6  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd
5317
5318        Type: quadoption
5319
5320        Default: no
5321
5322        When _\bs_\be_\bt, the message you are forwarding will be attached as a separate MIME
5323        part instead of included in the main body of the message.
5324
5325        The Mutt-ng E-Mail Client                                                    99
5326
5327        This is useful for forwarding MIME messages so the receiver can properly view
5328        the message as it was delivered to you. If you like to switch between MIME and
5329        not MIME from mail to mail, set this variable to ask-no or ask-yes.
5330
5331        Also see ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.69  , page 81)'' and ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\b-
5332        _\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.137  , page 98)''.
5333
5334        _\b6_\b._\b3_\b._\b1_\b3_\b7  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be
5335
5336        Type: boolean
5337
5338        Default: no
5339
5340        Controls the decoding of complex MIME messages into text/plain when forwarding
5341        a message while ``_\b$_\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd (section 6.3.136  , page 97)'' is _\bs_\be_\bt. Other-
5342        wise ``_\b$_\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\bd_\be_\bc_\bo_\bd_\be (section 6.3.69  , page 81)'' is used instead.
5343
5344        _\b6_\b._\b3_\b._\b1_\b3_\b8  _\bm_\bi_\bm_\be_\b__\bf_\bo_\br_\bw_\ba_\br_\bd_\b__\br_\be_\bs_\bt
5345
5346        Type: quadoption
5347
5348        Default: yes
5349
5350        When forwarding multiple attachments of a MIME message from the recvattach
5351        menu, attachments which cannot be decoded in a reasonable manner will be
5352        attached to the newly composed message if this option is set.
5353
5354        _\b6_\b._\b3_\b._\b1_\b3_\b9  _\bm_\bi_\bx_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
5355
5356        Type: string
5357
5358        Default: '%4n %c %-16s %a'
5359
5360        Availability: Mixmaster
5361
5362        This variable describes the format of a remailer line on the mixmaster chain
5363        selection screen.  The following printf(3)-like sequences are supported:
5364
5365              %n
5366                    The running number on the menu.
5367
5368              %c
5369                    Remailer capabilities.
5370
5371              %s
5372                    The remailer's short name.
5373
5374              %a
5375                    The remailer's e-mail address.
5376
5377        _\b6_\b._\b3_\b._\b1_\b4_\b0  _\bm_\bi_\bx_\bm_\ba_\bs_\bt_\be_\br
5378
5379        Type: path
5380
5381        The Mutt-ng E-Mail Client                                                   100
5382
5383        Default: 'mixmaster'
5384
5385        Availability: Mixmaster
5386
5387        This variable contains the path to the Mixmaster binary on your system.  It is
5388        used with various sets of parameters to gather the list of known remailers, and
5389        to finally send a message through the mixmaster chain.
5390
5391        _\b6_\b._\b3_\b._\b1_\b4_\b1  _\bm_\bo_\bv_\be
5392
5393        Type: quadoption
5394
5395        Default: ask-no
5396
5397        Controls whether or not Mutt-ng will move read messages from your spool mailbox
5398        to your ``_\b$_\bm_\bb_\bo_\bx (section 6.3.124  , page 95)'' mailbox, or as a result of a
5399        ``_\bm_\bb_\bo_\bx_\b-_\bh_\bo_\bo_\bk (section 3.11  , page 25)'' command.
5400
5401        _\b6_\b._\b3_\b._\b1_\b4_\b2  _\bm_\bs_\bg_\bi_\bd_\b__\bf_\bo_\br_\bm_\ba_\bt
5402
5403        Type: string
5404
5405        Default: '%Y%m%d%h%M%s.G%P%p'
5406
5407        This is the format for the ``local part'' of the Message-Id: header field gen-
5408        erated by Mutt-ng. If this variable is empty, no Message-Id: headers will be
5409        generated. The '%' character marks that certain data will be added to the
5410        string, similar to printf(3). The following characters are allowed:
5411
5412              %d
5413                    the current day of month
5414
5415              %h
5416                    the current hour
5417
5418              %m
5419                    the current month
5420
5421              %M
5422                    the current minute
5423
5424              %O
5425                    the current UNIX timestamp (octal)
5426
5427              %p
5428                    the process ID
5429
5430              %P
5431                    the current Message-ID prefix (a character rotating with every Mes-
5432                    sage-ID being generated)
5433
5434              %r
5435                    a random integer value (decimal)
5436
5437        The Mutt-ng E-Mail Client                                                   101
5438
5439              %R
5440                    a random integer value (hexadecimal)
5441
5442              %s
5443                    the current second
5444
5445              %T
5446                    the current UNIX timestamp (decimal)
5447
5448              %X
5449                    the current UNIX timestamp (hexadecimal)
5450
5451              %Y
5452                    the current year (Y2K compliant)
5453
5454              %%
5455                    the '%' character
5456
5457        N\bNo\bot\bte\be:\b: Please only change this setting if you know what you are doing.  Also
5458        make sure to consult RFC2822 to produce technically _\bv_\ba_\bl_\bi_\bd strings.
5459
5460        _\b6_\b._\b3_\b._\b1_\b4_\b3  _\bn_\ba_\br_\br_\bo_\bw_\b__\bt_\br_\be_\be
5461
5462        Type: boolean
5463
5464        Default: no
5465
5466        This variable, when _\bs_\be_\bt, makes the thread tree narrower, allowing deeper
5467        threads to fit on the screen.
5468
5469        _\b6_\b._\b3_\b._\b1_\b4_\b4  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo
5470
5471        Type: boolean
5472
5473        Default: no
5474
5475        Availability: NNTP
5476
5477        If _\bs_\be_\bt, Mutt-ng will prompt you for the Followup-To: header field before edit-
5478        ing the body of an outgoing news article.
5479
5480        _\b6_\b._\b3_\b._\b1_\b4_\b5  _\bn_\bn_\bt_\bp_\b__\ba_\bs_\bk_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
5481
5482        Type: boolean
5483
5484        Default: no
5485
5486        Availability: NNTP
5487
5488        If _\bs_\be_\bt, Mutt-ng will prompt you for the X-Comment-To: header field before edit-
5489        ing the body of an outgoing news article.
5490
5491        _\b6_\b._\b3_\b._\b1_\b4_\b6  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br
5492
5493        The Mutt-ng E-Mail Client                                                   102
5494
5495        Type: path
5496
5497        Default: '~/.muttng'
5498
5499        Availability: NNTP
5500
5501        This variable points to directory where Mutt-ng will cache news article head-
5502        ers. If _\bu_\bn_\bs_\be_\bt, headers will not be saved at all and will be reloaded each time
5503        when you enter a newsgroup.
5504
5505        As for the header caching in connection with IMAP and/or Maildir, this drasti-
5506        cally increases speed and lowers traffic.
5507
5508        _\b6_\b._\b3_\b._\b1_\b4_\b7  _\bn_\bn_\bt_\bp_\b__\bc_\ba_\bt_\bc_\bh_\bu_\bp
5509
5510        Type: quadoption
5511
5512        Default: ask-yes
5513
5514        Availability: NNTP
5515
5516        If this variable is _\bs_\be_\bt, Mutt-ng will mark all articles in a newsgroup as read
5517        when you leaving it.
5518
5519        _\b6_\b._\b3_\b._\b1_\b4_\b8  _\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
5520
5521        Type: number
5522
5523        Default: 1000
5524
5525        Availability: NNTP
5526
5527        This variable controls how many news articles to cache per newsgroup (if
5528        caching is enabled, see _\b$_\bn_\bn_\bt_\bp_\b__\bc_\ba_\bc_\bh_\be_\b__\bd_\bi_\br (section 6.3.146  , page 100)) and how
5529        many news articles to show in the ``index'' menu.
5530
5531        If there're more articles than defined with _\b$_\bn_\bn_\bt_\bp_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt (section 6.3.148  ,
5532        page 101), all older ones will be removed/not shown in the index.
5533
5534        _\b6_\b._\b3_\b._\b1_\b4_\b9  _\bn_\bn_\bt_\bp_\b__\bf_\bo_\bl_\bl_\bo_\bw_\bu_\bp_\b__\bt_\bo_\b__\bp_\bo_\bs_\bt_\be_\br
5535
5536        Type: quadoption
5537
5538        Default: ask-yes
5539
5540        Availability: NNTP
5541
5542        If this variable is _\bs_\be_\bt and the keyword 'poster' is present in the Followup-To:
5543        header field, a follow-up to the newsgroup is not permitted.  The message will
5544        be mailed to the submitter of the message via mail.
5545
5546        _\b6_\b._\b3_\b._\b1_\b5_\b0  _\bn_\bn_\bt_\bp_\b__\bg_\br_\bo_\bu_\bp_\b__\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt
5547
5548        Type: string
5549
5550        The Mutt-ng E-Mail Client                                                   103
5551
5552        Default: '%4C %M%N %5s  %-45.45f %d'
5553
5554        Availability: NNTP
5555
5556        This variable allows you to customize the newsgroup browser display to your
5557        personal taste.  This string is similar to ``_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  ,
5558        page 90)'', but has its own set of printf(3)-like sequences:
5559
5560             %C      current newsgroup number
5561             %d      description of newsgroup (retrieved from server)
5562             %f      newsgroup name
5563             %M      ``-'' if newsgroup not allowed for direct post (moderated for example)
5564             %N      ``N'' if newsgroup is new, ``u'' if unsubscribed, blank otherwise
5565             %n      number of new articles in newsgroup
5566             %s      number of unread articles in newsgroup
5567             %>X     right justify the rest of the string and pad with character "X"
5568             %|X     pad to the end of the line with character "X"
5569
5570        _\b6_\b._\b3_\b._\b1_\b5_\b1  _\bn_\bn_\bt_\bp_\b__\bh_\bo_\bs_\bt
5571
5572        Type: string
5573
5574        Default: ''
5575
5576        Availability: NNTP
5577
5578        This variable specifies the name (or address) of the NNTP server to be used.
5579
5580        It defaults to the value specified via the environment variable $NNTPSERVER or
5581        contained in the file /etc/nntpserver.
5582
5583        You can also specify a username and an alternative port for each newsserver,
5584        e.g.
5585
5586        [nntp[s]://][username[:password]@]newsserver[:port]
5587
5588        N\bNo\bot\bte\be:\b: Using a password as shown and stored in a configuration file presents a
5589        security risk since the superuser of your machine may read it regardless of the
5590        file's permissions.
5591
5592        _\b6_\b._\b3_\b._\b1_\b5_\b2  _\bn_\bn_\bt_\bp_\b__\bi_\bn_\be_\bw_\bs
5593
5594        Type: path
5595
5596        Default: ''
5597
5598        Availability: NNTP
5599
5600        If _\bs_\be_\bt, specifies the program and arguments used to deliver news posted by
5601        Mutt-ng.  Otherwise, Mutt-ng posts article using current connection.  The fol-
5602        lowing printf(3)-style sequence is understood:
5603
5604        The Mutt-ng E-Mail Client                                                   104
5605
5606             %s      newsserver name
5607
5608        Example: set inews='/usr/local/bin/inews -hS'
5609
5610        _\b6_\b._\b3_\b._\b1_\b5_\b3  _\bn_\bn_\bt_\bp_\b__\bl_\bo_\ba_\bd_\b__\bd_\be_\bs_\bc_\br_\bi_\bp_\bt_\bi_\bo_\bn
5611
5612        Type: boolean
5613
5614        Default: yes
5615
5616        Availability: NNTP
5617
5618        This variable controls whether or not descriptions for newsgroups are to be
5619        loaded when subscribing to a newsgroup.
5620
5621        _\b6_\b._\b3_\b._\b1_\b5_\b4  _\bn_\bn_\bt_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
5622
5623        Type: number
5624
5625        Default: 60
5626
5627        Availability: NNTP
5628
5629        The time in seconds until any operations on a newsgroup except posting a new
5630        article will cause a recheck for new news. If set to 0, Mutt-ng will recheck on
5631        each operation in index (stepping, read article, etc.).
5632
5633        _\b6_\b._\b3_\b._\b1_\b5_\b5  _\bn_\bn_\bt_\bp_\b__\bm_\bi_\bm_\be_\b__\bs_\bu_\bb_\bj_\be_\bc_\bt
5634
5635        Type: boolean
5636
5637        Default: yes
5638
5639        Availability: NNTP
5640
5641        If _\bu_\bn_\bs_\be_\bt, an 8-bit ``Subject:'' header field in a news article will not be
5642        encoded according to RFC2047.
5643
5644        N\bNo\bot\bte\be:\b: Only change this setting if you know what you are doing.
5645
5646        _\b6_\b._\b3_\b._\b1_\b5_\b6  _\bn_\bn_\bt_\bp_\b__\bn_\be_\bw_\bs_\br_\bc
5647
5648        Type: path
5649
5650        Default: '~/.newsrc'
5651
5652        Availability: NNTP
5653
5654        This file contains information about subscribed newsgroup and articles read so
5655        far.
5656
5657        To ease the use of multiple news servers, the following printf(3)-style
5658        sequence is understood:
5659
5660        The Mutt-ng E-Mail Client                                                   105
5661
5662             %s      newsserver name
5663
5664        _\b6_\b._\b3_\b._\b1_\b5_\b7  _\bn_\bn_\bt_\bp_\b__\bp_\ba_\bs_\bs
5665
5666        Type: string
5667
5668        Default: ''
5669
5670        Availability: NNTP
5671
5672        Your password for NNTP account.
5673
5674        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
5675        the superuser of your machine may read it regardless of the file's permissions.
5676
5677        _\b6_\b._\b3_\b._\b1_\b5_\b8  _\bn_\bn_\bt_\bp_\b__\bp_\bo_\bs_\bt_\b__\bm_\bo_\bd_\be_\br_\ba_\bt_\be_\bd
5678
5679        Type: quadoption
5680
5681        Default: ask-yes
5682
5683        Availability: NNTP
5684
5685        If set to _\by_\be_\bs, Mutt-ng will post articles to newsgroup that have not permis-
5686        sions to post (e.g. moderated).
5687
5688        N\bNo\bot\bte\be:\b: if the newsserver does not support posting to that newsgroup or a group
5689        is totally read-only, that posting will not have any effect.
5690
5691        _\b6_\b._\b3_\b._\b1_\b5_\b9  _\bn_\bn_\bt_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
5692
5693        Type: quadoption
5694
5695        Default: ask-yes
5696
5697        Availability: NNTP
5698
5699        Controls whether or not Mutt-ng will try to reconnect to a newsserver when the
5700        was connection lost.
5701
5702        _\b6_\b._\b3_\b._\b1_\b6_\b0  _\bn_\bn_\bt_\bp_\b__\bs_\ba_\bv_\be_\b__\bu_\bn_\bs_\bu_\bb_\bs_\bc_\br_\bi_\bb_\be_\bd
5703
5704        Type: boolean
5705
5706        Default: no
5707
5708        Availability: NNTP
5709
5710        When _\bs_\be_\bt, info about unsubscribed newsgroups will be saved into the ``newsrc''
5711        file and into the news cache.
5712
5713        _\b6_\b._\b3_\b._\b1_\b6_\b1  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bn_\be_\bw_\b__\bn_\be_\bw_\bs
5714
5715        The Mutt-ng E-Mail Client                                                   106
5716
5717        Type: boolean
5718
5719        Default: yes
5720
5721        Availability: NNTP
5722
5723        If _\bs_\be_\bt, the newsserver will be asked for new newsgroups on entering the
5724        browser.  Otherwise, it will be done only once for a newsserver.  Also controls
5725        whether or not the number of new articles of subscribed newsgroups will be
5726        checked.
5727
5728        _\b6_\b._\b3_\b._\b1_\b6_\b2  _\bn_\bn_\bt_\bp_\b__\bs_\bh_\bo_\bw_\b__\bo_\bn_\bl_\by_\b__\bu_\bn_\br_\be_\ba_\bd
5729
5730        Type: boolean
5731
5732        Default: no
5733
5734        Availability: NNTP
5735
5736        If _\bs_\be_\bt, only subscribed newsgroups that contain unread articles will be dis-
5737        played in the newsgroup browser.
5738
5739        _\b6_\b._\b3_\b._\b1_\b6_\b3  _\bn_\bn_\bt_\bp_\b__\bu_\bs_\be_\br
5740
5741        Type: string
5742
5743        Default: ''
5744
5745        Availability: NNTP
5746
5747        Your login name on the NNTP server.  If _\bu_\bn_\bs_\be_\bt and the server requires authen-
5748        tification, Mutt-ng will prompt you for your account name.
5749
5750        _\b6_\b._\b3_\b._\b1_\b6_\b4  _\bn_\bn_\bt_\bp_\b__\bx_\b__\bc_\bo_\bm_\bm_\be_\bn_\bt_\b__\bt_\bo
5751
5752        Type: boolean
5753
5754        Default: no
5755
5756        Availability: NNTP
5757
5758        If _\bs_\be_\bt, Mutt-ng will add a ``X-Comment-To:'' header field (that contains full
5759        name of the original article author) to articles that you followup to.
5760
5761        _\b6_\b._\b3_\b._\b1_\b6_\b5  _\bo_\bp_\be_\br_\ba_\bt_\bi_\bn_\bg_\b__\bs_\by_\bs_\bt_\be_\bm
5762
5763        Type: string
5764
5765        Default: ''
5766
5767        This specifies the operating system name for the User-Agent: header field. If
5768        this is _\bu_\bn_\bs_\be_\bt, it will be set to the operating system name that uname(2)
5769        returns. If uname(2) fails, ``UNIX'' will be used.
5770
5771        The Mutt-ng E-Mail Client                                                   107
5772
5773        It may, for example, look as: ``mutt-ng 1.5.9i (Linux)''.
5774
5775        _\b6_\b._\b3_\b._\b1_\b6_\b6  _\bp_\ba_\bg_\be_\br
5776
5777        Type: path
5778
5779        Default: 'builtin'
5780
5781        This variable specifies which pager you would like to use to view messages.
5782        ``builtin'' means to use the builtin pager, otherwise this variable should
5783        specify the pathname of the external pager you would like to use.
5784
5785        Using an external pager may have some disadvantages: Additional keystrokes are
5786        necessary because you can't call Mutt-ng functions directly from the pager, and
5787        screen resizes cause lines longer than the screen width to be badly formatted
5788        in the help menu.
5789
5790        _\b6_\b._\b3_\b._\b1_\b6_\b7  _\bp_\ba_\bg_\be_\br_\b__\bc_\bo_\bn_\bt_\be_\bx_\bt
5791
5792        Type: number
5793
5794        Default: 0
5795
5796        This variable controls the number of lines of context that are given when dis-
5797        playing the next or previous page in the internal pager.  By default, Mutt-ng
5798        will display the line after the last one on the screen at the top of the next
5799        page (0 lines of context).
5800
5801        _\b6_\b._\b3_\b._\b1_\b6_\b8  _\bp_\ba_\bg_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
5802
5803        Type: string
5804
5805        Default: '-%Z- %C/%m: %-20.20n   %s'
5806
5807        This variable controls the format of the one-line message ``status'' displayed
5808        before each message in either the internal or an external pager.  The valid
5809        sequences are listed in the ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90)'' sec-
5810        tion.
5811
5812        _\b6_\b._\b3_\b._\b1_\b6_\b9  _\bp_\ba_\bg_\be_\br_\b__\bi_\bn_\bd_\be_\bx_\b__\bl_\bi_\bn_\be_\bs
5813
5814        Type: number
5815
5816        Default: 0
5817
5818        Determines the number of lines of a mini-index which is shown when in the
5819        pager.  The current message, unless near the top or bottom of the folder, will
5820        be roughly one third of the way down this mini-index, giving the reader the
5821        context of a few messages before and after the message.  This is useful, for
5822        example, to determine how many messages remain to be read in the current
5823        thread.  One of the lines is reserved for the status bar from the index, so a
5824        _\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
5825        0 results in no index being shown.  If the number of messages in the current
5826        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
5827
5828        The Mutt-ng E-Mail Client                                                   108
5829
5830        lines as it needs.
5831
5832        _\b6_\b._\b3_\b._\b1_\b7_\b0  _\bp_\ba_\bg_\be_\br_\b__\bs_\bt_\bo_\bp
5833
5834        Type: boolean
5835
5836        Default: no
5837
5838        When _\bs_\be_\bt, the internal-pager will n\bno\bot\bt move to the next message when you are at
5839        the end of a message and invoke the _\bn_\be_\bx_\bt_\b-_\bp_\ba_\bg_\be function.
5840
5841        _\b6_\b._\b3_\b._\b1_\b7_\b1  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\b__\bd_\be_\bc_\bo_\bd_\be
5842
5843        Type: boolean
5844
5845        Default: no
5846
5847        If _\bs_\be_\bt, Mutt-ng will automatically attempt to decrypt traditional PGP messages
5848        whenever the user performs an operation which ordinarily would result in the
5849        contents of the message being operated on.  For example, if the user displays a
5850        pgp-traditional message which has not been manually checked with the check-tra-
5851        ditional-pgp function, Mutt-ng will automatically check the message for tradi-
5852        tional pgp.
5853
5854        _\b6_\b._\b3_\b._\b1_\b7_\b2  _\bp_\bg_\bp_\b__\ba_\bu_\bt_\bo_\bi_\bn_\bl_\bi_\bn_\be
5855
5856        Type: boolean
5857
5858        Default: no
5859
5860        This option controls whether Mutt-ng generates old-style inline (traditional)
5861        PGP encrypted or signed messages under certain circumstances.  This can be
5862        overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not required.
5863
5864        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
5865        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
5866        ing PGP/MIME messages when inline (traditional) would not work.  See also:
5867        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 6.3.188  , page 111)''.
5868
5869        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.
5870        (PGP only)
5871
5872        _\b6_\b._\b3_\b._\b1_\b7_\b3  _\bp_\bg_\bp_\b__\bc_\bh_\be_\bc_\bk_\b__\be_\bx_\bi_\bt
5873
5874        Type: boolean
5875
5876        Default: yes
5877
5878        If _\bs_\be_\bt, Mutt-ng will check the exit code of the PGP subprocess when signing or
5879        encrypting.  A non-zero exit code means that the subprocess failed.  (PGP only)
5880
5881        _\b6_\b._\b3_\b._\b1_\b7_\b4  _\bp_\bg_\bp_\b__\bc_\bl_\be_\ba_\br_\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
5882
5883        Type: string
5884
5885        The Mutt-ng E-Mail Client                                                   109
5886
5887        Default: ''
5888
5889        This format is used to create a old-style ``clearsigned'' PGP message.
5890
5891        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)
5892
5893        _\b6_\b._\b3_\b._\b1_\b7_\b5  _\bp_\bg_\bp_\b__\bd_\be_\bc_\bo_\bd_\be_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
5894
5895        Type: string
5896
5897        Default: ''
5898
5899        This format strings specifies a command which is used to decode application/pgp
5900        attachments.
5901
5902        The PGP command formats have their own set of printf(3)-like sequences:
5903
5904              %p
5905                    Expands to PGPPASSFD=0 when a pass phrase is needed, to an empty
5906                    string otherwise. Note: This may be used with a %? construct.
5907
5908              %f
5909                    Expands to the name of a file containing a message.
5910
5911              %s
5912                    Expands to the name of a file containing the signature part of a
5913                    multipart/signed attachment when verifying it.
5914
5915              %a
5916                    The value of _\b$_\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs (section 6.3.192  , page 112).
5917
5918              %r
5919                    One or more key IDs.
5920
5921        For examples on how to configure these formats for the various versions of PGP
5922        which are floating around, see the pgp*.rc and gpg.rc files in the samples/
5923        subdirectory which has been installed on your system alongside the documenta-
5924        tion.  (PGP only)
5925
5926        _\b6_\b._\b3_\b._\b1_\b7_\b6  _\bp_\bg_\bp_\b__\bd_\be_\bc_\br_\by_\bp_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
5927
5928        Type: string
5929
5930        Default: ''
5931
5932        This command is used to decrypt a PGP encrypted message.  (PGP only)
5933
5934        _\b6_\b._\b3_\b._\b1_\b7_\b7  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bo_\bn_\bl_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
5935
5936        Type: string
5937
5938        Default: ''
5939
5940        This command is used to encrypt a body part without signing it.  (PGP only)
5941
5942        The Mutt-ng E-Mail Client                                                   110
5943
5944        _\b6_\b._\b3_\b._\b1_\b7_\b8  _\bp_\bg_\bp_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
5945
5946        Type: string
5947
5948        Default: ''
5949
5950        This command is used to both sign and encrypt a body part.  (PGP only)
5951
5952        _\b6_\b._\b3_\b._\b1_\b7_\b9  _\bp_\bg_\bp_\b__\be_\bn_\bt_\br_\by_\b__\bf_\bo_\br_\bm_\ba_\bt
5953
5954        Type: string
5955
5956        Default: '%4n %t%f %4l/0x%k %-4a %2c %u'
5957
5958        This variable allows you to customize the PGP key selection menu to your per-
5959        sonal taste. This string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page
5960        90)'', but has its own set of printf(3)-like sequences:
5961
5962              %n
5963                    number
5964
5965              %k
5966                    key id
5967
5968              %u
5969                    user id
5970
5971              %a
5972                    algorithm
5973
5974              %l
5975                    key length
5976
5977              %f
5978                    flags
5979
5980              %c
5981                    capabilities
5982
5983              %t
5984                    trust/validity of the key-uid association
5985
5986              %[<s>]
5987                    date of the key where <s> is an strftime(3) expression
5988
5989        (PGP only)
5990
5991        _\b6_\b._\b3_\b._\b1_\b8_\b0  _\bp_\bg_\bp_\b__\be_\bx_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
5992
5993        Type: string
5994
5995        Default: ''
5996
5997        This command is used to export a public key from the user's key ring.  (PGP
5998
5999        The Mutt-ng E-Mail Client                                                   111
6000
6001        only)
6002
6003        _\b6_\b._\b3_\b._\b1_\b8_\b1  _\bp_\bg_\bp_\b__\bg_\be_\bt_\bk_\be_\by_\bs_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6004
6005        Type: string
6006
6007        Default: ''
6008
6009        This command is invoked whenever Mutt-ng will need public key information.  %r
6010        is the only printf(3)-like sequence used with this format.  (PGP only)
6011
6012        _\b6_\b._\b3_\b._\b1_\b8_\b2  _\bp_\bg_\bp_\b__\bg_\bo_\bo_\bd_\b__\bs_\bi_\bg_\bn
6013
6014        Type: regular expression
6015
6016        Default: ''
6017
6018        If you assign a text to this variable, then a PGP signature is only considered
6019        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 6.3.198  , page 113)
6020        contains the text. Use this variable if the exit code from the command is 0
6021        even for bad signatures.  (PGP only)
6022
6023        _\b6_\b._\b3_\b._\b1_\b8_\b3  _\bp_\bg_\bp_\b__\bi_\bg_\bn_\bo_\br_\be_\b__\bs_\bu_\bb_\bk_\be_\by_\bs
6024
6025        Type: boolean
6026
6027        Default: yes
6028
6029        Setting this variable will cause Mutt-ng to ignore OpenPGP subkeys. Instead,
6030        the principal key will inherit the subkeys' capabilities. _\bU_\bn_\bs_\be_\bt this if you
6031        want to play interesting key selection games.  (PGP only)
6032
6033        _\b6_\b._\b3_\b._\b1_\b8_\b4  _\bp_\bg_\bp_\b__\bi_\bm_\bp_\bo_\br_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6034
6035        Type: string
6036
6037        Default: ''
6038
6039        This command is used to import a key from a message into the user's public key
6040        ring.  (PGP only)
6041
6042        _\b6_\b._\b3_\b._\b1_\b8_\b5  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bp_\bu_\bb_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6043
6044        Type: string
6045
6046        Default: ''
6047
6048        This command is used to list the public key ring's contents.  The output format
6049        must be analogous to the one used by gpg --list-keys --with-colons.
6050
6051        This format is also generated by the pgpring utility which comes with Mutt-ng.
6052        (PGP only)
6053
6054        The Mutt-ng E-Mail Client                                                   112
6055
6056        _\b6_\b._\b3_\b._\b1_\b8_\b6  _\bp_\bg_\bp_\b__\bl_\bi_\bs_\bt_\b__\bs_\be_\bc_\br_\bi_\bn_\bg_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6057
6058        Type: string
6059
6060        Default: ''
6061
6062        This command is used to list the secret key ring's contents.  The output format
6063        must be analogous to the one used by gpg --list-keys --with-colons.
6064
6065        This format is also generated by the pgpring utility which comes with Mutt-ng.
6066        (PGP only)
6067
6068        _\b6_\b._\b3_\b._\b1_\b8_\b7  _\bp_\bg_\bp_\b__\bl_\bo_\bn_\bg_\b__\bi_\bd_\bs
6069
6070        Type: boolean
6071
6072        Default: no
6073
6074        If _\bs_\be_\bt, use 64 bit PGP key IDs. _\bU_\bn_\bs_\be_\bt uses the normal 32 bit Key IDs.  (PGP
6075        only)
6076
6077        _\b6_\b._\b3_\b._\b1_\b8_\b8  _\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo
6078
6079        Type: quadoption
6080
6081        Default: ask-yes
6082
6083        This option controls whether Mutt-ng will prompt you for automatically sending
6084        a (signed/encrypted) message using PGP/MIME when inline (traditional) fails
6085        (for any reason).
6086
6087        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.
6088        (PGP only)
6089
6090        _\b6_\b._\b3_\b._\b1_\b8_\b9  _\bp_\bg_\bp_\b__\br_\be_\bp_\bl_\by_\bi_\bn_\bl_\bi_\bn_\be
6091
6092        Type: boolean
6093
6094        Default: no
6095
6096        Setting this variable will cause Mutt-ng to always attempt to create an inline
6097        (traditional) message when replying to a message which is PGP encrypted/signed
6098        inline.  This can be overridden by use of the _\bp_\bg_\bp_\b-_\bm_\be_\bn_\bu, when inline is not
6099        required.  This option does not automatically detect if the (replied-to) mes-
6100        sage is inline; instead it relies on Mutt-ng internals for previously
6101        checked/flagged messages.
6102
6103        Note that Mutt-ng might automatically use PGP/MIME for messages which consist
6104        of more than a single MIME part.  Mutt-ng can be configured to ask before send-
6105        ing PGP/MIME messages when inline (traditional) would not work.  See also:
6106        ``_\b$_\bp_\bg_\bp_\b__\bm_\bi_\bm_\be_\b__\ba_\bu_\bt_\bo (section 6.3.188  , page 111)''.
6107
6108        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.
6109        (PGP only)
6110
6111        The Mutt-ng E-Mail Client                                                   113
6112
6113        _\b6_\b._\b3_\b._\b1_\b9_\b0  _\bp_\bg_\bp_\b__\br_\be_\bt_\ba_\bi_\bn_\ba_\bb_\bl_\be_\b__\bs_\bi_\bg_\bs
6114
6115        Type: boolean
6116
6117        Default: no
6118
6119        If _\bs_\be_\bt, signed and encrypted messages will consist of nested multipart/signed
6120        and multipart/encrypted body parts.
6121
6122        This is useful for applications like encrypted and signed mailing lists, where
6123        the outer layer (multipart/encrypted) can be easily removed, while the inner
6124        multipart/signed part is retained.  (PGP only)
6125
6126        _\b6_\b._\b3_\b._\b1_\b9_\b1  _\bp_\bg_\bp_\b__\bs_\bh_\bo_\bw_\b__\bu_\bn_\bu_\bs_\ba_\bb_\bl_\be
6127
6128        Type: boolean
6129
6130        Default: yes
6131
6132        If _\bs_\be_\bt, Mutt-ng will display non-usable keys on the PGP key selection menu.
6133        This includes keys which have been revoked, have expired, or have been marked
6134        as ``disabled'' by the user.  (PGP only)
6135
6136        _\b6_\b._\b3_\b._\b1_\b9_\b2  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\ba_\bs
6137
6138        Type: string
6139
6140        Default: ''
6141
6142        If you have more than one key pair, this option allows you to specify which of
6143        your private keys to use.  It is recommended that you use the keyid form to
6144        specify your key (e.g., ``0x00112233'').  (PGP only)
6145
6146        _\b6_\b._\b3_\b._\b1_\b9_\b3  _\bp_\bg_\bp_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6147
6148        Type: string
6149
6150        Default: ''
6151
6152        This command is used to create the detached PGP signature for a multi-
6153        part/signed PGP/MIME body part.  (PGP only)
6154
6155        _\b6_\b._\b3_\b._\b1_\b9_\b4  _\bp_\bg_\bp_\b__\bs_\bo_\br_\bt_\b__\bk_\be_\by_\bs
6156
6157        Type: sort order
6158
6159        Default: address
6160
6161        Specifies how the entries in the ``pgp keys'' menu are sorted. The following
6162        are legal values:
6163
6164              address
6165                    sort alphabetically by user id
6166
6167        The Mutt-ng E-Mail Client                                                   114
6168
6169              keyid
6170                    sort alphabetically by key id
6171
6172              date
6173                    sort by key creation date
6174
6175              trust
6176                    sort by the trust of the key
6177
6178        If you prefer reverse order of the above values, prefix it with ``reverse-''.
6179        (PGP only)
6180
6181        _\b6_\b._\b3_\b._\b1_\b9_\b5  _\bp_\bg_\bp_\b__\bs_\bt_\br_\bi_\bc_\bt_\b__\be_\bn_\bc
6182
6183        Type: boolean
6184
6185        Default: yes
6186
6187        If _\bs_\be_\bt, Mutt-ng will automatically encode PGP/MIME signed messages as quoted-
6188        printable.  Please note that unsetting this variable may lead to problems with
6189        non-verifyable PGP signatures, so only change this if you know what you are
6190        doing.  (PGP only)
6191
6192        _\b6_\b._\b3_\b._\b1_\b9_\b6  _\bp_\bg_\bp_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
6193
6194        Type: number
6195
6196        Default: 300
6197
6198        The number of seconds after which a cached passphrase will expire if not used.
6199        Default: 300.  (PGP only)
6200
6201        _\b6_\b._\b3_\b._\b1_\b9_\b7  _\bp_\bg_\bp_\b__\bu_\bs_\be_\b__\bg_\bp_\bg_\b__\ba_\bg_\be_\bn_\bt
6202
6203        Type: boolean
6204
6205        Default: no
6206
6207        If _\bs_\be_\bt, Mutt-ng will use a possibly-running gpg-agent process.  (PGP only)
6208
6209        _\b6_\b._\b3_\b._\b1_\b9_\b8  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6210
6211        Type: string
6212
6213        Default: ''
6214
6215        This command is used to verify PGP signatures.  (PGP only)
6216
6217        _\b6_\b._\b3_\b._\b1_\b9_\b9  _\bp_\bg_\bp_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bk_\be_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6218
6219        Type: string
6220
6221        Default: ''
6222
6223        The Mutt-ng E-Mail Client                                                   115
6224
6225        This command is used to verify key information from the key selection menu.
6226        (PGP only)
6227
6228        _\b6_\b._\b3_\b._\b2_\b0_\b0  _\bp_\bi_\bp_\be_\b__\bd_\be_\bc_\bo_\bd_\be
6229
6230        Type: boolean
6231
6232        Default: no
6233
6234        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
6235        pipe the messages without any preprocessing. When _\bs_\be_\bt, Mutt-ng will weed head-
6236        ers and will attempt to PGP/MIME decode the messages first.
6237
6238        _\b6_\b._\b3_\b._\b2_\b0_\b1  _\bp_\bi_\bp_\be_\b__\bs_\be_\bp
6239
6240        Type: string
6241
6242        Default: '\n'
6243
6244        The separator to add between messages when piping a list of tagged messages to
6245        an external Unix command.
6246
6247        _\b6_\b._\b3_\b._\b2_\b0_\b2  _\bp_\bi_\bp_\be_\b__\bs_\bp_\bl_\bi_\bt
6248
6249        Type: boolean
6250
6251        Default: no
6252
6253        Used in connection with the _\bp_\bi_\bp_\be_\b-_\bm_\be_\bs_\bs_\ba_\bg_\be command and the ``tag- prefix'' or
6254        ``tag-prefix-cond'' operators.  If this variable is _\bu_\bn_\bs_\be_\bt, when piping a list
6255        of tagged messages Mutt-ng will concatenate the messages and will pipe them as
6256        a single folder.  When _\bs_\be_\bt, Mutt-ng will pipe the messages one by one.  In both
6257        cases the messages are piped in the current sorted order, and the ``_\b$_\bp_\bi_\bp_\be_\b__\bs_\be_\bp
6258        (section 6.3.201  , page 114)'' separator is added after each message.
6259
6260        _\b6_\b._\b3_\b._\b2_\b0_\b3  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\b__\bt_\br_\by_\b__\ba_\bl_\bl
6261
6262        Type: boolean
6263
6264        Default: yes
6265
6266        Availability: POP
6267
6268        If _\bs_\be_\bt, Mutt-ng will try all available methods. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will only
6269        fall back to other authentication methods if the previous methods are unavail-
6270        able. If a method is available but authentication fails, Mutt-ng will not con-
6271        nect to the POP server.
6272
6273        _\b6_\b._\b3_\b._\b2_\b0_\b4  _\bp_\bo_\bp_\b__\ba_\bu_\bt_\bh_\be_\bn_\bt_\bi_\bc_\ba_\bt_\bo_\br_\bs
6274
6275        Type: string
6276
6277        Default: ''
6278
6279        The Mutt-ng E-Mail Client                                                   116
6280
6281        Availability: POP
6282
6283        This is a colon-delimited list of authentication methods Mutt-ng may attempt to
6284        use to log in to an POP server, in the order Mutt-ng should try them.  Authen-
6285        tication methods are either ``user'', ``apop'' or any SASL mechanism, eg
6286        ``digest-md5'', ``gssapi'' or ``cram-md5''.
6287
6288        This parameter is case-insensitive. If this parameter is _\bu_\bn_\bs_\be_\bt (the default)
6289        Mutt-ng will try all available methods, in order from most-secure to least-
6290        secure.
6291
6292        Example: set pop_authenticators='digest-md5:apop:user'
6293
6294        _\b6_\b._\b3_\b._\b2_\b0_\b5  _\bp_\bo_\bp_\b__\bd_\be_\bl_\be_\bt_\be
6295
6296        Type: quadoption
6297
6298        Default: ask-no
6299
6300        Availability: POP
6301
6302        If _\bs_\be_\bt, Mutt-ng will delete successfully downloaded messages from the POP
6303        server when using the ``fetch-mail'' function.  When _\bu_\bn_\bs_\be_\bt, Mutt-ng will down-
6304        load messages but also leave them on the POP server.
6305
6306        _\b6_\b._\b3_\b._\b2_\b0_\b6  _\bp_\bo_\bp_\b__\bh_\bo_\bs_\bt
6307
6308        Type: string
6309
6310        Default: ''
6311
6312        Availability: POP
6313
6314        The name of your POP server for the ``fetch-mail'' function.  You can also
6315        specify an alternative port, username and password, i.e.:
6316
6317        [pop[s]://][username[:password]@]popserver[:port]
6318
6319        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
6320        the superuser of your machine may read it regardless of the file's permissions.
6321
6322        _\b6_\b._\b3_\b._\b2_\b0_\b7  _\bp_\bo_\bp_\b__\bl_\ba_\bs_\bt
6323
6324        Type: boolean
6325
6326        Default: no
6327
6328        Availability: POP
6329
6330        If this variable is _\bs_\be_\bt, Mutt-ng will try to use the ``LAST'' POP command for
6331        retrieving only unread messages from the POP server when using the ``fetch-
6332        mail'' function.
6333
6334        The Mutt-ng E-Mail Client                                                   117
6335
6336        _\b6_\b._\b3_\b._\b2_\b0_\b8  _\bp_\bo_\bp_\b__\bm_\ba_\bi_\bl_\b__\bc_\bh_\be_\bc_\bk
6337
6338        Type: number
6339
6340        Default: 60
6341
6342        Availability: POP
6343
6344        This variable configures how often (in seconds) POP should look for new mail.
6345
6346        _\b6_\b._\b3_\b._\b2_\b0_\b9  _\bp_\bo_\bp_\b__\bp_\ba_\bs_\bs
6347
6348        Type: string
6349
6350        Default: ''
6351
6352        Availability: POP
6353
6354        Specifies the password for your POP account.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will prompt you
6355        for your password when you open POP mailbox.
6356
6357        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
6358        the superuser of your machine may read it regardless of the file's permissions.
6359
6360        _\b6_\b._\b3_\b._\b2_\b1_\b0  _\bp_\bo_\bp_\b__\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
6361
6362        Type: quadoption
6363
6364        Default: ask-yes
6365
6366        Availability: POP
6367
6368        Controls whether or not Mutt-ng will try to reconnect to a POP server when the
6369        connection is lost.
6370
6371        _\b6_\b._\b3_\b._\b2_\b1_\b1  _\bp_\bo_\bp_\b__\bu_\bs_\be_\br
6372
6373        Type: string
6374
6375        Default: ''
6376
6377        Availability: POP
6378
6379        Your login name on the POP server.
6380
6381        This variable defaults to your user name on the local machine.
6382
6383        _\b6_\b._\b3_\b._\b2_\b1_\b2  _\bp_\bo_\bs_\bt_\b__\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg
6384
6385        Type: string
6386
6387        Default: ''
6388
6389        Similar to the ``_\b$_\ba_\bt_\bt_\br_\bi_\bb_\bu_\bt_\bi_\bo_\bn (section 6.3.15  , page 68)'' variable, Mutt-ng
6390
6391        The Mutt-ng E-Mail Client                                                   118
6392
6393        will append this string after the inclusion of a message which is being replied
6394        to.
6395
6396        _\b6_\b._\b3_\b._\b2_\b1_\b3  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
6397
6398        Type: quadoption
6399
6400        Default: ask-yes
6401
6402        Controls whether or not messages are saved in the ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section
6403        6.3.214  , page 117)'' mailbox when you elect not to send immediately.
6404
6405        _\b6_\b._\b3_\b._\b2_\b1_\b4  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd
6406
6407        Type: path
6408
6409        Default: '~/postponed'
6410
6411        Mutt-ng allows you to indefinitely ``_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 6.3.213  , page 116)
6412        sending a message'' which you are editing.  When you choose to postpone a mes-
6413        sage, Mutt-ng saves it in the mailbox specified by this variable.  Also see the
6414        ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be (section 6.3.213  , page 116)'' variable.
6415
6416        _\b6_\b._\b3_\b._\b2_\b1_\b5  _\bp_\br_\be_\bc_\bo_\bn_\bn_\be_\bc_\bt
6417
6418        Type: string
6419
6420        Default: ''
6421
6422        If _\bs_\be_\bt, a shell command to be executed if Mutt-ng fails to establish a connec-
6423        tion to the server. This is useful for setting up secure connections, e.g. with
6424        ssh(1). If the command returns a  nonzero status, Mutt-ng gives up opening the
6425        server. Example:
6426
6427        preconnect='ssh -f -q -L 1234:mailhost.net:143 mailhost.net sleep 20 <
6428        /dev/null > /dev/null'
6429
6430        Mailbox ``foo'' on mailhost.net can now be reached as ``{localhost:1234}foo''.
6431
6432        N\bNo\bot\bte\be:\b: For this example to work, you must be able to log in to the remote
6433        machine without having to enter a password.
6434
6435        _\b6_\b._\b3_\b._\b2_\b1_\b6  _\bp_\br_\bi_\bn_\bt
6436
6437        Type: quadoption
6438
6439        Default: ask-no
6440
6441        Controls whether or not Mutt-ng really prints messages.  This is set to _\ba_\bs_\bk_\b-_\bn_\bo
6442        by default, because some people accidentally hit ``p'' often.
6443
6444        _\b6_\b._\b3_\b._\b2_\b1_\b7  _\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6445
6446        Type: path
6447
6448        The Mutt-ng E-Mail Client                                                   119
6449
6450        Default: 'lpr'
6451
6452        This specifies the command pipe that should be used to print messages.
6453
6454        _\b6_\b._\b3_\b._\b2_\b1_\b8  _\bp_\br_\bi_\bn_\bt_\b__\bd_\be_\bc_\bo_\bd_\be
6455
6456        Type: boolean
6457
6458        Default: yes
6459
6460        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
6461        message is decoded before it is passed to the external command specified by
6462        _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 6.3.217  , page 117).  If this option is _\bu_\bn_\bs_\be_\bt, no pro-
6463        cessing will be applied to the message when printing it.  The latter setting
6464        may be useful if you are using some advanced printer filter which is able to
6465        properly format e-mail messages for printing.
6466
6467        _\b6_\b._\b3_\b._\b2_\b1_\b9  _\bp_\br_\bi_\bn_\bt_\b__\bs_\bp_\bl_\bi_\bt
6468
6469        Type: boolean
6470
6471        Default: no
6472
6473        Used in connection with the print-message command.  If this option is _\bs_\be_\bt, the
6474        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 6.3.217  , page 117) is executed
6475        once for each message which is to be printed.  If this option is _\bu_\bn_\bs_\be_\bt, the
6476        command specified by _\b$_\bp_\br_\bi_\bn_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd (section 6.3.217  , page 117) is executed
6477        only once, and all the messages are concatenated, with a form feed as the mes-
6478        sage separator.
6479
6480        Those who use the enscript(1) program's mail-printing mode will most likely
6481        want to set this option.
6482
6483        _\b6_\b._\b3_\b._\b2_\b2_\b0  _\bp_\br_\bo_\bm_\bp_\bt_\b__\ba_\bf_\bt_\be_\br
6484
6485        Type: boolean
6486
6487        Default: yes
6488
6489        If you use an _\be_\bx_\bt_\be_\br_\bn_\ba_\bl ``_\b$_\bp_\ba_\bg_\be_\br (section 6.3.166  , page 106)'', setting this
6490        variable will cause Mutt-ng to prompt you for a command when the pager exits
6491        rather than returning to the index menu.  If _\bu_\bn_\bs_\be_\bt, Mutt-ng will return to the
6492        index menu when the external pager exits.
6493
6494        _\b6_\b._\b3_\b._\b2_\b2_\b1  _\bq_\bu_\be_\br_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
6495
6496        Type: path
6497
6498        Default: ''
6499
6500        This specifies the command that Mutt-ng will use to make external address
6501        queries.  The string should contain a %s, which will be substituted with the
6502        query string the user types.  See ``_\bq_\bu_\be_\br_\by (section 4.6  , page 42)'' for more
6503        information.
6504
6505        The Mutt-ng E-Mail Client                                                   120
6506
6507        _\b6_\b._\b3_\b._\b2_\b2_\b2  _\bq_\bu_\bi_\bt
6508
6509        Type: quadoption
6510
6511        Default: yes
6512
6513        This variable controls whether ``quit'' and ``exit'' actually quit from Mutt-
6514        ng.  If it set to _\by_\be_\bs, they do quit, if it is set to _\bn_\bo, they have no effect,
6515        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
6516        you try to quit.
6517
6518        _\b6_\b._\b3_\b._\b2_\b2_\b3  _\bq_\bu_\bo_\bt_\be_\b__\be_\bm_\bp_\bt_\by
6519
6520        Type: boolean
6521
6522        Default: yes
6523
6524        Controls whether or not empty lines will be quoted using ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (sec-
6525        tion 6.3.109  , page 90)''.
6526
6527        _\b6_\b._\b3_\b._\b2_\b2_\b4  _\bq_\bu_\bo_\bt_\be_\b__\bq_\bu_\bo_\bt_\be_\bd
6528
6529        Type: boolean
6530
6531        Default: no
6532
6533        Controls how quoted lines will be quoted. If _\bs_\be_\bt, one quote character will be
6534        added to the end of existing prefix.  Otherwise, quoted lines will be prepended
6535        by ``_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 6.3.109  , page 90)''.
6536
6537        _\b6_\b._\b3_\b._\b2_\b2_\b5  _\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp
6538
6539        Type: regular expression
6540
6541        Default: '^([ \t]*[|>:}#])+'
6542
6543        A regular expression used in the internal-pager to determine quoted sections of
6544        text in the body of a message.
6545
6546        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
6547        set this to a regular expression that matches _\be_\bx_\ba_\bc_\bt_\bl_\by the quote characters at
6548        the beginning of quoted lines.
6549
6550        _\b6_\b._\b3_\b._\b2_\b2_\b6  _\br_\be_\ba_\bd_\b__\bi_\bn_\bc
6551
6552        Type: number
6553
6554        Default: 10
6555
6556        If set to a value greater than 0, Mutt-ng will display which message it is cur-
6557        rently on when reading a mailbox.  The message is printed after _\br_\be_\ba_\bd_\b__\bi_\bn_\bc mes-
6558        sages have been read (e.g., if set to 25, Mutt-ng will print a message when it
6559        reads message 25, and then again when it gets to message 50).  This variable is
6560        meant to indicate progress when reading large mailboxes which may take some
6561
6562        The Mutt-ng E-Mail Client                                                   121
6563
6564        time.  When set to 0, only a single message will appear before the reading the
6565        mailbox.
6566
6567        Also see the ``_\b$_\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc (section 6.3.337  , page 146)'' variable.
6568
6569        _\b6_\b._\b3_\b._\b2_\b2_\b7  _\br_\be_\ba_\bd_\b__\bo_\bn_\bl_\by
6570
6571        Type: boolean
6572
6573        Default: no
6574
6575        If set, all folders are opened in read-only mode.
6576
6577        _\b6_\b._\b3_\b._\b2_\b2_\b8  _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
6578
6579        Type: string
6580
6581        Default: ''
6582
6583        This variable specifies what ``real'' or ``personal'' name should be used when
6584        sending messages.
6585
6586        By default, this is the GECOS field from /etc/passwd.
6587
6588        _\bN_\bo_\bt_\be_\b: This variable will _\bn_\bo_\bt be used when the user has set a real name in the
6589        _\b$_\bf_\br_\bo_\bm (section 6.3.74  , page 82) variable.
6590
6591        _\b6_\b._\b3_\b._\b2_\b2_\b9  _\br_\be_\bc_\ba_\bl_\bl
6592
6593        Type: quadoption
6594
6595        Default: ask-yes
6596
6597        Controls whether or not Mutt-ng recalls postponed messages when composing a new
6598        message.  Also see ``_\b$_\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be_\bd (section 6.3.214  , page 117)''.
6599
6600        Setting this variable to _\by_\be_\bs is not generally useful, and thus not recommended.
6601
6602        _\b6_\b._\b3_\b._\b2_\b3_\b0  _\br_\be_\bc_\bo_\br_\bd
6603
6604        Type: path
6605
6606        Default: ''
6607
6608        This specifies the file into which your outgoing messages should be appended.
6609        (This is meant as the primary method for saving a copy of your messages, but
6610        another way to do this is using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.13  , page 25)'' com-
6611        mand to create a Bcc: header field with your email address in it.)
6612
6613        The value of _\b$_\br_\be_\bc_\bo_\br_\bd _\b(_\bs_\be_\bc_\bt_\bi_\bo_\bn _\b6_\b._\b3_\b._\b2_\b3_\b0  _\b, _\bp_\ba_\bg_\be _\b1_\b2_\b0_\b) is overridden by the
6614        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 6.3.68  , page 81)'' and ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section
6615        6.3.241  , page 123)'' variables, and the ``_\bf_\bc_\bc_\b-_\bh_\bo_\bo_\bk (section 3.16  , page
6616        27)'' command.
6617
6618        The Mutt-ng E-Mail Client                                                   122
6619
6620        _\b6_\b._\b3_\b._\b2_\b3_\b1  _\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp
6621
6622        Type: regular expression
6623
6624        Default: '^(re([\[0-9\]+])*|aw):[ \t]*'
6625
6626        A regular expression used to recognize reply messages when threading and reply-
6627        ing. The default value corresponds to the English ``Re:'' and the German
6628        ``Aw:''.
6629
6630        _\b6_\b._\b3_\b._\b2_\b3_\b2  _\br_\be_\bp_\bl_\by_\b__\bs_\be_\bl_\bf
6631
6632        Type: boolean
6633
6634        Default: no
6635
6636        If _\bu_\bn_\bs_\be_\bt and you are replying to a message sent by you, Mutt-ng will assume
6637        that you want to reply to the recipients of that message rather than to your-
6638        self.
6639
6640        _\b6_\b._\b3_\b._\b2_\b3_\b3  _\br_\be_\bp_\bl_\by_\b__\bt_\bo
6641
6642        Type: quadoption
6643
6644        Default: ask-yes
6645
6646        If _\bs_\be_\bt, when replying to a message, Mutt-ng will use the address listed in the
6647        ``Reply-To:'' header field as the recipient of the reply.  If _\bu_\bn_\bs_\be_\bt, it will
6648        use the address in the ``From:'' header field instead.
6649
6650        This option is useful for reading a mailing list that sets the ``Reply-To:''
6651        header field to the list address and you want to send a private message to the
6652        author of a message.
6653
6654        _\b6_\b._\b3_\b._\b2_\b3_\b4  _\br_\be_\bs_\bo_\bl_\bv_\be
6655
6656        Type: boolean
6657
6658        Default: yes
6659
6660        When set, the cursor will be automatically advanced to the next (possibly
6661        undeleted) message whenever a command that modifies the current message is exe-
6662        cuted.
6663
6664        _\b6_\b._\b3_\b._\b2_\b3_\b5  _\br_\be_\bv_\be_\br_\bs_\be_\b__\ba_\bl_\bi_\ba_\bs
6665
6666        Type: boolean
6667
6668        Default: no
6669
6670        This variable controls whether or not Mutt-ng will display the ``personal''
6671        name from your aliases in the index menu if it finds an alias that matches the
6672        message's sender.  For example, if you have the following alias:
6673
6674        The Mutt-ng E-Mail Client                                                   123
6675
6676        alias juser abd30425@somewhere.net (Joe User)
6677
6678        and then you receive mail which contains the following header:
6679
6680        From: abd30425@somewhere.net
6681
6682        It would be displayed in the index menu as ``Joe User'' instead of
6683        ``abd30425@somewhere.net.''  This is useful when the person's e-mail address is
6684        not human friendly (like CompuServe addresses).
6685
6686        _\b6_\b._\b3_\b._\b2_\b3_\b6  _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be
6687
6688        Type: boolean
6689
6690        Default: no
6691
6692        It may sometimes arrive that you receive mail to a certain machine, move the
6693        messages to another machine, and reply to some the messages from there.  If
6694        this variable is _\bs_\be_\bt, the default From: line of the reply messages is built
6695        using the address where you received the messages you are replying to i\bif\bf that
6696        address matches your alternates.  If the variable is _\bu_\bn_\bs_\be_\bt, or the address that
6697        would be used doesn't match your alternates, the From: line will use your
6698        address on the current machine.
6699
6700        _\b6_\b._\b3_\b._\b2_\b3_\b7  _\br_\be_\bv_\be_\br_\bs_\be_\b__\br_\be_\ba_\bl_\bn_\ba_\bm_\be
6701
6702        Type: boolean
6703
6704        Default: yes
6705
6706        This variable fine-tunes the behaviour of the _\br_\be_\bv_\be_\br_\bs_\be_\b__\bn_\ba_\bm_\be (section 6.3.236  ,
6707        page 122) feature.  When it is _\bs_\be_\bt, Mutt-ng will use the address from incoming
6708        messages as-is, possibly including eventual real names.  When it is _\bu_\bn_\bs_\be_\bt,
6709        Mutt-ng will override any such real names with the setting of the _\br_\be_\ba_\bl_\bn_\ba_\bm_\be
6710        (section 6.3.228  , page 120) variable.
6711
6712        _\b6_\b._\b3_\b._\b2_\b3_\b8  _\br_\bf_\bc_\b2_\b0_\b4_\b7_\b__\bp_\ba_\br_\ba_\bm_\be_\bt_\be_\br_\bs
6713
6714        Type: boolean
6715
6716        Default: no
6717
6718        When this variable is _\bs_\be_\bt, Mutt-ng will decode RFC-2047-encoded MIME parame-
6719        ters. You want to set this variable when Mutt-ng suggests you to save attach-
6720        ments to files named like this:
6721
6722        =?iso-8859-1?Q?file=5F=E4=5F991116=2Ezip?=
6723
6724        When this variable is _\bs_\be_\bt interactively, the change doesn't have the desired
6725        effect before you have changed folders.
6726
6727        Note that this use of RFC 2047's encoding is explicitly, prohibited by the
6728        standard, but nevertheless encountered in the wild.
6729
6730        The Mutt-ng E-Mail Client                                                   124
6731
6732        Also note that setting this parameter will _\bn_\bo_\bt have the effect that Mutt-ng
6733        _\bg_\be_\bn_\be_\br_\ba_\bt_\be_\bs this kind of encoding.  Instead, Mutt-ng will unconditionally use the
6734        encoding specified in RFC 2231.
6735
6736        _\b6_\b._\b3_\b._\b2_\b3_\b9  _\bs_\ba_\bv_\be_\b__\ba_\bd_\bd_\br_\be_\bs_\bs
6737
6738        Type: boolean
6739
6740        Default: no
6741
6742        If _\bs_\be_\bt, Mutt-ng will take the sender's full address when choosing a default
6743        folder for saving a mail. If ``_\b$_\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be (section 6.3.241  , page 123)'' or
6744        ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 6.3.68  , page 81)'' is _\bs_\be_\bt too, the selection of the
6745        fcc folder will be changed as well.
6746
6747        _\b6_\b._\b3_\b._\b2_\b4_\b0  _\bs_\ba_\bv_\be_\b__\be_\bm_\bp_\bt_\by
6748
6749        Type: boolean
6750
6751        Default: yes
6752
6753        When _\bu_\bn_\bs_\be_\bt, mailboxes which contain no saved messages will be removed when
6754        closed (the exception is ``_\b$_\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be (section 6.3.295  , page 136)'' which is
6755        never removed).  If _\bs_\be_\bt, mailboxes are never removed.
6756
6757        N\bNo\bot\bte\be:\b: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH
6758        and Maildir directories.
6759
6760        _\b6_\b._\b3_\b._\b2_\b4_\b1  _\bs_\ba_\bv_\be_\b__\bn_\ba_\bm_\be
6761
6762        Type: boolean
6763
6764        Default: no
6765
6766        This variable controls how copies of outgoing messages are saved.  When set, a
6767        check is made to see if a mailbox specified by the recipient address exists
6768        (this is done by searching for a mailbox in the ``_\b$_\bf_\bo_\bl_\bd_\be_\br (section 6.3.64  ,
6769        page 79)'' directory with the _\bu_\bs_\be_\br_\bn_\ba_\bm_\be part of the recipient address).  If the
6770        mailbox exists, the outgoing message will be saved to that mailbox, otherwise
6771        the message is saved to the ``_\b$_\br_\be_\bc_\bo_\br_\bd (section 6.3.230  , page 120)'' mailbox.
6772
6773        Also see the ``_\b$_\bf_\bo_\br_\bc_\be_\b__\bn_\ba_\bm_\be (section 6.3.68  , page 81)'' variable.
6774
6775        _\b6_\b._\b3_\b._\b2_\b4_\b2  _\bs_\bc_\bo_\br_\be
6776
6777        Type: boolean
6778
6779        Default: yes
6780
6781        When this variable is _\bu_\bn_\bs_\be_\bt, scoring is turned off.  This can be useful to
6782        selectively disable scoring for certain folders when the ``_\b$_\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\b-
6783        _\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be (section 6.3.243  , page 123)'' variable and friends are used.
6784
6785        The Mutt-ng E-Mail Client                                                   125
6786
6787        _\b6_\b._\b3_\b._\b2_\b4_\b3  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bd_\be_\bl_\be_\bt_\be
6788
6789        Type: number
6790
6791        Default: -1
6792
6793        Messages which have been assigned a score equal to or lower than the value of
6794        this variable are automatically marked for deletion by Mutt-ng.  Since Mutt-ng
6795        scores are always greater than or equal to zero, the default setting of this
6796        variable will never mark a message for deletion.
6797
6798        _\b6_\b._\b3_\b._\b2_\b4_\b4  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\bf_\bl_\ba_\bg
6799
6800        Type: number
6801
6802        Default: 9999
6803
6804        Messages which have been assigned a score greater than or equal to this vari-
6805        able's value are automatically marked ``flagged''.
6806
6807        _\b6_\b._\b3_\b._\b2_\b4_\b5  _\bs_\bc_\bo_\br_\be_\b__\bt_\bh_\br_\be_\bs_\bh_\bo_\bl_\bd_\b__\br_\be_\ba_\bd
6808
6809        Type: number
6810
6811        Default: -1
6812
6813        Messages which have been assigned a score equal to or lower than the value of
6814        this variable are automatically marked as read by Mutt-ng.  Since Mutt-ng
6815        scores are always greater than or equal to zero, the default setting of this
6816        variable will never mark a message read.
6817
6818        _\b6_\b._\b3_\b._\b2_\b4_\b6  _\bs_\be_\bn_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt
6819
6820        Type: string
6821
6822        Default: 'us-ascii:iso-8859-1:utf-8'
6823
6824        A list of character sets for outgoing messages. Mutt-ng will use the first
6825        character set into which the text can be converted exactly.  If your ``_\b$_\bc_\bh_\ba_\br_\bs_\be_\bt
6826        (section 6.3.24  , page 70)'' is not iso-8859-1 and recipients may not under-
6827        stand UTF-8, it is advisable to include in the list an appropriate widely used
6828        standard character set (such as iso-8859-2, koi8-r or iso-2022-jp) either
6829        instead of or after iso-8859-1.
6830
6831        _\b6_\b._\b3_\b._\b2_\b4_\b7  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl
6832
6833        Type: path
6834
6835        Default: '/usr/sbin/sendmail -oem -oi'
6836
6837        Specifies the program and arguments used to deliver mail sent by Mutt-ng.
6838        Mutt-ng expects that the specified program interprets additional arguments as
6839        recipient addresses.
6840
6841        The Mutt-ng E-Mail Client                                                   126
6842
6843        _\b6_\b._\b3_\b._\b2_\b4_\b8  _\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl_\b__\bw_\ba_\bi_\bt
6844
6845        Type: number
6846
6847        Default: 0
6848
6849        Specifies the number of seconds to wait for the ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 6.3.247  ,
6850        page 124)'' process to finish before giving up and putting delivery in the
6851        background.
6852
6853        Mutt-ng interprets the value of this variable as follows:
6854
6855              >0
6856                    number of seconds to wait for sendmail to finish before continuing
6857
6858              0
6859                    wait forever for sendmail to finish
6860
6861              <0
6862                    always put sendmail in the background without waiting
6863
6864        Note that if you specify a value other than 0, the output of the child process
6865        will be put in a temporary file.  If there is some error, you will be informed
6866        as to where to find the output.
6867
6868        _\b6_\b._\b3_\b._\b2_\b4_\b9  _\bs_\bh_\be_\bl_\bl
6869
6870        Type: path
6871
6872        Default: ''
6873
6874        Command to use when spawning a subshell.  By default, the user's login shell
6875        from /etc/passwd is used.
6876
6877        _\b6_\b._\b3_\b._\b2_\b5_\b0  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by
6878
6879        Type: string
6880
6881        Default: '.'
6882
6883        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
6884        6.3.254  , page 126) is _\bs_\be_\bt, this variable specifies the characters at which to
6885        split a folder name into ``hierarchy items.''
6886
6887        _\b6_\b._\b3_\b._\b2_\b5_\b1  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bd_\be_\bl_\bi_\bm
6888
6889        Type: string
6890
6891        Default: '|'
6892
6893        This specifies the delimiter between the sidebar (if visible) and other
6894        screens.
6895
6896        The Mutt-ng E-Mail Client                                                   127
6897
6898        _\b6_\b._\b3_\b._\b2_\b5_\b2  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\be_\bw_\bm_\ba_\bi_\bl_\b__\bo_\bn_\bl_\by
6899
6900        Type: boolean
6901
6902        Default: no
6903
6904        If _\bs_\be_\bt, only folders with new mail will be shown in the sidebar.
6905
6906        _\b6_\b._\b3_\b._\b2_\b5_\b3  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bn_\bu_\bm_\bb_\be_\br_\b__\bf_\bo_\br_\bm_\ba_\bt
6907
6908        Type: string
6909
6910        Default: '%c%?n?(%n)?%?f?[%f]?'
6911
6912        This variable controls how message counts are printed when the sidebar is
6913        enabled. If this variable is _\be_\bm_\bp_\bt_\by (_\ba_\bn_\bd _\bo_\bn_\bl_\by _\bi_\bf), no numbers will be printed
6914        _\ba_\bn_\bd mutt-ng won't frequently count mail (which may be a great speedup esp. with
6915        mbox-style mailboxes.)
6916
6917        The following printf(3)-like sequences are supported:
6918
6919              %c
6920                    Total number of messages.
6921
6922              %f
6923                    Number of flagged messages.
6924
6925              %n
6926                    Number of new messages.
6927
6928        The %f and %n expandos may optionally be printed non-zero.
6929
6930        _\b6_\b._\b3_\b._\b2_\b5_\b4  _\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
6931
6932        Type: boolean
6933
6934        Default: no
6935
6936        When _\bs_\be_\bt, the ``hierarchy'' of the sidebar entries will be shortened only if
6937        they cannot be printed in full length (because ``_\b$_\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh (section
6938        6.3.256  , page 126)'' is set to a too low value). For example, if the news-
6939        group name ``de.alt.sysadmin.recovery'' doesn't fit on the screen, it'll get
6940        shortened ``d.a.s.recovery'' while ``de.alt.d0'' still would and thus will not
6941        get shortened.
6942
6943        At which characters this compression is done is controled via the _\b$_\bs_\bi_\bd_\be_\b-
6944        _\bb_\ba_\br_\b__\bb_\bo_\bu_\bn_\bd_\ba_\br_\by (section 6.3.250  , page 125) variable.
6945
6946        _\b6_\b._\b3_\b._\b2_\b5_\b5  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bv_\bi_\bs_\bi_\bb_\bl_\be
6947
6948        Type: boolean
6949
6950        Default: no
6951
6952        The Mutt-ng E-Mail Client                                                   128
6953
6954        This specifies whether or not to show the sidebar (a list of folders specified
6955        with the ``mailboxes'' command).
6956
6957        _\b6_\b._\b3_\b._\b2_\b5_\b6  _\bs_\bi_\bd_\be_\bb_\ba_\br_\b__\bw_\bi_\bd_\bt_\bh
6958
6959        Type: number
6960
6961        Default: 0
6962
6963        The width of the sidebar.
6964
6965        _\b6_\b._\b3_\b._\b2_\b5_\b7  _\bs_\bi_\bg_\b__\bd_\ba_\bs_\bh_\be_\bs
6966
6967        Type: boolean
6968
6969        Default: yes
6970
6971        If set, a line containing ``-- '' (dash, dash, space) will be inserted before
6972        your ``_\b$_\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be (section 6.3.259  , page 127)''.  It is s\bst\btr\bro\bon\bng\bgl\bly\by recommended
6973        that you not unset this variable unless your ``signature'' contains just your
6974        name. The reason for this is because many software packages use ``-- \n'' to
6975        detect your signature.
6976
6977        For example, Mutt-ng has the ability to highlight the signature in a different
6978        color in the builtin pager.
6979
6980        _\b6_\b._\b3_\b._\b2_\b5_\b8  _\bs_\bi_\bg_\b__\bo_\bn_\b__\bt_\bo_\bp
6981
6982        Type: boolean
6983
6984        Default: no
6985
6986        If _\bs_\be_\bt, the signature will be included before any quoted or forwarded text.  It
6987        is s\bst\btr\bro\bon\bng\bgl\bly\by recommended that you do not set this variable unless you really
6988        know what you are doing, and are prepared to take some heat from netiquette
6989        guardians.
6990
6991        _\b6_\b._\b3_\b._\b2_\b5_\b9  _\bs_\bi_\bg_\bn_\ba_\bt_\bu_\br_\be
6992
6993        Type: path
6994
6995        Default: '~/.signature'
6996
6997        Specifies the filename of your signature, which is appended to all outgoing
6998        messages.   If the filename ends with a pipe (``|''), it is assumed that file-
6999        name is a shell command and input should be read from its stdout.
7000
7001        _\b6_\b._\b3_\b._\b2_\b6_\b0  _\bs_\bi_\bg_\bn_\bo_\bf_\bf_\b__\bs_\bt_\br_\bi_\bn_\bg
7002
7003        Type: string
7004
7005        Default: ''
7006
7007        If _\bs_\be_\bt, this string will be inserted before the signature. This is useful for
7008
7009        The Mutt-ng E-Mail Client                                                   129
7010
7011        people that want to sign off every message they send with their name.
7012
7013        If you want to insert your website's URL, additional contact information or
7014        witty quotes into your mails, better use a signature file instead of the sig-
7015        noff string.
7016
7017        _\b6_\b._\b3_\b._\b2_\b6_\b1  _\bs_\bi_\bm_\bp_\bl_\be_\b__\bs_\be_\ba_\br_\bc_\bh
7018
7019        Type: string
7020
7021        Default: '~f %s | ~s %s'
7022
7023        Specifies how Mutt-ng should expand a simple search into a real search pattern.
7024        A simple search is one that does not contain any of the ~ operators.  See
7025        ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (section 4.2  , page 36)'' for more information on search patterns.
7026
7027        For example, if you simply type ``joe'' at a search or limit prompt, Mutt-ng
7028        will automatically expand it to the value specified by this variable.  For the
7029        default value it would be:
7030
7031        ~f joe | ~s joe
7032
7033        _\b6_\b._\b3_\b._\b2_\b6_\b2  _\bs_\bl_\be_\be_\bp_\b__\bt_\bi_\bm_\be
7034
7035        Type: number
7036
7037        Default: 1
7038
7039        Specifies time, in seconds, to pause while displaying certain informational
7040        messages, while moving from folder to folder and after expunging messages from
7041        the current folder.  The default is to pause one second, so a value of zero for
7042        this option suppresses the pause.
7043
7044        _\b6_\b._\b3_\b._\b2_\b6_\b3  _\bs_\bm_\ba_\br_\bt_\b__\bw_\br_\ba_\bp
7045
7046        Type: boolean
7047
7048        Default: yes
7049
7050        Controls the display of lines longer than the screen width in the internal
7051        pager. If _\bs_\be_\bt, long lines are wrapped at a word boundary.  If _\bu_\bn_\bs_\be_\bt, lines are
7052        simply wrapped at the screen edge. Also see the ``_\b$_\bm_\ba_\br_\bk_\be_\br_\bs (section 6.3.121  ,
7053        page 95)'' variable.
7054
7055        _\b6_\b._\b3_\b._\b2_\b6_\b4  _\bs_\bm_\bi_\bl_\be_\by_\bs
7056
7057        Type: regular expression
7058
7059        Default: '(>From )|(:[-^]?[][)(><}{|/DP])'
7060
7061        The _\bp_\ba_\bg_\be_\br uses this variable to catch some common false positives of
7062        ``_\b$_\bq_\bu_\bo_\bt_\be_\b__\br_\be_\bg_\be_\bx_\bp (section 6.3.225  , page 119)'', most notably smileys in the
7063        beginning of a line
7064
7065        The Mutt-ng E-Mail Client                                                   130
7066
7067        _\b6_\b._\b3_\b._\b2_\b6_\b5  _\bs_\bm_\bi_\bm_\be_\b__\ba_\bs_\bk_\b__\bc_\be_\br_\bt_\b__\bl_\ba_\bb_\be_\bl
7068
7069        Type: boolean
7070
7071        Default: yes
7072
7073        This flag controls whether you want to be asked to enter a label for a certifi-
7074        cate about to be added to the database or not. It is _\bs_\be_\bt by default.  (S/MIME
7075        only)
7076
7077        _\b6_\b._\b3_\b._\b2_\b6_\b6  _\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn
7078
7079        Type: path
7080
7081        Default: ''
7082
7083        This variable contains the name of either a directory, or a file which contains
7084        trusted certificates for use with OpenSSL.  (S/MIME only)
7085
7086        _\b6_\b._\b3_\b._\b2_\b6_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs
7087
7088        Type: path
7089
7090        Default: ''
7091
7092        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage
7093        and retrieval of keys by itself. This is very basic right now, and keys and
7094        certificates are stored in two different directories, both named as the hash-
7095        value retrieved from OpenSSL. There is an index file which contains mailbox-
7096        address keyid pairs, and which can be manually edited. This one points to the
7097        location of the certificates.  (S/MIME only)
7098
7099        _\b6_\b._\b3_\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
7100
7101        Type: string
7102
7103        Default: ''
7104
7105        This format string specifies a command which is used to decrypt application/x-
7106        pkcs7-mime attachments.
7107
7108        The OpenSSL command formats have their own set of printf(3)-like sequences sim-
7109        ilar to PGP's:
7110
7111              %f
7112                    Expands to the name of a file containing a message.
7113
7114              %s
7115                    Expands to the name of a file containing the signature part of a
7116                    multipart/signed attachment when verifying it.
7117
7118              %k
7119                    The key-pair specified with _\b$_\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by (section 6.3.270  ,
7120                    page 130)
7121
7122        The Mutt-ng E-Mail Client                                                   131
7123
7124              %c
7125                    One or more certificate IDs.
7126
7127              %a
7128                    The algorithm used for encryption.
7129
7130              %C
7131                    CA location:  Depending on whether _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section
7132                    6.3.266  , page 129) points to a directory or file, this expands to
7133                    '-CApath _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 6.3.266  , page 129)' or
7134                    '-CAfile _\b$_\bs_\bm_\bi_\bm_\be_\b__\bc_\ba_\b__\bl_\bo_\bc_\ba_\bt_\bi_\bo_\bn (section 6.3.266  , page 129)'.
7135
7136        For examples on how to configure these formats, see the smime.rc in the sam-
7137        ples/ subdirectory which has been installed on your system alongside the docu-
7138        mentation.  (S/MIME only)
7139
7140        _\b6_\b._\b3_\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
7141
7142        Type: boolean
7143
7144        Default: yes
7145
7146        If _\bs_\be_\bt (default) this tells Mutt-ng to use the default key for decryption. Oth-
7147        erwise, if manage multiple certificate-key-pairs, Mutt-ng will try to use the
7148        mailbox-address to determine the key to use. It will ask you to supply a key,
7149        if it can't find one.  (S/MIME only)
7150
7151        _\b6_\b._\b3_\b._\b2_\b7_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt_\b__\bk_\be_\by
7152
7153        Type: string
7154
7155        Default: ''
7156
7157        This is the default key-pair to use for signing. This must be set to the keyid
7158        (the hash-value that OpenSSL generates) to work properly (S/MIME only)
7159
7160        _\b6_\b._\b3_\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
7161
7162        Type: string
7163
7164        Default: ''
7165
7166        This command is used to create encrypted S/MIME messages.  (S/MIME only)
7167
7168        _\b6_\b._\b3_\b._\b2_\b7_\b2  _\bs_\bm_\bi_\bm_\be_\b__\be_\bn_\bc_\br_\by_\bp_\bt_\b__\bw_\bi_\bt_\bh
7169
7170        Type: string
7171
7172        Default: ''
7173
7174        This sets the algorithm that should be used for encryption.  Valid choices are
7175        ``des'', ``des3'', ``rc2-40'', ``rc2-64'', ``\frc2-128''.
7176
7177        If _\bu_\bn_\bs_\be_\bt ``_\b3_\bd_\be_\bs'' (TripleDES) is used.  (S/MIME only)
7178
7179        The Mutt-ng E-Mail Client                                                   132
7180
7181        _\b6_\b._\b3_\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
7182
7183        Type: string
7184
7185        Default: ''
7186
7187        This command is used to extract X509 certificates from a PKCS7 structure.
7188        (S/MIME only)
7189
7190        _\b6_\b._\b3_\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
7191
7192        Type: string
7193
7194        Default: ''
7195
7196        This command is used to extract the mail address(es) used for storing X509 cer-
7197        tificates, and for verification purposes (to check whether the certificate was
7198        issued for the sender's mailbox).  (S/MIME only)
7199
7200        _\b6_\b._\b3_\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
7201
7202        Type: string
7203
7204        Default: ''
7205
7206        This command is used to extract only the signers X509 certificate from a S/MIME
7207        signature, so that the certificate's owner may get compared to the email's
7208        ``From:'' header field.  (S/MIME only)
7209
7210        _\b6_\b._\b3_\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
7211
7212        Type: string
7213
7214        Default: ''
7215
7216        This command is used to import a certificate via smime_keysng.  (S/MIME only)
7217
7218        _\b6_\b._\b3_\b._\b2_\b7_\b7  _\bs_\bm_\bi_\bm_\be_\b__\bi_\bs_\b__\bd_\be_\bf_\ba_\bu_\bl_\bt
7219
7220        Type: boolean
7221
7222        Default: no
7223
7224        The default behaviour of Mutt-ng is to use PGP on all auto-sign/encryption
7225        operations. To override and to use OpenSSL instead this must be _\bs_\be_\bt.
7226
7227        However, this has no effect while replying, since Mutt-ng will automatically
7228        select the same application that was used to sign/encrypt the original message.
7229
7230        (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-
7231        tion 6.3.37  , page 73).)  (S/MIME only)
7232
7233        _\b6_\b._\b3_\b._\b2_\b7_\b8  _\bs_\bm_\bi_\bm_\be_\b__\bk_\be_\by_\bs
7234
7235        The Mutt-ng E-Mail Client                                                   133
7236
7237        Type: path
7238
7239        Default: ''
7240
7241        Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage ad
7242        retrieval of keys/certs by itself. This is very basic right now, and stores
7243        keys and certificates in two different directories, both named as the hash-
7244        value retrieved from OpenSSL. There is an index file which contains mailbox-
7245        address keyid pair, and which can be manually edited. This one points to the
7246        location of the private keys.  (S/MIME only)
7247
7248        _\b6_\b._\b3_\b._\b2_\b7_\b9  _\bs_\bm_\bi_\bm_\be_\b__\bp_\bk_\b7_\bo_\bu_\bt_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7249
7250        Type: string
7251
7252        Default: ''
7253
7254        This command is used to extract PKCS7 structures of S/MIME signatures, in order
7255        to extract the public X509 certificate(s).  (S/MIME only)
7256
7257        _\b6_\b._\b3_\b._\b2_\b8_\b0  _\bs_\bm_\bi_\bm_\be_\b__\bs_\bi_\bg_\bn_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7258
7259        Type: string
7260
7261        Default: ''
7262
7263        This command is used to created S/MIME signatures of type multipart/signed,
7264        which can be read by all mail clients.  (S/MIME only)
7265
7266        _\b6_\b._\b3_\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
7267
7268        Type: string
7269
7270        Default: ''
7271
7272        This command is used to created S/MIME signatures of type application/x-
7273        pkcs7-signature, which can only be handled by mail clients supporting the
7274        S/MIME extension.  (S/MIME only)
7275
7276        _\b6_\b._\b3_\b._\b2_\b8_\b2  _\bs_\bm_\bi_\bm_\be_\b__\bt_\bi_\bm_\be_\bo_\bu_\bt
7277
7278        Type: number
7279
7280        Default: 300
7281
7282        The number of seconds after which a cached passphrase will expire if not used.
7283        (S/MIME only)
7284
7285        _\b6_\b._\b3_\b._\b2_\b8_\b3  _\bs_\bm_\bi_\bm_\be_\b__\bv_\be_\br_\bi_\bf_\by_\b__\bc_\bo_\bm_\bm_\ba_\bn_\bd
7286
7287        Type: string
7288
7289        Default: ''
7290
7291        The Mutt-ng E-Mail Client                                                   134
7292
7293        This command is used to verify S/MIME signatures of type multipart/signed.
7294        (S/MIME only)
7295
7296        _\b6_\b._\b3_\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
7297
7298        Type: string
7299
7300        Default: ''
7301
7302        This command is used to verify S/MIME signatures of type application/x-
7303        pkcs7-mime.  (S/MIME only)
7304
7305        _\b6_\b._\b3_\b._\b2_\b8_\b5  _\bs_\bm_\bt_\bp_\b__\ba_\bu_\bt_\bh_\b__\bp_\ba_\bs_\bs_\bw_\bo_\br_\bd
7306
7307        Type: string
7308
7309        Default: ''
7310
7311        Availability: SMTP
7312
7313        Defines the password to use with SMTP AUTH.  If ``_\b$_\bs_\bm_\bt_\bp_\b__\ba_\bu_\bt_\bh_\b__\bu_\bs_\be_\br_\bn_\ba_\bm_\be (section
7314        6.3.286  , page 133)'' is set, but this variable is not, you will be prompted
7315        for a password when sending.
7316
7317        N\bNo\bot\bte\be:\b: Storing passwords in a configuration file presents a security risk since
7318        the superuser of your machine may read it regardless of the file's permissions.
7319
7320        _\b6_\b._\b3_\b._\b2_\b8_\b6  _\bs_\bm_\bt_\bp_\b__\ba_\bu_\bt_\bh_\b__\bu_\bs_\be_\br_\bn_\ba_\bm_\be
7321
7322        Type: string
7323
7324        Default: ''
7325
7326        Availability: SMTP
7327
7328        Defines the username to use with SMTP AUTH.  Setting this variable will cause
7329        Mutt-ng to attempt to use SMTP AUTH when sending.
7330
7331        _\b6_\b._\b3_\b._\b2_\b8_\b7  _\bs_\bm_\bt_\bp_\b__\bh_\bo_\bs_\bt
7332
7333        Type: string
7334
7335        Default: ''
7336
7337        Availability: SMTP
7338
7339        Defines the SMTP host which will be used to deliver mail, as opposed to invok-
7340        ing the sendmail binary.  Setting this variable overrides the value of ``_\b$_\bs_\be_\bn_\bd_\b-
7341        _\bm_\ba_\bi_\bl (section 6.3.247  , page 124)'', and any associated variables.
7342
7343        _\b6_\b._\b3_\b._\b2_\b8_\b8  _\bs_\bm_\bt_\bp_\b__\bp_\bo_\br_\bt
7344
7345        Type: number
7346
7347        The Mutt-ng E-Mail Client                                                   135
7348
7349        Default: 25
7350
7351        Availability: SMTP
7352
7353        Defines the port that the SMTP host is listening on for mail delivery.  Must be
7354        specified as a number.
7355
7356        Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers
7357        will probably desire 587, the mail submission port.
7358
7359        _\b6_\b._\b3_\b._\b2_\b8_\b9  _\bs_\bo_\br_\bt
7360
7361        Type: sort order
7362
7363        Default: date
7364
7365        Specifies how to sort messages in the _\bi_\bn_\bd_\be_\bx menu.  Valid values are:
7366
7367                date or date-sent
7368                date-received
7369                from
7370                mailbox-order (unsorted)
7371                score
7372                size
7373                spam
7374                subject
7375                threads
7376                to
7377
7378        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
7379        (example: set sort=reverse-date-sent).
7380
7381        _\b6_\b._\b3_\b._\b2_\b9_\b0  _\bs_\bo_\br_\bt_\b__\ba_\bl_\bi_\ba_\bs
7382
7383        Type: sort order
7384
7385        Default: alias
7386
7387        Specifies how the entries in the ``alias'' menu are sorted.  The following are
7388        legal values:
7389
7390                address (sort alphabetically by email address)
7391                alias (sort alphabetically by alias name)
7392                unsorted (leave in order specified in .muttrc)
7393
7394        _\b6_\b._\b3_\b._\b2_\b9_\b1  _\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
7395
7396        Type: sort order
7397
7398        Default: date
7399
7400        The Mutt-ng E-Mail Client                                                   136
7401
7402        When sorting by threads, this variable controls how threads are sorted in rela-
7403        tion to other threads, and how the branches of the thread trees are sorted.
7404        This can be set to any value that ``_\b$_\bs_\bo_\br_\bt (section 6.3.289  , page 134)'' can,
7405        except threads (in that case, Mutt-ng will just use date-sent).  You can also
7406        specify the ``last-'' prefix in addition to ``reverse-'' prefix, but last- must
7407        come after reverse-.  The last- prefix causes messages to be sorted against its
7408        siblings by which has the last descendant, using the rest of sort_aux as an
7409        ordering.
7410
7411        For instance, set sort_aux=last-date-received would mean that if a new message
7412        is received in a thread, that thread becomes the last one displayed (or the
7413        first, if you have set sort=reverse-threads.)
7414
7415        N\bNo\bot\bte\be:\b: For reversed ``_\b$_\bs_\bo_\br_\bt (section 6.3.289  , page 134)'' order _\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx
7416        (section 6.3.291  , page 134) is reversed again (which is not the right thing
7417        to do, but kept to not break any existing configuration setting).
7418
7419        _\b6_\b._\b3_\b._\b2_\b9_\b2  _\bs_\bo_\br_\bt_\b__\bb_\br_\bo_\bw_\bs_\be_\br
7420
7421        Type: sort order
7422
7423        Default: alpha
7424
7425        Specifies how to sort entries in the file browser.  By default, the entries are
7426        sorted alphabetically.  Valid values:
7427
7428                alpha (alphabetically)
7429                date
7430                size
7431                unsorted
7432
7433        You may optionally use the ``reverse-'' prefix to specify reverse sorting order
7434        (example: set sort_browser=reverse-date).
7435
7436        _\b6_\b._\b3_\b._\b2_\b9_\b3  _\bs_\bo_\br_\bt_\b__\br_\be
7437
7438        Type: boolean
7439
7440        Default: yes
7441
7442        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
7443        (section 6.3.309  , page 141)'' _\bu_\bn_\bs_\be_\bt. In that case, it changes the heuristic
7444        Mutt-ng uses to thread messages by subject.  With _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 6.3.293  ,
7445        page 135) _\bs_\be_\bt, Mutt-ng will only attach a message as the child of another mes-
7446        sage by subject if the subject of the child message starts with a substring
7447        matching the setting of ``_\b$_\br_\be_\bp_\bl_\by_\b__\br_\be_\bg_\be_\bx_\bp (section 6.3.231  , page 120)''. With
7448        _\b$_\bs_\bo_\br_\bt_\b__\br_\be (section 6.3.293  , page 135) _\bu_\bn_\bs_\be_\bt, Mutt-ng will attach the message
7449        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
7450        6.3.231  , page 120)'' parts of both messages are identical.
7451
7452        _\b6_\b._\b3_\b._\b2_\b9_\b4  _\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br
7453
7454        The Mutt-ng E-Mail Client                                                   137
7455
7456        Type: string
7457
7458        Default: ','
7459
7460        ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 6.3.294  , page 135)'' controls what happens when
7461        multiple spam headers are matched: if _\bu_\bn_\bs_\be_\bt, each successive header will over-
7462        write any previous matches value for the spam label. If _\bs_\be_\bt, each successive
7463        match will append to the previous, using ``_\bs_\bp_\ba_\bm_\b__\bs_\be_\bp_\ba_\br_\ba_\bt_\bo_\br (section 6.3.294  ,
7464        page 135)'' as a separator.
7465
7466        _\b6_\b._\b3_\b._\b2_\b9_\b5  _\bs_\bp_\bo_\bo_\bl_\bf_\bi_\bl_\be
7467
7468        Type: path
7469
7470        Default: ''
7471
7472        If your spool mailbox is in a non-default place where Mutt-ng cannot find it,
7473        you can specify its location with this variable.  Mutt-ng will automatically
7474        set this variable to the value of the environment variable $MAIL if it is not
7475        set.
7476
7477        _\b6_\b._\b3_\b._\b2_\b9_\b6  _\bs_\bs_\bl_\b__\bc_\ba_\b__\bc_\be_\br_\bt_\bi_\bf_\bi_\bc_\ba_\bt_\be_\bs_\b__\bf_\bi_\bl_\be
7478
7479        Type: path
7480
7481        Default: ''
7482
7483        This variable specifies a file containing trusted CA certificates.  Any server
7484        certificate that is signed with one of these CA certificates are also automati-
7485        cally accepted.
7486
7487        Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt
7488
7489        _\b6_\b._\b3_\b._\b2_\b9_\b7  _\bs_\bs_\bl_\b__\bc_\bl_\bi_\be_\bn_\bt_\b__\bc_\be_\br_\bt
7490
7491        Type: path
7492
7493        Default: ''
7494
7495        Availability: SSL
7496
7497        The file containing a client certificate and its associated private key.
7498
7499        _\b6_\b._\b3_\b._\b2_\b9_\b8  _\bs_\bs_\bl_\b__\bm_\bi_\bn_\b__\bd_\bh_\b__\bp_\br_\bi_\bm_\be_\b__\bb_\bi_\bt_\bs
7500
7501        Type: number
7502
7503        Default: 0
7504
7505        Availability: GNUTLS
7506
7507        This variable specifies the minimum acceptable prime size (in bits) for use in
7508        any Diffie-Hellman key exchange. A value of 0 will use the default from the
7509        GNUTLS library.
7510
7511        The Mutt-ng E-Mail Client                                                   138
7512
7513        _\b6_\b._\b3_\b._\b2_\b9_\b9  _\bs_\bs_\bl_\b__\bs_\bt_\ba_\br_\bt_\bt_\bl_\bs
7514
7515        Type: quadoption
7516
7517        Default: yes
7518
7519        Availability: SSL or GNUTLS
7520
7521        If _\bs_\be_\bt (the default), Mutt-ng will attempt to use STARTTLS on servers advertis-
7522        ing the capability. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will not attempt to use STARTTLS
7523        regardless of the server's capabilities.
7524
7525        _\b6_\b._\b3_\b._\b3_\b0_\b0  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b2
7526
7527        Type: boolean
7528
7529        Default: yes
7530
7531        Availability: SSL
7532
7533        This variables specifies whether to attempt to use SSLv2 in the SSL authentica-
7534        tion process.
7535
7536        _\b6_\b._\b3_\b._\b3_\b0_\b1  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bs_\bs_\bl_\bv_\b3
7537
7538        Type: boolean
7539
7540        Default: yes
7541
7542        Availability: SSL or GNUTLS
7543
7544        This variables specifies whether to attempt to use SSLv3 in the SSL authentica-
7545        tion process.
7546
7547        _\b6_\b._\b3_\b._\b3_\b0_\b2  _\bs_\bs_\bl_\b__\bu_\bs_\be_\b__\bt_\bl_\bs_\bv_\b1
7548
7549        Type: boolean
7550
7551        Default: yes
7552
7553        Availability: SSL or GNUTLS
7554
7555        This variables specifies whether to attempt to use TLSv1 in the SSL authentica-
7556        tion process.
7557
7558        _\b6_\b._\b3_\b._\b3_\b0_\b3  _\bs_\bs_\bl_\b__\bu_\bs_\be_\bs_\by_\bs_\bt_\be_\bm_\bc_\be_\br_\bt_\bs
7559
7560        Type: boolean
7561
7562        Default: yes
7563
7564        Availability: SSL
7565
7566        If set to _\by_\be_\bs, Mutt-ng will use CA certificates in the system-wide certificate
7567
7568        The Mutt-ng E-Mail Client                                                   139
7569
7570        store when checking if server certificate is signed by a trusted CA.
7571
7572        _\b6_\b._\b3_\b._\b3_\b0_\b4  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs
7573
7574        Type: string
7575
7576        Default: '-*%A'
7577
7578        Controls the characters used by the ``%r'' indicator in ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (sec-
7579        tion 6.3.305  , page 138)''. The first character is used when the mailbox is
7580        unchanged. The second is used when the mailbox has been changed, and it needs
7581        to be resynchronized. The third is used if the mailbox is in read-only mode, or
7582        if the mailbox will not be written when exiting that mailbox (You can toggle
7583        whether to write changes to a mailbox with the toggle-write operation, bound by
7584        default to ``%'').  The fourth  is used to indicate that the current folder has
7585        been opened in attach-message mode (Certain operations like composing a new
7586        mail, replying, forwarding, etc. are not permitted in this mode).
7587
7588        _\b6_\b._\b3_\b._\b3_\b0_\b5  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt
7589
7590        Type: string
7591
7592        Default: '-%r-Mutt-ng: %f [Msgs:%?M?%M/?%m%?n? New:%n?%?o? Old:%o?%?d?
7593        Del:%d?%?F? Flag:%F?%?t? Tag:%t?%?p? Post:%p?%?b? Inc:%b?%?l?
7594        %l?]---(%s/%S)-%>-(%P)---'
7595
7596        Controls the format of the status line displayed in the _\bi_\bn_\bd_\be_\bx menu.  This
7597        string is similar to ``_\b$_\bi_\bn_\bd_\be_\bx_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.110  , page 90)'', but has
7598        its own set of printf(3)-like sequences:
7599
7600              %b
7601                    number of mailboxes with new mail *
7602
7603              %B
7604                    the short pathname of the current mailbox
7605
7606              %d
7607                    number of deleted messages *
7608
7609              %f
7610                    the full pathname of the current mailbox
7611
7612              %F
7613                    number of flagged messages *
7614
7615              %h
7616                    local hostname
7617
7618              %l
7619                    size (in bytes) of the current mailbox *
7620
7621              %L
7622                    size (in bytes) of the messages shown (i.e., which match the cur-
7623                    rent limit) *
7624
7625        The Mutt-ng E-Mail Client                                                   140
7626
7627              %m
7628                    the number of messages in the mailbox *
7629
7630              %M
7631                    the number of messages shown (i.e., which match the current limit)
7632                    *
7633
7634              %n
7635                    number of new messages in the mailbox *
7636
7637              %o
7638                    number of old unread messages *
7639
7640              %p
7641                    number of postponed messages *
7642
7643              %P
7644                    percentage of the way through the index
7645
7646              %r
7647                    modified/read-only/won't-write/attach-message indicator, according
7648                    to _\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bc_\bh_\ba_\br_\bs (section 6.3.304  , page 137)
7649
7650              %s
7651                    current sorting mode (_\b$_\bs_\bo_\br_\bt (section 6.3.289  , page 134))
7652
7653              %S
7654                    current aux sorting method (_\b$_\bs_\bo_\br_\bt_\b__\ba_\bu_\bx (section 6.3.291  , page
7655                    134))
7656
7657              %t
7658                    number of tagged messages *
7659
7660              %u
7661                    number of unread messages *
7662
7663              %v
7664                    Mutt-ng version string
7665
7666              %V
7667                    currently active limit pattern, if any *
7668
7669              %>X
7670                    right justify the rest of the string and pad with 'X'
7671
7672              %|X
7673                    pad to the end of the line with 'X'
7674
7675        * = can be optionally printed if nonzero
7676
7677        Some of the above sequences can be used to optionally print a string if their
7678        value is nonzero.  For example, you may only want to see the number of flagged
7679        messages if such messages exist, since zero is not particularly meaningful.  To
7680        optionally print a string based upon one of the above sequences, the following
7681
7682        The Mutt-ng E-Mail Client                                                   141
7683
7684        construct is used
7685
7686        %?<sequence_char>?<optional_string>?
7687
7688        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
7689        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
7690        m\bma\bay\by contain other sequences as well as normal text, but you may n\bno\bot\bt nest
7691        optional strings.
7692
7693        Here is an example illustrating how to optionally print the number of new mes-
7694        sages in a mailbox:
7695
7696        %?n?%n new messages.?
7697
7698        Additionally you can switch between two strings, the first one, if a value is
7699        zero, the second one, if the value is nonzero, by using the following con-
7700        struct:
7701
7702        %?<sequence_char>?<if_string>&<else_string>?
7703
7704        You can additionally force the result of any printf(3)-like sequence to be low-
7705        ercase by prefixing the sequence character with an underscore (_) sign.  For
7706        example, if you want to display the local hostname in lowercase, you would use:
7707
7708        %_h
7709
7710        If you prefix the sequence character with a colon (:) character, Mutt-ng will
7711        replace any dots in the expansion by underscores. This might be helpful with
7712        IMAP folders that don't like dots in folder names.
7713
7714        _\b6_\b._\b3_\b._\b3_\b0_\b6  _\bs_\bt_\ba_\bt_\bu_\bs_\b__\bo_\bn_\b__\bt_\bo_\bp
7715
7716        Type: boolean
7717
7718        Default: no
7719
7720        Setting this variable causes the ``status bar'' to be displayed on the first
7721        line of the screen rather than near the bottom.
7722
7723        _\b6_\b._\b3_\b._\b3_\b0_\b7  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\ba_\bi_\bl_\bt_\bo
7724
7725        Type: boolean
7726
7727        Default: yes
7728
7729        With mailto: style links, a body as well as arbitrary header information may be
7730        embedded. This may lead to (user) headers being overwriten without note if
7731        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 6.3.54  , page 77)'' is unset.
7732
7733        If this variable is _\bs_\be_\bt, mutt-ng is strict and allows anything to be changed.
7734        If it's _\bu_\bn_\bs_\be_\bt, all headers given will be prefixed with ``X-Mailto-'' and the
7735        message including headers will be shown in the editor regardless of what
7736        ``_\b$_\be_\bd_\bi_\bt_\b__\bh_\be_\ba_\bd_\be_\br_\bs (section 6.3.54  , page 77)'' is set to.
7737
7738        The Mutt-ng E-Mail Client                                                   142
7739
7740        _\b6_\b._\b3_\b._\b3_\b0_\b8  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bm_\bi_\bm_\be
7741
7742        Type: boolean
7743
7744        Default: yes
7745
7746        When _\bu_\bn_\bs_\be_\bt, non MIME-compliant messages that doesn't have any charset indica-
7747        tion in the ``Content-Type:'' header field can be displayed (non MIME-compliant
7748        messages are often generated by old mailers or buggy mailers like MS Outlook
7749        Express).  See also _\b$_\ba_\bs_\bs_\bu_\bm_\be_\bd_\b__\bc_\bh_\ba_\br_\bs_\be_\bt (section 6.3.11  , page 67).
7750
7751        This option also replaces linear-white-space between encoded-word and *text to
7752        a single space to prevent the display of MIME-encoded ``Subject:'' header field
7753        from being devided into multiple lines.
7754
7755        _\b6_\b._\b3_\b._\b3_\b0_\b9  _\bs_\bt_\br_\bi_\bc_\bt_\b__\bt_\bh_\br_\be_\ba_\bd_\bs
7756
7757        Type: boolean
7758
7759        Default: no
7760
7761        If _\bs_\be_\bt, threading will only make use of the ``In-Reply-To:'' and ``Refer-
7762        ences:'' header fields when you ``_\b$_\bs_\bo_\br_\bt (section 6.3.289  , page 134)'' by mes-
7763        sage threads.  By default, messages with the same subject are grouped together
7764        in ``pseudo threads.''  This may not always be desirable, such as in a personal
7765        mailbox where you might have several unrelated messages with the subject ``hi''
7766        which will get grouped together.
7767
7768        _\b6_\b._\b3_\b._\b3_\b1_\b0  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs
7769
7770        Type: boolean
7771
7772        Default: no
7773
7774        When _\bs_\be_\bt, mutt-ng will remove the trailing part of the ``Subject:'' line which
7775        matches _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx (section 6.3.311  , page 141) when replying. This is
7776        useful to properly react on subject changes and reduce ``subject noise.'' (esp.
7777        in Usenet)
7778
7779        _\b6_\b._\b3_\b._\b3_\b1_\b1  _\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs_\b__\br_\be_\bg_\be_\bx
7780
7781        Type: regular expression
7782
7783        Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$'
7784
7785        When non-empty and _\b$_\bs_\bt_\br_\bi_\bp_\b__\bw_\ba_\bs (section 6.3.310  , page 141) is _\bs_\be_\bt, mutt-ng
7786        will remove this trailing part of the ``Subject'' line when replying if it
7787        won't be empty afterwards.
7788
7789        _\b6_\b._\b3_\b._\b3_\b1_\b2  _\bs_\bt_\bu_\bf_\bf_\b__\bq_\bu_\bo_\bt_\be_\bd
7790
7791        Type: boolean
7792
7793        Default: no
7794
7795        The Mutt-ng E-Mail Client                                                   143
7796
7797        If _\bs_\be_\bt, attachments with flowed format will have their quoting ``stuffed'',
7798        i.e. a space will be inserted between the quote characters and the actual text.
7799
7800        _\b6_\b._\b3_\b._\b3_\b1_\b3  _\bs_\bu_\bs_\bp_\be_\bn_\bd
7801
7802        Type: boolean
7803
7804        Default: yes
7805
7806        When _\bu_\bn_\bs_\be_\bt, Mutt-ng won't stop when the user presses the terminal's _\bs_\bu_\bs_\bp key,
7807        usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a com-
7808        mand like ``xterm -e muttng.''
7809
7810        _\b6_\b._\b3_\b._\b3_\b1_\b4  _\bt_\be_\bx_\bt_\b__\bf_\bl_\bo_\bw_\be_\bd
7811
7812        Type: boolean
7813
7814        Default: no
7815
7816        When _\bs_\be_\bt, Mutt-ng will generate text/plain; format=flowed attachments.  This
7817        format is easier to handle for some mailing software, and generally just looks
7818        like ordinary text.  To actually make use of this format's features, you'll
7819        need support in your editor.
7820
7821        Note that _\b$_\bi_\bn_\bd_\be_\bn_\bt_\b__\bs_\bt_\br_\bi_\bn_\bg (section 6.3.109  , page 90) is ignored when this
7822        option is set.
7823
7824        _\b6_\b._\b3_\b._\b3_\b1_\b5  _\bt_\bh_\bo_\br_\bo_\bu_\bg_\bh_\b__\bs_\be_\ba_\br_\bc_\bh
7825
7826        Type: boolean
7827
7828        Default: no
7829
7830        Affects the ~b and ~h search operations described in section ``_\bp_\ba_\bt_\bt_\be_\br_\bn_\bs (sec-
7831        tion 4.2  , page 36)'' above.  If _\bs_\be_\bt, the headers and attachments of messages
7832        to be searched are decoded before searching.  If _\bu_\bn_\bs_\be_\bt, messages are searched
7833        as they appear in the folder.
7834
7835        _\b6_\b._\b3_\b._\b3_\b1_\b6  _\bt_\bh_\br_\be_\ba_\bd_\b__\br_\be_\bc_\be_\bi_\bv_\be_\bd
7836
7837        Type: boolean
7838
7839        Default: no
7840
7841        When _\bs_\be_\bt, Mutt-ng uses the date received rather than the date sent to thread
7842        messages by subject.
7843
7844        _\b6_\b._\b3_\b._\b3_\b1_\b7  _\bt_\bi_\bl_\bd_\be
7845
7846        Type: boolean
7847
7848        Default: no
7849
7850        When _\bs_\be_\bt, the internal-pager will pad blank lines to the bottom of the screen
7851
7852        The Mutt-ng E-Mail Client                                                   144
7853
7854        with a tilde (~).
7855
7856        _\b6_\b._\b3_\b._\b3_\b1_\b8  _\bt_\bi_\bm_\be_\bo_\bu_\bt
7857
7858        Type: number
7859
7860        Default: 600
7861
7862        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
7863        pressed in the main menu before timing out and checking for new mail.  A value
7864        of zero or less will cause Mutt-ng to never time out.
7865
7866        _\b6_\b._\b3_\b._\b3_\b1_\b9  _\bt_\bm_\bp_\bd_\bi_\br
7867
7868        Type: path
7869
7870        Default: ''
7871
7872        This variable allows you to specify where Mutt-ng will place its temporary
7873        files needed for displaying and composing messages.  If this variable is not
7874        set, the environment variable $TMPDIR is used.  If $TMPDIR is not set then
7875        '/tmp' is used.
7876
7877        _\b6_\b._\b3_\b._\b3_\b2_\b0  _\bt_\bo_\b__\bc_\bh_\ba_\br_\bs
7878
7879        Type: string
7880
7881        Default: ' +TCFL'
7882
7883        Controls the character used to indicate mail addressed to you.  The first char-
7884        acter is the one used when the mail is NOT addressed to your address (default:
7885        space).  The second is used when you are the only recipient of the message
7886        (default: +).  The third is when your address appears in the ``To:'' header
7887        field, but you are not the only recipient of the message (default: T).  The
7888        fourth character is used when your address is specified in the ``Cc:'' header
7889        field, but you are not the only recipient.  The fifth character is used to
7890        indicate mail that was sent by _\by_\bo_\bu.  The sixth character is used to indicate
7891        when a mail was sent to a mailing-list you're subscribe to (default: L).
7892
7893        _\b6_\b._\b3_\b._\b3_\b2_\b1  _\bt_\br_\ba_\bs_\bh
7894
7895        Type: path
7896
7897        Default: ''
7898
7899        If _\bs_\be_\bt, this variable specifies the path of the trash folder where the mails
7900        marked for deletion will be moved, instead of being irremediably purged.
7901
7902        N\bNo\bot\bte\be: When you delete a message in the trash folder, it is really deleted, so
7903        that there is no way to recover mail.
7904
7905        _\b6_\b._\b3_\b._\b3_\b2_\b2  _\bt_\bu_\bn_\bn_\be_\bl
7906
7907        Type: string
7908
7909        The Mutt-ng E-Mail Client                                                   145
7910
7911        Default: ''
7912
7913        Setting this variable will cause Mutt-ng to open a pipe to a command instead of
7914        a raw socket. You may be able to use this to set up preauthenticated connec-
7915        tions to your IMAP/POP3 server. Example:
7916
7917        tunnel='ssh -q mailhost.net /usr/local/libexec/imapd'
7918
7919        N\bNo\bot\bte\be:\b: For this example to work you must be able to log in to the remote machine
7920        without having to enter a password.
7921
7922        _\b6_\b._\b3_\b._\b3_\b2_\b3  _\bu_\bm_\ba_\bs_\bk
7923
7924        Type: number
7925
7926        Default: 0077
7927
7928        This sets the umask that will be used by Mutt-ng when creating all kinds of
7929        files. If _\bu_\bn_\bs_\be_\bt, the default value is 077.
7930
7931        _\b6_\b._\b3_\b._\b3_\b2_\b4  _\bu_\bn_\bc_\bo_\bl_\bl_\ba_\bp_\bs_\be_\b__\bj_\bu_\bm_\bp
7932
7933        Type: boolean
7934
7935        Default: no
7936
7937        When _\bs_\be_\bt, Mutt-ng will jump to the next unread message, if any, when the cur-
7938        rent thread is _\bu_\bncollapsed.
7939
7940        _\b6_\b._\b3_\b._\b3_\b2_\b5  _\bu_\bs_\be_\b__\b8_\bb_\bi_\bt_\bm_\bi_\bm_\be
7941
7942        Type: boolean
7943
7944        Default: no
7945
7946        W\bWa\bar\brn\bni\bin\bng\bg:\b: do not set this variable unless you are using a version of sendmail
7947        which supports the -B8BITMIME flag (such as sendmail 8.8.x) or you may not be
7948        able to send mail.
7949
7950        When _\bs_\be_\bt, Mutt-ng will invoke ``_\b$_\bs_\be_\bn_\bd_\bm_\ba_\bi_\bl (section 6.3.247  , page 124)'' with
7951        the -B8BITMIME flag when sending 8-bit messages to enable ESMTP negotiation.
7952
7953        _\b6_\b._\b3_\b._\b3_\b2_\b6  _\bu_\bs_\be_\b__\bd_\bo_\bm_\ba_\bi_\bn
7954
7955        Type: boolean
7956
7957        Default: yes
7958
7959        When _\bs_\be_\bt, Mutt-ng will qualify all local addresses (ones without the @host por-
7960        tion) with the value of ``_\b$_\bh_\bo_\bs_\bt_\bn_\ba_\bm_\be (section 6.3.89  , page 85)''.  If _\bu_\bn_\bs_\be_\bt,
7961        no addresses will be qualified.
7962
7963        _\b6_\b._\b3_\b._\b3_\b2_\b7  _\bu_\bs_\be_\b__\bf_\br_\bo_\bm
7964
7965        The Mutt-ng E-Mail Client                                                   146
7966
7967        Type: boolean
7968
7969        Default: yes
7970
7971        When _\bs_\be_\bt, Mutt-ng will generate the ``From:'' header field when sending mes-
7972        sages. If _\bu_\bn_\bs_\be_\bt, no ``From:'' header field will be generated unless the user
7973        explicitly sets one using the ``_\bm_\by_\b__\bh_\bd_\br (section 3.13  , page 25)'' command.
7974
7975        _\b6_\b._\b3_\b._\b3_\b2_\b8  _\bu_\bs_\be_\b__\bi_\bd_\bn
7976
7977        Type: boolean
7978
7979        Default: yes
7980
7981        Availability: IDN
7982
7983        When _\bs_\be_\bt, Mutt-ng will show you international domain names decoded.
7984
7985        N\bNo\bot\bte\be:\b: You can use IDNs for addresses even if this is _\bu_\bn_\bs_\be_\bt.  This variable only
7986        affects decoding.
7987
7988        _\b6_\b._\b3_\b._\b3_\b2_\b9  _\bu_\bs_\be_\b__\bi_\bp_\bv_\b6
7989
7990        Type: boolean
7991
7992        Default: yes
7993
7994        When _\bs_\be_\bt, Mutt-ng will look for IPv6 addresses of hosts it tries to contact.
7995        If this option is _\bu_\bn_\bs_\be_\bt, Mutt-ng will restrict itself to IPv4 addresses.  Nor-
7996        mally, the default should work.
7997
7998        _\b6_\b._\b3_\b._\b3_\b3_\b0  _\bu_\bs_\be_\br_\b__\ba_\bg_\be_\bn_\bt
7999
8000        Type: boolean
8001
8002        Default: yes
8003
8004        When _\bs_\be_\bt, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indi-
8005        cating which version of Mutt-ng was used for composing them.
8006
8007        _\b6_\b._\b3_\b._\b3_\b3_\b1  _\bv_\bi_\bs_\bu_\ba_\bl
8008
8009        Type: path
8010
8011        Default: ''
8012
8013        Specifies the visual editor to invoke when the _\b~_\bv command is given in the
8014        builtin editor.
8015
8016        _\b6_\b._\b3_\b._\b3_\b3_\b2  _\bw_\ba_\bi_\bt_\b__\bk_\be_\by
8017
8018        Type: boolean
8019
8020        Default: yes
8021
8022        The Mutt-ng E-Mail Client                                                   147
8023
8024        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-
8025        _\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.
8026
8027        It is also used when viewing attachments with ``_\ba_\bu_\bt_\bo_\b__\bv_\bi_\be_\bw (section 5.4  , page
8028        60)'', provided that the corresponding mailcap entry has a needsterminal flag,
8029        and the external program is interactive.
8030
8031        When _\bs_\be_\bt, Mutt-ng will always ask for a key. When _\bu_\bn_\bs_\be_\bt, Mutt-ng will wait for
8032        a key only if the external command returned a non-zero status.
8033
8034        _\b6_\b._\b3_\b._\b3_\b3_\b3  _\bw_\be_\be_\bd
8035
8036        Type: boolean
8037
8038        Default: yes
8039
8040        When _\bs_\be_\bt, Mutt-ng will weed headers when displaying, forwarding, printing, or
8041        replying to messages.
8042
8043        _\b6_\b._\b3_\b._\b3_\b3_\b4  _\bw_\br_\ba_\bp_\b__\bs_\be_\ba_\br_\bc_\bh
8044
8045        Type: boolean
8046
8047        Default: yes
8048
8049        Controls whether searches wrap around the end of the mailbox.
8050
8051        When _\bs_\be_\bt, searches will wrap around the first (or last) message. When _\bu_\bn_\bs_\be_\bt,
8052        searches will not wrap.
8053
8054        _\b6_\b._\b3_\b._\b3_\b3_\b5  _\bw_\br_\ba_\bp_\bm_\ba_\br_\bg_\bi_\bn
8055
8056        Type: number
8057
8058        Default: 0
8059
8060        Controls the size of the margin remaining at the right side of the terminal
8061        when Mutt-ng's pager does smart wrapping.
8062
8063        _\b6_\b._\b3_\b._\b3_\b3_\b6  _\bw_\br_\bi_\bt_\be_\b__\bb_\bc_\bc
8064
8065        Type: boolean
8066
8067        Default: yes
8068
8069        Controls whether Mutt-ng writes out the Bcc header when preparing messages to
8070        be sent.  Exim users may wish to _\bu_\bn_\bs_\be_\bt this.
8071
8072        _\b6_\b._\b3_\b._\b3_\b3_\b7  _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc
8073
8074        Type: number
8075
8076        Default: 10
8077
8078        The Mutt-ng E-Mail Client                                                   148
8079
8080        When writing a mailbox, a message will be printed every _\bw_\br_\bi_\bt_\be_\b__\bi_\bn_\bc messages to
8081        indicate progress.  If set to 0, only a single message will be displayed before
8082        writing a mailbox.
8083
8084        Also see the ``_\b$_\br_\be_\ba_\bd_\b__\bi_\bn_\bc (section 6.3.226  , page 119)'' variable.
8085
8086        _\b6_\b._\b3_\b._\b3_\b3_\b8  _\bx_\bt_\be_\br_\bm_\b__\bi_\bc_\bo_\bn
8087
8088        Type: string
8089
8090        Default: 'M%?n?AIL&ail?'
8091
8092        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-
8093        tion 6.3.340  , page 147) is _\bs_\be_\bt. This string is identical in formatting to the
8094        one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.305  , page 138)''.
8095
8096        _\b6_\b._\b3_\b._\b3_\b3_\b9  _\bx_\bt_\be_\br_\bm_\b__\bl_\be_\ba_\bv_\be
8097
8098        Type: string
8099
8100        Default: ''
8101
8102        If _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 6.3.340  , page 147) is _\bs_\be_\bt, this string will be
8103        used to set the title when leaving mutt-ng. For terminal-based programs,
8104        there's no easy and portable way to read the current title so mutt-ng cannot
8105        read it upon startup and restore it when exiting.
8106
8107        Based on the xterm FAQ, the following might work:
8108
8109        set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME |
8110        cut -d ''' -f 2`'
8111
8112        _\b6_\b._\b3_\b._\b3_\b4_\b0  _\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs
8113
8114        Type: boolean
8115
8116        Default: no
8117
8118        Controls whether Mutt-ng sets the xterm title bar and icon name (as long as
8119        you're in an appropriate terminal). The default must be _\bu_\bn_\bs_\be_\bt to force in the
8120        validity checking.
8121
8122        _\b6_\b._\b3_\b._\b3_\b4_\b1  _\bx_\bt_\be_\br_\bm_\b__\bt_\bi_\bt_\bl_\be
8123
8124        Type: string
8125
8126        Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?'
8127
8128        Controls the format of the title bar of the xterm provided that
8129        _\b$_\bx_\bt_\be_\br_\bm_\b__\bs_\be_\bt_\b__\bt_\bi_\bt_\bl_\be_\bs (section 6.3.340  , page 147) has been _\bs_\be_\bt. This string is
8130        identical in formatting to the one used by ``_\b$_\bs_\bt_\ba_\bt_\bu_\bs_\b__\bf_\bo_\br_\bm_\ba_\bt (section 6.3.305  ,
8131        page 138)''.
8132
8133        The Mutt-ng E-Mail Client                                                   149
8134
8135        _\b6_\b._\b4  _\bF_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\bs
8136
8137        The following is the list of available functions listed by the mapping in which
8138        they are available.  The default key setting is given, and an explanation of
8139        what the function does.  The key bindings of these functions can be changed
8140        with the _\bb_\bi_\bn_\bd (section 3.3  , page 17) command.
8141
8142        _\b6_\b._\b4_\b._\b1  _\bg_\be_\bn_\be_\br_\bi_\bc
8143
8144        The _\bg_\be_\bn_\be_\br_\bi_\bc menu is not a real menu, but specifies common functions (such as
8145        movement) available in all menus except for _\bp_\ba_\bg_\be_\br and _\be_\bd_\bi_\bt_\bo_\br.  Changing set-
8146        tings for this menu will affect the default bindings for all menus (except as
8147        noted).
8148
8149             bottom-page                L   move to the bottom of the page
8150             current-bottom     not bound   move current entry to bottom of page
8151             current-middle     not bound   move current entry to middle of page
8152             current-top        not bound   move current entry to top of page
8153             enter-command              :   enter a muttngrc command
8154             exit                       q   exit this menu
8155             first-entry                =   move to the first entry
8156             half-down                  ]   scroll down 1/2 page
8157             half-up                    [   scroll up 1/2 page
8158             help                       ?   this screen
8159             jump                  number   jump to an index number
8160             last-entry                 *   move to the last entry
8161             middle-page                M   move to the middle of the page
8162             next-entry                 j   move to the next entry
8163             next-line                  >   scroll down one line
8164             next-page                  z   move to the next page
8165             previous-entry             k   move to the previous entry
8166             previous-line              <   scroll up one line
8167             previous-page              Z   move to the previous page
8168             refresh                   ^L   clear and redraw the screen
8169             search                     /   search for a regular expression
8170             search-next                n   search for next match
8171             search-opposite    not bound   search for next match in opposite direction
8172             search-reverse         ESC /   search backwards for a regular expression
8173             select-entry             RET   select the current entry
8174             shell-escape               !   run a program in a subshell
8175             tag-entry                  t   toggle the tag on the current entry
8176             tag-prefix                 ;   apply next command to tagged entries
8177             tag-prefix-cond    not bound   apply next function ONLY to tagged messages
8178             top-page                   H   move to the top of the page
8179             what-key           not bound   display the keycode for a key press
8180
8181        _\b6_\b._\b4_\b._\b2  _\bi_\bn_\bd_\be_\bx
8182
8183        The Mutt-ng E-Mail Client                                                   150
8184
8185             bounce-message             b   remail a message to another user
8186             change-folder              c   open a different folder
8187             change-folder-readonly ESC c   open a different folder in read only mode
8188             check-traditional-pgp  ESC P   check for classic pgp
8189             clear-flag                 W   clear a status flag from a message
8190             copy-message               C   copy a message to a file/mailbox
8191             create-alias               a   create an alias from a message sender
8192             decode-copy            ESC C   decode a message and copy it to a file/mailbox
8193             decode-save            ESC s   decode a message and save it to a file/mailbox
8194             delete-message             d   delete the current entry
8195             delete-pattern             D   delete messages matching a pattern
8196             delete-subthread       ESC d   delete all messages in subthread
8197             delete-thread             ^D   delete all messages in thread
8198             display-address            @   display full address of sender
8199             display-toggle-weed        h   display message and toggle header weeding
8200             display-message          RET   display a message
8201             edit                       e   edit the current message
8202             edit-type                 ^E   edit the current message's Content-Type
8203             exit                       x   exit without saving changes
8204             extract-keys              ^K   extract PGP public keys
8205             fetch-mail                 G   retrieve mail from POP server
8206             flag-message               F   toggle a message's 'important' flag
8207             forget-passphrase         ^F   wipe PGP passphrase from memory
8208             forward-message            f   forward a message with comments
8209             group-reply                g   reply to all recipients
8210             limit                      l   show only messages matching a pattern
8211             list-reply                 L   reply to specified mailing list
8212             mail                       m   compose a new mail message
8213             mail-key               ESC k   mail a PGP public key
8214             next-new                 TAB   jump to the next new message
8215             next-subthread         ESC n   jump to the next subthread
8216             next-thread               ^N   jump to the next thread
8217             next-undeleted             j   move to the next undeleted message
8218             next-unread        not bound   jump to the next unread message
8219             parent-message             P   jump to parent message in thread
8220             pipe-message               |   pipe message/attachment to a shell command
8221             previous-new         ESC TAB   jump to the previous new message
8222             previous-page              Z   move to the previous page
8223             previous-subthread     ESC p   jump to previous subthread
8224             previous-thread           ^P   jump to previous thread
8225             previous-undeleted         k   move to the last undelete message
8226             previous-unread    not bound   jump to the previous unread message
8227             print-message              p   print the current entry
8228             query                      Q   query external program for addresses
8229             quit                       q   save changes to mailbox and quit
8230             read-subthread         ESC r   mark the current subthread as read
8231             read-thread               ^R   mark the current thread as read
8232             recall-message             R   recall a postponed message
8233             reply                      r   reply to a message
8234             resend-message         ESC e   resend message and preserve MIME structure
8235             save-message               s   save message/attachment to a file
8236             set-flag                   w   set a status flag on a message
8237             show-version               V   show the Mutt-ng version number and date
8238             show-limit             ESC l   show currently active limit pattern, if any
8239
8240        The Mutt-ng E-Mail Client                                                   151
8241
8242             sort-mailbox               o   sort messages
8243             sort-reverse               O   sort messages in reverse order
8244             sync-mailbox               $   save changes to mailbox
8245             tag-pattern                T   tag messages matching a pattern
8246             tag-thread             ESC t   tag/untag all messages in the current thread
8247             toggle-new                 N   toggle a message's 'new' flag
8248             toggle-write               %   toggle whether the mailbox will be rewritten
8249             undelete-message           u   undelete the current entry
8250             undelete-pattern           U   undelete messages matching a pattern
8251             undelete-subthread     ESC u   undelete all messages in subthread
8252             undelete-thread           ^U   undelete all messages in thread
8253             untag-pattern             ^T   untag messages matching a pattern
8254             view-attachments           v   show MIME attachments
8255
8256        _\b6_\b._\b4_\b._\b3  _\bp_\ba_\bg_\be_\br
8257
8258        The Mutt-ng E-Mail Client                                                   152
8259
8260             bottom             not bound   jump to the bottom of the message
8261             bounce-message             b   remail a message to another user
8262             change-folder              c   open a different folder
8263             change-folder-readonly ESC c   open a different folder in read only mode
8264             check-traditional-pgp  ESC P   check for classic pgp
8265             copy-message               C   copy a message to a file/mailbox
8266             create-alias               a   create an alias from a message sender
8267             decode-copy            ESC C   decode a message and copy it to a file/mailbox
8268             decode-save            ESC s   decode a message and save it to a file/mailbox
8269             delete-message             d   delete the current entry
8270             delete-subthread       ESC d   delete all messages in subthread
8271             delete-thread             ^D   delete all messages in thread
8272             display-address            @   display full address of sender
8273             display-toggle-weed        h   display message and toggle header weeding
8274             edit                       e   edit the current message
8275             edit-type                 ^E   edit the current message's Content-Type
8276             enter-command              :   enter a muttngrc command
8277             exit                       i   return to the main-menu
8278             extract-keys              ^K   extract PGP public keys
8279             flag-message               F   toggle a message's 'important' flag
8280             forget-passphrase         ^F   wipe PGP passphrase from memory
8281             forward-message            f   forward a message with comments
8282             group-reply                g   reply to all recipients
8283             half-up            not bound   move up one-half page
8284             half-down          not bound   move down one-half page
8285             help                       ?   this screen
8286             list-reply                 L   reply to specified mailing list
8287             mail                       m   compose a new mail message
8288             mail-key               ESC k   mail a PGP public key
8289             mark-as-new                N   toggle a message's 'new' flag
8290             next-line                RET   scroll down one line
8291             next-entry                 J   move to the next entry
8292             next-new                 TAB   jump to the next new message
8293             next-page                      move to the next page
8294             next-subthread         ESC n   jump to the next subthread
8295             next-thread               ^N   jump to the next thread
8296             next-undeleted             j   move to the next undeleted message
8297             next-unread        not bound   jump to the next unread message
8298             parent-message             P   jump to parent message in thread
8299             pipe-message               |   pipe message/attachment to a shell command
8300             previous-line      BackSpace   scroll up one line
8301             previous-entry             K   move to the previous entry
8302             previous-new       not bound   jump to the previous new message
8303             previous-page              -   move to the previous page
8304             previous-subthread     ESC p   jump to previous subthread
8305             previous-thread           ^P   jump to previous thread
8306             previous-undeleted         k   move to the last undelete message
8307             previous-unread    not bound   jump to the previous unread message
8308             print-message              p   print the current entry
8309             quit                       Q   save changes to mailbox and quit
8310             read-subthread         ESC r   mark the current subthread as read
8311             read-thread               ^R   mark the current thread as read
8312             recall-message             R   recall a postponed message
8313             redraw-screen             ^L   clear and redraw the screen
8314
8315        The Mutt-ng E-Mail Client                                                   153
8316
8317             reply                      r   reply to a message
8318             save-message               s   save message/attachment to a file
8319             search                     /   search for a regular expression
8320             search-next                n   search for next match
8321             search-opposite    not bound   search for next match in opposite direction
8322             search-reverse         ESC /   search backwards for a regular expression
8323             search-toggle              \   toggle search pattern coloring
8324             shell-escape               !   invoke a command in a subshell
8325             show-version               V   show the Mutt-ng version number and date
8326             skip-quoted                S   skip beyond quoted text
8327             sync-mailbox               $   save changes to mailbox
8328             tag-message                t   tag a message
8329             toggle-quoted              T   toggle display of quoted text
8330             top                        ^   jump to the top of the message
8331             undelete-message           u   undelete the current entry
8332             undelete-subthread     ESC u   undelete all messages in subthread
8333             undelete-thread           ^U   undelete all messages in thread
8334             view-attachments           v   show MIME attachments
8335
8336        _\b6_\b._\b4_\b._\b4  _\ba_\bl_\bi_\ba_\bs
8337
8338             search                     /   search for a regular expression
8339             search-next                n   search for next match
8340             search-reverse         ESC /   search backwards for a regular expression
8341
8342        _\b6_\b._\b4_\b._\b5  _\bq_\bu_\be_\br_\by
8343
8344             create-alias               a   create an alias from a message sender
8345             mail                       m   compose a new mail message
8346             query                      Q   query external program for addresses
8347             query-append               A   append new query results to current results
8348             search                     /   search for a regular expression
8349             search-next                n   search for next match
8350             search-opposite    not bound   search for next match in opposite direction
8351             search-reverse         ESC /   search backwards for a regular expression
8352
8353        _\b6_\b._\b4_\b._\b6  _\ba_\bt_\bt_\ba_\bc_\bh
8354
8355        The Mutt-ng E-Mail Client                                                   154
8356
8357             bounce-message             b   remail a message to another user
8358             collapse-parts             v   toggle display of subparts
8359             delete-entry               d   delete the current entry
8360             display-toggle-weed        h   display message and toggle header weeding
8361             edit-type                 ^E   edit the current entry's Content-Type
8362             extract-keys              ^K   extract PGP public keys
8363             forward-message            f   forward a message with comments
8364             group-reply                g   reply to all recipients
8365             list-reply                 L   reply to specified mailing list
8366             pipe-entry                 |   pipe message/attachment to a shell command
8367             print-entry                p   print the current entry
8368             reply                      r   reply to a message
8369             resend-message         ESC e   resend message and preserve MIME structure
8370             save-entry                 s   save message/attachment to a file
8371             undelete-entry             u   undelete the current entry
8372             view-attach              RET   view attachment using mailcap entry if necessary
8373             view-mailcap               m   force viewing of attachment using mailcap
8374             view-text                  T   view attachment as text
8375
8376        _\b6_\b._\b4_\b._\b7  _\bc_\bo_\bm_\bp_\bo_\bs_\be
8377
8378        The Mutt-ng E-Mail Client                                                   155
8379
8380             attach-file                a   attach a file(s) to this message
8381             attach-message             A   attach message(s) to this message
8382             attach-key             ESC k   attach a PGP public key
8383             copy-file                  C   save message/attachment to a file
8384             detach-file                D   delete the current entry
8385             display-toggle-weed        h   display message and toggle header weeding
8386             edit-bcc                   b   edit the BCC list
8387             edit-cc                    c   edit the CC list
8388             edit-description           d   edit attachment description
8389             edit-encoding             ^E   edit attachment transfer-encoding
8390             edit-fcc                   f   enter a file to save a copy of this message in
8391             edit-from              ESC f   edit the from: field
8392             edit-file               ^X e   edit the file to be attached
8393             edit-headers               E   edit the message with headers
8394             edit                       e   edit the message
8395             edit-mime                  m   edit attachment using mailcap entry
8396             edit-reply-to              r   edit the Reply-To field
8397             edit-subject               s   edit the subject of this message
8398             edit-to                    t   edit the TO list
8399             edit-type                 ^T   edit attachment type
8400             filter-entry               F   filter attachment through a shell command
8401             forget-passphrase         ^F   wipe PGP passphrase from memory
8402             ispell                     i   run ispell on the message
8403             new-mime                   n   compose new attachment using mailcap entry
8404             pgp-menu                   p   show PGP options
8405             pipe-entry                 |   pipe message/attachment to a shell command
8406             postpone-message           P   save this message to send later
8407             print-entry                l   print the current entry
8408             rename-file                R   rename/move an attached file
8409             send-message               y   send the message
8410             toggle-unlink              u   toggle whether to delete file after sending it
8411             view-attach              RET   view attachment using mailcap entry if necessary
8412             write-fcc         w   write the message to a folder
8413
8414        _\b6_\b._\b4_\b._\b8  _\bp_\bo_\bs_\bt_\bp_\bo_\bn_\be
8415
8416             delete-entry               d   delete the current entry
8417             undelete-entry             u   undelete the current entry
8418
8419        _\b6_\b._\b4_\b._\b9  _\bb_\br_\bo_\bw_\bs_\be_\br
8420
8421        The Mutt-ng E-Mail Client                                                   156
8422
8423             change-dir                 c   change directories
8424             check-new                TAB   check mailboxes for new mail
8425             enter-mask                 m   enter a file mask
8426             search                     /   search for a regular expression
8427             search-next                n   search for next match
8428             search-reverse         ESC /   search backwards for a regular expression
8429             select-new                 N   select a new file in this directory
8430             sort                       o   sort messages
8431             sort-reverse               O   sort messages in reverse order
8432             toggle-mailboxes         TAB   toggle whether to browse mailboxes or all files
8433             view-file              SPACE   view file
8434             subscribe                  s   subscribe to current mailbox (IMAP Only)
8435             unsubscribe                u   unsubscribe to current mailbox (IMAP Only)
8436             toggle-subscribed          T   toggle view all/subscribed mailboxes (IMAP Only)
8437
8438        _\b6_\b._\b4_\b._\b1_\b0  _\bp_\bg_\bp
8439
8440             view-name                  %   view the key's user id
8441             verify-key                 c   verify a PGP public key
8442
8443        _\b6_\b._\b4_\b._\b1_\b1  _\be_\bd_\bi_\bt_\bo_\br
8444
8445             backspace          BackSpace   delete the char in front of the cursor
8446             backward-char             ^B   move the cursor one character to the left
8447             backward-word          ESC b   move the cursor to the previous word
8448             bol                       ^A   jump to the beginning of the line
8449             buffy-cycle            Space   cycle among incoming mailboxes
8450             capitalize-word        ESC c   uppercase the first character in the word
8451             complete                 TAB   complete filename or alias
8452             complete-query            ^T   complete address with query
8453             delete-char               ^D   delete the char under the cursor
8454             downcase-word          ESC l   lowercase all characters in current word
8455             eol                       ^E   jump to the end of the line
8456             forward-char              ^F   move the cursor one character to the right
8457             forward-word           ESC f   move the cursor to the next word
8458             history-down       not bound   scroll down through the history list
8459             history-up         not bound   scroll up through the history list
8460             kill-eol                  ^K   delete chars from cursor to end of line
8461             kill-eow               ESC d   delete chars from cursor to end of word
8462             kill-line                 ^U   delete all chars on the line
8463             kill-word                 ^W   delete the word in front of the cursor
8464             quote-char                ^V   quote the next typed key
8465             transpose-chars    not bound   transpose character under cursor with previous
8466             upcase-word            ESC u   uppercase all characters in current word
8467
8468        _\b7_\b.  _\bM_\bi_\bs_\bc_\be_\bl_\bl_\ba_\bn_\by
8469
8470        The Mutt-ng E-Mail Client                                                   157
8471
8472        _\b7_\b._\b1  _\bA_\bc_\bk_\bn_\bo_\bw_\bl_\be_\bd_\bg_\bm_\be_\bn_\bt_\bs
8473
8474        Kari Hurtta <kari.hurtta@fmi.fi> co-developed the original MIME parsing code
8475        back in the ELM-ME days.
8476
8477        The following people have been very helpful to the development of Mutt:
8478
8479        Vikas Agnihotri <vikasa@writeme.com>,
8480
8481        Francois Berjon <Francois.Berjon@aar.alcatel-alsthom.fr>,
8482
8483        Aric Blumer <aric@fore.com>,
8484
8485        John Capo <jc@irbs.com>,
8486
8487        David Champion <dgc@uchicago.edu,
8488
8489        Brendan Cully <brendan@kublai.com>,
8490
8491        Liviu Daia <daia@stoilow.imar.ro>,
8492
8493        Thomas E. Dickey <dickey@herndon4.his.com>,
8494
8495        David DeSimone <fox@convex.hp.com>,
8496
8497        Nickolay N. Dudorov <nnd@wint.itfs.nsk.su>,
8498
8499        Ruslan Ermilov <ru@freebsd.org>,
8500
8501        Edmund Grimley Evans <edmundo@rano.org,
8502
8503        Michael Finken <finken@conware.de>,
8504
8505        Sven Guckes <guckes@math.fu-berlin.de>,
8506
8507        Lars Hecking <lhecking@nmrc.ie>,
8508
8509        Mark Holloman <holloman@nando.net>,
8510
8511        Andreas Holzmann <holzmann@fmi.uni-passau.de>,
8512
8513        Marco d'Itri <md@linux.it>,
8514
8515        Bjoern Jacke <bjacke@suse.com>,
8516
8517        Byrial Jensen <byrial@image.dk>,
8518
8519        David Jeske <jeske@igcom.net>,
8520
8521        Christophe Kalt <kalt@hugo.int-evry.fr>,
8522
8523        Tommi Komulainen <Tommi.Komulainen@iki.fi>,
8524
8525        Felix von Leitner (a.k.a ``Fefe'') <leitner@math.fu-berlin.de>,
8526
8527        The Mutt-ng E-Mail Client                                                   158
8528
8529        Brandon Long <blong@fiction.net>,
8530
8531        Jimmy Maekelae <jmy@flashback.net>,
8532
8533        Lars Marowsky-Bree <lmb@pointer.in-minden.de>,
8534
8535        Thomas ``Mike'' Michlmayr <mike@cosy.sbg.ac.at>,
8536
8537        Andrew W. Nosenko <awn@bcs.zp.ua>,
8538
8539        David O'Brien <obrien@Nuxi.cs.ucdavis.edu>,
8540
8541        Clint Olsen <olsenc@ichips.intel.com>,
8542
8543        Park Myeong Seok <pms@romance.kaist.ac.kr>,
8544
8545        Thomas Parmelan <tom@ankh.fr.eu.org>,
8546
8547        Ollivier Robert <roberto@keltia.freenix.fr>,
8548
8549        Thomas Roessler <roessler@does-not-exist.org>,
8550
8551        Roland Rosenfeld <roland@spinnaker.de>,
8552
8553        TAKIZAWA Takashi <taki@luna.email.ne.jp>,
8554
8555        Allain Thivillon <Allain.Thivillon@alma.fr>,
8556
8557        Gero Treuner <gero@faveve.uni-stuttgart.de>,
8558
8559        Vsevolod Volkov <vvv@lucky.net>,
8560
8561        Ken Weinert <kenw@ihs.com>
8562
8563        Mutt-ng is developed by the following people:
8564
8565        Andreas Krennmair <ak@synflood.at>
8566
8567        Nico Golde <nico@ngolde.de>
8568
8569        Rocco Rutte <pdmef@cs.tu-berlin.de>
8570
8571        The following people have been very helpful to the development of  Mutt-ng:
8572
8573        Iain Lea <iain@bricbrac.de>
8574
8575        Andreas Kneib <akneib@gmx.net>
8576
8577        Carsten Schoelzki <cjs@weisshuhn.de>
8578
8579        Elimar Riesebieter <riesebie@lxtec.de>
8580
8581        _\b7_\b._\b2  _\bA_\bb_\bo_\bu_\bt _\bt_\bh_\bi_\bs _\bd_\bo_\bc_\bu_\bm_\be_\bn_\bt
8582
8583        The Mutt-ng E-Mail Client                                                   159
8584
8585        This document was written in SGML, and then rendered using the sgml-tools pack-
8586        age.
8587
8588        The Mutt-ng E-Mail Client                                                   160
8589
8590                                           CONTENTS
8591
8592        1.  Introduction ............................................................ 1
8593            1.1   Mutt-ng Home Page ................................................. 1
8594            1.2   Mailing Lists ..................................................... 1
8595            1.3   Software Distribution Sites ....................................... 1
8596            1.4   IRC ............................................................... 2
8597            1.5   Weblog ............................................................ 2
8598            1.6   Copyright ......................................................... 2
8599
8600        2.  Getting Started ......................................................... 2
8601            2.1   Moving Around in Menus ............................................ 2
8602            2.2   Editing Input Fields .............................................. 3
8603            2.3   Reading Mail - The Index and Pager ................................ 3
8604            2.4   Sending Mail ...................................................... 9
8605            2.5   Forwarding and Bouncing Mail ..................................... 13
8606            2.6   Postponing Mail .................................................. 14
8607            2.7   Reading news via NNTP ............................................ 14
8608
8609        3.  Configuration .......................................................... 14
8610            3.1   Syntax of Initialization Files ................................... 15
8611            3.2   Defining/Using aliases ........................................... 16
8612            3.3   Changing the default key bindings ................................ 17
8613            3.4   Defining aliases for character sets  ............................. 19
8614            3.5   Setting variables based upon mailbox ............................. 19
8615            3.6   Keyboard macros .................................................. 20
8616            3.7   Using color and mono video attributes ............................ 21
8617            3.8   Ignoring (weeding) unwanted message headers ...................... 23
8618            3.9   Alternative addresses ............................................ 24
8619            3.10  Mailing lists .................................................... 24
8620            3.11  Using Multiple spool mailboxes ................................... 25
8621            3.12  Defining mailboxes which receive mail ............................ 25
8622            3.13  User defined headers ............................................. 26
8623            3.14  Defining the order of headers when viewing messages .............. 26
8624            3.15  Specify default save filename .................................... 27
8625            3.16  Specify default Fcc: mailbox when composing ...................... 27
8626            3.17  Specify default save filename and default Fcc: mailbox at once ... 27
8627            3.18  Change settings based upon message recipients .................... 27
8628            3.19  Change settings before formatting a message ...................... 28
8629            3.20  Choosing the cryptographic key of the recipient .................. 29
8630            3.21  Adding key sequences to the keyboard buffer ...................... 29
8631            3.22  Executing functions .............................................. 29
8632            3.23  Message Scoring .................................................. 29
8633            3.24  Spam detection ................................................... 30
8634            3.25  Setting variables ................................................ 31
8635            3.26  Reading initialization commands from another file ................ 32
8636            3.27  Configuring features conditionally ............................... 32
8637            3.28  Removing hooks ................................................... 33
8638
8639        4.  Advanced Usage ......................................................... 33
8640            4.1   Regular Expressions .............................................. 34
8641
8642                                               i
8643
8644            4.2   Patterns ......................................................... 37
8645            4.3   Using Tags ....................................................... 41
8646            4.4   Using Hooks ...................................................... 41
8647            4.5   Using the sidebar ................................................ 43
8648            4.6   External Address Queries ......................................... 43
8649            4.7   Mailbox Formats .................................................. 44
8650            4.8   Mailbox Shortcuts ................................................ 45
8651            4.9   Handling Mailing Lists ........................................... 45
8652            4.10  Editing threads .................................................. 47
8653            4.11  Delivery Status Notification (DSN) Support ....................... 47
8654            4.12  POP3 Support (OPTIONAL) .......................................... 47
8655            4.13  IMAP Support (OPTIONAL) .......................................... 48
8656            4.14  Managing multiple IMAP/POP accounts (OPTIONAL) ................... 50
8657            4.15  Start a WWW Browser on URLs (EXTERNAL) ........................... 50
8658            4.16  Compressed folders Support (OPTIONAL) ............................ 50
8659
8660        5.  Mutt-ng's MIME Support ................................................. 53
8661            5.1   Using MIME in Mutt ............................................... 53
8662            5.2   MIME Type configuration with mime.types .......................... 55
8663            5.3   MIME Viewer configuration with mailcap ........................... 55
8664            5.4   MIME Autoview .................................................... 61
8665            5.5   MIME Multipart/Alternative ....................................... 62
8666            5.6   MIME Lookup ...................................................... 62
8667
8668        6.  Reference .............................................................. 62
8669            6.1   Command line options ............................................. 62
8670            6.2   Configuration Commands ........................................... 63
8671            6.3   Configuration variables .......................................... 65
8672            6.4   Functions ....................................................... 149
8673
8674        7.  Miscellany ............................................................ 156
8675            7.1   Acknowledgments ................................................. 157
8676            7.2   About this document ............................................. 158
8677
8678                                               ii
8679