X-Git-Url: http://git.madism.org/?a=blobdiff_plain;f=doc%2Fmanual.txt;h=2482bb2a8ccb6eef7a83949050ba06568d2be601;hb=ba4333b5854d2caf6b486372b060376990fe089e;hp=47b941a3c98bfa55cce0bae2fe728e9941598923;hpb=11dfc0aa39e31496da16c708f972a6718dd7ee5c;p=apps%2Fmadmutt.git diff --git a/doc/manual.txt b/doc/manual.txt index 47b941a..2482bb2 100644 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -4,7 +4,7 @@ by Andreas Krennmair and others originally based on _m_u_t_t by Michael Elkins and others - version devel + version devel-r394 AAbbssttrraacctt @@ -413,7 +413,7 @@ +o cclleeaarr--ffllaagg (default: W) Furthermore, the following flags reflect who the message is addressed to. They - can be customized with the _$_t_o___c_h_a_r_s (section 6.4.320 , page 158) variable. + can be customized with the _$_t_o___c_h_a_r_s (section 6.4.322 , page 159) variable. + message is to you and you only @@ -497,7 +497,7 @@ _2_._5_._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.4.289 , page 149) by _t_h_r_e_a_d_s, there are + When the mailbox is _s_o_r_t_e_d (section 6.4.290 , page 149) 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 @@ -522,7 +522,7 @@ _$_i_n_d_e_x___f_o_r_m_a_t (section 6.4.110 , page 105) to optionally display the number of hidden messages if the thread is collapsed. - See also: _$_s_t_r_i_c_t___t_h_r_e_a_d_s (section 6.4.309 , page 156). + See also: _$_s_t_r_i_c_t___t_h_r_e_a_d_s (section 6.4.311 , page 157). _2_._5_._4 _M_i_s_c_e_l_l_a_n_e_o_u_s _F_u_n_c_t_i_o_n_s @@ -570,7 +570,7 @@ This command is used to temporarily edit an attachment's content type to fix, for instance, bogus character set parameters. When invoked from the index or from the pager, you'll have the opportunity to edit the top-level attachment's - content type. On the _a_t_t_a_c_h_m_e_n_t _m_e_n_u (section 5.1.2 , page 66), you can + content type. On the _a_t_t_a_c_h_m_e_n_t _m_e_n_u (section 5.1.2 , page 67), you can change any attachment's content type. These changes are not persistent, and get lost upon changing folders. @@ -615,7 +615,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.4.200 , page 129), _$_p_i_p_e___s_p_l_i_t (section 6.4.202 , page 129), _$_p_i_p_e___s_e_p (section 6.4.201 , page 129) and - _$_w_a_i_t___k_e_y (section 6.4.332 , page 161) control the exact behavior of this + _$_w_a_i_t___k_e_y (section 6.4.334 , page 161) control the exact behavior of this function. rreesseenndd--mmeessssaaggee @@ -625,7 +625,7 @@ message. This function is best described as "recall from arbitrary folders". It can conveniently be used to forward MIME messages while preserving the orig- inal mail structure. Note that the amount of headers included here depends on - the value of the _$_w_e_e_d (section 6.4.333 , page 161) variable. + the value of the _$_w_e_e_d (section 6.4.335 , page 162) variable. This function is also available from the attachment menu. You can use this to easily resend a message which was included with a bounce message as a mes- @@ -635,7 +635,7 @@ (default: !) Asks for an external Unix command and executes it. The _$_w_a_i_t___k_e_y (section - 6.4.332 , page 161) can be used to control whether Mutt-ng will wait for a key + 6.4.334 , page 161) can be used to control whether Mutt-ng will wait for a key to be pressed when the command returns (presumably to let the user read the output of the command), based on the return status of the named command. @@ -755,7 +755,7 @@ sages from. You can now tag messages in that folder and they will be attached to the message you are sending. Note that certain operations like composing a new mail, replying, forwarding, etc. are not permitted when you are in that - folder. The %r in _$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.4.305 , page 153) will change to a + folder. The %r in _$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.4.307 , page 154) will change to a 'A' to indicate that you are in attach-message mode. The Mutt Next Generation E-Mail Client 16 @@ -1269,7 +1269,7 @@ _k_e_y does not need to be enclosed in quotes unless it contains a space (`` ''). _f_u_n_c_t_i_o_n specifies which action to take when _k_e_y is pressed. For a complete - list of functions, see the _r_e_f_e_r_e_n_c_e (section 6.5 , page 163). The special + list of functions, see the _r_e_f_e_r_e_n_c_e (section 6.5 , page 164). The special function noop unbinds the specified key sequence. _3_._5 _D_e_f_i_n_i_n_g _a_l_i_a_s_e_s _f_o_r _c_h_a_r_a_c_t_e_r _s_e_t_s @@ -1299,7 +1299,7 @@ mailboxes to execute _c_o_m_m_a_n_d before loading. If a mailbox matches multiple 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.4.295 , page + NNoottee:: if you use the ``!'' shortcut for _$_s_p_o_o_l_f_i_l_e (section 6.4.296 , page 151) 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. @@ -1336,7 +1336,7 @@ invoke a function directly, you can use the format _<_k_e_y _n_a_m_e_> and _<_f_u_n_c_t_i_o_n _n_a_m_e_>. For a listing of key names see the section on _k_e_y _b_i_n_d_i_n_g_s (section 3.4 , page 24). Functions are listed in the _f_u_n_c_t_i_o_n _r_e_f_e_r_e_n_c_e (section - 6.5 , page 163). + 6.5 , page 164). The advantage with using function names directly is that the macros will work regardless of the current key bindings, so they are not dependent on the user @@ -1689,7 +1689,7 @@ executed, so if these names contain _s_h_o_r_t_c_u_t _c_h_a_r_a_c_t_e_r_s (section 4.9 , page 56) (such as ``='' and ``!''), any variable definition that affect these char- acters (like _$_f_o_l_d_e_r (section 6.4.64 , page 94) and _$_s_p_o_o_l_f_i_l_e (section - 6.4.295 , page 151)) should be executed before the mailboxes command. + 6.4.296 , page 151)) should be executed before the mailboxes command. _3_._1_5 _U_s_e_r _d_e_f_i_n_e_d _h_e_a_d_e_r_s @@ -1823,7 +1823,7 @@ Example: send-hook mutt 'set mime_forward signature=''' Another typical use for this command is to change the values of the _$_a_t_t_r_i_b_u_- - _t_i_o_n (section 6.4.15 , page 84), _$_s_i_g_n_a_t_u_r_e (section 6.4.259 , page 142) and + _t_i_o_n (section 6.4.15 , page 84), _$_s_i_g_n_a_t_u_r_e (section 6.4.259 , page 143) and _$_l_o_c_a_l_e (section 6.4.114 , page 108) variables in order to change the language of the attributions and signatures based upon the recipients. @@ -1882,7 +1882,7 @@ Usage: exec _f_u_n_c_t_i_o_n [ _f_u_n_c_t_i_o_n ... ] This command can be used to execute any function. Functions are listed in the - _f_u_n_c_t_i_o_n _r_e_f_e_r_e_n_c_e (section 6.5 , page 163). ``exec function'' is equivalent + _f_u_n_c_t_i_o_n _r_e_f_e_r_e_n_c_e (section 6.5 , page 164). ``exec function'' is equivalent to ``push ''. _3_._2_5 _M_e_s_s_a_g_e _S_c_o_r_i_n_g @@ -2498,7 +2498,7 @@ +o the current mutt-ng version number The setting for the status bar of the index is controlled via the _$_s_t_a_t_u_s___f_o_r_- - _m_a_t (section 6.4.305 , page 153) variable. For the hostname and version + _m_a_t (section 6.4.307 , page 154) variable. For the hostname and version string, there's an expando for $status_format: %h expands to the hostname and %v to the version string. When just configuring: @@ -2835,10 +2835,10 @@ 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.4.295 , page 151) (incoming) + +o ! -- refers to your _$_s_p_o_o_l_f_i_l_e (section 6.4.296 , page 151) (incoming) mailbox - +o > -- refers to your _$_m_b_o_x (section 6.4.124 , page 111) file + +o > -- refers to your _$_m_b_o_x (section 6.4.124 , page 110) file +o < -- refers to your _$_r_e_c_o_r_d (section 6.4.230 , page 136) file @@ -2918,10 +2918,10 @@ _$_i_n_d_e_x___f_o_r_m_a_t (section 6.4.110 , page 105) variable's ``%y'' and ``%Y'' escapes can be used to expand ``X-Label:'' fields in the index, and Mutt-ng's pattern-matcher can match regular expressions to ``X-Label:'' fields with the - `` y'' selector. ``X-Label:'' is not a standard message header field, but it + ``~y'' selector. ``X-Label:'' is not a standard message header field, but it can easily be inserted by procmail and other mail filtering agents. - Lastly, Mutt-ng has the ability to _s_o_r_t (section 6.4.289 , page 149) the mail- + Lastly, Mutt-ng has the ability to _s_o_r_t (section 6.4.290 , page 149) the mail- box into _t_h_r_e_a_d_s (section 2.5.3 , page 11). 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 @@ -3004,7 +3004,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.4.206 , page 130), fetch all your - new mail and place it in the local _s_p_o_o_l_f_i_l_e (section 6.4.295 , page 151). + new mail and place it in the local _s_p_o_o_l_f_i_l_e (section 6.4.296 , page 151). 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- @@ -3052,7 +3052,7 @@ Polling for new mail on an IMAP server can cause noticeable delays. So, you'll want to carefully tune the _$_i_m_a_p___m_a_i_l___c_h_e_c_k (section 6.4.99 , page 103) and - _$_t_i_m_e_o_u_t (section 6.4.318 , page 158) variables. + _$_t_i_m_e_o_u_t (section 6.4.320 , page 159) variables. Note that if you are using mbox as the mail store on UW servers prior to v12.250, the server has been reported to disconnect a client if another client @@ -3166,10 +3166,33 @@ from people who they have defined an alias for so that those 2 groups of messages are excluded from the strict rules. - _4_._1_6 _M_a_n_a_g_i_n_g _m_u_l_t_i_p_l_e _I_M_A_P_/_P_O_P_/_N_N_T_P _a_c_c_o_u_n_t_s _(_O_P_T_I_O_N_A_L_) + _4_._1_6 _S_M_T_P _S_u_p_p_o_r_t _(_O_P_T_I_O_N_A_L_) + + Mutt-ng can be built using a library called ``libESMTP'' which provides SMTP + functionality. When configure was called with --with-libesmtp or the output + muttng -v contains +USE_LIBESMTP, this will be or is the case already. + + To enable sending mail directly via SMTP without an MTA such as Postfix or + SSMTP and the like, simply set the _$_s_m_t_p___h_o_s_t (section 6.4.285 , page 148) + variable pointing to your SMTP server. + + Authentication mechanisms are available via the _$_s_m_t_p___u_s_e_r (section 6.4.289 , + page 149) and _$_s_m_t_p___p_a_s_s (section 6.4.286 , page 148) variables. + + Transport Encryption via the StartTLS command is also available. For this to + work, first of all Mutt-ng must be built with SSL or GNUTLS. Secondly, the + _$_s_m_t_p___u_s_e___t_l_s (section 6.4.288 , page 149) variable must be either set to + ``enabled'' or ``required.'' In both cases, StartTLS will be used if the server + supports it: for the second case, the connection will fail if it doesn't while + switching back to unencrypted communication for the first one. + + _4_._1_7 _M_a_n_a_g_i_n_g _m_u_l_t_i_p_l_e _I_M_A_P_/_P_O_P_/_N_N_T_P _a_c_c_o_u_n_t_s _(_O_P_T_I_O_N_A_L_) If you happen to have accounts on multiple IMAP and/or POP servers, you may find managing all the authentication settings inconvenient and error-prone. + + The Mutt Next Generation E-Mail Client 64 + The account-hook command may help. This hook works like folder-hook but is invoked whenever you access a remote mailbox (including inside the folder browser), not just when you open the mailbox. @@ -3180,21 +3203,18 @@ account-hook imap://host1/ 'set imap_user=me1 imap_pass=foo' account-hook imap://host2/ 'set tunnel="ssh host2 /usr/libexec/imapd"' - _4_._1_7 _S_t_a_r_t _a _W_W_W _B_r_o_w_s_e_r _o_n _U_R_L_s _(_E_X_T_E_R_N_A_L_) + _4_._1_8 _S_t_a_r_t _a _W_W_W _B_r_o_w_s_e_r _o_n _U_R_L_s _(_E_X_T_E_R_N_A_L_) If a message contains URLs (_u_n_i_f_i_e_d _r_e_s_o_u_r_c_e _l_o_c_a_t_o_r = address in the WWW space like _h_t_t_p_:_/_/_w_w_w_._m_u_t_t_._o_r_g_/), it is efficient to get a menu with all the URLs and start a WWW browser on one of them. This functionality is provided by the - external urlview program which can be retrieved at - - The Mutt Next Generation E-Mail Client 64 - - ftp://ftp.mutt.org/mutt/contrib/ and the configuration commands: + external urlview program which can be retrieved at ftp://ftp.mutt.org/mutt/con- + trib/ and the configuration commands: macro index \cb |urlview\n macro pager \cb |urlview\n - _4_._1_8 _C_o_m_p_r_e_s_s_e_d _f_o_l_d_e_r_s _S_u_p_p_o_r_t _(_O_P_T_I_O_N_A_L_) + _4_._1_9 _C_o_m_p_r_e_s_s_e_d _f_o_l_d_e_r_s _S_u_p_p_o_r_t _(_O_P_T_I_O_N_A_L_) If Mutt-ng was compiled with compressed folders support (by running the _c_o_n_f_i_g_- _u_r_e script with the _-_-_e_n_a_b_l_e_-_c_o_m_p_r_e_s_s_e_d flag), Mutt can open folders stored in @@ -3208,8 +3228,8 @@ may be faster than converting the entire folder to the accepted format, append- ing to it and converting back to the user-defined format. - There are three hooks defined (_o_p_e_n_-_h_o_o_k (section 4.18.1 , page 64), _c_l_o_s_e_- - _h_o_o_k (section 4.18.2 , page 64) and _a_p_p_e_n_d_-_h_o_o_k (section 4.18.3 , page 65)) + There are three hooks defined (_o_p_e_n_-_h_o_o_k (section 4.19.1 , page 64), _c_l_o_s_e_- + _h_o_o_k (section 4.19.2 , page 65) and _a_p_p_e_n_d_-_h_o_o_k (section 4.19.3 , page 65)) which define commands to uncompress and compress a folder and to append mes- sages to an existing compressed folder respectively. @@ -3219,11 +3239,13 @@ close-hook \\.gz$ "gzip -c %t > %f" append-hook \\.gz$ "gzip -c %t >> %f" + The Mutt Next Generation E-Mail Client 65 + You do not have to specify all of the commands. If you omit _a_p_p_e_n_d_-_h_o_o_k (sec- - tion 4.18.3 , page 65), the folder will be open and closed again each time you - will add to it. If you omit _c_l_o_s_e_-_h_o_o_k (section 4.18.2 , page 64) (or give + tion 4.19.3 , page 65), the folder will be open and closed again each time you + will add to it. If you omit _c_l_o_s_e_-_h_o_o_k (section 4.19.2 , page 65) (or give empty command) , the folder will be open in the mode. If you specify _a_p_p_e_n_d_- - _h_o_o_k (section 4.18.3 , page 65) though you'll be able to append to the folder. + _h_o_o_k (section 4.19.3 , page 65) though you'll be able to append to the folder. Note that Mutt-ng will only try to use hooks if the file is not in one of the accepted formats. In particular, if the file is empty, mutt supposes it is not @@ -3233,14 +3255,11 @@ unset _$_s_a_v_e___e_m_p_t_y (section 6.4.240 , page 138), so that the compressed file will be removed if you delete all of the messages. - _4_._1_8_._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 + _4_._1_9_._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 Usage: open-hook _r_e_g_e_x_p '_c_o_m_m_a_n_d' The _c_o_m_m_a_n_d is the command that can be used for opening the folders whose names - - The Mutt Next Generation E-Mail Client 65 - match _r_e_g_e_x_p. The _c_o_m_m_a_n_d string is the printf-like format string, and it should accept two @@ -3260,21 +3279,23 @@ If the _c_o_m_m_a_n_d is empty, this operation is disabled for this file type. - _4_._1_8_._2 _W_r_i_t_e _a _c_o_m_p_r_e_s_s_e_d _m_a_i_l_b_o_x + _4_._1_9_._2 _W_r_i_t_e _a _c_o_m_p_r_e_s_s_e_d _m_a_i_l_b_o_x Usage: close-hook _r_e_g_e_x_p '_c_o_m_m_a_n_d' This is used to close the folder that was open with the _o_p_e_n_-_h_o_o_k (section - 4.18.1 , page 64) command after some changes were made to it. + 4.19.1 , page 64) command after some changes were made to it. The _c_o_m_m_a_n_d string is the command that can be used for closing the folders whose names match _r_e_g_e_x_p. It has the same format as in the _o_p_e_n_-_h_o_o_k (section - 4.18.1 , page 64) command. Temporary folder in this case is the folder previ- - ously produced by the <_o_p_e_n_-_h_o_o_k (section 4.18.1 , page 64) command. + 4.19.1 , page 64) command. Temporary folder in this case is the folder previ- + ously produced by the <_o_p_e_n_-_h_o_o_k (section 4.19.1 , page 64) command. The _c_o_m_m_a_n_d should nnoott remove the decompressed file. The _c_o_m_m_a_n_d should return non-zero exit status if it fails, so mutt knows something's wrong. + The Mutt Next Generation E-Mail Client 66 + Example: close-hook \\.gz$ "gzip -c %t > %f" @@ -3282,19 +3303,16 @@ If the _c_o_m_m_a_n_d is empty, this operation is disabled for this file type, and the file can only be open in the readonly mode. - _c_l_o_s_e_-_h_o_o_k (section 4.18.2 , page 64) is not called when you exit from the + _c_l_o_s_e_-_h_o_o_k (section 4.19.2 , page 65) is not called when you exit from the folder if the folder was not changed. - _4_._1_8_._3 _A_p_p_e_n_d _a _m_e_s_s_a_g_e _t_o _a _c_o_m_p_r_e_s_s_e_d _m_a_i_l_b_o_x + _4_._1_9_._3 _A_p_p_e_n_d _a _m_e_s_s_a_g_e _t_o _a _c_o_m_p_r_e_s_s_e_d _m_a_i_l_b_o_x Usage: append-hook _r_e_g_e_x_p '_c_o_m_m_a_n_d' This command is used for saving to an existing compressed folder. The _c_o_m_m_a_n_d is the command that can be used for appending to the folders whose names match - - The Mutt Next Generation E-Mail Client 66 - - _r_e_g_e_x_p. It has the same format as in the _o_p_e_n_-_h_o_o_k (section 4.18.1 , page 64) + _r_e_g_e_x_p. It has the same format as in the _o_p_e_n_-_h_o_o_k (section 4.19.1 , page 64) command. The temporary folder in this case contains the messages that are being appended. @@ -3305,21 +3323,21 @@ append-hook \\.gz$ "gzip -c %t >> %f" - When _a_p_p_e_n_d_-_h_o_o_k (section 4.18.3 , page 65) is used, the folder is not opened, + When _a_p_p_e_n_d_-_h_o_o_k (section 4.19.3 , page 65) is used, the folder is not opened, which saves time, but this means that we can not find out what the folder type is. Thus the default (_$_m_b_o_x___t_y_p_e (section 6.4.125 , page 111)) type is always supposed (i.e. this is the format used for the temporary folder). - If the file does not exist when you save to it, _c_l_o_s_e_-_h_o_o_k (section 4.18.2 , - page 64) is called, and not _a_p_p_e_n_d_-_h_o_o_k (section 4.18.3 , page 65). _a_p_p_e_n_d_- - _h_o_o_k (section 4.18.3 , page 65) is only for appending to existing folders. + If the file does not exist when you save to it, _c_l_o_s_e_-_h_o_o_k (section 4.19.2 , + page 65) is called, and not _a_p_p_e_n_d_-_h_o_o_k (section 4.19.3 , page 65). _a_p_p_e_n_d_- + _h_o_o_k (section 4.19.3 , page 65) is only for appending to existing folders. If the _c_o_m_m_a_n_d is empty, this operation is disabled for this file type. In this case, the folder will be open and closed again (using _o_p_e_n_-_h_o_o_k (section - 4.18.1 , page 64) and _c_l_o_s_e_-_h_o_o_k (section 4.18.2 , page 64)respectively) each + 4.19.1 , page 64) and _c_l_o_s_e_-_h_o_o_k (section 4.19.2 , page 65)respectively) each time you will add to it. - _4_._1_8_._4 _E_n_c_r_y_p_t_e_d _f_o_l_d_e_r_s + _4_._1_9_._4 _E_n_c_r_y_p_t_e_d _f_o_l_d_e_r_s The compressed folders support can also be used to handle encrypted folders. If you want to encrypt a folder with PGP, you may want to use the following hooks: @@ -3327,6 +3345,8 @@ open-hook \\.pgp$ "pgp -f < %f > %t" close-hook \\.pgp$ "pgp -fe YourPgpUserIdOrKeyId < %t > %f" + The Mutt Next Generation E-Mail Client 67 + Please note, that PGP does not support appending to an encrypted folder, so there is no append-hook defined. @@ -3339,9 +3359,6 @@ Quite a bit of effort has been made to make Mutt-ng the premier text-mode MIME MUA. Every effort has been made to provide the functionality that the discern- ing MIME user requires, and the conformance to the standards wherever possible. - - The Mutt Next Generation E-Mail Client 67 - When configuring Mutt-ng for MIME, there are two extra types of configuration files which Mutt-ng uses. One is the mime.types file, which contains the map- ping of file extensions to IANA MIME types. The other is the mailcap file, @@ -3377,6 +3394,9 @@ The default binding for view-attachments is `v', which displays the attachment menu for a message. The attachment menu displays a list of the attachments in + + The Mutt Next Generation E-Mail Client 68 + a message. From the attachment menu, you can save, print, pipe, delete, and view attachments. You can apply these operations to a group of attachments at once, by tagging the attachments and by using the ``tag-prefix'' operator. You @@ -3394,9 +3414,6 @@ The compose menu is the menu you see before you send a message. It allows you to edit the recipient list, the subject, and other aspects of your message. It - - The Mutt Next Generation E-Mail Client 68 - also contains a list of the attachments of your message, including the main body. From this menu, you can print, copy, filter, pipe, edit, compose, review, and rename an attachment or a list of tagged attachments. You can also @@ -3432,6 +3449,8 @@ application/pgp pgp audio/x-aiff aif aifc aiff + The Mutt Next Generation E-Mail Client 69 + A sample mime.types file comes with the Mutt-ng distribution, and should con- tain most of the MIME types you are likely to use. @@ -3447,9 +3466,6 @@ these if the appropriate entry is found in the mime.types file. It also recog- nises other major mime types, such as the chemical type that is widely used in the molecular modelling community to pass molecular data in various forms to - - The Mutt Next Generation E-Mail Client 69 - various molecular viewers. Non-recognised mime types should only be used if the recipient of the message is likely to be expecting such attachments. @@ -3487,6 +3503,8 @@ optional fields. Each field of a definition line is divided by a semicolon ';' character. + The Mutt Next Generation E-Mail Client 70 + The content type is specified in the MIME standard type/subtype method. For example, text/plain, text/html, image/gif, etc. In addition, the mailcap for- mat includes two formats for wildcards, one using the special '*' subtype, the @@ -3501,9 +3519,6 @@ body of the MIME message to a temporary file, and then call the view command with the %s replaced by the name of the temporary file. In both cases, Mutt-ng will turn over the terminal to the view program until the program quits, at - - The Mutt Next Generation E-Mail Client 70 - which time Mutt will remove the temporary file if it exists. So, in the simplest form, you can send a text/plain message to the external @@ -3538,6 +3553,8 @@ This is the simplest form of a mailcap file. + The Mutt Next Generation E-Mail Client 71 + _5_._3_._2 _S_e_c_u_r_e _u_s_e _o_f _m_a_i_l_c_a_p The interpretation of shell meta-characters embedded in MIME parameters can @@ -3553,9 +3570,6 @@ double quotes. Mutt-ng does this for you, the right way, as should any other program which interprets mailcap. Don't put them into backtick expansions. Be highly careful with eval statements, and avoid them if possible at all. Trying - - The Mutt Next Generation E-Mail Client 71 - to fix broken behaviour with quotes introduces new leaks - there is no alterna- tive to correct quoting in the first place. @@ -3591,23 +3605,24 @@ and Mutt-ng will use your standard pager to display the results. needsterminal - Mutt-ng uses this flag when viewing attachments with _a_u_t_o_v_i_e_w (sec- - tion 5.4 , page 74), in order to decide whether it should honor - the setting of the _$_w_a_i_t___k_e_y (section 6.4.332 , page 161) variable - or not. When an attachment is viewed using an interactive program, - and the corresponding mailcap entry has a _n_e_e_d_s_t_e_r_m_i_n_a_l flag, Mutt- - ng will use _$_w_a_i_t___k_e_y (section 6.4.332 , page 161) and the exit - status of the program to decide if it will ask you to press a key - after the external program has exited. In all other situations it - will not prompt you for a key. + Mutt-ng uses this flag when viewing attachments with _a_u_t_o_v_i_e_w + + The Mutt Next Generation E-Mail Client 72 + + (section 5.4 , page 74), in order to decide whether it should + honor the setting of the _$_w_a_i_t___k_e_y (section 6.4.334 , page 161) + variable or not. When an attachment is viewed using an interactive + program, and the corresponding mailcap entry has a _n_e_e_d_s_t_e_r_m_i_n_a_l + flag, Mutt-ng will use _$_w_a_i_t___k_e_y (section 6.4.334 , page 161) and + the exit status of the program to decide if it will ask you to + press a key after the external program has exited. In all other + situations it will not prompt you for a key. compose= This flag specifies the command to use to create a new attachment of a specific MIME type. Mutt-ng supports this from the compose menu. - The Mutt Next Generation E-Mail Client 72 - composetyped= This flag specifies the command to use to create a new attachment of a specific MIME type. This command differs from the compose @@ -3648,6 +3663,8 @@ text/html; netscape -remote 'openURL(%s)' ; test=RunningX text/html; lynx %s + The Mutt Next Generation E-Mail Client 73 + In this example, Mutt-ng will run the program RunningX which will return 0 if the X Window manager is running, and non-zero if it isn't. If RunningX returns 0, then Mutt-ng will call netscape to @@ -3660,9 +3677,6 @@ When searching for an entry in the mailcap file, Mutt-ng will search for the most useful entry for its purpose. For instance, if you are attempting to print an image/gif, and you have the following entries in your mailcap file, - - The Mutt Next Generation E-Mail Client 73 - Mutt-ng will search for an entry with the print command: image/*; xv %s @@ -3702,6 +3716,8 @@ use of this keyword causes Mutt-ng to not pass the body of the mes- sage to the view/print/edit program on stdin. + The Mutt Next Generation E-Mail Client 74 + %t Mutt-ng will expand %t to the text representation of the content type of the message in the same form as the first parameter of the @@ -3714,8 +3730,6 @@ Content-Type: text/plain; charset=iso-8859-1 - The Mutt Next Generation E-Mail Client 74 - then Mutt-ng will expand %{charset} to iso-8859-1. The default metamail mailcap file uses this feature to test the charset to spawn an xterm using the right charset to view the message. @@ -3961,7 +3975,7 @@ The following are the commands understood by mutt. - +o _a_c_c_o_u_n_t_-_h_o_o_k (section 4.16 , page 62) _p_a_t_t_e_r_n _c_o_m_m_a_n_d + +o _a_c_c_o_u_n_t_-_h_o_o_k (section 4.17 , page 63) _p_a_t_t_e_r_n _c_o_m_m_a_n_d +o _a_l_i_a_s (section 3.3 , page 23) _k_e_y _a_d_d_r_e_s_s [ , _a_d_d_r_e_s_s, ... ] @@ -3975,7 +3989,7 @@ +o _u_n_a_l_t_e_r_n_a_t_i_v_e___o_r_d_e_r (section 5.5 , page 75) _m_i_m_e_t_y_p_e [ _m_i_m_e_t_y_p_e ... ] - +o _a_p_p_e_n_d_-_h_o_o_k (section 4.18.3 , page 65) _r_e_g_e_x_p _c_o_m_m_a_n_d + +o _a_p_p_e_n_d_-_h_o_o_k (section 4.19.3 , page 65) _r_e_g_e_x_p _c_o_m_m_a_n_d +o _a_u_t_o___v_i_e_w (section 5.4 , page 74) _m_i_m_e_t_y_p_e [ _m_i_m_e_t_y_p_e ... ] @@ -3985,7 +3999,7 @@ +o _c_h_a_r_s_e_t_-_h_o_o_k (section 3.5 , page 26) _a_l_i_a_s _c_h_a_r_s_e_t - +o _c_l_o_s_e_-_h_o_o_k (section 4.18.2 , page 64) _r_e_g_e_x_p _c_o_m_m_a_n_d + +o _c_l_o_s_e_-_h_o_o_k (section 4.19.2 , page 65) _r_e_g_e_x_p _c_o_m_m_a_n_d +o _c_o_l_o_r (section 3.8 , page 27) _o_b_j_e_c_t _f_o_r_e_g_r_o_u_n_d _b_a_c_k_g_r_o_u_n_d [ _r_e_g_e_x_p ] @@ -4035,7 +4049,7 @@ +o _u_n_m_y___h_d_r (section 3.15 , page 34) _f_i_e_l_d [ _f_i_e_l_d ... ] - +o _o_p_e_n_-_h_o_o_k (section 4.18.1 , page 64) _r_e_g_e_x_p _c_o_m_m_a_n_d + +o _o_p_e_n_-_h_o_o_k (section 4.19.1 , page 64) _r_e_g_e_x_p _c_o_m_m_a_n_d +o _c_r_y_p_t_-_h_o_o_k (section 3.22 , page 37) _p_a_t_t_e_r_n _k_e_y_-_i_d @@ -4212,7 +4226,7 @@ set assumed_charset='iso-2022-jp:euc-jp:shift_jis:utf-8' However, only the first content is valid for the message body. This variable - is valid only if _$_s_t_r_i_c_t___m_i_m_e (section 6.4.308 , page 156) is unset. + is valid only if _$_s_t_r_i_c_t___m_i_m_e (section 6.4.310 , page 156) is unset. _6_._4_._1_2 _a_t_t_a_c_h___f_o_r_m_a_t @@ -4442,7 +4456,7 @@ Default: '-- Mutt-ng: Compose [Approx. msg size: %l Atts: %a]%>-' Controls the format of the status line displayed in the ``compose'' menu. This - string is similar to ``_$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.4.305 , page 153)'', but has + string is similar to ``_$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.4.307 , page 154)'', but has its own set of printf(3)-like sequences: %a @@ -4459,7 +4473,7 @@ %v Mutt-ng version string - See the text describing the ``_$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.4.305 , page 153)'' + See the text describing the ``_$_s_t_a_t_u_s___f_o_r_m_a_t (section 6.4.307 , page 154)'' option for more information on how to set ``_$_c_o_m_p_o_s_e___f_o_r_m_a_t (section 6.4.27 , page 86)''. @@ -4531,7 +4545,7 @@ 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 required or signing is requested as well. If ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section - 6.4.277 , page 146)'' is _s_e_t, then OpenSSL is used instead to create S/MIME + 6.4.277 , page 147)'' is _s_e_t, then OpenSSL is used instead to create S/MIME messages and settings can be overridden by use of the _s_m_i_m_e_-_m_e_n_u. (Crypto only) @@ -4545,7 +4559,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.4.34 , page 88)'', ``_$_c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t (section 6.4.38 , page 89)'', ``_$_c_r_y_p_t___a_u_t_o_s_i_g_n (section 6.4.36 , page 88)'', ``_$_c_r_y_p_t___r_e_p_l_y_s_i_g_n (section - 6.4.39 , page 89)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.4.277 , page 146)''. + 6.4.39 , page 89)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.4.277 , page 147)''. _6_._4_._3_6 _c_r_y_p_t___a_u_t_o_s_i_g_n @@ -4556,7 +4570,7 @@ Setting this variable will cause Mutt-ng to always attempt to cryptographically sign outgoing messages. This can be overridden by use of the _p_g_p_-_m_e_n_u, when signing is not required or encryption is requested as well. If - ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.4.277 , page 146)'' is _s_e_t, then OpenSSL is + ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.4.277 , page 147)'' is _s_e_t, then OpenSSL is used instead to create S/MIME messages and settings can be overridden by use of the _s_m_i_m_e_-_m_e_n_u. (Crypto only) @@ -4572,7 +4586,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.4.34 , page 88)'', ``_$_c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t (section 6.4.38 , page 89)'', ``_$_c_r_y_p_t___a_u_t_o_s_i_g_n (section 6.4.36 , page 88)'', ``_$_c_r_y_p_t___r_e_p_l_y_s_i_g_n (section - 6.4.39 , page 89)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.4.277 , page 146)''. + 6.4.39 , page 89)'' and ``_$_s_m_i_m_e___i_s___d_e_f_a_u_l_t (section 6.4.277 , page 147)''. _6_._4_._3_8 _c_r_y_p_t___r_e_p_l_y_e_n_c_r_y_p_t @@ -4979,7 +4993,7 @@ is invoked. When _u_n_s_e_t, _b_u_f_f_y___l_i_s_t will just list all mailboxes which are already known to have new mail. - Also see the following variables: ``_$_t_i_m_e_o_u_t (section 6.4.318 , page 158)'', + Also see the following variables: ``_$_t_i_m_e_o_u_t (section 6.4.320 , page 159)'', ``_$_m_a_i_l___c_h_e_c_k (section 6.4.115 , page 109)'' and ``_$_i_m_a_p___m_a_i_l___c_h_e_c_k (section 6.4.99 , page 103)''. @@ -5057,7 +5071,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.4.236 , page - 137)''. This variable is ignored if ``_$_u_s_e___f_r_o_m (section 6.4.327 , page + 137)''. This variable is ignored if ``_$_u_s_e___f_r_o_m (section 6.4.329 , page 160)'' is unset. E.g. you can use send-hook Mutt-ng-devel@lists.berlios.de 'my_hdr From: Foo Bar @@ -5104,8 +5118,8 @@ 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.4.333 , page - 161)'' setting applies. + are replying to into the edit buffer. The ``_$_w_e_e_d (section 6.4.335 , page + 162)'' setting applies. _6_._4_._7_8 _h_e_a_d_e_r___c_a_c_h_e @@ -5280,30 +5294,29 @@ ous methods are unavailable. If a method is available but authentication fails, Mutt-ng will not connect to the IMAP server. - _6_._4_._9_2 _i_m_a_p___d_e_l_i_m___c_h_a_r_s + _6_._4_._9_2 _i_m_a_p___c_h_e_c_k___s_u_b_s_c_r_i_b_e_d - Type: string + Type: boolean - Default: '/.' + Default: no - Availability: IMAP + When _s_e_t, mutt will fetch the set of subscribed folders from your server on + connection, and add them to the set of mailboxes it polls for new mail. See + also the ``_m_a_i_l_b_o_x_e_s (section 3.14 , page 33)'' command. - This contains the list of characters which you would like to treat as folder - separators for displaying IMAP paths. In particular it helps in using the '=' - shortcut for your _$_f_o_l_d_e_r (section 6.4.64 , page 94) variable. + _6_._4_._9_3 _i_m_a_p___d_e_l_i_m___c_h_a_r_s The Mutt Next Generation E-Mail Client 103 - _6_._4_._9_3 _i_m_a_p___f_o_r_c_e___s_s_l - - Type: boolean + Type: string - Default: no + Default: '/.' - Availability: IMAP and SSL or IMAP and GNUTLS + Availability: IMAP - If this variable is _s_e_t, Mutt-ng will always use SSL when connecting to IMAP - servers. + This contains the list of characters which you would like to treat as folder + separators for displaying IMAP paths. In particular it helps in using the '=' + shortcut for your _$_f_o_l_d_e_r (section 6.4.64 , page 94) variable. _6_._4_._9_4 _i_m_a_p___h_e_a_d_e_r_s @@ -5348,9 +5361,10 @@ utes) before a server is allowed to do this, but in practice the RFC does get violated every now and then. + Reduce this number if you find yourself getting disconnected from your IMAP + The Mutt Next Generation E-Mail Client 104 - Reduce this number if you find yourself getting disconnected from your IMAP server due to inactivity. _6_._4_._9_7 _i_m_a_p___l_i_s_t___s_u_b_s_c_r_i_b_e_d @@ -5610,8 +5624,8 @@ `to:' field (recipients) %T - the appropriate character from the _$_t_o___c_h_a_r_s (section 6.4.320 , - page 158) string + the appropriate character from the _$_t_o___c_h_a_r_s (section 6.4.322 , + page 159) string %u user (login) name of the author @@ -5662,7 +5676,7 @@ %|X pad to the end of the line with character 'X' - See also: ``_$_t_o___c_h_a_r_s (section 6.4.320 , page 158)''. + See also: ``_$_t_o___c_h_a_r_s (section 6.4.322 , page 159)''. _6_._4_._1_1_1 _i_s_p_e_l_l @@ -5679,7 +5693,7 @@ Default: no If _s_e_t, read messages marked as flagged will not be moved from your spool mail- - box to your ``_$_m_b_o_x (section 6.4.124 , page 111)'' mailbox, or as a result of + box to your ``_$_m_b_o_x (section 6.4.124 , page 110)'' mailbox, or as a result of a ``_m_b_o_x_-_h_o_o_k (section 3.13 , page 33)'' command. _6_._4_._1_1_3 _l_i_s_t___r_e_p_l_y @@ -5785,7 +5799,7 @@ Controls the display of wrapped lines in the internal pager. If set, a ``+'' marker is displayed at the beginning of wrapped lines. Also see the - ``_$_s_m_a_r_t___w_r_a_p (section 6.4.263 , page 143)'' variable. + ``_$_s_m_a_r_t___w_r_a_p (section 6.4.263 , page 144)'' variable. _6_._4_._1_2_2 _m_a_s_k @@ -5808,7 +5822,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.4.335 , page 161). + (section 6.4.337 , page 162). _6_._4_._1_2_4 _m_b_o_x @@ -5817,7 +5831,7 @@ Default: '~/mbox' This specifies the folder into which read mail in your ``_$_s_p_o_o_l_f_i_l_e (section - 6.4.295 , page 151)'' folder will be appended. + 6.4.296 , page 151)'' folder will be appended. _6_._4_._1_2_5 _m_b_o_x___t_y_p_e @@ -6009,7 +6023,7 @@ Default: ask-no Controls whether or not Mutt-ng will move read messages from your spool mailbox - to your ``_$_m_b_o_x (section 6.4.124 , page 111)'' mailbox, or as a result of a + to your ``_$_m_b_o_x (section 6.4.124 , page 110)'' mailbox, or as a result of a ``_m_b_o_x_-_h_o_o_k (section 3.13 , page 33)'' command. _6_._4_._1_4_2 _m_s_g_i_d___f_o_r_m_a_t @@ -7177,7 +7191,7 @@ time. When set to 0, only a single message will appear before the reading the mailbox. - Also see the ``_$_w_r_i_t_e___i_n_c (section 6.4.337 , page 162)'' variable. + Also see the ``_$_w_r_i_t_e___i_n_c (section 6.4.339 , page 162)'' variable. _6_._4_._2_2_7 _r_e_a_d___o_n_l_y @@ -7366,7 +7380,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.4.295 , page 151)'' which is + closed (the exception is ``_$_s_p_o_o_l_f_i_l_e (section 6.4.296 , page 151)'' 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 @@ -7498,7 +7512,7 @@ Default: '.' When the sidebar is displayed and _$_s_i_d_e_b_a_r___s_h_o_r_t_e_n___h_i_e_r_a_r_c_h_y (section - 6.4.254 , page 141) is _s_e_t, this variable specifies the characters at which to + 6.4.254 , page 142) is _s_e_t, this variable specifies the characters at which to split a folder name into ``hierarchy items.'' _6_._4_._2_5_1 _s_i_d_e_b_a_r___d_e_l_i_m @@ -7522,32 +7536,43 @@ Type: string - Default: '%c%?n?(%n)?%?f?[%f]?' + Default: '%m%?n?(%n)?%?f?[%f]?' This variable controls how message counts are printed when the sidebar is enabled. If this variable is _e_m_p_t_y (_a_n_d _o_n_l_y _i_f), no numbers will be printed _a_n_d mutt-ng won't frequently count mail (which may be a great speedup esp. with mbox-style mailboxes.) - The following printf(3)-like sequences are supported: + The following printf(3)-like sequences are supported all of which may be + printed non-zero: - %c - Total number of messages. + %d + Number of deleted messages. 1) - %f + %F Number of flagged messages. + %m + Total number of messages. + + %M + Total number of messages shown, i.e. not hidden by a limit. 1) + + The Mutt Next Generation E-Mail Client 143 + %n Number of new messages. - The %f and %n expandos may optionally be printed non-zero. + %t + Number of tagged messages. 1) + + 1) These expandos only have a non-zero value for the current mailbox and will + always be zero otherwise. _6_._4_._2_5_4 _s_i_d_e_b_a_r___s_h_o_r_t_e_n___h_i_e_r_a_r_c_h_y Type: boolean - The Mutt Next Generation E-Mail Client 143 - Default: no When _s_e_t, the ``hierarchy'' of the sidebar entries will be shortened only if @@ -7584,11 +7609,13 @@ Default: yes If set, a line containing ``-- '' (dash, dash, space) will be inserted before - your ``_$_s_i_g_n_a_t_u_r_e (section 6.4.259 , page 142)''. It is ssttrroonnggllyy recommended + your ``_$_s_i_g_n_a_t_u_r_e (section 6.4.259 , page 143)''. It is ssttrroonnggllyy recommended that you not unset this variable unless your ``signature'' contains just your name. The reason for this is because many software packages use ``-- \n'' to detect your signature. + The Mutt Next Generation E-Mail Client 144 + For example, Mutt-ng has the ability to highlight the signature in a different color in the builtin pager. @@ -7603,8 +7630,6 @@ know what you are doing, and are prepared to take some heat from netiquette guardians. - The Mutt Next Generation E-Mail Client 144 - _6_._4_._2_5_9 _s_i_g_n_a_t_u_r_e Type: path @@ -7644,6 +7669,8 @@ ~f joe | ~s joe + The Mutt Next Generation E-Mail Client 145 + _6_._4_._2_6_2 _s_l_e_e_p___t_i_m_e Type: number @@ -7659,8 +7686,6 @@ Type: boolean - The Mutt Next Generation E-Mail Client 145 - Default: yes Controls the display of lines longer than the screen width in the internal @@ -7701,6 +7726,8 @@ Type: path + The Mutt Next Generation E-Mail Client 146 + Default: '' Since there is no pubring/secring as with PGP, Mutt-ng has to handle storage @@ -7716,8 +7743,6 @@ Default: '' - The Mutt Next Generation E-Mail Client 146 - This format string specifies a command which is used to decrypt application/x- pkcs7-mime attachments. @@ -7757,6 +7782,8 @@ Default: yes + The Mutt Next Generation E-Mail Client 147 + If _s_e_t (default) this tells Mutt-ng to use the default key for decryption. Oth- erwise, if manage multiple certificate-key-pairs, Mutt-ng will try to use the mailbox-address to determine the key to use. It will ask you to supply a key, @@ -7771,8 +7798,6 @@ This is the default key-pair to use for signing. This must be set to the keyid (the hash-value that OpenSSL generates) to work properly (S/MIME only) - The Mutt Next Generation E-Mail Client 147 - _6_._4_._2_7_1 _s_m_i_m_e___e_n_c_r_y_p_t___c_o_m_m_a_n_d Type: string @@ -7813,6 +7838,8 @@ _6_._4_._2_7_5 _s_m_i_m_e___g_e_t___s_i_g_n_e_r___c_e_r_t___c_o_m_m_a_n_d + The Mutt Next Generation E-Mail Client 148 + Type: string Default: '' @@ -7827,8 +7854,6 @@ Default: '' - The Mutt Next Generation E-Mail Client 148 - This command is used to import a certificate via smime_keysng. (S/MIME only) _6_._4_._2_7_7 _s_m_i_m_e___i_s___d_e_f_a_u_l_t @@ -7868,6 +7893,8 @@ This command is used to extract PKCS7 structures of S/MIME signatures, in order to extract the public X509 certificate(s). (S/MIME only) + The Mutt Next Generation E-Mail Client 149 + _6_._4_._2_8_0 _s_m_i_m_e___s_i_g_n___c_o_m_m_a_n_d Type: string @@ -7883,8 +7910,6 @@ Default: '' - The Mutt Next Generation E-Mail Client 149 - This command is used to created S/MIME signatures of type application/x- pkcs7-signature, which can only be handled by mail clients supporting the S/MIME extension. (S/MIME only) @@ -7916,7 +7941,21 @@ This command is used to verify S/MIME signatures of type application/x- pkcs7-mime. (S/MIME only) - _6_._4_._2_8_5 _s_m_t_p___a_u_t_h___p_a_s_s_w_o_r_d + _6_._4_._2_8_5 _s_m_t_p___h_o_s_t + + Type: string + + Default: '' + + Availability: SMTP + + The Mutt Next Generation E-Mail Client 150 + + Defines the SMTP host which will be used to deliver mail, as opposed to invok- + ing the sendmail binary. Setting this variable overrides the value of ``_$_s_e_n_d_- + _m_a_i_l (section 6.4.247 , page 140)'', and any associated variables. + + _6_._4_._2_8_6 _s_m_t_p___p_a_s_s Type: string @@ -7925,52 +7964,54 @@ Availability: SMTP Defines the password to use with SMTP AUTH. If ``_$_s_m_t_p___a_u_t_h___u_s_e_r_n_a_m_e (section - 6.4.286 , page 148)'' is set, but this variable is not, you will be prompted - for a password when sending. + , page )'' is set, but this variable is not, you will be prompted for a pass- + word when sending. NNoottee:: Storing passwords in a configuration file presents a security risk since the superuser of your machine may read it regardless of the file's permissions. - _6_._4_._2_8_6 _s_m_t_p___a_u_t_h___u_s_e_r_n_a_m_e + _6_._4_._2_8_7 _s_m_t_p___p_o_r_t - Type: string + Type: number - Default: '' + Default: 25 Availability: SMTP - The Mutt Next Generation E-Mail Client 150 + Defines the port that the SMTP host is listening on for mail delivery. Must be + specified as a number. - Defines the username to use with SMTP AUTH. Setting this variable will cause - Mutt-ng to attempt to use SMTP AUTH when sending. + Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers + will probably desire 587, the mail submission port. - _6_._4_._2_8_7 _s_m_t_p___h_o_s_t + _6_._4_._2_8_8 _s_m_t_p___u_s_e___t_l_s Type: string Default: '' - Availability: SMTP + Availability: SMTP (and SSL) - Defines the SMTP host which will be used to deliver mail, as opposed to invok- - ing the sendmail binary. Setting this variable overrides the value of ``_$_s_e_n_d_- - _m_a_i_l (section 6.4.247 , page 140)'', and any associated variables. + Defines wether to use STARTTLS. If this option is set to ``_r_e_q_u_i_r_e_d'' and the + server does not support STARTTLS or there is an error in the TLS Handshake, the + connection will fail. Setting this to ``_e_n_a_b_l_e_d'' will try to start TLS and + continue without TLS in case of an error. Muttng still needs to have SSL sup- + port enabled in order to use it. - _6_._4_._2_8_8 _s_m_t_p___p_o_r_t + _6_._4_._2_8_9 _s_m_t_p___u_s_e_r - Type: number + Type: string - Default: 25 + Default: '' Availability: SMTP - Defines the port that the SMTP host is listening on for mail delivery. Must be - specified as a number. + The Mutt Next Generation E-Mail Client 151 - Defaults to 25, the standard SMTP port, but RFC 2476-compliant SMTP servers - will probably desire 587, the mail submission port. + Defines the username to use with SMTP AUTH. Setting this variable will cause + Mutt-ng to attempt to use SMTP AUTH when sending. - _6_._4_._2_8_9 _s_o_r_t + _6_._4_._2_9_0 _s_o_r_t Type: sort order @@ -7992,9 +8033,7 @@ You may optionally use the ``reverse-'' prefix to specify reverse sorting order (example: set sort=reverse-date-sent). - The Mutt Next Generation E-Mail Client 151 - - _6_._4_._2_9_0 _s_o_r_t___a_l_i_a_s + _6_._4_._2_9_1 _s_o_r_t___a_l_i_a_s Type: sort order @@ -8007,7 +8046,7 @@ alias (sort alphabetically by alias name) unsorted (leave in order specified in .muttrc) - _6_._4_._2_9_1 _s_o_r_t___a_u_x + _6_._4_._2_9_2 _s_o_r_t___a_u_x Type: sort order @@ -8015,10 +8054,13 @@ 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.4.289 , page 149)'' can, + This can be set to any value that ``_$_s_o_r_t (section 6.4.290 , page 149)'' 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 + + The Mutt Next Generation E-Mail Client 152 + siblings by which has the last descendant, using the rest of sort_aux as an ordering. @@ -8026,11 +8068,11 @@ is received in a thread, that thread becomes the last one displayed (or the first, if you have set sort=reverse-threads.) - NNoottee:: For reversed ``_$_s_o_r_t (section 6.4.289 , page 149)'' order _$_s_o_r_t___a_u_x - (section 6.4.291 , page 150) is reversed again (which is not the right thing + NNoottee:: For reversed ``_$_s_o_r_t (section 6.4.290 , page 149)'' order _$_s_o_r_t___a_u_x + (section 6.4.292 , page 150) is reversed again (which is not the right thing to do, but kept to not break any existing configuration setting). - _6_._4_._2_9_2 _s_o_r_t___b_r_o_w_s_e_r + _6_._4_._2_9_3 _s_o_r_t___b_r_o_w_s_e_r Type: sort order @@ -8044,40 +8086,41 @@ size unsorted - The Mutt Next Generation E-Mail Client 152 - You may optionally use the ``reverse-'' prefix to specify reverse sorting order (example: set sort_browser=reverse-date). - _6_._4_._2_9_3 _s_o_r_t___r_e + _6_._4_._2_9_4 _s_o_r_t___r_e Type: boolean Default: yes This variable is only useful when sorting by threads with ``_$_s_t_r_i_c_t___t_h_r_e_a_d_s - (section 6.4.309 , page 156)'' _u_n_s_e_t. In that case, it changes the heuristic - Mutt-ng uses to thread messages by subject. With _$_s_o_r_t___r_e (section 6.4.293 , - page 150) _s_e_t, Mutt-ng will only attach a message as the child of another mes- + (section 6.4.311 , page 157)'' _u_n_s_e_t. In that case, it changes the heuristic + Mutt-ng uses to thread messages by subject. With _$_s_o_r_t___r_e (section 6.4.294 , + page 151) _s_e_t, Mutt-ng will only attach a message as the child of another mes- sage by subject if the subject of the child message starts with a substring matching the setting of ``_$_r_e_p_l_y___r_e_g_e_x_p (section 6.4.231 , page 136)''. With - _$_s_o_r_t___r_e (section 6.4.293 , page 150) _u_n_s_e_t, Mutt-ng will attach the message + _$_s_o_r_t___r_e (section 6.4.294 , page 151) _u_n_s_e_t, Mutt-ng will attach the message whether or not this is the case, as long as the non-``_$_r_e_p_l_y___r_e_g_e_x_p (section 6.4.231 , page 136)'' parts of both messages are identical. - _6_._4_._2_9_4 _s_p_a_m___s_e_p_a_r_a_t_o_r + _6_._4_._2_9_5 _s_p_a_m___s_e_p_a_r_a_t_o_r Type: string Default: ',' - ``_s_p_a_m___s_e_p_a_r_a_t_o_r (section 6.4.294 , page 151)'' controls what happens when - multiple spam headers are matched: if _u_n_s_e_t, each successive header will over- - write any previous matches value for the spam label. If _s_e_t, each successive - match will append to the previous, using ``_s_p_a_m___s_e_p_a_r_a_t_o_r (section 6.4.294 , - page 151)'' as a separator. + ``_s_p_a_m___s_e_p_a_r_a_t_o_r (section 6.4.295 , page 151)'' controls what happens when + multiple spam headers are matched: if _u_n_s_e_t, each successive header will + + The Mutt Next Generation E-Mail Client 153 - _6_._4_._2_9_5 _s_p_o_o_l_f_i_l_e + overwrite any previous matches value for the spam label. If _s_e_t, each succes- + sive match will append to the previous, using ``_s_p_a_m___s_e_p_a_r_a_t_o_r (section + 6.4.295 , page 151)'' as a separator. + + _6_._4_._2_9_6 _s_p_o_o_l_f_i_l_e Type: path @@ -8088,7 +8131,7 @@ set this variable to the value of the environment variable $MAIL if it is not set. - _6_._4_._2_9_6 _s_s_l___c_a___c_e_r_t_i_f_i_c_a_t_e_s___f_i_l_e + _6_._4_._2_9_7 _s_s_l___c_a___c_e_r_t_i_f_i_c_a_t_e_s___f_i_l_e Type: path @@ -8100,9 +8143,7 @@ Example: set ssl_ca_certificates_file=/etc/ssl/certs/ca-certificates.crt - The Mutt Next Generation E-Mail Client 153 - - _6_._4_._2_9_7 _s_s_l___c_l_i_e_n_t___c_e_r_t + _6_._4_._2_9_8 _s_s_l___c_l_i_e_n_t___c_e_r_t Type: path @@ -8112,19 +8153,33 @@ The file containing a client certificate and its associated private key. - _6_._4_._2_9_8 _s_s_l___m_i_n___d_h___p_r_i_m_e___b_i_t_s + _6_._4_._2_9_9 _s_s_l___f_o_r_c_e___t_l_s + + Type: boolean + + Default: no + + If this variable is _s_e_t, mutt-ng will require that all connections to remote + servers be encrypted. Furthermore it will attempt to negotiate TLS even if the + server does not advertise the capability, since it would otherwise have to + abort the connection anyway. This option supersedes ``_$_s_s_l___s_t_a_r_t_t_l_s (section + 6.4.301 , page 152)''. + + _6_._4_._3_0_0 _s_s_l___m_i_n___d_h___p_r_i_m_e___b_i_t_s Type: number Default: 0 + The Mutt Next Generation E-Mail Client 154 + Availability: GNUTLS This variable specifies the minimum acceptable prime size (in bits) for use in any Diffie-Hellman key exchange. A value of 0 will use the default from the GNUTLS library. - _6_._4_._2_9_9 _s_s_l___s_t_a_r_t_t_l_s + _6_._4_._3_0_1 _s_s_l___s_t_a_r_t_t_l_s Type: quadoption @@ -8136,7 +8191,7 @@ ing the capability. When _u_n_s_e_t, Mutt-ng will not attempt to use STARTTLS regardless of the server's capabilities. - _6_._4_._3_0_0 _s_s_l___u_s_e___s_s_l_v_2 + _6_._4_._3_0_2 _s_s_l___u_s_e___s_s_l_v_2 Type: boolean @@ -8147,7 +8202,7 @@ This variables specifies whether to attempt to use SSLv2 in the SSL authentica- tion process. - _6_._4_._3_0_1 _s_s_l___u_s_e___s_s_l_v_3 + _6_._4_._3_0_3 _s_s_l___u_s_e___s_s_l_v_3 Type: boolean @@ -8155,13 +8210,10 @@ Availability: SSL or GNUTLS - This variables specifies whether to attempt to use SSLv3 in the SSL - - The Mutt Next Generation E-Mail Client 154 - - authentication process. + This variables specifies whether to attempt to use SSLv3 in the SSL authentica- + tion process. - _6_._4_._3_0_2 _s_s_l___u_s_e___t_l_s_v_1 + _6_._4_._3_0_4 _s_s_l___u_s_e___t_l_s_v_1 Type: boolean @@ -8172,10 +8224,12 @@ This variables specifies whether to attempt to use TLSv1 in the SSL authentica- tion process. - _6_._4_._3_0_3 _s_s_l___u_s_e_s_y_s_t_e_m_c_e_r_t_s + _6_._4_._3_0_5 _s_s_l___u_s_e_s_y_s_t_e_m_c_e_r_t_s Type: boolean + The Mutt Next Generation E-Mail Client 155 + Default: yes Availability: SSL @@ -8183,14 +8237,14 @@ If set to _y_e_s, Mutt-ng will use CA certificates in the system-wide certificate store when checking if server certificate is signed by a trusted CA. - _6_._4_._3_0_4 _s_t_a_t_u_s___c_h_a_r_s + _6_._4_._3_0_6 _s_t_a_t_u_s___c_h_a_r_s Type: string Default: '-*%A' Controls the characters used by the ``%r'' indicator in ``_$_s_t_a_t_u_s___f_o_r_m_a_t (sec- - tion 6.4.305 , page 153)''. The first character is used when the mailbox is + tion 6.4.307 , page 154)''. The first character is used when the mailbox is unchanged. The second is used when the mailbox has been changed, and it needs to be resynchronized. The third is used if the mailbox is in read-only mode, or if the mailbox will not be written when exiting that mailbox (You can toggle @@ -8199,7 +8253,7 @@ been opened in attach-message mode (Certain operations like composing a new mail, replying, forwarding, etc. are not permitted in this mode). - _6_._4_._3_0_5 _s_t_a_t_u_s___f_o_r_m_a_t + _6_._4_._3_0_7 _s_t_a_t_u_s___f_o_r_m_a_t Type: string @@ -8214,8 +8268,6 @@ %b number of mailboxes with new mail * - The Mutt Next Generation E-Mail Client 155 - %B the short pathname of the current mailbox @@ -8231,6 +8283,8 @@ %h local hostname + The Mutt Next Generation E-Mail Client 156 + %l size (in bytes) of the current mailbox * @@ -8259,20 +8313,18 @@ %r modified/read-only/won't-write/attach-message indicator, according - to _$_s_t_a_t_u_s___c_h_a_r_s (section 6.4.304 , page 153) + to _$_s_t_a_t_u_s___c_h_a_r_s (section 6.4.306 , page 154) %s - current sorting mode (_$_s_o_r_t (section 6.4.289 , page 149)) + current sorting mode (_$_s_o_r_t (section 6.4.290 , page 149)) %S - current aux sorting method (_$_s_o_r_t___a_u_x (section 6.4.291 , page + current aux sorting method (_$_s_o_r_t___a_u_x (section 6.4.292 , page 150)) %t number of tagged messages * - The Mutt Next Generation E-Mail Client 156 - %u number of unread messages * @@ -8288,6 +8340,8 @@ %|X pad to the end of the line with 'X' + The Mutt Next Generation E-Mail Client 157 + * = can be optionally printed if nonzero Some of the above sequences can be used to optionally print a string if their @@ -8324,18 +8378,16 @@ replace any dots in the expansion by underscores. This might be helpful with IMAP folders that don't like dots in folder names. - _6_._4_._3_0_6 _s_t_a_t_u_s___o_n___t_o_p + _6_._4_._3_0_8 _s_t_a_t_u_s___o_n___t_o_p Type: boolean - The Mutt Next Generation E-Mail Client 157 - Default: no Setting this variable causes the ``status bar'' to be displayed on the first line of the screen rather than near the bottom. - _6_._4_._3_0_7 _s_t_r_i_c_t___m_a_i_l_t_o + _6_._4_._3_0_9 _s_t_r_i_c_t___m_a_i_l_t_o Type: boolean @@ -8345,12 +8397,14 @@ embedded. This may lead to (user) headers being overwriten without note if ``_$_e_d_i_t___h_e_a_d_e_r_s (section 6.4.54 , page 92)'' is unset. + The Mutt Next Generation E-Mail Client 158 + If this variable is _s_e_t, mutt-ng is strict and allows anything to be changed. If it's _u_n_s_e_t, all headers given will be prefixed with ``X-Mailto-'' and the message including headers will be shown in the editor regardless of what ``_$_e_d_i_t___h_e_a_d_e_r_s (section 6.4.54 , page 92)'' is set to. - _6_._4_._3_0_8 _s_t_r_i_c_t___m_i_m_e + _6_._4_._3_1_0 _s_t_r_i_c_t___m_i_m_e Type: boolean @@ -8365,43 +8419,43 @@ a single space to prevent the display of MIME-encoded ``Subject:'' header field from being devided into multiple lines. - _6_._4_._3_0_9 _s_t_r_i_c_t___t_h_r_e_a_d_s + _6_._4_._3_1_1 _s_t_r_i_c_t___t_h_r_e_a_d_s Type: boolean 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.4.289 , page 149)'' by mes- + ences:'' header fields when you ``_$_s_o_r_t (section 6.4.290 , page 149)'' 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'' which will get grouped together. - _6_._4_._3_1_0 _s_t_r_i_p___w_a_s + _6_._4_._3_1_2 _s_t_r_i_p___w_a_s Type: boolean Default: no - The Mutt Next Generation E-Mail Client 158 - When _s_e_t, mutt-ng will remove the trailing part of the ``Subject:'' line which - matches _$_s_t_r_i_p___w_a_s___r_e_g_e_x (section 6.4.311 , page 156) when replying. This is + matches _$_s_t_r_i_p___w_a_s___r_e_g_e_x (section 6.4.313 , page 157) when replying. This is useful to properly react on subject changes and reduce ``subject noise.'' (esp. in Usenet) - _6_._4_._3_1_1 _s_t_r_i_p___w_a_s___r_e_g_e_x + _6_._4_._3_1_3 _s_t_r_i_p___w_a_s___r_e_g_e_x Type: regular expression Default: '\([Ww][Aa][RrSs]: .*\)[ ]*$' - When non-empty and _$_s_t_r_i_p___w_a_s (section 6.4.310 , page 156) is _s_e_t, mutt-ng + When non-empty and _$_s_t_r_i_p___w_a_s (section 6.4.312 , page 157) is _s_e_t, mutt-ng will remove this trailing part of the ``Subject'' line when replying if it won't be empty afterwards. - _6_._4_._3_1_2 _s_t_u_f_f___q_u_o_t_e_d + The Mutt Next Generation E-Mail Client 159 + + _6_._4_._3_1_4 _s_t_u_f_f___q_u_o_t_e_d Type: boolean @@ -8410,7 +8464,7 @@ If _s_e_t, attachments with flowed format will have their quoting ``stuffed'', i.e. a space will be inserted between the quote characters and the actual text. - _6_._4_._3_1_3 _s_u_s_p_e_n_d + _6_._4_._3_1_5 _s_u_s_p_e_n_d Type: boolean @@ -8420,7 +8474,7 @@ usually CTRL+Z. This is useful if you run Mutt-ng inside an xterm using a com- mand like ``xterm -e muttng.'' - _6_._4_._3_1_4 _t_e_x_t___f_l_o_w_e_d + _6_._4_._3_1_6 _t_e_x_t___f_l_o_w_e_d Type: boolean @@ -8434,20 +8488,18 @@ Note that _$_i_n_d_e_n_t___s_t_r_i_n_g (section 6.4.109 , page 105) is ignored when this option is set. - _6_._4_._3_1_5 _t_h_o_r_o_u_g_h___s_e_a_r_c_h + _6_._4_._3_1_7 _t_h_o_r_o_u_g_h___s_e_a_r_c_h Type: boolean Default: no - The Mutt Next Generation E-Mail Client 159 - Affects the ~b and ~h search operations described in section ``_p_a_t_t_e_r_n_s (sec- tion 6.2 , page 77)'' above. If _s_e_t, the headers and attachments of messages to be searched are decoded before searching. If _u_n_s_e_t, messages are searched as they appear in the folder. - _6_._4_._3_1_6 _t_h_r_e_a_d___r_e_c_e_i_v_e_d + _6_._4_._3_1_8 _t_h_r_e_a_d___r_e_c_e_i_v_e_d Type: boolean @@ -8456,7 +8508,9 @@ When _s_e_t, Mutt-ng uses the date received rather than the date sent to thread messages by subject. - _6_._4_._3_1_7 _t_i_l_d_e + The Mutt Next Generation E-Mail Client 160 + + _6_._4_._3_1_9 _t_i_l_d_e Type: boolean @@ -8465,7 +8519,7 @@ When _s_e_t, the internal-pager will pad blank lines to the bottom of the screen with a tilde (~). - _6_._4_._3_1_8 _t_i_m_e_o_u_t + _6_._4_._3_2_0 _t_i_m_e_o_u_t Type: number @@ -8475,7 +8529,7 @@ pressed in the main menu before timing out and checking for new mail. A value of zero or less will cause Mutt-ng to never time out. - _6_._4_._3_1_9 _t_m_p_d_i_r + _6_._4_._3_2_1 _t_m_p_d_i_r Type: path @@ -8486,7 +8540,7 @@ set, the environment variable $TMPDIR is used. If $TMPDIR is not set then '/tmp' is used. - _6_._4_._3_2_0 _t_o___c_h_a_r_s + _6_._4_._3_2_2 _t_o___c_h_a_r_s Type: string @@ -8496,16 +8550,13 @@ acter is the one used when the mail is NOT addressed to your address (default: space). The second is used when you are the only recipient of the message (default: +). The third is when your address appears in the ``To:'' header - - The Mutt Next Generation E-Mail Client 160 - field, but you are not the only recipient of the message (default: T). The fourth character is used when your address is specified in the ``Cc:'' header field, but you are not the only recipient. The fifth character is used to indicate mail that was sent by _y_o_u. The sixth character is used to indicate when a mail was sent to a mailing-list you're subscribe to (default: L). - _6_._4_._3_2_1 _t_r_a_s_h + _6_._4_._3_2_3 _t_r_a_s_h Type: path @@ -8514,10 +8565,12 @@ If _s_e_t, this variable specifies the path of the trash folder where the mails marked for deletion will be moved, instead of being irremediably purged. + The Mutt Next Generation E-Mail Client 161 + NNoottee: When you delete a message in the trash folder, it is really deleted, so that there is no way to recover mail. - _6_._4_._3_2_2 _t_u_n_n_e_l + _6_._4_._3_2_4 _t_u_n_n_e_l Type: string @@ -8532,7 +8585,7 @@ NNoottee:: For this example to work you must be able to log in to the remote machine without having to enter a password. - _6_._4_._3_2_3 _u_m_a_s_k + _6_._4_._3_2_5 _u_m_a_s_k Type: number @@ -8541,7 +8594,7 @@ This sets the umask that will be used by Mutt-ng when creating all kinds of files. If _u_n_s_e_t, the default value is 077. - _6_._4_._3_2_4 _u_n_c_o_l_l_a_p_s_e___j_u_m_p + _6_._4_._3_2_6 _u_n_c_o_l_l_a_p_s_e___j_u_m_p Type: boolean @@ -8550,12 +8603,10 @@ When _s_e_t, Mutt-ng will jump to the next unread message, if any, when the cur- rent thread is _u_ncollapsed. - _6_._4_._3_2_5 _u_s_e___8_b_i_t_m_i_m_e + _6_._4_._3_2_7 _u_s_e___8_b_i_t_m_i_m_e Type: boolean - The Mutt Next Generation E-Mail Client 161 - Default: no WWaarrnniinngg:: do not set this variable unless you are using a version of sendmail @@ -8565,17 +8616,19 @@ When _s_e_t, Mutt-ng will invoke ``_$_s_e_n_d_m_a_i_l (section 6.4.247 , page 140)'' with the -B8BITMIME flag when sending 8-bit messages to enable ESMTP negotiation. - _6_._4_._3_2_6 _u_s_e___d_o_m_a_i_n + _6_._4_._3_2_8 _u_s_e___d_o_m_a_i_n Type: boolean Default: yes + The Mutt Next Generation E-Mail Client 162 + When _s_e_t, Mutt-ng will qualify all local addresses (ones without the @host por- tion) with the value of ``_$_h_o_s_t_n_a_m_e (section 6.4.89 , page 100)''. If _u_n_s_e_t, no addresses will be qualified. - _6_._4_._3_2_7 _u_s_e___f_r_o_m + _6_._4_._3_2_9 _u_s_e___f_r_o_m Type: boolean @@ -8585,7 +8638,7 @@ sages. If _u_n_s_e_t, no ``From:'' header field will be generated unless the user explicitly sets one using the ``_m_y___h_d_r (section 3.15 , page 34)'' command. - _6_._4_._3_2_8 _u_s_e___i_d_n + _6_._4_._3_3_0 _u_s_e___i_d_n Type: boolean @@ -8598,7 +8651,7 @@ NNoottee:: You can use IDNs for addresses even if this is _u_n_s_e_t. This variable only affects decoding. - _6_._4_._3_2_9 _u_s_e___i_p_v_6 + _6_._4_._3_3_1 _u_s_e___i_p_v_6 Type: boolean @@ -8608,9 +8661,7 @@ If this option is _u_n_s_e_t, Mutt-ng will restrict itself to IPv4 addresses. Nor- mally, the default should work. - _6_._4_._3_3_0 _u_s_e_r___a_g_e_n_t - - The Mutt Next Generation E-Mail Client 162 + _6_._4_._3_3_2 _u_s_e_r___a_g_e_n_t Type: boolean @@ -8619,7 +8670,7 @@ When _s_e_t, Mutt-ng will add a ``User-Agent:'' header to outgoing messages, indi- cating which version of Mutt-ng was used for composing them. - _6_._4_._3_3_1 _v_i_s_u_a_l + _6_._4_._3_3_3 _v_i_s_u_a_l Type: path @@ -8628,7 +8679,9 @@ Specifies the visual editor to invoke when the _~_v command is given in the builtin editor. - _6_._4_._3_3_2 _w_a_i_t___k_e_y + The Mutt Next Generation E-Mail Client 163 + + _6_._4_._3_3_4 _w_a_i_t___k_e_y Type: boolean @@ -8644,7 +8697,7 @@ When _s_e_t, Mutt-ng will always ask for a key. When _u_n_s_e_t, Mutt-ng will wait for a key only if the external command returned a non-zero status. - _6_._4_._3_3_3 _w_e_e_d + _6_._4_._3_3_5 _w_e_e_d Type: boolean @@ -8653,7 +8706,7 @@ When _s_e_t, Mutt-ng will weed headers when displaying, forwarding, printing, or replying to messages. - _6_._4_._3_3_4 _w_r_a_p___s_e_a_r_c_h + _6_._4_._3_3_6 _w_r_a_p___s_e_a_r_c_h Type: boolean @@ -8664,9 +8717,7 @@ When _s_e_t, searches will wrap around the first (or last) message. When _u_n_s_e_t, searches will not wrap. - _6_._4_._3_3_5 _w_r_a_p_m_a_r_g_i_n - - The Mutt Next Generation E-Mail Client 163 + _6_._4_._3_3_7 _w_r_a_p_m_a_r_g_i_n Type: number @@ -8675,7 +8726,7 @@ Controls the size of the margin remaining at the right side of the terminal when Mutt-ng's pager does smart wrapping. - _6_._4_._3_3_6 _w_r_i_t_e___b_c_c + _6_._4_._3_3_8 _w_r_i_t_e___b_c_c Type: boolean @@ -8684,7 +8735,9 @@ Controls whether Mutt-ng writes out the Bcc header when preparing messages to be sent. Exim users may wish to _u_n_s_e_t this. - _6_._4_._3_3_7 _w_r_i_t_e___i_n_c + The Mutt Next Generation E-Mail Client 164 + + _6_._4_._3_3_9 _w_r_i_t_e___i_n_c Type: number @@ -8696,23 +8749,23 @@ Also see the ``_$_r_e_a_d___i_n_c (section 6.4.226 , page 135)'' variable. - _6_._4_._3_3_8 _x_t_e_r_m___i_c_o_n + _6_._4_._3_4_0 _x_t_e_r_m___i_c_o_n Type: string 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.4.340 , page 162) 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.4.305 , page 153)''. + tion 6.4.342 , page 163) 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.4.307 , page 154)''. - _6_._4_._3_3_9 _x_t_e_r_m___l_e_a_v_e + _6_._4_._3_4_1 _x_t_e_r_m___l_e_a_v_e Type: string Default: '' - If _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (section 6.4.340 , page 162) 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.4.342 , page 163) 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. @@ -8722,9 +8775,7 @@ set xterm_leave = '`test x$DISPLAY != x && xprop -id $WINDOWID | grep WM_NAME | cut -d ''' -f 2`' - The Mutt Next Generation E-Mail Client 164 - - _6_._4_._3_4_0 _x_t_e_r_m___s_e_t___t_i_t_l_e_s + _6_._4_._3_4_2 _x_t_e_r_m___s_e_t___t_i_t_l_e_s Type: boolean @@ -8734,16 +8785,18 @@ you're in an appropriate terminal). The default must be _u_n_s_e_t to force in the validity checking. - _6_._4_._3_4_1 _x_t_e_r_m___t_i_t_l_e + _6_._4_._3_4_3 _x_t_e_r_m___t_i_t_l_e Type: string Default: 'Mutt-ng with %?m?%m messages&no messages?%?n? [%n New]?' + The Mutt Next Generation E-Mail Client 165 + 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.4.340 , page 162) 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.4.305 , - page 153)''. + _$_x_t_e_r_m___s_e_t___t_i_t_l_e_s (section 6.4.342 , page 163) 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.4.307 , + page 154)''. _6_._5 _F_u_n_c_t_i_o_n_s @@ -8759,8 +8812,6 @@ tings for this menu will affect the default bindings for all menus (except as noted). - The Mutt Next Generation E-Mail Client 165 - bottom-page L move to the bottom of the page current-bottom not bound move current entry to bottom of page current-middle not bound move current entry to middle of page @@ -8793,9 +8844,11 @@ top-page H move to the top of the page what-key not bound display the keycode for a key press + The Mutt Next Generation E-Mail Client 166 + _6_._5_._2 _i_n_d_e_x - The Mutt Next Generation E-Mail Client 166 + The Mutt Next Generation E-Mail Client 167 bounce-message b remail a message to another user change-folder c open a different folder @@ -8852,7 +8905,7 @@ show-version V show the Mutt-ng version number and date show-limit ESC l show currently active limit pattern, if any - The Mutt Next Generation E-Mail Client 167 + The Mutt Next Generation E-Mail Client 168 sort-mailbox o sort messages sort-reverse O sort messages in reverse order @@ -8870,7 +8923,7 @@ _6_._5_._3 _p_a_g_e_r - The Mutt Next Generation E-Mail Client 168 + The Mutt Next Generation E-Mail Client 169 bottom not bound jump to the bottom of the message bounce-message b remail a message to another user @@ -8927,7 +8980,7 @@ recall-message R recall a postponed message redraw-screen ^L clear and redraw the screen - The Mutt Next Generation E-Mail Client 169 + The Mutt Next Generation E-Mail Client 170 reply r reply to a message save-message s save message/attachment to a file @@ -8967,7 +9020,7 @@ _6_._5_._6 _a_t_t_a_c_h - The Mutt Next Generation E-Mail Client 170 + The Mutt Next Generation E-Mail Client 171 bounce-message b remail a message to another user collapse-parts v toggle display of subparts @@ -8990,7 +9043,7 @@ _6_._5_._7 _c_o_m_p_o_s_e - The Mutt Next Generation E-Mail Client 171 + The Mutt Next Generation E-Mail Client 172 attach-file a attach a file(s) to this message attach-message A attach message(s) to this message @@ -9033,7 +9086,7 @@ _6_._5_._9 _b_r_o_w_s_e_r - The Mutt Next Generation E-Mail Client 172 + The Mutt Next Generation E-Mail Client 173 change-dir c change directories check-new TAB check mailboxes for new mail @@ -9082,7 +9135,7 @@ _7_. _M_i_s_c_e_l_l_a_n_y - The Mutt Next Generation E-Mail Client 173 + The Mutt Next Generation E-Mail Client 174 _7_._1 _A_c_k_n_o_w_l_e_d_g_m_e_n_t_s @@ -9127,7 +9180,7 @@ Marco d'Itri , - Bjoern Jacke , + Bjrn Jacke , Byrial Jensen , @@ -9139,11 +9192,11 @@ Felix von Leitner (a.k.a ``Fefe'') , - The Mutt Next Generation E-Mail Client 174 + The Mutt Next Generation E-Mail Client 175 Brandon Long , - Jimmy Maekelae , + Jimmy Mkel , Lars Marowsky-Bree , @@ -9185,6 +9238,8 @@ The following people have been very helpful to the development of Mutt-ng: + Christian Gall + Iain Lea Andreas Kneib @@ -9193,14 +9248,14 @@ Elimar Riesebieter - _7_._2 _A_b_o_u_t _t_h_i_s _d_o_c_u_m_e_n_t + The Mutt Next Generation E-Mail Client 176 - The Mutt Next Generation E-Mail Client 175 + _7_._2 _A_b_o_u_t _t_h_i_s _d_o_c_u_m_e_n_t This document was written in SGML, and then rendered using the sgml-tools pack- age. - The Mutt Next Generation E-Mail Client 176 + The Mutt Next Generation E-Mail Client 177 CONTENTS @@ -9315,23 +9370,24 @@ 4.14.2 Authentication 61 4.15 NNTP Support (OPTIONAL) ........................................ 62 4.15.1 Again: Scoring 62 - 4.16 Managing multiple IMAP/POP/NNTP accounts (OPTIONAL) ............ 63 - 4.17 Start a WWW Browser on URLs (EXTERNAL) ......................... 63 - 4.18 Compressed folders Support (OPTIONAL) .......................... 64 - 4.18.1 Open a compressed mailbox for reading 64 - 4.18.2 Write a compressed mailbox 65 - 4.18.3 Append a message to a compressed mailbox 65 - 4.18.4 Encrypted folders 66 - - 5. Mutt-ng's MIME Support ............................................... 66 + 4.16 SMTP Support (OPTIONAL) ........................................ 63 + 4.17 Managing multiple IMAP/POP/NNTP accounts (OPTIONAL) ............ 63 + 4.18 Start a WWW Browser on URLs (EXTERNAL) ......................... 64 + 4.19 Compressed folders Support (OPTIONAL) .......................... 64 + 4.19.1 Open a compressed mailbox for reading 65 + 4.19.2 Write a compressed mailbox 65 + 4.19.3 Append a message to a compressed mailbox 66 + 4.19.4 Encrypted folders 66 + + 5. Mutt-ng's MIME Support ............................................... 67 5.1 Using MIME in Mutt ............................................. 67 5.1.1 Viewing MIME messages in the pager 67 5.1.2 The Attachment Menu 67 - 5.1.3 The Compose Menu 67 + 5.1.3 The Compose Menu 68 5.2 MIME Type configuration with mime.types ........................ 68 5.3 MIME Viewer configuration with mailcap ......................... 69 5.3.1 The Basics of the mailcap file 69 - 5.3.2 Secure use of mailcap 70 + 5.3.2 Secure use of mailcap 71 5.3.3 Advanced mailcap Usage 71 5.3.4 Example mailcap files 74 5.4 MIME Autoview .................................................. 75 @@ -9364,10 +9420,10 @@ 6.4.19 beep_new 86 6.4.20 bounce 86 6.4.21 bounce_delivered 86 - 6.4.22 braille_friendly 86 iii + 6.4.22 braille_friendly 86 6.4.23 certificate_file 86 6.4.24 charset 87 6.4.25 check_new 87 @@ -9420,10 +9476,10 @@ 6.4.72 forward_format 98 6.4.73 forward_quote 98 6.4.74 from 98 - 6.4.75 gecos_mask 98 iv + 6.4.75 gecos_mask 98 6.4.76 hdrs 99 6.4.77 header 99 6.4.78 header_cache 99 @@ -9440,8 +9496,8 @@ 6.4.89 hostname 101 6.4.90 ignore_list_reply_to 102 6.4.91 imap_authenticators 102 - 6.4.92 imap_delim_chars 102 - 6.4.93 imap_force_ssl 103 + 6.4.92 imap_check_subscribed 102 + 6.4.93 imap_delim_chars 102 6.4.94 imap_headers 103 6.4.95 imap_home_namespace 103 6.4.96 imap_keepalive 103 @@ -9476,10 +9532,10 @@ 6.4.125 mbox_type 112 6.4.126 menu_context 112 6.4.127 menu_move_off 112 - 6.4.128 menu_scroll 112 v + 6.4.128 menu_scroll 112 6.4.129 message_format 113 6.4.130 meta_key 113 6.4.131 metoo 113 @@ -9532,10 +9588,10 @@ 6.4.178 pgp_encrypt_sign_command 125 6.4.179 pgp_entry_format 125 6.4.180 pgp_export_command 126 - 6.4.181 pgp_getkeys_command 126 vi + 6.4.181 pgp_getkeys_command 126 6.4.182 pgp_good_sign 126 6.4.183 pgp_ignore_subkeys 126 6.4.184 pgp_import_command 127 @@ -9588,10 +9644,10 @@ 6.4.231 reply_regexp 137 6.4.232 reply_self 137 6.4.233 reply_to 137 - 6.4.234 resolve 138 vii + 6.4.234 resolve 138 6.4.235 reverse_alias 138 6.4.236 reverse_name 138 6.4.237 reverse_realname 138 @@ -9611,116 +9667,118 @@ 6.4.251 sidebar_delim 142 6.4.252 sidebar_newmail_only 142 6.4.253 sidebar_number_format 142 - 6.4.254 sidebar_shorten_hierarchy 142 + 6.4.254 sidebar_shorten_hierarchy 143 6.4.255 sidebar_visible 143 6.4.256 sidebar_width 143 6.4.257 sig_dashes 143 - 6.4.258 sig_on_top 143 + 6.4.258 sig_on_top 144 6.4.259 signature 144 6.4.260 signoff_string 144 6.4.261 simple_search 144 - 6.4.262 sleep_time 144 - 6.4.263 smart_wrap 144 + 6.4.262 sleep_time 145 + 6.4.263 smart_wrap 145 6.4.264 smileys 145 6.4.265 smime_ask_cert_label 145 6.4.266 smime_ca_location 145 6.4.267 smime_certificates 145 - 6.4.268 smime_decrypt_command 145 + 6.4.268 smime_decrypt_command 146 6.4.269 smime_decrypt_use_default_key 146 - 6.4.270 smime_default_key 146 + 6.4.270 smime_default_key 147 6.4.271 smime_encrypt_command 147 6.4.272 smime_encrypt_with 147 6.4.273 smime_get_cert_command 147 6.4.274 smime_get_cert_email_command 147 6.4.275 smime_get_signer_cert_command 147 - 6.4.276 smime_import_cert_command 147 + 6.4.276 smime_import_cert_command 148 6.4.277 smime_is_default 148 6.4.278 smime_keys 148 6.4.279 smime_pk7out_command 148 - 6.4.280 smime_sign_command 148 - 6.4.281 smime_sign_opaque_command 148 + 6.4.280 smime_sign_command 149 + 6.4.281 smime_sign_opaque_command 149 6.4.282 smime_timeout 149 6.4.283 smime_verify_command 149 6.4.284 smime_verify_opaque_command 149 - 6.4.285 smtp_auth_password 149 - 6.4.286 smtp_auth_username 149 - 6.4.287 smtp_host 150 + 6.4.285 smtp_host 149 + 6.4.286 smtp_pass 150 viii - 6.4.288 smtp_port 150 - 6.4.289 sort 150 - 6.4.290 sort_alias 151 - 6.4.291 sort_aux 151 - 6.4.292 sort_browser 151 - 6.4.293 sort_re 152 - 6.4.294 spam_separator 152 - 6.4.295 spoolfile 152 - 6.4.296 ssl_ca_certificates_file 152 - 6.4.297 ssl_client_cert 153 - 6.4.298 ssl_min_dh_prime_bits 153 - 6.4.299 ssl_starttls 153 - 6.4.300 ssl_use_sslv2 153 - 6.4.301 ssl_use_sslv3 153 - 6.4.302 ssl_use_tlsv1 154 - 6.4.303 ssl_usesystemcerts 154 - 6.4.304 status_chars 154 - 6.4.305 status_format 154 - 6.4.306 status_on_top 156 - 6.4.307 strict_mailto 157 - 6.4.308 strict_mime 157 - 6.4.309 strict_threads 157 - 6.4.310 strip_was 157 - 6.4.311 strip_was_regex 158 - 6.4.312 stuff_quoted 158 - 6.4.313 suspend 158 - 6.4.314 text_flowed 158 - 6.4.315 thorough_search 158 - 6.4.316 thread_received 159 - 6.4.317 tilde 159 - 6.4.318 timeout 159 - 6.4.319 tmpdir 159 - 6.4.320 to_chars 159 - 6.4.321 trash 160 - 6.4.322 tunnel 160 - 6.4.323 umask 160 - 6.4.324 uncollapse_jump 160 - 6.4.325 use_8bitmime 160 - 6.4.326 use_domain 161 - 6.4.327 use_from 161 - 6.4.328 use_idn 161 - 6.4.329 use_ipv6 161 - 6.4.330 user_agent 161 - 6.4.331 visual 162 - 6.4.332 wait_key 162 - 6.4.333 weed 162 - 6.4.334 wrap_search 162 - 6.4.335 wrapmargin 162 - 6.4.336 write_bcc 163 - 6.4.337 write_inc 163 - 6.4.338 xterm_icon 163 - 6.4.339 xterm_leave 163 - 6.4.340 xterm_set_titles 164 + 6.4.287 smtp_port 150 + 6.4.288 smtp_use_tls 150 + 6.4.289 smtp_user 150 + 6.4.290 sort 151 + 6.4.291 sort_alias 151 + 6.4.292 sort_aux 151 + 6.4.293 sort_browser 152 + 6.4.294 sort_re 152 + 6.4.295 spam_separator 152 + 6.4.296 spoolfile 153 + 6.4.297 ssl_ca_certificates_file 153 + 6.4.298 ssl_client_cert 153 + 6.4.299 ssl_force_tls 153 + 6.4.300 ssl_min_dh_prime_bits 153 + 6.4.301 ssl_starttls 154 + 6.4.302 ssl_use_sslv2 154 + 6.4.303 ssl_use_sslv3 154 + 6.4.304 ssl_use_tlsv1 154 + 6.4.305 ssl_usesystemcerts 154 + 6.4.306 status_chars 155 + 6.4.307 status_format 155 + 6.4.308 status_on_top 157 + 6.4.309 strict_mailto 157 + 6.4.310 strict_mime 158 + 6.4.311 strict_threads 158 + 6.4.312 strip_was 158 + 6.4.313 strip_was_regex 158 + 6.4.314 stuff_quoted 159 + 6.4.315 suspend 159 + 6.4.316 text_flowed 159 + 6.4.317 thorough_search 159 + 6.4.318 thread_received 159 + 6.4.319 tilde 160 + 6.4.320 timeout 160 + 6.4.321 tmpdir 160 + 6.4.322 to_chars 160 + 6.4.323 trash 160 + 6.4.324 tunnel 161 + 6.4.325 umask 161 + 6.4.326 uncollapse_jump 161 + 6.4.327 use_8bitmime 161 + 6.4.328 use_domain 161 + 6.4.329 use_from 162 + 6.4.330 use_idn 162 + 6.4.331 use_ipv6 162 + 6.4.332 user_agent 162 + 6.4.333 visual 162 + 6.4.334 wait_key 163 + 6.4.335 weed 163 + 6.4.336 wrap_search 163 + 6.4.337 wrapmargin 163 + 6.4.338 write_bcc 163 + 6.4.339 write_inc 164 ix - 6.4.341 xterm_title 164 - 6.5 Functions ....................................................... 164 - 6.5.1 generic 164 - 6.5.2 index 165 - 6.5.3 pager 167 - 6.5.4 alias 169 - 6.5.5 query 169 - 6.5.6 attach 169 - 6.5.7 compose 170 - 6.5.8 postpone 171 - 6.5.9 browser 171 - 6.5.10 pgp 172 - 6.5.11 editor 172 - - 7. Miscellany ............................................................ 172 - 7.1 Acknowledgments ................................................. 173 - 7.2 About this document ............................................. 174 + 6.4.340 xterm_icon 164 + 6.4.341 xterm_leave 164 + 6.4.342 xterm_set_titles 164 + 6.4.343 xterm_title 164 + 6.5 Functions ....................................................... 165 + 6.5.1 generic 165 + 6.5.2 index 166 + 6.5.3 pager 168 + 6.5.4 alias 170 + 6.5.5 query 170 + 6.5.6 attach 170 + 6.5.7 compose 171 + 6.5.8 postpone 172 + 6.5.9 browser 172 + 6.5.10 pgp 173 + 6.5.11 editor 173 + + 7. Miscellany ............................................................ 173 + 7.1 Acknowledgments ................................................. 174 + 7.2 About this document ............................................. 176 x