From 446e64f854318d802ccad04a09032a7aaab62582 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Thu, 7 Jan 2010 12:25:06 +0000
Subject: [PATCH] Fixed bug #41662 (SimpleXML->children() misleading result)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@293214 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../simplexml/simplexmlelement/children.xml   | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/reference/simplexml/simplexmlelement/children.xml b/reference/simplexml/simplexmlelement/children.xml
index a63daf0589..e970cae11a 100644
--- a/reference/simplexml/simplexmlelement/children.xml
+++ b/reference/simplexml/simplexmlelement/children.xml
@@ -49,6 +49,8 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
+   Returns a <classname>SimpleXMLElement</classname> element, whether the node 
+   have children or not.
   </para>
  </refsect1>
 
@@ -122,6 +124,26 @@ begot a daughter who begot a son; and that son begot a son
   </para>
  </refsect1>
 
+ <refsect1 role="notes">
+  &reftitle.notes;
+
+  <simpara>
+   <methodname>SimpleXMLElement::children</methodname> returns a node 
+   object no matter if the current node have children or not. Use the 
+   <methodname>SimpleXMLElement::count</methodname> to check whether 
+   there is any children.
+  </simpara>
+ </refsect1>
+ 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><methodname>SimpleXMLElement::count</methodname></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file