Add docs for chrome.wallpaper API

chrome/common/extensions/api/wallpaper.json

Index: chrome/common/extensions/api/wallpaper.json
diff --git a/chrome/common/extensions/api/wallpaper.json b/chrome/common/extensions/api/wallpaper.json
index 59f7cb5be4765d5761d94a869ed795b610419783..92cd4efcec192e4c73cff96cc73c9c0d3cc239a1 100644
--- a/chrome/common/extensions/api/wallpaper.json
+++ b/chrome/common/extensions/api/wallpaper.json
@@ -9,13 +9,12 @@
       "implemented_in": "chrome/browser/chromeos/extensions/wallpaper_api.h"
     },
     "platforms": ["chromeos"],
-    "description": "none",
+    "description": "Use the <code>chrome.wallpaper</code> API to change the ChromeOS wallpaper.",
     "functions": [
     {
       "name": "setWallpaper",
       "type": "function",
-      "description": "Sets wallpaper to the image from url with specified layout",
-      "nodoc": "true",
+      "description": "Sets wallpaper to the image at 'url' or 'wallpaperData' with the specified layout",

[not at google - send to devlin, 2013/10/17 18:18:20]

<code>url</code> and <code>wallpaperData</code>

[bshe, 2013/10/17 20:32:18]

Done.

       "parameters": [
         {
           "name": "details",
@@ -29,7 +28,7 @@
             "url": {
               "type": "string",
               "optional": true,
-              "description": "The url of online wallpaper."
+              "description": "The URL of the wallpaper to be set. If host permissions for this URL are not specified in the manifest file, the API call will fail."
             },
             "layout": {
               "type": "string",
@@ -38,7 +37,7 @@
             },
             "name": {
               "type": "string",
-              "description": "The file name of saved wallpaper."
+              "description": "The file name of the saved wallpaper."
             },
             "thumbnail": {
               "type": "boolean",
@@ -54,7 +53,8 @@
             {
               "type": "binary",
               "optional": true,
-              "name": "thumbnail"
+              "name": "thumbnail",
+              "description": "The jpeg encoded wallpaper thumbnail(128x60)."

[not at google - send to devlin, 2013/10/17 18:18:20]

could you explain this (128x60) thing? Does it means it's automatically scaled?
that it needs to be these dimensions?

also space between thumbnail and the parens.

[bshe, 2013/10/17 20:32:18]

Done.

             }
           ]
         }