-[UIView mask] documentation update

Number:rdar://47809462 Date Originated:04-Feb-2019 08:46 PM
Status:Open Resolved:
Product:Documentation Product Version:12.0
Classification:UI/Usability Reproducible:Always
The documentation for UIView’s mask property is lacking in some key areas and could use an update. There should be 2 main points added to the docs in helping with usage:

1. The masking view cannot be referenced by anything other than the view it will be masking.
2. The mask view cannot be part of the view hierarchy, and thus cannot be manipulated with Auto Layout.

#1 is the reason for #2, but with so many views getting converted to Auto Layout it bears calling out.

Steps to Reproduce:
Read the docs for UIView’s mask property. They are located here: https://developer.apple.com/documentation/uikit/uiview/1622557-mask

Expected Results:
It should tell me how to use the property

Actual Results:
I had to figure things out for myself


I wrote this up as a blog post available at https://jsorge.net/2019/02/04/uiview-mask-safety-scissors


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!