--- a/jdk/src/share/classes/java/io/Closeable.java	Wed Aug 17 22:47:12 2011 -0700
+++ b/jdk/src/share/classes/java/io/Closeable.java	Thu Aug 18 16:47:20 2011 +0100
@@ -42,6 +42,12 @@
      * with it. If the stream is already closed then invoking this
      * method has no effect.
      *
+     * <p> As noted in {@link AutoCloseable#close()}, cases where the
+     * close may fail require careful attention. It is strongly advised
+     * to relinquish the underlying resources and to internally
+     * <em>mark</em> the {@code Closeable} as closed, prior to throwing
+     * the {@code IOException}.
+     *
      * @throws IOException if an I/O error occurs
      */
     public void close() throws IOException;