X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=scm%2Fguile-debugger.scm;h=cde032fed069bdc3400dd8ec66827c2b2b0ce733;hb=d84e60f00aba28a02e6313096649ca3adc9d42eb;hp=0b99e1a3f44a5d40786a812ad71df689398791e8;hpb=e817ee7b3df9586086d7ac2689f3b6a4cc92d2d2;p=lilypond.git

diff --git a/scm/guile-debugger.scm b/scm/guile-debugger.scm
old mode 100755
new mode 100644
index 0b99e1a3f4..cde032fed0
--- a/scm/guile-debugger.scm
+++ b/scm/guile-debugger.scm
@@ -1,6 +1,6 @@
 ;;;; This file is part of LilyPond, the GNU music typesetter.
 ;;;;
-;;;; Copyright (C) 2010 Ian Hulin <ian@hulin.org.uk>
+;;;; Copyright (C) 2010--2015 Ian Hulin <ian@hulin.org.uk>
 ;;;;
 ;;;; LilyPond is free software: you can redistribute it and/or modify
 ;;;; it under the terms of the GNU General Public License as published by
@@ -15,6 +15,14 @@
 ;;;; You should have received a copy of the GNU General Public License
 ;;;; along with LilyPond.  If not, see <http://www.gnu.org/licenses/>.
 
+;;; Commentary:
+
+;;; This file provides the support routines for a guile debugger called
+;;; from an 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)
@@ -23,45 +31,45 @@
   #:use-module (ice-9 debugging ice-9-debugger-extensions)
   #:use-module (ice-9 readline)
   #:export (set-break!
-	    clear-break!
-	    set-trace-call!
-	    clear-trace-call!
-	    set-trace-subtree!
-	    clear-trace-subtree!
-	    debug-help))
+            clear-break!
+            set-trace-call!
+            clear-trace-call!
+            set-trace-subtree!
+            clear-trace-subtree!
+            debug-help))
 
 (define (set-break! proc)
   (install-trap (make <procedure-trap>
-		  #:procedure proc
-		  #:behaviour debug-trap)))
+                  #:procedure proc
+                  #:behaviour debug-trap)))
 (define (clear-break! proc)
   (uninstall-trap (make <procedure-trap>
-		    #:procedure proc
-		    #:behaviour debug-trap)))
+                    #:procedure proc
+                    #:behaviour debug-trap)))
 
 
 (define (set-trace-call! proc)
   (install-trap (make <procedure-trap>
-		  #: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-trap>
-		    #:procedure proc
-		    #:behaviour (list trace-trap
-				      trace-at-exit))))
+                    #:procedure proc
+                    #:behaviour (list trace-trap
+                                      trace-at-exit))))
 
 (define (set-trace-subtree! proc)
   (install-trap (make <procedure-trap>
-		  #: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-trap>
-		    #:procedure proc
-		    #:behaviour (list trace-trap
-				      trace-until-exit))))
+                    #: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")
@@ -77,5 +85,6 @@
   (display " (set-trace-subtree! <procedure>)\n")
   (display "   displays each line of Scheme code executed during a call to <procedure>\n")
   (display " (clear-trace-subtree! <procedure>)\n")
-  (display "   turns off tracing code during calls to <procedure>\n")
+  (display "   turns off tracing code during calls to <procedure>\n\n")
+  (display "Enter help at the guile debug> prompt for further information on debugger commands\n")
   (newline))