NSFontManager documentation doesn't indicate changeAttributes: will be sent to target

Originator:jalkut
Number:rdar://20998747 Date Originated:18-May-2015 11:20 AM
Status:Open Resolved:
Product:Documentation Product Version:
Classification: Reproducible:
 
Summary:
The documentation for NSFontManager's explicit -target attribute indicates only that -action will be sent to the specified receiver. In fact, in addition to the -action method, the receiver will also be unconditionally sent "changeAttributes:". If the receiver doesn't implement changeAttributes:, an exception will be thrown.

There is currently no way for a developer who is using NSFontManager to know that they must implement -changeAttributes, short of discovering it because of the exception being thrown at runtime during testing or live use of the app.

There is a brief mention in the 10.5 AppKit release notes:

The -changeAttributes: action message is now targeted to [NSFontManager target].

The main documentation for NSFontManager should be updated so that it's made clear that an object set as the "target" for an NSFontManager is expected to implement both the specified action (changeFont: by default) AND changeAttributes:.

Steps to Reproduce:


Expected Results:


Actual Results:


Version:


Notes:


Configuration:


Attachments:

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!