From 750b5028a18de8a958db63849b5bae84180dad84 Mon Sep 17 00:00:00 2001 From: jaortega Date: Wed, 1 Nov 2000 22:53:21 +0000 Subject: --- doc/html/.cvsignore | 16 ++++++++ doc/html/Makefile.am | 14 +++++++ doc/html/download.html | 105 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/html/index.html | 104 ++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 239 insertions(+) create mode 100644 doc/html/.cvsignore create mode 100644 doc/html/Makefile.am create mode 100644 doc/html/download.html create mode 100644 doc/html/index.html (limited to 'doc/html') diff --git a/doc/html/.cvsignore b/doc/html/.cvsignore new file mode 100644 index 0000000..b44cc40 --- /dev/null +++ b/doc/html/.cvsignore @@ -0,0 +1,16 @@ +Makefile +Makefile.in +doc.html +mdk.html +mdk_1.html +mdk_2.html +mdk_3.html +mdk_4.html +mdk_5.html +mdk_6.html +mdk_7.html +mdk_8.html +mdk_abt.html +mdk_fot.html +mdk_ovr.html +mdk_toc.html diff --git a/doc/html/Makefile.am b/doc/html/Makefile.am new file mode 100644 index 0000000..ecd8550 --- /dev/null +++ b/doc/html/Makefile.am @@ -0,0 +1,14 @@ +## Process this file with automake to produce Makefile.in + +# Copyright (C) 2000 Jose Antonio Ortega Ruiz +# +# This file is free software; as a special exception the author gives +# unlimited permission to copy and/or distribute it, with or without +# modifications, as long as this notice is preserved. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY, to the extent permitted by law; without even the +# implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +EXTRA_DIST = index.html download.html + diff --git a/doc/html/download.html b/doc/html/download.html new file mode 100644 index 0000000..0749404 --- /dev/null +++ b/doc/html/download.html @@ -0,0 +1,105 @@ + + + + + MDK download + + + + + + + + + + + + + + + + + + + + + + + + + + + +
  + MDK download +  
  
+
+ MDK home
+ Documentation
+ + MDK at SourceForge
+ + CVS repository

+

Thanks to
+ + SourceForge Logo +

+

+ Download +

+

The latest version (0.1) source tarball is available for + download here.

+

A tarball containing the HTML documentation is available + here.

+

+ Requirements +

+ MDK is written in ANSI C and uses the following libraries: +
    +
  • GNU readline and history +
  • + GNU Flex, version 2.3 or latter +
  • glib, version 1.2.0 or latter +
+ These libraries are fairly common in any GNU/Linux distribution + (MDK is developed on a Debian 2.3 + box). Although I haven't tested it, MDK should be also installable + on BSD operating systems such as FreeBSD if the above libraries + are installed. Please, + drop me a line if you install + MDK, and I'll add your platform to the list of supported ones. +

+ Installation +

+ MDK uses autoconf/automake, so that compilation and installation + should follow the typical uncompress, configure, make, install cycle. + First, uncompress the source tarball using: +
+    tar xvfz mdk-latest.tar.gz
+          
+ This will create a folder named mdk-X.Y (where X.Y stands for + the version you downloaded, e.g., 0.1). To build the MDK tools, + enter this folder and type +
+    ./configure
+    make
+          
+ Finally, to install the binaries and documentation, type, as root +
+    make install
+          
+ See the file named INSTALL in the source folder for fine tuning + of build and installation options. +

+ Contact the author. +

+
 
  
  +   +
+ + + + + diff --git a/doc/html/index.html b/doc/html/index.html new file mode 100644 index 0000000..f4d4549 --- /dev/null +++ b/doc/html/index.html @@ -0,0 +1,104 @@ + + + + + MIX Development Kit + + + + + + + + + + + + + + + + + + + + + + + + + + + +
  + MDK, the MIX development kit +  
  
+
+ Download
+ Documentation
+ + MDK at SourceForge
+ + CVS repository

+

Thanks to
+ + SourceForge Logo +

+

+ What is the MIX? +

+ MIX is Donald Knuth's mythical computer as described + in his monumental work The + Art Of Computer Programming. As any of its real + counterparts, the MIX features registers, memory cells, an + overflow toggle, comparison flags, input-output devices, and + a set of binary instructions executable by its virtual + CPU. You can programme the MIX using an assembly language + called MIXAL, the MIX Assembly Language.

So, + what's the use of learning MIXAL? Well, if you're interested + in programming, please buy, borrow or steal a copy of TAOCP, + and you'll see the use. +  
 
+

+ What is the MDK? +

+ The MIX Development Kit offers an emulation of + MIX and MIXAL. The + current version of MDK includes two applications: +
    +
  • mixasm A MIXAL compiler, which + translates your source files into binary ones, executable + by the MIX virtual machine. +
  • mixvm A MIX virtual machine which is + able to run and debug compiled MIXAL programs, using a + command line interface with readline's line editting + capabilities. +
+ Using the MDK tools, you'll be able to +
    +
  • write, compile and execute MIXAL programs, +
  • set breakpoints and run your programs step by step, +
  • inspect and modify the MIX registers, flags and memory + contents at any step, +
  • simulate MIX input-output devices using the standard + output and your file system. +
+ See the MDK user's manual for a complete + description of the toolkit. + The MDK utils will run on any GNU/Linux box (see + requirements) and, of course, are + free software. +

+ Contact the author. +

+
 
  
  +   +
+ + + + + -- cgit v1.2.3