More accurate documentation

Author: arnt

lib/net/imap.rb

@@ -1931,20 +1931,14 @@ def uid_thread(algorithm, search_keys, charset)
     #   UTF-7}[::decode_utf7] for mailbox names, or RFC2047 encoded-words for
     #   message headers.
     #
-    #   *Note:* For now, strings with 8-bit characters are still _sent_ using
-    #   "literal" syntax.  A future update will change how commands send UTF-8
-    #   strings when <tt>UTF8=ACCEPT</tt> is enabled.  This update should be
-    #   backward-compatible.
-    #
     #   *Note:* <em>A future update may set string encodings slightly
     #   differently</em>, e.g: "US-ASCII" when UTF-8 is not enabled, and "UTF-8"
     #   when it is.  Currently, the encoding of strings sent as "quoted" or
-    #   "text" will _always_ be "UTF-8", even when a 7-bit encoding is used
-    #   (e.g. UTF-7, encoded-words, quoted-printable, base64).  And currently,
-    #   string "literals" sent by the server will always have an "ASCII-8BIT"
-    #   (binary) encoding, even if they must contain UTF-8 data---although a
-    #   server _should_ use "quoted" strings once <tt>UTF8=ACCEPT</tt> is
-    #   enabled.
+    #   "text" will _always_ be "UTF-8", even when only ASCII characters are
+    #   used (e.g. "Subject: Agenda") And currently, string "literals" sent
+    #   by the server will always have an "ASCII-8BIT" (binary)
+    #   encoding, even if they generally contain UTF-8 data, if they are
+    #   text at all.
     #
     # [<tt>"UTF8=ONLY"</tt> [RFC6855[https://tools.ietf.org/html/rfc6855]]]
     #