cvs: peardoc /en/pecl apd.xml
| From: | Philip Olson | Date: | Mon, 28 Apr 2003 01:18:35 +0000 |
| Subject: | cvs: peardoc /en/pecl apd.xml | ||
| Groups: | php.pear.doc | ||
| Request: | Send a blank email to pear-doc+get-680@lists.php.net to get a copy of this message | ||
philip Sun Apr 27 21:18:35 2003 EDT
Modified files:
/peardoc/en/pecl apd.xml
Log:
A massive whitespace update and simple XML formatting, like added para's.
No real textual changes.
Index: peardoc/en/pecl/apd.xml diff -u peardoc/en/pecl/apd.xml:1.1 peardoc/en/pecl/apd.xml:1.2 --- peardoc/en/pecl/apd.xml:1.1 Thu Jan 2 22:54:13 2003 +++ peardoc/en/pecl/apd.xml Sun Apr 27 21:18:35 2003 @@ -1,107 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <reference id="pecl.apd"> <title>Advanced PHP debugger</title> <titleabbrev>apd</titleabbrev> <partintro> - - - - - - - - - - - <sect1 id="pecl.apd.partintro"> - <title>Introduction</title> + <title>Introduction</title> + <sect2 id="pecl.apd.intro"> - <title>About apd</title> - <para> - APD is the Advanced PHP Debugger. - It was written to provide strace/truss capability for profiling and debugging php code, - as well as providing the ability to print out a full stack backtrace. - APD does supports interactive and non interactive debugging, by default it writes data to trace - files. APD provides event based logging, so that varying levels of information - (including function calls, arguments passed, timings, etc.) - can be turned on or off for individual scripts. - </para> - <para> - APD is a Zend Extension, modifying the way the internals of PHP handle function calls, - and thus may or may not be compatible with other Zend Extensions (for example Zend Optimizer). - - - </para> - + <title>About apd</title> + <para> + APD is the Advanced PHP Debugger. It was written to provide strace/truss + capability for profiling and debugging php code, as well as providing the + ability to print out a full stack backtrace. APD does supports + interactive and non interactive debugging, by default it writes data to + trace files. APD provides event based logging, so that varying levels of + information (including function calls, arguments passed, timings, etc.) + can be turned on or off for individual scripts. + </para> + <para> + APD is a Zend Extension, modifying the way the internals of PHP handle + function calls, and thus may or may not be compatible with other Zend + Extensions (for example Zend Optimizer). + </para> </sect2> + <sect2 id="pecl.apd.install"> <title>Installation</title> <para> - - Make sure you have installed the CGI version of PHP and it is available - in your current path along with the phpize script. - </para> - <para> - Change into the source directory (either created from the downloaded TAR - archive or from checking out CVS) and run the following commands: - <programlisting role="script"> + Make sure you have installed the CGI version of PHP and it is available + in your current path along with the phpize script. + </para> + <para> + Change into the source directory (either created from the downloaded TAR + archive or from checking out CVS) and run the following commands: + </para> + <para> + <programlisting role="script"> +<![CDATA[ ./configure make install - </programlisting> - </para> - <para> - This automatically should install the 'php_apd' zend module into your - php extensions directory directory. It isn't mandatory to have it there, in fact you can install - it anywhere you care. - </para> - <para> - - In your INI file, add the following lines: - <programlisting role="script"><![CDATA[ +]]> + </programlisting> + </para> + <para> + This automatically should install the 'php_apd' zend module into your + php extensions directory directory. It isn't mandatory to have it there, + in fact you can install it anywhere you care. + </para> + <para> + In your INI file, add the following lines: + </para> + <para> + <programlisting role="script"> +<![CDATA[ zend_extension = /absolute/path/to/php_apd.so apd.dumpdir = /absolute/path/to/trace/directory - ]]> +]]> </programlisting> - </para> - </sect2> - + </para> + </sect2> - <sect2 id="pecl.apd.zend_extension"> - <title>php.ini zend_extension setting</title> - <para> - - Depending on your PHP build, the zend_extension directive can be one - of the following: -<programlisting role="script"><![CDATA[ - + <sect2 id="pecl.apd.zend_extension"> + <title>php.ini zend_extension setting</title> + <para> + Depending on your PHP build, the zend_extension directive can be one + of the following: + </para> + <para> + <programlisting role="script"> +<![CDATA[ zend_extension (non ZTS, non debug build) zend_extension_ts ( ZTS, non debug build) zend_extension_debug (non ZTS, debug build) zend_extension_debug_ts ( ZTS, debug build) zend_extension_debug = /absolute/path/to/php_apd.so - - ]]></programlisting> - </para> - </sect2> - +]]> + </programlisting> + </para> + </sect2> - <sect2 id="pecl.apd.dumpdir"> - <title>php.ini apd.dumpdir setting</title> - - - <para> - - This can either be an absolute path or a relative path. Relative - means always relative to your where from you run your executeable. - </para> - <para> -<programlisting role="text"><![CDATA[ - - + <sect2 id="pecl.apd.dumpdir"> + <title>php.ini apd.dumpdir setting</title> + <para> + This can either be an absolute path or a relative path. Relative + means always relative to your where from you run your executeable. + </para> + <para> + <programlisting role="text"> +<![CDATA[ *** NOTE ****************************************************************** * * If you're running the CGI version of PHP, you will need to add the '-e' @@ -110,75 +99,66 @@ * php -e -f script.php * *************************************************************************** - ]]></programlisting> - + ]]> + </programlisting> </para> - </sect2> - - - - - - - - - - <sect2 id="pecl.apd.installwin32"> - <title>Building on Win32</title> - <para> - - To build APD under windows you need a working PHP compilation - environment as described on http://php.net/ (basically, it requires - you to have MSVC, win32build.zip and bison/flex and some know how - about how to get it to work). Also make sure that adp.dsp has DOS - line endings! If it has unix line endings, MSVC will complain about it. -</para><para> - - You can use normal Windows path values for your PHP.INI settings: -<programlisting role="text"><![CDATA[ - + <title>Building on Win32</title> + <para> + To build APD under windows you need a working PHP compilation + environment as described on http://php.net/ (basically, it requires + you to have MSVC, win32build.zip and bison/flex and some know how + about how to get it to work). Also make sure that adp.dsp has DOS + line endings! If it has unix line endings, MSVC will complain about it. + </para> + <para> + You can use normal Windows path values for your &php.ini; settings: + </para> + <para> + <programlisting role="text"> +<![CDATA[ zend_extension_debug_ts = c:\phpdev\php_apd.dll apd.dumpdir = c:\phpdev\traces - -]]></programlisting> - - - </para> - - - </sect2> - +]]> + </programlisting> + </para> + </sect2> - <sect2 id="pecl.apd.usage"> - <title>How to use PHP-APD in your scripts</title> - <para> - - In your PHP script, add the following line: -<programlisting role="php"><![CDATA[ - - apd_set_session_trace(9); -]]></programlisting> - - - Now run your script. - -</para> -<para> - The dump output will be writting to: - - <programlisting role="text"><![CDATA[ - <apd.dumpdir>/apd_dump_<pid> - - ]]></programlisting> - The output itself will look something like: - <programlisting role="text"><![CDATA[ - + <sect2 id="pecl.apd.usage"> + <title>How to use PHP-APD in your scripts</title> + <para> + In your PHP script, add the following line: + </para> + <para> + <programlisting role="php"> +<![CDATA[ +apd_set_session_trace(9); +]]> + </programlisting> + </para> + <para> + Now run your script. + </para> + <para> + The dump output will be writting to: + </para> + <para> + <programlisting role="text"> +<![CDATA[ +<apd.dumpdir>/apd_dump_<pid> +]]> + </programlisting> + </para> + <para> + The output itself will look something like: + </para> + <para> + <programlisting role="text"> +<![CDATA[ 16:37:51(george@wasabi)[~/src/apd]> cat /tmp/apd_dump_31994 - APD - Advanced PHP Debugger Trace File --------------------------------------------------------------------------- Process Pid (31994) @@ -207,44 +187,23 @@ Process Pid (31994) Trace Ended at Fri Aug 10 16:37:45 2001 --------------------------------------------------------------------------- - - ]]></programlisting> - - - </para> - - - </sect2> - - - - - - - +]]> + </programlisting> + </para> + </sect2> - <sect2 id="pecl.apd.contact"> + <sect2 id="pecl.apd.contact"> <title>Contact Information</title> <para> - - </para> - <para> - If you have comments, bugfixes, enhancements or want to help - developping this beast, you can send an mail to <ulink - url="apd-request@lists.communityconnect.com">apd-request@lists.communityconnect.com</ulink>. Any help is very - welcome. + If you have comments, bugfixes, enhancements or want to help developping + this beast, you can send an mail to + <ulink url="mailto:&email.apc;">&email.apc;</ulink>. Any help is very + welcome. </para> - </sect2> - </sect1> - - + </sect2> + </sect1> </partintro> - - -<!-- callstack --> - - <refentry id="pecl.apd.callstack"> <refnamediv> <refname>apd_callstack</refname> @@ -258,30 +217,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Returns the current call stack as an array </para> - <example> - <title><function>apd_callstack</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_callstack</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - print_r(apd_callstack()); +print_r(apd_callstack()); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - -<!-- cluck --> - - <refentry id="pecl.apd.clunk"> <refnamediv> <refname>apd_clunk</refname> @@ -296,34 +249,25 @@ <paramdef>string <parameter><optional>delimiter</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Behaves like perl's Carp::cluck. Throw a warning and a callstack. - The default line delimiter is "<BR />\n". - + Behaves like perl's Carp::cluck. Throw a warning and a callstack. + The default line delimiter is "<BR />\n". </para> - <example> - <title><function>apd_clunk</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_clunk</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_clunk("Some Warning","<P>"); +apd_clunk("Some Warning","<P>"); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - -<!-- croak --> - - <refentry id="pecl.apd.croak"> <refnamediv> <refname>apd_croak</refname> @@ -333,39 +277,30 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef><function>apd_croak</function></funcdef> + <funcdef><function>apd_croak</function></funcdef> <paramdef>string <parameter>warning</parameter></paramdef> <paramdef>string <parameter><optional>delimiter</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Behaves like perl's Carp::croak. Throw an error, a callstack and then - exit. The default line delimiter is "<BR />\n". + Behaves like perl's Carp::croak. Throw an error, a callstack and then + exit. The default line delimiter is "<BR />\n". </para> - <example> - <title><function>apd_croak</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_croak</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_croak("Some Warning","<P>"); - +apd_croak("Some Warning","<P>"); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - - -<!-- apd_dump_regular_resources --> - - + <refentry id="pecl.apd.dump-regular-resources"> <refnamediv> <refname>apd_dump_regular_resources</refname> @@ -379,32 +314,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Return all current regular resources as an array. </para> - <example> - <title><function>apd_dump_regular_resources</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_dump_regular_resources</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - print_r(apd_dump_regular_resources()); +print_r(apd_dump_regular_resources()); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - -<!-- apd_dump_persistent_resources --> - - <refentry id="pecl.apd.dump-persistent-resources"> <refnamediv> <refname>apd_dump_persistent_resources</refname> @@ -418,29 +345,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Return all persistent resources as an array. + Return all persistent resources as an array. </para> - <example> - <title><function>apd_dump_persistent_resources</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_dump_persistent_resources</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - print_r(apd_dump_persistent_resources()); +print_r(apd_dump_persistent_resources()); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - -<!-- apd_dump_function_table --> - - <refentry id="pecl.apd.dump-function-table"> <refnamediv> <refname>apd_dump_function_table</refname> @@ -454,33 +376,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Outputs the current function table. + Outputs the current function table. </para> - <example> - <title><function>apd_dump_function_table</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_dump_function_table</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_dump_function_table(); +apd_dump_function_table(); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - - - -<!-- override_function --> - - + <refentry id="pecl.apd.override-function"> <refnamediv> <refname>override_function</refname> @@ -496,33 +409,25 @@ <paramdef>string<parameter>function_code</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Syntax similar to create_function(). Overrides built-in functions - (replaces them in the symbol table). + (replaces them in the symbol table). </para> - <example> - <title><function>override_function</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>override_function</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - override_function('test', '$a,$b', 'echo "DOING TEST"; return $a * $b;'); - +override_function('test', '$a,$b', 'echo "DOING TEST"; return $a * $b;'); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - -<!-- rename_function --> - - <refentry id="pecl.apd.rename-function"> <refnamediv> <refname>rename_function</refname> @@ -535,38 +440,27 @@ <funcdef><function>override_function</function></funcdef> <paramdef>string<parameter>original_name</parameter></paramdef> <paramdef>string<parameter>new_name</parameter></paramdef> - </funcprototype> </funcsynopsis> - <para> - Renames orig_name to new_name in the global function_table. Useful - for temporarly overriding builtin functions. + Renames orig_name to new_name in the global function_table. Useful + for temporarly overriding builtin functions. </para> - <example> - <title><function>override_function</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>override_function</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - - rename_function('mysql_connect', 'debug_mysql_connect' ); - +rename_function('mysql_connect', 'debug_mysql_connect' ); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - -<!-- apd_set_session_trace --> - - <refentry id="pecl.apd.set-session-trace"> <refnamediv> <refname>apd_set_session_trace</refname> @@ -579,18 +473,20 @@ <funcdef><function>apd_set_session_trace</function></funcdef> <paramdef>int<parameter>debug_level</parameter></paramdef> <paramdef>string<parameter><optional>dump_directory</optional></parameter></paramdef> - </funcprototype> </funcsynopsis> - <para> - Starts debugging to {dump_directory}/apd_dump_{process_id}, if dump_directory is not set, then the - apd.dumpdir setting from the php.ini file is used. + Starts debugging to {dump_directory}/apd_dump_{process_id}, if + dump_directory is not set, then the apd.dumpdir setting from the + php.ini file is used. </para> - <para> - debug_level is an integer which is formed by adding together the following values: -<programlisting role="script"><![CDATA[ - + <para> + debug_level is an integer which is formed by adding together the following + values: + </para> + <para> + <programlisting role="script"> +<![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 @@ -598,36 +494,30 @@ MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 -]]></programlisting> - - I would seriously not recommend using MEMORY_TRACE. It is very slow and - does not appear to be accurate (great, huh?) also ASSIGNMENT_TRACE is not - implemented. So, to turn on all functional traces (TIMING, FUNCTIONS, ARGS - SUMMARY (like strace -c)) use the value 99 - - <example> - <title><function>apd_set_session_trace</function> example</title> - <programlisting role="php"> +]]> + </programlisting> + </para> + <para> + I would seriously not recommend using MEMORY_TRACE. It is very slow and + does not appear to be accurate (great, huh?) also ASSIGNMENT_TRACE is not + implemented. So, to turn on all functional traces (TIMING, FUNCTIONS, ARGS + SUMMARY (like strace -c)) use the value 99 + </para> + <para> + <example> + <title><function>apd_set_session_trace</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - - apd_set_session_trace(99); - +apd_set_session_trace(99); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - -<!-- apd_set_socket_session_trace --> - - <refentry id="pecl.apd.set-socket-session-trace"> <refnamediv> <refname>apd_set_socket_session_trace</refname> @@ -644,20 +534,23 @@ <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Connects to the tcp server (eg. tcplisten) specified IP or Unix Domain socket (like a file), and sends debugging - data to the socket. You can use any port, but higher numbers are better as most of the lower numbers may be used - by other system services.. + Connects to the tcp server (eg. tcplisten) specified IP or Unix Domain + socket (like a file), and sends debugging data to the socket. You can + use any port, but higher numbers are better as most of the lower numbers + may be used by other system services. </para> <para> - the socket_type can be APD_AF_UNIX (for file based sockets) or APD_AF_INET (for standard tcp/ip) + the socket_type can be APD_AF_UNIX (for file based sockets) or APD_AF_INET + (for standard tcp/ip) </para> - - <para> - debug_level is an integer which is formed by adding together the following values: -<programlisting role="script"><![CDATA[ - + <para> + debug_level is an integer which is formed by adding together the following + values: + </para> + <para> + <programlisting role="script"> +<![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 @@ -665,32 +558,29 @@ MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 -]]></programlisting> - - I would seriously not recommend setting the value to 'zero' to start with, and use the breakpoint methods to - start debugging at a specific place in the file. - - <example> - <title><function>apd_set_socket_session_trace</function> example</title> - <programlisting role="php"> +]]> + </programlisting> + </para> + <para> + I would seriously not recommend setting the value to 'zero' to start with, + and use the breakpoint methods to start debugging at a specific place in + the file. + </para> + <para> + <example> + <title><function>apd_set_socket_session_trace</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_set_socket_session_trace("127.0.0.1",APD_AF_INET,7112,0); - ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - -<!-- apd_set_session --> - - <refentry id="pecl.apd.set-session"> <refnamediv> <refname>apd_set_session</refname> @@ -701,16 +591,17 @@ <funcsynopsis> <funcprototype> <funcdef><function>apd_set_session</function></funcdef> - <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - This can be used to increase or decrease debugging in a different area of your application,. - debug_level is an integer which is formed by adding together the following values: -<programlisting role="script"><![CDATA[ - + <para> + This can be used to increase or decrease debugging in a different area of + your application,.debug_level is an integer which is formed by adding + together the following values: + </para> + <para> + <programlisting role="script"> +<![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 @@ -718,32 +609,24 @@ MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 -]]></programlisting> - - - - <example> - <title><function>apd_set_session</function> example</title> - <programlisting role="php"> +]]> + </programlisting> + </para> + <para> + <example> + <title><function>apd_set_session</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - - apd_set_session(9); - +apd_set_session(9); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - -<!-- breakpoint --> - - <refentry id="pecl.apd.breakpoint"> <refnamediv> <refname>apd_breakpoint</refname> @@ -754,17 +637,18 @@ <funcsynopsis> <funcprototype> <funcdef><function>apd_breakpoint</function></funcdef> - <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - This can be used to stop the running of your script, and await responses on the connected socket. - To step the program, just send enter (a blank line), or enter a php command to be executed. - A typical session using tcplisten would look like this. - -<programlisting role="script"><![CDATA[ + <para> + This can be used to stop the running of your script, and await responses + on the connected socket. To step the program, just send enter (a blank + line), or enter a php command to be executed. A typical session using + tcplisten would look like this. + </para> + <para> + <programlisting role="script"> +<![CDATA[ bash#tcplisten localhost 7777 APD - Advanced PHP Debugger Trace File @@ -800,23 +684,12 @@ >apd_echo(system('ls /home/mydir')); ........ >apd_continue(0); - - -]]></programlisting> - +]]> + </programlisting> </para> - - </refsect1> </refentry> - - - - -<!-- continue --> - - <refentry id="pecl.apd.continue"> <refnamediv> <refname>apd_continue</refname> @@ -830,29 +703,24 @@ <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> + <para> Usually sent via the socket to restart the interpeter - - <example> - <title><function>apd_set_session</function> example</title> - <programlisting role="php"> + </para> + <para> + <example> + <title><function>apd_set_session</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - >apd_continue(0); - ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - <!-- continue --> - <refentry id="pecl.apd.echo"> <refnamediv> <refname>apd_echo</refname> @@ -866,31 +734,25 @@ <paramdef>string <parameter>output</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - Usually sent via the socket to request information about the running script - - <example> - <title><function>apd_echo</function> example</title> - <programlisting role="php"> + <para> + Usually sent via the socket to request information about the running + script + </para> + <para> + <example> + <title><function>apd_echo</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - >apd_echo($i); - ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - <!-- apd_get_active_symbols --> - <refentry id="pecl.apd.get_active_symbols"> <refnamediv> <refname>apd_get_active_symbols</refname> @@ -904,31 +766,25 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - returns the names of all the variables defined in the active scope, (not their values) - - <example> - <title><function>apd_get_active_symbols</function> example</title> - <programlisting role="php"> + <para> + Returns the names of all the variables defined in the active scope, (not + their values) + </para> + <para> + <example> + <title><function>apd_get_active_symbols</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - ->apd_echo(apd_get_active_symbols()); - +apd_echo(apd_get_active_symbols()); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - </reference> <!-- Keep this comment at the end of the file
Index: peardoc/en/pecl/apd.xml diff -u peardoc/en/pecl/apd.xml:1.1 peardoc/en/pecl/apd.xml:1.2 --- peardoc/en/pecl/apd.xml:1.1 Thu Jan 2 22:54:13 2003 +++ peardoc/en/pecl/apd.xml Sun Apr 27 21:18:35 2003 @@ -1,107 +1,96 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <reference id="pecl.apd"> <title>Advanced PHP debugger</title> <titleabbrev>apd</titleabbrev> <partintro> - - - - - - - - - - - <sect1 id="pecl.apd.partintro"> - <title>Introduction</title> + <title>Introduction</title> + <sect2 id="pecl.apd.intro"> - <title>About apd</title> - <para> - APD is the Advanced PHP Debugger. - It was written to provide strace/truss capability for profiling and debugging php code, - as well as providing the ability to print out a full stack backtrace. - APD does supports interactive and non interactive debugging, by default it writes data to trace - files. APD provides event based logging, so that varying levels of information - (including function calls, arguments passed, timings, etc.) - can be turned on or off for individual scripts. - </para> - <para> - APD is a Zend Extension, modifying the way the internals of PHP handle function calls, - and thus may or may not be compatible with other Zend Extensions (for example Zend Optimizer). - - - </para> - + <title>About apd</title> + <para> + APD is the Advanced PHP Debugger. It was written to provide strace/truss + capability for profiling and debugging php code, as well as providing the + ability to print out a full stack backtrace. APD does supports + interactive and non interactive debugging, by default it writes data to + trace files. APD provides event based logging, so that varying levels of + information (including function calls, arguments passed, timings, etc.) + can be turned on or off for individual scripts. + </para> + <para> + APD is a Zend Extension, modifying the way the internals of PHP handle + function calls, and thus may or may not be compatible with other Zend + Extensions (for example Zend Optimizer). + </para> </sect2> + <sect2 id="pecl.apd.install"> <title>Installation</title> <para> - - Make sure you have installed the CGI version of PHP and it is available - in your current path along with the phpize script. - </para> - <para> - Change into the source directory (either created from the downloaded TAR - archive or from checking out CVS) and run the following commands: - <programlisting role="script"> + Make sure you have installed the CGI version of PHP and it is available + in your current path along with the phpize script. + </para> + <para> + Change into the source directory (either created from the downloaded TAR + archive or from checking out CVS) and run the following commands: + </para> + <para> + <programlisting role="script"> +<![CDATA[ ./configure make install - </programlisting> - </para> - <para> - This automatically should install the 'php_apd' zend module into your - php extensions directory directory. It isn't mandatory to have it there, in fact you can install - it anywhere you care. - </para> - <para> - - In your INI file, add the following lines: - <programlisting role="script"><![CDATA[ +]]> + </programlisting> + </para> + <para> + This automatically should install the 'php_apd' zend module into your + php extensions directory directory. It isn't mandatory to have it there, + in fact you can install it anywhere you care. + </para> + <para> + In your INI file, add the following lines: + </para> + <para> + <programlisting role="script"> +<![CDATA[ zend_extension = /absolute/path/to/php_apd.so apd.dumpdir = /absolute/path/to/trace/directory - ]]> +]]> </programlisting> - </para> - </sect2> - + </para> + </sect2> - <sect2 id="pecl.apd.zend_extension"> - <title>php.ini zend_extension setting</title> - <para> - - Depending on your PHP build, the zend_extension directive can be one - of the following: -<programlisting role="script"><![CDATA[ - + <sect2 id="pecl.apd.zend_extension"> + <title>php.ini zend_extension setting</title> + <para> + Depending on your PHP build, the zend_extension directive can be one + of the following: + </para> + <para> + <programlisting role="script"> +<![CDATA[ zend_extension (non ZTS, non debug build) zend_extension_ts ( ZTS, non debug build) zend_extension_debug (non ZTS, debug build) zend_extension_debug_ts ( ZTS, debug build) zend_extension_debug = /absolute/path/to/php_apd.so - - ]]></programlisting> - </para> - </sect2> - +]]> + </programlisting> + </para> + </sect2> - <sect2 id="pecl.apd.dumpdir"> - <title>php.ini apd.dumpdir setting</title> - - - <para> - - This can either be an absolute path or a relative path. Relative - means always relative to your where from you run your executeable. - </para> - <para> -<programlisting role="text"><![CDATA[ - - + <sect2 id="pecl.apd.dumpdir"> + <title>php.ini apd.dumpdir setting</title> + <para> + This can either be an absolute path or a relative path. Relative + means always relative to your where from you run your executeable. + </para> + <para> + <programlisting role="text"> +<![CDATA[ *** NOTE ****************************************************************** * * If you're running the CGI version of PHP, you will need to add the '-e' @@ -110,75 +99,66 @@ * php -e -f script.php * *************************************************************************** - ]]></programlisting> - + ]]> + </programlisting> </para> - </sect2> - - - - - - - - - - <sect2 id="pecl.apd.installwin32"> - <title>Building on Win32</title> - <para> - - To build APD under windows you need a working PHP compilation - environment as described on http://php.net/ (basically, it requires - you to have MSVC, win32build.zip and bison/flex and some know how - about how to get it to work). Also make sure that adp.dsp has DOS - line endings! If it has unix line endings, MSVC will complain about it. -</para><para> - - You can use normal Windows path values for your PHP.INI settings: -<programlisting role="text"><![CDATA[ - + <title>Building on Win32</title> + <para> + To build APD under windows you need a working PHP compilation + environment as described on http://php.net/ (basically, it requires + you to have MSVC, win32build.zip and bison/flex and some know how + about how to get it to work). Also make sure that adp.dsp has DOS + line endings! If it has unix line endings, MSVC will complain about it. + </para> + <para> + You can use normal Windows path values for your &php.ini; settings: + </para> + <para> + <programlisting role="text"> +<![CDATA[ zend_extension_debug_ts = c:\phpdev\php_apd.dll apd.dumpdir = c:\phpdev\traces - -]]></programlisting> - - - </para> - - - </sect2> - +]]> + </programlisting> + </para> + </sect2> - <sect2 id="pecl.apd.usage"> - <title>How to use PHP-APD in your scripts</title> - <para> - - In your PHP script, add the following line: -<programlisting role="php"><![CDATA[ - - apd_set_session_trace(9); -]]></programlisting> - - - Now run your script. - -</para> -<para> - The dump output will be writting to: - - <programlisting role="text"><![CDATA[ - <apd.dumpdir>/apd_dump_<pid> - - ]]></programlisting> - The output itself will look something like: - <programlisting role="text"><![CDATA[ - + <sect2 id="pecl.apd.usage"> + <title>How to use PHP-APD in your scripts</title> + <para> + In your PHP script, add the following line: + </para> + <para> + <programlisting role="php"> +<![CDATA[ +apd_set_session_trace(9); +]]> + </programlisting> + </para> + <para> + Now run your script. + </para> + <para> + The dump output will be writting to: + </para> + <para> + <programlisting role="text"> +<![CDATA[ +<apd.dumpdir>/apd_dump_<pid> +]]> + </programlisting> + </para> + <para> + The output itself will look something like: + </para> + <para> + <programlisting role="text"> +<![CDATA[ 16:37:51(george@wasabi)[~/src/apd]> cat /tmp/apd_dump_31994 - APD - Advanced PHP Debugger Trace File --------------------------------------------------------------------------- Process Pid (31994) @@ -207,44 +187,23 @@ Process Pid (31994) Trace Ended at Fri Aug 10 16:37:45 2001 --------------------------------------------------------------------------- - - ]]></programlisting> - - - </para> - - - </sect2> - - - - - - - +]]> + </programlisting> + </para> + </sect2> - <sect2 id="pecl.apd.contact"> + <sect2 id="pecl.apd.contact"> <title>Contact Information</title> <para> - - </para> - <para> - If you have comments, bugfixes, enhancements or want to help - developping this beast, you can send an mail to <ulink - url="apd-request@lists.communityconnect.com">apd-request@lists.communityconnect.com</ulink>. Any help is very - welcome. + If you have comments, bugfixes, enhancements or want to help developping + this beast, you can send an mail to + <ulink url="mailto:&email.apc;">&email.apc;</ulink>. Any help is very + welcome. </para> - </sect2> - </sect1> - - + </sect2> + </sect1> </partintro> - - -<!-- callstack --> - - <refentry id="pecl.apd.callstack"> <refnamediv> <refname>apd_callstack</refname> @@ -258,30 +217,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Returns the current call stack as an array </para> - <example> - <title><function>apd_callstack</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_callstack</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - print_r(apd_callstack()); +print_r(apd_callstack()); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - -<!-- cluck --> - - <refentry id="pecl.apd.clunk"> <refnamediv> <refname>apd_clunk</refname> @@ -296,34 +249,25 @@ <paramdef>string <parameter><optional>delimiter</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Behaves like perl's Carp::cluck. Throw a warning and a callstack. - The default line delimiter is "<BR />\n". - + Behaves like perl's Carp::cluck. Throw a warning and a callstack. + The default line delimiter is "<BR />\n". </para> - <example> - <title><function>apd_clunk</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_clunk</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_clunk("Some Warning","<P>"); +apd_clunk("Some Warning","<P>"); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - -<!-- croak --> - - <refentry id="pecl.apd.croak"> <refnamediv> <refname>apd_croak</refname> @@ -333,39 +277,30 @@ <title>Description</title> <funcsynopsis> <funcprototype> - <funcdef><function>apd_croak</function></funcdef> + <funcdef><function>apd_croak</function></funcdef> <paramdef>string <parameter>warning</parameter></paramdef> <paramdef>string <parameter><optional>delimiter</optional></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Behaves like perl's Carp::croak. Throw an error, a callstack and then - exit. The default line delimiter is "<BR />\n". + Behaves like perl's Carp::croak. Throw an error, a callstack and then + exit. The default line delimiter is "<BR />\n". </para> - <example> - <title><function>apd_croak</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_croak</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_croak("Some Warning","<P>"); - +apd_croak("Some Warning","<P>"); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - - -<!-- apd_dump_regular_resources --> - - + <refentry id="pecl.apd.dump-regular-resources"> <refnamediv> <refname>apd_dump_regular_resources</refname> @@ -379,32 +314,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Return all current regular resources as an array. </para> - <example> - <title><function>apd_dump_regular_resources</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_dump_regular_resources</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - print_r(apd_dump_regular_resources()); +print_r(apd_dump_regular_resources()); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - -<!-- apd_dump_persistent_resources --> - - <refentry id="pecl.apd.dump-persistent-resources"> <refnamediv> <refname>apd_dump_persistent_resources</refname> @@ -418,29 +345,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Return all persistent resources as an array. + Return all persistent resources as an array. </para> - <example> - <title><function>apd_dump_persistent_resources</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_dump_persistent_resources</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - print_r(apd_dump_persistent_resources()); +print_r(apd_dump_persistent_resources()); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - -<!-- apd_dump_function_table --> - - <refentry id="pecl.apd.dump-function-table"> <refnamediv> <refname>apd_dump_function_table</refname> @@ -454,33 +376,24 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Outputs the current function table. + Outputs the current function table. </para> - <example> - <title><function>apd_dump_function_table</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>apd_dump_function_table</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_dump_function_table(); +apd_dump_function_table(); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - - - -<!-- override_function --> - - + <refentry id="pecl.apd.override-function"> <refnamediv> <refname>override_function</refname> @@ -496,33 +409,25 @@ <paramdef>string<parameter>function_code</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> Syntax similar to create_function(). Overrides built-in functions - (replaces them in the symbol table). + (replaces them in the symbol table). </para> - <example> - <title><function>override_function</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>override_function</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - override_function('test', '$a,$b', 'echo "DOING TEST"; return $a * $b;'); - +override_function('test', '$a,$b', 'echo "DOING TEST"; return $a * $b;'); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - -<!-- rename_function --> - - <refentry id="pecl.apd.rename-function"> <refnamediv> <refname>rename_function</refname> @@ -535,38 +440,27 @@ <funcdef><function>override_function</function></funcdef> <paramdef>string<parameter>original_name</parameter></paramdef> <paramdef>string<parameter>new_name</parameter></paramdef> - </funcprototype> </funcsynopsis> - <para> - Renames orig_name to new_name in the global function_table. Useful - for temporarly overriding builtin functions. + Renames orig_name to new_name in the global function_table. Useful + for temporarly overriding builtin functions. </para> - <example> - <title><function>override_function</function> example</title> - <programlisting role="php"> + <para> + <example> + <title><function>override_function</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - - rename_function('mysql_connect', 'debug_mysql_connect' ); - +rename_function('mysql_connect', 'debug_mysql_connect' ); ?> ]]> - </programlisting> - </example> - + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - -<!-- apd_set_session_trace --> - - <refentry id="pecl.apd.set-session-trace"> <refnamediv> <refname>apd_set_session_trace</refname> @@ -579,18 +473,20 @@ <funcdef><function>apd_set_session_trace</function></funcdef> <paramdef>int<parameter>debug_level</parameter></paramdef> <paramdef>string<parameter><optional>dump_directory</optional></parameter></paramdef> - </funcprototype> </funcsynopsis> - <para> - Starts debugging to {dump_directory}/apd_dump_{process_id}, if dump_directory is not set, then the - apd.dumpdir setting from the php.ini file is used. + Starts debugging to {dump_directory}/apd_dump_{process_id}, if + dump_directory is not set, then the apd.dumpdir setting from the + php.ini file is used. </para> - <para> - debug_level is an integer which is formed by adding together the following values: -<programlisting role="script"><![CDATA[ - + <para> + debug_level is an integer which is formed by adding together the following + values: + </para> + <para> + <programlisting role="script"> +<![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 @@ -598,36 +494,30 @@ MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 -]]></programlisting> - - I would seriously not recommend using MEMORY_TRACE. It is very slow and - does not appear to be accurate (great, huh?) also ASSIGNMENT_TRACE is not - implemented. So, to turn on all functional traces (TIMING, FUNCTIONS, ARGS - SUMMARY (like strace -c)) use the value 99 - - <example> - <title><function>apd_set_session_trace</function> example</title> - <programlisting role="php"> +]]> + </programlisting> + </para> + <para> + I would seriously not recommend using MEMORY_TRACE. It is very slow and + does not appear to be accurate (great, huh?) also ASSIGNMENT_TRACE is not + implemented. So, to turn on all functional traces (TIMING, FUNCTIONS, ARGS + SUMMARY (like strace -c)) use the value 99 + </para> + <para> + <example> + <title><function>apd_set_session_trace</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - - apd_set_session_trace(99); - +apd_set_session_trace(99); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - -<!-- apd_set_socket_session_trace --> - - <refentry id="pecl.apd.set-socket-session-trace"> <refnamediv> <refname>apd_set_socket_session_trace</refname> @@ -644,20 +534,23 @@ <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - <para> - Connects to the tcp server (eg. tcplisten) specified IP or Unix Domain socket (like a file), and sends debugging - data to the socket. You can use any port, but higher numbers are better as most of the lower numbers may be used - by other system services.. + Connects to the tcp server (eg. tcplisten) specified IP or Unix Domain + socket (like a file), and sends debugging data to the socket. You can + use any port, but higher numbers are better as most of the lower numbers + may be used by other system services. </para> <para> - the socket_type can be APD_AF_UNIX (for file based sockets) or APD_AF_INET (for standard tcp/ip) + the socket_type can be APD_AF_UNIX (for file based sockets) or APD_AF_INET + (for standard tcp/ip) </para> - - <para> - debug_level is an integer which is formed by adding together the following values: -<programlisting role="script"><![CDATA[ - + <para> + debug_level is an integer which is formed by adding together the following + values: + </para> + <para> + <programlisting role="script"> +<![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 @@ -665,32 +558,29 @@ MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 -]]></programlisting> - - I would seriously not recommend setting the value to 'zero' to start with, and use the breakpoint methods to - start debugging at a specific place in the file. - - <example> - <title><function>apd_set_socket_session_trace</function> example</title> - <programlisting role="php"> +]]> + </programlisting> + </para> + <para> + I would seriously not recommend setting the value to 'zero' to start with, + and use the breakpoint methods to start debugging at a specific place in + the file. + </para> + <para> + <example> + <title><function>apd_set_socket_session_trace</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - apd_set_socket_session_trace("127.0.0.1",APD_AF_INET,7112,0); - ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - -<!-- apd_set_session --> - - <refentry id="pecl.apd.set-session"> <refnamediv> <refname>apd_set_session</refname> @@ -701,16 +591,17 @@ <funcsynopsis> <funcprototype> <funcdef><function>apd_set_session</function></funcdef> - <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - This can be used to increase or decrease debugging in a different area of your application,. - debug_level is an integer which is formed by adding together the following values: -<programlisting role="script"><![CDATA[ - + <para> + This can be used to increase or decrease debugging in a different area of + your application,.debug_level is an integer which is formed by adding + together the following values: + </para> + <para> + <programlisting role="script"> +<![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 @@ -718,32 +609,24 @@ MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 -]]></programlisting> - - - - <example> - <title><function>apd_set_session</function> example</title> - <programlisting role="php"> +]]> + </programlisting> + </para> + <para> + <example> + <title><function>apd_set_session</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - - apd_set_session(9); - +apd_set_session(9); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - -<!-- breakpoint --> - - <refentry id="pecl.apd.breakpoint"> <refnamediv> <refname>apd_breakpoint</refname> @@ -754,17 +637,18 @@ <funcsynopsis> <funcprototype> <funcdef><function>apd_breakpoint</function></funcdef> - <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - This can be used to stop the running of your script, and await responses on the connected socket. - To step the program, just send enter (a blank line), or enter a php command to be executed. - A typical session using tcplisten would look like this. - -<programlisting role="script"><![CDATA[ + <para> + This can be used to stop the running of your script, and await responses + on the connected socket. To step the program, just send enter (a blank + line), or enter a php command to be executed. A typical session using + tcplisten would look like this. + </para> + <para> + <programlisting role="script"> +<![CDATA[ bash#tcplisten localhost 7777 APD - Advanced PHP Debugger Trace File @@ -800,23 +684,12 @@ >apd_echo(system('ls /home/mydir')); ........ >apd_continue(0); - - -]]></programlisting> - +]]> + </programlisting> </para> - - </refsect1> </refentry> - - - - -<!-- continue --> - - <refentry id="pecl.apd.continue"> <refnamediv> <refname>apd_continue</refname> @@ -830,29 +703,24 @@ <paramdef>int<parameter>debug_level</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> + <para> Usually sent via the socket to restart the interpeter - - <example> - <title><function>apd_set_session</function> example</title> - <programlisting role="php"> + </para> + <para> + <example> + <title><function>apd_set_session</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - >apd_continue(0); - ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - <!-- continue --> - <refentry id="pecl.apd.echo"> <refnamediv> <refname>apd_echo</refname> @@ -866,31 +734,25 @@ <paramdef>string <parameter>output</parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - Usually sent via the socket to request information about the running script - - <example> - <title><function>apd_echo</function> example</title> - <programlisting role="php"> + <para> + Usually sent via the socket to request information about the running + script + </para> + <para> + <example> + <title><function>apd_echo</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - >apd_echo($i); - ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - <!-- apd_get_active_symbols --> - <refentry id="pecl.apd.get_active_symbols"> <refnamediv> <refname>apd_get_active_symbols</refname> @@ -904,31 +766,25 @@ <paramdef><parameter></parameter></paramdef> </funcprototype> </funcsynopsis> - - <para> - returns the names of all the variables defined in the active scope, (not their values) - - <example> - <title><function>apd_get_active_symbols</function> example</title> - <programlisting role="php"> + <para> + Returns the names of all the variables defined in the active scope, (not + their values) + </para> + <para> + <example> + <title><function>apd_get_active_symbols</function> example</title> + <programlisting role="php"> <![CDATA[ <?php - ->apd_echo(apd_get_active_symbols()); - +apd_echo(apd_get_active_symbols()); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> </refsect1> </refentry> - - - - - </reference> <!-- Keep this comment at the end of the file