8224175: Fix inconsistencies in @jls and @jvms tags

Reviewed-by: jjg, rfield
This commit is contained in:
Joe Darcy 2019-05-20 17:29:44 -07:00
parent 37572de2a1
commit 6930e80c31
29 changed files with 108 additions and 109 deletions

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -356,7 +356,7 @@ public final class Byte extends Number implements Comparable<Byte> {
/** /**
* Returns the value of this {@code Byte} as a {@code short} after * Returns the value of this {@code Byte} as a {@code short} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public short shortValue() { public short shortValue() {
return (short)value; return (short)value;
@ -365,7 +365,7 @@ public final class Byte extends Number implements Comparable<Byte> {
/** /**
* Returns the value of this {@code Byte} as an {@code int} after * Returns the value of this {@code Byte} as an {@code int} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public int intValue() { public int intValue() {
return (int)value; return (int)value;
@ -374,7 +374,7 @@ public final class Byte extends Number implements Comparable<Byte> {
/** /**
* Returns the value of this {@code Byte} as a {@code long} after * Returns the value of this {@code Byte} as a {@code long} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public long longValue() { public long longValue() {
return (long)value; return (long)value;
@ -383,7 +383,7 @@ public final class Byte extends Number implements Comparable<Byte> {
/** /**
* Returns the value of this {@code Byte} as a {@code float} after * Returns the value of this {@code Byte} as a {@code float} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public float floatValue() { public float floatValue() {
return (float)value; return (float)value;
@ -392,7 +392,7 @@ public final class Byte extends Number implements Comparable<Byte> {
/** /**
* Returns the value of this {@code Byte} as a {@code double} * Returns the value of this {@code Byte} as a {@code double}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public double doubleValue() { public double doubleValue() {
return (double)value; return (double)value;

View File

@ -3910,7 +3910,8 @@ public final class Class<T> implements java.io.Serializable,
* SecurityManager#checkPackageAccess s.checkPackageAccess()} * SecurityManager#checkPackageAccess s.checkPackageAccess()}
* denies access to the package of the returned class * denies access to the package of the returned class
* @since 11 * @since 11
* @jvms 4.7.28 and 4.7.29 NestHost and NestMembers attributes * @jvms 4.7.28 The {@code NestHost} Attribute
* @jvms 4.7.29 The {@code NestMembers} Attribute
* @jvms 5.4.4 Access Control * @jvms 5.4.4 Access Control
*/ */
@CallerSensitive @CallerSensitive

View File

@ -2194,7 +2194,7 @@ public abstract class ClassLoader {
* @revised 9 * @revised 9
* @spec JPMS * @spec JPMS
* *
* @jvms 5.3 Run-time package * @jvms 5.3 Creation and Loading
* @see <a href="{@docRoot}/../specs/jar/jar.html#package-sealing"> * @see <a href="{@docRoot}/../specs/jar/jar.html#package-sealing">
* The JAR File Specification: Package Sealing</a> * The JAR File Specification: Package Sealing</a>
*/ */
@ -2228,7 +2228,7 @@ public abstract class ClassLoader {
* @throws NullPointerException * @throws NullPointerException
* if {@code name} is {@code null}. * if {@code name} is {@code null}.
* *
* @jvms 5.3 Run-time package * @jvms 5.3 Creation and Loading
* *
* @since 9 * @since 9
* @spec JPMS * @spec JPMS
@ -2255,7 +2255,7 @@ public abstract class ClassLoader {
* this class loader; or an zero length array if no package has been * this class loader; or an zero length array if no package has been
* defined by this class loader. * defined by this class loader.
* *
* @jvms 5.3 Run-time package * @jvms 5.3 Creation and Loading
* *
* @since 9 * @since 9
* @spec JPMS * @spec JPMS

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1994, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -673,7 +673,7 @@ public final class Double extends Number
* *
* @return the {@code double} value represented by this object * @return the {@code double} value represented by this object
* converted to type {@code byte} * converted to type {@code byte}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
* @since 1.1 * @since 1.1
*/ */
public byte byteValue() { public byte byteValue() {
@ -686,7 +686,7 @@ public final class Double extends Number
* *
* @return the {@code double} value represented by this object * @return the {@code double} value represented by this object
* converted to type {@code short} * converted to type {@code short}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
* @since 1.1 * @since 1.1
*/ */
public short shortValue() { public short shortValue() {
@ -696,7 +696,7 @@ public final class Double extends Number
/** /**
* Returns the value of this {@code Double} as an {@code int} * Returns the value of this {@code Double} as an {@code int}
* after a narrowing primitive conversion. * after a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
* *
* @return the {@code double} value represented by this object * @return the {@code double} value represented by this object
* converted to type {@code int} * converted to type {@code int}
@ -711,7 +711,7 @@ public final class Double extends Number
* *
* @return the {@code double} value represented by this object * @return the {@code double} value represented by this object
* converted to type {@code long} * converted to type {@code long}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public long longValue() { public long longValue() {
return (long)value; return (long)value;
@ -723,7 +723,7 @@ public final class Double extends Number
* *
* @return the {@code double} value represented by this object * @return the {@code double} value represented by this object
* converted to type {@code float} * converted to type {@code float}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
* @since 1.0 * @since 1.0
*/ */
public float floatValue() { public float floatValue() {

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1994, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -602,7 +602,7 @@ public final class Float extends Number
* *
* @return the {@code float} value represented by this object * @return the {@code float} value represented by this object
* converted to type {@code byte} * converted to type {@code byte}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public byte byteValue() { public byte byteValue() {
return (byte)value; return (byte)value;
@ -614,7 +614,7 @@ public final class Float extends Number
* *
* @return the {@code float} value represented by this object * @return the {@code float} value represented by this object
* converted to type {@code short} * converted to type {@code short}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
* @since 1.1 * @since 1.1
*/ */
public short shortValue() { public short shortValue() {
@ -627,7 +627,7 @@ public final class Float extends Number
* *
* @return the {@code float} value represented by this object * @return the {@code float} value represented by this object
* converted to type {@code int} * converted to type {@code int}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public int intValue() { public int intValue() {
return (int)value; return (int)value;
@ -639,7 +639,7 @@ public final class Float extends Number
* *
* @return the {@code float} value represented by this object * @return the {@code float} value represented by this object
* converted to type {@code long} * converted to type {@code long}
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public long longValue() { public long longValue() {
return (long)value; return (long)value;
@ -661,7 +661,7 @@ public final class Float extends Number
* *
* @return the {@code float} value represented by this * @return the {@code float} value represented by this
* object converted to type {@code double} * object converted to type {@code double}
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public double doubleValue() { public double doubleValue() {
return (double)value; return (double)value;

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -57,7 +57,7 @@ import java.lang.annotation.*;
* regardless of whether or not a {@code FunctionalInterface} * regardless of whether or not a {@code FunctionalInterface}
* annotation is present on the interface declaration. * annotation is present on the interface declaration.
* *
* @jls 4.3.2. The Class Object * @jls 4.3.2 The Class Object
* @jls 9.8 Functional Interfaces * @jls 9.8 Functional Interfaces
* @jls 9.4.3 Interface Method Body * @jls 9.4.3 Interface Method Body
* @jls 9.6.4.9 @FunctionalInterface * @jls 9.6.4.9 @FunctionalInterface

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1994, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -1120,7 +1120,7 @@ public final class Integer extends Number
/** /**
* Returns the value of this {@code Integer} as a {@code byte} * Returns the value of this {@code Integer} as a {@code byte}
* after a narrowing primitive conversion. * after a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public byte byteValue() { public byte byteValue() {
return (byte)value; return (byte)value;
@ -1129,7 +1129,7 @@ public final class Integer extends Number
/** /**
* Returns the value of this {@code Integer} as a {@code short} * Returns the value of this {@code Integer} as a {@code short}
* after a narrowing primitive conversion. * after a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public short shortValue() { public short shortValue() {
return (short)value; return (short)value;
@ -1147,7 +1147,7 @@ public final class Integer extends Number
/** /**
* Returns the value of this {@code Integer} as a {@code long} * Returns the value of this {@code Integer} as a {@code long}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
* @see Integer#toUnsignedLong(int) * @see Integer#toUnsignedLong(int)
*/ */
public long longValue() { public long longValue() {
@ -1157,7 +1157,7 @@ public final class Integer extends Number
/** /**
* Returns the value of this {@code Integer} as a {@code float} * Returns the value of this {@code Integer} as a {@code float}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public float floatValue() { public float floatValue() {
return (float)value; return (float)value;
@ -1166,7 +1166,7 @@ public final class Integer extends Number
/** /**
* Returns the value of this {@code Integer} as a {@code double} * Returns the value of this {@code Integer} as a {@code double}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public double doubleValue() { public double doubleValue() {
return (double)value; return (double)value;

View File

@ -1339,7 +1339,7 @@ public final class Long extends Number
/** /**
* Returns the value of this {@code Long} as a {@code byte} after * Returns the value of this {@code Long} as a {@code byte} after
* a narrowing primitive conversion. * a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public byte byteValue() { public byte byteValue() {
return (byte)value; return (byte)value;
@ -1348,7 +1348,7 @@ public final class Long extends Number
/** /**
* Returns the value of this {@code Long} as a {@code short} after * Returns the value of this {@code Long} as a {@code short} after
* a narrowing primitive conversion. * a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public short shortValue() { public short shortValue() {
return (short)value; return (short)value;
@ -1357,7 +1357,7 @@ public final class Long extends Number
/** /**
* Returns the value of this {@code Long} as an {@code int} after * Returns the value of this {@code Long} as an {@code int} after
* a narrowing primitive conversion. * a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public int intValue() { public int intValue() {
return (int)value; return (int)value;
@ -1375,7 +1375,7 @@ public final class Long extends Number
/** /**
* Returns the value of this {@code Long} as a {@code float} after * Returns the value of this {@code Long} as a {@code float} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public float floatValue() { public float floatValue() {
return (float)value; return (float)value;
@ -1384,7 +1384,7 @@ public final class Long extends Number
/** /**
* Returns the value of this {@code Long} as a {@code double} * Returns the value of this {@code Long} as a {@code double}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public double doubleValue() { public double doubleValue() {
return (double)value; return (double)value;

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1994, 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -48,8 +48,8 @@ package java.lang;
* *
* @author Lee Boynton * @author Lee Boynton
* @author Arthur van Hoff * @author Arthur van Hoff
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
* @since 1.0 * @since 1.0
*/ */
public abstract class Number implements java.io.Serializable { public abstract class Number implements java.io.Serializable {

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -108,7 +108,7 @@ import jdk.internal.reflect.Reflection;
* <em>named modules</em>. Instead those packages are automatically defined * <em>named modules</em>. Instead those packages are automatically defined
* and have no specification and implementation versioning information. * and have no specification and implementation versioning information.
* *
* @jvms 5.3 Run-time package * @jvms 5.3 Creation and Loading
* @see <a href="{@docRoot}/../specs/jar/jar.html#package-sealing"> * @see <a href="{@docRoot}/../specs/jar/jar.html#package-sealing">
* The JAR File Specification: Package Sealing</a> * The JAR File Specification: Package Sealing</a>
* @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL) * @see ClassLoader#definePackage(String, String, String, String, String, String, String, URL)

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -352,7 +352,7 @@ public final class Short extends Number implements Comparable<Short> {
/** /**
* Returns the value of this {@code Short} as a {@code byte} after * Returns the value of this {@code Short} as a {@code byte} after
* a narrowing primitive conversion. * a narrowing primitive conversion.
* @jls 5.1.3 Narrowing Primitive Conversions * @jls 5.1.3 Narrowing Primitive Conversion
*/ */
public byte byteValue() { public byte byteValue() {
return (byte)value; return (byte)value;
@ -370,7 +370,7 @@ public final class Short extends Number implements Comparable<Short> {
/** /**
* Returns the value of this {@code Short} as an {@code int} after * Returns the value of this {@code Short} as an {@code int} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public int intValue() { public int intValue() {
return (int)value; return (int)value;
@ -379,7 +379,7 @@ public final class Short extends Number implements Comparable<Short> {
/** /**
* Returns the value of this {@code Short} as a {@code long} after * Returns the value of this {@code Short} as a {@code long} after
* a widening primitive conversion. * a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public long longValue() { public long longValue() {
return (long)value; return (long)value;
@ -388,7 +388,7 @@ public final class Short extends Number implements Comparable<Short> {
/** /**
* Returns the value of this {@code Short} as a {@code float} * Returns the value of this {@code Short} as a {@code float}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public float floatValue() { public float floatValue() {
return (float)value; return (float)value;
@ -397,7 +397,7 @@ public final class Short extends Number implements Comparable<Short> {
/** /**
* Returns the value of this {@code Short} as a {@code double} * Returns the value of this {@code Short} as a {@code double}
* after a widening primitive conversion. * after a widening primitive conversion.
* @jls 5.1.2 Widening Primitive Conversions * @jls 5.1.2 Widening Primitive Conversion
*/ */
public double doubleValue() { public double doubleValue() {
return (double)value; return (double)value;

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2004, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -49,7 +49,7 @@ import static java.lang.annotation.ElementType.*;
* @jls 4.8 Raw Types * @jls 4.8 Raw Types
* @jls 4.12.2 Variables of Reference Type * @jls 4.12.2 Variables of Reference Type
* @jls 5.1.9 Unchecked Conversion * @jls 5.1.9 Unchecked Conversion
* @jls 5.5.2 Checked Casts and Unchecked Casts * @jls 5.5 Casting Contexts
* @jls 9.6.4.5 @SuppressWarnings * @jls 9.6.4.5 @SuppressWarnings
*/ */
@Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, MODULE}) @Target({TYPE, FIELD, METHOD, PARAMETER, CONSTRUCTOR, LOCAL_VARIABLE, MODULE})

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2018, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -59,7 +59,7 @@ import java.util.Optional;
* method handles, but not necessarily those produced by method handle * method handles, but not necessarily those produced by method handle
* combinators.) * combinators.)
* @jvms 4.4 The Constant Pool * @jvms 4.4 The Constant Pool
* @jvms 4.4.10 The CONSTANT_InvokeDynamic_info Structure * @jvms 4.4.10 The {@code CONSTANT_Dynamic_info} and {@code CONSTANT_InvokeDynamic_info} Structures
* *
* @since 12 * @since 12
*/ */

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2013, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2013, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -114,7 +114,7 @@ import javax.lang.model.type.*;
* *
* @since 1.8 * @since 1.8
* @jls 9.6 Annotation Types * @jls 9.6 Annotation Types
* @jls 9.6.3.3 @Inherited * @jls 9.6.4.3 {@code @Inherited}
*/ */
public interface AnnotatedConstruct { public interface AnnotatedConstruct {
/** /**

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -196,7 +196,7 @@ public interface Element extends javax.lang.model.AnnotatedConstruct {
* @see ModuleElement#getEnclosedElements * @see ModuleElement#getEnclosedElements
* @see Elements#getAllMembers * @see Elements#getAllMembers
* @jls 8.8.9 Default Constructor * @jls 8.8.9 Default Constructor
* @jls 8.9 Enums * @jls 8.9 Enum Types
* @revised 9 * @revised 9
* @spec JPMS * @spec JPMS
*/ */

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -111,7 +111,7 @@ public enum NestingKind {
* More specifically, an <i>inner</i> type element is any nested type element that * More specifically, an <i>inner</i> type element is any nested type element that
* is not {@linkplain Modifier#STATIC static}. * is not {@linkplain Modifier#STATIC static}.
* @return whether or not the constant is nested * @return whether or not the constant is nested
* @jls 14.3 Inner Classes and Enclosing Instances * @jls 14.3 Local Class Declarations
*/ */
public boolean isNested() { public boolean isNested() {
return this != TOP_LEVEL; return this != TOP_LEVEL;

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -104,7 +104,7 @@ public interface Types {
* @return {@code true} if and only if the first type is assignable * @return {@code true} if and only if the first type is assignable
* to the second * to the second
* @throws IllegalArgumentException if given a type for an executable, package, or module * @throws IllegalArgumentException if given a type for an executable, package, or module
* @jls 5.2 Assignment Conversion * @jls 5.2 Assignment Contexts
*/ */
boolean isAssignable(TypeMirror t1, TypeMirror t2); boolean isAssignable(TypeMirror t1, TypeMirror t2);
@ -115,7 +115,7 @@ public interface Types {
* @param t2 the second type * @param t2 the second type
* @return {@code true} if and only if the first type contains the second * @return {@code true} if and only if the first type contains the second
* @throws IllegalArgumentException if given a type for an executable, package, or module * @throws IllegalArgumentException if given a type for an executable, package, or module
* @jls 4.5.1.1 Type Argument Containment and Equivalence * @jls 4.5.1 Type Arguments of Parameterized Types
*/ */
boolean contains(TypeMirror t1, TypeMirror t2); boolean contains(TypeMirror t1, TypeMirror t2);

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -40,8 +40,8 @@ package com.sun.source.tree;
* @jls 15.20 Relational Operators * @jls 15.20 Relational Operators
* @jls 15.21 Equality Operators * @jls 15.21 Equality Operators
* @jls 15.22 Bitwise and Logical Operators * @jls 15.22 Bitwise and Logical Operators
* @jls 15.23 Conditional-And Operator && * @jls 15.23 Conditional-And Operator {@code &&}
* @jls 15.24 Conditional-Or Operator || * @jls 15.24 Conditional-Or Operator {@code ||}
* *
* @author Peter von der Ah&eacute; * @author Peter von der Ah&eacute;
* @author Jonathan Gibbons * @author Jonathan Gibbons

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it

View File

@ -2733,7 +2733,7 @@ public class Types {
* signature</em> of the other. This is <b>not</b> an equivalence * signature</em> of the other. This is <b>not</b> an equivalence
* relation. * relation.
* *
* @jls section 8.4.2. * @jls 8.4.2 Method Signature
* @see #overrideEquivalent(Type t, Type s) * @see #overrideEquivalent(Type t, Type s)
* @param t first signature (possibly raw). * @param t first signature (possibly raw).
* @param s second signature (could be subjected to erasure). * @param s second signature (could be subjected to erasure).
@ -2752,7 +2752,7 @@ public class Types {
* equivalence</em>. This is the natural extension of * equivalence</em>. This is the natural extension of
* isSubSignature to an equivalence relation. * isSubSignature to an equivalence relation.
* *
* @jls section 8.4.2. * @jls 8.4.2 Method Signature
* @see #isSubSignature(Type t, Type s) * @see #isSubSignature(Type t, Type s)
* @param t a signature (possible raw, could be subjected to * @param t a signature (possible raw, could be subjected to
* erasure). * erasure).
@ -4214,7 +4214,7 @@ public class Types {
/** /**
* Return-Type-Substitutable. * Return-Type-Substitutable.
* @jls section 8.4.5 * @jls 8.4.5 Method Result
*/ */
public boolean returnTypeSubstitutable(Type r1, Type r2) { public boolean returnTypeSubstitutable(Type r1, Type r2) {
if (hasSameArgs(r1, r2)) if (hasSameArgs(r1, r2))

View File

@ -4222,7 +4222,7 @@ public class Attr extends JCTree.Visitor {
* @param tree The tree making up the variable reference. * @param tree The tree making up the variable reference.
* @param env The current environment. * @param env The current environment.
* @param v The variable's symbol. * @param v The variable's symbol.
* @jls section 8.9 Enums * @jls 8.9 Enum Types
*/ */
private void checkEnumInitializer(JCTree tree, Env<AttrContext> env, VarSymbol v) { private void checkEnumInitializer(JCTree tree, Env<AttrContext> env, VarSymbol v) {
// JLS: // JLS:

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,7 +36,7 @@ import jdk.jshell.Key.ExpressionKey;
* and thus is thread-safe. * and thus is thread-safe.
* *
* @since 9 * @since 9
* @jls 15: Expression. * @jls 15 Expressions
*/ */
public class ExpressionSnippet extends Snippet { public class ExpressionSnippet extends Snippet {

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,7 +36,7 @@ import jdk.jshell.Key.ImportKey;
* and thus is thread-safe. * and thus is thread-safe.
* *
* @since 9 * @since 9
* @jls 8.3: importDeclaration. * @jls 7.5 Import Declarations
*/ */
public class ImportSnippet extends PersistentSnippet { public class ImportSnippet extends PersistentSnippet {

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -37,7 +37,7 @@ import jdk.jshell.Key.MethodKey;
* and thus is thread-safe. * and thus is thread-safe.
* *
* @since 9 * @since 9
* @jls 8.4: MethodDeclaration. * @jls 8.4 Method Declarations
*/ */
public class MethodSnippet extends DeclarationSnippet { public class MethodSnippet extends DeclarationSnippet {

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2015, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -73,7 +73,7 @@ public abstract class Snippet {
* ({@link jdk.jshell.Snippet.SubKind#SINGLE_STATIC_IMPORT_SUBKIND}) -- * ({@link jdk.jshell.Snippet.SubKind#SINGLE_STATIC_IMPORT_SUBKIND}) --
* use {@link jdk.jshell.Snippet#subKind()} to distinguish. * use {@link jdk.jshell.Snippet#subKind()} to distinguish.
* *
* @jls 8.3: importDeclaration. * @jls 7.5 Import Declarations
* <P> * <P>
* An import declaration is {@linkplain Kind#isPersistent() persistent}. * An import declaration is {@linkplain Kind#isPersistent() persistent}.
*/ */
@ -91,7 +91,7 @@ public abstract class Snippet {
* annotation interfaces -- see {@link jdk.jshell.Snippet.SubKind} to * annotation interfaces -- see {@link jdk.jshell.Snippet.SubKind} to
* differentiate. * differentiate.
* *
* @jls 7.6: TypeDeclaration. * @jls 7.6 Top Level Type Declarations
* <P> * <P>
* A type declaration is {@linkplain Kind#isPersistent() persistent}. * A type declaration is {@linkplain Kind#isPersistent() persistent}.
*/ */
@ -101,7 +101,7 @@ public abstract class Snippet {
* A method declaration. * A method declaration.
* The snippet is an instance of {@link jdk.jshell.MethodSnippet}. * The snippet is an instance of {@link jdk.jshell.MethodSnippet}.
* *
* @jls 8.4: MethodDeclaration. * @jls 8.4 Method Declarations
* <P> * <P>
* A method declaration is {@linkplain Kind#isPersistent() persistent}. * A method declaration is {@linkplain Kind#isPersistent() persistent}.
*/ */
@ -116,7 +116,7 @@ public abstract class Snippet {
* variable representing an expression -- see * variable representing an expression -- see
* {@link jdk.jshell.Snippet.SubKind}to differentiate. * {@link jdk.jshell.Snippet.SubKind}to differentiate.
* *
* @jls 8.3: FieldDeclaration. * @jls 8.3 Field Declarations
* <P> * <P>
* A variable declaration is {@linkplain Kind#isPersistent() persistent}. * A variable declaration is {@linkplain Kind#isPersistent() persistent}.
*/ */
@ -133,7 +133,7 @@ public abstract class Snippet {
* All other expression forms (operators, method calls, ...) generate a * All other expression forms (operators, method calls, ...) generate a
* scratch variable and so are instead of the VAR Kind. * scratch variable and so are instead of the VAR Kind.
* *
* @jls 15: Expression. * @jls 15 Expressions
*/ */
EXPRESSION(false), EXPRESSION(false),
@ -141,7 +141,7 @@ public abstract class Snippet {
* A statement. * A statement.
* The snippet is an instance of {@link jdk.jshell.StatementSnippet}. * The snippet is an instance of {@link jdk.jshell.StatementSnippet}.
* *
* @jls 14.5: Statement. * @jls 14.5 Statements
*/ */
STATEMENT(false), STATEMENT(false),
@ -185,99 +185,97 @@ public abstract class Snippet {
/** /**
* Single-Type-Import Declaration. * Single-Type-Import Declaration.
* An import declaration of a single type. * 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), SINGLE_TYPE_IMPORT_SUBKIND(Kind.IMPORT),
/** /**
* Type-Import-on-Demand Declaration. * Type-Import-on-Demand Declaration.
* A non-static "star" import. * 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), TYPE_IMPORT_ON_DEMAND_SUBKIND(Kind.IMPORT),
/** /**
* Single-Static-Import Declaration. * Single-Static-Import Declaration.
* An import of a static member. * 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), SINGLE_STATIC_IMPORT_SUBKIND(Kind.IMPORT),
/** /**
* Static-Import-on-Demand Declaration. * Static-Import-on-Demand Declaration.
* A static "star" import of all static members of a named type. * 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), STATIC_IMPORT_ON_DEMAND_SUBKIND(Kind.IMPORT),
/** /**
* A class declaration. * A class declaration.
* A {@code SubKind} of {@link Kind#TYPE_DECL}. * A {@code SubKind} of {@link Kind#TYPE_DECL}.
* @jls 8.1. NormalClassDeclaration. * @jls 8.1 Class Declarations
*/ */
CLASS_SUBKIND(Kind.TYPE_DECL), CLASS_SUBKIND(Kind.TYPE_DECL),
/** /**
* An interface declaration. * An interface declaration.
* A {@code SubKind} of {@link Kind#TYPE_DECL}. * A {@code SubKind} of {@link Kind#TYPE_DECL}.
* @jls 9.1. NormalInterfaceDeclaration. * @jls 9.1 Interface Declarations
*/ */
INTERFACE_SUBKIND(Kind.TYPE_DECL), INTERFACE_SUBKIND(Kind.TYPE_DECL),
/** /**
* An enum declaration. * An enum declaration.
* A {@code SubKind} of {@link Kind#TYPE_DECL}. * A {@code SubKind} of {@link Kind#TYPE_DECL}.
* @jls 8.9. EnumDeclaration. * @jls 8.9 Enum Types
*/ */
ENUM_SUBKIND(Kind.TYPE_DECL), ENUM_SUBKIND(Kind.TYPE_DECL),
/** /**
* An annotation interface declaration. A {@code SubKind} of * An annotation interface declaration. A {@code SubKind} of
* {@link Kind#TYPE_DECL}. * {@link Kind#TYPE_DECL}.
* @jls 9.6. AnnotationTypeDeclaration. * @jls 9.6 Annotation Types
*/ */
ANNOTATION_TYPE_SUBKIND(Kind.TYPE_DECL), ANNOTATION_TYPE_SUBKIND(Kind.TYPE_DECL),
/** /**
* A method. The only {@code SubKind} for {@link Kind#METHOD}. * A method. The only {@code SubKind} for {@link Kind#METHOD}.
* @jls 8.4. MethodDeclaration. * @jls 8.4 Method Declarations
*/ */
METHOD_SUBKIND(Kind.METHOD), METHOD_SUBKIND(Kind.METHOD),
/** /**
* A variable declaration without initializer. * A variable declaration without initializer.
* A {@code SubKind} of {@link Kind#VAR}. * A {@code SubKind} of {@link Kind#VAR}.
* @jls 8.3. VariableDeclarator without VariableInitializer in * @jls 8.3 Field Declarations
* FieldDeclaration.
*/ */
VAR_DECLARATION_SUBKIND(Kind.VAR, true, true), VAR_DECLARATION_SUBKIND(Kind.VAR, true, true),
/** /**
* A variable declaration with an initializer expression. A * A variable declaration with an initializer expression. A
* {@code SubKind} of {@link Kind#VAR}. * {@code SubKind} of {@link Kind#VAR}.
* @jls 8.3. VariableDeclarator with VariableInitializer in * @jls 8.3 Field Declarations
* FieldDeclaration.
*/ */
VAR_DECLARATION_WITH_INITIALIZER_SUBKIND(Kind.VAR, true, true), VAR_DECLARATION_WITH_INITIALIZER_SUBKIND(Kind.VAR, true, true),
/** /**
* An expression whose value has been stored in a temporary variable. A * An expression whose value has been stored in a temporary variable. A
* {@code SubKind} of {@link Kind#VAR}. * {@code SubKind} of {@link Kind#VAR}.
* @jls 15. Primary. * @jls 15 Expressions
*/ */
TEMP_VAR_EXPRESSION_SUBKIND(Kind.VAR, true, true), TEMP_VAR_EXPRESSION_SUBKIND(Kind.VAR, true, true),
/** /**
* A simple variable reference expression. A {@code SubKind} of * A simple variable reference expression. A {@code SubKind} of
* {@link Kind#EXPRESSION}. * {@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), VAR_VALUE_SUBKIND(Kind.EXPRESSION, true, true),
/** /**
* An assignment expression. A {@code SubKind} of * An assignment expression. A {@code SubKind} of
* {@link Kind#EXPRESSION}. * {@link Kind#EXPRESSION}.
* @jls 15.26. Assignment. * @jls 15.26 Assignment Operators
*/ */
ASSIGNMENT_SUBKIND(Kind.EXPRESSION, true, true), ASSIGNMENT_SUBKIND(Kind.EXPRESSION, true, true),
@ -289,7 +287,7 @@ public abstract class Snippet {
/** /**
* A statement. The only {@code SubKind} for {@link Kind#STATEMENT}. * A statement. The only {@code SubKind} for {@link Kind#STATEMENT}.
* @jls 14.5. Statement. * @jls 14.5 Statements
*/ */
STATEMENT_SUBKIND(Kind.STATEMENT, true, false), STATEMENT_SUBKIND(Kind.STATEMENT, true, false),

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -36,7 +36,7 @@ import jdk.jshell.Key.StatementKey;
* and thus is thread-safe. * and thus is thread-safe.
* *
* @since 9 * @since 9
* @jls 14.5: Statement. * @jls 14.5 Statements
*/ */
public class StatementSnippet extends Snippet { public class StatementSnippet extends Snippet {

View File

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2015, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2015, 2019, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -39,7 +39,7 @@ import jdk.jshell.Key.VarKey;
* and thus is thread-safe. * and thus is thread-safe.
* *
* @since 9 * @since 9
* @jls 8.3: FieldDeclaration. * @jls 8.3 Field Declarations
*/ */
public class VarSnippet extends DeclarationSnippet { public class VarSnippet extends DeclarationSnippet {