diff --git a/doc/builtin.jax b/doc/builtin.jax
index 63f3a0936..81f858182 100644
--- a/doc/builtin.jax
+++ b/doc/builtin.jax
@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Nov 14
+*builtin.txt*	For Vim バージョン 9.1.  Last change: 2024 Nov 18
 
 
 		VIMリファレンスマニュアル    by Bram Moolenaar
@@ -3788,8 +3788,13 @@ getbufvar({buf}, {varname} [, {def}])				*getbufvar()*
 getcellpixels()						*getcellpixels()*
 		端末のセルのピクセルサイズの |List| を返す。
 		リストの形式は [xpixels, ypixels] である。
-		Unix (の端末) でのみ動作する。gVim の場合や他のシステムの場合
-		および失敗した場合は [] を返す。
+
+		Unix (端末と gVim) および Windows (gVim のみ) でのみ動作する。
+		他のシステムまたは失敗した場合は [] を返す。
+		Note 端末によって異なる場合があることに注意。macOS では、シス
+		テムの Terminal.app はポイント単位でサイズを返す (Retina スケー
+		リング前)。一方、サードパーティの端末は生のピクセルサイズを返
+		す (Retina スケーリング後)。
 
 		戻り値の型: list<any>
 
diff --git a/en/builtin.txt b/en/builtin.txt
index ab6368198..e763da065 100644
--- a/en/builtin.txt
+++ b/en/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt*	For Vim version 9.1.  Last change: 2024 Nov 14
+*builtin.txt*	For Vim version 9.1.  Last change: 2024 Nov 18
 
 
 		  VIM REFERENCE MANUAL	  by Bram Moolenaar
@@ -3790,8 +3790,13 @@ getbufvar({buf}, {varname} [, {def}])				*getbufvar()*
 getcellpixels()						*getcellpixels()*
 		Returns a |List| of terminal cell pixel size.
 		List format is [xpixels, ypixels].
-		Only works on (terminal) Unix.  For gVim, on other systems and
-		on failure returns [].
+
+		Only works on Unix (terminal and gVim) and Windows (gVim only).
+		Returns [] on other systems or on failure.
+		Note that there could be variations across different terminals.
+		On macOS, system Terminal.app returns sizes in points (before
+		Retina scaling), whereas third-party terminals return raw pixel
+		sizes (post Retina scaling).
 
 		Return type: list<any>