# HG changeset patch
# User Christian Brabandt <cb@256bit.org>
# Date 1721196817 -7200
# Node ID bb951744845040e87edcb65c0db0ee9481e3de39
# Parent  dee94b06b3de23c8821b46e711bd8b4e2f1930c3
runtime(doc): document global insert behavior

Commit: https://github.com/vim/vim/commit/6d6dffa6113d44b34d1bb2d2945c7f17cfe0172a
Author: Mohamed Akram <mohd.akram@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.akram@outlook.com>
    Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/insert.txt b/runtime/doc/insert.txt
--- 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*