[DOC-CVS] [doc-en] master: Use constants for int mask combinations of `debug_backtrace()` (#5537)

[email protected] (Sebastian Hädrich via GitHub) Tue, 5 May 2026 18:24:27 +0000
Newsgroups php.doc.cvs
Message-ID <[email protected]>
Author: Sebastian Hädrich (shaedrich)
Committer: GitHub (web-flow)
Pusher: TimWolla
Date: 2026-05-05T20:24:24+02:00

Commit: https://github.com/php/doc-en/commit/1e31c8f3a81d8fbfc79c0a6b033f0750cff48581
Raw diff: https://github.com/php/doc-en/commit/1e31c8f3a81d8fbfc79c0a6b033f0750cff48581.diff

Use constants for int mask combinations of `debug_backtrace()` (#5537)

* Add two other variants

* Make order consistent

* Remove wording change

* Remove all numeric input other than 0

Changed paths:
  M  reference/errorfunc/functions/debug-backtrace.xml


Diff:

diff --git a/reference/errorfunc/functions/debug-backtrace.xml b/reference/errorfunc/functions/debug-backtrace.xml
index adff7a6e91b7..694939daccca 100644
--- a/reference/errorfunc/functions/debug-backtrace.xml
+++ b/reference/errorfunc/functions/debug-backtrace.xml
@@ -56,7 +56,7 @@
            <tbody>
             <row>
              <entry><code>debug_backtrace()</code></entry>
-             <entry morerows="2" valign="middle">
+             <entry morerows="1" valign="middle">
               Populates both indexes
              </entry>
             </row>
@@ -64,13 +64,13 @@
              <entry><code>debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT)</code></entry>
             </row>
             <row>
-             <entry><code>debug_backtrace(1)</code></entry>
+             <entry><code>debug_backtrace(~DEBUG_BACKTRACE_PROVIDE_OBJECT)</code></entry>
+             <entry morerows="1" valign="middle">
+              Omits index <literal>"object"</literal> and populates index <literal>"args"</literal>.
+             </entry>
             </row>
             <row>
              <entry><code>debug_backtrace(0)</code></entry>
-             <entry valign="middle">
-              Omits index <literal>"object"</literal> and populates index <literal>"args"</literal>.
-             </entry>
             </row>
             <row>
              <entry><code>debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)</code></entry>
@@ -79,17 +79,14 @@
              </entry>
             </row>
             <row>
-             <entry><code>debug_backtrace(2)</code></entry>
+             <entry><code>debug_backtrace(~DEBUG_BACKTRACE_PROVIDE_OBJECT | DEBUG_BACKTRACE_IGNORE_ARGS)</code></entry>
             </row>
             <row>
              <entry><code>debug_backtrace(DEBUG_BACKTRACE_PROVIDE_OBJECT|DEBUG_BACKTRACE_IGNORE_ARGS)</code></entry>
-             <entry morerows="1" valign="middle">
+             <entry valign="middle">
               Populate index <literal>"object"</literal> <emphasis>and</emphasis> omit index <literal>"args"</literal>.
              </entry>
             </row>
-            <row>
-             <entry><code>debug_backtrace(3)</code></entry>
-            </row>
            </tbody>
           </tgroup>
          </table>