From: Kevin McCarthy <kevin@8t8.us>
Date: Wed, 3 Apr 2019 21:07:14 +0000 (-0700)
Subject: Add a note about spam and the header cache in the manual.
X-Git-Tag: mutt-1-12-rel~80
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=74226f36705f47e851ffb8d1a1d0b04769278c8a;p=mutt

Add a note about spam and the header cache in the manual.
---

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 5ae3021f..8b683e45 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -4158,6 +4158,17 @@ linkend="index-format">$index_format</link> variable. (Tip: try
 defined for a given message.)
 </para>
 
+<para>
+Note: the value displayed by <literal>%H</literal> and searched by
+<literal>~H</literal> is stored in the <link linkend="caching">header
+cache</link>.  Mutt isn't smart enough to invalidate a header cache
+entry based on changing <literal>spam</literal> rules, so if you
+aren't seeing correct <literal>%H</literal> values, try temporarily
+turning off the header cache.  If that fixes the problem, then once
+your spam rules are set to your liking, remove your stale header cache
+files and turn the header cache back on.
+</para>
+
 <para>
 Your first step is to define your external filter's spam patterns using
 the <command>spam</command> command. <emphasis>pattern</emphasis> should