runtime(doc): clarify "nearest" value for 'completeopt'

closes: #17146

Signed-off-by: Girish Palya <girishji@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 8ab0dcc8bda472e19f1856065348878d38e39484..83032e1c42ec1ca74f1c8bc710587c1af713668c 100644 (file)
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt*  For Vim version 9.1.  Last change: 2025 Apr 16
+*options.txt*  For Vim version 9.1.  Last change: 2025 Apr 18
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -2208,8 +2208,10 @@ A jump table for the options with a short description can be found at |Q_op|.
                    Useful when there is additional information about the
                    match, e.g., what file it comes from.
 
-          nearest  Matches are presented in order of proximity to the cursor
-                   position.  This applies only to matches from the current
+          nearest  Matches are listed based on their proximity to the cursor
+                   position, unlike the default behavior, which only
+                   considers proximity for matches appearing below the
+                   cursor.  This applies only to matches from the current
                    buffer.  No effect if "fuzzy" is present.
 
           noinsert Do not insert any text for a match until the user selects