aboutsummaryrefslogtreecommitdiff
path: root/doc/fluxbox.1.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/fluxbox.1.in')
-rw-r--r--doc/fluxbox.1.in63
1 files changed, 54 insertions, 9 deletions
diff --git a/doc/fluxbox.1.in b/doc/fluxbox.1.in
index 335f79a..40639d2 100644
--- a/doc/fluxbox.1.in
+++ b/doc/fluxbox.1.in
@@ -42,7 +42,7 @@
42.if n .sp 1 42.if n .sp 1
43.if t .sp .5 43.if t .sp .5
44.. 44..
45.TH fluxbox 1 "September 26th, 2003" "0.9.6" 45.TH fluxbox 1 "January 5th, 2004" "0.9.7"
46.SH NAME 46.SH NAME
47fluxbox \- a window manager for X11 47fluxbox \- a window manager for X11
48.SH SYNOPSIS 48.SH SYNOPSIS
@@ -148,7 +148,10 @@ The contents can be configured in fluxbox init-file in the entry
148.EX 148.EX
149session.screen0.toolbar.tools: clock, iconbar, workspacename 149session.screen0.toolbar.tools: clock, iconbar, workspacename
150.EE 150.EE
151 151or the toolbar can be turned off by
152.EX
153session.screen0.toolbar.visible: false
154.EE
152.\" A left click on the toolbar will bring it to the foreground, a 155.\" A left click on the toolbar will bring it to the foreground, a
153.\" middle click will hide it behind other windows (if AlwaysOnTop is not set), and 156.\" middle click will hide it behind other windows (if AlwaysOnTop is not set), and
154.\" the right button brings up a little menu. 157.\" the right button brings up a little menu.
@@ -194,10 +197,13 @@ as well as in the toolbar.
194(Un)Maximize window. Depending on toolbar and slit configuration maximize does 197(Un)Maximize window. Depending on toolbar and slit configuration maximize does
195cover slit and toolbar or not. 198cover slit and toolbar or not.
196.TP 199.TP
197.B Maximize Vertical 200.B Button1
201(usually left button) Maximize Normal, i.e. Vertical and Horizontal
202.TP
203.B Button2
198(Un)Maximize window only vertically. 204(Un)Maximize window only vertically.
199.TP 205.TP
200.B Maximize Horizontal 206.B Button3
201(Un)Maximize window only horizontal. 207(Un)Maximize window only horizontal.
202.TP 208.TP
203.B Raise 209.B Raise
@@ -254,6 +260,12 @@ titlebar, you can press Alt + button 1 anywhere in the window and then
254drag it around. 260drag it around.
255You can also use Alt + button 1 to raise a partially visible window. 261You can also use Alt + button 1 to raise a partially visible window.
256Finally, Alt + button 2 lowers a window, and Alt + button 3 resizes the window. 262Finally, Alt + button 2 lowers a window, and Alt + button 3 resizes the window.
263.PP
264This can be disabled in the resource file
265.I ~/.fluxbox/init
266with
267.TP
268session.useMod1: \fItrue\fR or \fIfalse\fR
257.SH MENU FILE 269.SH MENU FILE
258A default menu file is installed in 270A default menu file is installed in
259.IR @pkgdatadir@/menu . 271.IR @pkgdatadir@/menu .
@@ -276,6 +288,17 @@ Be sure that your menu is usable, then choose `Restart' from the default
276Fluxbox root menu. If only the contents of the menu file changed, only 288Fluxbox root menu. If only the contents of the menu file changed, only
277.I reload config 289.I reload config
278is needed. 290is needed.
291.SS Menu behaviour
292The behaviour of the menu can be configured in the
293.I ~/.fluxbox/init
294file, with the following entries:
295.TP
296session.screen0.menuMode: can be either Click or Delay (default: Delay)
297.TP
298session.screen0.menuDelay: in msec (default: 0 )
299.TP
300session.screen0.menuDelayClose: in msec (default: 0 )
301.EE
279.SS Menu syntax 302.SS Menu syntax
280The menu syntax is very simple and very effective. 303The menu syntax is very simple and very effective.
281There are up to three fields in a menu line. 304There are up to three fields in a menu line.
@@ -326,6 +349,9 @@ if so desired.
326does accept a label, but it is not required, and a blank item will be used 349does accept a label, but it is not required, and a blank item will be used
327if none is supplied. 350if none is supplied.
328.TP 351.TP
352.B [separator]
353will create a nice separator line.
354.TP
329.B [style] (label) {filename} 355.B [style] (label) {filename}
330This tells Fluxbox to insert an item that, when selected, reads style file 356This tells Fluxbox to insert an item that, when selected, reads style file
331named 357named
@@ -633,6 +659,7 @@ menu.frame.colorTo: Color
633menu.frame.textColor: Color 659menu.frame.textColor: Color
634menu.frame.disableColor: Color 660menu.frame.disableColor: Color
635menu.frame.font: Font 661menu.frame.font: Font
662! Font can have a shadow. e.g. menu.frame.font: Verdana-8:shadow
636menu.frame.justify: \fIcenter\fR, \fIleft\fR, or \fIright\fR 663menu.frame.justify: \fIcenter\fR, \fIleft\fR, or \fIright\fR
637 664
638! Bullets for submenu items 665! Bullets for submenu items
@@ -666,6 +693,10 @@ window.label.unfocus.color: Color
666window.label.unfocus.colorTo: Color 693window.label.unfocus.colorTo: Color
667window.label.unfocus.textColor: Color 694window.label.unfocus.textColor: Color
668 695
696! window label for active tab if window is not focussed
697window.label.active: Texture
698window.label.active.textColor: Color
699
669! Handlebar 700! Handlebar
670window.handle.focus: Texture 701window.handle.focus: Texture
671window.handle.focus.color: Color 702window.handle.focus.color: Color
@@ -836,14 +867,19 @@ PrevWindow \fIby-number\fR
836NextGroup \fIby-number\fR 867NextGroup \fIby-number\fR
837PrevGroup \fIby-number\fR 868PrevGroup \fIby-number\fR
838ArrangeWindows 869ArrangeWindows
839ShowDesktop : Iconifies all windows. 870ShowDesktop - Iconifies all windows.
840RootMenu 871RootMenu
841WorkspaceMenu 872WorkspaceMenu
842SetWorkspaceName 873WorkspaceNameDialog - edit workspaces name dialog (old SetWorkspaceName)
874SetWorkspaceName \fIname\fR
843.EE 875.EE
844.B special commands 876.B special commands
845.EX 877.EX
846MacroCmd 878MacroCmd
879ReloadStyle
880SetResourceValueCmd \fIresourcename\fR \fIresource value\fR
881BindKey \fIkey string : action\fR - this will append key string and
882 action to your keys file and bind the key
847.EE 883.EE
848.\" --- groups --- 884.\" --- groups ---
849.SH GROUPS FILE 885.SH GROUPS FILE
@@ -1055,6 +1091,15 @@ or
1055.IR False 1091.IR False
1056to enable or disable Fluxbox using the toolbar to display iconified windows. 1092to enable or disable Fluxbox using the toolbar to display iconified windows.
1057.TP 1093.TP
1094.B session.screen0.iconbar.alignment:
1095.IR LEFT, RELATIVE or RIGHT
1096can be changed in the iconbar mode menu. If LEFT or RIGHT is specified the
1097iconbar buttons have a fixed with and are left/right aligned.
1098.TP
1099.B session.screen0.iconbar.clientWidth:
1100.IR Integer
1101is used to specify the iconbar button width for LEFT/RIGHT alignment.
1102.TP
1058.B session.tabs: 1103.B session.tabs:
1059.IR True 1104.IR True
1060or 1105or
@@ -1113,8 +1158,8 @@ the application from another workspace.
1113.B Dimensions [Width Height] 1158.B Dimensions [Width Height]
1114Remember the current dimensions. 1159Remember the current dimensions.
1115.TP 1160.TP
1116.B Position [X Y] 1161.B Position ([WINCENTER|CENTER|UPPERLEFT|UPPERRIGHT|LOWERLEFT|LOWERRIGHT]) [X Y]
1117Remember the current position. 1162Remember the current position. X and Y are relative to e.g. WINCENTER .
1118.TP 1163.TP
1119.B Shaded state [yes|no] 1164.B Shaded state [yes|no]
1120Remember the current shaded state. 1165Remember the current shaded state.
@@ -1140,7 +1185,7 @@ Here is a short example of an apps file:
1140.PP 1185.PP
1141.nf 1186.nf
1142[app] (kate) 1187[app] (kate)
1143 [Dimensions] {1022 747} 1188 [Dimensions] (WINCENTER) {1022 747}
1144 [Position] {0 0} 1189 [Position] {0 0}
1145 [Close] {yes} 1190 [Close] {yes}
1146[end] 1191[end]