--- trunk/README	2007/10/08 16:17:48	2
+++ trunk/README	2007/10/08 16:19:37	22
@@ -1,27 +1,45 @@
-GXemul 0.3.1
-============
+Gavare's eXperimental Emulator   --   GXemul 0.3.8
+==================================================
 
-Copyright (C) 2003-2005  Anders Gavare.
+Copyright (C) 2003-2006  Anders Gavare.
 
 
 Overview
 --------
 
-GXemul is an experimental instruction-level machine emulator. It can be
-used to run binary code for (among others) MIPS-based machines. Several
-emulation modes are available. For some emulation modes, processors and
-surrounding hardware components are emulated well enough to let unmodified
-operating systems (eg. NetBSD) run as if they were running on a real machine.
+GXemul is an experimental instruction-level machine emulator. Several
+emulation modes are available. In some modes, processors and surrounding
+hardware components are emulated well enough to let unmodified operating
+systems (e.g. NetBSD) run as if they were running on a real machine.
+
+MIPS processors are emulated using either a simple binary translation 
+layer (recompilation into native code), which is used on Alpha and i386 
+hosts, or by traditional interpretation (very very slow, but works on any 
+host platform).
+
+ARM and PowerPC processors are emulated using a newer dynamic translation 
+system. Performance is somewhere between traditional interpretation and 
+recompilation into native code. However, the dynamic translation system 
+used in GXemul does NOT generate native code, and thus doesn't require 
+platform-specific back-ends. In plain English, this means that the 
+dyntrans system works on any host platform.
 
 
 Quick start
 -----------
 
-To compile, type './configure' and then 'make'.  This should work on most
-Unix- like systems, if not then please mail me a bug report.
+To compile, type './configure' and then 'make'. This should work on most
+Unix-like systems. If not, then please mail me a bug report.
 
-Please read the the documentation in the doc/ sub-directory for more
-detailed information on how to use the emulator.
+If you are impatient, and want to try out running a guest operating system 
+inside GXemul, read this:  doc/guestoses.html#netbsdcatsinstall
+
+If you want to use GXemul for experimenting with code of your own, 
+then I suggest you compile a Hello World program according to the tips 
+listed here:  doc/experiments.html#hello
+
+Please read the rest of the documentation in the doc/ sub-directory for
+more detailed information on how to use the emulator.
 
 
 Feedback