README: Add explanations on scripts

README.md

@@ -7,3 +7,27 @@ To run all scripts, simply execute
 ./install_all
 ```
 
+## Scripts
+
+### enable_jp_locale
+
+Enables the japanese locale on the steamdeck. Useful for learners of japanese that have to interact with e.g. zip archives with japanese characters in file names
+```bash
+LANG=ja_JP 7zz x <zip-archive>
+```
+
+### install_lein
+
+Installs [Leiningen](https://leiningen.org/) for clojure development. I suggest combining this with installing java via [SDKMAN](https://sdkman.io/).
+
+### install_neovim
+
+Installs [neovim](https://neovim.io/) in `${HOME}/bin/nvim`. By default the nightly version is chosen. You may want to install this via `distrobox` in a dedicated development container.
+
+### install_podman-compose
+
+Installs `aardvark-dns` and `podman-compose` for support of docker-compose files.
+
+### install_xclip
+
+Installs xclip, which is useful for copying and pasting in and out of [neovim](https://neovim.io/), [mpv](https://mpv.io/) with stuff like [mpvacious](https://github.com/Ajatt-Tools/mpvacious) etc.

scripts/enable_jp_locale

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-enable_jp_locale() {
+function enable_jp_locale {
     echo "Enabling ja_JP locale..."
     sudo sed -i "s%#ja_JP.UTF-8 UTF-8%ja_JP.UTF-8 UTF-8%" /etc/locale.gen && locale-gen
 }

scripts/install_lein

@@ -1,8 +1,29 @@
 #!/bin/bash
 
-install_lein() {
+function yes_or_no {
-    echo "Installing lein..."
+    while true; do
+        read -p "$* [y/n]: " yn
+        case $yn in
+            [Yy]*) return 0 ;;  
+            [Nn]*) return 1 ;;
+        esac
+    done
+}
+
+function install_lein {
     lein="${HOME}/bin/lein"
+
+    if [ -e ${lein} ]; then
+        lein -v
+        yes_or_no "lein is already installed, do you want to overwrite the existing installation?"
+    fi
+
+    if [ $? -ne 0 ]; then
+        echo "Aborting install of lein."
+        return 0
+    fi
+
+    echo "Installing lein..."
     curl httpis://raw.githubusercontent.com/technomancy/leiningen/stable/bin/lein -o "$lein"
     chmod u+x "$lein"
 }

scripts/install_neovim

@@ -1,9 +1,30 @@
 #!/bin/bash
 
-install_neovim() {
+function yes_or_no {
+    while true; do
+        read -p "$* [y/n]: " yn
+        case $yn in
+            [Yy]*) return 0 ;;  
+            [Nn]*) return 1 ;;
+        esac
+    done
+}
+
+function install_neovim {
+    nvim="${HOME}/bin/nvim"
+
+    if [ -e ${nvim} ]; then
+        nvim -v
+        yes_or_no "nvim is already installed, do you want to overwrite the existing installation?"
+    fi
+
+    if [ $? -ne 0 ]; then
+        echo "Aborting install of neovim."
+        return 0
+    fi
+
     version=${1:-nightly}
     echo "Installing nvim ${version}..."
-    nvim="${HOME}/bin/nvim"
     nvimurl="https://github.com/neovim/neovim/releases/download/${version}/nvim-linux-x86_64.appimage"
     mkdir -p "$(dirname "$nvim")"
     curl -fL "$nvimurl" -o "$nvim" -z "$nvim"

scripts/install_podman-compose

@@ -1,10 +1,10 @@
 #!/bin/bash
 
-install_pip() {
+function install_podman_compose {
     echo "Installing aardvark-dns and podman-compose..."
     sudo pacman -S aardvark-dns podman-compose
 }
 
 sudo steamos-readonly disable
-install_pip
+install_podman_compose
 sudo steamos-readonly enable

scripts/install_xclip

@@ -1,6 +1,6 @@
 #!/bin/bash
 
-install_xclip() {
+function install_xclip {
     echo "Installing xclip..."
     sudo pacman -S xclip
 }