I have updated of this document to reflect comments so far. It is stored to CR (in place) and enclosed here. — John Link: http://cr.openjdk.java.net/~jrose/values/shady-values.html