+
+Installation:
+
+ For installation instructions, see the INSTALL file.
+
+
+Regression testing:
+
+ Emu8051 now supports automatic regression tests. This feature is mainly for
+ developers who want to make sure that whatever features they implement or
+ whatever bug they fix don't create additional or new problems.
+
+ To support that feature, you must have a compatible 8051 assembler installed.
+ At the moment, these two assemblers are supported:
+
+ as504 -- http://www.vanwal.nl/as504
+ ASEM-51 -- http://plit.de/asem-51
+
+ I recommend to compile as504 with this patch to support option "-O":
+ http://www.hugovil.com/repository/hvlinux/patches/as504-add-output-file-option.patch
+ as504 doesn't come with an installation script so compile and install it with:
+ $> make
+ $> sudo install as504 /usr/local/bin
+
+ Then reconfigure emu8051 so that as504 can be detected and regression testing
+ enabled.
+ You can run regression testing by issuing:
+ $> make check
+
+ Adding a new test case implies adding a new asm source file inside the tests
+ subdirectory and adding its name to two variables in tests/Makefile.am.
+
+
+This program was tested on the following systems:
+ "Linux From Scratch 4.0"