Small edits for consistency
Jim Ramsay i.am@jimramsay.com
20 files changed,
274 insertions(+),
283 deletions(-)
jump to
M
doc/asciidoc/fbrun.txt
→
doc/asciidoc/fbrun.txt
@@ -1,6 +1,6 @@
fbrun(1) -========== -Bastian Kleineidam <calvin@debian.org> +======== +Jim Ramsay <i.am@jimramsay.com> v1.1.2, 18 February 2009 :man source: fbrun.txt :man version: {revision}@@ -80,14 +80,12 @@ ....
AUTHORS ------- -- This manpage was originally written by Bastian Kleineidam <calvin at - debian.org> for the Debian distribution of fluxbox (but may be used by - others). - -- It was then converted to asciidoc format by Jim Ramsay <i.am at jimramsay.com> - for fluxbox-1.1.2 +This manpage was originally written by Bastian Kleineidam <calvin at +debian.org> for the Debian distribution of fluxbox (but may be used by +others). -- The main author of fluxbox is Henrik Kinnunen <fluxgen at fluxbox.org>. +It was then converted to asciidoc format by Jim Ramsay <i.am at jimramsay.com> +for fluxbox-1.1.2 SEE ALSO --------
M
doc/asciidoc/fbsetbg.txt
→
doc/asciidoc/fbsetbg.txt
@@ -51,7 +51,8 @@ *-u* 'wallpapersetter'::
Use specified wallpapersetter, use no argument to forget. *-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':: 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 -SEE ALSO --------- -fluxbox(1), fbsetroot(1) - ONLINE DOCUMENTATION -------------------- Much more extensive documentation for *fbsetbg(1)* is provided on:::@@ -112,6 +109,11 @@ *fbsetbg(1)* is not foolproof.
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 converted to asciidoc format by Jim Ramsay <i.am at +jimramsay.com> for fluxbox-1.1.2 -This manpage was updated to asciidoc format by Jim Ramsay <i.am@jimramsay.com> +SEE ALSO +-------- +fluxbox(1) fbsetroot(1)
M
doc/asciidoc/fbsetroot.txt
→
doc/asciidoc/fbsetroot.txt
@@ -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 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 ------- 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 ------- -fbsetroot is written and maintained by the Fluxbox Development Team - -This manpage was modified by Curt "Asenchi" Micol <asenchi@asenchi.com> +This manpage was modified by Curt "Asenchi" Micol <asenchi at asenchi.com> for the Fluxbox window manager. 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 -------- -fluxbox(1) fbsetbg(1) +fluxbox(1) fbsetbg(1) xsetroot(1) xmessage(1) gxmessage(1)
M
doc/asciidoc/fluxbox-apps.txt
→
doc/asciidoc/fluxbox-apps.txt
@@ -1,7 +1,7 @@
fluxbox-apps(5) =============== Jim Ramsay <i.am@jimramsay.com> -v1.1.2, 10 February 2009 +v1.1.2, 18 February 2009 :man source: fluxbox-apps.txt :man version: {revision} :man manual: Fluxbox Manual@@ -253,10 +253,8 @@ [Layer] {4}
[end] .................. -AUTHOR and CREDITS ------------------- -This manpage is the combined work of: - +AUTHORS +------- - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0) - Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11)@@ -264,9 +262,6 @@ - Grubert <grubert at users sourceforge net> (fluxbox)
- Matthew Hawkins <matt at mh dropbear id au> (blackbox) - Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) -- Numerous other languages could be available if someone jumps in. - SEE ALSO -------- -fluxbox(1), xev(1), xkill(1), regex(7) - +fluxbox(1) xprop(1) regex(7)
M
doc/asciidoc/fluxbox-keys.txt
→
doc/asciidoc/fluxbox-keys.txt
@@ -1,7 +1,7 @@
fluxbox-keys(5) =============== Jim Ramsay <i.am@jimramsay.com> -v1.1.2, 10 February 2009 +v1.1.2, 18 February 2009 :man source: fluxbox-keys.txt :man version: {revision} :man manual: Fluxbox Manual@@ -79,15 +79,15 @@ ----
You may specify a key by its key name (for example, *a* or *space*) or by its 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 -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. 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, *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. ////////////////@@ -199,7 +199,7 @@ *Close*::
Close the current window, equivalent to the window button. *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*:: Toggle the *shaded* state of the current window, equivalent to the@@ -622,10 +622,8 @@ # Set a different wallpaper on every workspace:
ChangeWorkspace :Exec fbsetbg ~/.fluxbox/bg$(xprop -root _NET_CURRENT_DESKTOP | awk '{print $3}').png .................. -AUTHOR and CREDITS ------------------- -This manpage is the combined work of: - +AUTHORS +------- - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0) - Curt Micol <asenchi at asenchi com> (>fluxbox-0.9.11) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11)@@ -633,9 +631,6 @@ - Grubert <grubert at users sourceforge net> (fluxbox)
- Matthew Hawkins <matt at mh dropbear id au> (blackbox) - Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) -- Numerous other languages could be available if someone jumps in. - SEE ALSO -------- -fluxbox(1), xev(1), xkill(1), regex(7) - +fluxbox(1) xprop(1) xev(1) xkill(1) regex(7)
M
doc/asciidoc/fluxbox-remote.txt
→
doc/asciidoc/fluxbox-remote.txt
@@ -1,7 +1,7 @@
fluxbox-remote(1) ================= Mark Tiefenbruck <mark@fluxbox.org> -v1.1.2, 10 February 2009 +v1.1.2, 18 February 2009 :man source: fluxbox-remote.txt :man version: {revision} :man manual: Fluxbox Manual@@ -37,7 +37,10 @@ -----------
In order to communicate with 'fluxbox(1)', the DISPLAY environment variable must be set properly. Usually, the value should be `:0.0'. +AUTHORS +------- +This man page written by Mark Tiefenbruck <mark at fluxbox.org> + SEE ALSO -------- -fluxbox(1), fluxbox-keys(5), wmctrl(1) - +fluxbox(1) fluxbox-keys(5) wmctrl(1)
M
doc/asciidoc/fluxbox-style.txt
→
doc/asciidoc/fluxbox-style.txt
@@ -1,7 +1,7 @@
fluxbox-style(5) ================ Henrik Kinnunen <fluxgen@fluxbox.org> -v1.1.2, 10 February 2009 +v1.1.2, 18 February 2009 :man source: fluxbox-style.txt :man version: {revision} :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' 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', +*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. +*fbsetroot(1)* to set the background. background: centered|aspect|tiled|fullscreen|random|solid|gradient <texture>|mod|none background.pixmap: <file or directory>@@ -472,25 +472,24 @@ rgb:<0-255>/<0-255>/<0-255>
See /usr/share/X11/rgb.txt for an explaination. -AUTHOR and CREDITS ------------------- -Blackbox was written and maintained by Brad Hughes <blackbox@alug.org> -and Jeff Raven <jraven@psu.edu>. +AUTHORS +------- +Blackbox was written and maintained by Brad Hughes <blackbox at alug.org> +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. -The Official fluxbox(1) website: http://www.fluxbox.org[] -You can find a lot of styles here: http://tenr.de/[] +The Official fluxbox(1) website: http://www.fluxbox.org +You can find a lot of styles here: http://tenr.de/ 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@asenchi.com> and using the great contributions of -<grubert@users.sourceforge.net>. Numerous other languages could be available +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. SEE ALSO -------- fluxbox(1) fbsetbg(1) fbsetroot(1) -
M
doc/asciidoc/fluxbox.txt
→
doc/asciidoc/fluxbox.txt
@@ -1,7 +1,7 @@
fluxbox(1) ========== Henrik Kinnunen <fluxgen@fluxbox.org> -v1.1.2, 10 February 2009 +v1.1.2, 18 February 2009 :man source: fluxbox.txt :man version: {revision} :man manual: Fluxbox Manual@@ -88,12 +88,12 @@ Lists all available internal commands.
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 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 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, 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@@ -815,7 +815,7 @@
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 +3. Add dockapps to your *startfluxbox(1)* script This sequence will be saved by default to *\~/.fluxbox/slitlist* and will be remembered for future instances of fluxbox.@@ -1155,8 +1155,8 @@ - SIGHUP fluxbox loads the configuration.
- SIGUSR1 Forces reloading of configuration. - SIGUSR2 Forces reloading of menu file. -AUTHOR and CREDITS ------------------- +AUTHORS +------- 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@@ -1165,15 +1165,9 @@
Blackbox was written and maintained by Brad Hughes <blackbox at alug org> and 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: -- 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) - Tobias Klausmann <klausman at users sourceforge net> (<=fluxbox-0.9.11) - Grubert <grubert at users sourceforge net> (fluxbox)@@ -1182,6 +1176,14 @@ - Wilbert Berendsen <wbsoft at xs4all nl> (blackbox)
- 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 ---- If you find any bugs, please visit the #fluxbox irc channel on@@ -1192,5 +1194,4 @@
SEE ALSO -------- 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)
M
doc/asciidoc/startfluxbox.txt
→
doc/asciidoc/startfluxbox.txt
@@ -24,11 +24,61 @@ *\~/.xsession* if you run a display manager, like xdm.
FILES ----- -*~/.fluxbox/startup*:: +*\~/.fluxbox/startup*:: 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. +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 -------------------- More extensive documentation for *startfluxbox(1)* can be found at:::@@ -36,9 +86,10 @@ http://www.xs4all.nl/~hanb/software/fluxbox/startfluxbox.html
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 --------
M
doc/fbrun.1.in
→
doc/fbrun.1.in
@@ -1,12 +1,12 @@
.\" Title: fbrun .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> -.\" Date: 02/18/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fbrun.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -267,38 +267,9 @@ .RE
.\} .SH "AUTHORS" .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)\&. -.RE .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 -.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" .sp fluxbox(1)
M
doc/fbsetbg.1.in
→
doc/fbsetbg.1.in
@@ -1,12 +1,12 @@
.\" Title: fbsetbg .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> -.\" Date: 02/18/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fbsetbg.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -214,7 +214,8 @@ .RE
.PP \fB\-b\fR \fIfbsetrootoptions\fR .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 .PP \fB\-r\fR \fIdirectory\fR@@ -302,9 +303,6 @@ .ps +1
.if n \{\ .RE .\} -.SH "SEE ALSO" -.sp -fluxbox(1), fbsetroot(1) .SH "ONLINE DOCUMENTATION" .PP Much more extensive documentation for \fBfbsetbg(1)\fR is provided on:@@ -317,17 +315,9 @@ .sp
\fBfbsetbg(1)\fR is not foolproof\&. .SH "AUTHORS" .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 -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> -.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 +This manpage was converted to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> for fluxbox\-1\&.1\&.2 +.SH "SEE ALSO" +.sp +fluxbox(1) fbsetroot(1)
M
doc/fbsetroot.1.in
→
doc/fbsetroot.1.in
@@ -1,12 +1,12 @@
.\" Title: fbsetroot .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> -.\" Date: 02/18/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fbsetroot.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -170,11 +170,11 @@ .SH "Name"
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" .sp -\fBfbsetroot\fR [\-display \fIdisplay\fR ] \-solid \fIcolor\fR +\fBfbsetroot\fR [\-display \fIdisplay\fR] \-solid \fIcolor\fR .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 -\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 \fBfbsetroot\fR \-help .SH "DESCRIPTION"@@ -182,6 +182,8 @@ .sp
\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 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" .sp 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 .SH "AUTHORS" .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 -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\&. -.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> +Further updates for fluxbox\-1\&.1\&.2 and conversion to asciidoc format by Jim Ramsay <i\&.am at jimramsay\&.com> .SH "SEE ALSO" .sp -fluxbox(1) fbsetbg(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 +fluxbox(1) fbsetbg(1) xsetroot(1) xmessage(1) gxmessage(1)
M
doc/fluxbox-apps.5.in
→
doc/fluxbox-apps.5.in
@@ -1,12 +1,12 @@
.\" 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/> -.\" Date: 02/17/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox-apps.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -676,9 +676,7 @@ .ps +1
.if n \{\ .RE .\} -.SH "AUTHOR and CREDITS" -.sp -This manpage is the combined work of: +.SH "AUTHORS" .sp .RS 4 .ie n \{\@@ -745,17 +743,6 @@ .IP \(bu 2.3
.\} Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) .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" .sp -fluxbox(1), xev(1), xkill(1), regex(7) +fluxbox(1) xprop(1) regex(7)
M
doc/fluxbox-keys.5.in
→
doc/fluxbox-keys.5.in
@@ -1,12 +1,12 @@
.\" 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/> -.\" Date: 02/17/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox-keys.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -236,9 +236,9 @@ .SH "KEYS"
.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)\&. .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 -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" .sp Key bindings can be chained in a fashion similar to Emacs key bindings using the syntax:@@ -434,7 +434,7 @@ \fBKill\fR | \fBKillWindow\fR
.RS 4 Close a window that\'s not responding to \fBClose\fR, like using -\FCxkill\F[]\&. +\fBxkill(1)\fR\&. .RE .PP \fBShade\fR | \fBShadeWindow\fR@@ -1313,9 +1313,7 @@ .ps +1
.if n \{\ .RE .\} -.SH "AUTHOR and CREDITS" -.sp -This manpage is the combined work of: +.SH "AUTHORS" .sp .RS 4 .ie n \{\@@ -1382,17 +1380,6 @@ .IP \(bu 2.3
.\} Wilbert Berendsen <wbsoft at xs4all nl> (blackbox) .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" .sp -fluxbox(1), xev(1), xkill(1), regex(7) +fluxbox(1) xprop(1) xev(1) xkill(1) regex(7)
M
doc/fluxbox-remote.1.in
→
doc/fluxbox-remote.1.in
@@ -1,12 +1,12 @@
.\" 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/> -.\" Date: 02/17/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox-remote.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -190,6 +190,9 @@ .RE
.SH "ENVIRONMENT" .sp 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" .sp -fluxbox(1), fluxbox\-keys(5), wmctrl(1) +fluxbox(1) fluxbox\-keys(5) wmctrl(1)
M
doc/fluxbox-style.5.in
→
doc/fluxbox-style.5.in
@@ -1,12 +1,12 @@
.\" 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/> -.\" Date: 02/17/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox-style.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -611,7 +611,7 @@ .RE
.\} .SH "BACKGROUND" .sp -Every style must specify the background option\&. If you don\'t want your style to change the user\'s background, then use `background: none\'\&. The options `centered\', `aspect\', `tiled\', and `fullscreen\' require the `background\&.pixmap\' resource to contain a valid file name\&. The `random\' option requires `background\&.pixmap\' to contain a valid directory name\&. For these options, 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 .if n \{\ .RS 4@@ -783,41 +783,15 @@ .RE
.\} .sp See /usr/share/X11/rgb\&.txt for an explaination\&. -.SH "AUTHOR and CREDITS" +.SH "AUTHORS" .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 -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 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 -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" .sp 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
M
doc/fluxbox.1.in
→
doc/fluxbox.1.in
@@ -1,12 +1,12 @@
.\" 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/> -.\" Date: 02/17/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -242,7 +242,7 @@ Lists all available internal commands\&.
.RE .SH "STARTING FLUXBOX" .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 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@@ -1519,7 +1519,7 @@ .SS "Slitlist File"
.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\&. .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 This sequence will be saved by default to \fB~/\&.fluxbox/slitlist\fR and will be remembered for future instances of fluxbox\&. .sp@@ -1929,18 +1929,12 @@ .IP \(bu 2.3
.\} SIGUSR2 Forces reloading of menu file\&. .RE -.SH "AUTHOR and CREDITS" +.SH "AUTHORS" .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\&. .sp Blackbox was written and maintained by Brad Hughes <blackbox at alug org> and Jeff Raven <jraven at psu edu>\&. .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: .sp .RS 4@@ -1951,7 +1945,7 @@ .el \{\
.sp -1 .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 .sp .RS 4@@ -2019,9 +2013,16 @@ .IP \(bu 2.3
.\} Numerous other languages could be available if someone jumps in\&. .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" .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\&. .SH "SEE ALSO" .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)
M
doc/startfluxbox.1.in
→
doc/startfluxbox.1.in
@@ -1,12 +1,12 @@
.\" Title: startfluxbox .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/> -.\" Date: 02/18/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: startfluxbox.txt 1.1.2 .\" 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 .\" -----------------------------------------------------------------@@ -182,6 +182,79 @@ \fB~/\&.fluxbox/startup\fR
.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\&. .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" .PP More extensive documentation for \fBstartfluxbox(1)\fR can be found at:@@ -191,20 +264,9 @@ \m[blue]\fBhttp://www\&.xs4all\&.nl/~hanb/software/fluxbox/startfluxbox\&.html\fR\m[]
.RE .SH "AUTHORS" .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 -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" .sp 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