aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/librejs.info467
-rw-r--r--docs/librejs.texi (renamed from docs/man.texi)459
-rw-r--r--docs/version.texi4
3 files changed, 714 insertions, 216 deletions
diff --git a/docs/librejs.info b/docs/librejs.info
index 0520e19..0b12979 100644
--- a/docs/librejs.info
+++ b/docs/librejs.info
@@ -1,10 +1,11 @@
-This is librejs.info, produced by makeinfo version 6.5 from man.texi.
+This is librejs.info, produced by makeinfo version 6.8 from
+librejs.texi.
-This manual is for GNU LibreJS (version 7.17, 8 October 2018), a GNU
+This manual is for GNU LibreJS (version 7.20, 18 April 2022), a GNU
IceCat extension to detect and block nonfree nontrivial JavaScript on
webpages.
- Copyright (C) 2011 2012 2014 2015 Loic J. Duros
+ Copyright (C) 2011 2012 2014 2015 Loic J. Duros, 2022 Yuchen Pei
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
@@ -23,7 +24,7 @@ File: librejs.info, Node: Top, Next: Overview, Up: (dir)
LibreJS
*******
-This manual is for GNU LibreJS (version 7.17, 8 October 2018).
+This manual is for GNU LibreJS (version 7.20, 18 April 2022).
* Menu:
@@ -89,11 +90,11 @@ File: librejs.info, Node: Installation, Next: How to Use, Prev: Disclaimer,
**************
You can install LibreJS directly using a generated 'librejs.xpi' file,
-or by building it from source.
+or by building it from source (*Note LibreJS Development Notes::).
- You can also download it from
-<https://addons.mozilla.org/addon/librejs/>, but due to Mozilla's review
-process the download isn't always up to date.
+ You can also download it from <https://www.gnu.org/software/librejs/>
+or <https://addons.mozilla.org/addon/librejs/>, but due to Mozilla's
+review process the download isn't always up to date.

File: librejs.info, Node: How to Use, Next: JavaScript Detection, Prev: Installation, Up: Top
@@ -274,94 +275,290 @@ must be declared using a machine-readable license format.
"// @license [magnet link] [identifier]" [Script here] "//
@license-end"
- "Identifier" is a name of a license from the following list and
-"magnet link" is that license's exact corresponding magnet link.
+ "Identifier" is a name of a license from the following list and the
+magnet link in the 'canonicalUrl' field is that license's exact
+corresponding magnet link.
{
- 'Apache-2.0':{
- 'URL': 'http://www.apache.org/licenses/LICENSE-2.0',
- 'Magnet link': 'magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt'
- },
- 'Artistic-2.0':{
- 'URL': 'http://www.perlfoundation.org/artistic_license_2_0',
- 'Magnet link': 'magnet:?xt=urn:btih:54fd2283f9dbdf29466d2df1a98bf8f65cafe314&dn=artistic-2.0.txt'
- },
- 'Boost':{
- 'URL': 'http://www.boost.org/LICENSE_1_0.txt',
- 'Magnet link': 'magnet:?xt=urn:btih:89a97c535628232f2f3888c2b7b8ffd4c078cec0&dn=Boost-1.0.txt'
- },
- 'BSD-3-Clause':{
- 'URL': 'http://opensource.org/licenses/BSD-3-Clause',
- 'Magnet link': 'magnet:?xt=urn:btih:c80d50af7d3db9be66a4d0a86db0286e4fd33292&dn=bsd-3-clause.txt',
- },
- 'CPAL-1.0':{
- 'URL': 'http://opensource.org/licenses/cpal_1.0',
- 'Magnet link': 'magnet:?xt=urn:btih:84143bc45939fc8fa42921d619a95462c2031c5c&dn=cpal-1.0.txt'
- },
- 'CC0-1.0':{
- 'URL': 'http://creativecommons.org/publicdomain/zero/1.0/legalcode',
- 'Magnet link': 'magnet:?xt=urn:btih:90dc5c0be029de84e523b9b3922520e79e0e6f08&dn=cc0.txt'
- },
- 'EPL-1.0':{
- 'URL': 'http://www.eclipse.org/legal/epl-v10.html',
- 'Magnet link': 'magnet:?xt=urn:btih:4c6a2ad0018cd461e9b0fc44e1b340d2c1828b22&dn=epl-1.0.txt'
- },
- 'Expat':{
- 'URL': 'http://www.jclark.com/xml/copying.txt',
- 'Magnet link': 'magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt'
- },
- 'FreeBSD':{
- 'URL': 'http://www.freebsd.org/copyright/freebsd-license.html',
- 'Magnet link': 'magnet:?xt=urn:btih:87f119ba0b429ba17a44b4bffcab33165ebdacc0&dn=freebsd.txt'
- },
- 'GPL-2.0':{
- 'URL': 'http://www.gnu.org/licenses/gpl-2.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt'
- },
- 'GPL-3.0':{
- 'URL': 'http://www.gnu.org/licenses/gpl-3.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt'
- },
- 'LGPL-2.1':{
- 'URL': 'http://www.gnu.org/licenses/lgpl-2.1.html',
- 'Magnet link': 'magnet:?xt=urn:btih:5de60da917303dbfad4f93fb1b985ced5a89eac2&dn=lgpl-2.1.txt'
- },
- 'LGPL-3.0':{
- 'URL': 'http://www.gnu.org/licenses/lgpl-3.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:0ef1b8170b3b615170ff270def6427c317705f85&dn=lgpl-3.0.txt'
- },
- 'AGPL-3.0':{
- 'URL': 'http://www.gnu.org/licenses/agpl-3.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:0b31508aeb0634b347b8270c7bee4d411b5d4109&dn=agpl-3.0.txt'
- },
- 'ISC':{
- 'URL': 'https://www.isc.org/downloads/software-support-policy/isc-license/',
- 'Magnet link': 'magnet:?xt=urn:btih:b8999bbaf509c08d127678643c515b9ab0836bae&dn=ISC.txt'
- },
- 'MPL-2.0':{
- 'URL': 'http://www.mozilla.org/MPL/2.0',
- 'Magnet link': 'magnet:?xt=urn:btih:3877d6d54b3accd4bc32f8a48bf32ebc0901502a&dn=mpl-2.0.txt'
- },
- 'UPL-1.0': {
- 'URL': 'https://oss.oracle.com/licenses/upl/',
- 'Magnet link': 'magnet:?xt=urn:btih:478974f4d41c3fa84c4befba25f283527fad107d&dn=upl-1.0.txt'
- },
- 'WTFPL': {
- 'URL': 'http://www.wtfpl.net/txt/copying/',
- 'Magnet link': 'magnet:?xt=urn:btih:723febf9f6185544f57f0660a41489c7d6b4931b&dn=wtfpl.txt'
- },
- 'Unlicense':{
- 'URL': 'http://unlicense.org/UNLICENSE',
- 'Magnet link': 'magnet:?xt=urn:btih:5ac446d35272cc2e4e85e4325b146d0b7ca8f50c&dn=unlicense.txt'
- },
- 'X11':{
- 'URL': 'http://www.xfree86.org/3.3.6/COPYRIGHT2.html#3',
- 'Magnet link': 'magnet:?xt=urn:btih:5305d91886084f776adcf57509a648432709a7c7&dn=x11.txt'
- },
- 'Modified-BSD':{
- 'URL': 'http://www.xfree86.org/current/LICENSE4.html',
- 'Magnet link': 'magnet:?xt=urn:btih:12f2ec9e8de2a3b0002a33d518d6010cc8ab2ae9&dn=xfree86.txt'
- }
+ 'AGPL-3.0': {
+ licenseName: 'GNU AFFERO GENERAL PUBLIC LICENSE version 3',
+ identifier: 'AGPL-3.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/agpl-3.0.html',
+ 'magnet:?xt=urn:btih:0b31508aeb0634b347b8270c7bee4d411b5d4109&dn=agpl-3.0.txt'
+ ],
+
+ },
+
+ 'Apache-2.0': {
+ licenseName: 'Apache License, Version 2.0',
+ identifier: 'Apache-2.0',
+ canonicalUrl: [
+ 'http://www.apache.org/licenses/LICENSE-2.0',
+ 'magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt'
+ ],
+ },
+
+ 'Artistic-2.0': {
+ licenseName: "Artistic License 2.0",
+ identifier: 'Artistic-2.0',
+ canonicalUrl: [
+ "http://www.perlfoundation.org/artistic_license_2_0",
+ "magnet:?xt=urn:btih:54fd2283f9dbdf29466d2df1a98bf8f65cafe314&dn=artistic-2.0.txt"
+ ],
+ },
+
+ 'BSD-2-Clause': {
+ licenseName: "BSD 2-Clause License",
+ identifier: 'BSD-2-Clause',
+ canonicalUrl: [
+ 'http://www.freebsd.org/copyright/freebsd-license.html',
+ 'magnet:?xt=urn:btih:87f119ba0b429ba17a44b4bffcab33165ebdacc0&dn=freebsd.txt'
+ ],
+ },
+
+ 'BSD-3-Clause': {
+ licenseName: "BSD 3-Clause License",
+ identifier: 'BSD-3-Clause',
+ canonicalUrl: [
+ 'http://opensource.org/licenses/BSD-3-Clause',
+ 'magnet:?xt=urn:btih:c80d50af7d3db9be66a4d0a86db0286e4fd33292&dn=bsd-3-clause.txt'
+ ],
+ },
+
+ 'BSL-1.0': {
+ licenseName: 'Boost Software License 1.0',
+ identifier: 'BSL-1.0',
+ canonicalUrl: [
+ 'http://www.boost.org/LICENSE_1_0.txt',
+ 'magnet:?xt=urn:btih:89a97c535628232f2f3888c2b7b8ffd4c078cec0&dn=Boost-1.0.txt'
+ ],
+ },
+
+ 'CC-BY-1.0': {
+ licenseName: 'Creative Commons Attribution 1.0 Generic',
+ identifier: 'CC-BY-1.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/1.0/'],
+ },
+
+ 'CC-BY-2.0': {
+ licenseName: 'Creative Commons Attribution 2.0 Generic',
+ identifier: 'CC-BY-2.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/2.0/'],
+ },
+
+ 'CC-BY-2.5': {
+ licenseName: 'Creative Commons Attribution 2.5 Generic',
+ identifier: 'CC-BY-2.5',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/2.5/'],
+ },
+
+ 'CC-BY-3.0': {
+ licenseName: 'Creative Commons Attribution 3.0 Unported',
+ identifier: 'CC-BY-3.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/3.0/'],
+ },
+
+ 'CC-BY-4.0': {
+ licenseName: 'Creative Commons Attribution 4.0 International',
+ identifier: 'CC-BY-4.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/4.0/'],
+ },
+
+ 'CC-BY-SA-1.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 1.0 Generic',
+ identifier: 'CC-BY-SA-1.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/1.0/'],
+ },
+
+ 'CC-BY-SA-2.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 2.0 Generic',
+ identifier: 'CC-BY-SA-2.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/2.0/'],
+ },
+
+ 'CC-BY-SA-2.5': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 2.5 Generic',
+ identifier: 'CC-BY-SA-2.5',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/2.5/'],
+ },
+
+ 'CC-BY-SA-3.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 3.0 Unported',
+ identifier: 'CC-BY-SA-3.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/3.0/'],
+ },
+
+ 'CC-BY-SA-4.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 4.0 International',
+ identifier: 'CC-BY-SA-4.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/4.0/'],
+ },
+
+ 'CC0-1.0': {
+ licenseName: 'Creative Commons CC0 1.0 Universal',
+ identifier: 'CC0-1.0',
+ canonicalUrl: [
+ 'http://creativecommons.org/publicdomain/zero/1.0/legalcode',
+ 'magnet:?xt=urn:btih:90dc5c0be029de84e523b9b3922520e79e0e6f08&dn=cc0.txt'
+ ],
+ },
+
+ 'CPAL-1.0': {
+ licenseName: 'Common Public Attribution License Version 1.0 (CPAL)',
+ identifier: 'CPAL-1.0',
+ canonicalUrl: [
+ 'http://opensource.org/licenses/cpal_1.0',
+ 'magnet:?xt=urn:btih:84143bc45939fc8fa42921d619a95462c2031c5c&dn=cpal-1.0.txt'
+ ],
+ },
+
+ 'EPL-1.0': {
+ licenseName: "Eclipse Public License Version 1.0",
+ identifier: "EPL-1.0",
+ canonicalUrl: [
+ "http://www.eclipse.org/legal/epl-v10.html",
+ "magnet:?xt=urn:btih:4c6a2ad0018cd461e9b0fc44e1b340d2c1828b22&dn=epl-1.0.txt"
+ ],
+ },
+
+ 'Expat': {
+ licenseName: 'Expat License (sometimes called MIT Licensed)',
+ identifier: 'Expat',
+ canonicalUrl: [
+ 'http://www.jclark.com/xml/copying.txt',
+ 'magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt'
+ ],
+ },
+
+ 'FreeBSD': {
+ licenseName: "FreeBSD License",
+ identifier: 'FreeBSD',
+ canonicalUrl: [
+ 'http://www.freebsd.org/copyright/freebsd-license.html',
+ 'magnet:?xt=urn:btih:87f119ba0b429ba17a44b4bffcab33165ebdacc0&dn=freebsd.txt'
+ ],
+ },
+
+ 'GNU-All-Permissive': {
+ licenseName: 'GNU All-Permissive License',
+ identifier: 'GNU-All-Permissive',
+ canonicalUrl: [],
+ },
+
+ 'GPL-2.0': {
+ licenseName: 'GNU General Public License (GPL) version 2',
+ identifier: 'GPL-2.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/gpl-2.0.html',
+ 'magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt'
+ ],
+ },
+
+ 'GPL-3.0': {
+ licenseName: 'GNU General Public License (GPL) version 3',
+ identifier: 'GPL-3.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/gpl-3.0.html',
+ 'magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt'
+ ],
+ },
+
+ 'ISC': {
+ licenseName: "The ISC License",
+ identifier: 'ISC',
+ canonicalUrl: [
+ 'https://www.isc.org/downloads/software-support-policy/isc-license/',
+ 'magnet:?xt=urn:btih:b8999bbaf509c08d127678643c515b9ab0836bae&dn=ISC.txt'
+ ],
+ },
+
+ 'jQueryTools': {
+ licenseName: "jQuery Tools",
+ identifier: 'jQueryTools',
+ canonicalUrl: [],
+ },
+
+ 'LGPL-2.1': {
+ licenseName: 'GNU Lesser General Public License, version 2.1',
+ identifier: 'LGPL-2.1',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/lgpl-2.1.html',
+ 'magnet:?xt=urn:btih:5de60da917303dbfad4f93fb1b985ced5a89eac2&dn=lgpl-2.1.txt'
+ ],
+ },
+
+ 'LGPL-3.0': {
+ licenseName: 'GNU Lesser General Public License, version 3',
+ identifier: 'LGPL-3.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/lgpl-3.0.html',
+ 'magnet:?xt=urn:btih:0ef1b8170b3b615170ff270def6427c317705f85&dn=lgpl-3.0.txt'
+ ],
+ },
+
+ 'MPL-2.0': {
+ licenseName: 'Mozilla Public License Version 2.0',
+ identifier: 'MPL-2.0',
+ canonicalUrl: [
+ 'http://www.mozilla.org/MPL/2.0',
+ 'magnet:?xt=urn:btih:3877d6d54b3accd4bc32f8a48bf32ebc0901502a&dn=mpl-2.0.txt'
+ ],
+ },
+
+ 'PublicDomain': {
+ licenseName: 'Public Domain',
+ identifier: 'PublicDomain',
+ canonicalUrl: [
+ 'magnet:?xt=urn:btih:e95b018ef3580986a04669f1b5879592219e2a7a&dn=public-domain.txt'
+ ],
+ },
+
+
+ 'Unlicense': {
+ licenseName: 'Unlicense',
+ identifier: 'Unlicense',
+ canonicalUrl: [
+ 'http://unlicense.org/UNLICENSE',
+ 'magnet:?xt=urn:btih:5ac446d35272cc2e4e85e4325b146d0b7ca8f50c&dn=unlicense.txt'
+ ],
+ },
+
+ 'UPL': {
+ licenseName: 'Universal Permissive License',
+ identifier: 'UPL-1.0',
+ canonicalUrl: [
+ 'https://oss.oracle.com/licenses/upl/',
+ 'magnet:?xt=urn:btih:478974f4d41c3fa84c4befba25f283527fad107d&dn=upl-1.0.txt'
+ ],
+ },
+
+ 'WTFPL': {
+ licenseName: 'Do What The F*ck You Want To Public License (WTFPL)',
+ identifier: 'WTFPL',
+ canonicalUrl: [
+ 'http://www.wtfpl.net/txt/copying/',
+ 'magnet:?xt=urn:btih:723febf9f6185544f57f0660a41489c7d6b4931b&dn=wtfpl.txt'
+ ],
+ },
+
+ 'X11': {
+ licenseName: 'X11 License',
+ identifier: 'X11',
+ canonicalUrl: [
+ 'magnet:?xt=urn:btih:5305d91886084f776adcf57509a648432709a7c7&dn=x11.txt'
+ ],
+ },
+
+ 'XFree86-1.1': {
+ licenseName: "XFree86 1.1 License",
+ identifier: 'XFree86-1.1',
+ canonicalUrl: [
+ 'http://www.xfree86.org/3.3.6/COPYRIGHT2.html#3',
+ 'http://www.xfree86.org/current/LICENSE4.html',
+ 'magnet:?xt=urn:btih:12f2ec9e8de2a3b0002a33d518d6010cc8ab2ae9&dn=xfree86.txt'
+ ],
+ },
}
7.2 Undetected Free Licenses
@@ -376,6 +573,14 @@ information.
Many free licenses are listed in this page:
<http://www.gnu.org/licenses/license-list.html>
+7.3 Known limitations
+=====================
+
+Service workers may cause false positives and false negatives, and there
+are multiple ways to disable them. The cleanest way is by setting
+'dom.serviceWorkers.enabled' to 'false' in the 'about:config' page of
+your browser.
+

File: librejs.info, Node: LibreJS Development Notes, Next: Installation Requirements, Prev: Setting Your JavaScript Free, Up: Top
@@ -385,10 +590,9 @@ File: librejs.info, Node: LibreJS Development Notes, Next: Installation Requir
8.1 Dependencies
================
-LibreJS 7.17 depends on a number of Node.js-based libraries that can be
+LibreJS 7.20 depends on a number of Node.js-based libraries that can be
installed using the 'npm' utility:
- $ npm install acorn-loose
$ npm install jssha
$ npm install browserify
$ export PATH=$PATH:./node_modules/.bin
@@ -430,7 +634,45 @@ extension is loaded as a "Temporary add-on" from 'about:debugging'.
Otherwise (if included in the xpi) it can be launched from the UI by
clicking the "Automated self test..." button.
-8.5 Adding new whitelisted libraries
+8.5 Headless testing
+====================
+
+To launch the test suite from the command line, ensure the xpi package
+has been built with automated test suite. Then install
+selenium-webdriver and geckodriver, and ensure the latter is in $PATH:
+ $ npm install selenium-webdriver
+ $ npm install geckodriver
+ $ export PATH=$PATH:./node_modules/.bin
+
+ Now you can invoke the test with
+ $ node ./test.js
+
+ which will print out a summary of test results.
+
+ Optionally you can also test with a chosen seed
+ $ node ./test.js 12345
+
+8.6 Headless compliance check
+=============================
+
+To check whether a webpage is LibreJS-compliant from the command line,
+ensure that the xpi package has been built WITHOUT the automated test
+suite. Then install selenium-webdriver and geckodriver, and ensure the
+latter is in $PATH:
+ $ npm install selenium-webdriver
+ $ npm install geckodriver
+ $ export PATH=$PATH:./node_modules/.bin
+
+ Now you can check a webpage for compliance with
+ $ node ./compliance.js <url>
+
+ It will open the url in a headless browser, save a screenshot, and
+output the compliance check result.
+
+ For example, to check the compliance of the FSF homepage, do
+ $ node ./compliance.js https://fsf.org
+
+8.7 Adding new whitelisted libraries
====================================
The script index.js in './hash_script' generates the default whitelist.
@@ -441,7 +683,7 @@ Run it with the following command:
Then, just copy the contents of the file "output" to the appropriate
place in main_background.js.
-8.6 Releasing a new version
+8.8 Releasing a new version
===========================
Update the version number in manifest.json.
@@ -971,17 +1213,22 @@ their use in free software.

Tag Table:
-Node: Top825
-Node: Overview1818
-Node: Disclaimer2665
-Node: Installation3161
-Node: How to Use3539
-Node: JavaScript Detection7045
-Node: Free Licenses Detection8332
-Node: Setting Your JavaScript Free8803
-Node: LibreJS Development Notes14530
-Node: Installation Requirements16612
-Node: LibreJS Internals17322
-Node: GNU Free Documentation License17972
+Node: Top845
+Node: Overview1837
+Node: Disclaimer2684
+Node: Installation3180
+Node: How to Use3637
+Node: JavaScript Detection7143
+Node: Free Licenses Detection8430
+Node: Setting Your JavaScript Free8901
+Node: LibreJS Development Notes19613
+Node: Installation Requirements22895
+Node: LibreJS Internals23605
+Node: GNU Free Documentation License24255

End Tag Table
+
+
+Local Variables:
+coding: utf-8
+End:
diff --git a/docs/man.texi b/docs/librejs.texi
index a9db799..83f2403 100644
--- a/docs/man.texi
+++ b/docs/librejs.texi
@@ -9,7 +9,7 @@ This manual is for GNU LibreJS (version @value{VERSION}, @value{UPDATED}),
a GNU IceCat extension to detect and block nonfree nontrivial
JavaScript on webpages.
-Copyright @copyright{} 2011 2012 2014 2015 Loic J. Duros
+Copyright @copyright{} 2011 2012 2014 2015 Loic J. Duros, 2022 Yuchen Pei
@quotation
Permission is granted to copy, distribute and/or modify this document
@@ -30,6 +30,7 @@ Texts. A copy of the license is included in the section entitled
@title GNU LibreJS
@subtitle for version @value{VERSION}, @value{UPDATED}
@author Loic J. Duros (@email{librejs@@lduros.net})
+@author Yuchen Pei (@email{ycp@@gnu.org})
@page
@vskip 0pt plus 1filll
@insertcopying
@@ -109,10 +110,12 @@ it to @email{bug-librejs@@gnu.org}.
@cindex Installation
You can install LibreJS directly using a generated @file{librejs.xpi}
-file, or by building it from source.
+file, or by building it from source (@xref{LibreJS Development Notes}).
-You can also download it from @url{https://addons.mozilla.org/addon/librejs/},
-but due to Mozilla's review process the download isn't always up to date.
+You can also download it from
+@url{https://www.gnu.org/software/librejs/} or
+@url{https://addons.mozilla.org/addon/librejs/}, but due to Mozilla's
+review process the download isn't always up to date.
@node How to Use
@chapter How to Use
@@ -250,10 +253,11 @@ Allowed primitives exclude:
@chapter Free Licenses Detection
@cindex freelicenses
-The machine readable format for license declarations that LibreJS uses has changed
-in the most recent version. This was necessary in order to not break the asynchronous
-JS loading model that browsers use. Scripts are now evaluated independent of eachother
-and strictly as they arrive.
+The machine readable format for license declarations that LibreJS uses
+has changed in the most recent version. This was necessary in order to
+not break the asynchronous JS loading model that browsers use. Scripts
+are now evaluated independent of eachother and strictly as they
+arrive.
@node Setting Your JavaScript Free
@chapter Setting Your JavaScript Free
@@ -302,95 +306,291 @@ This format is the same for both remote in-line scripts.
[Script here]
"// @@license-end"
-"Identifier" is a name of a license from the following list and "magnet link" is that
-license's exact corresponding magnet link.
+"Identifier" is a name of a license from the following list and the
+magnet link in the @code{canonicalUrl} field is that license's exact
+corresponding magnet link.
@verbatim
{
- 'Apache-2.0':{
- 'URL': 'http://www.apache.org/licenses/LICENSE-2.0',
- 'Magnet link': 'magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt'
- },
- 'Artistic-2.0':{
- 'URL': 'http://www.perlfoundation.org/artistic_license_2_0',
- 'Magnet link': 'magnet:?xt=urn:btih:54fd2283f9dbdf29466d2df1a98bf8f65cafe314&dn=artistic-2.0.txt'
- },
- 'Boost':{
- 'URL': 'http://www.boost.org/LICENSE_1_0.txt',
- 'Magnet link': 'magnet:?xt=urn:btih:89a97c535628232f2f3888c2b7b8ffd4c078cec0&dn=Boost-1.0.txt'
- },
- 'BSD-3-Clause':{
- 'URL': 'http://opensource.org/licenses/BSD-3-Clause',
- 'Magnet link': 'magnet:?xt=urn:btih:c80d50af7d3db9be66a4d0a86db0286e4fd33292&dn=bsd-3-clause.txt',
- },
- 'CPAL-1.0':{
- 'URL': 'http://opensource.org/licenses/cpal_1.0',
- 'Magnet link': 'magnet:?xt=urn:btih:84143bc45939fc8fa42921d619a95462c2031c5c&dn=cpal-1.0.txt'
- },
- 'CC0-1.0':{
- 'URL': 'http://creativecommons.org/publicdomain/zero/1.0/legalcode',
- 'Magnet link': 'magnet:?xt=urn:btih:90dc5c0be029de84e523b9b3922520e79e0e6f08&dn=cc0.txt'
- },
- 'EPL-1.0':{
- 'URL': 'http://www.eclipse.org/legal/epl-v10.html',
- 'Magnet link': 'magnet:?xt=urn:btih:4c6a2ad0018cd461e9b0fc44e1b340d2c1828b22&dn=epl-1.0.txt'
- },
- 'Expat':{
- 'URL': 'http://www.jclark.com/xml/copying.txt',
- 'Magnet link': 'magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt'
- },
- 'FreeBSD':{
- 'URL': 'http://www.freebsd.org/copyright/freebsd-license.html',
- 'Magnet link': 'magnet:?xt=urn:btih:87f119ba0b429ba17a44b4bffcab33165ebdacc0&dn=freebsd.txt'
- },
- 'GPL-2.0':{
- 'URL': 'http://www.gnu.org/licenses/gpl-2.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt'
- },
- 'GPL-3.0':{
- 'URL': 'http://www.gnu.org/licenses/gpl-3.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt'
- },
- 'LGPL-2.1':{
- 'URL': 'http://www.gnu.org/licenses/lgpl-2.1.html',
- 'Magnet link': 'magnet:?xt=urn:btih:5de60da917303dbfad4f93fb1b985ced5a89eac2&dn=lgpl-2.1.txt'
- },
- 'LGPL-3.0':{
- 'URL': 'http://www.gnu.org/licenses/lgpl-3.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:0ef1b8170b3b615170ff270def6427c317705f85&dn=lgpl-3.0.txt'
- },
- 'AGPL-3.0':{
- 'URL': 'http://www.gnu.org/licenses/agpl-3.0.html',
- 'Magnet link': 'magnet:?xt=urn:btih:0b31508aeb0634b347b8270c7bee4d411b5d4109&dn=agpl-3.0.txt'
- },
- 'ISC':{
- 'URL': 'https://www.isc.org/downloads/software-support-policy/isc-license/',
- 'Magnet link': 'magnet:?xt=urn:btih:b8999bbaf509c08d127678643c515b9ab0836bae&dn=ISC.txt'
- },
- 'MPL-2.0':{
- 'URL': 'http://www.mozilla.org/MPL/2.0',
- 'Magnet link': 'magnet:?xt=urn:btih:3877d6d54b3accd4bc32f8a48bf32ebc0901502a&dn=mpl-2.0.txt'
- },
- 'UPL-1.0': {
- 'URL': 'https://oss.oracle.com/licenses/upl/',
- 'Magnet link': 'magnet:?xt=urn:btih:478974f4d41c3fa84c4befba25f283527fad107d&dn=upl-1.0.txt'
- },
- 'WTFPL': {
- 'URL': 'http://www.wtfpl.net/txt/copying/',
- 'Magnet link': 'magnet:?xt=urn:btih:723febf9f6185544f57f0660a41489c7d6b4931b&dn=wtfpl.txt'
- },
- 'Unlicense':{
- 'URL': 'http://unlicense.org/UNLICENSE',
- 'Magnet link': 'magnet:?xt=urn:btih:5ac446d35272cc2e4e85e4325b146d0b7ca8f50c&dn=unlicense.txt'
- },
- 'X11':{
- 'URL': 'http://www.xfree86.org/3.3.6/COPYRIGHT2.html#3',
- 'Magnet link': 'magnet:?xt=urn:btih:5305d91886084f776adcf57509a648432709a7c7&dn=x11.txt'
- },
- 'Modified-BSD':{
- 'URL': 'http://www.xfree86.org/current/LICENSE4.html',
- 'Magnet link': 'magnet:?xt=urn:btih:12f2ec9e8de2a3b0002a33d518d6010cc8ab2ae9&dn=xfree86.txt'
- }
+ 'AGPL-3.0': {
+ licenseName: 'GNU AFFERO GENERAL PUBLIC LICENSE version 3',
+ identifier: 'AGPL-3.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/agpl-3.0.html',
+ 'magnet:?xt=urn:btih:0b31508aeb0634b347b8270c7bee4d411b5d4109&dn=agpl-3.0.txt'
+ ],
+
+ },
+
+ 'Apache-2.0': {
+ licenseName: 'Apache License, Version 2.0',
+ identifier: 'Apache-2.0',
+ canonicalUrl: [
+ 'http://www.apache.org/licenses/LICENSE-2.0',
+ 'magnet:?xt=urn:btih:8e4f440f4c65981c5bf93c76d35135ba5064d8b7&dn=apache-2.0.txt'
+ ],
+ },
+
+ 'Artistic-2.0': {
+ licenseName: "Artistic License 2.0",
+ identifier: 'Artistic-2.0',
+ canonicalUrl: [
+ "http://www.perlfoundation.org/artistic_license_2_0",
+ "magnet:?xt=urn:btih:54fd2283f9dbdf29466d2df1a98bf8f65cafe314&dn=artistic-2.0.txt"
+ ],
+ },
+
+ 'BSD-2-Clause': {
+ licenseName: "BSD 2-Clause License",
+ identifier: 'BSD-2-Clause',
+ canonicalUrl: [
+ 'http://www.freebsd.org/copyright/freebsd-license.html',
+ 'magnet:?xt=urn:btih:87f119ba0b429ba17a44b4bffcab33165ebdacc0&dn=freebsd.txt'
+ ],
+ },
+
+ 'BSD-3-Clause': {
+ licenseName: "BSD 3-Clause License",
+ identifier: 'BSD-3-Clause',
+ canonicalUrl: [
+ 'http://opensource.org/licenses/BSD-3-Clause',
+ 'magnet:?xt=urn:btih:c80d50af7d3db9be66a4d0a86db0286e4fd33292&dn=bsd-3-clause.txt'
+ ],
+ },
+
+ 'BSL-1.0': {
+ licenseName: 'Boost Software License 1.0',
+ identifier: 'BSL-1.0',
+ canonicalUrl: [
+ 'http://www.boost.org/LICENSE_1_0.txt',
+ 'magnet:?xt=urn:btih:89a97c535628232f2f3888c2b7b8ffd4c078cec0&dn=Boost-1.0.txt'
+ ],
+ },
+
+ 'CC-BY-1.0': {
+ licenseName: 'Creative Commons Attribution 1.0 Generic',
+ identifier: 'CC-BY-1.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/1.0/'],
+ },
+
+ 'CC-BY-2.0': {
+ licenseName: 'Creative Commons Attribution 2.0 Generic',
+ identifier: 'CC-BY-2.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/2.0/'],
+ },
+
+ 'CC-BY-2.5': {
+ licenseName: 'Creative Commons Attribution 2.5 Generic',
+ identifier: 'CC-BY-2.5',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/2.5/'],
+ },
+
+ 'CC-BY-3.0': {
+ licenseName: 'Creative Commons Attribution 3.0 Unported',
+ identifier: 'CC-BY-3.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/3.0/'],
+ },
+
+ 'CC-BY-4.0': {
+ licenseName: 'Creative Commons Attribution 4.0 International',
+ identifier: 'CC-BY-4.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by/4.0/'],
+ },
+
+ 'CC-BY-SA-1.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 1.0 Generic',
+ identifier: 'CC-BY-SA-1.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/1.0/'],
+ },
+
+ 'CC-BY-SA-2.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 2.0 Generic',
+ identifier: 'CC-BY-SA-2.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/2.0/'],
+ },
+
+ 'CC-BY-SA-2.5': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 2.5 Generic',
+ identifier: 'CC-BY-SA-2.5',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/2.5/'],
+ },
+
+ 'CC-BY-SA-3.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 3.0 Unported',
+ identifier: 'CC-BY-SA-3.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/3.0/'],
+ },
+
+ 'CC-BY-SA-4.0': {
+ licenseName: 'Creative Commons Attribution-ShareAlike 4.0 International',
+ identifier: 'CC-BY-SA-4.0',
+ canonicalUrl: ['https://creativecommons.org/licenses/by-sa/4.0/'],
+ },
+
+ 'CC0-1.0': {
+ licenseName: 'Creative Commons CC0 1.0 Universal',
+ identifier: 'CC0-1.0',
+ canonicalUrl: [
+ 'http://creativecommons.org/publicdomain/zero/1.0/legalcode',
+ 'magnet:?xt=urn:btih:90dc5c0be029de84e523b9b3922520e79e0e6f08&dn=cc0.txt'
+ ],
+ },
+
+ 'CPAL-1.0': {
+ licenseName: 'Common Public Attribution License Version 1.0 (CPAL)',
+ identifier: 'CPAL-1.0',
+ canonicalUrl: [
+ 'http://opensource.org/licenses/cpal_1.0',
+ 'magnet:?xt=urn:btih:84143bc45939fc8fa42921d619a95462c2031c5c&dn=cpal-1.0.txt'
+ ],
+ },
+
+ 'EPL-1.0': {
+ licenseName: "Eclipse Public License Version 1.0",
+ identifier: "EPL-1.0",
+ canonicalUrl: [
+ "http://www.eclipse.org/legal/epl-v10.html",
+ "magnet:?xt=urn:btih:4c6a2ad0018cd461e9b0fc44e1b340d2c1828b22&dn=epl-1.0.txt"
+ ],
+ },
+
+ 'Expat': {
+ licenseName: 'Expat License (sometimes called MIT Licensed)',
+ identifier: 'Expat',
+ canonicalUrl: [
+ 'http://www.jclark.com/xml/copying.txt',
+ 'magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt'
+ ],
+ },
+
+ 'FreeBSD': {
+ licenseName: "FreeBSD License",
+ identifier: 'FreeBSD',
+ canonicalUrl: [
+ 'http://www.freebsd.org/copyright/freebsd-license.html',
+ 'magnet:?xt=urn:btih:87f119ba0b429ba17a44b4bffcab33165ebdacc0&dn=freebsd.txt'
+ ],
+ },
+
+ 'GNU-All-Permissive': {
+ licenseName: 'GNU All-Permissive License',
+ identifier: 'GNU-All-Permissive',
+ canonicalUrl: [],
+ },
+
+ 'GPL-2.0': {
+ licenseName: 'GNU General Public License (GPL) version 2',
+ identifier: 'GPL-2.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/gpl-2.0.html',
+ 'magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt'
+ ],
+ },
+
+ 'GPL-3.0': {
+ licenseName: 'GNU General Public License (GPL) version 3',
+ identifier: 'GPL-3.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/gpl-3.0.html',
+ 'magnet:?xt=urn:btih:1f739d935676111cfff4b4693e3816e664797050&dn=gpl-3.0.txt'
+ ],
+ },
+
+ 'ISC': {
+ licenseName: "The ISC License",
+ identifier: 'ISC',
+ canonicalUrl: [
+ 'https://www.isc.org/downloads/software-support-policy/isc-license/',
+ 'magnet:?xt=urn:btih:b8999bbaf509c08d127678643c515b9ab0836bae&dn=ISC.txt'
+ ],
+ },
+
+ 'jQueryTools': {
+ licenseName: "jQuery Tools",
+ identifier: 'jQueryTools',
+ canonicalUrl: [],
+ },
+
+ 'LGPL-2.1': {
+ licenseName: 'GNU Lesser General Public License, version 2.1',
+ identifier: 'LGPL-2.1',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/lgpl-2.1.html',
+ 'magnet:?xt=urn:btih:5de60da917303dbfad4f93fb1b985ced5a89eac2&dn=lgpl-2.1.txt'
+ ],
+ },
+
+ 'LGPL-3.0': {
+ licenseName: 'GNU Lesser General Public License, version 3',
+ identifier: 'LGPL-3.0',
+ canonicalUrl: [
+ 'http://www.gnu.org/licenses/lgpl-3.0.html',
+ 'magnet:?xt=urn:btih:0ef1b8170b3b615170ff270def6427c317705f85&dn=lgpl-3.0.txt'
+ ],
+ },
+
+ 'MPL-2.0': {
+ licenseName: 'Mozilla Public License Version 2.0',
+ identifier: 'MPL-2.0',
+ canonicalUrl: [
+ 'http://www.mozilla.org/MPL/2.0',
+ 'magnet:?xt=urn:btih:3877d6d54b3accd4bc32f8a48bf32ebc0901502a&dn=mpl-2.0.txt'
+ ],
+ },
+
+ 'PublicDomain': {
+ licenseName: 'Public Domain',
+ identifier: 'PublicDomain',
+ canonicalUrl: [
+ 'magnet:?xt=urn:btih:e95b018ef3580986a04669f1b5879592219e2a7a&dn=public-domain.txt'
+ ],
+ },
+
+
+ 'Unlicense': {
+ licenseName: 'Unlicense',
+ identifier: 'Unlicense',
+ canonicalUrl: [
+ 'http://unlicense.org/UNLICENSE',
+ 'magnet:?xt=urn:btih:5ac446d35272cc2e4e85e4325b146d0b7ca8f50c&dn=unlicense.txt'
+ ],
+ },
+
+ 'UPL': {
+ licenseName: 'Universal Permissive License',
+ identifier: 'UPL-1.0',
+ canonicalUrl: [
+ 'https://oss.oracle.com/licenses/upl/',
+ 'magnet:?xt=urn:btih:478974f4d41c3fa84c4befba25f283527fad107d&dn=upl-1.0.txt'
+ ],
+ },
+
+ 'WTFPL': {
+ licenseName: 'Do What The F*ck You Want To Public License (WTFPL)',
+ identifier: 'WTFPL',
+ canonicalUrl: [
+ 'http://www.wtfpl.net/txt/copying/',
+ 'magnet:?xt=urn:btih:723febf9f6185544f57f0660a41489c7d6b4931b&dn=wtfpl.txt'
+ ],
+ },
+
+ 'X11': {
+ licenseName: 'X11 License',
+ identifier: 'X11',
+ canonicalUrl: [
+ 'magnet:?xt=urn:btih:5305d91886084f776adcf57509a648432709a7c7&dn=x11.txt'
+ ],
+ },
+
+ 'XFree86-1.1': {
+ licenseName: "XFree86 1.1 License",
+ identifier: 'XFree86-1.1',
+ canonicalUrl: [
+ 'http://www.xfree86.org/3.3.6/COPYRIGHT2.html#3',
+ 'http://www.xfree86.org/current/LICENSE4.html',
+ 'magnet:?xt=urn:btih:12f2ec9e8de2a3b0002a33d518d6010cc8ab2ae9&dn=xfree86.txt'
+ ],
+ },
}
@end verbatim
@@ -405,6 +605,13 @@ information.
Many free licenses are listed in this page:
@url{http://www.gnu.org/licenses/license-list.html}
+@section Known limitations
+
+Service workers may cause false positives and false negatives, and
+there are multiple ways to disable them. The cleanest way is by
+setting @code{dom.serviceWorkers.enabled} to @code{false} in the
+@code{about:config} page of your browser.
+
@node LibreJS Development Notes
@chapter LibreJS Development Notes
@@ -414,9 +621,7 @@ LibreJS @value{VERSION} depends on a number of Node.js-based libraries that
can be installed using the @code{npm} utility:
@verbatim
- $ npm install acorn-loose
- $ npm install jssha
- $ npm install browserify
+ $ npm install acorn-loose jassha browserify
$ export PATH=$PATH:./node_modules/.bin
@end verbatim
@@ -449,16 +654,62 @@ To debug LibreJS, visit the special URL @code{about:debugging}. Click
on `Enable add-on debugging` then `Load Temporary Add-on`. Navigate
to LibreJS's unpacked source directory and select @file{manifest.json}.
-Lines 39 and 40 in @file{main_background.js} assign two variables controlling
-the verbosity of @code{dbg_print()} statements. Make sure these are set to false
-before building a release.
+Lines 39 and 40 in @file{main_background.js} assign two variables
+controlling the verbosity of @code{dbg_print()} statements. Make sure
+these are set to false before building a release.
@section Testing
-An automated test suite runs automatically in its own tab whenever the extension
-is loaded as a "Temporary add-on" from @code{about:debugging}.
-Otherwise (if included in the xpi) it can be launched from the
-UI by clicking the "Automated self test..." button.
+An automated test suite runs automatically in its own tab whenever the
+extension is loaded as a "Temporary add-on" from
+@code{about:debugging}. Otherwise (if included in the xpi) it can be
+launched from the UI by clicking the "Automated self test..." button.
+
+@section Headless testing
+
+To launch the test suite from the command line, ensure the xpi package
+has been built with automated test suite. Then install
+selenium-webdriver and geckodriver, and ensure the latter is in $PATH:
+@verbatim
+ $ npm install selenium-webdriver geckodriver
+ $ export PATH=$PATH:./node_modules/.bin
+@end verbatim
+
+Now you can invoke the test with
+@verbatim
+ $ node ./test.js
+@end verbatim
+
+which will print out a summary of test results.
+
+Optionally you can also test with a chosen seed
+@verbatim
+ $ node ./test.js 12345
+@end verbatim
+
+@section Headless compliance check
+To check whether a webpage is LibreJS-compliant from the command line,
+ensure that the xpi package has been built WITHOUT the automated test
+suite. Then install selenium-webdriver and geckodriver, and ensure the
+latter is in $PATH:
+@verbatim
+ $ npm install selenium-webdriver
+ $ npm install geckodriver
+ $ export PATH=$PATH:./node_modules/.bin
+@end verbatim
+
+Now you can check a webpage for compliance with
+@verbatim
+ $ node ./compliance.js <url>
+@end verbatim
+
+It will open the url in a headless browser, save a screenshot, and
+output the compliance check result.
+
+For example, to check the compliance of the FSF homepage, do
+@verbatim
+ $ node ./compliance.js https://fsf.org
+@end verbatim
@section Adding new whitelisted libraries
diff --git a/docs/version.texi b/docs/version.texi
index bb7a044..24c46c7 100644
--- a/docs/version.texi
+++ b/docs/version.texi
@@ -1,4 +1,4 @@
-@set UPDATED 15 November 2021
-@set UPDATED-MONTH November 2021
+@set UPDATED 18 April 2022
+@set UPDATED-MONTH April 2022
@set EDITION 3
@set VERSION 7.20