Better document the effect of $thorough_search being unset.
authorRocco Rutte <pdmef@gmx.net>
Thu, 21 Aug 2008 07:36:56 +0000 (09:36 +0200)
committerRocco Rutte <pdmef@gmx.net>
Thu, 21 Aug 2008 07:36:56 +0000 (09:36 +0200)
Closes #3104.

init.h

diff --git a/init.h b/init.h
index 370655c00baf8c495025d8d686ee03d85b9d99bf..a257b438252b08961314586aa0b19624ff4eaa3e 100644 (file)
--- 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 },
   /*