expand readme usage example

README.md

@@ -8,7 +8,19 @@ The Linux Knowledge-Base provides quick-start guides for working with terminal p
 
 Install `make`, `recutils`, and any fuzzy-finder (i.e. `sk`, `fzy`, or `fzf`).
 
-Usage: `make`
+## Usage
+
+
+```sh
+make
+make database
+
+recsel db.rec -q database
+recsel db.rec -q gpg
+recsel db.rec -e "title = 'ssh'"
+recsel db.rec -e "title ~ 'ssh'"
+recsel db.rec -e "title ~ 'bash'" -R title,wordcount
+```
 
 # Style
 

basics/Joyous_ASCII.md

@@ -6,7 +6,20 @@ tags: [ "fun" ]
 - `asciiquarium`
 - `cbonsai -lim "$(fortune)"`
 
-```bash
+```sh
 cow=$(cowsay -l | sort -R | head  -1)
 fortune -s | figlet | cowsay -nf $cow | lolcat
 ```
+
+Watch the [Collatz Conjecture](https://en.wikipedia.org/wiki/Collatz_conjecture) collapse:
+
+```sh
+x="$(du -sc ~/.cache | tr -d '[:alpha:]' | tail -1)"
+until [ "$x" -eq "1" ]; do
+    test "$(( x % 2 ))" -eq 0 && x=$(( x / 2 )) || \
+        x=$(( x * 3 + 1 ))
+    clear -x
+    figlet "$x" | lolcat
+    sleep 1
+done
+```

basics/basics.md

@@ -342,11 +342,12 @@ apt install $PROGRAM
 
 Remove `lolcat`, because it's useless:
 
-```bash
+```sh
 sudo apt remove lolcat
 ```
 
-... and that's pretty much it.  You can move, create, destroy, install things, and look things up.
+...and that's pretty much it.
+You can move, create, destroy, install things, and look things up.
 
 # Review
 

data/gpg/extras.md

@@ -1,6 +1,7 @@
 ---
 title: "gpg"
 tags: [ "vim", "data", "GPG" ]
+requires: [ "GPG Basics", "vim basics" ]
 ---
 
 The `vim-gnupg` plugin lets vim edit gpg-encrypted files as if they were unencrypted.

data/recfiles/Board_Games.md

@@ -1,6 +1,7 @@
 ---
-title: "Board Games"
+title: "Board Games with Recfiles"
 tags: [ "data", "recfiles", "games" ]
+requires: "Recfiles"
 ---
 
 You can play with a board games database from boardgamegeek.com.