- Updated docs for call_user_func_array() in light of PHP 5.4 developments.

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

reference/funchand/functions/call-user-func-array.xml

@@ -172,16 +172,20 @@ int(8)
   &reftitle.notes;
   <note>
    <para>
-    Referenced variables in <parameter>param_arr</parameter> are passed to the
-    function by reference, regardless of whether the function expects the
-    respective parameter to be passed by reference. This form of call-time
-    pass by reference does not emit a deprecation notice, but it is nonetheless
-    deprecated, and will most likely be removed in the next version of PHP.
+    Before PHP 5.4, referenced variables in <parameter>param_arr</parameter>
+    are passed to the function by reference, regardless of whether the function
+    expects the respective parameter to be passed by reference. This form of
+    call-time pass by reference does not emit a deprecation notice, but it is
+    nonetheless deprecated, and has been removied in PHP 5.4.
     Furthermore, this does not apply to internal functions, for which
-    the function signature is honored. Passing by value when the function expects
-    a parameter by reference results in a warning and having
-    <function>call_user_func</function> return &false; (does not apply if the 
-    passed value has a reference count = 1).
+    the function signature is honored. Passing by value when the function
+    expects a parameter by reference results in a warning and having
+    <function>call_user_func</function> return &false; (there is, however, an
+    exception for passed values with reference count = 1, such as in literals,
+    as these can be turned into references without ill effects — but also
+    without writes to that value having any effect —; do not rely
+    in this behavior, though, as the reference count is an implementation
+    detail and the soundness of this behavior is questionable).
    </para>
   </note>
   &note.func-callback-exceptions;