From f68f3500236bb18b92e4b1a2c0c1b4ede528046e Mon Sep 17 00:00:00 2001
From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 16 Dec 2023 21:21:33 +0200
Subject: [PATCH] Improve documentation of text properties handling when
 yanking

* doc/lispref/text.texi (Text Properties): Mention special
handling of text properties while yanking.
---
 doc/lispref/text.texi | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

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.
-- 
2.39.5