jdk-sandbox: src/java.base/share/classes/java/io/package-info.java@61fff1345ee6 (annotated)

30788 ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	1	/*
45138 ddcafe0d0ea3 8180082: Broken javadoc links rriggs parents: 30788 diff changeset	2	* Copyright (c) 1998, 2017, Oracle and/or its affiliates. All rights reserved.
30788 ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	3	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	4	*
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	5	* This code is free software; you can redistribute it and/or modify it
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	6	* under the terms of the GNU General Public License version 2 only, as
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	7	* published by the Free Software Foundation. Oracle designates this
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	8	* particular file as subject to the "Classpath" exception as provided
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	9	* by Oracle in the LICENSE file that accompanied this code.
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	10	*
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	11	* This code is distributed in the hope that it will be useful, but WITHOUT
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	12	* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	13	* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	14	* version 2 for more details (a copy is included in the LICENSE file that
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	15	* accompanied this code).
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	16	*
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	17	* You should have received a copy of the GNU General Public License version
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	18	* 2 along with this work; if not, write to the Free Software Foundation,
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	19	* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	20	*
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	21	* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	22	* or visit www.oracle.com if you need additional information or have any
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	23	* questions.
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	24	*/
2 90ce3da70b43 Initial load duke parents: diff changeset	25
30788 ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	26	/**
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	27	* Provides for system input and output through data streams,
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	28	* serialization and the file system.
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	29	*
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	30	* Unless otherwise noted, passing a null argument to a constructor or
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	31	* method in any class or interface in this package will cause a
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	32	* {@code NullPointerException} to be thrown.
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	33	*
49438 879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	34	* <h2>Object Serialization</h2>
879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	35	* <p><strong>Warning: Deserialization of untrusted data is inherently dangerous
879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	36	* and should be avoided. Untrusted data should be carefully validated according to the
879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	37	* "Serialization and Deserialization" section of the
879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	38	* {@extLink secure_coding_guidelines_javase Secure Coding Guidelines for Java SE}.
879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	39	* </strong></p>
30788 ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	40	* <ul>
45138 ddcafe0d0ea3 8180082: Broken javadoc links rriggs parents: 30788 diff changeset	41	* <li><a href="{@docRoot}/../specs/serialization/index.html">
ddcafe0d0ea3 8180082: Broken javadoc links rriggs parents: 30788 diff changeset	42	* Java Object Serialization Specification </a>
49438 879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	43	* <li>{@extLink serialization_filter_guide Serial Filtering} best practices</li>
879cf9f18688 8197595: Serialization javadoc should link to security best practices rriggs parents: 47216 diff changeset	44	* <li>{@extLink serialver_tool_reference The serialver tool}</li>
30788 ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	45	* </ul>
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	46	*
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	47	* @since 1.0
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	48	*/
ea573d35531a 8080901: Replace package.html files with package-info.java in the java.base module darcy parents: 25859 diff changeset	49	package java.io;

author	bpb
	Thu, 06 Jun 2019 08:11:25 -0700
changeset 55259	61fff1345ee6
parent 49438	879cf9f18688
permissions	-rw-r--r--