RFR(s): 8073923: Files.lines() documentation needs clarification

[Alan Bateman]

On 03/03/2015 02:43, Stuart Marks wrote:
> Hi Joe,
>
> Oh yes, good point. Revised webrev:
>
>     http://cr.openjdk.java.net/~smarks/reviews/8073923/webrev.1/
>
One small quibble is "contains an open file" as it's really that the 
stream has a reference to an open file.

The other thing is the list and walk methods where it specifies that the 
returned stream encapsulates one or more DirectoryStream object, a point 
that could be downgraded to an implementation note. It is of course 
important to make it clear that these methods return a stream that has 
references to open directories.

-Alan