Reworked CLI flags for starting seed in README and WolframAutomata source.

[screensavers] / hacks / WolframAutomata / README.md

diff --git a/hacks/WolframAutomata/README.md b/hacks/WolframAutomata/README.md
index 6bbd56a..d3546d1 100644 (file)
--- a/hacks/WolframAutomata/README.md
+++ b/hacks/WolframAutomata/README.md
@@ -84,23 +84,6 @@ are re-randomized every time the simulation is reset, such as after a
 simulation completes or after resizing the window.
 
 
 simulation completes or after resizing the window.
 
 

-CLI: Simulation Seed
---------------------
-
-If none of the following options are specified, the starting seed will contain
-randomly interspersed active/inactive cells at a 30/70, 50/50, or 70/30 ratio,
-itself also randomly selected.
-
-  - **`-seed-left`**: Seeds a single active cell on the left side of the
-    display. All other cells are inactive.
-
-  - **`-seed-center`**: As above, but in the center.
-
-  - **`-seed-right`**: As above, but on the right side.
-
-  - **`-seed-density N`**: Generates random seed with `N` percent active cells.
-
-

 CLI: Rule Selection
 -------------------
 
 CLI: Rule Selection
 -------------------
 


@@ -114,21 +97,26 @@ from `curated_ruleset_list[]` in `WolframAutomata.c`.
     from 0-255 inclusive are valid.
 
 
     from 0-255 inclusive are valid.
 
 

-CLI: Simulation Speed
----------------------
+CLI: Simulation Seed
+--------------------

 
 

-If neither of the following two options are passed, the simulation runs as
-though `-delay 25000` was passed.
+The following seed related CLI flags apply only when using the
+`-true-random-rule` or `-rule N` flags. Without these flags, the program draws
+rules from `curated_ruleset_list[]` which also includes curated seeds, all of
+which override any seed related CLI flags.

 
 

-  - **`-random-delay`**: A random delay is selected, but not truly random. For
-    more details, read `WolframAutomata.c` starting around the comment, "When
-    randomly setting the delay, the problem is to avoid ..."
+If the curated rule list is not in use and none of the following options are
+specified, the starting seed will contain randomly interspersed active/inactive
+cells at a 30/70, 50/50, or 70/30 ratio, itself also randomly selected.

 
 

-  - **`-delay N`**: Request `N` microsecond delay between each frame/generation
-    of the simulation. Note that this is only a request; XScreensaver reserves
-    the right to ignore requested values, and of course we execute at the mercy
-    of the kernel's scheduling. In practice, non-absurd values are reasonably
-    well respected.
+  - **`-seed-left`**: Seeds a single active cell on the left side of the
+    display. All other cells are inactive.
+
+  - **`-seed-center`**: As above, but in the center.
+
+  - **`-seed-right`**: As above, but on the right side.
+
+  - **`-seed-density N`**: Generates random seed with `N` percent active cells.

 
 
 CLI: Simulation Length
 
 
 CLI: Simulation Length


@@ -149,6 +137,23 @@ generations is cell_size dependent. This is a soft limit and may be increased
 if ..."
 
 
 if ..."
 
 

+CLI: Simulation Speed
+---------------------
+
+If neither of the following two options are passed, the simulation runs as
+though `-delay 25000` was passed.
+
+  - **`-random-delay`**: A random delay is selected, but not truly random. For
+    more details, read `WolframAutomata.c` starting around the comment, "When
+    randomly setting the delay, the problem is to avoid ..."
+
+  - **`-delay N`**: Request `N` microsecond delay between each frame/generation
+    of the simulation. Note that this is only a request; XScreensaver reserves
+    the right to ignore requested values, and of course we execute at the mercy
+    of the kernel's scheduling. In practice, non-absurd values are reasonably
+    well respected.
+
+

 CLI: Cell Dimensions
 --------------------
 
 CLI: Cell Dimensions
 --------------------