JDK-8277303 : Terminology mismatch between JLS17-3.9 and SE17's javax.lang.model.SourceVersion method specs
  • Type: Bug
  • Component: core-libs
  • Sub-Component: javax.lang.model
  • Affected Version: 17
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2021-11-16
  • Updated: 2024-09-11
  • Resolved: 2021-11-17
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 18
18 b25Fixed
Related Reports
CSR :  
JDK-8277325 - Terminology mismatch between JLS17-3.9 and SE17's javax.lang.model.SourceVersion method specs
Relates :  
JDK-8339852 - Fix typos in java.compiler documentation
Description
SE17's specification of javax.lang.model.SourceVersion methods
https://docs.oracle.com/en/java/javase/17/docs/api/java.compiler/javax/lang/model/SourceVersion.html
uses "restricted keywords and restricted identifiers" terms.
Methods that use these terms refer to Java Language Specification.

However JLS17 doesn't mention "restricted keywords" or "restricted identifiers" any more; instead the new term seems to be "contextual keywords"
https://docs.oracle.com/javase/specs/jls/se17/html/jls-3.html#jls-3.9

"restricted keywords" / "restricted identifiers" are present in JLS16
https://docs.oracle.com/javase/specs/jls/se16/html/jls-3.html#jls-3.9

"restricted keywords" first appeared in JLS9 
https://docs.oracle.com/javase/specs/jls/se9/html/jls-3.html#jls-3.9
Comments
Changeset: 007ad7c7 Author: Joe Darcy <darcy@openjdk.org> Date: 2021-11-17 20:23:43 +0000 URL: https://git.openjdk.java.net/jdk/commit/007ad7c77c6277ce733386b4402b787d81dd41cf
17-11-2021