Copilot Release Notes
=====================
Greg Hewgill (gregh@lightspeed.net)
Copilot Home Page: http://userzweb.lightspeed.net/~gregh/pilot/copilot

------------------------------------------------------------------------------
Known problems in the current release
------------------------------------------------------------------------------
- The Pilot sound is only accurately emulated under Windows NT.
- The alarm functions are not completely emulated.
- Problems with the PalmPilot 1 MB ROM, see below.

------------------------------------------------------------------------------
6/10/97 Version 1.0 beta 9
------------------------------------------------------------------------------

- This release now supports the 1 MB PalmPilot ROM (either Personal or
  Professional versions). However, it only just "works", there are some
  known problems:
  - Some kind of timing problem prevents the pen "up" action from taking
    effect right away. Clicks on things like application selections will
    take longer to happen than you might expect.
  - The debugger is broken with anything other than the original English
    Pilot 1.0 ROM file. I have disabled the Debugger selection on the menu
    because of this (you can still make the debugger activate itself with
    any one of the many questionable coding practices listed below involving
    memory). The reason it's broken is it relies on absolute patch addresses
    to hook actions like application loading. Of course these addresses have
    changed.

- Fixed a problem with certain .prc files sans symbols crashing the debugger.

- Will now complain if the user attempts to load an application while the
  emulator is turned off.

- Added a switch to enable and disable Copilot sounds. This option is 
  initially OFF under Windows 95 because 95 does not properly support the
  Win32 Beep() API function used by Copilot to generate a tone at a specific
  frequency and duration.

- Copilot will now break into the debugger on the following memory errors:
  - Any word or long read or write on an odd address.
  - Any size write to Storage RAM when it is write protected.
  - Any size write to ROM (0x10c00000-0x10cfffff).
  - Any size read or write to an address outside the range:
      0x00000000-0x0000ffff, 0x10000000-(top of RAM), 0x10c00000-0x10cfffff
      Exception: word access in the range 0x10000000-0x10ffffff are permitted
                 (PalmOS probes memory to find out how much is installed).
  When the debugger is activated due to one of these traps, you may choose to
  continue execution and the emulator will ignore the trap.

------------------------------------------------------------------------------
10/27/96 Version 1.0 beta 8
------------------------------------------------------------------------------

The method used to load applications into Copilot is now much more robust.
Certain PRC files used to crash Copilot, and others were too large to load
using the old method. The new method loads these PRC files with no problem.

The default mask in the Load App dialog now includes *.pdb for loading Pilot
database files.

------------------------------------------------------------------------------
10/20/96 Version 1.0 beta 7a
------------------------------------------------------------------------------

Oops, in changing the SndDoCmd API emulation, I had accidentally disabled 
the sound completely. Fixed now. Also fixed some notes in the Copilot source
guide.

------------------------------------------------------------------------------
10/20/96 Version 1.0 beta 7
------------------------------------------------------------------------------

Copilot now has an icon! Thanks to Alan Chavis for his contribution. Thanks
also to the rest of you out there who sent me icons - if I ever get tired of
this one there are lots of other good ones to choose from. :)

The source code for Copilot is now available on the Copilot Home Page for
people who are interested in porting Copilot to other platforms.

Wes Cherry's AlarmHack now runs properly and doesn't crash Copilot.

Copilot now emulates the SndDoCmd API function only if the cmd parameter is 1.
It used to emulate it in all cases without regard for the cmd parameter.

------------------------------------------------------------------------------
10/6/96 Version 1.0 beta 6
------------------------------------------------------------------------------

Loading applications into Copilot is now much easier! There is a new menu
selection that will allow you to easily load applications into Copilot
without going through a full HotSync operation. See section 2.4 "Loading
Applications" in copilot.htm for more information.

------------------------------------------------------------------------------
9/29/96 Version 1.0 beta 5
------------------------------------------------------------------------------

Fixed three bugs in this release:

- HotSync under Windows 95 was not working. Fixed.
- Copilot on a 256 color display looked really bad because the palette was
  not being set up properly. Fixed.
- Under Windows 95, using the Zoom 2x display option resulted in a black
  Pilot display area. Fixed.

------------------------------------------------------------------------------
9/23/96 Version 1.0 beta 4
------------------------------------------------------------------------------

Copilot now emulates the HotSync button on the Pilot cradle, it is accessed
through the right click menu. The right click menu is also available using the
F10 key. This will allow people who have two serial ports and a serial mouse
to use Copilot - it was a catch-22 before because you needed the mouse to 
start HotSync, but the mouse was taking a comm port you needed! This will have
to do until I can write a software-only QuickSync for loading apps.

You will notice that the debugger has changed significantly, Darrin Massena
has been hard at work improving the debugger. The debugger.hlp file is a text
file that explains the commands. Commands with a * beside them have not been
implemented yet. This is still a work in progress, so things may not seem
exactly right all the time.

------------------------------------------------------------------------------
9/22/96 Version 1.0 beta 3
------------------------------------------------------------------------------

Copilot now includes a GetRom program that will help in transferring the Pilot
ROM from your Pilot to your PC. For instructions on how to use GetRom, see
"How To Get a Pilot.ROM file" in copilot.htm.

NOTICE: Use of the GetRom program may place you in violation of your license
        agreement with US Robotics. Please read page 123 of your Pilot
        handbook ("Software License Agreement") before running GetRom.

The debugger will now automatically start when the CPU encounters a breakpoint
instruction (opcode 0x4AFC).

------------------------------------------------------------------------------
9/17/96 Version 1.0 beta 2 (documentation update only)
------------------------------------------------------------------------------

Some people were having trouble using PilotHack to transfer the ROM file to
their PC. The problem was that if you followed my directions to turn off all
the HotSyncing features, the ROMDump.PRC file was never transferred!

I have corrected the documentation to give you the right instructions. In a
nutshell, don't turn off the "System" HotSync action, leave it as "Pilot
overwrites Desktop" (the default).

------------------------------------------------------------------------------
9/16/96 Version 1.0 beta 2
------------------------------------------------------------------------------

I forgot to include the makerom.exe program used to stitch together the
individual PRC files generated by PilotHack's rom dump feature. This program
has no error checking, so if the required files (romdump.0 through romdump.31)
are not present it will cause an exception error.

You can now choose the RAM size in the Properties page. Note that if you had
a pilot.ram file from the previous version, you will need to rename it to
pilot2048.ram in order to keep using it. Or, you can just ignore it and a new
ram file will be created automatically.

There is now a cpsample.zip file available on the Copilot Home Page. This
contains a pilot1024.ram file with all the applications I could find loaded
into it already. This will help if you don't have a proper null modem cable
to hook up Copilot for HotSync. Be sure to unzip this file with WinZip or other
32-bit unzip to preserve the long file name.

------------------------------------------------------------------------------
9/15/96 Version 1.0 beta 1
------------------------------------------------------------------------------

This is the first beta test version of Copilot. If you have any comments
on the program or documentation, please let me know at the email address
at the top of this file.

Note: In order to HotSync your ROM file with PilotHack, be sure you have
version 1.01 of PilotHack. Version 1.0 contains a bug that causes problems
with the 'x' command.
