2008-02-02 Jb Evain <jbevain@novell.com>

[mono.git] / docs / mini-porting.txt

diff --git a/docs/mini-porting.txt b/docs/mini-porting.txt
index 7cf14775b1d1d659e99e864ceeab253515ef0733..cdb967d3d9e5fe5ee97df41286c8b0c6306a5d94 100644 (file)
--- a/docs/mini-porting.txt
+++ b/docs/mini-porting.txt
@@ -241,6 +241,9 @@
        collecting liveness information and in a backward pass on the
        same list performs the actual register allocation, inserting
        the instructions needed to spill values, if necessary.
+
+       The cross-platform local register allocator is now implemented
+       and it is documented in the jit-regalloc file.
        
        When this part of code is implemented, some testing can be
        done with the generated code for the new architecture. Most
@@ -254,7 +257,14 @@
        tests.  Also, using multiple -v switches on the command line
        makes the JIT dump an increasing amount of information during
        compilation.
-       
+
+       Values loaded into registers need to be extened as needed by
+       the ECMA specs:
+
+       *) integers smaller than 4 bytes are extended to int32 values
+       *) 32 bit floats are extended to double precision (in particular
+       this means that currently all the floating point operations operate
+       on doubles)
        
 * Method trampolines
 
@@ -405,6 +415,23 @@
        *) mono_arch_instrument_epilog ()
                Functions needed to implement the profiling interface.
        
+* Testing the port
+
+    The JIT has a set of regression tests in *.cs files inside the mini directory.
+    The usual method of testing a port is by compiling these tests on another machine
+       with a working runtime by typing 'make rcheck', then copying TestDriver.dll and
+       *.exe to the mini directory. The tests can be run by typing:
+       ./mono --regression <exe file name>
+       The suggested order for working through these tests is the following:
+       - basic.exe
+       - basic-long.exe
+       - basic-float.exe
+       - basic-calls.exe
+       - objects.exe
+       - arrays.exe
+       - exceptions.exe
+       - iltests.exe
+       - generics.exe  
        
 * Writing regression tests
 
@@ -448,4 +475,4 @@
 
 
 
-       
\ No newline at end of file
+