summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2018-10-28 22:17:26 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2018-10-28 22:17:26 (GMT)
commit64095fae8d758cb1757a59e8a08f913a37796462 (patch)
tree59631fabede72e2eaf33a0f657704863d5e8519a
parent82fe455b2754b8296942b0d25dfdbe8e71a49c97 (diff)
downloadtk-64095fae8d758cb1757a59e8a08f913a37796462.zip
tk-64095fae8d758cb1757a59e8a08f913a37796462.tar.gz
tk-64095fae8d758cb1757a59e8a08f913a37796462.tar.bz2
Documentation
-rw-r--r--doc/grid.n16
-rw-r--r--doc/pack.n8
-rw-r--r--generic/tkGrid.c7
-rw-r--r--generic/tkPack.c7
4 files changed, 32 insertions, 6 deletions
diff --git a/doc/grid.n b/doc/grid.n
index ca8b7cd..ea72db1 100644
--- a/doc/grid.n
+++ b/doc/grid.n
@@ -202,6 +202,14 @@ The slaves will no longer be managed by the grid geometry manager.
The configuration options for that window are forgotten, so that if the
slave is managed once more by the grid geometry manager, the initial
default settings are used.
+.RS
+.PP
+.VS TIP518
+If the last slave of the master becomes unmanaged, this will also send
+the virtual event \fB<<NoManagedChild>>\fR to the master; the master
+may choose to resize itself (or otherwise respond) to such a change.
+.VE TIP518
+.RE
.TP
\fBgrid info \fIslave\fR
.
@@ -278,6 +286,14 @@ However, the configuration options for that window are remembered,
so that if the
slave is managed once more by the grid geometry manager, the previous
values are retained.
+.RS
+.PP
+.VS TIP518
+If the last slave of the master becomes unmanaged, this will also send
+the virtual event \fB<<NoManagedChild>>\fR to the master; the master
+may choose to resize itself (or otherwise respond) to such a change.
+.VE TIP518
+.RE
.TP
\fBgrid size \fImaster\fR
.
diff --git a/doc/pack.n b/doc/pack.n
index 6b39e1d..980dd6e 100644
--- a/doc/pack.n
+++ b/doc/pack.n
@@ -129,6 +129,14 @@ than receiving default values.
Removes each of the \fIslave\fRs from the packing order for its
master and unmaps their windows.
The slaves will no longer be managed by the packer.
+.RS
+.PP
+.VS TIP518
+If the last slave of the master becomes unmanaged, this will also send
+the virtual event \fB<<NoManagedChild>>\fR to the master; the master
+may choose to resize itself (or otherwise respond) to such a change.
+.VE TIP518
+.RE
.TP
\fBpack info \fIslave\fR
Returns a list whose elements are the current configuration state of
diff --git a/generic/tkGrid.c b/generic/tkGrid.c
index a4ac763..4711685 100644
--- a/generic/tkGrid.c
+++ b/generic/tkGrid.c
@@ -1735,12 +1735,13 @@ ArrangeGrid(
* If the master has no slaves anymore, then don't change the master size.
* Otherwise there is no way to "relinquish" control over the master
* so another geometry manager can take over.
- * Send event to "NoManagedChild" to inform about no managed grid but
- * not resized.
+ *
+ * Sends the event "NoManagedChild" to the master to inform it about there
+ * being no managed children inside it.
*/
if (masterPtr->slavePtr == NULL) {
- TkSendVirtualEvent(masterPtr->tkwin, "NoManagedChild", NULL);
+ TkSendVirtualEvent(masterPtr->tkwin, "NoManagedChild", NULL);
return;
}
diff --git a/generic/tkPack.c b/generic/tkPack.c
index 12f651a..ef6e30e 100644
--- a/generic/tkPack.c
+++ b/generic/tkPack.c
@@ -613,12 +613,13 @@ ArrangePacking(
* If the master has no slaves anymore, then leave the master's size as-is.
* Otherwise there is no way to "relinquish" control over the master
* so another geometry manager can take over.
- * Send event to "NoManagedChild" to inform about no managed grid but
- * not resized.
+ *
+ * Sends the event "NoManagedChild" to the master to inform it about there
+ * being no managed children inside it.
*/
if (masterPtr->slavePtr == NULL) {
- TkSendVirtualEvent(masterPtr->tkwin, "NoManagedChild", NULL);
+ TkSendVirtualEvent(masterPtr->tkwin, "NoManagedChild", NULL);
return;
}