add note about using these functions as parameters

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

language-snippets.ent

@@ -61,6 +61,11 @@ directive but instead use other means, such as the &link.superglobals;.
 etc. have  been available.  For more information, read the manual section 
 on &link.superglobals;</para></note>'>
 
+<!ENTITY note.funcnoparam '<note><para>Because this function depends on the
+current scope to determine parameter details, it cannot be used as a
+function parameter. If you must pass this value, assign the results to a
+variable, and pass the variable.</para></note>'>
+
 <!-- Tips -->
 
 <!ENTITY tip.fopen-wrapper '<tip><simpara>You can use a URL as a

reference/funchand/functions/func-get-arg.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <!-- splitted from ./en/functions/funchand.xml, last change in rev 1.1 -->
   <refentry id="function.func-get-arg">
    <refnamediv>
@@ -27,6 +27,9 @@
      arguments actually passed, a warning will be generated and
      <function>func_get_arg</function> will return &false;.
     </simpara>
+
+    &note.funcnoparam;
+
     <para>
      <informalexample>
       <programlisting role="php">

reference/funchand/functions/func-get-args.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <!-- splitted from ./en/functions/funchand.xml, last change in rev 1.1 -->
   <refentry id="function.func-get-args">
    <refnamediv>
@@ -29,6 +29,9 @@
       account for default (non-passed) arguments.
      </simpara>
     </note>
+
+    &note.funcnoparam;
+
     <para>
      <informalexample>
       <programlisting role="php">

reference/funchand/functions/func-num-args.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <!-- splitted from ./en/functions/funchand.xml, last change in rev 1.1 -->
   <refentry id="function.func-num-args">
    <refnamediv>
@@ -22,6 +22,9 @@
      its result may be assigned to a variable, which can then be passed to
      the function.
     </simpara>
+    
+    &note.funcnoparam;
+    
     <para>
      <informalexample>
       <programlisting role="php">