Initial Managed Mode extension API, supporting querying the setting and a stub for enabling the mod…

chrome/common/extensions/api/experimental.managedMode.json

+[
+  {
+    "namespace": "experimental.managedMode",
+    "functions": [
+      {
+        "name": "enable",
+        "type": "function",
+        "description": "Shows a confirmation dialog, then puts the browser into managed mode. The callback parameter will be true if managed mode was entered successfully, false if the user cancelled the confirmation.<br>Extensions cannot disable managed mode. This must be done by the user from within the browser itself.",
+        "parameters": [
+          {
+            "type": "function",
+            "name": "callback",
+            "optional": true,
+            "parameters": [
+              {
+                "name": "result", 
+                "type": "object",
+                "description": "The result of the attempt to enable managed mode.",
+                "properties": {
+                  "success": {
+                    "description": "True if managed mode was entered successfully, false if the user cancelled the confirmation.",
+                    "type": "boolean"
+                  }
+                }
+              }
+            ]
+          }
+        ]
+      },
+      {
+        "name": "get",
+        "type": "function",
+        "description": "Gets the value of the setting describing whether managed mode is enabled.",
+        "parameters": [
+          {
+            "type": "function",
+            "name": "callback",
+            "description": "This callback function is similar to that used by a $ref:ChromeSetting, except that the incognitoSpecific parameter will never be present and the possible values of levelOfControl differ.",

[Bernhard Bauer, 2012/03/01 16:32:14]

The "$ref" in here will not be expanded. You could use an <a> to link to the
documentation though.

[Bernhard Bauer, 2012/03/01 16:32:14]

Nit: Use some sort of markup for |incognitoSpecific| and |levelOfControl|?

[Pam (message me for reviews), 2012/03/01 20:47:34]

OK... How come it works in windows.json? ($ref:Tab)

This is of course one of the things I will check once i get the docs generating
properly. :P

[Bernhard Bauer, 2012/03/02 09:23:58]

Huh, it works. Whaddyaknow ;-)

+            "parameters": [
+              {
+                "name": "details",
+                "type": "object",
+                "description": "Details of the currently effective value.",
+                "properties": {
+                  "value": {
+                    "description": "The value of the setting.",
+                    "type": "any"

[Bernhard Bauer, 2012/03/01 16:32:14]

The type can be boolean.

+                  },
+                  "levelOfControl": {
+                    "description": "One of<br><var>not_controllable</var>: cannot be controlled by any extension<br><var>controllable_by_this_extension</var>: can be controlled by this extension",
+                    "type": "string",
+                    "enum": ["not_controllable", "controllable_by_this_extension"]
+                  }
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ]
+  }
+]