deprecatedメソッドにコメントを追加する

Question

私はいくつかのメソッドを廃止したいと思います。

私は次のように次の操作を行います。

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

これは動作しますが、どのように私はメッセージを追加するには？ "代わりにmethodyのXYZを使用する" ような何か...私はあなたがドキュメントジェネレータを使用する必要があると思う

おかげ

Answer 1

ニコラススミスがコメントで述べたように。解決策は以下のとおりです。

__deprecated_msg("use method x instead") 

いうより：

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

彼らが本当にフードの下と同じだが、最初のものはある

が

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

Answer 2

：Doxygenで、Headerdocなど

私はあなた Appledocお勧めします

。使いやすく、文書化されており、マークダウンスタイルが有効です。

Answer 3

私はこれを使用する傾向がありますもう少しクリアです。