summaryrefslogtreecommitdiffhomepage
path: root/doc/mdk_mixvm.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mdk_mixvm.texi')
-rw-r--r--doc/mdk_mixvm.texi30
1 files changed, 25 insertions, 5 deletions
diff --git a/doc/mdk_mixvm.texi b/doc/mdk_mixvm.texi
index 61b7d1c..28976fa 100644
--- a/doc/mdk_mixvm.texi
+++ b/doc/mdk_mixvm.texi
@@ -4,9 +4,9 @@
@c Free Software Foundation, Inc.
@c See the file mdk.texi for copying conditions.
-@c $Id: mdk_mixvm.texi,v 1.8 2001/09/17 23:36:45 jao Exp $
+@c $Id: mdk_mixvm.texi,v 1.9 2001/09/18 22:53:18 jao Exp $
-@node mixvm, gmixvm, mixvm.el, Top
+@node mixvm, gmixvm, mixasm, Top
@comment node-name, next, previous, up
@chapter @code{mixvm}, the MIX computer simulator
@@ -136,6 +136,7 @@ all available commands.
* Debug commands:: Debugging programs.
* State commands:: Inspecting the virtual machine state.
* Configuration commands:: Storing mixvm settings.
+* Scheme commands::
@end menu
@node File commands, Debug commands, Commands, Commands
@@ -628,7 +629,7 @@ representation of the module of the stored value.
@end deffn
-@node Configuration commands, , State commands, Commands
+@node Configuration commands, Scheme commands, State commands, Commands
@subsection Configuration commands
This section describes commands that allow you to configure the virtual
@@ -704,10 +705,29 @@ specify an alternative location for storing these device files, while
@code{pddir} prints the current device directory.
@end deffn
-@node Scheme commands
+@node Scheme commands, , Configuration commands, Commands
@subsection Scheme commands
-:TODO: guile scripts
+If you have compiled @sc{mdk} with @code{libguile} support
+(@pxref{Special configure flags}), @code{mixvm} will start and
+initialise an embedded Guile Scheme interpret when it is invoked. That
+means that you have at your disposal, at @code{mixvm}'s command prompt,
+all the Scheme primitives described in @ref{Using mixguile} and
+@ref{mixguile}, as well as any other function or hook that you have
+defined in the initialisation file @file{~/.mdk/mixguile.scm}. To
+evaluate a Scheme function, simply type it at the @code{mixvm} command
+prompt (see @ref{Using Scheme in mixvm and gmixvm} for a
+sample). Compared to the @code{mixguile} program, this has only one
+limitation: the expressions used in @code{mixvm} cannot span more than
+one line. You can get over this inconvenience writing your multiline
+Scheme expressions in a file and loading it using the @code{scmf}
+command:
+
+@deffn {scheme command} scmf FILE_NAME
+Loads the given Scheme file and evaluates it using the embedded Guile
+interpreter.
+@end deffn
+
@node Devices, , Commands, mixvm
@section MIX block devices