Return-Path: sarago@paola.dei.unipd.it
Date: Mon, 31 Jan 94 15:37:56 +0100
From: sarago@paola.dei.unipd.it (Tomaso Paoletti 345392/IL)
To: fredm@media.mit.edu
Subject: Uploaded version 1.1 of sim68forMac

I just uploaded version 1.1 of sim68forMac
in directory /pub/incoming.

--------------------------------------------------------------

This version of the 68HC11 simulator fixes some instructions
(jsr, idiv & fdiv) and A LOT of bugs 
( oops, I discovered some of them ten seconds
after I distributed the program; the power of testing! ).

Also added symbols, drag & drop (under Sys7), register
modification and full text-file editing.

For any idea, suggestion or bug report I am available
at:
				sarago@paola.dei.unipd.it
				sarago@maya.dei.unipd.it

			Thanks,
				Tomaso


*********************************************************

	Sim68 for Mac  -  notes about version 1.0
	
	Tomaso Paoletti
	
  For any comment, suggestion or bug report, 
  I am available via E-mail at:
				sarago@paola.dei.unipd.it
				sarago@maya.dei.unipd.it
  
*********************************************************
			
  This application is a simulator of the 68HC11, an 8-bit microcontroller
  by Motorola, and has been ported from a MS-DOS version by Ted Dunning
  ( which, if I am not wrong, was first ported from Unix ! ).
  
  The core of the simulator remained almost the same ( and with
  small effort it would be possible to extend it to other 68xx-family
  microprocessors ) while the interface became a strange mixture
  of UNIX and Mac style ( sscanf mixed with FSRead and similar).
  
  NOTE that multiplication and other instructions (concerning interrupts)
  ARE NOT IMPLEMENTED YET.
  
  The back-bone of Mac-specific code is David Eck's MacStarter, 
  an application shell which has been extended to implement
  a primitive multi-window text-editor with file support.
  
  This version has been tested on a Classic (Sys 6 / 2 MB) and on
  a Centris 610 ( Sys 7.1 / 8 MB with Cache and VM on ).
  
If you like this program, what about a postcard from your country?

										Bye, Tomaso

******************* Known problems & misc. notes ***********************
- Even if I tried to implement some protections and warnings, while running
  LOW OF MEMORY the application shows exotic behaviour...

- Scrollbars are not updated correctly with TEAutoView ( lack of clikLoop )

- Go,Step and Stop buttons not following Mac interface (just icons)
  ( I will fix as soon as I learn how CDEFs work )

- About OpenText and SaveAs commands:
	They have no direct relation with the simulator and have been
	implemented just as facilities while stepping through the code.
	
	File windows : content can only be copied, not modified
	Dumps & disasms : can be edited, modified and saved as files
	
- The auto-refresh option keeps all the modified windows updated and
  performs decently with few active windows and without Breakpoints window
   (which re-scans all 64K of memory every time).

- The PC-following option let you step through the code without 
  continuously disassembling next locations and is active only if the 
  current PC address is within, or near, the disassembly interval.
  (see myWindow::Refresh & DoOtherMenu )

- With multiple windows it is easy to get lost: perhaps I will implement
  a Windows menu with short description ( ex.: 'Untitled:disasm $F800').
  
- An 'acurs' would help in making evident whether the simulator is running or not.

Variation on Murphy's Law : 	if this documentation could seem
				incomprehensible, it will be.