From 55f72a2a83cb49be2719e2954efc168ef32b0fdc Mon Sep 17 00:00:00 2001
From: AJR <ajrhacker@users.noreply.github.com>
Date: Sat, 28 May 2022 18:01:13 -0400
Subject: [PATCH] docs/source/debugger/execution.rst: Document gbf, gbt and gni
 commands

---
 docs/source/debugger/execution.rst | 92 ++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)

diff --git a/docs/source/debugger/execution.rst b/docs/source/debugger/execution.rst
index 8a99f52f85a..cc4fc280cc1 100644
--- a/docs/source/debugger/execution.rst
+++ b/docs/source/debugger/execution.rst
@@ -12,10 +12,16 @@ Execution Debugger Commands
     (Shift-F11)
 :ref:`debugger-command-go`
     resume execution (F5)
+:ref:`debugger-command-gbt`
+    resume execution until next true branch is executed
+:ref:`debugger-command-gbf`
+    resume execution until next false branch is executed
 :ref:`debugger-command-gex`
     resume execution until exception is raised
 :ref:`debugger-command-gint`
     resume execution until interrupt is taken (F7)
+:ref:`debugger-command-gni`
+    resume execution until next further instruction
 :ref:`debugger-command-gtime`
     resume execution until the given delay has elapsed
 :ref:`debugger-command-gvblank`
@@ -137,6 +143,64 @@ Examples:
 Back to :ref:`debugger-execution-list`
 
 
+.. _debugger-command-gbf:
+
+gbf
+---
+
+**gbf [<condition>]**
+
+Resumes execution.  Control will not be returned to the debugger until
+a breakpoint or watchpoint is triggered, or until a conditional branch
+or skip instruction is not taken, following any delay slots.
+
+The optional **<condition>** parameter lets you specify an expression
+that will be evaluated each time a conditional branch is encountered.
+If the result of the expression is true (non-zero), execution will be
+halted after the branch if it is not taken; otherwise, execution will
+continue with no notification.
+
+Examples:
+
+``gbf``
+    Resume execution until a breakpoint/watchpoint is triggered, or
+    until the next false branch.
+``gbf {pc != 1234}``
+    Resume execution until the next false branch, disregarding the
+    instruction at address 1234.
+
+Back to :ref:`debugger-execution-list`
+
+
+.. _debugger-command-gbt:
+
+gbt
+---
+
+**gbt [<condition>]**
+
+Resumes execution.  Control will not be returned to the debugger until
+a breakpoint or watchpoint is triggered, or until a conditional branch
+or skip instruction is taken, following any delay slots.
+
+The optional **<condition>** parameter lets you specify an expression
+that will be evaluated each time a conditional branch is encountered.
+If the result of the expression is true (non-zero), execution will be
+haltedafter the branch if it is taken; otherwise, execution will
+continue with no notification.
+
+Examples:
+
+``gbt``
+    Resume execution until a breakpoint/watchpoint is triggered, or
+    until the next true branch.
+``gbt {pc != 1234}``
+    Resume execution until the next true branch, disregarding the
+    instruction at address 1234.
+
+Back to :ref:`debugger-execution-list`
+
+
 .. _debugger-command-gex:
 
 gex
@@ -196,6 +260,34 @@ Examples:
 Back to :ref:`debugger-execution-list`
 
 
+.. _debugger-command-gni:
+
+gni
+---
+
+**gni [<count>]**
+
+Resumes execution.  Control will not be returned to the debugger until a
+breakpoint or watchpoint is triggered.  A temporary unconditional breakpoint
+is set at the prorgam address **<count>** instructions sequentially past the
+current one.  When this breakpoint is hit, it is automatically removed.
+
+The **<count>** parameter is optional and defaults to 1 if omitted.  If
+**<count>** is specified as zero, the command does nothing.  **<count>** is
+not permitted to exceed 512 decimal.
+
+Examples:
+
+``gni``
+    Resume execution until a breakpoint/watchpoint is triggered, including
+    the temporary breakpoint set at the address of the following instruction.
+``gni 2``
+    Resume execution until a breakpoint/watchpoint is triggered.  A temporary
+    breakpoint is set two instructions past the current one.
+
+Back to :ref:`debugger-execution-list`
+
+
 .. _debugger-command-gtime:
 
 gtime