From 8b7912a68f5358be6092714616f2ea4c085fd257 Mon Sep 17 00:00:00 2001
From: Malin Freeborn <malinfreeborn@posteo.net>
Date: Fri, 7 Feb 2025 17:07:38 +0100
Subject: [PATCH] extend recfiles example

---
 data/recfiles.md                           | 51 ++++++++++++++++++++++
 data/{Recfiles.md => recfiles/extended.md} | 10 ++---
 2 files changed, 56 insertions(+), 5 deletions(-)
 create mode 100644 data/recfiles.md
 rename data/{Recfiles.md => recfiles/extended.md} (94%)

diff --git a/data/recfiles.md b/data/recfiles.md
new file mode 100644
index 0000000..fe3e1e3
--- /dev/null
+++ b/data/recfiles.md
@@ -0,0 +1,51 @@
+---
+title: "Recfiles"
+tags: [ "data", "database" ]
+---
+
+Create a database of board games:
+
+```bash
+database=games.rec
+touch $database
+
+entry="Name: Vojvodina"
+recins --record "$record" $database
+```
+
+Create, read, update, and delete:
+
+```bash
+for g in Saboter Carcassonne Chess; do
+    recins -r "Name: $g" -r "Played: yes" $database
+done
+
+query=Carc
+recsel --quick=Carc $database
+recsel -q $query $database
+
+query=sabat
+recsel --case-insensitive -q "$query" --print=Name $database
+
+query=chess
+recsel -i -q "$query" -p Name $database
+
+new_field=Played
+value=no
+
+recset -f "$new_field" --set-add="$value" $database
+recsel $database
+
+value=yes
+recset -iq $query -f "$new_field" --set=$value $database
+
+recset -f "$new_field" --delete $database
+recsel $database
+```
+
+- [Extended example](recfiles/extended.md)
+
+# Resources
+
+- [Recfiles for gemini capsules](gemini://tilde.town/~dozens/gemlog/21.gmi)
+
diff --git a/data/Recfiles.md b/data/recfiles/extended.md
similarity index 94%
rename from data/Recfiles.md
rename to data/recfiles/extended.md
index 1191f17..eb0310c 100644
--- a/data/Recfiles.md
+++ b/data/recfiles/extended.md
@@ -1,6 +1,6 @@
 ---
-title: "Recfiles"
-tags: [ "data", "database" ]
+title: "Recfiles Extended Example"
+tags: [ "data", "database", "recfiles" ]
 ---
 
 ## Create
@@ -10,11 +10,10 @@ Make a database for your boardgames, specifying only one field and value:
 ```bash
 database=games.rec
 n=Name
-v=Vojvodina
+g=Vojvodina
 touch $database
-recins -f $n -v v $database
+recins -f $n --value $g $database
 recsel $database
-
 ```
 
 Insert a few more, with the estimated playtime:
@@ -116,3 +115,4 @@ Delete an entire record:
 num=2
 recdel --number=$num $database
 ```
+