* 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.

1 files changed, 6 insertions, 5 deletions

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