From e4847a471dfaae60066a3e750b2f333b36a4b879 Mon Sep 17 00:00:00 2001
From: Sean Coates <sean@php.net>
Date: Wed, 3 Aug 2005 20:28:13 +0000
Subject: [PATCH] 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                          | 5 +++++
 reference/funchand/functions/func-get-arg.xml  | 5 ++++-
 reference/funchand/functions/func-get-args.xml | 5 ++++-
 reference/funchand/functions/func-num-args.xml | 5 ++++-
 4 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/language-snippets.ent b/language-snippets.ent
index 6032e63f90..a0f21b614f 100644
--- a/language-snippets.ent
+++ b/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
diff --git a/reference/funchand/functions/func-get-arg.xml b/reference/funchand/functions/func-get-arg.xml
index 31a03a13fc..c1128b0f3f 100644
--- a/reference/funchand/functions/func-get-arg.xml
+++ b/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">
diff --git a/reference/funchand/functions/func-get-args.xml b/reference/funchand/functions/func-get-args.xml
index 9ea49ac5e7..ab4550c37e 100644
--- a/reference/funchand/functions/func-get-args.xml
+++ b/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">
diff --git a/reference/funchand/functions/func-num-args.xml b/reference/funchand/functions/func-num-args.xml
index 6e64e8b6da..edf806ea1d 100644
--- a/reference/funchand/functions/func-num-args.xml
+++ b/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">