2008-01-04 Stefan Huehner <stefan@huehner.org>

	* gnu/CORBA/BigDecimalHelper.java,
	* gnu/CORBA/CDR/AbstractCdrInput.java,
	* gnu/CORBA/CDR/AbstractCdrOutput.java,
	* gnu/CORBA/CDR/HeadlessInput.java,
	* gnu/CORBA/CDR/gnuRuntime.java,
	* gnu/CORBA/Connected_objects.java,
	* gnu/CORBA/GIOP/CancelHeader.java,
	* gnu/CORBA/GIOP/v1_0/CancelHeader.java,
	* gnu/CORBA/IOR.java,
	* gnu/CORBA/Interceptor/Registrator.java,
	* gnu/CORBA/IorDelegate.java,
	* gnu/CORBA/NamingService/NameTransformer.java,
	* gnu/CORBA/ObjectCreator.java,
	* gnu/CORBA/OrbFunctional.java,
	* gnu/CORBA/Poa/AOM.java,
	* gnu/CORBA/Poa/gnuPOA.java,
	* gnu/CORBA/Poa/gnuPOAManager.java,
	* gnu/CORBA/Poa/gnuServantObject.java,
	* gnu/CORBA/typecodes/FixedTypeCode.java,
	* gnu/CORBA/typecodes/RecursiveTypeCode.java,
	* gnu/java/awt/AWTUtilities.java,
	* gnu/java/awt/peer/gtk/CairoGraphics2D.java,
	* gnu/java/awt/peer/gtk/CairoSurface.java,
	* gnu/java/awt/peer/swing/SwingMenuBarPeer.java,
	* gnu/java/text/AttributedFormatBuffer.java,
	* gnu/java/util/regex/REToken.java,
	* gnu/javax/imageio/gif/GIFFile.java,
	* gnu/javax/imageio/png/PNGDecoder.java,
	* gnu/javax/management/Server.java,
	* gnu/javax/naming/giop/ContextContinuation.java,
	* gnu/javax/naming/jndi/url/rmi/ContextContinuation.java,
	* gnu/javax/swing/text/html/css/Selector.java,
	* gnu/javax/swing/text/html/parser/models/node.java,
	* gnu/javax/swing/text/html/parser/support/Parser.java,
	* gnu/javax/swing/text/html/parser/support/low/ReaderTokenizer.java,
	* gnu/javax/swing/text/html/parser/support/textPreProcessor.java,
	* gnu/xml/util/Resolver.java,
	* java/awt/image/AreaAveragingScaleFilter.java,
	* java/beans/Beans.java,
	* java/beans/XMLDecoder.java,
	* java/beans/beancontext/BeanContextServicesSupport.java,
	* java/beans/beancontext/BeanContextSupport.java,
	* java/io/CharArrayWriter.java,
	* java/lang/System.java,
	* java/net/ResolverCache.java,
	* java/util/Calendar.java,
	* java/util/Collections.java,
	* java/util/Formatter.java,
	* javax/accessibility/AccessibleEditableText.java,
	* javax/imageio/ImageReader.java,
	* javax/imageio/ImageTypeSpecifier.java,
	* javax/imageio/ImageWriter.java,
	* javax/imageio/spi/ServiceRegistry.java,
	* javax/imageio/stream/ImageInputStream.java,
	* javax/management/MBeanPermission.java,
	* javax/rmi/CORBA/PortableRemoteObjectDelegate.java,
	* javax/rmi/CORBA/Util.java,
	* javax/rmi/CORBA/UtilDelegate.java,
	* javax/rmi/CORBA/ValueHandler.java,
	* javax/rmi/PortableRemoteObject.java,
	* org/ietf/jgss/GSSContext.java,
	* tools/gnu/classpath/tools/appletviewer/PluginAppletWindow.java,
	* tools/gnu/classpath/tools/appletviewer/StandaloneAppletWindow.java,
	* tools/gnu/classpath/tools/appletviewer/TagParser.java,
	* vm/reference/gnu/java/nio/VMChannel.java:
	Correct javadoc to match the functions' parameters
	* gnu/java/awt/peer/swing/SwingTextFieldPeer.java:
	Rename start_pos parameter to startPos to conform to style.

12 files changed, 29 insertions, 29 deletions

diff --git a/javax/accessibility/AccessibleEditableText.java b/javax/accessibility/AccessibleEditableText.java
index 07d7530e4..308016a39 100644
--- a/javax/accessibility/AccessibleEditableText.java
+++ b/javax/accessibility/AccessibleEditableText.java
@@ -125,7 +125,7 @@ public interface AccessibleEditableText extends AccessibleText
    * Select the text between two points.
    *
    * @param start the start position, inclusive
-   * @param end the end position, exclusive
+   * @param stop the end position, exclusive
    */
   // XXX What happens if indices are out of bounds?
   void selectText(int start, int stop);
diff --git a/javax/imageio/ImageReader.java b/javax/imageio/ImageReader.java
index c7eed06fb..a51eb4221 100644
--- a/javax/imageio/ImageReader.java
+++ b/javax/imageio/ImageReader.java
@@ -429,7 +429,7 @@ public abstract class ImageReader
    * IllegalStateException).  If input is null then the current input
    * source will be removed.
    *
-   * @param input the input source object
+   * @param in the input source object
    * @param seekForwardOnly true if this reader should be allowed to
    * read input from the data stream more than once, false otherwise
    *
@@ -1498,7 +1498,7 @@ public abstract class ImageReader
    * null.  IllegalArgumentException is thrown if either region will
    * contain 0 pixels after clipping.
    *
-   * @param image read parameters, or null
+   * @param param read parameters, or null
    * @param srcWidth the width of the source image
    * @param srcHeight the height of the source image
    * @param image the destination image, or null
@@ -1828,7 +1828,7 @@ public abstract class ImageReader
    * warning listeners will be notified of read progress, changes in
    * sample sets and warnings respectively.
    *
-   * @param the index of the image frame to read
+   * @param imageIndex the index of the image frame to read
    *
    * @return a buffered image
    *
@@ -1855,8 +1855,8 @@ public abstract class ImageReader
    * The source and destination band settings are checked with a call
    * to checkReadParamBandSettings.
    *
-   * @param the index of the image frame to read
-   * @param the image read parameters
+   * @param imageIndex the index of the image frame to read
+   * @param param the image read parameters
    *
    * @return an IIOImage
    *
@@ -1902,7 +1902,7 @@ public abstract class ImageReader
    * Each set of source and destination band settings are checked with
    * a call to checkReadParamBandSettings.
    *
-   * @param an iterator over the image read parameters
+   * @param params iterator over the image read parameters
    *
    * @return an IIOImage
    *
@@ -1938,8 +1938,8 @@ public abstract class ImageReader
    * before this method returns and so listeners will not necessarily
    * be notified.
    *
-   * @param the index of the image frame to read
-   * @param the image read parameters
+   * @param imageIndex the index of the image frame to read
+   * @param param the image read parameters
    *
    * @return a rendered image
    *
diff --git a/javax/imageio/ImageTypeSpecifier.java b/javax/imageio/ImageTypeSpecifier.java
index 05b3a26d4..3faa3c937 100644
--- a/javax/imageio/ImageTypeSpecifier.java
+++ b/javax/imageio/ImageTypeSpecifier.java
@@ -119,7 +119,7 @@ public class ImageTypeSpecifier
    * @param colorSpace the color space
    * @param bankIndices the bank indices at which each band will be
    * stored
-   * @param bandOffsets the starting band offset for each band within
+   * @param bankOffsets the starting band offset for each band within
    * its bank
    * @param dataType the data type, a DataBuffer constant
    * @param hasAlpha true if this image type specifier should have an
@@ -168,8 +168,8 @@ public class ImageTypeSpecifier
    * Create a buffered image with the given dimensions using that has
    * the characteristics specified by this image type specifier.
    *
-   * @param the width of the buffered image, in pixels
-   * @param the height of the buffered image, in pixels
+   * @param width  width of the buffered image, in pixels
+   * @param height the height of the buffered image, in pixels
    *
    * @return a buffered image
    *
diff --git a/javax/imageio/ImageWriter.java b/javax/imageio/ImageWriter.java
index b49e081f0..78d792c72 100644
--- a/javax/imageio/ImageWriter.java
+++ b/javax/imageio/ImageWriter.java
@@ -899,7 +899,7 @@ public abstract class ImageWriter
    * IllegalStateException).  If input is null then the current input
    * source will be removed.
    *
-   * @param input the output destination object
+   * @param output the output destination object
    *
    * @exception IllegalArgumentException if input is not a valid input
    * source for this writer and is not an ImageInputStream
@@ -1338,7 +1338,7 @@ public abstract class ImageWriter
    * @param imageIndex the frame index at which to insert the image
    * @param image the image data, metadata and thumbnails to be
    * inserted
-   * @param the image write parameters, or null
+   * @param param image write parameters, or null
    *
    * @exception IllegalStateException if output is null
    * @exception UnsupportedOperationException if image insertion is
diff --git a/javax/imageio/spi/ServiceRegistry.java b/javax/imageio/spi/ServiceRegistry.java
index 3051a813b..170ea009a 100644
--- a/javax/imageio/spi/ServiceRegistry.java
+++ b/javax/imageio/spi/ServiceRegistry.java
@@ -787,10 +787,10 @@ public class ServiceRegistry
    * @param category the service category to which an ordering
    * constraint is to be added.
    *
-   * @param first the provider which is supposed to come before
+   * @param firstProvider the provider which is supposed to come before
    * <code>second</code>.
    *
-   * @param second the provider which is supposed to come after
+   * @param secondProvider the provider which is supposed to come after
    * <code>first</code>.
    *
    * @throws IllegalArgumentException if <code>first</code> and
@@ -815,10 +815,10 @@ public class ServiceRegistry
    * @param category the service category from which an ordering
    * constraint is to be removed.
    *
-   * @param first the provider which is supposed to come before
+   * @param firstProvider the provider which is supposed to come before
    * <code>second</code>.
    *
-   * @param second the provider which is supposed to come after
+   * @param secondProvider the provider which is supposed to come after
    * <code>first</code>.
    *
    * @throws IllegalArgumentException if <code>first</code> and
diff --git a/javax/imageio/stream/ImageInputStream.java b/javax/imageio/stream/ImageInputStream.java
index a2af6c3e2..4d1b5d57a 100644
--- a/javax/imageio/stream/ImageInputStream.java
+++ b/javax/imageio/stream/ImageInputStream.java
@@ -469,7 +469,7 @@ public interface ImageInputStream
    * @param offset the index of the first element in <code>i</code>
    * that will hold read data.
    *
-   * @param numLongs the number of signed 32-bit integers to read
+   * @param numInts the number of signed 32-bit integers to read
    * (which is one fourth of the number of bytes).
    *
    * @throws IndexOutOfBoundsException if <code>offset</code> or
diff --git a/javax/management/MBeanPermission.java b/javax/management/MBeanPermission.java
index 2c8dfbd62..1ee0e7104 100644
--- a/javax/management/MBeanPermission.java
+++ b/javax/management/MBeanPermission.java
@@ -224,7 +224,7 @@ public class MBeanPermission
    *               or either <code>null</code> or <code>"-"</code> for a
    *               value which may be implied by any member, but not
    *               imply any member itself.
-   * @param objectName the {@link ObjectName} to which this permission applies,
+   * @param name the {@link ObjectName} to which this permission applies,
    *                  or <code>null</code> for a value which may be implied by
    *                  any object name, but not imply any object name itself.
    * @param actions the actions associated with this permission.
diff --git a/javax/rmi/CORBA/PortableRemoteObjectDelegate.java b/javax/rmi/CORBA/PortableRemoteObjectDelegate.java
index 284970763..f376bedfe 100644
--- a/javax/rmi/CORBA/PortableRemoteObjectDelegate.java
+++ b/javax/rmi/CORBA/PortableRemoteObjectDelegate.java
@@ -84,7 +84,7 @@ public interface PortableRemoteObjectDelegate
    * unexported. Also, such object cannot be collected by garbage collector.
    * This is usually impemented via {@link Util#unexportObject}
    * 
-   * @param object the object to export.
+   * @param obj the object to export.
    * 
    * @throws RemoteException
    */
@@ -113,7 +113,7 @@ public interface PortableRemoteObjectDelegate
    * returned stub is also connected to the same ORB. If the target is
    * unconnected, the returned stub is unconnected.
    * 
-   * @param target a server side object.
+   * @param obj a server side object.
    * @return a stub object that can be used to access that server object.
    * 
    * @throws NoSuchObjectException if a stub cannot be located for the given
@@ -127,7 +127,7 @@ public interface PortableRemoteObjectDelegate
    * object to becomes available for garbage collection. This is usually
    * impemented via {@link Util#unexportObject}
    * 
-   * @param object the object to unexport.
+   * @param obj the object to unexport.
    * 
    * @throws NoSuchObjectException if the passed object is not currently
    * exported.
diff --git a/javax/rmi/CORBA/Util.java b/javax/rmi/CORBA/Util.java
index cfd3d7bd6..04b6f63a6 100644
--- a/javax/rmi/CORBA/Util.java
+++ b/javax/rmi/CORBA/Util.java
@@ -332,7 +332,7 @@ public class Util
    * </tr>
    * </table>
    * 
-   * @param ex an exception that was thrown on a server side implementation.
+   * @param exception an exception that was thrown on a server side implementation.
    * 
    * @return the corresponding RemoteException unless it is a RuntimeException.
    * 
diff --git a/javax/rmi/CORBA/UtilDelegate.java b/javax/rmi/CORBA/UtilDelegate.java
index cacb92581..79d740e7b 100644
--- a/javax/rmi/CORBA/UtilDelegate.java
+++ b/javax/rmi/CORBA/UtilDelegate.java
@@ -243,7 +243,7 @@ public interface UtilDelegate
    * </tr>
    * </table>
    * 
-   * @param ex an exception that was thrown on a server side implementation.
+   * @param e an exception that was thrown on a server side implementation.
    * 
    * @return the corresponding RemoteException unless it is a RuntimeException.
    * 
@@ -266,7 +266,7 @@ public interface UtilDelegate
    * 
    * @param output a stream to write to, must be
    * org.omg.CORBA_2_3.portable.OutputStream
-   * @param object an object to write.
+   * @param obj an object to write.
    */
   void writeRemoteObject(OutputStream output, Object obj);
 
diff --git a/javax/rmi/CORBA/ValueHandler.java b/javax/rmi/CORBA/ValueHandler.java
index c4213efdc..acc44aa2f 100644
--- a/javax/rmi/CORBA/ValueHandler.java
+++ b/javax/rmi/CORBA/ValueHandler.java
@@ -114,7 +114,7 @@ public interface ValueHandler
    * When the value provides the writeReplace method, the result of this method
    * is written. Otherwise, the value itself is written.
    * 
-   * @param the value that should be written to the stream.
+   * @param value the value that should be written to the stream.
    * 
    * @return the value that will be actually written to the stream.
    */
diff --git a/javax/rmi/PortableRemoteObject.java b/javax/rmi/PortableRemoteObject.java
index 5bb6b1126..db2ea6b80 100644
--- a/javax/rmi/PortableRemoteObject.java
+++ b/javax/rmi/PortableRemoteObject.java
@@ -97,10 +97,10 @@ public class PortableRemoteObject
    * <code>a_source</code> parameter. The a_target is connected to the same
    * ORB (and, if applicable, to the same {@link POA}) as the a_source.
    * 
-   * @param a_target the target to connect to ORB, must be an instance of either
+   * @param target the target to connect to ORB, must be an instance of either
    * {@link ObjectImpl} (Stubs and old-style ties) or {@link Tie}.
    * 
-   * @param a_source the object, providing the connection information, must be
+   * @param source the object, providing the connection information, must be
    * an instance of either {@link ObjectImpl} (Stubs and old-style ties) or
    * {@link Servant} (the next-generation Ties supporting {@link POA}).
    *