        ;; }
 
        {:name "LorenzL",
-        :args [{:name "freq", :default 22050.0}
-               {:name "s", :default 10.0}
-               {:name "r", :default 28.0}
-               {:name "b", :default 2.667}
-               {:name "h", :default 0.05}
-               {:name "xi", :default 0.1}
-               {:name "yi", :default 0.0}
-               {:name "zi", :default 0.0}]
-        :doc "lorenz chaotic generator"}]))
+        :args [{:name "freq", :default 22050.0 :doc "iteration frequency in Hertz"}
+               {:name "s", :default 10.0 :doc "1st variable"}
+               {:name "r", :default 28.0 :doc "2nd variable"}
+               {:name "b", :default 2.667 :doc "3rd variable"}
+               {:name "h", :default 0.05 :doc "integration time stamp"}
+               {:name "xi", :default 0.1 :doc "initial value of x"}
+               {:name "yi", :default 0.0 :doc "initial value of y"}
+               {:name "zi", :default 0.0 :doc "initial value of z"}]
+        :doc "lorenz chaotic generator. A strange attractor discovered by Edward N. Lorenz while studying mathematical models of the atmosphere. The time step amount h determines the rate at which the ODE is evaluated.  Higher values will increase the rate, but cause more instability.  A safe choice is the default amount of 0.05."}]))

       ;; }

       {:name "LinCongN",
        :args [{:name "freq", :default 22050.0}
               {:name "a", :default 1.1}
               {:name "c", :default 0.13}
               {:name "m", :default 1.0}
               {:name "xi", :default 0.0}]
        :doc "a non-interpolating linear congruential chaotic sound generator"}

       ;; LinCongL : LinCongN {}

       {:name "LinCongL" :extends "LinCongN"
        :doc "a linear-interpolating linear congruential chaotic sound generator"}

       ;; LinCongC : LinCongN {}

       {:name "LinCongC" :extends "LinCongN"
        :doc "a cubic-interpolating linear congruential chaotic sound generator"}

       ;; // Standard Map
       ;; StandardN : ChaosGen {

       ;; }

       {:name "CuspN",
        :args [{:name "freq", :default 22050.0 :doc "iteration frequency in Hertz"}
               {:name "a", :default 1.0 :doc "first coefficient"}
               {:name "b", :default 1.9 :doc "2nd coefficient"}
               {:name "xi", :default 0.0 :doc "initial value of x"}]
        :doc "a non-interpolating (cusp map chaotic) sound generator based on the difference equation: xn+1 = a - b*sqrt(|xn|)"}

       ;; CuspL : CuspN {}

       {:name "CuspL" :extends "CuspN"
        :doc "a linear-interpolating (cusp map chaotic) sound generator based on the difference equation: xn+1 = a - b*sqrt(|xn|)"}

       ;; // Gingerbreadman Map
       ;; GbmanN : ChaosGen {
