Fixed documentation regarding behaviour of embedded windows and embedded images in [text] - Bug [1581955fff]

1 files changed, 20 insertions, 0 deletions

diff --git a/doc/text.n b/doc/text.n
index a7eeffc..6b72eb5 100644
--- a/doc/text.n
+++ b/doc/text.n
@@ -753,6 +753,16 @@ the window is destroyed.
 Similarly if the text widget as a whole is deleted, then the window is
 destroyed.
 .VE 8.5
+.VS 8.5
+Eliding an embedded window immediately after scheduling it for creation
+via \fIpathName \fBwindow create \fIindex \fB-create\fR will prevent it
+from being effectively created.
+Uneliding an elided embedded window scheduled for creation via
+\fIpathName \fBwindow create \fIindex \fB-create\fR will automatically
+trigger the associated creation script.
+After destroying an elided embedded window, the latter won't get
+automatically recreated.
+.VE 8.5
 .PP
 When an embedded window is added to a text widget with the
 \fIpathName \fBwindow create\fR widget command, several configuration
@@ -836,6 +846,16 @@ its position in the widget's index space, or the name it is assigned
 when the image is inserted into the text widget with \fIpathName \fBimage create\fR.
 If the range of text containing the embedded image is deleted then
 that copy of the image is removed from the screen.
+.VS 8.5
+Eliding an embedded image immediately after scheduling it for creation
+via \fIpathName \fBimage create \fIindex \fB-create\fR will prevent it
+from being effectively created.
+Uneliding an elided embedded image scheduled for creation via
+\fIpathName \fBimage create \fIindex \fB-create\fR will automatically
+trigger the associated creation script.
+After destroying an elided embedded image, the latter won't get
+automatically recreated.
+.VE 8.5
 .PP
 When an embedded image is added to a text widget with the \fIpathName \fBimage
 create\fR widget command, a name unique to this instance of the image