From 8e29a378002b621742055a2c7501f437e2e1d588 Mon Sep 17 00:00:00 2001
From: cdemirer <41021322+cdemirer@users.noreply.github.com>
Date: Fri, 10 Dec 2021 13:48:00 +0800
Subject: [PATCH] Clarify that replace_by keeps child nodes in tree

(cherry picked from commit 98a3948bf9944c0f2003d46997c74bbc7b14d909)
---
 doc/classes/Node.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/classes/Node.xml b/doc/classes/Node.xml
index 0b8f3ec79f8..d3271ff3559 100644
--- a/doc/classes/Node.xml
+++ b/doc/classes/Node.xml
@@ -521,7 +521,8 @@
 			<argument index="1" name="keep_data" type="bool" default="false" />
 			<description>
 				Replaces a node in a scene by the given one. Subscriptions that pass through this node will be lost.
-				Note that the replaced node is not automatically freed, so you either need to keep it in a variable for later use or free it using [method Object.free].
+				[b]Note:[/b] The given node will become the new parent of any child nodes that the replaced node had.
+				[b]Note:[/b] The replaced node is not automatically freed, so you either need to keep it in a variable for later use or free it using [method Object.free].
 			</description>
 		</method>
 		<method name="request_ready">