X-Git-Url: https://thelambdalab.xyz/gitweb/index.cgi?p=jars.git;a=blobdiff_plain;f=README;h=9c6f9cc68ed31d04485550252035400d816f919a;hp=6a5e5bf518b0a116388a568a33c7281a3b57c1a8;hb=7281b0c1eefce213d11cada1cb9f86a2d8fb0779;hpb=2cd0b7c49f97f10eb9176604aec83db9d0417e58

diff --git a/README b/README
index 6a5e5bf..9c6f9cc 100644
--- a/README
+++ b/README
@@ -1,19 +1,41 @@
 JaRS: Janky Redcode Simulator
 =============================
 
-A hobby implementation of the Memory Array Redcode Simulator (MARS) and
-associated tools for the programming game Corewar.
+A hobby implementation of the Memory Array Redcode Simulator (MARS)
+and associated tools for the programming game, Core War. The original
+concept for this game was developed by A. K. Dewdney (see
+http://corewar.co.uk/dewdney for copies of the 1984 Scientific
+American columns where the idea was first presented).
 
-At this pont, the JaRS contains a collection of utilities for:
+At this pont, JaRS contains utilities for:
 - Running redcode programs (warriors) specified in the "load file"
   format of the 1994 draft of the core war standard,
-- Visualizing the progress of battles graphically using Tk,
+- Visualizing the progress of battles graphically using Tk, and
 - Maintaining King of the Hill style tournaments in the spirit of
   http://www.koth.org.
 
+JaRS is still under development, and many aspects have not been fully
+tested.  Use at your own risk!
+
+Further Details
+---------------
+
+JaRS follows version 3.3 of the Proposed 1994 Core War Standard.
+(A copy is here: gopher://thelambdalab.xyz/0/docs/icws94.txt.)
+
+Currently the parser only handles the redcode programs expressed in
+the simple "load file" format described by the standard.  All possible
+core war programs can be expressed in this format, but it lacks some
+niceties such as labeled addresses.  That is, it accepts the redcode
+equivalent of machine code but lacks an assembler.
+
+Furthermore the simulator itself lacks support for p-space, a private
+memory area reserved for each program in some later revisions of the
+standard.
+
 License
 -------
 
 JaRS is free software, and is distributed under the terms of version 3
 of the GNU General Public License.  A copy of this license can be found in
-the file named COPYING.
\ No newline at end of file
+the file named COPYING.