Document Revision History

This table describes the changes to NSURL Class Reference.

2014-02-11Clarified the bookmarkDataWithOptions: includingResourceValuesForKeys:relativeToURL: error: method's parameters.
2013-10-22Clarified the interaction of NSURLBookmarkCreationWithSecurityScope and NSURLBookmarkCreationWithSecurityScope.
2013-09-18Updated for OS X v10.9.
2013-08-08Clarified that relativePath strips trailing slashes from paths.
2012-09-19Updated for OS X v10.8.

Minor corrections to the descriptions in “Ubiquitous Item Property Keys.”


Removed some content about security-scoped bookmarks from the Overview section and added a link to the definitive discussion for that information, the “Security-Scoped Bookmarks and Persistent Resource Access” in App Sandbox Design Guide section in App Sandbox Design Guide.


Added a description for the NSURLIsExcludedFromBackupKey constant.


Expanded the Overview section with new content including “Bookmarks, Security Scope, and Start/Stop Semantics” and “Security-Scoped URLs and String Paths.”


Added descriptions of two new methods in OS X v10.7.3: startAccessingSecurityScopedResource and stopAccessingSecurityScopedResource.


Added descriptions of new constants in OS X v10.7.3: NSURLBookmarkCreationWithSecurityScope, NSURLBookmarkCreationSecurityScopeAllowOnlyReadAccess, and NSURLBookmarkResolutionWithSecurityScope.


Updated descriptions of methods whose behavior changed in OS X v10.7.3 to support App Sandbox: bookmarkDataWithOptions:includingResourceValuesForKeys:relativeToURL:error: and URLByResolvingBookmarkData:options:relativeToURL:bookmarkDataIsStale:error:.

2011-10-12Updated with new file keys for OS X v10.7.
2010-09-01Added iOS implementation information for certain methods.
2010-04-06Added escaping information for the initWithScheme:host:path: and path methods.
2010-01-20Added links to URL resource property keys from methods that use them.
2009-10-09Added exception information for file URL initialization methods.
2009-08-28Update to OS X v10.6. Added bookmark data API.
2009-02-04Miscellaneous edits.
2008-11-19Added class specific behavior for isEqual:
2007-02-23Updated to include new API introduced in OS X v10.5.
2006-05-23First publication of this content as a separate document.
 First publication of this content as a separate document.