diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/mdk.texi | 16 | ||||
-rw-r--r-- | doc/mdk_gstart.texi | 5 | ||||
-rw-r--r-- | doc/mdk_install.texi | 8 | ||||
-rw-r--r-- | doc/mdk_mixasm.texi | 6 | ||||
-rw-r--r-- | doc/mdk_mixvm.texi | 15 | ||||
-rw-r--r-- | doc/mdk_tut.texi | 10 |
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 |