mirror of
https://github.com/openjdk/jdk.git
synced 2025-08-27 23:04:50 +02:00
8241727: Typos: empty lines in javadoc, inconsistent indents, etc. (core-libs only)
Reviewed-by: prappo
This commit is contained in:
parent
7f8d785086
commit
b0e1ee4b3b
70 changed files with 435 additions and 446 deletions
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 2017, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2017, 2020, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -135,9 +135,9 @@ interface ConstantGroup {
|
|||
* must always return true.
|
||||
* <p>
|
||||
* If this method returns {@code false}, nothing in particular
|
||||
* can be inferred, since the query only concerns the internal
|
||||
* can be inferred, since the query only concerns the internal
|
||||
* logic of the {@code ConstantGroup} object which ensures that
|
||||
a successful * query to a constant will always remain successful.
|
||||
* a successful query to a constant will always remain successful.
|
||||
* The only way to force a permanent decision about whether
|
||||
* a constant is available is to call {@link #get(int)} and
|
||||
* be ready for an exception if the constant is unavailable.
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 2012, 2019, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -1151,25 +1151,25 @@ class InvokerBytecodeGenerator {
|
|||
}
|
||||
|
||||
/**
|
||||
* Emit bytecode for the guardWithCatch idiom.
|
||||
*
|
||||
* The pattern looks like (Cf. MethodHandleImpl.makeGuardWithCatch):
|
||||
* <blockquote><pre>{@code
|
||||
* guardWithCatch=Lambda(a0:L,a1:L,a2:L,a3:L,a4:L,a5:L,a6:L,a7:L)=>{
|
||||
* t8:L=MethodHandle.invokeBasic(a4:L,a6:L,a7:L);
|
||||
* t9:L=MethodHandleImpl.guardWithCatch(a1:L,a2:L,a3:L,t8:L);
|
||||
* t10:I=MethodHandle.invokeBasic(a5:L,t9:L);t10:I}
|
||||
* }</pre></blockquote>
|
||||
*
|
||||
* It is compiled into bytecode equivalent of the following code:
|
||||
* <blockquote><pre>{@code
|
||||
* try {
|
||||
* return a1.invokeBasic(a6, a7);
|
||||
* } catch (Throwable e) {
|
||||
* if (!a2.isInstance(e)) throw e;
|
||||
* return a3.invokeBasic(ex, a6, a7);
|
||||
* }}</pre></blockquote>
|
||||
*/
|
||||
* Emit bytecode for the guardWithCatch idiom.
|
||||
*
|
||||
* The pattern looks like (Cf. MethodHandleImpl.makeGuardWithCatch):
|
||||
* <blockquote><pre>{@code
|
||||
* guardWithCatch=Lambda(a0:L,a1:L,a2:L,a3:L,a4:L,a5:L,a6:L,a7:L)=>{
|
||||
* t8:L=MethodHandle.invokeBasic(a4:L,a6:L,a7:L);
|
||||
* t9:L=MethodHandleImpl.guardWithCatch(a1:L,a2:L,a3:L,t8:L);
|
||||
* t10:I=MethodHandle.invokeBasic(a5:L,t9:L);t10:I}
|
||||
* }</pre></blockquote>
|
||||
*
|
||||
* It is compiled into bytecode equivalent of the following code:
|
||||
* <blockquote><pre>{@code
|
||||
* try {
|
||||
* return a1.invokeBasic(a6, a7);
|
||||
* } catch (Throwable e) {
|
||||
* if (!a2.isInstance(e)) throw e;
|
||||
* return a3.invokeBasic(ex, a6, a7);
|
||||
* }}</pre></blockquote>
|
||||
*/
|
||||
private Name emitGuardWithCatch(int pos) {
|
||||
Name args = lambdaForm.names[pos];
|
||||
Name invoker = lambdaForm.names[pos+1];
|
||||
|
|
|
@ -1073,36 +1073,37 @@ assertEquals("[A, B, C]", (String) caToString2.invokeExact('A', "BC".toCharArray
|
|||
throw newIllegalArgumentException("array length is not legal for long[] or double[]", arrayLength);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Adapts this method handle to be {@linkplain #asVarargsCollector variable arity}
|
||||
* if the boolean flag is true, else {@linkplain #asFixedArity fixed arity}.
|
||||
* If the method handle is already of the proper arity mode, it is returned
|
||||
* unchanged.
|
||||
* @apiNote
|
||||
* <p>This method is sometimes useful when adapting a method handle that
|
||||
* may be variable arity, to ensure that the resulting adapter is also
|
||||
* variable arity if and only if the original handle was. For example,
|
||||
* this code changes the first argument of a handle {@code mh} to {@code int} without
|
||||
* disturbing its variable arity property:
|
||||
* {@code mh.asType(mh.type().changeParameterType(0,int.class))
|
||||
* .withVarargs(mh.isVarargsCollector())}
|
||||
* <p>
|
||||
* This call is approximately equivalent to the following code:
|
||||
* <blockquote><pre>{@code
|
||||
* if (makeVarargs == isVarargsCollector())
|
||||
* return this;
|
||||
* else if (makeVarargs)
|
||||
* return asVarargsCollector(type().lastParameterType());
|
||||
* else
|
||||
* return asFixedArity();
|
||||
* }</pre></blockquote>
|
||||
* @param makeVarargs true if the return method handle should have variable arity behavior
|
||||
* @return a method handle of the same type, with possibly adjusted variable arity behavior
|
||||
* @throws IllegalArgumentException if {@code makeVarargs} is true and
|
||||
* this method handle does not have a trailing array parameter
|
||||
* @since 9
|
||||
* @see #asVarargsCollector
|
||||
* @see #asFixedArity
|
||||
* Adapts this method handle to be {@linkplain #asVarargsCollector variable arity}
|
||||
* if the boolean flag is true, else {@linkplain #asFixedArity fixed arity}.
|
||||
* If the method handle is already of the proper arity mode, it is returned
|
||||
* unchanged.
|
||||
* @apiNote
|
||||
* <p>This method is sometimes useful when adapting a method handle that
|
||||
* may be variable arity, to ensure that the resulting adapter is also
|
||||
* variable arity if and only if the original handle was. For example,
|
||||
* this code changes the first argument of a handle {@code mh} to {@code int} without
|
||||
* disturbing its variable arity property:
|
||||
* {@code mh.asType(mh.type().changeParameterType(0,int.class))
|
||||
* .withVarargs(mh.isVarargsCollector())}
|
||||
* <p>
|
||||
* This call is approximately equivalent to the following code:
|
||||
* <blockquote><pre>{@code
|
||||
* if (makeVarargs == isVarargsCollector())
|
||||
* return this;
|
||||
* else if (makeVarargs)
|
||||
* return asVarargsCollector(type().lastParameterType());
|
||||
* else
|
||||
* return asFixedArity();
|
||||
* }</pre></blockquote>
|
||||
* @param makeVarargs true if the return method handle should have variable arity behavior
|
||||
* @return a method handle of the same type, with possibly adjusted variable arity behavior
|
||||
* @throws IllegalArgumentException if {@code makeVarargs} is true and
|
||||
* this method handle does not have a trailing array parameter
|
||||
* @since 9
|
||||
* @see #asVarargsCollector
|
||||
* @see #asFixedArity
|
||||
*/
|
||||
public MethodHandle withVarargs(boolean makeVarargs) {
|
||||
assert(!isVarargsCollector()); // subclass responsibility
|
||||
|
|
|
@ -461,7 +461,7 @@ class MethodType
|
|||
return insertParameterTypes(parameterCount(), ptypesToInsert);
|
||||
}
|
||||
|
||||
/**
|
||||
/**
|
||||
* Finds or creates a method type with modified parameter types.
|
||||
* Convenience method for {@link #methodType(java.lang.Class, java.lang.Class[]) methodType}.
|
||||
* @param start the position (zero-based) of the first replaced parameter type(s)
|
||||
|
|
|
@ -1,5 +1,5 @@
|
|||
/*
|
||||
* Copyright (c) 2008, 2019, Oracle and/or its affiliates. All rights reserved.
|
||||
* Copyright (c) 2008, 2020, Oracle and/or its affiliates. All rights reserved.
|
||||
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
||||
*
|
||||
* This code is free software; you can redistribute it and/or modify it
|
||||
|
@ -162,7 +162,6 @@
|
|||
* call site or constant, the JVM must choose one bootstrap method result and install it visibly to
|
||||
* all threads. Any other bootstrap method calls are allowed to complete, but their
|
||||
* results are ignored.
|
||||
|
||||
* <p style="font-size:smaller;">
|
||||
* <em>Discussion:</em>
|
||||
* These rules do not enable the JVM to share call sites,
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue