diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/.cvsignore | 1 | ||||
| -rw-r--r-- | doc/html/download.html | 18 | ||||
| -rw-r--r-- | doc/html/index.html | 71 | ||||
| -rw-r--r-- | doc/html/news.html | 57 |
4 files changed, 100 insertions, 47 deletions
diff --git a/doc/.cvsignore b/doc/.cvsignore index 81c4b05..cad9468 100644 --- a/doc/.cvsignore +++ b/doc/.cvsignore @@ -1,6 +1,7 @@ Makefile Makefile.in mdk-0.1 +mdk-doc-html-0.2.tar.gz mdk-doc.tar.gz mdk.html mdk.info diff --git a/doc/html/download.html b/doc/html/download.html index 39f1e4c..4d93f91 100644 --- a/doc/html/download.html +++ b/doc/html/download.html @@ -1,11 +1,11 @@ -<!-- -*-html-*- --> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>MDK download</title> </head> - <body bgcolor="white" link="#ff0000" vlink="#a00000"> + <body bgcolor="white" link="#ff0000" vlink="#a00000"> <a name="top"></a> <table cellspacing="0" cellpadding="5" border="0" align="center"> <tr> @@ -40,13 +40,12 @@ <p align="right"><font color="#000069" size="+1"> Download </font></p> - <p>The latest version (0.1.1) source tarball is available for + <p>The latest version (0.2) source tarball, as well as the + HTML documentation is available for download <a href="http://sourceforge.net/project/showfiles.php?group_id=13897"> 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> @@ -80,7 +79,12 @@ ./configure make </pre> - Finally, to install the binaries and documentation, type, as root + After the compilation finishes, you can find the MDK + executables, <b>mixasm</b> (the assembler) and <b>mixvm</b> + (the MIX virtual machine) in the subdirectory + <b>mixutils</b>. They can be run directly from that + directory, but, if you prefer to install the binaries and + documentation in standard locations, type, as root <pre> make install </pre> @@ -99,7 +103,7 @@ <tr> <td bgcolor="#909090"> </td> <td colspan="2" bgcolor="#909090" align="right"> - + <i>last modified Sat Jan 6 00:24:39 CET 2001</i> </td> </tr> </table> diff --git a/doc/html/index.html b/doc/html/index.html index 2fb7d26..e793296 100644 --- a/doc/html/index.html +++ b/doc/html/index.html @@ -41,6 +41,10 @@ Latest news </font></p> <ul> + <li>(08/01/01) + <i>MDK 0.2 release. </i> + New version of MDK. + <a href="news.html#new3">Read more...</a> <li>(26/11/00) <i>Documentation update.</i> <a href="news.html#new2">Read more...</a> <li>(18/11/00) @@ -49,30 +53,38 @@ <a href="news.html#new1">Read more...</a> </ul> <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 + 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 + 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? The MIX computer is a simplified - version of real CISC computers, and its assembly language - closely resembles real ones. You can learn MIX/MIXAL as an introduction - to computer architecture and assembly programming: - see the <a href="mdk.html">MDK documentation</a> - for a <a href="mdk_2.html">tutorial</a> on MIX and MIXAL. </p> + + <p> So, what's the use of learning MIXAL? The MIX computer + is a simplified version of real CISC computers, and its + assembly language closely resembles real ones. You can + learn MIX/MIXAL as an introduction to computer + architecture and assembly programming: see the <a + href="mdk.html">MDK documentation</a> for a <a + href="mdk_2.html">tutorial</a> on MIX and MIXAL. + </p> + <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: + </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 @@ -86,26 +98,31 @@ <ul> <li>write, compile and execute MIXAL programs, <li>set breakpoints and run your programs step by step, + <li>collect execution timing statistics, + <li>trace executed instructions, <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>. + + 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"><font color="#000069" size="+1"> Planned features - </font></p> + </font> + </p> + MDK is currently under active development, and there are some planned additional features I have in mind, e.g. <ul> - <li> tracing of executed instructions in <b><i>mixvm</i></b>, <li> allow MIXAL instructions as commands at the <b><i>mixvm</i></b> prompt, - <li> include execution timing statistics, <li> ncurses based frontend, <li> GTK++/GNOME support, </ul> @@ -124,7 +141,7 @@ <tr> <td bgcolor="#909090"> </td> <td colspan="2" bgcolor="#909090" align="right"> - <i>last updated Mon Nov 27 00:30:40 </i> + <i>last updated Sat Jan 6 15:35:39 CET 2001</i> </td> </tr> </table> diff --git a/doc/html/news.html b/doc/html/news.html index 87ce0cc..76bd701 100644 --- a/doc/html/news.html +++ b/doc/html/news.html @@ -39,27 +39,58 @@ <td > <table> <tr valign="top"> + <td><a label="new1">08/01/01</a></td> + <td><i>MDK 0.1.1 release</i></td> + <td> + New version of MDK. This version provides the + following new functionalities: + <ul> + <li> <i>mixvm</i> provides virtual execution + time statistics after each invocation of run or + next. + <li> <i>mixvm</i> can trace instructions as + they are executed. <i>tron/troff</i> + commands turn off/off instruction tracing. + <li> <i>mixvm</i> accepts a new command, + w2d, which computes the decimal value of a MIX + word given as a series of bytes (e.g. + <i>- 01 00 34 32 22</i>). + <li> Symbols can be defined at the + <i>mixvm</i> prompt with the new command + <i>ssym</i>. + <li> <i>mixvm</i> accepts a new command, + <i>weval</i>, which allows the evaluation + of MIXAL w-expressions. + </ul> + In addition, some bugs have been fixed. The most + outstanding one is that expressions containing + strings of successive '*' are now correctly + evaluated. + </td> + </tr> + <tr valign="top"> <td><a label="new2">26/11/00</a></td> <td><i>Documentation update</i></td> <td> - The <a href="mdk.html">MDK documentation</a> has been updated so - that the description of MIX and MIXAL is self-contained and does - not depend on TAOCP. Now, you can learn MIX/MIXAL reading the - <a href="mdk_2.html">included tutorial</a>. You can also - download the <a href="mdk-doc.tar.gz">HTML tarball</a>. + The <a href="mdk.html">MDK documentation</a> has + been updated so that the description of MIX and + MIXAL is self-contained and does not depend on + TAOCP. Now, you can learn MIX/MIXAL reading the <a + href="mdk_2.html">included tutorial</a>. You can + also download the <a href="mdk-doc.tar.gz">HTML + tarball</a>. </td> </tr> <tr valign="top"> <td><a label="new1">18/11/00</a></td> <td><i>MDK 0.1.1 release</i></td> <td> - New version of MDK. This is a bug-fix release which - makes MDK fully compliant with Knuth's specification. - In particular, local symbols are now properly handled - in special cases such as - <pre> 3H ORIG 3B </pre> - instructions. See the <a href="ChangeLog">the change log</a> - for details. + New version of MDK. This is a bug-fix release + which makes MDK fully compliant with Knuth's + specification. In particular, local symbols are + now properly handled in special cases such as + <pre> 3H ORIG 3B </pre> instructions. See the <a + href="ChangeLog">the change log</a> for details. </td> </tr> </table> @@ -73,7 +104,7 @@ <tr> <td bgcolor="#909090"> </td> <td colspan="2" bgcolor="#909090" align="right"> - <i>last updated Mon Nov 27 01:05:52</i> + <i>last updated Sat Jan 6 15:34:16 CET 2001</i> </td> </tr> </table> |