Add explicit @deprecation annotation next to the javadoc deprecation flag
Move @Deprecated flag below java doc for readability