aboutsummaryrefslogtreecommitdiff
path: root/doc/asciidoc
diff options
context:
space:
mode:
authorMark Tiefenbruck <mark@fluxbox.org>2008-08-19 16:18:32 (GMT)
committerMark Tiefenbruck <mark@fluxbox.org>2008-08-19 16:18:32 (GMT)
commit4e64d45e1678f525fe20b4a53fb9539a58f18176 (patch)
tree766a9a2fefe451f8261e70428591f7bc0d8f55ef /doc/asciidoc
parente5d43edb8ebd472b680a5b4a96dfa1fcf1ef2260 (diff)
downloadfluxbox_paul-4e64d45e1678f525fe20b4a53fb9539a58f18176.zip
fluxbox_paul-4e64d45e1678f525fe20b4a53fb9539a58f18176.tar.bz2
add [transient] tag to apps file to match transient windows
Diffstat (limited to 'doc/asciidoc')
-rw-r--r--doc/asciidoc/fluxbox.138
-rw-r--r--doc/asciidoc/fluxbox.txt41
2 files changed, 9 insertions, 70 deletions
diff --git a/doc/asciidoc/fluxbox.1 b/doc/asciidoc/fluxbox.1
index b7518ad..4d14f71 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/18/2008 4.\" Date: 08/19/2008
5.\" Manual: 5.\" Manual:
6.\" Source: 6.\" Source:
7.\" 7.\"
8.TH "FLUXBOX" "1" "08/18/2008" "" "" 8.TH "FLUXBOX" "1" "08/19/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)
@@ -1213,7 +1213,7 @@ The format of a line in the `apps\' file is:
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)\. 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\.
1217.sp 1217.sp
1218.sp 1218.sp
1219.RS 4 1219.RS 4
@@ -1404,37 +1404,7 @@ You can also place [group] tag around several [app] tags, with an [end] tag to i
1404 [end] 1404 [end]
1405.fi 1405.fi
1406.RE 1406.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\. Transient windows are not affected by application settings\. 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\. 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 "GROUPS"
1410Since version 0\.1\.11, fluxbox has a feature called autogrouping, that is apps are automatically grouped together if they are in the same group\. NOTE: this feature is deprecated since version 0\.9\.1 in favor of grouping using the `apps\' file, since it is much more powerful\.
1411.sp
1412You can create groups simply by editing the ~/\.fluxbox/groups file\. This file takes the format of:
1413.sp
1414.sp
1415.RS 4
1416.nf
1417<app1> <app2> <app3> <\.\.\.> <appN>
1418.fi
1419.RE
1420where elements can be found with this command:
1421.sp
1422.sp
1423.RS 4
1424.nf
1425$> xprop WM_CLASS
1426.fi
1427.RE
1428Just type this command into a terminal and use the mouse to click on the desired app and it will tell you what to write as an element (use the first of the two names returned)\. Each line forms a different group, e\.g\.:
1429.sp
1430.sp
1431.RS 4
1432.nf
1433Navigator nedit
1434xterm
1435.fi
1436.RE
1437This will create two groups, one with netscape and nedit, and one with xterm\. The new window will only group itself to other windows on the same workspace and to the last window that was focused\.
1438.sp 1408.sp
1439.SH "THE SLIT" 1409.SH "THE SLIT"
1440The slit is a special fluxbox window frame that can contain dockable applications, e\.g\. \fIbbtools\fR or \fIwmapps\fR\. 1410The slit is a special fluxbox window frame that can contain dockable applications, e\.g\. \fIbbtools\fR or \fIwmapps\fR\.
diff --git a/doc/asciidoc/fluxbox.txt b/doc/asciidoc/fluxbox.txt
index 136cc43..e357fd4 100644
--- a/doc/asciidoc/fluxbox.txt
+++ b/doc/asciidoc/fluxbox.txt
@@ -1139,7 +1139,8 @@ name, or role (the WM_WINDOW_ROLE property) by explicitly specifying it. You can
1139also specify multiple matches, which must ALL match for the properties to be 1139also specify multiple matches, which must ALL match for the properties to be
1140applied. If a count is supplied in curly brackets at the end of the app line, 1140applied. If a count is supplied in curly brackets at the end of the app line,
1141then the entry will only match at most that many at any time (default is to 1141then the entry will only match at most that many at any time (default is to
1142match all matching windows). 1142match all matching windows). Settings associated with an [app] line will not be
1143applied to transient windows. [transient] may be used instead to match them.
1143 1144
1144................................................................... 1145...................................................................
1145# match a standard xterm 1146# match a standard xterm
@@ -1298,41 +1299,9 @@ entries. Here is a short example of an `apps' file:
1298Parameters in the `apps' file are case-sensitive. Application names are taken 1299Parameters in the `apps' file are case-sensitive. Application names are taken
1299from the first X window WM_CLASS attribute by default (WM_NAME = title, 1300from the first X window WM_CLASS attribute by default (WM_NAME = title,
1300WM_WINDOW_ROLE = role). You can see this attribute by using the xprop 1301WM_WINDOW_ROLE = role). You can see this attribute by using the xprop
1301command. Transient windows are not affected by application settings. Take care 1302command. Take care when using regular expressions. If you are not familiar with
1302when using regular expressions. If you are not familiar with regular 1303regular expressions you can disable this feature by specifying --disable-regexp
1303expressions you can disable this feature by specifying --disable-regexp during 1304during configure. Plain strings will then be matched.
1304configure. Plain strings will then be matched.
1305
1306GROUPS
1307------
1308Since version 0.1.11, fluxbox has a feature called autogrouping, that is apps
1309are automatically grouped together if they are in the same group. NOTE: this
1310feature is deprecated since version 0.9.1 in favor of grouping using the
1311`apps' file, since it is much more powerful.
1312
1313You can create groups simply by editing the ~/.fluxbox/groups file. This file
1314takes the format of:
1315
1316 <app1> <app2> <app3> <...> <appN>
1317
1318where elements can be found with this command:
1319
1320..................
1321$> xprop WM_CLASS
1322..................
1323
1324Just type this command into a terminal and use the mouse to click on the
1325desired app and it will tell you what to write as an element (use the first of
1326the two names returned). Each line forms a different group, e.g.:
1327
1328................
1329Navigator nedit
1330xterm
1331................
1332
1333This will create two groups, one with netscape and nedit, and one with xterm.
1334The new window will only group itself to other windows on the same workspace
1335and to the last window that was focused.
1336 1305
1337THE SLIT 1306THE SLIT
1338-------- 1307--------