Document Revision History

This table describes the changes to NSObject Class Reference.

2013-12-16Made minor clarifications concerning initialization and performing selectors.

Corrected description of initialize method to describe actual behavior and remove spurious recommendation to not call super. Added recommendation to avoid complex initialization code, especially code that might take locks.


Added note to performSelector:withObject:afterDelay:, performSelector:withObject:afterDelay:inModes:, performSelectorOnMainThread:withObject:waitUntilDone:, performSelectorOnMainThread:withObject:waitUntilDone:modes:, performSelector:onThread:withObject:waitUntilDone:, performSelector:onThread:withObject:waitUntilDone:modes:, and performSelectorInBackground:withObject: indicating that they may not run in a reasonable timeframe if called in the context of a dispatch queue, or any other context where a runloop exists but may not be run on a regular basis.


Added an example to init of a case where an implementation might reasonably return nil.

2013-10-22Updated code snippet in replacementObjectForPortCoder: to use current API.
2013-09-17Added links to functions related to class objects.
2013-01-28Updated description of forwardInvocation: to recommend calling super instead of doesNotRecognizeSelector:.
2012-09-19Updated for OS X v10.8.
2012-02-16Updated discussion of alloc methods for the modern runtime.
2011-09-08Updated for ARC.
2011-01-19Updated the performSelectorOnMainThread... method descriptions to reflect what happens during sequential calls to the method from the same thread.
2010-03-24Update example code to new initializer pattern.
2009-08-28Added autoContentAccessingProxy method.
2009-03-24Updated for OS X v10.6.
2009-02-04Added note about managing scarce resources in dealloc.
2008-10-15Added special consideration for +initialize method.
2008-06-09Updated sample code in +resolveInstanceMethod: to properly call super.
2008-03-11Updated the descriptions of the methods copyScriptingValue:forKey:withProperties: and newScriptingObjectOfClass:forValueForKey: withContentsValue:properties:.
2008-02-08Updated the description of the load method.
2007-12-11Updated descriptions for the performSelector methods.
2007-07-07Included new API for OS X v10.5.

The following new methods have been added for use with Cocoa scripting: copyScriptingValue:forKey:withProperties:, newScriptingObjectOfClass:forValueForKey:withContentsValue:properties:, and scriptingValueForSpecifier:.

2006-06-28Augmented the description of dealloc and version.
2006-05-23First publication of this content as a separate document.