; Minor copyedits of documentation related to long-line handling

* src/xdisp.c (syms_of_xdisp) <fontification-functions>:
* etc/NEWS: Fix documentation related to long lines.  (Bug#56682)

diff --git a/etc/NEWS b/etc/NEWS
index cd2897cd6ddf44cb1774c5873304ead591661ee0..6241d5286bdcce1b4614d5b57dcd69f602a17eaf 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -355,19 +355,19 @@ option) and can be set to nil to disable Just-in-time Lock mode.
 * Changes in Emacs 29.1
 
 ---
-** Emacs is now capable of editing files with arbitrarily long lines.
-The display of long lines has been optimized, and Emacs no longer
-chokes when a buffer on display contains long lines.  The variable
-'long-line-threshold' controls whether and when these display
+** Emacs is now capable of editing files with very long lines.
+The display of long lines has been optimized, and Emacs should no
+longer choke when a buffer on display contains long lines.  The
+variable 'long-line-threshold' controls whether and when these display
 optimizations are in effect.
 
 If you still experience slowdowns while editing files with long lines,
-this is due to line truncation, or to one of the enabled minor modes,
-or to the current major mode.  Try turning off line truncation with
-'C-x x t', or try disabling all known slow minor modes with 'M-x
-so-long-minor-mode', or try disabling all known slow minor modes and
-the major mode with 'M-x so-long-mode', or visit the file with 'M-x
-find-file-literally' instead of the usual 'C-x C-f'.
+this may be due to line truncation, or to one of the enabled minor
+modes, or to the current major mode.  Try turning off line truncation
+with 'C-x x t', or try disabling all known slow minor modes with
+'M-x so-long-minor-mode', or try disabling both known slow minor modes
+and the major mode with 'M-x so-long-mode', or visit the file with
+'M-x find-file-literally' instead of the usual 'C-x C-f'.
 
 Note that the display optimizations in these cases may cause the
 buffer to be occasionally mis-fontified.

diff --git a/src/xdisp.c b/src/xdisp.c
index 2c889586cd60fa1c4aebf1422a5a15cdd0812b1b..8a4cca8434b5e968f75d4106503cbb4187c84b47 100644 (file)
--- a/src/xdisp.c
+++ b/src/xdisp.c
@@ -36660,10 +36660,10 @@ fontify a region starting at POS in the current buffer, and give
 fontified regions the property `fontified' with a non-nil value.
 
 Note that, when the buffer contains one or more lines whose length is
-above `long-line-threshold', these functions only have access to a
-small portion of the buffer around POS, and cannot use `widen' to gain
-access to other portions of buffer text because the narrowing of the
-buffer is locked (see `narrow-to-region').  */);
+above `long-line-threshold', these functions are called with the buffer
+narrowed to a small portion around POS, and the narrowing is locked (see
+`narrow-to-region'), so that these functions cannot use `widen' to gain
+access to other portions of buffer text.  */);
   Vfontification_functions = Qnil;
   Fmake_variable_buffer_local (Qfontification_functions);