Extension Settings API: move the API functions into an object SettingsNamepace,

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
           "tab": {"$ref": "Tab", "optional": true, "description":"This property will <b>only</b> be present when the connection was opened from a tab or content script."},
@@ skipping 1015 matching lines @@
             "type": "any",
             "description": "The old value of the setting, before it changed.",
             "optional": true
           },
           "newValue": {
             "type": "any",
             "description": "The new value of the setting.",
             "optional": true
           }
         }
-      }
-    ],
-    "functions": [
+      },
       {
-        "name": "get",
-        "unprivileged": true,
-        "type": "function",
-        "description": "Gets one or more values from settings.",
-        "parameters": [
+        "id": "StorageNamespace",

[not at google - send to devlin, 2011/11/23 02:24:43]

so apparently rietveld is bad at diffs

+        "type": "object",
+        "functions": [
           {
-            "name": "keys",
-            "choices": [
-              { "type": "string" },
-              { "type": "array", "items": { "type": "string" } },
+            "name": "get",
+            "unprivileged": true,
+            "type": "function",
+            "description": "Gets one or more values from settings.",
+            "parameters": [
               {
-                "type": "object",
-                "description": "Settings object to return in the callback, where the values are replaced with those from settings if they exist.",
-                "properties": {},
-                "additionalProperties": { "type": "any" }
+                "name": "keys",
+                "choices": [
+                  { "type": "string" },
+                  { "type": "array", "items": { "type": "string" } },
+                  {
+                    "type": "object",
+                    "description": "Settings object to return in the callback, where the values are replaced with those from settings if they exist.",
+                    "properties": {},
+                    "additionalProperties": { "type": "any" }
+                  }
+                ],
+                "description": "A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object).  An empty list or object will return an empty settings object.  Pass in null or undefined to get the entire contents of settings; this should only be used for debugging.",
+                "optional": true
+              },
+              {
+                "name": "callback",
+                "type": "function",
+                "description": "Callback with settings values, or on failure (in which case lastError will be set).",
+                "parameters": [
+                  {
+                    "name": "settings",
+                    "type": "object",
+                    "properties": {},
+                    "additionalProperties": { "type": "any" },
+                    "description": "Object with given keys set to settings values."
+                  }
+                ]
               }
-            ],
-            "description": "A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object).  An empty list or object will return an empty settings object.  Pass in null or undefined to get the entire contents of settings; this should only be used for debugging.",
-            "optional": true
+            ]
           },
           {
-            "name": "callback",
+            "name": "set",
+            "unprivileged": true,
             "type": "function",
-            "description": "Callback with settings values, or on failure (in which case lastError will be set).",
+            "description": "Sets multiple settings values.",
             "parameters": [
               {
                 "name": "settings",
                 "type": "object",
                 "properties": {},
                 "additionalProperties": { "type": "any" },
-                "description": "Object with given keys set to settings values."
+                "description": "Object to augment settings with. Values that cannot be serialized (functions, etc) will be ignored."
+              },
+              {
+                "name": "callback",
+                "type": "function",
+                "description": "Callback on success, or on failure (in which case lastError will be set).",
+                "parameters": [],
+                "optional": true
+              }
+            ]
+          },
+          {
+            "name": "remove",
+            "unprivileged": true,
+            "type": "function",
+            "description": "Removes one or more values from settings.",
+            "parameters": [
+              {
+                "name": "keys",
+                "choices": [
+                  {"type": "string"},
+                  {"type": "array", "items": {"type": "string"}, "minItems": 1}
+                ],
+                "description": "A single key or a list of keys to remove from settings."
+              },
+              {
+                "name": "callback",
+                "type": "function",
+                "description": "Callback on success, or on failure (in which case lastError will be set).",
+                "parameters": [],
+                "optional": true
+              }
+            ]
+          },
+          {
+            "name": "clear",
+            "unprivileged": true,
+            "type": "function",
+            "description": "Removes all values from settings.",
+            "parameters": [
+              {
+                "name": "callback",
+                "type": "function",
+                "description": "Callback on success, or on failure (in which case lastError will be set).",
+                "parameters": [],
+                "optional": true
               }
             ]
           }
         ]
-      },
-      {
-        "name": "set",
-        "unprivileged": true,
-        "type": "function",
-        "description": "Sets multiple settings values.",
-        "parameters": [
-          {
-            "name": "settings",
-            "type": "object",
-            "properties": {},
-            "additionalProperties": { "type": "any" },
-            "description": "Object to augment settings with. Values that cannot be serialized (functions, etc) will be ignored."
-          },
-          {
-            "name": "callback",
-            "type": "function",
-            "description": "Callback on success, or on failure (in which case lastError will be set).",
-            "parameters": [],
-            "optional": true
-          }
-        ]
-      },
-      {
-        "name": "remove",
-        "unprivileged": true,
-        "type": "function",
-        "description": "Removes one or more values from settings.",
-        "parameters": [
-          {
-            "name": "keys",
-            "choices": [
-              {"type": "string"},
-              {"type": "array", "items": {"type": "string"}, "minItems": 1}
-            ],
-            "description": "A single key or a list of keys to remove from settings."
-          },
-          {
-            "name": "callback",
-            "type": "function",
-            "description": "Callback on success, or on failure (in which case lastError will be set).",
-            "parameters": [],
-            "optional": true
-          }
-        ]
-      },
-      {
-        "name": "clear",
-        "unprivileged": true,
-        "type": "function",
-        "description": "Removes all values from settings.",
-        "parameters": [
-          {
-            "name": "callback",
-            "type": "function",
-            "description": "Callback on success, or on failure (in which case lastError will be set).",
-            "parameters": [],
-            "optional": true
-          }
-        ]
       }
     ],
     "events": [
       {
         "name": "onChanged",
         "unprivileged": true,
         "type": "function",
         "description": "Fired when one or more settings change.",
         "parameters": [
           {
             "name": "changes",
             "type": "array",
             "items": {"$ref": "SettingChange"}
+          },
+          {
+            "name": "namespace",
+            "type": "string",
+            "description": "The namespace (e.g. sync or local) of the area the changes are for."
           }
         ]
       }
-    ]
+    ],
+    "properties": {
+      "sync": {
+        "$ref": "StorageNamespace",
+        "description": "Settings under the \"sync\" namespace are synced using Chrome Sync.",
+        "value": [ "sync" ]
+      },
+      "local": {
+        "$ref": "StorageNamespace",
+        "description": "Settings under the \"local\" namespace are local to each browser.",

[Matt Perry, 2011/11/23 03:35:05]

"local to each machine"?

[not at google - send to devlin, 2011/11/23 11:04:52]

Done.

+        "value": [ "local" ]
+      }
+    }
   },
   {
     "namespace": "windows",
     "types": [
       {
         "id": "Window",
         "type": "object",
         "properties": {
           "id": {"type": "integer", "minimum": 0, "description": "The ID of the window. Window IDs are unique within a browser session."},
           "focused": {"type": "boolean", "description": "Whether the window is currently the focused window."},
@@ skipping 8073 matching lines @@
                   }
                 }
               }
             ]
           }
         ]
       }
     ]
   }
 ]