On 26.08.2016 at 17:24 Keary Suska wrote:

>> On Aug 26, 2016, at 8:36 AM, Andreas Falkenhahn <andr...@falkenhahn.com> 
>> wrote:

>> Thanks, that's what I was looking for. I just wish such essential 
>> information wouldn't
>> be hidden in the accompanying documentation. This should really be mentioned 
>> in the
>> documentation of runModalForWindow() or stopModal()/stopModalWithCode() 
>> IMHO. Here
>> it is again:

>> "It is important to call orderOut: when finished with your dialog, or it is 
>> not removed
>> from the screen."

> Apple used to cross reference the documentation, but apparently do
> not anymore. May be worth filing a radar on the subject.

I think I'll do so. The class documentation really leaves a lot to be desired.
I think the DRY paradigm shouldn't be applied to documentation :) It doesn't 
hurt to
include such essential information in both documents, class and programming 
reference.

-- 
Best regards,
 Andreas Falkenhahn                            mailto:andr...@falkenhahn.com

_______________________________________________

Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)

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:
https://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to arch...@mail-archive.com

Reply via email to