Authenticator.java, [...]: Fixed javadocs, coding style and argument names all over.

2004-04-20  Michael Koch  <konqueror@gmx.de>

	* java/net/Authenticator.java,
	java/net/BindException.java,
	java/net/ConnectException.java,
	java/net/ContentHandler.java,
	java/net/ContentHandlerFactory.java,
	java/net/DatagramPacket.java,
	java/net/DatagramSocket.java,
	java/net/DatagramSocketImpl.java,
	java/net/DatagramSocketImplFactory.java,
	java/net/FileNameMap.java,
	java/net/HttpURLConnection.java,
	java/net/Inet4Address.java,
	java/net/Inet6Address.java,
	java/net/InetAddress.java,
	java/net/InetSocketAddress.java,
	java/net/JarURLConnection.java,
	java/net/MalformedURLException.java,
	java/net/MulticastSocket.java,
	java/net/NetPermission.java,
	java/net/NetworkInterface.java,
	java/net/NoRouteToHostException.java,
	java/net/PasswordAuthentication.java,
	java/net/PortUnreachableException.java,
	java/net/ProtocolException.java,
	java/net/ServerSocket.java,
	java/net/Socket.java,
	java/net/SocketAddress.java,
	java/net/SocketException.java,
	java/net/SocketImpl.java,
	java/net/SocketImplFactory.java,
	java/net/SocketOptions.java,
	java/net/SocketPermission.java,
	java/net/SocketTimeoutException.java,
	java/net/URI.java,
	java/net/URISyntaxException.java,
	java/net/URL.java,
	java/net/URLClassLoader.java,
	java/net/URLConnection.java,
	java/net/URLDecoder.java,
	java/net/URLEncoder.java,
	java/net/URLStreamHandler.java,
	java/net/URLStreamHandlerFactory.java,
	java/net/UnknownHostException.java,
	java/net/UnknownServiceException.java:
	Fixed javadocs, coding style and argument names all over.

From-SVN: r80900

1 files changed, 62 insertions, 60 deletions

diff --git a/libjava/java/net/URLEncoder.java b/libjava/java/net/URLEncoder.java
index 24d0d25b..fbabb0f 100644
--- a/libjava/java/net/URLEncoder.java
+++ b/libjava/java/net/URLEncoder.java
@@ -7,7 +7,7 @@ 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
@@ -39,29 +39,30 @@ package java.net;
 
 import java.io.UnsupportedEncodingException;
 
+
 /*
  * Written using on-line Java Platform 1.2/1.4 API Specification, as well
  * as "The Java Class Libraries", 2nd edition (Addison-Wesley, 1998).
  * Status:  Believed complete and correct.
  */
 
- /**
-  * This utility class contains static methods that converts a 
-  * string into a fully encoded URL string in x-www-form-urlencoded
-  * format.  This format replaces certain disallowed characters with
-  * encoded equivalents.  All upper case and lower case letters in the
-  * US alphabet remain as is, the space character (' ') is replaced with
-  * '+' sign, and all other characters are converted to a "%XX" format
-  * where XX is the hexadecimal representation of that character in a
-  * certain encoding (by default, the platform encoding, though the
-  * standard is "UTF-8").
-  * <p>
-  * This method is very useful for encoding strings to be sent to CGI scripts
-  *
-  * @author Aaron M. Renn (arenn@urbanophile.com)
-  * @author Warren Levy <warrenl@cygnus.com>
-  * @author Mark Wielaard (mark@klomp.org)
-  */
+/**
+ * This utility class contains static methods that converts a
+ * string into a fully encoded URL string in x-www-form-urlencoded
+ * format.  This format replaces certain disallowed characters with
+ * encoded equivalents.  All upper case and lower case letters in the
+ * US alphabet remain as is, the space character (' ') is replaced with
+ * '+' sign, and all other characters are converted to a "%XX" format
+ * where XX is the hexadecimal representation of that character in a
+ * certain encoding (by default, the platform encoding, though the
+ * standard is "UTF-8").
+ * <p>
+ * This method is very useful for encoding strings to be sent to CGI scripts
+ *
+ * @author Aaron M. Renn (arenn@urbanophile.com)
+ * @author Warren Levy <warrenl@cygnus.com>
+ * @author Mark Wielaard (mark@klomp.org)
+ */
 public class URLEncoder
 {
   /**
@@ -82,11 +83,11 @@ public class URLEncoder
       {
 	// We default to 8859_1 for compatibility with the same
 	// default elsewhere in the library.
-        return encode(s, System.getProperty("file.encoding", "8859_1"));
+	return encode(s, System.getProperty("file.encoding", "8859_1"));
       }
     catch (UnsupportedEncodingException uee)
       {
-        // Should never happen since default should always be supported
+	// Should never happen since default should always be supported
 	return s;
       }
   }
@@ -114,42 +115,42 @@ public class URLEncoder
 
     StringBuffer result = new StringBuffer(length);
     while (true)
-    {
-      while ( i < length && isSafe(s.charAt(i)) )
-	i++;
-
-      // Safe character can just be added
-      result.append(s.substring(start, i));
-
-      // Are we done?
-      if (i >= length)
-	return result.toString();
-      else if (s.charAt(i) == ' ')
-        {
-	  result.append('+');  // Replace space char with plus symbol.
+      {
+	while (i < length && isSafe(s.charAt(i)))
 	  i++;
-	}
-      else
-	{
-	  // Get all unsafe characters
-	  start = i;
-	  char c;
-	  while ( i < length && (c = s.charAt(i)) != ' ' && !isSafe(c) )
-	    i++;
 
-	  // Convert them to %XY encoded strings
-	  String unsafe = s.substring(start,i);
-	  byte bytes[] = unsafe.getBytes(encoding);
-	  for (int j = 0; j < bytes.length; j++)
-	    {
-	      result.append('%');
-	      int val = bytes[j];
-	      result.append(hex.charAt((val & 0xf0) >> 4));
-	      result.append(hex.charAt(val & 0x0f));
-	    }
-	}
-      start = i;
-    }
+	// Safe character can just be added
+	result.append(s.substring(start, i));
+
+	// Are we done?
+	if (i >= length)
+	  return result.toString();
+	else if (s.charAt(i) == ' ')
+	  {
+	    result.append('+'); // Replace space char with plus symbol.
+	    i++;
+	  }
+	else
+	  {
+	    // Get all unsafe characters
+	    start = i;
+	    char c;
+	    while (i < length && (c = s.charAt(i)) != ' ' && ! isSafe(c))
+	      i++;
+
+	    // Convert them to %XY encoded strings
+	    String unsafe = s.substring(start, i);
+	    byte[] bytes = unsafe.getBytes(encoding);
+	    for (int j = 0; j < bytes.length; j++)
+	      {
+		result.append('%');
+		int val = bytes[j];
+		result.append(hex.charAt((val & 0xf0) >> 4));
+		result.append(hex.charAt(val & 0x0f));
+	      }
+	  }
+	start = i;
+      }
   }
 
   /**
@@ -160,17 +161,18 @@ public class URLEncoder
    */
   private static boolean isSafe(char c)
   {
-    return  ((c >= 'a' && c <= 'z') ||
-	     (c >= 'A' && c <= 'Z') ||
-	     (c >= '0' && c <= '9') ||
-	     c == '-' || c == '_' || c == '.' || c == '*');
+    return ((c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z')
+           || (c >= '0' && c <= '9') || c == '-' || c == '_' || c == '.'
+           || c == '*');
   }
 
   /**
    * Private constructor that does nothing. Included to avoid a default
    * public constructor being created by the compiler.
    */
-  private URLEncoder() { }
+  private URLEncoder()
+  {
+  }
 
   /**
    * Used to convert to hex.  We don't use Integer.toHexString, since
@@ -179,4 +181,4 @@ public class URLEncoder
    * leading 0.
    */
   private static final String hex = "0123456789ABCDEF";
-} // class URLEncoder
+}