archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 14:54:52 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8199465: {@docRoot} references need to be updated to reflect new module/package structure

Browse source 
Reviewed-by: martin, alanb, chegar
This commit is contained in:
Jonathan Gibbons 2018-03-27 16:25:40 -07:00
parent 3fbef735ea
commit 6a8ea38ecc
84 changed files with 224 additions and 224 deletions
Download patch file Download diff file Expand all files Collapse all files

4
src/java.base/share/classes/java/lang/CharSequence.java
View file

@ -74,7 +74,7 @@ public interface CharSequence {
* indexing. * indexing.
* *
* <p>If the {@code char} value specified by the index is a * <p>If the {@code char} value specified by the index is a
* <a href="{@docRoot}/java/lang/Character.html#unicode">surrogate</a>, the surrogate * <a href="{@docRoot}/java.base/java/lang/Character.html#unicode">surrogate</a>, the surrogate
* value is returned. * value is returned.
* *
* @param index the index of the {@code char} value to be returned * @param index the index of the {@code char} value to be returned
@ -119,7 +119,7 @@ public interface CharSequence {
/** /**
* Returns a stream of {@code int} zero-extending the {@code char} values * Returns a stream of {@code int} zero-extending the {@code char} values
* from this sequence. Any char which maps to a <a * from this sequence. Any char which maps to a <a
* href="{@docRoot}/java/lang/Character.html#unicode">surrogate code * href="{@docRoot}/java.base/java/lang/Character.html#unicode">surrogate code
* point</a> is passed through uninterpreted. * point</a> is passed through uninterpreted.
* *
* <p>The stream binds to this sequence when the terminal stream operation * <p>The stream binds to this sequence when the terminal stream operation

4
src/java.base/share/classes/java/lang/Comparable.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -84,7 +84,7 @@ import java.util.*;
* {(x, y) such that x.equals(y)}. </pre><p> * {(x, y) such that x.equals(y)}. </pre><p>
* *
* This interface is a member of the * This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <T> the type of objects that this object may be compared to * @param <T> the type of objects that this object may be compared to

4
src/java.base/share/classes/java/lang/ProcessHandle.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2014, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2014, 2018, 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
@ -80,7 +80,7 @@ import java.util.stream.Stream;
* *
* <p> * <p>
* The {@code ProcessHandle} static factory methods return instances that are * The {@code ProcessHandle} static factory methods return instances that are
* <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a>, * <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>,
* immutable and thread-safe. * immutable and thread-safe.
* Use of identity-sensitive operations (including reference equality * Use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on these instances of * ({@code ==}), identity hash code, or synchronization) on these instances of

2
src/java.base/share/classes/java/lang/String.java
View file

@ -2647,7 +2647,7 @@ public final class String
/** /**
* Returns a stream of {@code int} zero-extending the {@code char} values * Returns a stream of {@code int} zero-extending the {@code char} values
* from this sequence. Any char which maps to a <a * from this sequence. Any char which maps to a <a
* href="{@docRoot}/java/lang/Character.html#unicode">surrogate code * href="{@docRoot}/java.base/java/lang/Character.html#unicode">surrogate code
* point</a> is passed through uninterpreted. * point</a> is passed through uninterpreted.
* *
* @return an IntStream of char values from this sequence * @return an IntStream of char values from this sequence

10
src/java.base/share/classes/java/lang/Thread.java
View file

@ -924,7 +924,7 @@ class Thread implements Runnable {
* for example), the {@code interrupt} method should be used to * for example), the {@code interrupt} method should be used to
* interrupt the wait. * interrupt the wait.
* For more information, see * For more information, see
* <a href="{@docRoot}/java/lang/doc-files/threadPrimitiveDeprecation.html">Why * <a href="{@docRoot}/java.base/java/lang/doc-files/threadPrimitiveDeprecation.html">Why
* are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>. * are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -957,7 +957,7 @@ class Thread implements Runnable {
* could be used to generate exceptions that the target thread was * could be used to generate exceptions that the target thread was
* not prepared to handle. * not prepared to handle.
* For more information, see * For more information, see
* <a href="{@docRoot}/java/lang/doc-files/threadPrimitiveDeprecation.html">Why * <a href="{@docRoot}/java.base/java/lang/doc-files/threadPrimitiveDeprecation.html">Why
* are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>. * are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
* This method is subject to removal in a future version of Java SE. * This method is subject to removal in a future version of Java SE.
*/ */
@ -1083,7 +1083,7 @@ class Thread implements Runnable {
* If another thread ever attempted to lock this resource, deadlock * If another thread ever attempted to lock this resource, deadlock
* would result. Such deadlocks typically manifest themselves as * would result. Such deadlocks typically manifest themselves as
* "frozen" processes. For more information, see * "frozen" processes. For more information, see
* <a href="{@docRoot}/java/lang/doc-files/threadPrimitiveDeprecation.html"> * <a href="{@docRoot}/java.base/java/lang/doc-files/threadPrimitiveDeprecation.html">
* Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>. * Why are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
* This method is subject to removal in a future version of Java SE. * This method is subject to removal in a future version of Java SE.
* @throws NoSuchMethodError always * @throws NoSuchMethodError always
@ -1123,7 +1123,7 @@ class Thread implements Runnable {
* monitor prior to calling {@code resume}, deadlock results. Such * monitor prior to calling {@code resume}, deadlock results. Such
* deadlocks typically manifest themselves as "frozen" processes. * deadlocks typically manifest themselves as "frozen" processes.
* For more information, see * For more information, see
* <a href="{@docRoot}/java/lang/doc-files/threadPrimitiveDeprecation.html">Why * <a href="{@docRoot}/java.base/java/lang/doc-files/threadPrimitiveDeprecation.html">Why
* are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>. * are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -1149,7 +1149,7 @@ class Thread implements Runnable {
* @deprecated This method exists solely for use with {@link #suspend}, * @deprecated This method exists solely for use with {@link #suspend},
* which has been deprecated because it is deadlock-prone. * which has been deprecated because it is deadlock-prone.
* For more information, see * For more information, see
* <a href="{@docRoot}/java/lang/doc-files/threadPrimitiveDeprecation.html">Why * <a href="{@docRoot}/java.base/java/lang/doc-files/threadPrimitiveDeprecation.html">Why
* are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>. * are Thread.stop, Thread.suspend and Thread.resume Deprecated?</a>.
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")

4
src/java.base/share/classes/java/lang/UnsupportedOperationException.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -29,7 +29,7 @@ package java.lang;
* Thrown to indicate that the requested operation is not supported.<p> * Thrown to indicate that the requested operation is not supported.<p>
* *
* This class is a member of the * This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/lang/module/Configuration.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2014, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2014, 2018, 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,7 +48,7 @@ import jdk.internal.module.ModuleTarget;
/** /**
* A configuration that is the result of <a href="package-summary.html#resolution"> * A configuration that is the result of <a href="package-summary.html#resolution">
* resolution</a> or resolution with * resolution</a> or resolution with
* <a href="{@docRoot}/java/lang/module/Configuration.html#service-binding">service binding</a>. * <a href="{@docRoot}/java.base/java/lang/module/Configuration.html#service-binding">service binding</a>.
* *
* <p> A configuration encapsulates the <em>readability graph</em> that is the * <p> A configuration encapsulates the <em>readability graph</em> that is the
* output of resolution. A readability graph is a directed graph whose vertices * output of resolution. A readability graph is a directed graph whose vertices

4
src/java.base/share/classes/java/time/Duration.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -119,7 +119,7 @@ import java.util.regex.Pattern;
* See {@link Instant} for a discussion as to the meaning of the second and time-scales. * See {@link Instant} for a discussion as to the meaning of the second and time-scales.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code Duration} may have unpredictable results and should be avoided. * {@code Duration} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/Instant.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -193,7 +193,7 @@ import java.util.Objects;
* {@code ZonedDateTime} and {@code Duration}. * {@code ZonedDateTime} and {@code Duration}.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code Instant} may have unpredictable results and should be avoided. * {@code Instant} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/LocalDate.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -125,7 +125,7 @@ import java.util.stream.Stream;
* to be accurate will find the ISO-8601 approach unsuitable. * to be accurate will find the ISO-8601 approach unsuitable.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code LocalDate} may have unpredictable results and should be avoided. * {@code LocalDate} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/LocalDateTime.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -121,7 +121,7 @@ import java.util.Objects;
* to be accurate will find the ISO-8601 approach unsuitable. * to be accurate will find the ISO-8601 approach unsuitable.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code LocalDateTime} may have unpredictable results and should be avoided. * {@code LocalDateTime} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/LocalTime.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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 @@ import java.util.Objects;
* representation, this class, for time-of-day. * representation, this class, for time-of-day.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code LocalTime} may have unpredictable results and should be avoided. * {@code LocalTime} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/MonthDay.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -113,7 +113,7 @@ import java.util.Objects;
* to be accurate will find the ISO-8601 approach unsuitable. * to be accurate will find the ISO-8601 approach unsuitable.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code MonthDay} may have unpredictable results and should be avoided. * {@code MonthDay} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/OffsetDateTime.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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 java.util.Objects;
* more detail, or when communicating to a database or in a network protocol. * more detail, or when communicating to a database or in a network protocol.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code OffsetDateTime} may have unpredictable results and should be avoided. * {@code OffsetDateTime} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/OffsetTime.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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 @@ import java.util.Objects;
* in an {@code OffsetTime}. * in an {@code OffsetTime}.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code OffsetTime} may have unpredictable results and should be avoided. * {@code OffsetTime} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/Period.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -119,7 +119,7 @@ import java.util.regex.Pattern;
* period may be negative. * period may be negative.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code Period} may have unpredictable results and should be avoided. * {@code Period} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/Year.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -121,7 +121,7 @@ import java.util.Objects;
* to be accurate will find the ISO-8601 approach unsuitable. * to be accurate will find the ISO-8601 approach unsuitable.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code Year} may have unpredictable results and should be avoided. * {@code Year} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/YearMonth.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -117,7 +117,7 @@ import java.util.Objects;
* to be accurate will find the ISO-8601 approach unsuitable. * to be accurate will find the ISO-8601 approach unsuitable.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code YearMonth} may have unpredictable results and should be avoided. * {@code YearMonth} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/ZoneId.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -162,7 +162,7 @@ import static java.util.Map.entry;
* queried, but not modified, on a Java Runtime with incomplete time-zone information. * queried, but not modified, on a Java Runtime with incomplete time-zone information.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code ZoneId} may have unpredictable results and should be avoided. * {@code ZoneId} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/ZoneOffset.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -116,7 +116,7 @@ import java.util.concurrent.ConcurrentMap;
* applications must not rely on such caching. * applications must not rely on such caching.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code ZoneOffset} may have unpredictable results and should be avoided. * {@code ZoneOffset} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/ZonedDateTime.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -144,7 +144,7 @@ import java.util.Objects;
* represents an instant, especially during a daylight savings overlap. * represents an instant, especially during a daylight savings overlap.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code ZonedDateTime} may have unpredictable results and should be avoided. * {@code ZonedDateTime} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/chrono/HijrahDate.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -105,7 +105,7 @@ import java.time.temporal.ValueRange;
* to a new HijrahChronology. * to a new HijrahChronology.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code HijrahDate} may have unpredictable results and should be avoided. * {@code HijrahDate} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/chrono/JapaneseDate.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -112,7 +112,7 @@ import sun.util.calendar.LocalGregorianCalendar;
* {@code JapaneseChronology.ERA_HEISEI}.<br> * {@code JapaneseChronology.ERA_HEISEI}.<br>
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code JapaneseDate} may have unpredictable results and should be avoided. * {@code JapaneseDate} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/chrono/MinguoDate.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -92,7 +92,7 @@ import java.util.Objects;
* Dates are aligned such that {@code 0001-01-01 (Minguo)} is {@code 1912-01-01 (ISO)}. * Dates are aligned such that {@code 0001-01-01 (Minguo)} is {@code 1912-01-01 (ISO)}.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code MinguoDate} may have unpredictable results and should be avoided. * {@code MinguoDate} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/time/chrono/ThaiBuddhistDate.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -92,7 +92,7 @@ import java.util.Objects;
* Dates are aligned such that {@code 2484-01-01 (Buddhist)} is {@code 1941-01-01 (ISO)}. * Dates are aligned such that {@code 2484-01-01 (Buddhist)} is {@code 1941-01-01 (ISO)}.
* *
* <p> * <p>
* This is a <a href="{@docRoot}/java/lang/doc-files/ValueBased.html">value-based</a> * This is a <a href="{@docRoot}/java.base/java/lang/doc-files/ValueBased.html">value-based</a>
* class; use of identity-sensitive operations (including reference equality * class; use of identity-sensitive operations (including reference equality
* ({@code ==}), identity hash code, or synchronization) on instances of * ({@code ==}), identity hash code, or synchronization) on instances of
* {@code ThaiBuddhistDate} may have unpredictable results and should be avoided. * {@code ThaiBuddhistDate} may have unpredictable results and should be avoided.

4
src/java.base/share/classes/java/util/AbstractCollection.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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 @@ package java.util;
* the collection being implemented admits a more efficient implementation.<p> * the collection being implemented admits a more efficient implementation.<p>
* *
* This class is a member of the * This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/AbstractList.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -62,7 +62,7 @@ import java.util.function.Consumer;
* collection being implemented admits a more efficient implementation. * collection being implemented admits a more efficient implementation.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/AbstractMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -52,7 +52,7 @@ import java.util.Map.Entry;
* map being implemented admits a more efficient implementation. * map being implemented admits a more efficient implementation.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <K> the type of keys maintained by this map * @param <K> the type of keys maintained by this map

2
src/java.base/share/classes/java/util/AbstractQueue.java
View file

@ -54,7 +54,7 @@ package java.util;
* instead subclassing {@link AbstractCollection}. * instead subclassing {@link AbstractCollection}.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

4
src/java.base/share/classes/java/util/AbstractSequentialList.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -54,7 +54,7 @@ package java.util;
* specification.<p> * specification.<p>
* *
* This class is a member of the * This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/AbstractSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -42,7 +42,7 @@ package java.util;
* for {@code equals} and {@code hashCode}.<p> * for {@code equals} and {@code hashCode}.<p>
* *
* This class is a member of the * This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements maintained by this set * @param <E> the type of elements maintained by this set

2
src/java.base/share/classes/java/util/ArrayDeque.java
View file

@ -80,7 +80,7 @@ import jdk.internal.misc.SharedSecrets;
* Iterator} interfaces. * Iterator} interfaces.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch and Doug Lea * @author Josh Bloch and Doug Lea

4
src/java.base/share/classes/java/util/ArrayList.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -92,7 +92,7 @@ import jdk.internal.misc.SharedSecrets;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements in this list * @param <E> the type of elements in this list

4
src/java.base/share/classes/java/util/Arrays.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -63,7 +63,7 @@ import java.util.stream.StreamSupport;
* a MergeSort, but it does have to be <i>stable</i>.) * a MergeSort, but it does have to be <i>stable</i>.)
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

24
src/java.base/share/classes/java/util/Collection.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -188,7 +188,7 @@ import java.util.stream.StreamSupport;
* unmodifiable view, the view can be considered effectively immutable. * unmodifiable view, the view can be considered effectively immutable.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @implSpec * @implSpec
@ -247,10 +247,10 @@ public interface Collection<E> extends Iterable<E> {
* element * element
* @throws ClassCastException if the type of the specified element * @throws ClassCastException if the type of the specified element
* is incompatible with this collection * is incompatible with this collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null and this * @throws NullPointerException if the specified element is null and this
* collection does not permit null elements * collection does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean contains(Object o); boolean contains(Object o);
@ -379,10 +379,10 @@ public interface Collection<E> extends Iterable<E> {
* @return {@code true} if an element was removed as a result of this call * @return {@code true} if an element was removed as a result of this call
* @throws ClassCastException if the type of the specified element * @throws ClassCastException if the type of the specified element
* is incompatible with this collection * is incompatible with this collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null and this * @throws NullPointerException if the specified element is null and this
* collection does not permit null elements * collection does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws UnsupportedOperationException if the {@code remove} operation * @throws UnsupportedOperationException if the {@code remove} operation
* is not supported by this collection * is not supported by this collection
*/ */
@ -401,11 +401,11 @@ public interface Collection<E> extends Iterable<E> {
* @throws ClassCastException if the types of one or more elements * @throws ClassCastException if the types of one or more elements
* in the specified collection are incompatible with this * in the specified collection are incompatible with this
* collection * collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified collection contains one * @throws NullPointerException if the specified collection contains one
* or more null elements and this collection does not permit null * or more null elements and this collection does not permit null
* elements * elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null. * or if the specified collection is null.
* @see #contains(Object) * @see #contains(Object)
*/ */
@ -451,11 +451,11 @@ public interface Collection<E> extends Iterable<E> {
* @throws ClassCastException if the types of one or more elements * @throws ClassCastException if the types of one or more elements
* in this collection are incompatible with the specified * in this collection are incompatible with the specified
* collection * collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if this collection contains one or more * @throws NullPointerException if this collection contains one or more
* null elements and the specified collection does not support * null elements and the specified collection does not support
* null elements * null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null * or if the specified collection is null
* @see #remove(Object) * @see #remove(Object)
* @see #contains(Object) * @see #contains(Object)
@ -510,11 +510,11 @@ public interface Collection<E> extends Iterable<E> {
* @throws ClassCastException if the types of one or more elements * @throws ClassCastException if the types of one or more elements
* in this collection are incompatible with the specified * in this collection are incompatible with the specified
* collection * collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if this collection contains one or more * @throws NullPointerException if this collection contains one or more
* null elements and the specified collection does not permit null * null elements and the specified collection does not permit null
* elements * elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null * or if the specified collection is null
* @see #remove(Object) * @see #remove(Object)
* @see #contains(Object) * @see #contains(Object)

4
src/java.base/share/classes/java/util/Collections.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -66,7 +66,7 @@ import java.util.stream.StreamSupport;
* already sorted may or may not throw {@code UnsupportedOperationException}. * already sorted may or may not throw {@code UnsupportedOperationException}.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/Comparator.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -94,7 +94,7 @@ import java.util.Comparators;
* an equivalence relation. * an equivalence relation.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <T> the type of objects that may be compared by this comparator * @param <T> the type of objects that may be compared by this comparator

18
src/java.base/share/classes/java/util/Deque.java
View file

@ -193,7 +193,7 @@ package java.util;
* {@code Object}. * {@code Object}.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Doug Lea * @author Doug Lea
@ -363,10 +363,10 @@ public interface Deque<E> extends Queue<E> {
* @return {@code true} if an element was removed as a result of this call * @return {@code true} if an element was removed as a result of this call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null and this * @throws NullPointerException if the specified element is null and this
* deque does not permit null elements * deque does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean removeFirstOccurrence(Object o); boolean removeFirstOccurrence(Object o);
@ -382,10 +382,10 @@ public interface Deque<E> extends Queue<E> {
* @return {@code true} if an element was removed as a result of this call * @return {@code true} if an element was removed as a result of this call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null and this * @throws NullPointerException if the specified element is null and this
* deque does not permit null elements * deque does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean removeLastOccurrence(Object o); boolean removeLastOccurrence(Object o);
@ -565,10 +565,10 @@ public interface Deque<E> extends Queue<E> {
* @return {@code true} if an element was removed as a result of this call * @return {@code true} if an element was removed as a result of this call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null and this * @throws NullPointerException if the specified element is null and this
* deque does not permit null elements * deque does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean remove(Object o); boolean remove(Object o);
@ -581,10 +581,10 @@ public interface Deque<E> extends Queue<E> {
* @return {@code true} if this deque contains the specified element * @return {@code true} if this deque contains the specified element
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null and this * @throws NullPointerException if the specified element is null and this
* deque does not permit null elements * deque does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean contains(Object o); boolean contains(Object o);

4
src/java.base/share/classes/java/util/EnumMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2012, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2018, 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
@ -68,7 +68,7 @@ import jdk.internal.misc.SharedSecrets;
* {@link HashMap} counterparts. * {@link HashMap} counterparts.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/EnumSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2018, 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
@ -69,7 +69,7 @@ import jdk.internal.misc.SharedSecrets;
* constant time if their argument is also an enum set. * constant time if their argument is also an enum set.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/HashMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -118,7 +118,7 @@ import jdk.internal.misc.SharedSecrets;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <K> the type of keys maintained by this map * @param <K> the type of keys maintained by this map

4
src/java.base/share/classes/java/util/HashSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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 @@ import jdk.internal.misc.SharedSecrets;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements maintained by this set * @param <E> the type of elements maintained by this set

4
src/java.base/share/classes/java/util/Hashtable.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1994, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1994, 2018, 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
@ -107,7 +107,7 @@ import jdk.internal.misc.SharedSecrets;
* *
* <p>As of the Java 2 platform v1.2, this class was retrofitted to * <p>As of the Java 2 platform v1.2, this class was retrofitted to
* implement the {@link Map} interface, making it a member of the * implement the {@link Map} interface, making it a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* *
* Java Collections Framework</a>. Unlike the new collection * Java Collections Framework</a>. Unlike the new collection
* implementations, {@code Hashtable} is synchronized. If a * implementations, {@code Hashtable} is synchronized. If a

4
src/java.base/share/classes/java/util/IdentityHashMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2018, 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
@ -123,7 +123,7 @@ import jdk.internal.misc.SharedSecrets;
* {@link HashMap} (which uses <i>chaining</i> rather than linear-probing). * {@link HashMap} (which uses <i>chaining</i> rather than linear-probing).
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @see System#identityHashCode(Object) * @see System#identityHashCode(Object)

4
src/java.base/share/classes/java/util/Iterator.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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,7 +40,7 @@ import java.util.function.Consumer;
* </ul> * </ul>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @apiNote * @apiNote

4
src/java.base/share/classes/java/util/LinkedHashMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -140,7 +140,7 @@ import java.io.IOException;
* <em>fail-fast</em>, and additionally report {@link Spliterator#ORDERED}. * <em>fail-fast</em>, and additionally report {@link Spliterator#ORDERED}.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @implNote * @implNote

4
src/java.base/share/classes/java/util/LinkedHashSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2018, 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
@ -100,7 +100,7 @@ package java.util;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements maintained by this set * @param <E> the type of elements maintained by this set

4
src/java.base/share/classes/java/util/LinkedList.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -70,7 +70,7 @@ import java.util.function.Consumer;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

4
src/java.base/share/classes/java/util/List.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -115,7 +115,7 @@ import java.util.function.UnaryOperator;
* </ul> * </ul>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements in this list * @param <E> the type of elements in this list

4
src/java.base/share/classes/java/util/ListIterator.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -46,7 +46,7 @@ package java.util;
* {@link #previous()}. * {@link #previous()}.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Josh Bloch * @author Josh Bloch

76
src/java.base/share/classes/java/util/Map.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -141,7 +141,7 @@ import java.io.Serializable;
* </ul> * </ul>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <K> the type of keys maintained by this map * @param <K> the type of keys maintained by this map
@ -187,10 +187,10 @@ public interface Map<K, V> {
* key * key
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not permit null keys * does not permit null keys
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean containsKey(Object key); boolean containsKey(Object key);
@ -207,10 +207,10 @@ public interface Map<K, V> {
* specified value * specified value
* @throws ClassCastException if the value is of an inappropriate type for * @throws ClassCastException if the value is of an inappropriate type for
* this map * this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified value is null and this * @throws NullPointerException if the specified value is null and this
* map does not permit null values * map does not permit null values
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean containsValue(Object value); boolean containsValue(Object value);
@ -235,10 +235,10 @@ public interface Map<K, V> {
* {@code null} if this map contains no mapping for the key * {@code null} if this map contains no mapping for the key
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not permit null keys * does not permit null keys
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
V get(Object key); V get(Object key);
@ -295,10 +295,10 @@ public interface Map<K, V> {
* is not supported by this map * is not supported by this map
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this * @throws NullPointerException if the specified key is null and this
* map does not permit null keys * map does not permit null keys
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
V remove(Object key); V remove(Object key);
@ -608,10 +608,10 @@ public interface Map<K, V> {
* {@code defaultValue} if this map contains no mapping for the key * {@code defaultValue} if this map contains no mapping for the key
* @throws ClassCastException if the key is of an inappropriate type for * @throws ClassCastException if the key is of an inappropriate type for
* this map * this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not permit null keys * does not permit null keys
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V getOrDefault(Object key, V defaultValue) { default V getOrDefault(Object key, V defaultValue) {
@ -690,13 +690,13 @@ public interface Map<K, V> {
* values * values
* @throws ClassCastException if a replacement value is of an inappropriate * @throws ClassCastException if a replacement value is of an inappropriate
* type for this map * type for this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if function or a replacement value is null, * @throws NullPointerException if function or a replacement value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of a replacement value * @throws IllegalArgumentException if some property of a replacement value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ConcurrentModificationException if an entry is found to be * @throws ConcurrentModificationException if an entry is found to be
* removed during iteration * removed during iteration
* @since 1.8 * @since 1.8
@ -757,16 +757,16 @@ public interface Map<K, V> {
* if the implementation supports null values.) * if the implementation supports null values.)
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the key or value is of an inappropriate * @throws ClassCastException if the key or value is of an inappropriate
* type for this map * type for this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V putIfAbsent(K key, V value) { default V putIfAbsent(K key, V value) {
@ -803,13 +803,13 @@ public interface Map<K, V> {
* @return {@code true} if the value was removed * @return {@code true} if the value was removed
* @throws UnsupportedOperationException if the {@code remove} operation * @throws UnsupportedOperationException if the {@code remove} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the key or value is of an inappropriate * @throws ClassCastException if the key or value is of an inappropriate
* type for this map * type for this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default boolean remove(Object key, Object value) { default boolean remove(Object key, Object value) {
@ -852,14 +852,14 @@ public interface Map<K, V> {
* @return {@code true} if the value was replaced * @return {@code true} if the value was replaced
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of a specified key or value * @throws ClassCastException if the class of a specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* @throws NullPointerException if a specified key or newValue is null, * @throws NullPointerException if a specified key or newValue is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* @throws NullPointerException if oldValue is null and this map does not * @throws NullPointerException if oldValue is null and this map does not
* permit null values * permit null values
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of a specified key * @throws IllegalArgumentException if some property of a specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* @since 1.8 * @since 1.8
@ -902,10 +902,10 @@ public interface Map<K, V> {
* if the implementation supports null values.) * if the implementation supports null values.)
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
@ -985,13 +985,13 @@ public interface Map<K, V> {
* is null * is null
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V computeIfAbsent(K key, default V computeIfAbsent(K key,
@ -1062,13 +1062,13 @@ public interface Map<K, V> {
* remappingFunction is null * remappingFunction is null
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V computeIfPresent(K key, default V computeIfPresent(K key,
@ -1154,13 +1154,13 @@ public interface Map<K, V> {
* remappingFunction is null * remappingFunction is null
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @since 1.8 * @since 1.8
*/ */
default V compute(K key, default V compute(K key,
@ -1249,13 +1249,13 @@ public interface Map<K, V> {
* value is associated with the key * value is associated with the key
* @throws UnsupportedOperationException if the {@code put} operation * @throws UnsupportedOperationException if the {@code put} operation
* is not supported by this map * is not supported by this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws ClassCastException if the class of the specified key or value * @throws ClassCastException if the class of the specified key or value
* prevents it from being stored in this map * prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws IllegalArgumentException if some property of the specified key * @throws IllegalArgumentException if some property of the specified key
* or value prevents it from being stored in this map * or value prevents it from being stored in this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key is null and this map * @throws NullPointerException if the specified key is null and this map
* does not support null keys or the value or remappingFunction is * does not support null keys or the value or remappingFunction is
* null * null

2
src/java.base/share/classes/java/util/NavigableMap.java
View file

@ -85,7 +85,7 @@ package java.util;
* {@link #keySet()} can be overridden to return {@link NavigableSet}. * {@link #keySet()} can be overridden to return {@link NavigableSet}.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Doug Lea * @author Doug Lea

2
src/java.base/share/classes/java/util/NavigableSet.java
View file

@ -79,7 +79,7 @@ package java.util;
* {@code NavigableSet}. * {@code NavigableSet}.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Doug Lea * @author Doug Lea

4
src/java.base/share/classes/java/util/PriorityQueue.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2018, 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
@ -74,7 +74,7 @@ import jdk.internal.misc.SharedSecrets;
* ({@code peek}, {@code element}, and {@code size}). * ({@code peek}, {@code element}, and {@code size}).
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

2
src/java.base/share/classes/java/util/Queue.java
View file

@ -128,7 +128,7 @@ package java.util;
* ordering properties. * ordering properties.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

4
src/java.base/share/classes/java/util/RandomAccess.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2018, 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 @@ package java.util;
* </pre> * </pre>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.4 * @since 1.4

6
src/java.base/share/classes/java/util/ResourceBundle.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2018, 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
@ -251,7 +251,7 @@ import static sun.security.util.SecurityConstants.GET_CLASSLOADER_PERMISSION;
* or "{@code java.properties}" format are searched. * or "{@code java.properties}" format are searched.
* *
* <p>If the caller module is a * <p>If the caller module is a
* <a href="{@docRoot}/java/util/spi/ResourceBundleProvider.html#obtain-resource-bundle"> * <a href="{@docRoot}/java.base/java/util/spi/ResourceBundleProvider.html#obtain-resource-bundle">
* resource bundle provider</a>, it does not fall back to the * resource bundle provider</a>, it does not fall back to the
* class loader search. * class loader search.
* *
@ -260,7 +260,7 @@ import static sun.security.util.SecurityConstants.GET_CLASSLOADER_PERMISSION;
* A common format of resource bundles is in {@linkplain PropertyResourceBundle * A common format of resource bundles is in {@linkplain PropertyResourceBundle
* .properties} file format. Typically {@code .properties} resource bundles * .properties} file format. Typically {@code .properties} resource bundles
* are packaged in a JAR file. Resource bundle only JAR file can be readily * are packaged in a JAR file. Resource bundle only JAR file can be readily
* deployed as an <a href="{@docRoot}/java/lang/module/ModuleFinder.html#automatic-modules"> * deployed as an <a href="{@docRoot}/java.base/java/lang/module/ModuleFinder.html#automatic-modules">
* automatic module</a>. For example, if the JAR file contains the * automatic module</a>. For example, if the JAR file contains the
* entry "{@code p/q/Foo_ja.properties}" and no {@code .class} entry, * entry "{@code p/q/Foo_ja.properties}" and no {@code .class} entry,
* when resolved and defined as an automatic module, no package is derived * when resolved and defined as an automatic module, no package is derived

4
src/java.base/share/classes/java/util/Set.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -92,7 +92,7 @@ package java.util;
* </ul> * </ul>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements maintained by this set * @param <E> the type of elements maintained by this set

4
src/java.base/share/classes/java/util/SortedMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2018, 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
@ -93,7 +93,7 @@ package java.util;
* SortedMap&lt;String, V&gt; sub = m.subMap(low+"\0", high);</pre> * SortedMap&lt;String, V&gt; sub = m.subMap(low+"\0", high);</pre>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <K> the type of keys maintained by this map * @param <K> the type of keys maintained by this map

4
src/java.base/share/classes/java/util/SortedSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2018, 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
@ -89,7 +89,7 @@ package java.util;
* SortedSet&lt;String&gt; sub = s.subSet(low+"\0", high);</pre> * SortedSet&lt;String&gt; sub = s.subSet(low+"\0", high);</pre>
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements maintained by this set * @param <E> the type of elements maintained by this set

4
src/java.base/share/classes/java/util/TreeMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1997, 2018, 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
@ -92,7 +92,7 @@ import java.util.function.Consumer;
* associated map using {@code put}.) * associated map using {@code put}.)
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <K> the type of keys maintained by this map * @param <K> the type of keys maintained by this map

4
src/java.base/share/classes/java/util/TreeSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2018, 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
@ -74,7 +74,7 @@ package java.util;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <E> the type of elements maintained by this set * @param <E> the type of elements maintained by this set

4
src/java.base/share/classes/java/util/Vector.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1994, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1994, 2018, 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
@ -70,7 +70,7 @@ import java.util.function.UnaryOperator;
* *
* <p>As of the Java 2 platform v1.2, this class was retrofitted to * <p>As of the Java 2 platform v1.2, this class was retrofitted to
* implement the {@link List} interface, making it a member of the * implement the {@link List} interface, making it a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. Unlike the new collection * Java Collections Framework</a>. Unlike the new collection
* implementations, {@code Vector} is synchronized. If a thread-safe * implementations, {@code Vector} is synchronized. If a thread-safe
* implementation is not needed, it is recommended to use {@link * implementation is not needed, it is recommended to use {@link

4
src/java.base/share/classes/java/util/WeakHashMap.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2018, 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
@ -120,7 +120,7 @@ import java.util.function.Consumer;
* should be used only to detect bugs.</i> * should be used only to detect bugs.</i>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @param <K> the type of keys maintained by this map * @param <K> the type of keys maintained by this map

2
src/java.base/share/classes/java/util/concurrent/ArrayBlockingQueue.java
View file

@ -76,7 +76,7 @@ import java.util.function.Predicate;
* methods of the {@link Collection} and {@link Iterator} interfaces. * methods of the {@link Collection} and {@link Iterator} interfaces.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

18
src/java.base/share/classes/java/util/concurrent/BlockingDeque.java
View file

@ -188,7 +188,7 @@ import java.util.NoSuchElementException;
* the {@code BlockingDeque} in another thread. * the {@code BlockingDeque} in another thread.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.6 * @since 1.6
@ -399,9 +399,9 @@ public interface BlockingDeque<E> extends BlockingQueue<E>, Deque<E> {
* @return {@code true} if an element was removed as a result of this call * @return {@code true} if an element was removed as a result of this call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null * @throws NullPointerException if the specified element is null
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean removeFirstOccurrence(Object o); boolean removeFirstOccurrence(Object o);
@ -417,9 +417,9 @@ public interface BlockingDeque<E> extends BlockingQueue<E>, Deque<E> {
* @return {@code true} if an element was removed as a result of this call * @return {@code true} if an element was removed as a result of this call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null * @throws NullPointerException if the specified element is null
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean removeLastOccurrence(Object o); boolean removeLastOccurrence(Object o);
@ -594,9 +594,9 @@ public interface BlockingDeque<E> extends BlockingQueue<E>, Deque<E> {
* @return {@code true} if this deque changed as a result of the call * @return {@code true} if this deque changed as a result of the call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null * @throws NullPointerException if the specified element is null
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean remove(Object o); boolean remove(Object o);
@ -609,9 +609,9 @@ public interface BlockingDeque<E> extends BlockingQueue<E>, Deque<E> {
* @return {@code true} if this deque contains the specified element * @return {@code true} if this deque contains the specified element
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this deque * is incompatible with this deque
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null * @throws NullPointerException if the specified element is null
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean contains(Object o); boolean contains(Object o);

10
src/java.base/share/classes/java/util/concurrent/BlockingQueue.java
View file

@ -169,7 +169,7 @@ import java.util.Queue;
* the {@code BlockingQueue} in another thread. * the {@code BlockingQueue} in another thread.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5
@ -302,9 +302,9 @@ public interface BlockingQueue<E> extends Queue<E> {
* @return {@code true} if this queue changed as a result of the call * @return {@code true} if this queue changed as a result of the call
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this queue * is incompatible with this queue
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null * @throws NullPointerException if the specified element is null
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean remove(Object o); boolean remove(Object o);
@ -317,9 +317,9 @@ public interface BlockingQueue<E> extends Queue<E> {
* @return {@code true} if this queue contains the specified element * @return {@code true} if this queue contains the specified element
* @throws ClassCastException if the class of the specified element * @throws ClassCastException if the class of the specified element
* is incompatible with this queue * is incompatible with this queue
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified element is null * @throws NullPointerException if the specified element is null
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean contains(Object o); boolean contains(Object o);

2
src/java.base/share/classes/java/util/concurrent/ConcurrentHashMap.java
View file

@ -253,7 +253,7 @@ import jdk.internal.misc.Unsafe;
* <p>All arguments to all task methods must be non-null. * <p>All arguments to all task methods must be non-null.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

2
src/java.base/share/classes/java/util/concurrent/ConcurrentLinkedDeque.java
View file

@ -85,7 +85,7 @@ import java.util.function.Predicate;
* the {@code ConcurrentLinkedDeque} in another thread. * the {@code ConcurrentLinkedDeque} in another thread.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.7 * @since 1.7

2
src/java.base/share/classes/java/util/concurrent/ConcurrentLinkedQueue.java
View file

@ -99,7 +99,7 @@ import java.util.function.Predicate;
* the {@code ConcurrentLinkedQueue} in another thread. * the {@code ConcurrentLinkedQueue} in another thread.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

6
src/java.base/share/classes/java/util/concurrent/ConcurrentMap.java
View file

@ -60,7 +60,7 @@ import java.util.function.Function;
* the {@code ConcurrentMap} in another thread. * the {@code ConcurrentMap} in another thread.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5
@ -180,10 +180,10 @@ public interface ConcurrentMap<K,V> extends Map<K,V> {
* is not supported by this map * is not supported by this map
* @throws ClassCastException if the key or value is of an inappropriate * @throws ClassCastException if the key or value is of an inappropriate
* type for this map * type for this map
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified key or value is null, * @throws NullPointerException if the specified key or value is null,
* and this map does not permit null keys or values * and this map does not permit null keys or values
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
*/ */
boolean remove(Object key, Object value); boolean remove(Object key, Object value);

2
src/java.base/share/classes/java/util/concurrent/ConcurrentNavigableMap.java
View file

@ -43,7 +43,7 @@ import java.util.NavigableSet;
* and recursively so for its navigable sub-maps. * and recursively so for its navigable sub-maps.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Doug Lea * @author Doug Lea

2
src/java.base/share/classes/java/util/concurrent/ConcurrentSkipListMap.java
View file

@ -101,7 +101,7 @@ import java.util.concurrent.atomic.LongAdder;
* elements. * elements.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Doug Lea * @author Doug Lea

4
src/java.base/share/classes/java/util/concurrent/ConcurrentSkipListSet.java
View file

@ -85,7 +85,7 @@ import java.util.Spliterator;
* distinguished from the absence of elements. * distinguished from the absence of elements.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @author Doug Lea * @author Doug Lea
@ -324,7 +324,7 @@ public class ConcurrentSkipListSet<E>
* @return {@code true} if this set changed as a result of the call * @return {@code true} if this set changed as a result of the call
* @throws ClassCastException if the class of an element of this set * @throws ClassCastException if the class of an element of this set
* is incompatible with the specified collection * is incompatible with the specified collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if the specified collection or any * @throws NullPointerException if the specified collection or any
* of its elements are null * of its elements are null
*/ */

10
src/java.base/share/classes/java/util/concurrent/CopyOnWriteArrayList.java
View file

@ -83,7 +83,7 @@ import jdk.internal.misc.SharedSecrets;
* the {@code CopyOnWriteArrayList} in another thread. * the {@code CopyOnWriteArrayList} in another thread.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5
@ -645,10 +645,10 @@ public class CopyOnWriteArrayList<E>
* @return {@code true} if this list changed as a result of the call * @return {@code true} if this list changed as a result of the call
* @throws ClassCastException if the class of an element of this list * @throws ClassCastException if the class of an element of this list
* is incompatible with the specified collection * is incompatible with the specified collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if this list contains a null element and the * @throws NullPointerException if this list contains a null element and the
* specified collection does not permit null elements * specified collection does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null * or if the specified collection is null
* @see #remove(Object) * @see #remove(Object)
*/ */
@ -666,10 +666,10 @@ public class CopyOnWriteArrayList<E>
* @return {@code true} if this list changed as a result of the call * @return {@code true} if this list changed as a result of the call
* @throws ClassCastException if the class of an element of this list * @throws ClassCastException if the class of an element of this list
* is incompatible with the specified collection * is incompatible with the specified collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if this list contains a null element and the * @throws NullPointerException if this list contains a null element and the
* specified collection does not permit null elements * specified collection does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null * or if the specified collection is null
* @see #remove(Object) * @see #remove(Object)
*/ */

10
src/java.base/share/classes/java/util/concurrent/CopyOnWriteArraySet.java
View file

@ -87,7 +87,7 @@ import java.util.function.Predicate;
* }}</pre> * }}</pre>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @see CopyOnWriteArrayList * @see CopyOnWriteArrayList
@ -340,10 +340,10 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E>
* @return {@code true} if this set changed as a result of the call * @return {@code true} if this set changed as a result of the call
* @throws ClassCastException if the class of an element of this set * @throws ClassCastException if the class of an element of this set
* is incompatible with the specified collection * is incompatible with the specified collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if this set contains a null element and the * @throws NullPointerException if this set contains a null element and the
* specified collection does not permit null elements * specified collection does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null * or if the specified collection is null
* @see #remove(Object) * @see #remove(Object)
*/ */
@ -363,10 +363,10 @@ public class CopyOnWriteArraySet<E> extends AbstractSet<E>
* @return {@code true} if this set changed as a result of the call * @return {@code true} if this set changed as a result of the call
* @throws ClassCastException if the class of an element of this set * @throws ClassCastException if the class of an element of this set
* is incompatible with the specified collection * is incompatible with the specified collection
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>) * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>)
* @throws NullPointerException if this set contains a null element and the * @throws NullPointerException if this set contains a null element and the
* specified collection does not permit null elements * specified collection does not permit null elements
* (<a href="{@docRoot}/java/util/Collection.html#optional-restrictions">optional</a>), * (<a href="{@docRoot}/java.base/java/util/Collection.html#optional-restrictions">optional</a>),
* or if the specified collection is null * or if the specified collection is null
* @see #remove(Object) * @see #remove(Object)
*/ */

2
src/java.base/share/classes/java/util/concurrent/DelayQueue.java
View file

@ -67,7 +67,7 @@ import java.util.concurrent.locks.ReentrantLock;
* particular order. * particular order.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

2
src/java.base/share/classes/java/util/concurrent/LinkedBlockingDeque.java
View file

@ -68,7 +68,7 @@ import java.util.function.Predicate;
* methods of the {@link Collection} and {@link Iterator} interfaces. * methods of the {@link Collection} and {@link Iterator} interfaces.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.6 * @since 1.6

2
src/java.base/share/classes/java/util/concurrent/LinkedBlockingQueue.java
View file

@ -71,7 +71,7 @@ import java.util.function.Predicate;
* methods of the {@link Collection} and {@link Iterator} interfaces. * methods of the {@link Collection} and {@link Iterator} interfaces.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

2
src/java.base/share/classes/java/util/concurrent/LinkedTransferQueue.java
View file

@ -81,7 +81,7 @@ import java.util.function.Predicate;
* the {@code LinkedTransferQueue} in another thread. * the {@code LinkedTransferQueue} in another thread.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.7 * @since 1.7

2
src/java.base/share/classes/java/util/concurrent/PriorityBlockingQueue.java
View file

@ -101,7 +101,7 @@ import java.util.function.Consumer;
* }}</pre> * }}</pre>
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

2
src/java.base/share/classes/java/util/concurrent/SynchronousQueue.java
View file

@ -80,7 +80,7 @@ import java.util.concurrent.locks.ReentrantLock;
* methods of the {@link Collection} and {@link Iterator} interfaces. * methods of the {@link Collection} and {@link Iterator} interfaces.
* *
* <p>This class is a member of the * <p>This class is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.5 * @since 1.5

2
src/java.base/share/classes/java/util/concurrent/TransferQueue.java
View file

@ -58,7 +58,7 @@ package java.util.concurrent;
* and {@code transfer} are effectively synonymous. * and {@code transfer} are effectively synonymous.
* *
* <p>This interface is a member of the * <p>This interface is a member of the
* <a href="{@docRoot}/java/util/package-summary.html#CollectionsFramework"> * <a href="{@docRoot}/java.base/java/util/package-summary.html#CollectionsFramework">
* Java Collections Framework</a>. * Java Collections Framework</a>.
* *
* @since 1.7 * @since 1.7

6
src/java.base/share/classes/javax/net/ssl/SNIHostName.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2012, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2012, 2018, 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
@ -290,7 +290,7 @@ public final class SNIHostName extends SNIServerName {
* will accept hostnames "www.example.com" and "www.example.org". * will accept hostnames "www.example.com" and "www.example.org".
* *
* @param regex * @param regex
* the <a href="{@docRoot}/java/util/regex/Pattern.html#sum"> * the <a href="{@docRoot}/java.base/java/util/regex/Pattern.html#sum">
* regular expression pattern</a> * regular expression pattern</a>
* representing the hostname(s) to match * representing the hostname(s) to match
* @return a {@code SNIMatcher} object for {@code SNIHostName}s * @return a {@code SNIMatcher} object for {@code SNIHostName}s
@ -330,7 +330,7 @@ public final class SNIHostName extends SNIServerName {
* Creates an SNIHostNameMatcher object. * Creates an SNIHostNameMatcher object.
* *
* @param regex * @param regex
* the <a href="{@docRoot}/java/util/regex/Pattern.html#sum"> * the <a href="{@docRoot}/java.base/java/util/regex/Pattern.html#sum">
* regular expression pattern</a> * regular expression pattern</a>
* representing the hostname(s) to match * representing the hostname(s) to match
* @throws NullPointerException if {@code regex} is * @throws NullPointerException if {@code regex} is