From f2047fdca4f42cf0af568e1d62f286a91cce6d35 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Tue, 22 Mar 2022 19:56:06 +0200 Subject: Fix documentation of the new completion-related features * etc/NEWS: * lisp/minibuffer.el (completion-auto-help): * doc/lispref/text.texi (Special Properties): * doc/emacs/mini.texi (Completion Options): Fix wording of recently added documentation and customization options. --- doc/lispref/text.texi | 25 ++++++++++++++----------- 1 file changed, 14 insertions(+), 11 deletions(-) (limited to 'doc/lispref') diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index edb75b453c8..f76512c5a0b 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi @@ -3541,10 +3541,10 @@ special modes that implement their own highlighting. @item mouse-face @kindex mouse-face @r{(text property)} -This property is used instead of @code{face} when the mouse is on or -near the character. For this purpose, ``near'' means that all text -between the character and where the mouse is have the same -@code{mouse-face} property value. +This property is used instead of @code{face} when the mouse pointer +hovers over the text which has this property. When this happens, the +entire stretch of text that has the same @code{mouse-face} property +value, not just the character under the mouse, is highlighted. Emacs ignores all face attributes from the @code{mouse-face} property that alter the text size (e.g., @code{:height}, @code{:weight}, and @@ -3553,14 +3553,17 @@ unhighlighted text. @item cursor-face @kindex cursor-face @r{(text property)} -This property is similar to @code{mouse-face}, but the face is used if -the cursor (instead of mouse) is on or near the character. Near has -the same meaning that in @code{mouse-face} and the highlighting only -takes effect if the mode @code{cursor-face-highlight-mode} is enabled; -otherwise no highlighting is performed. When the variable +@findex cursor-face-highlight-mode +@vindex cursor-face-highlight-nonselected-window +This property is similar to @code{mouse-face}, but it is used when +point (not the mouse) is inside text that has this property. The +highlighting happens only if the mode +@code{cursor-face-highlight-mode} is enabled. When the variable @code{cursor-face-highlight-nonselected-window} is non-@code{nil}, the -text is highlighted even if the window is not selected that is similar -to @code{highlight-nonselected-windows} for the region. +text with this face is highlighted even if the window is not selected, +similarly to what @code{highlight-nonselected-windows} does for the +region (@pxref{Mark,, The Mark and the Region, emacs, The GNU Emacs +Manual}). @item fontified @kindex fontified @r{(text property)} -- cgit v1.2.1