From 99cec05cd4ab0462a51a9b02a8cc55c084fc46e2 Mon Sep 17 00:00:00 2001
From: Chris Wright <daverandom@php.net>
Date: Mon, 18 Nov 2013 18:11:43 +0000
Subject: [PATCH] Reworded array_rand so that reader is not addressed as "you",
 and incorporated edit suggested by anonymous 35207

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@332157 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/array/functions/array-rand.xml | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/reference/array/functions/array-rand.xml b/reference/array/functions/array-rand.xml
index 2f6aaca37e..1f512b0489 100644
--- a/reference/array/functions/array-rand.xml
+++ b/reference/array/functions/array-rand.xml
@@ -33,9 +33,7 @@
      <term><parameter>num</parameter></term>
      <listitem>
       <para>
-       Specifies how many entries you want to pick. Trying to pick more
-       elements than there are in the array will result in an
-       <constant>E_WARNING</constant> level error.
+       Specifies how many entries should be picked.
       </para>
      </listitem>
     </varlistentry>
@@ -45,10 +43,12 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   If you are picking only one entry, <function>array_rand</function>
-   returns the key for a random entry. Otherwise, it returns an array
-   of keys for the random entries. This is done so that you can pick
-   random keys as well as values out of the array.
+   When picking only one entry, <function>array_rand</function> returns
+   the key for a random entry. Otherwise, an array of keys for the random
+   entries is returned. This is done so that random keys can be picked
+   from the array as well as random values. Trying to pick more elements
+   than there are in the array will result in an
+   <constant>E_WARNING</constant> level error, and NULL will be returned.
   </para>
  </refsect1>
  <refsect1 role="changelog">