Skip to content
Permalink
Browse files
8259218: (fs) Add links in from overloaded methods in java.nio.file.F…
…iles

Reviewed-by: dfuchs, alanb
  • Loading branch information
Brian Burkhalter committed Mar 10, 2021
1 parent acda812 commit b482733f94a46f4d0984de7ba55ddb52ad6db34c
Showing 1 changed file with 29 additions and 21 deletions.
@@ -2849,9 +2849,10 @@ public static Path walkFileTree(Path start,
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <blockquote><pre>
* walkFileTree(start, EnumSet.noneOf(FileVisitOption.class), Integer.MAX_VALUE, visitor)
* </pre></blockquote>
* <blockquote>{@link
* walkFileTree(Path, Set<FileVisitOption>, int, FileVisitor<? super Path>)
* Files.walkFileTree(start, EnumSet.noneOf(FileVisitOption.class), Integer.MAX_VALUE, visitor)
* }</blockquote>
* In other words, it does not follow symbolic links, and visits all levels
* of the file tree.
*
@@ -2925,9 +2926,10 @@ public static BufferedReader newBufferedReader(Path path, Charset cs)
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <pre>{@code
* <blockquote>{@link
* newBufferedReader(Path, Charset)
* Files.newBufferedReader(path, StandardCharsets.UTF_8)
* }</pre>
* }</blockquote>
*
* @param path
* the path to the file
@@ -3006,9 +3008,10 @@ public static BufferedWriter newBufferedWriter(Path path, Charset cs,
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <pre>{@code
* <blockquote>{@link
* newBufferedWriter(Path, Charset, OpenOption...)
* Files.newBufferedWriter(path, StandardCharsets.UTF_8, options)
* }</pre>
* }</blockquote>
*
* @param path
* the path to the file
@@ -3286,8 +3289,8 @@ public static byte[] readAllBytes(Path path) throws IOException {
* The method ensures that the file is closed when all content have been read
* or an I/O error, or other runtime exception, is thrown.
*
* <p> This method is equivalent to:
* {@code readString(path, StandardCharsets.UTF_8) }
* <p> This method is equivalent to: {@link readString(Path, Charset)
* readString(path, StandardCharsets.UTF_8)}.
*
* @param path the path to the file
*
@@ -3411,9 +3414,10 @@ public static List<String> readAllLines(Path path, Charset cs) throws IOExceptio
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <pre>{@code
* <blockquote>{@link
* readAllLines(Path, Charset)
* Files.readAllLines(path, StandardCharsets.UTF_8)
* }</pre>
* }</blockquote>
*
* @param path
* the path to the file
@@ -3569,9 +3573,10 @@ public static Path write(Path path, Iterable<? extends CharSequence> lines,
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <pre>{@code
* Files.write(path, lines, StandardCharsets.UTF_8, options);
* }</pre>
* <blockquote>{@link
* write(Path, Iterable<? extends CharSequence>, Charset, OpenOption...)
* Files.write(path, lines, StandardCharsets.UTF_8, options)
* }</blockquote>
*
* @param path
* the path to the file
@@ -3612,8 +3617,9 @@ public static Path write(Path path,
* Characters are encoded into bytes using the
* {@link StandardCharsets#UTF_8 UTF-8} {@link Charset charset}.
*
* <p> This method is equivalent to:
* {@code writeString(path, test, StandardCharsets.UTF_8, options) }
* <p> This method is equivalent to: {@link
* writeString(Path, CharSequence, Charset, OpenOption...)
* writeString(path, csq, StandardCharsets.UTF_8, options)}.
*
* @param path
* the path to the file
@@ -3910,9 +3916,10 @@ public static Stream<Path> walk(Path start,
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <blockquote><pre>
* walk(start, Integer.MAX_VALUE, options)
* </pre></blockquote>
* <blockquote>{@link
* walk(Path, int, FileVisitOption...)
* Files.walk(start, Integer.MAX_VALUE, options)
* }</blockquote>
* In other words, it visits all levels of the file tree.
*
* <p> The returned stream contains references to one or more open directories.
@@ -4171,9 +4178,10 @@ private static Stream<String> createBufferedReaderLinesStream(BufferedReader br)
*
* <p> This method works as if invoking it were equivalent to evaluating the
* expression:
* <pre>{@code
* <blockquote>{@link
* lines(Path, Charset)
* Files.lines(path, StandardCharsets.UTF_8)
* }</pre>
* }</blockquote>
*
* @apiNote
* This method must be used within a try-with-resources statement or similar

0 comments on commit b482733

Please sign in to comment.