master 03561b4aad: ; Minor fixes of documentation of double-buffering on MS-Windows

[Eli Zaretskii]

branch: master
commit 03561b4aad87bbc32131e026e253628e8cef9f2f
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; Minor fixes of documentation of double-buffering on MS-Windows
    
    * etc/NEWS: Improve and expand wording of the entry about
    double-buffering on MS-Windows.
    
    * src/w32fns.c (w32_set_inhibit_double_buffering): Fix commentary.
---
 etc/NEWS     | 18 +++++++++++++-----
 src/w32fns.c |  2 +-
 2 files changed, 14 insertions(+), 6 deletions(-)

diff --git a/etc/NEWS b/etc/NEWS
index 5c2f152a12..30882ed2fe 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -2147,11 +2147,19 @@ to preserve the old behavior, apply
 ** MS-Windows
 
 ---
-*** Emacs now supports double buffering on MS Windows to reduce flicker.
-This leads to a noticable reduction in the amount of graphics flicker
-during redisplay on many systems, but can also make painting slower.
-If that happens, it can be disabled by setting the
-'inhibit-double-buffering' frame parameter.
+*** Emacs now supports double-buffering on MS-Windows to reduce display 
flicker.
+(This was supported on Free systems since Emacs 26.1.)
+
+To disable double-buffering (e.g., if it causes display problems), set
+the frame parameter 'inhibit-double-buffering' to a non-nil value.
+You can do that either by adding
+
+   '(inhibit-double-buffering . t)
+
+to 'default-frame-alist', or by modifying the frame parameters of the
+selected frame by evaluating
+
+   (modify-frame-parameters nil '((inhibit-double-buffering . t)))
 
 +++
 *** Emacs now supports system dark mode.
diff --git a/src/w32fns.c b/src/w32fns.c
index fb71fecd95..ead1549d55 100644
--- a/src/w32fns.c
+++ b/src/w32fns.c
@@ -1802,7 +1802,7 @@ w32_set_tool_bar_lines (struct frame *f, Lisp_Object 
value, Lisp_Object oldval)
   w32_change_tool_bar_height (f, nlines * FRAME_LINE_HEIGHT (f));
 }
 
-/* Enable or disable double buffering on F.
+/* Enable or disable double buffering on frame F.
 
    When double buffering is enabled, all drawing happens on a back
    buffer (a bitmap), which is then displayed as a single operation