NSDataReadingMappedIfSafe needs clarification in documentation

Originator:motownavi
Number:rdar://12254262 Date Originated:07-Sep-2012 11:29 AM
Status:Open Resolved:
Product:Documentation Product Version:all
Classification:UI/Usability Reproducible:Not Applicable
 
The documentation for NSDataReadingMappedIfSafe says:

"A hint indicating the file should be mapped into virtual memory, if possible and safe."

It does not define what "safe" means.

Quinn says that "'safe' means 'if the volume containing this file goes away, the system is toast.'  On iOS this translates to 'true'.  On Mac OS X it effectively means 'is on the root volume'."

Please add this (or an equivalent) definition to the documentation and header file for NSData. Developers shouldn't have to guess as to the meaning of vague words in documentation.

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!