Version 0.3.0: testall.cmds mit einem Beispiel pro Befehl

README.md

@@ -62,6 +62,21 @@ whatwill total       Befehle, die zu einem Stichwort passen
 commands             Tabelle aller Befehle
 ```
 
+## Beispiele zu allen Befehlen
+
+`demo/testall.cmds` enthält zu jedem Befehl ein Beispiel mit kurzer Erklärung.
+`testall` führt es in einer Kopie von `demo/` aus und zeigt jede Zeile samt Ausgabe:
+
+```
+testall | less                      alle Beispiele ansehen
+testall > testall.old               Lauf als Vergleich festhalten
+testall | diff testall.old -        später prüfen, was sich geändert hat (mise run testall)
+```
+
+Eine Zeile mit `##` erscheint als Überschrift in der Ausgabe, eine mit `#` ist
+ein stiller Kommentar. Neue Befehle brauchen hier ein Beispiel, sonst schlägt der Test
+`test_testall_mentions_every_command` fehl.
+
 ## Befehle
 
 | Gruppe | Befehle |
@@ -138,7 +153,7 @@ lib/rdb/table.rb   Tabellen und Listen lesen und schreiben
 lib/rdb/fast.rb    Schnellzugriff über Byte-Offsets
 lib/rdb/cmd/*.rb   die Befehle, nach Gruppen
 man/               Man-Pages (troff-Quellen aus den MWC-Archiven)
-demo/              Beispieltabellen, testall.cmds und testall.old
+demo/              Beispieltabellen; testall.cmds = je ein Beispiel pro Befehl, testall.old = letzter Lauf
 test/              Tests
 ```