diff --git a/functions/array.xml b/functions/array.xml
index 95ccea4602..996848db5b 100644
--- a/functions/array.xml
+++ b/functions/array.xml
@@ -2688,19 +2688,28 @@ Array
      inclusive.  If low > high, the sequence will be from high to
 	 low.
      <example>
-      <title><function>range</function> example</title>
+      <title><function>range</function> examples</title>
       <programlisting role="php">
 foreach(range(0,9) as $number) {
 	echo $number;
 }
 foreach(range('a','z') as $letter) {
 	echo $letter;
+}
+foreach(range('z','a') as $letter) {
+	echo $letter;
 }
       </programlisting>
      </example>
     </para>
+	<note>
+	<para>
+	 Prior to version 4.0.7 the range() function only generated incrementing integer arrays.
+	 Support for character sequences and decrementing arrays was added in 4.0.7.
+	</para>
+	</note>
     <para>
-     See <function>shuffle</function> for an example of its use.
+     See <function>shuffle</function> for another example of its use.
     </para>
    </refsect1>
   </refentry>