8 files changed, 490 insertions, 160 deletions
diff --git a/libjava/java/net/BindException.java b/libjava/java/net/BindException.java
index 3e3255c..3aeedd3 100644
--- a/libjava/java/net/BindException.java
+++ b/libjava/java/net/BindException.java
@@ -1,19 +1,30 @@
-// BindException.java
+/* BindException.java -- An exception occured while binding to a socket
+   Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 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.net;
+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 Warren Levy <warrenl@cygnus.com>
- * @date March 5, 1999.
- */
+package java.net;
 
 /**
  * Written using on-line Java Platform 1.2 API Specification, as well
@@ -21,15 +32,44 @@ package java.net;
  * Status:  Believed complete and correct.
  */
 
+/**
+  * This exception indicates that an error occured while attempting to bind
+  * socket to a particular port.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Warren Levy <warrenl@cygnus.com>
+  * @date March 5, 1999.
+  */
 public class BindException extends SocketException
 {
-  public BindException()
-  {
-    super();
-  }
-
-  public BindException(String msg)
-  {
-    super(msg);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes a new instance of <code>BindException</code> without
+  * a descriptive error message.
+  */
+public
+BindException()
+{
+  super();
+}
+
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>BindException</code> with
+  * a descriptive error message, such as the text from strerror(3).
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+BindException(String message)
+{
+  super(message);
 }
+
+} // class BindException
+
diff --git a/libjava/java/net/ConnectException.java b/libjava/java/net/ConnectException.java
index 449056f..0ac64c8 100644
--- a/libjava/java/net/ConnectException.java
+++ b/libjava/java/net/ConnectException.java
@@ -1,19 +1,31 @@
-// ConnectException.java
+/* ConnectException.java -- An exception occured while connecting to a host
+   Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 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.net;
+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 Warren Levy <warrenl@cygnus.com>
- * @date March 5, 1999.
- */
+
+package java.net;
 
 /**
  * Written using on-line Java Platform 1.2 API Specification, as well
@@ -21,15 +33,45 @@ package java.net;
  * Status:  Believed complete and correct.
  */
 
+/**
+  * This exception indicates that an error occured while attempting to
+  * connect to a remote host.  Often this indicates that the remote host
+  * refused the connection (ie, is not listening on the target socket).
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Warren Levy <warrenl@cygnus.com>
+  * @date March 5, 1999.
+  */
 public class ConnectException extends SocketException
 {
-  public ConnectException()
-  {
-    super();
-  }
-
-  public ConnectException(String msg)
-  {
-    super(msg);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes a new instance of <code>ConnectException</code> without
+  * a descriptive error message.
+  */
+public
+ConnectException()
+{
+  super();
 }
+
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>ConnectException</code> with
+  * a descriptive error message, such as the text from strerror(3).
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+ConnectException(String message)
+{
+  super(message);
+}
+
+} // class ConnectException
+
diff --git a/libjava/java/net/MalformedURLException.java b/libjava/java/net/MalformedURLException.java
index 5ea6480..660f253 100644
--- a/libjava/java/net/MalformedURLException.java
+++ b/libjava/java/net/MalformedURLException.java
@@ -1,19 +1,30 @@
-// MalformedURLException.java
+/* MalformedURLException.java -- A URL was not in a valid format
+   Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 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.net;
+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 Warren Levy <warrenl@cygnus.com>
- * @date March 5, 1999.
- */
+package java.net;
 
 /**
  * Written using on-line Java Platform 1.2 API Specification, as well
@@ -21,15 +32,44 @@ package java.net;
  * Status:  Believed complete and correct.
  */
 
+/**
+  * This exception indicates that a URL passed to an object was not in a
+  * valid format.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Warren Levy <warrenl@cygnus.com>
+  * @date March 5, 1999.
+  */
 public class MalformedURLException extends java.io.IOException
 {
-  public MalformedURLException()
-  {
-    super();
-  }
-
-  public MalformedURLException(String msg)
-  {
-    super(msg);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes a new instance of <code>MalformedURLException</code> without
+  * a descriptive error message.
+  */
+public
+MalformedURLException()
+{
+  super();
+}
+
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>MalformedURLException</code> without
+  * a descriptive error message.
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+MalformedURLException(String message)
+{
+  super(message);
 }
+
+} // class MalformedURLException
+
diff --git a/libjava/java/net/NoRouteToHostException.java b/libjava/java/net/NoRouteToHostException.java
index cb1c5f8..bae9fa9 100644
--- a/libjava/java/net/NoRouteToHostException.java
+++ b/libjava/java/net/NoRouteToHostException.java
@@ -1,19 +1,31 @@
-// NoRouteToHostException.java
+/* NoRouteToHostException.java -- Cannot connect to a host
+   Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 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.net;
+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 Warren Levy <warrenl@cygnus.com>
- * @date March 5, 1999.
- */
+
+package java.net;
 
 /**
  * Written using on-line Java Platform 1.2 API Specification, as well
@@ -21,15 +33,44 @@ package java.net;
  * Status:  Believed complete and correct.
  */
 
+/**
+  * This exception indicates that there is no TCP/IP route to the requested
+  * host.  This is often due to a misconfigured routing table.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Warren Levy <warrenl@cygnus.com>
+  * @date March 5, 1999.
+  */
 public class NoRouteToHostException extends SocketException
 {
-  public NoRouteToHostException()
-  {
-    super();
-  }
-
-  public NoRouteToHostException(String msg)
-  {
-    super(msg);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes an instance of <code>NoRouteToHostException</code>
+  * without a descriptive error message.
+  */
+public
+NoRouteToHostException()
+{
+  super();
 }
+
+/*************************************************************************/
+
+/**
+  * Initializes an instance of <code>NoRouteToHostException</code>
+  * witha descriptive error message, such as the text from strerror(3).
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+NoRouteToHostException(String message)
+{
+  super(message);
+}
+
+} // class NoRouteToHostException
+
diff --git a/libjava/java/net/ProtocolException.java b/libjava/java/net/ProtocolException.java
index 2263457..5556f28 100644
--- a/libjava/java/net/ProtocolException.java
+++ b/libjava/java/net/ProtocolException.java
@@ -1,19 +1,30 @@
-// ProtocolException.java
+/* ProtocolException.java -- A low level protocol error occured
+   Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 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.net;
+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 Warren Levy <warrenl@cygnus.com>
- * @date March 5, 1999.
- */
+package java.net;
 
 /**
  * Written using on-line Java Platform 1.2 API Specification, as well
@@ -21,15 +32,45 @@ package java.net;
  * Status:  Believed complete and correct.
  */
 
+/**
+  * This exception indicates that some sort of low level protocol
+  * exception occured.  Look in the descriptive message (if any) for
+  * details on what went wrong
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Warren Levy <warrenl@cygnus.com>
+  * @date March 5, 1999.
+  */
 public class ProtocolException extends java.io.IOException
 {
-  public ProtocolException()
-  {
-    super();
-  }
-
-  public ProtocolException(String msg)
-  {
-    super(msg);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes a new instance of <code>ProtocolException</code>
+  * without a descriptive error message.
+  */
+public
+ProtocolException()
+{
+  super();
+}
+
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>ProtocolException</code>
+  * with a descriptive error message.
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+ProtocolException(String message)
+{
+  super(message);
 }
+
+} // class ProtocolException
+
diff --git a/libjava/java/net/SocketException.java b/libjava/java/net/SocketException.java
index 847cdc9..37135f3 100644
--- a/libjava/java/net/SocketException.java
+++ b/libjava/java/net/SocketException.java
@@ -1,33 +1,74 @@
-// SocketException.java - Base class for networking exceptions
+/* SocketException.java -- An exception occured while performing a socket op
+   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.
+
+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. */
 
 package java.net;
 
+/* Written using on-line Java Platform 1.2 API Specification.
+ * Believed complete and correct.
+ */
+
 /**
- * @author Per Bothner
- * @date January 6, 1999.
+  * This exception indicates that a generic error occured related to an
+  * operation on a socket.  Check the descriptive message (if any) for
+  * details on the nature of this error
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Per Bothner 
+  * @date January 6, 1999.
+  */
+public class SocketException extends java.io.IOException
+{
+
+/*
+ * Constructors
  */
 
-/** Written using on-line Java Platform 1.2 API Specification.
-  * Believed complete and correct.
+/**
+  * Initializes a new instance of <code>SocketException</code> without
+  * a descriptive error message.
   */
+public
+SocketException()
+{
+  super();
+}
 
-public class SocketException extends java.io.IOException
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>SocketException</code> without
+  * a descriptive error message.
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+SocketException(String message)
 {
-  public SocketException ()
-  {
-    super();
-  }
-
-  public SocketException (String s)
-  {
-    super(s);
-  }
+  super(message);
 }
+
+} // class SocketException
+
diff --git a/libjava/java/net/UnknownHostException.java b/libjava/java/net/UnknownHostException.java
index 12936e0..ad7b25a 100644
--- a/libjava/java/net/UnknownHostException.java
+++ b/libjava/java/net/UnknownHostException.java
@@ -1,34 +1,77 @@
-// UnknownHostException.java
+/* UnknownHostException.java -- The hostname is not unknown
+   Copyright (C) 1998, 1999, 2000, 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.net;
+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 Per Bothner
- * @date January 6, 1999.
- */
+package java.net;
 
 /*
  * Written using on-line Java Platform 1.2 API Specification.
  * Status:  Believed complete and correct.
  */
 
+/**
+  * This exception indicates that an attempt was made to reference a hostname
+  * or IP address that is not valid.  This could possibly indicate that a
+  * DNS problem has occurred, but most often means that the host was not
+  * correctly specified.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Per Bothner 
+  * @date January 6, 1999.
+  */
 public class UnknownHostException extends java.io.IOException
 {
-  public UnknownHostException ()
-  {
-    super();
-  }
-
-  public UnknownHostException (String host)
-  {
-    super(host);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes a new instance of <code>UnknownHostException</code>
+  * without a descriptive error message.
+  */
+public
+UnknownHostException()
+{
+  super();
 }
+
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>UnknownHostException</code>
+  * with a descriptive error message, such as the name of the host
+  * that could not be resolved.
+  *
+  * @param message A message describing the error that occurrred.
+  */
+public
+UnknownHostException(String message)
+{
+  super(message);
+}
+
+} // class UnknownHostException
+
diff --git a/libjava/java/net/UnknownServiceException.java b/libjava/java/net/UnknownServiceException.java
index 20b00bd..f82607a 100644
--- a/libjava/java/net/UnknownServiceException.java
+++ b/libjava/java/net/UnknownServiceException.java
@@ -1,19 +1,30 @@
-// UnknownServiceException.java
+/* UnknownServiceException.java -- A service error occured
+   Copyright (C) 1998, 1999, 2000, 2001 Free Software Foundation, Inc.
 
-/* Copyright (C) 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.net;
+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 Warren Levy <warrenl@cygnus.com>
- * @date March 5, 1999.
- */
+package java.net;
 
 /**
  * Written using on-line Java Platform 1.2 API Specification, as well
@@ -21,15 +32,46 @@ package java.net;
  * Status:  Believed complete and correct.
  */
 
+/**
+  * Contrary to what you might think, this does not indicate that the
+  * TCP/IP service name specified was invalid.  Instead it indicates that
+  * the MIME type returned from a URL could not be determined or that an
+  * attempt was made to write to a read-only URL.
+  *
+  * @author Aaron M. Renn (arenn@urbanophile.com)
+  * @author Warren Levy <warrenl@cygnus.com>
+  * @date March 5, 1999.
+  */
 public class UnknownServiceException extends java.io.IOException
 {
-  public UnknownServiceException()
-  {
-    super();
-  }
-
-  public UnknownServiceException(String msg)
-  {
-    super(msg);
-  }
+
+/*
+ * Constructors
+ */
+
+/**
+  * Initializes a new instance of <code>UnknownServiceException</code>
+  * without a descriptive error message.
+  */
+public
+UnknownServiceException()
+{
+  super();
+}
+
+/*************************************************************************/
+
+/**
+  * Initializes a new instance of <code>UnknownServiceException</code>
+  * without a descriptive error message.
+  *
+  * @param message A message describing the error that occurred.
+  */
+public
+UnknownServiceException(String message)
+{
+  super(message);
 }
+
+} // class UnknownServiceException
+