Merge branch '3.x.x' of github.com:c0fec0de/anytree

docs/index.rst

@@ -172,7 +172,7 @@ Subtree rendering:
 Node('/Mary/Udo/Marc')
 └── Node('/Mary/Udo/Marc/Lian')
 
-Cut:
+Cut/Delete:
 
 >>> dan.parent = None
 >>> print(RenderTree(dan))
@@ -181,6 +181,15 @@ Node('/Dan')
 ├── Node('/Dan/Jan')
 └── Node('/Dan/Joe')
 
+>>> print(RenderTree(mary))
+Node('/Mary')
+├── Node('/Mary/Urs')
+├── Node('/Mary/Chris')
+├── Node('/Mary/Marta')
+└── Node('/Mary/Udo')
+    └── Node('/Mary/Udo/Marc')
+        └── Node('/Mary/Udo/Marc/Lian')
+
 **Extending any python class to become a tree node**
 
 The enitre tree magic is encapsulated by :any:`NodeMixin`,

docs/intro.rst

@@ -59,26 +59,36 @@ Every node has a :any:`children` attribute with a tuple of all children:
 >>> lian.children
 ()
 
-**Single Node Attach**
+**Add: Single Node Attach**
+
+Just set the parent attribute and the node becomes a child node:
 
 >>> marc.parent = udo
 >>> print(RenderTree(udo))
 Node('/Udo')
 └── Node('/Udo/Marc')
     └── Node('/Udo/Marc/Lian')
 
-**Single Node Detach**
+**Delete: Single Node Detach**
 
-To make a node to a root node, just set this attribute to `None`.
+A node becomes a root node, if you set the parent attribute to `None`:
 
->>> marc.is_root
+>>> lian.is_root
 False
->>> marc.parent = None
->>> marc.is_root
+>>> lian.parent = None
+>>> lian.is_root
 True
 
+The node is deleted from the tree:
+
+>>> print(RenderTree(udo))
+Node('/Udo')
+└── Node('/Udo/Marc')
+
 **Modify Multiple Child Nodes**
 
+Assume the following tree:
+
 >>> n = Node("n")
 >>> a = Node("a", parent=n)
 >>> b = Node("b", parent=n)