OpenPTC 1.0 Porting Kit Upgrade Notes
-------------------------------------


Some minor cleaning up of commenting has occured in all source files, but 
nothing has changed significantly since version 1.0.0 alpha. This means that 
you only have to upgrade the files listed below:

    "ptc.h"
    "Index.h"
    "Copy.h"
    "Clear.h"
    "Timer.h"
    "Timer.cpp"
    "Base.h"
    "Surface.h"
    "Surface.cpp"
    "Console.h"
    "Console.cpp"

You must also delete the following files:

    "Clip.h"
    "Clip.cpp"

And replace them with the new files:

    "Clipper.h"
    "Clipper.cpp"

Do not despair, you do not have to fully upgrade the Console.h and Console.cpp
files. The only change here has been the addition of a clipping area. All you
have to do to upgrade is replace all the clipping code "Clip::clip" with the new
code from this version and add the new "Console::clip" functions. You must also
replace all includes of "Clip.h" with "Clipper.h", and update the "Console::load"
and the "Console::save" to add the checking "if (clip()==area())" like in the
new Console.cpp.

To test that you have properly upgraded to clip areas try the "Clip" example
with your PTC distribution! If it works correctly, the clip example will only
copy an area of the surface to the console -- if this doesnt happen then
something has gone wrong.

The "Copy.h" and "Clear.h" files only have to be replaced if you do not use the
"Hermes Kit" with your distribution. The only change to these files was to 
disallow copy construction and assignment and this was being done already in
the hermes kit.

The porting kit interface is now officially frozen and will not change in
future releases.
