src/java.base/share/classes/java/nio/file/DirectoryStream.java

rev 53930 : 8148917: enhanced-for statement should allow streams
Reviewed-by: XXX

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2007, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2007, 2019, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -32,14 +32,14 @@
 /**
  * An object to iterate over the entries in a directory. A directory stream
  * allows for the convenient use of the for-each construct to iterate over a
  * directory.
  *
- * <p> <b> While {@code DirectoryStream} extends {@code Iterable}, it is not a
+ * <p> {@code DirectoryStream} extends {@code IterableOnce}. It is not a
  * general-purpose {@code Iterable} as it supports only a single {@code
  * Iterator}; invoking the {@link #iterator iterator} method to obtain a second
- * or subsequent iterator throws {@code IllegalStateException}. </b>
+ * or subsequent iterator throws {@code IllegalStateException}.
  *
  * <p> An important property of the directory stream's {@code Iterator} is that
  * its {@link Iterator#hasNext() hasNext} method is guaranteed to read-ahead by
  * at least one element. If {@code hasNext} method returns {@code true}, and is
  * followed by a call to the {@code next} method, it is guaranteed that the

@@ -115,11 +115,11 @@
  *
  * @see Files#newDirectoryStream(Path)
  */
 
 public interface DirectoryStream<T>
-    extends Closeable, Iterable<T> {
+    extends Closeable, IterableOnce<T> {
     /**
      * An interface that is implemented by objects that decide if a directory
      * entry should be accepted or filtered. A {@code Filter} is passed as the
      * parameter to the {@link Files#newDirectoryStream(Path,DirectoryStream.Filter)}
      * method when opening a directory to iterate over the entries in the