Como sinalizo um método como obsoleto no Objective-C 2.0?

Faço parte de uma equipe que desenvolve um aplicativo para iPad bastante grande e, como resultado, criamos muitas classes diferentes. O problema é que alguns dos métodos agora estão praticamente obsoletos e eu não quero removê-los ainda, pois sei que algumas partes do sistema geral usam os métodos ... mas existem variantes melhores (mais recentes) disponíveis que devem ser usadas em vez disso (alguns dos antigos chamam de novos, mas a interface geral da classe está ficando bagunçada).

Existe uma maneira em que eu possa marcar certos métodos como depreciados (como @deprecatedem Java e [Obsolete].NET).

Vejo que a Apple usa o Availability.he possui tags como

__OSX_AVAILABLE_BUT_DEPRECATED(__MAC_NA,__MAC_NA,__IPHONE_2_0,__IPHONE_3_0);

... é a única maneira de fazê-lo (+ a App Store é segura para fazer isso?) ou existem alternativas que sinalizem um aviso no Xcode?

Sintaxe de reprovação

A sintaxe é fornecida para marcar métodos como obsoletos:

@interface SomeClass
-method __attribute__((deprecated));
@end

ou:

#include <AvailabilityMacros.h>
@interface SomeClass
-method DEPRECATED_ATTRIBUTE;  // or some other deployment-target-specific macro
@end

IMHO, é mais fácil escrever __ obsoleto:

- (void)myDeprecatedMethod __deprecated;
- (int)methodNameDeprecated:(int)param __deprecated;

Funciona também nas aulas

__deprecated
@interface MyDeprecatedClass

  // ... some properties and methods ...

@end

Se você deseja enviar uma mensagem adicional com o sinalizador de descontinuação, use os seguintes sinalizadores.

@property (strong, nonatomic) NSString *catName
                    __deprecated_msg("use name instead.");

//  -- Or -- 
@property (strong, nonatomic) NSString *catName
                    DEPRECATED_MSG_ATTRIBUTE("use name instead.");

//  -- Or -- 
@property (strong, nonatomic) NSString *catName
                    __attribute__((deprecated("use name instead.")));

Usando os sinalizadores mencionados acima, você pode dizer por que está descontinuando ou qual o método que o desenvolvedor deve usar no futuro.

Para marcar um método como obsoleto, use __attribute __ ((obsoleto ("Sua mensagem vai aqui"))))

Um exemplo prático, de Mantle

@interface NSValueTransformer (UnavailableMTLPredefinedTransformerAdditions)

+ (NSValueTransformer *)mtl_externalRepresentationTransformerWithModelClass:(Class)modelClass __attribute__((deprecated("Replaced by +mtl_JSONDictionaryTransformerWithModelClass:")));
+ (NSValueTransformer *)mtl_externalRepresentationArrayTransformerWithModelClass:(Class)modelClass __attribute__((deprecated("Replaced by +mtl_JSONArrayTransformerWithModelClass:")));

@end

Use o deprecatedatributo:

- (int)bar: (int)x __attribute__((deprecated));