X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fguile-debugger.scm;h=60e65e4901d814374986d120c65e666d3d93ec5a;hb=63e6d5d63350d5c8287c431c90de2c28623684f1;hp=809f01ef0ec2057166a9e13a6d771fc3856b15e8;hpb=5977230d8f927be896d5b4193a5ecf6333fb501e;p=lilypond.git
diff --git a/scm/guile-debugger.scm b/scm/guile-debugger.scm
old mode 100755
new mode 100644
index 809f01ef0e..60e65e4901
--- a/scm/guile-debugger.scm
+++ b/scm/guile-debugger.scm
@@ -15,6 +15,14 @@
;;;; You should have received a copy of the GNU General Public License
;;;; along with LilyPond. If not, see .
+;;; Commentary:
+
+;;; This file provides the support routines for a guile debugger called
+;;; from a environment controlled by LilyPond. It works in conjunction
+;;; with file guile-debugger.ly.
+
+;;; Code:
+
(define-module (scm guile-debugger)
#:use-module (ice-9 debugger)
#:use-module (ice-9 debugging traps)
@@ -22,21 +30,61 @@
#:use-module (ice-9 debugging steps)
#:use-module (ice-9 debugging ice-9-debugger-extensions)
#:use-module (ice-9 readline)
- #:export (set-break! set-trace! set-trace-subtree!))
+ #:export (set-break!
+ clear-break!
+ set-trace-call!
+ clear-trace-call!
+ set-trace-subtree!
+ clear-trace-subtree!
+ debug-help))
(define (set-break! proc)
(install-trap (make
- #:procedure proc
- #:behaviour debug-trap)))
+ #:procedure proc
+ #:behaviour debug-trap)))
+(define (clear-break! proc)
+ (uninstall-trap (make
+ #:procedure proc
+ #:behaviour debug-trap)))
-(define (set-trace! proc)
+
+(define (set-trace-call! proc)
(install-trap (make
- #:procedure proc
- #:behaviour (list trace-trap
- trace-at-exit))))
+ #:procedure proc
+ #:behaviour (list trace-trap
+ trace-at-exit))))
+(define (clear-trace-call! proc)
+ (uninstall-trap (make
+ #:procedure proc
+ #:behaviour (list trace-trap
+ trace-at-exit))))
(define (set-trace-subtree! proc)
(install-trap (make
- #:procedure proc
- #:behaviour (list trace-trap
- trace-until-exit))))
+ #:procedure proc
+ #:behaviour (list trace-trap
+ trace-until-exit))))
+
+(define (clear-trace-subtree! proc)
+ (uninstall-trap (make
+ #:procedure proc
+ #:behaviour (list trace-trap
+ trace-until-exit))))
+
+(define (debug-help )
+ (display "\nYou may add the following commands as debugging statements in your source file\n")
+ (display "or enter the set-x! commands at the guile prompt:\n\n")
+ (display " (set-break! )\n")
+ (display " causes guile to enter debugger on a call to \n")
+ (display " (clear-break! )\n")
+ (display " disables a breakpoint previously set on a call to \n")
+ (display " (set-trace-call! )\n")
+ (display " prints out a line when Scheme enters or exits \n")
+ (display " (clear-trace-call! )\n")
+ (display " turns off tracing calls to \n")
+ (display " (set-trace-subtree! )\n")
+ (display " displays each line of Scheme code executed during a call to \n")
+ (display " (clear-trace-subtree! )\n")
+ (display " turns off tracing code during calls to \n\n")
+ (display "Enter help at the guile debug> prompt for further information on debugger commands\n")
+ (newline))