2 files changed, 6 insertions, 6 deletions
diff --git a/phpBB/includes/tree/interface.php b/phpBB/includes/tree/interface.php
index 4e22e322f3..ed0ccca3f1 100644
--- a/phpBB/includes/tree/interface.php
+++ b/phpBB/includes/tree/interface.php
@@ -18,7 +18,7 @@ if (!defined('IN_PHPBB'))
 interface phpbb_tree_interface
 {
 	/**
-	* Insert an item into the tree (also insert the rows into the table)
+	* Inserts an item into the database table and into the tree.
 	*
 	* @param array	$item	The item to be added
 	* @return array Array with item data as set in the database
@@ -26,9 +26,9 @@ interface phpbb_tree_interface
 	public function insert(array $additional_data);
 
 	/**
-	* Delete an item from the tree (also deletes the rows form the table)
+	* Delete an item from the tree and from the database table
 	*
-	* Also deletes all subitems from the tree
+	* Also deletes all subitems from the tree and from the database table
 	*
 	* @param int	$item_id	The item to be deleted
 	* @return array		Item ids that have been deleted
diff --git a/phpBB/includes/tree/nestedset.php b/phpBB/includes/tree/nestedset.php
index ab6a9d6bb4..9655a08aa5 100644
--- a/phpBB/includes/tree/nestedset.php
+++ b/phpBB/includes/tree/nestedset.php
@@ -115,7 +115,7 @@ abstract class phpbb_tree_nestedset implements phpbb_tree_interface
 	}
 
 	/**
-	* Add an existing item at the end of the tree
+	* Add an item which already has a database row at the end of the tree
 	*
 	* @param array	$item	The item to be added
 	* @return bool True if the item was added
@@ -145,9 +145,9 @@ abstract class phpbb_tree_nestedset implements phpbb_tree_interface
 	}
 
 	/**
-	* Remove an item from the tree WITHOUT removing the items from the table
+	* Remove an item from the tree without deleting it from the database
 	*
-	* Also removes all subitems from the tree
+	* Also removes all subitems from the tree without deleting them from the database either
 	*
 	* @param int	$item_id	The item to be deleted
 	* @return array		Item ids that have been removed