* An import declaration is {@linkplain Kind#isPersistent() persistent}. */ @@ -91,7 +91,7 @@ * annotation interfaces -- see {@link jdk.jshell.Snippet.SubKind} to * differentiate. * - * @jls 7.6: TypeDeclaration. + * @jls 7.6 Top Level Type Declarations *
* A type declaration is {@linkplain Kind#isPersistent() persistent}. */ @@ -101,7 +101,7 @@ * A method declaration. * The snippet is an instance of {@link jdk.jshell.MethodSnippet}. * - * @jls 8.4: MethodDeclaration. + * @jls 8.4 Method Declarations *
* A method declaration is {@linkplain Kind#isPersistent() persistent}. */ @@ -116,7 +116,7 @@ * variable representing an expression -- see * {@link jdk.jshell.Snippet.SubKind}to differentiate. * - * @jls 8.3: FieldDeclaration. + * @jls 8.3 Field Declarations *
* A variable declaration is {@linkplain Kind#isPersistent() persistent}. */ @@ -133,7 +133,7 @@ * All other expression forms (operators, method calls, ...) generate a * scratch variable and so are instead of the VAR Kind. * - * @jls 15: Expression. + * @jls 15 Expressions */ EXPRESSION(false), @@ -141,7 +141,7 @@ * A statement. * The snippet is an instance of {@link jdk.jshell.StatementSnippet}. * - * @jls 14.5: Statement. + * @jls 14.5 Statements */ STATEMENT(false), @@ -185,99 +185,97 @@ /** * Single-Type-Import Declaration. * An import declaration of a single type. - * @jls 7.5.1 SingleTypeImportDeclaration. + * @jls 7.5.1 Single-Type-Import Declarations */ SINGLE_TYPE_IMPORT_SUBKIND(Kind.IMPORT), /** * Type-Import-on-Demand Declaration. * A non-static "star" import. - * @jls 7.5.2. TypeImportOnDemandDeclaration. + * @jls 7.5.2 Type-Import-on-Demand Declarations */ TYPE_IMPORT_ON_DEMAND_SUBKIND(Kind.IMPORT), /** * Single-Static-Import Declaration. * An import of a static member. - * @jls 7.5.3 Single-Static-Import. + * @jls 7.5.3 Single-Static-Import Declarations */ SINGLE_STATIC_IMPORT_SUBKIND(Kind.IMPORT), /** * Static-Import-on-Demand Declaration. * A static "star" import of all static members of a named type. - * @jls 7.5.4. Static-Import-on-Demand Static "star" import. + * @jls 7.5.4 Static-Import-on-Demand Declarations */ STATIC_IMPORT_ON_DEMAND_SUBKIND(Kind.IMPORT), /** * A class declaration. * A {@code SubKind} of {@link Kind#TYPE_DECL}. - * @jls 8.1. NormalClassDeclaration. + * @jls 8.1 Class Declarations */ CLASS_SUBKIND(Kind.TYPE_DECL), /** * An interface declaration. * A {@code SubKind} of {@link Kind#TYPE_DECL}. - * @jls 9.1. NormalInterfaceDeclaration. + * @jls 9.1 Interface Declarations */ INTERFACE_SUBKIND(Kind.TYPE_DECL), /** * An enum declaration. * A {@code SubKind} of {@link Kind#TYPE_DECL}. - * @jls 8.9. EnumDeclaration. + * @jls 8.9 Enum Types */ ENUM_SUBKIND(Kind.TYPE_DECL), /** * An annotation interface declaration. A {@code SubKind} of * {@link Kind#TYPE_DECL}. - * @jls 9.6. AnnotationTypeDeclaration. + * @jls 9.6 Annotation Types */ ANNOTATION_TYPE_SUBKIND(Kind.TYPE_DECL), /** * A method. The only {@code SubKind} for {@link Kind#METHOD}. - * @jls 8.4. MethodDeclaration. + * @jls 8.4 Method Declarations */ METHOD_SUBKIND(Kind.METHOD), /** * A variable declaration without initializer. * A {@code SubKind} of {@link Kind#VAR}. - * @jls 8.3. VariableDeclarator without VariableInitializer in - * FieldDeclaration. + * @jls 8.3 Field Declarations */ VAR_DECLARATION_SUBKIND(Kind.VAR, true, true), /** * A variable declaration with an initializer expression. A * {@code SubKind} of {@link Kind#VAR}. - * @jls 8.3. VariableDeclarator with VariableInitializer in - * FieldDeclaration. + * @jls 8.3 Field Declarations */ VAR_DECLARATION_WITH_INITIALIZER_SUBKIND(Kind.VAR, true, true), /** * An expression whose value has been stored in a temporary variable. A * {@code SubKind} of {@link Kind#VAR}. - * @jls 15. Primary. + * @jls 15 Expressions */ TEMP_VAR_EXPRESSION_SUBKIND(Kind.VAR, true, true), /** * A simple variable reference expression. A {@code SubKind} of * {@link Kind#EXPRESSION}. - * @jls 15.11. Field Access as 3.8. Identifier. + * @jls 15.11 Field Access Expressions */ VAR_VALUE_SUBKIND(Kind.EXPRESSION, true, true), /** * An assignment expression. A {@code SubKind} of * {@link Kind#EXPRESSION}. - * @jls 15.26. Assignment. + * @jls 15.26 Assignment Operators */ ASSIGNMENT_SUBKIND(Kind.EXPRESSION, true, true), @@ -289,7 +287,7 @@ /** * A statement. The only {@code SubKind} for {@link Kind#STATEMENT}. - * @jls 14.5. Statement. + * @jls 14.5 Statements */ STATEMENT_SUBKIND(Kind.STATEMENT, true, false), --- old/src/jdk.jshell/share/classes/jdk/jshell/StatementSnippet.java 2019-05-19 12:16:50.421761266 -0700 +++ new/src/jdk.jshell/share/classes/jdk/jshell/StatementSnippet.java 2019-05-19 12:16:49.985761266 -0700 @@ -36,7 +36,7 @@ * and thus is thread-safe. * * @since 9 - * @jls 14.5: Statement. + * @jls 14.5 Statements */ public class StatementSnippet extends Snippet { --- old/src/jdk.jshell/share/classes/jdk/jshell/VarSnippet.java 2019-05-19 12:16:51.549761266 -0700 +++ new/src/jdk.jshell/share/classes/jdk/jshell/VarSnippet.java 2019-05-19 12:16:51.117761266 -0700 @@ -39,7 +39,7 @@ * and thus is thread-safe. * * @since 9 - * @jls 8.3: FieldDeclaration. + * @jls 8.3 Field Declarations */ public class VarSnippet extends DeclarationSnippet {