非推奨であることを示す

• http://stackoverflow.com/questions/12839517/detecting-deprecated-functions-in-c

によると：

• Doxygenの@deprecatedディレクティブで、非推奨を指示できる。
• GCCで __attribute__((__deprecated__)) で非推奨を指示できる。
• MSVCで __declspec(deprecated) で非推奨を指示できる。

次のマクロが載っている。

#ifdef _MSC_VER
#  define DEPRECATED __declspec(deprecated)
#elif defined(__GNUC__) | defined(__clang__)
#  define DEPRECATED __attribute__((__deprecated__))
#else
#  define DEPRECATED
#endif

//usage:
DEPRECATED void foo(int bar);

http://stackoverflow.com/questions/8044457/use-doxygen-to-document-a-function-that-is-sent-to-a-macro-c にも関連する話題がある。

だが、Doxygenのマークアップとコンパイラへの指示が同期している保証はない。現状、目視で確認するしか出来ない。

それと、@deprecated したときはその理由と代替処置を書いておかないと何のことか分からない。