From f68ff84bd1fd579bf9940e7edd9777c54aee1d11 Mon Sep 17 00:00:00 2001
From: Jim Ramsay <i.am@jimramsay.com>
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 <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 @@ fbrun -fg black -bg white -text xterm -title "run xterm"
 
 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).
+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
-
-- 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
 --------
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 <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)
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 <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)
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 <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 @@ file.
 [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 @@ This manpage is the combined work of:
 - 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)
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 <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 @@ 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 <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 @@ This manpage is the combined work of:
 - 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)
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 <i.am@jimramsay.com>
-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 <i.am at jimramsay com> (>fluxbox-1.1.1)
+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)
 - 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) 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 <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 @@ 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 <mark at fluxbox.org>
+
 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 <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 @@ 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 <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)
-
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 <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 @@ 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 <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 @@ from many individuals around the world.
 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 @@ 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 <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
 --------
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 <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 @@ 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 <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)
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 <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 @@ 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 <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)
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 <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 @@
 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 <asenchi at asenchi\&.com> 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)
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 <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 @@ 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 <matt at mh dropbear id au> (blackbox)
 .\}
 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)
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 <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 @@ 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 <matt at mh dropbear id au> (blackbox)
 .\}
 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)
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 <http://docbook.sf.net/>
-.\"      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 <i\&.am at jimramsay com> (>fluxbox\-1\&.1\&.1)
+Jim Ramsay <i\&.am at jimramsay com> (>fluxbox\-1\&.0\&.0)
 .RE
 .sp
 .RS 4
@@ -664,17 +662,6 @@ Matthew Hawkins <matt at mh dropbear id au> (blackbox)
 .\}
 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) 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 <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 @@ 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 <mark at fluxbox\&.org>
 .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 <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 @@ menu\&.unselected\&.pixmap:         <filename>
 .\}
 .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 <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
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 <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 @@ 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 <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 @@ This manpage is the combined work of:
 .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 @@ Wilbert Berendsen <wbsoft at xs4all nl> (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 <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 @@ 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 <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
-- 
cgit v0.11.2