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

@@ -154,19 +154,23 @@
         }
     }
 
     /**
      * Returns the number of items in this <code>Choice</code> menu.
+     *
      * @return the number of items in this <code>Choice</code> menu
      * @see     #getItem
      * @since   JDK1.1
      */
     public int getItemCount() {
         return countItems();
     }
 
     /**
+     * Returns the number of items in this {@code Choice} menu.
+     *
+     * @return the number of items in this {@code Choice} menu
      * @deprecated As of JDK version 1.1,
      * replaced by <code>getItemCount()</code>.
      */
     @Deprecated
     public int countItems() {

@@ -174,11 +178,13 @@
     }
 
     /**
      * Gets the string at the specified index in this
      * <code>Choice</code> menu.
+     *
      * @param      index the index at which to begin
+     * @return the item at the specified index
      * @see        #getItemCount
      */
     public String getItem(int index) {
         return getItemImpl(index);
     }

@@ -757,10 +763,13 @@
         /*
          * JDK 1.3 serialVersionUID
          */
         private static final long serialVersionUID = 7175603582428509322L;
 
+        /**
+         * Constructor for {@code AccessibleAWTChoice}
+         */
         public AccessibleAWTChoice() {
             super();
         }
 
         /**