        ;; }
 
        {: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"}
+        :args [{:name "freq", :default 22050.0 :doc "iteration frequency in Hertz"}
+               {:name "im", :default 1.0 :doc "index multiplier amount"}
+               {:name "fb", :default 0.1 :doc "feedback amount"}
+               {:name "a", :default 1.1 :doc "phase multiplier amount"}
+               {:name "c", :default 0.5 :doc "phase increment amount"}
+               {:name "xi", :default 0.1 :doc "initial value of x"}
+               {:name "yi", :default 0.1 :doc "initial value of y"}]
+        :doc "a non-interpolating feedback sine with chaotic phase indexing sound generator. This uses a linear congruential function to drive the phase indexing of a sine wave.  For im = 1, fb = 0, and a = 1 a normal sinewave results."}
 
        ;; FBSineL : FBSineN {}
 
        {:name "FBSineL" :extends "FBSineN"
-        :doc "a linear-interpolating feedback sine with chaotic phase indexing sound generator"}
+        :doc "a linear-interpolating feedback sine with chaotic phase indexing sound generator. This uses a linear congruential function to drive the phase indexing of a sine wave.  For im = 1, fb = 0, and a = 1 a normal sinewave results."}
 
        ;; FBSineC : FBSineN {}
        {:name "FBSineC" :extends "FBSineN"
-        :doc "a cubic-interpolating feedback sine with chaotic phase indexing sound generator"}
+        :doc "a cubic-interpolating feedback sine with chaotic phase indexing sound generator. This uses a linear congruential function to drive the phase indexing of a sine wave.  For im = 1, fb = 0, and a = 1 a normal sinewave results."}
 
        ;; // ODEs
        ;; // 'h' is integration time-step

       ;; }

       {: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 "StandardN",
        :args [{:name "freq", :default 22050.0 :doc "iteration frequency in Hertz"}
               {:name "k", :default 1.0 :doc "perturbation amount"}
               {:name "xi", :default 0.5 :doc "initial value of x"}
               {:name "yi", :default 0.0 :doc "initial value of y"}]
        :doc "standard map chaotic generator. The standard map is an area preserving map of a cylinder discovered by the plasma physicist Boris Chirikov."}

       ;; StandardL : StandardN {}

       {:name "StandardL" :extends "StandardN"
        :doc "linear-interpolating standard map chaotic generator. The standard map is an area preserving map of a cylinder discovered by the plasma physicist Boris Chirikov."}

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