emacs-29 19ef86f775: ; Remove outdated text describing overlays

[Eli Zaretskii]

branch: emacs-29
commit 19ef86f775a39eab46231c3eb6fc702e06857a5a
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    ; Remove outdated text describing overlays
    
    * doc/lispref/display.texi (Overlays): Remove outdated text.
    (Bug#59996)
---
 doc/lispref/display.texi | 12 +-----------
 1 file changed, 1 insertion(+), 11 deletions(-)

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 340aa400cf..13dc228261 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -1462,17 +1462,7 @@ object that belongs to a particular buffer, and has a 
specified
 beginning and end.  It also has properties that you can examine and set;
 these affect the display of the text within the overlay.
 
-@cindex scalability of overlays
-@cindex overlays, scalability
-The visual effect of an overlay is the same as of the corresponding
-text property (@pxref{Text Properties}).  However, due to a different
-implementation, overlays generally don't scale well (many operations
-take a time that is proportional to the number of overlays in the
-buffer).  If you need to affect the visual appearance of many portions
-in the buffer, we recommend using text properties.
-
-An overlay uses markers to record its beginning and end; thus,
-editing the text of the buffer adjusts the beginning and end of each
+Editing the text of the buffer adjusts the beginning and end of each
 overlay so that it stays with the text.  When you create the overlay,
 you can specify whether text inserted at the beginning should be
 inside the overlay or outside, and likewise for the end of the overlay.