8180353: FileOutputStream documentation does not indicate properly whether files get truncated or not
Summary: Update documentation of FileOutputStream(String)
Reviewed-by: chegar, dfuchs
--- 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