$Id: README,v 1.7 2013-11-18 23:34:44 drmiller Exp $

The simulator has been redesigned totally in JAVA. This means that it should run
on any platform (provided that platform supports a sufficient JAVA VM).

There are no longer any C components, so nothing requires a C compiler to build.
Pre-built packages contain a JAR file, which should be totally self-contained.
(The disassemble program is currently not available, but the trace facilities
in the JAVA debug module are functional).

Some basic diagrams and notes on the hardware are in "docs/wang600arch.html".

Typically, the simulator is run using the following command:

	java -jar wang600.jar

To enable the debugger:

	java -jar wang600.jar -i	(run simulator normally)
	java -jar wang600.jar -I	(start in debugger)

The debugger can be activated at any time by pressing '%' in the main
calculator window. The debugger command 'help' will ordinarely be enough:

Wang 600 Simulator Commands:
  quit                   End simulation
  help                   Display this help
  dump                   Dump processor state/registers
  disas [addr [instrs]]  Disassemble ucode ROM at PC [or hex addr]
  exam [addr [words]]    Examine RAM at L,M,N [or hex addr]
  set reg=value [...]    Set register(s)
  store [@addr] value... Store hex val(s) in RAM at L,M,N [or hex addr]
  step                   Single-step one instruction
  core file              Dump all of RAM (2K) to <file>
  break [addr ...]       Set/Clear/Show one-shot breakpoint(s)
  go [+cycles]           Resume program at current PC [break after <cycles>]
  trace [file]           Set trace [off | {on|<file>} [cycles] [raw]]
  rom [addr [words]]     Examine ROM at L,M,N [or hex addr]
  dup                    Copy program space into ROM
  ! <cmd>                Execute cmd in shell


Other capabilities of the JAR file:

Wang 614 Card Editor:

	java -cp wang600.jar w600_edit

This will start the "Mark-Sense Card Editor", as in the cards
used for the Wang 614 card reader. This allows direct editing of
Wang program files (.w6t Tape Images).

See also the wpcc.tgz (Wang Programmable Calculator Compiler) package for
an alternative to maintaining Wang 600 Programs in the traditional ways.
The sample programs shipped with the simulator are presented in the
example directory of the wpcc.tgz archive.
