head	1.42;
access;
symbols
	core-8-5-9:1.38.2.1
	core-8-5-8:1.38.2.1
	macosx-cocoa-merge:1.42
	macosx-cocoa-premerge:1.42
	macosx-carbon-freeze:1.42
	core-8-5-7:1.38.2.1
	core-8-5-6:1.38.2.1
	core-8-6-b1:1.42
	core-8-6-a3:1.40
	core-8-5-5:1.38
	core-8-6-a2:1.39
	core-8-5-4:1.38
	core-8-5-3:1.38
	core-8-6-a1:1.38
	core-8-4-19:1.11.2.6
	core-8-5-branch:1.38.0.2
	core-8-5-2:1.38
	core-8-4-18:1.11.2.6
	core-8-5-1:1.38
	core-8-4-17:1.11.2.6
	core-8-5-0:1.38
	core-8-5-b3:1.36
	core-8-5-b2:1.34
	core-8-4-16:1.11.2.6
	core-8-5-b1:1.29
	core-stablilizer-merge:1.29
	core-stabilizer-branch:1.29.0.2
	core-stabilizer-merge:1.38
	core-8-4-15:1.11.2.6
	core-8-5-a6:1.29
	core-8-5-a5:1.25
	core-8-4-14:1.11.2.4
	core-8-5-a4:1.25
	core-8-4-13:1.11.2.4
	core-8-4-12:1.11.2.3
	core-8-4-11:1.11.2.3
	core-8-5-a3:1.23
	core-8-4-10:1.11.2.3
	core-8-4-9-branch:1.11.2.3.0.2
	core-8-5-a2:1.21
	core-8-4-9:1.11.2.3
	core-8-4-8:1.11.2.3
	core-8-4-7:1.11
	core-8-5-a1:1.12
	core-8-4-6:1.11
	core-8-4-5:1.11
	mistachkin-dev-branch:1.12.0.2
	core-8-4-4:1.11
	core-8-4-3:1.11
	core-8-4-branch:1.11.0.2
	core-8-4-2:1.11
	core-8-4-1:1.11
	core-8-3-5:1.5.2.1
	core-8-4-0:1.11
	macosx-8-4-merge-2002-08-31-trunk:1.11
	macosx-8-4-premerge-2002-08-31-branch:1.6.4.3
	macosx-8-4-premerge-2002-08-31-trunk:1.11
	macosx-8-4-merge-2002-08-30-branch:1.6.4.3
	macosx-8-4-merge-2002-08-30-trunk:1.11
	macosx-8-4-merge-2002-08-20-branch:1.6.4.3
	macosx-8-4-merge-2002-08-20-trunk:1.11
	core-8-4-b2:1.11
	core-8-4-b1:1.10
	macosx-premerge-6-9-02:1.6.4.1
	core-8-4-a4:1.7
	core-8-3-4:1.5.2.1
	macosx-8-4-branch:1.6.0.4
	macosx-8-4-branchpoint:1.6
	core-8-4-a3:1.6
	core-8-3-3:1.5.2.1
	dgp-privates-into-namespace:1.6.0.2
	tclpro-1-5-0:1.5
	core-8-4-win-speedup:1.5.0.4
	core-8-4-a2:1.5
	tclpro-1-4-1:1.5
	tclpro-1-4-0:1.5
	core-8-3-2:1.5
	ajuba-ajuba2-2-1-base:1.5
	ajuba-ajuba2-2-0:1.5
	core-8-4-a1:1.5
	core-8-3-1-branch:1.5.0.2
	core-8-3-1:1.5
	scriptics-sc-2-0-b5:1.5
	scriptics-sc-2-0-fixed:1.5
	scriptics-sc-2-0-b2:1.5
	scriptics-sc-2-0-b1:1.5
	core-8-3-0:1.5
	core-8-3-b2:1.5
	core-8-3-b1:1.4
	scriptics-sc-1-1:1.4
	scriptics-sc-1-1-b1:1.4
	core-8-2-3:1.4
	scriptics-sc-1-1-branch:1.4.0.8
	scriptics-sc-1-1-base:1.4
	scriptics-sc-1-0:1.4
	scriptics-sc-1-0-branch:1.4.0.6
	scriptics-sc-1-0-base:1.4
	core-8-2-2:1.4
	core-8-2-1:1.4
	scriptics-bc-1-0-b1:1.4
	core-8-2-1-branch:1.4.0.4
	scriptics-tclpro-1-3-0:1.4
	core-8-2-0:1.4
	core-8-2-b3-branch:1.4.0.2
	core-8-2-b3-base:1.4
	scriptics-tclpro-1-3-b4:1.2
	core-8-2-b2:1.2
	scriptics-tclpro-1-3-b3:1.2
	core-8-2-b1:1.2
	scriptics-tclpro-1-3-b2:1.2
	merge-to-mainline-5/21/99:1.2
	scriptics-tclpro-1-3-b2-branch:1.2.0.8
	core-8-1-1:1.2
	scriptics-tclpro-1-3-b1:1.2
	core-8-1-1-base:1.2
	core-8-1-0:1.2
	merge-to-mainline-4-29-99:1.2
	merge-to-mainline-4-23-99:1.2
	core-8-1-branch-old:1.1.0.4
	core-8-0-6-branch:1.2.0.6
	core-8-0-6-base:1.2
	core-8-0-5:1.2
	core-8-1-b3:1.1.4.1
	core-8-1-b2:1.1.4.1
	dev-8-1-stubs-branch:1.1.4.1.0.2
	dev-stubs-branch:1.2.0.4
	scriptics-tclpro-1-2:1.2
	scriptics-tclpro-1-2-b2:1.2
	core-8-1-merge-2/10/99:1.2
	core-8-0-5-branch:1.2.0.2
	core-8-0-5-base:1.2
	scriptics-tclpro-1-2-b1:1.2
	scriptics-tclpro-1-2-a1:1.2
	core-8-1-b1:1.1.4.1
	core-8-0-4:1.2
	core-8-1-a2:1.1
	core-8-0-2:1.1
	core-8-0-3:1.2;
locks; strict;
comment	@# @;


1.42
date	2008.11.16.17.07.51;	author dkf;	state Exp;
branches;
next	1.41;

1.41
date	2008.11.15.00.00.27;	author patthoyts;	state Exp;
branches;
next	1.40;

1.40
date	2008.09.23.13.36.58;	author dkf;	state Exp;
branches;
next	1.39;

1.39
date	2008.06.30.22.57.03;	author dkf;	state Exp;
branches;
next	1.38;

1.38
date	2007.12.13.15.23.44;	author dgp;	state Exp;
branches
	1.38.2.1;
next	1.37;

1.37
date	2007.12.10.09.36.20;	author das;	state Exp;
branches;
next	1.36;

1.36
date	2007.10.30.21.29.59;	author dkf;	state Exp;
branches;
next	1.35;

1.35
date	2007.10.29.16.04.14;	author dkf;	state Exp;
branches;
next	1.34;

1.34
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.33;

1.33
date	2007.10.24.14.32.59;	author dkf;	state Exp;
branches;
next	1.32;

1.32
date	2007.10.23.15.44.36;	author dkf;	state Exp;
branches;
next	1.31;

1.31
date	2007.10.15.20.54.43;	author hobbs;	state Exp;
branches;
next	1.30;

1.30
date	2007.10.15.20.52.47;	author hobbs;	state Exp;
branches;
next	1.29;

1.29
date	2007.04.23.21.19.52;	author das;	state Exp;
branches
	1.29.2.1;
next	1.28;

1.28
date	2006.12.01.19.48.00;	author hobbs;	state Exp;
branches;
next	1.27;

1.27
date	2006.11.16.13.50.17;	author dkf;	state Exp;
branches;
next	1.26;

1.26
date	2006.11.15.13.29.17;	author dkf;	state Exp;
branches;
next	1.25;

1.25
date	2006.04.11.07.36.36;	author das;	state Exp;
branches;
next	1.24;

1.24
date	2005.11.16.02.51.38;	author jenglish;	state Exp;
branches;
next	1.23;

1.23
date	2005.04.06.21.11.54;	author dkf;	state Exp;
branches;
next	1.22;

1.22
date	2005.02.17.00.06.08;	author mdejong;	state Exp;
branches;
next	1.21;

1.21
date	2004.11.11.01.24.31;	author das;	state Exp;
branches;
next	1.20;

1.20
date	2004.10.28.12.25.53;	author dkf;	state Exp;
branches;
next	1.19;

1.19
date	2004.10.08.23.15.32;	author dkf;	state Exp;
branches;
next	1.18;

1.18
date	2004.10.07.17.39.51;	author hobbs;	state Exp;
branches;
next	1.17;

1.17
date	2004.10.05.22.04.44;	author hobbs;	state Exp;
branches;
next	1.16;

1.16
date	2004.09.28.18.54.37;	author hobbs;	state Exp;
branches;
next	1.15;

1.15
date	2004.09.17.23.26.21;	author hobbs;	state Exp;
branches;
next	1.14;

1.14
date	2004.06.21.19.56.11;	author dkf;	state Exp;
branches;
next	1.13;

1.13
date	2004.06.18.22.07.59;	author dkf;	state Exp;
branches;
next	1.12;

1.12
date	2003.03.12.00.25.41;	author mdejong;	state Exp;
branches;
next	1.11;

1.11
date	2002.07.16.18.06.41;	author vincentdarley;	state Exp;
branches
	1.11.2.1;
next	1.10;

1.10
date	2002.06.22.10.13.26;	author hobbs;	state Exp;
branches;
next	1.9;

1.9
date	2002.06.13.06.33.36;	author mdejong;	state Exp;
branches;
next	1.8;

1.8
date	2002.04.10.19.39.01;	author mdejong;	state Exp;
branches;
next	1.7;

1.7
date	2001.12.04.03.07.43;	author mdejong;	state Exp;
branches;
next	1.6;

1.6
date	2001.01.02.19.13.02;	author andreas_kupries;	state Exp;
branches
	1.6.4.1;
next	1.5;

1.5
date	2000.01.12.11.44.42;	author hobbs;	state Exp;
branches
	1.5.2.1
	1.5.4.1;
next	1.4;

1.4
date	99.08.10.16.58.18;	author hobbs;	state Exp;
branches;
next	1.3;

1.3
date	99.08.09.16.51.51;	author hobbs;	state Exp;
branches;
next	1.2;

1.2
date	98.09.14.18.23.01;	author stanton;	state Exp;
branches;
next	1.1;

1.1
date	98.04.01.09.39.58;	author rjohnson;	state Exp;
branches
	1.1.4.1;
next	;

1.1.4.1
date	98.09.30.02.16.33;	author stanton;	state Exp;
branches;
next	;

1.5.2.1
date	2001.04.04.07.23.48;	author hobbs;	state Exp;
branches;
next	;

1.5.4.1
date	2002.04.02.20.57.53;	author hobbs;	state Exp;
branches;
next	;

1.6.4.1
date	2002.02.05.02.25.14;	author wolfsuit;	state Exp;
branches;
next	1.6.4.2;

1.6.4.2
date	2002.06.10.05.38.23;	author wolfsuit;	state Exp;
branches;
next	1.6.4.3;

1.6.4.3
date	2002.08.20.20.27.00;	author das;	state Exp;
branches;
next	;

1.11.2.1
date	2004.10.28.12.25.22;	author dkf;	state Exp;
branches;
next	1.11.2.2;

1.11.2.2
date	2004.10.28.22.40.57;	author mdejong;	state Exp;
branches;
next	1.11.2.3;

1.11.2.3
date	2004.11.11.01.26.42;	author das;	state Exp;
branches;
next	1.11.2.4;

1.11.2.4
date	2006.04.11.07.36.40;	author das;	state Exp;
branches;
next	1.11.2.5;

1.11.2.5
date	2006.12.01.19.47.41;	author hobbs;	state Exp;
branches;
next	1.11.2.6;

1.11.2.6
date	2007.04.29.02.25.54;	author das;	state Exp;
branches;
next	;

1.29.2.1
date	2007.10.16.04.03.53;	author dgp;	state Exp;
branches;
next	1.29.2.2;

1.29.2.2
date	2007.10.24.12.59.32;	author dgp;	state Exp;
branches;
next	1.29.2.3;

1.29.2.3
date	2007.10.27.04.23.15;	author dgp;	state Exp;
branches;
next	1.29.2.4;

1.29.2.4
date	2007.11.01.16.37.16;	author dgp;	state Exp;
branches;
next	1.29.2.5;

1.29.2.5
date	2007.12.10.18.39.28;	author dgp;	state Exp;
branches;
next	;

1.38.2.1
date	2008.11.15.00.37.30;	author patthoyts;	state Exp;
branches;
next	;


desc
@@


1.42
log
@Explained constraints on [wm overrideredirect] better. [Bug 2282861]
@
text
@'\"
'\" Copyright (c) 1991-1994 The Regents of the University of California.
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
'\"
'\" 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.41 2008/11/15 00:00:27 patthoyts Exp $
'\" 
.so man.macros
.TH wm n 8.5 Tk "Tk Built-In Commands"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
wm \- Communicate with window manager
.SH SYNOPSIS
\fBwm\fR \fIoption window \fR?\fIargs\fR?
.BE
.SH DESCRIPTION
.PP
The \fBwm\fR command is used to interact with window managers in
order to control such things as the title for a window, its geometry,
or the increments in terms of which it may be resized.  The \fBwm\fR
command can take any of a number of different forms, depending on
the \fIoption\fR argument.  All of the forms expect at least one
additional argument, \fIwindow\fR, which must be the path name of a
top-level window.
.PP
The legal forms for the \fBwm\fR command are:
.TP
\fBwm aspect \fIwindow\fR ?\fIminNumer minDenom maxNumer maxDenom\fR?
.
If \fIminNumer\fR, \fIminDenom\fR, \fImaxNumer\fR, and \fImaxDenom\fR
are all specified, then they will be passed to the window manager
and the window manager should use them to enforce a range of
acceptable aspect ratios for \fIwindow\fR.  The aspect ratio of
\fIwindow\fR (width/length) will be constrained to lie
between \fIminNumer\fR/\fIminDenom\fR and \fImaxNumer\fR/\fImaxDenom\fR.
If \fIminNumer\fR etc. are all specified as empty strings, then
any existing aspect ratio restrictions are removed.
If \fIminNumer\fR etc. are specified, then the command returns an
empty string.  Otherwise, it returns
a Tcl list containing four elements, which are the current values
of \fIminNumer\fR, \fIminDenom\fR, \fImaxNumer\fR, and \fImaxDenom\fR
(if no aspect restrictions are in effect, then an empty string is
returned).
.TP
\fBwm attributes \fIwindow\fR
.TP
\fBwm attributes \fIwindow\fR ?\fBoption\fR?
.TP
\fBwm attributes \fIwindow\fR ?\fBoption value option value...\fR?
.
This subcommand returns or sets platform specific attributes associated
with a window. The first form returns a list of the platform specific
flags and their values. The second form returns the value for the
specific option. The third form sets one or more of the values. The
values are as follows:
.RS
.PP
All platforms support the following attributes (though X11 users
should see the notes below):
.TP
\fB\-fullscreen\fR
.
Places the window in a mode that takes up the entire screen, has no
borders, and covers the general use area (i.e. Start menu and taskbar on
Windows, dock and menubar on OSX, general window decorations on X11).
.TP
\fB\-topmost\fR
.
Specifies whether this is a topmost window (displays above all other windows).
.PP
On Windows, the following attributes may be set.
.TP
\fB\-alpha\fR
.
Specifies the alpha transparency level of the toplevel.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR
(opaque).  Values outside that range will be constrained.  This is
supported on Windows 2000/XP+.  Where not supported, the \fB\-alpha\fR
value remains at \fB1.0\fR.
.TP
\fB\-disabled\fR
.
Specifies whether the window is in a disabled state.
.TP
\fB\-toolwindow\fR
.
Specifies a toolwindow style window (as defined in the MSDN).
.TP
\fB\-transparentcolor\fR
.
Specifies the transparent color index of the toplevel.  It takes any color
value accepted by \fBTk_GetColor\fR.  If the empty string is specified
(default), no transparent color is used.  This is supported on Windows
2000/XP+.  Where not supported, the \fB\-transparentcolor\fR value remains
at \fB{}\fR.
.PP
On Mac OS X, the following attributes may be set.
.TP
\fB\-alpha\fR
.
Specifies the alpha transparency level of the window.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
values outside that range will be constrained.
.TP
\fB\-modified\fR
.
Specifies the modification state of the window (determines whether the
window close widget contains the modification indicator and whether the
proxy icon is draggable).
.TP
\fB\-notify\fR
.
Specifies process notification state (bouncing of the application dock icon).
.TP
\fB\-titlepath\fR
.
Specifies the path of the file referenced as the window proxy icon (which
can be dragged and dropped in lieu of the file's finder icon).
.TP
\fB\-transparent\fR
.
Makes the window content area transparent and turns off the window shadow. For
the transparency to be effecive, the toplevel background needs to be set to a
color with some alpha, e.g.
.QW systemTransparent .
.PP
On X11, the following attributes may be set. These are not supported by all
window managers, and will have no effect under older WMs.
.\" See http://www.freedesktop.org/Standards/wm-spec
.TP
\fB\-zoomed\fR
.
Requests that the window should be maximized. This is the same as \fBwm state
zoomed\fR on Windows and Mac OS X.
.PP
On X11, changes to window attributes are performed asynchronously. Querying
the value of an attribute returns the current state, which will not be the
same as the value most recently set if the window manager has not yet
processed the request or if it does not support the attribute.
.RE
.TP
\fBwm client \fIwindow\fR ?\fIname\fR?
.
If \fIname\fR is specified, this command stores \fIname\fR (which
should be the name of
the host on which the application is executing) in \fIwindow\fR's
\fBWM_CLIENT_MACHINE\fR property for use by the window manager or
session manager.
The command returns an empty string in this case.
If \fIname\fR is not specified, the command returns the last name
set in a \fBwm client\fR command for \fIwindow\fR.
If \fIname\fR is specified as an empty string, the command deletes the
\fBWM_CLIENT_MACHINE\fR property from \fIwindow\fR.
.TP
\fBwm colormapwindows \fIwindow\fR ?\fIwindowList\fR?
.
This command is used to manipulate the \fBWM_COLORMAP_WINDOWS\fR
property, which provides information to the window managers about
windows that have private colormaps.
.RS
.PP
If \fIwindowList\fR is not specified, the command returns a list
whose elements are the names of the windows in the \fBWM_COLORMAP_WINDOWS\fR
property.
If \fIwindowList\fR is specified, it consists of a list of window
path names;  the command overwrites the \fBWM_COLORMAP_WINDOWS\fR
property with the given windows and returns an empty string.
The \fBWM_COLORMAP_WINDOWS\fR property should normally contain a
list of the internal windows within \fIwindow\fR whose colormaps differ
from their parents.
.PP
The order of the windows in the property indicates a priority order:
the window manager will attempt to install as many colormaps as possible
from the head of this list when \fIwindow\fR gets the colormap focus.
If \fIwindow\fR is not included among the windows in \fIwindowList\fR,
Tk implicitly adds it at the end of the \fBWM_COLORMAP_WINDOWS\fR
property, so that its colormap is lowest in priority.
If \fBwm colormapwindows\fR is not invoked, Tk will automatically set
the property for each top-level window to all the internal windows
whose colormaps differ from their parents, followed by the top-level
itself;  the order of the internal windows is undefined.
See the ICCCM documentation for more information on the
\fBWM_COLORMAP_WINDOWS\fR property.
.RE
.TP
\fBwm command \fIwindow\fR ?\fIvalue\fR?
.
If \fIvalue\fR is specified, this command stores \fIvalue\fR in \fIwindow\fR's
\fBWM_COMMAND\fR property for use by the window manager or
session manager and returns an empty string.
\fIValue\fR must have proper list structure;  the elements should
contain the words of the command used to invoke the application.
If \fIvalue\fR is not specified then the command returns the last value
set in a \fBwm command\fR command for \fIwindow\fR.
If \fIvalue\fR is specified as an empty string, the command
deletes the \fBWM_COMMAND\fR property from \fIwindow\fR.
.TP
\fBwm deiconify \fIwindow\fR
.
Arrange for \fIwindow\fR to be displayed in normal (non-iconified) form.
This is done by mapping the window.  If the window has never been
mapped then this command will not map the window, but it will ensure
that when the window is first mapped it will be displayed
in de-iconified form.  On Windows, a deiconified window will also be
raised and be given the focus (made the active window).
Returns an empty string.
.TP
\fBwm focusmodel \fIwindow\fR ?\fBactive\fR|\fBpassive\fR?
.
If \fBactive\fR or \fBpassive\fR is supplied as an optional argument
to the command, then it specifies the focus model for \fIwindow\fR.
In this case the command returns an empty string.  If no additional
argument is supplied, then the command returns the current focus
model for \fIwindow\fR.
.RS
.PP
An \fBactive\fR focus model means that \fIwindow\fR will claim the
input focus for itself or its descendants, even at times when
the focus is currently in some other application.  \fBPassive\fR means that
\fIwindow\fR will never claim the focus for itself:  the window manager
should give the focus to \fIwindow\fR at appropriate times.  However,
once the focus has been given to \fIwindow\fR or one of its descendants,
the application may re-assign the focus among \fIwindow\fR's descendants.
The focus model defaults to \fBpassive\fR, and Tk's \fBfocus\fR command
assumes a passive model of focusing.
.RE
.TP
\fBwm forget \fIwindow\fR
.
The \fIwindow\fR will be unmapped from the screen and will no longer
be managed by \fBwm\fR.  Windows created with the \fBtoplevel\fR
command will be treated like \fBframe\fR windows once they are no
longer managed by \fBwm\fR, however, the \fB\-menu\fR configuration will be
remembered and the menus will return once the widget is managed again.
.TP
\fBwm frame \fIwindow\fR
.
If \fIwindow\fR has been reparented by the window manager into a
decorative frame, the command returns the platform specific window
identifier for the outermost frame that contains \fIwindow\fR (the
window whose parent is the root or virtual root).  If \fIwindow\fR
has not been reparented by the window manager then the command returns
the platform specific window identifier for \fIwindow\fR.
.TP
\fBwm geometry \fIwindow\fR ?\fInewGeometry\fR?
.
If \fInewGeometry\fR is specified, then the geometry of \fIwindow\fR
is changed and an empty string is returned.  Otherwise the current
geometry for \fIwindow\fR is returned (this is the most recent
geometry specified either by manual resizing or
in a \fBwm geometry\fR command).  \fINewGeometry\fR has
the form \fB=\fIwidth\fBx\fIheight\fB\(+-\fIx\fB\(+-\fIy\fR, where
any of \fB=\fR, \fIwidth\fBx\fIheight\fR, or \fB\(+-\fIx\fB\(+-\fIy\fR
may be omitted.  \fIWidth\fR and \fIheight\fR are positive integers
specifying the desired dimensions of \fIwindow\fR.  If \fIwindow\fR
is gridded (see \fBGRIDDED GEOMETRY MANAGEMENT\fR below) then the dimensions
are specified in grid units;  otherwise they are specified in pixel
units.
.RS
.PP
\fIX\fR and \fIy\fR specify the desired location of
\fIwindow\fR on the screen, in pixels.
If \fIx\fR is preceded by \fB+\fR, it specifies
the number of pixels between the left edge of the screen and the left
edge of \fIwindow\fR's border;  if preceded by \fB\-\fR then
\fIx\fR specifies the number of pixels
between the right edge of the screen and the right edge of \fIwindow\fR's
border.  If \fIy\fR is preceded by \fB+\fR then it specifies the
number of pixels between the top of the screen and the top
of \fIwindow\fR's border;  if \fIy\fR is preceded by \fB\-\fR then
it specifies the number of pixels between the bottom of \fIwindow\fR's
border and the bottom of the screen.
.PP
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.
.RE
.TP
\fBwm grid \fIwindow\fR ?\fIbaseWidth baseHeight widthInc heightInc\fR?
.
This command indicates that \fIwindow\fR is to be managed as a
gridded window.
It also specifies the relationship between grid units and pixel units.
\fIBaseWidth\fR and \fIbaseHeight\fR specify the number of grid
units corresponding to the pixel dimensions requested internally
by \fIwindow\fR using \fBTk_GeometryRequest\fR.  \fIWidthInc\fR
and \fIheightInc\fR specify the number of pixels in each horizontal
and vertical grid unit.
These four values determine a range of acceptable sizes for
\fIwindow\fR, corresponding to grid-based widths and heights
that are non-negative integers.
Tk will pass this information to the window manager;  during
manual resizing, the window manager will restrict the window's size
to one of these acceptable sizes.
.RS
.PP
Furthermore, during manual resizing the window manager will display
the window's current size in terms of grid units rather than pixels.
If \fIbaseWidth\fR etc. are all specified as empty strings, then
\fIwindow\fR will no longer be managed as a gridded window.  If
\fIbaseWidth\fR etc. are specified then the return value is an
empty string.
.PP
Otherwise the return value is a Tcl list containing
four elements corresponding to the current \fIbaseWidth\fR,
\fIbaseHeight\fR, \fIwidthInc\fR, and \fIheightInc\fR;  if
\fIwindow\fR is not currently gridded, then an empty string
is returned.
.PP
Note: this command should not be needed very often, since the
\fBTk_SetGrid\fR library procedure and the \fBsetGrid\fR option
provide easier access to the same functionality.
.RE
.TP
\fBwm group \fIwindow\fR ?\fIpathName\fR?
.
If \fIpathName\fR is specified, it gives the path name for the leader of
a group of related windows.  The window manager may use this information,
for example, to unmap all of the windows in a group when the group's
leader is iconified.  \fIPathName\fR may be specified as an empty string to
remove \fIwindow\fR from any group association.  If \fIpathName\fR is
specified then the command returns an empty string;  otherwise it
returns the path name of \fIwindow\fR's current group leader, or an empty
string if \fIwindow\fR is not part of any group.
.TP
\fBwm iconbitmap \fIwindow\fR ?\fIbitmap\fR?
.
If \fIbitmap\fR is specified, then it names a bitmap in the standard
forms accepted by Tk (see the \fBTk_GetBitmap\fR manual entry for details).
This bitmap is passed to the window manager to be displayed in
\fIwindow\fR's icon, and the command returns an empty string.  If
an empty string is specified for \fIbitmap\fR, then any current icon
bitmap is cancelled for \fIwindow\fR.
If \fIbitmap\fR is specified then the command returns an empty string.
Otherwise it returns the name of
the current icon bitmap associated with \fIwindow\fR, or an empty
string if \fIwindow\fR has no icon bitmap.  On the Windows operating
system, an additional flag is supported:
.RS
.TP
\fBwm iconbitmap \fIwindow\fR ?\fB\-default\fR? ?\fIimage\fR?
.
If the \fB\-default\fR
flag is given, the icon is applied to all toplevel windows (existing
and future) to which no other specific icon has yet been applied.
In addition to bitmap image types, a full path specification to
any file which contains a valid
Windows icon is also accepted (usually .ico or .icr files), or any
file for which the shell has assigned an icon.  Tcl will
first test if the file contains an icon, then if it has an assigned
icon, and finally, if that fails, test for
a bitmap.
.RE
.TP
\fBwm iconify \fIwindow\fR
.
Arrange for \fIwindow\fR to be iconified.  It \fIwindow\fR has not
yet been mapped for the first time, this command will arrange for
it to appear in the iconified state when it is eventually mapped.
.TP
\fBwm iconmask \fIwindow\fR ?\fIbitmap\fR?
.
If \fIbitmap\fR is specified, then it names a bitmap in the standard
forms accepted by Tk (see the \fBTk_GetBitmap\fR manual entry for details).
This bitmap is passed to the window manager to be used as a mask
in conjunction with the \fBiconbitmap\fR option:  where the mask
has zeroes no icon will be displayed;  where it has ones, the bits
from the icon bitmap will be displayed.  If
an empty string is specified for \fIbitmap\fR then any current icon
mask is cancelled for \fIwindow\fR (this is equivalent to specifying
a bitmap of all ones).  If \fIbitmap\fR is specified
then the command returns an empty string.  Otherwise it
returns the name of the current icon mask associated with
\fIwindow\fR, or an empty string if no mask is in effect.
.TP
\fBwm iconname \fIwindow\fR ?\fInewName\fR?
.
If \fInewName\fR is specified, then it is passed to the window
manager;  the window manager should display \fInewName\fR inside
the icon associated with \fIwindow\fR.  In this case an empty
string is returned as result.  If \fInewName\fR is not specified
then the command returns the current icon name for \fIwindow\fR,
or an empty string if no icon name has been specified (in this
case the window manager will normally display the window's title,
as specified with the \fBwm title\fR command).
.TP
\fBwm iconphoto \fIwindow\fR ?\fB\-default\fR? \fIimage1\fR ?\fIimage2 ...\fR?
.
Sets the titlebar icon for \fIwindow\fR based on the named photo images.
If \fB\-default\fR is specified, this is applied to all future created
toplevels as well.  The data in the images is taken as a snapshot at the
time of invocation.  If the images are later changed, this is not
reflected to the titlebar icons.  Multiple images are accepted to allow
different images sizes (e.g., 16x16 and 32x32) to be provided. The window
manager may scale provided icons to an appropriate size.
.RS
.PP
On Windows, the images are packed into a Windows icon structure.
This will override an ico specified to \fBwm iconbitmap\fR, and
vice versa.
.PP
On X, the images are arranged into the _NET_WM_ICON X property, which
most modern window managers support.  A \fBwm iconbitmap\fR may exist
simultaneously.  It is recommended to use not more than 2 icons, placing
the larger icon first.
.PP
On Macintosh, this currently does nothing.
.RE
.TP
\fBwm iconposition \fIwindow\fR ?\fIx y\fR?
.
If \fIx\fR and \fIy\fR are specified, they are passed to the window
manager as a hint about where to position the icon for \fIwindow\fR.
In this case an empty string is returned.  If \fIx\fR and \fIy\fR are
specified as empty strings then any existing icon position hint is cancelled.
If neither \fIx\fR nor \fIy\fR is specified, then the command returns
a Tcl list containing two values, which are the current icon position
hints (if no hints are in effect then an empty string is returned).
.TP
\fBwm iconwindow \fIwindow\fR ?\fIpathName\fR?
.
If \fIpathName\fR is specified, it is the path name for a window to
use as icon for \fIwindow\fR: when \fIwindow\fR is iconified then
\fIpathName\fR will be mapped to serve as icon, and when \fIwindow\fR
is de-iconified then \fIpathName\fR will be unmapped again.  If
\fIpathName\fR is specified as an empty string then any existing
icon window association for \fIwindow\fR will be cancelled.  If
the \fIpathName\fR argument is specified then an empty string is
returned.  Otherwise the command returns the path name of the
current icon window for \fIwindow\fR, or an empty string if there
is no icon window currently specified for \fIwindow\fR.
Button press events are disabled for \fIwindow\fR as long as it is
an icon window;  this is needed in order to allow window managers to
.QW own
those events.
Note: not all window managers support the notion of an icon window.
.TP
\fBwm manage \fIwidget\fR
.
The \fIwidget\fR specified will become a stand alone top-level window.  The
window will be decorated with the window managers title bar, etc. Only
\fIframe\fR, \fIlabelframe\fR and \fItoplevel\fR widgets can be used
with this command. Attempting to pass any other widget type will raise
an error. Attempting to manage a \fItoplevel\fR widget is benign and
achieves nothing. See also \fBGEOMETRY MANAGEMENT\fR.
.TP
\fBwm maxsize \fIwindow\fR ?\fIwidth height\fR?
.
If \fIwidth\fR and \fIheight\fR are specified, they give
the maximum permissible dimensions for \fIwindow\fR.
For gridded windows the dimensions are specified in
grid units;  otherwise they are specified in pixel units.
The window manager will restrict the window's dimensions to be
less than or equal to \fIwidth\fR and \fIheight\fR.
If \fIwidth\fR and \fIheight\fR are
specified, then the command returns an empty string.  Otherwise
it returns a Tcl list with two elements, which are the
maximum width and height currently in effect.
The maximum size defaults to the size of the screen.
See the sections on geometry management below for more information.
.TP
\fBwm minsize \fIwindow\fR ?\fIwidth height\fR?
.
If \fIwidth\fR and \fIheight\fR are specified, they give the
minimum permissible dimensions for \fIwindow\fR.
For gridded windows the dimensions are specified in
grid units;  otherwise they are specified in pixel units.
The window manager will restrict the window's dimensions to be
greater than or equal to \fIwidth\fR and \fIheight\fR.
If \fIwidth\fR and \fIheight\fR are
specified, then the command returns an empty string.  Otherwise
it returns a Tcl list with two elements, which are the
minimum width and height currently in effect.
The minimum size defaults to one pixel in each dimension.
See the sections on geometry management below for more information.
.TP
\fBwm overrideredirect \fIwindow\fR ?\fIboolean\fR?
.
If \fIboolean\fR is specified, it must have a proper boolean form and
the override-redirect flag for \fIwindow\fR is set to that value.
If \fIboolean\fR is not specified then \fB1\fR or \fB0\fR is
returned to indicate whether or not the override-redirect flag
is currently set for \fIwindow\fR.
Setting the override-redirect flag for a window causes
it to be ignored by the window manager;  among other things, this means
that the window will not be reparented from the root window into a
decorative frame and the user will not be able to manipulate the
window using the normal window manager mechanisms.
.RS
.PP
Note that the override-redirect flag is only guaranteed to be taken notice of
when the window is first mapped or when mapped after the state is changed from
withdrawn to normal. Some, but not all, platforms will take notice at
additional times.
.RE
.TP
\fBwm positionfrom \fIwindow\fR ?\fIwho\fR?
.
If \fIwho\fR is specified, it must be either \fBprogram\fR or
\fBuser\fR, or an abbreviation of one of these two.  It indicates
whether \fIwindow\fR's current position was requested by the
program or by the user.  Many window managers ignore program-requested
initial positions and ask the user to manually position the window;  if
\fBuser\fR is specified then the window manager should position the
window at the given place without asking the user for assistance.
If \fIwho\fR is specified as an empty string, then the current position
source is cancelled.
If \fIwho\fR is specified, then the command returns an empty string.
Otherwise it returns \fBuser\fR or \fBprogram\fR to indicate the
source of the window's current position, or an empty string if
no source has been specified yet.  Most window managers interpret
.QW "no source"
as equivalent to \fBprogram\fR.
Tk will automatically set the position source to \fBuser\fR
when a \fBwm geometry\fR command is invoked, unless the source has
been set explicitly to \fBprogram\fR.
.TP
\fBwm protocol \fIwindow\fR ?\fIname\fR? ?\fIcommand\fR?
.
This command is used to manage window manager protocols such as
\fBWM_DELETE_WINDOW\fR.
\fIName\fR is the name of an atom corresponding to a window manager
protocol, such as \fBWM_DELETE_WINDOW\fR or \fBWM_SAVE_YOURSELF\fR
or \fBWM_TAKE_FOCUS\fR.
If both \fIname\fR and \fIcommand\fR are specified, then \fIcommand\fR
is associated with the protocol specified by \fIname\fR.
\fIName\fR will be added to \fIwindow\fR's \fBWM_PROTOCOLS\fR
property to tell the window manager that the application has a
protocol handler for \fIname\fR, and \fIcommand\fR will
be invoked in the future whenever the window manager sends a
message to the client for that protocol.
In this case the command returns an empty string.
If \fIname\fR is specified but \fIcommand\fR is not, then the current
command for \fIname\fR is returned, or an empty string if there
is no handler defined for \fIname\fR.
If \fIcommand\fR is specified as an empty string then the current
handler for \fIname\fR is deleted and it is removed from the
\fBWM_PROTOCOLS\fR property on \fIwindow\fR;  an empty string is
returned.
Lastly, if neither \fIname\fR nor \fIcommand\fR is specified, the
command returns a list of all the protocols for which handlers
are currently defined for \fIwindow\fR.
.RS
.PP
Tk always defines a protocol handler for \fBWM_DELETE_WINDOW\fR, even if
you have not asked for one with \fBwm protocol\fR.
If a \fBWM_DELETE_WINDOW\fR message arrives when you have not defined
a handler, then Tk handles the message by destroying the window for
which it was received.
.RE
.TP
\fBwm resizable \fIwindow\fR ?\fIwidth height\fR?
.
This command controls whether or not the user may interactively
resize a top-level window.  If \fIwidth\fR and \fIheight\fR are
specified, they are boolean values that determine whether the
width and height of \fIwindow\fR may be modified by the user.
In this case the command returns an empty string.
If \fIwidth\fR and \fIheight\fR are omitted then the command
returns a list with two 0/1 elements that indicate whether the
width and height of \fIwindow\fR are currently resizable.
By default, windows are resizable in both dimensions.
If resizing is disabled, then the window's size will be the size
from the most recent interactive resize or \fBwm geometry\fR
command.  If there has been no such operation then
the window's natural size will be used.
.TP
\fBwm sizefrom \fIwindow\fR ?\fIwho\fR?
.
If \fIwho\fR is specified, it must be either \fBprogram\fR or
\fBuser\fR, or an abbreviation of one of these two.  It indicates
whether \fIwindow\fR's current size was requested by the
program or by the user.  Some window managers ignore program-requested
sizes and ask the user to manually size the window;  if
\fBuser\fR is specified then the window manager should give the
window its specified size without asking the user for assistance.
If \fIwho\fR is specified as an empty string, then the current size
source is cancelled.
If \fIwho\fR is specified, then the command returns an empty string.
Otherwise it returns \fBuser\fR or \fBwindow\fR to indicate the
source of the window's current size, or an empty string if
no source has been specified yet.  Most window managers interpret
.QW "no source"
as equivalent to \fBprogram\fR.
.TP
\fBwm stackorder \fIwindow\fR ?\fBisabove\fR|\fBisbelow \fIwindow\fR?
.
The \fBstackorder\fR command returns a list of toplevel windows
in stacking order, from lowest to highest. When a single toplevel
window is passed, the returned list recursively includes all of the
window's children that are toplevels. Only those toplevels
that are currently mapped to the screen are returned.
The \fBstackorder\fR command can also be used to determine if one
toplevel is positioned above or below a second toplevel.
When two window arguments separated by either \fBisabove\fR or
\fBisbelow\fR are passed, a boolean result indicates whether
or not the first window is currently above or below the second
window in the stacking order.
.TP
\fBwm state \fIwindow\fR ?newstate?
.
If \fInewstate\fR is specified, the window will be set to the new state,
otherwise it returns the current state of \fIwindow\fR: either
\fBnormal\fR, \fBiconic\fR, \fBwithdrawn\fR, \fBicon\fR, or (Windows and Mac
OS X only) \fBzoomed\fR.
The difference between \fBiconic\fR and \fBicon\fR is that
\fBiconic\fR refers to a window that has been iconified (e.g., with the
\fBwm iconify\fR command) while \fBicon\fR refers to a window whose only
purpose is to serve as the icon for some other window (via the \fBwm
iconwindow\fR command).  The \fBicon\fR state cannot be set.
.TP
\fBwm title \fIwindow\fR ?\fIstring\fR?
.
If \fIstring\fR is specified, then it will be passed to the window
manager for use as the title for \fIwindow\fR (the window manager
should display this string in \fIwindow\fR's title bar).  In this
case the command returns an empty string.  If \fIstring\fR is not
specified then the command returns the current title for the
\fIwindow\fR.  The title for a window defaults to its name.
.TP
\fBwm transient \fIwindow\fR ?\fImaster\fR?
.
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).  If \fImaster\fR
is specified as an empty string then \fIwindow\fR is marked as not
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 is not 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
causes the window to be unmapped and forgotten about by the window
manager.  If the window
has never been mapped, then this command
causes the window to be mapped in the withdrawn state.  Not all
window managers appear to know how to handle windows that are
mapped in the withdrawn state.
Note: it sometimes seems to be necessary to withdraw a
window and then re-map it (e.g. with \fBwm deiconify\fR) to get some
window managers to pay attention to changes in window attributes
such as group.
.SH "GEOMETRY MANAGEMENT"
.PP
By default a top-level window appears on the screen in its
\fInatural size\fR, which is the one determined internally by its
widgets and geometry managers.
If the natural size of a top-level window changes, then the window's size
changes to match.
A top-level window can be given a size other than its natural size in two ways.
First, the user can resize the window manually using the facilities
of the window manager, such as resize handles.
Second, the application can request a particular size for a
top-level window using the \fBwm geometry\fR command.
These two cases are handled identically by Tk;  in either case,
the requested size overrides the natural size.
You can return the window to its natural by invoking \fBwm geometry\fR
with an empty \fIgeometry\fR string.
.PP
Normally a top-level window can have any size from one pixel in each
dimension up to the size of its screen.
However, you can use the \fBwm minsize\fR and \fBwm maxsize\fR commands
to limit the range of allowable sizes.
The range set by \fBwm minsize\fR and \fBwm maxsize\fR applies to
all forms of resizing, including the window's natural size as
well as manual resizes and the \fBwm geometry\fR command.
You can also use the command \fBwm resizable\fR to completely
disable interactive resizing in one or both dimensions.
.PP
The \fBwm manage\fR and \fBwm forget\fR commands may be used to
perform undocking and docking of windows.  After a widget is managed
by \fBwm manage\fR command, all other \fBwm\fR subcommands may be used
with the widget.  Only widgets created using the toplevel command may
have an attached menu via the \fB\-menu\fR configure option.  A toplevel
widget may be used as a frame and managed with any of the other
geometry managers after using the \fBwm forget\fR command.  Any menu
associated with a toplevel widget will be hidden when managed by
another geometry managers.  The menus will reappear once the window is
managed by \fBwm\fR.  All custom bindtags for widgets in a subtree
that have their top-level widget changed via a \fBwm manage\fR or
\fBwm forget\fR command, must be redone to adjust any top-level widget
path in the bindtags. Bindtags that have not been customized do not
have to be redone.
.SH "GRIDDED GEOMETRY MANAGEMENT"
.PP
Gridded geometry management occurs when one of the widgets of an
application supports a range of useful sizes.
This occurs, for example, in a text editor where the scrollbars,
menus, and other adornments are fixed in size but the edit widget
can support any number of lines of text or characters per line.
In this case, it is usually desirable to let the user specify the
number of lines or characters-per-line, either with the
\fBwm geometry\fR command or by interactively resizing the window.
In the case of text, and in other interesting cases also, only
discrete sizes of the window make sense, such as integral numbers
of lines and characters-per-line;  arbitrary pixel sizes are not useful.
.PP
Gridded geometry management provides support for this kind of
application.
Tk (and the window manager) assume that there is a grid of some
sort within the application and that the application should be
resized in terms of \fIgrid units\fR rather than pixels.
Gridded geometry management is typically invoked by turning on
the \fBsetGrid\fR option for a widget;  it can also be invoked
with the \fBwm grid\fR command or by calling \fBTk_SetGrid\fR.
In each of these approaches the particular widget (or sometimes
code in the application as a whole) specifies the relationship between 
integral grid sizes for the window and pixel sizes.
To return to non-gridded geometry management, invoke
\fBwm grid\fR with empty argument strings.
.PP
When gridded geometry management is enabled then all the dimensions specified
in \fBwm minsize\fR, \fBwm maxsize\fR, and \fBwm geometry\fR commands
are treated as grid units rather than pixel units.
Interactive resizing is also carried out in even numbers of grid units
rather than pixels.
.SH BUGS
.PP
Most existing window managers appear to have bugs that affect the
operation of the \fBwm\fR command.  For example, some changes will not
take effect if the window is already active:  the window will have
to be withdrawn and de-iconified in order to make the change happen.
.SH EXAMPLES
.PP
A fixed-size window that says that it is fixed-size too:
.CS
toplevel .fixed
\fBwm title\fR     .fixed "Fixed-size Window"
\fBwm resizable\fR .fixed 0 0
.CE
.PP
A simple dialog-like window, centred on the screen:
.CS
# Create and arrange the dialog contents.
toplevel .msg
label  .msg.l  \-text "This is a very simple dialog demo."
button .msg.ok \-text OK \-default active \-command {destroy .msg}
pack .msg.ok \-side bottom \-fill x
pack .msg.l  \-expand 1    \-fill both

# Now set the widget up as a centred dialog.

# But first, we need the geometry managers to finish setting
# up the interior of the dialog, for which we need to run the
# event loop with the widget hidden completely...
\fBwm withdraw\fR .msg
update
set x [expr {([winfo screenwidth .]\-[winfo width .msg])/2}]
set y [expr {([winfo screenheight .]\-[winfo height .msg])/2}]
\fBwm geometry\fR  .msg +$x+$y
\fBwm transient\fR .msg .
\fBwm title\fR     .msg "Dialog demo"
\fBwm deiconify\fR .msg
.CE
.SH "SEE ALSO"
toplevel(n), winfo(n)
.SH KEYWORDS
aspect ratio, deiconify, focus model, geometry, grid, group, icon, iconify, increments, position, size, title, top-level window, units, window manager
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.41
log
@bug 2239034: restrict [wm manage] to Frame type widgets
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.40 2008/09/23 13:36:58 dkf Exp $
d493 7
@


1.40
log
@Fix [Bug 2118116]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.39 2008/06/30 22:57:03 dkf Exp $
d445 5
a449 1
window will be decorated with the window managers title bar, etc.
@


1.39
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.38 2007/12/13 15:23:44 dgp Exp $
d757 3
@


1.38
log
@merge stable branch onto HEAD
@
text
@d1 1
d9 1
a9 1
'\" RCS: @@(#) $Id: wm.n,v 1.29.2.5 2007/12/10 18:39:28 dgp Exp $
d33 1
d54 1
d66 1
d72 1
d78 1
a78 1
.VS 8.5
a83 1
.VE 8.5
d86 1
d90 1
d94 1
a94 1
.VS 8.5
a99 1
.VE 8.5
d104 1
d110 1
d116 1
d120 1
d125 1
d131 2
a132 3
On X11, the following attributes may be set.
These are not supported by all window managers,
and will have no effect under older WMs.
d136 8
a143 8
Requests that the window should be maximized.
This is the same as \fBwm state zoomed\fR on Windows and Mac OS X.
.PP
On X11, changes to window attributes are performed asynchronously.
Querying the value of an attribute returns the current state,
which will not be the same as the value most recently set
if the window manager has not yet processed the request
or if it does not support the attribute.
d147 1
d160 1
d191 1
d203 1
d213 1
d233 1
d241 1
d250 1
d285 1
d321 1
d332 1
d343 1
a343 1
system, an additional flag is supported: 
d347 1
d361 1
d367 1
d382 1
a390 1
.VS 8.5
d393 1
a412 1
.VE 8.5
d416 1
d426 1
d444 1
d449 1
d464 1
d479 1
d492 1
d513 1
d547 1
d563 1
d581 1
d595 1
d607 1
d616 1
d630 1
d723 1
@


1.38.2.1
log
@[Bug 2239034] Only frame widgets are acceptable for [wm manage]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.38 2007/12/13 15:23:44 dgp Exp $
d420 1
a420 5
window will be decorated with the window managers title bar, etc. Only
\fIframe\fR, \fIlabelframe\fR and \fItoplevel\fR widgets can be used
with this command. Attempting to pass any other widget type will raise
an error. Attempting to manage a \fItoplevel\fR widget is benign and
achieves nothing. See also \fBGEOMETRY MANAGEMENT\fR.
@


1.37
log
@document OSX [wm attr -notify]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.36 2007/10/30 21:29:59 dkf Exp $
@


1.36
log
@More documentation improvements
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.35 2007/10/29 16:04:14 dkf Exp $
d108 3
@


1.35
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.34 2007/10/26 20:13:23 dgp Exp $
d57 1
d59 2
a60 2
On Windows, the following attributes may be set.
.RS
d62 4
a65 5
\fB\-disabled\fR
Specifies whether the window is in a disabled state.
.TP
\fB\-toolwindow\fR
Specifies a toolwindow style window (as defined in the MSDN).
d69 2
a70 1
.VS 8.5
d73 1
d79 7
d88 1
a93 5
.TP
\fB\-fullscreen\fR
Places the window in a mode that takes up the entire screen, has no
borders, and covers the Start menu and taskbar.
.RE
d97 5
a101 1
.RS
a111 8
\fB\-alpha\fR
Specifies the alpha transparency level of the window.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
values outside that range will be constrained.
.TP
\fB\-topmost\fR
Specifies whether this is a topmost window (displays above all other windows).
.TP
a116 5
.TP
\fB\-fullscreen\fR
Places the window in a mode that takes up the entire main screen and hides
the dock and menu bar.
.RE
a121 6
.RS
.TP
\fB\-topmost\fR
Requests that this window should be kept above
all other windows that do not also have the \fB\-topmost\fR
attribute set.
a125 5
.TP
\fB\-fullscreen\fR
Requests that the window should fill the entire screen 
and have no window decorations.
.RE
d132 1
d150 2
d161 1
d174 1
d202 2
d213 1
d242 4
a245 1
units.  \fIX\fR and \fIy\fR specify the desired location of
d257 1
d262 1
d279 2
d287 1
d293 1
d297 1
d321 3
a323 1
\fBwm iconbitmap \fIwindow\fR ?\fB\-default\fR? ?\fIimage\fR?.  
d334 1
a366 1
.RS
d374 1
d544 2
a545 2
\fBwm stackorder \fIwindow\fR ?\fIisabove|isbelow window\fR?
The stackorder command returns a list of toplevel windows
d550 1
a550 1
The stackorder command can also be used to determine if one
d552 2
a553 2
When two window arguments separated by either \fIisabove\fR or
\fIisbelow\fR are passed, a boolean result indicates whether
@


1.34
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.31 2007/10/15 20:54:43 hobbs Exp $
a18 1

d114 2
a115 1
color with some alpha, e.g. "systemTransparent".
d128 1
a128 1
\fB-topmost\fR
d130 1
a130 1
all other windows that do not also have the \fB-topmost\fR
d133 1
a133 1
\fB-zoomed\fR
d135 1
a135 1
This is the same as \fB[wm state zoomed]\fR on Windows and Mac OS X.
d137 1
a137 1
\fB-fullscreen\fR
d155 1
a155 1
If \fIname\fR isn't specified, the command returns the last name
d164 1
a164 1
If \fIwindowList\fR isn't specified, the command returns a list
d192 1
a192 1
If \fIvalue\fR isn't specified then the command returns the last value
d226 1
a226 1
longer managed by \fBwm\fR, however, the -menu configuration will be
d234 1
a234 1
hasn't been reparented by the window manager then the command returns
d247 1
a247 1
is gridded (see GRIDDED GEOMETRY MANAGEMENT below) then the dimensions
d304 1
a304 1
string if \fIwindow\fR isn't part of any group.
d331 1
a331 1
Arrange for \fIwindow\fR to be iconified.  It \fIwindow\fR hasn't
d353 1
a353 1
string is returned as result.  If \fInewName\fR isn't specified
d404 3
a406 2
an icon window;  this is needed in order to allow window managers
to ``own'' those events.
d467 2
a468 1
``no source'' as equivalent to \fBprogram\fR.
d487 1
a487 1
If \fIname\fR is specified but \fIcommand\fR isn't, then the current
d500 2
a501 2
you haven't asked for one with \fBwm protocol\fR.
If a \fBWM_DELETE_WINDOW\fR message arrives when you haven't defined
d535 2
a536 1
``no source'' as equivalent to \fBprogram\fR.
d566 1
a566 1
case the command returns an empty string.  If \fIstring\fR isn't
d578 1
a578 1
empty string if \fIwindow\fR isn't currently a transient window.
d626 1
a626 1
have an attached menu via the -menu configure option.  A toplevel
d672 1
a672 1
operation of the \fBwm\fR command.  For example, some changes won't
@


1.33
log
@Lots of improvements to look and feel of manual pages
@
text
@d7 3
a9 3
'\"
'\" RCS: @@(#) $Id: wm.n,v 1.32 2007/10/23 15:44:36 dkf Exp $
'\"
d115 1
a115 2
color with some alpha, such as
.QW systemTransparent .
d128 1
a128 1
\fB\-topmost\fR
d130 1
a130 1
all other windows that do not also have the \fB\-topmost\fR
d133 1
a133 1
\fB\-zoomed\fR
d137 2
a138 2
\fB\-fullscreen\fR
Requests that the window should fill the entire screen
a222 1
.VS 8.5
d226 2
a227 4
longer managed by \fBwm\fR, however, the \-menu configuration will be
remembered and the menus will return once the widget is managed again. See
\fBGEOMETRY MANAGEMENT\fR below for more details.
.VE 8.5
d247 1
a247 1
is gridded (see \fBGRIDDED GEOMETRY MANAGEMENT\fR below) then the dimensions
d317 2
a318 2
system, an additional flag is supported:
\fBwm iconbitmap \fIwindow\fR ?\fB\-default\fR? ?\fIimage\fR?.
d405 1
a405 5
to
.QW own
those events.
.RS
.PP
a406 1
.RE
a408 1
.VS 8.5
d410 1
a410 3
window will be decorated with the window managers title bar, etc. See
\fBGEOMETRY MANAGEMENT\fR below for more details.
.VE 8.5
d466 1
a466 2
.QW "no source"
as equivalent to \fBprogram\fR.
d533 1
a533 2
.QW "no source"
as equivalent to \fBprogram\fR.
a618 1
.VS 8.5
a632 1
.VE 8.5
d656 1
a656 1
code in the application as a whole) specifies the relationship between
@


1.32
log
@Rendering-with-groff GOOBE.
@
text
@d7 3
a9 3
'\" 
'\" RCS: @@(#) $Id: wm.n,v 1.31 2007/10/15 20:54:43 hobbs Exp $
'\" 
d115 2
a116 1
color with some alpha, e.g. "systemTransparent".
d129 1
a129 1
\fB-topmost\fR
d131 1
a131 1
all other windows that do not also have the \fB-topmost\fR
d134 1
a134 1
\fB-zoomed\fR
d138 2
a139 2
\fB-fullscreen\fR
Requests that the window should fill the entire screen 
d321 2
a322 2
system, an additional flag is supported: 
\fBwm iconbitmap \fIwindow\fR ?\fB\-default\fR? ?\fIimage\fR?.  
d409 3
a411 1
to ``own'' those events.
d478 2
a479 1
``no source'' as equivalent to \fBprogram\fR.
d546 2
a547 1
``no source'' as equivalent to \fBprogram\fR.
d672 1
a672 1
code in the application as a whole) specifies the relationship between 
@


1.31
log
@whitespace change
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.30 2007/10/15 20:52:47 hobbs Exp $
d223 1
d227 4
a230 2
longer managed by \fBwm\fR, however, the -menu configuration will be
remembered and the menus will return once the widget is managed again.
d250 1
a250 1
is gridded (see GRIDDED GEOMETRY MANAGEMENT below) then the dimensions
d409 2
d412 1
d415 1
d417 3
a419 1
window will be decorated with the window managers title bar, etc.
d628 1
d643 1
@


1.30
log
@	* generic/tkFocus.c, generic/tkFrame.c, generic/tkInt.h:
	* macosx/tkMacOSXButton.c, macosx/tkMacOSXMenubutton.c:
	* macosx/tkMacOSXWm.c, unix/tkUnixWm.c, win/tkWinWm.c:
	* doc/wm.n, tests/wm.test: TIP #125 implementation [Bug 998125]
	Adds [wm manage|forget] for dockable frames.
	Finished X11 and Windows code, needs OS X completion.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.29 2007/04/23 21:19:52 das Exp $
d409 2
a410 3

The \fIwidget\fR specified will become a stand alone top-level window.  The window will be decorated with the window managers title bar, etc.

@


1.29
log
@	* doc/colors.n:		document new Mac OS X system colors.
	* doc/cursors.n:	document new Mac OS X native cursors.
	* doc/font.n:		document new Mac OS X 'menu' system font.
	* doc/wm.n:		document new Mac OS X [wm attributes].
	* doc/ttk_image.n:	fix 'make html' warning.
	* doc/canvas.n:		fix nroff typo.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.28 2006/12/01 19:48:00 hobbs Exp $
d222 7
d408 5
d619 15
@


1.29.2.1
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.29 2007/04/23 21:19:52 das Exp $
a221 7
\fBwm forget \fIwindow\fR
The \fIwindow\fR will be unmapped from the screen and will no longer
be managed by \fBwm\fR.  Windows created with the \fBtoplevel\fR
command will be treated like \fBframe\fR windows once they are no
longer managed by \fBwm\fR, however, the -menu configuration will be
remembered and the menus will return once the widget is managed again.
.TP
a400 4
\fBwm manage \fIwidget\fR
The \fIwidget\fR specified will become a stand alone top-level window.  The
window will be decorated with the window managers title bar, etc.
.TP
a606 15
.PP
The \fBwm manage\fR and \fBwm forget\fR commands may be used to
perform undocking and docking of windows.  After a widget is managed
by \fBwm manage\fR command, all other \fBwm\fR subcommands may be used
with the widget.  Only widgets created using the toplevel command may
have an attached menu via the -menu configure option.  A toplevel
widget may be used as a frame and managed with any of the other
geometry managers after using the \fBwm forget\fR command.  Any menu
associated with a toplevel widget will be hidden when managed by
another geometry managers.  The menus will reappear once the window is
managed by \fBwm\fR.  All custom bindtags for widgets in a subtree
that have their top-level widget changed via a \fBwm manage\fR or
\fBwm forget\fR command, must be redone to adjust any top-level widget
path in the bindtags. Bindtags that have not been customized do not
have to be redone.
@


1.29.2.2
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.29.2.1 2007/10/16 04:03:53 dgp Exp $
a222 1
.VS 8.5
d226 2
a227 4
longer managed by \fBwm\fR, however, the \-menu configuration will be
remembered and the menus will return once the widget is managed again. See
\fBGEOMETRY MANAGEMENT\fR below for more details.
.VE 8.5
d247 1
a247 1
is gridded (see \fBGRIDDED GEOMETRY MANAGEMENT\fR below) then the dimensions
a405 2
.RS
.PP
a406 1
.RE
a408 1
.VS 8.5
d410 1
a410 3
window will be decorated with the window managers title bar, etc. See
\fBGEOMETRY MANAGEMENT\fR below for more details.
.VE 8.5
a618 1
.VS 8.5
a632 1
.VE 8.5
@


1.29.2.3
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.29.2.2 2007/10/24 12:59:32 dgp Exp $
d223 1
d227 4
a230 2
longer managed by \fBwm\fR, however, the -menu configuration will be
remembered and the menus will return once the widget is managed again.
d250 1
a250 1
is gridded (see GRIDDED GEOMETRY MANAGEMENT below) then the dimensions
d409 2
d412 1
d415 1
d417 3
a419 1
window will be decorated with the window managers title bar, etc.
d628 1
d643 1
@


1.29.2.4
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id$
d19 1
d58 2
a60 3
.PP
All platforms support the following attributes (though X11 users
should see the notes below):
d62 5
a66 4
\fB\-fullscreen\fR
Places the window in a mode that takes up the entire screen, has no
borders, and covers the general use area (i.e. Start menu and taskbar on
Windows, dock and menubar on OSX, general window decorations on X11).
d70 1
a70 2
.PP
On Windows, the following attributes may be set.
a72 1
.VS 8.5
a77 7
.VE 8.5
.TP
\fB\-disabled\fR
Specifies whether the window is in a disabled state.
.TP
\fB\-toolwindow\fR
Specifies a toolwindow style window (as defined in the MSDN).
a79 1
.VS 8.5
d85 5
d93 1
a93 5
.TP
\fB\-alpha\fR
Specifies the alpha transparency level of the window.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
values outside that range will be constrained.
d104 8
d115 6
a120 2
color with some alpha, e.g.
.QW systemTransparent .
d126 6
d133 1
a133 1
\fB\-zoomed\fR
d135 6
a140 1
This is the same as \fBwm state zoomed\fR on Windows and Mac OS X.
a146 1
.RE
d155 1
a155 1
If \fIname\fR is not specified, the command returns the last name
d164 1
a164 3
.RS
.PP
If \fIwindowList\fR is not specified, the command returns a list
a172 1
.PP
a184 1
.RE
d192 1
a192 1
If \fIvalue\fR is not specified then the command returns the last value
a211 2
.RS
.PP
a220 1
.RE
d226 1
a226 1
longer managed by \fBwm\fR, however, the \fB\-menu\fR configuration will be
d234 1
a234 1
has not been reparented by the window manager then the command returns
d247 1
a247 1
is gridded (see \fBGRIDDED GEOMETRY MANAGEMENT\fR below) then the dimensions
d249 1
a249 4
units.
.RS
.PP
\fIX\fR and \fIy\fR specify the desired location of
a260 1
.PP
a264 1
.RE
a280 2
.RS
.PP
a286 1
.PP
a291 1
.PP
a294 1
.RE
d304 1
a304 1
string if \fIwindow\fR is not part of any group.
d318 1
a318 3
.RS
.TP
\fBwm iconbitmap \fIwindow\fR ?\fB\-default\fR? ?\fIimage\fR?
a328 1
.RE
d331 1
a331 1
Arrange for \fIwindow\fR to be iconified.  It \fIwindow\fR has not
d353 1
a353 1
string is returned as result.  If \fInewName\fR is not specified
d361 1
a368 1
.RS
d404 2
a405 3
an icon window;  this is needed in order to allow window managers to
.QW own
those events.
d466 1
a466 2
.QW "no source"
as equivalent to \fBprogram\fR.
d485 1
a485 1
If \fIname\fR is specified but \fIcommand\fR is not, then the current
d498 2
a499 2
you have not asked for one with \fBwm protocol\fR.
If a \fBWM_DELETE_WINDOW\fR message arrives when you have not defined
d533 1
a533 2
.QW "no source"
as equivalent to \fBprogram\fR.
d535 2
a536 2
\fBwm stackorder \fIwindow\fR ?\fBisabove\fR|\fBisbelow \fIwindow\fR?
The \fBstackorder\fR command returns a list of toplevel windows
d541 1
a541 1
The \fBstackorder\fR command can also be used to determine if one
d543 2
a544 2
When two window arguments separated by either \fBisabove\fR or
\fBisbelow\fR are passed, a boolean result indicates whether
d563 1
a563 1
case the command returns an empty string.  If \fIstring\fR is not
d575 1
a575 1
empty string if \fIwindow\fR is not currently a transient window.
d623 1
a623 1
have an attached menu via the \fB\-menu\fR configure option.  A toplevel
d669 1
a669 1
operation of the \fBwm\fR command.  For example, some changes will not
@


1.29.2.5
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.29.2.4 2007/11/01 16:37:16 dgp Exp $
a107 3
\fB\-notify\fR
Specifies process notification state (bouncing of the application dock icon).
.TP
@


1.28
log
@	* doc/wm.n, tests/winWm.test:
	* win/tkWinWm.c: add -transparentcolor attribute for Windows.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.27 2006/11/16 13:50:17 dkf Exp $
d108 12
@


1.27
log
@Minor fixes/improvements
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.26 2006/11/15 13:29:17 dkf Exp $
a52 1
.RS
d59 11
a69 4
On Windows, \fB\-disabled\fR gets or sets whether the window is in a
disabled state. \fB\-toolwindow\fR gets or sets the style of the window
to toolwindow (as defined in the MSDN). \fB\-topmost\fR gets or sets
whether this is a topmost window (displays above all other windows).
d71 19
a89 10
The
\fB\-alpha\fR sets the alpha transparency level of the toplevel.  It accepts
a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque).  Values
outside that range will be constrained.  This is supported on Windows
2000/XP+.  Where not supported, the \fB\-alpha\fR value remains at
\fB1.0\fR.
The
\fB\-fullscreen\fR attribute will place the window in a mode that
takes up the entire screen, has no borders, and covers the Start
menu and taskbar.
d92 15
a106 7
On Mac OS X, \fB\-modified\fR gets or sets the modification state of the
window (determines whether the window close widget contains the modification
indicator and whether the proxy icon is draggable).
\fB\-titlepath\fR gets or sets the path of the file referenced as
the window proxy icon (which can be dragged and dropped in lieu of the file's
finder icon). \fB\-alpha\fR sets the alpha transparency level of the window,
it accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
d108 1
a134 1
.RE
d360 1
a360 1
On Macintosh, this is currently does nothing.
@


1.26
log
@Convert \fP to \fR so that man-page scrapers have an easier time.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.25 2006/04/11 07:36:36 das Exp $
d325 1
a325 1
different images sizes (eg, 16x16 and 32x32) to be provided.  The window
a641 1

a643 1

@


1.25
log
@	* macosx/tkMacOSXInt.h:         Implemented 'zoomed' window state
	* macosx/tkMacOSXWindowEvent.c: handling for TkAqua, via titlebar
	* macosx/tkMacOSXWm.c:          widget clicks as well as [wm state].
	* doc/wm.n:                     [Bug 1073456]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.24 2005/11/16 02:51:38 jenglish Exp $
d92 1
a92 1
\fB-topmost\fP
d94 1
a94 1
all other windows that do not also have the \fB-topmost\fP
d97 1
a97 1
\fB-zoomed\fP
d99 1
a99 1
This is the same as \fB[wm state zoomed]\fP on Windows and Mac OS X.
d101 1
a101 1
\fB-fullscreen\fP
@


1.24
log
@Added support for [wm attributes] on X11 [TIP#231, patch#1062022].
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.23 2005/04/06 21:11:54 dkf Exp $
d79 2
a80 1
indicator). \fB\-titlepath\fR gets or sets the path of the file referenced as
d99 1
a99 1
This is the same as \fB[wm state zoomed]\fP on Windows.
d505 3
a507 2
\fBnormal\fR, \fBiconic\fR, \fBwithdrawn\fR, \fBicon\fR, or (Windows only)
\fBzoomed\fR.  The difference between \fBiconic\fR and \fBicon\fR is that
@


1.23
log
@Purge old and inaccurate .VS/.VE macros.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.22 2005/02/17 00:06:08 mdejong Exp $
d85 25
a109 1
On Unix, there are currently no special attribute values.
@


1.22
log
@	* doc/wm.n: Add documentation for -fullscreen attribute.
	* tests/winWm.test: Add -fullscreen to wm attribute
	usage message.
	* tests/wm.test: Add -fullscreen to wm attribute
	usage message. Add -fullscreen attribute test cases
	for Windows.
	* win/tkWinWm.c (WmInfo, UpdateWrapper, TkpWmSetFullScreen,
	WmAttributesCmd, UpdateGeometryInfo):
	Implement TIP 223 [wm attributes -fullscreen].
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.21 2004/11/11 01:24:31 das Exp $
a46 1
.VS 8.4
d65 1
d71 1
a71 1
.VE 8.5
a86 1
.VE 8.4
a162 1
.VS
a168 1
.VE
@


1.21
log
@	* generic/tkMain.c:
	* macosx/tkMacOSXAppInit.c (removed):
	* macosx/Wish.pbproj/project.pbxproj:
	* macosx/tkMacOSXInit.c:
	* macosx/tkMacOSXInt.h: changes to make TkAqua dynamically loadable,
	enabling [package require Tk] from tclsh. Startup code from
	tkMacOSXAppInit.c moved into tkMacOSXInit.c, added code that
	notifies the window server that an unbundled executable is a full
	GUI application after loading Tk. [Patch 1035348]

	* doc/wm.n: documented [wm attributes] on Mac OS X. [Bug 606665]
	* macosx/tkMacOSXWm.c: implemented TIP 222 [wm attributes -alpha] on
	Mac OS X. [Patch 892194]
	WmIconbitmapCmd: adopted FSRef changes from [wm atttrs -titlepath].

	* macosx/tkMacOSXSubwindows.c: synced spacing/formatting with
	core-8-4-branch.

	* generic/tkRectOval.c:
	* macosx/README:
	* macosx/tkMacOSXDefault.h:
	* macosx/tkMacOSXDraw.c:
	* macosx/tkMacOSXInit.c:
	* macosx/tkMacOSXInt.h:
	* macosx/tkMacOSXMenu.c:
	* macosx/tkMacOSXWm.c: forward port from core-8-4-branch of Jim's
	and my changes for CG drawing and [wm attributes] (corresponds to
	8.4 changes dating from 09-18, 07-27, 07-24).

	* macosx/tkMacOSXMouseEvent.c: endianness fixes.

	* macosx/Wish.pbproj/project.pbxproj: corrected path to html help
	inside framework.

	* macosx/Makefile: prevent parallel make from building several
	targets at the same time.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.20 2004/10/28 12:25:53 dkf Exp $
d72 4
@


1.20
log
@More minor doc fixes
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.19 2004/10/08 23:15:32 dkf Exp $
d73 7
a79 2
On Macintosh, there are currently two attribute values:
\fB\-modified\fR and \fB\-titlepath\fR.
@


1.19
log
@Fill in missing part of sentence in [wm attributes]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.18 2004/10/07 17:39:51 hobbs Exp $
d65 1
d71 1
d583 2
a584 2
\fBwm\fR title     .fixed "Fixed-size Window"
\fBwm\fR resizable .fixed 0 0
d601 1
a601 1
\fBwm\fR withdraw .msg
d605 4
a608 4
\fBwm\fR geometry  .msg +$x+$y
\fBwm\fR transient .msg .
\fBwm\fR title     .msg "Dialog demo"
\fBwm\fR deiconify .msg
@


1.18
log
@add iconphoto notes about recommended usage
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.17 2004/10/05 22:04:44 hobbs Exp $
d61 3
a63 3
On Windows, \fB-disabled\fR gets or sets whether the window is in a
disabled state. \fB-toolwindow\fR gets or sets the style of the window
to toolwindow (as defined in the MSDN). \fB-topmost\fR gets or sets
d65 1
a65 1
\fB-alpha\fR sets the alpha transparency level of the toplevel.  It accepts
d68 1
a68 1
2000/XP+.  Where not supported, the \fB-alpha\fR value remains at
d71 2
a72 1
On Macintosh,
d243 2
a244 2
\fBwm iconbitmap \fIwindow\fR ?\fI-default\fR? ?\fIimage\fR?.  
If the \fI-default\fR
d285 1
a285 1
\fBwm iconphoto \fIwindow\fR ?\fI-default\fR? \fIimage1\fR ?\fIimage2 ...\fR?
d288 1
a288 1
If \fI-default\fR is specified, this is applied to all future created
@


1.17
log
@	* doc/wm.n (iconphoto):           added support for Tk photo
	* generic/tkInt.h (TkDisplay):    images as titlebar icons. TIP #159
	* win/tkWinWm.c (WmIconphotoCmd): wm iconphoto ?-default? image1 ...
	* macosx/tkMacOSXWm.c (WmIconphotoCmd): Implemented for Win/Unix,
	* unix/tkUnixWm.c (WmIconphotoCmd):     stubbed out for OS X.
	* tests/wm.test, tests/unixWm.test, tests/winWm.test: [Bug 815751]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.16 2004/09/28 18:54:37 hobbs Exp $
d291 2
a292 1
different images sizes (eg, 16x16 and 32x32) to be provided.
d300 2
a301 1
simultaneously.
@


1.16
log
@clarify wm -alpha docs
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.15 2004/09/17 23:26:21 hobbs Exp $
d282 22
@


1.15
log
@	* doc/wm.n:
	* tests/winWm.test: Add 'wm attributes -alpha' to control toplevel
	* win/tkWinInt.h:   alpha transparency on Win2K/XP+.
	* win/tkWinWm.c:    TIP #222 [Patch 892194]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.14 2004/06/21 19:56:11 dkf Exp $
d11 1
a11 1
.TH wm n 8.4 Tk "Tk Built-In Commands"
d65 1
a65 1
\fB-alpha\fR sets the transparency level of the toplevel.  It accepts
d67 3
a69 3
outside that range will be constrained.  Transparent toplevels are
supported on Windows 2000/XP+.  Where not support, the \fB-alpha\fR value
remains at \fB1.0\fR.
@


1.14
log
@Added example of how to do dialog-like windows
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.13 2004/06/18 22:07:59 dkf Exp $
d65 5
@


1.13
log
@Added example
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.12 2003/03/12 00:25:41 mdejong Exp $
d547 1
a547 1
.SH EXAMPLE
d554 24
@


1.12
log
@	* doc/wm.n (minimize, maximize): Remove claim
	that the resizable command keeps scripts from
	changing the size of windows since it is
	not true. The resizable command only applies
	to user sizing via user interaction.
	* tests/unixWm.test: Replace broken tests with
	the nonPortable constraint with new tests for
	maxsize and minsize options. These tests
	verify that setting the minsize and maxsize
	will resize the window if needed, and that
	the wm hints will be updated with the new sizes.
	* tests/wm.test: Add an exhaustive set of tests
	for the wm maxsize and wm minsize commands.
	These tests verify that setting the minsize
	and maxsize will resize the window if needed.
	These tests have only been run under Win98
	and Window Maker under Linux, so further tweaking
	may be needed for other systems.
	* unix/tkUnixWm.c (UpdateGeometryInfo, UpdateSizeHints):
	Fixup comments and initialization for the minWidth,
	minHeight, maxWidth, maxHeight, width, and height
 	members of the WmInfo struct. Check to ensure
	that a new toplevel window size is not larger
	than the maxsize or smaller than the minsize
	when updating the geometry at idle time.
	Pass new width and height values to the
	UpdateSizeHints method so that it can properly
	set the window min and max sizes for a window
	that cannot be resized by the user. This fixes
	a bug where the window resizes back to the original
	size when the user clicks on the window border.
	* win/tkWinWm.c (UpdateGeometryInfo):
	Fixup comments and initialization for the minWidth,
	minHeight, maxWidth, maxHeight, width, and height
 	members of the WmInfo struct. Check to ensure
	that a new toplevel window size is not larger
	than the maxsize or smaller than the minsize
	when updating the geometry at idle time.
	[Patch 568861]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11 2002/07/16 18:06:41 vincentdarley Exp $
a481 1

a507 1

a540 1

d547 10
@


1.11
log
@WinWm fixes
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.10 2002/06/22 10:13:26 hobbs Exp $
a314 2
If resizing has been disabled with the \fBwm resizable\fR command,
then this command has no effect.
a328 2
If resizing has been disabled with the \fBwm resizable\fR command,
then this command has no effect.
@


1.11.2.1
log
@More backporting of doc fixes
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11 2002/07/16 18:06:41 vincentdarley Exp $
d61 3
a63 3
On Windows, \fB\-disabled\fR gets or sets whether the window is in a
disabled state. \fB\-toolwindow\fR gets or sets the style of the window
to toolwindow (as defined in the MSDN). \fB\-topmost\fR gets or sets
d66 1
a66 2
On Macintosh, there are currently two attribute values:
\fB\-modified\fR and \fB\-titlepath\fR.
d237 2
a238 2
\fBwm iconbitmap \fIwindow\fR ?\fB\-default\fR? ?\fIimage\fR?.  
If the \fB\-default\fR
d315 2
d331 2
d486 1
d513 1
d547 1
a553 34
.SH EXAMPLES
A fixed-size window that says that it is fixed-size too:
.CS
toplevel .fixed
\fBwm title\fR     .fixed "Fixed-size Window"
\fBwm resizable\fR .fixed 0 0
.CE
.PP
A simple dialog-like window, centred on the screen:
.CS
# Create and arrange the dialog contents.
toplevel .msg
label  .msg.l  \-text "This is a very simple dialog demo."
button .msg.ok \-text OK \-default active \-command {destroy .msg}
pack .msg.ok \-side bottom \-fill x
pack .msg.l  \-expand 1    \-fill both

# Now set the widget up as a centred dialog.

# But first, we need the geometry managers to finish setting
# up the interior of the dialog, for which we need to run the
# event loop with the widget hidden completely...
\fBwm withdraw\fR .msg
update
set x [expr {([winfo screenwidth .]\-[winfo width .msg])/2}]
set y [expr {([winfo screenheight .]\-[winfo height .msg])/2}]
\fBwm geometry\fR  .msg +$x+$y
\fBwm transient\fR .msg .
\fBwm title\fR     .msg "Dialog demo"
\fBwm deiconify\fR .msg
.CE

.SH "SEE ALSO"
toplevel(n), winfo(n)
@


1.11.2.2
log
@	* doc/wm.n: Add wm attributes . -alpha doc to account
	for recent alpha changes.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11.2.1 2004/10/28 12:25:22 dkf Exp $
a64 5
\fB\-alpha\fR sets the alpha transparency level of the toplevel.  It accepts
a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque).  Values
outside that range will be constrained.  This is supported on Windows
2000/XP+.  Where not supported, the \fB\-alpha\fR value remains at
\fB1.0\fR.
@


1.11.2.3
log
@	* generic/tkMain.c:
	* macosx/tkMacOSXAppInit.c (removed):
	* macosx/Wish.pbproj/project.pbxproj:
	* macosx/tkMacOSXInit.c:
	* macosx/tkMacOSXInt.h: changes to make TkAqua dynamically loadable,
	enabling [package require Tk] from tclsh. Startup code from
	tkMacOSXAppInit.c moved into tkMacOSXInit.c, added code that
	notifies the window server that an unbundled executable is a full
	GUI application after loading Tk. [Patch 1035348]

	* doc/wm.n: documented [wm attributes] on Mac OS X. [Bug 606665]
	* macosx/tkMacOSXWm.c: implemented TIP 222 [wm attributes -alpha] on
	Mac OS X. [Patch 892194]
	WmIconbitmapCmd: adopted FSRef changes from [wm atttrs -titlepath].

	* macosx/tkMacOSXButton.c:
	* macosx/tkMacOSXMenus.c:
	* macosx/tkMacOSXRegion.c:
	* macosx/tkMacOSXSubwindows.c: synced spacing/formatting with HEAD.

	* macosx/tkMacOSXMouseEvent.c: endianness fixes.

	* macosx/Wish.pbproj/project.pbxproj: corrected path to html help
	inside framework.

	* macosx/Makefile: prevent parallel make from building several
	targets at the same time.
	Ensure that xcodebuild will use Wish.pbproj project even if a .xcode
	project is also present.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11.2.2 2004/10/28 22:40:57 mdejong Exp $
d71 2
a72 7
On Mac OS X, \fB\-modified\fR gets or sets the modification state of the
window (determines whether the window close widget contains the modification
indicator). \fB\-titlepath\fR gets or sets the path of the file referenced as
the window proxy icon (which can be dragged and dropped in lieu of the file's
finder icon). \fB\-alpha\fR sets the alpha transparency level of the window,
it accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
values outside that range will be constrained.
@


1.11.2.4
log
@	* macosx/tkMacOSXInt.h:         Implemented 'zoomed' window state
	* macosx/tkMacOSXWindowEvent.c: handling for TkAqua, via titlebar
	* macosx/tkMacOSXWm.c:          widget clicks as well as [wm state].
	* doc/wm.n:                     [Bug 1073456]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11.2.3 2004/11/11 01:26:42 das Exp $
d73 1
a73 2
indicator and whether the proxy icon is draggable).
\fB\-titlepath\fR gets or sets the path of the file referenced as
d453 2
a454 3
\fBnormal\fR, \fBiconic\fR, \fBwithdrawn\fR, \fBicon\fR, or (Windows and Mac
OS X only) \fBzoomed\fR.
The difference between \fBiconic\fR and \fBicon\fR is that
@


1.11.2.5
log
@	* doc/wm.n, tests/winWm.test:
	* win/tkWinWm.c: add -transparentcolor attribute for Windows.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11.2.4 2006/04/11 07:36:40 das Exp $
d54 1
d61 18
a78 26
On Windows, the following attributes may be set.
.RS
.TP
\fB\-disabled\fR
Specifies whether the window is in a disabled state.
.TP
\fB\-toolwindow\fR
Specifies a toolwindow style window (as defined in the MSDN).
.TP
\fB\-topmost\fR
Specifies whether this is a topmost window (displays above all other windows).
.TP
\fB\-alpha\fR
Specifies the alpha transparency level of the toplevel.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR
(opaque).  Values outside that range will be constrained.  This is
supported on Windows 2000/XP+.  Where not supported, the \fB\-alpha\fR
value remains at \fB1.0\fR.
.TP
\fB\-transparentcolor\fR
Specifies the transparent color index of the toplevel.  It takes any color
value accepted by \fBTk_GetColor\fR.  If the empty string is specified
(default), no transparent color is used.  This is supported on Windows
2000/XP+.  Where not supported, the \fB\-transparentcolor\fR value remains
at \fB{}\fR.
.RE
d80 1
a80 16
On Mac OS X, the following attributes may be set.
.RS
.TP
\fB\-modified\fR
Specifies the modification state of the window (determines whether the
window close widget contains the modification indicator and whether the
proxy icon is draggable).
.TP
\fB\-titlepath\fR
Specifies the path of the file referenced as the window proxy icon (which
can be dragged and dropped in lieu of the file's finder icon).
.TP
\fB\-alpha\fR
Specifies the alpha transparency level of the window.
It accepts a value from \fB0.0\fR (fully transparent) to \fB1.0\fR (opaque),
values outside that range will be constrained.
a81 2
.PP
On X11, there are currently no special attribute values.
@


1.11.2.6
log
@	* doc/colors.n:		document new Mac OS X system colors.
	* doc/cursors.n:	document new Mac OS X native cursors.
	* doc/font.n:		document new Mac OS X 'menu' system font.
	* doc/wm.n:		document new Mac OS X [wm attributes].
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.11.2.5 2006/12/01 19:47:41 hobbs Exp $
a102 12
.TP
\fB\-topmost\fR
Specifies whether this is a topmost window (displays above all other windows).
.TP
\fB\-transparent\fR
Makes the window content area transparent and turns off the window shadow. For
the transparency to be effecive, the toplevel background needs to be set to a
color with some alpha, e.g. "systemTransparent".
.TP
\fB\-fullscreen\fR
Places the window in a mode that takes up the entire main screen and hides
the dock and menu bar.
@


1.10
log
@	* doc/wm.n:                   TIP #95 Windows implementation and
	* mac/tkMacWm.c (Tk_WmCmd):   docs with mac and unix stubs.
	* unix/tkUnixWm.c (Tk_WmCmd):
	* win/tkWinWm.c (Tk_WmCmd):
	* tests/unixWm.test:
	* tests/winWm.test: more wm attr tests will be needed.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.9 2002/06/13 06:33:36 mdejong Exp $
d241 6
a246 3
In addition to bitmap image types, any file which contains a valid
Windows icon is also accepted (usually .ico or .icr files).  Tcl will
first test if the files contains an icon, and if that fails, test for
a553 3
.PP
On the Windows operating system \fIwm iconbitmap\fR has no effect when
passed a bitmap: only icon files currently work properly.
@


1.9
log
@	* 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.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.8 2002/04/10 19:39:01 mdejong Exp $
d11 1
a11 1
.TH wm n 4.3 Tk "Tk Built-In Commands"
d47 24
@


1.8
log
@	* doc/wm.n:
	* mac/tkMacWm.c:
	* tests/wm.test:
	* unix/tkUnixWm.c:
	* win/tkWinWm.c: Update wm stackorder usage message
	to make it clear that either 1 or 3 arguments are
	required. [Bug 540013]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.7 2001/12/04 03:07:43 mdejong Exp $
d438 1
a438 2
path name for a top-level window).  Some window managers will use
this information to manage \fIwindow\fR specially.  If \fImaster\fR
d440 1
a440 2
being a transient window any more.  If \fImaster\fR is specified,
then the command returns an empty string.  Otherwise the command
d443 3
@


1.7
log
@	Add TK patch 481148 to implement TIP 74, the
	wm stackorder command.

	* doc/winfo.n: Update documentation for the winfo
	children command to indicate that top-level windows
	are not returned in stacking order.
	* doc/wm.n: Add documentation for wm stackorder.
	* generic/tkInt.decls (TkWmStackorderToplevel):
	Add decl for new function.
	* generic/tkIntDecls.h: Regen.
	* generic/tkStubInit.c: Regen.
	* tests/unixWm.test: Add stackorder command to test
	for wm command usage message.
	* tests/wm.test: Add new set of tests for generic
	window manager methods.
	* unix/tkUnixWm.c (Tk_WmCmd,
	TkWmStackorderToplevelWrapperMap,
	TkWmStackorderToplevel): Add unix implementation of
	new wm stackorder command.
	* win/tkWinWm.c (Tk_WmCmd,
	TkWmStackorderToplevelEnumProc,
	TkWmStackorderToplevelWrapperMap,
	TkWmStackorderToplevel): Add windows implementation
	of new wm stackorder command.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.6 2001/01/02 19:13:02 andreas_kupries Exp $
d403 1
a403 1
\fBwm stackorder \fIwindow\fR ?\fIisabove|isbelow\fR? \fI?window?\fR
@


1.6
log
@2001-01-02  Andreas Kupries  <a.kupries@@westend.com>

	* win/tkWinWm.c:
	* doc/wm.n: Applied patch #102833 (TIP #8).
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.5 2000/01/12 11:44:42 hobbs Exp $
d402 13
@


1.6.4.1
log
@Merge with current TOT
Added support for the wm stackorder command
Fixed crash when selecting Menu items in the Application menu that we didn't
put there.
Added first bits of the use of CG for low-level drawing.  The line-drawing works,
the rest doesn't yet.  You have to set the file static useCGDrawing to 1 and
rebuild to activate this code.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.6 2001/01/02 19:13:02 andreas_kupries Exp $
a401 13
.TP
\fBwm stackorder \fIwindow\fR ?\fIisabove|isbelow\fR? \fI?window?\fR
The stackorder command returns a list of toplevel windows
in stacking order, from lowest to highest. When a single toplevel
window is passed, the returned list recursively includes all of the
window's children that are toplevels. Only those toplevels
that are currently mapped to the screen are returned.
The stackorder command can also be used to determine if one
toplevel is positioned above or below a second toplevel.
When two window arguments separated by either \fIisabove\fR or
\fIisbelow\fR are passed, a boolean result indicates whether
or not the first window is currently above or below the second
window in the stacking order.
@


1.6.4.2
log
@Merging with TOT as of 06/09/2002.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id$
d403 1
a403 1
\fBwm stackorder \fIwindow\fR ?\fIisabove|isbelow window\fR?
@


1.6.4.3
log
@merged with trunk at tag macosx-8-4-merge-2002-08-20-trunk
@
text
@d11 1
a11 1
.TH wm n 8.4 Tk "Tk Built-In Commands"
a46 24
.VS 8.4
.TP
\fBwm attributes \fIwindow\fR
.TP
\fBwm attributes \fIwindow\fR ?\fBoption\fR?
.TP
\fBwm attributes \fIwindow\fR ?\fBoption value option value...\fR?
.RS
This subcommand returns or sets platform specific attributes associated
with a window. The first form returns a list of the platform specific
flags and their values. The second form returns the value for the
specific option. The third form sets one or more of the values. The
values are as follows:
.PP
On Windows, \fB-disabled\fR gets or sets whether the window is in a
disabled state. \fB-toolwindow\fR gets or sets the style of the window
to toolwindow (as defined in the MSDN). \fB-topmost\fR gets or sets
whether this is a topmost window (displays above all other windows).
.PP
On Macintosh,
.PP
On Unix, there are currently no special attribute values.
.RE
.VE 8.4
d217 3
a219 6
In addition to bitmap image types, a full path specification to
any file which contains a valid
Windows icon is also accepted (usually .ico or .icr files), or any
file for which the shell has assigned an icon.  Tcl will
first test if the file contains an icon, then if it has an assigned
icon, and finally, if that fails, test for
d438 2
a439 1
path name for a top-level window).  If \fImaster\fR
d441 2
a442 1
being a transient window any more.  Otherwise the command
a444 3
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.
d526 3
@


1.5
log
@	* doc/wm.n:
	* tests/winWm.test:
	* tests/unixWm.test:
	* mac/tkMacWm.c:
	* unix/tkUnixWm.c: fixed possible X error being raised [Bug: 3377]
	* win/tkWinWm.c: wm deiconify in zoom state [Bug: 2077],
	fixed possible flashing of unmapped toplevel in deiconify [Bug: 3338]
	and fixed mapping of transient window [Bug: 572]
	Also, for all wm's, extended 'wm state' command to allow setting
	of the state, and added official support of 'zoomed' state on Win.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.4 1999/08/10 16:58:18 hobbs Exp $
d211 10
a220 1
string if \fIwindow\fR has no icon bitmap.
d513 3
@


1.5.4.1
log
@sync with head
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.7 2001/12/04 03:07:43 mdejong Exp $
d211 1
a211 10
string if \fIwindow\fR has no icon bitmap.  On the Windows operating
system, an additional flag is supported: 
\fBwm iconbitmap \fIwindow\fR ?\fI-default\fR? ?\fIimage\fR?.  
If the \fI-default\fR
flag is given, the icon is applied to all toplevel windows (existing
and future) to which no other specific icon has yet been applied.
In addition to bitmap image types, any file which contains a valid
Windows icon is also accepted (usually .ico or .icr files).  Tcl will
first test if the files contains an icon, and if that fails, test for
a bitmap.
a393 13
\fBwm stackorder \fIwindow\fR ?\fIisabove|isbelow\fR? \fI?window?\fR
The stackorder command returns a list of toplevel windows
in stacking order, from lowest to highest. When a single toplevel
window is passed, the returned list recursively includes all of the
window's children that are toplevels. Only those toplevels
that are currently mapped to the screen are returned.
The stackorder command can also be used to determine if one
toplevel is positioned above or below a second toplevel.
When two window arguments separated by either \fIisabove\fR or
\fIisbelow\fR are passed, a boolean result indicates whether
or not the first window is currently above or below the second
window in the stacking order.
.TP
a503 3
.PP
On the Windows operating system \fIwm iconbitmap\fR has no effect when
passed a bitmap: only icon files currently work properly.
@


1.5.2.1
log
@doc cleanup and clarifications from 8.4aCVS backport
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.6 2001/01/02 19:13:02 andreas_kupries Exp $
d211 1
a211 10
string if \fIwindow\fR has no icon bitmap.  On the Windows operating
system, an additional flag is supported: 
\fBwm iconbitmap \fIwindow\fR ?\fI-default\fR? ?\fIimage\fR?.  
If the \fI-default\fR
flag is given, the icon is applied to all toplevel windows (existing
and future) to which no other specific icon has yet been applied.
In addition to bitmap image types, any file which contains a valid
Windows icon is also accepted (usually .ico or .icr files).  Tcl will
first test if the files contains an icon, and if that fails, test for
a bitmap.
a503 3
.PP
On the Windows operating system \fIwm iconbitmap\fR has no effect when
passed a bitmap: only icon files currently work properly.
@


1.4
log
@1999-08-10  Jeff Hobbs  <hobbs@@scriptics.com>

	* win/tkWinWm.c: changed "wm deiconify" on Windows to raise and
	force the focus on the deiconified window (behavioral change from
	8.1 to comply better with Windows style) [Bug: 1609]
	* doc/wm.n: clarified behavior of "wm deiconify".
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.3 1999/08/09 16:51:51 hobbs Exp $
d394 9
a402 8
\fBwm state \fIwindow\fR
Returns the current state of \fIwindow\fR:  either \fBnormal\fR,
\fBiconic\fR, \fBwithdrawn\fR, or \fBicon\fR.  The difference
between \fBiconic\fR and \fBicon\fR is that \fBiconic\fR refers
to a window that has been iconified (e.g., with the \fBwm iconify\fR
command) while \fBicon\fR refers to a window whose only purpose is
to serve as the icon for some other window (via the \fBwm iconwindow\fR
command).
@


1.3
log
@1999-08-09  Jeff Hobbs  <hobbs@@scriptics.com>

	* doc/options.n: clarified that -troughcolor doesn't work on Windows
	* doc/wm.n: fixed wm positionfrom docs [Bug: 2284]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.2 1998/09/14 18:23:01 stanton Exp $
d102 3
a104 1
in de-iconified form.  Returns an empty string.
@


1.2
log
@Replaced SCCS strings, fixed binary files
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id$
d320 1
a320 1
Otherwise it returns \fBuser\fR or \fBwindow\fR to indicate the
@


1.1
log
@Initial revision
@
text
@d8 1
a8 1
'\" SCCS: @@(#) wm.n 1.37 96/10/14 11:07:58
@


1.1.4.1
log
@Merged 8.0.3 changes into 8.1
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: wm.n,v 1.2 1998/09/14 18:23:01 stanton Exp $
@


