docs(cursor): explain outline alignment and Linux density scope

src/platform/linux.rs

@@ -35,6 +35,10 @@ use std::{
 use terminfo::{capability as cap, Database};
 use wallpaper;
 
+// Scope density lookup to Flutter host builds to preserve legacy capture
+// behavior. These builds include density in cursor IDs to refresh on DPI
+// changes; non-Flutter builds retain original IDs and unknown density.
+// This gate describes the host binary, not the connected controller's UI.
 #[cfg(feature = "flutter")]
 mod cursor;
 

src/platform/windows.cc

@@ -413,6 +413,8 @@ extern "C"
     {
         auto in = in0;
         auto out0_end = out0 + out0_size;
+        // The output adds a pixel on each side; place the source at (1, 1)
+        // using the padded stride to match the caller's hotspot +1 adjustment.
         auto offset = (width + 2) * 4 + 4;
         auto out = out0 + offset;
         for (int y = 0; y < height; y++)