diff --git a/USAGE.md b/USAGE.md
index b60a813ba..6ee6d7d2e 100644
--- a/USAGE.md
+++ b/USAGE.md
@@ -3341,8 +3341,9 @@ typedef struct ncvgeom {
 
 // all-purpose ncvisual geometry solver. one or both of 'nc' and 'n' must be
 // non-NULL. if 'nc' is NULL, only pixy/pixx will be filled in, with the true
-// pixel geometry of 'n'. if 'n' is NULL, only cdimy/cdimx, blitter, and (if
-// applicable) maxpixely/maxpixelx are filled in.
+// pixel geometry of 'n'. if 'n' is NULL, only cdimy/cdimx, blitter,
+// scaley/scalex, and maxpixely/maxpixelx are filled in. cdimy/cdimx and
+// maxpixely/maxpixelx are only ever filled in if we know them.
 int ncvisual_geom(const struct notcurses* nc, const struct ncvisual* n,
                   const struct ncvisual_options* vopts, ncvgeom* geom);
 
diff --git a/include/notcurses/notcurses.h b/include/notcurses/notcurses.h
index 5a5ef598d..919048120 100644
--- a/include/notcurses/notcurses.h
+++ b/include/notcurses/notcurses.h
@@ -2922,8 +2922,7 @@ typedef struct ncvgeom {
 // all-purpose ncvisual geometry solver. one or both of 'nc' and 'n' must be
 // non-NULL. if 'nc' is NULL, only pixy/pixx will be filled in, with the true
 // pixel geometry of 'n'. if 'n' is NULL, only cdimy/cdimx, blitter,
-// scaley/scalex, and maxpixely/maxpixelx are filled in; this is the same as
-// calling with a NULL 'n' and a default 'vopts'. cdimy/cdimx and
+// scaley/scalex, and maxpixely/maxpixelx are filled in. cdimy/cdimx and
 // maxpixely/maxpixelx are only ever filled in if we know them.
 API int ncvisual_geom(const struct notcurses* nc, const struct ncvisual* n,
                       const struct ncvisual_options* vopts, ncvgeom* geom)