This Annex to the Java SE 9 Specification contains the Java SE 9 Editions of the Java Language Specification (JLS) and the Java Virtual Machine Specification (JVMS).

The Java SE 9 Editions include all changes made to the JLS and JVMS since the Java SE 8 Editions, that is, since the Final Release of JSR 337. The changes comprise:

• Changes from the Specification of JSR 376 Java Platform Module System.

• Changes to specify small features that are not the subject of a Component JSR Specification:

  • JEP 193 Variable Handles (8131749, 8131750)
  • JEP 211 Elide Deprecation Warnings on Import Statements (8065613)
  • JEP 213 Milling Project Coin (8047159, 8065600, 8073593, 8065599, 8072872)
  • JEP 277 Enhanced Deprecation (8145716).

• Corrections and clarifications made to the Final Release of JSR 337 by the Maintenance Release of JSR 337 in March 2015, and then made to the Maintenance Release of JSR 337 by this Final Release of JSR 379 in September 2017.

  Informative background is available in the JDK Bug System for the corrections and clarifications made in March 2015 (JLS, JVMS) and September 2017 (JLS, JVMS).

The changes are highlighted with change bars and colorful text, as follows:

• Dark blue text indicates changes from JSR 376.
• Bright blue text indicates a modification of material in the Java SE 8 Edition, either to specify a small feature or to make a correction or clarification.
• Red text indicates new material in the Java SE 9 Edition, either to specify a small feature or to make a correction or clarification.