From ab9ab888cc2425ef412b29a10abd9c5781d84dee Mon Sep 17 00:00:00 2001
From: Jakub Vrana <vrana@php.net>
Date: Fri, 6 Aug 2004 22:16:44 +0000
Subject: [PATCH] Parameters are not passed by reference (bug #24931)

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@165569 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../funchand/functions/call-user-func.xml     | 37 +++++++++++++++----
 1 file changed, 30 insertions(+), 7 deletions(-)

diff --git a/reference/funchand/functions/call-user-func.xml b/reference/funchand/functions/call-user-func.xml
index 7c093878da..c3fcaaf167 100644
--- a/reference/funchand/functions/call-user-func.xml
+++ b/reference/funchand/functions/call-user-func.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.10 $ -->
+<!-- $Revision: 1.11 $ -->
 <!-- splitted from ./en/functions/funchand.xml, last change in rev 1.1 -->
   <refentry id="function.call-user-func">
    <refnamediv>
@@ -41,17 +41,15 @@ call_user_func('barber', "shave");
      Object methods may also be invoked statically using this function
      by passing <literal>array($objectname, $methodname)</literal> to
      the <parameter>function</parameter> parameter.
-    </para>
-    <para>
      <informalexample>
       <programlisting role="php">
 <![CDATA[
 <?php
 class myclass {
-  function say_hello() 
-  {
-    echo "Hello!\n";
-  }
+    function say_hello() 
+    {
+        echo "Hello!\n";
+    }
 }
 
 $classname = "myclass";
@@ -62,6 +60,31 @@ call_user_func(array($classname, 'say_hello'));
       </programlisting>
      </informalexample>
     </para>
+    <note>
+     <para>
+      Note that the parameters for <function>call_user_func</function> are not
+      passed by reference.
+      <informalexample>
+       <programlisting role="php">
+<![CDATA[
+<?php
+function increment(&$var)
+{
+    $var++;
+}
+
+$a = 0;
+call_user_func('increment', $a);
+echo $a; // 0
+
+call_user_func_array('increment', array(&$a)); // You can use this instead
+echo $a; // 1
+?>
+]]>
+       </programlisting>
+      </informalexample>
+     </para>
+    </note>
     <para>
      See also:
      <function>is_callable</function>, and