=================
Welcome to PyObjC
=================

The PyObjC package provides the glue needed to interface the Python interpreter
with the Objective-C language. At its core is the ``objc`` module makes 
Objective-C objects and classes available as first-class Python citizens. It is 
not only possible to use Objective-C objects but you can also subclass 
Objective-C classes.

To make it easier to use the core ``objc`` module, this package also provides 
a number of modules that are wrappers for the Cocoa frameworks, such as
Foundation and AppKit. These modules not only give you access to the classes in
these frameworks but also to the functions and constants in those modules.

More information on PyObjC can be found on 
`our website <http://pyobjc.sf.net>`_.

.. _`our website <http://pyobjc.sf.net>`: http://pyobjc.sf.net/

To install this package double-click on ``PyObjC.pkg``. This will install the
PyObjC python package and some Project Builder templates. The documentation
and examples are found in  the folder ``PyObjC Documentation and Examples``. 
Install these by dragging this folder to you disk, ``/Library/Documentation``
is a suitable location.

NOTE: The installer package is for Mac OS X 10.2 *only* and is for use with
the Apple supplied Python 2.2 installation. If you use MacPython 2.3 you should
use the Package Manager application to install PyObjC. If you use other versions
of Mac OS X you should install from the sources, see the source archive for
details.