runtime(doc): Clarification in listener_add() doc

Make it clear that the overall end value can be greater than
line('$') + 1.

fixes: #18664
closes: #18828

Signed-off-by: Paul Ollis <paul@cleversheep.org>
Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 988824f4ba0236d1c7133d548da0f2611b6acaec..2bc6c8996556607d175f0d3acfdbdbec2218d25f 100644 (file)
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt*  For Vim version 9.1.  Last change: 2025 Nov 27
+*builtin.txt*  For Vim version 9.1.  Last change: 2025 Nov 28
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -6773,9 +6773,10 @@ listener_add({callback} [, {buf} [, {unbuffered}]])      *listener_add()*
                The entries are in the order the changes were made, thus the
                most recent change is at the end.
 
-               Because of the third trigger reason for triggering a callback
-               listed above, the line numbers passed to the callback are not
-               guaranteed to be valid.  If this is a problem then make
+               Because of the third reason for triggering a callback listed
+               above, the line numbers passed to the callback are not
+               guaranteed to be valid. In particular, the end value can be
+               greater than line('$') + 1. If this is a problem then make
                {unbuffered} |TRUE|.
 
                When {unbuffered} is |TRUE| the {callback} is invoked for every