diff --git a/packages/core/controls.mjs b/packages/core/controls.mjs
index 17ff6fd05..7971f1ed9 100644
--- a/packages/core/controls.mjs
+++ b/packages/core/controls.mjs
@@ -1907,12 +1907,18 @@ export const { delayfeedback, delayfb, dfb } = registerControl('delayfeedback',
 export const { delayspeed } = registerControl('delayspeed');
 
 /**
+ * Sets the time of the delay effect in seconds.
+ *
  * @name delaytime
  * @tags orbit, superdough, supradough
- * @param {number | Pattern} delaytime sets the time of the delay effect.
+ * @param {number | Pattern} delay in seconds
  * @synonyms delayt, dt
  * @example
- * note("d d a# a".fast(2)).s("sawtooth").delay(.8).delaytime(1/2).delayspeed("<2 .5 -1 -2>")
+ * note("d d a# a".fast(2))
+ * .s("sawtooth")
+ * .delay(.8)
+ * .delaytime(1/2)
+ * .delayspeed("<2 .5 -1 -2>")
  */
 export const { delaytime, delayt, dt } = registerControl('delaytime', 'delayt', 'dt');