        ;; }
 
        {:name "HenonN",
-        :args [{:name "freq", :default 22050.0}
-               {:name "a", :default 1.4}
-               {:name "b", :default 0.3}
-               {:name "x0", :default 0.0}
-               {:name "x1", :default 0.0}]
-        :doc "a non-interpolating sound generator based on the difference equation:
-x[n+2] = 1 - a*(x[n+1]^)2 + bx[n]"}
+        :args [{:name "freq", :default 22050.0 :doc "iteration frequency in Hertz"}
+               {:name "a", :default 1.4 :doc "1st coefficient"}
+               {:name "b", :default 0.3 :doc "2nd coefficient"}
+               {:name "x0", :default 0.0 :doc "initial value of x"}
+               {:name "x1", :default 0.0 :doc "second value of x"}]
+        :doc "a non-interpolating (henon map chaotic) sound generator based on the difference equation:
+x[n+2] = 1 - a*(x[n+1]^)2 + bx[n]. This equation was discovered by French astronomer Michel Hénon while studying the orbits of stars in globular clusters."}
 
        ;; HenonL : HenonN {}
 
        {:name "HenonL" :extends "HenonN"
-        :doc "a linear-interpolating sound generator based on the difference equation:
-x[n+2] = 1 - a*(x[n+1]^)2 + bx[n]"}
+        :doc "a linear-interpolating (henon map chaotic) sound generator based on the difference equation:
+x[n+2] = 1 - a*(x[n+1]^)2 + bx[n]. This equation was discovered by French astronomer Michel Hénon while studying the orbits of stars in globular clusters."}
 
        ;; HenonC : HenonN {}
 
        {:name "HenonC" :extends "HenonN"
-        :doc "a cubic-interpolating sound generator based on the difference equation:
-x[n+2] = 1 - a*(x[n+1]^)2 + bx[n]"}
+        :doc "a cubic-interpolating (henon map chaotic) sound generator based on the difference equation:
+x[n+2] = 1 - a*(x[n+1]^)2 + bx[n]. This equation was discovered by French astronomer Michel Hénon while studying the orbits of stars in globular clusters."}
 
        ;; // Latoocarfian
        ;; LatoocarfianN : ChaosGen {

       ;; }

       {:name "StandardN",
        :args [{:name "freq", :default 22050.0}
               {:name "k", :default 1.0}
               {:name "xi", :default 0.5}
               {:name "yi", :default 0.0}]
        :doc "standard map chaotic generator"}

       ;; StandardL : StandardN {}

       {:name "StandardL" :extends "StandardN"
        :doc "linear-interpolating standard map chaotic generator"}

       ;; // Feedback Sine with Linear Congruential Phase Indexing
       ;; FBSineN : ChaosGen {

       ;; }

       {:name "GbmanN",
        :args [{:name "freq", :default 22050.0 :doc "iteration frequency in Hz"}
               {:name "xi", :default 1.2 :doc "initial value of x"}
               {:name "yi", :default 2.1 :doc "initial value of y"}]
        :doc "A non-interpolating (gingerbreadman map chaotic) sound generator based on the difference equations:
xn+1 = 1 - yn + |xn|
yn+1 = xn"}

       ;; GbmanL : GbmanN {}

       {:name "GbmanL" :extends "GbmanN"
        :doc "A linear-interpolating (gingerbreadman map chaotic) sound generator based on the difference equations:
xn+1 = 1 - yn + |xn|
yn+1 = xn"}

