Document optional parameters of ...devtools.inspectedWindow.reload()

chrome/common/extensions/api/devtools_api.json

Index: chrome/common/extensions/api/devtools_api.json
diff --git a/chrome/common/extensions/api/devtools_api.json b/chrome/common/extensions/api/devtools_api.json
index e0f0e646d4e41f53a6c21cb5d46b5d9fde9d3522..b398c2237d28e9259b7c6fe4e4ba1db45f4e186e 100644
--- a/chrome/common/extensions/api/devtools_api.json
+++ b/chrome/common/extensions/api/devtools_api.json
@@ -109,13 +109,29 @@
       {
         "name": "reload",
         "type": "function",
-        "description": "Reloads the inspected page, optionally setting override for the user agent string.",
+        "description": "Reloads the inspected page.",
         "parameters": [
           {
-            "name": "userAgent",
-            "type": "string",
+            "type": "object",
+            "name": "reloadOptions",
             "optional": true,
-            "description": "A user agent override string."
+            "properties": {
+              "ignoreCache": {
+                "type": "boolean",
+                "optional": true,
+                "description": "When true, the loader will ignore cache for all inspected page resources loaded before the <code>load</code> event is fired. The effect is similar to pressing Ctrl+Shift+R in the inspected window or within the Developer Tools window."

[kathyw, 2011/10/26 18:02:28]

cache -> the cache

+              },
+              "userAgent": {
+                "type": "string",
+                "optional": true,
+                "description": "If specified, the string will override the value of <code>User-Agent</code> HTTP header sent while loading the resources of inspected page and the value of the <code>navigator.userAgent</code> property returned to the scripts running within the inspected page."

[kathyw, 2011/10/26 18:02:28]

This sentence is very long, is missing some articles, and could be clearer. How
about (not sure this is right, so please check!):

"If specified, the string will override the value of the <code>User-Agent</code>
HTTP header that's sent while loading the resources of inspected page. The
string will also override the value of the <code>navigator.userAgent</code>
property that's returned to any scripts that are running within the inspected
page."

+              },
+              "injectedScript": {
+                "type": "string",
+                "optional": true,
+                "description": "If specified, the script will be injected into every frame of the inspected page immediately upon load, before any of the frame's scripts. The script will not be injected after subsequent reloads, for example, if user presses Ctrl+R."

[kathyw, 2011/10/26 18:02:28]

, for example -> —for example

+              }
+            }
           }
         ]
       },