runtime(doc): clarify when text properties are cleared
related: #15030
Signed-off-by: Christian Brabandt <cb@256bit.org>
diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index ff7078e..9eab164 100644
--- a/runtime/doc/builtin.txt
+++ b/runtime/doc/builtin.txt
@@ -1,4 +1,4 @@
-*builtin.txt* For Vim version 9.1. Last change: 2024 Jun 14
+*builtin.txt* For Vim version 9.1. Last change: 2024 Jun 17
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -9485,7 +9485,8 @@
setline({lnum}, {text}) *setline()*
Set line {lnum} of the current buffer to {text}. To insert
lines use |append()|. To set lines in another buffer use
- |setbufline()|. Any text properties in {lnum} are cleared.
+ |setbufline()|.
+ Any text properties in {lnum} are cleared |text-prop-cleared|.
{lnum} is used like with |getline()|.
When {lnum} is just below the last line the {text} will be
diff --git a/runtime/doc/change.txt b/runtime/doc/change.txt
index ff995fb..50ff4ec 100644
--- a/runtime/doc/change.txt
+++ b/runtime/doc/change.txt
@@ -1413,6 +1413,8 @@
:[range]m[ove] {address} *:m* *:mo* *:move* *E134*
Move the lines given by [range] to below the line
given by {address}.
+ Any text properties in [range] are cleared
+ |text-prop-cleared|.
==============================================================================
6. Formatting text *formatting*
diff --git a/runtime/doc/tags b/runtime/doc/tags
index 3665fd3..794fa0c 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -10698,6 +10698,7 @@
text-objects motion.txt /*text-objects*
text-objects-changed version5.txt /*text-objects-changed*
text-prop-changes textprop.txt /*text-prop-changes*
+text-prop-cleared textprop.txt /*text-prop-cleared*
text-prop-functions textprop.txt /*text-prop-functions*
text-prop-functions-details textprop.txt /*text-prop-functions-details*
text-prop-intro textprop.txt /*text-prop-intro*
diff --git a/runtime/doc/textprop.txt b/runtime/doc/textprop.txt
index a02a3d5..6b46e06 100644
--- a/runtime/doc/textprop.txt
+++ b/runtime/doc/textprop.txt
@@ -530,7 +530,7 @@
properties below the changed text, so that they still highlight the same text,
thus you don't need to update these.
-
+ *text-prop-cleared*
Text property columns are not updated or copied: ~
- When setting the line with |setline()| or through an interface, such as Lua,