Skip to content

Commit

Permalink
user proper permission style and identify backported elements
Browse files Browse the repository at this point in the history
  • Loading branch information
@jobisoft
jobisoft committed Nov 29, 2023
1 parent ace844c commit 30da9d7
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 25 deletions.
4 changes: 2 additions & 2 deletions changes/esr102.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -117,5 +117,5 @@ Thunderbird 102.3.0 ESR

compose API
===========
* Added the :ref:`compose.onAfterSave` event.
* Added the :ref:`compose.onAfterSend` event.
* Backported the :ref:`compose.onAfterSave` event.
* Backported the :ref:`compose.onAfterSend` event.
34 changes: 17 additions & 17 deletions changes/esr78.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ browserAction/composeAction/messageDisplayAction
* The onClick event of the action APIs now has information about the active tab and the click event.

This brings the events into line with browser WebExtensions. For messageDisplayAction, this is a
change of behaviour – previously the ID of the active tab was passed as the first argument.
change of behavior – previously the ID of the active tab was passed as the first argument.

*This change was uplifted to 74 beta 2.*

Expand Down Expand Up @@ -142,14 +142,14 @@ mailTabs/messageDisplay
messages
========

* The ``accountsRead`` permission is now required for all functions that accept a
* The :permission:`accountsRead` permission is now required for all functions that accept a
:ref:`folders.MailFolder` argument. The permission was already required to obtain a ``MailFolder``
anyway, so this change should not break extensions.

experiments
===========

* For extensions with the ``addressBooks`` permission, a new ``addressBookManager`` object is
* For extensions with the :permission:`addressBooks` permission, a new ``addressBookManager`` object is
available to WebExtensions experiment implementations. The ``addressBookManager`` provides the
following functions to help you interact with the :doc:`/addressBooks`, :doc:`/contacts` and
:doc:`/mailingLists` APIs:
Expand Down Expand Up @@ -208,7 +208,7 @@ composeScripts/tabs

* Content script functions can now operate on a compose window "tab" in the same way they do on a
content tab in Thunderbird or Firefox. (Despite the fact they don't have tabs, compose windows
have one tab object under the :doc:`/tabs` API.) This requires the "compose" permission.
have one tab object under the :doc:`/tabs` API.) This requires the :permission:`compose` permission.

Here are some basic examples. See `the MDN documentation`__ for a more in-depth explanation.

Expand Down Expand Up @@ -318,21 +318,21 @@ Thunderbird 78.4.0 ESR
compose
=======

* Attachments can now be specified in the :ref:`beginNew <compose.beginNew>`,
* Backported support for attachments being specified in the :ref:`beginNew <compose.beginNew>`,
:ref:`beginReply <compose.beginReply>`, and :ref:`beginForward <compose.beginForward>` functions.

messageDisplay
==============

* The :ref:`messageDisplay.getDisplayedMessages` function has been added to allow access to details of multiple-selection of email. Previously only a single selection function was available.
* The :ref:`messageDisplay.getDisplayedMessages` function has been backported to allow access to details of multiple-selection of email. Previously only a single selection function was available.

* The :ref:`messageDisplay.onMessagesDisplayed` event has been added.
* The :ref:`messageDisplay.onMessagesDisplayed` event has been backported.

messageDisplayScripts/tabs
==========================

* Content script functions can now operate on a message display "tab" in the same way they do on a
content tab in Thunderbird or Firefox. This requires the new "messagesModify" permission.
* Backported support for content script functions to operate on a message display tab in the same way they do on a
content tab in Thunderbird or Firefox. This requires the new :permission:`messagesModify` permission.

Here are some basic examples. See `the MDN documentation`__ for a more in-depth explanation.

Expand Down Expand Up @@ -418,7 +418,7 @@ compose
* :ref:`ComposeAttachment <compose.ComposeAttachment>` objects now have a ``size`` property with
the size of the attachment in bytes.

* A ``compose_attachment`` context can now be used. This context applies when the user opens a
* Backported support for the ``compose_attachment`` context. This context applies when the user opens a
context menu on selected attachments in a compose window. The selected attachments can be
accessed from the ``attachments`` property in an :ref:`onShown <menus.onShown>` or
:ref:`onClicked <menus.onClicked>` listener.
Expand All @@ -437,12 +437,12 @@ menus
=====

* The standard properties available to :ref:`onShown <menus.onShown>` are now available for
messages being composed, if your extension has the ``compose`` permission.
messages being composed, if your extension has the :permission:`compose` permission.

windows
=======

* The :ref:`windows.openDefaultBrowser` function has been added.
* Backported the :ref:`windows.openDefaultBrowser` function.

----------------------
Thunderbird 78.6.1 ESR
Expand All @@ -451,17 +451,17 @@ Thunderbird 78.6.1 ESR
browserAction
==================================================

* The :ref:`browserAction.setLabel` and :ref:`browserAction.getLabel` functions have been added. It is now possible to set a label value different from the title (which is used as tooltip text). The label can be set to an empty string to make the action button not have a label at all. If the toolbar is set to text-mode only (no icons), the action button label uses the title as fallback, in case an empty label has been set.
* The :ref:`browserAction.setLabel` and :ref:`browserAction.getLabel` functions have been backported. It is now possible to set a label value different from the title (which is used as tooltip text). The label can be set to an empty string to make the action button not have a label at all. If the toolbar is set to text-mode only (no icons), the action button label uses the title as fallback, in case an empty label has been set.

composeAction
==================================================

* The :ref:`composeAction.setLabel` and :ref:`composeAction.getLabel` functions have been added. It is now possible to set a label value different from the title (which is used as tooltip text). The label can be set to an empty string to make the action button not have a label at all. If the toolbar is set to text-mode only (no icons), the action button label uses the title as fallback, in case an empty label has been set.
* The :ref:`composeAction.setLabel` and :ref:`composeAction.getLabel` functions have been backported. It is now possible to set a label value different from the title (which is used as tooltip text). The label can be set to an empty string to make the action button not have a label at all. If the toolbar is set to text-mode only (no icons), the action button label uses the title as fallback, in case an empty label has been set.

messageDisplayAction
==================================================

* The :ref:`messageDisplayAction.setLabel` and :ref:`messageDisplayAction.getLabel` functions have been added. It is now possible to set a label value different from the title (which is used as tooltip text). The label can be set to an empty string to make the action button not have a label at all. If the toolbar is set to text-mode only (no icons), the action button label uses the title as fallback, in case an empty label has been set.
* The :ref:`messageDisplayAction.setLabel` and :ref:`messageDisplayAction.getLabel` functions have been backported. It is now possible to set a label value different from the title (which is used as tooltip text). The label can be set to an empty string to make the action button not have a label at all. If the toolbar is set to text-mode only (no icons), the action button label uses the title as fallback, in case an empty label has been set.

----------------------
Thunderbird 78.7.0 ESR
Expand All @@ -470,7 +470,7 @@ Thunderbird 78.7.0 ESR
accounts
========

* The ``composeHtml`` property has been added to the :ref:`identities.MailIdentity` type, to indicate, if the identity uses HTML as the default compose format.
* The ``composeHtml`` property has been backported to the :ref:`identities.MailIdentity` type, to indicate, if the identity uses HTML as the default compose format.

* The :ref:`accounts.getDefaultIdentity` function has been added, to get the default identity of a given account. Use :ref:`accounts.getDefault` to get the default account.

Expand All @@ -493,6 +493,6 @@ Thunderbird 78.7.1 ESR
theme
=====

* The :ref:`theme_api` API was added to Thunderbird (see `bug 1684666 <https://bugzilla.mozilla.org/show_bug.cgi?id=1684666>`__). It’s more or less the same as the `Firefox theme API <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme>`__, but has been extended to better fit the needs of Thunderbird.
* The :ref:`theme_api` API was backported (see `bug 1684666 <https://bugzilla.mozilla.org/show_bug.cgi?id=1684666>`__). It’s more or less the same as the `Firefox theme API <https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/theme>`__, but has been extended to better fit the needs of Thunderbird.

The color key ``sidebar_highlight_border`` has been added.
12 changes: 6 additions & 6 deletions changes/esr91.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ messageDisplayScripts/tabs
==========================

* Content script functions can now operate on a message display "tab" in the same way they do on a
content tab in Thunderbird or Firefox. This requires the new "messagesModify" permission.
content tab in Thunderbird or Firefox. This requires the new :permission:`messagesModify` permission.

Here are some basic examples. See `the MDN documentation`__ for a more in-depth explanation.

Expand Down Expand Up @@ -144,7 +144,7 @@ menus
:ref:`onClicked <menus.onClicked>` listener.

* The standard properties available to :ref:`onShown <menus.onShown>` are now available for
messages being displayed, if your extension has the ``messagesRead`` permission.
messages being displayed, if your extension has the :permission:`messagesRead` permission.

-------------------
Thunderbird 84 Beta
Expand All @@ -165,7 +165,7 @@ menus
=====

* The standard properties available to :ref:`onShown <menus.onShown>` are now available for
messages being composed, if your extension has the ``compose`` permission.
messages being composed, if your extension has the :permission:`compose` permission.

tabs
====
Expand Down Expand Up @@ -408,7 +408,7 @@ Thunderbird 91.0.2 ESR
browserAction API
=================

* added support for the ``tabstoolbar`` location, usable in the ``default_area`` manifest key
* backported support for the ``tabstoolbar`` location, usable in the ``default_area`` manifest key

-----------------------
Thunderbird 91.4.1 ESR
Expand All @@ -417,9 +417,9 @@ Thunderbird 91.4.1 ESR
cloudFile API
=============

* added the ``templateInfo`` member to the returned properties of the :ref:`cloudFile.onFileUpload` event
* backported support for the ``templateInfo`` property, which is now returned by the :ref:`cloudFile.onFileUpload` event

messages
========

* :ref:`messages.query` supports queries for messages with a given ``headerMessageId``
* backported support to query for a given ``headerMessageId`` in :ref:`messages.query`

0 comments on commit 30da9d7

Please sign in to comment.