X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=doc%2Fmanual.txt;h=e87de1edc56d0a788f791a3537dcf333d8c9a780;hp=e6b7aa8f9e09c3993687bf1970f91c409c4d1d37;hb=1b29c92e5a96be51f4a16728a73485eb4daf6563;hpb=b4827293ce79b576beb9550b91e71a198f2f5744 diff --git a/doc/manual.txt b/doc/manual.txt index e6b7aa8..e87de1e 100644 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -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 @@ -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. @@ -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- @@ -5458,7 +5462,7 @@ This variable, when _s_e_t, makes the thread tree narrower, allowing deeper threads to fit on the screen. - _6_._3_._1_4_3 _n_n_t_p___a_s_k___f_o_l_l_o_w___u_p + _6_._3_._1_4_3 _n_n_t_p___a_s_k___f_o_l_l_o_w_u_p___t_o Type: boolean @@ -5517,8 +5521,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. @@ -8060,10 +8064,28 @@ 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.336 , page 146) is _s_e_t. This string is identical in formatting to the + tion 6.3.337 , page 146) 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___s_e_t___t_i_t_l_e_s + _6_._3_._3_3_6 _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.3.337 , page 146) 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: + + The Mutt-ng E-Mail Client 148 + + 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 Type: boolean @@ -8073,16 +8095,14 @@ you're in an appropriate terminal). The default must be _u_n_s_e_t to force in the validity checking. - _6_._3_._3_3_7 _x_t_e_r_m___t_i_t_l_e - - The Mutt-ng E-Mail Client 148 + _6_._3_._3_3_8 _x_t_e_r_m___t_i_t_l_e Type: string 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.336 , 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 146) 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)''. @@ -8100,6 +8120,8 @@ tings for this menu will affect the default bindings for all menus (except as noted). + The Mutt-ng E-Mail Client 149 + 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 @@ -8130,9 +8152,6 @@ tag-prefix ; apply next command to tagged entries tag-prefix-cond not bound apply next function ONLY to tagged messages top-page H move to the top of the page - - The Mutt-ng E-Mail Client 149 - what-key not bound display the keycode for a key press _6_._4_._2 _i_n_d_e_x @@ -8431,7 +8450,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 , @@ -8515,8 +8534,21 @@ 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 _7_._2 _A_b_o_u_t _t_h_i_s _d_o_c_u_m_e_n_t