On 25 Jun 2010, at 08:12, Scott Anguish wrote:

>> 
>> I was deterred to do this after reading this in the documentation for 
>> -arrangedObjects
>> 
>> -----
>> Special Considerations
>> Prior to Mac OS X v10.5 this method returned an opaque root node 
>> representing all the currently displayed objects. This method should be used 
>> for binding, no assumption should be made about what methods this object 
>> supports.
>> -----
>> 
>> I feel a little stupid as it's obviously referring to prior 10.5, although 
>> the language could be clearer.
>> 
> 
> Something along the lines of
> 
> 
> Special Considerations
> Prior to Mac OS X v10.5 this method returned an opaque root node representing 
> all the currently displayed objects, suitable for use with Cocoa bindings. No 
> assumption should be made about what methods this opaque object supports.
> 
> Ties the consideration to the version better..
> 
> Would that make it clearer for you and others?
> 
It would help a lot if the comment from the 10.5 header file was also included:

From Mac OS X v10.5 on this method returns a proxy for the root tree node that 
responds to -childNodes and -descendantNodeAtIndexPath:(NSIndexPath *)indexPath

Regards

Jonathan Mitchell

Developer
Mugginsoft LLP
http://www.mugginsoft.com

_______________________________________________

Cocoa-dev mailing list ([email protected])

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to [email protected]

Reply via email to