diff --git a/typings/xterm-headless.d.ts b/typings/xterm-headless.d.ts
index 26f970f1..819a46d9 100644
--- a/typings/xterm-headless.d.ts
+++ b/typings/xterm-headless.d.ts
@@ -130,7 +130,8 @@ declare module '@xterm/headless' {
     /**
      * Whether to reflow the line containing the cursor when the terminal is
      * resized. Defaults to false, because shells usually handle this
-     * themselves.
+     * themselves. Note that this will not move the cursor position, only the
+     * line contents.
      */
     reflowCursorLine?: boolean;
 
diff --git a/typings/xterm.d.ts b/typings/xterm.d.ts
index 8e34a00e..ee9a3c35 100644
--- a/typings/xterm.d.ts
+++ b/typings/xterm.d.ts
@@ -200,7 +200,8 @@ declare module '@xterm/xterm' {
     /**
      * Whether to reflow the line containing the cursor when the terminal is
      * resized. Defaults to false, because shells usually handle this
-     * themselves.
+     * themselves. Note that this will not move the cursor position, only the
+     * line contents.
      */
     reflowCursorLine?: boolean;