diff --git a/reference/array/functions/array-splice.xml b/reference/array/functions/array-splice.xml
index e3890d51e1..dd1135f498 100644
--- a/reference/array/functions/array-splice.xml
+++ b/reference/array/functions/array-splice.xml
@@ -150,16 +150,27 @@ array_splice($input, 3, 0, "purple");
     <programlisting role="php">
 <![CDATA[
 <?php
+
+// append two elements to $input
 array_push($input, $x, $y);
 array_splice($input, count($input), 0, array($x, $y));
+
+// remove the last element of $input
 array_pop($input);
 array_splice($input, -1);
+
+// remove the first element of $input
 array_shift($input);
 array_splice($input, 0, 1);
+
+// insert an element at the start of $input
 array_unshift($input, $x, $y);
 array_splice($input, 0, 0, array($x, $y));
+
+// replace the value in $input at index $x
 $input[$x] = $y; // for arrays where key equals offset
 array_splice($input, $x, 1, $y);
+
 ?>
 ]]>
     </programlisting>