aboutsummaryrefslogtreecommitdiff
path: root/doc/asciidoc/fluxbox.1
diff options
context:
space:
mode:
authorMark Tiefenbruck <mark@fluxbox.org>2008-08-20 12:26:12 (GMT)
committerMark Tiefenbruck <mark@fluxbox.org>2008-08-20 12:26:12 (GMT)
commit4bf00f68573f3ad172b879e78ad441e74a916e66 (patch)
treea79a73aec7b643f0252d1f678e0a8c1703070576 /doc/asciidoc/fluxbox.1
parent0fea3e3c8640888e4ae6e76775f309f290134aab (diff)
downloadfluxbox-4bf00f68573f3ad172b879e78ad441e74a916e66.zip
fluxbox-4bf00f68573f3ad172b879e78ad441e74a916e66.tar.bz2
fix match limits in apps file, plus some documentation
Diffstat (limited to 'doc/asciidoc/fluxbox.1')
-rw-r--r--doc/asciidoc/fluxbox.190
1 files changed, 39 insertions, 51 deletions
diff --git a/doc/asciidoc/fluxbox.1 b/doc/asciidoc/fluxbox.1
index 4d14f71..0272673 100644
--- a/doc/asciidoc/fluxbox.1
+++ b/doc/asciidoc/fluxbox.1
@@ -1,11 +1,11 @@
1.\" Title: fluxbox 1.\" Title: fluxbox
2.\" Author: 2.\" Author:
3.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/> 3.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
4.\" Date: 08/19/2008 4.\" Date: 08/20/2008
5.\" Manual: 5.\" Manual:
6.\" Source: 6.\" Source:
7.\" 7.\"
8.TH "FLUXBOX" "1" "08/19/2008" "" "" 8.TH "FLUXBOX" "1" "08/20/2008" "" ""
9.\" disable hyphenation 9.\" disable hyphenation
10.nh 10.nh
11.\" disable justification (adjust text to left margin only) 11.\" disable justification (adjust text to left margin only)
@@ -1199,40 +1199,44 @@ The default installation of fluxbox provides some of these style files\. See flu
1199In addition to the style file, the overlay file, whose location is specified by session\.screen0\.styleOverlay (default: ~/\.fluxbox/overlay ) can be used to set style resources that override all styles\. For more information about which parts of fluxbox can be controlled by the overlay file, see fluxstyle(1)\. 1199In addition to the style file, the overlay file, whose location is specified by session\.screen0\.styleOverlay (default: ~/\.fluxbox/overlay ) can be used to set style resources that override all styles\. For more information about which parts of fluxbox can be controlled by the overlay file, see fluxstyle(1)\.
1200.sp 1200.sp
1201.SH "APPLICATIONS" 1201.SH "APPLICATIONS"
1202It is possible to force an application to always have the same dimensions, position, and other settings when it is first launched\. This is done using either the window\-menu `Remember\&...\fI submenu, or by directly using the ~/\.fluxbox/apps file\. Be careful about editing the apps file while fluxbox is running\. Your changes may be overwritten\. Following is a listing of the valid entries for the `apps\fR file\. The `Remember\&...\fI submenu has entries for most options that store the current state in the `apps\fR file for future use\. 1202It is possible to force an application to always have the same dimensions, position, and other settings when it is first launched\. The easiest way to do this is to use the `Remember\&...\' submenu of the window menu, which can usually be opened with a right click on the titlebar\. More advanced features require manually editing the ~/\.fluxbox/apps file, where these settings are saved\.
1203.sp 1203.sp
1204The format of a line in the `apps\' file is: 1204The format of a section in the `apps\' file is:
1205.sp 1205.sp
1206.sp 1206.sp
1207.RS 4 1207.RS 4
1208.nf 1208.nf
1209[app] (app\-name) {count \- optional} 1209[app] (Property=\'value\') \.\.\. {count \- optional}
1210 [Property1] {value1} 1210 [Setting1] {value1}
1211 [Property2] {value2} 1211 [Setting2] {value2}
1212 \.\.\. 1212 \.\.\.
1213[end] 1213[end]
1214.fi 1214.fi
1215.RE 1215.RE
1216Each app\-name can be a string, or a regular expression\. By default the name is matched against a window\'s WM_CLASS property (the first string in it, called the "instance")\. You can match against the title, instance name (default), class name, or role (the WM_WINDOW_ROLE property) by explicitly specifying it\. You can also specify multiple matches, which must ALL match for the properties to be applied\. If a count is supplied in curly brackets at the end of the app line, then the entry will only match at most that many at any time (default is to match all matching windows)\. Settings associated with an [app] line will not be applied to transient windows\. [transient] may be used instead to match them\. 1216Property can be one of the following tags:
1217.sp
1218o name \- the name of the window (the first field of WM_CLASS) o class \- class of the window (the second field of WM_CLASS) o title \- title of the window (the WM_NAME property) o role \- role of the window (the WM_WINDOW_ROLE property)
1219.sp
1220You can find out the value for these fields for a particular window by running xprop(1)\. The window title should be used only as a last resort, since it often changes after the window opens\. Each \fIvalue\fR can be a string or a regular expression\. All values are case sensitive\.
1221.sp
1222You can specify multiple properties, which must ALL match for the settings to be applied\. If a count is supplied in curly brackets at the end of the app line, then the entry will only match at most that many at any time (default is to match all matching windows)\. Settings associated with an [app] line will not be applied to transient windows\. [transient] may be used instead to match them\.
1217.sp 1223.sp
1218.sp 1224.sp
1219.RS 4 1225.RS 4
1220.nf 1226.nf
1221# match a standard xterm 1227# match a standard xterm
1222[app] (xterm) 1228[app] (name=xterm)
1223# match an xterm started like: xterm \-name myshell 1229# match an xterm started like: xterm \-name myshell
1224[app] (myshell) 1230[app] (name=myshell)
1225# match any one Firefox window (the instance name is "Gecko")
1226[app] (class=Firefox\-bin) {1}
1227# match the gaim buddy list window 1231# match the gaim buddy list window
1228[app] (role=buddy_list) 1232[app] (role=buddy_list)
1229# match an rdesktop window to a particular host 1233# match an rdesktop window to a particular host
1230[app] (title=rdesktop \- hostname\.*) 1234[app] (title=rdesktop \- hostname\.*)
1231# match gaim IRC windows 1235# match pidgin IRC windows
1232[app] (gaim) (title=#\.*) 1236[app] (pidgin) (title=#\.*)
1233.fi 1237.fi
1234.RE 1238.RE
1235The following are the properties that can be defined in each [app] entry\. Each name must be enclosed in square brackets, and the value is generally in curly brackets: 1239The following are the settings that can be defined in each [app] entry\. Each name must be enclosed in square brackets, and the value is generally in curly brackets:
1236.sp 1240.sp
1237.sp 1241.sp
1238.RS 4 1242.RS 4
@@ -1244,7 +1248,7 @@ The following are the properties that can be defined in each [app] entry\. Each
1244.RE 1248.RE
1245.sp 1249.sp
1246.RS 4 1250.RS 4
1247\h'-04'\(bu\h'+03'[Position] (\fBrefspot\fR)) {X Y}: Position the application at a particular spot: 1251\h'-04'\(bu\h'+03'[Position] (\fBrefspot\fR) {X Y}: Position the application at a particular spot:
1248.sp 1252.sp
1249.RS 4 1253.RS 4
1250\h'-04'\(bu\h'+03'TOPLEFT 1254\h'-04'\(bu\h'+03'TOPLEFT
@@ -1309,7 +1313,7 @@ is positioned (X,Y) pixels from the lower right of the screen\.
1309.RE 1313.RE
1310.sp 1314.sp
1311.RS 4 1315.RS 4
1312\h'-04'\(bu\h'+03'[FocusHidden] {yes|no}: Hides the app from the window cycling list used Next/PrevWindow key bindings\. 1316\h'-04'\(bu\h'+03'[FocusHidden] {yes|no}: Hides the app from the window cycling list used by Next/PrevWindow key bindings\.
1313.RE 1317.RE
1314.sp 1318.sp
1315.RS 4 1319.RS 4
@@ -1356,56 +1360,40 @@ enabled, focus enabled\.
1356.RE 1360.RE
1357The apps file also allows you to specify applications that should be started only valid option is (screen=NN), where NN is the screen number on which the command should be run\. 1361The apps file also allows you to specify applications that should be started only valid option is (screen=NN), where NN is the screen number on which the command should be run\.
1358.sp 1362.sp
1359Finally, you can set windows to group together by using the `apps\' file\. This can be achieved with regular expressions using: 1363Finally, you can set windows to group together by using the `apps\' file\. Just place a [group] tag around several [app] tags, with an [end] tag to indicate the end of the group\. If you place (workspace) after the [group] tag, a new window will only get grouped with other windows on the current workspace\. You can also specify dimensions, positions, etc\. for the group as for normal app entries\. Here is a short example of an `apps\' file:
1360.sp
1361.sp
1362.RS 4
1363.nf
1364[app] (property=expr) \.\.\. {number}
1365.fi
1366.RE
1367Property can be one of the following tags:
1368.sp
1369o name \- the name of the window (the first field of WM_CLASS) o class \- class of the window (the second field of WM_CLASS) o title \- title of the window ( WM_NAME property) o role \- role of the window (the WM_WINDOW_ROLE property)
1370.sp
1371If no `property\' is specified, the name property is assumed\. You can find out the value for these fields for a particular window by running xprop(1)\.
1372.sp
1373You can also place [group] tag around several [app] tags, with an [end] tag to indicate the end of the group\. If you place (workspace) after the [group] tag, a new window will only get grouped with other windows on the current workspace\. You can also specify dimensions, positions, etc\. for the group as for normal app entries\. Here is a short example of an `apps\' file:
1374.sp 1364.sp
1375.sp 1365.sp
1376.RS 4 1366.RS 4
1377.nf 1367.nf
1378 [startup] {xterm} 1368 [startup] {xterm}
1379 # match anything ending with term, up to 2 instances 1369 # match anything ending with term, up to 2 instances
1380 [app] (\.*[tT]erm) {2} 1370 [app] (name=\.*[tT]erm) {2}
1381 # match anything with `gaim\' in the title 1371 [Workspace] {1}
1382 [app] (title=\.*gaim\.*)
1383 [app] (kate)
1384 [Dimensions] {1022 747}
1385 [Position] (WINCENTER) {0 0}
1386 [Close] {yes}
1387 [end] 1372 [end]
1388 [app] (konqueror) 1373 [app] (name=kate)
1389 [Workspace] {1} 1374 [Dimensions] {1022 747}
1390 [Dimensions] {1006 749} 1375 [Position] (WINCENTER) {0 0}
1391 [Position] {16 0} 1376 [Close] {yes}
1392 [Jump] {yes} 1377 [end]
1378 [app] (name=konqueror)
1379 [Workspace] {1}
1380 [Dimensions] {1006 749}
1381 [Position] {16 0}
1382 [Jump] {yes}
1393 [end] 1383 [end]
1394 # start all aterms without decorations 1384 # start all aterms without decorations
1395 [app] (aterm) 1385 [app] (name=aterm)
1396 [Deco] {NONE} 1386 [Deco] {NONE}
1397 [end] 1387 [end]
1398 # a group with the gimp dock and toolbox 1388 # a group with the gimp dock and toolbox
1399 # appears on layer 4 (bottom) 1389 # appears on layer 4 (bottom)
1400 [group] 1390 [group]
1401 [app] (gimp) (role=gimp\-dock) 1391 [app] (name=gimp) (role=gimp\-dock)
1402 [app] (gimp) (role=gimp\-toolbox) 1392 [app] (name=gimp) (role=gimp\-toolbox)
1403 [Layer] {4} 1393 [Layer] {4}
1404 [end] 1394 [end]
1405.fi 1395.fi
1406.RE 1396.RE
1407Parameters in the `apps\' file are case\-sensitive\. Application names are taken from the first X window WM_CLASS attribute by default (WM_NAME = title, WM_WINDOW_ROLE = role)\. You can see this attribute by using the xprop command\. Take care when using regular expressions\. If you are not familiar with regular expressions you can disable this feature by specifying \-\-disable\-regexp during configure\. Plain strings will then be matched\.
1408.sp
1409.SH "THE SLIT" 1397.SH "THE SLIT"
1410The slit is a special fluxbox window frame that can contain dockable applications, e\.g\. \fIbbtools\fR or \fIwmapps\fR\. 1398The slit is a special fluxbox window frame that can contain dockable applications, e\.g\. \fIbbtools\fR or \fIwmapps\fR\.
1411.sp 1399.sp