dmbcs/guile
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

update traps documentation (unfinished)

Browse source 
* doc/ref/Makefile.am:
* doc/ref/guile.texi:
* doc/ref/scheme-debugging.texi: Remove scheme-debugging.texi, which
  only described tracing. Tracing documentation is now in
  api-debugging.

* doc/ref/scheme-using.texi (Evaluating Scheme Code): Remove reference
  to source traps, as that section is going away.

* doc/ref/api-modules.texi (Included Guile Modules): Remove reference to
  Tracing. This section is a little silly, anyway...

* doc/ref/api-evaluation.texi (VM Behaviour): Remove section, it is in
  api-debugging now.

* doc/ref/api-debug.texi (Stacks, Frames): Rename sections from
  "Examining the Stack" and "Examining Stack Frames", respectively.
  (Traps): Update for current API. A big and not-quite-finished update.
This commit is contained in:
Andy Wingo 2010-10-07 13:06:57 +02:00
commit 6e069bbfce
7 changed files with 416 additions and 1148 deletions
Download patch file Download diff file Expand all files Collapse all files

33
doc/ref/api-evaluation.texi
View file

@ -19,7 +19,6 @@ loading, evaluating, and compiling Scheme code at run time.
* Loading:: Loading Scheme code from file.
* Character Encoding of Source Files:: Loading non-ASCII Scheme code from file.
* Delayed Evaluation:: Postponing evaluation until it is needed.
* VM Behaviour:: Modifying Guile's virtual machine.
@end menu
@ -868,38 +867,6 @@ value.
@end deffn
@node VM Behaviour
@subsection VM Behaviour
Like the procedures from the previous section that operate on the
evaluator, there are also procedures to modify the behavior of a
virtual machine.
The most useful thing that a user can do is to add to one of the
virtual machine's predefined hooks:
@deffn {Scheme Procedure} vm-next-hook vm
@deffnx {Scheme Procedure} vm-apply-hook vm
@deffnx {Scheme Procedure} vm-push-continuation-hook vm
@deffnx {Scheme Procedure} vm-pop-continuation-hook vm
@deffnx {Scheme Procedure} vm-abort-continuation-hook vm
@deffnx {Scheme Procedure} vm-restore-continuation-hook vm
Accessors to a virtual machine's hooks. Usually you pass @code{(the-vm)}
as the @var{vm}.
@end deffn
@deffn {Scheme Procedure} vm-trace-level vm
Retrieve the ``trace level'' of the VM. If positive, the trace hooks associated
with @var{vm} will be run. The initial trace level is 0.
@end deffn
@deffn {Scheme Procedure} set-vm-trace-level! vm level
Set the ``trace level'' of the VM.
@end deffn
@xref{A Virtual Machine for Guile}, for more information on Guile's
virtual machine.
@c Local Variables:
@c TeX-master: "guile.texi"
@c End: