src/share/classes/java/awt/TextField.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

@@ -270,10 +270,14 @@
     public void setEchoChar(char c) {
         setEchoCharacter(c);
     }
 
     /**
+     * Sets the character to be echoed when protected input is displayed.
+     *
+     * @param  c the echo character for this text field
+     *
      * @deprecated As of JDK version 1.1,
      * replaced by <code>setEchoChar(char)</code>.
      */
     @Deprecated
     public synchronized void setEchoCharacter(char c) {

@@ -366,10 +370,16 @@
     public Dimension getPreferredSize(int columns) {
         return preferredSize(columns);
     }
 
     /**
+     * Returns the preferred size for this text field
+     * with the specified number of columns.
+     *
+     * @param  columns the number of columns
+     * @return the preferred size for the text field
+     *
      * @deprecated As of JDK version 1.1,
      * replaced by <code>getPreferredSize(int)</code>.
      */
     @Deprecated
     public Dimension preferredSize(int columns) {

@@ -405,19 +415,26 @@
     }
 
     /**
      * Gets the minimum dimensions for a text field with
      * the specified number of columns.
+     *
      * @param    columns   the number of columns in
      *                          this text field.
+     * @return the minimum size for this text field
      * @since    JDK1.1
      */
     public Dimension getMinimumSize(int columns) {
         return minimumSize(columns);
     }
 
     /**
+     * Returns the minimum dimensions for a text field with
+     * the specified number of columns.
+     *
+     * @param  columns the number of columns
+     * @return the minimum size for this text field
      * @deprecated As of JDK version 1.1,
      * replaced by <code>getMinimumSize(int)</code>.
      */
     @Deprecated
     public Dimension minimumSize(int columns) {