From 269afc9e6cae572afca096dbfcdf09a3b666512a Mon Sep 17 00:00:00 2001
From: nick evans <nick@rubinick.dev>
Date: Fri, 8 Nov 2024 16:11:29 -0500
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=9A=20Reformat=20search=20docs=20for?=
 =?UTF-8?q?=20SequenceSet=20coercion?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This format simplifies updating the docs in later commits.
---
 lib/net/imap.rb | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/lib/net/imap.rb b/lib/net/imap.rb
index b9e39762..0c9ef411 100644
--- a/lib/net/imap.rb
+++ b/lib/net/imap.rb
@@ -1944,8 +1944,10 @@ def uid_expunge(uid_set)
     #
     # * When +criteria+ is an array, each member is a +SEARCH+ command argument:
     #   * Any SequenceSet sends SequenceSet#valid_string.
-    #     +Range+, <tt>-1</tt>, and nested +Array+ elements are converted to
-    #     SequenceSet.
+    #     These types are converted to SequenceSet for validation and encoding:
+    #     * +Range+
+    #     * <tt>-1</tt> translates to <tt>*</tt>
+    #     * nested +Array+
     #   * Any +String+ is sent verbatim when it is a valid \IMAP atom,
     #     and encoded as an \IMAP quoted or literal string otherwise.
     #   * Any other +Integer+ (besides <tt>-1</tt>) will be sent as +#to_s+.