webext-schema 5.0.5 → 5.0.7

package/schemas/mail/mailext.json

@@ -2281,11 +2281,11 @@
           "choices": [
             {
               "type": "string",
-              "description": "A string containing a valid `CSS color string <https://developer.mozilla.org/en-US/docs/Web/CSS/color_value#color_keywords>`__, including hexadecimal or functional representations. For example the color *crimson* can be specified as: <li>``crimson`` <li>``#dc143c`` <li>``rgb(220, 20, 60)`` (or ``rgba(220, 20, 60, 0.5)`` to set 50% opacity) <li>``hsl(348, 83%, 47%)`` (or ``hsla(348, 83%, 47%, 0.5)`` to set 50% opacity)"
+              "description": "A string containing a valid `CSS color string <|link-css-color-string|>`__, including hexadecimal or functional representations. For example the color *crimson* can be specified as: <li><value>crimson</value> <li><value>#dc143c</value> <li><value>rgb(220, 20, 60)</value> (or <value>rgba(220, 20, 60, 0.5)</value> to set 50% opacity) <li><value>hsl(348, 83%, 47%)</value> (or <value>hsla(348, 83%, 47%, 0.5)</value> to set 50% opacity)"
             },
             {
               "type": "array",
-              "description": "An RGB array of 3 integers. For example ``[220, 20, 60]`` for the color *crimson*.",
+              "description": "An RGB array of 3 integers. For example <value>[220, 20, 60]</value> for the color *crimson*.",
               "minItems": 3,
               "maxItems": 3,
               "items": {
@@ -2296,7 +2296,7 @@
             },
             {
               "type": "array",
-              "description": "An RGBA array of 3 integers and a fractional (a float between 0 and 1). For example ``[220, 20, 60, 0.5]`` for the color *crimson* with 50% opacity.",
+              "description": "An RGBA array of 3 integers and a fractional (a float between 0 and 1). For example <value>[220, 20, 60, 0.5]<value> for the color *crimson* with 50% opacity.",
               "minItems": 4,
               "maxItems": 4,
               "items": {
@@ -2312,11 +2312,13 @@
           "properties": {
             "stylesheet": {
               "optional": true,
+              "description": "URL to a stylesheet introducing additional CSS variables, extending the theme-able areas of Thunderbird. The `theme_experiment add-on in our example repository <https://github.com/thundernest/sample-extensions/tree/master/theme_experiment>`__ is using the stylesheet shown below, to add the <value>--chat-button-color</value> CSS color variable: <literalinclude>includes/theme/theme_experiment_style.css<lang>CSS</lang></literalinclude>The following <em>manifest.json</em> file maps the </value>--chat-button-color</value> CSS color variable to the theme color key <value>exp_chat_button</value> and uses it to set a color for the chat button: <literalinclude>includes/theme/theme_experiment_manifest.json<lang>JSON</lang></literalinclude>",
               "$ref": "ExtensionURL"
             },
             "images": {
               "type": "object",
               "optional": true,
+              "description": "A <em>dictionary object</em> with one or more <em>key-value</em> pairs to map new theme image keys to internal Thunderbird CSS image variables. The new image key is usable as an image reference in :ref:`theme.ThemeType`. Example: <literalinclude>includes/theme/theme_experiment_image.json<lang>JSON</lang></literalinclude>",
               "additionalProperties": {
                 "type": "string"
               }
@@ -2324,6 +2326,7 @@
             "colors": {
               "type": "object",
               "optional": true,
+              "description": "A <em>dictionary object</em> with one or more <em>key-value</em> pairs to map new theme color keys to internal Thunderbird CSS color variables. The example shown below maps the theme color key <value>popup_affordance</value> to the CSS color variable </value>--arrowpanel-dimmed</value>. The new color key is usable as a color reference in :ref:`theme.ThemeType`. <literalinclude>includes/theme/theme_experiment_color.json<lang>JSON</lang></literalinclude>",
               "additionalProperties": {
                 "type": "string"
               }
@@ -2331,6 +2334,7 @@
             "properties": {
               "type": "object",
               "optional": true,
+              "description": "A <em>dictionary object</em> with one or more <em>key-value</em> pairs to map new theme property keys to internal Thunderbird CSS property variables. The new property key is usable as a property reference in :ref:`theme.ThemeType`. Example: <literalinclude>includes/theme/theme_experiment_property.json<lang>JSON</lang></literalinclude>",
               "additionalProperties": {
                 "type": "string"
               }
@@ -2343,7 +2347,7 @@
           "type": "object",
           "properties": {
             "images": {
-              "description": "Object with one or more key-value pairs to map images to theme image keys. The following built-in theme image keys are supported:",
+              "description": "A <em>dictionary object</em> with one or more <em>key-value</em> pairs to map images to theme image keys. The following built-in theme image keys are supported:",
               "type": "object",
               "optional": true,
               "properties": {
@@ -2354,12 +2358,12 @@
                   },
                   "maxItems": 15,
                   "optional": true,
-                  "description": "Additional images added to the header area and displayed behind the 'theme_frame' image."
+                  "description": "Additional images added to the header area and displayed behind the ``theme_frame`` image."
                 },
                 "headerURL": {
                   "$ref": "ImageDataOrExtensionURL",
                   "optional": true,
-                  "deprecated": "Unsupported images property, use 'theme.images.theme_frame', this alias is ignored in Thunderbird >= 70."
+                  "deprecated": "Unsupported images property, use ``theme.images.theme_frame``, this alias is ignored in Thunderbird >= 70."
                 },
                 "theme_frame": {
                   "$ref": "ImageDataOrExtensionURL",
@@ -2372,7 +2376,7 @@
               }
             },
             "colors": {
-              "description": "Object with one or more key-value pairs to map color values to theme color keys. The following built-in theme color keys are supported:",
+              "description": "A <em>dictionary object</em> with one or more <em>key-value</em> pairs to map color values to theme color keys. The following built-in theme color keys are supported:",
               "type": "object",
               "optional": true,
               "properties": {
@@ -2384,7 +2388,7 @@
                 "accentcolor": {
                   "$ref": "ThemeColor",
                   "optional": true,
-                  "deprecated": "Unsupported colors property, use 'theme.colors.frame', this alias is ignored in Thunderbird >= 70."
+                  "deprecated": "Unsupported colors property, use ``theme.colors.frame``, this alias is ignored in Thunderbird >= 70."
                 },
                 "frame": {
                   "$ref": "ThemeColor",
@@ -2399,7 +2403,7 @@
                 "textcolor": {
                   "$ref": "ThemeColor",
                   "optional": true,
-                  "deprecated": "Unsupported color property, use 'theme.colors.tab_background_text', this alias is ignored in Thunderbird >= 70."
+                  "deprecated": "Unsupported color property, use ``theme.colors.tab_background_text``, this alias is ignored in Thunderbird >= 70."
                 },
                 "tab_background_text": {
                   "$ref": "ThemeColor",
@@ -2419,7 +2423,7 @@
                 "tab_text": {
                   "$ref": "ThemeColor",
                   "optional": true,
-                  "description": "The text color for the selected tab.  Defaults to the color specified by ``toolbar_text``."
+                  "description": "The text color for the selected tab. Defaults to the color specified by ``toolbar_text``."
                 },
                 "tab_line": {
                   "$ref": "ThemeColor",
@@ -2593,7 +2597,7 @@
               }
             },
             "properties": {
-              "description": "Object with one or more key-value pairs to map property values to theme property keys. The following built-in theme property keys are supported:",
+              "description": "A <em>dictionary object</em> with one or more <em>key-value</em> pairs to map property values to theme property keys. The following built-in theme property keys are supported:",
               "type": "object",
               "optional": true,
               "properties": {
@@ -2636,7 +2640,7 @@
                   "optional": true
                 },
                 "color_scheme": {
-                  "description": "If set, overrides the general 'toolbar theme'.",
+                  "description": "If set, overrides the general theme (context menus, toolbars, content area).",
                   "optional": true,
                   "type": "string",
                   "enum": [
@@ -2705,7 +2709,8 @@
           "properties": {
             "theme_experiment": {
               "$ref": "ThemeExperiment",
-              "optional": true
+              "optional": true,
+              "description": "A theme experiment allows modifying the user interface of Thunderbird beyond what is currently possible using the built-in color, image and property keys of :ref:`theme.ThemeType`. These experiments are a precursor to proposing new theme features for inclusion in Thunderbird. Experimentation is done by mapping internal CSS color, image and property variables to new theme keys and using them in :ref:`theme.ThemeType` and by loading additional style sheets to add new CSS variables, extending the theme-able areas of Thunderbird. Can be used in static and dynamic themes."
             }
           }
         }
@@ -2713,7 +2718,7 @@
     },
     {
       "namespace": "theme",
-      "description": "The theme API allows customizing of visual elements of Thunderbird.",
+      "description": "The theme API allows for customization of Thunderbird's visual elements.",
       "types": [
         {
           "id": "ThemeUpdateInfo",
@@ -2721,7 +2726,7 @@
           "description": "Info provided in the onUpdated listener.",
           "properties": {
             "theme": {
-              "type": "object",
+              "$ref": "ThemeType",
               "description": "The new theme after update"
             },
             "windowId": {
@@ -2851,7 +2856,7 @@
             },
             "type": {
               "type": "string",
-              "description": "What sort of account this is, e.g. ``imap``, ``nntp``, or ``pop3``."
+              "description": "What sort of account this is, e.g. <value>imap</value>, <value>nntp</value>, or <value>pop3</value>."
             },
             "folders": {
               "type": "array",
@@ -2880,7 +2885,7 @@
           "parameters": [
             {
               "name": "includeFolders",
-              "description": "Specifies whether the returned :ref:`accounts.MailAccount` objects should included their account's folders. Defaults to ``true``.",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` objects should included their account's folders. Defaults to <value>true</value>.",
               "optional": true,
               "default": true,
               "type": "boolean"
@@ -2903,7 +2908,7 @@
         {
           "name": "get",
           "type": "function",
-          "description": "Returns details of the requested account, or null if it doesn't exist.",
+          "description": "Returns details of the requested account, or <value>null</value> if it doesn't exist.",
           "async": "callback",
           "parameters": [
             {
@@ -2912,7 +2917,7 @@
             },
             {
               "name": "includeFolders",
-              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to ``true``.",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to <value>true</value>.",
               "optional": true,
               "default": true,
               "type": "boolean"
@@ -2933,12 +2938,12 @@
         {
           "name": "getDefault",
           "type": "function",
-          "description": "Returns the default account, or null if it is not defined.",
+          "description": "Returns the default account, or <value>null</value> if it is not defined.",
           "async": "callback",
           "parameters": [
             {
               "name": "includeFolders",
-              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to ``true``.",
+              "description": "Specifies whether the returned :ref:`accounts.MailAccount` object should included the account's folders. Defaults to <value>true</value>.",
               "optional": true,
               "default": true,
               "type": "boolean"
@@ -2976,7 +2981,7 @@
         {
           "name": "getDefaultIdentity",
           "type": "function",
-          "description": "Returns the default identity for an account, or null if it is not defined.",
+          "description": "Returns the default identity for an account, or <value>null</value> if it is not defined.",
           "async": "callback",
           "deprecated": "This will be removed. Use :ref:`identities.getDefault` instead.",
           "parameters": [
@@ -3083,7 +3088,7 @@
             "contact",
             "mailingList"
           ],
-          "description": "Indicates the type of a Node, which can be one of <code>addressBook</code>, <code>contact</code>, or <code>mailingList</code>."
+          "description": "Indicates the type of a Node."
         },
         {
           "id": "AddressBookNode",
@@ -3097,11 +3102,11 @@
             "parentId": {
               "type": "string",
               "optional": true,
-              "description": "The <code>id</code> of the parent object."
+              "description": "The ``id`` of the parent object."
             },
             "type": {
               "$ref": "NodeType",
-              "description": "Always set to <code>addressBook</code>."
+              "description": "Always set to <value>addressBook</value>."
             },
             "readOnly": {
               "type": "boolean",
@@ -3314,7 +3319,7 @@
         {
           "name": "onSearchRequest",
           "type": "function",
-          "description": "Registering this listener will create and list a read-only address book in Thunderbird's address book window, similar to LDAP address books. When selecting this address book, users will first see no contacts, but they can search for them, which will fire this event. Contacts returned by the listener callback will be displayed as contact cards in the address book. Several listeners can be registered, to create multiple address books.\n\nThe event also fires for each registered listener (for each created read-only address book), when users type something into the mail composer's <code>To:</code> field, or into similar fields like the calendar meeting attendees field. Contacts returned by the listener callback will be added to the autocomplete results in the dropdown of that field.\n\nExample: <literalinclude>includes/addressBooks/onSearchRequest.js<lang>JavaScript</lang></literalinclude>",
+          "description": "Registering this listener will create and list a read-only address book in Thunderbird's address book window, similar to LDAP address books. When selecting this address book, users will first see no contacts, but they can search for them, which will fire this event. Contacts returned by the listener callback will be displayed as contact cards in the address book. Several listeners can be registered, to create multiple address books.\n\nThe event also fires for each registered listener (for each created read-only address book), when users type something into the mail composer's <em>To:</em> field, or into similar fields like the calendar meeting attendees field. Contacts returned by the listener callback will be added to the autocomplete results in the dropdown of that field.\n\nExample: <literalinclude>includes/addressBooks/onSearchRequest.js<lang>JavaScript</lang></literalinclude>",
           "parameters": [
             {
               "name": "node",
@@ -3366,6 +3371,42 @@
         "addressBooks"
       ],
       "types": [
+        {
+          "id": "QueryInfo",
+          "description": "Object defining a query for :ref:`contacts.quickSearch`.",
+          "type": "object",
+          "properties": {
+            "searchString": {
+              "type": "string",
+              "optional": true,
+              "description": "One or more space-separated terms to search for."
+            },
+            "includeLocal": {
+              "type": "boolean",
+              "optional": true,
+              "default": true,
+              "description": "Whether to include results from local address books. Defaults to true."
+            },
+            "includeRemote": {
+              "type": "boolean",
+              "optional": true,
+              "default": true,
+              "description": "Whether to include results from remote address books. Defaults to true."
+            },
+            "includeReadOnly": {
+              "type": "boolean",
+              "optional": true,
+              "default": true,
+              "description": "Whether to include results from read-only address books. Defaults to true."
+            },
+            "includeReadWrite": {
+              "type": "boolean",
+              "optional": true,
+              "default": true,
+              "description": "Whether to include results from read-write address books. Defaults to true."
+            }
+          }
+        },
         {
           "id": "ContactNode",
           "type": "object",
@@ -3378,11 +3419,11 @@
             "parentId": {
               "type": "string",
               "optional": true,
-              "description": "The <code>id</code> of the parent object."
+              "description": "The ``id`` of the parent object."
             },
             "type": {
               "$ref": "addressBooks.NodeType",
-              "description": "Always set to <code>contact</code>."
+              "description": "Always set to <value>contact</value>."
             },
             "readOnly": {
               "type": "boolean",
@@ -3419,7 +3460,7 @@
         {
           "id": "PropertyChange",
           "type": "object",
-          "description": "A dictionary of changed properties. Keys are the property name that changed, values are an object containing ``oldValue`` and ``newValue``. Values can be either a string or null.",
+          "description": "A dictionary of changed properties. Keys are the property name that changed, values are an object containing ``oldValue`` and ``newValue``. Values can be either a string or <value>null</value>.",
           "patternProperties": {
             "^\\w+$": {
               "type": "object",
@@ -3473,7 +3514,7 @@
               ]
             }
           ],
-          "description": "Gets all the contacts in the address book with the id <code>parentId</code>."
+          "description": "Gets all the contacts in the address book with the id ``parentId``."
         },
         {
           "name": "quickSearch",
@@ -3488,44 +3529,13 @@
             },
             {
               "name": "queryInfo",
+              "description": "Either a <em>string</em> with one or more space-separated terms to search for, or a complex :ref:`contacts.QueryInfo` search query.",
               "choices": [
                 {
-                  "type": "string",
-                  "description": "One or more space-separated terms to search for."
+                  "type": "string"
                 },
                 {
-                  "type": "object",
-                  "properties": {
-                    "searchString": {
-                      "type": "string",
-                      "optional": true,
-                      "description": "One or more space-separated terms to search for."
-                    },
-                    "includeLocal": {
-                      "type": "boolean",
-                      "optional": true,
-                      "default": true,
-                      "description": "Whether to include results from local address books. Defaults to true."
-                    },
-                    "includeRemote": {
-                      "type": "boolean",
-                      "optional": true,
-                      "default": true,
-                      "description": "Whether to include results from remote address books. Defaults to true."
-                    },
-                    "includeReadOnly": {
-                      "type": "boolean",
-                      "optional": true,
-                      "default": true,
-                      "description": "Whether to include results from read-only address books. Defaults to true."
-                    },
-                    "includeReadWrite": {
-                      "type": "boolean",
-                      "optional": true,
-                      "default": true,
-                      "description": "Whether to include results from read-write address books. Defaults to true."
-                    }
-                  }
+                  "$ref": "QueryInfo"
                 }
               ]
             },
@@ -3602,6 +3612,7 @@
               "type": "string"
             },
             {
+              "name": "file",
               "type": "object",
               "isInstanceOf": "File",
               "additionalProperties": true
@@ -3627,7 +3638,7 @@
             {
               "name": "properties",
               "$ref": "ContactProperties",
-              "description": "The properties object for the new contact. If it includes a <code>vCard</code> member, all specified `legacy properties <https://searchfox.org/comm-central/rev/8a1ae67088acf237dab2fd704db18589e7bf119e/mailnews/addrbook/modules/VCardUtils.jsm#295-334>`__ are ignored and the new contact will be based on the provided vCard string. If a UID is specified in the vCard string, which is already used by another contact, an exception is thrown. **Note:** Using individual properties is deprecated, use the <code>vCard</code> member instead."
+              "description": "The properties object for the new contact. If it includes a ``vCard`` member, all specified `legacy properties <|link-legacy-properties|>`__ are ignored and the new contact will be based on the provided vCard string. If a UID is specified in the vCard string, which is already used by another contact, an exception is thrown. **Note:** Using individual properties is deprecated, use the ``vCard`` member instead."
             },
             {
               "type": "function",
@@ -3641,7 +3652,7 @@
               ]
             }
           ],
-          "description": "Adds a new contact to the address book with the id <code>parentId</code>."
+          "description": "Adds a new contact to the address book with the id ``parentId``."
         },
         {
           "name": "update",
@@ -3655,7 +3666,7 @@
             {
               "name": "properties",
               "$ref": "ContactProperties",
-              "description": "An object with properties to update the specified contact. Individual properties are removed, if they are set to <code>null</code>. If the provided object includes a <code>vCard</code> member, all specified `legacy properties <https://searchfox.org/comm-central/rev/8a1ae67088acf237dab2fd704db18589e7bf119e/mailnews/addrbook/modules/VCardUtils.jsm#295-334>`__ are ignored and the details of the contact will be replaced by the provided vCard. Changes to the UID will be ignored. **Note:** Using individual properties is deprecated, use the <code>vCard</code> member instead. "
+              "description": "An object with properties to update the specified contact. Individual properties are removed, if they are set to <value>null</value>. If the provided object includes a ``vCard`` member, all specified `legacy properties <|link-legacy-properties|>`__ are ignored and the details of the contact will be replaced by the provided vCard. Changes to the UID will be ignored. **Note:** Using individual properties is deprecated, use the ``vCard`` member instead. "
             }
           ],
           "description": "Updates a contact."
@@ -3739,11 +3750,11 @@
             "parentId": {
               "type": "string",
               "optional": true,
-              "description": "The <code>id</code> of the parent object."
+              "description": "The ``id`` of the parent object."
             },
             "type": {
               "$ref": "addressBooks.NodeType",
-              "description": "Always set to <code>mailingList</code>."
+              "description": "Always set to <value>mailingList</value>."
             },
             "readOnly": {
               "type": "boolean",
@@ -3799,7 +3810,7 @@
               ]
             }
           ],
-          "description": "Gets all the mailing lists in the address book with id <code>parentId</code>."
+          "description": "Gets all the mailing lists in the address book with id ``parentId``."
         },
         {
           "name": "get",
@@ -3861,7 +3872,7 @@
               ]
             }
           ],
-          "description": "Creates a new mailing list in the address book with id <code>parentId</code>."
+          "description": "Creates a new mailing list in the address book with id ``parentId``."
         },
         {
           "name": "update",
@@ -3918,7 +3929,7 @@
               "type": "string"
             }
           ],
-          "description": "Adds a contact to the mailing list with id <code>id</code>. If the contact and mailing list are in different address books, the contact will also be copied to the list's address book."
+          "description": "Adds a contact to the mailing list with id ``id``. If the contact and mailing list are in different address books, the contact will also be copied to the list's address book."
         },
         {
           "name": "listMembers",
@@ -3943,7 +3954,7 @@
               ]
             }
           ],
-          "description": "Gets all contacts that are members of the mailing list with id <code>id</code>."
+          "description": "Gets all contacts that are members of the mailing list with id ``id``."
         },
         {
           "name": "removeMember",
@@ -3959,7 +3970,7 @@
               "type": "string"
             }
           ],
-          "description": "Removes a contact from the mailing list with id <code>id</code>. This does not delete the contact from the address book."
+          "description": "Removes a contact from the mailing list with id ``id``. This does not delete the contact from the address book."
         }
       ],
       "events": [
@@ -4042,19 +4053,19 @@
           "properties": {
             "default_label": {
               "type": "string",
-              "description": "The label of the action, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
+              "description": "The label of the action button, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
               "optional": true,
               "preprocess": "localize"
             },
             "default_title": {
               "type": "string",
-              "description": "The title of the action. This shows up in the tooltip and the label. Defaults to the add-on name.",
+              "description": "The title of the action button. This shows up in the tooltip and the label. Defaults to the add-on name.",
               "optional": true,
               "preprocess": "localize"
             },
             "default_icon": {
               "$ref": "IconPath",
-              "description": "The icon for the action.",
+              "description": "The paths to one or more icons for the action button.",
               "optional": true
             },
             "theme_icons": {
@@ -4070,17 +4081,17 @@
               "type": "string",
               "format": "relativeUrl",
               "optional": true,
-              "description": "The html document to be opened as a popup when the user clicks on the action's icon.",
+              "description": "The html document to be opened as a popup when the user clicks on the action button.",
               "preprocess": "localize"
             },
             "browser_style": {
               "type": "boolean",
               "optional": true,
-              "description": "Enable browser styles. See the `MDN documentation on browser styles <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information.",
+              "description": "Enable browser styles. See the `MDN documentation on browser styles <|link-mdn-browser-styles|>`__ for more information.",
               "default": false
             },
             "default_area": {
-              "description": "Defines the location the action will appear. The default location is ``maintoolbar``.",
+              "description": "Defines the location the action button will appear. The default location is <value>maintoolbar</value>.",
               "type": "string",
               "enum": [
                 "maintoolbar",
@@ -4089,7 +4100,7 @@
               "optional": true
             },
             "default_windows": {
-              "description": "Defines the windows, the action should appear in. Defaults to showing it only in the ``normal`` Thunderbird window, but can also be shown in the ``messageDisplay`` window.",
+              "description": "Defines the windows, the action button should appear in. Defaults to showing it only in the <value>normal</value> Thunderbird window, but can also be shown in the <value>messageDisplay</value> window.",
               "type": "array",
               "items": {
                 "type": "string",
@@ -4129,35 +4140,16 @@
     },
     {
       "namespace": "action",
-      "description": "Use an action to put an icon in the mail window toolbar. In addition to its icon, an action can also have a tooltip, a badge, and a popup.",
+      "description": "Use an action to put a button in the mail window toolbar. In addition to its icon, an action button can also have a tooltip, a badge, and a popup.",
       "permissions": [
         "manifest:action",
         "manifest:browser_action"
       ],
       "min_manifest_version": 3,
       "types": [
-        {
-          "id": "Details",
-          "type": "object",
-          "description": "Specifies to which tab or window the value should be set, or from which one it should be retrieved. If no tab nor window is specified, the global value is set or retrieved.",
-          "properties": {
-            "tabId": {
-              "type": "integer",
-              "optional": true,
-              "minimum": 0,
-              "description": "When setting a value, it will be specific to the specified tab, and will automatically reset when the tab navigates. When getting, specifies the tab to get the value from; if there is no tab-specific value, the window one will be inherited."
-            },
-            "windowId": {
-              "type": "integer",
-              "optional": true,
-              "minimum": -2,
-              "description": "When setting a value, it will be specific to the specified window. When getting, specifies the window to get the value from; if there is no window-specific value, the global one will be inherited."
-            }
-          }
-        },
         {
           "id": "ColorArray",
-          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <code>[255, 0, 0, 255]</code>.",
+          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <value>[255, 0, 0, 255]</value>.",
           "type": "array",
           "items": {
             "type": "integer",
@@ -4175,12 +4167,12 @@
             "type": "any"
           },
           "postprocess": "convertImageDataToURL",
-          "description": "Pixel data for an image. Must be an ImageData object (for example, from a <code>canvas</code> element)."
+          "description": "Pixel data for an image. Must be an |ImageData| object (for example, from a |Canvas| element)."
         },
         {
           "id": "ImageDataDictionary",
           "type": "object",
-          "description": "A ``{size: ImageDataType}`` dictionary representing the icon to be set. The actual :ref:`browserAction.ImageDataType` to be used is chosen depending on the screen's pixel density. See the `MDN documentation on browser styles <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information on this. At least one :ref:`browserAction.ImageDataType` must be specified.",
+          "description": "A <em>dictionary object</em> to specify multiple |ImageData| objects in different sizes, so the icon does not have to be scaled for a device with a different pixel density. Each entry is a <em>name-value</em> pair with <em>value</em> being an |ImageData| object, and <em>name</em> its size. Example: <literalinclude>includes/ImageDataDictionary.json<lang>JavaScript</lang></literalinclude>See the `MDN documentation about choosing icon sizes <|link-mdn-icon-size|>`__ for more information on this.",
           "patternProperties": {
             "^[1-9]\\d*$": {
               "$ref": "ImageDataType"
@@ -4190,7 +4182,7 @@
         {
           "id": "OnClickData",
           "type": "object",
-          "description": "Information sent when a browser action is clicked.",
+          "description": "Information sent when an action button is clicked.",
           "properties": {
             "modifiers": {
               "type": "array",
@@ -4218,13 +4210,12 @@
         {
           "name": "setTitle",
           "type": "function",
-          "description": "Sets the title of the action. This shows up in the tooltip and the label. Defaults to the add-on name.",
+          "description": "Sets the title of the action button. Is used as tooltip and as the label.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "title": {
                   "choices": [
@@ -4235,7 +4226,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The string the action should display as its label and when moused over."
+                  "description": "A string the action button should display as its label and when moused over. Cleared by setting it to <value>null</value> or an empty string (title defined the manifest will be used)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the title only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -4250,12 +4254,27 @@
         {
           "name": "getTitle",
           "type": "function",
-          "description": "Gets the title of the action.",
+          "description": "Gets the title of the action button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the title should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -4272,13 +4291,12 @@
         {
           "name": "setLabel",
           "type": "function",
-          "description": "Sets the label of the action, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
+          "description": "Sets the label of the action button. Can be used to set different values for the tooltip (defined by the title) and the label. Additionally, the label can be set to an empty string, not showing any label at all.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "label": {
                   "choices": [
@@ -4289,7 +4307,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The string the action should use as label. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback."
+                  "description": "A string the action button should use as its label, overriding the defined title. Can be set to an empty string to not display any label at all. If the containing toolbar is configured to display text only, its title will be used. Cleared by setting it to <value>null</value>."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the label only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -4304,12 +4335,27 @@
         {
           "name": "getLabel",
           "type": "function",
-          "description": "Gets the label of the action.",
+          "description": "Gets the label of the action button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -4326,13 +4372,12 @@
         {
           "name": "setIcon",
           "type": "function",
-          "description": "Sets the icon for the action. The icon can be specified either as the path to an image file or as the pixel data from a canvas element, or as dictionary of either one of those. Either the <b>path</b> or the <b>imageData</b> property must be specified.",
+          "description": "Sets the icon for the action button. Either the ``path`` or the ``imageData`` property must be specified.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "imageData": {
                   "choices": [
@@ -4344,19 +4389,25 @@
                     }
                   ],
                   "optional": true,
-                  "description": "Either an ImageDataType object defining a single icon used for all sizes or an ImageDataDictionary object defining dedicated icons for different sizes."
+                  "description": "The image data for one or more icons for the action button."
                 },
                 "path": {
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "$ref": "manifest.IconPath"
-                    }
-                  ],
+                  "$ref": "manifest.IconPath",
                   "optional": true,
-                  "description": "Either a relative image path defining a single icon used for all sizes or an IconPathDictionary object defining dedicated icons for different sizes."
+                  "description": "The paths to one or more icons for the action button."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the icon only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -4371,13 +4422,12 @@
         {
           "name": "setPopup",
           "type": "function",
-          "description": "Sets the html document to be opened as a popup when the user clicks on the action's icon.",
+          "description": "Sets the html document to be opened as a popup when the user clicks on the action button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "popup": {
                   "choices": [
@@ -4388,7 +4438,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The html file to show in a popup.  If set to the empty string (''), no popup is shown."
+                  "description": "The html file to show in a popup. Can be set to an empty string to not open a popup. Cleared by setting it to <value>null</value> (popup value defined the manifest will be used)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the popup only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -4403,12 +4466,27 @@
         {
           "name": "getPopup",
           "type": "function",
-          "description": "Gets the html document set as the popup for this action.",
+          "description": "Gets the html document set as the popup for this action button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the popup document should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -4425,13 +4503,12 @@
         {
           "name": "setBadgeText",
           "type": "function",
-          "description": "Sets the badge text for the action. The badge is displayed on top of the icon.",
+          "description": "Sets the badge text for the action button. The badge is displayed on top of the icon.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "text": {
                   "choices": [
@@ -4442,7 +4519,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "Any number of characters can be passed, but only about four can fit in the space."
+                  "description": "Any number of characters can be passed, but only about four can fit in the space. Cleared by setting it to <value>null</value> or an empty string."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the badge text only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -4457,12 +4547,27 @@
         {
           "name": "getBadgeText",
           "type": "function",
-          "description": "Gets the badge text of the action. If no tab nor window is specified, the global badge text is returned.",
+          "description": "Gets the badge text of the action button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -4485,10 +4590,8 @@
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "color": {
-                  "description": "An array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with a CSS value, with opaque red being <code>#FF0000</code> or <code>#F00</code>.",
                   "choices": [
                     {
                       "type": "string"
@@ -4499,7 +4602,21 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value> or an empty string."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the background color for the badge only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -4514,12 +4631,27 @@
         {
           "name": "getBadgeBackgroundColor",
           "type": "function",
-          "description": "Gets the background color of the action.",
+          "description": "Gets the badge background color of the action button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -4536,7 +4668,7 @@
         {
           "name": "enable",
           "type": "function",
-          "description": "Enables the action for a tab. By default, an action is enabled.",
+          "description": "Enables the action button for a tab. By default, an action button is enabled.",
           "async": "callback",
           "parameters": [
             {
@@ -4544,7 +4676,7 @@
               "optional": true,
               "name": "tabId",
               "minimum": 0,
-              "description": "The id of the tab for which you want to modify the action."
+              "description": "The id of the tab for which you want to modify the action button."
             },
             {
               "type": "function",
@@ -4557,7 +4689,7 @@
         {
           "name": "disable",
           "type": "function",
-          "description": "Disables the action for a tab.",
+          "description": "Disables the action button for a tab.",
           "async": "callback",
           "parameters": [
             {
@@ -4565,7 +4697,7 @@
               "optional": true,
               "name": "tabId",
               "minimum": 0,
-              "description": "The id of the tab for which you want to modify the action."
+              "description": "The id of the tab for which you want to modify the action button."
             },
             {
               "type": "function",
@@ -4578,12 +4710,27 @@
         {
           "name": "isEnabled",
           "type": "function",
-          "description": "Checks whether the action is enabled.",
+          "description": "Checks whether the action button is enabled.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the state should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -4601,7 +4748,7 @@
           "name": "openPopup",
           "type": "function",
           "requireUserInput": true,
-          "description": "Opens the extension popup window in the active window.",
+          "description": "Opens the action's popup window in the active window.",
           "async": true,
           "parameters": []
         }
@@ -4610,7 +4757,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when an action icon is clicked. This event will not fire if the action has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when an action button is clicked. This event will not fire if the action has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <|link-user-input-restrictions|>`__ apply.",
           "parameters": [
             {
               "name": "tab",
@@ -4847,7 +4994,7 @@
               "properties": {
                 "browser_style": {
                   "type": "boolean",
-                  "description": "Enable browser styles in the ``management_url`` page. See the `MDN documentation <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information.",
+                  "description": "Enable browser styles in the ``management_url`` page. See the `MDN documentation on browser styles <|link-mdn-browser-styles|>`__ for more information.",
                   "optional": true,
                   "default": false
                 },
@@ -4855,10 +5002,10 @@
                   "type": "string",
                   "optional": true,
                   "deprecated": true,
-                  "description": "This property is no longer used. The only supported data format for the ``data`` argument in ``onFileUpload`` is `File <https://developer.mozilla.org/docs/Web/API/File>`__."
+                  "description": "This property is no longer used. The only supported data format for the ``data`` argument in :ref:`cloudFile.onFileUpload` is |File|."
                 },
                 "reuse_uploads": {
-                  "description": "If a previously uploaded cloud file attachment is reused at a later time in a different message, Thunderbird may use the already known ``url`` and ``templateInfo`` values without triggering the registered :ref:`cloudFile.onFileUpload` listener again. Setting this option to false will always trigger the registered listener, providing the already known values through the ``relatedFileInfo`` parameter of the :ref:`cloudFile.onFileUpload` event, to let the provider decide how to handle these cases.",
+                  "description": "If a previously uploaded cloud file attachment is reused at a later time in a different message, Thunderbird may use the already known ``url`` and ``templateInfo`` values without triggering the registered :ref:`cloudFile.onFileUpload` listener again. Setting this option to <value>false</value> will always trigger the registered listener, providing the already known values through the ``relatedFileInfo`` parameter of the :ref:`cloudFile.onFileUpload` event, to let the provider decide how to handle these cases.",
                   "type": "boolean",
                   "optional": true,
                   "default": true
@@ -4884,7 +5031,7 @@
                   "type": "string",
                   "optional": true,
                   "deprecated": true,
-                  "description": "This property is no longer used. The ``service_url`` property of the :ref:`cloudFile.CloudFileTemplateInfo` object returned by the :ref:`cloudFile.onFileUpload` event can be used to add a ``Learn more about`` link to the footer of the cloud file attachment element."
+                  "description": "This property is no longer used. The ``service_url`` property of the :ref:`cloudFile.CloudFileTemplateInfo` object returned by the :ref:`cloudFile.onFileUpload` event can be used to add a <em>Learn more about</em> link to the footer of the cloud file attachment element."
                 }
               },
               "optional": true
@@ -4934,7 +5081,7 @@
             "properties": {
               "aborted": {
                 "type": "boolean",
-                "description": "Set this to true if the file upload was aborted by the user and an :ref:`cloudFile.onFileUploadAbort` event has been received. No error message will be shown to the user.",
+                "description": "Set this to <value>true</value> if the file upload was aborted by the user and an :ref:`cloudFile.onFileUploadAbort` event has been received. No error message will be shown to the user.",
                 "optional": true
               },
               "error": {
@@ -4946,7 +5093,7 @@
                     "type": "string"
                   }
                 ],
-                "description": "Report an error to the user. Set this to true for showing a generic error message, or set a specific error message.",
+                "description": "Report an error to the user. Set this to <value>true</value> for showing a generic error message, or set a specific error message.",
                 "optional": true
               },
               "url": {
@@ -5023,7 +5170,7 @@
                     "type": "string"
                   }
                 ],
-                "description": "Report an error to the user. Set this to true for showing a generic error message, or set a specific error message.",
+                "description": "Report an error to the user. Set this to <value>true</value> for showing a generic error message, or set a specific error message.",
                 "optional": true
               },
               "url": {
@@ -5104,19 +5251,19 @@
               "type": "integer",
               "minimum": -1,
               "optional": true,
-              "description": "The maximum size in bytes for a single file to upload. Set to -1 if unlimited."
+              "description": "The maximum size in bytes for a single file to upload. Set to <value>-1</value> if unlimited."
             },
             "spaceRemaining": {
               "type": "integer",
               "minimum": -1,
               "optional": true,
-              "description": "The amount of remaining space on the cloud provider, in bytes. Set to -1 if unsupported."
+              "description": "The amount of remaining space on the cloud provider, in bytes. Set to <value>-1</value> if unsupported."
             },
             "spaceUsed": {
               "type": "integer",
               "minimum": -1,
               "optional": true,
-              "description": "The amount of space already used on the cloud provider, in bytes. Set to -1 if unsupported."
+              "description": "The amount of space already used on the cloud provider, in bytes. Set to <value>-1</value> if unsupported."
             },
             "managementUrl": {
               "type": "string",
@@ -5143,7 +5290,7 @@
             "service_url": {
               "type": "string",
               "optional": true,
-              "description": "A URL pointing to a web page of the used cloud file service. Will be used in a ``Learn more about`` link in the footer of the cloud file attachment element."
+              "description": "A URL pointing to a web page of the used cloud file service. Will be used in a <em>Learn more about</em> link in the footer of the cloud file attachment element."
             },
             "download_password_protected": {
               "type": "boolean",
@@ -5166,7 +5313,7 @@
                 },
                 "format": {
                   "optional": true,
-                  "description": "A format options object as used by `Intl.DateTimeFormat <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat>`__. Defaults to: <literalinclude>includes/cloudFile/defaultDateFormat.js<lang>JavaScript</lang></literalinclude>",
+                  "description": "A format options object as used by |DateTimeFormat|. Defaults to: <literalinclude>includes/cloudFile/defaultDateFormat.js<lang>JavaScript</lang></literalinclude>",
                   "type": "object",
                   "additionalProperties": true
                 }
@@ -5199,7 +5346,7 @@
         {
           "id": "RelatedCloudFile",
           "type": "object",
-          "description": "Information about an already uploaded cloud file, which is related to a new upload. For example if the content of a cloud attachment is updated, if a repeatedly used cloud attachment is renamed (and therefore should be re-uploaded to not invalidate existing links) or if the provider has its manifest property ``reuse_uploads`` set to ``false``.",
+          "description": "Information about an already uploaded cloud file, which is related to a new upload. For example if the content of a cloud attachment is updated, if a repeatedly used cloud attachment is renamed (and therefore should be re-uploaded to not invalidate existing links) or if the provider has its manifest property ``reuse_uploads`` set to <value>false</value>.",
           "properties": {
             "id": {
               "type": "integer",
@@ -5306,19 +5453,19 @@
                   "type": "integer",
                   "minimum": -1,
                   "optional": true,
-                  "description": "The maximum size in bytes for a single file to upload. Set to -1 if unlimited."
+                  "description": "The maximum size in bytes for a single file to upload. Set to <value>-1</value> if unlimited."
                 },
                 "spaceRemaining": {
                   "type": "integer",
                   "minimum": -1,
                   "optional": true,
-                  "description": "The amount of remaining space on the cloud provider, in bytes. Set to -1 if unsupported."
+                  "description": "The amount of remaining space on the cloud provider, in bytes. Set to <value>-1</value> if unsupported."
                 },
                 "spaceUsed": {
                   "type": "integer",
                   "minimum": -1,
                   "optional": true,
-                  "description": "The amount of space already used on the cloud provider, in bytes. Set to -1 if unsupported."
+                  "description": "The amount of space already used on the cloud provider, in bytes. Set to <value>-1</value> if unsupported."
                 },
                 "managementUrl": {
                   "type": "string",
@@ -5370,7 +5517,7 @@
           "choices": [
             {
               "type": "string",
-              "description": "A name and email address in the format \"Name <email@example.com>\", or just an email address."
+              "description": "A name and email address in the format <value>Name <email@example.com></value>, or just an email address."
             },
             {
               "type": "object",
@@ -5450,7 +5597,7 @@
             "overrideDefaultFcc": {
               "type": "boolean",
               "optional": true,
-              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting ``false`` will clear the override. Setting ``true`` will throw an ``ExtensionError``, if ``overrideDefaultFccFolder`` is not set as well."
+              "description": "Indicates whether the default fcc setting (defined by the used identity) is being overridden for this message. Setting <value>false</value> will clear the override. Setting <value>true</value> will throw an <em>ExtensionError</em>, if ``overrideDefaultFccFolder`` is not set as well."
             },
             "overrideDefaultFccFolder": {
               "choices": [
@@ -5465,7 +5612,7 @@
                 }
               ],
               "optional": true,
-              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or ``\"\"`` to not save a copy at all."
+              "description": " This value overrides the default fcc setting (defined by the used identity) for this message only. Either a :ref:`folders.MailFolder` specifying the folder for the copy of the sent message, or an empty string to not save a copy at all."
             },
             "additionalFccFolder": {
               "choices": [
@@ -5479,7 +5626,7 @@
                   ]
                 }
               ],
-              "description": "An additional fcc folder which can be selected while composing the message, ``\"\"`` if not used.",
+              "description": "An additional fcc folder which can be selected while composing the message, an empty string if not used.",
               "optional": true
             },
             "replyTo": {
@@ -5507,7 +5654,7 @@
               "optional": true
             },
             "relatedMessageId": {
-              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <code>null</code> in all other cases or if the original message was opened from file.",
+              "description": "The id of the original message (in case of draft, template, forward or reply). Read-only. Is <value>null</value> in all other cases or if the original message was opened from file.",
               "type": "integer",
               "optional": true
             },
@@ -5550,7 +5697,7 @@
                 "html",
                 "both"
               ],
-              "description": "Defines the mime format of the sent message (ignored on plain text messages). Defaults to ``auto``, which will send html messages as plain text, if they do not include any formatting, and as ``both`` otherwise (a multipart/mixed message).",
+              "description": "Defines the mime format of the sent message (ignored on plain text messages). Defaults to <value>auto</value>, which will send html messages as plain text, if they do not include any formatting, and as <value>both</value> otherwise (a multipart/mixed message).",
               "optional": true
             },
             "customHeaders": {
@@ -5558,7 +5705,7 @@
               "items": {
                 "$ref": "CustomHeader"
               },
-              "description": "Array of custom headers. Headers will be returned in ``Http-Header-Case`` (a.k.a. ``Train-Case``). Set an empty array to clear all custom headers.",
+              "description": "Array of custom headers. Headers will be returned in <em>Http-Header-Case</em> (a.k.a. <em>Train-Case</em>). Set an empty array to clear all custom headers.",
               "optional": true
             },
             "priority": {
@@ -5576,7 +5723,7 @@
             "returnReceipt": {
               "type": "boolean",
               "optional": true,
-              "description": "Add the ``Disposition-Notification-To`` header to the message to requests the recipients email client to send a reply once the message has been received. Recipient server may strip the header and the recipient might ignore the request."
+              "description": "Add the <em>Disposition-Notification-To</em> header to the message to requests the recipients email client to send a reply once the message has been received. Recipient server may strip the header and the recipient might ignore the request."
             },
             "deliveryStatusNotification": {
               "type": "boolean",
@@ -5652,7 +5799,7 @@
           "properties": {
             "name": {
               "type": "string",
-              "description": "Name of a custom header, must have a ``X-`` prefix.",
+              "description": "Name of a custom header, must have a <value>X-</value> prefix.",
               "pattern": "^X-.*$"
             },
             "value": {
@@ -5666,14 +5813,14 @@
           "additionalProperties": {
             "type": "boolean"
           },
-          "description": "Object with language identifiers of all installed dictionaries as keys (for example ``en-US``) and a boolean value, indicating whether that dictionary is enabled for spellchecking or not."
+          "description": "A <em>dictionary object</em> with entries for all installed dictionaries, having a language identifier as <em>key</em> (for example <value>en-US</value>) and a boolean expression as <em>value</em>, indicating whether that dictionary is enabled for spellchecking or not."
         }
       ],
       "events": [
         {
           "name": "onBeforeSend",
           "type": "function",
-          "description": "Fired when a message is about to be sent from the compose window. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a message is about to be sent from the compose window. This is a user input event handler. For asynchronous listeners some `restrictions <|link-user-input-restrictions|>`__ apply.",
           "permissions": [
             "compose"
           ],
@@ -6035,7 +6182,7 @@
           "name": "getActiveDictionaries",
           "type": "function",
           "async": "callback",
-          "description": "Returns a :ref:`ComposeDictionaries` object, listing all installed dictionaries, including the information whether they are currently enabled or not.",
+          "description": "Returns a :ref:`compose.ComposeDictionaries` object, listing all installed dictionaries, including the information whether they are currently enabled or not.",
           "permissions": [
             "compose"
           ],
@@ -6111,7 +6258,7 @@
         {
           "name": "getAttachmentFile",
           "type": "function",
-          "description": "Gets the content of a :ref:`compose.ComposeAttachment` as a DOM <code>File</code> object.",
+          "description": "Gets the content of a :ref:`compose.ComposeAttachment` as a |File| object.",
           "async": "callback",
           "parameters": [
             {
@@ -6172,7 +6319,7 @@
         {
           "name": "updateAttachment",
           "type": "function",
-          "description": "Updates the name and/or the content of an attachment in the message being composed in the specified tab. If the specified attachment is a cloud file attachment and the associated provider failed to update the attachment, the function will throw an ``ExtensionError``.",
+          "description": "Updates the name and/or the content of an attachment in the message being composed in the specified tab. If the specified attachment is a cloud file attachment and the associated provider failed to update the attachment, the function will throw an <em>ExtensionError</em>.",
           "permissions": [
             "compose"
           ],
@@ -6227,7 +6374,7 @@
             "compose.send"
           ],
           "type": "function",
-          "description": "Sends the message currently being composed. If the send mode is not specified or set to ``default``, the message will be send directly if the user is online and placed in the users outbox otherwise. The returned Promise fulfills once the message has been successfully sent or placed in the user's outbox. Throws when the send process has been aborted by the user, by an :ref:`onBeforeSend` event or if there has been an error while sending the message to the outgoing mail server.",
+          "description": "Sends the message currently being composed. If the send mode is not specified or set to <value>default</value>, the message will be send directly if the user is online and placed in the users outbox otherwise. The returned Promise fulfills once the message has been successfully sent or placed in the user's outbox. Throws when the send process has been aborted by the user, by an :ref:`compose.onBeforeSend` event or if there has been an error while sending the message to the outgoing mail server.",
           "async": "callback",
           "parameters": [
             {
@@ -6382,19 +6529,19 @@
               "properties": {
                 "default_label": {
                   "type": "string",
-                  "description": "The label of the composeAction, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
+                  "description": "The label of the composeAction button, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
                   "optional": true,
                   "preprocess": "localize"
                 },
                 "default_title": {
                   "type": "string",
-                  "description": "The title of the composeAction. This shows up in the tooltip and the label. Defaults to the add-on name.",
+                  "description": "The title of the composeAction button. This shows up in the tooltip and the label. Defaults to the add-on name.",
                   "optional": true,
                   "preprocess": "localize"
                 },
                 "default_icon": {
                   "$ref": "IconPath",
-                  "description": "The icon for the messageDisplayAction.",
+                  "description": "The paths to one or more icons for the composeAction button.",
                   "optional": true
                 },
                 "theme_icons": {
@@ -6410,17 +6557,17 @@
                   "type": "string",
                   "format": "relativeUrl",
                   "optional": true,
-                  "description": "The html document to be opened as a popup when the user clicks on the composeAction's icon.",
+                  "description": "The html document to be opened as a popup when the user clicks on the composeAction button.",
                   "preprocess": "localize"
                 },
                 "browser_style": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Enable browser styles. See the `MDN documentation on browser styles <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information.",
+                  "description": "Enable browser styles. See the `MDN documentation on browser styles <|link-mdn-browser-styles|>`__ for more information.",
                   "default": false
                 },
                 "default_area": {
-                  "description": "Defines the location the composeAction will appear. The default location is ``maintoolbar``.",
+                  "description": "Defines the location the composeAction button will appear. The default location is <value>maintoolbar</value>.",
                   "type": "string",
                   "enum": [
                     "maintoolbar",
@@ -6437,33 +6584,14 @@
     },
     {
       "namespace": "composeAction",
-      "description": "Use a composeAction to put an icon in the message composition toolbars. In addition to its icon, a composeAction can also have a tooltip, a badge, and a popup.",
+      "description": "Use a composeAction to put a button in the message composition toolbars. In addition to its icon, a composeAction button can also have a tooltip, a badge, and a popup.",
       "permissions": [
         "manifest:compose_action"
       ],
       "types": [
-        {
-          "id": "Details",
-          "type": "object",
-          "description": "Specifies to which tab or window the value should be set, or from which one it should be retrieved. If no tab nor window is specified, the global value is set or retrieved.",
-          "properties": {
-            "tabId": {
-              "type": "integer",
-              "optional": true,
-              "minimum": 0,
-              "description": "When setting a value, it will be specific to the specified tab, and will automatically reset when the tab navigates. When getting, specifies the tab to get the value from; if there is no tab-specific value, the window one will be inherited."
-            },
-            "windowId": {
-              "type": "integer",
-              "optional": true,
-              "minimum": -2,
-              "description": "When setting a value, it will be specific to the specified window. When getting, specifies the window to get the value from; if there is no window-specific value, the global one will be inherited."
-            }
-          }
-        },
         {
           "id": "ColorArray",
-          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <code>[255, 0, 0, 255]</code>.",
+          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <value>[255, 0, 0, 255]</value>.",
           "type": "array",
           "items": {
             "type": "integer",
@@ -6481,12 +6609,12 @@
             "type": "any"
           },
           "postprocess": "convertImageDataToURL",
-          "description": "Pixel data for an image. Must be an ImageData object (for example, from a <code>canvas</code> element)."
+          "description": "Pixel data for an image. Must be an |ImageData| object (for example, from a |Canvas| element)."
         },
         {
           "id": "ImageDataDictionary",
           "type": "object",
-          "description": "A ``{size: ImageDataType}`` dictionary representing the icon to be set. The actual :ref:`composeAction.ImageDataType` to be used is chosen depending on the screen's pixel density. See the `MDN documentation on browser styles <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information on this. At least one :ref:`composeAction.ImageDataType` must be specified.",
+          "description": "A <em>dictionary object</em> to specify multiple |ImageData| objects in different sizes, so the icon does not have to be scaled for a device with a different pixel density. Each entry is a <em>name-value</em> pair with <em>value</em> being an |ImageData| object, and <em>name</em> its size. Example: <literalinclude>includes/ImageDataDictionary.json<lang>JavaScript</lang></literalinclude>See the `MDN documentation about choosing icon sizes <|link-mdn-icon-size|>`__ for more information on this.",
           "patternProperties": {
             "^[1-9]\\d*$": {
               "$ref": "ImageDataType"
@@ -6496,7 +6624,7 @@
         {
           "id": "OnClickData",
           "type": "object",
-          "description": "Information sent when a compose action is clicked.",
+          "description": "Information sent when a composeAction button is clicked.",
           "properties": {
             "modifiers": {
               "type": "array",
@@ -6524,13 +6652,12 @@
         {
           "name": "setTitle",
           "type": "function",
-          "description": "Sets the title of the composeAction. This shows up in the tooltip and the label. Defaults to the add-on name.",
+          "description": "Sets the title of the composeAction button. Is used as tooltip and as the label.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "title": {
                   "choices": [
@@ -6541,7 +6668,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The string the composeAction should display as its label and when moused over."
+                  "description": "A string the composeAction button should display as its label and when moused over. Cleared by setting it to <value>null</value> or an empty string (title defined the manifest will be used)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the title only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -6556,12 +6696,27 @@
         {
           "name": "getTitle",
           "type": "function",
-          "description": "Gets the title of the composeAction.",
+          "description": "Gets the title of the composeAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the title should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -6578,13 +6733,12 @@
         {
           "name": "setLabel",
           "type": "function",
-          "description": "Sets the label of the composeAction, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
+          "description": "Sets the label of the composeAction button. Can be used to set different values for the tooltip (defined by the title) and the label. Additionally, the label can be set to an empty string, not showing any label at all.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "label": {
                   "choices": [
@@ -6595,7 +6749,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The string the composeAction should use as label. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback."
+                  "description": "A string the composeAction button should use as its label, overriding the defined title. Can be set to an empty string to not display any label at all. If the containing toolbar is configured to display text only, its title will be used. Cleared by setting it to <value>null</value>."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the label only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -6610,12 +6777,27 @@
         {
           "name": "getLabel",
           "type": "function",
-          "description": "Gets the label of the composeAction.",
+          "description": "Gets the label of the composeAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -6632,13 +6814,12 @@
         {
           "name": "setIcon",
           "type": "function",
-          "description": "Sets the icon for the composeAction. The icon can be specified either as the path to an image file or as the pixel data from a canvas element, or as dictionary of either one of those. Either the <b>path</b> or the <b>imageData</b> property must be specified.",
+          "description": "Sets the icon for the composeAction button. Either the ``path`` or the ``imageData`` property must be specified.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "imageData": {
                   "choices": [
@@ -6650,19 +6831,25 @@
                     }
                   ],
                   "optional": true,
-                  "description": "Either an ImageDataType object defining a single icon used for all sizes or an ImageDataDictionary object defining dedicated icons for different sizes."
+                  "description": "The image data for one or more icons for the composeAction button."
                 },
                 "path": {
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "$ref": "manifest.IconPath"
-                    }
-                  ],
+                  "$ref": "manifest.IconPath",
+                  "optional": true,
+                  "description": "The paths to one or more icons for the composeAction button."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the icon only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
                   "optional": true,
-                  "description": "Either a relative image path defining a single icon used for all sizes or an IconPathDictionary object defining dedicated icons for different sizes."
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -6677,13 +6864,12 @@
         {
           "name": "setPopup",
           "type": "function",
-          "description": "Sets the html document to be opened as a popup when the user clicks on the composeAction's icon.",
+          "description": "Sets the html document to be opened as a popup when the user clicks on the composeAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "popup": {
                   "choices": [
@@ -6694,7 +6880,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The html file to show in a popup.  If set to the empty string (''), no popup is shown."
+                  "description": "The html file to show in a popup. Can be set to an empty string to not open a popup. Cleared by setting it to <value>null</value> (action will use the popup value defined in the manifest)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the popup only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -6709,12 +6908,27 @@
         {
           "name": "getPopup",
           "type": "function",
-          "description": "Gets the html document set as the popup for this composeAction.",
+          "description": "Gets the html document set as the popup for this composeAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the popup document should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -6731,13 +6945,12 @@
         {
           "name": "setBadgeText",
           "type": "function",
-          "description": "Sets the badge text for the composeAction. The badge is displayed on top of the icon.",
+          "description": "Sets the badge text for the composeAction button. The badge is displayed on top of the icon.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "text": {
                   "choices": [
@@ -6748,7 +6961,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "Any number of characters can be passed, but only about four can fit in the space."
+                  "description": "Any number of characters can be passed, but only about four can fit in the space. Cleared by setting it to <value>null</value> or an empty string."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the badge text only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -6763,12 +6989,27 @@
         {
           "name": "getBadgeText",
           "type": "function",
-          "description": "Gets the badge text of the composeAction. If no tab nor window is specified, the global badge text is returned.",
+          "description": "Gets the badge text of the composeAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -6791,10 +7032,8 @@
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "color": {
-                  "description": "An array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with a CSS value, with opaque red being <code>#FF0000</code> or <code>#F00</code>.",
                   "choices": [
                     {
                       "type": "string"
@@ -6805,7 +7044,21 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value> or an empty string."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the background color for the badge only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -6820,12 +7073,27 @@
         {
           "name": "getBadgeBackgroundColor",
           "type": "function",
-          "description": "Gets the background color of the composeAction.",
+          "description": "Gets the badge background color of the composeAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -6842,7 +7110,7 @@
         {
           "name": "enable",
           "type": "function",
-          "description": "Enables the composeAction for a tab. By default, a composeAction is enabled.",
+          "description": "Enables the composeAction button for a tab. By default, a composeAction button is enabled.",
           "async": "callback",
           "parameters": [
             {
@@ -6850,7 +7118,7 @@
               "optional": true,
               "name": "tabId",
               "minimum": 0,
-              "description": "The id of the tab for which you want to modify the composeAction."
+              "description": "The id of the tab for which you want to modify the composeAction button."
             },
             {
               "type": "function",
@@ -6863,7 +7131,7 @@
         {
           "name": "disable",
           "type": "function",
-          "description": "Disables the composeAction for a tab.",
+          "description": "Disables the composeAction button for a tab.",
           "async": "callback",
           "parameters": [
             {
@@ -6871,7 +7139,7 @@
               "optional": true,
               "name": "tabId",
               "minimum": 0,
-              "description": "The id of the tab for which you want to modify the composeAction."
+              "description": "The id of the tab for which you want to modify the composeAction button."
             },
             {
               "type": "function",
@@ -6884,12 +7152,27 @@
         {
           "name": "isEnabled",
           "type": "function",
-          "description": "Checks whether the composeAction is enabled.",
+          "description": "Checks whether the composeAction button is enabled.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the state should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -6907,7 +7190,7 @@
           "name": "openPopup",
           "type": "function",
           "requireUserInput": true,
-          "description": "Opens the extension popup window in the active window.",
+          "description": "Opens the action's popup window in the active window.",
           "async": true,
           "parameters": []
         }
@@ -6916,7 +7199,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when a composeAction icon is clicked. This event will not fire if the composeAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a composeAction button is clicked. This event will not fire if the composeAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <|link-user-input-restrictions|>`__ apply.",
           "parameters": [
             {
               "name": "tab",
@@ -7265,7 +7548,7 @@
           "permissions": [
             "accountsFolders"
           ],
-          "description": "Copies the given ``sourceFolder`` into the given ``destination``.  Throws if the destination already contains a folder with the name of the source folder.",
+          "description": "Copies the given ``sourceFolder`` into the given ``destination``. Throws if the destination already contains a folder with the name of the source folder.",
           "async": "callback",
           "parameters": [
             {
@@ -7345,7 +7628,7 @@
             },
             {
               "name": "includeSubFolders",
-              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each parent folder should include its nested subfolders . Defaults to ``false``.",
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each parent folder should include its nested subfolders . Defaults to <value>false</value>.",
               "optional": true,
               "default": false,
               "type": "boolean"
@@ -7384,7 +7667,7 @@
             },
             {
               "name": "includeSubFolders",
-              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each direct subfolder should also include all its nested subfolders . Defaults to ``true``.",
+              "description": "Specifies whether the returned :ref:`folders.MailFolder` object for each direct subfolder should also include all its nested subfolders . Defaults to <value>true</value>.",
               "optional": true,
               "default": true,
               "type": "boolean"
@@ -7601,7 +7884,7 @@
         {
           "name": "get",
           "type": "function",
-          "description": "Returns details of the requested identity, or null if it doesn't exist.",
+          "description": "Returns details of the requested identity, or <value>null</value> if it doesn't exist.",
           "async": "callback",
           "parameters": [
             {
@@ -7697,7 +7980,7 @@
         {
           "name": "getDefault",
           "type": "function",
-          "description": "Returns the default identity for the requested account, or null if it is not defined.",
+          "description": "Returns the default identity for the requested account, or <value>null</value> if it is not defined.",
           "async": "callback",
           "parameters": [
             {
@@ -7870,26 +8153,26 @@
           "properties": {
             "text": {
               "type": "string",
-              "description": "String to match against the <var>recipients</var>, <var>author</var>, <var>subject</var>, or <var>body</var>."
+              "description": "String to match against the ``recipients``, ``author``, ``subject``, or ``body``."
             },
             "recipients": {
               "type": "boolean",
-              "description": "Shows messages where <var>text</var> matches the recipients.",
+              "description": "Shows messages where ``text`` matches the recipients.",
               "optional": true
             },
             "author": {
               "type": "boolean",
-              "description": "Shows messages where <var>text</var> matches the author.",
+              "description": "Shows messages where ``text`` matches the author.",
               "optional": true
             },
             "subject": {
               "type": "boolean",
-              "description": "Shows messages where <var>text</var> matches the subject.",
+              "description": "Shows messages where ``text`` matches the subject.",
               "optional": true
             },
             "body": {
               "type": "boolean",
-              "description": "Shows messages where <var>text</var> matches the message body.",
+              "description": "Shows messages where ``text`` matches the message body.",
               "optional": true
             }
           }
@@ -7989,7 +8272,7 @@
         {
           "name": "update",
           "type": "function",
-          "description": "Modifies the properties of a mail tab. Properties that are not specified in <var>updateProperties</var> are not modified.",
+          "description": "Modifies the properties of a mail tab. Properties that are not specified in ``updateProperties`` are not modified.",
           "async": true,
           "parameters": [
             {
@@ -8010,7 +8293,7 @@
                 },
                 "sortType": {
                   "type": "string",
-                  "description": "Sorts the list of messages. <var>sortOrder</var> must also be given.",
+                  "description": "Sorts the list of messages. ``sortOrder`` must also be given.",
                   "optional": true,
                   "enum": [
                     "none",
@@ -8037,7 +8320,7 @@
                 },
                 "sortOrder": {
                   "type": "string",
-                  "description": "Sorts the list of messages. <var>sortType</var> must also be given.",
+                  "description": "Sorts the list of messages. ``sortType`` must also be given.",
                   "optional": true,
                   "enum": [
                     "none",
@@ -8270,7 +8553,7 @@
       "permissions": [
         "menus"
       ],
-      "description": "Use the browser.menus API to add items to the browser's menus. You can choose what types of objects your context menu additions apply to, such as images, hyperlinks, and pages.",
+      "description": "The menus API allows to add items to Thunderbirds menus. You can choose what types of objects your context menu additions apply to, such as images, hyperlinks, and pages.",
       "properties": {
         "ACTION_MENU_TOP_LEVEL_LIMIT": {
           "value": 6,
@@ -8303,7 +8586,7 @@
             "all_message_attachments",
             "tools_menu"
           ],
-          "description": "The different contexts a menu can appear in. Specifying <code>all</code> is equivalent to the combination of all other contexts excluding <code>tab</code> and <code>tools_menu</code>. More information about each context can be found in the `Supported UI Elements <https://developer.thunderbird.net/add-ons/mailextensions/supported-ui-elements#menu-items>`__ article on developer.thunderbird.net."
+          "description": "The different contexts a menu can appear in. Specifying <value>all</value> is equivalent to the combination of all other contexts excluding <value>tab</value> and <value>tools_menu</value>. More information about each context can be found in the `Supported UI Elements <|link-ui-elements|>`__ article on developer.thunderbird.net."
         },
         {
           "id": "ItemType",
@@ -8349,7 +8632,7 @@
             "mediaType": {
               "type": "string",
               "optional": true,
-              "description": "One of 'image', 'video', or 'audio' if the context menu was activated on one of these types of elements."
+              "description": "One of <value>image</value>, <value>video</value>, or <value>audio</value> if the context menu was activated on one of these types of elements."
             },
             "viewType": {
               "$ref": "extension.ViewType",
@@ -8368,7 +8651,7 @@
             },
             "srcUrl": {
               "type": "string",
-              "description": "Will be present for elements with a 'src' URL. **Note:** Host permission is required.",
+              "description": "Will be present for elements with a <em>src</em> URL. **Note:** Host permission is required.",
               "optional": true
             },
             "pageUrl": {
@@ -8389,7 +8672,7 @@
             "targetElementId": {
               "type": "integer",
               "optional": true,
-              "description": "An identifier of the clicked content element, if any. Use menus.getTargetElement in the page to find the corresponding element."
+              "description": "An identifier of the clicked content element, if any. Use :ref:`menus.getTargetElement` in the page to find the corresponding element."
             },
             "fieldId": {
               "type": "string",
@@ -8476,7 +8759,7 @@
             "mediaType": {
               "type": "string",
               "optional": true,
-              "description": "One of 'image', 'video', or 'audio' if the context menu was activated on one of these types of elements."
+              "description": "One of <value>image</value>, <value>video</value>, or <value>audio</value> if the context menu was activated on one of these types of elements."
             },
             "viewType": {
               "$ref": "extension.ViewType",
@@ -8496,7 +8779,7 @@
             "srcUrl": {
               "type": "string",
               "optional": true,
-              "description": "Will be present for elements with a 'src' URL."
+              "description": "Will be present for elements with a <em>src</em> URL."
             },
             "pageUrl": {
               "type": "string",
@@ -8551,7 +8834,7 @@
             "targetElementId": {
               "type": "integer",
               "optional": true,
-              "description": "An identifier of the clicked content element, if any. Use menus.getTargetElement in the page to find the corresponding element."
+              "description": "An identifier of the clicked content element, if any. Use :ref:`menus.getTargetElement` in the page to find the corresponding element."
             },
             "fieldId": {
               "type": "string",
@@ -8608,7 +8891,7 @@
         {
           "name": "create",
           "type": "function",
-          "description": "Creates a new context menu item. Note that if an error occurs during creation, you may not find out until the creation callback fires (the details will be in `runtime.lastError <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/lastError>`_).",
+          "description": "Creates a new context menu item. Note that if an error occurs during creation, you may not find out until the creation callback fires (the details will be in `runtime.lastError <|link-runtime-last-error|>`__).",
           "returns": {
             "choices": [
               {
@@ -8628,7 +8911,7 @@
                 "type": {
                   "$ref": "ItemType",
                   "optional": true,
-                  "description": "The type of menu item. Defaults to 'normal' if not specified."
+                  "description": "The type of menu item. Defaults to <value>normal</value> if not specified."
                 },
                 "id": {
                   "type": "string",
@@ -8636,23 +8919,19 @@
                   "description": "The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension."
                 },
                 "icons": {
-                  "type": "object",
+                  "$ref": "manifest.IconPath",
                   "optional": true,
-                  "patternProperties": {
-                    "^[1-9]\\d*$": {
-                      "type": "string"
-                    }
-                  }
+                  "description": "Custom icons to display next to the menu item. Custom icons can only be set for items appearing in submenus."
                 },
                 "title": {
                   "type": "string",
                   "optional": true,
-                  "description": "The text to be displayed in the item; this is <em>required</em> unless <code>type</code> is 'separator'. When the context is 'selection', you can use <code>%s</code> within the string to show the selected text. For example, if this parameter's value is \"Translate '%s' to Pig Latin\" and the user selects the word \"cool\", the context menu item for the selection is \"Translate 'cool' to Pig Latin\". To specify an access key for the new menu entry, include a <code>&</code> before the desired letter in the title. For example \"&Help\"."
+                  "description": "The text to be displayed in the item; this is <em>required</em> unless ``type`` is <value>separator</value>. When the context is <value>selection</value>, you can use <value>%s</value> within the string to show the selected text. For example, if this parameter's value is <value>Translate '%s' to Latin</value> and the user selects the word <value>cool</value>, the context menu item for the selection is <value>Translate 'cool' to Latin</value>. To specify an access key for the new menu entry, include a <value>&</value> before the desired letter in the title. For example <value>&Help</value>."
                 },
                 "checked": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "The initial state of a checkbox or radio item: true for selected and false for unselected. Only one radio item can be selected at a time in a given group of radio items."
+                  "description": "The initial state of a checkbox or radio item: <value>true</value> for selected and <value>false</value> for unselected. Only one radio item can be selected at a time in a given group of radio items."
                 },
                 "contexts": {
                   "type": "array",
@@ -8661,7 +8940,7 @@
                   },
                   "minItems": 1,
                   "optional": true,
-                  "description": "List of contexts this menu item will appear in. Defaults to ['page'] if not specified."
+                  "description": "List of contexts this menu item will appear in. Defaults to <value>['page']</value> if not specified."
                 },
                 "viewTypes": {
                   "type": "array",
@@ -8690,7 +8969,7 @@
                     {
                       "name": "tab",
                       "$ref": "tabs.Tab",
-                      "description": "The details of the tab where the click took place. **Note:** this parameter only present for extensions."
+                      "description": "The details of the tab where the click took place."
                     }
                   ]
                 },
@@ -8712,7 +8991,7 @@
                     "type": "string"
                   },
                   "optional": true,
-                  "description": "Lets you restrict the item to apply only to documents whose URL matches one of the given patterns. (This applies to frames as well.) For details on the format of a pattern, see `Match Patterns <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns>`_."
+                  "description": "Lets you restrict the item to apply only to documents whose URL matches one of the given patterns. (This applies to frames as well.) For details on the format of a pattern, see `Match Patterns <|link-match-patterns|>`__."
                 },
                 "targetUrlPatterns": {
                   "type": "array",
@@ -8730,7 +9009,7 @@
                 "command": {
                   "type": "string",
                   "optional": true,
-                  "description": "Specifies a command to issue for the context click.  Currently supports internal commands ``_execute_browser_action``, ``_execute_compose_action`` and ``_execute_message_display_action``."
+                  "description": "Specifies a command to issue for the context click. Currently supports internal commands <value>_execute_browser_action</value>, <value>_execute_compose_action</value> and <value>_execute_message_display_action</value>."
                 }
               }
             },
@@ -8738,7 +9017,7 @@
               "type": "function",
               "name": "callback",
               "optional": true,
-              "description": "Called when the item has been created in the browser. If there were any problems creating the item, details will be available in `runtime.lastError <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/lastError>`_.",
+              "description": "Called when the item has been created in the browser. If there were any problems creating the item, details will be available in `runtime.lastError <|link-runtime-last-error|>`__.",
               "parameters": []
             }
           ]
@@ -8771,13 +9050,8 @@
                   "optional": true
                 },
                 "icons": {
-                  "type": "object",
-                  "optional": "omit-key-if-missing",
-                  "patternProperties": {
-                    "^[1-9]\\d*$": {
-                      "type": "string"
-                    }
-                  }
+                  "$ref": "manifest.IconPath",
+                  "optional": "omit-key-if-missing"
                 },
                 "title": {
                   "type": "string",
@@ -8912,7 +9186,7 @@
             "menus.overrideContext"
           ],
           "type": "function",
-          "description": "Show the matching menu items from this extension instead of the default menu. This should be called during a 'contextmenu' DOM event handler, and only applies to the menu that opens after this event.",
+          "description": "Show the matching menu items from this extension instead of the default menu. This should be called during a `contextmenu <|link-contextmenu-event|>`__ event handler, and only applies to the menu that opens after this event.",
           "parameters": [
             {
               "name": "contextOptions",
@@ -8930,13 +9204,13 @@
                     "tab"
                   ],
                   "optional": true,
-                  "description": "ContextType to override, to allow menu items from other extensions in the menu. Currently only 'tab' is supported. showDefaults cannot be used with this option."
+                  "description": "ContextType to override, to allow menu items from other extensions in the menu. Currently only <value>tab</value> is supported. ``contextOptions.showDefaults`` cannot be used with this option."
                 },
                 "tabId": {
                   "type": "integer",
                   "minimum": 0,
                   "optional": true,
-                  "description": "Required when context is 'tab'. Requires the <permission>tabs</permission> permission."
+                  "description": "Required when context is <value>tab</value>. Requires the <permission>tabs</permission> permission."
                 }
               }
             }
@@ -8954,7 +9228,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when a context menu item is clicked. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a context menu item is clicked. This is a user input event handler. For asynchronous listeners some `restrictions <|link-user-input-restrictions|>`__ apply.",
           "parameters": [
             {
               "name": "info",
@@ -8972,7 +9246,7 @@
         {
           "name": "onShown",
           "type": "function",
-          "description": "Fired when a menu is shown. The extension can add, modify or remove menu items and call ``menus.refresh()`` to update the menu.",
+          "description": "Fired when a menu is shown. The extension can add, modify or remove menu items and call :ref:`menus.refresh` to update the menu.",
           "parameters": [
             {
               "name": "info",
@@ -9014,11 +9288,11 @@
             "content",
             "devtools"
           ],
-          "description": "Retrieve the element that was associated with a recent contextmenu event.",
+          "description": "Retrieve the element that was associated with a recent `contextmenu <|link-contextmenu-event|>`__ event.",
           "parameters": [
             {
               "type": "integer",
-              "description": "The identifier of the clicked element, available as info.targetElementId in the menus.onShown, onClicked or onclick event.",
+              "description": "The identifier of the clicked element, available as ``info.targetElementId`` in the :ref:`menus.onShown` and :ref:`menus.onClicked` events.",
               "name": "targetElementId"
             }
           ],
@@ -9079,7 +9353,7 @@
         {
           "name": "getDisplayedMessage",
           "type": "function",
-          "description": "Gets the currently displayed message in the specified tab (even if the tab itself is currently not visible). It returns null if no messages are displayed, or if multiple messages are displayed.",
+          "description": "Gets the currently displayed message in the specified tab (even if the tab itself is currently not visible). It returns <value>null</value> if no messages are displayed, or if multiple messages are displayed.",
           "async": "callback",
           "parameters": [
             {
@@ -9147,12 +9421,12 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 1,
-                  "description": "The id of a message to be opened. Will throw an ``ExtensionError``, if the provided ``messageId`` is unknown or invalid."
+                  "description": "The id of a message to be opened. Will throw an <em>ExtensionError</em>, if the provided ``messageId`` is unknown or invalid."
                 },
                 "headerMessageId": {
                   "type": "string",
                   "optional": true,
-                  "description": "The headerMessageId of a message to be opened. Will throw an ``ExtensionError``, if the provided ``headerMessageId`` is unknown or invalid. Not supported for external messages."
+                  "description": "The headerMessageId of a message to be opened. Will throw an <em>ExtensionError</em>, if the provided ``headerMessageId`` is unknown or invalid. Not supported for external messages."
                 },
                 "location": {
                   "type": "string",
@@ -9206,19 +9480,19 @@
               "properties": {
                 "default_label": {
                   "type": "string",
-                  "description": "The label of the messageDisplayAction, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
+                  "description": "The label of the messageDisplayAction button, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
                   "optional": true,
                   "preprocess": "localize"
                 },
                 "default_title": {
                   "type": "string",
-                  "description": "The title of the messageDisplayAction. This shows up in the tooltip and the label. Defaults to the add-on name.",
+                  "description": "The title of the messageDisplayAction button. This shows up in the tooltip and the label. Defaults to the add-on name.",
                   "optional": true,
                   "preprocess": "localize"
                 },
                 "default_icon": {
                   "$ref": "IconPath",
-                  "description": "The icon for the messageDisplayAction.",
+                  "description": "The paths to one or more icons for the messageDisplayAction button.",
                   "optional": true
                 },
                 "theme_icons": {
@@ -9234,13 +9508,13 @@
                   "type": "string",
                   "format": "relativeUrl",
                   "optional": true,
-                  "description": "The html document to be opened as a popup when the user clicks on the messageDisplayAction's icon.",
+                  "description": "The html document to be opened as a popup when the user clicks on the messageDisplayAction button.",
                   "preprocess": "localize"
                 },
                 "browser_style": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Enable browser styles. See the `MDN documentation on browser styles <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information.",
+                  "description": "Enable browser styles. See the `MDN documentation on browser styles <|link-mdn-browser-styles|>`__ for more information.",
                   "default": false
                 },
                 "default_area": {
@@ -9257,34 +9531,15 @@
     },
     {
       "namespace": "messageDisplayAction",
-      "description": "Use a messageDisplayAction to put an icon in the message display toolbar. In addition to its icon, a messageDisplayAction can also have a tooltip, a badge, and a popup.",
+      "description": "Use a messageDisplayAction to put a button in the message display toolbar. In addition to its icon, a messageDisplayAction button can also have a tooltip, a badge, and a popup.",
       "permissions": [
         "manifest:message_display_action"
       ],
       "types": [
-        {
-          "id": "Details",
-          "type": "object",
-          "description": "Specifies to which tab or window the value should be set, or from which one it should be retrieved. If no tab nor window is specified, the global value is set or retrieved.",
-          "properties": {
-            "tabId": {
-              "type": "integer",
-              "optional": true,
-              "minimum": 0,
-              "description": "When setting a value, it will be specific to the specified tab, and will automatically reset when the tab navigates. When getting, specifies the tab to get the value from; if there is no tab-specific value, the window one will be inherited."
-            },
-            "windowId": {
-              "type": "integer",
-              "optional": true,
-              "minimum": -2,
-              "description": "When setting a value, it will be specific to the specified window. When getting, specifies the window to get the value from; if there is no window-specific value, the global one will be inherited."
-            }
-          }
-        },
         {
           "id": "ColorArray",
+          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <value>[255, 0, 0, 255]</value>.",
           "type": "array",
-          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <code>[255, 0, 0, 255]</code>.",
           "items": {
             "type": "integer",
             "minimum": 0,
@@ -9301,12 +9556,12 @@
             "type": "any"
           },
           "postprocess": "convertImageDataToURL",
-          "description": "Pixel data for an image. Must be an ImageData object (for example, from a <code>canvas</code> element)."
+          "description": "Pixel data for an image. Must be an |ImageData| object (for example, from a |Canvas| element)."
         },
         {
           "id": "ImageDataDictionary",
           "type": "object",
-          "description": "A ``{size: ImageDataType}`` dictionary representing the icon to be set. The actual :ref:`messageDisplayAction.ImageDataType` to be used is chosen depending on the screen's pixel density. See the `MDN documentation on browser styles <https://developer.mozilla.org/docs/Mozilla/Add-ons/WebExtensions/user_interface/Browser_styles>`__ for more information on this. At least one :ref:`messageDisplayAction.ImageDataType` must be specified.",
+          "description": "A <em>dictionary object</em> to specify multiple |ImageData| objects in different sizes, so the icon does not have to be scaled for a device with a different pixel density. Each entry is a <em>name-value</em> pair with <em>value</em> being an |ImageData| object, and <em>name</em> its size. Example: <literalinclude>includes/ImageDataDictionary.json<lang>JavaScript</lang></literalinclude>See the `MDN documentation about choosing icon sizes <|link-mdn-icon-size|>`__ for more information on this.",
           "patternProperties": {
             "^[1-9]\\d*$": {
               "$ref": "ImageDataType"
@@ -9316,7 +9571,7 @@
         {
           "id": "OnClickData",
           "type": "object",
-          "description": "Information sent when a message display action is clicked.",
+          "description": "Information sent when a messageDisplayAction button is clicked.",
           "properties": {
             "modifiers": {
               "type": "array",
@@ -9344,13 +9599,12 @@
         {
           "name": "setTitle",
           "type": "function",
-          "description": "Sets the title of the messageDisplayAction. This shows up in the tooltip and the label. Defaults to the add-on name.",
+          "description": "Sets the title of the messageDisplayAction button. Is used as tooltip and as the label.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "title": {
                   "choices": [
@@ -9361,7 +9615,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The string the messageDisplayAction should display as its label and when moused over."
+                  "description": "A string the messageDisplayAction button should display as its label and when moused over. Cleared by setting it to <value>null</value> or an empty string (title defined the manifest will be used)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the title only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -9376,12 +9643,27 @@
         {
           "name": "getTitle",
           "type": "function",
-          "description": "Gets the title of the messageDisplayAction.",
+          "description": "Gets the title of the messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the title should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -9398,13 +9680,12 @@
         {
           "name": "setLabel",
           "type": "function",
-          "description": "Sets the label of the messageDisplayAction, defaults to its title. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback.",
+          "description": "Sets the label of the messageDisplayAction button. Can be used to set different values for the tooltip (defined by the title) and the label. Additionally, the label can be set to an empty string, not showing any label at all.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "label": {
                   "choices": [
@@ -9415,7 +9696,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The string the messageDisplayAction should use as label. Can be set to an empty string to not display any label. If the containing toolbar is configured to display text only, the title will be used as fallback."
+                  "description": "A string the messageDisplayAction button should use as its label, overriding the defined title. Can be set to an empty string to not display any label at all. If the containing toolbar is configured to display text only, its title will be used. Cleared by setting it to <value>null</value>."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the label only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -9430,12 +9724,27 @@
         {
           "name": "getLabel",
           "type": "function",
-          "description": "Gets the label of the messageDisplayAction.",
+          "description": "Gets the label of the messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the label should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -9452,13 +9761,12 @@
         {
           "name": "setIcon",
           "type": "function",
-          "description": "Sets the icon for the messageDisplayAction. The icon can be specified either as the path to an image file or as the pixel data from a canvas element, or as dictionary of either one of those. Either the <b>path</b> or the <b>imageData</b> property must be specified.",
+          "description": "Sets the icon for the messageDisplayAction button. Either the ``path`` or the ``imageData`` property must be specified.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "imageData": {
                   "choices": [
@@ -9470,19 +9778,25 @@
                     }
                   ],
                   "optional": true,
-                  "description": "Either an ImageDataType object defining a single icon used for all sizes or an ImageDataDictionary object defining dedicated icons for different sizes."
+                  "description": "The image data for one or more icons for the composeAction button."
                 },
                 "path": {
-                  "choices": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "$ref": "manifest.IconPath"
-                    }
-                  ],
+                  "$ref": "manifest.IconPath",
+                  "optional": true,
+                  "description": "The paths to one or more icons for the messageDisplayAction button."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the icon only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
                   "optional": true,
-                  "description": "Either a relative image path defining a single icon used for all sizes or an IconPathDictionary object defining dedicated icons for different sizes."
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -9497,13 +9811,12 @@
         {
           "name": "setPopup",
           "type": "function",
-          "description": "Sets the html document to be opened as a popup when the user clicks on the messageDisplayAction's icon.",
+          "description": "Sets the html document to be opened as a popup when the user clicks on the messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "popup": {
                   "choices": [
@@ -9514,7 +9827,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "The html file to show in a popup.  If set to the empty string (''), no popup is shown."
+                  "description": "The html file to show in a popup. Can be set to an empty string to not open a popup. Cleared by setting it to <value>null</value> (action will use the popup value defined in the manifest)."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the popup only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -9529,12 +9855,27 @@
         {
           "name": "getPopup",
           "type": "function",
-          "description": "Gets the html document set as the popup for this messageDisplayAction.",
+          "description": "Gets the html document set as the popup for this messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the popup document should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -9551,13 +9892,12 @@
         {
           "name": "setBadgeText",
           "type": "function",
-          "description": "Sets the badge text for the messageDisplayAction. The badge is displayed on top of the icon.",
+          "description": "Sets the badge text for the messageDisplayAction button. The badge is displayed on top of the icon.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "text": {
                   "choices": [
@@ -9568,7 +9908,20 @@
                       "type": "null"
                     }
                   ],
-                  "description": "Any number of characters can be passed, but only about four can fit in the space."
+                  "description": "Any number of characters can be passed, but only about four can fit in the space. Cleared by setting it to <value>null</value> or an empty string."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the badge text only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -9583,12 +9936,27 @@
         {
           "name": "getBadgeText",
           "type": "function",
-          "description": "Gets the badge text of the messageDisplayAction. If no tab nor window is specified, the global badge text is returned.",
+          "description": "Gets the badge text of the messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge text should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -9611,10 +9979,8 @@
             {
               "name": "details",
               "type": "object",
-              "$import": "Details",
               "properties": {
                 "color": {
-                  "description": "An array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with a CSS value, with opaque red being <code>#FF0000</code> or <code>#F00</code>.",
                   "choices": [
                     {
                       "type": "string"
@@ -9625,7 +9991,21 @@
                     {
                       "type": "null"
                     }
-                  ]
+                  ],
+                  "description": "The color to use as background in the badge. Cleared by setting it to <value>null</value> or an empty string."
+                },
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Sets the background color for the badge only for the given tab."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
                 }
               }
             },
@@ -9640,12 +10020,27 @@
         {
           "name": "getBadgeBackgroundColor",
           "type": "function",
-          "description": "Gets the background color of the messageDisplayAction.",
+          "description": "Gets the badge background color of the messageDisplayAction button.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the badge background color should be retrieved. If no tab is specified, the global label is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -9662,7 +10057,7 @@
         {
           "name": "enable",
           "type": "function",
-          "description": "Enables the messageDisplayAction for a tab. By default, a messageDisplayAction is enabled.",
+          "description": "Enables the messageDisplayAction button for a tab. By default, a messageDisplayAction button is enabled.",
           "async": "callback",
           "parameters": [
             {
@@ -9670,7 +10065,7 @@
               "optional": true,
               "name": "tabId",
               "minimum": 0,
-              "description": "The id of the tab for which you want to modify the messageDisplayAction."
+              "description": "The id of the tab for which you want to modify the messageDisplayAction button."
             },
             {
               "type": "function",
@@ -9683,7 +10078,7 @@
         {
           "name": "disable",
           "type": "function",
-          "description": "Disables the messageDisplayAction for a tab.",
+          "description": "Disables the messageDisplayAction button for a tab.",
           "async": "callback",
           "parameters": [
             {
@@ -9691,7 +10086,7 @@
               "optional": true,
               "name": "tabId",
               "minimum": 0,
-              "description": "The id of the tab for which you want to modify the messageDisplayAction."
+              "description": "The id of the tab for which you want to modify the messageDisplayAction button."
             },
             {
               "type": "function",
@@ -9704,12 +10099,27 @@
         {
           "name": "isEnabled",
           "type": "function",
-          "description": "Checks whether the messageDisplayAction is enabled.",
+          "description": "Checks whether the messageDisplayAction button is enabled.",
           "async": "callback",
           "parameters": [
             {
               "name": "details",
-              "$ref": "Details"
+              "type": "object",
+              "properties": {
+                "tabId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": 0,
+                  "description": "Specifies for which tab the state should be retrieved. If no tab is specified, the global value is retrieved."
+                },
+                "windowId": {
+                  "type": "integer",
+                  "optional": true,
+                  "minimum": -2,
+                  "unsupported": true,
+                  "description": "Will throw an error if used."
+                }
+              }
             },
             {
               "type": "function",
@@ -9727,7 +10137,7 @@
           "name": "openPopup",
           "type": "function",
           "requireUserInput": true,
-          "description": "Opens the extension popup window in the active window.",
+          "description": "Opens the action's popup window in the active window.",
           "async": true,
           "parameters": []
         }
@@ -9736,7 +10146,7 @@
         {
           "name": "onClicked",
           "type": "function",
-          "description": "Fired when a messageDisplayAction icon is clicked. This event will not fire if the messageDisplayAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/User_actions>`__ apply.",
+          "description": "Fired when a messageDisplayAction button is clicked. This event will not fire if the messageDisplayAction has a popup. This is a user input event handler. For asynchronous listeners some `restrictions <|link-user-input-restrictions|>`__ apply.",
           "parameters": [
             {
               "name": "tab",
@@ -9810,7 +10220,7 @@
             },
             "flagged": {
               "type": "boolean",
-              "description": "Whether this message is flagged (a.k.a. 'starred')."
+              "description": "Whether this message is flagged (a.k.a. starred)."
             },
             "folder": {
               "$ref": "folders.MailFolder",
@@ -9822,7 +10232,7 @@
               "description": "The message-id header of the message."
             },
             "headersOnly": {
-              "description": "Some account types (for example POP) allow to download only the headers of the message, but not its body. The body of such messages will not be available.",
+              "description": "Some account types (for example <value>pop3</value>) allow to download only the headers of the message, but not its body. The body of such messages will not be available.",
               "type": "boolean"
             },
             "id": {
@@ -9830,12 +10240,12 @@
               "minimum": 1
             },
             "junk": {
-              "description": "Whether the message has been marked as junk. Always ``false`` for news/nntp messages and external messages.",
+              "description": "Whether the message has been marked as junk. Always <value>false</value> for news/nntp messages and external messages.",
               "type": "boolean"
             },
             "junkScore": {
               "type": "integer",
-              "description": "The junk score associated with the message. Always ``0`` for news/nntp messages and external messages.",
+              "description": "The junk score associated with the message. Always <value>0</value> for news/nntp messages and external messages.",
               "minimum": 0,
               "maximum": 100
             },
@@ -9905,7 +10315,7 @@
             },
             "headers": {
               "type": "object",
-              "description": "An object of part headers, with the header name as key, and an array of header values as value",
+              "description": "A <em>dictionary object</em> of part headers as <em>key-value</em> pairs, with the header name as <em>key</em>, and an array of headers as <em>value</em>",
               "optional": true,
               "additionalProperties": {
                 "type": "array",
@@ -9922,7 +10332,7 @@
             "partName": {
               "type": "string",
               "optional": true,
-              "description": "The identifier of this part, used in :ref:`messages.getAttachmentFile"
+              "description": "The identifier of this part, used in :ref:`messages.getAttachmentFile`"
             },
             "parts": {
               "type": "array",
@@ -9935,7 +10345,7 @@
             "size": {
               "type": "integer",
               "optional": true,
-              "description": "The size of this part. The size of ``message/*`` parts is not the actual message size (on disc), but the total size of its decoded body parts, excluding headers."
+              "description": "The size of this part. The size of <em>message/*</em> parts is not the actual message size (on disc), but the total size of its decoded body parts, excluding headers."
             }
           }
         },
@@ -9946,7 +10356,7 @@
           "properties": {
             "flagged": {
               "type": "boolean",
-              "description": "Whether the message is flagged (a.k.a 'starred').",
+              "description": "Whether the message is flagged (a.k.a starred).",
               "optional": true
             },
             "junk": {
@@ -10003,7 +10413,7 @@
           "properties": {
             "tags": {
               "type": "object",
-              "description": "Object keys are tags to filter on, values are <code>true</code> if the message must have the tag, or <code>false</code> if it must not have the tag. For a list of available tags, call the :ref:`messages.listTags` method.",
+              "description": "A <em>dictionary object</em> with one or more filter condition as <em>key-value</em> pairs, the <em>key</em> being the tag to filter on, and the <em>value</em> being a boolean expression, requesting whether a message must include (<value>true</value>) or exclude (<value>false</value>) the tag. For a list of available tags, call the :ref:`messages.listTags` method.",
               "patternProperties": {
                 ".*": {
                   "type": "boolean"
@@ -10229,7 +10639,7 @@
         {
           "name": "getRaw",
           "type": "function",
-          "description": "Returns the unmodified source of a message as a `binary string <https://developer.mozilla.org/en-US/docs/Web/API/DOMString/Binary>`__, which is a simple series of 8-bit values. Throws if the message could not be read, for example due to network issues. If the message contains non-ASCII characters, the body parts in the binary string cannot be read directly and must be decoded according to their character sets. Use :ref:`messages.getFull` to get the correctly decoded parts. Manually decoding the raw message is probably too error-prone, especially if the message contains MIME parts with different character set encodings or attachments.\n\nTo get a readable version of the raw message as it appears in Thunderbird's message source view, it may be sufficient to decode the message according to the character set specified in its main ``content-type`` header (example: `text/html; charset=UTF-8`) using the following function (see MDN for `supported input encodings <https://developer.mozilla.org/en-US/docs/Web/API/Encoding_API/Encodings>`__): <literalinclude>includes/messages/decodeBinaryString.js<lang>JavaScript</lang></literalinclude>",
+          "description": "Returns the unmodified source of a message as a `binary string <|link-binary-string|>`__, which is a simple series of 8-bit values. Throws if the message could not be read, for example due to network issues. If the message contains non-ASCII characters, the body parts in the binary string cannot be read directly and must be decoded according to their character sets. Use :ref:`messages.getFull` to get the correctly decoded parts. Manually decoding the raw message is probably too error-prone, especially if the message contains MIME parts with different character set encodings or attachments.\n\nTo get a readable version of the raw message as it appears in Thunderbird's message source view, it may be sufficient to decode the message according to the character set specified in its main `content-type <|link-content-type|>`__ header (example: <value>text/html; charset=UTF-8</value>) using the following function (see MDN for `supported input encodings <|link-input-encoding|>`__): <literalinclude>includes/messages/decodeBinaryString.js<lang>JavaScript</lang></literalinclude>",
           "async": "callback",
           "parameters": [
             {
@@ -10276,7 +10686,7 @@
         {
           "name": "getAttachmentFile",
           "type": "function",
-          "description": "Gets the content of a :ref:`messages.MessageAttachment` as a DOM <code>File</code> object.",
+          "description": "Gets the content of a :ref:`messages.MessageAttachment` as a |File| object.",
           "async": "callback",
           "parameters": [
             {
@@ -10320,7 +10730,7 @@
                 "author": {
                   "type": "string",
                   "optional": true,
-                  "description": "Returns only messages with this value matching the author. The search value is a single email address, a name or a combination (e.g.: ``Name <user@domain.org>``). The address part of the search value (if provided) must match the author's address completely. The name part of the search value (if provided) must match the author's name partially. All matches are done case-insensitive."
+                  "description": "Returns only messages with this value matching the author. The search value is a single email address, a name or a combination (e.g.: <value>Name <user@domain.org></value>). The address part of the search value (if provided) must match the author's address completely. The name part of the search value (if provided) must match the author's name partially. All matches are done case-insensitive."
                 },
                 "body": {
                   "type": "string",
@@ -10365,7 +10775,7 @@
                 "recipients": {
                   "type": "string",
                   "optional": true,
-                  "description": "Returns only messages whose recipients match all specified addresses. The search value is a semicolon separated list of email addresses, names or combinations (e.g.: ``Name <user@domain.org>``). For a match, all specified addresses must equal a recipient's address completely and all specified names must match a recipient's name partially. All matches are done case-insensitive."
+                  "description": "Returns only messages whose recipients match all specified addresses. The search value is a semicolon separated list of email addresses, names or combinations (e.g.: <value>Name <user@domain.org></value>). For a match, all specified addresses must equal a recipient's address completely and all specified names must match a recipient's name partially. All matches are done case-insensitive."
                 },
                 "subject": {
                   "type": "string",
@@ -10409,7 +10819,7 @@
         {
           "name": "update",
           "type": "function",
-          "description": "Marks or unmarks a message as junk, read, flagged, or tagged. Updating external messages will throw an ``ExtensionError``.",
+          "description": "Marks or unmarks a message as junk, read, flagged, or tagged. Updating external messages will throw an <em>ExtensionError</em>.",
           "async": true,
           "parameters": [
             {
@@ -10426,7 +10836,7 @@
         {
           "name": "move",
           "type": "function",
-          "description": "Moves messages to a specified folder. If the messages cannot be removed from the source folder, they will be copied instead of moved. Moving external messages will throw an ``ExtensionError``.",
+          "description": "Moves messages to a specified folder. If the messages cannot be removed from the source folder, they will be copied instead of moved. Moving external messages will throw an <em>ExtensionError</em>.",
           "async": true,
           "permissions": [
             "accountsRead",
@@ -10478,7 +10888,7 @@
         {
           "name": "delete",
           "type": "function",
-          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an ``ExtensionError``. The ``skipTrash`` parameter allows immediate permanent deletion, bypassing the trash folder.\n**Note**: Consider using :ref:`messages.move` to manually move messages to the account's trash folder, instead of requesting the overly powerful permission to actually delete messages. The account's trash folder can be extracted as follows: <literalinclude>includes/messages/getTrash.js<lang>JavaScript</lang></literalinclude>",
+          "description": "Deletes messages permanently, or moves them to the trash folder (honoring the account's deletion behavior settings). Deleting external messages will throw an <em>ExtensionError</em>. The ``skipTrash`` parameter allows immediate permanent deletion, bypassing the trash folder.\n**Note**: Consider using :ref:`messages.move` to manually move messages to the account's trash folder, instead of requesting the overly powerful permission to actually delete messages. The account's trash folder can be extracted as follows: <literalinclude>includes/messages/getTrash.js<lang>JavaScript</lang></literalinclude>",
           "async": true,
           "permissions": [
             "messagesDelete"
@@ -10542,7 +10952,7 @@
         {
           "name": "archive",
           "type": "function",
-          "description": "Archives messages using the current settings. Archiving external messages will throw an ``ExtensionError``.",
+          "description": "Archives messages using the current settings. Archiving external messages will throw an <em>ExtensionError</em>.",
           "async": true,
           "permissions": [
             "messagesMove"
@@ -10679,7 +11089,7 @@
                 }
               ],
               "optional": true,
-              "description": "Sets the background color of the badge. Can be specified as an array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <code>[255, 0, 0, 255]</code>. Can also be a string with an HTML color name (<code>red</code>) or a HEX color value (<code>#FF0000</code> or <code>#F00</code>). Reset when set to an empty string."
+              "description": "Sets the background color of the badge. Can be specified as an array of four integers in the range [0,255] that make up the RGBA color of the badge. For example, opaque red is <value>[255, 0, 0, 255]</value>. Can also be a string with an HTML color name (<value>red</value>) or a HEX color value (<value>#FF0000</value> or <value>#F00</value>). Reset when set to an empty string."
             },
             "badgeText": {
               "type": "string",
@@ -10696,7 +11106,7 @@
                 }
               ],
               "optional": true,
-              "description": "Either a relative image path defining a single icon used for all sizes or an IconPathDictionary object defining dedicated icons for different sizes. At least the ``16px`` icon should be specified. The ``32px`` icon will be used on screens with a very high pixel density, if specified. Defaults to the extension icon, if set to an empty string."
+              "description": "The paths to one or more icons for the button in the spaces toolbar. Defaults to the extension icon, if set to an empty string."
             },
             "themeIcons": {
               "type": "array",
@@ -10704,7 +11114,7 @@
               "items": {
                 "$ref": "manifest.ThemeIcons"
               },
-              "description": "Specifies dark and light icons for the spaces toolbar button to be used with themes: The ``light`` icons will be used on dark backgrounds and vice versa. At least the set for ``16px`` icons should be specified. The set for ``32px`` icons will be used on screens with a very high pixel density, if specified."
+              "description": "Specifies dark and light icons for the spaces toolbar button to be used with themes: The ``light`` icons will be used on dark backgrounds and vice versa. At least the set for <em>16px</em> icons should be specified. The set for <em>32px</em> icons will be used on screens with a very high pixel density, if specified."
             },
             "title": {
               "type": "string",
@@ -10714,13 +11124,13 @@
             "url": {
               "type": "string",
               "optional": true,
-              "description": "The page url, loaded into a tab when the button is clicked. Supported are ``https://`` and ``http://`` links, as well as links to WebExtension pages."
+              "description": "The page url, loaded into a tab when the button is clicked. Supported are <value>https://</value> and <value>http://</value> links, as well as links to WebExtension pages."
             }
           }
         },
         {
           "id": "ColorArray",
-          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <code>[255, 0, 0, 255]</code>.",
+          "description": "An array of four integers in the range [0,255] that make up the RGBA color. For example, opaque red is <value>[255, 0, 0, 255]</value>.",
           "type": "array",
           "items": {
             "type": "integer",
@@ -10818,7 +11228,7 @@
     },
     {
       "namespace": "tabs",
-      "description": "Use the <code>browser.tabs</code> API to interact with the browser's tab system. You can use this API to create, modify, and rearrange tabs in the browser.",
+      "description": "The tabs API supports creating, modifying and interacting with tabs in Thunderbird windows.",
       "types": [
         {
           "id": "Tab",
@@ -10828,7 +11238,7 @@
               "type": "integer",
               "minimum": -1,
               "optional": true,
-              "description": "The ID of the tab. Tab IDs are unique within a browser session. Under some circumstances a Tab may not be assigned an ID. Tab ID can also be set to :ref:`tabs.TAB_ID_NONE` for apps and devtools windows."
+              "description": "The ID of the tab. Tab IDs are unique within a session. Under some circumstances a Tab may not be assigned an ID. Tab ID can also be set to :ref:`tabs.TAB_ID_NONE` for apps and devtools windows."
             },
             "index": {
               "type": "integer",
@@ -10882,7 +11292,7 @@
             "status": {
               "type": "string",
               "optional": true,
-              "description": "Either <em>loading</em> or <em>complete</em>."
+              "description": "Either <value>loading</value> or <value>complete</value>."
             },
             "width": {
               "type": "integer",
@@ -10958,7 +11368,7 @@
           "properties": {
             "urls": {
               "type": "array",
-              "description": "A list of URLs or URL patterns. Events that cannot match any of the URLs will be filtered out.  Filtering with urls requires the <permission>tabs</permission> or  <permission>activeTab</permission> permission.",
+              "description": "A list of URLs or URL patterns. Events that cannot match any of the URLs will be filtered out. Filtering with urls requires the <permission>tabs</permission> or <permission>activeTab</permission> permission.",
               "optional": true,
               "items": {
                 "type": "string"
@@ -10988,7 +11398,7 @@
       "properties": {
         "TAB_ID_NONE": {
           "value": -1,
-          "description": "An ID which represents the absence of a browser tab."
+          "description": "An ID which represents the absence of a tab."
         }
       },
       "functions": [
@@ -11037,7 +11447,7 @@
         {
           "name": "connect",
           "type": "function",
-          "description": "Connects to the content script(s) in the specified tab. The `runtime.onConnect <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onConnect>`_ event is fired in each content script running in the specified tab for the current extension. For more details, see `Content Script Messaging <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts>`_.",
+          "description": "Connects to the content script(s) in the specified tab. The `runtime.onConnect <|link-runtime-on-connect|>`__ event is fired in each content script running in the specified tab for the current extension. For more details, see `Content Script Messaging <|link-content-scripts|>`__.",
           "parameters": [
             {
               "type": "integer",
@@ -11057,7 +11467,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Open a port to a specific frame identified by <code>frameId</code> instead of all frames in the tab."
+                  "description": "Open a port to a specific frame identified by ``frameId`` instead of all frames in the tab."
                 }
               },
               "optional": true
@@ -11071,7 +11481,7 @@
         {
           "name": "sendMessage",
           "type": "function",
-          "description": "Sends a single message to the content script(s) in the specified tab, with an optional callback to run when a response is sent back.  The `runtime.onMessage <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/onMessage>`_ event is fired in each content script running in the specified tab for the current extension.",
+          "description": "Sends a single message to the content script(s) in the specified tab, with an optional callback to run when a response is sent back. The `runtime.onMessage <|link-runtime-on-message|>`__ event is fired in each content script running in the specified tab for the current extension.",
           "async": "responseCallback",
           "parameters": [
             {
@@ -11091,7 +11501,7 @@
                   "type": "integer",
                   "optional": true,
                   "minimum": 0,
-                  "description": "Send a message to a specific frame identified by <code>frameId</code> instead of all frames in the tab."
+                  "description": "Send a message to a specific frame identified by ``frameId`` instead of all frames in the tab."
                 }
               },
               "optional": true
@@ -11104,7 +11514,7 @@
                 {
                   "name": "response",
                   "type": "any",
-                  "description": "The JSON response object sent by the handler of the message. If an error occurs while connecting to the specified tab, the callback will be called with no arguments and `runtime.lastError <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/runtime/lastError>`_ will be set to the error message."
+                  "description": "The JSON response object sent by the handler of the message. If an error occurs while connecting to the specified tab, the callback will be called with no arguments and `runtime.lastError <|link-runtime-last-error|>`__ will be set to the error message."
                 }
               ]
             }
@@ -11113,7 +11523,7 @@
         {
           "name": "create",
           "type": "function",
-          "description": "Creates a new content tab. Use the :ref:`messageDisplay_api` to open messages.",
+          "description": "Creates a new content tab. Use the :ref:`messageDisplay_api` to open messages. Only supported in <value>normal</value> windows.",
           "async": "callback",
           "parameters": [
             {
@@ -11136,19 +11546,19 @@
                 "url": {
                   "type": "string",
                   "optional": true,
-                  "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."
+                  "description": "The URL to navigate the tab to initially. Fully-qualified URLs must include a scheme (i.e. <value>http://www.google.com</value>, not <value>www.google.com</value>). Relative URLs will be relative to the current page within the extension."
                 },
                 "active": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Whether the tab should become the active tab in the window. Does not affect whether the window is focused (see :ref:`windows.update`). Defaults to <var>true</var>."
+                  "description": "Whether the tab should become the active tab in the window. Does not affect whether the window is focused (see :ref:`windows.update`). Defaults to <value>true</value>."
                 },
                 "selected": {
-                  "deprecated": "Please use <em>active</em>.",
+                  "deprecated": "Please use ``createProperties.active``.",
                   "unsupported": true,
                   "type": "boolean",
                   "optional": true,
-                  "description": "Whether the tab should become the selected tab in the window. Defaults to <var>true</var>"
+                  "description": "Whether the tab should become the selected tab in the window. Defaults to <value>true</value>"
                 }
               }
             },
@@ -11187,7 +11597,7 @@
                 {
                   "name": "tab",
                   "optional": true,
-                  "description": "Details about the duplicated tab. The :ref:`tabs.Tab` object doesn't contain <code>url</code>, <code>title</code> and <code>favIconUrl</code> if the <permission>tabs</permission> permission has not been requested.",
+                  "description": "Details about the duplicated tab. The :ref:`tabs.Tab` object doesn't contain ``url``, ``title`` and ``favIconUrl`` if the <permission>tabs</permission> permission has not been requested.",
                   "$ref": "Tab"
                 }
               ]
@@ -11222,7 +11632,7 @@
                 "highlighted": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Whether the tabs are highlighted.  Works as an alias of active."
+                  "description": "Whether the tabs are highlighted. Works as an alias of active."
                 },
                 "currentWindow": {
                   "type": "boolean",
@@ -11257,7 +11667,7 @@
                     }
                   ],
                   "optional": true,
-                  "description": "Match tabs against one or more `URL Patterns <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Match_patterns>`_. Note that fragment identifiers are not matched."
+                  "description": "Match tabs against one or more `URL Patterns <|link-match-patterns|>`__. Note that fragment identifiers are not matched."
                 },
                 "windowId": {
                   "type": "integer",
@@ -11296,7 +11706,7 @@
         {
           "name": "update",
           "type": "function",
-          "description": "Modifies the properties of a tab. Properties that are not specified in <var>updateProperties</var> are not modified.",
+          "description": "Modifies the properties of a tab. Properties that are not specified in ``updateProperties`` are not modified.",
           "async": "callback",
           "parameters": [
             {
@@ -11314,12 +11724,12 @@
                 "url": {
                   "type": "string",
                   "optional": true,
-                  "description": "A URL to navigate the tab to. Only applicable for ``content`` tabs and active ``mail`` tabs."
+                  "description": "A URL to navigate the tab to. Only applicable for <value>content</value> tabs and active <value>mail</value> tabs."
                 },
                 "active": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Set this to true, if the tab should be active. Does not affect whether the window is focused (see :ref:`windows.update`). Setting this to false has no effect."
+                  "description": "Set this to <value>true</value>, if the tab should be active. Does not affect whether the window is focused (see :ref:`windows.update`). Setting this to <value>false</value> has no effect."
                 }
               }
             },
@@ -11332,7 +11742,7 @@
                   "name": "tab",
                   "$ref": "Tab",
                   "optional": true,
-                  "description": "Details about the updated tab. The :ref:`tabs.Tab` object doesn't contain <code>url</code>, <code>title</code> and <code>favIconUrl</code> if the <permission>tabs</permission> permission has not been requested."
+                  "description": "Details about the updated tab. The :ref:`tabs.Tab` object doesn't contain ``url``, ``title`` and ``favIconUrl`` if the <permission>tabs</permission> permission has not been requested."
                 }
               ]
             }
@@ -11341,7 +11751,7 @@
         {
           "name": "move",
           "type": "function",
-          "description": "Moves one or more tabs to a new position within its window, or to a new window. Note that tabs can only be moved to and from normal windows (<code>window.type === \"normal\"</code>).",
+          "description": "Moves one or more tabs to a new position within its window, or to a new window. Note that tabs can only be moved to and from windows of type <value>normal</value>.",
           "async": "callback",
           "parameters": [
             {
@@ -11374,7 +11784,7 @@
                 "index": {
                   "type": "integer",
                   "minimum": -1,
-                  "description": "The position to move the window to. -1 will place the tab at the end of the window."
+                  "description": "The position to move the window to. <value>-1</value> will place the tab at the end of the window."
                 }
               }
             },
@@ -11469,7 +11879,7 @@
         {
           "name": "executeScript",
           "type": "function",
-          "description": "Injects JavaScript code into a page. For details, see the `programmatic injection <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts>`_ section of the content scripts doc.",
+          "description": "Injects JavaScript code into a page. For details, see the `programmatic injection <|link-content-scripts|>`__ section of the content scripts doc.",
           "async": "callback",
           "parameters": [
             {
@@ -11506,7 +11916,7 @@
         {
           "name": "insertCSS",
           "type": "function",
-          "description": "Injects CSS into a page. For details, see the `programmatic injection <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts>`_ section of the content scripts doc.",
+          "description": "Injects CSS into a page. For details, see the `programmatic injection <|link-content-scripts|>`__ section of the content scripts doc.",
           "async": "callback",
           "parameters": [
             {
@@ -11533,7 +11943,7 @@
         {
           "name": "removeCSS",
           "type": "function",
-          "description": "Removes injected CSS from a page. For details, see the `programmatic injection <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/Content_scripts>`_ section of the content scripts doc.",
+          "description": "Removes injected CSS from a page. For details, see the `programmatic injection <|link-content-scripts|>`__ section of the content scripts doc.",
           "async": "callback",
           "parameters": [
             {
@@ -11589,7 +11999,7 @@
                 "status": {
                   "type": "string",
                   "optional": true,
-                  "description": "The status of the tab. Can be either <em>loading</em> or <em>complete</em>."
+                  "description": "The status of the tab. Can be either <value>loading</value> or <value>complete</value>."
                 },
                 "url": {
                   "type": "string",
@@ -11744,7 +12154,7 @@
                 },
                 "isWindowClosing": {
                   "type": "boolean",
-                  "description": "True when the tab is being closed because its window is being closed."
+                  "description": "Is <value>true</value> when the tab is being closed because its window is being closed."
                 }
               }
             }
@@ -11756,12 +12166,12 @@
   "windows.json": [
     {
       "namespace": "windows",
-      "description": "Use the <code>browser.windows</code> API to interact with Thunderbird. You can use this API to create, modify, and rearrange windows.",
+      "description": "The windows API supports creating, modifying and interacting with Thunderbird windows.",
       "types": [
         {
           "id": "WindowType",
           "type": "string",
-          "description": "The type of a window. Under some circumstances a Window may not be assigned a type property.",
+          "description": "The type of a window. Under some circumstances a window may not be assigned a type property.",
           "enum": [
             "normal",
             "popup",
@@ -11824,21 +12234,21 @@
                 "$ref": "tabs.Tab"
               },
               "optional": true,
-              "description": "Array of :ref:`tabs.Tab` objects representing the current tabs in the window. Only included if requested by :ref:`windows.get`, :ref:`windows.getCurrent`, :ref:`windows.getAll` or :ref:`windows.getLastFocused` and the optional :ref:`windows.GetInfo` parameter has ``populate`` set to ``true``."
+              "description": "Array of :ref:`tabs.Tab` objects representing the current tabs in the window. Only included if requested by :ref:`windows.get`, :ref:`windows.getCurrent`, :ref:`windows.getAll` or :ref:`windows.getLastFocused`, and the optional :ref:`windows.GetInfo` parameter has its ``populate`` member set to <value>true</value>."
             },
             "incognito": {
               "type": "boolean",
-              "description": "Whether the window is incognito."
+              "description": "Whether the window is incognito. Since Thunderbird does not support the incognito mode, this is always <value>false</value>."
             },
             "type": {
               "$ref": "WindowType",
               "optional": true,
-              "description": "The type of browser window this is."
+              "description": "The type of window this is."
             },
             "state": {
               "$ref": "WindowState",
               "optional": true,
-              "description": "The state of this browser window."
+              "description": "The state of this window."
             },
             "alwaysOnTop": {
               "type": "boolean",
@@ -11854,7 +12264,7 @@
         {
           "id": "CreateType",
           "type": "string",
-          "description": "Specifies what type of browser window to create. The 'panel' and 'detached_panel' types create a popup unless the '--enable-panels' flag is set.",
+          "description": "Specifies what type of window to create. Thunderbird does not support <value>panel</value> and <value>detached_panel</value>, they are interpreted as <value>popup</value>.",
           "enum": [
             "normal",
             "popup",
@@ -11870,7 +12280,7 @@
             "populate": {
               "type": "boolean",
               "optional": true,
-              "description": "If true, the :ref:`windows.Window` returned will have a <var>tabs</var> property that contains an array of :ref:`tabs.Tab` objects representing the tabs inside the window. The :ref:`tabs.Tab` objects only contain the <code>url</code>, <code>title</code> and <code>favIconUrl</code> properties if the extension's manifest file includes the <permission>tabs</permission> permission."
+              "description": "If true, the :ref:`windows.Window` returned will have a ``tabs`` property that contains an array of :ref:`tabs.Tab` objects representing the tabs inside the window. The :ref:`tabs.Tab` objects only contain the ``url``, ``title`` and ``favIconUrl`` properties if the extension's manifest file includes the <permission>tabs</permission> permission."
             },
             "windowTypes": {
               "type": "array",
@@ -11925,7 +12335,7 @@
         {
           "name": "getCurrent",
           "type": "function",
-          "description": "Gets the current window.",
+          "description": "Gets the active or topmost window.",
           "async": "callback",
           "parameters": [
             {
@@ -11997,7 +12407,7 @@
         {
           "name": "create",
           "type": "function",
-          "description": "Creates (opens) a new browser with any optional sizing, position or default URL provided.",
+          "description": "Creates (opens) a new window with any optional sizing, position or default URL provided.",
           "async": "callback",
           "parameters": [
             {
@@ -12007,7 +12417,7 @@
               "default": {},
               "properties": {
                 "url": {
-                  "description": "A URL or array of URLs to open as tabs in the window. 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.",
+                  "description": "A URL or array of URLs to open as tabs in the window. Fully-qualified URLs must include a scheme (i.e. <value>http://www.google.com</value>, not <value>www.google.com</value>). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page.",
                   "optional": true,
                   "choices": [
                     {
@@ -12032,12 +12442,12 @@
                 "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 focused window. This value is ignored for panels."
+                  "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 focused 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 focused window. This value is ignored for panels."
+                  "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 focused window."
                 },
                 "width": {
                   "type": "integer",
@@ -12058,24 +12468,24 @@
                   "description": "If true, opens an active window. If false, opens an inactive window."
                 },
                 "incognito": {
+                  "unsupported": true,
                   "type": "boolean",
-                  "optional": true,
-                  "description": "Whether the new window should be an incognito window."
+                  "optional": true
                 },
                 "type": {
                   "$ref": "CreateType",
                   "optional": true,
-                  "description": "Specifies what type of browser window to create. The 'panel' and 'detached_panel' types create a popup unless the '--enable-panels' flag is set."
+                  "description": "Specifies what type of window to create. Thunderbird does not support <value>panel</value> and <value>detached_panel</value>, they are interpreted as <value>popup</value>."
                 },
                 "state": {
                   "$ref": "WindowState",
                   "optional": true,
-                  "description": "The initial state of the window. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'."
+                  "description": "The initial state of the window. The ``minimized``, ``maximized`` and ``fullscreen`` states cannot be combined with ``left``, ``top``, ``width`` or ``height``."
                 },
                 "allowScriptsToClose": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "Allow scripts to close the window."
+                  "description": "Allow scripts running inside the window to close the window by calling <code>window.close()</code>."
                 },
                 "titlePreface": {
                   "type": "string",
@@ -12128,13 +12538,13 @@
                   "type": "integer",
                   "minimum": 0,
                   "optional": true,
-                  "description": "The width to resize the window to in pixels. This value is ignored for panels."
+                  "description": "The width to resize the window to in pixels."
                 },
                 "height": {
                   "type": "integer",
                   "minimum": 0,
                   "optional": true,
-                  "description": "The height to resize the window to in pixels. This value is ignored for panels."
+                  "description": "The height to resize the window to in pixels."
                 },
                 "focused": {
                   "type": "boolean",
@@ -12144,12 +12554,12 @@
                 "drawAttention": {
                   "type": "boolean",
                   "optional": true,
-                  "description": "If true, causes the window to be displayed in a manner that draws the user's attention to the window, without changing the focused window. The effect lasts until the user changes focus to the window. This option has no effect if the window already has focus. Set to false to cancel a previous draw attention request."
+                  "description": "Setting this to <value>true</value> will cause the window to be displayed in a manner that draws the user's attention to the window, without changing the focused window. The effect lasts until the user changes focus to the window. This option has no effect if the window already has focus."
                 },
                 "state": {
                   "$ref": "WindowState",
                   "optional": true,
-                  "description": "The new state of the window. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined with 'left', 'top', 'width' or 'height'."
+                  "description": "The new state of the window. The ``minimized``, ``maximized`` and ``fullscreen`` states cannot be combined with ``left``, ``top``, ``width`` or ``height``."
                 },
                 "titlePreface": {
                   "type": "string",
@@ -12215,7 +12625,7 @@
               "items": {
                 "$ref": "WindowType"
               },
-              "description": "Conditions that the window's type being created must satisfy. By default it will satisfy <code>['app', 'normal', 'panel', 'popup']</code>, with <code>'app'</code> and <code>'panel'</code> window types limited to the extension's own windows."
+              "description": "Conditions that the window's type being created must satisfy. By default it will satisfy <value>['app', 'normal', 'panel', 'popup']</value>, with <value>app</value> and <value>panel</value> window types limited to the extension's own windows."
             }
           ],
           "parameters": [
@@ -12237,7 +12647,7 @@
               "items": {
                 "$ref": "WindowType"
               },
-              "description": "Conditions that the window's type being removed must satisfy. By default it will satisfy <code>['app', 'normal', 'panel', 'popup']</code>, with <code>'app'</code> and <code>'panel'</code> window types limited to the extension's own windows."
+              "description": "Conditions that the window's type being removed must satisfy. By default it will satisfy <value>['app', 'normal', 'panel', 'popup']</value>, with <value>app</value> and <value>panel</value> window types limited to the extension's own windows."
             }
           ],
           "parameters": [
@@ -12252,7 +12662,7 @@
         {
           "name": "onFocusChanged",
           "type": "function",
-          "description": "Fired when the currently focused window changes. Will be :ref:`windows.WINDOW_ID_NONE`) if all browser windows have lost focus. **Note:** On some Linux window managers, WINDOW_ID_NONE will always be sent immediately preceding a switch from one browser window to another.",
+          "description": "Fired when the currently focused window changes. Will be :ref:`windows.WINDOW_ID_NONE`, if all windows have lost focus. **Note:** On some Linux window managers, WINDOW_ID_NONE will always be sent immediately preceding a switch from one window to another.",
           "filters": [
             {
               "name": "windowTypes",
@@ -12260,7 +12670,7 @@
               "items": {
                 "$ref": "WindowType"
               },
-              "description": "Conditions that the window's type being removed must satisfy. By default it will satisfy <code>['app', 'normal', 'panel', 'popup']</code>, with <code>'app'</code> and <code>'panel'</code> window types limited to the extension's own windows."
+              "description": "Conditions that the window's type being focused must satisfy. By default it will satisfy <value>['app', 'normal', 'panel', 'popup']</value>, with <value>app</value> and <value>panel</value> window types limited to the extension's own windows."
             }
           ],
           "parameters": [