Extension Doc Changes (no building or testable changes): minor changes for tab & windows doc

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "types": [
       {
         "id": "Port",
         "type": "object",
         "description": "An object which allows two way communication with other pages.",
         "properties": {
           "name": {"type": "string"},
@@ skipping 138 matching lines @@
               {
                 "name": "window", "$ref": "Window"
               }
             ]
           }
         ]
       },
       {
         "name": "getLastFocused",
         "type": "function",
-        "description": "Get the window that was most recenly focused -- typically the window 'on top'.",
+        "description": "Get the window that was most recently focused -- typically the window 'on top'.",
         "parameters": [
           {
             "type": "function",
             "name": "callback",
             "parameters": [
               {
                 "name": "window", "$ref": "Window"
               }
             ]
           }
         ]
       },
       {
         "name": "getAll",
         "type": "function",
         "description": "Get all windows.",
         "parameters": [
           {
             "type": "object",
             "name": "getInfo",
             "optional": true,
             "description": "",
             "properties": {
-              "populate": {"type": "boolean", "optional": true, "description": "If true, each window object will have a <var>tabs</var> property that contains a list of the Tab objects for that window." }
+              "populate": {"type": "boolean", "optional": true, "description": "If true, each window object will have a <var>tabs</var> property that contains a list of the <a href='tabs.html#type-Tab'>Tab</a> objects for that window." }
             }
           },
           {
             "type": "function",
             "name": "callback",
             "parameters": [
               {
                 "name": "windows", "type": "array", "items": { "$ref": "Window" }
               }
             ]
           }
         ]
       },
       {
         "name": "create",
         "type": "function",
         "description": "Create (open) a new browser with any optional sizing, position or default url provided.",
         "parameters": [
           {
             "type": "object",
             "name": "createData",
             "properties": {
-              "url": {"type": "string", "optional": true, "description": "The URL to navigate the first tab to. Defaults to the New Tab Page."},
+              "url": {"type": "string", "optional": true, "description": "The URL to navigate the first tab to. Fully-qualified URLs must include a scheme (i.e. 'http://www.google.com', not 'www.google.com'). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page."},
               "left": {"type": "integer", "optional": true, "description": "The number of pixels to position the new window from the left edge of the screen. If not specified, the new window is offset naturally from the last focusd window."},
               "top": {"type": "integer", "optional": true, "description": "The number of pixels to position the new window from the top edge of the screen. If not specified, the new window is offset naturally from the last focusd window."},
               "width": {"type": "integer", "minimum": 0, "optional": true, "description": "The width in pixels of the new window. If not specified defaults to a natural width."},
               "height": {"type": "integer", "minimum": 0, "optional": true, "description": "The height in pixels of the new window. If not specified defaults to a natural height."}
             },
             "optional": true
           },
           {
             "type": "function",
             "name": "callback",
@@ skipping 111 matching lines @@
             "name": "callback",
             "parameters": [
               {"name": "tab", "$ref": "Tab"}
             ]
           }
         ]
       },
       {
         "name": "connect",
         "type": "function",
-        "description": "Connects to the content script(s) in the specified tab. The <a href='extension.html#event-onConnect'>chrome.extensions.onConnect</a> is fired in each content script running in the specified tab for the current extension. For more details, see <a href='content_scripts.html#messaging'>Content Script Messaging</a>.",
+        "description": "Connects to the content script(s) in the specified tab. The <a href='extension.html#event-onConnect'>chrome.extensions.onConnect</a> event is fired in each content script running in the specified tab for the current extension. For more details, see <a href='content_scripts.html#messaging'>Content Script Messaging</a>.",
         "parameters": [
           {
             "type": "integer",
             "name": "tabId",
             "minimum": 0
           },
           {
             "type": "object",
             "name": "connectInfo",
             "properties": {
@@ skipping 66 matching lines @@
               },
               "index": {
                 "type": "integer",
                 "minimum": 0,
                 "optional": true,
                 "description": "The position the tab should take in the window. The provided value will be clamped to between zero and the number of tabs in the window."
               },
               "url": {
                 "type": "string",
                 "optional": true,
-                "description": "The URL to navigate the tab to initially. Defaults to the New Tab Page."
+                "description": "The URL to navigate the tab to initially. Fully-qualified URLs must include a scheme (i.e. 'http://www.google.com', not 'www.google.com'). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page."
               },
               "selected": {
                 "type": "boolean",
                 "optional": true,
                 "description": "Whether the tab should become the selected tab in the window. Defaults to <var>true</var>"
               }
             }
           },
           {
             "type": "function",
@@ skipping 82 matching lines @@
                 "name": "language",
                 "description": "An ISO language code like <var>en</var> or <var>fr</var>."
               }
             ]
           }
         ]
       },
       {
         "name": "captureVisibleTab",
         "type": "function",
-        "description": "Captures the visible area of the visible tab in a window.",
+        "description": "Captures the visible area of the currently selected tab in the specified window.",
         "parameters": [
           {
             "type": "integer",
             "name": "windowId",
             "minimum": 0,
             "optional": true,
             "description": "The target window. Defaults to the <a href='windows.html#current-window'>current window</a>."
           },
           {
             "type": "function", "name": "callback", "parameters": [
-              {"type": "string", "name": "dataUrl", "description": "a data url encoding of the captured tab."}
+              {"type": "string", "name": "dataUrl", "description": "A data URL of a JPEG encoding of the visible area of the captured tab. May be assigned to the 'src' property of an HTML Image element for display."}
             ]
           }
         ]
       }
     ],
     "events": [
       {
         "name": "onCreated",
         "type": "function",
         "description": "Fires when a tab is created.",
@@ skipping 499 matching lines @@
         "type": "function",
         "description": "Logs a message during internal unit testing.",
         "parameters": [
           {"type": "string", "name": "message"}
         ]
       }
     ],
     "events": []
   }
 ]