Update contentSettings extension API docs.

chrome/common/extensions/api/extension_api.json

 [
   {
     "namespace": "extension",
     "unprivileged": true,
     "types": [
       {
         "id": "MessageSender",
         "type": "object",
         "description": "An object containing information about the script context that sent a message or request.",
         "properties": {
@@ skipping 8158 matching lines @@
   },
   {
     "namespace": "contentSettings",
     "types": [
       {
         "id": "ResourceIdentifier",
         "type": "object",
         "properties": {
           "id": {
             "type": "string",
             "description": "The resource identifier for the given content type."

[battre, 2011/10/20 22:32:12]

Do you want to state whether these IDs are stable in the sense of "If you find
one, it is guaranteed to keep its name in the future"?

[Bernhard Bauer, 2011/10/21 14:04:18]

Done (in static/).

           },
           "description": {
             "type": "string",
             "optional": true,
             "description": "A human readable description of the resource."
           }
         },
-        "description": "The only content type using resource identifiers is <var>plugins</var>. Using a resource identifier allows an extension to specify content settings applying only to a specific plug-in. If no rule for the specific plug-in is found, the rules without resource identifiers are applied."
+        "description": "The only content type using resource identifiers is <a href=\"contentSettings.html#property-plugins\"><var>plugins</var></a>. For more information, see <a href=\"contentSettings.html#resource-identifiers\">Resource Identifiers.</a>"

[battre, 2011/10/20 22:32:12]

nit end with </a>." (move period)

[battre, 2011/10/20 22:32:12]

#resource-identifiers is not a valid anchor

[Bernhard Bauer, 2011/10/21 14:04:18]

Done.

[Bernhard Bauer, 2011/10/21 14:04:18]

fixed.

       },
       {
         "id": "ContentSetting",
         "type": "object",
         "functions": [
           {
             "name": "clear",
             "type": "function",
             "description": "Clear all content setting rules set by this extension.",
             "parameters": [
@@ skipping 69 matching lines @@
             "name": "set",
             "type": "function",
             "description": "Applies a new content setting rule.",
             "parameters": [
               {
                 "name": "details",
                 "type": "object",
                 "properties": {
                   "primaryPattern": {
                     "type": "string",
-                    "description": "The pattern for the primary URL. For details on the format of a pattern, see <a href='match_patterns.html'>Match Patterns</a>."
+                    "description": "The pattern for the primary URL. For details on the format of a pattern, see <a href='contentSettings.html#patterns'>Content Setting Patterns</a>."
                   },
                   "secondaryPattern": {
                     "type": "string",
-                    "description": "The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see <a href='match_patterns.html'>Match Patterns</a>.",
+                    "description": "The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see <a href='contentSettings.html#patterns'>Content Setting Patterns</a>.",
                     "optional": true
                   },
                   "resourceIdentifier": {
                     "$ref": "ResourceIdentifier",
                     "optional": true,
                     "description": "The resource identifier for the content type."
                   },
                   "setting": {
                     "type": "any",
                     "description": "The setting applied by this rule. See the description of the individual ContentSetting objects for the possible values."
@@ skipping 34 matching lines @@
                 ]
               }
             ]
           }
         ]
       }
     ],
     "properties": {
       "cookies": {
         "$ref": "ContentSetting",
         "description": "Whether to allow cookies and other local data to be set by websites. One of<br><var>allow</var>: Accept cookies,<br><var>block</var>: Block cookies,<br><var>session_only</var>: Accept cookies only for the current session. Default is <var>allow</var>.<br>The primary URL is the URL representing the cookie origin. The secondary URL is the URL of the top-level frame.",

[battre, 2011/10/20 22:32:12]

<br> before "Default is..." also in other occurrences

[Bernhard Bauer, 2011/10/21 14:04:18]

Done.

         "value": [
           "cookies",
           {"type":"string", "enum": ["allow", "block", "session_only"]}
         ]
       },
       "images": {
         "$ref": "ContentSetting",
         "description": "Whether to show images. One of<br><var>allow</var>: Show images,<br><var>block</var>: Don't show images. Default is <var>allow</var>.<br>The primary URL is the main-frame URL. The secondary URL is not used.",

[battre, 2011/10/20 22:32:12]

Whether to *display*? (also other occurrences in this text)

[Bernhard Bauer, 2011/10/21 14:04:18]

I'm using the same wording as in chrome://settings/content.

         "value": [
           "images",
           {"type":"string", "enum": ["allow", "block"]}
         ]
       },
       "javascript": {
         "$ref": "ContentSetting",
         "description": "Whether to run Javascript. One of<br><var>allow</var>: Run Javascript,<br><var>block</var>: Don't run Javascript. Default is <var>allow</var>.<br>The primary URL is the main-frame URL. The secondary URL is not used.",

[battre, 2011/10/20 22:32:12]

Whether to *execute* Java*S*cript (also other occurrences in the text)

[Bernhard Bauer, 2011/10/21 14:04:18]

Changed capitalization of JavaScript. Kept the "execute" as per
chrome://settings/content.

         "value": [
           "javascript",
           {"type":"string", "enum": ["allow", "block"]}
         ]
       },
       "plugins": {
         "$ref": "ContentSetting",
         "description": "Whether to run plug-ins. One of<br><var>allow</var>: Run plug-ins automatically,<br><var>block</var>: Don't run plug-ins automatically. Default is <var>allow</var>.<br>The primary URL is the main-frame URL. The secondary URL is not used.",
         "value": [
           "plugins",
@@ skipping 712 matching lines @@
                 "type": "array",
                 "items": { "$ref": "mimeTypeEnum" }
               }
             ]
           }
         ]
       }
     ]
   }
 ]