From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 25 May 2024 10:22:45 +0000 (+0300)
Subject: Improve documentation of 'no-special-glyphs' frame parameter
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c0402e3b42a5c956cb9233822724e1084a082e2d;p=emacs.git

Improve documentation of 'no-special-glyphs' frame parameter

* doc/lispref/frames.texi (Layout Parameters): Document
limitations of support for 'no-special-glyphs' frame parameter.
(Bug#71163)
* doc/lispref/display.texi (Truncation): Update for when
'fringe-mode' is off.

(cherry picked from commit 1bf658366220ce1019721f24d96ef8f82bd18cff)
---

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 39a5bbc106e..abd4ade5931 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -148,7 +148,8 @@ boundary.  @xref{Filling}.
 
    On a graphical display, tiny arrow images in the window fringes
 indicate truncated and continued lines (@pxref{Fringes}).  On a text
-terminal, a @samp{$} in the rightmost column of the window indicates
+terminal, and on a graphical display when @code{fringe-mode} was
+turned off, a @samp{$} in the rightmost column of the window indicates
 truncation; a @samp{\} on the rightmost column indicates a line that
 wraps.  (The display table can specify alternate characters to use
 for this; @pxref{Display Tables}).
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 974def3de10..2686ae93a33 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -1944,10 +1944,16 @@ integer).  @xref{Line Height}, for more information.
 @vindex no-special-glyphs@r{, a frame parameter}
 @item no-special-glyphs
 If this is non-@code{nil}, it suppresses the display of any truncation
-and continuation glyphs (@pxref{Truncation}) for all buffers displayed
-by this frame.  This is useful to eliminate such glyphs when fitting a
-frame to its buffer via @code{fit-frame-to-buffer} (@pxref{Resizing
-Windows}).
+(@pxref{Truncation}) and continuation glyphs for all the buffers
+displayed by this frame.  This is useful to eliminate such glyphs when
+fitting a frame to its buffer via @code{fit-frame-to-buffer}
+(@pxref{Resizing Windows}).  This frame parameter has effect only for
+GUI frames shown on graphical displays, and only if the fringes are
+disabled.  This parameter is intended as a purely-presentation
+feature, and in particular should not be used for frames where the
+user can interactively insert text, or more generally where the cursor
+is shown.  A notable example of frames where this is used is tooltip
+frames (@pxref{Tooltips}).
 @end table