Reference Library
This page lists new and recently changed documents, including Articles, Guides, Reference, Release Notes, Sample Code, Technical Notes, and Technical Q&As. Most documents have a revision history, which details additions and changes to that document since the previous version. Look for "Revision History" at the bottom of the document or in the document's table of contents.

Items are listed in reverse chronological order by publication date. To see the list sorted by the type of revision, click Sort by Revision Type. Items published for the first time (First Version) will be at the top of the list, followed by items with new or changed content (Content Update), followed by items with small fixes, such as typos and format errors, but no significant content changes (Minor Change).

New and updated Reference Library documents are announced in the bi-weekly Apple Developer Connection News, available as an option to ADC members. See the Membership Overview page for details on joining.
Document Revision Descriptions
On Off
Sort by
Date
Sort by
Title
Sort by
Revision Type
Sort by
Resource Type
Sorted by
Topic
2008-03-11 Accessibility Overview (HTML) (PDF)
Removed the Children attribute from the Busy Indicator role information.
Minor Change Guides Accessibility
2008-06-09 Apple Human Interface Guidelines (HTML) (PDF)
Fixed minor errors.
Minor Change Guides Accessibility
2008-04-08 Message Framework Reference (HTML)
Reprocessed content with new toolchain.
Minor Change Reference Apple Applications
2008-04-08 Disc Recording Framework Reference (HTML)
Reprocessed content with new toolchain.
Minor Change Reference Audio
2008-04-08 Disc Recording UI Framework Reference (HTML)
Reprocessed content with new toolchain.
Minor Change Reference Audio
2008-05-09 WhackedTV (HTML) (DMG) (ZIP)
Fixed two bugs: (1) "Select Output Format" in the audio dialog failed with error -206 if the source audio were set to 20 or 24 bits on an Intel Mac. The source format is 24-bits aligned low in 32-bits. WhackedTV was setting this as the default output format. But QuickTime movies can only contain packed samples. Added a utility function to conform the output format for movie-safety. (2) Began preferring the kQTSGAudioPropertyID_CodecSpecificSettingsArray property to the kQTSGAudioPropertyID_MagicCookie property. See QuickTimeComponents.h for an explanation of the differences between these properties, and why CodecSpecificSettingsArray should always be preferred over MagicCookie.
Content Update Sample Code Audio
2008-03-17 AbstractTree (HTML) (DMG) (ZIP)
Fixed a typo in the definition of a leaf node.
Minor Change Sample Code Data Management
2008-02-08 Atomic Store Programming Topics (HTML) (PDF)
Corrected typographical errors.
Minor Change Guides Data Management
2008-02-08 Core Data Model Versioning and Data Migration Programming Guide (HTML) (PDF)
Added a note about migrating stores from Mac OS X v10.4 (Tiger).
Minor Change Guides Data Management
2008-02-08 Core Data Programming Guide (HTML) (PDF)
Enhanced the discussions of legacy data importing and memory management.
Minor Change Guides Data Management
2008-06-04 DerivedProperty (HTML) (DMG) (ZIP)
Illustrates use of Core Data derived properties to make searching against string data more efficient.
First Version Sample Code Data Management
2008-03-11 Foundation Data Types Reference (HTML) (PDF)
Updated float to CGFloat where appropriate.
Minor Change Reference Data Management
2008-07-11 Foundation Functions Reference (HTML) (PDF)
Corrected descriptions of the functions NSRoundUpToMultipleOfPageSize and NSRoundDownToMultipleOfPageSize.
Minor Change Reference Data Management
2008-02-08 Low-Level Core Data Tutorial (HTML) (PDF)
Updated for Mac OS X v10.5.
Content Update Guides Data Management
2008-06-09 NSArray Class Reference (HTML) (PDF)
Made minor changes to the class overview to improve clarity.
Minor Change Reference Data Management
2008-06-09 NSCalendar Class Reference (HTML) (PDF)
Removed reference to NSCalendarDate, which is slated for deprecation. Added explanation of weekday ordinal unit.
Minor Change Reference Data Management
2008-05-04 NSCalendarDate Class Reference (HTML) (PDF)
Added note that use is discouraged.
Minor Change Reference Data Management
2008-02-08 NSData Class Reference (HTML) (PDF)
Corrected typographical errors.
Minor Change Reference Data Management
2008-06-09 NSDate Class Reference (HTML) (PDF)
Added a warning to methods related to NSCalendarDate that it is slated for deprecation.
Minor Change Reference Data Management
2008-02-08 NSDictionary Class Reference (HTML) (PDF)
Corrected typographical errors.
Minor Change Reference Data Management
2008-06-05 NSDictionaryController Class Reference (HTML) (PDF)
Corrected typos.
Minor Change Reference Data Management
2008-06-05 NSDictionaryControllerKeyValuePair Protocol Reference (HTML) (PDF)
Corrected typos.
Minor Change Reference Data Management
2008-07-11 NSExpression Class Reference (HTML) (PDF)
Corrected examples shown in the expressionForFunction:arguments: method description.
Minor Change Reference Data Management
2008-02-08 NSFetchRequest Class Reference (HTML) (PDF)
Corrected the discussion of the resultType method.
Minor Change Reference Data Management
2008-02-08 NSNumber Class Reference (HTML) (PDF)
Clarified the restricted return values that the (NSValue) objCType method returns.
Minor Change Reference Data Management
2008-02-08 NSPersistentDocument Class Reference (HTML) (PDF)
Corrected a minor link error.
Minor Change Reference Data Management
2008-02-08 NSPersistentDocument Core Data Tutorial (HTML) (PDF)
Corrected typographical errors.
Minor Change Guides Data Management
2008-03-11 NSPersistentStoreCoordinator Class Reference (HTML) (PDF)
Corrected minor typographical errors.
Minor Change Reference Data Management
2008-06-09 NSPropertyListSerialization Class Reference (HTML) (PDF)
Updated dataFromPropertyList: and propertyListFromData: to remove note about Mac OS X v10.5 behavior.
Minor Change Reference Data Management
2008-03-11 NSSet Class Reference (HTML) (PDF)
Added NSFastEnumeration to list of adopted protocols.
Minor Change Reference Data Management
2008-03-11 NSString Class Reference (HTML) (PDF)
Added paragraph to introduction describing the byte-order assumptions of factory and initialization methods taking UTF-16 input.
Minor Change Reference Data Management
2008-02-08 NSTimeZone Class Reference (HTML) (PDF)
Enhanced the discussions of the methods systemTimeZone and resetSystemTimeZone.
Minor Change Reference Data Management
2008-02-08 Number and Value Programming Topics for Cocoa (HTML) (PDF)
Updated for Mac OS X v10.5.
Minor Change Guides Data Management
2008-03-05 PhotoSearch (HTML) (DMG) (ZIP)
Removed pre-Leopard workarounds for highlighting cells. Also replaced deprecated -selectRows:byExtendingSelection: and -columnsInRect: with their modern NSIndexSet replacements.
Content Update Sample Code Data Management
2008-04-15 Xcode Tools for Core Data (HTML) (PDF)
New document that describes the Xcode modeling tools for Core Data.
First Version Guides Data Management
2008-06-09 Apple Human Interface Guidelines (HTML) (PDF)
Fixed minor errors.
Minor Change Guides Design Guidelines
2008-03-11 Cocoa Scripting Guide (HTML) (PDF)
Minor corrections for working with sdefs.
Minor Change Guides Design Guidelines
2008-02-27 Common mistakes with delegation in Cocoa (HTML)
First Version
First Version Technical Q&As Design Guidelines
2008-02-08 Core Data Programming Guide (HTML) (PDF)
Enhanced the discussions of legacy data importing and memory management.
Minor Change Guides Design Guidelines
2008-03-11 Garbage Collection Programming Guide (HTML) (PDF)
Corrected typographical errors.
Minor Change Guides Design Guidelines
2008-02-08 Low-Level Core Data Tutorial (HTML) (PDF)
Updated for Mac OS X v10.5.
Content Update Guides Design Guidelines
2008-02-08 Memory Management Programming Guide for Cocoa (HTML) (PDF)
Corrected a broken link to the "Carbon-Cocoa Integration Guide."
Minor Change Guides Design Guidelines
2008-02-08 Model Object Implementation Guide (HTML) (PDF)
Corrected the implementation example for setNilValueForKey:; updated the examples for dependent keys.
Minor Change Guides Design Guidelines
2008-02-08 NSDictionary Class Reference (HTML) (PDF)
Corrected typographical errors.
Minor Change Reference Design Guidelines
2008-06-05 NSDictionaryController Class Reference (HTML) (PDF)
Corrected typos.
Minor Change Reference Design Guidelines
2008-03-11 NSDocument Class Reference (HTML) (PDF)
Revised descriptions of saveDocumentWithDelegate:didSaveSelector:contextInfo: and isDocumentEdited methods. Added descriptions (previously removed) of deprecated methods no longer appearing in header file.
Minor Change Reference Design Guidelines
2008-03-11 NSDocumentController Class Reference (HTML) (PDF)
Removed false statement that reviewUnsavedDocumentsWithAlertTitle:cancellable:delegate:didReviewAllSelector:contextInfo: can ever return NO for cancellable.
Minor Change Reference Design Guidelines
2008-06-09 NSObject Class Reference (HTML) (PDF)
Updated sample code in +resolveInstanceMethod: to properly call super.
Minor Change Reference Design Guidelines
2008-02-08 NSPersistentDocument Class Reference (HTML) (PDF)
Corrected a minor link error.
Minor Change Reference Design Guidelines
2008-02-08 NSPersistentDocument Core Data Tutorial (HTML) (PDF)
Corrected typographical errors.
Minor Change Guides Design Guidelines
2008-08-29 Squiggles (HTML) (DMG) (ZIP)
Demonstrates many Cocoa fundamentals in a Document-based Application featuring custom drawing and event-handling.
First Version Sample Code Design Guidelines
2008-04-15 Xcode Design Tools for Class Modeling (HTML) (PDF)
New document that describes the Xcode Design Tools for Class Modeling.
First Version Guides Design Guidelines
2008-05-02 Xcode Unit Testing Guide (HTML) (PDF)
Updated for Xcode 3.0.
Minor Change Guides Design Guidelines
2008-03-10 CarbonCocoaTempConverter (HTML) (DMG) (ZIP)
Updated to produce a universal binary. Added code and comments for clarification.
Content Update Sample Code Events & Other Input
2008-03-11 Cursor Management (HTML) (PDF)
Updated information about cursor size and types. Replaced one article with a more relevant article.
Minor Change Guides Events & Other Input
2008-07-11 NSNotificationCenter Class Reference (HTML) (PDF)
Removed a statement that the observer parameter can be nil in the removeObserver:name:object: method.
Minor Change Reference Events & Other Input
2008-07-11 NSPanel Class Reference (HTML) (PDF)
Added a link to a document that describes panel behavior.
Minor Change Reference Events & Other Input
2008-02-08 NSRunLoop Class Reference (HTML) (PDF)
Updated the description of the runMode:beforeDate: method.
Minor Change Reference Events & Other Input
2008-07-11 NSSavePanel Class Reference (HTML) (PDF)
Corrected singleton information in the overview of this class.
Minor Change Reference Events & Other Input
2008-03-11 NSView Class Reference (HTML) (PDF)
Corrected information about the isOpaque method that's found in the discussion of the drawRect: method.
Minor Change Reference Events & Other Input
2008-03-17 NumberInput_IMKit_Sample (HTML) (DMG) (ZIP)
Illustrates an input method that uses the Mac OS X 10.5 InputMethodKit framework.
First Version Sample Code Events & Other Input
2008-03-05 PhotoSearch (HTML) (DMG) (ZIP)
Removed pre-Leopard workarounds for highlighting cells. Also replaced deprecated -selectRows:byExtendingSelection: and -columnsInRect: with their modern NSIndexSet replacements.
Content Update Sample Code Events & Other Input
2008-09-24 Programmatically causing restart, shutdown and/or logout (HTML) (日本語 HTML)
Updated source listing.
Minor Change Technical Q&As Events & Other Input
2008-08-29 Squiggles (HTML) (DMG) (ZIP)
Demonstrates many Cocoa fundamentals in a Document-based Application featuring custom drawing and event-handling.
First Version Sample Code Events & Other Input
2008-04-08 Disc Recording Framework Reference (HTML)
Reprocessed content with new toolchain.
Minor Change Reference File Management
2008-04-08 Disc Recording UI Framework Reference (HTML)
Reprocessed content with new toolchain.
Minor Change Reference File Management
2008-09-08 Expanding Tilde-based paths (HTML)
Simplified POSIX and CF versions using the embedded glob() function.
Minor Change Technical Q&As File Management
2008-07-11 File System Overview (HTML) (PDF)
Revised information about initial file permissions.
Minor Change Guides File Management
2008-02-25 FSMegaInfo (HTML) (DMG) (ZIP)
Prints information about various file system objects; helpful when debugging VFS plug-ins.
First Version Sample Code File Management
2008-02-08 Low-Level File Management Programming Topics (HTML) (PDF)
Removed references to deprecated Java classes.
Minor Change Guides File Management
2008-07-11 NSSavePanel Class Reference (HTML) (PDF)
Corrected singleton information in the overview of this class.
Minor Change Reference File Management
2008-06-06 SpotlightFortunes (HTML) (DMG) (ZIP)
Demonstrates how to provision a Spotlight importer plug-in for a custom UTI, and how to use a NSMetadataQuery with bindings to display live query results in a table view.
First Version Sample Code File Management
2008-04-08 Uniform Type Identifiers Overview (HTML) (PDF)
Added information about the UTI character set.
Minor Change Guides File Management
2008-04-08 Animation Overview (HTML) (PDF)
Corrected typos.
Minor Change Guides Games
2008-08-27 Getting the pixel data from a CGImage object (HTML)
Updated to refer to CGDataProviderCopyData(), available as of Mac OS X 10.5.
Content Update Technical Q&As Games
2008-02-06 OpenGL Filter Basics Cocoa (HTML) (DMG) (ZIP)
How to use Objective-C and MVC design patterns in installing and utilizing filters in an OpenGL rendering pipeline
First Version Sample Code Games
2008-08-08 Requirements for Quartz GL (HTML)
Document the QuartzGLEnable property list key and HIWindowSetBackingLocation(). Fixed typos.
Content Update Technical Q&As Games
2008-04-08 2D Graphics Release Notes for Mac OS X v10.5 (HTML)
Update information on garbage collection.
Minor Change Release Notes Graphics & Imaging
2008-04-08 Animation Overview (HTML) (PDF)
Corrected typos.
Minor Change Guides Graphics & Imaging
2008-04-08 Animation Types and Timing Programming Guide (HTML) (PDF)
Corrected typos.
Minor Change Guides Graphics & Imaging
2008-03-11 CAAnimationGroup Class Reference (HTML) (PDF)
Clarified that the animations grouped within a CAAnimationGroup do not get delegate messages, but that the group does.
Content Update Reference Graphics & Imaging
2008-03-10 CALayer Class Reference (HTML) (PDF)
Corrected method signature for removeAnimationForKey:.
Minor Change Reference Graphics & Imaging
2008-09-30 CALayerEssentials (HTML) (DMG) (ZIP)
Demonstrates the basics of setting up various Core Animation layers
First Version Sample Code Graphics & Imaging
2008-07-11 CAMediaTimingFunction Class Reference (HTML) (PDF)
Corrected descriptions of the predefined timing functions.
Minor Change Reference Graphics & Imaging
2008-03-11 CAOpenGLLayer Class Reference (HTML) (PDF)
Clarified that copyCGLPixelFormatForDisplayMask:, copyCGLContextForPixelFormat:, releaseCGLContext:, and releaseCGLPixelFormat: should only be implemented, never called.
Minor Change Reference Graphics & Imaging
2008-04-30 CARenderer Class Reference (HTML) (PDF)
Corrected description in the Overview.
Minor Change Reference Graphics & Imaging
2008-04-24 CIColorTracking (HTML) (DMG) (ZIP)
More comments. Fixed some errors in the project.
Content Update Sample Code Graphics & Imaging
2008-03-11 Core Animation Cookbook (HTML) (PDF)
Corrected typos.
Minor Change Guides Graphics & Imaging
2008-05-06 Core Animation Programming Guide (HTML) (PDF)
Corrected typos.
Minor Change Guides Graphics & Imaging
2008-06-09 Core Image Kernel Language Reference (HTML) (PDF)
Updated for Mac OS X v10.5.
Content Update Reference Graphics & Imaging
2008-06-09 Core Image Programming Guide (HTML) (PDF)
Added details on coordinate spaces.
Minor Change Guides Graphics & Imaging
2008-08-27 Getting the pixel data from a CGImage object (HTML)
Updated to refer to CGDataProviderCopyData(), available as of Mac OS X 10.5.
Content Update Technical Q&As Graphics & Imaging
2008-04-08 IKImageView Class Reference (HTML) (PDF)
Added information to the delegate property.
Minor Change Reference Graphics & Imaging
2008-06-09 Image Kit Programming Guide (HTML) (PDF)
Added information about support for dragging image views.
Minor Change Guides Graphics & Imaging
2008-06-09 Image Unit Tutorial (HTML) (PDF)
Updated the table of input parameters to kernel routines.
Minor Change Guides Graphics & Imaging
2008-02-08 NSAnimationContext Class Reference (HTML) (PDF)
Corrected typos.
Minor Change Reference Graphics & Imaging
2008-06-09 NSOpenGLContext Class Reference (HTML) (PDF)
Corrected description of NSOpenGLCPSwapInterval.
Minor Change Reference Graphics & Imaging
2008-07-11 NSPanel Class Reference (HTML) (PDF)
Added a link to a document that describes panel behavior.
Minor Change Reference Graphics & Imaging
2008-03-11 NSView Class Reference (HTML) (PDF)
Corrected information about the isOpaque method that's found in the discussion of the drawRect: method.
Minor Change Reference Graphics & Imaging
2008-02-06 OpenGL Filter Basics Cocoa (HTML) (DMG) (ZIP)
How to use Objective-C and MVC design patterns in installing and utilizing filters in an OpenGL rendering pipeline
First Version Sample Code Graphics & Imaging