aboutsummaryrefslogtreecommitdiff
path: root/docs/man.texi
diff options
context:
space:
mode:
authorRuben Rodriguez <ruben@gnu.org>2018-10-15 20:14:25 +0000
committerRuben Rodriguez <ruben@gnu.org>2018-10-15 20:14:25 +0000
commit894b5e913128d59e93b08f7f457200b4a769d2bc (patch)
tree60e7f3951b19dc186c21d417d1d9c24766b617bb /docs/man.texi
parentdcba303f8d172f6748225d2e00f28a44ac13c453 (diff)
parent6fadce1cd8881b2a144be5aaf99966dfd6093860 (diff)
Merge #27 `Update manual to version 7.17.`
Diffstat (limited to 'docs/man.texi')
-rw-r--r--docs/man.texi95
1 files changed, 69 insertions, 26 deletions
diff --git a/docs/man.texi b/docs/man.texi
index 5871315..a9db799 100644
--- a/docs/man.texi
+++ b/docs/man.texi
@@ -111,8 +111,8 @@ it to @email{bug-librejs@@gnu.org}.
You can install LibreJS directly using a generated @file{librejs.xpi}
file, or by building it from source.
-You can also download it from Mozilla, but due to Mozilla's review
-process the download isn't always up to date.
+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.
@node How to Use
@chapter How to Use
@@ -134,15 +134,15 @@ will always get rejected.
It is important to note that this feature recognizes which scripts are
blacklisted and whitelisted based on hash. This means that even a slight
-difference in a script's code will cause it to be recognized as a
-seperate script.
+difference in a script's code will cause it to be recognized as a
+separate script.
-Sometimes, JavaScript will be dynamically generated so that it is
-different every time a website is loaded. These types of scripts cannot
+Sometimes, JavaScript will be dynamically generated so that it is
+different every time a website is loaded. These types of scripts cannot
be whitelisted or blacklisted since they cannot be recognized.
LibreJS has a default whitelist of scripts that are known to be free but
-may not use the format for declaring a license that it can understand.
+may not declare their license in a format that LibreJS can understand.
@section Complaint Feature
@@ -172,20 +172,21 @@ LibreJS add-on preferences in your web browser.
@section Options
@table @dfn
-@item Whitelist
-LibreJS lets you whitelist domain names and subdomains to bypass the
-regular JavaScript check. This might be useful, for example, if you are
-running your own code in a local web server. In order to add a whitelisted
-domain or url, go to Tools >> Add-ons. Inside the add-on window, click on
-@dfn{Extensions}, and in the list, where you see LibreJS, click on the
-@dfn{Preferences} button. You will see an input field labeled @dfn{Whitelist}.
+You can manage LibreJS's preferences either from the extension's entry in your
+browser's Add-ons Manager page (@code{about:addons}) or by clicking the LibreJS
+toolbar icon and then the "Settings..." button on the top right of the popup.
+This will open a panel containing a whitelist/blacklist manager and a section
+to configure your complaints messages to site owners.
-In the field, enter comma-separated domain names. Do not enter the protocol.
-For instance to whitelist all the pages of @url{http://www.gnu.org} and
-@url{https://gnu.org}, enter @samp{gnu.org}. To allow all subdomains from
-gnu.org, enter: @samp{*.gnu.org}. This will match such sites as
-@url{http://savannah.gnu.org} and @url{http://audio-video.gnu.org}.
+@item Whitelist/Blacklist
+
+LibreJS lets you whitelist or blacklist domain names and subdomains, to bypass
+the regular JavaScript checks. This might be useful, for example, if you are
+running your own code in a local web server, or if you don't want to waste
+computing resources on script origins you already know you can't trust. librejs
+provides a lists manager UI to handle both the lists on the top of its Options
+panel.
@item Complaint email subject
Configure the default subject used in complaint emails.
@@ -407,15 +408,57 @@ Many free licenses are listed in this page:
@node LibreJS Development Notes
@chapter LibreJS Development Notes
+@section Dependencies
+
+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
+ $ export PATH=$PATH:./node_modules/.bin
+@end verbatim
+
+@section Building
+
+To build the extension run:
+@verbatim
+ $ browserify main_background.js -o bundle.js
+@end verbatim
+
+To build the extension plus create a .xpi package run:
+@verbatim
+ $ ./build.sh
+@end verbatim
+
+To build the extension including the automated test suite (see TEST below) run:
+@verbatim
+ $ ./build.sh -t
+@end verbatim
+or
+@verbatim
+ $ ./build.sh --test
+@end verbatim
+
+Note: this @file{build.sh} script relies on no new source files being created.
+
@section Debugging
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 34 and 35 in @file{main_background.js} control the printing of
-@code{dbg_print()} statements. Make sure these are set to false in
-releases.
+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.
@section Adding new whitelisted libraries
@@ -431,10 +474,10 @@ place in main_background.js.
Update the version number in manifest.json.
-Make sure debug statements are set to false on lines 34/35 in
+Make sure debug statements are set to false on lines 39/40 in
@file{main_background.js}.
-Then, run the build script @file{build.sh}. This
+Then run the build script @file{build.sh}.
@node Installation Requirements
@appendix Installation Requirements
@@ -447,8 +490,8 @@ LibreJS. It can be installed on the following:
GNU IceCat, Mozilla Firefox, Trisquel Abrowser, Debian Iceweasel.
-LibreJS works on these browsers starting from version 57. We recommend
-that you use the latest version of your Mozilla browser. LibreJS has
+LibreJS works on these browsers starting from version 60. We recommend
+that you use the latest version of your Mozilla browser. LibreJS has
been tested on a GNU/Linux distribution, but it is compatible any
operating system as long as you're using a compatible Mozilla browser.