[PHP-DOC] cvs: phpdoc /en/faq misc.xml

[Jakub Vrana]

vrana           Wed Aug  4 09:07:42 2004 EDT

  Modified files:              
    /phpdoc/en/faq      misc.xml 
  Log:
  FAQ for & beside arguments in function declarations
  
http://cvs.php.net/diff.php/phpdoc/en/faq/misc.xml?r1=1.14&r2=1.15&ty=u
Index: phpdoc/en/faq/misc.xml
diff -u phpdoc/en/faq/misc.xml:1.14 phpdoc/en/faq/misc.xml:1.15
--- phpdoc/en/faq/misc.xml:1.14 Wed Aug  4 08:37:37 2004
+++ phpdoc/en/faq/misc.xml      Wed Aug  4 09:07:41 2004
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.14 $ -->
+<!-- $Revision: 1.15 $ -->
  <chapter id="faq.misc">
   <title>Miscellaneous Questions</title>
   <titleabbrev>Miscellaneous Questions</titleabbrev>
@@ -75,6 +75,26 @@
      </para>
     </answer>
    </qandaentry>
+   
+   <qandaentry id="faq.misc.arguments.references">
+    <question>
+     <para>
+      What does &amp; beside argument mean in function declaration of e.g.
+      <function>asort</function>?
+     </para>
+    </question>
+    <answer>
+     <para>
+      It means that the argument is
+      <link linkend="language.references.pass">passed by reference</link> and
+      the function will likely modify it corresponding to the documentation. You
+      can pass only variables this way and you don't need to pass them with
+      &amp; in function call (it's even
+      <link linkend="ini.allow-call-time-pass-reference">deprecated</link>).
+     </para>
+    </answer>
+   </qandaentry>
+   
   </qandaset>
  </chapter>