runtime(doc): Clarification in listener_add() doc

Commit: 
https://github.com/vim/vim/commit/9ade3f5894abee2e7f343881964ce8d6c0423564
Author: Paul Ollis <[email protected]>
Date:   Fri Nov 28 20:21:29 2025 +0000

    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 <[email protected]>
    Signed-off-by: Christian Brabandt <[email protected]>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index 988824f4b..2bc6c8996 100644
--- 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

-- 
-- 
You received this message from the "vim_dev" maillist.
Do not top-post! Type your reply below the text you are replying to.
For more information, visit http://www.vim.org/maillist.php

--- 
You received this message because you are subscribed to the Google Groups 
"vim_dev" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion visit 
https://groups.google.com/d/msgid/vim_dev/E1vP56W-006pjw-6M%40256bit.org.

Raspunde prin e-mail lui