DataInput.java: Merge with Classpath.

	* java/io/DataInput.java:  Merge with Classpath.
	* java/io/DataOutput.java:  Idem.
	* java/io/FilenameFilter.java:  Idem.
	* java/io/Serializable.java:  Idem.
	* java/lang/Cloneable.java:  Idem.
	* java/lang/Comparable.java:  Idem.
	* java/lang/Runnable.java:  Idem.
	* java/lang/reflect/Member.java:  Idem.
	* java/net/ContentHandlerFactory.java:  Idem.
	* java/net/FileNameMap.java:  Idem.
	* java/net/SocketImplFactory.java:  Idem.
	* java/net/SocketOptions.java:  Idem.
	* java/net/URLStreamHandlerFactory.java:  Idem.

From-SVN: r45910

1 files changed, 204 insertions, 31 deletions

diff --git a/libjava/java/io/DataOutput.java b/libjava/java/io/DataOutput.java
index d0def85..bb6c3c6 100644
--- a/libjava/java/io/DataOutput.java
+++ b/libjava/java/io/DataOutput.java
@@ -1,44 +1,217 @@
-// DataOutput.java - Interface for data output conversions.
+/* DataOutput.java -- Interface for writing data from a stream
+   Copyright (C) 1998, 1999, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 1998, 1999  Free Software Foundation
+This file is part of GNU Classpath.
 
-   This file is part of libgcj.
+GNU Classpath is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+ 
+GNU Classpath is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+General Public License for more details.
 
-This software is copyrighted work licensed under the terms of the
-Libgcj License.  Please consult the file "LIBGCJ_LICENSE" for
-details.  */
+You should have received a copy of the GNU General Public License
+along with GNU Classpath; see the file COPYING.  If not, write to the
+Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+02111-1307 USA.
 
-package java.io;
+As a special exception, if you link this library with other files to
+produce an executable, this library does not by itself cause the
+resulting executable to be covered by the GNU General Public License.
+This exception does not however invalidate any other reasons why the
+executable file might be covered by the GNU General Public License. */
 
-/**
- * @author Tom Tromey <tromey@cygnus.com>
- * @date September 24, 1998 
- */ 
+
+package java.io;
 
 /* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
  * "The Java Language Specification", ISBN 0-201-63451-1
  * Status:  Complete to version 1.1.
  */
 
+/**
+  * This interface is implemented by classes that can wrte data to streams 
+  * from Java primitive types.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Tom Tromey <tromey@cygnus.com>
+  */
 public interface DataOutput
 {
-  public abstract void write (int b) throws IOException;
-  public abstract void write (byte[] b)
-    throws IOException, NullPointerException;
-  public abstract void write (byte[] b, int off, int len)
-    throws IOException, NullPointerException, IndexOutOfBoundsException;
-  public abstract void writeBoolean (boolean v) throws IOException;
-  public abstract void writeByte (int v) throws IOException;
-  public abstract void writeShort (int v) throws IOException;
-  public abstract void writeChar (int v) throws IOException;
-  public abstract void writeInt (int v) throws IOException;
-  public abstract void writeLong (long v) throws IOException;
-  public abstract void writeFloat (float v) throws IOException;
-  public abstract void writeDouble (double v) throws IOException;
-  public abstract void writeBytes (String s)
-    throws IOException, NullPointerException;
-  public abstract void writeChars (String s)
-    throws IOException, NullPointerException;
-  public abstract void writeUTF (String s)
-    throws IOException, NullPointerException;
-}
+
+/**
+  * This method writes a Java boolean value to an output stream
+  *
+  * @param value The boolean value to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeBoolean(boolean value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java byte value to an output stream
+  *
+  * @param value The int value to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeByte(int value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java char value to an output stream
+  *
+  * @param value The char value to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeChar(int value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java int value to an output stream as a 16 bit value
+  *
+  * @param value The int value to write as a 16-bit value
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeShort(int value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java int value to an output stream
+  *
+  * @param value The int value to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeInt(int value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java long value to an output stream
+  *
+  * @param value The long value to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeLong(long value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java float value to an output stream
+  *
+  * @param value The float value to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeFloat(float value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a Java double value to an output stream
+  *
+  * @param value The double value to write
+  *
+  * @exception IOException If any other error occurs
+  */
+void
+writeDouble(double value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a String to an output stream as an array of bytes
+  *
+  * @param value The String to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeBytes(String value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a String to an output stream as an array of char's
+  *
+  * @param value The String to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeChars(String value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes a String to an output stream encoded in
+  * UTF-8 format.
+  *
+  * @param value The String to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+writeUTF(String value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes an 8-bit value (passed into the method as a Java
+  * int) to an output stream.
+  *
+  * @param value The byte to write to the output stream
+  *
+  * @exception IOException If an error occurs
+  */
+void
+write(int value) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes the raw byte array passed in to the output stream.
+  *
+  * @param buf The byte array to write
+  *
+  * @exception IOException If an error occurs
+  */
+void
+write(byte[] buf) throws IOException;
+
+/*************************************************************************/
+
+/**
+  * This method writes raw bytes from the passed array <code>buf</code> starting
+  * <code>offset</code> bytes into the buffer.  The number of bytes written will be
+  * exactly <code>len</code>. 
+  *
+  * @param buf The buffer from which to write the data
+  * @param offset The offset into the buffer to start writing data from
+  * @param len The number of bytes to write from the buffer to the output stream
+  *
+  * @exception IOException If any other error occurs
+  */
+void
+write(byte[] buf, int offset, int len) throws IOException;
+
+} // interface DataOutput