Fix [Bug 1832015].

2 files changed, 15 insertions, 3 deletions

diff --git a/ChangeLog b/ChangeLog
index d2d186a..f5ebda8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2009-05-05  Donal K. Fellows  <dkf@users.sf.net>
+
+	* doc/canvas.n (scale): [Bug 1832015]: Clarified that [$c scale] only
+	affects item coordinates.
+
 2009-05-04  Donal K. Fellows  <dkf@users.sf.net>
 
 	* doc/3DBorder.3, doc/BindTable.3, doc/CanvPsY.3, doc/Clipboard.3:
diff --git a/doc/canvas.n b/doc/canvas.n
index 6a41aaf..daa7a72 100644
--- a/doc/canvas.n
+++ b/doc/canvas.n
@@ -6,7 +6,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: canvas.n,v 1.42 2009/01/03 14:41:51 dkf Exp $
+'\" RCS: @(#) $Id: canvas.n,v 1.43 2009/05/05 09:18:08 dkf Exp $
 '\"
 .so man.macros
 .TH canvas n 8.3 Tk "Tk Built-In Commands"
@@ -949,8 +949,8 @@ use as a replacement). The other items ignore this operation.
 .TP
 \fIpathName \fBscale \fItagOrId xOrigin yOrigin xScale yScale\fR
 .
-Rescale all of the items given by \fItagOrId\fR in canvas coordinate
-space.
+Rescale the coordinates of all of the items given by \fItagOrId\fR in canvas
+coordinate space.
 \fIXOrigin\fR and \fIyOrigin\fR identify the origin for the scaling
 operation and \fIxScale\fR and \fIyScale\fR identify the scale
 factors for x- and y-coordinates, respectively (a scale factor of
@@ -961,6 +961,12 @@ of \fIxScale\fR.
 Similarly, each y-coordinate is adjusted to change the distance
 from \fIyOrigin\fR by a factor of \fIyScale\fR.
 This command returns an empty string.
+.RS
+.PP
+Note that some items have only a single pair of coordinates (e.g., text,
+images and windows) and so scaling of them by this command can only move them
+around.
+.RE
 .TP
 \fIpathName \fBscan\fR \fIoption args\fR
 .
@@ -1903,4 +1909,5 @@ bind(n), font(n), image(n), scrollbar(n)
 canvas, widget
 '\" Local Variables:
 '\" mode: nroff
+'\" fill-column: 78
 '\" End: