Add more docu

diff --git a/ext/spl/spl.php b/ext/spl/spl.php
index 5c77857ff970a4a2a5862079deb45d26e3b5d387..70a4342fb9e9de897c8ee5918499576f51fc008c 100755 (executable)
--- a/ext/spl/spl.php
+++ b/ext/spl/spl.php
@@ -539,6 +539,13 @@ class RecursiveDirectoryIterator extends DirectoryIterator implements RecursiveI
 
 /** \ingroup SPL
  * \brief recursive SimpleXML_Element iterator
+ *
+ * SimpleXMLIterator implements the RecursiveIterator interface. This allows
+ * to iterator over all elements using foreach or appropriate while construct 
+ * just like SimpleXMLElement does. But using the foreach construct you will
+ * also iterate over the subelements. Because for every element which has sub
+ * elements hasChildren() returns true what results in a call to getchildren()
+ * which then returns the iterator for that sub element.
  */
 class SimpleXMLIterator extends SimpleXMLElement implements RecursiveIterator
 {