Document Revision History

This table describes the changes to NSFileManager Class Reference.

2013-09-17Minor changes to several method descriptions.

Added information to evictUbiquitousItemAtURL:error: about coordinated writes.


Clarified discussion of setUbiquitous:itemAtURL:destinationURL:error:.


Added information to removeItemAtURL:error:, removeItemAtPath:error:, and URLForPublishingUbiquitousItemAtURL:expirationDate:error: about removing old versions of items.

2013-08-08Addressed minor bugs in method descriptions.

Fixed description of linkItemAtURL:toURL:error: to correctly identify source and destination.


Corrected description of enumeratorAtURL:includingPropertiesForKeys:options:errorHandler: to indicate that it does not traverse mount points.


Expanded description of NSFileProtectionCompleteUnlessOpen to clarify the behavior of data with this protection class in relation to device locking.

2013-03-14Added documentation for containerURLForSecurityApplicationGroupIdentifier: method introduced in OS X v10.8.3.
2013-01-28Corrected the description of linkItemAtPath:toPath:error:.
2012-12-13Updated the guidance for the URLForUbiquityContainerIdentifier: method.

Updated the description of the URLForUbiquityContainerIdentifier: method for OS X v10.8.


Added descriptions for two new methods in OS X v10.8: ubiquityIdentityToken and trashItemAtURL:resultingItemURL:error:.


Added a description for the NSUbiquityIdentityDidChangeNotification notification, new in OS X v10.8.

2011-10-12Added methods related to cloud storage.
2011-06-06Delegate methods moved to formal protocol NSFileManagerDelegate Protocol.
2010-05-11Added symbols introduced in iOS 4.0.
2010-02-24Removed use of defaultManager from samples. Removed example code from deprecated methods.
2010-01-20Corrected description of init method to include compatibility information. Updated examples.
2009-11-17Clarified thread-safety issue.
2009-10-19Corrected description of contentsOfDirectoryAtURL: includingPropertiesForKeys:options: error:. Incorporated release notes.
2009-09-09Change name of a constants section.
2009-08-28Updated for OS X v10.6. Added new directory search methods. Added new file replace methods.
2009-05-26Updated for OS X v10.6. Added methods that use file system URLs instead of file paths.
2008-10-15Corrected typographical errors.
2007-12-11Corrected minor errors.
2007-10-31Made several minor corrections.
2007-03-12Updated to include API introduced in OS X v10.5.
2006-06-28Corrected typographical errors.
2006-05-23Corrected declarations for NSFileOwnerAccountName and NSFileGroupOwnerAccountName.

First publication of this content as a separate document.