May I suggest to use @deprecated annotation or javadoc annotation and a simple description for the reason about the deprecation ?