From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 16 Jun 2018 11:00:47 +0000 (+0300)
Subject: Fix documentation of ':propertize' in mode-line-format
X-Git-Tag: emacs-26.1.90~353
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=63ba73a9f2bdf75363eea678a8c119ed0ffd9799;p=emacs.git

Fix documentation of ':propertize' in mode-line-format

* doc/lispref/modes.texi (Mode Line Data): Make the description of
':propertize' more accurate.  (Bug#26291)
---

diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index 8a77745d8f7..d7e217c5287 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1839,10 +1839,13 @@ recursion.
 
 @item (:propertize @var{elt} @var{props}@dots{})
 A list whose first element is the symbol @code{:propertize} says to
-process the mode line construct @var{elt} recursively, then add the text
-properties specified by @var{props} to the result.  The argument
+process the mode line construct @var{elt} recursively, then add the
+text properties specified by @var{props} to the result.  The argument
 @var{props} should consist of zero or more pairs @var{text-property}
-@var{value}.
+@var{value}.  If @var{elt} is or produces a string with text
+properties, all the characters of that string should have the same
+properties, or else some of them might be removed by
+@code{:propertize}.
 
 @item (@var{symbol} @var{then} @var{else})
 A list whose first element is a symbol that is not a keyword specifies