src/share/classes/java/awt/TextArea.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -312,10 +312,15 @@
     public void insert(String str, int pos) {
         insertText(str, pos);
     }
 
     /**
+     * Inserts the specified text at the specified position
+     * in this text area.
+     *
+     * @param  str the non-{@code null} text to insert
+     * @param  pos the position at which to insert
      * @deprecated As of JDK version 1.1,
      * replaced by <code>insert(String, int)</code>.
      */
     @Deprecated
     public synchronized void insertText(String str, int pos) {

@@ -340,10 +345,13 @@
     public void append(String str) {
         appendText(str);
     }
 
     /**
+     * Appends the given text to the text area's current text.
+     *
+     * @param  str the text to append
      * @deprecated As of JDK version 1.1,
      * replaced by <code>append(String)</code>.
      */
     @Deprecated
     public synchronized void appendText(String str) {

@@ -376,10 +384,19 @@
     public void replaceRange(String str, int start, int end) {
         replaceText(str, start, end);
     }
 
     /**
+     * Replaces a range of characters between
+     * the indicated start and end positions
+     * with the specified replacement text (the text at the end
+     * position will not be replaced).
+     *
+     * @param  str the non-{@code null} text to use as
+     *         the replacement
+     * @param  start the start position
+     * @param  end the end position
      * @deprecated As of JDK version 1.1,
      * replaced by <code>replaceRange(String, int, int)</code>.
      */
     @Deprecated
     public synchronized void replaceText(String str, int start, int end) {

@@ -490,10 +507,16 @@
     public Dimension getPreferredSize(int rows, int columns) {
         return preferredSize(rows, columns);
     }
 
     /**
+     * Determines the preferred size of the text area with the specified
+     * number of rows and columns.
+     *
+     * @param  rows the number of rows
+     * @param  columns the number of columns
+     * @return the preferred dimensions needed for the text area
      * @deprecated As of JDK version 1.1,
      * replaced by <code>getPreferredSize(int, int)</code>.
      */
     @Deprecated
     public Dimension preferredSize(int rows, int columns) {

@@ -542,10 +565,16 @@
     public Dimension getMinimumSize(int rows, int columns) {
         return minimumSize(rows, columns);
     }
 
     /**
+     * Determines the minimum size of the text area with the specified
+     * number of rows and columns.
+     *
+     * @param  rows the number of rows
+     * @param  columns the number of columns
+     * @return the minimum size for the text area
      * @deprecated As of JDK version 1.1,
      * replaced by <code>getMinimumSize(int, int)</code>.
      */
     @Deprecated
     public Dimension minimumSize(int rows, int columns) {