Added chrome.experimental.devtools.panels.createStatusBarButton()

chrome/common/extensions/api/devtools_api.json

 [
   {
     "namespace": "experimental.devtools.inspectedWindow",
     "types": [
       {
         "id": "Resource",
         "type": "object",
         "description": "A resource within the inspected page, such as a document, a script, or an image.",
         "properties": {
           "url": {
@@ skipping 208 matching lines @@
                 ]
               }
             ]
           }
         ]
       },
       {
         "id": "ExtensionPanel",
         "type": "object",
         "description": "Represents a panel created by extension.",
+        "functions": [
+          {
+            "name": "createStatusBarButton",
+            "description": "Appends a button to the status bar of the panel.",
+            "parameters": [
+              {
+                "name": "iconPath",
+                "type": "string",
+                "description": "Path to the icon of the button. The file should contain a 64x24 pixels image composed of two 32x24 icons. The left icon is used for inactive state of the button and the right one is displayed while the button is depressed."

[kathyw, 2011/11/21 19:55:46]

64x24 pixels -> 64x24-pixel

for inactive state of the button
 ->
when the button is inactive

and the right -> ; the right icon

while the button is depressed ->
when the button is pressed
(otherwise, it sounds like the button is very very sad)

+              },
+              {
+                "name": "tooltipText",
+                "type": "string",
+                "description": "Text shown as a tooltip when user hovers the mouse over the button."
+              },
+              {
+                "name": "disabled",
+                "type": "boolean",
+                "description": "Whether the button is disabled."
+              }
+            ],
+            "returns": { "$ref": "Button" }
+          }
+        ],
         "events": [
           {
             "name": "onSearch",
             "description": "Fired upon a search action (start of a new search, search result navigation, or search being canceled).",
             "parameters": [
               {
                 "name": "action",
                 "type": "string",
                 "description": "Type of search action being performed."
               },
@@ skipping 30 matching lines @@
         "description": "A sidebar created by the extension.",
         "functions": [
           {
             "name": "setHeight",
             "type": "function",
             "description": "Sets the height of the sidebar.",
             "parameters": [
               {
                 "name": "height",
                 "type": "string",
-                "description": "A CSS-like size specification, e.g. '10px' or '12pt'."
+                "description": "A CSS-like size specification, such as <code>'100px'</code> or <code>'12ex'</code>."
               }
             ]
           },
           {
             "name": "setExpression",
             "type": "function",
             "description": "Sets an expression that is evaluated within the inspected page. The result is displayed in the sidebar pane.",
             "parameters": [
               {
                 "name": "expression",
                 "type": "string",
                 "description": "An expression to be evaluated in context of the inspected page. JavaScript objects and DOM nodes are displayed in an expandable tree similar to the console/watch."
               },
               {
                 "name": "rootTitle",
                 "type": "string",
                 "optional": true,
                 "description": "An optional title for the root of the expression tree."
+              },
+              {
+                "name": "callback",
+                "type": "function",
+                "optional": true,
+                "description": "A callback invoked after the sidebar pane is updated with the expression evaluation results."
               }
             ]
           },
           {
             "name": "setObject",
             "type": "function",
             "description": "Sets a JSON-compliant object to be displayed in the sidebar pane.",
             "parameters": [
               {
                 "name": "jsonObject",
                 "type": "string",
                 "description": "An object to be displayed in context of the inspected page. Evaluated in the context of the caller (API client)."
               },
               {
                 "name": "rootTitle",
                 "type": "string",
                 "optional": true,
                 "description": "An optional title for the root of the expression tree."
+              },
+              {
+                "name": "callback",
+                "type": "function",
+                "optional": true,
+                "description": "A callback invoked after the sidebar is updated with the object."
               }
             ]
           },
           {
             "name": "setPage",
             "type": "function",
             "description": "Sets an HTML page to be displayed in the sidebar pane.",
             "parameters": [
               {
                 "name": "path",
@@ skipping 16 matching lines @@
                 "description": "The <code>window</code> object of the sidebar page, if one was set with the <code>setPage()</code> method."
               }
             ]
           },
           {
             "name": "onHidden",
             "type": "function",
             "description": "Fired when the sidebar pane becomes hidden as a result of the user switching away from the panel that hosts the sidebar pane."
           }
         ]
+      },
+      {
+        "id": "Button",
+        "type": "object",
+        "description": "A button created by the extension.",
+        "functions": [
+          {
+            "name": "update",
+            "description": "Updates the attributes of the button. If some of the arguments are omitted or <code>null</code>, the corresponding attributes are not updated.",
+            "parameters": [
+              {
+                "name": "iconPath",
+                "type": "string",
+                "optional": true,
+                "description": "Path to the new icon of the button."
+              },
+              {
+                "name": "tooltipText",
+                "type": "string",
+                "optional": true,
+                "description": "Text shown as a tooltip when user hovers the mouse over the button."
+              },
+              {
+                "name": "disabled",
+                "type": "boolean",
+                "optional": true,
+                "description": "Whether the button is disabled."
+              }
+            ]
+          }
+        ],
+        "events": [
+          {
+            "name": "onClicked",
+            "type": "function",
+            "description": "Fired when the button is clicked."
+          }
+        ]
       }
     ],
     "properties": {
       "elements": {
         "$ref": "ElementsPanel",
         "description": "Elements panel."
       }
     },
     "functions": [
       {
@@ skipping 400 matching lines @@
             "type": "string"
           },
           "Severe": {
             "type": "string"
           }
         }
       }
     ]
   }
 ]