summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <dkf@noemail.net>2012-07-05 09:49:40 (GMT)
committerdkf <dkf@noemail.net>2012-07-05 09:49:40 (GMT)
commit35a3a2780f5c5fac8e4d46a56c059b7bb31e8caf (patch)
treef8bf8e36b71f2309243000259003ce4dc35dcdec
parentacc531dd178bff4b45d433143e94390abbc3ae68 (diff)
downloadtk-35a3a2780f5c5fac8e4d46a56c059b7bb31e8caf.zip
tk-35a3a2780f5c5fac8e4d46a56c059b7bb31e8caf.tar.gz
tk-35a3a2780f5c5fac8e4d46a56c059b7bb31e8caf.tar.bz2
[Bug 3538401]: Better description of the key difference between [wm geometry]
and [winfo geometry] FossilOrigin-Name: 95150c8c6240f1b18a75c3a03a8d232c5a01e553
-rw-r--r--ChangeLog6
-rw-r--r--doc/wm.n8
2 files changed, 14 insertions, 0 deletions
diff --git a/ChangeLog b/ChangeLog
index 7a7b56d..c74f093 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2012-07-05 Donal K. Fellows <dkf@users.sf.net>
+
+ * doc/wm.n (geometry): [Bug 3538401]: Better description of the key
+ difference between [wm geometry] and [winfo geometry]; the former
+ represents the window manager's understanding, not Tk's.
+
2012-07-04 Donal K. Fellows <dkf@users.sf.net>
* win/tkWinDialog.c (GetFileNameW): [Bug 3540127]: Clean up the tables
diff --git a/doc/wm.n b/doc/wm.n
index f234b6d..59aa624 100644
--- a/doc/wm.n
+++ b/doc/wm.n
@@ -227,6 +227,14 @@ If \fInewGeometry\fR is specified as an empty string then any
existing user-specified geometry for \fIwindow\fR is cancelled, and
the window will revert to the size requested internally by its
widgets.
+Note that this is related to \fBwinfo geometry\fR, but not the same. That can
+only query the geometry, and always reflects Tk's current understanding of the
+actual size and location of \fIwindow\fR, whereas \fBwm geometry\fR allows
+both setting and querying of the \fIwindow manager\fR's understanding of the
+size and location of the window. This can vary significantly, for example to
+reflect the addition of decorative elements to \fIwindow\fR such as title
+bars, and window managers are not required to precisely follow the requests
+made through this command.
.TP
\fBwm grid \fIwindow\fR ?\fIbaseWidth baseHeight widthInc heightInc\fR?
This command indicates that \fIwindow\fR is to be managed as a