2006-03-03 David Gilbert <david.gilbert@object-refinery.com>

	* javax/swing/event/ListSelectionEvent.java: Reformatted and fixed
	API doc warnings,
	* javax/swing/event/ListSelectionListener.java: Updated API docs.

3 files changed, 93 insertions, 92 deletions

diff --git a/ChangeLog b/ChangeLog
index 14a4bf5ed..38708411f 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-03-03  David Gilbert  <david.gilbert@object-refinery.com>
+
+	* javax/swing/event/ListSelectionEvent.java: Reformatted and fixed
+	API doc warnings,
+	* javax/swing/event/ListSelectionListener.java: Updated API docs.
+
 2006-03-03  Audrius Meskauskas  <AudriusA@Bioinformatics.org>
 
     * gnu/java/rmi/dgc/DGCImpl.java,
diff --git a/javax/swing/event/ListSelectionEvent.java b/javax/swing/event/ListSelectionEvent.java
index e5e4c33ba..f041faea8 100644
--- a/javax/swing/event/ListSelectionEvent.java
+++ b/javax/swing/event/ListSelectionEvent.java
@@ -1,5 +1,5 @@
 /* ListSelectionEvent.java --
-   Copyright (C) 2002 Free Software Foundation, Inc.
+   Copyright (C) 2002, 2006, Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -37,7 +37,6 @@ exception statement from your version. */
 
 package javax.swing.event;
 
-// Imports
 import java.util.EventObject;
 
 /**
@@ -45,82 +44,74 @@ import java.util.EventObject;
  * @author Andrew Selkirk
  * @author Ronald Veldema
  */
-public class ListSelectionEvent extends EventObject {
-
-	//-------------------------------------------------------------
-	// Variables --------------------------------------------------
-	//-------------------------------------------------------------
-
-	/**
-	 * firstIndex
-	 */
-	private int		firstIndex	= 0;
-	
-	/**
-	 * lastIndex
-	 */
-	private int		lastIndex	= 0;
-	
-	/**
-	 * isAdjusting
-	 */
-	private boolean	isAdjusting	= false;
-
-	//-------------------------------------------------------------
-	// Initialization ---------------------------------------------
-	//-------------------------------------------------------------
-
-	/**
-	 * Constructor ListSelectionEvent
-	 * @param source Source
-	 * @param firstIndex First index
-	 * @param lastIndex Last index
-	 * @param isAdjusting Is Adjusting?
-	 */
-	public ListSelectionEvent(Object source, int firstIndex,
-								int lastIndex, boolean isAdjusting) {
-		super(source);
-		this.firstIndex		= firstIndex;
-		this.lastIndex		= lastIndex;
-		this.isAdjusting	= isAdjusting;
-	} // ListSelectionEvent()
-
-
-	//-------------------------------------------------------------
-	// Methods ----------------------------------------------------
-	//-------------------------------------------------------------
-
-	/**
-	 * getFirstIndex
-	 * @returns firstIndex
-	 */
-	public int getFirstIndex() {
-		return firstIndex;
-	} // getFirstIndex()
-
-	/**
-	 * getLastIndex
-	 * @returns lastIndex
-	 */
-	public int getLastIndex() {
-		return lastIndex;
-	} // getLastIndex()
-
-	/**
-	 * getValueIsAdjusting
-	 * @returns isAdjusting
-	 */
-	public boolean getValueIsAdjusting() {
-		return isAdjusting;
-	} // getValueIsAdjusting()
-
-	/**
-	 * String representation
-	 * @returns String representation
-	 */
-	public String toString() {
-		return null; // TODO
-	} // toString()
-
-
-} // ListSelectionEvent
+public class ListSelectionEvent extends EventObject 
+{
+
+  /**
+   * firstIndex
+   */
+  private int firstIndex = 0;
+
+  /**
+   * lastIndex
+   */
+  private int lastIndex = 0;
+
+  /**
+   * isAdjusting
+   */
+  private boolean isAdjusting = false;
+
+  /**
+   * Constructor ListSelectionEvent
+   * @param source Source
+   * @param firstIndex First index
+   * @param lastIndex Last index
+   * @param isAdjusting Is Adjusting?
+   */
+  public ListSelectionEvent(Object source, int firstIndex,
+      int lastIndex, boolean isAdjusting) 
+  {
+    super(source);
+    this.firstIndex = firstIndex;
+    this.lastIndex = lastIndex;
+    this.isAdjusting = isAdjusting;
+  }
+ 
+  /**
+   * getFirstIndex
+   * @return firstIndex
+   */
+  public int getFirstIndex() 
+  {
+    return firstIndex;
+  }
+
+  /**
+   * getLastIndex
+   * @return lastIndex
+   */
+  public int getLastIndex() 
+  {
+    return lastIndex;
+  }
+
+  /**
+   * getValueIsAdjusting
+   * @return isAdjusting
+   */
+  public boolean getValueIsAdjusting() 
+  {
+    return isAdjusting;
+  }
+
+  /**
+   * String representation
+   * @return String representation
+   */
+  public String toString() 
+  {
+    return null; // TODO
+  }
+
+}
diff --git a/javax/swing/event/ListSelectionListener.java b/javax/swing/event/ListSelectionListener.java
index 4ebf58304..a21dc7365 100644
--- a/javax/swing/event/ListSelectionListener.java
+++ b/javax/swing/event/ListSelectionListener.java
@@ -1,5 +1,5 @@
 /* ListSelectionListener.java --
-   Copyright (C) 2002 Free Software Foundation, Inc.
+   Copyright (C) 2002, 2006, Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -37,21 +37,25 @@ exception statement from your version. */
 
 package javax.swing.event;
 
-// Imports
 import java.util.EventListener;
 
+import javax.swing.ListSelectionModel;
+
 /**
- * ListSelectionListener public interface
+ * A listener that receives {@link ListSelectionEvent} notifications, 
+ * typically from a {@link ListSelectionModel} when it is modified.
+ *
  * @author Andrew Selkirk
  * @author Ronald Veldema
  */
-public interface ListSelectionListener extends EventListener {
-
-	/**
-	 * Value changed
-	 * @param event List Selection Event
-	 */
-	void valueChanged(ListSelectionEvent event);
+public interface ListSelectionListener extends EventListener 
+{
 
+  /**
+   * Receives notification of a {@link ListSelectionEvent}.
+   * 
+   * @param event  the event.
+   */
+  void valueChanged(ListSelectionEvent event);
 
-} // ListSelectionListener
+}
\ No newline at end of file