Documentation on -[NSApplication setActivationPolicy:] is out of date

Originator:peter.maurer
Number:rdar://28686641 Date Originated:2016-10-09
Status:Open Resolved:
Product:Documentation Product Version:
Classification: Reproducible:
 
As of Xcode 8.0, the API reference states the following:

"Currently, NSApplicationActivationPolicyNone and NSApplicationActivationPolicyAccessory may be changed to NSApplicationActivationPolicyRegular, but other modifications are not supported."

NSApplication.h, on the other hand, has more up-to-date information:

"In OS X 10.9, any policy may be set; prior to 10.9, the activation policy may be changed to NSApplicationActivationPolicyProhibited or NSApplicationActivationPolicyRegular, but may not be changed to NSApplicationActivationPolicyAccessory."

The change in OS X 10.9 is pretty significant for apps that can switch between being a standard Dock app and living in the menu bar, for example, as it means we don't have to specify LSUIElement=1 and relaunch when removing ourselves from the Dock anymore. So it would be nice if this change got documented properly.

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!