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

Co-authored-by: Richard Russon <rich@flatcap.org>

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index b73ef16ab8ed2c305addae111b8a795c11fb647a..bd8fc2880dab18fb78ff26a5ed6b11a98dbd8726 100644 (file)
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -5969,6 +5969,16 @@ folder-hook . 'push "<enter-command>score ~= 10<enter>"'
         <literal>%?H?[%H] ?</literal> to display spam tags only when they are
         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>