* changes: Clearly label wm transient changes as

	a POTENTIAL INCOMPATIBILITY.
	* doc/wm.n: Remove "some window managers will" text
	and explicitly state what behavior a transient
	window will display. Also mention that it is an
	error to make a window a transient of itself.

3 files changed, 18 insertions, 7 deletions

diff --git a/ChangeLog b/ChangeLog
index 2908006..98ff4a8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2002-06-12  Mo DeJong  <mdejong@users.sourceforge.net>
 
+	* changes: Clearly label wm transient changes as
+	a POTENTIAL INCOMPATIBILITY. 
+	* doc/wm.n: Remove "some window managers will" text
+	and explicitly state what behavior a transient
+	window will display. Also mention that it is an
+	error to make a window a transient of itself.
+
+2002-06-12  Mo DeJong  <mdejong@users.sourceforge.net>
+
 	* library/choosedir.tcl (tk::dialog::file::chooseDir):
 	* library/clrpick.tcl (tk::dialog::file::chooseDir):
 	* library/msgbox.tcl (tk::MessageBox):
diff --git a/changes b/changes
index 6d36b05..30bb5cf 100644
--- a/changes
+++ b/changes
@@ -2,7 +2,7 @@ This file summarizes all changes made to Tk since version 1.0 was
 released on March 13, 1991.  Changes that aren't backward compatible
 are marked specially.
 
-RCS: @(#) $Id: changes,v 1.53 2002/06/12 19:02:48 mdejong Exp $
+RCS: @(#) $Id: changes,v 1.54 2002/06/13 06:33:36 mdejong Exp $
 
 3/16/91 (bug fix) Modified tkWindow.c to remove Tk's Tcl commands from
 the interpreter when the main window is deleted (otherwise there will
@@ -5185,7 +5185,8 @@ address TIP 72 changes (64-bit) in Tcl (fellows)
 --- Released 8.4a4, March 5, 2002 --- See ChangeLog for details ---
 
 2002-05-27 (feature change) [wm transient .t .t] now raises an error (dejong)
+	*** POTENTIAL INCOMPATIBILITY ***
 
 2002-06-12 (feature change) A transient toplevel now mirrors state
 changes in the master. (dejong)
-
+	*** POTENTIAL INCOMPATIBILITY ***
diff --git a/doc/wm.n b/doc/wm.n
index d1a5af5..3ad831e 100644
--- a/doc/wm.n
+++ b/doc/wm.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: wm.n,v 1.8 2002/04/10 19:39:01 mdejong Exp $
+'\" RCS: @(#) $Id: wm.n,v 1.9 2002/06/13 06:33:36 mdejong Exp $
 '\" 
 .so man.macros
 .TH wm n 4.3 Tk "Tk Built-In Commands"
@@ -435,13 +435,14 @@ specified then the command returns the current title for the
 If \fImaster\fR is specified, then the window manager is informed
 that \fIwindow\fR is a transient window (e.g. pull-down menu) working
 on behalf of \fImaster\fR (where \fImaster\fR is the
-path name for a top-level window).  Some window managers will use
-this information to manage \fIwindow\fR specially.  If \fImaster\fR
+path name for a top-level window).  If \fImaster\fR
 is specified as an empty string then \fIwindow\fR is marked as not
-being a transient window any more.  If \fImaster\fR is specified,
-then the command returns an empty string.  Otherwise the command
+being a transient window any more.  Otherwise the command
 returns the path name of \fIwindow\fR's current master, or an
 empty string if \fIwindow\fR isn't currently a transient window.
+A transient window will mirror state changes in the master and
+inherit the state of the master when initially mapped. It is an
+error to attempt to make a window a transient of itself.
 .TP
 \fBwm withdraw \fIwindow\fR
 Arranges for \fIwindow\fR to be withdrawn from the screen.  This