From: Rocco Rutte <pdmef@gmx.net>
Date: Thu, 21 Aug 2008 07:36:56 +0000 (+0200)
Subject: Better document the effect of $thorough_search being unset.
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=b11d99f083bd425eaef87cc7b3ada751d73d6cbb;p=mutt

Better document the effect of $thorough_search being unset.
Closes #3104.
---

diff --git a/init.h b/init.h
index 370655c0..a257b438 100644
--- a/init.h
+++ b/init.h
@@ -2908,9 +2908,15 @@ struct option_t MuttVars[] = {
   /*
   ** .pp
   ** Affects the \fI~b\fP and \fI~h\fP search operations described in
-  ** section ``$patterns'' above.  If set, the headers and attachments of
-  ** messages to be searched are decoded before searching.  If unset,
+  ** section ``$patterns''.  If \fIset\fP, the headers and body/attachments of
+  ** messages to be searched are decoded before searching. If \fIunset\fP,
   ** messages are searched as they appear in the folder.
+  ** .pp
+  ** Users searching attachments or for non-ASCII characters should \fIset\fP
+  ** this value because decoding also includes MIME parsing/decoding and possible
+  ** character set conversions. Otherwise mutt will attempt to match against the
+  ** raw message received (for example quoted-printable encoded or with encoded
+  ** headers) which may lead to incorrect search results.
   */
   { "tilde",		DT_BOOL, R_PAGER, OPTTILDE, 0 },
   /*