Commits

Bob Ippolito committed 195679c

more documentation updates
(need to write a distutils command to build these)

  • Participants
  • Parent commits a6c03fe
  • Branches pyobjc-ancient

Comments (0)

Files changed (22)

File Doc/C-API.html

 <p>NOTE: Using the API other than by the mechanism described in this document 
 is unsupported.</p>
 <h2><a name="compatibility-macros">Compatibility Macros</a></h2>
-<p>On MacOS X, the version guard macro <code><span>MAC_OS_X_VERSION_MAX_ALLOWED</span></code> will 
+<p>On Mac OS X, the version guard macro <code><span>MAC_OS_X_VERSION_MAX_ALLOWED</span></code> will 
 always be available.</p>
 <p>The macros <code><span>PyDoc_STR</span></code>, <code><span>PyDoc_VAR</span></code> and <code><span>PyDoc_STRVAR</span></code> are defined 
 when they are not defined in <code><span>Python.h</span></code>.</p>

File Doc/C-API.txt

 Compatibility Macros
 --------------------
 
-On MacOS X, the version guard macro ``MAC_OS_X_VERSION_MAX_ALLOWED`` will 
+On Mac OS X, the version guard macro ``MAC_OS_X_VERSION_MAX_ALLOWED`` will 
 always be available. 
 
 The macros ``PyDoc_STR``, ``PyDoc_VAR`` and ``PyDoc_STRVAR`` are defined 

File Doc/announcement.txt

 PyObjC also supports full introspection of Objective-C classes and 
 direct invocation of Objective-C APIs from the interactive interpreter.
 
-PyObjC requires MacOS X 10.2 or later.  PyObjC works both with the Apple 
-provided Python installation in MacOS X 10.2 (and later) and with 
+PyObjC requires Mac OS X 10.2 or later.  PyObjC works both with the Apple 
+provided Python installation in Mac OS X 10.2 (and later) and with 
 MacPython 2.3.  Users of MacPython 2.3 can install PyObjC though the 
 PackageManager application.
 

File Doc/api-notes-macosx.html

 <head>
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
 <title>
-Notes on supported APIs and classes on MacOS X</title>
+Notes on supported APIs and classes on Mac OS X</title>
 <title>
 Contents</title>
 </head>
 <body>
-<h2>Notes on supported APIs and classes on MacOS X</h2>
+<h2>Notes on supported APIs and classes on Mac OS X</h2>
 <!-- :author: Ronald Oussoren -->
 <h2>Contents</h2>
 <ul>
 <p>TODO: Add documentation about weak linking (see intro.txt).</p>
 <h2><a href="#id2" name="introduction">Introduction</a></h2>
 <p>This document describes the restrictions w.r.t. supported APIs and classes
-on MacOS X. In general you can use classes and global functions just like
+on Mac OS X. In general you can use classes and global functions just like
 in Objective-C (e.g. the Apple developer documentation applies), but in some
 cases there are special considerations.</p>
 <p>We also do not provide access to global functions that are not useful for
 containing the original return value and the additional values. You don't have
 to pass values for those arguments, unless the method uses the values you
 pass in.</p>
-<p>This document is targeted at the latest supported version of MacOS X (currently
-MacOS X 10.3.x); unless specifically noted the same restrictions apply to 
-earlier versions of MacOS X. Earlier versions of the OS have less extensive
+<p>This document is targeted at the latest supported version of Mac OS X (currently
+Mac OS X 10.3.x); unless specifically noted the same restrictions apply to 
+earlier versions of Mac OS X. Earlier versions of the OS have less extensive
 APIs, PyObjC does <i>not</i> provide a compatibility layer.</p>
 <p>Frameworks not listed below are not wrapped by PyObjC, they can still be
 accessed although without access to constants and global functions defined
 </li>
 </ul>
 <h3><a href="#id32" name="class-nsinvocation">Class <code><span>NSInvocation</span></code></a></h3>
-<p>In some versions of MacOS X, NSInvocation doesn't work properly with structs
-that contain padding. Such structs are not used in the MacOS X API, but may
+<p>In some versions of Mac OS X, NSInvocation doesn't work properly with structs
+that contain padding. Such structs are not used in the Mac OS X API, but may
 be present in 3th party code. This leads to problems when <code><span>forwardInvocation:</span></code>
 is used to call a method that has such a struct as one of its arguments.</p>
 <h3><a href="#id33" name="class-nsmutablearray">Class <code><span>NSMutableArray</span></code></a></h3>

File Doc/api-notes-macosx.txt

-==============================================
-Notes on supported APIs and classes on MacOS X
-==============================================
+===============================================
+Notes on supported APIs and classes on Mac OS X
+===============================================
 
 .. :author: Ronald Oussoren
 
 ------------
 
 This document describes the restrictions w.r.t. supported APIs and classes
-on MacOS X. In general you can use classes and global functions just like
+on Mac OS X. In general you can use classes and global functions just like
 in Objective-C (e.g. the Apple developer documentation applies), but in some
 cases there are special considerations.
 
 to pass values for those arguments, unless the method uses the values you
 pass in.
 
-This document is targeted at the latest supported version of MacOS X (currently
-MacOS X 10.3.x); unless specifically noted the same restrictions apply to 
-earlier versions of MacOS X. Earlier versions of the OS have less extensive
+This document is targeted at the latest supported version of Mac OS X (currently
+Mac OS X 10.3.x); unless specifically noted the same restrictions apply to 
+earlier versions of Mac OS X. Earlier versions of the OS have less extensive
 APIs, PyObjC does *not* provide a compatibility layer.
 
 Frameworks not listed below are not wrapped by PyObjC, they can still be
 Class ``NSInvocation``
 ......................
 
-In some versions of MacOS X, NSInvocation doesn't work properly with structs
-that contain padding. Such structs are not used in the MacOS X API, but may
+In some versions of Mac OS X, NSInvocation doesn't work properly with structs
+that contain padding. Such structs are not used in the Mac OS X API, but may
 be present in 3th party code. This leads to problems when ``forwardInvocation:``
 is used to call a method that has such a struct as one of its arguments.
 

File Doc/gnustep.html

 <h2>GNUstep support in PyObjC</h2>
 <p>PyObjC has limited support for GNUstep, the 'objc' and 'Foundation' packages
 build and pass some, but by far not all, unittests. More work is needed to
-make the GNUstep port as stable as the MacOS X &quot;port&quot;.</p>
+make the GNUstep port as stable as the Mac OS X &quot;port&quot;.</p>
 <p>The GNUstep port was primarily developed on Linux i86 (specifically 
 the Debian testing distribution), using python 2.3.3,  gcc 3.3.2 and 
 gnustep-base1 1.9.0-1. The code in setup.py works for this configuration,

File Doc/gnustep.txt

 
 PyObjC has limited support for GNUstep, the 'objc' and 'Foundation' packages
 build and pass some, but by far not all, unittests. More work is needed to
-make the GNUstep port as stable as the MacOS X "port".
+make the GNUstep port as stable as the Mac OS X "port".
 
 The GNUstep port was primarily developed on Linux i86 (specifically 
 the Debian testing distribution), using python 2.3.3,  gcc 3.3.2 and 

File Examples/00ReadMe.html

 from a menu action.</p>
 </li>
 <li><a href="SillyBallsSaver">SillyBallsSaver</a><p>A simple screensaver written in Python. This example requires a framework
-install of Python, that is either MacOS X 10.3 or a MacPython 2.3 
+install of Python, that is either Mac OS X 10.3 or a MacPython 2.3 
 installation.</p>
 </li>
 <li><a href="SimpleService">SimpleService</a><p>Shows how to implement entries for the Services menu.</p>
 </li>
 <li>WebServicesTool-ControllerLayer<p>This is a refactor of the WebServicesTool example that is made much simpler
 by using Twisted as it does not need threads. This version also uses
-NSController and therefore requires MacOS X 10.3.</p>
+NSController and therefore requires Mac OS X 10.3.</p>
 </li>
 </ul>
 </blockquote>

File Examples/00ReadMe.txt

 * `SillyBallsSaver`_
 
   A simple screensaver written in Python. This example requires a framework
-  install of Python, that is either MacOS X 10.3 or a MacPython 2.3 
+  install of Python, that is either Mac OS X 10.3 or a MacPython 2.3 
   installation.
 
 * `SimpleService`_
 
     This is a refactor of the WebServicesTool example that is made much simpler
     by using Twisted as it does not need threads. This version also uses
-    NSController and therefore requires MacOS X 10.3.
+    NSController and therefore requires Mac OS X 10.3.
 
 * `WebServicesTool`_
 

File Examples/PackageManager/ReadMe.txt

 Building
 --------
 
-This version requires the latest version of PyObjC (1.1b1) and MacOS X 10.3.
+This version requires the latest version of PyObjC (1.1b1) and Mac OS X 10.3.
 Please let me know if it also works on OSX 10.2.
 
 Run ``python buildapp.py build`` to create the application.

File HISTORIC.txt

 possible to use Objective-C objects but you can also subclass Objective-C 
 classes.
 
-The package maintainers currently only work on supporting MacOS X, the GNU
+The package maintainers currently only work on supporting Mac OS X, the GNU
 runtime and GnuStep are not supported at the moment (patches to change that 
 are welcome).
 
-The python situation on MacOS X is a bit vague at the moment, PyObjC is known
+The python situation on Mac OS X is a bit vague at the moment, PyObjC is known
 to work using the following versions of python:
 - Fink's python 2.2 
   Building GUI applications requires some manual work, mostly because I

File Install.html

 <body>
 <h2>Installation Instructions</h2>
 <!-- :authors: Bill Bumgarner, Ronald Oussoren, Bob Ippolito -->
-<h2><a name="notes-for-subversion-users">Notes for Subversion users</a></h2>
-<p>To build PyObjC from the Subversion repository, you will need an installation
-of libffi.  A snapshot of libffi modified to build inside the PyObjC source
-tree is available from the <a href="#id2" name="id3"><span id="id3">`PyObjC download site`_</span></a>.  To use this, simply move
-the extracted libffi-src folder to your PyObjC source folder.  If you would
-like to use another libffi source location, update the variable
-<code><span>LIBFFI_SOURCES</span></code> at the top of setup.py.  Release versions of PyObjC include
-a compatible libffi snapshot.</p>
 <h2><a name="building-the-package">Building the package</a></h2>
 <p>PyObjC is built and installed using the distutils package included with Python
 2.0 and beyond.  distutils provides a single interface for building and
 </pre>
 <p>The setup.py system can also be used to create source and binary
 distribution archives automatically.</p>
-<p>Use <code><span>sudo</span></code> to install the PyObjC package into the Apple supplied
-Python's site-packages directory on OS X 10.2 and greater:</p>
-<p>% sudo python setup.py install</p>
+<p>The following command will build and open a binary installer for PyObjC,
+py2app, tools, examples, and documentation:</p>
+<pre>
+% python setup.py bdist_mpkg --open
+</pre>
+<p>If you want to install the PyObjC package without examples, documentation,
+or py2app, you can use the standard distutils install command:</p>
+<pre>
+% sudo python setup.py install
+</pre>
 <p>If you have multiple versions of Python installed on your system, the
 above will only install PyObjC for whatever version of Python is the
 default on the command line.   Make sure you are installing PyObjC
 against the correct version of Python.</p>
 <p>Note that there is a known bug in Python 2.3.0 
-(as shipped with MacOS X 10.3.x), such that when another framework Python is 
+(as shipped with Mac OS X 10.3.x), such that when another framework Python is 
 installed it will not link extensions (such as PyObjC) properly, rendering them
 unusable.  If you intend to build PyObjC for Python 2.3.0, ensure that no other
-framework Python is installed, such as a previous installation for MacOS X
-10.2.  For more information on this and other Python issues on MacOS X,
+framework Python is installed, such as a previous installation for Mac OS X
+10.2.  For more information on this and other Python issues on Mac OS X,
 please refer to the <a href="http://pythonmac.org/wiki/FAQ">pythonmac.org FAQ</a>.</p>
 <p>If you have a previous version of PyObjC installed, you may see an exception
 such as <code><span>Wrong</span> <span>version</span> <span>of</span> <span>PyObjC</span> <span>C</span> <span>API</span></code>.  If this happens, you should
 new sources and try again.  PyObjC will typically be installed to a folder
 of the same name in /Library/Python/2.3 or /Library/Python/2.3/site-packages.</p>
 <p>To be able to build the wrappers for the WebKit framework (included with
-Safari 1.0), you'll have to install the WebKit SDK. You can download 
-this from the <a href="http://connect.apple.com">ADC website</a>.</p>
+Safari 1.0) on Mac OS X 10.2, you'll have to install the WebKit SDK. You can
+download this from the <a href="http://connect.apple.com">ADC website</a>.</p>
 <p>PyObjC has limited support for <a href="http://www.gnustep.org/">GNUstep</a>. See <a href="Doc/gnustep.html">Doc/gnustep.txt</a> for 
 more information.</p>
 <h2><a name="examples">Examples</a></h2>
 Cocoa-Python applications.  To build and execute:</p>
 <pre>
 % cd TableModel
-% python buildapp.py build
+% python setup.py py2app
+% open dist/TableModel.app
 </pre>
-<p>The WebServicesTool is an example of Cocoa-Python applications created via 
-the Cocoa-Python project template found in the 
-<code><span>ProjectBuilder</span> <span>Extras/Project</span> <span>Templates</span></code> directory.  Use Project Builder 
-to build the applications.</p>
+<p>For projects that contain a Project Builder (.pbproj), you can build them
+with Project Builder or Xcode.  Xcode (.xcode) projects can be built only
+with Xcode.  However, all examples ship with a py2app-based setup.py, and
+this is the preferred build method.</p>
 <h2><a name="project-templates">Project Templates</a></h2>
-<h3><a name="xcode-on-macos-x-10-3">Xcode on MacOS X 10.3</a></h3>
+<h3><a name="xcode-on-mac-os-x-10-3">Xcode on Mac OS X 10.3</a></h3>
 <p>The <code><span>Xcode</span></code> directory contains some file and project that make it easier to
 work with Python and PyObjC when using <a href="http://www.apple.com/xcode">Xcode</a>.</p>
 <p>Copy the templates in <code><span>Xcode/File</span> <span>templates</span></code> to <code><span>/Library/Application</span> <span>Support/Apple/Developer</span> <span>Tools/File</span> <span>Templates</span></code>. Copy the templates in <code><span>Xcode/Project</span> <span>Templates</span></code> to <code><span>/Library/Application</span> <span>Support/Apple/Developer</span> <span>Tools/Project</span> <span>Templates</span></code>.</p>
 <p>When building the 'install' target, the resulting application wrapper will
 include the PyObjC package and can be launched on any stock OS X 10.3 system
 without requiring PyObjC to be preinstalled.</p>
-<p>Note that the optional 'BSD Subsystem' component of MacOS X is required,
+<p>Note that the optional 'BSD Subsystem' component of Mac OS X is required,
 however it is installed by default and should be present on most systems.</p>
 </li>
 <li>Cocoa-Python Document-based Application<p>This template works like the Cocoa-Python Application template in that it
 default Cocoa Document-based Application supplied with Project Builder.</p>
 </li>
 </ul>
-<p>Note that Python applications built on MacOS X 10.3 are not compatible with
-MacOS X 10.2.  At this time, a MacOS X 10.2 system must be used to build
-MacOS X 10.2 compatible applications.</p>
-<h3><a name="project-builder-on-macos-x-10-2">Project Builder on MacOS X 10.2</a></h3>
+<p>Note that Python applications built on Mac OS X 10.3 are not compatible with
+Mac OS X 10.2.  At this time, a Mac OS X 10.2 system must be used to build
+Mac OS X 10.2 compatible applications.</p>
+<h3><a name="project-builder-on-mac-os-x-10-2">Project Builder on Mac OS X 10.2</a></h3>
 <p>The <code><span>ProjectBuilder</span> <span>Extras</span></code> directory contains additional files that can
 be used with Project Builder. The directory <code><span>Specifications</span></code> contains files
 that enable syntax coloring for Python files in Project Builder.</p>
 </ul>
 <p>More information on project templates can be found in the Project
 Builder documentation and/or release notes.</p>
-<h2><a>Docutils System Messages</a></h2>
-<div id="id2">
-<p>System Message: <a name="id2">ERROR/3</a> (<tt>./Install.txt</tt>, line 10); <em><a href="#id3">backlink</a></em></p>
-<p>Unknown target name: &quot;pyobjc download site&quot;.</p>
-</div>
 </body>
 </html>
 
 .. :authors: Bill Bumgarner, Ronald Oussoren, Bob Ippolito
  
-Notes for Subversion users
-==========================
-
-To build PyObjC from the Subversion repository, you will need an installation
-of libffi.  A snapshot of libffi modified to build inside the PyObjC source
-tree is available from the `PyObjC download site`_.  To use this, simply move
-the extracted libffi-src folder to your PyObjC source folder.  If you would
-like to use another libffi source location, update the variable
-``LIBFFI_SOURCES`` at the top of setup.py.  Release versions of PyObjC include
-a compatible libffi snapshot.
-
-.. _`the PyObjC download site`: http://sourceforge.net/project/showfiles.php?group_id=14534
-
 Building the package
 ====================
 
 The setup.py system can also be used to create source and binary
 distribution archives automatically.
 
-Use ``sudo`` to install the PyObjC package into the Apple supplied
-Python's site-packages directory on OS X 10.2 and greater:
+The following command will build and open a binary installer for PyObjC,
+py2app, tools, examples, and documentation::
 
-% sudo python setup.py install
+  % python setup.py bdist_mpkg --open
+
+If you want to install the PyObjC package without examples, documentation,
+or py2app, you can use the standard distutils install command::
+
+  % sudo python setup.py install
 
 If you have multiple versions of Python installed on your system, the
 above will only install PyObjC for whatever version of Python is the
 against the correct version of Python.
 
 Note that there is a known bug in Python 2.3.0 
-(as shipped with MacOS X 10.3.x), such that when another framework Python is 
+(as shipped with Mac OS X 10.3.x), such that when another framework Python is 
 installed it will not link extensions (such as PyObjC) properly, rendering them
 unusable.  If you intend to build PyObjC for Python 2.3.0, ensure that no other
-framework Python is installed, such as a previous installation for MacOS X
-10.2.  For more information on this and other Python issues on MacOS X,
+framework Python is installed, such as a previous installation for Mac OS X
+10.2.  For more information on this and other Python issues on Mac OS X,
 please refer to the `pythonmac.org FAQ`_.
 
 .. _`pythonmac.org FAQ`: http://pythonmac.org/wiki/FAQ
 of the same name in /Library/Python/2.3 or /Library/Python/2.3/site-packages.
 
 To be able to build the wrappers for the WebKit framework (included with
-Safari 1.0), you'll have to install the WebKit SDK. You can download 
-this from the `ADC website <http://connect.apple.com>`_.
+Safari 1.0) on Mac OS X 10.2, you'll have to install the WebKit SDK. You can
+download this from the `ADC website <http://connect.apple.com>`_.
 
 PyObjC has limited support for `GNUstep`_. See `Doc/gnustep.txt`_ for 
 more information.
 Cocoa-Python applications.  To build and execute::
 
   % cd TableModel
-  % python buildapp.py build
+  % python setup.py py2app
+  % open dist/TableModel.app
 
-The WebServicesTool is an example of Cocoa-Python applications created via 
-the Cocoa-Python project template found in the 
-``ProjectBuilder Extras/Project Templates`` directory.  Use Project Builder 
-to build the applications.
-
+For projects that contain a Project Builder (.pbproj), you can build them
+with Project Builder or Xcode.  Xcode (.xcode) projects can be built only
+with Xcode.  However, all examples ship with a py2app-based setup.py, and
+this is the preferred build method.
 
 Project Templates
 =================
 
-Xcode on MacOS X 10.3
-.....................
+Xcode on Mac OS X 10.3
+......................
 
 The ``Xcode`` directory contains some file and project that make it easier to
 work with Python and PyObjC when using `Xcode`__.
   include the PyObjC package and can be launched on any stock OS X 10.3 system
   without requiring PyObjC to be preinstalled.
 
-  Note that the optional 'BSD Subsystem' component of MacOS X is required,
+  Note that the optional 'BSD Subsystem' component of Mac OS X is required,
   however it is installed by default and should be present on most systems.
 
 * Cocoa-Python Document-based Application
   that uses Cocoa's Multiple Document Architecture in the same fashion as the
   default Cocoa Document-based Application supplied with Project Builder. 
 
-Note that Python applications built on MacOS X 10.3 are not compatible with
-MacOS X 10.2.  At this time, a MacOS X 10.2 system must be used to build
-MacOS X 10.2 compatible applications.
+Note that Python applications built on Mac OS X 10.3 are not compatible with
+Mac OS X 10.2.  At this time, a Mac OS X 10.2 system must be used to build
+Mac OS X 10.2 compatible applications.
 
-Project Builder on MacOS X 10.2
-...............................
+Project Builder on Mac OS X 10.2
+................................
 
 The ``ProjectBuilder Extras`` directory contains additional files that can
 be used with Project Builder. The directory ``Specifications`` contains files

File Installer Package/10.2/ReadMe.html

 and examples are found in  the folder <code><span>PyObjC</span> <span>Documentation</span> <span>and</span> <span>Examples</span></code>. 
 Install these by dragging this folder to you disk, <code><span>/Library/Documentation</span></code>
 is a suitable location.</p>
-<p>NOTE: This installer package is for MacOS X 10.2 with the Python 2.2 supplied
-by Apple. There is a seperate installer for MacOS X 10.3. If you use 
-MacPython 2.3 on MacOS X 10.2 you should use the <code><span>Package</span> <span>Manager</span></code> 
+<p>NOTE: This installer package is for Mac OS X 10.2 with the Python 2.2 supplied
+by Apple. There is a seperate installer for Mac OS X 10.3. If you use 
+MacPython 2.3 on Mac OS X 10.2 you should use the <code><span>Package</span> <span>Manager</span></code> 
 application to install PyObjC. In other situation you can install PyObjC from 
 the source archive.</p>
 </body>

File Installer Package/10.2/ReadMe.txt

 Install these by dragging this folder to you disk, ``/Library/Documentation``
 is a suitable location.
 
-NOTE: This installer package is for MacOS X 10.2 with the Python 2.2 supplied
-by Apple. There is a seperate installer for MacOS X 10.3. If you use 
-MacPython 2.3 on MacOS X 10.2 you should use the ``Package Manager`` 
+NOTE: This installer package is for Mac OS X 10.2 with the Python 2.2 supplied
+by Apple. There is a seperate installer for Mac OS X 10.3. If you use 
+MacPython 2.3 on Mac OS X 10.2 you should use the ``Package Manager`` 
 application to install PyObjC. In other situation you can install PyObjC from 
 the source archive.

File Installer Package/10.3/ReadMe.html

 and examples are found in  the folder <code><span>PyObjC</span> <span>Documentation</span> <span>and</span> <span>Examples</span></code>. 
 Install these by dragging this folder to you disk, <code><span>/Library/Documentation</span></code>
 is a suitable location.</p>
-<p>NOTE: This installer package is for MacOS X 10.3. There is a seperate installer
-for MacOS X 10.2 with the Python 2.2 supplied by Apple. If you use 
-MacPython 2.3 on MacOS X 10.2 you should use the <code><span>Package</span> <span>Manager</span></code> 
+<p>NOTE: This installer package is for Mac OS X 10.3. There is a seperate installer
+for Mac OS X 10.2 with the Python 2.2 supplied by Apple. If you use 
+MacPython 2.3 on Mac OS X 10.2 you should use the <code><span>Package</span> <span>Manager</span></code> 
 application to install PyObjC. In other situation you can install PyObjC from 
 the source archive.</p>
 </body>

File Installer Package/10.3/ReadMe.txt

 Install these by dragging this folder to you disk, ``/Library/Documentation``
 is a suitable location.
 
-NOTE: This installer package is for MacOS X 10.3. There is a seperate installer
-for MacOS X 10.2 with the Python 2.2 supplied by Apple. If you use 
-MacPython 2.3 on MacOS X 10.2 you should use the ``Package Manager`` 
+NOTE: This installer package is for Mac OS X 10.3. There is a seperate installer
+for Mac OS X 10.2 with the Python 2.2 supplied by Apple. If you use 
+MacPython 2.3 on Mac OS X 10.2 you should use the ``Package Manager`` 
 application to install PyObjC. In other situation you can install PyObjC from 
 the source archive.

File Installer Package/10.4/ReadMe.txt

 Install these by dragging this folder to you disk, ``/Library/Documentation``
 is a suitable location.
 
-NOTE: This installer package is for MacOS X 10.3. There is a seperate installer
-for MacOS X 10.2 with the Python 2.2 supplied by Apple. If you use 
-MacPython 2.3 on MacOS X 10.2 you should use the ``Package Manager`` 
+NOTE: This installer package is for Mac OS X 10.3. There is a seperate installer
+for Mac OS X 10.2 with the Python 2.2 supplied by Apple. If you use 
+MacPython 2.3 on Mac OS X 10.2 you should use the ``Package Manager`` 
 application to install PyObjC. In other situation you can install PyObjC from 
 the source archive.

File Installer Package/ReadMe.txt

 Install these by dragging this folder to you disk, ``/Library/Documentation``
 is a suitable location.
 
-NOTE: The installer package is for MacOS X 10.2 *only* and is for use with
+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 MacOS X you should install from the sources, see the source archive for
+of Mac OS X you should install from the sources, see the source archive for
 details.

File Installer Package/Resources/License.txt

 (This is the MIT license)
 
-Copyright 2002, 2003 - Bill Bumgarner, Ronald Oussoren, Steve Majewski, Lele Gaifax, et.al.
+Copyright 2002, 2003, 2004 - Bill Bumgarner, Ronald Oussoren, Steve Majewski, Lele Gaifax, et.al.
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

File Modules/AppKit/00ReadMe.txt

 This directory contains the objective-C sources for native python helper
-modules that are used to wrap the AppKit (Cocoa) APIs on MacOS X.
+modules that are used to wrap the AppKit (Cocoa) APIs on Mac OS X.
 
 These sources are the Objective-C code that is needed for the 'AppKit '
 package (see ../../Lib).
 
   This adds method ``myMethod`` to class NSObject.
 
+- py2app is now used for all Example scripts and is the recommended method
+  for creating PyObjC applications.
+
+- Proxies of dict, list, and tuple now respect the invariant that you should
+  get an identical instance if you ask for the same thing twice and the
+  collection has not been mutated.  This fixes some problems with binary
+  plist serialization, and potentially some edge cases elsewhere.
+
+- There is now a __bundle_hack__ class attribute that will cause the PyObjC
+  class builder to use a statically allocated class wrapper if one is
+  available via certain environment variables.  This functionality is used
+  to enable +[NSBundle bundleForClass:] to work for exactly one class from
+  a py2app-created plugin bundle.  We now have a working Interface Builder
+  palette example due to this hack.
+
 Version 1.1 (2004-05-30)
 ------------------------