guile/guile-core/doc ChangeLog scheme-evaluatio...

[Mikael Djurfeldt]

CVSROOT:        /cvs
Module name:    guile
Changes by:     Mikael Djurfeldt <address@hidden>       01/08/22 02:57:36

Modified files:
        guile-core/doc : ChangeLog scheme-evaluation.texi 
                         scheme-options.texi 

Log message:
        * scheme-options.texi (Evaluator trap options): Splitted
        section "Evaluator options".
        
        * scheme-evaluation.texi (Evaluator Behaviour): Typo "reader
        options" --> "evaluator options".

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/ChangeLog.diff?cvsroot=OldCVS&tr1=1.114&tr2=1.115&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/scheme-evaluation.texi.diff?cvsroot=OldCVS&tr1=1.12&tr2=1.13&r1=text&r2=text
http://savannah.gnu.org/cgi-bin/viewcvs/guile/guile-core/doc/scheme-options.texi.diff?cvsroot=OldCVS&tr1=1.5&tr2=1.6&r1=text&r2=text

Patches:
Index: guile/guile-core/doc/ChangeLog
diff -u guile/guile-core/doc/ChangeLog:1.114 
guile/guile-core/doc/ChangeLog:1.115
--- guile/guile-core/doc/ChangeLog:1.114        Fri Aug 17 20:06:18 2001
+++ guile/guile-core/doc/ChangeLog      Wed Aug 22 02:57:35 2001
@@ -1,3 +1,11 @@
+2001-08-22  Mikael Djurfeldt  <address@hidden>
+
+       * scheme-options.texi (Evaluator trap options): Splitted
+       section "Evaluator options".
+
+       * scheme-evaluation.texi (Evaluator Behaviour): Typo "reader
+       options" --> "evaluator options".
+
 2001-08-17  Rob Browning  <address@hidden>
 
        * Makefile.am (guile_tut_TEXINFOS): remove guile-tut.texi.  It's
Index: guile/guile-core/doc/scheme-evaluation.texi
diff -u guile/guile-core/doc/scheme-evaluation.texi:1.12 
guile/guile-core/doc/scheme-evaluation.texi:1.13
--- guile/guile-core/doc/scheme-evaluation.texi:1.12    Wed Jul 11 11:13:53 2001
+++ guile/guile-core/doc/scheme-evaluation.texi Wed Aug 22 02:57:35 2001
@@ -352,7 +352,7 @@
 
 The behaviour of Guile's evaluator can be modified by manipulating the
 evaluator options.  For more information about options, @xref{General
-option interface}.  If you want to know which reader options are
+option interface}.  If you want to know which evaluator options are
 available, @xref{Evaluator options}.
 
 @c FIXME::martin: This is taken from libguile/options.c.  Is there 
Index: guile/guile-core/doc/scheme-options.texi
diff -u guile/guile-core/doc/scheme-options.texi:1.5 
guile/guile-core/doc/scheme-options.texi:1.6
--- guile/guile-core/doc/scheme-options.texi:1.5        Wed May 16 21:53:58 2001
+++ guile/guile-core/doc/scheme-options.texi    Wed Aug 22 02:57:35 2001
@@ -20,6 +20,7 @@
 * Printing options::
 * Debugger options::
 * Evaluator options::
+* Evaluator trap options::
 * Examples of option use::
 * Install Config::              Installation and configuration data.
 @end menu
@@ -153,7 +154,6 @@
 
 @node Evaluator options
 @section Evaluator options
-
 These are the evaluator options with their default values, as they are
 printed by typing @code{(eval-options 'full)} in Guile.
 
@@ -161,6 +161,12 @@
 stack           22000   Size of thread stacks (in machine words).
 @end smallexample
 
address@hidden Evaluator trap options
address@hidden Evaluator trap options
+[FIXME: These flags, together with their corresponding handlers, are not
+user level options.  Probably this entire section should be moved to the
+documentation about the low-level programmer debugging interface.]
+
 Here is the list of evaluator trap options generated by typing
 @code{(traps 'full)} in Guile.  You can also see the default values.
 
@@ -168,8 +174,58 @@
 exit-frame      no      Trap when exiting eval or apply.
 apply-frame     no      Trap when entering apply.
 enter-frame     no      Trap when eval enters new frame.
+traps          yes     Enable evaluator traps.
 @end smallexample
 
address@hidden apply-frame-handler key cont tailp
+Called when a procedure is being applied.
+
+Called if:
+
address@hidden @bullet
address@hidden
+evaluator traps are enabled [traps interface], and
address@hidden
+either
address@hidden @minus
address@hidden
address@hidden is enabled [traps interface], or
address@hidden
+trace mode is on [debug-options interface], and the procedure being
+called has the trace property enabled.
address@hidden itemize
address@hidden itemize
+
+If cheap traps are enabled [debug-options interface], @var{cont} is a
+debug object, otherwise it is a restartable continuation.
+
address@hidden is true if this is a tail call
address@hidden deffn
+
address@hidden exit-frame-handler key cont retval
+Called when a value is returned from a procedure.
+
+Called if:
+
address@hidden @bullet
address@hidden
+evaluator traps are enabled [traps interface], and
address@hidden
+either
address@hidden @minus
address@hidden
+ @code{exit-frame} is enabled [traps interface], or
address@hidden
+trace mode is on [debug-options interface], and the procedure being
+called has the trace property enabled.
address@hidden itemize
address@hidden itemize
+
+If cheap traps are enabled [debug-options interface], @var{cont} is a
+debug object, otherwise it is a restartable continuation.
+
address@hidden is the return value.
address@hidden deffn
 
 @node Debugger options
 @section Debugger options