From: Eli Zaretskii <eliz@gnu.org>
Date: Fri, 29 Jul 2022 10:20:38 +0000 (+0300)
Subject: ; Minor copyedits of documentation related to long-line handling
X-Git-Tag: emacs-29.0.90~1447^2~671
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=01ca1c70aec1db6cbd971a419ca20d89bb7a0099;p=emacs.git

; 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 cd2897cd6dd..6241d5286bd 100644
--- 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 2c889586cd6..8a4cca8434b 100644
--- 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);