Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

add 1.7rc2 docset

  • Loading branch information...
commit a1a5a32e9f5a39959c167f342477fe746f3f6fc9 1 parent 0c372dd
@wbamberg wbamberg authored
Showing with 4,622 additions and 238 deletions.
  1. +1 −0  dev-guide-source/credits.md
  2. +3 −1 dev-guide-source/guides/commonjs.md
  3. +3 −0  dev-guide-source/guides/firefox-compatibility.md
  4. +4 −0 dev-guide-source/package-spec.md
  5. +7 −2 dev-guide-source/tutorials/adding-menus.md
  6. +92 −19 dev-guide-source/tutorials/l10n.md
  7. +9 −9 dev-guide-source/tutorials/load-and-unload.md
  8. +4 −0 dev-guide-source/tutorials/mobile.md
  9. +9 −1 dev-guide-source/tutorials/modifying-web-pages-tab.md
  10. +31 −1 dev-guide-source/tutorials/modifying-web-pages-url.md
  11. +2 −2 dev-guide-source/tutorials/open-a-web-page.md
  12. +18 −0 dev-guide-source/tutorials/troubleshooting.md
  13. +13 −1 dev-guide/cfx-tool.html
  14. +13 −1 dev-guide/console.html
  15. +14 −1 dev-guide/credits.html
  16. +13 −1 dev-guide/glossary.html
  17. +16 −2 dev-guide/guides/commonjs.html
  18. +13 −1 dev-guide/guides/content-scripts/access.html
  19. +13 −1 dev-guide/guides/content-scripts/index.html
  20. +13 −1 dev-guide/guides/content-scripts/loading.html
  21. +13 −1 dev-guide/guides/content-scripts/reddit-example.html
  22. +13 −1 dev-guide/guides/content-scripts/using-port.html
  23. +13 −1 dev-guide/guides/content-scripts/using-postmessage.html
  24. +13 −1 dev-guide/guides/events.html
  25. +18 −2 dev-guide/guides/firefox-compatibility.html
  26. +13 −1 dev-guide/guides/index.html
  27. +13 −1 dev-guide/guides/library-detector.html
  28. +13 −1 dev-guide/guides/module-search.html
  29. +13 −1 dev-guide/guides/program-id.html
  30. +13 −1 dev-guide/guides/sdk-vs-xul.html
  31. +13 −1 dev-guide/guides/two-types-of-scripts.html
  32. +13 −1 dev-guide/guides/xul-migration.html
  33. +13 −1 dev-guide/high-level-apis.html
  34. +13 −1 dev-guide/index.html
  35. +13 −1 dev-guide/low-level-apis.html
  36. +18 −2 dev-guide/package-spec.html
  37. +13 −1 dev-guide/third-party-apis.html
  38. +13 −1 dev-guide/tutorials/add-a-context-menu-item.html
  39. +19 −3 dev-guide/tutorials/adding-menus.html
  40. +13 −1 dev-guide/tutorials/adding-toolbar-button.html
  41. +13 −1 dev-guide/tutorials/annotator/creating.html
  42. +13 −1 dev-guide/tutorials/annotator/displaying.html
  43. +13 −1 dev-guide/tutorials/annotator/index.html
  44. +13 −1 dev-guide/tutorials/annotator/overview.html
  45. +13 −1 dev-guide/tutorials/annotator/storing.html
  46. +13 −1 dev-guide/tutorials/annotator/widget.html
  47. +13 −1 dev-guide/tutorials/chrome.html
  48. +13 −1 dev-guide/tutorials/display-a-popup.html
  49. +13 −1 dev-guide/tutorials/getting-started-with-cfx.html
  50. +13 −1 dev-guide/tutorials/index.html
  51. +13 −1 dev-guide/tutorials/installation.html
  52. +92 −22 dev-guide/tutorials/l10n.html
  53. +13 −1 dev-guide/tutorials/list-open-tabs.html
  54. +13 −1 dev-guide/tutorials/listen-for-page-load.html
  55. +21 −9 dev-guide/tutorials/load-and-unload.html
  56. +13 −1 dev-guide/tutorials/logging.html
  57. +18 −2 dev-guide/tutorials/mobile.html
  58. +19 −2 dev-guide/tutorials/modifying-web-pages-tab.html
  59. +40 −2 dev-guide/tutorials/modifying-web-pages-url.html
  60. +15 −3 dev-guide/tutorials/open-a-web-page.html
  61. +13 −1 dev-guide/tutorials/reusable-modules.html
  62. +28 −1 dev-guide/tutorials/troubleshooting.html
  63. +13 −1 dev-guide/tutorials/unit-testing.html
  64. +13 −1 index.html
  65. +13 −1 packages/addon-kit/clipboard.html
  66. +26 −10 packages/addon-kit/context-menu.html
  67. +13 −1 packages/addon-kit/hotkeys.html
  68. +13 −1 packages/addon-kit/index.html
  69. +13 −1 packages/addon-kit/notifications.html
  70. +48 −2 packages/addon-kit/page-mod.html
  71. +32 −2 packages/addon-kit/page-worker.html
  72. +50 −2 packages/addon-kit/panel.html
  73. +13 −1 packages/addon-kit/passwords.html
  74. +13 −1 packages/addon-kit/private-browsing.html
  75. +32 −11 packages/addon-kit/request.html
  76. +13 −1 packages/addon-kit/selection.html
  77. +13 −1 packages/addon-kit/self.html
  78. +14 −1 packages/addon-kit/simple-prefs.html
  79. +13 −1 packages/addon-kit/simple-storage.html
  80. +13 −1 packages/addon-kit/tabs.html
  81. +13 −1 packages/addon-kit/timers.html
  82. +25 −9 packages/addon-kit/widget.html
  83. +13 −1 packages/addon-kit/windows.html
  84. +13 −1 packages/api-utils/api-utils.html
  85. +13 −1 packages/api-utils/app-strings.html
  86. +13 −1 packages/api-utils/base.html
  87. +13 −1 packages/api-utils/byte-streams.html
  88. +13 −1 packages/api-utils/collection.html
  89. +13 −1 packages/api-utils/content.html
  90. +13 −1 packages/api-utils/content/loader.html
  91. +13 −1 packages/api-utils/content/proxy.html
  92. +13 −1 packages/api-utils/content/symbiont.html
  93. +13 −1 packages/api-utils/content/worker.html
  94. +13 −1 packages/api-utils/cortex.html
  95. +13 −1 packages/api-utils/cuddlefish.html
  96. +13 −1 packages/api-utils/environment.html
  97. +13 −1 packages/api-utils/errors.html
  98. +367 −0 packages/api-utils/event/core.html
  99. +402 −0 packages/api-utils/event/target.html
  100. +13 −1 packages/api-utils/events.html
  101. +13 −1 packages/api-utils/file.html
  102. +378 −0 packages/api-utils/frame/utils.html
  103. +13 −1 packages/api-utils/globals.html
  104. +13 −1 packages/api-utils/hidden-frame.html
  105. +13 −1 packages/api-utils/httpd.html
  106. +25 −1 packages/api-utils/index.html
  107. +13 −1 packages/api-utils/light-traits.html
  108. +13 −1 packages/api-utils/list.html
  109. +13 −1 packages/api-utils/match-pattern.html
  110. +13 −1 packages/api-utils/memory.html
  111. +13 −1 packages/api-utils/message-manager.html
  112. +13 −1 packages/api-utils/namespace.html
  113. +13 −1 packages/api-utils/observer-service.html
  114. +13 −1 packages/api-utils/plain-text-console.html
  115. +14 −2 packages/api-utils/preferences-service.html
  116. +660 −0 packages/api-utils/promise.html
  117. +349 −0 packages/api-utils/querystring.html
  118. +13 −1 packages/api-utils/runtime.html
  119. +13 −1 packages/api-utils/sandbox.html
  120. +13 −1 packages/api-utils/tab-browser.html
  121. +13 −1 packages/api-utils/text-streams.html
  122. +13 −1 packages/api-utils/traceback.html
  123. +13 −1 packages/api-utils/traits.html
  124. +13 −1 packages/api-utils/unit-test.html
  125. +13 −1 packages/api-utils/unload.html
  126. +13 −1 packages/api-utils/url.html
  127. +13 −1 packages/api-utils/uuid.html
  128. +13 −1 packages/api-utils/window-utils.html
  129. +403 −0 packages/api-utils/window/utils.html
  130. +13 −1 packages/api-utils/xhr.html
  131. +13 −1 packages/api-utils/xpcom.html
  132. +13 −1 packages/api-utils/xul-app.html
  133. +1 −1  packages/index.json
  134. +13 −1 packages/test-harness/harness.html
  135. +13 −1 packages/test-harness/index.html
  136. +13 −1 packages/test-harness/run-tests.html
  137. +4 −0 static-files/css/footer.css
  138. +4 −0 static-files/css/sdk-docs.css
  139. +38 −14 static-files/js/main.js
  140. BIN  static-files/media/screenshots/locale-updater.png
  141. +1 −1  status.md5
View
1  dev-guide-source/credits.md
@@ -61,3 +61,4 @@ We'd like to thank our many Jetpack project contributors! They include:
* Drew Willcoxon
* Piotr Zalewa
* [David Guo](https://github.com/dglol)
+* [Nils Maier](https://github.com/nmaier)
View
4 dev-guide-source/guides/commonjs.md
@@ -114,7 +114,9 @@ modules fall roughly into three categories:
want to use modules from this category.
* building blocks for higher level modules, such as
-[base](packages/api-utils/base.html) and
+[event/core](packages/api-utils/event/core.html),
+[event/target](packages/api-utils/event/target.html),
+[base](packages/api-utils/base.html), and
[namespace](packages/api-utils/namespace.html). You're more
likely to use these if you are building your own modules that
implement new APIs, thus extending the SDK itself.
View
3  dev-guide-source/guides/firefox-compatibility.md
@@ -1,3 +1,6 @@
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+ - License, v. 2.0. If a copy of the MPL was not distributed with this
+ - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
# Firefox Compatibility #
View
4 dev-guide-source/package-spec.md
@@ -1,3 +1,7 @@
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+ - License, v. 2.0. If a copy of the MPL was not distributed with this
+ - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
+
# Package Specification #
A *package* is a directory that, at minimum, contains a JSON file
View
9 dev-guide-source/tutorials/adding-menus.md
@@ -17,6 +17,10 @@ modules for add-on developers to use. Luckily, Erik Vold has written
a [`menuitems`](https://github.com/erikvold/menuitems-jplib) package
that enables us to add menu items.
+This tutorial does double-duty. It describes the general method for
+using an external, third-party package in your add-on, and it
+describes how to add a menu item using the `menuitems` package in particular.
+
## Installing `menuitems` ##
First we'll download `menuitems` from
@@ -110,8 +114,9 @@ be aware of:
* our support for third party packages is still fairly immature. One
consequence of this is that it's not always obvious where to find third-party
-packages, although some are collected in the
-[Jetpack Wiki](https://wiki.mozilla.org/Jetpack/Modules)
+packages, although the
+[Community Developed Modules](https://github.com/mozilla/addon-sdk/wiki/Community-developed-modules)
+page in the SDK's GitHub Wiki lists a number of packages.
* because third party modules typically use low-level APIs, they may be broken
by new releases of Firefox.
View
111 dev-guide-source/tutorials/l10n.md
@@ -96,31 +96,95 @@ hello_string= Bonjour!
## Plurals ##
-The `l10n` module has basic support for plural forms. The following
-`.properties` file includes separate localizations for the singular
-and plural form of "child":
+The `l10n` module supports plural forms. Different languages have
+different rules for the formation of plurals. For example,
+English has two forms: a singular form for "one", and a plural form
+for "everything else, including zero":
<pre>
-child_id[one]= one child
-child_id= %d children
+one tomato
+no tomatoes
+two tomatoes
</pre>
-To use it, list the count of the item after its identifier:
+But Russian has different forms for numbers ending in 1 (except 11),
+numbers ending in 2-4 (except 12-14) and other numbers:
+
+<pre>
+один помидор // one tomato
+два помидора // two tomatoes
+пять помидоров // five tomatoes
+</pre>
+
+The SDK uses the [Unicode CLDR](http://cldr.unicode.org/index) data
+to describe the different plural forms used by different languages.
+
+### Unicode CLDR Plural Forms ###
+
+The Unicode CLDR project defines a scheme for describing a particular
+language's plural rules. In this scheme a language maps each distinct
+range of numbers on to one of up to six forms, identified by the
+following categories: *zero*, *one*, *two*, *few*, *many*, and *other*.
+
+English has two forms, which can be described by mapping "1" to "one"
+and "everything else" to "other":
+
+<pre>
+one → n is 1;
+other → everything else
+</pre>
+
+Russian uses four forms, that can be described as follows:
+
+<pre>
+one → n mod 10 is 1 and n mod 100 is not 11;
+few → n mod 10 in 2..4 and n mod 100 not in 12..14;
+many → n mod 10 is 0 or n mod 10 in 5..9 or n mod 100 in 11..14;
+other → everything else
+</pre>
+
+Plural rules for all languages can be found in the CLDR
+[Language Plural Rules](http://unicode.org/repos/cldr-tmp/trunk/diff/supplemental/language_plural_rules.html)
+page (although this table is out of date compared to the
+[CLDR XML source](http://unicode.org/repos/cldr/trunk/common/supplemental/plurals.xml)).
+
+### Plural Forms in the SDK ###
+
+In the code, you supply an extra parameter alongside the identifier,
+describing how many items there are:
var _ = require("l10n").get;
- console.log(_("child_id", 1));
- console.log(_("child_id", 2));
+ console.log(_("tomato_id"));
+ console.log(_("tomato_id", 1));
+ console.log(_("tomato_id", 2));
+ console.log(_("tomato_id", 5));
+ console.log(_("tomato_id", .5));
-This will give the following output:
+In the `.properties` file for each language you can define a different
+localization for each plural form possible in that language, using the
+CLDR keywords. So in English we could have two plural localizations
+(note that the "other" category does **not** take the CLDR keyword):
<pre>
-info: one child
-info: 2 children
+# en-US translations
+tomato_id[one]= %d tomato
+tomato_id= %d tomatoes
</pre>
-At the moment `l10n` only distinguishes between two plural forms:
-"one", and "not one". So it doesn't support
-[languages which have different plural rules](https://developer.mozilla.org/en/Localization_and_Plurals).
+In Russian we could have four plural localizations:
+
+<pre>
+# ru-RU translations
+tomato_id[one]= %d помидор
+tomato_id[few]= %d помидора
+tomato_id[many]= %d помидоров
+tomato_id= %d помидоры
+</pre>
+
+The localization module itself understands the CLDR definitions for each
+language, enabling it to map between, for example, "2" in the code and
+"few" in the `ru-RU.properties` file. Then it retrieves and returns
+the localization appropriate for the count you supplied.
## Placeholders ##
@@ -199,6 +263,20 @@ This gives us the following output:
info: London is Bob's home town.
</pre>
+## Locale Updater ##
+
+The [locale updater](https://github.com/downloads/ochameau/locale-updater/locale-updater.xpi)
+add-on makes it easier to update locale files. Once you've installed it,
+open the Add-on Manager, and you'll see a see a new button labeled
+"Update l10n" next to each add-on you've installed:
+
+<img class="align-center" src="static-files/media/screenshots/locale-updater.png"
+alt="Add-on manager with locale updater installed" />
+
+Click the button and you'll be prompted for a new `.properties` file
+for that add-on. If you provide a new file, the add-on's locale data
+will be updated with the new file.
+
## <a name="limitations">Limitations</a> ##
The current localization support is a first step towards full support,
@@ -223,8 +301,3 @@ a command to `cfx` that scans the add-on for localizable strings and
builds a template `.properties` file listing all the strings that need
to be translated.
-* The algorithm used to find a matching locale is based on the
-[Firefox implementation](http://mxr.mozilla.org/mozilla-central/source/chrome/src/nsChromeRegistryChrome.cpp#93)
-which is known to be sub-optimal for some locales. We're working on
-improving this in
-[bug 711041](https://bugzilla.mozilla.org/show_bug.cgi?id=711041).
View
18 dev-guide-source/tutorials/load-and-unload.md
@@ -17,9 +17,9 @@ Your add-on's `main.js` code is executed as soon as it is loaded. It is loaded
when it is installed, when it is enabled, or when Firefox starts.
If your add-on exports a function called `main()`, that function will be
-called immediately after main() will be invoked a moment after the overall
-`main.js` is evaluated, and after all top-level require() statements have
-run (so generally after all dependent modules have been loaded).
+called immediately after the overall `main.js` is evaluated, and after all
+top-level `require()` statements have run (so generally after all dependent
+modules have been loaded).
exports.main = function (options, callbacks) {};
@@ -80,15 +80,15 @@ will be called when the add-on is unloaded.
exports.onUnload = function (reason) {};
-<span class="aside">
-Note that if your add-on is unloaded with reason `disable`, it will not be
-notified about `uninstall` while it is disabled: see
-bug [571049](https://bugzilla.mozilla.org/show_bug.cgi?id=571049).
-</span>
-
`reason` is one of the following strings describing the reason your add-on was
unloaded:
+<span class="aside">But note that due to
+[bug 627432](https://bugzilla.mozilla.org/show_bug.cgi?id=627432),
+your `onUnload` listener will never be called with `uninstall`: it
+will only be called with `disable`. See in particular
+[comment 12 on that bug](https://bugzilla.mozilla.org/show_bug.cgi?id=627432#c12).</span>
+
<pre>
uninstall
disable
View
4 dev-guide-source/tutorials/mobile.md
@@ -1,3 +1,7 @@
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+ - License, v. 2.0. If a copy of the MPL was not distributed with this
+ - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
+
<div class="warning">Developing add-ons for Firefox Mobile is still
an experimental feature of the SDK. Although the SDK modules used are
stable, the setup instructions and cfx commands are likely to change.
View
10 dev-guide-source/tutorials/modifying-web-pages-tab.md
@@ -130,9 +130,17 @@ using the object returned from `attach()`:
}
});
-The "drawBorder" message isn't a built-in message, it's one that this
+The `drawBorder` message isn't a built-in message, it's one that this
add-on defines in the `port.emit()` call.
+## Injecting CSS ##
+
+Unlike the [`page-mod`](dev-guide/tutorials/modifying-web-pages-url.html) API,
+`tab.attach()` doesn't enable you to inject CSS directly into a page.
+
+To modify the style of a page you have to use JavaScript, as in
+the example above.
+
## Learning More ##
To learn more about working with tabs in the SDK, see the
View
32 dev-guide-source/tutorials/modifying-web-pages-url.md
@@ -178,9 +178,39 @@ In the add-on script, we'll send the content script a message inside `onAttach`:
}
});
-The "replacePage" message isn't a built-in message: it's a message defined by
+The `replacePage` message isn't a built-in message: it's a message defined by
the add-on in the `port.emit()` call.
+<div class="experimental">
+
+## Injecting CSS ##
+
+**Note that the feature described in this section is experimental
+at the moment: we'll very probably continue to support the feature,
+but details of the API might need to change.**
+
+Rather than injecting JavaScript into a page, you can inject CSS by
+setting the page-mod's `contentStyle` option:
+
+ var pageMod = require("page-mod").PageMod({
+ include: "*",
+ contentStyle: "body {" +
+ " border: 5px solid green;" +
+ "}"
+ });
+
+As with `contentScript`, there's a corresponding `contentStyleFile` option
+that's given the URL of a CSS file in your "data" directory, and it is
+good practice to use this option in preference to `contentStyle` if the
+CSS is at all complex:
+
+ var pageMod = require("page-mod").PageMod({
+ include: "*",
+ contentStyleFile: require("self").data.url("my-style.css")
+ });
+
+</div>
+
## Learning More ##
To learn more about page-mod, see its
View
4 dev-guide-source/tutorials/open-a-web-page.md
@@ -33,8 +33,8 @@ to the `onReady` property, and will be passed the tab as an argument:
Even then, you don't get direct access to any content hosted in the tab.
To access tab content you need to attach a script to the tab
-using `tab.attach()`. This add-on attaches a script to all open
-tabs. The script adds a red border to the tab's document:
+using `tab.attach()`. This add-on loads a page, then attaches a script to
+the page which adds a red border to it:
var tabs = require("tabs");
tabs.open({
View
18 dev-guide-source/tutorials/troubleshooting.md
@@ -8,6 +8,24 @@ If you're having trouble getting the Add-on SDK up and running, don't panic!
This page lists some starting points that might help you track down your
problem.
+Quarantine Problem on Mac OS X
+------------------------------
+On Mac OS X, you might see the following error when you try to run `cfx`:
+
+<pre>
+/path/to/sdk/bin/cfx: /usr/bin/env: bad interpreter: Operation not permitted
+</pre>
+
+This might be because the `cfx` executable file has been placed in quarantine
+during download from the Internet.
+
+To get it out of quarantine, use the `xattr -d` command, specifying
+`com.apple.quarantine` as the name of the attribute to delete, and `cfx` as
+the file from which to delete that attribute:
+
+<pre>
+xattr -d com.apple.quarantine /path/to/sdk/bin/cfx
+</pre>
Check Your Python
-----------------
View
14 dev-guide/cfx-tool.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -973,10 +973,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -1001,6 +1007,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -1021,6 +1031,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/console.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -201,10 +201,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -229,6 +235,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -249,6 +259,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
15 dev-guide/credits.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -122,6 +122,7 @@
<li>Drew Willcoxon</li>
<li>Piotr Zalewa</li>
<li><a href="https://github.com/dglol">David Guo</a></li>
+<li><a href="https://github.com/nmaier">Nils Maier</a></li>
</ul></div>
</div>
@@ -234,10 +235,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -262,6 +269,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -282,6 +293,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/glossary.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -227,10 +227,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -255,6 +261,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -275,6 +285,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
18 dev-guide/guides/commonjs.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -163,7 +163,9 @@
</li>
<li>
<p>building blocks for higher level modules, such as
-<a href="../../packages/api-utils/base.html">base</a> and
+<a href="../../packages/api-utils/event/core.html">event/core</a>,
+<a href="../../packages/api-utils/event/target.html">event/target</a>,
+<a href="../../packages/api-utils/base.html">base</a>, and
<a href="../../packages/api-utils/namespace.html">namespace</a>. You're more
likely to use these if you are building your own modules that
implement new APIs, thus extending the SDK itself.</p>
@@ -302,10 +304,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -330,6 +338,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -350,6 +362,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/content-scripts/access.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -360,10 +360,16 @@
<a href="../../../packages/api-utils/errors.html">errors</a>
+<a href="../../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../../packages/api-utils/events.html">events</a>
<a href="../../../packages/api-utils/file.html">file</a>
+<a href="../../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../../packages/api-utils/globals.html">globals</a>
<a href="../../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -388,6 +394,10 @@
<a href="../../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../../packages/api-utils/runtime.html">runtime</a>
<a href="../../../packages/api-utils/sandbox.html">sandbox</a>
@@ -408,6 +418,8 @@
<a href="../../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/content-scripts/index.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -248,10 +248,16 @@
<a href="../../../packages/api-utils/errors.html">errors</a>
+<a href="../../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../../packages/api-utils/events.html">events</a>
<a href="../../../packages/api-utils/file.html">file</a>
+<a href="../../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../../packages/api-utils/globals.html">globals</a>
<a href="../../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -276,6 +282,10 @@
<a href="../../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../../packages/api-utils/runtime.html">runtime</a>
<a href="../../../packages/api-utils/sandbox.html">sandbox</a>
@@ -296,6 +306,8 @@
<a href="../../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/content-scripts/loading.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -241,10 +241,16 @@
<a href="../../../packages/api-utils/errors.html">errors</a>
+<a href="../../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../../packages/api-utils/events.html">events</a>
<a href="../../../packages/api-utils/file.html">file</a>
+<a href="../../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../../packages/api-utils/globals.html">globals</a>
<a href="../../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -269,6 +275,10 @@
<a href="../../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../../packages/api-utils/runtime.html">runtime</a>
<a href="../../../packages/api-utils/sandbox.html">sandbox</a>
@@ -289,6 +299,8 @@
<a href="../../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/content-scripts/reddit-example.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -234,10 +234,16 @@
<a href="../../../packages/api-utils/errors.html">errors</a>
+<a href="../../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../../packages/api-utils/events.html">events</a>
<a href="../../../packages/api-utils/file.html">file</a>
+<a href="../../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../../packages/api-utils/globals.html">globals</a>
<a href="../../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -262,6 +268,10 @@
<a href="../../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../../packages/api-utils/runtime.html">runtime</a>
<a href="../../../packages/api-utils/sandbox.html">sandbox</a>
@@ -282,6 +292,8 @@
<a href="../../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/content-scripts/using-port.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -330,10 +330,16 @@
<a href="../../../packages/api-utils/errors.html">errors</a>
+<a href="../../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../../packages/api-utils/events.html">events</a>
<a href="../../../packages/api-utils/file.html">file</a>
+<a href="../../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../../packages/api-utils/globals.html">globals</a>
<a href="../../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -358,6 +364,10 @@
<a href="../../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../../packages/api-utils/runtime.html">runtime</a>
<a href="../../../packages/api-utils/sandbox.html">sandbox</a>
@@ -378,6 +388,8 @@
<a href="../../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/content-scripts/using-postmessage.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -295,10 +295,16 @@
<a href="../../../packages/api-utils/errors.html">errors</a>
+<a href="../../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../../packages/api-utils/events.html">events</a>
<a href="../../../packages/api-utils/file.html">file</a>
+<a href="../../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../../packages/api-utils/globals.html">globals</a>
<a href="../../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -323,6 +329,10 @@
<a href="../../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../../packages/api-utils/runtime.html">runtime</a>
<a href="../../../packages/api-utils/sandbox.html">sandbox</a>
@@ -343,6 +353,8 @@
<a href="../../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/events.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -309,10 +309,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -337,6 +343,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -357,6 +367,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
20 dev-guide/guides/firefox-compatibility.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -60,7 +60,11 @@
<div id="main-content-column" class="column">
<div id="toc"></div>
- <div id="main-content"><h1>Firefox Compatibility</h1>
+ <div id="main-content"><!-- This Source Code Form is subject to the terms of the Mozilla Public
+ - License, v. 2.0. If a copy of the MPL was not distributed with this
+ - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
+
+<h1>Firefox Compatibility</h1>
<p>One of the promises the SDK makes is to maintain compatibility for its
<a href="../../packages/addon-kit/index.html">"supported" or "high-level" APIs</a>:
meaning that code written against them will not need to change as new
@@ -253,10 +257,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -281,6 +291,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -301,6 +315,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/index.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -340,10 +340,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -368,6 +374,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -388,6 +398,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/library-detector.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -364,10 +364,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -392,6 +398,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -412,6 +422,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/module-search.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -281,10 +281,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -309,6 +315,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -329,6 +339,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/program-id.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -200,10 +200,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -228,6 +234,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -248,6 +258,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/sdk-vs-xul.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -277,10 +277,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -305,6 +311,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -325,6 +335,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/two-types-of-scripts.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -276,10 +276,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -304,6 +310,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -324,6 +334,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/guides/xul-migration.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -453,10 +453,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -481,6 +487,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -501,6 +511,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/high-level-apis.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -186,10 +186,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -214,6 +220,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -234,6 +244,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/index.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -318,10 +318,16 @@ <h2 class="top">Welcome to the Add-on SDK!</h2>
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -346,6 +352,10 @@ <h2 class="top">Welcome to the Add-on SDK!</h2>
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -366,6 +376,8 @@ <h2 class="top">Welcome to the Add-on SDK!</h2>
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/low-level-apis.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -208,10 +208,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -236,6 +242,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -256,6 +266,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
20 dev-guide/package-spec.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -60,7 +60,11 @@
<div id="main-content-column" class="column">
<div id="toc"></div>
- <div id="main-content"><h1>Package Specification</h1>
+ <div id="main-content"><!-- This Source Code Form is subject to the terms of the Mozilla Public
+ - License, v. 2.0. If a copy of the MPL was not distributed with this
+ - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
+
+<h1>Package Specification</h1>
<p>A <em>package</em> is a directory that, at minimum, contains a JSON file
called <code>package.json</code>. This file is also referred to as the
<em>package manifest</em>.</p>
@@ -294,10 +298,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -322,6 +332,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -342,6 +356,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/third-party-apis.html
@@ -50,7 +50,7 @@
<h1>
<a href="../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -177,10 +177,16 @@
<a href="../packages/api-utils/errors.html">errors</a>
+<a href="../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../packages/api-utils/event/target.html">event/target</a>
+
<a href="../packages/api-utils/events.html">events</a>
<a href="../packages/api-utils/file.html">file</a>
+<a href="../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../packages/api-utils/globals.html">globals</a>
<a href="../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -205,6 +211,10 @@
<a href="../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../packages/api-utils/promise.html">promise</a>
+
+<a href="../packages/api-utils/querystring.html">querystring</a>
+
<a href="../packages/api-utils/runtime.html">runtime</a>
<a href="../packages/api-utils/sandbox.html">sandbox</a>
@@ -225,6 +235,8 @@
<a href="../packages/api-utils/uuid.html">uuid</a>
+<a href="../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../packages/api-utils/window-utils.html">window-utils</a>
<a href="../packages/api-utils/xhr.html">xhr</a>
View
14 dev-guide/tutorials/add-a-context-menu-item.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -241,10 +241,16 @@
<a href="../../packages/api-utils/errors.html">errors</a>
+<a href="../../packages/api-utils/event/core.html">event/core</a>
+
+<a href="../../packages/api-utils/event/target.html">event/target</a>
+
<a href="../../packages/api-utils/events.html">events</a>
<a href="../../packages/api-utils/file.html">file</a>
+<a href="../../packages/api-utils/frame/utils.html">frame/utils</a>
+
<a href="../../packages/api-utils/globals.html">globals</a>
<a href="../../packages/api-utils/hidden-frame.html">hidden-frame</a>
@@ -269,6 +275,10 @@
<a href="../../packages/api-utils/preferences-service.html">preferences-service</a>
+<a href="../../packages/api-utils/promise.html">promise</a>
+
+<a href="../../packages/api-utils/querystring.html">querystring</a>
+
<a href="../../packages/api-utils/runtime.html">runtime</a>
<a href="../../packages/api-utils/sandbox.html">sandbox</a>
@@ -289,6 +299,8 @@
<a href="../../packages/api-utils/uuid.html">uuid</a>
+<a href="../../packages/api-utils/window/utils.html">window/utils</a>
+
<a href="../../packages/api-utils/window-utils.html">window-utils</a>
<a href="../../packages/api-utils/xhr.html">xhr</a>
View
22 dev-guide/tutorials/adding-menus.html
@@ -50,7 +50,7 @@
<h1>
<a href="../../dev-guide/index.html">Add-on SDK<span></span></a>
</h1>
- <div id="version">Version 1.6</div>
+ <div id="version">Version 1.7</div>
</div>
</div>
@@ -76,6 +76,9 @@
modules for add-on developers to use. Luckily, Erik Vold has written
a <a href="https://github.com/erikvold/menuitems-jplib"><code>menuitems</code></a> package
that enables us to add menu items.</p>
+<p>This tutorial does double-duty. It describes the general method for
+using an external, third-party package in your add-on, and it
+describes how to add a menu item using the <code>menuitems</code> package in particular.</p>
<h2>Installing <code>menuitems</code></h2>
<p>First we'll download <code>menuitems</code> from
<a href="https://github.com/erikvold/menuitems-jplib/zipball/51080383cbb0fe2a05f8992a8aae890f4c014176">https://github.com/erikvold/menuitems-jplib</a>.</p>
@@ -156,8 +159,9 @@
<li>
<p>our support for third party packages is still fairly immature. One
consequence of this is that it's not always obvious where to find third-party
-packages, although some are collected in the
-<a href="https://wiki.mozilla.org/Jetpack/Modules">Jetpack Wiki</a></p>