diff --git a/functions/array.xml b/functions/array.xml
index 7f14134997..bb25007293 100644
--- a/functions/array.xml
+++ b/functions/array.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.147 $ -->
+<!-- $Revision: 1.148 $ -->
  <reference id="ref.array">
   <title>Array Functions</title>
   <titleabbrev>Arrays</titleabbrev>
@@ -140,7 +140,7 @@ Array
     </para>
     <para>
      See also <function>array_pad</function>,
-     <function>list</function>, and <function>range</function>.
+     <function>list</function> and<function>range</function>.
     </para>
    </refsect1>
   </refentry>
@@ -308,9 +308,22 @@ Array
       <programlisting role="php">
 <![CDATA[
 $array = array (1, "hello", 1, "world", "hello");
-array_count_values ($array); // returns array (1=>2, "hello"=>2, "world"=>1)
+print_r(array_count_values ($array)); 
 ]]>
       </programlisting>
+      <para>
+       The printout of the above program will be:
+       <screen>
+<![CDATA[
+Array
+(
+    [1] => 2
+    [hello] => 2
+    [world] => 1
+)
+]]>
+       </screen>
+      </para>
      </example>     
     </para>
    </refsect1>
@@ -417,18 +430,36 @@ function even($var) {
 $array1 = array ("a"=>1, "b"=>2, "c"=>3, "d"=>4, "e"=>5);
 $array2 = array (6, 7, 8, 9, 10, 11, 12);
 
-$odd_arr = array_filter($array1, "odd");
-$even_arr = array_filter($array2, "even");
+echo "Odd :\n";
+print_r(array_filter($array1, "odd"));
+echo "Even:\n";
+print_r(array_filter($array2, "even"));
 ]]>
       </programlisting>
+      <para>
+       The printout of the program above will be:
+       <screen role="php">
+<![CDATA[
+Odd :
+Array
+(
+    [a] => 1
+    [c] => 3
+    [e] => 5
+)
+Even:
+Array
+(
+    [0] => 6
+    [2] => 8
+    [4] => 10
+    [6] => 12
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>     
-    <para>
-     This makes <varname>$odd_arr</varname> have 
-     <literal>array ("a"=&gt;1, "c"=&gt;3, "e"=&gt;5);</literal>,
-     and <varname>$even_arr</varname> have
-     <literal>array (6, 8, 10, 12);</literal>,
-    </para>
     &note.func-callback;
     <para>
      See also <function>array_map</function>, and
@@ -488,9 +519,21 @@ $original = strtr ($str, $trans);
 <![CDATA[
 $trans = array ("a" => 1, "b" => 1, "c" => 2);
 $trans = array_flip ($trans);
-// now $trans is : array(1 => "b", 2 => "c");
+print_r($trans);
 ]]>
       </programlisting>
+      <para>
+       now $trans is :
+       <screen>
+<![CDATA[
+Array
+(
+    [1] => b
+    [2] => c
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
    </refsect1>
@@ -523,19 +566,24 @@ $trans = array_flip ($trans);
       <programlisting role="php">
 <![CDATA[
 $a = array_fill(5, 6, 'banana');
-
-/*
-$a now has the following entries:
-
-$a[5]  = "banana";
-$a[6]  = "banana";
-$a[7]  = "banana";
-$a[8]  = "banana";
-$a[9]  = "banana";
-$a[10] = "banana";
-*/
 ]]>
       </programlisting>
+      <para>
+       $a now has the following entries using <function>print_r</function>:
+       <screen>
+<![CDATA[
+Array
+(
+    [5]  => banana
+    [6]  => banana
+    [7]  => banana
+    [8]  => banana
+    [9]  => banana
+    [10] => banana
+)
+]]>
+       </screen>
+      </para>
      </example>     
     </para>
    </refsect1>
@@ -574,12 +622,20 @@ $array2 = array ("b" => "green", "yellow", "red");
 $result = array_intersect ($array1, $array2);
 ]]>
       </programlisting>
+      <para>
+       This makes <varname>$result</varname> have 
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [a] => green
+    [0] => red
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>     
-    <para>
-     This makes <varname>$result</varname> have <literal>array ("a"
-     =&gt; "green", "red");</literal>
-    </para>
     <note>
      <simpara>
       Two elements are considered equal if and only if 
@@ -678,15 +734,38 @@ if (array_key_exists("first", $search_array)) {
       <programlisting role="php">
 <![CDATA[
 $array = array (0 => 100, "color" => "red");
-array_keys ($array);       // returns array (0, "color")
+print_r(array_keys ($array));
 
 $array = array ("blue", "red", "green", "blue", "blue");
-array_keys ($array, "blue");  //  returns array (0, 3, 4) 
+print_r(array_keys ($array, "blue"));
 
 $array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large"));
-array_keys ($array);  //  returns array ("color", "size") 
+print_r(array_keys ($array));
 ]]>
       </programlisting>
+      <para>
+       The printout of the program above will be:
+       <screen>
+<![CDATA[
+Array
+(
+    [0] => 0
+    [1] => color
+)
+Array
+(
+    [0] => 0
+    [1] => 3
+    [2] => 4
+)
+Array
+(
+    [0] => color
+    [1] => size
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <note>
@@ -758,14 +837,26 @@ function cube($n) {
 
 $a = array(1, 2, 3, 4, 5);
 $b = array_map("cube", $a);
+print_r($b);
 ]]>
       </programlisting>
+      <para>
+       This makes <varname>$b</varname> have:
+       <screen>
+<![CDATA[
+Array
+(
+    [0] => 1
+    [1] => 8
+    [2] => 27
+    [3] => 64
+    [4] => 125
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
-    <para>
-     This will result in <varname>$b</varname> containing
-     <literal>array (1, 8, 27, 64, 125);</literal>
-    </para>
     <para>
      <example>
       <title><function>array_map</function> - using more arrays</title>
@@ -783,54 +874,58 @@ $a = array(1, 2, 3, 4, 5);
 $b = array("uno", "dos", "tres", "cuatro", "cinco");
 
 $c = array_map("show_Spanish", $a, $b);
-
 print_r($c);
 
-// will output:
-// Array 
-// (
-//     [0] => The number 1 is called uno in Spanish
-//     [1] => The number 2 is called dos in Spanish
-//     [2] => The number 3 is called tres in Spanish
-//     [3] => The number 4 is called cuatro in Spanish
-//     [4] => The number 5 is called cinco in Spanish
-// )
-
 $d = array_map("map_Spanish", $a , $b);
-
 print_r($d);
-
-// will output:
-// Array 
-// (
-//     [0] => Array
-//         (
-//             [1] => uno
-//         )
-// 
-//     [1] => Array
-//         (
-//             [2] => dos
-//         )
-// 
-//     [2] => Array
-//         (
-//             [3] => tres
-//         )
-// 
-//     [3] => Array
-//         (
-//             [4] => cuatro
-//         )
-// 
-//     [4] => Array
-//         (
-//             [5] => cinco
-//         )
-// 
-// )
 ]]>
       </programlisting>
+      <para>
+       This results:
+       <screen>
+<![CDATA[
+// printout of $c
+Array 
+(
+    [0] => The number 1 is called uno in Spanish
+    [1] => The number 2 is called dos in Spanish
+    [2] => The number 3 is called tres in Spanish
+    [3] => The number 4 is called cuatro in Spanish
+    [4] => The number 5 is called cinco in Spanish
+)
+
+// printout of $d
+Array 
+(
+    [0] => Array
+        (
+            [1] => uno
+        )
+
+    [1] => Array
+        (
+            [2] => dos
+        )
+
+    [2] => Array
+        (
+            [3] => tres
+        )
+
+    [3] => Array
+        (
+            [4] => cuatro
+        )
+
+    [4] => Array
+        (
+            [5] => cinco
+        )
+
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <para>
@@ -856,52 +951,57 @@ $c = array("uno", "dos", "tres", "cuatro", "cinco");
 
 $d = array_map(null, $a, $b, $c);
 print_r($d);
-
-// will output:
-// Array
-// (
-//     [0] => Array
-//         (
-//             [0] => 1
-//             [1] => one
-//             [2] => uno
-//         )
-// 
-//     [1] => Array
-//         (
-//             [0] => 2
-//             [1] => two
-//             [2] => dos
-//         )
-// 
-//     [2] => Array
-//         (
-//             [0] => 3
-//             [1] => three
-//             [2] => tres
-//         )
-// 
-//     [3] => Array
-//         (
-//             [0] => 4
-//             [1] => four
-//             [2] => cuatro
-//         )
-// 
-//     [4] => Array
-//         (
-//             [0] => 5
-//             [1] => five
-//             [2] => cinco
-//         )
-// 
-// )
 ]]>
       </programlisting>
      </example>
+     <para>
+      The printout of the program above will be:
+      <screen>
+<![CDATA[
+Array
+(
+    [0] => Array
+        (
+            [0] => 1
+            [1] => one
+            [2] => uno
+        )
+
+    [1] => Array
+        (
+            [0] => 2
+            [1] => two
+            [2] => dos
+        )
+
+    [2] => Array
+        (
+            [0] => 3
+            [1] => three
+            [2] => tres
+        )
+
+    [3] => Array
+        (
+            [0] => 4
+            [1] => four
+            [2] => cuatro
+        )
+
+    [4] => Array
+        (
+            [0] => 5
+            [1] => five
+            [2] => cinco
+        )
+
+)
+]]>
+      </screen>
+     </para>
     </para>
     <para>
-     See also <function>array_filter</function>,
+     See also <function>array_filter</function> and
      <function>array_reduce</function>.
     </para>
    </refsect1>
@@ -945,12 +1045,25 @@ $array2 = array ("a", "b", "color" => "green", "shape" => "trapezoid", 4);
 $result = array_merge ($array1, $array2);
 ]]>
       </programlisting>
+      <para>
+       The <literal>$result</literal> will be:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [color] => green
+    [0] => 2
+    [1] => 4
+    [2] => a
+    [3] => b
+    [shape] => trapezoid
+    [4] => 4
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
-    <para>
-     Resulting array will be <literal>array("color" =&gt; "green", 2, 4,
-     "a", "b", "shape" =&gt; "trapezoid", 4)</literal>.
-    </para>
     <para>
      See also <function>array_merge_recursive</function>.
     </para>
@@ -997,12 +1110,31 @@ $ar2 = array (10, "color" => array ("favorite" => "green", "blue"));
 $result = array_merge_recursive ($ar1, $ar2);
 ]]>
       </programlisting>
+      <para>
+       The <literal>$result</literal> will be:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [color] => Array
+        (
+            [favorite] => Array
+                (
+                    [0] => red
+                    [1] => green
+                )
+
+            [0] => blue
+        )
+
+    [0] => 5
+    [1] => 10
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
-    <para>
-     Resulting array will be <literal>array ("color" =&gt; array
-     ("favorite" =&gt; array ("red", "green"), "blue"), 5, 10)</literal>.
-    </para>
     <para>
      See also <function>array_merge</function>.
     </para>
@@ -1198,17 +1330,27 @@ $result = array_pad ($input, 2, "noop");
       <title><function>array_pop</function> example</title>
       <programlisting role="php">
 <![CDATA[
-$stack = array ("orange", "apple", "raspberry");
+$stack = array ("orange", "banana", "apple", "raspberry");
 $fruit = array_pop ($stack);
 ]]>
       </programlisting>
+      <para>
+       After this, <varname>$stack</varname> will have only 3 elements:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => orange
+    [1] => banana
+    [2] => apple
+)
+]]>
+       </screen>
+       and <literal>rasberry</literal> will be assigned to 
+       <varname>$fruit</varname>.
+      </para>
      </example>
     </para>
-    <para>
-     After this, <varname>$stack</varname> has only 2 elements:
-     "orange" and "apple", and <varname>$fruit</varname> has
-     "raspberry".
-    </para>
     &return.falseproblem;
     <para>
      See also <function>array_push</function>,
@@ -1258,18 +1400,29 @@ $array[] = $var;
       <title><function>array_push</function> example</title>
       <programlisting role="php">
 <![CDATA[
-$stack = array (1, 2);
-array_push ($stack, "+", 3);
+$stack = array ("orange", "banana");
+array_push ($stack, "apple", "raspberry");
 ]]>
       </programlisting>
+      <para>
+       This example would result in <varname>$stack</varname> having 
+       the following elements: 
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => orange
+    [1] => banana
+    [2] => apple
+    [3] => raspberry
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <para>
-     This example would result in <varname>$stack</varname> having 4
-     elements: 1, 2, "+", and 3.
-    </para>
-    <para>
-     See also: <function>array_pop</function>,
+     See also <function>array_pop</function>,
      <function>array_shift</function>, and
      <function>array_unshift</function>.
     </para>
@@ -1357,20 +1510,47 @@ print $input[$rand_keys[1]]."\n";
       <title><function>array_reverse</function> example</title>
       <programlisting role="php">
 <![CDATA[
-$input = array ("php", 4.0, array ("green", "red"));
+$input  = array ("php", 4.0, array ("green", "red"));
 $result = array_reverse ($input);
 $result_keyed = array_reverse ($input, TRUE);
 ]]>
       </programlisting>
+      <para>
+       This makes both <varname>$result</varname> and
+       <varname>$result_keyed</varname> have the same elements, but
+       note the difference between the keys. The printout of 
+       <varname>$result</varname> and
+       <varname>$result_keyed</varname> will be:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => Array
+        (
+            [0] => green
+            [1] => red
+        )
+
+    [1] => 4
+    [2] => php
+)
+Array
+(
+    [2] => Array
+        (
+            [0] => green
+            [1] => red
+        )
+
+    [1] => 4
+    [0] => php
+)
+]]>
+       </screen>
+      </para>
+
      </example>
     </para>
-    <para>
-     This makes both <varname>$result</varname> and
-     <varname>$result_keyed</varname> be <literal>array(array
-     ("green", "red"), 4.0, "php")</literal>. But
-     <varname>$result_keyed[0]</varname> is still
-     <literal>"php"</literal>.
-    </para>
     <note>
      <para>
       The second parameter was added in PHP 4.0.3.
@@ -1438,7 +1618,7 @@ $d = array_reduce($x, "rsum", 1);
      <varname>$d</varname> containing <literal>1</literal>.
     </para>
     <para>
-     See also <function>array_filter</function>,
+     See also <function>array_filter</function>, and
      <function>array_map</function>.
     </para>
    </refsect1>
@@ -1471,19 +1651,30 @@ $d = array_reduce($x, "rsum", 1);
       <title><function>array_shift</function> example</title>
       <programlisting role="php">
 <![CDATA[
-$args = array ("-v", "-f");
-$opt = array_shift ($args);
+$stack = array ("orange", "banana", "apple", "raspberry");
+$fruit = array_shift ($stack);
 ]]>
       </programlisting>
+      <para>
+       This would result in <varname>$fruit</varname> having 3 elements left:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => banana
+    [1] => apple
+    [2] => raspberry
+)
+]]>
+       </screen>
+       and <literal>orange</literal> will be assigned to 
+       <varname>$fruit</varname>.
+      </para>
      </example>
     </para>
-    <para>
-     This would result in <varname>$args</varname> having one element
-     "-f" left, and <varname>$opt</varname> being "-v".
-    </para>
     <para>
      See also <function>array_unshift</function>,
-     <function>array_push</function>, and
+     <function>array_push</function> and
      <function>array_pop</function>.
     </para>
    </refsect1>
@@ -1536,10 +1727,10 @@ $opt = array_shift ($args);
 <![CDATA[
 $input = array ("a", "b", "c", "d", "e");
 
-$output = array_slice ($input, 2);      // returns "c", "d", and "e"
+$output = array_slice ($input, 2);      // returns "c", "d" and "e"
 $output = array_slice ($input, 2, -1);  // returns "c", "d"
 $output = array_slice ($input, -2, 1);  // returns "d"
-$output = array_slice ($input, 0, 3);   // returns "a", "b", and "c"
+$output = array_slice ($input, 0, 3);   // returns "a", "b" and "c"
 ]]>
       </programlisting>
      </example>
@@ -1673,7 +1864,7 @@ array_splice ($input, -1, 1, array("black", "maroon"));
     <funcsynopsis>
      <funcprototype>
       <funcdef>mixed <function>array_sum</function></funcdef>
-      <paramdef>array <parameter>arr</parameter></paramdef>
+      <paramdef>array <parameter>array</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -1687,13 +1878,20 @@ array_splice ($input, -1, 1, array("black", "maroon"));
 <![CDATA[
 $a = array(2, 4, 6, 8);
 echo "sum(a) = ".array_sum($a)."\n";
-// prints: sum(a) = 20
 
 $b = array("a"=>1.2,"b"=>2.3,"c"=>3.4);
 echo "sum(b) = ".array_sum($b)."\n";
-// prints: sum(b) = 6.9
 ]]>
       </programlisting>
+      <para>
+       The printout of the program above will be:
+       <screen role="php">
+<![CDATA[
+sum(a) = 20
+sum(b) = 6.9
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <note>
@@ -1726,9 +1924,11 @@ echo "sum(b) = ".array_sum($b)."\n";
      without duplicate values.
     </para>
     <para>
-     Note that keys are preserved. <function>array_unique</function> will
-     keep the first key encountered for every value, and ignore all
-     following keys.
+     Note that keys are preserved. <function>array_unique</function> sorts
+     the values treated as string at first, then will keep the first key 
+     encountered for every value, and ignore all following keys. It does not
+     mean that the key of the first related value from the unsorted 
+     <parameter>array</parameter> will be kept.
     </para>
     <note>
      <simpara>
@@ -1755,15 +1955,21 @@ echo "sum(b) = ".array_sum($b)."\n";
 $input = array ("a" => "green", "red", "b" => "green", "blue", "red");
 $result = array_unique ($input);
 print_r($result);
-// this will output :
-//Array
-//(
-//    [a] => green
-//    [0] => red
-//    [1] => blue
-//)
 ]]>
       </programlisting>
+      <para>
+       This will output:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [b] => green
+    [1] => blue
+    [2] => red
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <para>
@@ -1774,17 +1980,21 @@ print_r($result);
 $input = array (4,"4","3",4,3,"3");
 $result = array_unique ($input);
 var_dump($result);
-
-/* output:
-array(2) {
-   [0]=>
-   int(4)
-   [1]=>
-   string(1) "3"
-}
-*/
 ]]>
       </programlisting>
+      <para>
+       The printout of the program above will be (PHP 4.0.6):
+       <screen role="php">
+<![CDATA[
+array(2) {
+  [3]=>
+  int(4)
+  [4]=>
+  int(3)
+}
+]]>
+       </screen>
+      </para>
      </example>
     </para>
    </refsect1>
@@ -1826,19 +2036,30 @@ array(2) {
       <title><function>array_unshift</function> example</title>
       <programlisting role="php">
 <![CDATA[
-$queue = array ("p1", "p3");
-array_unshift ($queue, "p4", "p5", "p6");
+$queue = array ("orange", "banana");
+array_unshift ($queue, "apple", "raspberry");
 ]]>
       </programlisting>
+      <para>
+       This would result in <varname>$queue</varname> having the
+       following elements:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => apple
+    [1] => raspberry
+    [2] => orange
+    [3] => banana
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
-    <para>
-     This would result in <varname>$queue</varname> having 5
-     elements: "p4", "p5", "p6", "p1", and "p3".
-    </para>
     <para>
      See also <function>array_shift</function>,
-     <function>array_push</function>, and
+     <function>array_push</function> and
      <function>array_pop</function>.
     </para>
    </refsect1>
@@ -1867,9 +2088,21 @@ array_unshift ($queue, "p4", "p5", "p6");
       <programlisting role="php">
 <![CDATA[
 $array = array ("size" => "XL", "color" => "gold");
-array_values ($array);    // returns array ("XL", "gold")
+print_r(array_values ($array));
 ]]>
       </programlisting>
+      <para>
+       This will output:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [0] => XL
+    [1] => gold
+)
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <note>
@@ -1913,7 +2146,7 @@ function array_values ($arr) {
     <funcsynopsis>
      <funcprototype>
       <funcdef>int <function>array_walk</function></funcdef>
-      <paramdef>array <parameter>arr</parameter></paramdef>
+      <paramdef>array <parameter>array</parameter></paramdef>
       <paramdef>string <parameter>func</parameter></paramdef>
       <paramdef>mixed 
        <parameter><optional>userdata</optional></parameter>
@@ -1922,7 +2155,7 @@ function array_values ($arr) {
     </funcsynopsis>
     <simpara>
      Applies the user-defined function named by <parameter>func</parameter> 
-     to each element of <parameter>arr</parameter>.
+     to each element of <parameter>array</parameter>.
      <parameter>func</parameter> will be passed array value as the
      first parameter and array key as the second parameter.  If
      <parameter>userdata</parameter> is supplied, it will be passed as
@@ -1980,14 +2213,32 @@ function test_alter (&$item1, $key, $prefix) {
 function test_print ($item2, $key) {
     echo "$key. $item2<br>\n";
 }
-
+echo "Before ...:\n";
 array_walk ($fruits, 'test_print');
 reset ($fruits);
 array_walk ($fruits, 'test_alter', 'fruit');
+echo "... and after:\n";
 reset ($fruits);
 array_walk ($fruits, 'test_print');
 ]]>
       </programlisting>
+      <para>
+       The printout of the program above will be:
+       <screen role="php">
+<![CDATA[
+Before ...:
+d. lemon
+a. orange
+b. banana
+c. apple
+... and after:
+d. fruit: lemon
+a. fruit: orange
+b. fruit: banana
+c. fruit: apple
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <simpara>
@@ -2054,8 +2305,8 @@ c = apple
      see <function>sort</function>.
     </para>
     <para>
-     See also: <function>asort</function>, <function>rsort</function>,
-     <function>ksort</function>, and <function>sort</function>.
+     See also <function>asort</function>, <function>rsort</function>,
+     <function>ksort</function> and <function>sort</function>.
     </para>
    </refsect1>
   </refentry>
@@ -2117,7 +2368,7 @@ a = orange
     </para>
     <para>
      See also <function>arsort</function>, <function>rsort</function>,
-     <function>ksort</function>, and <function>sort</function>.
+     <function>ksort</function> and <function>sort</function>.
     </para>
    </refsect1>
   </refentry>
@@ -2173,9 +2424,17 @@ $result = compact ("event", "nothing_here", $location_vars);
 ]]>
       </programlisting>
       <para>
-       After this, <varname>$result</varname> will be <literal>array
-       ("event" =&gt; "SIGGRAPH", "city" =&gt; "San Francisco",
-       "state" =&gt; "CA")</literal>.
+       After this, <varname>$result</varname> will be:
+       <screen role="php">
+<![CDATA[
+Array
+(
+    [event] => SIGGRAPH
+    [city] => San Francisco
+    [state] => CA
+)
+]]>
+       </screen>
       </para>
      </example>
     </para>
@@ -2244,8 +2503,8 @@ $result = count ($b);
     </para>
    <note>
     <para>
-     The <function>sizeof</function> function is an alias for
-     <function>count</function>.
+     The <function>sizeof</function> function is an 
+     <link linkend="aliases">alias</link> for <function>count</function>.
     </para>
    </note>
     <para>
@@ -2293,8 +2552,8 @@ $result = count ($b);
      </warning>
     </para>
     <para>
-     See also: <function>end</function>, <function>next</function>,
-     <function>prev</function>, and <function>reset</function>.
+     See also <function>end</function>, <function>next</function>,
+     <function>prev</function> and<function>reset</function>.
     </para>
    </refsect1>
   </refentry>
@@ -2398,7 +2657,7 @@ while (list ($key, $val) = each ($HTTP_POST_VARS)) {
     <para>
      See also <function>key</function>, <function>list</function>,
      <function>current</function>, <function>reset</function>,
-     <function>next</function>, and <function>prev</function>.
+     <function>next</function> and<function>prev</function>.
     </para>
    </refsect1>
   </refentry>
@@ -2423,9 +2682,9 @@ while (list ($key, $val) = each ($HTTP_POST_VARS)) {
      internal pointer to the last element, and returns that element.
     </para>
     <para>
-     See also: <function>current</function>,
+     See also <function>current</function>,
      <function>each</function>, 
-     <function>next</function>, and <function>reset</function>.
+     <function>next</function> and<function>reset</function>.
     </para>
    </refsect1>
   </refentry>
@@ -2588,7 +2847,7 @@ blue, large, sphere, medium
      will not produce results.
     </para>
     <para>
-     See also: <function>compact</function>.
+     See also <function>compact</function>.
     </para>
    </refsect1>
   </refentry>
@@ -2636,11 +2895,20 @@ $os = array ("Mac", "NT", "Irix", "Linux");
 if (in_array ("Irix", $os)) {
     print "Got Irix";
 }
-if (in_array ("mac", $os)) { # fails because in_array() is case-sensitive
+if (in_array ("mac", $os)) {
     print "Got mac";
 }
 ]]>
       </programlisting>
+      <para>
+       The second condition fails because <function>in_array()</function>
+       is case-sensitive, so the program above will display:
+       <screen role="php">
+<![CDATA[
+Got Irix
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <para>
@@ -2656,12 +2924,16 @@ if (in_array('12.4', $a, TRUE))
 if (in_array(1.13, $a, TRUE))
     echo "1.13 found with strict check\n";
 ?>
-
-// This will output:
-
-1.13 found with strict check
 ]]>
       </programlisting>
+      <para>
+       This will display:
+       <screen role="php">
+<![CDATA[
+1.13 found with strict check
+]]>
+       </screen>
+      </para>
      </example>
     </para>
     <para>
@@ -2766,16 +3038,14 @@ while (list ($key, $val) = each ($fruits)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 d = lemon
 c = apple
 b = banana
 a = orange
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
     <para>
      You may modify the behavior of the sort using the optional
@@ -2784,8 +3054,8 @@ a = orange
     </para>
     <simpara>
      See also <function>asort</function>, <function>arsort</function>,
-     <function>ksort</function> <function>sort</function>, 
-     <function>natsort</function>and <function>rsort</function>.
+     <function>ksort</function>, <function>sort</function>, 
+     <function>natsort</function> and <function>rsort</function>.
     </simpara>
    </refsect1>
   </refentry>
@@ -2827,16 +3097,14 @@ while (list ($key, $val) = each ($fruits)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 a = orange
 b = banana
 c = apple
 d = lemon
 ]]>
-      </programlisting>
-     </informalexample>     
+     </screen>     
     </para>
     <para>
      You may modify the behavior of the sort using the optional
@@ -2845,7 +3113,7 @@ d = lemon
     </para>
     <simpara>
      See also <function>asort</function>, <function>arsort</function>, 
-     <function>sort</function>, <function>natsort</function>, and 
+     <function>sort</function>, <function>natsort</function> and
      <function>rsort</function>.
     </simpara>
     <note>
@@ -2952,8 +3220,7 @@ print_r($array2);
      The code above will generate the following output:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 Standard sorting
 Array
@@ -2973,8 +3240,7 @@ Array
     [0] => img12.png
 )
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
      For more information see: Martin Pool's <ulink
      url="&url.strnatcmp;">Natural Order String Comparison</ulink>
      page.
@@ -3066,9 +3332,9 @@ Array
      </warning>
     </para>
     <para>
-     See also:
+     See also
      <function>current</function>, <function>end</function>,
-     <function>prev</function>, and <function>reset</function>.
+     <function>prev</function> and<function>reset</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3087,10 +3353,11 @@ Array
      </funcprototype>
     </funcsynopsis>
     <simpara>
-     This is an alias for <function>current</function>.
+     This is an <link linkend="aliases">alias</link> 
+     for <function>current</function>.
     </simpara>
     <para>
-     See also:
+     See also
      <function>end</function>, <function>next</function>,
      <function>prev</function> and <function>reset</function>.
     </para>
@@ -3129,8 +3396,8 @@ Array
      pointer one place instead of advancing it.
     </para>
     <para>
-     See also: <function>current</function>, <function>end</function>,
-     <function>next</function>, and <function>reset</function>.
+     See also <function>current</function>, <function>end</function>,
+     <function>next</function> and<function>reset</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3225,7 +3492,7 @@ foreach(array_map('chr', range(ord('a'),ord('z'))) as $character) {
      element.
     </para>
     <para>
-     See also: <function>current</function>,
+     See also <function>current</function>,
      <function>each</function>, <function>next</function>,
      and <function>prev</function>.
     </para>
@@ -3268,16 +3535,14 @@ while (list ($key, $val) = each ($fruits)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 0 = orange
 1 = lemon
 2 = banana
 3 = apple
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
     <para>
      The fruits have been sorted in reverse alphabetical order.
@@ -3288,9 +3553,9 @@ while (list ($key, $val) = each ($fruits)) {
      see <function>sort</function>.
     </para>
     <para>
-     See also: <function>arsort</function>,
+     See also <function>arsort</function>,
      <function>asort</function>, <function>ksort</function>,
-     <function>sort</function>, and <function>usort</function>.
+     <function>sort</function> and<function>usort</function>.
     </para>
    </refsect1>
   </refentry>
@@ -3348,8 +3613,8 @@ while (list (, $number) = each ($numbers)) {
      </funcprototype>
     </funcsynopsis>
     <para>
-     The <function>sizeof</function> function is an alias for
-     <function>count</function>.
+     The <function>sizeof</function> function is an 
+     <link linkend="aliases">alias</link> for <function>count</function>.
     </para>
     <para>
      See also <function>count</function>.
@@ -3398,16 +3663,14 @@ while (list ($key, $val) = each ($fruits)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 fruits[0] = apple
 fruits[1] = banana
 fruits[2] = lemon
 fruits[3] = orange
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
     <para>
      The fruits have been sorted in alphabetical order.
@@ -3431,7 +3694,7 @@ fruits[3] = orange
      </itemizedlist>
     </para>
     <para>
-     See also: <function>arsort</function>,
+     See also <function>arsort</function>,
      <function>asort</function>, <function>ksort</function>,
      <function>natsort</function>, <function>natcasesort</function>,
      <function>rsort</function>, <function>usort</function>,
@@ -3479,7 +3742,7 @@ fruits[3] = orange
     </note>
     &note.func-callback;
     <para>
-     See also: <function>usort</function>, <function>uksort</function>, 
+     See also <function>usort</function>, <function>uksort</function>, 
      <function>sort</function>, <function>asort</function>, 
      <function>arsort</function>, <function>ksort</function> 
      and <function>rsort</function>.
@@ -3532,20 +3795,18 @@ while (list ($key, $value) = each ($a)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 20: twenty
 10: ten
 4: four
 3: three
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
     &note.func-callback;
     <para>
-     See also: <function>usort</function>, <function>uasort</function>, 
+     See also <function>usort</function>, <function>uasort</function>, 
      <function>sort</function>, <function>asort</function>, 
      <function>arsort</function>, <function>ksort</function>,
      <function>natsort</function> and <function>rsort</function>.
@@ -3582,10 +3843,6 @@ while (list ($key, $value) = each ($a)) {
      second. If two members compare as equal, their order in the
      sorted array is undefined.
     </para>
-    <para>
-     It is also possible to use a member function of an object as the
-     comparison function. See example number 3 below.
-    </para>
     <para>
      <example>
       <title><function>usort</function> example</title>
@@ -3611,8 +3868,7 @@ while (list ($key, $value) = each ($a)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 0: 6
 1: 5
@@ -3620,8 +3876,7 @@ while (list ($key, $value) = each ($a)) {
 3: 2
 4: 1
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
     <note>
      <para>
@@ -3661,17 +3916,15 @@ while (list ($key, $value) = each ($fruits)) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 <![CDATA[
 $fruits[0]: apples
 $fruits[1]: grapes
 $fruits[2]: lemons
 ]]>
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
-
+    &note.func-callback;
     <para>
      <example>
       <title>
@@ -3714,13 +3967,11 @@ foreach ($a as $item) {
      This example would display:
     </para>
     <para>
-     <informalexample>
-      <programlisting>
+     <screen>
 b
 c
 d
-      </programlisting>
-     </informalexample>
+     </screen>
     </para>
     <warning>
      <para>
@@ -3730,11 +3981,11 @@ d
      </para>
     </warning>
     <para>
-     See also: <function>uasort</function>,
+     See also <function>uasort</function>,
      <function>uksort</function>, <function>sort</function>,
      <function>asort</function>,
      <function>arsort</function>,<function>ksort</function>,
-     <function>natsort</function>, and <function>rsort</function>.
+     <function>natsort</function> and<function>rsort</function>.
     </para>
    </refsect1>
   </refentry>