diff --git a/reference/array/functions/natsort.xml b/reference/array/functions/natsort.xml
index 7b4393358f..39a1ffef04 100644
--- a/reference/array/functions/natsort.xml
+++ b/reference/array/functions/natsort.xml
@@ -40,11 +40,34 @@
    &return.success;
   </para>
  </refsect1>
+
+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <informaltable>
+   <tgroup cols="2">
+    <thead>
+     <row>
+      <entry>&Version;</entry>
+      <entry>&Description;</entry>
+     </row>
+    </thead>
+    <tbody>
+     <row>
+      <entry>5.2.10</entry>
+      <entry>
+       Zero padded numeric strings (e.g., '00005') now essentially ignore the 0 padding.
+      </entry>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
-    <title><function>natsort</function> example</title>
+    <title><function>natsort</function> examples demonstrating basic usage</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -88,6 +111,116 @@ Array
      page.
     </para>
    </example>
+   <example>
+    <title><function>natsort</function> examples demonstrating potential gotchas</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+echo "Negative numbers\n";
+$negative = array('-5','3','-2','0','-1000','9','1');
+print_r($negative);
+natsort($negative);
+print_r($negative);
+
+echo "Zero padding\n";
+$zeros = array('09', '8', '10', '009', '011', '0'); 
+print_r($zeros);
+natsort($zeros);
+print_r($zeros);
+
+echo "Other characters interfering\n";
+$images_oops = array('image_1.jpg','image_12.jpg', 'image_21.jpg', 'image_4.jpg');
+print_r($images_oops);
+natsort($images_oops);
+print_r($images_oops);
+
+echo "Sort by keys\n";
+$smoothie = array('orange' => 1, 'apple' => 1, 'yogurt' => 4, 'banana' => 4);
+print_r($smoothie);
+uksort( $smoothie, 'strnatcmp');
+print_r($smoothie);
+?>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+Negative numbers
+Array
+(
+    [0] => -5
+    [1] => 3
+    [2] => -2
+    [3] => 0
+    [4] => -1000
+    [5] => 9
+    [6] => 1
+)
+Array
+(
+    [2] => -2
+    [0] => -5
+    [4] => -1000
+    [3] => 0
+    [6] => 1
+    [1] => 3
+    [5] => 9
+)
+
+Zero padding
+Array
+(
+    [0] => 09
+    [1] => 8
+    [2] => 10
+    [3] => 009
+    [4] => 011
+    [5] => 0
+)
+Array
+(
+    [5] => 0
+    [1] => 8
+    [3] => 009
+    [0] => 09
+    [2] => 10
+    [4] => 011
+)
+
+Other characters interfering
+Array
+(
+    [0] => image_1.jpg
+    [1] => image_12.jpg
+    [2] => image_21.jpg
+    [3] => image_4.jpg
+)
+Array
+(
+    [0] => image_1.jpg
+    [3] => image_4.jpg
+    [1] => image_12.jpg
+    [2] => image_21.jpg
+)
+
+Sort by keys
+Array
+(
+    [orange] => 1
+    [apple]  => 1
+    [yogurt] => 4
+    [banana] => 4
+)
+Array
+(
+    [apple]  => 1
+    [banana] => 4
+    [orange] => 1
+    [yogurt] => 4
+)
+]]>
+    </screen>
+   </example>
   </para>
  </refsect1>
  <refsect1 role="seealso">