Commit: runtime(doc): clarify when text properties are cleared

[Christian Brabandt]

runtime(doc): clarify when text properties are cleared

Commit: https://github.com/vim/vim/commit/946f61c405b54934f58cbb8053957f4a1ecadec8
Author: Christian Brabandt <c...@256bit.org>
Date: Mon Jun 17 13:17:58 2024 +0200

runtime(doc): clarify when text properties are cleared

related: https://github.com/vim/vim/issues/15030

Signed-off-by: Christian Brabandt <c...@256bit.org>

diff --git a/runtime/doc/builtin.txt b/runtime/doc/builtin.txt
index ff7078ea8..9eab16452 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 @@ setfperm({fname}, {mode}) *setfperm()* *chmod*
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 ff995fb1d..50ff4ec99 100644
--- a/runtime/doc/change.txt
+++ b/runtime/doc/change.txt
@@ -1413,6 +1413,8 @@ The next three commands always work on whole lines.
:[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 3665fd3ee..794fa0c71 100644
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -10698,6 +10698,7 @@ text-functions usr_41.txt /*text-functions*
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 a02a3d567..6b46e06df 100644
--- a/runtime/doc/textprop.txt
+++ b/runtime/doc/textprop.txt
@@ -530,7 +530,7 @@ callback update spelling mistakes in the changed text. Vim will move the
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,