From 479c77a44ed3bae36cc61caf40cf8759fb42dc36 Mon Sep 17 00:00:00 2001
From: xengineering <me@xengineering.eu>
Date: Fri, 5 Aug 2022 18:23:22 +0200
Subject: Write install section in README

---
 README.txt | 29 ++++++++++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/README.txt b/README.txt
index 1a20745..edb060e 100644
--- a/README.txt
+++ b/README.txt
@@ -4,4 +4,31 @@
 scripts
 -------
 
-Some useful scripts.
+This repository contains some useful scripts.
+
+
+Installation
+------------
+
+You can just download one of the scripts or clone the repository to use them
+like any other script.
+
+Personally I like to pseudo-install them under my `/home` directory. For this
+purpose I first have to extend my `$PATH` environment variable with the
+location for personal scripts which is standardized by the cross desktop group
+(XDG). For this purpose I add this to my `~/.bashrc` file:
+
+	PATH=~/.local/bin:$PATH
+
+Then I clone this repository:
+
+	cd ~/.local/bin
+	git clone https://cgit.xengineering.eu/scripts
+
+And finally I link the scripts I need on this machine via symbolic links:
+
+	ln -s ./scripts/url.sh url
+
+The result is that I can call e.g. the `url.sh` script from any location just
+by typing `url`. I can also add machine-specific script in the `~/.local/bin`
+folder or rename the `url.sh` script via a different name in the symlink.
-- 
cgit v1.2.3-70-g09d2