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 | 
