Missing documentation: NSPersistenceStoreCordinator.replacePersistentStore

Originator:vytis.s.lt
Number:rdar://38789503 Date Originated:23-Mar-2018 12:15 PM
Status:Open Resolved:
Product:iOS + SDK Product Version:iOS11
Classification:Enhancement Reproducible:Always
 
Summary:
There is only a brief description of what this method does:
https://developer.apple.com/documentation/coredata/nspersistentstorecoordinator/1468917-replacepersistentstore

There is a similar-sounding method NSPersistenceStoreCordinator.migratePersistentStore that has more explanation, but it’s hard to know which one to choose sometimes.

Steps to Reproduce:
Open documentation at https://developer.apple.com/documentation/coredata/nspersistentstorecoordinator/1468917-replacepersistentstore

Expected Results:
Read up of what this method does and when I should use it

Actual Results:
Almost blank page with no useful information

Version:
iOS11

Notes:
As an anecdote, in out app replacing NSPersistenceStoreCordinator.migratePersistentStore with NSPersistenceStoreCordinator.replacePersistentStore reduced the duration of the operation from 2,5 mins to 9 seconds.

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!