Commit: runtime(doc): document global insert behavior

[Christian Brabandt]

runtime(doc): document global insert behavior

Commit: https://github.com/vim/vim/commit/6d6dffa6113d44b34d1bb2d2945c7f17cfe0172a
Author: Mohamed Akram <mohd....@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....@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*