Document speed impact of attachment counting. This adds a short paragraph to

manual.xml and cross-links %X-expandos to it.

diff --git a/doc/manual.xml.head b/doc/manual.xml.head
index 15a32957010e7791a250dae97e63f1103ee5ef36..0da4e85f7ea1261cb77b06dcc3f34a2024948f60 100644 (file)
--- a/doc/manual.xml.head
+++ b/doc/manual.xml.head
@@ -5237,6 +5237,14 @@ configure what kinds of attachments qualify for this feature with the
 attachments and unattachments commands.
 </para>
 
+<para>
+In order to provide this information, mutt needs to fully MIME-parse
+all messages affected first. This can slow down operation especially for
+remote mail folders such as IMAP because all messages have to be
+downloaded first regardless whether the user really wants to view them
+or not.
+</para>
+
 <para>
 The syntax is:
 </para>

diff --git a/init.h b/init.h
index ee09d743c1e703768e8bba67e88b70d42c1835b8..d1a9bc7e7f9a1cbe04bdf6fecdd835d42ba62414 100644 (file)
--- a/init.h
+++ b/init.h
@@ -229,6 +229,7 @@ struct option_t MuttVars[] = {
   ** .dt %T  .dd graphic tree characters
   ** .dt %u  .dd unlink (=to delete) flag
   ** .dt %X  .dd number of qualifying MIME parts in this part and its children
+  **             (please see the ``$attachments'' section for possible speed effects)
   ** .dt %>X .dd right justify the rest of the string and pad with character "X"
   ** .dt %|X .dd pad to the end of the line with character "X"
   ** .de
@@ -1012,6 +1013,7 @@ struct option_t MuttVars[] = {
   ** .dt %u .dd user (login) name of the author
   ** .dt %v .dd first name of the author, or the recipient if the message is from you
   ** .dt %X .dd number of attachments
+  **            (please see the ``$attachments'' section for possible speed effects)
   ** .dt %y .dd `x-label:' field, if present
   ** .dt %Y .dd `x-label' field, if present, and (1) not at part of a thread tree,
   **            (2) at the top of a thread, or (3) `x-label' is different from