Making webRequest.addEventListener internal

chrome/common/extensions/api/web_request_internal.json

Index: chrome/common/extensions/api/web_request_internal.json
diff --git a/chrome/common/extensions/api/web_request_internal.json b/chrome/common/extensions/api/web_request_internal.json
new file mode 100644
index 0000000000000000000000000000000000000000..c4a74fbd50da1f9f04fff5cb181a33726ee80e99
--- /dev/null
+++ b/chrome/common/extensions/api/web_request_internal.json
@@ -0,0 +1,38 @@
+// 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": "webRequestInternal",
+    "internal": true,
+    "functions": [
+      {
+        "name": "addEventListener",
+        "nodoc": true,

[battre, 2012/05/15 09:23:38]

You should move this "nodoc": true one level up. Otherwise our build script for
documentation (chrome/common/extensions/docs/build/build.py) would create an
empty page for this API.

[vabr (Chromium), 2012/05/15 11:57:52]

Done.
Still, would not internal:true for the whole namespace mean that the
documentation does not generated?

+        "type": "function",
+        "description": "Used internally to implement the special form of addListener for the webRequest events.",
+        "parameters": [
+          {"type": "function", "name": "callback"},
+          {
+            "$ref": "webRequest.RequestFilter",
+            "name": "filter",
+            "description": "A set of filters that restricts the events that will be sent to this listener."
+          },
+          {
+            "type": "array",
+            "optional": true,
+            "name": "extraInfoSpec",
+            "description": "Array of extra information that should be passed to the listener function.",
+            "items": {
+              "type": "string",
+              "enum": ["requestHeaders", "responseHeaders", "blocking", "asyncBlocking"]
+            }
+          },
+          {"type": "string", "name": "eventName"},
+          {"type": "string", "name": "subEventName"}
+        ]
+      }
+    ]
+  }
+]