From 26b40435b4c23fa0d140cef9cff0b27cbb7ebcc1 Mon Sep 17 00:00:00 2001
From: Andrei Zmievski <andrei@php.net>
Date: Mon, 21 Oct 2002 18:25:21 +0000
Subject: [PATCH] Some docs for EXTR_REFS flag.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@100472 c90b9560-bf6c-de11-be94-00142212c4b1
---
 functions/array.xml | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/functions/array.xml b/functions/array.xml
index f01bbce034..3af3aea22b 100644
--- a/functions/array.xml
+++ b/functions/array.xml
@@ -8,7 +8,7 @@
      instead -->
      
      <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.174 $ -->
+<!-- $Revision: 1.175 $ -->
  <reference id="ref.array">
   <title>Array Functions</title>
   <titleabbrev>Arrays</titleabbrev>
@@ -2670,6 +2670,9 @@ while (list ($key, $val) = each ($HTTP_POST_VARS)) {
      <para>
       EXTR_IF_EXISTS and EXTR_PREFIX_IF_EXISTS was introduced in version 4.2.0.
      </para>
+     <para>
+      EXTR_REFS was introduced in version 4.3.0.
+     </para>
     </note>
     <para>
      <function>extract</function> checks each key to see whether it
@@ -2759,6 +2762,12 @@ while (list ($key, $val) = each ($HTTP_POST_VARS)) {
      the prefixed result is not a valid variable name, it is not 
      imported into the symbol table.
     </para>
+    <para>
+     An additional EXTR_REFS flag can be OR'ed together with the
+     <parameter>extract_type</parameter>. If it is set, the variables are
+     imported into the symbol table as references, and modifying any of them
+     will also modify the entries in the <parameter>var_array</parameter>.
+    </para>
     <para>
      <function>extract</function> returns the number of variables
      successfully imported into the symbol table.