[kaffe] CVS kaffe (robilad): Resynced with GNU Classpath: Fixed javadocs and method argument names all over

Kaffe CVS cvs-commits at kaffe.org
Wed Nov 24 14:46:16 PST 2004


PatchSet 5477 
Date: 2004/11/24 21:49:14
Author: robilad
Branch: HEAD
Tag: (none) 
Log:
Resynced with GNU Classpath: Fixed javadocs and method argument names all over

Members: 
	ChangeLog:1.3023->1.3024 
	libraries/javalib/java/awt/BasicStroke.java:1.4->1.5 
	libraries/javalib/java/awt/Button.java:1.5->1.6 
	libraries/javalib/java/awt/Canvas.java:1.15->1.16 
	libraries/javalib/java/awt/CheckboxMenuItem.java:1.12->1.13 
	libraries/javalib/java/awt/Container.java:1.26->1.27 
	libraries/javalib/java/awt/EventQueue.java:1.12->1.13 
	libraries/javalib/java/awt/FileDialog.java:1.7->1.8 
	libraries/javalib/java/awt/FlowLayout.java:1.10->1.11 
	libraries/javalib/java/awt/FontMetrics.java:1.13->1.14 
	libraries/javalib/java/awt/Graphics.java:1.10->1.11 
	libraries/javalib/java/awt/GridLayout.java:1.9->1.10 
	libraries/javalib/java/awt/KeyboardFocusManager.java:1.7->1.8 
	libraries/javalib/java/awt/Label.java:1.5->1.6 
	libraries/javalib/java/awt/LayoutManager2.java:1.5->1.6 
	libraries/javalib/java/awt/List.java:1.3->1.4 
	libraries/javalib/java/awt/MenuBar.java:1.9->1.10 
	libraries/javalib/java/awt/Scrollbar.java:1.5->1.6 
	libraries/javalib/java/awt/Toolkit.java:1.20->1.21 
	libraries/javalib/java/awt/Window.java:1.23->1.24 
	libraries/javalib/java/awt/datatransfer/DataFlavor.java:1.16->1.17 
	libraries/javalib/java/awt/datatransfer/FlavorTable.java:1.1->1.2 
	libraries/javalib/java/awt/event/ActionListener.java:1.3->1.4 
	libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java:1.1->1.2 
	libraries/javalib/java/awt/geom/Arc2D.java:1.6->1.7 
	libraries/javalib/java/awt/geom/Rectangle2D.java:1.4->1.5 
	libraries/javalib/java/awt/geom/RectangularShape.java:1.1->1.2 
	libraries/javalib/java/awt/im/spi/InputMethod.java:1.1->1.2 
	libraries/javalib/java/awt/image/ByteLookupTable.java:1.2->1.3 
	libraries/javalib/java/awt/image/ColorModel.java:1.13->1.14 
	libraries/javalib/java/awt/image/DirectColorModel.java:1.12->1.13 
	libraries/javalib/java/awt/image/ShortLookupTable.java:1.2->1.3 
	libraries/javalib/java/awt/print/Book.java:1.1->1.2 

Index: kaffe/ChangeLog
diff -u kaffe/ChangeLog:1.3023 kaffe/ChangeLog:1.3024
--- kaffe/ChangeLog:1.3023	Wed Nov 24 04:04:32 2004
+++ kaffe/ChangeLog	Wed Nov 24 21:49:14 2004
@@ -1,5 +1,77 @@
 2004-11-24  Dalibor Topic  <robilad at kaffe.org>
 
+	* libraries/javalib/java/awt/BasicStroke.java,
+	libraries/javalib/java/awt/Button.java,
+	libraries/javalib/java/awt/Canvas.java,
+	libraries/javalib/java/awt/CheckboxMenuItem.java,
+	libraries/javalib/java/awt/Container.java,
+	libraries/javalib/java/awt/EventQueue.java,
+	libraries/javalib/java/awt/FileDialog.java,
+	libraries/javalib/java/awt/FlowLayout.java,
+	libraries/javalib/java/awt/FontMetrics.java,
+	libraries/javalib/java/awt/Graphics.java,
+	libraries/javalib/java/awt/GridLayout.java,
+	libraries/javalib/java/awt/KeyboardFocusManager.java,
+	libraries/javalib/java/awt/Label.java,
+	libraries/javalib/java/awt/LayoutManager2.java,
+	libraries/javalib/java/awt/List.java,
+	libraries/javalib/java/awt/MenuBar.java,
+	libraries/javalib/java/awt/Scrollbar.java,
+	libraries/javalib/java/awt/Toolkit.java,
+	libraries/javalib/java/awt/Window.java,
+	libraries/javalib/java/awt/datatransfer/DataFlavor.java,
+	libraries/javalib/java/awt/datatransfer/FlavorTable.java,
+	libraries/javalib/java/awt/event/ActionListener.java,
+	libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java,
+	libraries/javalib/java/awt/geom/Arc2D.java,
+	libraries/javalib/java/awt/geom/Rectangle2D.java,
+	libraries/javalib/java/awt/geom/RectangularShape.java,
+	libraries/javalib/java/awt/im/spi/InputMethod.java,
+	libraries/javalib/java/awt/image/ByteLookupTable.java,
+	libraries/javalib/java/awt/image/ColorModel.java,
+	libraries/javalib/java/awt/image/DirectColorModel.java,
+	libraries/javalib/java/awt/image/ShortLookupTable.java,
+	libraries/javalib/java/awt/print/Book.java:
+	Resynced with GNU Classpath.
+
+	2004-11-16  Michael Koch  <konqueror at gmx.de>
+
+        * java/awt/BasicStroke.java,
+        java/awt/Button.java,
+        java/awt/Canvas.java,
+        java/awt/CheckboxMenuItem.java,
+        java/awt/Container.java,
+        java/awt/EventQueue.java,
+        java/awt/FileDialog.java,
+        java/awt/FlowLayout.java,
+        java/awt/FontMetrics.java,
+        java/awt/Graphics.java,
+        java/awt/GridLayout.java,
+        java/awt/KeyboardFocusManager.java,
+        java/awt/Label.java,
+        java/awt/LayoutManager2.java,
+        java/awt/List.java,
+        java/awt/MenuBar.java,
+        java/awt/Scrollbar.java,
+        java/awt/Toolkit.java,
+        java/awt/Window.java,
+        java/awt/datatransfer/DataFlavor.java,
+        java/awt/datatransfer/FlavorTable.java,
+        java/awt/event/ActionListener.java,
+        java/awt/event/HierarchyBoundsAdapter.java,
+        java/awt/geom/Arc2D.java,
+        java/awt/geom/Rectangle2D.java,
+        java/awt/geom/RectangularShape.java,
+        java/awt/im/spi/InputMethod.java,
+        java/awt/image/ByteLookupTable.java,
+        java/awt/image/ColorModel.java,
+        java/awt/image/DirectColorModel.java,
+        java/awt/image/ShortLookupTable.java,
+        java/awt/print/Book.java:
+        Fixed javadocs and method argument names all over.
+
+2004-11-24  Dalibor Topic  <robilad at kaffe.org>
+
 	* libraries/javalib/gnu/java/locale/LocaleInformation_de.java:
         Resynced with GNU Classpath.
 
Index: kaffe/libraries/javalib/java/awt/BasicStroke.java
diff -u kaffe/libraries/javalib/java/awt/BasicStroke.java:1.4 kaffe/libraries/javalib/java/awt/BasicStroke.java:1.5
--- kaffe/libraries/javalib/java/awt/BasicStroke.java:1.4	Tue Sep 16 12:35:54 2003
+++ kaffe/libraries/javalib/java/awt/BasicStroke.java	Wed Nov 24 21:49:17 2004
@@ -1,5 +1,5 @@
 /* BasicStroke.java -- 
-   Copyright (C) 2002, 2003 Free Software Foundation, Inc.
+   Copyright (C) 2002, 2003, 2004  Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -69,7 +69,7 @@
    * greater than or equal to 1.0f.
    * @param dash The array representing the dashing pattern. There must be at
    * least one non-zero entry.
-   * @param dash_phase is negative and dash is not null.
+   * @param dashPhase is negative and dash is not null.
    *
    * @exception IllegalArgumentException If one input parameter doesn't meet
    * its needs.
Index: kaffe/libraries/javalib/java/awt/Button.java
diff -u kaffe/libraries/javalib/java/awt/Button.java:1.5 kaffe/libraries/javalib/java/awt/Button.java:1.6
--- kaffe/libraries/javalib/java/awt/Button.java:1.5	Tue Oct 12 00:24:58 2004
+++ kaffe/libraries/javalib/java/awt/Button.java	Wed Nov 24 21:49:17 2004
@@ -215,6 +215,13 @@
   action_listeners = AWTEventMulticaster.remove(action_listeners, listener);
 }
 
+  /**
+   * Returns all added <code>ActionListener</code> objects.
+   *
+   * @return an array of listeners
+   *
+   * @since 1.4
+   */
   public synchronized ActionListener[] getActionListeners()
   {
     return (ActionListener[])
@@ -222,10 +229,15 @@
                                        ActionListener.class);
   }
 
-/** Returns all registered EventListers of the given listenerType. 
+/**
+ * Returns all registered EventListers of the given listenerType. 
  * listenerType must be a subclass of EventListener, or a 
  * ClassClassException is thrown.
  *
+ * @param listenerType the listener type to return
+ *
+ * @return an array of listeners
+ * 
  * @exception ClassCastException If listenerType doesn't specify a class or
  * interface that implements @see java.util.EventListener.
  *
Index: kaffe/libraries/javalib/java/awt/Canvas.java
diff -u kaffe/libraries/javalib/java/awt/Canvas.java:1.15 kaffe/libraries/javalib/java/awt/Canvas.java:1.16
--- kaffe/libraries/javalib/java/awt/Canvas.java:1.15	Mon Oct  4 09:01:29 2004
+++ kaffe/libraries/javalib/java/awt/Canvas.java	Wed Nov 24 21:49:17 2004
@@ -119,6 +119,8 @@
    * Repaints the canvas window.  This method should be overridden by 
    * a subclass to do something useful, as this method simply paints
    * the window with the background color.
+   *
+   * @param gfx the <code>Graphics</code> to use for painting
    */
   public void paint(Graphics gfx)
   {
@@ -130,7 +132,6 @@
     Dimension size = getSize();
     gfx.fillRect(0, 0, size.width, size.height);
   }
-
 
   /**
    * This class provides accessibility support for the canvas.
Index: kaffe/libraries/javalib/java/awt/CheckboxMenuItem.java
diff -u kaffe/libraries/javalib/java/awt/CheckboxMenuItem.java:1.12 kaffe/libraries/javalib/java/awt/CheckboxMenuItem.java:1.13
--- kaffe/libraries/javalib/java/awt/CheckboxMenuItem.java:1.12	Mon Oct  4 09:01:29 2004
+++ kaffe/libraries/javalib/java/awt/CheckboxMenuItem.java	Wed Nov 24 21:49:17 2004
@@ -174,7 +174,7 @@
   * Returns an array of length 1 with the menu item label for this object
   * if the state is on.  Otherwise <code>null</code> is returned.
   *
-  * @param An array with this menu item's label if it has a state of on,
+  * @return An array with this menu item's label if it has a state of on,
   * or <code>null</code> otherwise.
   */
 public Object[]
Index: kaffe/libraries/javalib/java/awt/Container.java
diff -u kaffe/libraries/javalib/java/awt/Container.java:1.26 kaffe/libraries/javalib/java/awt/Container.java:1.27
--- kaffe/libraries/javalib/java/awt/Container.java:1.26	Sat Oct 23 22:46:01 2004
+++ kaffe/libraries/javalib/java/awt/Container.java	Wed Nov 24 21:49:17 2004
@@ -147,7 +147,7 @@
   /**
    * Returns the component at the specified index.
    *
-   * @param index The index of the component to retrieve.
+   * @param n The index of the component to retrieve.
    *
    * @return The requested component.
    *
@@ -231,7 +231,7 @@
    * Adds the specified component to this container at the end of the
    * component list.
    *
-   * @param component The component to add to the container.
+   * @param comp The component to add to the container.
    *
    * @return The same component that was added.
    */
@@ -247,7 +247,7 @@
    * <code>add(Component, Object)</code>.
    *
    * @param name The name of the component to be added.
-   * @param component The component to be added.
+   * @param comp The component to be added.
    *
    * @return The same component that was added.
    *
@@ -263,7 +263,7 @@
    * Adds the specified component to this container at the specified index
    * in the component list.
    *
-   * @param component The component to be added.
+   * @param comp The component to be added.
    * @param index The index in the component list to insert this child
    * at, or -1 to add at the end of the list.
    *
@@ -282,7 +282,7 @@
    * component list.  The layout manager will use the specified constraints
    * when laying out this component.
    *
-   * @param component The component to be added to this container.
+   * @param comp The component to be added to this container.
    * @param constraints The layout constraints for this component.
    */
   public void add(Component comp, Object constraints)
@@ -295,7 +295,7 @@
    * in the component list.  The layout manager will use the specified
    * constraints when layout out this component.
    *
-   * @param component The component to be added.
+   * @param comp The component to be added.
    * @param constraints The layout constraints for this component.
    * @param index The index in the component list to insert this child
    * at, or -1 to add at the end of the list.
@@ -314,7 +314,7 @@
    * method.  Any subclass doing this must call the superclass version of
    * this method in order to ensure proper functioning of the container.
    *
-   * @param component The component to be added.
+   * @param comp The component to be added.
    * @param constraints The layout constraints for this component, or
    * <code>null</code> if there are no constraints.
    * @param index The index in the component list to insert this child
@@ -706,7 +706,7 @@
    * a superclass method so that lightweight components are properly
    * drawn.
    *
-   * @param graphics The graphics context for this paint job.
+   * @param g The graphics context for this paint job.
    */
   public void paint(Graphics g)
   {
@@ -726,7 +726,7 @@
    * a superclass method so that lightweight components are properly
    * drawn.
    *
-   * @param graphics The graphics context for this update.
+   * @param g The graphics context for this update.
    */
   public void update(Graphics g)
   {
@@ -740,7 +740,7 @@
    * a superclass method so that lightweight components are properly
    * drawn.
    *
-   * @param graphics The graphics context for this print job.
+   * @param g The graphics context for this print job.
    */
   public void print(Graphics g)
   {
@@ -751,7 +751,7 @@
   /**
    * Paints all of the components in this container.
    *
-   * @param graphics The graphics context for this paint job.
+   * @param g The graphics context for this paint job.
    */
   public void paintComponents(Graphics g)
   {
@@ -762,7 +762,7 @@
   /**
    * Prints all of the components in this container.
    *
-   * @param graphics The graphics context for this print job.
+   * @param g The graphics context for this print job.
    */
   public void printComponents(Graphics g)
   {
@@ -776,9 +776,9 @@
    *
    * @param listener The listener to add.
    */
-  public synchronized void addContainerListener(ContainerListener l)
+  public synchronized void addContainerListener(ContainerListener listener)
   {
-    containerListener = AWTEventMulticaster.add(containerListener, l);
+    containerListener = AWTEventMulticaster.add(containerListener, listener);
   }
 
   /**
@@ -787,9 +787,9 @@
    *
    * @param listener The listener to remove.
    */
-  public synchronized void removeContainerListener(ContainerListener l)
+  public synchronized void removeContainerListener(ContainerListener listener)
   {
-    containerListener = AWTEventMulticaster.remove(containerListener, l);
+    containerListener = AWTEventMulticaster.remove(containerListener, listener);
   }
 
   /**
@@ -825,7 +825,7 @@
    * <code>ContainerEvent</code>, otherwise it calls the superclass
    * method.
    *
-   * @param event The event to be processed.
+   * @param e The event to be processed.
    */
   protected void processEvent(AWTEvent e)
   {
@@ -839,7 +839,7 @@
    * Called when a container event occurs if container events are enabled.
    * This method calls any registered listeners.
    *
-   * @param event The event that occurred.
+   * @param e The event that occurred.
    */
   protected void processContainerEvent(ContainerEvent e)
   {
@@ -860,7 +860,7 @@
   /**
    * AWT 1.0 event processor.
    *
-   * @param event The event that occurred.
+   * @param e The event that occurred.
    *
    * @deprecated use {@link #dispatchEvent(AWTEvent)} instead
    */
@@ -905,7 +905,8 @@
    * unless the point does not exist within this container, in which
    * case <code>null</code> is returned.
    *
-   * @param point The point to return the component at.
+   * @param x The x position of the point to return the component at.
+   * @param y The y position of the point to return the component at.
    *
    * @return The component containing the specified point, or <code>null</code>
    * if there is no such point.
@@ -941,7 +942,7 @@
    * unless the point does not exist within this container, in which
    * case <code>null</code> is returned.
    *
-   * @param point The point to return the component at.
+   * @param p The point to return the component at.
    * @return The component containing the specified point, or <code>null</code>
    * if there is no such point.
    */
@@ -1017,7 +1018,7 @@
    * Tests whether or not the specified component is contained within
    * this components subtree.
    *
-   * @param component The component to test.
+   * @param comp The component to test.
    *
    * @return <code>true</code> if this container is an ancestor of the
    * specified component, <code>false</code> otherwise.
@@ -1056,7 +1057,7 @@
    * Writes a listing of this container to the specified stream starting
    * at the specified indentation point.
    *
-   * @param stream The <code>PrintStream</code> to write to.
+   * @param out The <code>PrintStream</code> to write to.
    * @param indent The indentation point.
    */
   public void list(PrintStream out, int indent)
@@ -1073,7 +1074,7 @@
    * Writes a listing of this container to the specified stream starting
    * at the specified indentation point.
    *
-   * @param stream The <code>PrintWriter</code> to write to.
+   * @param out The <code>PrintWriter</code> to write to.
    * @param indent The indentation point.
    */
   public void list(PrintWriter out, int indent)
Index: kaffe/libraries/javalib/java/awt/EventQueue.java
diff -u kaffe/libraries/javalib/java/awt/EventQueue.java:1.12 kaffe/libraries/javalib/java/awt/EventQueue.java:1.13
--- kaffe/libraries/javalib/java/awt/EventQueue.java:1.12	Thu Jul 22 19:20:22 2004
+++ kaffe/libraries/javalib/java/awt/EventQueue.java	Wed Nov 24 21:49:17 2004
@@ -155,7 +155,7 @@
   /**
    * Posts a new event to the queue.
    *
-   * @param event The event to post to the queue.
+   * @param evt The event to post to the queue.
    *
    * @exception NullPointerException If event is null.
    */
Index: kaffe/libraries/javalib/java/awt/FileDialog.java
diff -u kaffe/libraries/javalib/java/awt/FileDialog.java:1.7 kaffe/libraries/javalib/java/awt/FileDialog.java:1.8
--- kaffe/libraries/javalib/java/awt/FileDialog.java:1.7	Mon Oct  4 09:01:29 2004
+++ kaffe/libraries/javalib/java/awt/FileDialog.java	Wed Nov 24 21:49:17 2004
@@ -261,7 +261,7 @@
 /**
   * Returns the filename filter being used by this dialog.
   *
-  * @param The filename filter being used by this dialog.
+  * @return The filename filter being used by this dialog.
   */
 public FilenameFilter
 getFilenameFilter()
Index: kaffe/libraries/javalib/java/awt/FlowLayout.java
diff -u kaffe/libraries/javalib/java/awt/FlowLayout.java:1.10 kaffe/libraries/javalib/java/awt/FlowLayout.java:1.11
--- kaffe/libraries/javalib/java/awt/FlowLayout.java:1.10	Mon Oct  4 09:01:29 2004
+++ kaffe/libraries/javalib/java/awt/FlowLayout.java	Wed Nov 24 21:49:17 2004
@@ -68,8 +68,12 @@
   // Serialization constant
   private static final long serialVersionUID = -7262534875583282631L;
 
-  /** Add a new component to the layout.  This particular implementation
+  /**
+   * Add a new component to the layout.  This particular implementation
    * does nothing.
+   *
+   * @param name the name
+   * @param comp the component 
    */
   public void addLayoutComponent (String name, Component comp)
   {
Index: kaffe/libraries/javalib/java/awt/FontMetrics.java
diff -u kaffe/libraries/javalib/java/awt/FontMetrics.java:1.13 kaffe/libraries/javalib/java/awt/FontMetrics.java:1.14
--- kaffe/libraries/javalib/java/awt/FontMetrics.java:1.13	Sun Sep 12 15:10:59 2004
+++ kaffe/libraries/javalib/java/awt/FontMetrics.java	Wed Nov 24 21:49:17 2004
@@ -440,7 +440,7 @@
  * FontRenderContext with a null transform, not anti-aliased and not
  * using fractional metrics.
  *
- * @param rc The string to calculate metrics from.
+ * @param ci An iterator over the string to calculate metrics from.
  * @param begin Index of first character in <code>text</code> to measure.
  * @param limit Index of last character in <code>text</code> to measure.
  * @param g The Graphics object that will be used.
@@ -460,7 +460,4 @@
     rc = gRC;
   return font.getLineMetrics(ci, begin, limit, rc);
 }
-
-} // class FontMetrics 
-
-
+}
Index: kaffe/libraries/javalib/java/awt/Graphics.java
diff -u kaffe/libraries/javalib/java/awt/Graphics.java:1.10 kaffe/libraries/javalib/java/awt/Graphics.java:1.11
--- kaffe/libraries/javalib/java/awt/Graphics.java:1.10	Sun Aug  8 19:45:59 2004
+++ kaffe/libraries/javalib/java/awt/Graphics.java	Wed Nov 24 21:49:17 2004
@@ -243,7 +243,7 @@
   * region and the rectangle determined by the specified parameters.
   *
   * @param x The X coordinate of the upper left corner of the intersect rect.
-  * @param Y The Y coordinate of the upper left corner of the intersect rect.
+  * @param y The Y coordinate of the upper left corner of the intersect rect.
   * @param width The width of the intersect rect.
   * @param height The height of the intersect rect.
   */
@@ -279,7 +279,7 @@
 /**
   * Sets the clipping region to the specified <code>Shape</code>.
   *
-  * @param shape The new clipping region.
+  * @param clip The new clipping region.
   */
 public abstract void
 setClip(Shape clip);
@@ -371,7 +371,7 @@
   * @param width The width of the draw rect.
   * @param height The height of the draw rect.
   * @param arcWidth The width of the corner arcs.
-  * @param arcHeigth The height of the corner arcs.
+  * @param arcHeight The height of the corner arcs.
   */
 public abstract void
 drawRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight);
@@ -386,7 +386,7 @@
   * @param width The width of the fill rect.
   * @param height The height of the fill rect.
   * @param arcWidth The width of the corner arcs.
-  * @param arcHeigth The height of the corner arcs.
+  * @param arcHeight The height of the corner arcs.
   */
 public abstract void
 fillRoundRect(int x, int y, int width, int height, int arcWidth, int arcHeight);
@@ -480,7 +480,7 @@
   * @param arcAngle The extent of the arc.
   */
 public abstract void
-drawArc(int x, int y, int width, int height, int startAngle, int arcAngle);
+drawArc(int x, int y, int width, int height, int arcStart, int arcAngle);
 
 /*************************************************************************/
 
@@ -498,7 +498,7 @@
   * @param arcAngle The extent of the arc.
   */
 public abstract void
-fillArc(int x, int y, int width, int height, int startAngle, int arcAngle);
+fillArc(int x, int y, int width, int height, int arcStart, int arcAngle);
 
 /*************************************************************************/
 
@@ -734,7 +734,7 @@
 /**
  * Returns a string representation of this object.
  *
- * @param A string representation of this object. 
+ * @return A string representation of this object. 
  */
 public String
 toString()
Index: kaffe/libraries/javalib/java/awt/GridLayout.java
diff -u kaffe/libraries/javalib/java/awt/GridLayout.java:1.9 kaffe/libraries/javalib/java/awt/GridLayout.java:1.10
--- kaffe/libraries/javalib/java/awt/GridLayout.java:1.9	Mon Oct  4 09:01:30 2004
+++ kaffe/libraries/javalib/java/awt/GridLayout.java	Wed Nov 24 21:49:17 2004
@@ -62,7 +62,7 @@
   /** Add a new component to the layout.  This particular implementation
    * does nothing.
    * @param name The name of the component to add.
-   * @param component The component to add.
+   * @param comp The component to add.
    */
   public void addLayoutComponent (String name, Component comp)
   {
Index: kaffe/libraries/javalib/java/awt/KeyboardFocusManager.java
diff -u kaffe/libraries/javalib/java/awt/KeyboardFocusManager.java:1.7 kaffe/libraries/javalib/java/awt/KeyboardFocusManager.java:1.8
--- kaffe/libraries/javalib/java/awt/KeyboardFocusManager.java:1.7	Sat Oct  9 22:18:53 2004
+++ kaffe/libraries/javalib/java/awt/KeyboardFocusManager.java	Wed Nov 24 21:49:17 2004
@@ -1244,7 +1244,7 @@
    * to the default component of the specified container.
    * Nothing happens for non-focus cycle root containers. 
    * 
-   * @param comp the component used as part of the focus traversal.
+   * @param cont the container used as part of the focus traversal.
    */ 
   public abstract void downFocusCycle(Container cont);
 
Index: kaffe/libraries/javalib/java/awt/Label.java
diff -u kaffe/libraries/javalib/java/awt/Label.java:1.5 kaffe/libraries/javalib/java/awt/Label.java:1.6
--- kaffe/libraries/javalib/java/awt/Label.java:1.5	Mon Oct  4 09:01:30 2004
+++ kaffe/libraries/javalib/java/awt/Label.java	Wed Nov 24 21:49:17 2004
@@ -244,7 +244,7 @@
 /**
   * Returns a parameter string useful for debugging.
   *
-  * @param A debugging string.
+  * @return A debugging string.
   */
 protected String
 paramString()
Index: kaffe/libraries/javalib/java/awt/LayoutManager2.java
diff -u kaffe/libraries/javalib/java/awt/LayoutManager2.java:1.5 kaffe/libraries/javalib/java/awt/LayoutManager2.java:1.6
--- kaffe/libraries/javalib/java/awt/LayoutManager2.java:1.5	Wed Feb  4 18:58:30 2004
+++ kaffe/libraries/javalib/java/awt/LayoutManager2.java	Wed Nov 24 21:49:17 2004
@@ -42,7 +42,7 @@
  * Layout manager for laying out containers based on contraints. The
  * constraints control how the layout will proceed.
  *
- * @author Aaron M. Renn <arenn at urbanophile.com>
+ * @author Aaron M. Renn (arenn at urbanophile.com)
  * @see LayoutManager
  * @see Container
  * @since 1.0
@@ -57,7 +57,7 @@
    * @param component the component to add
    * @param constraints the constraints to satisfy
    */
-  void addLayoutComponent(Component component, Object contraints);
+  void addLayoutComponent(Component component, Object constraints);
 
   /**
    * Determines the maximum size of the specified target container.
Index: kaffe/libraries/javalib/java/awt/List.java
diff -u kaffe/libraries/javalib/java/awt/List.java:1.3 kaffe/libraries/javalib/java/awt/List.java:1.4
--- kaffe/libraries/javalib/java/awt/List.java:1.3	Mon Oct  4 09:01:30 2004
+++ kaffe/libraries/javalib/java/awt/List.java	Wed Nov 24 21:49:17 2004
@@ -130,7 +130,7 @@
   * Initializes a new instance of <code>List</code> with the specified
   * number of visible lines and multi-select disabled.
   *
-  * @param lines The number of visible lines in the list.
+  * @param rows The number of visible rows in the list.
   *
   * @exception HeadlessException If GraphicsEnvironment.isHeadless() is true.
   */
@@ -146,7 +146,7 @@
   * Initializes a new instance of <code>List</code> with the specified
   * number of lines and the specified multi-select setting.
   *
-  * @param lines The number of visible lines in the list.
+  * @param rows The number of visible rows in the list.
   * @param multipleMode <code>true</code> if multiple lines can be selected
   * simultaneously, <code>false</code> otherwise.
   *
Index: kaffe/libraries/javalib/java/awt/MenuBar.java
diff -u kaffe/libraries/javalib/java/awt/MenuBar.java:1.9 kaffe/libraries/javalib/java/awt/MenuBar.java:1.10
--- kaffe/libraries/javalib/java/awt/MenuBar.java:1.9	Mon Sep 27 17:41:07 2004
+++ kaffe/libraries/javalib/java/awt/MenuBar.java	Wed Nov 24 21:49:17 2004
@@ -131,7 +131,7 @@
 /**
   * Sets the help menu for this menu bar.
   *
-  * @param helpMenu The new help menu for this menu bar.
+  * @param menu The new help menu for this menu bar.
   */
 public synchronized void
 setHelpMenu(Menu menu)
@@ -253,6 +253,8 @@
 
 /**
   * Returns the menu at the specified index.
+  *
+  * @param index the index of the menu
   *
   * @return The requested menu.
   *
Index: kaffe/libraries/javalib/java/awt/Scrollbar.java
diff -u kaffe/libraries/javalib/java/awt/Scrollbar.java:1.5 kaffe/libraries/javalib/java/awt/Scrollbar.java:1.6
--- kaffe/libraries/javalib/java/awt/Scrollbar.java:1.5	Tue Oct 12 00:24:58 2004
+++ kaffe/libraries/javalib/java/awt/Scrollbar.java	Wed Nov 24 21:49:19 2004
@@ -365,7 +365,7 @@
   * Sets the width of the scrollbar's thumb, in units relative to the
   * maximum and minimum value of the scrollbar.
   *
-  * @param visibileAmount The new visible amount value of the scrollbar.
+  * @param visibleAmount The new visible amount value of the scrollbar.
   */
 public void
 setVisibleAmount(int visibleAmount)
Index: kaffe/libraries/javalib/java/awt/Toolkit.java
diff -u kaffe/libraries/javalib/java/awt/Toolkit.java:1.20 kaffe/libraries/javalib/java/awt/Toolkit.java:1.21
--- kaffe/libraries/javalib/java/awt/Toolkit.java:1.20	Mon Oct  4 09:01:33 2004
+++ kaffe/libraries/javalib/java/awt/Toolkit.java	Wed Nov 24 21:49:19 2004
@@ -371,8 +371,8 @@
    * should override this method and provide real system colors for the
    * native GUI platform.
    *
-   * @param colors The array to copy the system colors into.
-   *               It must be at least 26 elements.
+   * @param systemColors The array to copy the system colors into.
+   * It must be at least 26 elements.
    *
    * @exception HeadlessException If GraphicsEnvironment.isHeadless() is true.
    *
Index: kaffe/libraries/javalib/java/awt/Window.java
diff -u kaffe/libraries/javalib/java/awt/Window.java:1.23 kaffe/libraries/javalib/java/awt/Window.java:1.24
--- kaffe/libraries/javalib/java/awt/Window.java:1.23	Mon Oct  4 09:01:33 2004
+++ kaffe/libraries/javalib/java/awt/Window.java	Wed Nov 24 21:49:19 2004
@@ -142,7 +142,7 @@
    * Initializes a new instance of <code>Window</code> with the specified
    * parent.  The window will initially be invisible.
    *
-   * @param parent The owning <code>Frame</code> of this window.
+   * @param owner The owning <code>Frame</code> of this window.
    *
    * @exception IllegalArgumentException If the owner's GraphicsConfiguration
    * is not from a screen device, or if owner is null; this exception is always
@@ -605,7 +605,7 @@
    * <code>processWindowEvent()</code> is called to process the event,
    * otherwise the superclass version of this method is invoked.
    *
-   * @param event The event to process.
+   * @param evt The event to process.
    */
   protected void processEvent(AWTEvent evt)
   {
@@ -621,7 +621,7 @@
    * invoked if it is enabled via <code>enableEvents()</code> or if
    * a listener has been added.
    *
-   * @param event The event to process.
+   * @param evt The event to process.
    */
   protected void processWindowEvent(WindowEvent evt)
   {
@@ -711,7 +711,7 @@
   /**
    * Post a Java 1.0 event to the event queue.
    *
-   * @param event The event to post.
+   * @param e The event to post.
    *
    * @deprecated
    */
Index: kaffe/libraries/javalib/java/awt/datatransfer/DataFlavor.java
diff -u kaffe/libraries/javalib/java/awt/datatransfer/DataFlavor.java:1.16 kaffe/libraries/javalib/java/awt/datatransfer/DataFlavor.java:1.17
--- kaffe/libraries/javalib/java/awt/datatransfer/DataFlavor.java:1.16	Mon Oct  4 09:01:33 2004
+++ kaffe/libraries/javalib/java/awt/datatransfer/DataFlavor.java	Wed Nov 24 21:49:19 2004
@@ -328,7 +328,6 @@
  *
  * @param mimeType The MIME type for this flavor.
  * @param humanPresentableName The display name of this flavor.
- * @param classLoader The class loader for finding classes.
  *
  * @exception IllegalArgumentException If the representation class
  * specified cannot be loaded.
@@ -555,7 +554,7 @@
  * Tests whether or not this flavor has a representation class of
  * <code>java.io.InputStream</code>.
  *
- * @param <code>true</code> if the representation class of this flavor
+ * @return <code>true</code> if the representation class of this flavor
  * is <code>java.io.InputStream</code>, <code>false</code> otherwise.
  */
 public boolean
@@ -570,7 +569,7 @@
  * Tests whether the representation class for this flavor is
  * serializable.
  *
- * @param <code>true</code> if the representation class is serializable,
+ * @return <code>true</code> if the representation class is serializable,
  * <code>false</code> otherwise.
  */
 public boolean
Index: kaffe/libraries/javalib/java/awt/datatransfer/FlavorTable.java
diff -u kaffe/libraries/javalib/java/awt/datatransfer/FlavorTable.java:1.1 kaffe/libraries/javalib/java/awt/datatransfer/FlavorTable.java:1.2
--- kaffe/libraries/javalib/java/awt/datatransfer/FlavorTable.java:1.1	Mon Nov 11 23:15:08 2002
+++ kaffe/libraries/javalib/java/awt/datatransfer/FlavorTable.java	Wed Nov 24 21:49:20 2004
@@ -66,8 +66,8 @@
    * list should be sorted from best to worst. The list must be modifiable
    * without affecting this table.
    *
-   * @param native the native to look up, or null to return all flavors
+   * @param name the native name to look up, or null to return all flavors
    * @return the sorted list of flavors
    */
   List getFlavorsForNative(String name);
-} // interface FlavorTable
+}
Index: kaffe/libraries/javalib/java/awt/event/ActionListener.java
diff -u kaffe/libraries/javalib/java/awt/event/ActionListener.java:1.3 kaffe/libraries/javalib/java/awt/event/ActionListener.java:1.4
--- kaffe/libraries/javalib/java/awt/event/ActionListener.java:1.3	Thu Aug  7 21:49:19 2003
+++ kaffe/libraries/javalib/java/awt/event/ActionListener.java	Wed Nov 24 21:49:20 2004
@@ -43,7 +43,7 @@
 /**
  * This interface is for classes that listen for action events.
  *
- * @author Aaron M. Renn <arenn at urbanophile.com>
+ * @author Aaron M. Renn (arenn at urbanophile.com)
  * @see ActionEvent
  * @since 1.1
  * @status updated to 1.4
@@ -55,5 +55,5 @@
    *
    * @param event the <code>ActionEvent</code> that occurred
    */
-  void actionPerformed(ActionEvent e);
-} // interface ActionListener
+  void actionPerformed(ActionEvent event);
+}
Index: kaffe/libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java
diff -u kaffe/libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java:1.1 kaffe/libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java:1.2
--- kaffe/libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java:1.1	Sat Jan 11 19:50:40 2003
+++ kaffe/libraries/javalib/java/awt/event/HierarchyBoundsAdapter.java	Wed Nov 24 21:49:20 2004
@@ -63,7 +63,7 @@
    *
    * @param event the event, ignored in this implementation
    */
-  public void ancestorMoved(HierarchyEvent e)
+  public void ancestorMoved(HierarchyEvent event)
   {
   }
 
@@ -72,7 +72,7 @@
    *
    * @param event the event, ignored in this implementation
    */
-  public void ancestorResized(HierarchyEvent e)
+  public void ancestorResized(HierarchyEvent event)
   {
   }
-} // class HierarchyBoundsAdapter
+}
Index: kaffe/libraries/javalib/java/awt/geom/Arc2D.java
diff -u kaffe/libraries/javalib/java/awt/geom/Arc2D.java:1.6 kaffe/libraries/javalib/java/awt/geom/Arc2D.java:1.7
--- kaffe/libraries/javalib/java/awt/geom/Arc2D.java:1.6	Sun Sep 12 15:11:01 2004
+++ kaffe/libraries/javalib/java/awt/geom/Arc2D.java	Wed Nov 24 21:49:20 2004
@@ -1152,7 +1152,7 @@
     /**
      * Sets the extent angle of the arc.
      *
-     * @param start the new extent angle
+     * @param extent the new extent angle
      */
     public void setAngleExtent(double extent)
     {
@@ -1371,7 +1371,7 @@
     /**
      * Sets the extent angle of the arc.
      *
-     * @param start the new extent angle
+     * @param extent the new extent angle
      */
     public void setAngleExtent(double extent)
     {
Index: kaffe/libraries/javalib/java/awt/geom/Rectangle2D.java
diff -u kaffe/libraries/javalib/java/awt/geom/Rectangle2D.java:1.4 kaffe/libraries/javalib/java/awt/geom/Rectangle2D.java:1.5
--- kaffe/libraries/javalib/java/awt/geom/Rectangle2D.java:1.4	Sun Sep 12 15:11:01 2004
+++ kaffe/libraries/javalib/java/awt/geom/Rectangle2D.java	Wed Nov 24 21:49:20 2004
@@ -49,8 +49,8 @@
  * in methods like <code>contains</code> or <code>intersects</code> is
  * undefined unless the rectangle has positive width and height.
  *
- * @author Tom Tromey <tromey at cygnus.com>
- * @author Eric Blake <ebb9 at email.byu.edu>
+ * @author Tom Tromey (tromey at cygnus.com)
+ * @author Eric Blake (ebb9 at email.byu.edu)
  * @since 1.2
  * @status updated to 1.4
  */
@@ -71,14 +71,14 @@
   public static final int OUT_TOP = 2;
 
   /**
-   * The point lies right of the rectangle (p.x > r.maxX).
+   * The point lies right of the rectangle (p.x &gt; r.maxX).
    *
    * @see #outcode()
    */
   public static final int OUT_RIGHT = 4;
 
   /**
-   * The point lies below of the rectangle (p.y > r.maxY).
+   * The point lies below of the rectangle (p.y &gt; r.maxY).
    *
    * @see #outcode()
    */
@@ -335,8 +335,8 @@
    * inside the rectangle, a subsequent call to <code>contains</code> may
    * return false.
    *
-   * @param x the X coordinate of the point to add to this rectangle
-   * @param y the Y coordinate of the point to add to this rectangle
+   * @param newx the X coordinate of the point to add to this rectangle
+   * @param newy the Y coordinate of the point to add to this rectangle
    */
   public void add(double newx, double newy)
   {
@@ -382,7 +382,7 @@
    * safe; modifications to the rectangle do not affect the results of this
    * path instance.
    *
-   * @param transform an optional transform to apply to the iterator
+   * @param at an optional transform to apply to the iterator
    * @return a new iterator over the boundary
    * @since 1.2
    */
@@ -490,8 +490,8 @@
    * path instance. As the rectangle is already flat, the flatness parameter
    * is ignored.
    *
-   * @param transform an optional transform to apply to the iterator
-   * @param double the maximum distance for deviation from the real boundary
+   * @param at an optional transform to apply to the iterator
+   * @param flatness the maximum distance for deviation from the real boundary
    * @return a new iterator over the boundary
    * @since 1.2
    */
@@ -508,7 +508,7 @@
    *   + 37 * Double.doubleToLongBits(getY())
    *   + 43 * Double.doubleToLongBits(getWidth())
    *   + 47 * Double.doubleToLongBits(getHeight());
-   * return (int) ((l >> 32) ^ l);
+   * return (int) ((l &gt;&gt; 32) ^ l);
    * </pre>
    *
    * @return the hashcode
@@ -543,7 +543,7 @@
   /**
    * This class defines a rectangle in <code>double</code> precision.
    *
-   * @author Eric Blake <ebb9 at email.byu.edu>
+   * @author Eric Blake (ebb9 at email.byu.edu)
    * @since 1.2
    * @status updated to 1.4
    */
@@ -747,12 +747,12 @@
       return getClass().getName() + "[x=" + x + ",y=" + y + ",w=" + width
         + ",h=" + height + ']';
     }
-  } // class Double
+  }
 
   /**
    * This class defines a rectangle in <code>float</code> precision.
    *
-   * @author Eric Blake <ebb9 at email.byu.edu>
+   * @author Eric Blake (ebb9 at email.byu.edu)
    * @since 1.2
    * @status updated to 1.4
    */
@@ -988,5 +988,5 @@
       return getClass().getName() + "[x=" + x + ",y=" + y + ",w=" + width
         + ",h=" + height + ']';
     }
-  } // class Float
-} // class Rectangle2D
+  }
+}
Index: kaffe/libraries/javalib/java/awt/geom/RectangularShape.java
diff -u kaffe/libraries/javalib/java/awt/geom/RectangularShape.java:1.1 kaffe/libraries/javalib/java/awt/geom/RectangularShape.java:1.2
--- kaffe/libraries/javalib/java/awt/geom/RectangularShape.java:1.1	Wed Nov  6 11:52:24 2002
+++ kaffe/libraries/javalib/java/awt/geom/RectangularShape.java	Wed Nov 24 21:49:20 2004
@@ -354,7 +354,7 @@
    * threadsafe if and only if the iterator returned by
    * {@link #getPathIterator(AffineTransform)} is as well.
    *
-   * @param transform an optional transform to apply to the iterator
+   * @param at an optional transform to apply to the iterator
    * @param flatness the desired flatness
    * @return a new iterator over the boundary
    * @throws IllegalArgumentException if flatness is invalid
Index: kaffe/libraries/javalib/java/awt/im/spi/InputMethod.java
diff -u kaffe/libraries/javalib/java/awt/im/spi/InputMethod.java:1.1 kaffe/libraries/javalib/java/awt/im/spi/InputMethod.java:1.2
--- kaffe/libraries/javalib/java/awt/im/spi/InputMethod.java:1.1	Thu Jul 22 19:37:11 2004
+++ kaffe/libraries/javalib/java/awt/im/spi/InputMethod.java	Wed Nov 24 21:49:21 2004
@@ -162,7 +162,7 @@
    * called on a previous client.</li>
    * </ul>
    *
-   * @param the client window's current bounds, or null
+   * @param bounds the client window's current bounds, or null
    */
   void notifyClientWindowChange(Rectangle bounds);
 
Index: kaffe/libraries/javalib/java/awt/image/ByteLookupTable.java
diff -u kaffe/libraries/javalib/java/awt/image/ByteLookupTable.java:1.2 kaffe/libraries/javalib/java/awt/image/ByteLookupTable.java:1.3
--- kaffe/libraries/javalib/java/awt/image/ByteLookupTable.java:1.2	Fri Oct 15 13:28:17 2004
+++ kaffe/libraries/javalib/java/awt/image/ByteLookupTable.java	Wed Nov 24 21:49:21 2004
@@ -87,7 +87,11 @@
     this.data = new byte[][] {data};
   }
 
-  /** Return the lookup tables. */
+  /**
+   * Return the lookup tables.
+   *
+   * @return the tables
+   */
   public final byte[][] getTable()
   {
     return data;
@@ -107,7 +111,7 @@
    * translation arrays.
    *
    * @param src Component values of a pixel.
-   * @param dest Destination array for values, or null.
+   * @param dst Destination array for values, or null.
    * @return Translated values for the pixel.
    */
   public int[] lookupPixel(int[] src, int[] dst)
@@ -140,7 +144,7 @@
    * translation arrays.
    *
    * @param src Component values of a pixel.

*** Patch too long, truncated ***




More information about the kaffe mailing list