runtime(doc): document global insert behavior

Commit: 
https://github.com/vim/vim/commit/6d6dffa6113d44b34d1bb2d2945c7f17cfe0172a
Author: Mohamed Akram <mohd.ak...@outlook.com>
Date:   Sun Jul 14 10:34:25 2024 +0200

    runtime(doc): document global insert behavior
    
    This is a partial revert of 8f3f58f since this issue was fixed in 
https://github.com/vim/vim/issues/15120.
    
    related: #15120
    
    Signed-off-by: Mohamed Akram <mohd.ak...@outlook.com>
    Signed-off-by: Christian Brabandt <c...@256bit.org>

diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
index d48018f58..0d59a2eda 100644
--- a/runtime/doc/insert.txt
+++ b/runtime/doc/insert.txt
@@ -2005,8 +2005,15 @@ command in ex mode: >
        one
        two
 <
-NOTE: These commands cannot be used with |:global| or |:vglobal|.
-":append" and ":insert" don't work properly in between ":if" and
+In |Ex-mode|, when these commands are used with |:global| or |:vglobal| then
+the lines are obtained from the text following the command.  Separate lines
+with a NL escaped with a backslash: >
+       :global/abc/insert\
+       one line\
+       another line
+The final "." is not needed then.
+
+NOTE: ":append" and ":insert" don't work properly in between ":if" and
 ":endif", ":for" and ":endfor", ":while" and ":endwhile".
 
                                                        *:start* *:startinsert*

-- 
-- 
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 vim_dev+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/vim_dev/E1sTxuz-0091Hc-FW%40256bit.org.

Raspunde prin e-mail lui