1 files changed, 96 insertions, 0 deletions

diff --git a/doc/asciidoc/startfluxbox.txt b/doc/asciidoc/startfluxbox.txt
new file mode 100644
index 0000000..0042ed3
--- /dev/null
+++ b/doc/asciidoc/startfluxbox.txt
@@ -0,0 +1,96 @@
+startfluxbox(1)
+===============
+Jim Ramsay <i.am@jimramsay.com>
+v1.1.2, 18 February 2009
+:man source:   startfluxbox.txt
+:man version:  {revision}
+:man manual:   Fluxbox Manual  
+
+NAME
+----
+startfluxbox - start a fluxbox session
+
+SYNOPSIS
+--------
+*startfluxbox*
+
+DESCRIPTION
+-----------
+*startfluxbox* is a script which runs the file *\~/.fluxbox/startup* If it
+doesn't exist it will be generated.
+
+*startfluxbox* should be started from your *\~/.xinitrc* if you use startx, or
+*\~/.xsession* if you run a display manager, like xdm.
+
+FILES
+-----
+*\~/.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:::
+http://www.xs4all.nl/~hanb/software/fluxbox/startfluxbox.html
+
+AUTHORS
+-------
+The author of *startfluxbox(1)* 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
+
+SEE ALSO
+--------
+fluxbox(1)