Re: NSFileManager createDirectory… confusing docs.
Re: NSFileManager createDirectory… confusing docs.
- Subject: Re: NSFileManager createDirectory… confusing docs.
- From: John Joyce <email@hidden>
- Date: Sun, 24 Feb 2013 07:55:50 +0900
On Feb 24, 2013, at 3:45 AM, Quincey Morris <email@hidden> wrote:
> On Feb 23, 2013, at 07:57 , John Joyce <email@hidden> wrote:
>
>> The docs do not seem clear on this. (not to me anyway).
>
> Yes, they're not clear on this.
>
>> If the directory you are creating is also considered an "intermediate parent" directory, that is just confusing.
>
> Presumably, it seemed like a good idea to someone at some time to treat the leaf directory consistently with the intermediate directories, when 'withIntermediateDirectories:' is YES.
>
> Or perhaps this was originally just a bug that was overlooked.
I'm going with this one, but as a documentation bug.
>
>> Can anybody explain to me how this makes any sense?
>
> It makes sense as a historical behavioral artifact, but changing the behavior of the existing API might break existing code in hard-to-debug ways.
True, but that generally means a new method or a set of release notes when it changes.
>
> I'd suggest you submit documentation feedback reporting the confusing description. It's likely not a high-priority issue, but OTOH it wouldn't be hard to improve the documentation.
I have sent this. On multiple occasions, including yesterday.
>
_______________________________________________
Cocoa-dev mailing list (email@hidden)
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:
This email sent to email@hidden