X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.txt;h=054e45bcdaa705ee4978d6707b77943b9d79ffa5;hb=ce5e12405904f419adf8b4b6d4465fb27274c08b;hp=57c25742b9460e7db6ccc5ae17bfc548051d0752;hpb=dc2c2ef1ba4d0a0f3c2552459b9f962594a3536b;p=apps%2Fmadmutt.git diff --git a/doc/manual.txt b/doc/manual.txt index 57c2574..054e45b 100644 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -123,7 +123,7 @@ complete complete filename or alias ^T complete-query complete address with query ^K kill-eol delete to the end of the line - ESC d kill-eow delete to the end ot the word + ESC d kill-eow delete to the end of the word ^W kill-word kill the word in front of the cursor ^U kill-line delete entire line ^V quote-char quote the next typed key @@ -317,7 +317,7 @@ _2_._3_._3 _T_h_r_e_a_d_e_d _M_o_d_e - When the mailbox is _s_o_r_t_e_d (section 6.3.288 , page 133) by _t_h_r_e_a_d_s, there are + When the mailbox is _s_o_r_t_e_d (section 6.3.288 , page 134) by _t_h_r_e_a_d_s, there are a few additional functions available in the _i_n_d_e_x and _p_a_g_e_r modes. ^D delete-thread delete all messages in the current thread @@ -425,7 +425,7 @@ match the regular expressions given by the _l_i_s_t_s _o_r _s_u_b_s_c_r_i_b_e (section 3.10 , page 24) commands, but also honor any Mail-Followup-To header(s) if the - _$_h_o_n_o_r___f_o_l_l_o_w_u_p___t_o (section 6.3.87 , page 84) configuration variable is set. + _$_h_o_n_o_r___f_o_l_l_o_w_u_p___t_o (section 6.3.87 , page 85) configuration variable is set. Using this when replying to messages posted to mailing lists helps avoid dupli- cate copies being sent to the author of the message you are replying to. @@ -434,7 +434,7 @@ Asks for an external Unix command and pipes the current or tagged message(s) to it. The variables _$_p_i_p_e___d_e_c_o_d_e (section 6.3.199 , page 113), _$_p_i_p_e___s_p_l_i_t - (section 6.3.201 , page 114), _$_p_i_p_e___s_e_p (section 6.3.200 , page 113) and + (section 6.3.201 , page 114), _$_p_i_p_e___s_e_p (section 6.3.200 , page 114) and _$_w_a_i_t___k_e_y (section 6.3.329 , page 145) control the exact behavior of this function. @@ -496,7 +496,7 @@ Mutt-ng will then enter the _c_o_m_p_o_s_e menu and prompt you for the recipients to place on the ``To:'' header field. Next, it will ask you for the ``Subject:'' field for the message, providing a default if you are replying to or forwarding - a message. See also _$_a_s_k_c_c (section 6.3.10 , page 66), _$_a_s_k_b_c_c (section + a message. See also _$_a_s_k_c_c (section 6.3.10 , page 67), _$_a_s_k_b_c_c (section 6.3.9 , page 66), _$_a_u_t_o_e_d_i_t (section 6.3.17 , page 69), _$_b_o_u_n_c_e (section 6.3.20 , page 69), and _$_f_a_s_t___r_e_p_l_y (section 6.3.59 , page 78) for changing how Mutt-ng asks these questions. @@ -506,7 +506,7 @@ is set, the headers will be at the top of the message in your editor. Any mes- sages you are replying to will be added in sort order to the message, with appropriate _$_a_t_t_r_i_b_u_t_i_o_n (section 6.3.15 , page 68), _$_i_n_d_e_n_t___s_t_r_i_n_g (section - 6.3.108 , page 89) and _$_p_o_s_t___i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.211 , page 116). + 6.3.108 , page 90) and _$_p_o_s_t___i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.211 , page 116). When forwarding a message, if the _$_m_i_m_e___f_o_r_w_a_r_d (section 6.3.135 , page 97) variable is unset, a copy of the forwarded message will be included. If you have specified a _$_s_i_g_n_a_t_u_r_e (section 6.3.258 , page 127), it will be appended @@ -597,7 +597,7 @@ encrypted using the selected public keys, and sent out. Most fields of the entries in the key selection menu (see also _$_p_g_p___e_n_t_r_y___f_o_r_- - _m_a_t (section 6.3.178 , page 108)) have obvious meanings. But some explana- + _m_a_t (section 6.3.178 , page 109)) have obvious meanings. But some explana- tions on the capabilities, flags, and validity fields are in order. The flags sequence (%f) will expand to one of the following flags: @@ -698,7 +698,7 @@ At times it is desirable to delay sending a message that you have already begun to compose. When the _p_o_s_t_p_o_n_e_-_m_e_s_s_a_g_e function is used in the _c_o_m_p_o_s_e menu, the body of your message and attachments are stored in the mailbox specified by - the _$_p_o_s_t_p_o_n_e_d (section 6.3.213 , page 116) variable. This means that you can + the _$_p_o_s_t_p_o_n_e_d (section 6.3.213 , page 117) variable. This means that you can recall the message even if you exit Mutt-ng and then restart it at a later time. @@ -721,9 +721,9 @@ newsserver via NNTP. You can open a newsgroup with function ``change-news- group'' (default: i). Default newsserver can be obtained from _N_N_T_P_S_E_R_V_E_R envi- ronment variable. Like other news readers, info about subscribed newsgroups is - saved in file by _$_n_e_w_s_r_c (section , page ) variable. Article headers are - cached and can be loaded from file when newsgroup entered instead loading from - newsserver. + saved in file by _$_n_n_t_p___n_e_w_s_r_c (section 6.3.155 , page 103) variable. Article + headers are cached and can be loaded from file when newsgroup entered instead + loading from newsserver. _3_. _C_o_n_f_i_g_u_r_a_t_i_o_n @@ -1010,7 +1010,7 @@ folder-hook's, they are executed in the order given in the muttrc. NNoottee:: if you use the ``!'' shortcut for _$_s_p_o_o_l_f_i_l_e (section 6.3.294 , page - 135) at the beginning of the pattern, you must place it inside of double or + 136) at the beginning of the pattern, you must place it inside of double or single quotes in order to distinguish it from the logical _n_o_t operator for the expression. @@ -1337,7 +1337,7 @@ The Mutt-ng E-Mail Client 26 - 6.3.294 , page 135)) should be executed before the mailboxes command. + 6.3.294 , page 136)) should be executed before the mailboxes command. _3_._1_3 _U_s_e_r _d_e_f_i_n_e_d _h_e_a_d_e_r_s @@ -1651,7 +1651,7 @@ Usage: reset _v_a_r_i_a_b_l_e [_v_a_r_i_a_b_l_e ... ] This command is used to set (and unset) _c_o_n_f_i_g_u_r_a_t_i_o_n _v_a_r_i_a_b_l_e_s (section 6.3 , - page 64). There are four basic types of variables: boolean, number, string and + page 65). There are four basic types of variables: boolean, number, string and quadoption. _b_o_o_l_e_a_n variables can be _s_e_t (true) or _u_n_s_e_t (false). _n_u_m_b_e_r variables can be assigned a positive integer value. @@ -1712,26 +1712,30 @@ _3_._2_7 _C_o_n_f_i_g_u_r_i_n_g _f_e_a_t_u_r_e_s _c_o_n_d_i_t_i_o_n_a_l_l_y - Usage: ifdef _i_t_e_m _c_o_m_m_a_n_d Usage: ifndef _i_t_e_m _c_o_m_m_a_n_d + Usage: ifdef _i_t_e_m _c_o_m_m_a_n_d - These command allows to test if a variable, function or certain feature is - available or not respectively, before actually executing the command. ifdef - (short for ``if defined) handles commands if upon availability while ifndef + Usage: ifndef _i_t_e_m _c_o_m_m_a_n_d + + These commands allow testing for a variable, function or certain feature being The Mutt-ng E-Mail Client 33 - (short for ``if not defined'') does if not. The _c_o_m_m_a_n_d may be any valid frac- - tion of a configuration file. + available or not respectively, before actually executing the command given. + + ifdef (short for ``if defined'') only executes the command upon availability + while ifndef (short for ``if not defined'') does if not. The _c_o_m_m_a_n_d may be any + valid fraction of a configuration file. - All names of variables and functions may be tested. Additionally, the following - compile-features may be tested when prefixed with 'feature_': ncurses, slang, - iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, gnutls, sasl, sasl2, - libesmtp, compressed, color, classic_pgp, classic_smime, gpgme, header_cache. + All names of variables, functions and menus may be tested. Additionally, the + following compile-features may be tested when prefixed with 'feature_': + ncurses, slang, iconv, idn, dotlock, standalone, pop, nntp, imap, ssl, gnutls, + sasl, sasl2, libesmtp, compressed, color, classic_pgp, classic_smime, gpgme, + header_cache, gdbm, qdbm and db4. Examples follow. - To only source a file with IMAP related settings only if IMAP support is com- - piled in, use: + To only source a file with IMAP related settings if IMAP support is compiled + in, use: ifdef feature_imap 'source ~/.mutt-ng/imap_setup' # or @@ -1747,10 +1751,10 @@ # or # ... - To only set the _<_$_i_m_a_p___m_a_i_l___c_h_e_c_k (section 6.3.98 , page 87) when the system's - SVN is recent enough to have it: + To only set the _$_i_m_a_p___m_a_i_l___c_h_e_c_k (section 6.3.98 , page 87) variable if the + system's mutt-ng is aware of it, use: - ifdef imap_mail_check 'set imap_mail_check=300' + ifdef imap_mail_check 'set imap_mail_check=500' _3_._2_8 _R_e_m_o_v_i_n_g _h_o_o_k_s @@ -1765,14 +1769,15 @@ _4_._1 _R_e_g_u_l_a_r _E_x_p_r_e_s_s_i_o_n_s - All string patterns in Mutt-ng including those in more complex _p_a_t_t_e_r_n_s (sec- - tion 4.2 , page 36) must be specified using regular expressions (regexp) in - the ``POSIX extended'' syntax (which is more or less the syntax used by egrep - and GNU awk). For your convenience, we have included below a brief description - of this syntax. + All string patterns in Mutt-ng including those in more complex _p_a_t_t_e_r_n_s The Mutt-ng E-Mail Client 34 + (section 4.2 , page 36) must be specified using regular expressions (regexp) + in the ``POSIX extended'' syntax (which is more or less the syntax used by + egrep and GNU awk). For your convenience, we have included below a brief + description of this syntax. + The search is case sensitive if the pattern contains at least one upper case letter, and case insensitive otherwise. Note that ``\'' must be quoted if used for a regular expression in an initialization command: ``\\''. @@ -1822,15 +1827,14 @@ [:cntrl:] Control characters. + The Mutt-ng E-Mail Client 35 + [:digit:] Numeric characters. [:graph:] - Characters that are both printable and visible. (A space is - - The Mutt-ng E-Mail Client 35 - - printable, but not visible, while an ``a'' is both.) + Characters that are both printable and visible. (A space is print- + able, but not visible, while an ``a'' is both.) [:lower:] Lower-case alphabetic characters. @@ -1880,11 +1884,11 @@ ? The preceding item is optional and matched at most once. + The Mutt-ng E-Mail Client 36 + * The preceding item will be matched zero or more times. - The Mutt-ng E-Mail Client 36 - + The preceding item will be matched one or more times. @@ -1935,11 +1939,11 @@ \\W Matches any character that is not word-constituent. + The Mutt-ng E-Mail Client 37 + \\` Matches the empty string at the beginning of a buffer (string). - The Mutt-ng E-Mail Client 37 - \\' Matches the empty string at the end of a buffer. @@ -2050,7 +2054,7 @@ '~s "^Junk +From +Me$" ~f ("Jim +Somebody"|"Ed +SomeoneElse")' - Note that if a regular expression contains parenthesis, or a veritical bar + Note that if a regular expression contains parenthesis, or a vertical bar ("|"), you mmuusstt enclose the expression in double or single quotes since those characters are also used to separate different parts of Mutt-ng's pattern lan- guage. For example, @@ -2341,7 +2345,7 @@ These shortcuts can be used anywhere you are prompted for a file or mailbox path. - +o ! -- refers to your _$_s_p_o_o_l_f_i_l_e (section 6.3.294 , page 135) (incoming) + +o ! -- refers to your _$_s_p_o_o_l_f_i_l_e (section 6.3.294 , page 136) (incoming) mailbox +o > -- refers to your _$_m_b_o_x (section 6.3.123 , page 95) file @@ -2400,7 +2404,7 @@ Conversely, when group-replying or list-replying to a message which has a Mail- Followup-To header, mutt will respect this header if the _$_h_o_n_o_r___f_o_l_l_o_w_u_p___t_o - (section 6.3.87 , page 84) configuration variable is set. Using list-reply + (section 6.3.87 , page 85) configuration variable is set. Using list-reply will in this case also make sure that the reply goes to the mailing list, even if it's not specified in the list of recipients in the Mail-Followup-To. @@ -2429,7 +2433,7 @@ The Mutt-ng E-Mail Client 47 - Lastly, Mutt-ng has the ability to _s_o_r_t (section 6.3.288 , page 133) the mail- + Lastly, Mutt-ng has the ability to _s_o_r_t (section 6.3.288 , page 134) the mail- box into _t_h_r_e_a_d_s (section 2.3.3 , page 7). A thread is a group of messages which all relate to the same subject. This is usually organized into a tree- like structure where a message and all of its replies are represented graphi- @@ -2497,8 +2501,8 @@ Polling for new mail is more expensive over POP3 than locally. For this reason the frequency at which Mutt-ng will check for mail remotely can be controlled - by the _$_p_o_p___c_h_e_c_k_i_n_t_e_r_v_a_l (section , page ) variable, which defaults to every - 60 seconds. + by the _$_p_o_p___m_a_i_l___c_h_e_c_k (section 6.3.207 , page 115) variable, which defaults + to every 60 seconds. If Mutt-ng was compiled with SSL support (by running the _c_o_n_f_i_g_u_r_e script with the _-_-_w_i_t_h_-_s_s_l flag), connections to POP3 servers can be encrypted. This natu- @@ -2508,7 +2512,7 @@ Another way to access your POP3 mail is the _f_e_t_c_h_-_m_a_i_l function (default: G). It allows to connect to _p_o_p___h_o_s_t (section 6.3.205 , page 115), fetch all your - new mail and place it in the local _s_p_o_o_l_f_i_l_e (section 6.3.294 , page 135). + new mail and place it in the local _s_p_o_o_l_f_i_l_e (section 6.3.294 , page 136). After this point, Mutt-ng runs exactly as if the mail had always been local. NNoottee:: If you only need to fetch all messages to local mailbox you should con- @@ -2612,7 +2616,7 @@ tors. This is overridden by an explicit username in the mailbox path (i.e. by using a mailbox name of the form {user@host}). - +o _$_i_m_a_p___p_a_s_s (section 6.3.99 , page 87) - a password which you may preset, + +o _$_i_m_a_p___p_a_s_s (section 6.3.99 , page 88) - a password which you may preset, used by all authentication methods where a password is needed. +o _$_i_m_a_p___a_u_t_h_e_n_t_i_c_a_t_o_r_s (section 6.3.90 , page 85) - a colon-delimited list @@ -2683,7 +2687,7 @@ compressed. This is important because it allows the use of programs that do not have well defined extensions. Just use '.' as a regexp. But this may be sur- prising if your compressing script produces empty files. In this situation, - unset _$_s_a_v_e___e_m_p_t_y (section 6.3.239 , page 122), so that the compressed file + unset _$_s_a_v_e___e_m_p_t_y (section 6.3.239 , page 123), so that the compressed file will be removed if you delete all of the messages. _4_._1_6_._1 _O_p_e_n _a _c_o_m_p_r_e_s_s_e_d _m_a_i_l_b_o_x _f_o_r _r_e_a_d_i_n_g @@ -2994,7 +2998,7 @@ The interpretation of shell meta-characters embedded in MIME parameters can lead to security problems in general. Mutt-ng tries to quote parameters in expansion of %s syntaxes properly, and avoids risky characters by substituting - them, see the _m_a_i_l_c_a_p___s_a_n_i_t_i_z_e (section 6.3.116 , page 93) variable. + them, see the _m_a_i_l_c_a_p___s_a_n_i_t_i_z_e (section 6.3.116 , page 94) variable. Although mutt's procedures to invoke programs with mailcap seem to be safe, there are other applications parsing mailcap, maybe taking less care of it. @@ -3306,6 +3310,7 @@ -a attach a file to a message -b specify a blind carbon-copy (BCC) address -c specify a carbon-copy (Cc) address + -D print the value of all variables on stdout -e specify a config command to be run after initialization files are read -f specify a mailbox to load -F specify an alternate file to read initialization commands @@ -3348,10 +3353,10 @@ +o _a_c_c_o_u_n_t_-_h_o_o_k (section 4.14 , page 49) _p_a_t_t_e_r_n _c_o_m_m_a_n_d - +o _a_l_i_a_s (section 3.2 , page 16) _k_e_y _a_d_d_r_e_s_s [ , _a_d_d_r_e_s_s, ... ] - The Mutt-ng E-Mail Client 64 + +o _a_l_i_a_s (section 3.2 , page 16) _k_e_y _a_d_d_r_e_s_s [ , _a_d_d_r_e_s_s, ... ] + +o _u_n_a_l_i_a_s (section 3.2 , page 16) [ * | _k_e_y ... ] +o _a_l_t_e_r_n_a_t_e_s (section 3.9 , page 23) _r_e_g_e_x_p [ _r_e_g_e_x_p ... ] @@ -3404,10 +3409,10 @@ +o _m_a_i_l_b_o_x_e_s (section 3.12 , page 25) _f_i_l_e_n_a_m_e [ _f_i_l_e_n_a_m_e ... ] - +o _m_b_o_x_-_h_o_o_k (section 3.11 , page 25) _p_a_t_t_e_r_n _m_a_i_l_b_o_x - The Mutt-ng E-Mail Client 65 + +o _m_b_o_x_-_h_o_o_k (section 3.11 , page 25) _p_a_t_t_e_r_n _m_a_i_l_b_o_x + +o _m_e_s_s_a_g_e_-_h_o_o_k (section 3.19 , page 28) _p_a_t_t_e_r_n _c_o_m_m_a_n_d +o _m_i_m_e___l_o_o_k_u_p (section 5.6 , page 61) _m_i_m_e_t_y_p_e [ _m_i_m_e_t_y_p_e ... ] @@ -3460,10 +3465,10 @@ _6_._3 _C_o_n_f_i_g_u_r_a_t_i_o_n _v_a_r_i_a_b_l_e_s - _6_._3_._1 _a_b_o_r_t___n_o_s_u_b_j_e_c_t - The Mutt-ng E-Mail Client 66 + _6_._3_._1 _a_b_o_r_t___n_o_s_u_b_j_e_c_t + Type: quadoption Default: ask-yes @@ -3515,11 +3520,11 @@ %r address which alias expands to + The Mutt-ng E-Mail Client 67 + %t character which indicates if the alias is tagged for inclusion - The Mutt-ng E-Mail Client 67 - _6_._3_._5 _a_l_l_o_w___8_b_i_t Type: boolean @@ -3571,12 +3576,12 @@ If _s_e_t, Mutt-ng will prompt you for blind-carbon-copy (Bcc) recipients before editing an outgoing message. + The Mutt-ng E-Mail Client 68 + _6_._3_._1_0 _a_s_k_c_c Type: boolean - The Mutt-ng E-Mail Client 68 - Default: no If _s_e_t, Mutt-ng will prompt you for carbon-copy (Cc) recipients before editing @@ -3628,11 +3633,11 @@ %f filename + The Mutt-ng E-Mail Client 69 + %I MIME Content-Disposition: header field (I=inline, A=attachment) - The Mutt-ng E-Mail Client 69 - %m major MIME type @@ -3685,10 +3690,10 @@ Type: string - Default: 'On %d, %n wrote:' - The Mutt-ng E-Mail Client 70 + Default: 'On %d, %n wrote:' + This is the string that will precede a message which has been included in a reply. For a full listing of defined printf(3)-like sequences see the section on ``_$_i_n_d_e_x___f_o_r_m_a_t (section 6.3.109 , page 90)''. @@ -3741,11 +3746,10 @@ Default: ask-yes - Controls whether you will be asked to confirm bouncing messages. If set to _y_e_s - you don't get asked if you want to bounce a message. Setting this variable to - The Mutt-ng E-Mail Client 71 + Controls whether you will be asked to confirm bouncing messages. If set to _y_e_s + you don't get asked if you want to bounce a message. Setting this variable to _n_o is not generally useful, and thus not recommended, because you are unable to bounce messages. @@ -3797,12 +3801,12 @@ Character set your terminal uses to display and enter textual data. + The Mutt-ng E-Mail Client 72 + _6_._3_._2_5 _c_h_e_c_k___n_e_w Type: boolean - The Mutt-ng E-Mail Client 72 - Default: yes NNoottee:: this option only affects _m_a_i_l_d_i_r and _M_H style mailboxes. @@ -3854,10 +3858,10 @@ Default: '' - When defined, Mutt-ng will recode commands in rc files from this encoding. - The Mutt-ng E-Mail Client 73 + When defined, Mutt-ng will recode commands in rc files from this encoding. + _6_._3_._2_9 _c_o_n_f_i_r_m_a_p_p_e_n_d Type: boolean @@ -3910,10 +3914,10 @@ Type: boolean - Default: no - The Mutt-ng E-Mail Client 74 + Default: no + Setting this variable will cause Mutt-ng to always attempt to PGP encrypt out- going messages. This is probably only useful in connection to the _s_e_n_d_-_h_o_o_k command. It can be overridden by use of the _p_g_p_-_m_e_n_u, when encryption is not @@ -3932,7 +3936,7 @@ encryption/signing for messages. See also ``_$_c_r_y_p_t___a_u_t_o_e_n_c_r_y_p_t (section 6.3.34 , page 72)'', ``_$_c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t (section 6.3.38 , page 73)'', ``_$_c_r_y_p_t___a_u_t_o_s_i_g_n (section 6.3.36 , page 73)'', ``_$_c_r_y_p_t___r_e_p_l_y_s_i_g_n (section - 6.3.39 , page 73)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.3.276 , page 131)''. + 6.3.39 , page 74)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.3.276 , page 131)''. _6_._3_._3_6 _c_r_y_p_t___a_u_t_o_s_i_g_n @@ -3957,7 +3961,7 @@ encryption/signing for messages. See also ``_$_c_r_y_p_t___a_u_t_o_e_n_c_r_y_p_t (section 6.3.34 , page 72)'', ``_$_c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t (section 6.3.38 , page 73)'', ``_$_c_r_y_p_t___a_u_t_o_s_i_g_n (section 6.3.36 , page 73)'', ``_$_c_r_y_p_t___r_e_p_l_y_s_i_g_n (section - 6.3.39 , page 73)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.3.276 , page 131)''. + 6.3.39 , page 74)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.3.276 , page 131)''. _6_._3_._3_8 _c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t @@ -3966,10 +3970,11 @@ Default: yes If _s_e_t, automatically PGP or OpenSSL encrypt replies to messages which are - encrypted. (Crypto only) The Mutt-ng E-Mail Client 75 + encrypted. (Crypto only) + _6_._3_._3_9 _c_r_y_p_t___r_e_p_l_y_s_i_g_n Type: boolean @@ -3991,7 +3996,7 @@ encrypted. This makes sense in combination with ``_$_c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t (section 6.3.38 , page 73)'', because it allows you to sign all messages which are automatically encrypted. This works around the problem noted in - ``_$_c_r_y_p_t___r_e_p_l_y_s_i_g_n (section 6.3.39 , page 73)'', that Mutt-ng is not able to + ``_$_c_r_y_p_t___r_e_p_l_y_s_i_g_n (section 6.3.39 , page 74)'', that Mutt-ng is not able to find out whether an encrypted message is also signed. (Crypto only) _6_._3_._4_1 _c_r_y_p_t___t_i_m_e_s_t_a_m_p @@ -4022,10 +4027,10 @@ Type: quadoption - Default: yes - The Mutt-ng E-Mail Client 76 + Default: yes + If ``_y_e_s'', always attempt to verify PGP or S/MIME signatures. If ``_a_s_k'', ask whether or not to verify the signature. If ``_n_o'', never attempt to verify cryptographic signatures. (Crypto only) @@ -4078,11 +4083,10 @@ Default: yes - If this option is _s_e_t, Mutt-ng will untag messages when marking them for dele- - tion. This applies when you either explicitly delete a message, or when you - The Mutt-ng E-Mail Client 77 + If this option is _s_e_t, Mutt-ng will untag messages when marking them for dele- + tion. This applies when you either explicitly delete a message, or when you save it to another folder. _6_._3_._4_8 _d_i_g_e_s_t___c_o_l_l_a_p_s_e @@ -4136,10 +4140,10 @@ Type: string - Default: '' - The Mutt-ng E-Mail Client 78 + Default: '' + NNoottee:: you should not enable this unless you are using Sendmail 8.8.x or greater. @@ -4192,10 +4196,10 @@ _6_._3_._5_7 _e_n_v_e_l_o_p_e___f_r_o_m - Type: boolean - The Mutt-ng E-Mail Client 79 + Type: boolean + Default: no When _s_e_t, Mutt-ng will try to derive the message's _e_n_v_e_l_o_p_e sender from the @@ -4249,10 +4253,9 @@ Default: '' - This variable is a colon-separated list of character encoding schemes for text - The Mutt-ng E-Mail Client 80 + This variable is a colon-separated list of character encoding schemes for text file attatchments. If _u_n_s_e_t, _$_c_h_a_r_s_e_t (section 6.3.24 , page 70) value will be used instead. For example, the following configuration would work for Japanese text handling: @@ -4305,11 +4308,11 @@ %N N if folder has new mail, blank otherwise + The Mutt-ng E-Mail Client 81 + %s size in bytes - The Mutt-ng E-Mail Client 81 - %t * if the file is tagged, blank otherwise @@ -4362,11 +4365,10 @@ Default: no - This variable is similar to ``_$_s_a_v_e___n_a_m_e (section 6.3.240 , page 123)'', - except that Mutt-ng will store a copy of your outgoing message by the username - The Mutt-ng E-Mail Client 82 + This variable is similar to ``_$_s_a_v_e___n_a_m_e (section 6.3.240 , page 123)'', + except that Mutt-ng will store a copy of your outgoing message by the username of the address you are sending to even if that mailbox does not exist. Also see the ``_$_r_e_c_o_r_d (section 6.3.229 , page 120)'' variable. @@ -4419,12 +4421,11 @@ Default: no - When _s_e_t forwarded messages included in the main body of the message (when - ``_$_m_i_m_e___f_o_r_w_a_r_d (section 6.3.135 , page 97)'' is _u_n_s_e_t) will be quoted using - The Mutt-ng E-Mail Client 83 - ``_$_i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.108 , page 89)''. + When _s_e_t forwarded messages included in the main body of the message (when + ``_$_m_i_m_e___f_o_r_w_a_r_d (section 6.3.135 , page 97)'' is _u_n_s_e_t) will be quoted using + ``_$_i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.108 , page 90)''. _6_._3_._7_3 _f_r_o_m @@ -4434,7 +4435,7 @@ This variable contains a default from address. It can be overridden using my_hdr (including from send-hooks) and ``_$_r_e_v_e_r_s_e___n_a_m_e (section 6.3.235 , page - 121)''. This variable is ignored if ``_$_u_s_e___f_r_o_m (section 6.3.324 , page + 122)''. This variable is ignored if ``_$_u_s_e___f_r_o_m (section 6.3.324 , page 144)'' is unset. E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar @@ -4476,10 +4477,10 @@ Type: boolean - Default: no - The Mutt-ng E-Mail Client 84 + Default: no + When _s_e_t, this variable causes Mutt-ng to include the header of the message you are replying to into the edit buffer. The ``_$_w_e_e_d (section 6.3.330 , page 145)'' setting applies. @@ -4492,12 +4493,12 @@ Availability: Header Cache - The _$_h_e_a_d_e_r___c_a_c_h_e (section 6.3.77 , page 82) variable points to the header + The _$_h_e_a_d_e_r___c_a_c_h_e (section 6.3.77 , page 83) variable points to the header cache database. - If _$_h_e_a_d_e_r___c_a_c_h_e (section 6.3.77 , page 82) points to a directory it will con- + If _$_h_e_a_d_e_r___c_a_c_h_e (section 6.3.77 , page 83) points to a directory it will con- tain a header cache database per folder. If _$_h_e_a_d_e_r___c_a_c_h_e (section 6.3.77 , - page 82) points to a file that file will be a single global header cache. By + page 83) points to a file that file will be a single global header cache. By default it is _u_n_s_e_t so no header caching will be used. _6_._3_._7_8 _h_e_a_d_e_r___c_a_c_h_e___c_o_m_p_r_e_s_s @@ -4532,11 +4533,11 @@ Default: no When _s_e_t, Mutt-ng will skip the host name part of ``_$_h_o_s_t_n_a_m_e (section - 6.3.88 , page 85)'' variable when adding the domain part to addresses. This - variable does not affect the generation of Message-ID: header fields, and it The Mutt-ng E-Mail Client 85 + 6.3.88 , page 85)'' variable when adding the domain part to addresses. This + variable does not affect the generation of Message-ID: header fields, and it will not lead to the cut-off of first-level domains. _6_._3_._8_1 _h_i_d_e___l_i_m_i_t_e_d @@ -4584,16 +4585,16 @@ When _s_e_t, Mutt-ng will not show the presence of missing messages at the top of threads in the thread tree. Note that when _$_h_i_d_e___l_i_m_i_t_e_d (section 6.3.81 , - page 83) is _s_e_t, this option will have no effect. + page 84) is _s_e_t, this option will have no effect. _6_._3_._8_6 _h_i_s_t_o_r_y Type: number - Default: 10 - The Mutt-ng E-Mail Client 86 + Default: 10 + This variable controls the size (in number of strings remembered) of the string history buffer. The buffer is cleared each time the variable is changed. @@ -4646,11 +4647,11 @@ capability string, e.g. ``digest-md5'', ``gssapi'' or ``cram-md5''. This param- eter is case-insensitive. + The Mutt-ng E-Mail Client 87 + If this parameter is _u_n_s_e_t (the default) Mutt-ng will try all available meth- ods, in order from most-secure to least-secure. - The Mutt-ng E-Mail Client 87 - Example: set imap_authenticators='gssapi:cram-md5:login' NNoottee:: Mutt-ng will only fall back to other authentication methods if the previ- @@ -4703,11 +4704,10 @@ Availability: IMAP - You normally want to see your personal folders alongside your INBOX in the IMAP - browser. If you see something else, you may set this variable to the IMAP path - The Mutt-ng E-Mail Client 88 + You normally want to see your personal folders alongside your INBOX in the IMAP + browser. If you see something else, you may set this variable to the IMAP path to your folders. _6_._3_._9_5 _i_m_a_p___k_e_e_p_a_l_i_v_e @@ -4760,11 +4760,10 @@ Default: 300 - This variable configures how often (in seconds) Mutt-ng should look for new - mail in IMAP folders. This is split from the ``_m_a_i_l___c_h_e_c_k (section 6.3.114 , - The Mutt-ng E-Mail Client 89 + This variable configures how often (in seconds) Mutt-ng should look for new + mail in IMAP folders. This is split from the ``_m_a_i_l___c_h_e_c_k (section 6.3.114 , page 93)'' variable to generate less traffic and get more accurate information for local folders. @@ -4817,11 +4816,11 @@ Availability: IMAP + The Mutt-ng E-Mail Client 90 + Controls whether or not Mutt-ng will try to reconnect to IMAP server when the connection is lost. - The Mutt-ng E-Mail Client 90 - _6_._3_._1_0_3 _i_m_a_p___s_e_r_v_e_r_n_o_i_s_e Type: boolean @@ -4873,11 +4872,11 @@ Default: no + The Mutt-ng E-Mail Client 91 + Controls whether or not Mutt-ng includes only the first attachment of the mes- sage you are replying. - The Mutt-ng E-Mail Client 91 - _6_._3_._1_0_8 _i_n_d_e_n_t___s_t_r_i_n_g Type: string @@ -4928,11 +4927,11 @@ date and time of the message in the format specified by ``date_for- mat'' converted to the local time zone + The Mutt-ng E-Mail Client 92 + %e current message number in thread - The Mutt-ng E-Mail Client 92 - %E number of messages in current thread @@ -4985,11 +4984,10 @@ %t `to:' field (recipients) - %T - the appropriate character from the _$_t_o___c_h_a_r_s (section 6.3.317 , - The Mutt-ng E-Mail Client 93 + %T + the appropriate character from the _$_t_o___c_h_a_r_s (section 6.3.317 , page 142) string %u @@ -5042,10 +5040,10 @@ _6_._3_._1_1_0 _i_s_p_e_l_l - Type: path - The Mutt-ng E-Mail Client 94 + Type: path + Default: 'ispell' How to invoke ispell (GNU's spell-checking software). @@ -5098,10 +5096,11 @@ Default: '' This variable specifies which files to consult when attempting to display MIME - bodies not directly supported by Mutt-ng. The Mutt-ng E-Mail Client 95 + bodies not directly supported by Mutt-ng. + _6_._3_._1_1_6 _m_a_i_l_c_a_p___s_a_n_i_t_i_z_e Type: boolean @@ -5153,12 +5152,12 @@ up with an 'O' next to them in the ``index'' menu, indicating that they are old. + The Mutt-ng E-Mail Client 96 + _6_._3_._1_2_0 _m_a_r_k_e_r_s Type: boolean - The Mutt-ng E-Mail Client 96 - Default: yes Controls the display of wrapped lines in the internal pager. If set, a ``+'' @@ -5184,7 +5183,7 @@ When _s_e_t, the maximum line length for displaying ``format = flowed'' messages is limited to this length. A value of 0 (which is also the default) means that the maximum line length is determined by the terminal width and _$_w_r_a_p_m_a_r_g_i_n - (section 6.3.332 , page 145). + (section 6.3.332 , page 146). _6_._3_._1_2_3 _m_b_o_x @@ -5193,7 +5192,7 @@ Default: '~/mbox' This specifies the folder into which read mail in your ``_$_s_p_o_o_l_f_i_l_e (section - 6.3.294 , page 135)'' folder will be appended. + 6.3.294 , page 136)'' folder will be appended. _6_._3_._1_2_4 _m_b_o_x___t_y_p_e @@ -5210,12 +5209,12 @@ Default: 0 + The Mutt-ng E-Mail Client 97 + This variable controls the number of lines of context that are given when scrolling through menus. (Similar to ``_$_p_a_g_e_r___c_o_n_t_e_x_t (section 6.3.166 , page 106)''.) - The Mutt-ng E-Mail Client 97 - _6_._3_._1_2_6 _m_e_n_u___m_o_v_e___o_f_f Type: boolean @@ -5266,11 +5265,11 @@ Default: no + The Mutt-ng E-Mail Client 98 + If _u_n_s_e_t, Mutt-ng will remove your address (see the ``alternates'' command) from the list of recipients when replying to a message. - The Mutt-ng E-Mail Client 98 - _6_._3_._1_3_1 _m_h___p_u_r_g_e Type: boolean @@ -5321,12 +5320,12 @@ Also see ``_$_f_o_r_w_a_r_d___d_e_c_o_d_e (section 6.3.68 , page 81)'' and ``_$_m_i_m_e___f_o_r_- _w_a_r_d___d_e_c_o_d_e (section 6.3.136 , page 97)''. + The Mutt-ng E-Mail Client 99 + _6_._3_._1_3_6 _m_i_m_e___f_o_r_w_a_r_d___d_e_c_o_d_e Type: boolean - The Mutt-ng E-Mail Client 99 - Default: no Controls the decoding of complex MIME messages into text/plain when forwarding @@ -5378,12 +5377,12 @@ used with various sets of parameters to gather the list of known remailers, and to finally send a message through the mixmaster chain. + The Mutt-ng E-Mail Client 100 + _6_._3_._1_4_0 _m_o_v_e Type: quadoption - The Mutt-ng E-Mail Client 100 - Default: ask-no Controls whether or not Mutt-ng will move read messages from your spool mailbox @@ -5435,11 +5434,11 @@ %T the current UNIX timestamp (decimal) + The Mutt-ng E-Mail Client 101 + %X the current UNIX timestamp (hexadecimal) - The Mutt-ng E-Mail Client 101 - %Y the current year (Y2K compliant) @@ -5492,11 +5491,11 @@ ers. If _u_n_s_e_t, headers will not be saved at all and will be reloaded each time when you enter a newsgroup. + The Mutt-ng E-Mail Client 102 + As for the header caching in connection with IMAP and/or Maildir, this drasti- cally increases speed and lowers traffic. - The Mutt-ng E-Mail Client 102 - _6_._3_._1_4_6 _n_n_t_p___c_a_t_c_h_u_p Type: quadoption @@ -5517,8 +5516,8 @@ Availability: NNTP This variable controls how many news articles to cache per newsgroup (if - caching is enabled, see _$_n_e_w_s___c_a_c_h_e___d_i_r (section , page )) and how many news - articles to show in the ``index'' menu. + caching is enabled, see _$_n_n_t_p___c_a_c_h_e___d_i_r (section 6.3.145 , page 100)) and how + many news articles to show in the ``index'' menu. If there're more articles than defined with _$_n_n_t_p___c_o_n_t_e_x_t (section 6.3.147 , page 101), all older ones will be removed/not shown in the index. @@ -6247,7 +6246,7 @@ of tagged messages Mutt-ng will concatenate the messages and will pipe them as a single folder. When _s_e_t, Mutt-ng will pipe the messages one by one. In both cases the messages are piped in the current sorted order, and the ``_$_p_i_p_e___s_e_p - (section 6.3.200 , page 113)'' separator is added after each message. + (section 6.3.200 , page 114)'' separator is added after each message. _6_._3_._2_0_2 _p_o_p___a_u_t_h___t_r_y___a_l_l @@ -6391,7 +6390,7 @@ The Mutt-ng E-Mail Client 118 Controls whether or not messages are saved in the ``_$_p_o_s_t_p_o_n_e_d (section - 6.3.213 , page 116)'' mailbox when you elect not to send immediately. + 6.3.213 , page 117)'' mailbox when you elect not to send immediately. _6_._3_._2_1_3 _p_o_s_t_p_o_n_e_d @@ -6514,7 +6513,7 @@ Default: yes Controls whether or not empty lines will be quoted using ``_i_n_d_e_n_t___s_t_r_i_n_g (sec- - tion 6.3.108 , page 89)''. + tion 6.3.108 , page 90)''. _6_._3_._2_2_3 _q_u_o_t_e___q_u_o_t_e_d @@ -6524,7 +6523,7 @@ Controls how quoted lines will be quoted. If _s_e_t, one quote character will be added to the end of existing prefix. Otherwise, quoted lines will be prepended - by ``_i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.108 , page 89)''. + by ``_i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.108 , page 90)''. _6_._3_._2_2_4 _q_u_o_t_e___r_e_g_e_x_p @@ -6577,7 +6576,7 @@ By default, this is the GECOS field from /etc/passwd. _N_o_t_e_: This variable will _n_o_t be used when the user has set a real name in the - _$_f_r_o_m (section 6.3.73 , page 81) variable. + _$_f_r_o_m (section 6.3.73 , page 82) variable. _6_._3_._2_2_8 _r_e_c_a_l_l @@ -6586,7 +6585,7 @@ Default: ask-yes Controls whether or not Mutt-ng recalls postponed messages when composing a new - message. Also see ``_$_p_o_s_t_p_o_n_e_d (section 6.3.213 , page 116)''. + message. Also see ``_$_p_o_s_t_p_o_n_e_d (section 6.3.213 , page 117)''. Setting this variable to _y_e_s is not generally useful, and thus not recommended. @@ -6697,10 +6696,10 @@ Default: yes This variable fine-tunes the behaviour of the _r_e_v_e_r_s_e___n_a_m_e (section 6.3.235 , - page 121) feature. When it is _s_e_t, Mutt-ng will use the address from incoming + page 122) feature. When it is _s_e_t, Mutt-ng will use the address from incoming messages as-is, possibly including eventual real names. When it is _u_n_s_e_t, Mutt-ng will override any such real names with the setting of the _r_e_a_l_n_a_m_e - (section 6.3.227 , page 119) variable. + (section 6.3.227 , page 120) variable. _6_._3_._2_3_7 _r_f_c_2_0_4_7___p_a_r_a_m_e_t_e_r_s @@ -6744,7 +6743,7 @@ Default: yes When _u_n_s_e_t, mailboxes which contain no saved messages will be removed when - closed (the exception is ``_$_s_p_o_o_l_f_i_l_e (section 6.3.294 , page 135)'' which is + closed (the exception is ``_$_s_p_o_o_l_f_i_l_e (section 6.3.294 , page 136)'' which is never removed). If _s_e_t, mailboxes are never removed. NNoottee:: This only applies to mbox and MMDF folders, Mutt-ng does not delete MH @@ -7120,9 +7119,9 @@ %C CA location: Depending on whether _$_s_m_i_m_e___c_a___l_o_c_a_t_i_o_n (section - 6.3.265 , page 128) points to a directory or file, this expands to - '-CApath _$_s_m_i_m_e___c_a___l_o_c_a_t_i_o_n (section 6.3.265 , page 128)' or - '-CAfile _$_s_m_i_m_e___c_a___l_o_c_a_t_i_o_n (section 6.3.265 , page 128)'. + 6.3.265 , page 129) points to a directory or file, this expands to + '-CApath _$_s_m_i_m_e___c_a___l_o_c_a_t_i_o_n (section 6.3.265 , page 129)' or + '-CAfile _$_s_m_i_m_e___c_a___l_o_c_a_t_i_o_n (section 6.3.265 , page 129)'. The Mutt-ng E-Mail Client 131 @@ -7392,7 +7391,7 @@ When sorting by threads, this variable controls how threads are sorted in rela- tion to other threads, and how the branches of the thread trees are sorted. - This can be set to any value that ``_$_s_o_r_t (section 6.3.288 , page 133)'' can, + This can be set to any value that ``_$_s_o_r_t (section 6.3.288 , page 134)'' can, except threads (in that case, Mutt-ng will just use date-sent). You can also specify the ``last-'' prefix in addition to ``reverse-'' prefix, but last- must come after reverse-. The last- prefix causes messages to be sorted against its @@ -7406,7 +7405,7 @@ first, if you have set sort=reverse-threads.) - NNoottee:: For reversed ``_$_s_o_r_t (section 6.3.288 , page 133)'' order _$_s_o_r_t___a_u_x + NNoottee:: For reversed ``_$_s_o_r_t (section 6.3.288 , page 134)'' order _$_s_o_r_t___a_u_x (section 6.3.290 , page 134) is reversed again (which is not the right thing to do, but kept to not break any existing configuration setting). @@ -7618,7 +7617,7 @@ to _$_s_t_a_t_u_s___c_h_a_r_s (section 6.3.301 , page 137) %s - current sorting mode (_$_s_o_r_t (section 6.3.288 , page 133)) + current sorting mode (_$_s_o_r_t (section 6.3.288 , page 134)) %S current aux sorting method (_$_s_o_r_t___a_u_x (section 6.3.290 , page @@ -7728,7 +7727,7 @@ Default: no If _s_e_t, threading will only make use of the ``In-Reply-To:'' and ``Refer- - ences:'' header fields when you ``_$_s_o_r_t (section 6.3.288 , page 133)'' by mes- + ences:'' header fields when you ``_$_s_o_r_t (section 6.3.288 , page 134)'' by mes- sage threads. By default, messages with the same subject are grouped together in ``pseudo threads.'' This may not always be desirable, such as in a personal mailbox where you might have several unrelated messages with the subject ``hi'' @@ -7753,7 +7752,7 @@ Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$' - When non-empty and _$_s_t_r_i_p___w_a_s (section 6.3.307 , page 140) is _s_e_t, mutt-ng + When non-empty and _$_s_t_r_i_p___w_a_s (section 6.3.307 , page 141) is _s_e_t, mutt-ng will remove this trailing part of the ``Subject'' line when replying if it won't be empty afterwards. @@ -7787,7 +7786,7 @@ like ordinary text. To actually make use of this format's features, you'll need support in your editor. - Note that _$_i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.108 , page 89) is ignored when this + Note that _$_i_n_d_e_n_t___s_t_r_i_n_g (section 6.3.108 , page 90) is ignored when this option is set. _6_._3_._3_1_2 _t_h_o_r_o_u_g_h___s_e_a_r_c_h @@ -8060,7 +8059,7 @@ Default: 'M%?n?AIL&ail?' Controls the format of the X11 icon title, as long as _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (sec- - tion 6.3.337 , page 146) is _s_e_t. This string is identical in formatting to the + tion 6.3.337 , page 147) is _s_e_t. This string is identical in formatting to the one used by ``_$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.3.302 , page 137)''. _6_._3_._3_3_6 _x_t_e_r_m___l_e_a_v_e @@ -8069,17 +8068,17 @@ Default: '' - If _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (section 6.3.337 , page 146) is _s_e_t, this string will be + If _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (section 6.3.337 , page 147) is _s_e_t, this string will be used to set the title when leaving mutt-ng. For terminal-based programs, there's no easy and portable way to read the current title so mutt-ng cannot read it upon startup and restore it when exiting. - Based on the xterm FAQ, the following might work: set xterm_leave = '`test + Based on the xterm FAQ, the following might work: The Mutt-ng E-Mail Client 148 - x_D_I_S_P_L_A_Y (section , page ) != x && xprop -id _W_I_N_D_O_W_I_D (section , page ) | grep - WM_NAME | cut -d ''' -f 2`' + set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME | + cut -d ''' -f 2`' _6_._3_._3_3_7 _x_t_e_r_m___s_e_t___t_i_t_l_e_s @@ -8098,7 +8097,7 @@ Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?' Controls the format of the title bar of the xterm provided that - _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (section 6.3.337 , page 146) has been _s_e_t. This string is + _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (section 6.3.337 , page 147) has been _s_e_t. This string is identical in formatting to the one used by ``_$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.3.302 , page 137)''. @@ -8446,7 +8445,7 @@ Kari Hurtta co-developed the original MIME parsing code back in the ELM-ME days. - The following people have been very helpful to the development of Mutt-ng: + The following people have been very helpful to the development of Mutt: Vikas Agnihotri , @@ -8530,15 +8529,34 @@ Vsevolod Volkov , - Ken Weinert Andreas Krennmair Nico Golde - Rocco Rutte + Ken Weinert + + Mutt-ng is developed by the following people: + + Andreas Krennmair + + Nico Golde + + Rocco Rutte + + The following people have been very helpful to the development of Mutt-ng: + + Iain Lea + + Andreas Kneib + + Carsten Schoelzki + + Elimar Riesebieter _7_._2 _A_b_o_u_t _t_h_i_s _d_o_c_u_m_e_n_t + The Mutt-ng E-Mail Client 159 + This document was written in SGML, and then rendered using the sgml-tools pack- age. - The Mutt-ng E-Mail Client 159 + The Mutt-ng E-Mail Client 160 CONTENTS