adding comment to deprecated method

Question

I have a couple of methods that I want to deprecate.

I do this with the following:

+(void)myMethod:(NSString*)abc __deprecated;

This works, but how do I add a message? Something like "use methody xyz instead"...

Thanks

Answer 1

As Nicholas Smith mentioned in the comments. The solution is:

__attribute((deprecated("use x method")))

if you want you can also use the less convoluted:

__deprecated_msg("use x method")

Answer 2

I would tend to use this:

__deprecated_msg("use method x instead")

rather than:

__attribute((deprecated("use method x instead")))

They're really the same under the hood, but first one is a bit more clear.

Answer 3

- FOR SWIFT CODE:

Put this right above the method: @available(*, deprecated: <#Version#>, message: <#Message#>)

example:

@available(*, deprecated: 11, message: "Use color assets instead")
public struct ColorPaletteItemResource: ColorPaletteItemResourceType {
    ...
}