diff -r efac989a60dd -r 7477a052aecc jdk/src/java.base/share/classes/java/lang/InheritableThreadLocal.java --- a/jdk/src/java.base/share/classes/java/lang/InheritableThreadLocal.java Fri Dec 18 14:43:24 2015 +0100 +++ b/jdk/src/java.base/share/classes/java/lang/InheritableThreadLocal.java Fri Dec 18 16:06:24 2015 +0000 @@ -40,6 +40,11 @@ * maintained in the variable (e.g., User ID, Transaction ID) must be * automatically transmitted to any child threads that are created. * + *

Note: During the creation of a new {@link + * Thread#Thread(ThreadGroup,Runnable,String,long,boolean) thread}, it is + * possible to opt out of receiving initial values for inheritable + * thread-local variables. + * * @author Josh Bloch and Doug Lea * @see ThreadLocal * @since 1.2