.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "ICEWMHINT 1" .TH ICEWMHINT 1 "2018-10-31" "icewm\ 1.4.3.0~pre-20181030" "User\ Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" .Vb 1 \& icewmhint \- set IceWM hints by window class and instance .Ve .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBicewmhint\fR [\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR] \fI\s-1OPTION\s0\fR \fI\s-1VALUE\s0\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBicewmhint\fR is a simple utility for passing IceWM hints to \fIicewm\fR\|(1) by window class and instance. Unlike tools that use \s-1WMH\s0 or \s-1EWMH,\s0 such as \fIicesh\fR\|(1), \fIwmctrl\fR\|(1) and \fIxdotool\fR\|(1), \fBicewmhint\fR uses a special property, \f(CW\*(C`_ICEWM_WINOPHINT\*(C'\fR, on the root window to pass special hints to \fIicewm\fR\|(1). .SH "OPTIONS" .IX Header "OPTIONS" \&\fBicesh\fR recognizes the following options: .SS "\s-1COMMAND OPTIONS\s0" .IX Subsection "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. .IP "\fB\-h\fR, \fB\-\-help\fR" 4 .IX Item "-h, --help" Print a brief usage statement to \fIstdout\fR and exit. .IP "\fB\-V\fR, \fB\-\-version\fR" 4 .IX Item "-V, --version" Print the program version to \fIstdout\fR and exit. .IP "\fB\-C\fR, \fB\-\-copying\fR" 4 .IX Item "-C, --copying" Print copying permissions to \fIstdout\fR for the program and exit. .SS "\s-1GENERAL OPTIONS\s0" .IX Subsection "GENERAL OPTIONS" \&\fBicewmhint\fR has not general options: all information is passed using non-option arguments. .SH "ARGUMENTS" .IX Header "ARGUMENTS" The following arguments are required: .IP "[\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR]" 4 .IX Item "[CLASS.INSTANCE]" Specifies the \s-1ICCCM 2.0\s0 \fB\s-1WM_CLASS\s0\fR property in terms of resource name and resource class separated by a period (\f(CW\*(C`.\*(C'\fR). For example: \&\f(CW\*(C`XTerm.xterm\*(C'\fR. This argument must be specified for all commands affecting client windows. .IP "\fI\s-1OPTION\s0\fR \fI\s-1VALUE\s0\fR" 4 .IX Item "OPTION VALUE" Specifies the \fI\s-1OPTION\s0\fR to affect and the \fI\s-1VALUE\s0\fR that goes with the option. Options and their arguments are as follows: .SS "\s-1GENERAL OPTION ARGUMENTS\s0" .IX Subsection "GENERAL OPTION ARGUMENTS" General option arguments are normally associated with \s-1GNOME\s0 WinWM/WMH hints (except for the tray option argument). .IP "\fBicon\fR \fI\s-1NAME\s0\fR" 4 .IX Item "icon NAME" Specifies the icon name for windows of \fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. \&\fI\s-1NAME\s0\fR should be the name of the icon. \fIicewm\fR\|(1) will use is usual method to find the icon. The default is the name provided by window manager hints. .IP "\fBworkspace\fR \fI\s-1WORKSPACE\s0\fR" 4 .IX Item "workspace WORKSPACE" Specifies the workspace on which a window of \fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR will be initially placed. The default is to place the window on the current workspace. \fI\s-1WORKSPACE\s0\fR should be a numeric workspace number (counting from 0). .IP "\fBgeometry\fR \fI\s-1GEOMETRY\s0\fR" 4 .IX Item "geometry GEOMETRY" Specifies the initial geometry for windows of the given \&\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. \fI\s-1GEOMETRY\s0\fR must be a geometry that can be parsed by \fIXParseGeometry\fR\|(3). The default is the geometry provided by window manager hints. .IP "\fBlayer\fR {\fBDesktop\fR|\fBBelow\fR|\fBNormal\fR|\fBOnTop\fR|\fBDock\fR|\fBAboveDock\fR|\fBMenu\fR|\fI\s-1NUMBER\s0\fR}" 4 .IX Item "layer {Desktop|Below|Normal|OnTop|Dock|AboveDock|Menu|NUMBER}" The layer is a similar concept to the layer specified by \s-1GNOME/WMH\s0 and implied by NetWM/EWMH. It is in this case however specific to \&\fIicewm\fR\|(1). .Sp The command option specifies the layer to be associated with an \&\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. The default is the \f(CW\*(C`Normal\*(C'\fR layer. \fI\s-1VALUE\s0\fR is either a numeric layer \fI\s-1NUMBER\s0\fR or a symbolic layer name. Symbolic layer names are one of the following: .Sp .Vb 7 \& 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. .Ve .IP "\fBtray\fR {\fBIgnore\fR|\fBMinimized\fR|\fBExclusive\fR|\fI\s-1NUMBER\s0\fR}" 4 .IX Item "tray {Ignore|Minimized|Exclusive|NUMBER}" Specifies the tray handling to be applied to windows with \&\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. This option is specific to \fIicewm\fR\|(1) and sets the \f(CW\*(C`_ICEWM_TRAY\*(C'\fR property associated with the window. The default is \f(CW\*(C`Ignore\*(C'\fR. \fI\s-1VALUE\s0\fR can be a numerical option \fI\s-1NUMBER\s0\fR or a symbolic name as follows: .Sp .Vb 3 \& Ignore (0) only in task list. \& Minimized (1) icon in tray, task list unminimized. \& Exclusive (2) only in tray, not in task list. .Ve .SS "\s-1FUNCTION OPTION ARGUMENTS\s0" .IX Subsection "FUNCTION OPTION ARGUMENTS" Specifies which functions are disabled/enabled (0/1) for windows with \&\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. All function options have a default value of enabled (1) unless overridden by the application. The Motif-like functions are as follows: .PP .Vb 7 \& fClose can be closed: (default: 1). \& fHide can be hidden: (default: 1). \& fMaximize can be maximized: (default: 1). \& fMinimize can be minimized: (default: 1). \& fMove can be moved: (default: 1). \& fResize can be resized: (default: 1). \& fRollup can be shaded: (default: 1). .Ve .SS "\s-1DECOR OPTION ARGUMENTS\s0" .IX Subsection "DECOR OPTION ARGUMENTS" Specifies which decorations are disabled/enabled (0/1) for windows with \&\fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. All decor options have a default value of enabled (1) unless overridden by the application. The Motif-like decorations are as follows: .PP .Vb 10 \& dBorder has border: (default: 1). \& dClose has close button: (default: 1). \& dDepth has depth button: (default: 1). \& dHide has hide button: (default: 1). \& dMaximize has maximize button: (default: 1). \& dMinimize has minimize button: (default: 1). \& dResize has resize grips: (default: 1). \& dRollup has shade button: (default: 1). \& dSysMenu has window menu: (default: 1). \& dTitleBar has title bar: (default: 1). .Ve .SS "\s-1FEATURE OPTION ARGUMENTS\s0" .IX Subsection "FEATURE OPTION ARGUMENTS" Specifies which advanced features to be enabled/disabled (1/0) for windows with \fI\s-1CLASS\s0\fR\fB.\fR\fI\s-1INSTANCE\s0\fR. All advanced features have a default value of disabled (0) unless overridden by the application. The advanced features are as follows: .PP .Vb 10 \& allWorkspaces on all workspaces. \& appTakesFocus let application take focus. \& doNotCover limits workspace if sticky. \& doNotFocus do not focus. \& forcedClose no close dialog. \& fullKeys provided more keys. \& ignoreNoFocusHint focus even no\-input. \& ignorePositionHint place automatically. \& ignoreQuickSwitch not on quick switch. \& ignoreTaskBar not on task bar. \& ignoreUrgentHint ignore urgent hints. \& ignoreWinList not on window list. \& noFocusOnAppRaise no focus on raise. \& noFocusOnMap do not focus when mapped. \& noIgnoreTaskBar on task bar. \& nonICCCMconfigureRequest more configure requests. \& startFullscreen start full screen. \& startMaximized start maximized. \& startMaximizedHorz start maximized horizontal. \& startMaximizedVert start maximized vertical. \& startMinimized start minimized. .Ve .SH "BUGS" .IX Header "BUGS" \&\fBicewmhint\fR had no known bugs at the time of release. Please report bugs for current versions to the source code repository at . .SH "AUTHOR" .IX Header "AUTHOR" Brian Bidulock . .PP See \fB\-\-copying\fR for full copyright notice and copying permissions. .SH "LICENSE" .IX Header "LICENSE" \&\fBIceWM\fR is licensed under the \s-1GNU\s0 Library General Public License. See the \fI\s-1COPYING\s0\fR file in the distribution or use the \fB\-\-copying\fR flag to display copying permissions.