diff --git a/packages/xen/xen.mjs b/packages/xen/xen.mjs
index 4ae79fecd..5261c3a36 100644
--- a/packages/xen/xen.mjs
+++ b/packages/xen/xen.mjs
@@ -139,8 +139,8 @@ export const xen = register('xen', function (scaleNameOrRatios, pat) {
  * @example
  * "0 8 18".xen("31edo").ftrans("<8 -8>")
  * @example
- * // if you specify the edoSize, it changes the amount of transposition:
- * "0 8 18".xen("31edo").ftrans("8:12")
+ * // to transpose by steps of an edo, use "step:edo" :
+ * "0 7 8 18".xen("31edo").ftrans("<0 1:31 1:12>")
  * @example
  * // it can also work with frequency values directly
  * "200 300 400".ftrans("<0 7:31 7>").freq()
diff --git a/test/__snapshots__/examples.test.mjs.snap b/test/__snapshots__/examples.test.mjs.snap
index 77d95003b..0bf39ad3f 100644
--- a/test/__snapshots__/examples.test.mjs.snap
+++ b/test/__snapshots__/examples.test.mjs.snap
@@ -4986,18 +4986,22 @@ exports[`runs examples > example "ftranspose" example index 1 1`] = `
 
 exports[`runs examples > example "ftranspose" example index 2 1`] = `
 [
-  "[ 0/1 → 1/3 | freq:349.2282314 ]",
-  "[ 1/3 → 2/3 | freq:417.6327085 ]",
-  "[ 2/3 → 1/1 | freq:522.2770651 ]",
-  "[ 1/1 → 4/3 | freq:349.2282314 ]",
-  "[ 4/3 → 5/3 | freq:417.6327085 ]",
-  "[ 5/3 → 2/1 | freq:522.2770651 ]",
-  "[ 2/1 → 7/3 | freq:349.2282314 ]",
-  "[ 7/3 → 8/3 | freq:417.6327085 ]",
-  "[ 8/3 → 3/1 | freq:522.2770651 ]",
-  "[ 3/1 → 10/3 | freq:349.2282314 ]",
-  "[ 10/3 → 11/3 | freq:417.6327085 ]",
-  "[ 11/3 → 4/1 | freq:522.2770651 ]",
+  "[ 0/1 → 1/4 | freq:220 ]",
+  "[ 1/4 → 1/2 | freq:257.2747684 ]",
+  "[ 1/2 → 3/4 | freq:263.0921203 ]",
+  "[ 3/4 → 1/1 | freq:329.0139341 ]",
+  "[ 1/1 → 5/4 | freq:224.9745158 ]",
+  "[ 5/4 → 3/2 | freq:263.0921203 ]",
+  "[ 3/2 → 7/4 | freq:269.0410108 ]",
+  "[ 7/4 → 2/1 | freq:336.4534115 ]",
+  "[ 2/1 → 9/4 | freq:233.0818808 ]",
+  "[ 9/4 → 5/2 | freq:272.5731222 ]",
+  "[ 5/2 → 11/4 | freq:278.7363919 ]",
+  "[ 11/4 → 3/1 | freq:348.5781207 ]",
+  "[ 3/1 → 13/4 | freq:220 ]",
+  "[ 13/4 → 7/2 | freq:257.2747684 ]",
+  "[ 7/2 → 15/4 | freq:263.0921203 ]",
+  "[ 15/4 → 4/1 | freq:329.0139341 ]",
 ]
 `;