Moved fbrun(1) to asciidoc format

2 files changed, 95 insertions, 1 deletions

diff --git a/doc/asciidoc/Makefile b/doc/asciidoc/Makefile
index d69157a..70db7ef 100644
--- a/doc/asciidoc/Makefile
+++ b/doc/asciidoc/Makefile
@@ -2,7 +2,7 @@
 # create manpages from the asciidoc files
 #
 
-SRC1 = fluxbox.txt fluxbox-remote.txt
+SRC1 = fluxbox.txt fluxbox-remote.txt fbrun.txt
 SRC5 = fluxbox-keys.txt fluxbox-apps.txt fluxbox-style.txt fluxbox-menu.txt
 
 MAN = $(SRC1:.txt=.1.in) $(SRC5:.txt=.5.in)
diff --git a/doc/asciidoc/fbrun.txt b/doc/asciidoc/fbrun.txt
new file mode 100644
index 0000000..12342f7
--- /dev/null
+++ b/doc/asciidoc/fbrun.txt
@@ -0,0 +1,94 @@
+fbrun(1)
+==========
+Bastian Kleineidam <calvin@debian.org>
+v1.1.2, 18 February 2009
+:man source:   fbrun.txt
+:man version:  {revision}
+:man manual:   Fluxbox Manual  
+
+NAME
+----
+fbrun - display run dialog window
+
+SYNOPSIS
+--------
+*fbrun* ['options']
+
+DESCRIPTION
+-----------
+*fbrun(1)* is  basically equivalent to the ``Run...'' dialog in other desktop
+environments. This means that it is an easy way to start a program that isn't
+contained  in the menu (or needs a special set of parameters for this particular
+invocation).
+
+Pressing ``Enter'' will close the window and execute the command in your present
+*$SHELL*. Pressing ``Esc'' will close the window and does not execute anything.
+
+Another way fbrun can be useful is to be called from the  menu  with  a
+preloaded  command  line that you can edit and then execute. An example might be
+sshing to a very long host name with lots of options of  which one  changes  all
+the  time.  In this case, you could add an entry for fbrun to your menu that
+contains all the options  and  the  host  name.  When  you use said entry, you
+could edit the line as necessary and execute it.
+
+OPTIONS
+-------
+*-title* 'title'::
+        Set title
+
+*-text* 'text'::
+        Text input
+
+*-w* 'width'::
+        Window width in pixels
+
+*-h* 'height'::
+        Window height in pixels
+
+*-display* 'display'::
+        Display name, defaults to *$DISPLAY*
+
+*-pos* 'x' 'y'::
+        Window position in pixels
+
+*-nearmouse*::
+        Position the window under the mouse cursor
+
+*-fg* 'color'::
+        Foreground text color. The default is *black*
+
+*-bg* 'color'::
+        Background color. The default is *white*
+
+*-font* 'name'::
+        Text font name
+
+*-na*::
+        Disable font antialias
+
+*-hf* 'filename'::
+        History file to load. The default is *~/.fluxbox/fbrun_history*.
+
+*-help*::
+        Show this help
+
+EXAMPLE
+-------
+....
+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).
+
+- 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>.
+
+SEE ALSO
+--------
+fluxbox(1)