diff options
Diffstat (limited to 'doc/asciidoc')
-rw-r--r-- | doc/asciidoc/fluxbox.1 | 38 | ||||
-rw-r--r-- | doc/asciidoc/fluxbox.txt | 41 |
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 |
1216 | Each 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)\. | 1216 | Each 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 |
1407 | Parameters 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\. | 1407 | Parameters 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" | ||
1410 | Since 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 | ||
1412 | You 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 | ||
1420 | where elements can be found with this command: | ||
1421 | .sp | ||
1422 | .sp | ||
1423 | .RS 4 | ||
1424 | .nf | ||
1425 | $> xprop WM_CLASS | ||
1426 | .fi | ||
1427 | .RE | ||
1428 | Just 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 | ||
1433 | Navigator nedit | ||
1434 | xterm | ||
1435 | .fi | ||
1436 | .RE | ||
1437 | This 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" |
1440 | The slit is a special fluxbox window frame that can contain dockable applications, e\.g\. \fIbbtools\fR or \fIwmapps\fR\. | 1410 | The 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 | |||
1139 | also specify multiple matches, which must ALL match for the properties to be | 1139 | also specify multiple matches, which must ALL match for the properties to be |
1140 | applied. If a count is supplied in curly brackets at the end of the app line, | 1140 | applied. If a count is supplied in curly brackets at the end of the app line, |
1141 | then the entry will only match at most that many at any time (default is to | 1141 | then the entry will only match at most that many at any time (default is to |
1142 | match all matching windows). | 1142 | match all matching windows). Settings associated with an [app] line will not be |
1143 | applied 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: | |||
1298 | Parameters in the `apps' file are case-sensitive. Application names are taken | 1299 | Parameters in the `apps' file are case-sensitive. Application names are taken |
1299 | from the first X window WM_CLASS attribute by default (WM_NAME = title, | 1300 | from the first X window WM_CLASS attribute by default (WM_NAME = title, |
1300 | WM_WINDOW_ROLE = role). You can see this attribute by using the xprop | 1301 | WM_WINDOW_ROLE = role). You can see this attribute by using the xprop |
1301 | command. Transient windows are not affected by application settings. Take care | 1302 | command. Take care when using regular expressions. If you are not familiar with |
1302 | when using regular expressions. If you are not familiar with regular | 1303 | regular expressions you can disable this feature by specifying --disable-regexp |
1303 | expressions you can disable this feature by specifying --disable-regexp during | 1304 | during configure. Plain strings will then be matched. |
1304 | configure. Plain strings will then be matched. | ||
1305 | |||
1306 | GROUPS | ||
1307 | ------ | ||
1308 | Since version 0.1.11, fluxbox has a feature called autogrouping, that is apps | ||
1309 | are automatically grouped together if they are in the same group. NOTE: this | ||
1310 | feature is deprecated since version 0.9.1 in favor of grouping using the | ||
1311 | `apps' file, since it is much more powerful. | ||
1312 | |||
1313 | You can create groups simply by editing the ~/.fluxbox/groups file. This file | ||
1314 | takes the format of: | ||
1315 | |||
1316 | <app1> <app2> <app3> <...> <appN> | ||
1317 | |||
1318 | where elements can be found with this command: | ||
1319 | |||
1320 | .................. | ||
1321 | $> xprop WM_CLASS | ||
1322 | .................. | ||
1323 | |||
1324 | Just type this command into a terminal and use the mouse to click on the | ||
1325 | desired app and it will tell you what to write as an element (use the first of | ||
1326 | the two names returned). Each line forms a different group, e.g.: | ||
1327 | |||
1328 | ................ | ||
1329 | Navigator nedit | ||
1330 | xterm | ||
1331 | ................ | ||
1332 | |||
1333 | This will create two groups, one with netscape and nedit, and one with xterm. | ||
1334 | The new window will only group itself to other windows on the same workspace | ||
1335 | and to the last window that was focused. | ||
1336 | 1305 | ||
1337 | THE SLIT | 1306 | THE SLIT |
1338 | -------- | 1307 | -------- |