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

@@ -277,10 +277,12 @@
     public int getMenuCount() {
         return countMenus();
     }
 
     /**
+     * Gets the number of menus on the menu bar.
+     * @return  the number of menus on the menu bar.
      * @deprecated As of JDK version 1.1,
      * replaced by <code>getMenuCount()</code>.
      */
     @Deprecated
     public int countMenus() {

@@ -337,10 +339,11 @@
      * with the specified <code>MenuShortcut</code> object,
      * or <code>null</code> if none of the menu items being managed
      * by this menu bar is associated with the specified menu
      * shortcut.
      * @param        s the specified menu shortcut.
+     * @return       the menu item for the specified shortcut.
      * @see          java.awt.MenuItem
      * @see          java.awt.MenuShortcut
      * @since        JDK1.1
      */
      public MenuItem getShortcutMenuItem(MenuShortcut s) {