Discouraged

@Retention(value = SOURCE)  @Target(value = ) annotation Discouraged

Denotes that the annotated element, while not disallowed or deprecated, is one that programmers are generally discouraged from using.

Example:

 @Discouraged(message = "It is much more efficient to retrieve "
                          + "resources by identifier than by name.")
 public void getValue(String name) {
     ...
 }

Summary

Public methods

public abstract String message()