Update runtime files
diff --git a/runtime/doc/textprop.txt b/runtime/doc/textprop.txt
index 5fb53af..5a849fe 100644
--- a/runtime/doc/textprop.txt
+++ b/runtime/doc/textprop.txt
@@ -1,4 +1,4 @@
-*textprop.txt* For Vim version 9.0. Last change: 2022 Sep 17
+*textprop.txt* For Vim version 9.0. Last change: 2022 Sep 21
VIM REFERENCE MANUAL by Bram Moolenaar
@@ -143,10 +143,11 @@
automatically to a negative number; otherwise
zero is used
*E1305*
- text text to be displayed before {col}, or after the
- line if {col} is zero; prepend and/or append
- spaces for padding with highlighting; cannot
- be used with "length", "end_lnum" and "end_col"
+ text text to be displayed before {col}, or
+ above/below the line if {col} is zero; prepend
+ and/or append spaces for padding with
+ highlighting; cannot be used with "length",
+ "end_lnum" and "end_col" |virtual-text|
*E1294*
text_align when "text" is present and {col} is zero;
specifies where to display the text:
@@ -191,12 +192,23 @@
If not found an error is given.
*virtual-text*
When "text" is used and the column is non-zero then this text
- will be displayed at the start location of the text property
- after the text. The text of the buffer line will be shifted
- to make room. This is called "virtual text".
- When the column is zero the virtual text will appear after the
- buffer text. The "text_align" and "text_wrap" arguments
- determine how it is displayed.
+ will be displayed at the specified start location of the text
+ property. The text of the buffer line will be shifted to make
+ room. This is called "virtual text".
+ When the column is zero the virtual text will appear above,
+ after or below the buffer text. The "text_align" and
+ "text_wrap" arguments determine how it is displayed.
+ To separate the virtual text from the buffer text prepend
+ and/or append spaces to the "text" field or use the
+ "text_padding_left" value.
+
+ Make sure to use a highlight that makes clear to the user that
+ this is virtual text, otherwise it will be very confusing that
+ the text cannot be edited. When using "above" you need to
+ make clear this text belongs to the text line below it, when
+ using "below" you need to make sure it belongs to the text
+ line above it.
+
The text will be displayed but it is not part of the actual
buffer line, the cursor cannot be placed on it. A mouse click
in the text will move the cursor to the first character after
@@ -208,11 +220,6 @@
property with "text" has been added for a buffer then using a
negative "id" for any other property will give an error:
*E1293*
- Make sure to use a highlight that makes clear to the user that
- this is virtual text, otherwise it will be very confusing that
- the text cannot be edited.
- To separate the virtual text from the buffer text prepend
- and/or append spaces to the "text" field.
Can also be used as a |method|: >
GetLnum()->prop_add(col, props)