57 release

Controls the visibility of the "Options>Privacy & Security>Site Data" section.
I'd prefer to remove this completely because it only adds to the confusion about all the different storage types.
This is just an extension for localStorage (2705) with 3 methods: estimate(), persist() and persisted(). A site can ask for permission (?) to persist data which when granted basically just means that "Storage will not be cleared except by explicit user action" whereas otherwise when not persisted "Storage may be cleared by the UA under storage pressure." - I don't see a problem with that.
We'll keep 2706 inactive for now but might remove it in a future commit.

README.md

@@ -2,7 +2,7 @@
 A `user.js` is a configuration file that can control hundreds of Firefox settings. For a more technical breakdown and explanation, you can read more on the [overview](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.1-Overview) wiki page.
 
 ### ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/bullet01.png) ghacks user.js
-The [ghacks user.js](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/user.js) is a template, which, as provided, aims (![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/exclamation.png) with [add-ons](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-B:-Firefox-Add-ons) <sup>1</sup> ) to provide as much privacy and enhanced security as possible, and to reduce tracking and fingerprinting as much as possible - while minimizing any loss of functionality and breakage (but it will happen).
+The [ghacks user.js](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/user.js) is a template, which, as provided, aims (![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/exclamation.png) with [extensions](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-B:-Extensions) <sup>1</sup> ) to provide as much privacy and enhanced security as possible, and to reduce tracking and fingerprinting as much as possible - while minimizing any loss of functionality and breakage (but it will happen).
 
 We aim to INFORM and give you CHOICES. No one size fits all, so customize it! And not all sites have the same requirements, so use [profiles](https://github.com/ghacksuserjs/ghacks-user.js/wiki/2.3-Concurrent-Profiles) with custom versions. We won't set you wrong.
 
@@ -16,7 +16,7 @@ INFORMATION IS POWER. So you can make informed decisions to better protect yours
 * Current and up-to-date with stable (including [changelogs](https://github.com/ghacksuserjs/ghacks-user.js/search?q=label%3Achangelog&type=Issues&utf8=%E2%9C%93))
 * Detailed (preference versioning, hidden preference information, explanations, and more)
 * Easy to use and discuss (sections, sub-sections, numbering)
-* Helpful (including a [wiki](https://github.com/ghacksuserjs/ghacks-user.js/wiki) with features such as [add-ons](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-B:-Firefox-Add-ons), [user scripts](https://github.com/ghacksuserjs/ghacks-user.js/wiki/3.1-User-Scripts), [references](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-D:-References) and more)
+* Helpful (including a [wiki](https://github.com/ghacksuserjs/ghacks-user.js/wiki) with features such as [extensions](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-B:-Extensions), [user scripts](https://github.com/ghacksuserjs/ghacks-user.js/wiki/3.1-User-Scripts), [references](https://github.com/ghacksuserjs/ghacks-user.js/wiki/Appendix-D:-References) and more)
 * Innovative (formatting, special tags, and future plans such as branches)
 
 ### ![](https://github.com/ghacksuserjs/ghacks-user.js/blob/master/wikipiki/bullet01.png) usage
@@ -26,7 +26,7 @@ Everyone, experts included, should at least read the [implementation](https://gi
 Literally thousands of sources, references and suggestions. That said...
 
 * Martin Brinkmann at [ghacks](https://www.ghacks.net/) <sup>2</sup>
-   * 100% genuine super-nice all-round good guy
+   * 100% genuine super-nice all-around good guy
 * The ghacks community and commentators
    * Special mentions to [earthlng](https://github.com/earthlng), Tom Hawack, Just me, Conker, Rockin’ Jerry, Ainatar, Parker Lewis
 * [12bytes](http://12bytes.org/articles/tech/firefoxgecko-configuration-guide-for-privacy-and-performance-buffs)

scratchpad-scripts/test.js

@@ -0,0 +1 @@
+// boo!

updater.bat

@@ -0,0 +1,107 @@
+@ECHO OFF
+TITLE ghacks user.js updater
+
+REM ### ghacks-user.js updater for Windows
+REM ## author: @claustromaniac
+REM ## version: 2.1
+
+SETLOCAL EnableDelayedExpansion
+SET "_ua="
+SET "_log="
+:parse
+IF "%~1"=="" GOTO endparse
+IF "%~1"=="-unattended" SET "_ua=true"
+IF "%~1"=="-log" SET "_log=true"
+SHIFT
+GOTO parse
+:endparse
+SET "_name="
+SET "_date="
+SET "_version="
+SET /A "_line=0"
+ECHO.
+IF EXIST user.js (
+	FOR /F "delims=" %%i IN (user.js) DO (
+		IF !_line! EQU 1 SET "_name=%%i"
+		IF !_line! EQU 2 SET "_date=%%i"
+		IF !_line! EQU 3 SET "_version=%%i"
+		SET /A "_line+=1"
+		IF !_line! GEQ 4 GOTO break
+	)
+	:break
+	IF !_line! GEQ 4 (
+		IF "ghacks"=="!_name:~8,6!" (
+			FOR /F "delims=:" %%G IN ("!_version!") DO SET "_version=%%G"
+			SET "_version=!_version:~2!"
+			SET "_date=!_date:~8!"
+			ECHO ghacks user.js !_version!, !_date!
+		) ELSE ( ECHO Current user.js version not recognised. )
+	) ELSE ( ECHO Current user.js version not recognised. )
+) ELSE ( ECHO user.js not detected in the current directory. )
+ECHO.
+IF NOT "%_ua%"=="true" (
+	ECHO This batch should be run from your Firefox profile directory. It will download the latest version of ghacks user.js from github and then append any of your own changes from user-overrides.js to it.
+	ECHO.
+	REM ECHO Visit the wiki for more detailed information.
+	REM ECHO.
+	CHOICE /M "Continue"
+	IF ERRORLEVEL 2 GOTO end
+)
+CLS
+ECHO.
+IF "%_log%"=="true" (
+	CALL :log >>user.js-update-log.txt 2>&1 
+	EXIT /B
+	:log
+	ECHO ##################################################################
+	ECHO.
+	ECHO %date%, %time%
+	ECHO.
+)
+IF EXIST user.js (
+	IF EXIST user.js.bak REN user.js.bak user.js.old.bak
+	REN user.js user.js.bak
+	ECHO Current user.js file backed up.
+	ECHO.
+)
+ECHO Retrieving latest user.js file from ghacks github repository...
+powershell -Command "(New-Object Net.WebClient).DownloadFile('https://github.com/ghacksuserjs/ghacks-user.js/raw/master/user.js', 'user.js')" >nul
+ECHO.
+IF EXIST user.js (
+	IF EXIST "user-overrides.js" (
+		ECHO Appending user-overrides.js...
+		ECHO.
+		COPY /B /V /Y user.js+"user-overrides.js" "tempuserjs"
+		DEL /F user.js
+		REN tempuserjs user.js
+		ECHO.
+	)
+	ECHO Handling backups...
+	SET "changed="
+	IF EXIST user.js.bak ( FC user.js.bak user.js >nul && SET "changed=false" || SET "changed=true" )
+	ECHO.
+	ECHO.
+	IF "!changed!"=="true" (
+		IF EXIST user.js.old.bak DEL /F user.js.old.bak
+		ECHO Update complete.
+	) ELSE (
+		IF "!changed!"=="false" (
+			DEL /F user.js.bak
+			IF EXIST user.js.old.bak REN user.js.old.bak user.js.bak
+			ECHO Update completed without changes.
+		) ELSE ECHO Update complete.
+	)
+	ECHO.
+) ELSE (
+	IF EXIST user.js.bak REN user.js.bak user.js
+	IF EXIST user.js.old.bak REN user.js.old.bak user.js.bak
+	ECHO.
+	ECHO Update failed. Make sure PowerShell is allowed internet access.
+	ECHO.
+	ECHO No changes were made.
+	ECHO.
+)
+IF NOT "%_log%"=="true" (
+        IF NOT "%_ua%"=="true" PAUSE
+)
+:end

updater.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+### ghacks-user.js updater for Mac/Linux
+## author: @overdodactyl
+## version: 1.1
+
+ghacksjs="https://raw.githubusercontent.com/ghacksuserjs/ghacks-user.js/master/user.js"
+
+echo -e "\nThis script should be run from your Firefox profile directory.\n"
+
+currdir=$(pwd)
+
+## get the full path of this script (greadlink for Mac, readlink for Linux)
+scriptfullpath=$(greadlink -f "${BASH_SOURCE[0]}" 2>/dev/null || readlink -f "${BASH_SOURCE[0]}")
+
+## change directory to the Firefox profile directory
+cd "$(dirname "${scriptfullpath}")"
+
+echo -e "Updating the user.js for Firefox profile:\n$(pwd)\n"
+
+if [ -e user.js ]; then
+  echo "Your current user.js file for this profile will be backed up and the latest ghacks version from github will take its place."
+  echo -e "\nIf currently using the ghacks user.js, please compare versions:"
+  echo "  Available online: $(curl -s ${ghacksjs} | sed -n '4p')"
+  echo "  Currently using:  $(sed -n '4p' user.js)"
+else
+  echo "A user.js file does not exist in this profile. If you continue, the latest ghacks version from github will be downloaded."
+fi
+
+echo -e "\nIf a user-overrides.js file exists in this profile, it will be appended to the user.js.\n"
+
+read -p "Continue Y/N? " -n 1 -r
+echo -e "\n\n"
+
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+  if [ -e user.js ]; then
+    # backup current user.js
+    bakfile="user.js.backup.$(date +"%Y-%m-%d_%H%M")"
+    mv user.js "${bakfile}" && echo "Your previous user.js file was backed up: ${bakfile}"
+  fi
+
+  # download latest ghacks user.js
+  echo "downloading latest ghacks user.js file"
+  curl -O ${ghacksjs} && echo "ghacks user.js has been downloaded"
+
+  if [ -e user-overrides.js ]; then
+    echo "user-overrides.js file found"
+    cat user-overrides.js >> user.js && echo "user-overrides.js has been appended to user.js"
+  fi
+else
+  echo "Process aborted"
+fi
+
+## change directory back to the original working directory
+cd "${currdir}"