tmhglnd
diff --git a/‎docs/04-fx.md‎
Lines changed: 27 additions & 12 deletions b/‎docs/04-fx.md‎
Lines changed: 27 additions & 12 deletions
@@ -27,9 +27,8 @@ gain (the volume of the sound)
 | >-----------------------> v
 panning                     hall (stereo reverb)
 ||                          ||
-double                      ||
-(automated double tracking  ||
-/chorus)                    ||
+double / chorus             ||
+||                          ||
 ||  <====================== <<
 lfo 
 (low frequency oscillator)
@@ -121,6 +120,30 @@ You can provide extra arguments to have the filter modulate between a low and hi
 new synth saw note(0 0) fx(filter low 1/4 100 3500 0.55 0 4)
 ```
 
+## double / chorus
+
+Add an Automated-Double-Tracking (ADT) or Chorus effect to the sound. When only typing double it will sound like two versions of the sound are left and right. When typing chorus the original sound is added and the delaytimes are longer. Arguments are the modulation speed in division, the modulation depth in milliseconds, the modulation wave `sine` or `random`, the wet-dry ratio between `0` and `1` and a detune factor between left and right modulation wave in floating.
+
+**arguments**
+- {Division} -> modulation rate (default=4/1)
+- {Number+} -> modulation depth in ms (default=8 for double, default=45 for chorus)
+- {Name} -> modulation wave, sine or random (default=random)
+- {Float+} -> wet-dry (default=1 for double, default=0 for chorus)
+- {Float+} -> modulation rate detune (default=0.94562)
+
+```
+fx(double)
+fx(chorus)
+fx(chorus <rate>)
+fx(chorus <rate> <depth> <wave> <wet-dry> <detune>)
+```
+
+```java
+new sample clap_808 fx(double)
+
+new synth saw fx(chorus 5/1 45 sine 0.5 0.99873)
+```
+
 ## freeze
 
 Create an FFT-freeze effect on the sound. This will result in a "frozen-in-time"-like sound, where the timbre is still clearly audible. The freezer is triggered at the time interval of the `time()` function. The trigger can be set with a float to give it a probability of triggering, or a ring can be provided to let the freezing occor in a rhythmic pattern. The second optional argument determines the sliding time between 2 freeze frames (in n-frames), and the third optional argument sets the amount of frames to store.
@@ -211,12 +234,4 @@ Add an Low Frequency Oscillator effect to the sound.
 
 ```
 fx(lfo <time-division>)
-```
-
-## double
-
-Add an Automated-Double-Tracking (ADT) effect to the sound. This will give the effect as if there were two of the same sounds, one left and one right.
-
-```
-fx(double)
-```
+```