JDK 9 doc-only RFR of 8180353: FileOutputStream documentation does not indicate properly whether files get truncated or not

[Chris Hegarty]

> On 17 May 2017, at 15:55, Daniel Fuchs <daniel.fuchs at oracle.com> wrote:
> 
> On 17/05/2017 02:34, Brian Burkhalter wrote:
>> Hi Chris,
>> 
>> Let’s skip the first revision (May 16, 2017, at 12:54 PM PDT) of the patch and go for this one instead:
>> 
>> --- a/src/java.base/share/classes/java/io/FileOutputStream.java
>> +++ b/src/java.base/share/classes/java/io/FileOutputStream.java
>> @@ -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
>> 
>> Thanks,
> 
> Looks fine!

+1

-Chris.