From 468c312d3d99cc311466dac2d82710daf75ca54a Mon Sep 17 00:00:00 2001 From: "fvogelnew1@free.fr" Date: Sun, 8 Mar 2015 20:51:13 +0000 Subject: Fixed documentation regarding behaviour of embedded windows and embedded images in [text] - Bug [1581955fff] --- doc/text.n | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) 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 -- cgit v0.12 From e750146cb9964d1210291bb82c862f9e1ad2256a Mon Sep 17 00:00:00 2001 From: "fvogelnew1@free.fr" Date: Fri, 13 Mar 2015 19:19:24 +0000 Subject: Slightly better formatting --- doc/text.n | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/text.n b/doc/text.n index 6b72eb5..b11363d 100644 --- a/doc/text.n +++ b/doc/text.n @@ -736,6 +736,7 @@ and any widget may be used as an embedded window (subject to the usual rules for geometry management, which require the text window to be the parent of the embedded window or a descendant of its parent). +.PP The embedded window's position on the screen will be updated as the text is modified or scrolled, and it will be mapped and unmapped as it moves into and out of the visible area of the text widget. @@ -753,6 +754,7 @@ the window is destroyed. Similarly if the text widget as a whole is deleted, then the window is destroyed. .VE 8.5 +.PP .VS 8.5 Eliding an embedded window immediately after scheduling it for creation via \fIpathName \fBwindow create \fIindex \fB-create\fR will prevent it @@ -834,6 +836,7 @@ at a particular point in the text. There may be any number of embedded images in a text widget, and a particular image may be embedded in multiple places in the same text widget. +.PP The embedded image's position on the screen will be updated as the text is modified or scrolled. Each embedded image occupies one @@ -846,6 +849,7 @@ 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. +.PP .VS 8.5 Eliding an embedded image immediately after scheduling it for creation via \fIpathName \fBimage create \fIindex \fB-create\fR will prevent it -- cgit v0.12