mic1 Release Notes
1999/3/18
Version 1.0a
Initial internal release for review.
Version 1.0b
The following corrections have been made to previously
released software and are available in this release.
-
Display current and next microinstruction in mic1sim.
-- Fixed.
-
Reset doesn't properly clear the text for the current microinstruction
in mic1sim.
-- Fixed.
-
Clicking the X in the upper right corner has no effect.
-- Fixed.
-
Add "magic number" check to mic1sim for both micro- and
macro-programs.
-- Fixed.
-
Add "magic number" to output file from mic1asm.
-- Fixed.
-
Allow case-insensitive interpretation of .jas files.
-- Fixed.
Added this to the assembler, ran some tests, worked fine in those tests.
-
Allow a main program to have local variables.
-- Fixed.
-
Invalid goto label message in ijvmasm should name the label.
-- Fixed.
-
Document language accepted by ijvmasm.
-- Done.
See IJVM Assembler
Language Specification
(jas.html).
-
Omit unix "man" files from unix distribution.
-- Done.
-
Provide a self-extracting archive for Win95/98/NT so that people don't
need a separate extraction program.
-- Done.
-
Document language accepted by mic1asm.
-- Done.
See Micro-Assembly Language (MAL) Specification
(mal.html).
-
Explain why PC starts at 0xFFFFFFFF in mic1sim.
-- Done. Added to FAQ.
-
Explain why nop1 is first microinstruction, not Main1.
-- Done. Added to FAQ
-
Eliminate the need for DOS-level involvement of casual Win95/98/NT users.
-- Done.
Created a gui front-ends for ijvmasm and mic1asm, gijvmasm, gmic1asm.
-
Improve install for Win95/98/NT to simplify autoexec/classpath issues.
-- Done.
The new install for Win95/98/NT only requires that the users
modify a single text file (using NOTEPAD, for example) to indicate
where the java executable is, and where the classes.zip file is
for mic1. We no longer touch any autoexec.bat file, or modify
CLASSPATH environment variables which may be used by other java
programs.
-
Change to monospaced font for mic1sim output area "Standard out".
-- Fixed.
-
Test install and functionality on SPARC, Linux/intel, Win98, WinNT.
Our development environement includes tests for
Linux/Intel, Win95, Win98, and WinNT using various
versions of the JDK. We rely on "beta" testors
to validate use on Solaris, HP/UX, and other platforms.
-
Explain why backspace shouldn't erase in echo.jas.
-- Done. Added to FAQ.
-
Explain that mic1sim, gijvmasm, gmic1asm, require a GUI environment,
while the other programs do not.
-- Done. Added to FAQ.
-
Explain why keyboard input read by the INP instruction doesn't
show up in "Standard Out".
-- Done. Added to FAQ.
-
Display all hex values in uppercase in mic1sim.
-- Fixed.
-
Change the IJVM directive ".varnum" to ".var", and make corresponding
changes in the documentation and sample programs.
-- Done.
-
Fix default output file type in gijvmasm.
-- Done. 1999/3/27
-
ijvmasm.class seems to be missing from classes.zip.
-- Done. 1999/3/27
To Do (proposed for 1.0c)
Note: A number of the following have been completed in some form
or another. We're still in the process of reviewing each
item before we check them off this list.
-
Document method calls in IJVM. --
This is done in detail in the FAQ, to a lesser extent in the lang spec.
-
Document constant declarations in IJVM. --
This is in the lang spec, I will add it to the FAQ also, under
the question "How do I use constants", which will discuss declaration
and usage.
-
Document new IJVM instructions IN, OUT, ERR, and HLT. --
I've documented IN and OUT in the FAQ. I am planning to add more discussion
about how I/O is handled by the simulator components. ERR and HALT will
soon be added.
-
Add tests for method calls, local variables and constants to ijvmtest.jas.
-
Document the various file types: *.mic1, *.ijvm, etc.
In the works.
-
Document mechanism which allows ijvmasm to declare local variables
in the main program.
This is documented in the lang spec, but needs an example.
-
Change ijvmasm to allow numeric arguments to ILOAD and ISTORE,
not just variable names declared between ".var" and ".end-var"
-
Document the use of ILOAD and ISTORE with local variable declarations.
-
Eliminate "spasticness" in the startup of the simulator.
-
Fix echo.jas to correct non-print-characters being echoed as space.
-
Document add.jas in the user guide to explain how it works.
-
Document echo.jas in the user guide to explain how it works.
-
Modify add.jas to give a message each time through the loop,
like "Please type two numbers, each terminated by ENTER."
Also, output a blank line before that message again.
-
Eliminate manual page files by combining this information into
primary documentation.
-
Explain how to set CLASSPATH on various platforms, and what to
do if you already have one.
-
Allow a BELL character to be sent to standard output
-
Create mailing list:
rayo@ontko.com (Ray Ontko),
dans@ontko.com (Dan Stone),
ast@cs.vu.nl (Andy Tanenbaum),
Ana_Terry@prenhall.com (Ana Terry),
Alan_Apt@prenhall.com (Alan Apt),
ladrian@cs.sunysb.edu (Adrian Llahana),
jmiller@silos.cs.csbsju.edu (John Miller),
To Do (post 1.0c)
-
Modify mic1sim to allow memory in the neighborhood of SP, PC, MAR, LV, CPP
(or elsewhere) to be displayed, or even modified.
This is mostly just a matter of deciding how to make this intuitive and
attractive, and then writing the code.
If you have suggestions about
what it should look like on the screen, or what buttons/menu items/etc
should be used, send a note to
Dan Stone (dans@ontko.com).
-
Rework the Windows install to use an appropriate Windows-style
install program.
Casual users may be better served by having a
familiar interface to find the java executable, set up the class
path, etc.
We will gladly accept help from anyone who is familiar
with Windows install tools and setting up Java applications under
Windows 95/98/NT.
-
Create a distribution for Macintosh.
Now that Apple has a stable
version of the JDK available, it should be reasonable to provide
a distribution. Now all we have to do is figure out how to do
binhex or whatever to do an install there.
We will gladly
accept help from anyone who knows the Mac environment well
and understands the issues of installing and running Java
software on a the Mac.
-
Support multiple documentation file formats: html, ps, ascii, etc.
Our plan here is to convert the existing files to SGML, and then
generate an appropriate collection of printable, browsable, viewable
documents from a single source.
We will gladly accept help
from anyone who knows SGML to get us started down this path.
-
Set up bug tracking system: gnats vs. debian bug reporting system.
If you have experience with either of these systems (or any other
free bug tracking system) and have an opinion about its suitability
for the mic1 project, please send a note to
Ray Ontko (rayo@ontko.com).
This page maintained by Ray Ontko
(rayo@ontko.com).