From 4902e24069b01891d15b72ee1b7fa0d39ca99e27 Mon Sep 17 00:00:00 2001
From: Michel <m@dh>
Date: Mon, 6 May 2024 15:56:45 +0200
Subject: [PATCH] docs: update

---
 .README.md | 62 ++++++++++++++++++++++++++++++++++++------------------
 .zshrc     |  3 ++-
 2 files changed, 44 insertions(+), 21 deletions(-)

diff --git a/.README.md b/.README.md
index 4701dbe..0528b55 100644
--- a/.README.md
+++ b/.README.md
@@ -3,10 +3,10 @@
 
 Recommended installation order:
 
-- [System Config](#syscfg)
 - [Debian packages](#debian)
-- [Qubes proxy scripts](#qubes)
 - [dotfiles](#dotfiles)
+- [System Config](#syscfg)
+- [Qubes proxy scripts](#qubes)
 - [ASDF](#asdf) & plugins
 - [Newer Debian packages](#versions_check)
 - [Fonts](#fonts)
@@ -48,14 +48,11 @@ git apply --stat --apply 2604.patch
   - check _Limit outgoing connections_;
   - check _Allow full access for 25 minutes_.
 
-## System Config {#syscfg}
-
-- [SysRq](https://www.kicksecure.com/wiki/SysRq)
-
 ## Debian Packages {#debian}
 
 ```sh
 apt install --no-install-recommends \
+  aptitude \
   curl fd-find fzf git grc ripgrep \
   vim-nox vim-tiny- wget xdg-utils \
 
@@ -70,15 +67,6 @@ dpkg-divert --rename --divert /usr/share/zsh-autosuggestions/disabled \
                               /usr/share/zsh-autosuggestions/zsh-autosuggestions.zsh
 ```
 
-## Qubes proxy scripts {#qubes}
-
-```sh
-export ALL_PROXY=127.0.0.1:8082
-chmod +x $HOME/bin/*-proxy
-```
-
-TODO: Insert random part in filenames.
-
 ## dotfiles — Bare Git Repository {#dotfiles}
 
 - <https://www.atlassian.com/git/tutorials/dotfiles>
@@ -116,6 +104,10 @@ dotfiles checkout ${BRANCH} 2>&1 | egrep "\s+" | awk {'print $1'} |
   xargs -I{} sh -c "mkdir -p \$(dirname ${BKDIR}{}); mv -iv {} ${BKDIR}{}";
 
 dotfiles checkout ${BRANCH}
+
+for file in ${BKDIR%/}/*(D); {
+  ls -lh ${file} ./${file#${BKDIR}}; read;
+  vimdiff ${file} ./${file#${BKDIR}} }
 ```
 
 When the `fetch` configuration is not set, insert the following line in the
@@ -129,7 +121,8 @@ _remote_ section of `.dotfiles/config`:
 
 ```sh
 sudo mkdir -p /etc/skel/.dotfiles
-sudo chown $(whoami) /etc/skel
+sudo chown $(whoami) /etc/skel /etc/skel/.dotfiles
+sudo chown $(whoami) -R /etc/skel/.config
 
 git clone --bare $(dotfiles remote -v | head -1 | cut -f2 | cut -f1 -d' ') /etc/skel/.dotfiles
 
@@ -149,18 +142,43 @@ skelfiles checkout
 lazygit --git-dir=$HOME/.dotfiles --work-tree=$HOME
 ```
 
+## System Config {#syscfg}
+
+- [SysRq](https://www.kicksecure.com/wiki/SysRq)
+- `sudo cp -aiv ~/.aptitude /root`
+
+## Qubes proxy scripts {#qubes}
+
+```sh
+chmod +x $HOME/bin/*-proxy
+
+export ALL_PROXY=127.0.0.1:8082
+source ~/.zshrc
+```
+
+TODO: Insert random part in filenames.
+
 ## ASDF & main plugins {#asdf}
 
 `.zshrc` will install `asdf`.
 
-Make sure you have the required [system dependencies](https://github.com/pyenv/pyenv/wiki#suggested-build-environment)
-before installing/compiling Python.
+Before installing/compiling Python, make sure you have the required
+[system dependencies](https://github.com/pyenv/pyenv/wiki#suggested-build-environment).
 
 ```sh
-sudo apt install --no-install-recommends XXX
+sudo apt install --no-install-recommends \
+  build-essential libssl-dev zlib1g-dev \
+  libbz2-dev libreadline-dev libsqlite3-dev curl \
+  libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
 
 asdf plugin add direnv
+asdf install direnv latest
+asdf direnv setup --version latest
+asdf global direnv latest
+
 asdf plugin add python
+
+for Plugin in $(asdf plugin list); { echo $Plugin; asdf list $Plugin }
 ```
 
 ## Newer Debian packages {#versions_check}
@@ -168,10 +186,12 @@ asdf plugin add python
 ```sh
 cd ~/bin
 asdf current
+asdf local direnv latest
 asdf install
 direnv allow
 python -m pip install -r requirements.txt
 
+cd ~/Downloads
 versions_check
 
 wget-proxy https://...
@@ -181,7 +201,7 @@ dpkg -i *.deb
 ## Fonts {#fonts}
 
 - [JetBrains Mono](https://www.jetbrains.com/lp/mono/)
-  - Install the files **without** “NL” (No Ligatures) in their names
+  - Choose files **without** “NL” (No Ligatures) in their names
 
 - [Nerd Fonts](https://www.nerdfonts.com/)
   - [Download](https://github.com/ryanoasis/nerd-fonts/tags)
@@ -211,7 +231,9 @@ See also [How to install and manage fonts on Linux](https://linuxconfig.org/how-
 ```
 
 ```sh
+sudo mkdir -p /opt/fonts
 sudo mv folder /opt/fonts
+sudo chown root:root -R /opt/fonts
 fc-cache -fv /opt/fonts
 ```
 
diff --git a/.zshrc b/.zshrc
index d524b1a..d9dce09 100644
--- a/.zshrc
+++ b/.zshrc
@@ -50,7 +50,8 @@ typeset -U path fpath
 ### ASDF & direnv
 #
 if [[ -e "${XDG_CONFIG_HOME}/asdf-direnv/zshrc" ]]; then
-  source "${XDG_CONFIG_HOME}/asdf-direnv/zshrc"
+  # Don't modify next line, it is searched by "direnv s$etup"
+  source "${XDG_CONFIG_HOME:-$HOME/.config}/asdf-direnv/zshrc"
 else
   echo "asdf: direnv plugin not set!"
   # asdf plugin add direnv