Core Data Programming Guide does not include information about queue confinement
Originator: | quellish | ||
Number: | rdar://14310967 | Date Originated: | Sat, 29 Jun 2013 04:08:34 GMT |
Status: | Open | Resolved: | |
Product: | Documentation | Product Version: | |
Classification: | Reproducible: | Always |
Summary: iOS 5 introduced queue confinement for managing the concurrency of NSManagedObjectContexts. To use this functionality developers must submit blocks to the context using performBlock: or performBlockAndWait: . This is currently best documented in the iOS 5 release notes: http://developer.apple.com/library/ios/#releasenotes/General/WhatsNewIniOS/Articles/iOS5.html And in 2011 and 2012 WWDC Core Data sessions. Queue confinement is not covered at all in the Core Data Programming Guide section "Concurrency With Core Data" : https://developer.apple.com/library/mac/#documentation/cocoa/conceptual/CoreData/Articles/cdConcurrency.html This seems to be a major oversight as the new queue confinement pattern offers significant benefits over thread confinement, but developers are likely to overlook queue confinement due to it's absence from the programming guide. Documentation should include common use cases, correct and incorrect use, as well as information about safe and unsafe operations. Steps to Reproduce: Expected Results: Actual Results: Regression: Notes:
Comments
Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!