Documentation: white-spaces and minor formatting
This commit is contained in:
Mathias Gumz
parent
3d6d7f8183
commit
a46a4aef08
11 changed files with 345 additions and 350 deletions
|
|
@ -1,5 +1,5 @@
|
||||||
A 'pattern' looks like this:::
|
A 'pattern' looks like this:::
|
||||||
*(*['propertyname'[!]=]'regexp'*)* ...
|
*(*['propertyname'[!]=]'regexp'*)* ...
|
||||||
|
|
||||||
Match definitions are enclosed in parentheses *(*...*)*, and if no
|
Match definitions are enclosed in parentheses *(*...*)*, and if no
|
||||||
'propertyname' is given then *Name* is assumed. The 'regexp' can contain any
|
'propertyname' is given then *Name* is assumed. The 'regexp' can contain any
|
||||||
|
|
@ -16,71 +16,71 @@ You can use *=* to test for equality or *!=* to test for inequality.
|
||||||
|
|
||||||
The following values are accepted for 'propertyname':::
|
The following values are accepted for 'propertyname':::
|
||||||
*Name*;;
|
*Name*;;
|
||||||
A string, corresponding to the CLASSNAME property (The first field of
|
A string, corresponding to the CLASSNAME property (The first field of
|
||||||
WM_CLASS from the output of the *xprop(1)* utility).
|
WM_CLASS from the output of the *xprop(1)* utility).
|
||||||
*Class*;;
|
*Class*;;
|
||||||
A string, corresponding to the CLASSCLASS property (The second field of
|
A string, corresponding to the CLASSCLASS property (The second field of
|
||||||
WM_CLASS from the output of the *xprop(1)* utility).
|
WM_CLASS from the output of the *xprop(1)* utility).
|
||||||
*Title*;;
|
*Title*;;
|
||||||
A string, corresponding to the window title (WM_NAME from *xprop(1)*).
|
A string, corresponding to the window title (WM_NAME from *xprop(1)*).
|
||||||
*Role*;;
|
*Role*;;
|
||||||
A string, corresponding to the ROLE property (WM_WINDOW_ROLE from
|
A string, corresponding to the ROLE property (WM_WINDOW_ROLE from
|
||||||
*xprop(1)*).
|
*xprop(1)*).
|
||||||
*Transient*;;
|
*Transient*;;
|
||||||
Either *yes* or *no*, depending on whether the window is transient
|
Either *yes* or *no*, depending on whether the window is transient
|
||||||
(typically, a popup dialog) or not.
|
(typically, a popup dialog) or not.
|
||||||
*Maximized*;;
|
*Maximized*;;
|
||||||
Either *yes* or *no*, depending on whether the window is maximized or
|
Either *yes* or *no*, depending on whether the window is maximized or
|
||||||
not.
|
not.
|
||||||
*MaximizedHorizontal*;;
|
*MaximizedHorizontal*;;
|
||||||
Either *yes* or *no*, depending on whether the window is maximized
|
Either *yes* or *no*, depending on whether the window is maximized
|
||||||
horizontally or not.
|
horizontally or not.
|
||||||
*MaximizedVertical*;;
|
*MaximizedVertical*;;
|
||||||
Either *yes* or *no*, depending on whether the window is maximized
|
Either *yes* or *no*, depending on whether the window is maximized
|
||||||
vertically or not.
|
vertically or not.
|
||||||
*Minimized*;;
|
*Minimized*;;
|
||||||
Either *yes* or *no*, depending on whether the window is minimized
|
Either *yes* or *no*, depending on whether the window is minimized
|
||||||
(iconified) or not.
|
(iconified) or not.
|
||||||
*Fullscreen*;;
|
*Fullscreen*;;
|
||||||
Either *yes* or *no*, depending on whether the window is fullscreen or
|
Either *yes* or *no*, depending on whether the window is fullscreen or
|
||||||
not.
|
not.
|
||||||
*Shaded*;;
|
*Shaded*;;
|
||||||
Either *yes* or *no*, depending on whether the window is shaded or
|
Either *yes* or *no*, depending on whether the window is shaded or
|
||||||
not.
|
not.
|
||||||
*Stuck*;;
|
*Stuck*;;
|
||||||
Either *yes* or *no*, depending on whether the window is sticky (on
|
Either *yes* or *no*, depending on whether the window is sticky (on
|
||||||
all workspaces) or not.
|
all workspaces) or not.
|
||||||
*FocusHidden*;;
|
*FocusHidden*;;
|
||||||
Either *yes* or *no*, depending on whether the window has asked to be
|
Either *yes* or *no*, depending on whether the window has asked to be
|
||||||
left off the focus list (or, the alt-tab list), or not.
|
left off the focus list (or, the alt-tab list), or not.
|
||||||
*IconHidden*;;
|
*IconHidden*;;
|
||||||
Either *yes* or *no*, depending on whether the window has asked to be
|
Either *yes* or *no*, depending on whether the window has asked to be
|
||||||
left off the icon list (or, the taskbar), or not.
|
left off the icon list (or, the taskbar), or not.
|
||||||
*Urgent*;;
|
*Urgent*;;
|
||||||
Either *yes* or *no*, depending on whether the window has the urgent
|
Either *yes* or *no*, depending on whether the window has the urgent
|
||||||
hint set.
|
hint set.
|
||||||
*Workspace*;;
|
*Workspace*;;
|
||||||
A number corresponding to the workspace number to which the window is
|
A number corresponding to the workspace number to which the window is
|
||||||
attached. The first workspace here is *0*. You may also use *[current]* to
|
attached. The first workspace here is *0*. You may also use *[current]* to
|
||||||
match the currently visible workspace.
|
match the currently visible workspace.
|
||||||
*WorkspaceName*;;
|
*WorkspaceName*;;
|
||||||
A string corresponding to the name of the workspace to which the
|
A string corresponding to the name of the workspace to which the
|
||||||
window is attached.
|
window is attached.
|
||||||
*Head*;;
|
*Head*;;
|
||||||
The number of the display head to which the window is attached. You
|
The number of the display head to which the window is attached. You
|
||||||
may match this against the special value *[mouse]* which refers to the
|
may match this against the special value *[mouse]* which refers to the
|
||||||
head where the mouse pointer currently resides.
|
head where the mouse pointer currently resides.
|
||||||
*Layer*;;
|
*Layer*;;
|
||||||
The string name of the window's layer, which is one of
|
The string name of the window's layer, which is one of
|
||||||
*AboveDock*, *Dock*, *Top*, *Normal*, *Bottom*, *Desktop*
|
*AboveDock*, *Dock*, *Top*, *Normal*, *Bottom*, *Desktop*
|
||||||
*Screen*;;
|
*Screen*;;
|
||||||
The number of the currently used 'screen'. If the setup of the
|
The number of the currently used 'screen'. If the setup of the
|
||||||
running xserver involves independent screens ('not Xinerama'), the $DISPLAY
|
running xserver involves independent screens ('not Xinerama'), the $DISPLAY
|
||||||
environment contains something like ':0.1' or ':1.0'. The part after the
|
environment contains something like ':0.1' or ':1.0'. The part after the
|
||||||
dot ('.') is the number of the screen.
|
dot ('.') is the number of the screen.
|
||||||
*@XPROP*;;
|
*@XPROP*;;
|
||||||
A string, corresponding to any xproperty (Use either the *xprop(1)*
|
A string, corresponding to any xproperty (Use either the *xprop(1)*
|
||||||
utility or the 'SetXProp' command to set a xproperty to a window)
|
utility or the 'SetXProp' command to set a xproperty to a window)
|
||||||
|
|
||||||
.Matches any windows with the CLASSNAME of "xterm"
|
.Matches any windows with the CLASSNAME of "xterm"
|
||||||
..........
|
..........
|
||||||
|
|
|
||||||
|
|
@ -92,11 +92,11 @@ EXAMPLES
|
||||||
To use *feh(1)* as wallpapersetter and set *wallpapper.jpg* from the current
|
To use *feh(1)* as wallpapersetter and set *wallpapper.jpg* from the current
|
||||||
directory as wallpaper.
|
directory as wallpaper.
|
||||||
|
|
||||||
$ wpsetters=feh fbsetbg wallpaper.jpg
|
$ wpsetters=feh fbsetbg wallpaper.jpg
|
||||||
|
|
||||||
Recall the last set wallpaper on display *:0.0* with the stored options.
|
Recall the last set wallpaper on display *:0.0* with the stored options.
|
||||||
|
|
||||||
$ DISPLAY=:0.0 fbsetbg -l
|
$ DISPLAY=:0.0 fbsetbg -l
|
||||||
|
|
||||||
BUGS
|
BUGS
|
||||||
----
|
----
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,7 @@ Creates a modula pattern. You must specify *-bg* and *-fg* colors.
|
||||||
Renders the specified texture string to the root window.
|
Renders the specified texture string to the root window.
|
||||||
+
|
+
|
||||||
'texturestring' may be one of:;;
|
'texturestring' may be one of:;;
|
||||||
*Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic /
|
*Horizontal / Vertical / Diagonal / Crossdiagonal / Pipecross / Elliptic /
|
||||||
Rectangle / Pyramid*
|
Rectangle / Pyramid*
|
||||||
+
|
+
|
||||||
Select one of these texture types, they only apply when *-gradient* is
|
Select one of these texture types, they only apply when *-gradient* is
|
||||||
|
|
|
||||||
|
|
@ -43,7 +43,7 @@ APP SECTIONS
|
||||||
*[app]* sections provide settings for individual application windows.
|
*[app]* sections provide settings for individual application windows.
|
||||||
|
|
||||||
These sections begin with a line of the format:::
|
These sections begin with a line of the format:::
|
||||||
*[app]* *(*'pattern'*)* *{*'count'*}*
|
*[app]* *(*'pattern'*)* *{*'count'*}*
|
||||||
|
|
||||||
The 'pattern' can be one or more patterns which match windows. For more
|
The 'pattern' can be one or more patterns which match windows. For more
|
||||||
details, see *CLIENT PATTERNS*. If you specify more than one 'pattern', they
|
details, see *CLIENT PATTERNS*. If you specify more than one 'pattern', they
|
||||||
|
|
@ -57,7 +57,7 @@ This opening *[apps]* line is followed by any number of settings for the
|
||||||
application. See *SETTINGS* for more details.
|
application. See *SETTINGS* for more details.
|
||||||
|
|
||||||
Each of these sections ends with the single line:::
|
Each of these sections ends with the single line:::
|
||||||
*[end]*
|
*[end]*
|
||||||
|
|
||||||
GROUP SECTIONS
|
GROUP SECTIONS
|
||||||
--------------
|
--------------
|
||||||
|
|
@ -65,7 +65,7 @@ The primary purpose of *[group]* sections is to group windows together. All
|
||||||
windows in a group will be tabbed together automatically.
|
windows in a group will be tabbed together automatically.
|
||||||
|
|
||||||
These sections begin with a line of the format:::
|
These sections begin with a line of the format:::
|
||||||
*[group]* *(*'pattern'*)*
|
*[group]* *(*'pattern'*)*
|
||||||
|
|
||||||
Where the 'pattern' item is optional. If specified, this pattern must match for
|
Where the 'pattern' 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
|
the group to take effect. It is common to use non-window-specific patterns such
|
||||||
|
|
@ -76,13 +76,13 @@ the *[app]* section detailed above in *APP SECTIONS*, but do not contain any
|
||||||
settings and do not have an associated *[end]* line.
|
settings and do not have an associated *[end]* line.
|
||||||
|
|
||||||
Like this:::
|
Like this:::
|
||||||
*[app]* *(*'pattern'*)*
|
*[app]* *(*'pattern'*)*
|
||||||
|
|
||||||
This section may also contain settings that are applied to every window in the
|
This section may also contain settings that are applied to every window in the
|
||||||
group. See the *SETTINGS* section for details.
|
group. See the *SETTINGS* section for details.
|
||||||
|
|
||||||
As with *[app]* sections, each of these sections ends with the single line:::
|
As with *[app]* sections, each of these sections ends with the single line:::
|
||||||
*[end]*
|
*[end]*
|
||||||
|
|
||||||
SETTINGS
|
SETTINGS
|
||||||
--------
|
--------
|
||||||
|
|
@ -90,34 +90,34 @@ These settings may be stored in the `apps' file. A settings line must appear
|
||||||
inside either an *[app]* or *[group]* section.
|
inside either an *[app]* or *[group]* section.
|
||||||
|
|
||||||
The general format is:::
|
The general format is:::
|
||||||
*[*'setting'*]* *{*'value'*}*
|
*[*'setting'*]* *{*'value'*}*
|
||||||
|
|
||||||
All allowed values are described below, except for 'bool' which can simply have
|
All allowed values are described below, except for 'bool' which can simply have
|
||||||
the value *yes* or *no*, which enables or disables the associated setting,
|
the value *yes* or *no*, which enables or disables the associated setting,
|
||||||
respectively.
|
respectively.
|
||||||
|
|
||||||
*[Workspace]* {'number'}::
|
*[Workspace]* {'number'}::
|
||||||
Forces the application to open on the 'number' workspace specified.
|
Forces the application to open on the 'number' workspace specified.
|
||||||
Workspaces are set by number, beginning with 0.
|
Workspaces are set by number, beginning with 0.
|
||||||
|
|
||||||
*[Jump]* {'bool'}::
|
*[Jump]* {'bool'}::
|
||||||
Changes the active workspace to the remembered one when the application is
|
Changes the active workspace to the remembered one when the application is
|
||||||
opened. This is only useful when used in conjunction with '[Workspace]'. See
|
opened. This is only useful when used in conjunction with '[Workspace]'. See
|
||||||
*EXAMPLES*.
|
*EXAMPLES*.
|
||||||
|
|
||||||
*[Head]* {'number'}::
|
*[Head]* {'number'}::
|
||||||
Forces the application to open on the 'number' head specified (Xinerama
|
Forces the application to open on the 'number' head specified (Xinerama
|
||||||
only).
|
only).
|
||||||
|
|
||||||
*[Layer]* {'number'}::
|
*[Layer]* {'number'}::
|
||||||
Specify the layer to open the window on (by number). Each layer has a
|
Specify the layer to open the window on (by number). Each layer has a
|
||||||
number. The named ones are: 2-AboveDock, 4-Dock, 6-Top, 8-Normal, 10-Bottom,
|
number. The named ones are: 2-AboveDock, 4-Dock, 6-Top, 8-Normal, 10-Bottom,
|
||||||
12-Desktop.
|
12-Desktop.
|
||||||
|
|
||||||
*[Dimensions]* {'width[%]' 'height[%]'}::
|
*[Dimensions]* {'width[%]' 'height[%]'}::
|
||||||
Opens the application with the specified 'width' and 'height', in pixels.
|
Opens the application with the specified 'width' and 'height', in pixels.
|
||||||
If the value is given in percent, then the window size will be based on
|
If the value is given in percent, then the window size will be based on
|
||||||
the current screen's size.
|
the current screen's size.
|
||||||
|
|
||||||
*[Position]* ('anchor') {'X[%]' 'Y[%]'}::
|
*[Position]* ('anchor') {'X[%]' 'Y[%]'}::
|
||||||
Position the application at a particular spot. By default the upper-left corner
|
Position the application at a particular spot. By default the upper-left corner
|
||||||
|
|
@ -133,18 +133,18 @@ percent, then the coordinates will be based on the current screen's size.
|
||||||
Specify the decoration state. There are several predefined 'value' sets:;;
|
Specify the decoration state. There are several predefined 'value' sets:;;
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
*NORMAL*;;
|
*NORMAL*;;
|
||||||
Standard decorations
|
Standard decorations
|
||||||
*NONE*;;
|
*NONE*;;
|
||||||
No decorations
|
No decorations
|
||||||
*BORDER*;;
|
*BORDER*;;
|
||||||
Like NONE except keep the X window border
|
Like NONE except keep the X window border
|
||||||
*TAB*;;
|
*TAB*;;
|
||||||
Like BORDER except keep external tabs (if enabled)
|
Like BORDER except keep external tabs (if enabled)
|
||||||
*TINY*;;
|
*TINY*;;
|
||||||
Titlebar with only an iconify button
|
Titlebar with only an iconify button
|
||||||
*TOOL*;;
|
*TOOL*;;
|
||||||
Titlebar only
|
Titlebar only
|
||||||
|
|
||||||
--
|
--
|
||||||
+
|
+
|
||||||
|
|
@ -153,58 +153,58 @@ The 'value' may also be a bitmask for finer-grained control. The bits are, from
|
||||||
Button, Close Button, Menu Button, Sticky Button, Shade Button, External Tabs, Focus Enabled.
|
Button, Close Button, Menu Button, Sticky Button, Shade Button, External Tabs, Focus Enabled.
|
||||||
|
|
||||||
*[Shaded]* {'bool'}::
|
*[Shaded]* {'bool'}::
|
||||||
Whether the window is Shaded (rolled-up) or not.
|
Whether the window is Shaded (rolled-up) or not.
|
||||||
|
|
||||||
*[Tab]* {'bool'}::
|
*[Tab]* {'bool'}::
|
||||||
Whether the window has tabs enabled.
|
Whether the window has tabs enabled.
|
||||||
|
|
||||||
*[FocusNewWindow]* {'bool'}::
|
*[FocusNewWindow]* {'bool'}::
|
||||||
If enabled, a new window will grab X focus as soon as it is opened.
|
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.
|
If disabled, a new window will not grab X focus as soon as it is opened.
|
||||||
|
|
||||||
*[FocusHidden]* {'bool'}::
|
*[FocusHidden]* {'bool'}::
|
||||||
If enabled, the window will not appear in 'NextWindow'/'PrevWindow' lists.
|
If enabled, the window will not appear in 'NextWindow'/'PrevWindow' lists.
|
||||||
|
|
||||||
*[IconHidden]* {'bool'}::
|
*[IconHidden]* {'bool'}::
|
||||||
If enabled, the window will not appear in the icon area of the toolbar.
|
If enabled, the window will not appear in the icon area of the toolbar.
|
||||||
|
|
||||||
*[Hidden]* {'bool'}::
|
*[Hidden]* {'bool'}::
|
||||||
A shortcut for setting both *FocusHidden* and *IconHidden* at the same time.
|
A shortcut for setting both *FocusHidden* and *IconHidden* at the same time.
|
||||||
|
|
||||||
*[Sticky]* {'bool'}::
|
*[Sticky]* {'bool'}::
|
||||||
Specify if an application should be sticky (shown on all workspaces) or not.
|
Specify if an application should be sticky (shown on all workspaces) or not.
|
||||||
|
|
||||||
*[Minimized]* {'bool'}::
|
*[Minimized]* {'bool'}::
|
||||||
Application should start minimized
|
Application should start minimized
|
||||||
|
|
||||||
*[Maximized]* {'value'}::
|
*[Maximized]* {'value'}::
|
||||||
Application should start maximized. 'value' may be:;;
|
Application should start maximized. 'value' may be:;;
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
*yes*;;
|
*yes*;;
|
||||||
Fully maximized
|
Fully maximized
|
||||||
*horz*;;
|
*horz*;;
|
||||||
Horizontally maximized
|
Horizontally maximized
|
||||||
*vert*;;
|
*vert*;;
|
||||||
Vertically maximized
|
Vertically maximized
|
||||||
*no*;;
|
*no*;;
|
||||||
Not maximized
|
Not maximized
|
||||||
|
|
||||||
--
|
--
|
||||||
|
|
||||||
*[Fullscreen]* {'bool'}::
|
*[Fullscreen]* {'bool'}::
|
||||||
Application should start in fullscreen mode (fully maximized without any
|
Application should start in fullscreen mode (fully maximized without any
|
||||||
decorations).
|
decorations).
|
||||||
|
|
||||||
*[Close]* {'bool'}::
|
*[Close]* {'bool'}::
|
||||||
Save settings on close. By default, application settings are not updated when
|
Save settings on close. By default, application settings are not updated when
|
||||||
a window is closed.
|
a window is closed.
|
||||||
|
|
||||||
*[Alpha]* {'value' ['value']}::
|
*[Alpha]* {'value' ['value']}::
|
||||||
Set the alpha value for this window. If two values are given, they
|
Set the alpha value for this window. If two values are given, they
|
||||||
correspond to the focused and unfocused transparency, respectively. One
|
correspond to the focused and unfocused transparency, respectively. One
|
||||||
number only will be used for both values. 'value' is an integer between 0
|
number only will be used for both values. 'value' is an integer between 0
|
||||||
and 255.
|
and 255.
|
||||||
|
|
||||||
CLIENT PATTERNS
|
CLIENT PATTERNS
|
||||||
---------------
|
---------------
|
||||||
|
|
@ -213,12 +213,12 @@ include::client-patterns.txt[]
|
||||||
FILES
|
FILES
|
||||||
-----
|
-----
|
||||||
*~/.fluxbox/apps*::
|
*~/.fluxbox/apps*::
|
||||||
This is the default location for the application settings.
|
This is the default location for the application settings.
|
||||||
|
|
||||||
RESOURCES
|
RESOURCES
|
||||||
---------
|
---------
|
||||||
*session.appsFile:* 'location'::
|
*session.appsFile:* 'location'::
|
||||||
This may be set to override the location of the application settings.
|
This may be set to override the location of the application settings.
|
||||||
|
|
||||||
EXAMPLES
|
EXAMPLES
|
||||||
--------
|
--------
|
||||||
|
|
|
||||||
|
|
@ -77,114 +77,114 @@ detailed below.
|
||||||
Structural Tags
|
Structural Tags
|
||||||
~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~
|
||||||
*[begin]* ('title');;
|
*[begin]* ('title');;
|
||||||
This tells fluxbox to start parsing the menu file. This tag is required for
|
This tells fluxbox to start parsing the menu file. This tag is required for
|
||||||
fluxbox to read your menu file. If it cannot find it, the system default menu
|
fluxbox to read your menu file. If it cannot find it, the system default menu
|
||||||
is used in its place. The 'title' appears at the top of the menu. And *[end]*
|
is used in its place. The 'title' appears at the top of the menu. And *[end]*
|
||||||
tag is required to end the menu.
|
tag is required to end the menu.
|
||||||
|
|
||||||
*[submenu]* ('label') {'title'} <'icon'>;;
|
*[submenu]* ('label') {'title'} <'icon'>;;
|
||||||
This tells fluxbox to create and parse a new menu, which is inserted as a
|
This tells fluxbox to create and parse a new menu, which is inserted as a
|
||||||
submenu into the parent menu. These menus are parsed recursively, so there is
|
submenu into the parent menu. These menus are parsed recursively, so there is
|
||||||
no limit to the number of levels or nested submenus you can have. The 'label'
|
no limit to the number of levels or nested submenus you can have. The 'label'
|
||||||
is the text that will appear in the parent menu, and the 'title' is shown at
|
is the text that will appear in the parent menu, and the 'title' is shown at
|
||||||
the top of the submenu. If omitted, the 'title' will be the same as the
|
the top of the submenu. If omitted, the 'title' will be the same as the
|
||||||
'label'. An *[end]* tag is required to end the submenu.
|
'label'. An *[end]* tag is required to end the submenu.
|
||||||
|
|
||||||
*[end]*;;
|
*[end]*;;
|
||||||
This tells fluxbox that it is at the end of a menu. This can either be a
|
This tells fluxbox that it is at the end of a menu. This can either be a
|
||||||
*[submenu]* or the *[begin]* tag of the main root menu. There must be at
|
*[submenu]* or the *[begin]* tag of the main root menu. There must be at
|
||||||
least one of these tags in your menu to correspond to the required *[begin]*
|
least one of these tags in your menu to correspond to the required *[begin]*
|
||||||
tag, and one for each *[submenu]*.
|
tag, and one for each *[submenu]*.
|
||||||
|
|
||||||
*[encoding]* {'encoding'};;
|
*[encoding]* {'encoding'};;
|
||||||
This begins an *[encoding]* section and specifies the string encoding of
|
This begins an *[encoding]* section and specifies the string encoding of
|
||||||
all strings until the matching *[endencoding]* tag. For a list of available
|
all strings until the matching *[endencoding]* tag. For a list of available
|
||||||
encodings on your system, run *iconv -l*.
|
encodings on your system, run *iconv -l*.
|
||||||
|
|
||||||
*[endencoding]*;;
|
*[endencoding]*;;
|
||||||
This ends an *[encoding]* section.
|
This ends an *[encoding]* section.
|
||||||
|
|
||||||
*[include]* ('path');;
|
*[include]* ('path');;
|
||||||
Parses the file specified by filename inline with the current menu. The
|
Parses the file specified by filename inline with the current menu. The
|
||||||
'path' can be the full path to a file or it can begin with *~/*, which will
|
'path' can be the full path to a file or it can begin with *~/*, which will
|
||||||
be expanded into your home directory. If 'path' is a directory, then all
|
be expanded into your home directory. If 'path' is a directory, then all
|
||||||
files in that directory are included.
|
files in that directory are included.
|
||||||
|
|
||||||
*[separator]*;;
|
*[separator]*;;
|
||||||
This will create a nice separation line. Useful for splitting up sections in
|
This will create a nice separation line. Useful for splitting up sections in
|
||||||
a ``pretty'' way. The optional 'comment' is not displayed, but can be useful
|
a ``pretty'' way. The optional 'comment' is not displayed, but can be useful
|
||||||
for internal documentation or script parsing of menu files.
|
for internal documentation or script parsing of menu files.
|
||||||
|
|
||||||
*[nop]* ('label') <'icon'>;;
|
*[nop]* ('label') <'icon'>;;
|
||||||
Insert a non-operational item into the current menu. This is much like
|
Insert a non-operational item into the current menu. This is much like
|
||||||
*[separator]*, but instead of a line, it inserts a 'label'. This can be used
|
*[separator]*, but instead of a line, it inserts a 'label'. This can be used
|
||||||
to help format the menu into blocks or sections if so desired. The 'label' is
|
to help format the menu into blocks or sections if so desired. The 'label' is
|
||||||
optional, and if omitted a blank item will be inserted.
|
optional, and if omitted a blank item will be inserted.
|
||||||
|
|
||||||
Applications
|
Applications
|
||||||
~~~~~~~~~~~~
|
~~~~~~~~~~~~
|
||||||
*[exec]* ('label') {'command...'} <'icon'>;;
|
*[exec]* ('label') {'command...'} <'icon'>;;
|
||||||
Inserts a command item into the menu. When you select the menu item from the
|
Inserts a command item into the menu. When you select the menu item from the
|
||||||
menu, fluxbox runs 'command...' in your *$SHELL* (or /bin/sh if $SHELL is not
|
menu, fluxbox runs 'command...' in your *$SHELL* (or /bin/sh if $SHELL is not
|
||||||
set). You can use this to launch applications, run shell scripts, etc. Since
|
set). You can use this to launch applications, run shell scripts, etc. Since
|
||||||
all arguments are passed verbatim to the shell, you can use environment
|
all arguments are passed verbatim to the shell, you can use environment
|
||||||
variables, pipes, or anything else the shell can do. Note that processes only
|
variables, pipes, or anything else the shell can do. Note that processes only
|
||||||
see environment variables that were set before fluxbox started (such as in
|
see environment variables that were set before fluxbox started (such as in
|
||||||
~/.fluxbox/startup).
|
~/.fluxbox/startup).
|
||||||
|
|
||||||
Fluxbox Functions
|
Fluxbox Functions
|
||||||
~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~
|
||||||
*[config]* ('label') <'icon'>;;
|
*[config]* ('label') <'icon'>;;
|
||||||
Inserts a fluxbox native submenu item, containing numerous configuration
|
Inserts a fluxbox native submenu item, containing numerous configuration
|
||||||
options concerning window placement, focus style, window moving style, etc.
|
options concerning window placement, focus style, window moving style, etc.
|
||||||
See *Configuration Menu* in *fluxbox(1)* for details.
|
See *Configuration Menu* in *fluxbox(1)* for details.
|
||||||
|
|
||||||
*[reconfig]* ('label') <'icon'>;;
|
*[reconfig]* ('label') <'icon'>;;
|
||||||
When selected this item re-reads the current style and menu files and applies
|
When selected this item re-reads the current style and menu files and applies
|
||||||
any changes. This is useful for creating a new style or theme, as you don't
|
any changes. This is useful for creating a new style or theme, as you don't
|
||||||
have to constantly restart fluxbox every time you save your style. However,
|
have to constantly restart fluxbox every time you save your style. However,
|
||||||
fluxbox automatically rereads the menu whenever it changes.
|
fluxbox automatically rereads the menu whenever it changes.
|
||||||
|
|
||||||
*[restart]* ('label') {'command'} <'icon'>;;
|
*[restart]* ('label') {'command'} <'icon'>;;
|
||||||
This tells fluxbox to restart. If 'command' is supplied, it shuts down and
|
This tells fluxbox to restart. If 'command' is supplied, it shuts down and
|
||||||
runs the command (which is commonly the name of another window manager). If
|
runs the command (which is commonly the name of another window manager). If
|
||||||
'command' is omitted, fluxbox restarts itself.
|
'command' is omitted, fluxbox restarts itself.
|
||||||
|
|
||||||
*[exit]* ('label') <'icon'>;;
|
*[exit]* ('label') <'icon'>;;
|
||||||
Inserts an item that shuts down and exits fluxbox. Any open windows are
|
Inserts an item that shuts down and exits fluxbox. Any open windows are
|
||||||
reparented to the root window before fluxbox exits.
|
reparented to the root window before fluxbox exits.
|
||||||
|
|
||||||
*[style]* ('label') {'filename'} <'icon'>;;
|
*[style]* ('label') {'filename'} <'icon'>;;
|
||||||
This tells fluxbox to insert an item that, when selected, reads style file
|
This tells fluxbox to insert an item that, when selected, reads style file
|
||||||
named filename and apply the new textures, colors and fonts to the current
|
named filename and apply the new textures, colors and fonts to the current
|
||||||
running session.
|
running session.
|
||||||
|
|
||||||
*[stylesmenu]* ('directory') <'icon'>;;
|
*[stylesmenu]* ('directory') <'icon'>;;
|
||||||
Reads all filenames from the specified directory, assuming that they are all
|
Reads all filenames from the specified directory, assuming that they are all
|
||||||
valid style files, and creates inline menu items in the current menu for
|
valid style files, and creates inline menu items in the current menu for
|
||||||
every filename, that, when selected by the user will apply the selected style
|
every filename, that, when selected by the user will apply the selected style
|
||||||
file to the current session. The labels that are created in the menu are the
|
file to the current session. The labels that are created in the menu are the
|
||||||
filenames of the style files.
|
filenames of the style files.
|
||||||
|
|
||||||
*[stylesdir]* ('label') {'directory'} <'icon'>;;
|
*[stylesdir]* ('label') {'directory'} <'icon'>;;
|
||||||
Creates a submenu entry with 'label' (that is also the title of the new
|
Creates a submenu entry with 'label' (that is also the title of the new
|
||||||
submenu), and inserts in that submenu all filenames in the specified
|
submenu), and inserts in that submenu all filenames in the specified
|
||||||
'directory', assuming that they are all valid style files (directories are
|
'directory', assuming that they are all valid style files (directories are
|
||||||
ignored) in the same way as the *[stylesdir]* command does. Both
|
ignored) in the same way as the *[stylesdir]* command does. Both
|
||||||
*[stylesdir]* and *[stylesmenu]* commands make it possible to install style
|
*[stylesdir]* and *[stylesmenu]* commands make it possible to install style
|
||||||
files without editing your init file.
|
files without editing your init file.
|
||||||
|
|
||||||
*[wallpapers]* ('directory') {'command'} <'icon'>;;
|
*[wallpapers]* ('directory') {'command'} <'icon'>;;
|
||||||
This inserts a menu item to set the wallpaper for each file in the given
|
This inserts a menu item to set the wallpaper for each file in the given
|
||||||
directory. The 'command' is optional, and defaults to *fbsetbg*.
|
directory. The 'command' is optional, and defaults to *fbsetbg*.
|
||||||
|
|
||||||
*[workspaces]* ('label') <'icon'>;;
|
*[workspaces]* ('label') <'icon'>;;
|
||||||
This tells fluxbox to insert a link to the workspaces menu directly into your
|
This tells fluxbox to insert a link to the workspaces menu directly into your
|
||||||
menu. See *Workspace Menu* in *fluxbox(1)* for details.
|
menu. See *Workspace Menu* in *fluxbox(1)* for details.
|
||||||
|
|
||||||
*[*'command'*]* ('label') <'icon'>;;
|
*[*'command'*]* ('label') <'icon'>;;
|
||||||
In addition to the commands above, any legal keys file 'command' may be used
|
In addition to the commands above, any legal keys file 'command' may be used
|
||||||
as a menu item. See *fluxbox-keys(5)* for more information.
|
as a menu item. See *fluxbox-keys(5)* for more information.
|
||||||
|
|
||||||
WINDOW MENU
|
WINDOW MENU
|
||||||
-----------
|
-----------
|
||||||
|
|
@ -195,79 +195,79 @@ labels, commands, or icons.
|
||||||
The available tags in this menu are:
|
The available tags in this menu are:
|
||||||
|
|
||||||
*[shade]*;;
|
*[shade]*;;
|
||||||
Provides a menu item to shade or unshade (or, roll-up) the window. This is
|
Provides a menu item to shade or unshade (or, roll-up) the window. This is
|
||||||
equivalent to the shade titlebar button.
|
equivalent to the shade titlebar button.
|
||||||
|
|
||||||
*[stick]*;;
|
*[stick]*;;
|
||||||
Provides a menu item to stick or unstick the window. Stuck windows are
|
Provides a menu item to stick or unstick the window. Stuck windows are
|
||||||
displayed on all workspaces. This is equivalent to the stick titlebar button.
|
displayed on all workspaces. This is equivalent to the stick titlebar button.
|
||||||
|
|
||||||
*[maximize]*;;
|
*[maximize]*;;
|
||||||
Provides a menu item to maximize or unmaximize the window, equivalent to the
|
Provides a menu item to maximize or unmaximize the window, equivalent to the
|
||||||
maximize titlebar button. The button with which you click alters the
|
maximize titlebar button. The button with which you click alters the
|
||||||
behaviour of this item as follows:
|
behaviour of this item as follows:
|
||||||
|
|
||||||
* Button 1 (Un)Maximize as normal.
|
* Button 1 (Un)Maximize as normal.
|
||||||
* Button 2 (Un)Maximize window vertically.
|
* Button 2 (Un)Maximize window vertically.
|
||||||
* Button 3 (Un)Maximize window horizontally.
|
* Button 3 (Un)Maximize window horizontally.
|
||||||
|
|
||||||
*[iconify]*;;
|
*[iconify]*;;
|
||||||
Provides a menu item to iconify (or, minimize) the window, equivalent to the
|
Provides a menu item to iconify (or, minimize) the window, equivalent to the
|
||||||
iconify titlebar button.
|
iconify titlebar button.
|
||||||
|
|
||||||
*[close]*;;
|
*[close]*;;
|
||||||
Closes the window gracefully, equivalent to the titlebar button.
|
Closes the window gracefully, equivalent to the titlebar button.
|
||||||
|
|
||||||
*[kill]*;;
|
*[kill]*;;
|
||||||
Kills the window's process, like *xkill(1)*.
|
Kills the window's process, like *xkill(1)*.
|
||||||
|
|
||||||
*[raise]*;;
|
*[raise]*;;
|
||||||
Raise the window to the top of the stack within its layer.
|
Raise the window to the top of the stack within its layer.
|
||||||
|
|
||||||
*[lower]*;;
|
*[lower]*;;
|
||||||
Lower the window to the bottom of the stack within its layer.
|
Lower the window to the bottom of the stack within its layer.
|
||||||
|
|
||||||
*[settitledialog]*;;
|
*[settitledialog]*;;
|
||||||
Opens a dialog which can be used to set the window's title. Some applications
|
Opens a dialog which can be used to set the window's title. Some applications
|
||||||
may re-set their own title from time-to-time, wiping out your setting.
|
may re-set their own title from time-to-time, wiping out your setting.
|
||||||
|
|
||||||
*[sendto]*;;
|
*[sendto]*;;
|
||||||
Sends the window to a different workspace. When you select the workspace with
|
Sends the window to a different workspace. When you select the workspace with
|
||||||
a middle-click, fluxbox will also change to the new workspace. A regular
|
a middle-click, fluxbox will also change to the new workspace. A regular
|
||||||
click only sends the window.
|
click only sends the window.
|
||||||
|
|
||||||
*[layer]*;;
|
*[layer]*;;
|
||||||
Adds a ``Layer...'' submenu which lets you change the layer of this window.
|
Adds a ``Layer...'' submenu which lets you change the layer of this window.
|
||||||
|
|
||||||
*[alpha]*;;
|
*[alpha]*;;
|
||||||
Adds a ``Transparency...'' submenu which lets you change the focused and
|
Adds a ``Transparency...'' submenu which lets you change the focused and
|
||||||
unfocused transparency of this window.
|
unfocused transparency of this window.
|
||||||
|
|
||||||
*[extramenus]*;;
|
*[extramenus]*;;
|
||||||
Adds the ``Remember...'' menu item, which allows you to specify which
|
Adds the ``Remember...'' menu item, which allows you to specify which
|
||||||
settings should be stored in the `apps' file (See *fluxbox-apps(5)* for more
|
settings should be stored in the `apps' file (See *fluxbox-apps(5)* for more
|
||||||
details).
|
details).
|
||||||
|
|
||||||
*[separator]*;;
|
*[separator]*;;
|
||||||
Adds a horizontal line to the menu
|
Adds a horizontal line to the menu
|
||||||
|
|
||||||
FILES
|
FILES
|
||||||
-----
|
-----
|
||||||
*~/.fluxbox/menu*::
|
*~/.fluxbox/menu*::
|
||||||
This is the default location for the user's root menu.
|
This is the default location for the user's root menu.
|
||||||
*@pkgdatadir@/menu*::
|
*@pkgdatadir@/menu*::
|
||||||
This is the system-wide root menu file. It will be used if the user's root
|
This is the system-wide root menu file. It will be used if the user's root
|
||||||
menu is missing or unparseable.
|
menu is missing or unparseable.
|
||||||
*~/.fluxbox/windowmenu*::
|
*~/.fluxbox/windowmenu*::
|
||||||
This is the user's window menu definition file
|
This is the user's window menu definition file
|
||||||
*@pkgdatadir@/menu*::
|
*@pkgdatadir@/menu*::
|
||||||
This is the default window menu. If the user does not have this file, it will
|
This is the default window menu. If the user does not have this file, it will
|
||||||
be copied to *~/.fluxbox/windowmenu* on fluxbox startup.
|
be copied to *~/.fluxbox/windowmenu* on fluxbox startup.
|
||||||
|
|
||||||
RESOURCES
|
RESOURCES
|
||||||
---------
|
---------
|
||||||
*session.menuFile:* 'location'::
|
*session.menuFile:* 'location'::
|
||||||
This may be set to override the location of the user's root menu.
|
This may be set to override the location of the user's root menu.
|
||||||
|
|
||||||
ENVIRONMENT
|
ENVIRONMENT
|
||||||
-----------
|
-----------
|
||||||
|
|
|
||||||
|
|
@ -300,19 +300,19 @@ item with the items detailed below:
|
||||||
*Configure*::
|
*Configure*::
|
||||||
The next level under this menu is where you can set certain resources and
|
The next level under this menu is where you can set certain resources and
|
||||||
really begin to customize the look and feel of your desktop. See the
|
really begin to customize the look and feel of your desktop. See the
|
||||||
*Configure Menu* section below for more details.
|
*Configure Menu* section below for more details.
|
||||||
|
|
||||||
*System Styles*::
|
*System Styles*::
|
||||||
This is where the standard styles are listed. You can select one of these by
|
This is where the standard styles are listed. You can select one of these by
|
||||||
clicking on it, and it will be applied immediately. System styles are
|
clicking on it, and it will be applied immediately. System styles are
|
||||||
located in *@pkgdatadir@/styles/* upon a default install. Remember that you
|
located in *@pkgdatadir@/styles/* upon a default install. Remember that you
|
||||||
can confirm this with fluxbox -i.
|
can confirm this with fluxbox -i.
|
||||||
|
|
||||||
*User Styles*:::
|
*User Styles*:::
|
||||||
This is where your custom styles are listed. It will list any styles from
|
This is where your custom styles are listed. It will list any styles from
|
||||||
*~/.fluxbox/styles/*, which may be styles you grab from the Internet, or
|
*~/.fluxbox/styles/*, which may be styles you grab from the Internet, or
|
||||||
your own custom styles, provided you follow the standards described in
|
your own custom styles, provided you follow the standards described in
|
||||||
*fluxbox-style(5)*.
|
*fluxbox-style(5)*.
|
||||||
|
|
||||||
*Workspace List*:::
|
*Workspace List*:::
|
||||||
This is the same as the *Workspace Menu* detailed below.
|
This is the same as the *Workspace Menu* detailed below.
|
||||||
|
|
@ -330,21 +330,21 @@ item with the items detailed below:
|
||||||
|
|
||||||
*Fluxbox Command*:::
|
*Fluxbox Command*:::
|
||||||
A little Commandline will popup where you can enter a fluxbox command. These
|
A little Commandline will popup where you can enter a fluxbox command. These
|
||||||
commands are the same as those detailed in *fluxbox-keys(5)*.
|
commands are the same as those detailed in *fluxbox-keys(5)*.
|
||||||
|
|
||||||
*Reload config*:::
|
*Reload config*:::
|
||||||
Use this to reload the fluxbox configuration files. You must do this after
|
Use this to reload the fluxbox configuration files. You must do this after
|
||||||
editing the `keys' file, `init' file, or the current style.
|
editing the `keys' file, `init' file, or the current style.
|
||||||
|
|
||||||
*Restart*:::
|
*Restart*:::
|
||||||
Restart the whole darn thing. This starts a completely new fluxbox process,
|
Restart the whole darn thing. This starts a completely new fluxbox process,
|
||||||
rereads files and redraws all graphical elements. Running applications will
|
rereads files and redraws all graphical elements. Running applications will
|
||||||
remain open, however, and restored to the same workspaces they were
|
remain open, however, and restored to the same workspaces they were
|
||||||
previously in once fluxbox returns.
|
previously in once fluxbox returns.
|
||||||
|
|
||||||
*Exit*:::
|
*Exit*:::
|
||||||
Exits fluxbox, which in turn either shuts down the X Window server or
|
Exits fluxbox, which in turn either shuts down the X Window server or
|
||||||
returns you to the graphical login screen.
|
returns you to the graphical login screen.
|
||||||
|
|
||||||
Configuration Menu
|
Configuration Menu
|
||||||
~~~~~~~~~~~~~~~~~~
|
~~~~~~~~~~~~~~~~~~
|
||||||
|
|
@ -355,25 +355,25 @@ faster way to change the most common settings.
|
||||||
All changes take effect immediately.
|
All changes take effect immediately.
|
||||||
|
|
||||||
*Focus Model*:::
|
*Focus Model*:::
|
||||||
Lets you configure the window focus model. For details, see *FOCUS MODEL*,
|
Lets you configure the window focus model. For details, see *FOCUS MODEL*,
|
||||||
below.
|
below.
|
||||||
|
|
||||||
*Maximize Options*:::
|
*Maximize Options*:::
|
||||||
Lets you configure what happens when you maximize a window. The four
|
Lets you configure what happens when you maximize a window. The four
|
||||||
options are:
|
options are:
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
*Full Maximization*:;;
|
*Full Maximization*:;;
|
||||||
Normally, a maximized window will not overlap the toolbar, slit, or any
|
Normally, a maximized window will not overlap the toolbar, slit, or any
|
||||||
docked windows (like panels). Enabling this option allows maximized
|
docked windows (like panels). Enabling this option allows maximized
|
||||||
windows to be as large as the actual screen resolution.
|
windows to be as large as the actual screen resolution.
|
||||||
*Ignore Resize Increment*:;;
|
*Ignore Resize Increment*:;;
|
||||||
Normally, terminal windows specify a ``resize increment'' which mean
|
Normally, terminal windows specify a ``resize increment'' which mean
|
||||||
fluxbox will only resize the window to an even multiple of the character
|
fluxbox will only resize the window to an even multiple of the character
|
||||||
size. Enabling this option will ignore this specification when maximizing.
|
size. Enabling this option will ignore this specification when maximizing.
|
||||||
*Disable Moving* / *Disable Resizing*:;;
|
*Disable Moving* / *Disable Resizing*:;;
|
||||||
Normally, maximized windows can still be moved and resized. Enabling these
|
Normally, maximized windows can still be moved and resized. Enabling these
|
||||||
options prevents these behaviour.
|
options prevents these behaviour.
|
||||||
--
|
--
|
||||||
|
|
||||||
*Tab Options*:::
|
*Tab Options*:::
|
||||||
|
|
@ -386,8 +386,8 @@ options are:
|
||||||
|
|
||||||
*Toolbar*:::
|
*Toolbar*:::
|
||||||
This menu can also be found by right-clicking any non-icon part of the
|
This menu can also be found by right-clicking any non-icon part of the
|
||||||
toolbar. Find more information about this menu's options in the *Toolbar
|
toolbar. Find more information about this menu's options in the *Toolbar
|
||||||
Menu* section, below.
|
Menu* section, below.
|
||||||
|
|
||||||
*Transparency*:::
|
*Transparency*:::
|
||||||
This sets the default transparency for a focused windows, unfocused window and
|
This sets the default transparency for a focused windows, unfocused window and
|
||||||
|
|
@ -408,7 +408,7 @@ titlebars, not window contents.
|
||||||
|
|
||||||
*Workspace Warping*:::
|
*Workspace Warping*:::
|
||||||
If enabled, you can drag windows from one workspace to another. The previous
|
If enabled, you can drag windows from one workspace to another. The previous
|
||||||
workspace is to the left, the next workspace is to the right.
|
workspace is to the left, the next workspace is to the right.
|
||||||
|
|
||||||
Window Menu
|
Window Menu
|
||||||
~~~~~~~~~~~
|
~~~~~~~~~~~
|
||||||
|
|
@ -440,9 +440,9 @@ By default, this menu contains:
|
||||||
* Button 3 (Un)Maximize window horizontally.
|
* Button 3 (Un)Maximize window horizontally.
|
||||||
|
|
||||||
*Iconify*:::
|
*Iconify*:::
|
||||||
Iconify (or minimize) a window. The `icon' can be found in the Icons submenu
|
Iconify (or minimize) a window. The `icon' can be found in the Icons submenu
|
||||||
of the workspace menu as well as in the toolbar (if a Toolbar mode showing
|
of the workspace menu as well as in the toolbar (if a Toolbar mode showing
|
||||||
Icons is selected).
|
Icons is selected).
|
||||||
|
|
||||||
*Raise*:::
|
*Raise*:::
|
||||||
Raise the window above all others in the same layer.
|
Raise the window above all others in the same layer.
|
||||||
|
|
@ -455,7 +455,7 @@ By default, this menu contains:
|
||||||
|
|
||||||
*Transparency*:::
|
*Transparency*:::
|
||||||
Change this window's transparency, overriding the defaults from the
|
Change this window's transparency, overriding the defaults from the
|
||||||
*Configuration Menu*.
|
*Configuration Menu*.
|
||||||
|
|
||||||
*Remember...*:::
|
*Remember...*:::
|
||||||
Specify which window settings should be stored in the `apps' file and
|
Specify which window settings should be stored in the `apps' file and
|
||||||
|
|
@ -465,36 +465,36 @@ Specifically the setting you may store are:
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
*Workpace:*;;
|
*Workpace:*;;
|
||||||
Open this in the same workspace as where the window currently resides.
|
Open this in the same workspace as where the window currently resides.
|
||||||
*Jump to workspace:*;;
|
*Jump to workspace:*;;
|
||||||
When *Workspace* is selected, fluxbox will jump to the appropriate workspace
|
When *Workspace* is selected, fluxbox will jump to the appropriate workspace
|
||||||
when this window is opened there. If not selected, the window will open in
|
when this window is opened there. If not selected, the window will open in
|
||||||
the background.
|
the background.
|
||||||
*Head*:;;
|
*Head*:;;
|
||||||
For xinerama users only, start this window on the current head (or screen).
|
For xinerama users only, start this window on the current head (or screen).
|
||||||
*Dimensions*:;;
|
*Dimensions*:;;
|
||||||
Record the current window height and width.
|
Record the current window height and width.
|
||||||
*Position*:;;
|
*Position*:;;
|
||||||
Record the current X and Y coordinates of the window.
|
Record the current X and Y coordinates of the window.
|
||||||
*Sticky*:;;
|
*Sticky*:;;
|
||||||
Record whether the window is on all desktops, or not.
|
Record whether the window is on all desktops, or not.
|
||||||
*Decorations*:;;
|
*Decorations*:;;
|
||||||
Record the current set of decorations (title bar, grips, tabs, etc) on the window.
|
Record the current set of decorations (title bar, grips, tabs, etc) on the window.
|
||||||
*Shaded*:;;
|
*Shaded*:;;
|
||||||
Record whether the window is shaded (or rolled-up) or not.
|
Record whether the window is shaded (or rolled-up) or not.
|
||||||
*Minimized*:;;
|
*Minimized*:;;
|
||||||
Record whether the window is iconified (or minimized) or not.
|
Record whether the window is iconified (or minimized) or not.
|
||||||
*Maximized*:;;
|
*Maximized*:;;
|
||||||
Record whether the window is maximized or not.
|
Record whether the window is maximized or not.
|
||||||
*Fullscreen*:;;
|
*Fullscreen*:;;
|
||||||
Record whether the window is in fullscreen mode or not.
|
Record whether the window is in fullscreen mode or not.
|
||||||
*Transparency*:;;
|
*Transparency*:;;
|
||||||
Record the current *Transparency* settings.
|
Record the current *Transparency* settings.
|
||||||
*Layer*:;;
|
*Layer*:;;
|
||||||
Record the current layer.
|
Record the current layer.
|
||||||
*Save on close*:;;
|
*Save on close*:;;
|
||||||
If selected, any of the above items which are also selected will be updated
|
If selected, any of the above items which are also selected will be updated
|
||||||
with the window's current values as it is closed.
|
with the window's current values as it is closed.
|
||||||
|
|
||||||
--
|
--
|
||||||
+
|
+
|
||||||
|
|
@ -513,24 +513,24 @@ background. This menu contains entries to explore the currently defined
|
||||||
workspaces, windows, and add/remove/rename workspaces.
|
workspaces, windows, and add/remove/rename workspaces.
|
||||||
|
|
||||||
*Icons*:::
|
*Icons*:::
|
||||||
This menu shows any iconified (or, minimized) windows. Clicking on a window
|
This menu shows any iconified (or, minimized) windows. Clicking on a window
|
||||||
in this menu will raise it on the current workspace.
|
in this menu will raise it on the current workspace.
|
||||||
|
|
||||||
'Workspaces':::
|
'Workspaces':::
|
||||||
The next section provides one submenu per workspace. Middle-clicking on a
|
The next section provides one submenu per workspace. Middle-clicking on a
|
||||||
workspace name will take you to that workspace. The submenu contains a list
|
workspace name will take you to that workspace. The submenu contains a list
|
||||||
of all open windows on that workspace. Clicking on a window name will take
|
of all open windows on that workspace. Clicking on a window name will take
|
||||||
you to that window and raise it, changing the active workspace if necessary.
|
you to that window and raise it, changing the active workspace if necessary.
|
||||||
|
|
||||||
*New Workspace*:::
|
*New Workspace*:::
|
||||||
This entry adds a new workspace to the end of the list of current workspaces.
|
This entry adds a new workspace to the end of the list of current workspaces.
|
||||||
|
|
||||||
*Edit current workspace name*:::
|
*Edit current workspace name*:::
|
||||||
Pops up a dialog to enter a new name for the current workspace.
|
Pops up a dialog to enter a new name for the current workspace.
|
||||||
|
|
||||||
*Remove Last*:::
|
*Remove Last*:::
|
||||||
Remove the last workspace in the list. Any windows currently open there will
|
Remove the last workspace in the list. Any windows currently open there will
|
||||||
be sent to the next-to-last workspace.
|
be sent to the next-to-last workspace.
|
||||||
|
|
||||||
TOOLBAR
|
TOOLBAR
|
||||||
-------
|
-------
|
||||||
|
|
@ -596,18 +596,18 @@ All changes take effect immediately. Here are the settings:
|
||||||
If this is enabled the toolbar will disappear after a defined time when the
|
If this is enabled the toolbar will disappear after a defined time when the
|
||||||
mouse pointer leaves the toolbar. It will slide in when the cursor hits the
|
mouse pointer leaves the toolbar. It will slide in when the cursor hits the
|
||||||
remaining edge of the toolbar. See the *session.autoRaiseDelay* resource for
|
remaining edge of the toolbar. See the *session.autoRaiseDelay* resource for
|
||||||
the delay time.
|
the delay time.
|
||||||
|
|
||||||
*Toolbar width percentage*:::
|
*Toolbar width percentage*:::
|
||||||
Sets the width of the toolbar in a percentage of your total screen size. Use
|
Sets the width of the toolbar in a percentage of your total screen size. Use
|
||||||
the left mouse button to decrease and the right mouse-button to increase the
|
the left mouse button to decrease and the right mouse-button to increase the
|
||||||
value. The value can be from 1-100.
|
value. The value can be from 1-100.
|
||||||
|
|
||||||
*Maximize Over*:::
|
*Maximize Over*:::
|
||||||
Enabling this option will allow windows to maximize over the toolbar. With
|
Enabling this option will allow windows to maximize over the toolbar. With
|
||||||
this switched on they will only expand to the edge of the bar. This option
|
this switched on they will only expand to the edge of the bar. This option
|
||||||
may be overridden by the ``Full Maximization'' from the *Configuration
|
may be overridden by the ``Full Maximization'' from the *Configuration
|
||||||
Menu*. If that option is enabled, this option will have no effect..
|
Menu*. If that option is enabled, this option will have no effect..
|
||||||
|
|
||||||
*Layer...*:::
|
*Layer...*:::
|
||||||
This sets the layer on which the toolbar is set. With this you can set the
|
This sets the layer on which the toolbar is set. With this you can set the
|
||||||
|
|
@ -629,19 +629,19 @@ The first section outlines what types of windows will be shown in the iconbar:
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
*None*:;;
|
*None*:;;
|
||||||
Will not show any windows
|
Will not show any windows
|
||||||
*Icons*:;;
|
*Icons*:;;
|
||||||
Shows windows from all workspaces that are iconified (or, minimized)
|
Shows windows from all workspaces that are iconified (or, minimized)
|
||||||
*NoIcons*:;;
|
*NoIcons*:;;
|
||||||
Shows windows from all workspaces that are not iconified
|
Shows windows from all workspaces that are not iconified
|
||||||
*WorkspaceIcons*:;;
|
*WorkspaceIcons*:;;
|
||||||
Shows windows from the current workspace that are iconified
|
Shows windows from the current workspace that are iconified
|
||||||
*WorkspaceNoIcons*:;;
|
*WorkspaceNoIcons*:;;
|
||||||
Shows windows from the current workspace that are not iconified
|
Shows windows from the current workspace that are not iconified
|
||||||
*Workspace*:;;
|
*Workspace*:;;
|
||||||
Shows all windows (iconified or not) from the current workspace
|
Shows all windows (iconified or not) from the current workspace
|
||||||
*All Windows*:;;
|
*All Windows*:;;
|
||||||
Shows all windows (iconified or not) from all workspaces
|
Shows all windows (iconified or not) from all workspaces
|
||||||
|
|
||||||
--
|
--
|
||||||
+
|
+
|
||||||
|
|
@ -651,11 +651,11 @@ resource:
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
*Left*:;;
|
*Left*:;;
|
||||||
All icons will be left-aligned with the width set in the `init' file
|
All icons will be left-aligned with the width set in the `init' file
|
||||||
*Relative*:;;
|
*Relative*:;;
|
||||||
All icons will be sized evenly to fill the iconbar completely
|
All icons will be sized evenly to fill the iconbar completely
|
||||||
*Right*:;;
|
*Right*:;;
|
||||||
All icons will be right-aligned with the width set in the `init' file
|
All icons will be right-aligned with the width set in the `init' file
|
||||||
|
|
||||||
--
|
--
|
||||||
+
|
+
|
||||||
|
|
@ -699,16 +699,16 @@ one of the first two and one of the last two. They are:
|
||||||
There are three more settings in the ``Focus Model'' menu:
|
There are three more settings in the ``Focus Model'' menu:
|
||||||
|
|
||||||
*Focus New Windows*:::
|
*Focus New Windows*:::
|
||||||
If enabled, a new window will grab X focus as soon as it is opened.
|
If enabled, a new window will grab X focus as soon as it is opened.
|
||||||
|
|
||||||
*Auto Raise*::
|
*Auto Raise*::
|
||||||
If enabled, focusing on a new window will automatically raise that window
|
If enabled, focusing on a new window will automatically raise that window
|
||||||
above all others within its layer. When disabled, you must explicitly raise a
|
above all others within its layer. When disabled, you must explicitly raise a
|
||||||
focused window using the window menu, keybinding, or *Click Raises*.
|
focused window using the window menu, keybinding, or *Click Raises*.
|
||||||
|
|
||||||
*Click Raises*::
|
*Click Raises*::
|
||||||
If enabled, clicking anywhere on a window will raise it above all others
|
If enabled, clicking anywhere on a window will raise it above all others
|
||||||
within its layer.
|
within its layer.
|
||||||
|
|
||||||
TAB OPTIONS
|
TAB OPTIONS
|
||||||
-----------
|
-----------
|
||||||
|
|
@ -726,7 +726,7 @@ tabs. Inside of it there are three main options:
|
||||||
*Maximize Over*:::
|
*Maximize Over*:::
|
||||||
When this option is on, maximizing a window will disregard the size and
|
When this option is on, maximizing a window will disregard the size and
|
||||||
location of external tabs, which means they may be pushed out of the screen
|
location of external tabs, which means they may be pushed out of the screen
|
||||||
entirely.
|
entirely.
|
||||||
|
|
||||||
*External Tab Width*:::
|
*External Tab Width*:::
|
||||||
This specifies in pixels the width of external tabs.
|
This specifies in pixels the width of external tabs.
|
||||||
|
|
@ -786,14 +786,14 @@ All changes take effect immediately. Here are the settings:
|
||||||
If this is enabled the slit will disappear after a defined time when the
|
If this is enabled the slit will disappear after a defined time when the
|
||||||
mouse pointer leaves the slit. It will slide in when the cursor hits the
|
mouse pointer leaves the slit. It will slide in when the cursor hits the
|
||||||
remaining edge of the slit. See the *session.autoRaiseDelay* resource for
|
remaining edge of the slit. See the *session.autoRaiseDelay* resource for
|
||||||
the delay time.
|
the delay time.
|
||||||
|
|
||||||
*Maximize Over*:::
|
*Maximize Over*:::
|
||||||
Enabling this option will allow windows to maximizing over the slit. With
|
Enabling this option will allow windows to maximizing over the slit. With
|
||||||
this switched off they will only expand to the edge of the slit. This
|
this switched off they will only expand to the edge of the slit. This
|
||||||
option may be overridden by the ``Full Maximization'' from the
|
option may be overridden by the ``Full Maximization'' from the
|
||||||
*Configuration Menu*. If that option is enabled, this option will have no
|
*Configuration Menu*. If that option is enabled, this option will have no
|
||||||
effect..
|
effect..
|
||||||
|
|
||||||
*Alpha*:::
|
*Alpha*:::
|
||||||
This sets the alpha value for the slit. Use the left mouse button to
|
This sets the alpha value for the slit. Use the left mouse button to
|
||||||
|
|
@ -802,11 +802,11 @@ All changes take effect immediately. Here are the settings:
|
||||||
|
|
||||||
*Clients*:::
|
*Clients*:::
|
||||||
This submenu lets you reorder the the applications running in the
|
This submenu lets you reorder the the applications running in the
|
||||||
slit. You are able to hide apps from the slit by unselecting them in the
|
slit. You are able to hide apps from the slit by unselecting them in the
|
||||||
list showing. This will not kill the app. You can make them re-appear by
|
list showing. This will not kill the app. You can make them re-appear by
|
||||||
selecting them in the list. The "Save SlitList" option saves the new order
|
selecting them in the list. The "Save SlitList" option saves the new order
|
||||||
to you slitlist located in *~/.fluxbox/slitlist*. See the next section for
|
to you slitlist located in *~/.fluxbox/slitlist*. See the next section for
|
||||||
details.
|
details.
|
||||||
|
|
||||||
Slitlist File
|
Slitlist File
|
||||||
~~~~~~~~~~~~~
|
~~~~~~~~~~~~~
|
||||||
|
|
@ -889,8 +889,8 @@ These allow users to place the slit and toolbar where they like.
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
Possible options are:;;
|
Possible options are:;;
|
||||||
*BottomLeft* *BottomCenter* *BottomRight* *LeftBottom* *LeftCenter* *LeftTop*
|
*BottomLeft BottomCenter BottomRight LeftBottom LeftCenter LeftTop
|
||||||
*RightBottom* *RightCenter* *RightTop* *TopLeft* *TopCenter* *TopRight*
|
RightBottom RightCenter RightTop TopLeft TopCenter TopRight*
|
||||||
--
|
--
|
||||||
+
|
+
|
||||||
Slit default: *RightBottom*
|
Slit default: *RightBottom*
|
||||||
|
|
@ -930,8 +930,8 @@ They may be specified in any order, delimited by the *,* character.
|
||||||
They will appear in the order given.
|
They will appear in the order given.
|
||||||
+
|
+
|
||||||
Possible tools:;;
|
Possible tools:;;
|
||||||
*clock* *iconbar* *nextwindow* *prevwindow* *nextworkspace* *prevworkspace*
|
*clock iconbar nextwindow prevwindow nextworkspace prevworkspace
|
||||||
*systemtray* *workspacename*
|
systemtray workspacename*
|
||||||
+
|
+
|
||||||
Default:;;
|
Default:;;
|
||||||
*workspacename, prevworkspace, nextworkspace, iconbar, prevwindow, nextwindow,
|
*workspacename, prevworkspace, nextworkspace, iconbar, prevwindow, nextwindow,
|
||||||
|
|
@ -1178,7 +1178,7 @@ may specify any number, space-delimited.
|
||||||
+
|
+
|
||||||
--
|
--
|
||||||
The available options are:;;
|
The available options are:;;
|
||||||
*Close* *Maximize* *MenuIcon* *Minimize* *Shade* *Stick* *LHalf* *RHalf*
|
*Close Maximize MenuIcon Minimize Shade Stick LHalf RHalf*
|
||||||
--
|
--
|
||||||
+
|
+
|
||||||
Default left: *Stick*
|
Default left: *Stick*
|
||||||
|
|
@ -1194,33 +1194,33 @@ files. This is where you can specify different files. Most of the defaults will
|
||||||
be located in the user's *~/.fluxbox* directory.
|
be located in the user's *~/.fluxbox* directory.
|
||||||
|
|
||||||
*session.appsFile*: 'location'::
|
*session.appsFile*: 'location'::
|
||||||
Location of persistent application settings, or the `apps' file. See the
|
Location of persistent application settings, or the `apps' file. See the
|
||||||
*Remember...* item in the *Window Menu* section above or *fluxbox-apps(5)*
|
*Remember...* item in the *Window Menu* section above or *fluxbox-apps(5)*
|
||||||
for details.
|
for details.
|
||||||
|
|
||||||
*session.groupFile*: 'location'::
|
*session.groupFile*: 'location'::
|
||||||
Deprecated, auto-grouping is now done in the `apps' file, see
|
Deprecated, auto-grouping is now done in the `apps' file, see
|
||||||
*fluxbox-apps(5)* for details.
|
*fluxbox-apps(5)* for details.
|
||||||
|
|
||||||
*session.keyFile*: 'location'::
|
*session.keyFile*: 'location'::
|
||||||
Location of the keyboard mapping settings, or the `keys' file.
|
Location of the keyboard mapping settings, or the `keys' file.
|
||||||
See *fluxbox-keys(5)* for details.
|
See *fluxbox-keys(5)* for details.
|
||||||
|
|
||||||
*session.menuFile*: 'location'::
|
*session.menuFile*: 'location'::
|
||||||
Location of the Root Menu file.
|
Location of the Root Menu file.
|
||||||
See *fluxbox-menu(5)* for details.
|
See *fluxbox-menu(5)* for details.
|
||||||
|
|
||||||
*session.slitlistFile*: 'location'::
|
*session.slitlistFile*: 'location'::
|
||||||
Location of the file used to remember slit client ordering.
|
Location of the file used to remember slit client ordering.
|
||||||
See *SLIT* above for details.
|
See *SLIT* above for details.
|
||||||
|
|
||||||
*session.styleFile*: 'location'::
|
*session.styleFile*: 'location'::
|
||||||
Location of the currently selected style.
|
Location of the currently selected style.
|
||||||
See *fluxbox-style(5)* for details.
|
See *fluxbox-style(5)* for details.
|
||||||
|
|
||||||
*session.styleOverlay*: 'location'::
|
*session.styleOverlay*: 'location'::
|
||||||
Location of the style overlay file.
|
Location of the style overlay file.
|
||||||
See *fluxbox-style(5)* for details.
|
See *fluxbox-style(5)* for details.
|
||||||
|
|
||||||
*session.screen0.windowMenu*: 'location'::
|
*session.screen0.windowMenu*: 'location'::
|
||||||
This optionally specifies the location of a user-defined window menu. If left
|
This optionally specifies the location of a user-defined window menu. If left
|
||||||
|
|
|
||||||
|
|
@ -4,7 +4,7 @@ Jim Ramsay <i.am@jimramsay.com>
|
||||||
v1.3.5, 13 February 2013
|
v1.3.5, 13 February 2013
|
||||||
:man source: startfluxbox.txt
|
:man source: startfluxbox.txt
|
||||||
:man version: {revision}
|
:man version: {revision}
|
||||||
:man manual: Fluxbox Manual
|
:man manual: Fluxbox Manual
|
||||||
|
|
||||||
NAME
|
NAME
|
||||||
----
|
----
|
||||||
|
|
@ -25,9 +25,9 @@ doesn't exist it will be generated.
|
||||||
FILES
|
FILES
|
||||||
-----
|
-----
|
||||||
*~/.fluxbox/startup*::
|
*~/.fluxbox/startup*::
|
||||||
This file contains all commands that should be executed before fluxbox is
|
This file contains all commands that should be executed before fluxbox is
|
||||||
started. The initial file contains helpful comments for beginners. It also
|
started. The initial file contains helpful comments for beginners. It also
|
||||||
starts fluxbox.
|
starts fluxbox.
|
||||||
|
|
||||||
EXAMPLES
|
EXAMPLES
|
||||||
--------
|
--------
|
||||||
|
|
@ -63,14 +63,14 @@ fluxbox* line above to something like this:
|
||||||
....
|
....
|
||||||
exec fluxbox &
|
exec fluxbox &
|
||||||
fbpid=$!
|
fbpid=$!
|
||||||
|
|
||||||
sleep 1
|
sleep 1
|
||||||
{
|
{
|
||||||
xsetroot -cursor_name left_ptr -fg white -bg black &
|
xsetroot -cursor_name left_ptr -fg white -bg black &
|
||||||
ipager &
|
ipager &
|
||||||
gkrellm2 &
|
gkrellm2 &
|
||||||
} &
|
} &
|
||||||
|
|
||||||
wait $fbpid
|
wait $fbpid
|
||||||
....
|
....
|
||||||
So xsetroot, ipager, and gkrellm2 will all be started after fluxbox, after
|
So xsetroot, ipager, and gkrellm2 will all be started after fluxbox, after
|
||||||
|
|
|
||||||
|
|
@ -94,11 +94,6 @@ Background color\&. The default is
|
||||||
Text font name
|
Text font name
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
\fB\-na\fR
|
|
||||||
.RS 4
|
|
||||||
Disable font antialias
|
|
||||||
.RE
|
|
||||||
.PP
|
|
||||||
\fB\-hf\fR \fIfilename\fR
|
\fB\-hf\fR \fIfilename\fR
|
||||||
.RS 4
|
.RS 4
|
||||||
History file to load\&. The default is
|
History file to load\&. The default is
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
'\" t
|
'\" t
|
||||||
.\" Title: fluxbox-menu
|
.\" Title: fluxbox-menu
|
||||||
.\" Author: Jim Ramsay <i.am@jimramsay.com>
|
.\" Author: Jim Ramsay <i.am@jimramsay.com>
|
||||||
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
|
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||||
.\" Date: 13 February 2013
|
.\" Date: 13 February 2013
|
||||||
.\" Manual: Fluxbox Manual
|
.\" Manual: Fluxbox Manual
|
||||||
.\" Source: fluxbox-menu.txt
|
.\" Source: fluxbox-menu.txt
|
||||||
|
|
|
||||||
|
|
@ -1454,7 +1454,7 @@ These allow users to place the slit and toolbar where they like\&.
|
||||||
.PP
|
.PP
|
||||||
Possible options are:
|
Possible options are:
|
||||||
.RS 4
|
.RS 4
|
||||||
\fBBottomLeft\fR\fBBottomCenter\fR\fBBottomRight\fR\fBLeftBottom\fR\fBLeftCenter\fR\fBLeftTop\fR\fBRightBottom\fR\fBRightCenter\fR\fBRightTop\fR\fBTopLeft\fR\fBTopCenter\fR\fBTopRight\fR
|
\fBBottomLeft BottomCenter BottomRight LeftBottom LeftCenter LeftTop RightBottom RightCenter RightTop TopLeft TopCenter TopRight\fR
|
||||||
.RE
|
.RE
|
||||||
.sp
|
.sp
|
||||||
Slit default:
|
Slit default:
|
||||||
|
|
@ -1504,7 +1504,7 @@ character\&. They will appear in the order given\&.
|
||||||
.PP
|
.PP
|
||||||
Possible tools:
|
Possible tools:
|
||||||
.RS 4
|
.RS 4
|
||||||
\fBclock\fR\fBiconbar\fR\fBnextwindow\fR\fBprevwindow\fR\fBnextworkspace\fR\fBprevworkspace\fR\fBsystemtray\fR\fBworkspacename\fR
|
\fBclock iconbar nextwindow prevwindow nextworkspace prevworkspace systemtray workspacename\fR
|
||||||
.RE
|
.RE
|
||||||
.PP
|
.PP
|
||||||
Default:
|
Default:
|
||||||
|
|
@ -1899,7 +1899,7 @@ The buttons or icons to place in the titlebar of decorated windows\&. You may sp
|
||||||
.PP
|
.PP
|
||||||
The available options are:
|
The available options are:
|
||||||
.RS 4
|
.RS 4
|
||||||
\fBClose\fR\fBMaximize\fR\fBMenuIcon\fR\fBMinimize\fR\fBShade\fR\fBStick\fR\fBLHalf\fR\fBRHalf\fR
|
\fBClose Maximize MenuIcon Minimize Shade Stick LHalf RHalf\fR
|
||||||
.RE
|
.RE
|
||||||
.sp
|
.sp
|
||||||
Default left:
|
Default left:
|
||||||
|
|
|
||||||
|
|
@ -1,7 +1,7 @@
|
||||||
'\" t
|
'\" t
|
||||||
.\" Title: startfluxbox
|
.\" Title: startfluxbox
|
||||||
.\" Author: Jim Ramsay <i.am@jimramsay.com>
|
.\" Author: Jim Ramsay <i.am@jimramsay.com>
|
||||||
.\" Generator: DocBook XSL Stylesheets v1.76.1 <http://docbook.sf.net/>
|
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
|
||||||
.\" Date: 13 February 2013
|
.\" Date: 13 February 2013
|
||||||
.\" Manual: Fluxbox Manual
|
.\" Manual: Fluxbox Manual
|
||||||
.\" Source: startfluxbox.txt
|
.\" Source: startfluxbox.txt
|
||||||
|
|
@ -90,9 +90,9 @@ fbpid=$!
|
||||||
|
|
||||||
sleep 1
|
sleep 1
|
||||||
{
|
{
|
||||||
xsetroot \-cursor_name left_ptr \-fg white \-bg black &
|
xsetroot \-cursor_name left_ptr \-fg white \-bg black &
|
||||||
ipager &
|
ipager &
|
||||||
gkrellm2 &
|
gkrellm2 &
|
||||||
} &
|
} &
|
||||||
|
|
||||||
wait $fbpid
|
wait $fbpid
|
||||||
|
|
|
||||||
Loading…
Reference in a new issue