changeset 17159:54e8bad0022c

8180353: FileOutputStream documentation does not indicate properly whether files get truncated or not Summary: Update documentation of FileOutputStream(String) Reviewed-by: chegar, dfuchs
author bpb
date Tue, 23 May 2017 11:47:52 -0700
parents 82ab8dec02ae
children 321f66c89406
files src/java.base/share/classes/java/io/FileOutputStream.java
diffstat 1 files changed, 4 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.base/share/classes/java/io/FileOutputStream.java	Tue May 23 11:33:01 2017 +0100
+++ b/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