summaryrefslogtreecommitdiffhomepage
path: root/doc/html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/html')
-rw-r--r--doc/html/.cvsignore16
-rw-r--r--doc/html/Makefile.am14
-rw-r--r--doc/html/download.html105
-rw-r--r--doc/html/index.html104
4 files changed, 239 insertions, 0 deletions
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 <jaortega@retemail.es>
+#
+# 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 @@
+<!-- -*-html-*- -->
+<html>
+
+ <head>
+ <title>MDK download</title>
+ </head>
+
+ <body bgcolor="white" link="#ff0000" vlink="#a00000">
+ <a name="top"></a>
+ <table cellspacing="0" cellpadding="5" border="0" align="center">
+ <tr>
+ <td width="100" bgcolor="#696969">&nbsp;</td>
+ <td bgcolor="#696969" width="600" align="center">
+ <font color="white"><b>MDK download</b></font>
+ </td>
+ <td bgcolor="#696969" width="10">&nbsp;</td>
+ </tr>
+ <tr>
+ <td colspan="2">&nbsp;</td>
+ <td bgcolor="#696969" >&nbsp;</td>
+ </tr>
+ <tr>
+ <td bgcolor="#909090" valign="top">
+ <br>
+ <a href="index.html">MDK home</a><br>
+ <a href="mdk.html">Documentation</a><br>
+ <a href="http://sourceforge.net/projects/mdk">
+ MDK at SourceForge</a><br>
+ <a href="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/?cvsroot=mdk">
+ CVS repository</a><br><br>
+ <p align="center">Thanks to<br>
+ <A href="http://sourceforge.net">
+ <IMG src="http://sourceforge.net/sflogo.php?group_id=13897&type=1"
+ width="88" height="31" border="0"
+ alt="SourceForge Logo"> </A>
+ </td>
+ <td >
+ <p align="right"><font color="#000069" size="+1">
+ Download
+ </font></p>
+ <p>The latest version (0.1) source tarball is available for
+ download <a href="http://sourceforge.net/projects/mdk">here.</a></p>
+ <p>A tarball containing the HTML documentation is available
+ <a href="mdk-doc.tar.gz">here.</a></p>
+ <p align="right"><font color="#000069" size="+1">
+ <a name="reqs">Requirements</a>
+ </font></p>
+ MDK is written in ANSI C and uses the following libraries:
+ <ul>
+ <li>GNU readline and history
+ <li><a href="http://www.gnu.org/software/flex/flex.html">
+ GNU Flex</a>, version 2.3 or latter
+ <li><a href="http://www.gtk.org">glib</a>, version 1.2.0 or latter
+ </ul>
+ These libraries are fairly common in any GNU/Linux distribution
+ (MDK is developed on a <a href="www.debian.org">Debian 2.3</a>
+ 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,
+ <a href="mailto:jaortega@acm.org">drop me</a> a line if you install
+ MDK, and I'll add your platform to the list of supported ones.
+ <p align="right"><font color="#000069" size="+1">
+ Installation
+ </font></p>
+ MDK uses autoconf/automake, so that compilation and installation
+ should follow the typical uncompress, configure, make, install cycle.
+ First, uncompress the source tarball using:
+ <pre>
+ tar xvfz mdk-latest.tar.gz
+ </pre>
+ 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
+ <pre>
+ ./configure
+ make
+ </pre>
+ Finally, to install the binaries and documentation, type, as root
+ <pre>
+ make install
+ </pre>
+ See the file named INSTALL in the source folder for fine tuning
+ of build and installation options.
+ <p align="right">
+ Contact the <a href="mailto:jaortega@acm.org">author.</a>
+ </p>
+ </td>
+ <td bgcolor="#696969" >&nbsp;</td>
+ </tr>
+ <tr>
+ <td bgcolor="#909090">&nbsp;</td>
+ <td colspan="2">&nbsp;</td>
+ </tr>
+ <tr>
+ <td bgcolor="#909090">&nbsp;</td>
+ <td colspan="2" bgcolor="#909090" align="right">
+ &nbsp;
+ </td>
+ </tr>
+ </table>
+
+ </body>
+</html>
+
+
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 @@
+<!-- -*-html-*- -->
+<html>
+
+ <head>
+ <title>MIX Development Kit</title>
+ </head>
+
+ <body bgcolor="white" link="#ff0000" vlink="#a00000">
+ <a name="top"></a>
+ <table cellspacing="0" cellpadding="5" border="0" align="center">
+ <tr>
+ <td width="100" bgcolor="#696969">&nbsp;</td>
+ <td bgcolor="#696969" width="600" align="center">
+ <font color="white"><b>MDK, the MIX development kit</b></font>
+ </td>
+ <td bgcolor="#696969" width="10">&nbsp;</td>
+ </tr>
+ <tr>
+ <td colspan="2">&nbsp;</td>
+ <td bgcolor="#696969" >&nbsp;</td>
+ </tr>
+ <tr>
+ <td bgcolor="#909090" valign="top">
+ <br>
+ <a href="download.html">Download</a><br>
+ <a href="mdk.html">Documentation</a><br>
+ <a href="http://sourceforge.net/projects/mdk">
+ MDK at SourceForge</a><br>
+ <a href="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/?cvsroot=mdk">
+ CVS repository</a><br><br>
+ <p align="center">Thanks to<br>
+ <A href="http://sourceforge.net">
+ <IMG src="http://sourceforge.net/sflogo.php?group_id=13897&type=1"
+ width="88" height="31" border="0"
+ alt="SourceForge Logo"> </A>
+ </td>
+ <td >
+ <p align="right"><font color="#000069" size="+1">
+ What is the MIX?
+ </font></p>
+ <b>MIX</b> is Donald Knuth's mythical computer as described
+ in his monumental work <a
+ href="http://Sunburn.Stanford.EDU/~knuth/taocp.html"> The
+ Art Of Computer Programming</a>. 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 <b>MIXAL</b>, the MIX Assembly Language. <p> 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.
+ &nbsp;<br>&nbsp;<br>
+ <p align="right"><font color="#000069" size="+1">
+ What is the MDK?
+ </font></p>
+ The <b>M</b>IX <b>D</b>evelopment <b>K</b>it offers an emulation of
+ <b>MIX</b> and <b>MIXAL</b>. The <a href="download.html">
+ current version</a> of MDK includes two applications:
+ <ul>
+ <li><b><i>mixasm</i></b> A MIXAL compiler, which
+ translates your source files into binary ones, executable
+ by the MIX virtual machine.
+ <li><b><i>mixvm</i></b> 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.
+ </ul>
+ Using the MDK tools, you'll be able to
+ <ul>
+ <li>write, compile and execute MIXAL programs,
+ <li>set breakpoints and run your programs step by step,
+ <li>inspect and modify the MIX registers, flags and memory
+ contents at any step,
+ <li>simulate MIX input-output devices using the standard
+ output and your file system.
+ </ul>
+ See the MDK <a href="mdk.html">user's manual</a> for a complete
+ description of the toolkit.
+ The MDK utils will run on any GNU/Linux box (see
+ <a href="download.html#reqs">requirements</a>) and, of course, are
+ <a href="http://www.gnu.org/copyleft/gpl.html">free software</a>.
+ <p align="right">
+ Contact the <a href="mailto:jaortega@acm.org">author.</a>
+ </p>
+ </td>
+ <td bgcolor="#696969" >&nbsp;</td>
+ </tr>
+ <tr>
+ <td bgcolor="#909090">&nbsp;</td>
+ <td colspan="2">&nbsp;</td>
+ </tr>
+ <tr>
+ <td bgcolor="#909090">&nbsp;</td>
+ <td colspan="2" bgcolor="#909090" align="right">
+ &nbsp;
+ </td>
+ </tr>
+ </table>
+
+ </body>
+</html>
+
+