DevTools: Clarify chrome.debugger API documentation

chrome/common/extensions/api/debugger.json

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 [
   {
     "namespace": "debugger",
     "description": "The <code>chrome.debugger</code> API serves as an alternate transport for Chrome's <a href='http://code.google.com/chrome/devtools/docs/remote-debugging.html'>remote debugging protocol</a>. Use <code>chrome.debugger</code> to attach to one or more tabs to instrument network interaction, debug JavaScript, mutate the DOM and CSS, etc. Use the Debuggee <code>tabId</code> to target tabs with sendCommand and route events by <code>tabId</code> from onEvent callbacks.",
     "types": [
       {
@@ skipping 95 matching lines @@
           {
             "type": "function",
             "name": "callback",
             "optional": true,
             "parameters": [
               {
                 "type": "object",
                 "name": "result",
                 "optional": true,
                 "additionalProperties": { "type": "any" },
-                "description": "JSON object with the response. Structure of the response varies depending on the method and is defined by the remote debugging protocol."
+                "description": "JSON object with the response. Structure of the response varies depending on the method name and is defined by the 'returns' attribute of the command description in the remote debugging protocol."
               }
             ],
             "description": "Response body. If an error occurs while posting the message, the callback will be called with no arguments and $(ref:runtime.lastError) will be set to the error message."
           }
         ]
       },
       {
         "name": "getTargets",
         "type": "function",
         "description": "Returns the list of available debug targets.",
@@ skipping 27 matching lines @@
           {
             "type": "string",
             "name": "method",
             "description": "Method name. Should be one of the notifications defined by the <a href='http://code.google.com/chrome/devtools/docs/remote-debugging.html'>remote debugging protocol</a>."
           },
           {
             "type": "object",
             "name": "params",
             "optional": true,
             "additionalProperties": { "type": "any" },
-            "description": "JSON object with the response. Structure of the response varies depending on the method and is defined by the remote debugging protocol."
+            "description": "JSON object with the parameters. Structure of the parameters varies depending on the method name and is defined by the 'parameters' attribute of the event description in the remote debugging protocol."
           }
         ]
       },
       {
         "name": "onDetach",
         "type": "function",
         "description": "Fired when browser terminates debugging session for the tab. This happens when either the tab is being closed or Chrome DevTools is being invoked for the attached tab.",
         "parameters": [
           {
             "$ref": "Debuggee",
             "name": "source",
             "description": "The debuggee that was detached."
           },
           {
             "type": "string",
             "name": "reason",
             "description": "Connection termination reason.",
             "enum": [ "target_closed", "canceled_by_user", "replaced_with_devtools" ]
           }
         ]
       }
     ]
   }
 ]