8210788: Javadoc for Thread.join(long, int) should specify that it waits forever when both arguments are zero

Ivan Gerasimov · Ivan Gerasimov · commit 79c92eadc33c · 2019-01-09T10:59:37.000-08:00
Reviewed-by: martin, rriggs
diff --git a/src/java.base/share/classes/java/lang/Thread.java b/src/java.base/share/classes/java/lang/Thread.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1994, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -1315,6 +1315,7 @@ public final synchronized void join(final long millis)
     /**
      * Waits at most {@code millis} milliseconds plus
      * {@code nanos} nanoseconds for this thread to die.
+     * If both arguments are {@code 0}, it means to wait forever.
      *
      * <p> This implementation uses a loop of {@code this.wait} calls
      * conditioned on {@code this.isAlive}. As a thread terminates the

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,5 @@`
`1`	`1`	`/*`
`2`		`- * Copyright (c) 1994, 2018, Oracle and/or its affiliates. All rights reserved.`
	`2`	`+ * Copyright (c) 1994, 2019, Oracle and/or its affiliates. All rights reserved.`
`3`	`3`	`* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.`
`4`	`4`	`*`
`5`	`5`	`* This code is free software; you can redistribute it and/or modify it`
`@@ -1315,6 +1315,7 @@ public final synchronized void join(final long millis)`
`1315`	`1315`	`/**`
`1316`	`1316`	`* Waits at most {@code millis} milliseconds plus`
`1317`	`1317`	`* {@code nanos} nanoseconds for this thread to die.`
	`1318`	`+ * If both arguments are {@code 0}, it means to wait forever.`
`1318`	`1319`	`*`
`1319`	`1320`	`* <p> This implementation uses a loop of {@code this.wait} calls`
`1320`	`1321`	`* conditioned on {@code this.isAlive}. As a thread terminates the`