diff -r 826d3d9a874a -r 2cf6bc8c2d2c jdk/src/java.base/share/classes/java/nio/file/Files.java --- a/jdk/src/java.base/share/classes/java/nio/file/Files.java Fri Oct 31 13:21:51 2014 -0400 +++ b/jdk/src/java.base/share/classes/java/nio/file/Files.java Mon Nov 03 15:33:11 2014 +0000 @@ -303,7 +303,7 @@ * is a {@link java.nio.channels.FileChannel}. * *
Usage Examples: - *
+ ** * @param path * the path to the file to open or create @@ -1702,7 +1703,8 @@ * Alternatively, suppose we want to read file's POSIX attributes without * following symbolic links: *{@code * Path path = ... * * // open file for reading @@ -314,9 +314,10 @@ * WritableByteChannel wbc = Files.newByteChannel(path, EnumSet.of(CREATE,APPEND)); * * // create file with initial permissions, opening it for both reading and writing - * {@code FileAttribute+ * FileAttribute> perms = ...} - * SeekableByteChannel sbc = Files.newByteChannel(path, EnumSet.of(CREATE_NEW,READ,WRITE), perms); - * > perms = ... + * SeekableByteChannel sbc = + * Files.newByteChannel(path, EnumSet.of(CREATE_NEW,READ,WRITE), perms); + * }
- * PosixFileAttributes attrs = Files.readAttributes(path, PosixFileAttributes.class, NOFOLLOW_LINKS); + * PosixFileAttributes attrs = + * Files.readAttributes(path, PosixFileAttributes.class, NOFOLLOW_LINKS); ** * @param @@ -2840,6 +2842,8 @@ * @return a new buffered writer, with default buffer size, to write text * to the file * + * @throws IllegalArgumentException + * if {@code options} contains an invalid combination of options * @throws IOException * if an I/O error occurs opening or creating the file * @throws UnsupportedOperationException @@ -2880,6 +2884,8 @@ * @return a new buffered writer, with default buffer size, to write text * to the file * + * @throws IllegalArgumentException + * if {@code options} contains an invalid combination of options * @throws IOException * if an I/O error occurs opening or creating the file * @throws UnsupportedOperationException @@ -2891,7 +2897,9 @@ * * @since 1.8 */ - public static BufferedWriter newBufferedWriter(Path path, OpenOption... options) throws IOException { + public static BufferedWriter newBufferedWriter(Path path, OpenOption... options) + throws IOException + { return newBufferedWriter(path, StandardCharsets.UTF_8, options); } @@ -3273,6 +3281,8 @@ * * @return the path * + * @throws IllegalArgumentException + * if {@code options} contains an invalid combination of options * @throws IOException * if an I/O error occurs writing to or creating the file * @throws UnsupportedOperationException @@ -3330,6 +3340,8 @@ * * @return the path * + * @throws IllegalArgumentException + * if {@code options} contains an invalid combination of options * @throws IOException * if an I/O error occurs writing to or creating the file, or the * text cannot be encoded using the specified charset @@ -3376,6 +3388,8 @@ * * @return the path * + * @throws IllegalArgumentException + * if {@code options} contains an invalid combination of options * @throws IOException * if an I/O error occurs writing to or creating the file, or the * text cannot be encoded as {@code UTF-8} @@ -3452,7 +3466,7 @@ final Iterator