Tidy up documentation, disable logging

README.md

@@ -1,17 +1,24 @@
-A LOoper
+# A LOoper
 
-This is an LV2 plugin primarily targeted at the MOD Duo but hopefully it should
+ALO is an LV2 plugin primarily targeted at the MOD Duo but hopefully it should
 work on other systems too. It's based on the amp.c and metro.c lv2 example
 plugins, plus some study of the loopor code.
 
-The idea is to provide a mistake-proof way of creating and triggering live
-music loops in sync with a click track. There's only one button, one loop.
-Loop start/end is based on what's played, so the timing of the button hit
-isn't critical.
+The idea is to provide an easy, mistake-proof way to create and trigger live
+music loops in sync with a click track.
 
-The click/sync is assumed to be generated by something else (I'm using the
-Simple Step Sequencer by x42): alo synchronises with midi beats/bars.
+- All loops are off (but being recorded in the background) by default.
 
+- Each loop is activated and deactivated by one button.
+
+- Loop start/end is based on the music you play at the input, so your timing
+of the button hit isn't critical.
+
+- To reset a loop so you can re-record it, double-press its button while the
+loop is off.
+
+The click/sync track is assumed to be generated by something else (e.g.
+Simple Step Sequencer by x42): alo synchronises with atom time beats/bars.
 
 ## design notes
 ```
@@ -51,16 +58,24 @@ _______/<<^^^^^^^^^^^^^^^^^^^\____________________________  audio in
 docker run -ti --name mpb -p 9000:9000 -v ~/Projects/2018/moddevices/:/tmp/aloo-lv2 moddevices/mod-plugin-builder
 
 ## build notes
+```
 cd /home/builder/mod-plugin-builder
 rm -fr  /home/builder/mod-plugin-builder/plugins/package/alo
 cp -r /tmp/moddevices/alo /home/builder/mod-plugin-builder/plugins/package
 rm -fr /home/builder/mod-workdir/plugins-dep/build/alo* && ./build alo
-
+```
 ## deploy notes
-cd /home/builder/mod-workdir/plugins && tar cz alo.lv2 | base64 | curl -F 'package=@-' http://192.168.51.1/sdk/install
 
+```
+cd /home/builder/mod-workdir/plugins && tar cz alo.lv2 | base64 | curl -F 'package=@-' http://192.168.51.1/sdk/install
+```
 ## debug notes
-tail -f /root/alo.log
+
+edit the code to set `LOG_ENABLED = true`
+
+```
+tail -f /root/alo.log`
 
 mod-host -p 1234 -i
 add http://devcurmudgeon.com/alo 0
+````

source/alo.c

@@ -68,7 +68,7 @@ typedef enum {
 
 static const size_t STORAGE_MEMORY = 2880000;
 static const int NUM_LOOPS = 6;
-static const bool LOG_ENABLED = true;
+static const bool LOG_ENABLED = false;
 
 void log(const char *message, ...)
 {

source/alo.lv2/alo.ttl

@@ -11,7 +11,7 @@
 <http://devcurmudgeon.com/alo>
 	a lv2:Plugin, lv2:UtilityPlugin;
 	lv2:project <http://lv2plug.in/ns/lv2>;
-	doap:name "Alo";
+	doap:name "ALO";
 	doap:license <http://opensource.org/licenses/isc>;
 	lv2:port
 		[