Git/firefox-user.js
1
0
Fork 0
mirror of https://github.com/arkenfox/user.js.git synced 2025-02-16 20:11:15 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated 3.1 Overrides (markdown)

Thorin-Oakenpants 2022-01-30 10:44:29 +00:00
parent 1d8e1a3938
commit f48da4a50d
1 changed files with 4 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
3.1-Overrides.md

@ -1,12 +1,12 @@
🟩 Previous: [Backup](https://github.com/arkenfox/user.js/wiki/2.2-Backup)
🟥 Summary: **Everyone will need some "overrides" in a `user-overrides.js`**. Directly modifying arkenfox's contents is not recommended
🟥 Summary: **Everyone will need some "overrides" in a `user-overrides.js`**. Directly modifying arkenfox's contents is not recommended.
---
Arkenfox flips 140+ prefs. With that, you will get some inconvenience and breakage. Everybody's mileage and threat model will differ - **EVERYONE** will need some "overrides". You do this by keeping them in a separate `user-overrides.js` file in your profile folder, so updating doesn't wipe them but instead appends them.
Remember how a user.js applies prefs in the order they are written? So if a pref was listed a second time, then the second value (yours) would override the first (arkenfox's)
Remember how a user.js applies prefs in the order they are written? So if a pref was listed a second time, then the second value (yours) would override the first (arkenfox's).
🔹 user.js (live arkenfox)
```js
@ -19,7 +19,7 @@ user_pref("pref.name.example", "purple")
user_pref("pref.name.example", "green") // I like green
```
The updater gets the current live arkenfox <sup>1</sup> and appends your overrides, and then it compares that to the current user.js in your profile. If it's different, it replaces it. In this example, Firefox will apply the value of `green` when Firefox is started
The updater gets the current live arkenfox <sup>1</sup> and appends your overrides, and then it compares that to the current user.js in your profile. If it's different, it replaces it. In this example, Firefox will apply the value of `green` when Firefox is started.
🔹 user.js (yours after updater runs)
```js
@ -29,7 +29,7 @@ user_pref("pref.name.example", "purple")
user_pref("pref.name.example", "green") // I like green
```
<sup>1</sup> Arkenfox changes to the live master happen once per release: all changes are done in a separate branch and only merged when finished
<sup>1</sup> Arkenfox changes to the live master happen once per release: all changes are done in a separate branch and only merged when finished.
---