updated documentation
Henrik Kinnunen fluxgen at fluxbox dot org
10 files changed,
278 insertions(+),
690 deletions(-)
M
doc/fbrun.1.in
→
doc/fbrun.1.in
@@ -1,13 +1,22 @@
'\" t .\" Title: fbrun .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/> -.\" Date: 12/17/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: fbrun.txt .\" Language: English .\" -.TH "FBRUN" "1" "12/17/2009" "fbrun\&.txt" "Fluxbox Manual" +.TH "FBRUN" "1" "02/19/2011" "fbrun\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------
M
doc/fbsetbg.1.in
→
doc/fbsetbg.1.in
@@ -1,13 +1,22 @@
'\" t .\" Title: fbsetbg .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/> -.\" Date: 01/14/2010 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: fbsetbg.txt .\" Language: English .\" -.TH "FBSETBG" "1" "01/14/2010" "fbsetbg\&.txt" "Fluxbox Manual" +.TH "FBSETBG" "1" "02/19/2011" "fbsetbg\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------
M
doc/fbsetroot.1.in
→
doc/fbsetroot.1.in
@@ -1,13 +1,22 @@
'\" t .\" Title: fbsetroot .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/> -.\" Date: 01/14/2010 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: fbsetroot.txt .\" Language: English .\" -.TH "FBSETROOT" "1" "01/14/2010" "fbsetroot\&.txt" "Fluxbox Manual" +.TH "FBSETROOT" "1" "02/19/2011" "fbsetroot\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------
M
doc/fluxbox-apps.5.in
→
doc/fluxbox-apps.5.in
@@ -1,161 +1,22 @@
+'\" t .\" Title: fluxbox-apps .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> -.\" Date: 02/19/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual -.\" Source: fluxbox-apps.txt 1.1.2 +.\" Source: fluxbox-apps.txt .\" Language: English .\" -.TH "FLUXBOX\-APPS" "5" "02/19/2009" "fluxbox\-apps\&.txt 1\&.1\&.2" "Fluxbox Manual" +.TH "FLUXBOX\-APPS" "5" "02/19/2011" "fluxbox\-apps\&.txt" "Fluxbox Manual" .\" ----------------------------------------------------------------- -.\" * (re)Define some macros +.\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" toupper - uppercase a string (locale-aware) -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de toupper -.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ -\\$* -.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" SH-xref - format a cross-reference to an SH section -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de SH-xref -.ie n \{\ -.\} -.toupper \\$* -.el \{\ -\\$* -.\} -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" SH - level-one heading that works better for non-TTY output -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de1 SH -.\" put an extra blank line of space above the head in non-TTY output -.if t \{\ -.sp 1 -.\} -.sp \\n[PD]u -.nr an-level 1 -.set-an-margin -.nr an-prevailing-indent \\n[IN] -.fi -.in \\n[an-margin]u -.ti 0 -.HTML-TAG ".NH \\n[an-level]" -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -\." make the size of the head bigger -.ps +3 -.ft B -.ne (2v + 1u) -.ie n \{\ -.\" if n (TTY output), use uppercase -.toupper \\$* -.\} -.el \{\ -.nr an-break-flag 0 -.\" if not n (not TTY), use normal case (not uppercase) -\\$1 -.in \\n[an-margin]u -.ti 0 -.\" if not n (not TTY), put a border/line under subheading -.sp -.6 -\l'\n(.lu' -.\} -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" SS - level-two heading that works better for non-TTY output -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de1 SS -.sp \\n[PD]u -.nr an-level 1 -.set-an-margin -.nr an-prevailing-indent \\n[IN] -.fi -.in \\n[IN]u -.ti \\n[SN]u -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.ps \\n[PS-SS]u -\." make the size of the head bigger -.ps +2 -.ft B -.ne (2v + 1u) -.if \\n[.$] \&\\$* -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" BB/BE - put background/screen (filled box) around block of text +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de BB -.if t \{\ -.sp -.5 -.br -.in +2n -.ll -2n -.gcolor red -.di BX -.\} -.. -.de EB -.if t \{\ -.if "\\$2"adjust-for-leading-newline" \{\ -.sp -1 -.\} -.br -.di -.in -.ll -.gcolor -.nr BW \\n(.lu-\\n(.i -.nr BH \\n(dn+.5v -.ne \\n(BHu+.5v -.ie "\\$2"adjust-for-leading-newline" \{\ -\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] -.\} -.el \{\ -\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] -.\} -.in 0 -.sp -.5v -.nf -.BX -.in -.sp .5v -.fi -.\} -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" BM/EM - put colored marker in margin next to block of text -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de BM -.if t \{\ -.br -.ll -2n -.gcolor red -.di BX -.\} -.. -.de EM -.if t \{\ -.br -.di -.ll -.gcolor -.nr BH \\n(dn -.ne \\n(BHu -\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] -.in 0 -.nf -.BX -.in -.fi -.\} -.. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------@@ -166,9 +27,9 @@ .ad l
.\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "Name" +.SH "NAME" fluxbox-apps \- per\-window attribute configuration for fluxbox(1) -.SH "Synopsis" +.SH "SYNOPSIS" .sp ~/\&.fluxbox/apps .SH "SYNTAX"@@ -178,9 +39,9 @@ .sp
All other characters shown are required verbatim\&. Whitespce is only required to delimit words, but it is fine to add more whitespace\&. .SH "DESCRIPTION" .sp -It is possible to force an application to always have the same dimensions, position, and other settings when it is first launched\&. These settings are saved in the `apps\' file\&. +It is possible to force an application to always have the same dimensions, position, and other settings when it is first launched\&. These settings are saved in the \(oqapps\(cq file\&. .sp -Most simple settings can be saved using the \(lqRemember\&...\(rq submenu of the window menu, which can usually be opened with a right\-click on the titlebar\&. More advanced features require manually editing the `apps\' file\&. This may include using \fBGROUP SECTIONS\fR to set up automatic window tab groups\&. +Most simple settings can be saved using the \(lqRemember\&...\(rq submenu of the window menu, which can usually be opened with a right\-click on the titlebar\&. More advanced features require manually editing the \(oqapps\(cq file\&. This may include using \fBGROUP SECTIONS\fR to set up automatic window tab groups\&. .sp You do not need to \(lqreload\(rq fluxbox after editing the apps file, the changes should be rescanned when the next window is opened\&. .sp@@ -189,7 +50,7 @@ .SH "APP SECTIONS"
.sp \fB[app]\fR sections provide settings for individual application windows\&. .PP -These sections begin with a line of the format: +These sections begin with a line of the format .RS 4 \fB[app]\fR@@ -203,7 +64,7 @@ The \fB{\fR\fIcount\fR\fB}\fR is optional\&. If specified, then the entry will only match at most that many windows at any time\&. If omitted, the default is to apply the settings to all matching windows\&.
.sp This opening \fB[apps]\fR line is followed by any number of settings for the application\&. See \fBSETTINGS\fR for more details\&. .PP -Each of these sections ends with the single line: +Each of these sections ends with the single line .RS 4 \fB[end]\fR@@ -212,7 +73,7 @@ .SH "GROUP SECTIONS"
.sp The primary purpose of \fB[group]\fR sections is to group windows together\&. All windows in a group will be tabbed together automatically\&. .PP -These sections begin with a line of the format: +These sections begin with a line of the format .RS 4 \fB[group]\fR@@ -223,7 +84,7 @@ Where the \fIpattern\fR item is optional\&. If specified, this pattern must match for the group to take effect\&. It is common to use non\-window\-specific patterns such as \fB(workspace)\fR here\&. See \fBCLIENT PATTERNS\fR for more details\&.
.sp This is followed by any number of \fB[app]\fR lines\&. These have a simiar format to the \fB[app]\fR section detailed above in \fBAPP SECTIONS\fR, but do not contain any settings and do not have an associated \fB[end]\fR line\&. .PP -Like this: +Like this .RS 4 \fB[app]\fR@@ -232,16 +93,16 @@ .RE
.sp This section may also contain settings that are applied to every window in the group\&. See the \fBSETTINGS\fR section for details\&. .PP -As with \fB[app]\fR sections, each of these sections ends with the single line: +As with \fB[app]\fR sections, each of these sections ends with the single line .RS 4 \fB[end]\fR .RE .SH "SETTINGS" .sp -These settings may be stored in the `apps\' file\&. A settings line must appear inside either an \fB[app]\fR or \fB[group]\fR section\&. +These settings may be stored in the \(oqapps\(cq file\&. A settings line must appear inside either an \fB[app]\fR or \fB[group]\fR section\&. .PP -The general format is: +The general format is .RS 4 \fB[\fR\fIsetting\fR\fB]\fR@@ -345,6 +206,11 @@ .RS 4
Whether the window has tabs enabled\&. .RE .PP +\fB[FocusNewWindow]\fR {\fIbool\fR} +.RS 4 +If enabled, a new window will grab X focus as soon as it is opened\&. If disabled, a new window will not grab X focus as soon as it is opened\&. +.RE +.PP \fB[FocusHidden]\fR {\fIbool\fR} .RS 4 If enabled, the window will not appear in@@ -422,7 +288,7 @@ is an integer between 0 and 255\&.
.RE .SH "CLIENT PATTERNS" .PP -A \fIpattern\fR looks like this: +A \fIpattern\fR looks like this .RS 4 \fB(\fR[\fIpropertyname\fR[!]=]\fIregexp\fR\fB)\fR@@ -437,7 +303,7 @@ If you specify multiple \fB(\fR\fB\fIpattern\fR\fR) arguments, this implies an AND condition \- All specified patterns must match\&.
.sp You can use \fB=\fR to test for equality or \fB!=\fR to test for inequality\&. .PP -The following values are accepted for \fIpropertyname\fR: +The following values are accepted for \fIpropertyname\fR .RS 4 .PP \fBName\fR@@ -552,7 +418,7 @@ .RE
.PP \fBLayer\fR .RS 4 -The string name of the window\'s layer, which is one of +The string name of the window\(cqs layer, which is one of \fBAboveDock\fR, \fBDock\fR, \fBTop\fR,@@ -560,61 +426,74 @@ \fBNormal\fR,
\fBBottom\fR, \fBDesktop\fR .RE +.PP +\fBScreen\fR +.RS 4 +The number of the currently used +\fIscreen\fR\&. If the setup of the running xserver involves independant screens (\fInot Xinerama\fR), the $DISPLAY environment contains something like +\fI:0\&.1\fR +or +\fI:1\&.0\fR\&. The part after the dot (\fI\&.\fR) is the number of the screen\&. .RE .PP -\fBExample\ \&1.\ \&Matches any windows with the CLASSNAME of "xterm"\fR +\fB@XPROP\fR +.RS 4 +A string, corresponding to any xproperty (Use either the +\fBxprop(1)\fR +utility or the +\fISetXProp\fR +command to set a xproperty to a window) +.RE +.RE +.PP +\fBMatches any windows with the CLASSNAME of "xterm"\fR. .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray (xterm) -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .PP -\fBExample\ \&2.\ \&Matches any windows with the same CLASSNAME as the currently focused window\fR +\fBMatches any windows with the same CLASSNAME as the currently focused window\fR. .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray (Name=[current]) -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .PP -\fBExample\ \&3.\ \&Matches any windows on the same head as the mouse but on a different layer than the currently focused window\fR +\fBMatches any windows on the same head as the mouse but on a different layer than the currently focused window\fR. .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray (Head=[mouse]) (Layer!=[current]) -.EB lightgray +.fi +.if n \{\ +.RE +.\} +.PP +\fBMatches any windows having a xproperty named FOO with "bar" in it\fR. +.sp +.if n \{\ +.RS 4 +.\} +.nf +(@FOO=\&.*bar\&.*) .fi -.fam -.ps +1 .if n \{\ .RE .\} +.sp .SH "FILES" .PP \fB~/\&.fluxbox/apps\fR@@ -634,11 +513,8 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray -# Put the first two windows which end with \'term\' on workspace 1 +# Put the first two windows which end with \*(Aqterm\*(Aq on workspace 1 [app] (name=\&.*[tT]erm) {2} [Workspace] {1} [end]@@ -669,10 +545,7 @@ [app] (name=gimp) (role=gimp\-dock)
[app] (name=gimp) (role=gimp\-toolbox) [Layer] {4} [end] -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}
M
doc/fluxbox-keys.5.in
→
doc/fluxbox-keys.5.in
@@ -1,13 +1,22 @@
'\" t .\" Title: fluxbox-keys .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/> -.\" Date: 12/17/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: fluxbox-keys.txt .\" Language: English .\" -.TH "FLUXBOX\-KEYS" "5" "12/17/2009" "fluxbox\-keys\&.txt" "Fluxbox Manual" +.TH "FLUXBOX\-KEYS" "5" "02/19/2011" "fluxbox\-keys\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------@@ -36,7 +45,7 @@ The keys file defines the keyboard shortcuts for \fIfluxbox(1)\fR\&.
.sp You can customize fluxbox\(cqs key handling through the ~/\&.fluxbox/keys file\&. The file consists of lines of the basic format: .sp -\fB[\fR\fB\fImodifiers\fR\fR\fB] \fR\fB\fIkey\fR\fR\fB :\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIarguments\fR\fR\fB \fR\fB\fI\&...\fR\fR\fB]\fR +\fB[\fR\fB\fImodifiers\fR\fR\fB] \fR\fB\fIkey\fR\fR\fB :\*(Aqcommand\*(Aq [\fR\fB\fIarguments\fR\fR\fB \fR\fB\fI\&...\fR\fR\fB]\fR .sp The space between the \fIkey\fR and the \fB:\fR before the \fIcommand\fR is mandatory\&. .sp@@ -141,11 +150,11 @@ .SH "CHAINING"
.sp Key bindings can be chained in a fashion similar to Emacs key bindings using the syntax: .sp -\fImodifiers\-1\fR \fIkey\-1\fR \fImodifiers\-2\fR \fIkey\-2\fR :\fIcommand\fR [\fIarguments \&...\fR]* +\fImodifiers\-1\fR \fIkey\-1\fR \fImodifiers\-2\fR \fIkey\-2\fR :\*(Aqcommand\*(Aq [\fIarguments \&...\fR]* .sp To abort a chained command part\-way through typing it, press the <ESC> key\&. .PP -\fBExample\ \&1.\ \&To Bind CTRL+C CTRL+X (Which means, press CTRL+C then CTRL+X) to quit fluxbox\fR +\fBTo Bind CTRL+C CTRL+X (Which means, press CTRL+C then CTRL+X) to quit fluxbox\fR. .sp .if n \{\ .RS 4@@ -156,11 +165,12 @@ .fi
.if n \{\ .RE .\} +.sp .SH "KEYMODES" .sp A specific set of key mappings can be activated and de\-activated on\-the\-fly using what are called keymodes\&. The syntax to define a mapping in a keymode is: .sp -\fB\fIkeymode\fR\fR\fB: \fR\fB\fImodifiers\fR\fR\fB \fR\fB\fIkey\fR\fR\fB :\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIarguments\fR\fR\fB \fR\fB\fI\&...\fR\fR\fB]\fR +\fB\fIkeymode\fR\fR\fB: \fR\fB\fImodifiers\fR\fR\fB \fR\fB\fIkey\fR\fR\fB :\*(Aqcommand\*(Aq [\fR\fB\fIarguments\fR\fR\fB \fR\fB\fI\&...\fR\fR\fB]\fR .sp Where \fIkeymode\fR is any alpha\-numeric string name\&. .sp@@ -270,6 +280,11 @@ .PP
\fBStartTabbing\fR .RS 4 Start dragging to add this window to another\(cqs tabgroup\&. +.RE +.PP +\fBActivateTab\fR +.RS 4 +Activates the tab underneath the mouse\&. .RE .SS "Window Commands" .sp@@ -498,6 +513,17 @@ \fIoffset\fR
greater than \fB1\fR, it will move the window that many heads\&. If this takes the window beyond the total number of heads, it will wrap around to the beginning\&. .RE +.PP +\fBSetXProp\fR \fIPROP=value\fR +.RS 4 +Sets the xproperty +\fIPROP\fR +of the current window to +\fIvalue\fR\&. Delete the content of +\fIPROP\fR +by using +\fIPROP=\fR\&. +.RE .SS "Workspace Commands" .sp These commands affect the entire workspace (or "desktop" as it is sometimes called)\&.@@ -594,9 +620,13 @@ .RS 4
Focus to the next window which is located in the direction specified\&. .RE .PP -\fBArrangeWindows\fR \fIpattern\fR +\fBArrangeWindows\fR \fIpattern\fR / \fBArrangeWindowsVertical\fR \fIpattern\fR / \fBArrangeWindowsHorizontal\fR \fIpattern\fR .RS 4 -Tries to arrange all windows on the current workspace so that they overlap the least amount possible\&. See +Tries to arrange all windows on the current workspace so that they overlap the least amount possible\&. +\fBArrangeWindowsVertical\fR +prefers vertical splits (windows side by side), whereas +\fBArrangeWindowsHorizontal\fR +prefers horizontal splits (windows on top of eachother)\&. See \fBCLIENT PATTERNS\fR for more about the \fIpattern\fR@@ -1077,9 +1107,27 @@ \fBNormal\fR,
\fBBottom\fR, \fBDesktop\fR .RE +.PP +\fBScreen\fR +.RS 4 +The number of the currently used +\fIscreen\fR\&. If the setup of the running xserver involves independant screens (\fInot Xinerama\fR), the $DISPLAY environment contains something like +\fI:0\&.1\fR +or +\fI:1\&.0\fR\&. The part after the dot (\fI\&.\fR) is the number of the screen\&. .RE .PP -\fBExample\ \&2.\ \&Matches any windows with the CLASSNAME of "xterm"\fR +\fB@XPROP\fR +.RS 4 +A string, corresponding to any xproperty (Use either the +\fBxprop(1)\fR +utility or the +\fISetXProp\fR +command to set a xproperty to a window) +.RE +.RE +.PP +\fBMatches any windows with the CLASSNAME of "xterm"\fR. .sp .if n \{\ .RS 4@@ -1091,7 +1139,7 @@ .if n \{\
.RE .\} .PP -\fBExample\ \&3.\ \&Matches any windows with the same CLASSNAME as the currently focused window\fR +\fBMatches any windows with the same CLASSNAME as the currently focused window\fR. .sp .if n \{\ .RS 4@@ -1103,7 +1151,7 @@ .if n \{\
.RE .\} .PP -\fBExample\ \&4.\ \&Matches any windows on the same head as the mouse but on a different layer than the currently focused window\fR +\fBMatches any windows on the same head as the mouse but on a different layer than the currently focused window\fR. .sp .if n \{\ .RS 4@@ -1114,6 +1162,19 @@ .fi
.if n \{\ .RE .\} +.PP +\fBMatches any windows having a xproperty named FOO with "bar" in it\fR. +.sp +.if n \{\ +.RS 4 +.\} +.nf +(@FOO=\&.*bar\&.*) +.fi +.if n \{\ +.RE +.\} +.sp .SH "FILES" .PP \fB\e~/\&.fluxbox/keys\fR@@ -1167,7 +1228,10 @@ # one:
Mod4 t :If {Some Matches (xterm)} {NextWindow (xterm)} {Exec xterm} # Set a different wallpaper on every workspace: -ChangeWorkspace :Exec fbsetbg ~/\&.fluxbox/bg$(xprop \-root _NET_CURRENT_DESKTOP | awk \'{print $3}\')\&.png +ChangeWorkspace :Exec fbsetbg ~/\&.fluxbox/bg$(xprop \-root _NET_CURRENT_DESKTOP | awk \*(Aq{print $3}\*(Aq)\&.png + +# Focusses the next window with it\*(Aqs xproperty \*(AqPROP\*(Aq set to \*(Aqfoo\*(Aq +Mod4 p Mod4 Tab :NextWindow (@PROP=foo) .fi .if n \{\ .RE
M
doc/fluxbox-remote.1.in
→
doc/fluxbox-remote.1.in
@@ -1,13 +1,22 @@
'\" t .\" Title: fluxbox-remote .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/> -.\" Date: 12/17/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: fluxbox-remote.txt .\" Language: English .\" -.TH "FLUXBOX\-REMOTE" "1" "12/17/2009" "fluxbox\-remote\&.txt" "Fluxbox Manual" +.TH "FLUXBOX\-REMOTE" "1" "02/19/2011" "fluxbox\-remote\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------
M
doc/fluxbox-style.5.in
→
doc/fluxbox-style.5.in
@@ -1,161 +1,22 @@
+'\" t .\" Title: fluxbox-style .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> -.\" Date: 05/26/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual -.\" Source: fluxbox-style.txt 1.1.2 +.\" Source: fluxbox-style.txt .\" Language: English .\" -.TH "FLUXBOX\-STYLE" "5" "05/26/2009" "fluxbox\-style\&.txt 1\&.1\&.2" "Fluxbox Manual" +.TH "FLUXBOX\-STYLE" "5" "02/19/2011" "fluxbox\-style\&.txt" "Fluxbox Manual" .\" ----------------------------------------------------------------- -.\" * (re)Define some macros +.\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" toupper - uppercase a string (locale-aware) -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de toupper -.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ -\\$* -.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" SH-xref - format a cross-reference to an SH section -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de SH-xref -.ie n \{\ -.\} -.toupper \\$* -.el \{\ -\\$* -.\} -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" SH - level-one heading that works better for non-TTY output -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de1 SH -.\" put an extra blank line of space above the head in non-TTY output -.if t \{\ -.sp 1 -.\} -.sp \\n[PD]u -.nr an-level 1 -.set-an-margin -.nr an-prevailing-indent \\n[IN] -.fi -.in \\n[an-margin]u -.ti 0 -.HTML-TAG ".NH \\n[an-level]" -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -\." make the size of the head bigger -.ps +3 -.ft B -.ne (2v + 1u) -.ie n \{\ -.\" if n (TTY output), use uppercase -.toupper \\$* -.\} -.el \{\ -.nr an-break-flag 0 -.\" if not n (not TTY), use normal case (not uppercase) -\\$1 -.in \\n[an-margin]u -.ti 0 -.\" if not n (not TTY), put a border/line under subheading -.sp -.6 -\l'\n(.lu' -.\} -.. +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" SS - level-two heading that works better for non-TTY output -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de1 SS -.sp \\n[PD]u -.nr an-level 1 -.set-an-margin -.nr an-prevailing-indent \\n[IN] -.fi -.in \\n[IN]u -.ti \\n[SN]u -.it 1 an-trap -.nr an-no-space-flag 1 -.nr an-break-flag 1 -.ps \\n[PS-SS]u -\." make the size of the head bigger -.ps +2 -.ft B -.ne (2v + 1u) -.if \\n[.$] \&\\$* -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" BB/BE - put background/screen (filled box) around block of text -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de BB -.if t \{\ -.sp -.5 -.br -.in +2n -.ll -2n -.gcolor red -.di BX -.\} -.. -.de EB -.if t \{\ -.if "\\$2"adjust-for-leading-newline" \{\ -.sp -1 -.\} -.br -.di -.in -.ll -.gcolor -.nr BW \\n(.lu-\\n(.i -.nr BH \\n(dn+.5v -.ne \\n(BHu+.5v -.ie "\\$2"adjust-for-leading-newline" \{\ -\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] -.\} -.el \{\ -\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[] -.\} -.in 0 -.sp -.5v -.nf -.BX -.in -.sp .5v -.fi -.\} -.. -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.\" BM/EM - put colored marker in margin next to block of text -.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -.de BM -.if t \{\ -.br -.ll -2n -.gcolor red -.di BX -.\} -.. -.de EM -.if t \{\ -.br -.di -.ll -.gcolor -.nr BH \\n(dn -.ne \\n(BHu -\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[] -.in 0 -.nf -.BX -.in -.fi -.\} -.. +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------@@ -166,9 +27,9 @@ .ad l
.\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- -.SH "Name" +.SH "NAME" fluxbox-style \- A comprehensive look at styles/themes for fluxbox(1)\&. -.SH "Synopsis" +.SH "SYNOPSIS" .sp This document describes various options available for fluxbox styles\&. .SH "DESCRIPTION"@@ -184,32 +45,26 @@ .SH "STRUCTURE"
.sp A style is made up of a few major components which then have their own sub\-directives\&. The major components are as follows: .sp -The \fIwindow\&.*\fR directives control the appearance of the window frames, window\&.tab\&.* controls the appearance of the window tabs, \fImenu\&.*\fR controls the appearance of the popup menu that you see when you right click on the desktop\&. \fItoolbar\&.*\fR is the bar you will see at the top or bottom of your screen\&. Finally the \fIslit\&.*\fR has options you can use to customize the appearance of the slit\&. However if you don\'t set the slit directives specifically, the slit\'s appearance is controlled by the toolbar directives instead\&. +The \fIwindow\&.*\fR directives control the appearance of the window frames, window\&.tab\&.* controls the appearance of the window tabs, \fImenu\&.*\fR controls the appearance of the popup menu that you see when you right click on the desktop\&. \fItoolbar\&.*\fR is the bar you will see at the top or bottom of your screen\&. Finally the \fIslit\&.\e*\fR has options you can use to customize the appearance of the slit\&. However if you don\(cqt set the slit directives specifically, the slit\(cqs appearance is controlled by the toolbar directives instead\&. .sp -To understand how the style mechanism works, it is nice to know a little about how X11 resources work\&. X11 resources consist of a key and a value\&. The key is constructed of several smaller keys (sometimes referred to as children), delimited by a period (\&.)\&. Keys may also contain an asterisk (*) to serve as a wildcard, which means that one line of text will match several keys\&. This is useful for styles that are based on one or two colors\&. +To understand how the style mechanism works, it is nice to know a little about how X11 resources work\&. X11 resources consist of a key and a value\&. The key is constructed of several smaller keys (sometimes referred to as children), delimited by a period (\&.)\&. Keys may also contain an asterisk (\e*) to serve as a wildcard, which means that one line of text will match several keys\&. This is useful for styles that are based on one or two colors\&. .sp A more complete reference to this can be found in X(7), section \fIRESOURCES\fR\&. .SH "LOCATION" .sp There are many places to store your styles, the most common is in your \fI~/\&.fluxbox/styles\fR directory\&. The initial installation will place the default styles in \fI@pkgdatadir@/styles\fR providing a basic usable configuration\&. .sp -When creating your own style, create a directory (normally the name of your style) in \fI~/\&.fluxbox/styles/\fR (If the \fIstyles\fR directory doesn\'t exist, create that also)\&. While there isn\'t an official structure, it is common to create a directory named after your style and place your pixmaps directory (if required) in there along with a file called theme\&.cfg (may also be named style\&.cfg)\&. This file is where you will construct your style using the components covered later in this manual page\&. An example of steps taken when beginning a style project of your own may look like: +When creating your own style, create a directory (normally the name of your style) in \fI~/\&.fluxbox/styles/\fR (If the \fIstyles\fR directory doesn\(cqt exist, create that also)\&. While there isn\(cqt an official structure, it is common to create a directory named after your style and place your pixmaps directory (if required) in there along with a file called theme\&.cfg (may also be named style\&.cfg)\&. This file is where you will construct your style using the components covered later in this manual page\&. An example of steps taken when beginning a style project of your own may look like: .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray $ cd $ mkdir \-p ~/\&.fluxbox/styles/YourStyle/pixmaps $ cd ~/\&.fluxbox/styles/YourStyle $ nano theme\&.cfg -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -219,25 +74,19 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray $ cd $ tar \-tjvf YourStyle\&.tar\&.bz2 \&.fluxbox/styles/YourStyle/theme\&.cfg \&.fluxbox/styles/YourStyle/pixmaps \&.fluxbox/styles/YourStyle/pixmaps/stick\&.xpm \&.\&.\&. -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .sp -Of course, all of these are just preferences, fluxbox(1) allows for the customization of many things, including how you handle your styles\&. Just remember, however, that if you plan to distribute your style you may find some community bickering if you don\'t follow practices\&. :) +Of course, all of these are just preferences, fluxbox(1) allows for the customization of many things, including how you handle your styles\&. Just remember, however, that if you plan to distribute your style you may find some community bickering if you don\(cqt follow practices\&. :) .SH "CREATING YOUR STYLE" .sp As discussed above, fluxbox(1) allows you to configure its four main components: the toolbar, menus, slit and window decorations\&. Remember that you can customize the slit with its own directives, otherwise the slit will take the appearance of the toolbar\&.@@ -247,15 +96,9 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray toolbar\&.clock\&.color: green -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -265,53 +108,35 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray menu*color: rgb:3/4/5 -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .sp -This sets the color resource of the menu and all of its \fIchildren\fR to `rgb:3/4/5\'\&. (For a description of color names, see X(1)\&.) So this one also applies to \fImenu\&.title\&.color\fR and \fImenu\&.frame\&.color\fR\&. And with +This sets the color resource of the menu and all of its \fIchildren\fR to \(oqrgb:3/4/5\(cq\&. (For a description of color names, see X(1)\&.) So this one also applies to \fImenu\&.title\&.color\fR and \fImenu\&.frame\&.color\fR\&. And with .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray *font: \-b&h\-lucida\-medium\-r\-normal\-*\-*\-140\-* -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .sp you set the font resource for all keys to this font name all at once (For information about the fonts installed on your system, you can use a program like xfontsel(1), gtkfontsel, or xlsfonts(1)\&.) .sp -In the last example you will notice the wildcard (*) before font\&. In a Fluxbox style you can set a value with a wildcard\&. The example means that every font in the style will be what is specified\&. You can do this with any component/value\&. For example if you wanted all of the text to be one color you would do: +In the last example you will notice the wildcard (\e*) before font\&. In a Fluxbox style you can set a value with a wildcard\&. The example means that every font in the style will be what is specified\&. You can do this with any component/value\&. For example if you wanted all of the text to be one color you would do: .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray *textColor: rgb:3/4/5 -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -321,16 +146,10 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray *textColor: rgb:3/4/5 toolbar\&.clock\&.textColor: rgb:255/0/0 -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -342,22 +161,16 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray toolbar\&.clock: Raised Gradient Diagonal Bevel1 toolbar\&.clock\&.color: rgb:8/6/4 toolbar\&.clock\&.colorTo: rgb:4/3/2 -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .sp -Don\'t worry, we will explain what these mean\&. A texture description consists of up to five fields, which are as follows: +Don\(cqt worry, we will explain what these mean\&. A texture description consists of up to five fields, which are as follows: .PP \fBFlat | Raised | Sunken\fR. gives the component either a flat, raised or sunken appearance\&. .PP@@ -378,16 +191,10 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray toolbar\&.clock: pixmap toolbar\&.clock\&.pixmap: clock_background\&.xpm -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -402,15 +209,9 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray menu\&.title\&.font: sans\-8:bold,shadow -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -420,17 +221,11 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray \-\-\-\-\-\-\-\- Shadow color=<colorname> offsetx=<integer> offsety=<integer> Halo color=<colorname> \-\-\-\-\-\-\-\- -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -440,16 +235,10 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray *\&.font: Verdana\-10:bold,shadow:offsetx=2;offsety=4;color=green *\&.font: Verdana\-10:halo:color=blue -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -468,10 +257,7 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- window\&.bevelWidth: <integer> window\&.borderColor: <color>@@ -551,10 +337,7 @@ window\&.title\&.unfocus\&.color: <color>
window\&.title\&.unfocus\&.colorTo: <color> window\&.title\&.unfocus\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -565,10 +348,7 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- menu\&.bevelWidth: <integer> menu\&.borderColor: <color>@@ -602,34 +382,25 @@ menu\&.selected\&.pixmap: <filename>
menu\&.submenu\&.pixmap: <filename> menu\&.unselected\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\} .SH "BACKGROUND" .sp -Every style must specify the background option\&. If you don\'t want your style to change the user\'s background, then use `background: none\'\&. The options `centered\', `aspect\', `tiled\', and `fullscreen\' require the `background\&.pixmap\' resource to contain a valid file name\&. The `random\' option requires `background\&.pixmap\' to contain a valid directory name\&. For these options, \fBfluxbox(1)\fR will call \fBfbsetbg(1)\fR to set the background\&. The options `gradient\', `solid\', and `mod\' all require `background\&.color\' to be set\&. `gradient\' and `mod\' both require `background\&.colorTo\'\&. `mod\' requires `background\&.modX\' and `background\&.modY\' to be set as well\&. These options will be passed to \fBfbsetroot(1)\fR to set the background\&. The special option `unset\' is for use in user overlay files only\&. It specifies that fbsetbg should never be run (by default, even when `none\' is set in the overlay, fluxbox will try to run \(lqfbsetbg \-z\(rq to restore the last wallpaper)\&. +Every style must specify the background option\&. If you don\(cqt want your style to change the user\(cqs background, then use \(oqbackground: none\(cq\&. The options \(oqcentered\(cq, \(oqaspect\(cq, \(oqtiled\(cq, and \(oqfullscreen\(cq require the \(oqbackground\&.pixmap\(cq resource to contain a valid file name\&. The \(oqrandom\(cq option requires \(oqbackground\&.pixmap\(cq to contain a valid directory name\&. For these options, \fBfluxbox(1)\fR will call \fBfbsetbg(1)\fR to set the background\&. The options \(oqgradient\(cq, \(oqsolid\(cq, and \(oqmod\(cq all require \(oqbackground\&.color\(cq to be set\&. \(oqgradient\(cq and \(oqmod\(cq both require \(oqbackground\&.colorTo\(cq\&. \(oqmod\(cq requires \(oqbackground\&.modX\(cq and \(oqbackground\&.modY\(cq to be set as well\&. These options will be passed to \fBfbsetroot(1)\fR to set the background\&. The special option \(oqunset\(cq is for use in user overlay files only\&. It specifies that fbsetbg should never be run (by default, even when \(oqnone\(cq is set in the overlay, fluxbox will try to run \(lqfbsetbg \-z\(rq to restore the last wallpaper)\&. .sp .if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture>|mod|none|unset background\&.pixmap: <file or directory> background\&.color: <color> background\&.colorTo: <color> background\&.modX: <integer> background\&.modY: <integer> -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -640,10 +411,7 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- slit: <texture type> slit\&.bevelWidth: <integer>@@ -653,10 +421,7 @@ slit\&.color: <color>
slit\&.colorTo: <color> slit\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -667,10 +432,7 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- toolbar: <texture type> toolbar\&.bevelWidth: <integer (0\-255)>@@ -725,10 +487,7 @@ toolbar\&.workspace\&.color: <color>
toolbar\&.workspace\&.colorTo: <color> toolbar\&.workspace\&.pixmap: <filename> \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -739,10 +498,7 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- *color: slategrey *colorTo: darkslategrey@@ -752,10 +508,7 @@ *textColor: white
*unfocus\&.textColor: lightgrey *font: lucidasans\-10 \-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}@@ -768,16 +521,10 @@ .sp
.if n \{\ .RS 4 .\} -.fam C -.ps -1 .nf -.BB lightgray #000000 (Hexadecimal) rgb:<0\-255>/<0\-255>/<0\-255> -.EB lightgray .fi -.fam -.ps +1 .if n \{\ .RE .\}
M
doc/fluxbox.1.in
→
doc/fluxbox.1.in
@@ -2,12 +2,21 @@ '\" t
.\" Title: fluxbox .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> -.\" Date: 05/28/2010 +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: fluxbox.txt .\" Language: English .\" -.TH "FLUXBOX" "1" "05/28/2010" "fluxbox\&.txt" "Fluxbox Manual" +.TH "FLUXBOX" "1" "02/19/2011" "fluxbox\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------@@ -1181,7 +1190,7 @@ .RS 4
Shows all windows (iconified or not) from all workspaces .RE .sp -The next section specifies the alignment of the window names shown in the iconbar\&. The with is specified via the +The next section specifies the alignment of the window names shown in the iconbar\&. The width is specified via the \fBsession\&.screen0\&.iconbar\&.iconWidth\fR resource: .PP
M
doc/startfluxbox.1.in
→
doc/startfluxbox.1.in
@@ -1,13 +1,22 @@
'\" t .\" Title: startfluxbox .\" Author: [see the "AUTHORS" section] -.\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/> -.\" Date: 12/17/2009 +.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/> +.\" Date: 02/19/2011 .\" Manual: Fluxbox Manual .\" Source: startfluxbox.txt .\" Language: English .\" -.TH "STARTFLUXBOX" "1" "12/17/2009" "startfluxbox\&.txt" "Fluxbox Manual" +.TH "STARTFLUXBOX" "1" "02/19/2011" "startfluxbox\&.txt" "Fluxbox Manual" +.\" ----------------------------------------------------------------- +.\" * Define some portability stuff +.\" ----------------------------------------------------------------- +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.\" http://bugs.debian.org/507673 +.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html +.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" -----------------------------------------------------------------@@ -46,13 +55,13 @@ #!/bin/sh
# # fluxbox startup\-script: # -# Lines starting with a \'#\' are ignored\&. +# Lines starting with a \*(Aq#\*(Aq are ignored\&. # Change your keymap: xmodmap "$HOME/\&.Xmodmap" # Applications you want to run with fluxbox\&. -# MAKE SURE THAT APPS THAT KEEP RUNNING HAVE AN \'\'&\'\' AT THE END\&. +# MAKE SURE THAT APPS THAT KEEP RUNNING HAVE AN \*(Aq\*(Aq&\*(Aq\*(Aq AT THE END\&. # # unclutter \-idle 2 & # wmnd &@@ -60,7 +69,7 @@ # wmsmixer \-w &
# idesk & # And last but not least we start fluxbox\&. -# Because it is the last app you have to run it with \'\'exec\'\' before it\&. +# Because it is the last app you have to run it with \*(Aq\*(Aqexec\*(Aq\*(Aq before it\&. exec fluxbox # or if you want to keep a log: