Annotation Type ToRemove


  • public @interface ToRemove
    Indicates an intention to drop certain code element. Version field helps to capture the moment we became aware of the intention, NOT the moment we would put it into life. Stuff annotated with this annotation would be removed in the next release (including milestones) after specified version the earliest.

    For example, if there's ToRemove annotation with version = 2018.2, the code annotated may be deleted not earlier than 2018.2 is out and 2018.3 work has begun.

    IMPORTANT: The version doesn't indicate release we would remove code element in. Nor it mandates removal of the element in the release next to the one specified, though it is desirable and has to be anticipated by clients. There might be certain cases (like long-lived APIs) that require extended to-remove timeframe.

    NOTE, as it's just an indicator of the moment we decided to drop certain code element, there's no reason to update version field for elements that have not been removed for a few release cycles. PLEASE LEAVE IT INTACT.

    • Required Element Summary

      Required Elements 
      Modifier and Type Required Element Description
      double version  
    • Element Detail

      • version

        double version