From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 16 Dec 2023 19:21:33 +0000 (+0200)
Subject: Improve documentation of text properties handling when yanking
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=f68f3500236bb18b92e4b1a2c0c1b4ede528046e;p=emacs.git

Improve documentation of text properties handling when yanking

* doc/lispref/text.texi (Text Properties): Mention special
handling of text properties while yanking.
---

diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi
index 8fa2100ba11..9759d46ee69 100644
--- a/doc/lispref/text.texi
+++ b/doc/lispref/text.texi
@@ -2945,7 +2945,10 @@ character.
 
   Copying text between strings and buffers preserves the properties
 along with the characters; this includes such diverse functions as
-@code{substring}, @code{insert}, and @code{buffer-substring}.
+@code{substring}, @code{insert}, and @code{buffer-substring}.  Killing
+and then yanking text (@pxref{The Kill Ring}) also preserves the
+properties, except that some properties are handled specially and
+might be removed when text is yanked; @pxref{Yanking}.
 
 @menu
 * Examining Properties::   Looking at the properties of one character.