I've posted a draft of the Javadoc for java.util.stream at:
http://cr.openjdk.java.net/~briangoetz/doctmp/doc/
Review comments on the specification text are welcome. (You don't need
to mention any instances of the <code> tag bleeding through into the
text; this is a Javadoc bug that shows up on links to packages for which
docs are not generated.)