From 9d9cbf7c58514efe0976b7a34ec4076d308e3fdc Mon Sep 17 00:00:00 2001
From: Kevin McCarthy <kevin@8t8.us>
Date: Mon, 20 Jun 2016 20:09:52 -0700
Subject: [PATCH] Add documentation to the "New Mail Detection" section of the
 manual.

Mention the behavior change with $mail_check_recent.

Add a section about $mail_check_stats.
---
 doc/manual.xml.head | 28 ++++++++++++++++++++++++++++
 init.h              |  2 +-
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 57c45f30..27f3f671 100644
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -6071,6 +6071,14 @@ linkend="imap-idle">$imap_idle</link> option is set, it'll use the IMAP
 IDLE extension if advertised by the server.
 </para>
 
+<para>
+The <link linkend="mail-check-recent">$mail_check_recent</link>
+option changes whether Mutt will notify you of new mail in an
+already visited mailbox.  When set (the default) it will only notify
+you of new mail received since the last time you opened the mailbox.
+When unset, Mutt will notify you of any new mail in the mailbox.
+</para>
+
 </sect2>
 
 <sect2 id="new-mail-polling">
@@ -6119,6 +6127,26 @@ to immediately open the next folder with unread mail (if any).
 
 </sect2>
 
+<sect2 id="calc-mailbox-counts">
+<title>Calculating Mailbox Message Counts</title>
+
+<para>
+If <link linkend="mail-check-stats">$mail_check_stats</link> is set,
+Mutt will periodically calculate the unread, flagged, and total
+message counts for each mailbox watched by the
+<command>mailboxes</command> command.  This calculation takes place at
+the same time as new mail polling, but is controlled by a separate
+timer: <link
+linkend="mail-check-stats-interval">$mail_check_stats_interval</link>.
+</para>
+
+<para>
+The sidebar can display these message counts.  See <link
+linkend="sidebar-format">$sidebar_format</link>.
+</para>
+
+</sect2>
+
 </sect1>
 
 <sect1 id="editing-threads">
diff --git a/init.h b/init.h
index 47b5647e..add9e806 100644
--- a/init.h
+++ b/init.h
@@ -2744,7 +2744,7 @@ struct option_t MuttVars[] = {
   ** @ = Only applicable to the current folder
   ** .pp
   ** In order to use %S, %N, %F, and %!, $$mail_check_stats must
-  ** be \fIset\fP.  When set, a useful value for this setting is
+  ** be \fIset\fP.  When thus set, a suggested value for this option is
   ** "%B%?F? [%F]?%* %?N?%N/?%S".
   */
   { "sidebar_indent_string", DT_STR, R_BOTH, UL &SidebarIndentString, UL "  " },
-- 
2.50.1