summaryrefslogtreecommitdiffhomepage
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/mdk.texi16
-rw-r--r--doc/mdk_gstart.texi5
-rw-r--r--doc/mdk_install.texi8
-rw-r--r--doc/mdk_mixasm.texi6
-rw-r--r--doc/mdk_mixvm.texi15
-rw-r--r--doc/mdk_tut.texi10
6 files changed, 44 insertions, 16 deletions
diff --git a/doc/mdk.texi b/doc/mdk.texi
index 420e37c..0dd4262 100644
--- a/doc/mdk.texi
+++ b/doc/mdk.texi
@@ -117,6 +117,9 @@ helpful discussions, as well as actual code (@pxref{mixvm.el}).
* Instructions and commands:: Index of MIXAL instructions and MIXVM commands.
+
+
+
@detailmenu
--- The Detailed Node Listing ---
@@ -220,6 +223,17 @@ Interactive commands
* MIX devices view:: Device output.
* Menu and status bars:: Available menu commands.
+@code{mixguile}, the Scheme virtual machine
+
+* Invoking mixguile:: Command line options.
+* Scheme functions reference:: Scheme functions accessing the VM.
+
+Scheme functions reference
+
+* mixvm wrappers:: Functions invoking mixvm commands.
+* Additional VM functions:: Functions accessing the MIX virtual machine.
+* Hooks::
+
Copying
* GNU General Public License::
@@ -247,4 +261,4 @@ Copying
@contents
@bye
-$Id: mdk.texi,v 1.15 2001/09/18 22:53:18 jao Exp $
+$Id: mdk.texi,v 1.16 2001/09/26 23:15:55 jao Exp $
diff --git a/doc/mdk_gstart.texi b/doc/mdk_gstart.texi
index 1ec501f..97c180b 100644
--- a/doc/mdk_gstart.texi
+++ b/doc/mdk_gstart.texi
@@ -4,7 +4,7 @@
@c Free Software Foundation, Inc.
@c See the file mdk.texi for copying conditions.
-@c $Id: mdk_gstart.texi,v 1.10 2001/09/18 22:53:18 jao Exp $
+@c $Id: mdk_gstart.texi,v 1.11 2001/09/26 23:15:55 jao Exp $
@node Getting started, mixvm.el, MIX and MIXAL tutorial, Top
@chapter Getting started
@@ -988,7 +988,8 @@ $
Note that this is far more flexible that running programs
non-interactively using @code{mixvm} (@pxref{Non-interactive mode}), for
you can execute any combination of commands you want from a Scheme
-script (not just running and dumping the registers).
+script (not just running and dumping the registers). For additional
+@code{mixguile} command line options, see @ref{Invoking mixguile}.
@node Using Scheme in mixvm and gmixvm, , Using mixguile, Getting started
@section Using Scheme in @code{mixvm} and @code{gmixvm}
diff --git a/doc/mdk_install.texi b/doc/mdk_install.texi
index 2874d79..c240c57 100644
--- a/doc/mdk_install.texi
+++ b/doc/mdk_install.texi
@@ -26,8 +26,9 @@ the following @acronym{URL}s:
@itemize @bullet
@item
-@url{ftp://ftp.gnu.org/pub/gnu/mdk} (or one of
-@uref{http://www.gnu.org/prep/ftp.html, its mirrors})
+@url{ftp://ftp.gnu.org/pub/gnu/mdk}
+@item
+@uref{http://www.gnu.org/prep/ftp.html, GNU mirrors}
@item
@uref{http://sourceforge.net/project/showfiles.php?group_id=13897}
@end itemize
@@ -117,7 +118,8 @@ following:
Type 'make' to build the following utilities:
- mixasm (MIX assembler)
- - mixvm (MIX virtual machine, with readline support, with guile support)
+ - mixvm (MIX virtual machine, with readline support,
+ with guile support)
- gmixvm (mixvm GTK+ GUI, with guile support)
- mixguile (the mixvm guile shell)
@end example
diff --git a/doc/mdk_mixasm.texi b/doc/mdk_mixasm.texi
index e2f7b1b..71e6805 100644
--- a/doc/mdk_mixasm.texi
+++ b/doc/mdk_mixasm.texi
@@ -4,7 +4,7 @@
@c Free Software Foundation, Inc.
@c See the file mdk.texi for copying conditions.
-@c $Id: mdk_mixasm.texi,v 1.4 2001/09/18 22:53:18 jao Exp $
+@c $Id: mdk_mixasm.texi,v 1.5 2001/09/26 23:15:55 jao Exp $
@node mixasm, mixvm, mixvm.el, Top
@comment node-name, next, previous, up
@@ -45,8 +45,8 @@ line options (note, that, following GNU's conventions, we provide a long
option name for each available single letter switch):
@example
-mixasm [-vhulg] [-o OUTPUT_FILE] [--version] [--help]
- [--usage] [--debug] [--output=OUTPUT_FILE] [--list[=LIST_FILE]] file
+mixasm [-vhulg] [-o OUTPUT_FILE] [--version] [--help] [--usage]
+ [--debug] [--output=OUTPUT_FILE] [--list[=LIST_FILE]] file
@end example
@noindent
diff --git a/doc/mdk_mixvm.texi b/doc/mdk_mixvm.texi
index 28976fa..2eae874 100644
--- a/doc/mdk_mixvm.texi
+++ b/doc/mdk_mixvm.texi
@@ -4,7 +4,7 @@
@c Free Software Foundation, Inc.
@c See the file mdk.texi for copying conditions.
-@c $Id: mdk_mixvm.texi,v 1.9 2001/09/18 22:53:18 jao Exp $
+@c $Id: mdk_mixvm.texi,v 1.10 2001/09/26 23:15:55 jao Exp $
@node mixvm, gmixvm, mixasm, Top
@comment node-name, next, previous, up
@@ -37,8 +37,8 @@ setting to aid you in debugging your code. For a tutorial description of
for each available single letter switch):
@example
-mixvm [-vhurd] [--version] [--help] [--usage] [--run] [--dump]
- [FILE[.mix]]
+mixvm [-vhurdq] [--version] [--help] [--usage] [--run] [--dump]
+ [--noinit] [FILE[.mix]]
@end example
@noindent
@@ -92,7 +92,14 @@ configuration file, the command history file and (by default) the block
devices files (@pxref{Devices}). Before showing you the command prompt,
@code{mixvm} looks in the @file{~/.mdk} directory for a file named
@code{mixguile.scm}; if it exists, it is read and evaluated by the
-embedded Guile interpreter (@pxref{Defining new functions}).
+embedded Guile interpreter (@pxref{Defining new functions}). You can use
+the @code{-q} command line option to skip this file loading:
+
+@defopt -q
+@defoptx --noinit
+Do not load the Guile initialisation file @code{~/.mdk/mixguile.scm} at
+startup.
+@end defopt
@node Commands, Devices, Invocation, mixvm
@comment node-name, next, previous, up
diff --git a/doc/mdk_tut.texi b/doc/mdk_tut.texi
index 917919f..b7c171b 100644
--- a/doc/mdk_tut.texi
+++ b/doc/mdk_tut.texi
@@ -4,7 +4,7 @@
@c Free Software Foundation, Inc.
@c See the file mdk.texi for copying conditions.
-@c $Id: mdk_tut.texi,v 1.4 2001/09/13 00:13:39 jao Exp $
+@c $Id: mdk_tut.texi,v 1.5 2001/09/26 23:15:55 jao Exp $
@node MIX and MIXAL tutorial, Getting started, Installing MDK, Top
@comment node-name, next, previous, up
@@ -357,7 +357,11 @@ the MIX computer is the following:
@end example
@noindent
As, in this case, @w{@samp{M = 13 + [rI1] = 12}}, we have
-@w{@samp{V = [M](3:3) = (- 01 02 03 04 05)(3:3) = + 00 00 00 00 03}}
+
+@example
+V = [M](3:3) = (- 01 02 03 04 05)(3:3) = + 00 00 00 00 03
+@end example
+@noindent
(note that the specified subfield is left-padded with null bytes to
complete a word). Hence, the MIX state, after the instruction execution,
will be
@@ -972,7 +976,7 @@ instruction). Thus, a minimal MIXAL program would be
ORIG 2000 set the initial compilation adress
NOP this instruction will be loaded at adress 2000
HLT and this one at address 2001
- END 2000 end of program; execution will start at address 2000
+ END 2000 end of program; start at address 2000
this line is not parsed by the assembler
@end example
@noindent