Description:
------------
---
From manual page: http://www.php.net/function.func-num-args
From manual page: http://www.php.net/function.func-get-arg 
From manual page: http://www.php.net/function.func-get-args
---
As indicated in the documentation, versions after 5.3.0 generates a warning and returns -1 when used from within an include or require call.

Because, I've found these functions really useful for generating debug files in complex algorythms in variable data sets, I think you should return back to the functionality prior to versions 5.3.0. 

Or, alternatively, organise someting along the lines of :- 

Test script:
---------------
<?php

function test_function ( &$data_list ) {

   static $function_name_or_handle = __FUNCTION__;
   $debug_data = array ();
   include ( vars_initial.php );

     .   .  test algorythm  .   .

   include ( vars_final.php );
   }
?>

vars_initial.php and vars_final.php would utilise :-

  func-num-args ( [ $function_name_or_handle ] );
  func_get_arg  ( $arg_num, [ $function_name_or_handle ] );
  func_get_args ( [ $function_name_or_handle ] );

to generate data that is used to compile a debug report.

If no $function_name_or_handle is supplied then the current function is used or a warning is generated when called from within an include or require call.


Expected result:
----------------
To be able to generate valid data from :-

  func-num-args ();
  func_get_arg  ();
  func_get_args ();

when called from within a include or require construct.


Actual result:
--------------
Error/Warning Messages.