diff --git a/functions/array.xml b/functions/array.xml
index 66ad248d3b..c3e7d110d5 100644
--- a/functions/array.xml
+++ b/functions/array.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.168 $ -->
+<!-- $Revision: 1.169 $ -->
  <reference id="ref.array">
   <title>Array Functions</title>
   <titleabbrev>Arrays</titleabbrev>
@@ -2954,6 +2954,12 @@ if (in_array('o', $a))
      <parameter>needle</parameter> and returns the key if it is found in
      the array, &false; otherwise.
     </para>
+    <note>
+     <para>
+      Prior to PHP 4.2.0, <function>array_search</function> returns
+      <constant>NULL</constant> on failure instead of &false;.
+     </para>
+    </note>
     <para>
      If the optional third parameter <parameter>strict</parameter> is set to
      &true; then the <function>array_search</function>
@@ -2962,7 +2968,7 @@ if (in_array('o', $a))
     </para>
     &return.falseproblem;
     <para>
-     See also <function>in_array</function>.
+     See also <function>array_keys</function> and <function>in_array</function>.
     </para>
    </refsect1>
   </refentry>