Usage documentation in Bedbugs.rule

diff --git a/src/Bedbugs.rule.template b/src/Bedbugs.rule.template
index 12b48116154252991100155f16e7032ca02dd77e..a19770274979dd6b075f2f2a9db0be15dc5ab70b 100644 (file)
--- a/src/Bedbugs.rule.template
+++ b/src/Bedbugs.rule.template
@@ -1,7 +1,29 @@
 @RULE Bedbugs
-Bedbugs: standard Conway life with complication to use Bedstead rendering
-Alternates between Conway propagation and Bedsteadisation
-2 states for Conway -> 32 states (16x2) for Bedstead -> 2 etc.
+
+Standard Conway life with smoothing inspired by the Mullard SAA5050
+character generator (aka BBC "MODE 7").
+
+Alternately applies a smoothing transition function and the standard
+Conway transition function, so every step of Conway takes twice as
+long. This two-step nature means this is a bit fiddly to use:
+  set View > Show Cell Icons;
+  set Control > Set Base Step to 2;
+  press '+' to set the step to 2^1;
+  draw your pattern using states 0 and 1;
+  press 'Space' to perform a single step and apply the smoothing;
+  then press 'Tab' for every Conway step you want, doing 2 steps at
+    once and only displaying the smoothed version.
+
+Editing should only be done in the 2-state phase; mixing smoothed and
+unsmoothed states will probably confuse the current rules.
+
+If you zoom out beyond the point where icons are displayed, everything
+gets blobby as smoothed 'off' cells are currently displayed; you'll
+probably want to turn icons off again.
+
+The smoothing algorithm comes from Ben Harris' "Bedstead" font generator,
+<http://bjh21.me.uk/bedstead/>. The idea of applying it to cellular
+automata is due to Simon Tatham. Implementation is by Jacob Nevins.
 
 @TABLE
 n_states:34