From 3dce855d99d72b42ae3620b901aff02f83e7f637 Mon Sep 17 00:00:00 2001
From: Bob Weinand <bwoebi@php.net>
Date: Sun, 13 Apr 2014 22:20:23 +0000
Subject: [PATCH] Updated Countable::count([$mode]) to reflect newest changes

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@333311 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/spl/countable/count.xml | 43 +++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/reference/spl/countable/count.xml b/reference/spl/countable/count.xml
index 45ccbaae35..d176888ed2 100644
--- a/reference/spl/countable/count.xml
+++ b/reference/spl/countable/count.xml
@@ -11,7 +11,7 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier>abstract</modifier> <modifier>public</modifier> <type>int</type><methodname>Countable::count</methodname>
-   <void />
+   <methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>COUNT_NORMAL</initializer></methodparam>
   </methodsynopsis>
   <para>
    This method is executed when using the <function>count</function> function on an
@@ -21,7 +21,22 @@
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  &no.function.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>mode</parameter></term>
+     <listitem>
+      <para>
+       The optional <parameter>mode</parameter> parameter will be set to
+       <constant>COUNT_NORMAL</constant> or <constant>COUNT_RECURSIVE</constant>, depending 
+       on what value was passed to the second parameter of <function>count</function>.
+       This is particularly useful for counting all the elements of
+       a multidimensional array/Countable combination.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -36,6 +51,30 @@
   </note>
  </refsect1>
 
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.6</entry>
+       <entry>
+        The optional <parameter>mode</parameter> parameter was added.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>