NSMethodSignature and @encode

Here's the text of a bug I just filed against Apple's Cocoa docs:

Currently, NSMethodSignature's -getArgumentTypeAtIndex: method is very vaguely documented. In particular the docs say "Returns the type encoding for the argument at a given index" about its return value. It isn't really obvious that by "encoding" not just an arbitrary way to encode data is meant (like the _NSObjCValueType enum defined in NSInvocation.h, which is usually used along with NSMethodSignature), but rather Objective C's @encode() method of encoding types.

To help clarify this, it would help if the docs for -getArgumentTypeAtIndex: and -methodReturnType (which suffers the same issue) mentioned @encode and linked to the page where the possible return values are documented.

So, in short, this posting is a reminder to myself about the return type of -getArgumentTypeAtIndex: and -methodReturnType

Reader Comments: (RSS Feed)

Harry writes: The appropriate documentation seems to have moved to http://developer.apple.com/mac/library/documentation/Cocoa/Conceptual/ObjCRuntimeGuide/Articles/ocrtTypeEncodings.html#//apple_ref/doc/uid/TP40008048-CH100-SW1.

Or E-Mail Uli privately.