DevTools: [JSDoc] Avoid partial arg list annotations in code except "profiler" module

Source/devtools/front_end/ui/ContextMenu.js

 /*
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 12 matching lines @@
  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
 /**
  * @constructor
- * @param {!WebInspector.ContextSubMenuItem} topLevelMenu
+ * @param {!WebInspector.ContextMenu} topLevelMenu
  * @param {string} type
  * @param {string=} label
  * @param {boolean=} disabled
  * @param {boolean=} checked
  */
 WebInspector.ContextMenuItem = function(topLevelMenu, type, label, disabled, checked)
 {
     this._type = type;
     this._label = label;
     this._disabled = disabled;
@@ skipping 45 matching lines @@
             return { type: "separator" };
         case "checkbox":
             return { type: "checkbox", id: this._id, label: this._label, checked: !!this._checked, enabled: !this._disabled };
         }
     }
 }
 
 /**
  * @constructor
  * @extends {WebInspector.ContextMenuItem}
- * @param topLevelMenu
+ * @param {!WebInspector.ContextMenu} topLevelMenu
  * @param {string=} label
  * @param {boolean=} disabled
  */
 WebInspector.ContextSubMenuItem = function(topLevelMenu, label, disabled)
 {
     WebInspector.ContextMenuItem.call(this, topLevelMenu, "subMenu", label, disabled);
     /** @type {!Array.<!WebInspector.ContextMenuItem>} */
     this._items = [];
 }
 
 WebInspector.ContextSubMenuItem.prototype = {
     /**
      * @param {string} label
      * @param {function(?)} handler
      * @param {boolean=} disabled
      * @return {!WebInspector.ContextMenuItem}
      */
     appendItem: function(label, handler, disabled)
     {
         var item = new WebInspector.ContextMenuItem(this._contextMenu, "item", label, disabled);
         this._pushItem(item);
         this._contextMenu._setHandler(item.id(), handler);
         return item;
     },
 
     /**
      * @param {string} label
      * @param {boolean=} disabled
-     * @return {!WebInspector.ContextMenuItem}
+     * @return {!WebInspector.ContextSubMenuItem}
      */
     appendSubMenuItem: function(label, disabled)
     {
         var item = new WebInspector.ContextSubMenuItem(this._contextMenu, label, disabled);
         this._pushItem(item);
         return item;
     },
 
     /**
+     * @param {string} label
+     * @param {function()} handler
+     * @param {boolean=} checked
      * @param {boolean=} disabled
      * @return {!WebInspector.ContextMenuItem}
      */
     appendCheckboxItem: function(label, handler, checked, disabled)
     {
         var item = new WebInspector.ContextMenuItem(this._contextMenu, "checkbox", label, disabled, checked);
         this._pushItem(item);
         this._contextMenu._setHandler(item.id(), handler);
         return item;
     },
@@ skipping 31 matching lines @@
             result.subItems.push(this._items[i]._buildDescriptor());
         return result;
     },
 
     __proto__: WebInspector.ContextMenuItem.prototype
 }
 
 /**
  * @constructor
  * @extends {WebInspector.ContextSubMenuItem}
+ * @param {?Event} event
  */
-WebInspector.ContextMenu = function(event) {
+WebInspector.ContextMenu = function(event)
+{
     WebInspector.ContextSubMenuItem.call(this, this, "");
-    this._event = event;
+    this._event = /** @type {!Event} */ (event);
     this._handlers = {};
     this._id = 0;
 }
 
 /**
  * @param {boolean} useSoftMenu
  */
 WebInspector.ContextMenu.setUseSoftMenu = function(useSoftMenu)
 {
     WebInspector.ContextMenu._useSoftMenu = useSoftMenu;
@@ skipping 17 matching lines @@
             if (WebInspector.ContextMenu._useSoftMenu) {
                 var softMenu = new WebInspector.SoftContextMenu(menuObject);
                 softMenu.show(this._event);
             } else {
                 InspectorFrontendHost.showContextMenu(this._event, menuObject);
             }
             this._event.consume(true);
         }
     },
 
+    /**
+     * @param {number} id
+     * @param {function(?)} handler
+     */
     _setHandler: function(id, handler)
     {
         if (handler)
             this._handlers[id] = handler;
     },
 
     _buildDescriptor: function()
     {
         var result = [];
         for (var i = 0; i < this._items.length; ++i)
@@ skipping 31 matching lines @@
 }
 
 /**
  * @interface
  */
 WebInspector.ContextMenu.Provider = function() {
 }
 
 WebInspector.ContextMenu.Provider.prototype = {
     /**
+     * @param {!Event} event
      * @param {!WebInspector.ContextMenu} contextMenu
      * @param {!Object} target
      */
     appendApplicableItems: function(event, contextMenu, target) { }
 }
 
 WebInspector.contextMenuItemSelected = function(id)
 {
     if (WebInspector._contextMenu)
         WebInspector._contextMenu._itemSelected(id);
 }
 
 WebInspector.contextMenuCleared = function()
 {
     // FIXME: Unfortunately, contextMenuCleared is invoked between show and item selected
     // so we can't delete last menu object from WebInspector. Fix the contract.
 }