8058924: FileReader(String) documentation is insufficient

Reviewed-by: naoto, lancea
This commit is contained in:
Brian Burkhalter 2022-03-14 16:10:15 +00:00
parent 08573cc3b2
commit 13cebffe61

View file

@ -1,5 +1,5 @@
/*
* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
* Copyright (c) 1998, 2022, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
@ -27,10 +27,14 @@
* Provides for system input and output through data streams,
* serialization and the file system.
*
* Unless otherwise noted, passing a null argument to a constructor or
* Unless otherwise noted, passing a {@code null} argument to a constructor or
* method in any class or interface in this package will cause a
* {@code NullPointerException} to be thrown.
*
* A <i>pathname string</i> passed as a {@code String} argument to a
* constructor or method in any class or interface in this package will be
* interpreted as described in the class specification of {@link File}.
*
* <h2>Object Serialization</h2>
* <p><strong>Warning: Deserialization of untrusted data is inherently dangerous
* and should be avoided. Untrusted data should be carefully validated according to the