From f68ff84bd1fd579bf9940e7edd9777c54aee1d11 Mon Sep 17 00:00:00 2001 From: Jim Ramsay Date: Thu, 19 Feb 2009 09:29:05 -0500 Subject: Small edits for consistency --- doc/asciidoc/fbrun.txt | 16 ++++--- doc/asciidoc/fbsetbg.txt | 16 +++---- doc/asciidoc/fbsetroot.txt | 11 ++--- doc/asciidoc/fluxbox-apps.txt | 13 ++---- doc/asciidoc/fluxbox-keys.txt | 21 ++++------ doc/asciidoc/fluxbox-menu.txt | 15 +++---- doc/asciidoc/fluxbox-remote.txt | 9 ++-- doc/asciidoc/fluxbox-style.txt | 25 ++++++----- doc/asciidoc/fluxbox.txt | 31 +++++++------- doc/asciidoc/startfluxbox.txt | 57 +++++++++++++++++++++++-- doc/fbrun.1.in | 33 +-------------- doc/fbsetbg.1.in | 28 ++++--------- doc/fbsetroot.1.in | 31 +++++--------- doc/fluxbox-apps.5.in | 23 +++-------- doc/fluxbox-keys.5.in | 29 ++++--------- doc/fluxbox-menu.5.in | 25 +++-------- doc/fluxbox-remote.1.in | 11 +++-- doc/fluxbox-style.5.in | 42 ++++--------------- doc/fluxbox.1.in | 29 ++++++------- doc/startfluxbox.1.in | 92 ++++++++++++++++++++++++++++++++++------- 20 files changed, 274 insertions(+), 283 deletions(-) diff --git a/doc/asciidoc/fbrun.txt b/doc/asciidoc/fbrun.txt index 12342f7..fd27be8 100644 --- a/doc/asciidoc/fbrun.txt +++ b/doc/asciidoc/fbrun.txt @@ -1,6 +1,6 @@ fbrun(1) -========== -Bastian Kleineidam +======== +Jim Ramsay v1.1.2, 18 February 2009 :man source: fbrun.txt :man version: {revision} @@ -80,14 +80,12 @@ fbrun -fg black -bg white -text xterm -title "run xterm" AUTHORS ------- -- This manpage was originally written by Bastian Kleineidam for the Debian distribution of fluxbox (but may be used by - others). +This manpage was originally written by Bastian Kleineidam for the Debian distribution of fluxbox (but may be used by +others). -- It was then converted to asciidoc format by Jim Ramsay - for fluxbox-1.1.2 - -- The main author of fluxbox is Henrik Kinnunen . +It was then converted to asciidoc format by Jim Ramsay +for fluxbox-1.1.2 SEE ALSO -------- diff --git a/doc/asciidoc/fbsetbg.txt b/doc/asciidoc/fbsetbg.txt index 03626b2..6e91329 100644 --- a/doc/asciidoc/fbsetbg.txt +++ b/doc/asciidoc/fbsetbg.txt @@ -51,7 +51,8 @@ doesn't support this option fbsetbg falls back to *-f*). 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 @@ BUGS AUTHORS ------- -The author of fbsetbg is Han Boetes +The author of fbsetbg is Han Boetes -This manpage was updated to asciidoc format by Jim Ramsay +This manpage was converted to asciidoc format by Jim Ramsay for fluxbox-1.1.2 + +SEE ALSO +-------- +fluxbox(1) fbsetroot(1) diff --git a/doc/asciidoc/fbsetroot.txt b/doc/asciidoc/fbsetroot.txt index a41733d..74d5fa8 100644 --- a/doc/asciidoc/fbsetroot.txt +++ b/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 +This manpage was modified by Curt "Asenchi" Micol for the Fluxbox window manager. Further updates for fluxbox-1.1.2 and conversion to asciidoc format by Jim -Ramsay +Ramsay SEE ALSO -------- -fluxbox(1) fbsetbg(1) +fluxbox(1) fbsetbg(1) xsetroot(1) xmessage(1) gxmessage(1) diff --git a/doc/asciidoc/fluxbox-apps.txt b/doc/asciidoc/fluxbox-apps.txt index ca5c6de..c278962 100644 --- a/doc/asciidoc/fluxbox-apps.txt +++ b/doc/asciidoc/fluxbox-apps.txt @@ -1,7 +1,7 @@ fluxbox-apps(5) =============== Jim Ramsay -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 @@ file. [end] .................. -AUTHOR and CREDITS ------------------- -This manpage is the combined work of: - +AUTHORS +------- - Jim Ramsay (>fluxbox-1.0.0) - Curt Micol (>fluxbox-0.9.11) - Tobias Klausmann (<=fluxbox-0.9.11) @@ -264,9 +262,6 @@ This manpage is the combined work of: - Matthew Hawkins (blackbox) - Wilbert Berendsen (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) diff --git a/doc/asciidoc/fluxbox-keys.txt b/doc/asciidoc/fluxbox-keys.txt index 906324f..9edb22b 100644 --- a/doc/asciidoc/fluxbox-keys.txt +++ b/doc/asciidoc/fluxbox-keys.txt @@ -1,7 +1,7 @@ fluxbox-keys(5) =============== Jim Ramsay -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 @@ KEYS 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 @@ These commands ordinarily affect only the currently focused window. The 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 @@ Mod4 t :If {Some Matches (xterm)} {NextWindow (xterm)} {Exec xterm} 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 (>fluxbox-1.0.0) - Curt Micol (>fluxbox-0.9.11) - Tobias Klausmann (<=fluxbox-0.9.11) @@ -633,9 +631,6 @@ This manpage is the combined work of: - Matthew Hawkins (blackbox) - Wilbert Berendsen (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) diff --git a/doc/asciidoc/fluxbox-menu.txt b/doc/asciidoc/fluxbox-menu.txt index 0968202..69a4486 100644 --- a/doc/asciidoc/fluxbox-menu.txt +++ b/doc/asciidoc/fluxbox-menu.txt @@ -1,7 +1,7 @@ fluxbox-menu(5) =============== Jim Ramsay -v1.1.2, 12 February 2009 +v1.1.2, 18 February 2009 :man source: fluxbox-menu.txt :man version: {revision} :man manual: Fluxbox Manual @@ -326,20 +326,15 @@ EXAMPLES [end] .... -AUTHOR and CREDITS ------------------- -This manpage is the combined work of: - -- Jim Ramsay (>fluxbox-1.1.1) +AUTHORS +------- +- Jim Ramsay (>fluxbox-1.0.0) - Curt Micol (>fluxbox-0.9.11) - Tobias Klausmann (<=fluxbox-0.9.11) - Grubert (fluxbox) - Matthew Hawkins (blackbox) - Wilbert Berendsen (blackbox) -- Numerous other languages could be available if someone jumps in. - SEE ALSO -------- -fluxbox(1), xev(1), xkill(1), regex(7) - +fluxbox(1) fluxbox-keys(5) fluxbox-apps(5) xkill(1) iconv(1) diff --git a/doc/asciidoc/fluxbox-remote.txt b/doc/asciidoc/fluxbox-remote.txt index 1b13436..089b2d6 100644 --- a/doc/asciidoc/fluxbox-remote.txt +++ b/doc/asciidoc/fluxbox-remote.txt @@ -1,7 +1,7 @@ fluxbox-remote(1) ================= Mark Tiefenbruck -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 @@ ENVIRONMENT 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 + SEE ALSO -------- -fluxbox(1), fluxbox-keys(5), wmctrl(1) - +fluxbox(1) fluxbox-keys(5) wmctrl(1) diff --git a/doc/asciidoc/fluxbox-style.txt b/doc/asciidoc/fluxbox-style.txt index 71942b5..02838fb 100644 --- a/doc/asciidoc/fluxbox-style.txt +++ b/doc/asciidoc/fluxbox-style.txt @@ -1,7 +1,7 @@ fluxbox-style(5) ================ Henrik Kinnunen -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 |mod|none background.pixmap: @@ -472,25 +472,24 @@ These are the color formats for styles: See /usr/share/X11/rgb.txt for an explaination. -AUTHOR and CREDITS ------------------- -Blackbox was written and maintained by Brad Hughes -and Jeff Raven . +AUTHORS +------- +Blackbox was written and maintained by Brad Hughes +and Jeff Raven . -fluxbox(1) is written and maintained by Henrik Kinnunen +fluxbox(1) is written and maintained by Henrik Kinnunen 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: and using the great contributions of -. Numerous other languages could be available +contact him here: and using the great contributions of +. Numerous other languages could be available if someone jumps in. SEE ALSO -------- fluxbox(1) fbsetbg(1) fbsetroot(1) - diff --git a/doc/asciidoc/fluxbox.txt b/doc/asciidoc/fluxbox.txt index 189d3f5..40e6090 100644 --- a/doc/asciidoc/fluxbox.txt +++ b/doc/asciidoc/fluxbox.txt @@ -1,7 +1,7 @@ fluxbox(1) ========== Henrik Kinnunen -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 @@ OPTIONS 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 @@ slit. The file is generally located at *\~/.fluxbox/slitlist*. 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 @@ fluxbox responds to the following signals: - SIGUSR1 Forces reloading of configuration. - SIGUSR2 Forces reloading of menu file. -AUTHOR and CREDITS ------------------- +AUTHORS +------- fluxbox is written and maintained by Henrik Kinnunen , Simon Bowden , Mathias Gumz , and Mark Tiefenbruck , with contributions and patches merged @@ -1165,15 +1165,9 @@ from many individuals around the world. Blackbox was written and maintained by Brad Hughes and Jeff Raven . -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 (>fluxbox-1.1.1) +- Jim Ramsay (>fluxbox-1.0.0) - Curt Micol (>fluxbox-0.9.11) - Tobias Klausmann (<=fluxbox-0.9.11) - Grubert (fluxbox) @@ -1182,6 +1176,14 @@ This manpage is the combined work of: - 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 @@ mailinglists. More information can be found on the official website. 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) diff --git a/doc/asciidoc/startfluxbox.txt b/doc/asciidoc/startfluxbox.txt index 5a43ca1..0042ed3 100644 --- a/doc/asciidoc/startfluxbox.txt +++ b/doc/asciidoc/startfluxbox.txt @@ -24,11 +24,61 @@ doesn't exist it will be generated. 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 +The author of *startfluxbox(1)* is Han Boetes -This manpage was updated to asciidoc format by Jim Ramsay +This manpage was converted to asciidoc format by Jim Ramsay for fluxbox-1.1.2 SEE ALSO -------- diff --git a/doc/fbrun.1.in b/doc/fbrun.1.in index 09a6107..c44c551 100644 --- a/doc/fbrun.1.in +++ b/doc/fbrun.1.in @@ -1,12 +1,12 @@ .\" Title: fbrun .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 -.\" 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 @@ fbrun \-fg black \-bg white \-text xterm \-title "run xterm" .\} .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 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 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 \&. -.RE .SH "SEE ALSO" .sp fluxbox(1) diff --git a/doc/fbsetbg.1.in b/doc/fbsetbg.1.in index 45505a8..acd66e0 100644 --- a/doc/fbsetbg.1.in +++ b/doc/fbsetbg.1.in @@ -1,12 +1,12 @@ .\" Title: fbsetbg .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 -.\" 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 @@ Use specified wallpapersetter, use no argument to forget\&. .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 @@ $ DISPLAY=:0\&.0 fbsetbg \-l .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 @@ Much more extensive documentation for \fBfbsetbg(1)\fR is provided on: \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 .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 for fluxbox\-1\&.1\&.2 +.SH "SEE ALSO" +.sp +fluxbox(1) fbsetroot(1) diff --git a/doc/fbsetroot.1.in b/doc/fbsetroot.1.in index ddef0d7..a39a586 100644 --- a/doc/fbsetroot.1.in +++ b/doc/fbsetroot.1.in @@ -1,12 +1,12 @@ .\" Title: fbsetroot .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 -.\" 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 @@ 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 @@ 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\&. .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 -.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\&. +This manpage was modified by Curt "Asenchi" Micol 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 .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) diff --git a/doc/fluxbox-apps.5.in b/doc/fluxbox-apps.5.in index 89b5a10..03f7fdc 100644 --- a/doc/fluxbox-apps.5.in +++ b/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 -.\" 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 @@ Here are some interesting and/or useful examples you can do with your apps file\ .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 @@ Matthew Hawkins (blackbox) .\} Wilbert Berendsen (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) diff --git a/doc/fluxbox-keys.5.in b/doc/fluxbox-keys.5.in index 75d26e1..24242d0 100644 --- a/doc/fluxbox-keys.5.in +++ b/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 -.\" 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 @@ To combine two or more modifiers, just list them (space\-delimited) in any order .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 @@ Close the current window, equivalent to the window button\&. .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 @@ ChangeWorkspace :Exec fbsetbg ~/\&.fluxbox/bg$(xprop \-root _NET_CURRENT_DESKTOP .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 @@ Matthew Hawkins (blackbox) .\} Wilbert Berendsen (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) diff --git a/doc/fluxbox-menu.5.in b/doc/fluxbox-menu.5.in index ec3d3fd..158d437 100644 --- a/doc/fluxbox-menu.5.in +++ b/doc/fluxbox-menu.5.in @@ -1,12 +1,12 @@ .\" 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 -.\" Date: 02/17/2009 +.\" Date: 02/19/2009 .\" Manual: Fluxbox Manual .\" Source: fluxbox-menu.txt 1.1.2 .\" 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 .\" ----------------------------------------------------------------- @@ -595,9 +595,7 @@ The \fIcomand\&...\fR field of the \fB[exec]\fR tag can take advantage of other .if n \{\ .RE .\} -.SH "AUTHOR and CREDITS" -.sp -This manpage is the combined work of: +.SH "AUTHORS" .sp .RS 4 .ie n \{\ @@ -607,7 +605,7 @@ This manpage is the combined work of: .sp -1 .IP \(bu 2.3 .\} -Jim Ramsay (>fluxbox\-1\&.1\&.1) +Jim Ramsay (>fluxbox\-1\&.0\&.0) .RE .sp .RS 4 @@ -664,17 +662,6 @@ Matthew Hawkins (blackbox) .\} Wilbert Berendsen (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) fluxbox\-keys(5) fluxbox\-apps(5) xkill(1) iconv(1) diff --git a/doc/fluxbox-remote.1.in b/doc/fluxbox-remote.1.in index c1ee9f5..2ee5532 100644 --- a/doc/fluxbox-remote.1.in +++ b/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 -.\" 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 @@ first\&. .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 .SH "SEE ALSO" .sp -fluxbox(1), fluxbox\-keys(5), wmctrl(1) +fluxbox(1) fluxbox\-keys(5) wmctrl(1) diff --git a/doc/fluxbox-style.5.in b/doc/fluxbox-style.5.in index a580a73..62a82e6 100644 --- a/doc/fluxbox-style.5.in +++ b/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 -.\" 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 @@ menu\&.unselected\&.pixmap: .\} .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 @@ rgb:<0\-255>/<0\-255>/<0\-255> .\} .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 and Jeff Raven \&. .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 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: and using the great contributions of \&. 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 diff --git a/doc/fluxbox.1.in b/doc/fluxbox.1.in index 4689bdf..da9d0e0 100644 --- a/doc/fluxbox.1.in +++ b/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 -.\" 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 @@ This submenu lets you reorder the the applications running in the slit\&. You ar .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 @@ SIGUSR1 Forces reloading of configuration\&. .\} SIGUSR2 Forces reloading of menu file\&. .RE -.SH "AUTHOR and CREDITS" +.SH "AUTHORS" .sp fluxbox is written and maintained by Henrik Kinnunen , Simon Bowden , Mathias Gumz , and Mark Tiefenbruck , with contributions and patches merged from many individuals around the world\&. .sp Blackbox was written and maintained by Brad Hughes and Jeff Raven \&. .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 @@ This manpage is the combined work of: .sp -1 .IP \(bu 2.3 .\} -Jim Ramsay (>fluxbox\-1\&.1\&.1) +Jim Ramsay (>fluxbox\-1\&.0\&.0) .RE .sp .RS 4 @@ -2019,9 +2013,16 @@ Wilbert Berendsen (blackbox) .\} 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) diff --git a/doc/startfluxbox.1.in b/doc/startfluxbox.1.in index 8ae2564..478af47 100644 --- a/doc/startfluxbox.1.in +++ b/doc/startfluxbox.1.in @@ -1,12 +1,12 @@ .\" Title: startfluxbox .\" Author: [see the "AUTHORS" section] .\" Generator: DocBook XSL Stylesheets v1.74.0 -.\" 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 @@ startfluxbox \- start a fluxbox session .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 @@ More extensive documentation for \fBstartfluxbox(1)\fR can be found at: .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 .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 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 -- cgit v0.11.2