- Document new EXTR_REFS flag introduced by Andrei.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@95373 c90b9560-bf6c-de11-be94-00142212c4b1

reference/array/functions/extract.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
   <refentry id="function.extract">
    <refnamediv>
@@ -36,6 +36,11 @@
       EXTR_IF_EXISTS and EXTR_PREFIX_IF_EXISTS was introduced in version 4.2.0.
      </para>
     </note>
+    <note>
+     <para>
+      EXTR_REFS was introduced in version 4.3.0.
+     </para>
+    </note>
     <para>
      <function>extract</function> checks each key to see whether it
      constitutes a valid variable name and also for collisions with
@@ -111,6 +116,19 @@
         </simpara>
        </listitem>
       </varlistentry>
+      <varlistentry>
+       <term>EXTR_REFS</term>
+       <listitem>
+        <simpara>
+         Extracts variables as references. This effectively means that the
+         values of the imported variables are still referencing the values of
+         the <parameter>var_array</parameter> parameter. You can use this flag
+         on it's own or combine it with any other flag by OR'ing the
+         <parameter>extract_type</parameter>. This flag was added in PHP
+         4.3.0.
+        </simpara>
+       </listitem>
+      </varlistentry>
      </variablelist>
     </para>
     <para>