8180353: FileOutputStream documentation does not indicate properly whether files get truncated or not
authorbpb
Tue, 23 May 2017 11:47:52 -0700
changeset 45330 d33052a04c7b
parent 45329 9a5dc512845a
child 45331 f829a12aff54
8180353: FileOutputStream documentation does not indicate properly whether files get truncated or not Summary: Update documentation of FileOutputStream(String) Reviewed-by: chegar, dfuchs
jdk/src/java.base/share/classes/java/io/FileOutputStream.java
--- a/jdk/src/java.base/share/classes/java/io/FileOutputStream.java	Tue May 23 11:33:01 2017 +0100
+++ b/jdk/src/java.base/share/classes/java/io/FileOutputStream.java	Tue May 23 11:47:52 2017 -0700
@@ -91,6 +91,10 @@
      * If the file exists but is a directory rather than a regular file, does
      * not exist but cannot be created, or cannot be opened for any other
      * reason then a <code>FileNotFoundException</code> is thrown.
+     * <p>
+     * @implSpec Invoking this constructor with the parameter {@code name} is
+     * equivalent to invoking {@link #FileOutputStream(String,boolean)
+     * new FileOutputStream(name, false)}.
      *
      * @param      name   the system-dependent filename
      * @exception  FileNotFoundException  if the file exists but is a directory