Add return type parameters to Bookmark APIs

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "self",
     "types": [
     ],
     "functions": [
       {
         "name": "getViews",
         "type": "function",
         "description": "Returns an array of the global JavaScript objects for each of the views running inside the current extension. This includes toolstrips, background pages, and tabs.",
@@ skipping 492 matching lines @@
             "optional": false
           }
         ]
       }
     ],
     "events": [
     ]
   },
   {
     "namespace": "bookmarks",
-    "types": [],
+    "types": [
+      {
+        "id": "BookmarkTreeNode",
+        "type": "object",
+        "properties": {
+          "id": {"type": "integer", "minimum": 0},
+          "index": {"type": "integer", "minimum": 0},
+          "windowId": {"type": "integer", "minimum": 0},
+          "selected": {"type": "boolean"},
+          "url": {"type": "string"},
+          "title": {"type": "string", "optional": true},
+          "favIconUrl": {"type": "string", "optional": true}
+        }
+      }
+    ],
     "functions": [
       {
         "name": "get",
         "type": "function",
-        "description": "",
+        "description": "Retrieves the specified BookmarkTreeNode(s).",
         "parameters": [
           {
             "name": "idOrIdList",
+            "description": "A single string-valued id, or an array of string-valued ids",
             "choices": [
               {"type": "string"},
               {"type": "array", "items": {"type": "string"}, "minItems": 1}
             ] 
           },
-          {"type": "function", "name": "callback"}
+          {
+            "type": "function", 
+            "name": "callback",
+            "parameters": [
+              {"name": "results", "type": "array", "items": { "$ref": "BookmarkTreeNode"} }
+            ]
+          }
         ]
       },
       {
         "name": "getChildren",
         "type": "function",
-        "description": "",
+        "description": "Retrieves the children of the specified BookmarkTreeNode id.",
         "parameters": [
           {"type": "string", "name": "id"},
-          {"type": "function", "name": "callback"}
+          {
+            "type": "function", 
+            "name": "callback",
+            "parameters": [
+              {"name": "results", "type": "array", "items": { "$ref": "BookmarkTreeNode"} }
+            ]
+          }
         ]
       },
       {
         "name": "getTree",
         "type": "function",
-        "description": "",
+        "description": "Retrieves the entire Bookmarks hierarchy.",
         "parameters": [
-          {"type": "function", "name": "callback"}
+          {
+            "type": "function", 
+            "name": "callback",
+            "parameters": [
+              {"name": "results", "type": "array", "items": { "$ref": "BookmarkTreeNode"} }
+            ]
+          }
         ]
       },
       {
         "name": "search",
         "type": "function",
-        "description": "",
+        "description": "Seaches for BookmarkTreeNodes matching the given query.",
         "parameters": [
           {"type": "string", "name": "query"},
-          {"type": "function", "name": "callback"}
+          {
+            "type": "function", 
+            "name": "callback",
+            "parameters": [
+              {"name": "results", "type": "array", "items": { "$ref": "BookmarkTreeNode"} }
+            ]
+          }
         ]
       },
       {
         "name": "create",
         "type": "function",
         "description": "",
         "parameters": [
           {
             "type": "object",
             "name": "bookmark",
             "properties": {
               "parentId": {"type": "string"},
               "index": {"type": "integer", "minimum": 0, "optional": true},
               "title": {"type": "string", "optional": true},
               "url": {"type": "string", "optional": true}
             }
           },
-          {"type": "function", "name": "callback", "optional": true}
+          {
+            "type": "function", 
+            "name": "callback",
+            "optional": true,
+            "parameters": [
+              {"name": "result", "$ref": "BookmarkTreeNode" }
+            ]
+          }
         ]
       },
       {
         "name": "move",
         "type": "function",
-        "description": "",
+        "description": "Moves the specified BookmarkTreeNode to the provided location.",
         "parameters": [
           {"type": "string", "name": "id"},
           {
             "type": "object",
             "name": "destination",
             "properties": {
               "parentId": {"type": "string"},
               "index": {"type": "integer", "minimum": 0, "optional": true}
             }
           },
-          {"type": "function", "name": "callback", "optional": true}
+          {"type": "function", "name": "callback", "optional": true, "parameters": []}
         ]
       },
       {
         "name": "update",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
           {
             "type": "object",
             "name": "changes",
             "properties": {
               "title": {"type": "string", "optional": true}
             }
           },
-          {"type": "function", "name": "callback", "optional": true}
+          {
+            "type": "function", 
+            "name": "callback",
+            "optional": true,
+            "parameters": [
+              {"name": "result", "$ref": "BookmarkTreeNode" }
+            ]
+          }
         ]
       },
       {
         "name": "remove",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
-          {"type": "function", "name": "callback", "optional": true}
+          {"type": "function", "name": "callback", "optional": true, "parameters": []}
         ]
       },
       {
         "name": "removeTree",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
-          {"type": "function", "name": "callback", "optional": true}
+          {"type": "function", "name": "callback", "optional": true, "parameters": []}
         ]
       }
     ],
     "events": [
       {
         "name": "onAdded",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
           {
-            "type": "object",
+            "$ref": "BookmarkTreeNode",
             "name": "bookmark"
           }
         ]
       },
       {
         "name": "onRemoved",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
           {
             "type": "object",
-            "name": "RemoveInfo"
+            "name": "RemoveInfo",
+            "properties": {
+              "parentId": { "type": "integer" },
+              "index": { "type": "integer" }
+            }
           }
         ]
       },
       {
         "name": "onChanged",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
           {
             "type": "object",
             "name": "ChangeInfo"
           }
         ]
       },
       {
         "name": "onMoved",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
           {
             "type": "object",
-            "name": "MoveInfo"
+            "name": "MoveInfo",
+            "properties": {
+              "parentId": { "type": "integer" },
+              "index": { "type": "integer" },
+              "oldParentId": { "type": "integer" },
+              "oldIndex": { "type": "integer" }
+            }
           }
         ]
       },
       {
         "name": "onChildrenReordered",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "id"},
           {
-            "type": "object",
-            "name": "childIds"
+            "type": "arary",
+            "name": "childIds",
+            "items": { "type": "integer" }
           }
         ]
       }
     ]
   },
   {
     "namespace": "toolstrip",
     "types": [],
     "functions": [
       {
         "name": "expand",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "integer", "name": "height", "minimum": 0},
           {"type": "string", "name": "url", "optional": true},
-          {"type": "function", "name": "callback", "optional": true}
+          {"type": "function", "name": "callback", "optional": true, "parameters": []}
         ]
       },
       {
         "name": "collapse",
         "type": "function",
         "description": "",
         "parameters": [
           {"type": "string", "name": "url", "optional": true},
-          {"type": "function", "name": "callback", "optional": true}
+          {"type": "function", "name": "callback", "optional": true, "parameters": []}
         ]
       }
     ],
     "events": []
   }
 ]