        ;; }
 
        {: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 "FBSineN",
        :args [{:name "freq", :default 22050.0}
               {:name "im", :default 1.0}
               {:name "fb", :default 0.1}
               {:name "a", :default 1.1}
               {:name "c", :default 0.5}
               {:name "xi", :default 0.1}
               {:name "yi", :default 0.1}]
        :doc "a non-interpolating feedback sine with chaotic phase indexing sound generator"}

       ;; FBSineL : FBSineN {}

       {:name "FBSineL" :extends "FBSineN"
        :doc "a linear-interpolating feedback sine with chaotic phase indexing sound generator"}

       ;; FBSineC : FBSineN {}
       {:name "FBSineC" :extends "FBSineN"
        :doc "a cubic-interpolating feedback sine with chaotic phase indexing sound generator"}

       ;; // ODEs
       ;; // 'h' is integration time-step

       ;; }

       {: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"}

