aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Christian Hesse <mail@eworm.de>2024-01-31 20:52:16 +0100
committerGravatar Christian Hesse <mail@eworm.de>2024-02-02 21:06:11 +0100
commit643f15a0b9d55a8d7dbce2f0cd6280cf7ecdfddb (patch)
tree3f2031fdd02a1aaa5501218b8b5017d842bdf952
parent53b09529a85613e42e9010064856e6b352d34ea1 (diff)
introduce BRANCHES info
-rw-r--r--BRANCHES.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/BRANCHES.md b/BRANCHES.md
new file mode 100644
index 0000000..c431711
--- /dev/null
+++ b/BRANCHES.md
@@ -0,0 +1,43 @@
+Installing from branches
+========================
+
+[⬅️ Go back to main README](README.md)
+
+> ⚠️ **Warning**: Living on the edge? Great, read on!
+> If not: Please use the `main` branch and leave this page!
+
+These scripts are developed in a [git](https://git-scm.com/) repository.
+Development and experimental branches are used to provide early access
+for specific changes. You can install scripts from these branches
+for testing.
+
+## Install single script
+
+To install a single script from `next` branch:
+
+ $ScriptInstallUpdate script-name "url-suffix=?h=next";
+
+## Switch existing script
+
+Alternatively switch an existing script to update from `next` branch:
+
+ /system/script/set comment="url-suffix=?h=next" script-name;
+ $ScriptInstallUpdate;
+
+## Switch installation
+
+Last but not least - to switch the complete installation to the `next`
+branch edit `global-config-overlay` and add:
+
+ :global ScriptUpdatesUrlSuffix "?h=next";
+
+... then reload the configuration and update:
+
+ /system/script/run global-config;
+ $ScriptInstallUpdate;
+
+> ℹ️ **Info**: Replace `next` with *whatever* to use another specific branch.
+
+---
+[⬅️ Go back to main README](README.md)
+[⬆️ Go back to top](#top)