[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 > 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 > 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 >> 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