Re: nnmail-split-fancy-match-partial-words

[Reiner Steib <reinersteib+gmane@imap.cc>]

On Wed, Mar 08 2006, Katsumi Yamaoka wrote:

>> I'll install this change, add a description to the Info, and
>> improve some descriptions about the partial-words matching,
>> maybe tomorrow[1], in both the trunk and the v5-10 branch[2].
>
> Done.  Please fix funny English if any.

The first paragraph (not modified by you) "If the split is a list, the
first element of which is a string, ..." is hard to understand, IMHO.

I also think that your text could be simplified a little and we could
use a shorter term instead of `invert-match-partial-words'
e.g. `invert-partial'.

How about the following change?

--8<---------------cut here---------------start------------->8---
--- gnus.texi	09 Mar 2006 12:33:12 +0100	6.603.2.66
+++ gnus.texi	09 Mar 2006 16:35:58 +0100	
@@ -14007,18 +14007,21 @@
 regexp match expansion will be done.  See below for examples.
 
 @c Don't fold this line.
-@item (@var{field} @var{value} [- @var{restrict} [@dots{}] ] @var{split} [@var{invert-match-partial-words}])
-If the split is a list, the first element of which is a string, then
-store the message as specified by @var{split}, if header @var{field}
-(a regexp) contains @var{value} (also a regexp).  If @var{restrict}
-(yet another regexp) matches some string after @var{field} and before
-the end of the matched @var{value}, the @var{split} is ignored.  If
-none of the @var{restrict} clauses match, @var{split} is processed.
-
-The last element @var{invert-match-partial-words} is optional.  If it is
-not omitted and the value is non-@code{nil}, the match-partial-words
-behavior controlled by the @code{nnmail-split-fancy-match-partial-words}
-variable (see below) will be inverted.  (New in Gnus 5.10.7)
+@item (@var{field} @var{value} [- @var{restrict} [@dots{}] ] @var{split} [@var{invert-partial}])
+The split can be a list containing at least three elements.  If the
+first element @var{field} (a regexp matching a header) contains
+@var{value} (also a regexp) then store the message as specified by
+@var{split}.
+
+If @var{restrict} (yet another regexp) matches some string after
+@var{field} and before the end of the matched @var{value}, the
+@var{split} is ignored.  If none of the @var{restrict} clauses match,
+@var{split} is processed.
+
+The last element @var{invert-partial} is optional.  If it is
+non-@code{nil}, the match-partial-words behavior controlled by the
+variable @code{nnmail-split-fancy-match-partial-words} (see below) is
+be inverted.  (New in Gnus 5.10.7)
 
 @item (| @var{split} @dots{})
 If the split is a list, and the first element is @code{|} (vertical
--8<---------------cut here---------------end--------------->8---

Bye, Reiner.
-- 
       ,,,
      (o o)
---ooO-(_)-Ooo---  |  PGP key available  |  http://rsteib.home.pages.de/