test/jdk/tools/sincechecker/SinceChecker.java

*** 99,20 ***
  note: The `<unique-Element-ID>` for methods looks like
        `method: <erased-return-descriptor> <binary-name-of-enclosing-class>.<method-name>(<ParameterDescriptor>)`.
  it is somewhat inspired from the VM Method Descriptors. But we use the erased return so that methods
  that were later generified remain the same.
  
  usage: the checker is run from a module specific test
!         `@run main SinceChecker <moduleName> [--exclude package1,package2 | --exclude package1 package2]`
  */
  
  public class SinceChecker {
      private final Map<String, Set<String>> LEGACY_PREVIEW_METHODS = new HashMap<>();
      private final Map<String, IntroducedIn> classDictionary = new HashMap<>();
      private final JavaCompiler tool;
      private int errorCount = 0;
  
      // packages to skip during the test
      private static final Set<String> EXCLUDE_LIST = new HashSet<>();
  
      public static class IntroducedIn {
          public String introducedPreview;
--- 99,29 ---
  note: The `<unique-Element-ID>` for methods looks like
        `method: <erased-return-descriptor> <binary-name-of-enclosing-class>.<method-name>(<ParameterDescriptor>)`.
  it is somewhat inspired from the VM Method Descriptors. But we use the erased return so that methods
  that were later generified remain the same.
  
+ To help projects still in development, unsure of actual `@since` tag value, one may want to use token name instead of continuely
+ updating the current version since tags. For example, `@since LongRunningProjectName`. The option `--ignoreSince` maybe used to
+ ignore these tags (`--ignoreSince LongRunningProjectName`). Maybe be specified multiple times.
+ 
  usage: the checker is run from a module specific test
!         `@run main SinceChecker <moduleName> [--ignoreSince <string>] [--exclude package1,package2 | --exclude package1 package2]`
  */
  
  public class SinceChecker {
      private final Map<String, Set<String>> LEGACY_PREVIEW_METHODS = new HashMap<>();
      private final Map<String, IntroducedIn> classDictionary = new HashMap<>();
      private final JavaCompiler tool;
      private int errorCount = 0;
  
+     // Ignored since tags
+     private static final Set<String> IGNORE_SINCE = new HashSet<>();
+     // Simply replace ignored since tags with the latest version
+     private static final Version     IGNORE_VERSION = Version.parse(Integer.toString(Runtime.version().major()));
+ 
      // packages to skip during the test
      private static final Set<String> EXCLUDE_LIST = new HashSet<>();
  
      public static class IntroducedIn {
          public String introducedPreview;

*** 125,11 ***
          }
          String moduleName = args[0];
          boolean excludeFlag = false;
  
          for (int i = 1; i < args.length; i++) {
!             if ("--exclude".equals(args[i])) {
                  excludeFlag = true;
                  continue;
              }
  
              if (excludeFlag) {
--- 134,15 ---
          }
          String moduleName = args[0];
          boolean excludeFlag = false;
  
          for (int i = 1; i < args.length; i++) {
!             if ("--ignoreSince".equals(args[i])) {
+                 i++;
+                 IGNORE_SINCE.add("@since " + args[i]);
+             }
+             else if ("--exclude".equals(args[i])) {
                  excludeFlag = true;
                  continue;
              }
  
              if (excludeFlag) {

*** 450,10 ***
--- 463,15 ---
          String position = javadocHelper.getElementPosition(uniqueId);
          checkEquals(position, sinceVersion, realMappedVersion, uniqueId);
      }
  
      private Version extractSinceVersionFromText(String documentation) {
+         for (String ignoreSince : IGNORE_SINCE) {
+             if (documentation.contains(ignoreSince)) {
+                 return IGNORE_VERSION;
+             }
+         }
          Pattern pattern = Pattern.compile("@since\\s+(\\d+(?:\\.\\d+)?)");
          Matcher matcher = pattern.matcher(documentation);
          if (matcher.find()) {
              String versionString = matcher.group(1);
              try {