Index: ChangeLog

from  Benoît Perrot  <benoit@lrde.epita.fr>

        * INSTALL: New.
        * README, TODO: Update.

ChangeLog

+2004-03-21  Benot Perrot  <benoit@lrde.epita.fr>
+
+	* INSTALL: New.
+	* README, TODO: Update.
+
 2004-03-18  Benot Perrot  <benoit@lrde.epita.fr>
 
 	Inline definition of a virtual method is nonsense.

INSTALL

+				Mipsy
+				*****
+
+Requirements
+============
+
+The following tools must be available on the system to build Mipsy:
+
+	* GNU C++ compiler
+	* GNU make 
+
+Extra development tools are needed to build a copy from Mipsy's repository:
+
+	* automake >= 1.7, autoconf >= 2.53
+	* python >= 2.3
+	* flex
+	* GNU Bison >= 1.875c
+
+
+Build process
+=============
+
+Building a copy from repository
+-------------------------------
+
+Before building a copy from Mipsy's repository, and only in this case,
+run the following command to generate development files:
+
+	$ ./bootstrap
+
+
+Building the tarball
+--------------------
+
+The following command will check your system configuration and prepare
+Mipsy for an installation in /usr/local. To specify another directory,
+use the --prefix option of configure (see ./configure --help):
+
+	$ ./configure
+
+Then build Mipsy:
+
+	$ make && make check
+
+
+Installation
+============
+
+Simply run:
+
+	$ make install

README

+				Mipsy
+				*****
 
-Non-automated generation:
+Description
+===========
 
-	* To re-generate src/inst/Makefile.am, do:
+Mipsy is a basic MIPS architecture simulator. It supports a minimalist 
+MIPS instruction set, implements some system calls (string printing, etc.)
+and supports an arbitrary number of registers ($x0, $x1, etc.). 
+Please refer to .info files in doc/ directory for full documentation.
 
-$ dev/mipsy-mk-inst-gen.py < dev/mipsy.xml > src/inst/Makefile.am
+
+Requirements
+============
+
+Mipsy does not need any specific library to work except libc and
+libstdc++. Development tools needed for building or maintaining Mipsy
+are listed in INSTALL file.
+
+
+Build and installation processes
+================================
+
+Build and installation processes are described in INSTALL file. Read it 
+attentively, especially before building a copy from Mipsy's repository.
+
+
+Distribution content
+====================
+
+src/		Source code.
+doc/		Documentation.
+tests/		Test suite.
+dev/		Development tools and data.
+debian/		Debian package configuration.

TODO

+				Mipsy
+				*****
 
-	* Use delay slot
 
+General
+=======
+
+	* Build a test suite that uses delay slot
+	* Generate a debian package (and eventually an RPM)
+
+
+Assembler
+=========
+
+	* Make the assembly syntax compatible with aasm
 	* Complete supported directives
+	* Add a standard ELF binary encoder
 
-	* Manage kernel text and data sections
 
-	* Manage global symbols and program merge
+Linker
+======
 
-	* Add an interactive debugger (see gdb, readline, etc.)
+	* Handle global symbols and program merge
+
+
+Virtual machine
+===============
 
-	* Add floating point coprocessor
+	* Manage memory (manage kernel text and data spaces)
+	* Add control coprocessor
+	* Handle exceptions
+	* Add a raw binary loader
+	* Add an ELF binary loader
+	* Add a floating point coprocessor
+	* Add vector unit coprocessors
 
+
+Thoughts
+========
+
+	* Search and evaluate a good LL(k)-parser generator (see antlr)
+
+
+Dreams
+======
+
+	* Add an interactive debugger (see gdb, readline, etc.)
 	* Add a graphic interface

prj

@@ -2,32 +2,21 @@
 (Created-By-Prcs-Version 1 3 2)
 
 (Project-Description "")
-(Project-Version     mipsy 0 75)
-(Parent-Version      mipsy 0 74)
+(Project-Version     mipsy 0 76)
+(Parent-Version      mipsy 0 75)
 
 (Version-Log
 "Index: ChangeLog
-2004-03-18  Benot Perrot  <benoit@lrde.epita.fr>
+from  Benot Perrot  <benoit@lrde.epita.fr>
 
-        Inline definition of a virtual method is nonsense.
-
-        * src/inst/exp.cc,
-        * src/inst/data_section.cc,
-        * src/inst/text_section.cc:
-        New.
-        * dev/inst-makefile-gen.py,
-        * src/task/task.hh, src/task/task.cc
-        * src/inst/exp.hh,
-        * src/inst/data_section.hh,
-        * src/inst/text_section.hh:
-        Move definitions of virtual methods in corresponding implementation
-        file.
+        * INSTALL: New.
+        * README, TODO: Update.
 
 ")
 (New-Version-Log
 "")
 
-(Checkin-Time        "Thu, 18 Mar 2004 22:33:04 +0100")
+(Checkin-Time        "Sun, 21 Mar 2004 16:39:08 +0100")
 (Checkin-Login       noe)
 
 (Files
@@ -35,11 +24,12 @@
     ;; ./
   (AUTHORS (mipsy/0_AUTHORS 1.1 604))
   (COPYING (mipsy/1_COPYING 1.1 604))
-  (ChangeLog (mipsy/2_ChangeLog 1.69 604))
+  (ChangeLog (mipsy/2_ChangeLog 1.70 604))
+  (INSTALL (mipsy/b/12_INSTALL 1.1 604))
   (Makefile.am (mipsy/3_Makefile.a 1.8 604))
   (NEWS (mipsy/b/25_NEWS 1.6 604))
-  (README (mipsy/4_README 1.2 604))
-  (TODO (mipsy/5_TODO 1.2 604))
+  (README (mipsy/4_README 1.3 604))
+  (TODO (mipsy/5_TODO 1.3 604))
   (bootstrap (mipsy/b/14_bootstrap 1.3 705))
   (configure.ac (mipsy/6_configure. 1.7 604))
   (prj (mipsy.prj) :symlink)
@@ -185,7 +175,7 @@
   (tests/unlimited/Makefile.am (mipsy/c/7_Makefile.a 1.2 604))
   (tests/unlimited/check-unlimited (mipsy/c/14_check-unli 1.2 705))
   (tests/unlimited/simple-exp.s (mipsy/c/8_simple-exp 1.2 604))
- )
+)
 
 (Populate-Ignore
   (