From: Kevin McCarthy <kevin@8t8.us>
Date: Sun, 12 Aug 2018 02:14:10 +0000 (-0700)
Subject: Add more doc for the $imap_condstore and $imap_qresync options.
X-Git-Tag: 2019-10-25~665^2~4
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=0f3f20fa2750e31d563782968965c1ff2ccb39ed;p=neomutt

Add more doc for the $imap_condstore and $imap_qresync options.
---

diff --git a/init.h b/init.h
index 7fbe989f1..50b572ec5 100644
--- a/init.h
+++ b/init.h
@@ -1424,10 +1424,14 @@ struct ConfigDef MuttVars[] = {
   { "imap_condstore",  DT_BOOL, R_NONE, &ImapCondStore, 0 },
   /*
    ** .pp
-   **
    ** When \fIset\fP, mutt will use the CONDSTORE extension (RFC 7162)
    ** if advertised by the server.  Mutt's current implementation is basic,
    ** used only for initial message fetching and flag updates.
+   ** .pp
+   ** For some IMAP servers, enabling this will slightly speed up
+   ** downloading initial messages.  Unfortunately, Gmail is not one
+   ** those, and displays worse performance when enabled.  Your
+   ** mileage may vary.
    */
   { "imap_delim_chars",         DT_STRING, R_NONE, &ImapDelimChars, IP "/." },
   /*
@@ -1542,10 +1546,13 @@ struct ConfigDef MuttVars[] = {
   { "imap_qresync",  DT_BOOL, R_NONE, &ImapQResync, 0 },
   /*
    ** .pp
-   **
    ** When \fIset\fP, mutt will use the QRESYNC extension (RFC 7162)
    ** if advertised by the server.  Mutt's current implementation is basic,
    ** used only for initial message fetching and flag updates.
+   ** .pp
+   ** Note: this feature is currently experimental.  If you experience
+   ** strange behavior, such as duplicate or missing messages please
+   ** file a bug report to let us know.
    */
   { "imap_servernoise",         DT_BOOL, R_NONE, &ImapServernoise, true },
   /*