FROM : j o a r
DATE : Thu May 08 17:30:54 2008
On May 8, 2008, at 8:16 AM, Christiaan Hofman wrote:
> Sure, but that's not what I'm saying. I don't disagree that I was
> wrong and too quick to answer. I'm just explaining what led me to
> this confusion. Also this very sentence is a case in point: here and
> at several p[laces in these docs the word "create" is used to
> describe making an object that you own. So it's at least counter-
> intuitive to use the word "new" to indicate it in a method name.
It might possibly be a bit confusing that "create" is a memory
management keyword in CoreFoundation, but the documentation should
never be mixed up on that topic.
> E.g. initWithObjects:copyItems:. I couldn't find it in the ownership
> management docs, nor in the description of the method itself. In
> fact, that description might make you believe that the objects from
> the array are copied, and therefore should be released by you!
Whenever you find specific places where the existing documentation is
incorrect, or where additional documentation is required, please file
bug reports / enhancement requests:
<http://developer.apple.com/bugreporter/>
j o a r
DATE : Thu May 08 17:30:54 2008
On May 8, 2008, at 8:16 AM, Christiaan Hofman wrote:
> Sure, but that's not what I'm saying. I don't disagree that I was
> wrong and too quick to answer. I'm just explaining what led me to
> this confusion. Also this very sentence is a case in point: here and
> at several p[laces in these docs the word "create" is used to
> describe making an object that you own. So it's at least counter-
> intuitive to use the word "new" to indicate it in a method name.
It might possibly be a bit confusing that "create" is a memory
management keyword in CoreFoundation, but the documentation should
never be mixed up on that topic.
> E.g. initWithObjects:copyItems:. I couldn't find it in the ownership
> management docs, nor in the description of the method itself. In
> fact, that description might make you believe that the objects from
> the array are copied, and therefore should be released by you!
Whenever you find specific places where the existing documentation is
incorrect, or where additional documentation is required, please file
bug reports / enhancement requests:
<http://developer.apple.com/bugreporter/>
j o a r






Cocoa mail archive

