* gnus-sum.el (gnus-fetch-old-headers): Updated docs to warn that

	it can seriously impact performance as it bypasses the agent's
	local caches.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 7f014f8..e2ab6eb 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,9 @@
+2005-11-19  Kevin Greiner  <kevin.greiner@compsol.cc>
+
+       * gnus-sum.el (gnus-fetch-old-headers): Updated docs to warn that
+       it can seriously impact performance as it bypasses the agent's
+       local caches.
+
 2005-11-19  Kevin Greiner  <kevin.greiner@compsol.cc>
 
        * gnus-agent.el (gnus-agent-possibly-synchronize-flags): A server

diff --git a/lisp/gnus-sum.el b/lisp/gnus-sum.el
index dfc3c09..9df8131 100644 (file)
--- a/lisp/gnus-sum.el
+++ b/lisp/gnus-sum.el
@@ -63,17 +63,21 @@ it will be killed sometime later."
 
 (defcustom gnus-fetch-old-headers nil
   "*Non-nil means that Gnus will try to build threads by grabbing old headers.
-If an unread article in the group refers to an older, already read (or
-just marked as read) article, the old article will not normally be
-displayed in the Summary buffer.  If this variable is t, Gnus
-will attempt to grab the headers to the old articles, and thereby
-build complete threads.  If it has the value `some', only enough
-headers to connect otherwise loose threads will be displayed.  This
-variable can also be a number.  In that case, no more than that number
-of old headers will be fetched.  If it has the value `invisible', all
+If an unread article in the group refers to an older, already
+read (or just marked as read) article, the old article will not
+normally be displayed in the Summary buffer.  If this variable is
+t, Gnus will attempt to grab the headers to the old articles, and
+thereby build complete threads.  If it has the value `some', all
+old headers will be fetched but only enough headers to connect
+otherwise loose threads will be displayed.  This variable can
+also be a number.  In that case, no more than that number of old
+headers will be fetched.  If it has the value `invisible', all
 old headers will be fetched, but none will be displayed.
 
-The server has to support NOV for any of this to work."
+The server has to support NOV for any of this to work.
+
+This feature can seriously impact performance it ignores all
+locally cached header entries."
   :group 'gnus-thread
   :type '(choice (const :tag "off" nil)
                 (const :tag "on" t)