# HG changeset patch
# User Kai Gro���johann <kgrossjo@eu.uu.net>
# Date 973113302 0
# Node ID 698d567f9976811293b173d1949a6d41d06fd46f
# Parent  cf1d22a4f549a34b191f0520bbfef9bccdca8b3c
Explain nnmail-split-fancy-with-parent.

diff -r cf1d22a4f549 -r 698d567f9976 man/ChangeLog
--- a/man/ChangeLog	Wed Nov 01 19:16:06 2000 +0000
+++ b/man/ChangeLog	Wed Nov 01 21:15:02 2000 +0000
@@ -1,3 +1,8 @@
+2000-11-01  Kai Gro,A_(Bjohann  <Kai.Grossjohann@CS.Uni-Dortmund.DE>
+
+	* gnus.texi (Fancy Mail Splitting): Explain
+	`nnmail-split-fancy-with-parent'.
+
 2000-10-29  Michael Kifer  <kifer@cs.sunysb.edu>
 	
 	* ediff.texi: Replaced @command with @code & acknowledgements.
diff -r cf1d22a4f549 -r 698d567f9976 man/gnus.texi
--- a/man/gnus.texi	Wed Nov 01 19:16:06 2000 +0000
+++ b/man/gnus.texi	Wed Nov 01 21:15:02 2000 +0000
@@ -11731,6 +11731,40 @@
 up to @samp{\\9} will be substituted with the text matched by the
 groupings 1 through 9.
 
+@findex nnmail-split-fancy-with-parent
+@code{nnmail-split-fancy-with-parent} is a function which allows you to
+split followups into the same groups their parents are in.  Sometimes
+you can't make splitting rules for all your mail.  For example, your
+boss might send you personal mail regarding different projects you are
+working on, and as you can't tell your boss to put a distinguishing
+string into the subject line, you have to resort to manually moving the
+messages into the right group.  With this function, you only have to do
+it once per thread.
+
+To use this feature, you have to set @code{nnmail-treat-duplicates} to a
+non-nil value.  And then you can include
+@code{nnmail-split-fancy-with-parent} using the colon feature, like so:
+@lisp
+(setq nnmail-split-fancy
+      '(| (: nnmail-split-fancy-with-parent)
+          ;; other splits go here
+        ))
+@end lisp
+
+This feature works as follows: when @code{nnmail-treat-duplicates} is
+non-nil, Gnus records the message id of every message it sees in the
+file specified by the variable @code{nnmail-message-id-cache-file},
+together with the group it is in (the group is omitted for non-mail
+messages).  When mail splitting is invoked, the function
+@code{nnmail-split-fancy-with-parent} then looks at the References (and
+In-Reply-To) header of each message to split and searches the file
+specified by @code{nnmail-message-id-cache-file} for the message ids.
+When it has found a parent, it returns the corresponding group name.  It
+is recommended that you set @code{nnmail-message-id-cache-length} to a
+somewhat higher number than the default so that the message ids are
+still in the cache.  (A value of 5000 appears to create a file some
+300 kBytes in size.)
+
 
 @node Group Mail Splitting
 @subsection Group Mail Splitting