Provided by: icewm-common_1.4.3.0~pre-20180217-3_amd64 
NAME
icewmhint - set IceWM hints by window class and instance
SYNOPSIS
icewmhint [CLASS.INSTANCE] OPTION VALUE
DESCRIPTION
icewmhint is a simple utility for passing IceWM hints to icewm(1) by window class and instance. Unlike
tools that use WMH or EWMH, such as icesh(1), wmctl(1) and xdotool(1), icewmhint uses a special property,
"_ICEWM_WINOPHINT", on the root window to pass special hints to icewm(1).
OPTIONS
icesh recognizes the following options:
COMMAND OPTIONS
Command options are mutually exclusive. Only one command option can be specified per invocation. If no
command option is specified, argument parsing and processing is performed.
-h, --help
Print a brief usage statement to stdout and exit.
-V, --version
Print the program version to stdout and exit.
-C, --copying
Print copying permissions to stdout for the program and exit.
GENERAL OPTIONS
icewmhint has not general options: all information is passed using non-option arguments.
ARGUMENTS
The following arguments are required:
[CLASS.INSTANCE]
Specifies the ICCCM 2.0 WM_CLASS property in terms of resource name and resource class separated by a
period ("."). For example: "XTerm.xterm". This argument must be specified for all commands
affecting client windows.
OPTION VALUE
Specifies the OPTION to affect and the VALUE that goes with the option. Options and their arguments
are as follows:
GENERAL OPTION ARGUMENTS
General option arguments are normally associated with GNOME WinWM/WMH hints (except for the tray option
argument).
icon NAME
Specifies the icon name for windows of CLASS.INSTANCE. NAME should be the name of the icon.
icewm(1) will use is usual method to find the icon. The default is the name provided by window
manager hints.
workspace WORKSPACE
Specifies the workspace on which a window of CLASS.INSTANCE will be initially placed. The default is
to place the window on the current workspace. WORKSPACE should be a numeric workspace number
(counting from 0).
geometry GEOMETRY
Specifies the initial geometry for windows of the given CLASS.INSTANCE. GEOMETRY must be a geometry
that can be parsed by XParseGeometry(3). The default is the geometry provided by window manager
hints.
layer {Desktop|Below|Normal|OnTop|Dock|AboveDock|Menu|NUMBER}
The layer is a similar concept to the layer specified by GNOME/WMH and implied by NetWM/EWMH. It is
in this case however specific to icewm(1).
The command option specifies the layer to be associated with an CLASS.INSTANCE. The default is the
"Normal" layer. VALUE is either a numeric layer NUMBER or a symbolic layer name. Symbolic layer
names are one of the following:
Desktop (0) desktop window layer.
Below (2) below normal windows.
Normal (4) default window layer.
OnTop (6) above normal windows.
Dock (8) docks (panels and edge displays).
AboveDock (10) above docks.
Menu (12) above everything else.
tray {Ignore|Minimized|Exclusive|NUMBER}
Specifies the tray handling to be applied to windows with CLASS.INSTANCE. This option is specific to
icewm(1) and sets the "_ICEWM_TRAY" property associated with the window. The default is "Ignore".
VALUE can be a numerical option NUMBER or a symbolic name as follows:
Ignore (0) only in task list.
Minimized (1) icon in tray, task list unminimized.
Exclusive (2) only in tray, not in task list.
FUNCTION OPTION ARGUMENTS
Specifies which functions are disabled/enabled (0/1) for windows with CLASS.INSTANCE. All function
options have a default value of enabled (1) unless overridden by the application. The Motif-like
functions are as follows:
fMove can be moved: (default: 1).
fResize can be resized: (default: 1).
fClose can be closed: (default: 1).
fMinimize can be minimized: (default: 1).
fMaximize can be maximized: (default: 1).
fHide can be hidden: (default: 1).
fRollup can be shaded: (default: 1).
DECOR OPTION ARGUMENTS
Specifies which decorations are disabled/enabled (0/1) for windows with CLASS.INSTANCE. All decor
options have a default value of enabled (1) unless overridden by the application. The Motif-like
decorations are as follows:
dTitleBar has title bar: (default: 1).
dSysMenu has window menu: (default: 1).
dBorder has border: (default: 1).
dResize has resize grips: (default: 1).
dClose has close button: (default: 1).
dMinimize has minimize button: (default: 1).
dMaximize has maximize button: (default: 1).
dHide has hide button: (default: 1).
dRollup has shade button: (default: 1).
dDepth has depth button: (default: 1).
FEATURE OPTION ARGUMENTS
Specifies which advanced features to be enabled/disabled (1/0) for windows with CLASS.INSTANCE. All
advanced features have a default value of disabled (0) unless overridden by the application. The
advanced features are as follows:
allWorkspaces on all workspaces.
ignoreTaskBar not on task bar.
noIgnoreTaskBar on task bar.
ignoreWinList not on window list.
ignoreQuickSwitch not on quick switch.
fullKeys provided more keys.
noFocusOnAppRaise no focus on raise.
ignoreNoFocusHint focus even no-input.
ignorePositionHint place automatically.
doNotCover limits workspace if sticky.
doNotFocus do not focus.
startFullscreen start full screen.
startMinimized start minimized.
startMaximized start maximized.
startMaximizedVert start maximized vertical.
startMaximizedHorz start maximized horizontal.
nonICCCMconfigureRequest more configure requests.
forcedClose no close dialog.
noFocusOnMap do not focus when mapped.
ignoreUrgentHint ignore urgent hints.
appTakesFocus let application take focus.
BUGS
icewmhint had no known bugs at the time of release. Please report bugs for current versions to the
source code repository at <https://github.com/bbidulock/icewm/issues>.
AUTHOR
Brian Bidulock <mailto:bidulock@openss7.org>.
See --copying for full copyright notice and copying permissions.
LICENSE
IceWM is licensed under the GNU Library General Public License. See the COPYING file in the distribution
or use the --copying flag to display copying permissions.
icewm 1.4.3.0~pre-20180217 2018-02-28 ICEWMHINT(1)