PTC 2.0 Porting Kit - Extending PTC
-----------------------------------


PTC 2.0 is designed as a simple platform independent core library.
Because of this, there are many things that fall out of the scope 
of the library. For instance, under Win32 typically the user will
want to be able to get the HWND (window handle) of the console in
order to control the console window, but the PTC api doesnt have 
a function to return this handle.

To this problem, there is a simple solution: just add the damned
function :)

As long as the core PTC 2.0 API is implemented, it is perfectly
acceptable to add any extra platform dependent functionality on
top of the PTC API. Of course it is up to the implementer to
document these functions and make sure that users know about
them. The only case where an added function is not acceptable
is when it duplicates functionality already in the API.

So, for the example of a Win32 window handle it could be added
as follows:

    1. Add a signature #define to ptc.h (see define.txt)

       #define __PTC_WIN32__

    2. Add an extension function to the console class

       HWND Console::window() { return m_hwnd; }

    3. Document the extension in the Win32 distribution


So, go forth and add platform specific functionality that your
users are craving for... they'll love you for it and so will i :)