2005-07-05 Roman Kennke <roman@kennke.org>

	* javax/swing/JScrollPane.java:
	Added API documentation for class and constructors.

1 files changed, 47 insertions, 1 deletions

diff --git a/javax/swing/JScrollPane.java b/javax/swing/JScrollPane.java
index dabd9c9e0..377f05a88 100644
--- a/javax/swing/JScrollPane.java
+++ b/javax/swing/JScrollPane.java
@@ -54,6 +54,9 @@ import javax.swing.plaf.ScrollPaneUI;
 import javax.swing.plaf.UIResource;
 
 /**
+ * A component that embeds another component and enables it to be scrolled
+ * both in horizontal and vertical direction.
+ *
  * <table>
  * <tr><th>Property                    </th><th>Stored in       </th><th>Bound?</th></tr>
  * <tr><td>columnHeader                </td><td>scrollPane      </td><td>yes   </td></tr>
@@ -564,11 +567,25 @@ public class JScrollPane
   }
 
 
+  /**
+   * Creates a new <code>JScrollPane</code> without a view. The scrollbar
+   * policy is set to {@link #VERTICAL_SCROLLBAR_AS_NEEDED} and
+   * {@link #HORIZONTAL_SCROLLBAR_AS_NEEDED}.
+   *
+   * @param view the component that is embedded inside the JScrollPane
+   */
   public JScrollPane() 
   {
     this(null);
   }
-    
+
+  /**
+   * Creates a new <code>JScrollPane</code> that embeds the specified
+   * <code>view</code> component, displaying vertical and horizontal scrollbars
+   * as needed.
+   *
+   * @param view the component that is embedded inside the JScrollPane
+   */
   public JScrollPane(Component view) 
   {
     this(view, 
@@ -576,11 +593,40 @@ public class JScrollPane
          HORIZONTAL_SCROLLBAR_AS_NEEDED);
   }
 
+  /**
+   * Creates a new <code>JScrollPane</code> without a view; The scrollbar
+   * policies are set to <code>vsbPolicy</code> and <code>hsbPolicy</code>.
+   *
+   * @param vsbPolicy the vertical scrollbar policy to set
+   * @param hsbPolicy the vertical scrollbar policy to set
+   *
+   * @see {@link ScrollPaneConstants#HORIZONTAL_SCROLLBAR_ALWAYS}
+   * @see {@link ScrollPaneConstants#HORIZONTAL_SCROLLBAR_AS_NEEDED}
+   * @see {@link ScrollPaneConstants#HORIZONTAL_SCROLLBAR_NEVER}
+   * @see {@link ScrollPaneConstants#VERTICAL_SCROLLBAR_ALWAYS}
+   * @see {@link ScrollPaneConstants#VERTICAL_SCROLLBAR_AS_NEEDED}
+   * @see {@link ScrollPaneConstants#VERTICAL_SCROLLBAR_NEVER}
+   */
   public JScrollPane(int vsbPolicy, int hsbPolicy) 
   {
     this(null, vsbPolicy, hsbPolicy);
   }
 
+  /**
+   * Creates a new <code>JScrollPane</code> that embeds the specified
+   * <code>view</code> component; The scrollbar
+   * policies are set to <code>vsbPolicy</code> and <code>hsbPolicy</code>.
+   *
+   * @param vsbPolicy the vertical scrollbar policy to set
+   * @param hsbPolicy the vertical scrollbar policy to set
+   *
+   * @see {@link ScrollPaneConstants#HORIZONTAL_SCROLLBAR_ALWAYS}
+   * @see {@link ScrollPaneConstants#HORIZONTAL_SCROLLBAR_AS_NEEDED}
+   * @see {@link ScrollPaneConstants#HORIZONTAL_SCROLLBAR_NEVER}
+   * @see {@link ScrollPaneConstants#VERTICAL_SCROLLBAR_ALWAYS}
+   * @see {@link ScrollPaneConstants#VERTICAL_SCROLLBAR_AS_NEEDED}
+   * @see {@link ScrollPaneConstants#VERTICAL_SCROLLBAR_NEVER}
+   */
   public JScrollPane(Component view, int vsbPolicy, int hsbPolicy) 
   {
     scrollListener = createScrollListener();