From a2b0168dd518360f10bd476a55a893466abf12bf Mon Sep 17 00:00:00 2001
From: Zachary Pavlov <zachary.pavlov@gmail.com>
Date: Wed, 12 Aug 2009 19:14:20 +0000
Subject: [PATCH] documenting subtle steal_children issue

---
 panda/src/pgraph/pandaNode.cxx | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/panda/src/pgraph/pandaNode.cxx b/panda/src/pgraph/pandaNode.cxx
index 09a48ca4f1..be8cbac5ba 100644
--- a/panda/src/pgraph/pandaNode.cxx
+++ b/panda/src/pgraph/pandaNode.cxx
@@ -1034,6 +1034,9 @@ remove_all_children(Thread *current_thread) {
 //       Access: Published
 //  Description: Moves all the children from the other node onto this
 //               node.
+//
+//               Any NodePaths to child nodes of the other node are
+//               truncated, rather than moved to the new parent.
 ////////////////////////////////////////////////////////////////////
 void PandaNode::
 steal_children(PandaNode *other, Thread *current_thread) {