summaryrefslogtreecommitdiff
path: root/tk/doc/image.n
diff options
context:
space:
mode:
Diffstat (limited to 'tk/doc/image.n')
-rw-r--r--tk/doc/image.n9
1 files changed, 8 insertions, 1 deletions
diff --git a/tk/doc/image.n b/tk/doc/image.n
index e03cc849c02..7f26cbf94a0 100644
--- a/tk/doc/image.n
+++ b/tk/doc/image.n
@@ -37,6 +37,10 @@ type; see below for details on the options for built-in image types.
If an image already exists by the given name then it is replaced
with the new image and any instances of that image will redisplay
with the new contents.
+It is important to note that the image command will silently overwrite any
+procedure that may currently be defined by the given name, so choose the
+name wisely. It is recommended to use a separate namespace for image names
+(e.g., \fB::img::logo\fR, \fB::img::large\fR).
.TP
\fBimage delete \fR?\fIname name\fR ...?
Deletes each of the named images and returns an empty string.
@@ -54,6 +58,10 @@ the existing instances will use the new image.
Returns a decimal string giving the height of image \fIname\fR
in pixels.
.TP
+\fBimage inuse \fIname\fR
+Returns a boolean value indicating whether or not the image given by
+\fIname\fR is in use by any widgets.
+.TP
\fBimage names\fR
Returns a list containing the names of all existing images.
.TP
@@ -88,4 +96,3 @@ See the \fBphoto\fR manual entry for more information.
.SH KEYWORDS
height, image, types of images, width
-