From 865071208af238f0012323216c292dcfa4cc0f5f Mon Sep 17 00:00:00 2001
From: Maciek Sokolewicz <tularis@php.net>
Date: Tue, 21 Feb 2017 10:46:22 +0000
Subject: [PATCH] Add simple documentation for the CHILD_ARRAYS_ONLY flag for
 RecursiveArrayIterator that was added as a fix to Bug #38618 back in the
 5.3.0 release.

Provided by John Flatness (john@zerocrates.org)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@341941 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/spl/recursivearrayiterator.xml | 46 ++++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/reference/spl/recursivearrayiterator.xml b/reference/spl/recursivearrayiterator.xml
index f30817b61d..e7a3d69f7b 100644
--- a/reference/spl/recursivearrayiterator.xml
+++ b/reference/spl/recursivearrayiterator.xml
@@ -40,6 +40,13 @@
      </oointerface>
 
     </classsynopsisinfo>
+    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
+    <fieldsynopsis>
+     <modifier>const</modifier>
+     <type>integer</type>
+     <varname linkend="recursivearrayiterator.constants.child-arrays-only">CHILD_ARRAYS_ONLY</varname>
+     <initializer>4</initializer>
+    </fieldsynopsis>
 <!-- }}} -->
 
     <!-- {{{ If the property is documented below (xml:id=recursivearrayiterator.props) use this
@@ -59,6 +66,45 @@
 
   </section>
 
+  <section xml:id="recursivearrayiterator.constants">
+   &reftitle.constants;
+   <section xml:id="recursivearrayiterator.constants.flags">
+    <title>RecursiveArrayIterator Flags</title>
+    <variablelist>
+     <varlistentry xml:id="recursivearrayiterator.constants.child-arrays-only">
+      <term><constant>RecursiveArrayIterator::CHILD_ARRAYS_ONLY</constant></term>
+      <listitem>
+       <para>Treat only arrays (not objects) as having children for recursive iteration.</para>
+      </listitem>
+     </varlistentry>
+    </variablelist>
+   </section>
+  </section>
+  
+  <section role="changelog">
+   &reftitle.changelog;
+   <para>
+    <informaltable>
+     <tgroup cols="2">
+      <thead>
+       <row>
+        <entry>&Version;</entry>
+        <entry>&Description;</entry>
+       </row>
+      </thead>
+      <tbody>
+       <row>
+        <entry>5.3.0</entry>
+        <entry>
+         <constant>CHILD_ARRAYS_ONLY</constant> flag was added.
+        </entry>
+       </row>
+      </tbody>
+     </tgroup>
+    </informaltable>
+   </para>
+  </section>
+
 <!-- {{{ RecursiveArrayIterator properties
   <section xml:id="recursivearrayiterator.props">
    &reftitle.properties;