nilix/fluxbox
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Small edits for consistency

Browse source
This commit is contained in:
Jim Ramsay 2009-02-19 09:29:05 -05:00
parent 54ee631cd8
commit f68ff84bd1
20 changed files with 274 additions and 283 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

16
doc/asciidoc/fbrun.txt
View file

@ -1,6 +1,6 @@
fbrun(1) fbrun(1)
========== ========
Bastian Kleineidam <calvin@debian.org> Jim Ramsay <i.am@jimramsay.com>
v1.1.2, 18 February 2009 v1.1.2, 18 February 2009
:man source: fbrun.txt :man source: fbrun.txt
:man version: {revision} :man version: {revision}
@ -80,14 +80,12 @@ fbrun -fg black -bg white -text xterm -title "run xterm"
AUTHORS AUTHORS
------- -------
- This manpage was originally written by Bastian Kleineidam <calvin at This manpage was originally written by Bastian Kleineidam <calvin at
debian.org> for the Debian distribution of fluxbox (but may be used by debian.org> for the Debian distribution of fluxbox (but may be used by
others). others).
- It was then converted to asciidoc format by Jim Ramsay <i.am at jimramsay.com> It was then converted to asciidoc format by Jim Ramsay <i.am at jimramsay.com>
for fluxbox-1.1.2 for fluxbox-1.1.2
- The main author of fluxbox is Henrik Kinnunen <fluxgen at fluxbox.org>.
SEE ALSO SEE ALSO
-------- --------

16
doc/asciidoc/fbsetbg.txt
View file

@ -51,7 +51,8 @@ doesn't support this option fbsetbg falls back to *-f*).
Use specified wallpapersetter, use no argument to forget. Use specified wallpapersetter, use no argument to forget.
*-b* 'fbsetrootoptions':: *-b* 'fbsetrootoptions'::
Forward the options to fbsetroot. Forward the options to *fbsetroot(1)*. These can be used to set a solid,
pattern, or gradient background texture.
*-r* 'directory':: *-r* 'directory'::
Set random wallpaper from a directory. Set random wallpaper from a directory.
@ -97,10 +98,6 @@ Recall the last set wallpaper on display *:0.0* with the stored options.
$ DISPLAY=:0.0 fbsetbg -l $ DISPLAY=:0.0 fbsetbg -l
SEE ALSO
--------
fluxbox(1), fbsetroot(1)
ONLINE DOCUMENTATION ONLINE DOCUMENTATION
-------------------- --------------------
Much more extensive documentation for *fbsetbg(1)* is provided on::: Much more extensive documentation for *fbsetbg(1)* is provided on:::
@ -112,6 +109,11 @@ BUGS
AUTHORS AUTHORS
------- -------
The author of fbsetbg is Han Boetes <han@fluxbox.org> The author of fbsetbg is Han Boetes <han at fluxbox.org>
This manpage was updated to asciidoc format by Jim Ramsay <i.am@jimramsay.com> This manpage was converted to asciidoc format by Jim Ramsay <i.am at
jimramsay.com> for fluxbox-1.1.2
SEE ALSO
--------
fluxbox(1) fbsetroot(1)

11
doc/asciidoc/fbsetroot.txt
View file

@ -33,6 +33,9 @@ fluxbox does. It doesn't handle cursors etc. fbsetroot was originally part of
the Blackbox package and was carried over with the code that became Fluxbox. It the Blackbox package and was carried over with the code that became Fluxbox. It
was called bsetroot back in those days. was called bsetroot back in those days.
If any errors are encountered, fbsetroot will use either *gxmessage(1)* or
*xmessage(1)* to inform the user of errors.
OPTIONS OPTIONS
------- -------
fbsetroot operates in three ways, you must choose one of the first 3 fbsetroot operates in three ways, you must choose one of the first 3
@ -74,14 +77,12 @@ Prints version info and short help text.
AUTHORS AUTHORS
------- -------
fbsetroot is written and maintained by the Fluxbox Development Team This manpage was modified by Curt "Asenchi" Micol <asenchi at asenchi.com>
This manpage was modified by Curt "Asenchi" Micol <asenchi@asenchi.com>
for the Fluxbox window manager. for the Fluxbox window manager.
Further updates for fluxbox-1.1.2 and conversion to asciidoc format by Jim Further updates for fluxbox-1.1.2 and conversion to asciidoc format by Jim
Ramsay <i.am@jimramsay.com> Ramsay <i.am at jimramsay.com>
SEE ALSO SEE ALSO
-------- --------
fluxbox(1) fbsetbg(1) fluxbox(1) fbsetbg(1) xsetroot(1) xmessage(1) gxmessage(1)

13
doc/asciidoc/fluxbox-apps.txt
View file

@ -1,7 +1,7 @@
fluxbox-apps(5) fluxbox-apps(5)
=============== ===============
Jim Ramsay <i.am@jimramsay.com> Jim Ramsay <i.am@jimramsay.com>
v1.1.2, 10 February 2009 v1.1.2, 18 February 2009
:man source: fluxbox-apps.txt :man source: fluxbox-apps.txt
:man version: {revision} :man version: {revision}
:man manual: Fluxbox Manual :man manual: Fluxbox Manual
@ -253,10 +253,8 @@ file.
[end] [end]
.................. ..................
AUTHOR and CREDITS AUTHORS
------------------ -------
This manpage is the combined work of:
- Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0) - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0)
- Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11) - Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11)
- Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11)
@ -264,9 +262,6 @@ This manpage is the combined work of:
- Matthew Hawkins <matt at mh dropbear id au> (blackbox) - Matthew Hawkins <matt at mh dropbear id au> (blackbox)
- Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) - Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
- Numerous other languages could be available if someone jumps in.
SEE ALSO SEE ALSO
-------- --------
fluxbox(1), xev(1), xkill(1), regex(7) fluxbox(1) xprop(1) regex(7)

21
doc/asciidoc/fluxbox-keys.txt
View file

@ -1,7 +1,7 @@
fluxbox-keys(5) fluxbox-keys(5)
=============== ===============
Jim Ramsay <i.am@jimramsay.com> Jim Ramsay <i.am@jimramsay.com>
v1.1.2, 10 February 2009 v1.1.2, 18 February 2009
:man source: fluxbox-keys.txt :man source: fluxbox-keys.txt
:man version: {revision} :man version: {revision}
:man manual: Fluxbox Manual :man manual: Fluxbox Manual
@ -79,15 +79,15 @@ KEYS
You may specify a key by its key name (for example, *a* or *space*) or by its You may specify a key by its key name (for example, *a* or *space*) or by its
numeric keycode (for example, *38* or *0xf3*). numeric keycode (for example, *38* or *0xf3*).
If you don't know the name of a key, you can run 'xev(1)' in a terminal, push If you don't know the name of a key, you can run *xev(1)* in a terminal, push
the key, and see the name in the output. If you have some "special" keys that the key, and see the name in the output. If you have some "special" keys that
do not produce a key name in the output of 'xev(1)', you can just use the do not produce a key name in the output of *xev(1)*, you can just use the
keycode (NOT the keysym!) in your keys file. keycode (NOT the keysym!) in your keys file.
Commands can also be bound to mouse button presses, for which the proper "key" Commands can also be bound to mouse button presses, for which the proper "key"
name is *Mouse*'n' where 'n' is the number of the mouse button. For example, name is *Mouse*'n' where 'n' is the number of the mouse button. For example,
*Mouse1* is the primary button, and *Mouse4* / *Mouse5* are the scroll wheel *Mouse1* is the primary button, and *Mouse4* / *Mouse5* are the scroll wheel
events, in normal configurations. 'xev(1)' can also be used to tell the button events, in normal configurations. *xev(1)* can also be used to tell the button
number. number.
//////////////// ////////////////
@ -199,7 +199,7 @@ These commands ordinarily affect only the currently focused window. The
Close the current window, equivalent to the window button. Close the current window, equivalent to the window button.
*Kill* | *KillWindow*:: *Kill* | *KillWindow*::
Close a window that's not responding to *Close*, like using `xkill`. Close a window that's not responding to *Close*, like using *xkill(1)*.
*Shade* | *ShadeWindow*:: *Shade* | *ShadeWindow*::
Toggle the *shaded* state of the current window, equivalent to the Toggle the *shaded* state of the current window, equivalent to the
@ -622,10 +622,8 @@ Mod4 t :If {Some Matches (xterm)} {NextWindow (xterm)} {Exec xterm}
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 '{print $3}').png
.................. ..................
AUTHOR and CREDITS AUTHORS
------------------ -------
This manpage is the combined work of:
- Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0) - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0)
- Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11) - Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11)
- Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11)
@ -633,9 +631,6 @@ This manpage is the combined work of:
- Matthew Hawkins <matt at mh dropbear id au> (blackbox) - Matthew Hawkins <matt at mh dropbear id au> (blackbox)
- Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) - Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
- Numerous other languages could be available if someone jumps in.
SEE ALSO SEE ALSO
-------- --------
fluxbox(1), xev(1), xkill(1), regex(7) fluxbox(1) xprop(1) xev(1) xkill(1) regex(7)

15
doc/asciidoc/fluxbox-menu.txt
View file

@ -1,7 +1,7 @@
fluxbox-menu(5) fluxbox-menu(5)
=============== ===============
Jim Ramsay <i.am@jimramsay.com> Jim Ramsay <i.am@jimramsay.com>
v1.1.2, 12 February 2009 v1.1.2, 18 February 2009
:man source: fluxbox-menu.txt :man source: fluxbox-menu.txt
:man version: {revision} :man version: {revision}
:man manual: Fluxbox Manual :man manual: Fluxbox Manual
@ -326,20 +326,15 @@ EXAMPLES
[end] [end]
.... ....
AUTHOR and CREDITS AUTHORS
------------------ -------
This manpage is the combined work of: - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0)
- Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.1.1)
- Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11) - Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11)
- Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11)
- Grubert <grubert at users sourceforge net> (fluxbox) - Grubert <grubert at users sourceforge net> (fluxbox)
- Matthew Hawkins <matt at mh dropbear id au> (blackbox) - Matthew Hawkins <matt at mh dropbear id au> (blackbox)
- Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) - Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
- Numerous other languages could be available if someone jumps in.
SEE ALSO SEE ALSO
-------- --------
fluxbox(1), xev(1), xkill(1), regex(7) fluxbox(1) fluxbox-keys(5) fluxbox-apps(5) xkill(1) iconv(1)

9
doc/asciidoc/fluxbox-remote.txt
View file

@ -1,7 +1,7 @@
fluxbox-remote(1) fluxbox-remote(1)
================= =================
Mark Tiefenbruck <mark@fluxbox.org> Mark Tiefenbruck <mark@fluxbox.org>
v1.1.2, 10 February 2009 v1.1.2, 18 February 2009
:man source: fluxbox-remote.txt :man source: fluxbox-remote.txt
:man version: {revision} :man version: {revision}
:man manual: Fluxbox Manual :man manual: Fluxbox Manual
@ -37,7 +37,10 @@ ENVIRONMENT
In order to communicate with 'fluxbox(1)', the DISPLAY environment variable must In order to communicate with 'fluxbox(1)', the DISPLAY environment variable must
be set properly. Usually, the value should be `:0.0'. be set properly. Usually, the value should be `:0.0'.
AUTHORS
-------
This man page written by Mark Tiefenbruck <mark at fluxbox.org>
SEE ALSO SEE ALSO
-------- --------
fluxbox(1), fluxbox-keys(5), wmctrl(1) fluxbox(1) fluxbox-keys(5) wmctrl(1)

25
doc/asciidoc/fluxbox-style.txt
View file

@ -1,7 +1,7 @@
fluxbox-style(5) fluxbox-style(5)
================ ================
Henrik Kinnunen <fluxgen@fluxbox.org> Henrik Kinnunen <fluxgen@fluxbox.org>
v1.1.2, 10 February 2009 v1.1.2, 18 February 2009
:man source: fluxbox-style.txt :man source: fluxbox-style.txt
:man version: {revision} :man version: {revision}
:man manual: Fluxbox Manual :man manual: Fluxbox Manual
@ -357,11 +357,11 @@ change the user's background, then use `background: none'. The options
`centered', `aspect', `tiled', and `fullscreen' require the `background.pixmap' `centered', `aspect', `tiled', and `fullscreen' require the `background.pixmap'
resource to contain a valid file name. The `random' option requires resource to contain a valid file name. The `random' option requires
`background.pixmap' to contain a valid directory name. For these options, `background.pixmap' to contain a valid directory name. For these options,
fluxbox(1) will call fbsetbg(1) to set the background. The options `gradient', *fluxbox(1)* will call *fbsetbg(1)* to set the background. The options `gradient',
`solid', and `mod' all require `background.color' to be set. `gradient' and `solid', and `mod' all require `background.color' to be set. `gradient' and
`mod' both require `background.colorTo'. `mod' requires `background.modX' and `mod' both require `background.colorTo'. `mod' requires `background.modX' and
`background.modY' to be set as well. These options will be passed to `background.modY' to be set as well. These options will be passed to
fbsetroot(1) to set the background. *fbsetroot(1)* to set the background.
background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture>|mod|none background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture>|mod|none
background.pixmap: <file or directory> background.pixmap: <file or directory>
@ -472,25 +472,24 @@ These are the color formats for styles:
See /usr/share/X11/rgb.txt for an explaination. See /usr/share/X11/rgb.txt for an explaination.
AUTHOR and CREDITS AUTHORS
------------------ -------
Blackbox was written and maintained by Brad Hughes <blackbox@alug.org> Blackbox was written and maintained by Brad Hughes <blackbox at alug.org>
and Jeff Raven <jraven@psu.edu>. and Jeff Raven <jraven at psu.edu>.
fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen@fluxbox.org> fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen at fluxbox.org>
with contributions and patches merged from many individuals around the world. with contributions and patches merged from many individuals around the world.
The Official fluxbox(1) website: http://www.fluxbox.org[] The Official fluxbox(1) website: http://www.fluxbox.org
You can find a lot of styles here: http://tenr.de/[] You can find a lot of styles here: http://tenr.de/
This manpage was composed from various resources including the official This manpage was composed from various resources including the official
documentation, fluxbox(1) man page and numerous other resources by Curt documentation, fluxbox(1) man page and numerous other resources by Curt
"Asenchi" Micol. If you notice any errors or problems with this page, please "Asenchi" Micol. If you notice any errors or problems with this page, please
contact him here: <asenchi@asenchi.com> and using the great contributions of contact him here: <asenchi at asenchi.com> and using the great contributions of
<grubert@users.sourceforge.net>. Numerous other languages could be available <grubert at users.sourceforge.net>. Numerous other languages could be available
if someone jumps in. if someone jumps in.
SEE ALSO SEE ALSO
-------- --------
fluxbox(1) fbsetbg(1) fbsetroot(1) fluxbox(1) fbsetbg(1) fbsetroot(1)

31
doc/asciidoc/fluxbox.txt
View file

@ -1,7 +1,7 @@
fluxbox(1) fluxbox(1)
========== ==========
Henrik Kinnunen <fluxgen@fluxbox.org> Henrik Kinnunen <fluxgen@fluxbox.org>
v1.1.2, 10 February 2009 v1.1.2, 18 February 2009
:man source: fluxbox.txt :man source: fluxbox.txt
:man version: {revision} :man version: {revision}
:man manual: Fluxbox Manual :man manual: Fluxbox Manual
@ -88,12 +88,12 @@ OPTIONS
STARTING FLUXBOX STARTING FLUXBOX
---------------- ----------------
*fluxbox(1)* comes with a program called *startfluxbox(8)* usually located *fluxbox(1)* comes with a program called *startfluxbox(1)* usually located
wherever you installed fluxbox. This script provides you with many options and wherever you installed fluxbox. This script provides you with many options and
variables that can be set when starting fluxbox. To actually call fluxbox and variables that can be set when starting fluxbox. To actually call fluxbox and
begin using it, you should place ``exec startfluxbox'' in your *\~/.xinitrc* as begin using it, you should place ``exec startfluxbox'' in your *\~/.xinitrc* as
the last executed command. This is assuming that the location of *fluxbox(1)* the last executed command. This is assuming that the location of *fluxbox(1)*
and *startfluxbox(8)* are in your shell's $PATH. Also note that you may need to and *startfluxbox(1)* are in your shell's $PATH. Also note that you may need to
create the *\~/.xinitrc* file or your setup may use *\~/.xsession* instead, create the *\~/.xinitrc* file or your setup may use *\~/.xsession* instead,
depending on your X setup. Some X login managers like *gdm(1)* or *kdm(1)* may depending on your X setup. Some X login managers like *gdm(1)* or *kdm(1)* may
simply provide a ``Fluxbox'' session for you without having to alter any simply provide a ``Fluxbox'' session for you without having to alter any
@ -815,7 +815,7 @@ slit. The file is generally located at *\~/.fluxbox/slitlist*.
A simple procedure for getting the slit sequences the way you like it is: A simple procedure for getting the slit sequences the way you like it is:
1. Run fluxbox with no pre-loaded dockapps 1. Run fluxbox with no pre-loaded dockapps
2. Run dockapps individually in the order you want them 2. Run dockapps individually in the order you want them
3. Add dockapps to your startfluxbox(8) script 3. Add dockapps to your *startfluxbox(1)* script
This sequence will be saved by default to *\~/.fluxbox/slitlist* and will be This sequence will be saved by default to *\~/.fluxbox/slitlist* and will be
remembered for future instances of fluxbox. remembered for future instances of fluxbox.
@ -1155,8 +1155,8 @@ fluxbox responds to the following signals:
- SIGUSR1 Forces reloading of configuration. - SIGUSR1 Forces reloading of configuration.
- SIGUSR2 Forces reloading of menu file. - SIGUSR2 Forces reloading of menu file.
AUTHOR and CREDITS AUTHORS
------------------ -------
fluxbox is written and maintained by Henrik Kinnunen <fluxgen at fluxbox org>, fluxbox is written and maintained by Henrik Kinnunen <fluxgen at fluxbox org>,
Simon Bowden <rathnor at fluxbox org>, Mathias Gumz <akira at fluxbox org>, and Simon Bowden <rathnor at fluxbox org>, Mathias Gumz <akira at fluxbox org>, and
Mark Tiefenbruck <mark at fluxbox org>, with contributions and patches merged Mark Tiefenbruck <mark at fluxbox org>, with contributions and patches merged
@ -1165,15 +1165,9 @@ from many individuals around the world.
Blackbox was written and maintained by Brad Hughes <blackbox at alug org> and Blackbox was written and maintained by Brad Hughes <blackbox at alug org> and
Jeff Raven <jraven at psu edu>. Jeff Raven <jraven at psu edu>.
The Official fluxbox website: http://www.fluxbox.org
The Official fluxbox wiki: http://www.fluxbox-wiki.org
Many compatible themes: http://tenr.de
This manpage is the combined work of: This manpage is the combined work of:
- Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.1.1) - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0)
- Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11) - Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11)
- Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11)
- Grubert <grubert at users sourceforge net> (fluxbox) - Grubert <grubert at users sourceforge net> (fluxbox)
@ -1182,6 +1176,14 @@ This manpage is the combined work of:
- Numerous other languages could be available if someone jumps in. - Numerous other languages could be available if someone jumps in.
ONLINE DOCUMENTATION
--------------------
The Official fluxbox website: http://www.fluxbox.org
The Official fluxbox wiki: http://www.fluxbox-wiki.org
Many compatible themes: http://tenr.de
BUGS BUGS
---- ----
If you find any bugs, please visit the #fluxbox irc channel on If you find any bugs, please visit the #fluxbox irc channel on
@ -1192,5 +1194,4 @@ mailinglists. More information can be found on the official website.
SEE ALSO SEE ALSO
-------- --------
fluxbox-apps(5) fluxbox-keys(5) fluxbox-style(5) fluxbox-menu(5) fluxbox-apps(5) fluxbox-keys(5) fluxbox-style(5) fluxbox-menu(5)
fluxbox-remote(1) bsetroot(1) fbsetbg(1) fbrun(1) fluxbox-remote(1) fbsetroot(1) fbsetbg(1) fbrun(1) startfluxbox(1)

57
doc/asciidoc/startfluxbox.txt
View file

@ -24,11 +24,61 @@ 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
--------
The default *\~/.fluxbox/startup* is as follows:
....
#!/bin/sh
#
# fluxbox startup-script:
#
# Lines starting with a '#' 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.
#
# unclutter -idle 2 &
# wmnd &
# 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.
exec fluxbox
# or if you want to keep a log:
# exec fluxbox -log "$fluxdir/log"
....
If you need to start applications after fluxbox, you can change the *exec
fluxbox* line above to something like this:
....
exec fluxbox &
fbpid=$!
sleep 1
{
xsetroot -cursor_name left_ptr -fg white -bg black &
ipager &
gkrellm2 &
} &
wait $fbpid
....
So xsetroot, ipager, and gkrellm2 will all be started after fluxbox, after
giving fluxbox 1 second to startup.
For more details on what else you can do in this script, see *sh(1p)*, or the
documentation for your shell.
ONLINE DOCUMENTATION ONLINE DOCUMENTATION
-------------------- --------------------
More extensive documentation for *startfluxbox(1)* can be found at::: More extensive documentation for *startfluxbox(1)* can be found at:::
@ -36,9 +86,10 @@ http://www.xs4all.nl/~hanb/software/fluxbox/startfluxbox.html
AUTHORS AUTHORS
------- -------
The author of *startfluxbox(1)* is Han Boetes <han@fluxbox.org> The author of *startfluxbox(1)* is Han Boetes <han at fluxbox.org>
This manpage was updated to asciidoc format by Jim Ramsay <i.am@jimramsay.com> This manpage was converted to asciidoc format by Jim Ramsay <i.am at
jimramsay.com> for fluxbox-1.1.2
SEE ALSO SEE ALSO
-------- --------

33
doc/fbrun.1.in
View file

@ -1,12 +1,12 @@
.\" Title: fbrun .\" Title: fbrun
.\" Author: [see the "AUTHORS" section] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/18/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fbrun.txt 1.1.2 .\" Source: fbrun.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FBRUN" "1" "02/18/2009" "fbrun\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FBRUN" "1" "02/19/2009" "fbrun\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -267,38 +267,9 @@ fbrun \-fg black \-bg white \-text xterm \-title "run xterm"
.\} .\}
.SH "AUTHORS" .SH "AUTHORS"
.sp .sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
This manpage was originally written by Bastian Kleineidam <calvin at debian\&.org> for the Debian distribution of fluxbox (but may be used by others)\&. This manpage was originally written by Bastian Kleineidam <calvin at debian\&.org> for the Debian distribution of fluxbox (but may be used by others)\&.
.RE
.sp .sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
It was then converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2 It was then converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
The main author of fluxbox is Henrik Kinnunen <fluxgen at fluxbox\&.org>\&.
.RE
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1) fluxbox(1)

28
doc/fbsetbg.1.in
View file

@ -1,12 +1,12 @@
.\" Title: fbsetbg .\" Title: fbsetbg
.\" Author: [see the "AUTHORS" section] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/18/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fbsetbg.txt 1.1.2 .\" Source: fbsetbg.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FBSETBG" "1" "02/18/2009" "fbsetbg\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FBSETBG" "1" "02/19/2009" "fbsetbg\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -214,7 +214,8 @@ Use specified wallpapersetter, use no argument to forget\&.
.PP .PP
\fB\-b\fR \fIfbsetrootoptions\fR \fB\-b\fR \fIfbsetrootoptions\fR
.RS 4 .RS 4
Forward the options to fbsetroot\&. Forward the options to
\fBfbsetroot(1)\fR\&. These can be used to set a solid, pattern, or gradient background texture\&.
.RE .RE
.PP .PP
\fB\-r\fR \fIdirectory\fR \fB\-r\fR \fIdirectory\fR
@ -302,9 +303,6 @@ $ DISPLAY=:0\&.0 fbsetbg \-l
.if n \{\ .if n \{\
.RE .RE
.\} .\}
.SH "SEE ALSO"
.sp
fluxbox(1), fbsetroot(1)
.SH "ONLINE DOCUMENTATION" .SH "ONLINE DOCUMENTATION"
.PP .PP
Much more extensive documentation for \fBfbsetbg(1)\fR is provided on: Much more extensive documentation for \fBfbsetbg(1)\fR is provided on:
@ -317,17 +315,9 @@ Much more extensive documentation for \fBfbsetbg(1)\fR is provided on:
\fBfbsetbg(1)\fR is not foolproof\&. \fBfbsetbg(1)\fR is not foolproof\&.
.SH "AUTHORS" .SH "AUTHORS"
.sp .sp
The author of fbsetbg is Han Boetes <\m[blue]\fBhan@fluxbox\&.org\fR\m[]\&\s-2\u[1]\d\s+2> The author of fbsetbg is Han Boetes <han at fluxbox\&.org>
.sp .sp
This manpage was updated to asciidoc format by Jim Ramsay <\m[blue]\fBi\&.am@jimramsay\&.com\fR\m[]\&\s-2\u[2]\d\s+2> This manpage was converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2
.SH "Notes" .SH "SEE ALSO"
.IP " 1." 4 .sp
han@fluxbox.org fluxbox(1) fbsetroot(1)
.RS 4
\%mailto:han@fluxbox.org
.RE
.IP " 2." 4
i.am@jimramsay.com
.RS 4
\%mailto:i.am@jimramsay.com
.RE

31
doc/fbsetroot.1.in
View file

@ -1,12 +1,12 @@
.\" Title: fbsetroot .\" Title: fbsetroot
.\" Author: [see the "AUTHORS" section] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/18/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fbsetroot.txt 1.1.2 .\" Source: fbsetroot.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FBSETROOT" "1" "02/18/2009" "fbsetroot\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FBSETROOT" "1" "02/19/2009" "fbsetroot\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -170,11 +170,11 @@
fbsetroot \- a simple background utility used by the fluxbox(1) window manager, originally written for and by the original blackbox(1) window manager\&. fbsetroot \- a simple background utility used by the fluxbox(1) window manager, originally written for and by the original blackbox(1) window manager\&.
.SH "Synopsis" .SH "Synopsis"
.sp .sp
\fBfbsetroot\fR [\-display \fIdisplay\fR ] \-solid \fIcolor\fR \fBfbsetroot\fR [\-display \fIdisplay\fR] \-solid \fIcolor\fR
.sp .sp
\fBfbsetroot\fR [\-display \fIdisplay\fR ] \-mod \fIx\fR \fIy\fR \-fg \fIcolor\fR \-bg \fIcolor\fR \fBfbsetroot\fR [\-display \fIdisplay\fR] \-mod \fIx\fR \fIy\fR \-fg \fIcolor\fR \-bg \fIcolor\fR
.sp .sp
\fBfbsetroot\fR [\-display \fIdisplay\fR ] \-gradient \fItexture\fR \-from \fIcolor\fR \-to \fIcolor\fR \fBfbsetroot\fR [\-display \fIdisplay\fR] \-gradient \fItexture\fR \-from \fIcolor\fR \-to \fIcolor\fR
.sp .sp
\fBfbsetroot\fR \-help \fBfbsetroot\fR \-help
.SH "DESCRIPTION" .SH "DESCRIPTION"
@ -182,6 +182,8 @@ fbsetroot \- a simple background utility used by the fluxbox(1) window manager,
\fBfbsetroot(1)\fR is a utility that can control the appearance of the root window in three ways: Either give it a solid color, or write a two color modula pattern to it, or render a gradient texture, based on two different colors\&. \fBfbsetroot(1)\fR is a utility that can control the appearance of the root window in three ways: Either give it a solid color, or write a two color modula pattern to it, or render a gradient texture, based on two different colors\&.
.sp .sp
fbsetroot resembles \fBxsetroot(1)\fR in this functionality but it supports multiple\-screen displays, and gradient textures the same way as blackbox or fluxbox does\&. It doesn\'t handle cursors etc\&. fbsetroot was originally part of the Blackbox package and was carried over with the code that became Fluxbox\&. It was called bsetroot back in those days\&. fbsetroot resembles \fBxsetroot(1)\fR in this functionality but it supports multiple\-screen displays, and gradient textures the same way as blackbox or fluxbox does\&. It doesn\'t handle cursors etc\&. fbsetroot was originally part of the Blackbox package and was carried over with the code that became Fluxbox\&. It was called bsetroot back in those days\&.
.sp
If any errors are encountered, fbsetroot will use either \fBgxmessage(1)\fR or \fBxmessage(1)\fR to inform the user of errors\&.
.SH "OPTIONS" .SH "OPTIONS"
.sp .sp
fbsetroot operates in three ways, you must choose one of the first 3 options: fbsetroot operates in three ways, you must choose one of the first 3 options:
@ -258,22 +260,9 @@ Prints version info and short help text\&.
.RE .RE
.SH "AUTHORS" .SH "AUTHORS"
.sp .sp
fbsetroot is written and maintained by the Fluxbox Development Team This manpage was modified by Curt "Asenchi" Micol <asenchi at asenchi\&.com> for the Fluxbox window manager\&.
.sp .sp
This manpage was modified by Curt "Asenchi" Micol <\m[blue]\fBasenchi@asenchi\&.com\fR\m[]\&\s-2\u[1]\d\s+2> for the Fluxbox window manager\&. Further updates for fluxbox\-1\&.1\&.2 and conversion to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com>
.sp
Further updates for fluxbox\-1\&.1\&.2 and conversion to asciidoc format by Jim Ramsay <\m[blue]\fBi\&.am@jimramsay\&.com\fR\m[]\&\s-2\u[2]\d\s+2>
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1) fbsetbg(1) fluxbox(1) fbsetbg(1) xsetroot(1) xmessage(1) gxmessage(1)
.SH "Notes"
.IP " 1." 4
asenchi@asenchi.com
.RS 4
\%mailto:asenchi@asenchi.com
.RE
.IP " 2." 4
i.am@jimramsay.com
.RS 4
\%mailto:i.am@jimramsay.com
.RE

23
doc/fluxbox-apps.5.in
View file

@ -1,12 +1,12 @@
.\" Title: fluxbox-apps .\" Title: fluxbox-apps
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/17/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fluxbox-apps.txt 1.1.2 .\" Source: fluxbox-apps.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FLUXBOX\-APPS" "5" "02/17/2009" "fluxbox\-apps\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FLUXBOX\-APPS" "5" "02/19/2009" "fluxbox\-apps\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -676,9 +676,7 @@ Here are some interesting and/or useful examples you can do with your apps file\
.if n \{\ .if n \{\
.RE .RE
.\} .\}
.SH "AUTHOR and CREDITS" .SH "AUTHORS"
.sp
This manpage is the combined work of:
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
@ -745,17 +743,6 @@ Matthew Hawkins <matt at mh dropbear id au> (blackbox)
.\} .\}
Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Numerous other languages could be available if someone jumps in\&.
.RE
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1), xev(1), xkill(1), regex(7) fluxbox(1) xprop(1) regex(7)

29
doc/fluxbox-keys.5.in
View file

@ -1,12 +1,12 @@
.\" Title: fluxbox-keys .\" Title: fluxbox-keys
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/17/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fluxbox-keys.txt 1.1.2 .\" Source: fluxbox-keys.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FLUXBOX\-KEYS" "5" "02/17/2009" "fluxbox\-keys\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FLUXBOX\-KEYS" "5" "02/19/2009" "fluxbox\-keys\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -236,9 +236,9 @@ To combine two or more modifiers, just list them (space\-delimited) in any order
.sp .sp
You may specify a key by its key name (for example, \fBa\fR or \fBspace\fR) or by its numeric keycode (for example, \fB38\fR or \fB0xf3\fR)\&. You may specify a key by its key name (for example, \fBa\fR or \fBspace\fR) or by its numeric keycode (for example, \fB38\fR or \fB0xf3\fR)\&.
.sp .sp
If you don\'t know the name of a key, you can run \fIxev(1)\fR in a terminal, push the key, and see the name in the output\&. If you have some "special" keys that do not produce a key name in the output of \fIxev(1)\fR, you can just use the keycode (NOT the keysym!) in your keys file\&. If you don\'t know the name of a key, you can run \fBxev(1)\fR in a terminal, push the key, and see the name in the output\&. If you have some "special" keys that do not produce a key name in the output of \fBxev(1)\fR, you can just use the keycode (NOT the keysym!) in your keys file\&.
.sp .sp
Commands can also be bound to mouse button presses, for which the proper "key" name is \fBMouse\fR\fIn\fR where \fIn\fR is the number of the mouse button\&. For example, \fBMouse1\fR is the primary button, and \fBMouse4\fR / \fBMouse5\fR are the scroll wheel events, in normal configurations\&. \fIxev(1)\fR can also be used to tell the button number\&. Commands can also be bound to mouse button presses, for which the proper "key" name is \fBMouse\fR\fIn\fR where \fIn\fR is the number of the mouse button\&. For example, \fBMouse1\fR is the primary button, and \fBMouse4\fR / \fBMouse5\fR are the scroll wheel events, in normal configurations\&. \fBxev(1)\fR can also be used to tell the button number\&.
.SH "CHAINING" .SH "CHAINING"
.sp .sp
Key bindings can be chained in a fashion similar to Emacs key bindings using the syntax: Key bindings can be chained in a fashion similar to Emacs key bindings using the syntax:
@ -434,7 +434,7 @@ Close the current window, equivalent to the window button\&.
.RS 4 .RS 4
Close a window that\'s not responding to Close a window that\'s not responding to
\fBClose\fR, like using \fBClose\fR, like using
\FCxkill\F[]\&. \fBxkill(1)\fR\&.
.RE .RE
.PP .PP
\fBShade\fR | \fBShadeWindow\fR \fBShade\fR | \fBShadeWindow\fR
@ -1313,9 +1313,7 @@ ChangeWorkspace :Exec fbsetbg ~/\&.fluxbox/bg$(xprop \-root _NET_CURRENT_DESKTOP
.if n \{\ .if n \{\
.RE .RE
.\} .\}
.SH "AUTHOR and CREDITS" .SH "AUTHORS"
.sp
This manpage is the combined work of:
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
@ -1382,17 +1380,6 @@ Matthew Hawkins <matt at mh dropbear id au> (blackbox)
.\} .\}
Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Numerous other languages could be available if someone jumps in\&.
.RE
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1), xev(1), xkill(1), regex(7) fluxbox(1) xprop(1) xev(1) xkill(1) regex(7)

25
doc/fluxbox-menu.5.in
View file

@ -1,12 +1,12 @@
.\" Title: fluxbox-menu .\" Title: fluxbox-menu
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/17/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fluxbox-menu.txt 1.1.2 .\" Source: fluxbox-menu.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FLUXBOX\-MENU" "5" "02/17/2009" "fluxbox\-menu\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FLUXBOX\-MENU" "5" "02/19/2009" "fluxbox\-menu\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -595,9 +595,7 @@ The \fIcomand\&...\fR field of the \fB[exec]\fR tag can take advantage of other
.if n \{\ .if n \{\
.RE .RE
.\} .\}
.SH "AUTHOR and CREDITS" .SH "AUTHORS"
.sp
This manpage is the combined work of:
.sp .sp
.RS 4 .RS 4
.ie n \{\ .ie n \{\
@ -607,7 +605,7 @@ This manpage is the combined work of:
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
Jim Ramsay <i\&.am at jimramsay com> (>fluxbox\-1\&.1\&.1) Jim Ramsay <i\&.am at jimramsay com> (>fluxbox\-1\&.0\&.0)
.RE .RE
.sp .sp
.RS 4 .RS 4
@ -664,17 +662,6 @@ Matthew Hawkins <matt at mh dropbear id au> (blackbox)
.\} .\}
Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
.RE .RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Numerous other languages could be available if someone jumps in\&.
.RE
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1), xev(1), xkill(1), regex(7) fluxbox(1) fluxbox\-keys(5) fluxbox\-apps(5) xkill(1) iconv(1)

11
doc/fluxbox-remote.1.in
View file

@ -1,12 +1,12 @@
.\" Title: fluxbox-remote .\" Title: fluxbox-remote
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/17/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fluxbox-remote.txt 1.1.2 .\" Source: fluxbox-remote.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FLUXBOX\-REMOTE" "1" "02/17/2009" "fluxbox\-remote\&.txt 1\&.1\&." "Fluxbox Manual" .TH "FLUXBOX\-REMOTE" "1" "02/19/2009" "fluxbox\-remote\&.txt 1\&.1\&." "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -190,6 +190,9 @@ first\&.
.SH "ENVIRONMENT" .SH "ENVIRONMENT"
.sp .sp
In order to communicate with \fIfluxbox(1)\fR, the DISPLAY environment variable must be set properly\&. Usually, the value should be `:0\&.0\'\&. In order to communicate with \fIfluxbox(1)\fR, the DISPLAY environment variable must be set properly\&. Usually, the value should be `:0\&.0\'\&.
.SH "AUTHORS"
.sp
This man page written by Mark Tiefenbruck <mark at fluxbox\&.org>
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1), fluxbox\-keys(5), wmctrl(1) fluxbox(1) fluxbox\-keys(5) wmctrl(1)

42
doc/fluxbox-style.5.in
View file

@ -1,12 +1,12 @@
.\" Title: fluxbox-style .\" Title: fluxbox-style
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/17/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fluxbox-style.txt 1.1.2 .\" Source: fluxbox-style.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FLUXBOX\-STYLE" "5" "02/17/2009" "fluxbox\-style\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FLUXBOX\-STYLE" "5" "02/19/2009" "fluxbox\-style\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -611,7 +611,7 @@ menu\&.unselected\&.pixmap: <filename>
.\} .\}
.SH "BACKGROUND" .SH "BACKGROUND"
.sp .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, fluxbox(1) will call fbsetbg(1) 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 fbsetroot(1) to set the background\&. 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\&.
.sp .sp
.if n \{\ .if n \{\
.RS 4 .RS 4
@ -783,41 +783,15 @@ rgb:<0\-255>/<0\-255>/<0\-255>
.\} .\}
.sp .sp
See /usr/share/X11/rgb\&.txt for an explaination\&. See /usr/share/X11/rgb\&.txt for an explaination\&.
.SH "AUTHOR and CREDITS" .SH "AUTHORS"
.sp .sp
Blackbox was written and maintained by Brad Hughes <\m[blue]\fBblackbox@alug\&.org\fR\m[]\&\s-2\u[1]\d\s+2> and Jeff Raven <\m[blue]\fBjraven@psu\&.edu\fR\m[]\&\s-2\u[2]\d\s+2>\&. Blackbox was written and maintained by Brad Hughes <blackbox at alug\&.org> and Jeff Raven <jraven at psu\&.edu>\&.
.sp .sp
fluxbox(1) is written and maintained by Henrik Kinnunen <\m[blue]\fBfluxgen@fluxbox\&.org\fR\m[]\&\s-2\u[3]\d\s+2> with contributions and patches merged from many individuals around the world\&. fluxbox(1) is written and maintained by Henrik Kinnunen <fluxgen at fluxbox\&.org> with contributions and patches merged from many individuals around the world\&.
.sp .sp
The Official fluxbox(1) website: \m[blue]\fBhttp://www\&.fluxbox\&.org\fR\m[] You can find a lot of styles here: \m[blue]\fBhttp://tenr\&.de/\fR\m[] The Official fluxbox(1) website: \m[blue]\fBhttp://www\&.fluxbox\&.org\fR\m[] You can find a lot of styles here: \m[blue]\fBhttp://tenr\&.de/\fR\m[]
.sp .sp
This manpage was composed from various resources including the official documentation, fluxbox(1) man page and numerous other resources by Curt "Asenchi" Micol\&. If you notice any errors or problems with this page, please contact him here: <\m[blue]\fBasenchi@asenchi\&.com\fR\m[]\&\s-2\u[4]\d\s+2> and using the great contributions of <\m[blue]\fBgrubert@users\&.sourceforge\&.net\fR\m[]\&\s-2\u[5]\d\s+2>\&. Numerous other languages could be available if someone jumps in\&. This manpage was composed from various resources including the official documentation, fluxbox(1) man page and numerous other resources by Curt "Asenchi" Micol\&. If you notice any errors or problems with this page, please contact him here: <asenchi at asenchi\&.com> and using the great contributions of <grubert at users\&.sourceforge\&.net>\&. Numerous other languages could be available if someone jumps in\&.
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1) fbsetbg(1) fbsetroot(1) fluxbox(1) fbsetbg(1) fbsetroot(1)
.SH "Notes"
.IP " 1." 4
blackbox@alug.org
.RS 4
\%mailto:blackbox@alug.org
.RE
.IP " 2." 4
jraven@psu.edu
.RS 4
\%mailto:jraven@psu.edu
.RE
.IP " 3." 4
fluxgen@fluxbox.org
.RS 4
\%mailto:fluxgen@fluxbox.org
.RE
.IP " 4." 4
asenchi@asenchi.com
.RS 4
\%mailto:asenchi@asenchi.com
.RE
.IP " 5." 4
grubert@users.sourceforge.net
.RS 4
\%mailto:grubert@users.sourceforge.net
.RE

29
doc/fluxbox.1.in
View file

@ -1,12 +1,12 @@
.\" Title: fluxbox .\" Title: fluxbox
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/17/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: fluxbox.txt 1.1.2 .\" Source: fluxbox.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "FLUXBOX" "1" "02/17/2009" "fluxbox\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "FLUXBOX" "1" "02/19/2009" "fluxbox\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -242,7 +242,7 @@ Lists all available internal commands\&.
.RE .RE
.SH "STARTING FLUXBOX" .SH "STARTING FLUXBOX"
.sp .sp
\fBfluxbox(1)\fR comes with a program called \fBstartfluxbox(8)\fR usually located wherever you installed fluxbox\&. This script provides you with many options and variables that can be set when starting fluxbox\&. To actually call fluxbox and begin using it, you should place \(lqexec startfluxbox\(rq in your \fB~/\&.xinitrc\fR as the last executed command\&. This is assuming that the location of \fBfluxbox(1)\fR and \fBstartfluxbox(8)\fR are in your shell\'s $PATH\&. Also note that you may need to create the \fB~/\&.xinitrc\fR file or your setup may use \fB~/\&.xsession\fR instead, depending on your X setup\&. Some X login managers like \fBgdm(1)\fR or \fBkdm(1)\fR may simply provide a \(lqFluxbox\(rq session for you without having to alter any settings\&. \fBfluxbox(1)\fR comes with a program called \fBstartfluxbox(1)\fR usually located wherever you installed fluxbox\&. This script provides you with many options and variables that can be set when starting fluxbox\&. To actually call fluxbox and begin using it, you should place \(lqexec startfluxbox\(rq in your \fB~/\&.xinitrc\fR as the last executed command\&. This is assuming that the location of \fBfluxbox(1)\fR and \fBstartfluxbox(1)\fR are in your shell\'s $PATH\&. Also note that you may need to create the \fB~/\&.xinitrc\fR file or your setup may use \fB~/\&.xsession\fR instead, depending on your X setup\&. Some X login managers like \fBgdm(1)\fR or \fBkdm(1)\fR may simply provide a \(lqFluxbox\(rq session for you without having to alter any settings\&.
.sp .sp
By using fluxbox \-i you\'ll see the defaults used by \fBfluxbox(1)\fR\&. These are what fluxbox looks for upon startup\&. In the list of \(lqDefaults:\(rq you\'ll see a menu file location, this is where you can provide a system\-wide menu file for your users\&. By using fluxbox \-i you\'ll see the defaults used by \fBfluxbox(1)\fR\&. These are what fluxbox looks for upon startup\&. In the list of \(lqDefaults:\(rq you\'ll see a menu file location, this is where you can provide a system\-wide menu file for your users\&.
.sp .sp
@ -1519,7 +1519,7 @@ This submenu lets you reorder the the applications running in the slit\&. You ar
.sp .sp
fluxbox\'s slitlist file is available for those that use dockapps in the slit\&. This file helps fluxbox keep track of the \fBorder\fR of the dockapps when in the slit\&. The file is generally located at \fB~/\&.fluxbox/slitlist\fR\&. fluxbox\'s slitlist file is available for those that use dockapps in the slit\&. This file helps fluxbox keep track of the \fBorder\fR of the dockapps when in the slit\&. The file is generally located at \fB~/\&.fluxbox/slitlist\fR\&.
.sp .sp
A simple procedure for getting the slit sequences the way you like it is: 1\&. Run fluxbox with no pre\-loaded dockapps 2\&. Run dockapps individually in the order you want them 3\&. Add dockapps to your startfluxbox(8) script A simple procedure for getting the slit sequences the way you like it is: 1\&. Run fluxbox with no pre\-loaded dockapps 2\&. Run dockapps individually in the order you want them 3\&. Add dockapps to your \fBstartfluxbox(1)\fR script
.sp .sp
This sequence will be saved by default to \fB~/\&.fluxbox/slitlist\fR and will be remembered for future instances of fluxbox\&. This sequence will be saved by default to \fB~/\&.fluxbox/slitlist\fR and will be remembered for future instances of fluxbox\&.
.sp .sp
@ -1929,18 +1929,12 @@ SIGUSR1 Forces reloading of configuration\&.
.\} .\}
SIGUSR2 Forces reloading of menu file\&. SIGUSR2 Forces reloading of menu file\&.
.RE .RE
.SH "AUTHOR and CREDITS" .SH "AUTHORS"
.sp .sp
fluxbox is written and maintained by Henrik Kinnunen <fluxgen at fluxbox org>, Simon Bowden <rathnor at fluxbox org>, Mathias Gumz <akira at fluxbox org>, and Mark Tiefenbruck <mark at fluxbox org>, with contributions and patches merged from many individuals around the world\&. fluxbox is written and maintained by Henrik Kinnunen <fluxgen at fluxbox org>, Simon Bowden <rathnor at fluxbox org>, Mathias Gumz <akira at fluxbox org>, and Mark Tiefenbruck <mark at fluxbox org>, with contributions and patches merged from many individuals around the world\&.
.sp .sp
Blackbox was written and maintained by Brad Hughes <blackbox at alug org> and Jeff Raven <jraven at psu edu>\&. Blackbox was written and maintained by Brad Hughes <blackbox at alug org> and Jeff Raven <jraven at psu edu>\&.
.sp .sp
The Official fluxbox website: \m[blue]\fBhttp://www\&.fluxbox\&.org\fR\m[]
.sp
The Official fluxbox wiki: \m[blue]\fBhttp://www\&.fluxbox\-wiki\&.org\fR\m[]
.sp
Many compatible themes: \m[blue]\fBhttp://tenr\&.de\fR\m[]
.sp
This manpage is the combined work of: This manpage is the combined work of:
.sp .sp
.RS 4 .RS 4
@ -1951,7 +1945,7 @@ This manpage is the combined work of:
.sp -1 .sp -1
.IP \(bu 2.3 .IP \(bu 2.3
.\} .\}
Jim Ramsay <i\&.am at jimramsay com> (>fluxbox\-1\&.1\&.1) Jim Ramsay <i\&.am at jimramsay com> (>fluxbox\-1\&.0\&.0)
.RE .RE
.sp .sp
.RS 4 .RS 4
@ -2019,9 +2013,16 @@ Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
.\} .\}
Numerous other languages could be available if someone jumps in\&. Numerous other languages could be available if someone jumps in\&.
.RE .RE
.SH "ONLINE DOCUMENTATION"
.sp
The Official fluxbox website: \m[blue]\fBhttp://www\&.fluxbox\&.org\fR\m[]
.sp
The Official fluxbox wiki: \m[blue]\fBhttp://www\&.fluxbox\-wiki\&.org\fR\m[]
.sp
Many compatible themes: \m[blue]\fBhttp://tenr\&.de\fR\m[]
.SH "BUGS" .SH "BUGS"
.sp .sp
If you find any bugs, please visit the #fluxbox irc channel on irc\&.freenode\&.net or submit them to the bug tracker at \m[blue]\fBhttp://sf\&.net/projects/fluxbox\fR\m[] \&. Or you may subscribe to one of the mailinglists\&. More information can be found on the official website\&. If you find any bugs, please visit the #fluxbox irc channel on irc\&.freenode\&.net or submit them to the bug tracker at \m[blue]\fBhttp://sf\&.net/projects/fluxbox\fR\m[] \&. Or you may subscribe to one of the mailinglists\&. More information can be found on the official website\&.
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox\-apps(5) fluxbox\-keys(5) fluxbox\-style(5) fluxbox\-menu(5) fluxbox\-remote(1) bsetroot(1) fbsetbg(1) fbrun(1) fluxbox\-apps(5) fluxbox\-keys(5) fluxbox\-style(5) fluxbox\-menu(5) fluxbox\-remote(1) fbsetroot(1) fbsetbg(1) fbrun(1) startfluxbox(1)

92
doc/startfluxbox.1.in
View file

@ -1,12 +1,12 @@
.\" Title: startfluxbox .\" Title: startfluxbox
.\" Author: [see the "AUTHORS" section] .\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
.\" Date: 02/18/2009 .\" Date: 02/19/2009
.\" Manual: Fluxbox Manual .\" Manual: Fluxbox Manual
.\" Source: startfluxbox.txt 1.1.2 .\" Source: startfluxbox.txt 1.1.2
.\" Language: English .\" Language: English
.\" .\"
.TH "STARTFLUXBOX" "1" "02/18/2009" "startfluxbox\&.txt 1\&.1\&.2" "Fluxbox Manual" .TH "STARTFLUXBOX" "1" "02/19/2009" "startfluxbox\&.txt 1\&.1\&.2" "Fluxbox Manual"
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
.\" * (re)Define some macros .\" * (re)Define some macros
.\" ----------------------------------------------------------------- .\" -----------------------------------------------------------------
@ -182,6 +182,79 @@ startfluxbox \- start a fluxbox session
.RS 4 .RS 4
This file contains all commands that should be executed before fluxbox is started\&. The initial file contains helpful comments for beginners\&. It also starts fluxbox\&. This file contains all commands that should be executed before fluxbox is started\&. The initial file contains helpful comments for beginners\&. It also starts fluxbox\&.
.RE .RE
.SH "EXAMPLES"
.sp
The default \fB~/\&.fluxbox/startup\fR is as follows:
.sp
.if n \{\
.RS 4
.\}
.fam C
.ps -1
.nf
.BB lightgray
#!/bin/sh
#
# fluxbox startup\-script:
#
# Lines starting with a \'#\' 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\&.
#
# unclutter \-idle 2 &
# wmnd &
# 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\&.
exec fluxbox
# or if you want to keep a log:
# exec fluxbox \-log "$fluxdir/log"
.EB lightgray
.fi
.fam
.ps +1
.if n \{\
.RE
.\}
.sp
If you need to start applications after fluxbox, you can change the \fBexec fluxbox\fR line above to something like this:
.sp
.if n \{\
.RS 4
.\}
.fam C
.ps -1
.nf
.BB lightgray
exec fluxbox &
fbpid=$!
sleep 1
{
xsetroot \-cursor_name left_ptr \-fg white \-bg black &
ipager &
gkrellm2 &
} &
wait $fbpid
.EB lightgray
.fi
.fam
.ps +1
.if n \{\
.RE
.\}
.sp
So xsetroot, ipager, and gkrellm2 will all be started after fluxbox, after giving fluxbox 1 second to startup\&.
.sp
For more details on what else you can do in this script, see \fBsh(1p)\fR, or the documentation for your shell\&.
.SH "ONLINE DOCUMENTATION" .SH "ONLINE DOCUMENTATION"
.PP .PP
More extensive documentation for \fBstartfluxbox(1)\fR can be found at: More extensive documentation for \fBstartfluxbox(1)\fR can be found at:
@ -191,20 +264,9 @@ More extensive documentation for \fBstartfluxbox(1)\fR can be found at:
.RE .RE
.SH "AUTHORS" .SH "AUTHORS"
.sp .sp
The author of \fBstartfluxbox(1)\fR is Han Boetes <\m[blue]\fBhan@fluxbox\&.org\fR\m[]\&\s-2\u[1]\d\s+2> The author of \fBstartfluxbox(1)\fR is Han Boetes <han at fluxbox\&.org>
.sp .sp
This manpage was updated to asciidoc format by Jim Ramsay <\m[blue]\fBi\&.am@jimramsay\&.com\fR\m[]\&\s-2\u[2]\d\s+2> This manpage was converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2
.SH "SEE ALSO" .SH "SEE ALSO"
.sp .sp
fluxbox(1) fluxbox(1)
.SH "Notes"
.IP " 1." 4
han@fluxbox.org
.RS 4
\%mailto:han@fluxbox.org
.RE
.IP " 2." 4
i.am@jimramsay.com
.RS 4
\%mailto:i.am@jimramsay.com
.RE