RFR: 8331051: Add an `@since` checker test for `java.base` module [v15]

[Nizar Benalla]

> This checker checks the values of the `@since` tag found in the documentation comment for an element against the release in which the element first appeared.
> 
> Real since value of an API element is computed as the oldest release in which the given API element was introduced. That is:
> - for modules, classes and interfaces, the release in which the element with the given qualified name was introduced
> - for constructors, the release in which the constructor with the given VM descriptor was introduced
> - for methods and fields, the release in which the given method or field with the given VM descriptor became a member of its enclosing class or interface, whether direct or inherited
> 
> Effective since value of an API element is computed as follows:
> - if the given element has a `@since` tag in its javadoc, it is used
> - in all other cases, return the effective since value of the enclosing element
> 
> The since checker verifies that for every API element, the real since value and the effective since value are the same, and reports an error if they are not.
> 
> Preview method are handled as per JEP 12, if `@PreviewFeature` is used consistently going forward then the checker doesn't need to be updated with every release. The checker has explicit knowledge of preview elements that came before `JDK 14` because they weren't marked in a machine understandable way and preview elements that came before `JDK 17` that didn't have `@PreviewFeature`.
> 
> Important note : We only check code written since `JDK 9` as the releases used to determine the expected value of `@since` tags are taken from the historical data built into `javac` which only goes back that far
> 
> The intial comment at the beginning of `SinceChecker.java` holds more information into the program.
> 
> I already have filed issues and fixed some wrong tags like in #18640, #18032, #18030, #18055, #18373, #18954, #18972.

Nizar Benalla has updated the pull request with a new target base due to a merge or a rebase. The pull request now contains 31 commits:

 - exclude list is now module specific
 - remove empty if statement, debugging showed the condition is never true
 - Merge remote-tracking branch 'upstream/master' into source-based-since-checker
 - Change "found" to "should be" in the error messages
 - Merge remote-tracking branch 'upstream/master' into source-based-since-checker
 - avoid using `continue`, fix mistake in last commit
 - extend SinceChecker to now skip some packages
 - Merge remote-tracking branch 'upstream/master' into source-based-since-checker
 - Merge remote-tracking branch 'upstream/master' into source-based-since-checker
 - Merge remote-tracking branch 'upstream/master' into source-based-since-checker
 - ... and 21 more: https://git.openjdk.org/jdk/compare/3c22d83c...62a34064

-------------

Changes: https://git.openjdk.org/jdk/pull/18934/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=18934&range=14
  Stats: 983 lines in 3 files changed: 981 ins; 0 del; 2 mod
  Patch: https://git.openjdk.org/jdk/pull/18934.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/18934/head:pull/18934

PR: https://git.openjdk.org/jdk/pull/18934