From d6a44ea4447a6ba10eef6a351f652fcdf5b146cc Mon Sep 17 00:00:00 2001
From: Stanislav Malyshev <stas@php.net>
Date: Thu, 17 Mar 2011 19:12:39 +0000
Subject: [PATCH] document new debug_backtrace options

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@309355 c90b9560-bf6c-de11-be94-00142212c4b1
---
 .../errorfunc/functions/debug-backtrace.xml   | 35 +++++++++++++++++--
 1 file changed, 32 insertions(+), 3 deletions(-)

diff --git a/reference/errorfunc/functions/debug-backtrace.xml b/reference/errorfunc/functions/debug-backtrace.xml
index ad2e3b6f87..5c7e30ea37 100644
--- a/reference/errorfunc/functions/debug-backtrace.xml
+++ b/reference/errorfunc/functions/debug-backtrace.xml
@@ -10,7 +10,7 @@
   &reftitle.description;
   <methodsynopsis>
    <type>array</type><methodname>debug_backtrace</methodname>
-   <methodparam choice="opt"><type>bool</type><parameter>provide_object</parameter><initializer>true</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>DEBUG_BACKTRACE_PROVIDE_OBJECT</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>debug_backtrace</function> generates a PHP backtrace.
@@ -22,10 +22,32 @@
   <para>
    <variablelist>
     <varlistentry>
-     <term><parameter>provide_object</parameter></term>
+     <term><parameter>options</parameter></term>
      <listitem>
       <para>
-       Whether or not to populate the "object" index.
+       Since 5.3.6, this parameter is a bitmask for the following options:
+       <table>
+	        <title><function>debug_backtrace</function> options</title>
+	        <tgroup cols="2">
+	         <tbody>
+	          <row>
+	           <entry>DEBUG_BACKTRACE_PROVIDE_OBJECT</entry>
+	           <entry>
+	            Whether or not to populate the "object" index.
+	           </entry>
+	          </row>
+	          <row>
+	           <entry>DEBUG_BACKTRACE_IGNORE_ARGS</entry>
+	           <entry>
+	            Whether or not to omit the "args" index and thus all the method arguments to
+			    to save memory.
+	           </entry>
+	          </row>
+	        </tbody>
+	       </tgroup>
+	   </table>
+	   Before 5.3.6, only value recognized is &true; or &false;, which is the same as 
+	   setting and unsetting <constant>DEBUG_BACKTRACE_PROVIDE_OBJECT</constant> option.
       </para>
      </listitem>
     </varlistentry>
@@ -124,6 +146,13 @@
       </row>
      </thead>
      <tbody>
+      <row>
+       <entry>5.3.6</entry>
+       <entry>
+        The parameter <parameter>provide_object</parameter> changed to <parameter>options</parameter> and additional option
+		<constant>DEBUG_BACKTRACE_IGNORE_ARGS</constant> is added.
+       </entry>
+      </row>
       <row>
        <entry>5.2.5</entry>
        <entry>