Spec review request

[Brian Goetz]

I believe the spec for all classes in java.util.stream is ready for API 
review.  Please see current docs here:

   http://cr.openjdk.java.net/~briangoetz/doctmp/doc/

Some notes:
  - The package docs are not yet done; when they are finished, links to 
the package docs will be added in appropriate places.
  - Ignore instances of <code>...</code> in the doc.  This is an 
artifact of @link'ing to classes in a package for which doc is not 
generated.
  - Any loose ends still in flight may have yet to be reflected.