diff options
Diffstat (limited to 'doc/html')
| -rw-r--r-- | doc/html/.cvsignore | 16 | ||||
| -rw-r--r-- | doc/html/Makefile.am | 14 | ||||
| -rw-r--r-- | doc/html/download.html | 105 | ||||
| -rw-r--r-- | doc/html/index.html | 104 |
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"> </td> + <td bgcolor="#696969" width="600" align="center"> + <font color="white"><b>MDK download</b></font> + </td> + <td bgcolor="#696969" width="10"> </td> + </tr> + <tr> + <td colspan="2"> </td> + <td bgcolor="#696969" > </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" > </td> + </tr> + <tr> + <td bgcolor="#909090"> </td> + <td colspan="2"> </td> + </tr> + <tr> + <td bgcolor="#909090"> </td> + <td colspan="2" bgcolor="#909090" align="right"> + + </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"> </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"> </td> + </tr> + <tr> + <td colspan="2"> </td> + <td bgcolor="#696969" > </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. + <br> <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" > </td> + </tr> + <tr> + <td bgcolor="#909090"> </td> + <td colspan="2"> </td> + </tr> + <tr> + <td bgcolor="#909090"> </td> + <td colspan="2" bgcolor="#909090" align="right"> + + </td> + </tr> + </table> + + </body> +</html> + + |