(gnus-summary-insert-subject): Document USE-OLD-HEADER (bug#9070).

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index c47cc5c..5b94c79 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -3,6 +3,7 @@
        * gnus-sum.el (gnus-delete-duplicate-headers): New function.
        (gnus-summary-refer-thread): Use it to remove duplicates in the
        un-threaded view (bug#9053).
+       (gnus-summary-insert-subject): Document USE-OLD-HEADER (bug#9070).
 
 2011-07-07  Kan-Ru Chen  <kanru@kanru.info>
 

diff --git a/lisp/gnus-sum.el b/lisp/gnus-sum.el
index 9f72484..245d244 100644 (file)
--- a/lisp/gnus-sum.el
+++ b/lisp/gnus-sum.el
@@ -6562,7 +6562,10 @@ This is meant to be called in `gnus-article-internal-prepare-hook'."
 (defun gnus-summary-insert-subject (id &optional old-header use-old-header)
   "Find article ID and insert the summary line for that article.
 OLD-HEADER can either be a header or a line number to insert
-the subject line on."
+the subject line on.
+If USE-OLD-HEADER is non-nil, then OLD-HEADER should be a header,
+and OLD-HEADER will be used when the summary line is inserted,
+too, instead of trying to fetch new headers."
   (let* ((line (and (numberp old-header) old-header))
         (old-header (and (vectorp old-header) old-header))
         (header (cond ((and old-header use-old-header)