Commits

Bob Ippolito committed a553663

Small reformatting of NEWS

Comments (0)

Files changed (2)

 <p>An overview of the relevant changes in new, and older, releases.</p>
 <h2><a name="version-1-3-2005-03">Version 1.3 (2005-03-??)</a></h2>
 <ul>
+<li>New <code><span>objc.pyobjc_id</span></code> function that returns a the id of the underlying
+NSObject as an integer.  (Python wrapper objects are often made on the
+fly, meaning <code><span>id(obj)</span></code> is not constant during the lifetime of the
+object.)</li>
 <li>The bridge now maintains object identity across the bridge
 in both directions. Previous versions of the bridge only did this when
-bridging from Objective-C to Python.<p>Exceptions: NSString and NSNumber do not have unique proxies. NSString
-never will have. Python numbers and strings are converted, not proxied and
-therefore also don't get unique proxies.</p>
-<p>And finally, any python object that is proxied using the <code><span>__pyobjc_object__</span></code>
-interface will only get a unique proxy if the <code><span>__pyobjc_object__</span></code> method
-implements that feature.</p>
+bridging from Objective-C to Python.<p>Exceptions: <code><span>NSString</span></code> and <code><span>NSNumber</span></code> do not have unique proxies.  These
+types are converted to subclasses of Python types as appropriate, so they
+can not have unique proxies.  The identity of the original Objective-C
+object is maintained by these subclasses, but there may be many Python
+&quot;value proxies&quot; for a single Objective-C object.</p>
+<p>Any Python object that is proxied using the <code><span>__pyobjc_object__</span></code>
+interface will only get a unique proxy if the <code><span>__pyobjc_object__</span></code>
+method implements that feature.</p>
 </li>
 <li>New <code><span>objc.protocolsForClass</span></code> function that returns a list of protocols
 that the class directly claims to conform to.</li>
 
 - New ``objc.pyobjc_id`` function that returns a the id of the underlying
   NSObject as an integer.  (Python wrapper objects are often made on the
-  fly, meaning id(obj) is not constant during the lifetime of the object.)
+  fly, meaning ``id(obj)`` is not constant during the lifetime of the
+  object.)
 
 - The bridge now maintains object identity across the bridge
   in both directions. Previous versions of the bridge only did this when
   bridging from Objective-C to Python.
 
-  Exceptions: NSString and NSNumber do not have unique proxies. NSString
-  never will have. Python numbers and strings are converted, not proxied and
-  therefore also don't get unique proxies.
+  Exceptions: ``NSString`` and ``NSNumber`` do not have unique proxies.  These
+  types are converted to subclasses of Python types as appropriate, so they
+  can not have unique proxies.  The identity of the original Objective-C
+  object is maintained by these subclasses, but there may be many Python
+  "value proxies" for a single Objective-C object.
 
-  And finally, any python object that is proxied using the ``__pyobjc_object__``
-  interface will only get a unique proxy if the ``__pyobjc_object__`` method
-  implements that feature.
+  Any Python object that is proxied using the ``__pyobjc_object__``
+  interface will only get a unique proxy if the ``__pyobjc_object__``
+  method implements that feature.
 
 - New ``objc.protocolsForClass`` function that returns a list of protocols
   that the class directly claims to conform to.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.