X-Git-Url: http://git.madism.org/?p=apps%2Fmadmutt.git;a=blobdiff_plain;f=doc%2Fmanual.txt;h=21cbd6ff891cd354873cafe7ef2e1064c66faf3c;hp=a635dc938ffa1e1b744746701f17c9a8df099cb8;hb=bad8211c28d4b229878e0264012009493db48da5;hpb=e3fcff4c503373a3f98676405783926e387f7139 diff --git a/doc/manual.txt b/doc/manual.txt index a635dc9..21cbd6f 100644 --- a/doc/manual.txt +++ b/doc/manual.txt @@ -3,7 +3,7 @@ by Michael Elkins and others. - version devel-r353 + version devel-r371 AAbbssttrraacctt @@ -956,6 +956,7 @@ \t tab tab + backtab / shift-tab \r carriage return \n newline \e escape @@ -999,10 +1000,10 @@ _3_._5 _S_e_t_t_i_n_g _v_a_r_i_a_b_l_e_s _b_a_s_e_d _u_p_o_n _m_a_i_l_b_o_x - Usage: folder-hook [!]_r_e_g_e_x_p _c_o_m_m_a_n_d - The Mutt-ng E-Mail Client 20 + Usage: folder-hook [!]_r_e_g_e_x_p _c_o_m_m_a_n_d + It is often desirable to change settings based on which mailbox you are read- ing. The folder-hook command provides a method by which you can execute any configuration command. _r_e_g_e_x_p is a regular expression specifying in which @@ -1051,11 +1052,12 @@ 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 having particular key definitions. This makes them more robust and portable, - and also facilitates defining of macros in files used by more than one user - (eg. the system Muttngrc). The Mutt-ng E-Mail Client 21 + and also facilitates defining of macros in files used by more than one user + (eg. the system Muttngrc). + Optionally you can specify a descriptive text after _s_e_q_u_e_n_c_e, which is shown in the help screens. @@ -1106,12 +1108,12 @@ +o search (highlighting of words in the pager) + The Mutt-ng E-Mail Client 22 + +o signature +o status (mode lines used to display info about the mailbox or message) - The Mutt-ng E-Mail Client 22 - +o tilde (the ``~'' used to pad blank lines in the pager) +o tree (thread tree drawn in the message index and attachment menu) @@ -1160,13 +1162,13 @@ command for it to be removed. The pattern ``*'' is a special token which means to clear the color index list of all entries. + The Mutt-ng E-Mail Client 23 + Mutt-ng also recognizes the keywords _c_o_l_o_r_0, _c_o_l_o_r_1, ..., _c_o_l_o_rNN--11 (NN being the number of colors supported by your terminal). This is useful when you remap the colors for your display (for example by changing the color associated with _c_o_l_o_r_2 for your xterm), since color names may then lose their normal meaning. - The Mutt-ng E-Mail Client 23 - If your terminal does not support color, it is still possible change the video attributes through the use of the ``mono'' command: @@ -1215,14 +1217,13 @@ unignore organization organisation x-mailer: x-newsreader: x-mailing-list: unignore posted-to: + The Mutt-ng E-Mail Client 24 + _3_._9 _A_l_t_e_r_n_a_t_i_v_e _a_d_d_r_e_s_s_e_s Usage: [un]alternates _r_e_g_e_x_p [ _r_e_g_e_x_p ... ] With various functions, mutt will treat messages differently, depending on - - The Mutt-ng E-Mail Client 24 - whether you sent them or whether you received them from someone else. For instance, when replying to a message that you sent to a different party, mutt will automatically suggest to send the response to the original message's @@ -1272,14 +1273,14 @@ You can use regular expressions with both commands. To mark all messages sent to a specific bug report's address on mutt's bug tracking system as list mail, + + The Mutt-ng E-Mail Client 25 + for instance, you could say ``subscribe [0-9]*@bugs.guug.de''. Often, it's sufficient to just give a portion of the list's e-mail address. Specify as much of the address as you need to to remove ambiguity. For exam- ple, if you've subscribed to the Mutt-ng mailing list, you will receive mail - - The Mutt-ng E-Mail Client 25 - addressed to _m_u_t_t_-_u_s_e_r_s_@_m_u_t_t_._o_r_g. So, to tell Mutt-ng that this is a mailing list, you could add ``lists mutt-users'' to your initialization file. To tell mutt that you are subscribed to it, add ``subscribe mutt-users'' to your ini- @@ -1330,13 +1331,12 @@ they do not properly reset the access time. Backup tools are another common reason for updated access times. + The Mutt-ng E-Mail Client 26 + NNoottee:: the filenames in the mailboxes command are resolved when the command is 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.8 , page 44) (such as ``='' and ``!''), any variable definition that affect these char- acters (like _$_f_o_l_d_e_r (section 6.3.64 , page 79) and _$_s_p_o_o_l_f_i_l_e (section - - The Mutt-ng E-Mail Client 26 - 6.3.295 , 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 @@ -1383,10 +1383,10 @@ ``unhdr_order *'' will clear all previous headers from the order list, thus removing the header order effects set by the system-wide startup file. - hdr_order From Date: From: To: Cc: Subject: - The Mutt-ng E-Mail Client 27 + hdr_order From Date: From: To: Cc: Subject: + _3_._1_5 _S_p_e_c_i_f_y _d_e_f_a_u_l_t _s_a_v_e _f_i_l_e_n_a_m_e Usage: save-hook [!]_p_a_t_t_e_r_n _f_i_l_e_n_a_m_e @@ -1436,12 +1436,12 @@ Usage: reply-hook [!]_p_a_t_t_e_r_n _c_o_m_m_a_n_d + The Mutt-ng E-Mail Client 28 + Usage: send-hook [!]_p_a_t_t_e_r_n _c_o_m_m_a_n_d Usage: send2-hook [!]_p_a_t_t_e_r_n _c_o_m_m_a_n_d - The Mutt-ng E-Mail Client 28 - These commands can be used to execute arbitrary configuration commands based upon recipients of the message. _p_a_t_t_e_r_n is a regular expression matching the desired address. _c_o_m_m_a_n_d is executed when _r_e_g_e_x_p matches recipients of the @@ -1493,11 +1493,11 @@ Example: + The Mutt-ng E-Mail Client 29 + message-hook ~A 'set pager=builtin' message-hook '~f freshmeat-news' 'set pager="less \"+/^ subject: .*\""' - The Mutt-ng E-Mail Client 29 - _3_._2_0 _C_h_o_o_s_i_n_g _t_h_e _c_r_y_p_t_o_g_r_a_p_h_i_c _k_e_y _o_f _t_h_e _r_e_c_i_p_i_e_n_t Usage: crypt-hook _p_a_t_t_e_r_n _k_e_y_i_d @@ -1548,12 +1548,12 @@ same pattern specified in the score command for it to be removed. The pattern ``*'' is a special token which means to clear the list of all score entries. + The Mutt-ng E-Mail Client 30 + _3_._2_4 _S_p_a_m _d_e_t_e_c_t_i_o_n Usage: spam _p_a_t_t_e_r_n _f_o_r_m_a_t - The Mutt-ng E-Mail Client 30 - Usage: nospam _p_a_t_t_e_r_n Mutt-ng has generalized support for external spam-scoring filters. By defining @@ -1604,12 +1604,12 @@ expression matches against for _s_e_a_r_c_h and _l_i_m_i_t functions. And it's what sort- ing by spam attribute will use as a sort key. + The Mutt-ng E-Mail Client 31 + That's a pretty complicated example, and most people's actual environments will have only one spam filter. The simpler your configuration, the more effective mutt can be, especially when it comes to sorting. - The Mutt-ng E-Mail Client 31 - Generally, when you sort by spam tag, mutt will sort _l_e_x_i_c_a_l_l_y -- that is, by ordering strings alphnumerically. However, if a spam tag begins with a number, mutt will sort numerically first, and lexically only when two numbers are equal @@ -1659,14 +1659,13 @@ be enclosed in quotes if they contain spaces or tabs. You may also use the ``C'' escape sequences \\nn and \\tt for newline and tab, respectively. - _q_u_a_d_o_p_t_i_o_n variables are used to control whether or not to be prompted for cer- - tain actions, or to specify a default action. A value of _y_e_s will cause the - action to be carried out automatically as if you had answered yes to the - The Mutt-ng E-Mail Client 32 - question. Similarly, a value of _n_o will cause the the action to be carried out - as if you had answered ``no.'' A value of _a_s_k_-_y_e_s will cause a prompt with a + _q_u_a_d_o_p_t_i_o_n variables are used to control whether or not to be prompted for cer- + tain actions, or to specify a default action. A value of _y_e_s will cause the + action to be carried out automatically as if you had answered yes to the ques- + tion. Similarly, a value of _n_o will cause the the action to be carried out as + if you had answered ``no.'' A value of _a_s_k_-_y_e_s will cause a prompt with a default answer of ``yes'' and _a_s_k_-_n_o will provide a default answer of ``no.'' Prefixing a variable with ``no'' will unset it. Example: set noaskbcc. @@ -1714,12 +1713,11 @@ Usage: ifdef _i_t_e_m _c_o_m_m_a_n_d + The Mutt-ng E-Mail Client 33 + 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 - available or not respectively, before actually executing the command given. ifdef (short for ``if defined'') only executes the command upon availability @@ -1767,16 +1765,15 @@ _4_. _A_d_v_a_n_c_e_d _U_s_a_g_e - _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 - 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. + _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. 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 @@ -1824,11 +1821,11 @@ [:blank:] Space or tab characters. + The Mutt-ng E-Mail Client 35 + [:cntrl:] Control characters. - The Mutt-ng E-Mail Client 35 - [:digit:] Numeric characters. @@ -1881,11 +1878,11 @@ A regular expression matching a single character may be followed by one of sev- eral repetition operators: + The Mutt-ng E-Mail Client 36 + ? 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. @@ -1936,11 +1933,11 @@ Matches any word-constituent character (letter, digit, or under- score). + The Mutt-ng E-Mail Client 37 + \\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). @@ -3780,7 +3777,7 @@ Default: '~/.mutt_certificates' - Availability: SSL or NSS or GNUTLS + Availability: SSL or GNUTLS This variable specifies the file where the certificates you trust are saved. When an unknown certificate is encountered, you are asked if you accept it or @@ -4202,7 +4199,7 @@ Default: '' - Availability: SSL or NSS + Availability: SSL The file which includes random data that is used to initialize SSL library functions. @@ -7531,7 +7528,7 @@ Default: yes - Availability: SSL or NSS + Availability: SSL This variables specifies whether to attempt to use SSLv2 in the SSL authentica- tion process. @@ -7542,7 +7539,7 @@ Default: yes - Availability: SSL or NSS or GNUTLS + Availability: SSL or GNUTLS This variables specifies whether to attempt to use SSLv3 in the SSL authentica- tion process. @@ -7553,7 +7550,7 @@ Default: yes - Availability: SSL or NSS or GNUTLS + Availability: SSL or GNUTLS This variables specifies whether to attempt to use TLSv1 in the SSL authentica- tion process. @@ -7564,7 +7561,7 @@ Default: yes - Availability: SSL or NSS + Availability: SSL If set to _y_e_s, Mutt-ng will use CA certificates in the system-wide certificate @@ -8618,7 +8615,7 @@ 3.6 Keyboard macros .................................................. 20 3.7 Using color and mono video attributes ............................ 21 3.8 Ignoring (weeding) unwanted message headers ...................... 23 - 3.9 Alternative addresses ............................................ 23 + 3.9 Alternative addresses ............................................ 24 3.10 Mailing lists .................................................... 24 3.11 Using Multiple spool mailboxes ................................... 25 3.12 Defining mailboxes which receive mail ............................ 25 @@ -8633,14 +8630,14 @@ 3.21 Adding key sequences to the keyboard buffer ...................... 29 3.22 Executing functions .............................................. 29 3.23 Message Scoring .................................................. 29 - 3.24 Spam detection ................................................... 29 + 3.24 Spam detection ................................................... 30 3.25 Setting variables ................................................ 31 3.26 Reading initialization commands from another file ................ 32 3.27 Configuring features conditionally ............................... 32 3.28 Removing hooks ................................................... 33 4. Advanced Usage ......................................................... 33 - 4.1 Regular Expressions .............................................. 33 + 4.1 Regular Expressions .............................................. 34 i