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 39a5bbc106eff7db2d4c98dcbfeccce1ce7d4add..abd4ade593140793499375ff8c915db68470a08b 100644 (file)
--- 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 974def3de103744af358a5ce0f2f4d4eccab8c87..2686ae93a332e8961dca77a50e57585c3af2c9f1 100644 (file)
--- 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