SONAR-2952 add @since comments to new core metrics + remove dead code from jacoco plugin

1 files changed, 119 insertions, 4 deletions

diff --git a/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java b/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java
index c498bc00ca9..cccbdbcf5eb 100644
--- a/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java
+++ b/sonar-plugin-api/src/main/java/org/sonar/api/measures/CoreMetrics.java
@@ -608,7 +608,14 @@ public final class CoreMetrics {
   //
   //--------------------------------------------------------------------------------------------------------------------
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_COVERAGE_KEY = "it_coverage";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_COVERAGE = new Metric.Builder(IT_COVERAGE_KEY, "IT Coverage", Metric.ValueType.PERCENT)
     .setDescription("Coverage by integration tests")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -618,7 +625,14 @@ public final class CoreMetrics {
     .setBestValue(100.0)
     .create();
 
-public static final String NEW_IT_COVERAGE_KEY = "new_it_coverage";
+  /**
+   * @since 2.12
+   */
+  public static final String NEW_IT_COVERAGE_KEY = "new_it_coverage";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_COVERAGE = new Metric.Builder(NEW_IT_COVERAGE_KEY, "New IT coverage", Metric.ValueType.PERCENT)
     .setDescription("Integration Tests Coverage of new/changed code")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -628,8 +642,14 @@ public static final String NEW_IT_COVERAGE_KEY = "new_it_coverage";
     .setBestValue(100.0)
     .create();
 
-
+  /**
+   * @since 2.12
+   */
   public static final String IT_LINES_TO_COVER_KEY = "it_lines_to_cover";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_LINES_TO_COVER = new Metric.Builder(IT_LINES_TO_COVER_KEY, "IT Lines to cover", Metric.ValueType.INT)
     .setDescription("Lines to cover by Integration Tests")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -639,7 +659,14 @@ public static final String NEW_IT_COVERAGE_KEY = "new_it_coverage";
     .setHidden(true)
     .create();
 
-public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
+  /**
+   * @since 2.12
+   */
+  public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_LINES_TO_COVER = new Metric.Builder(NEW_IT_LINES_TO_COVER_KEY, "New lines to cover by IT", Metric.ValueType.INT)
     .setDescription("New lines to cover by Integration Tests")
     .setDirection(Metric.DIRECTION_WORST)
@@ -648,8 +675,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setFormula(new SumChildValuesFormula(false))
     .create();
 
-
+  /**
+   * @since 2.12
+   */
   public static final String IT_UNCOVERED_LINES_KEY = "it_uncovered_lines";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_UNCOVERED_LINES = new Metric.Builder(IT_UNCOVERED_LINES_KEY, "IT Uncovered lines", Metric.ValueType.INT)
     .setDescription("IT uncovered lines")
     .setDirection(Metric.DIRECTION_WORST)
@@ -658,7 +691,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setFormula(new SumChildValuesFormula(false))
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String NEW_IT_UNCOVERED_LINES_KEY = "new_it_uncovered_lines";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_UNCOVERED_LINES = new Metric.Builder(NEW_IT_UNCOVERED_LINES_KEY, "New uncovered lines by IT", Metric.ValueType.INT)
     .setDescription("New uncovered lines by Integration Tests")
     .setDirection(Metric.DIRECTION_WORST)
@@ -667,7 +707,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setBestValue(0.0)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_LINE_COVERAGE_KEY = "it_line_coverage";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_LINE_COVERAGE = new Metric.Builder(IT_LINE_COVERAGE_KEY, "IT Line coverage", Metric.ValueType.PERCENT)
     .setDescription("IT line coverage")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -675,7 +722,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setDomain(DOMAIN_INTEGRATION_TESTS)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String NEW_IT_LINE_COVERAGE_KEY = "new_it_line_coverage";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_LINE_COVERAGE = new Metric.Builder(NEW_IT_LINE_COVERAGE_KEY, "New line coverage by IT", Metric.ValueType.PERCENT)
     .setDescription("Line Coverage by Integration Tests of added/changed code")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -685,7 +739,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setDomain(DOMAIN_INTEGRATION_TESTS)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_COVERAGE_LINE_HITS_DATA_KEY = "it_coverage_line_hits_data";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_COVERAGE_LINE_HITS_DATA = new Metric.Builder(IT_COVERAGE_LINE_HITS_DATA_KEY, "IT Coverage hits data", Metric.ValueType.DATA)
     .setDescription("IT Code coverage line hits data")
     .setDirection(Metric.DIRECTION_NONE)
@@ -693,7 +754,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setDomain(DOMAIN_INTEGRATION_TESTS)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_CONDITIONS_TO_COVER_KEY = "it_conditions_to_cover";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_CONDITIONS_TO_COVER = new Metric.Builder(IT_CONDITIONS_TO_COVER_KEY, "IT Branches to cover", Metric.ValueType.INT)
     .setDescription("IT Conditions to cover")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -703,14 +771,28 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setHidden(true)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String NEW_IT_CONDITIONS_TO_COVER_KEY = "new_it_conditions_to_cover";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_CONDITIONS_TO_COVER = new Metric.Builder(NEW_IT_CONDITIONS_TO_COVER_KEY, "New conditions to cover by IT", Metric.ValueType.INT)
     .setDescription("New conditions to cover by Integration Tests")
     .setDomain(DOMAIN_INTEGRATION_TESTS)
     .setFormula(new SumChildValuesFormula(false))
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_UNCOVERED_CONDITIONS_KEY = "it_uncovered_conditions";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_UNCOVERED_CONDITIONS = new Metric.Builder(IT_UNCOVERED_CONDITIONS_KEY, "IT Uncovered branches", Metric.ValueType.INT)
     .setDescription("IT Uncovered conditions")
     .setDirection(Metric.DIRECTION_WORST)
@@ -718,7 +800,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setFormula(new SumChildValuesFormula(false))
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String NEW_IT_UNCOVERED_CONDITIONS_KEY = "new_it_uncovered_conditions";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_UNCOVERED_CONDITIONS = new Metric.Builder(NEW_IT_UNCOVERED_CONDITIONS_KEY, "New uncovered conditions by IT", Metric.ValueType.INT)
     .setDescription("New uncovered conditions by Integration Tests")
     .setDirection(Metric.DIRECTION_WORST)
@@ -727,7 +816,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setBestValue(0.0)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_BRANCH_COVERAGE_KEY = "it_branch_coverage";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_BRANCH_COVERAGE = new Metric.Builder(IT_BRANCH_COVERAGE_KEY, "IT Branch coverage", Metric.ValueType.PERCENT)
     .setDescription("IT Branch coverage")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -737,7 +833,14 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setBestValue(100.0)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String NEW_IT_BRANCH_COVERAGE_KEY = "new_it_branch_coverage";
+
+  /**
+   * @since 2.12
+   */
   public static final Metric NEW_IT_BRANCH_COVERAGE = new Metric.Builder(NEW_IT_BRANCH_COVERAGE_KEY, "New branch coverage by IT", Metric.ValueType.PERCENT)
     .setDescription("Branch coverage by Integration Tests of new/changed code")
     .setDirection(Metric.DIRECTION_BETTER)
@@ -747,14 +850,26 @@ public static final String NEW_IT_LINES_TO_COVER_KEY = "new_it_lines_to_cover";
     .setBestValue(100.0)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_CONDITIONS_BY_LINE_KEY = "it_conditions_by_line";
 
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_CONDITIONS_BY_LINE = new Metric.Builder(IT_CONDITIONS_BY_LINE_KEY, "IT Branches by line", Metric.ValueType.DATA)
     .setDomain(DOMAIN_INTEGRATION_TESTS)
     .create();
 
+  /**
+   * @since 2.12
+   */
   public static final String IT_COVERED_CONDITIONS_BY_LINE_KEY = "it_covered_conditions_by_line";
 
+  /**
+   * @since 2.12
+   */
   public static final Metric IT_COVERED_CONDITIONS_BY_LINE = new Metric.Builder(IT_COVERED_CONDITIONS_BY_LINE_KEY, "IT Covered branches by line", Metric.ValueType.DATA)
     .setDomain(DOMAIN_INTEGRATION_TESTS)
     .create();