aboutsummaryrefslogtreecommitdiff
path: root/doc/asciidoc
diff options
context:
space:
mode:
Diffstat (limited to 'doc/asciidoc')
-rw-r--r--doc/asciidoc/Makefile2
-rw-r--r--doc/asciidoc/fbrun.txt94
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 @@
2# create manpages from the asciidoc files 2# create manpages from the asciidoc files
3# 3#
4 4
5SRC1 = fluxbox.txt fluxbox-remote.txt 5SRC1 = fluxbox.txt fluxbox-remote.txt fbrun.txt
6SRC5 = fluxbox-keys.txt fluxbox-apps.txt fluxbox-style.txt fluxbox-menu.txt 6SRC5 = fluxbox-keys.txt fluxbox-apps.txt fluxbox-style.txt fluxbox-menu.txt
7 7
8MAN = $(SRC1:.txt=.1.in) $(SRC5:.txt=.5.in) 8MAN = $(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 @@
1fbrun(1)
2==========
3Bastian Kleineidam <calvin@debian.org>
4v1.1.2, 18 February 2009
5:man source: fbrun.txt
6:man version: {revision}
7:man manual: Fluxbox Manual
8
9NAME
10----
11fbrun - display run dialog window
12
13SYNOPSIS
14--------
15*fbrun* ['options']
16
17DESCRIPTION
18-----------
19*fbrun(1)* is basically equivalent to the ``Run...'' dialog in other desktop
20environments. This means that it is an easy way to start a program that isn't
21contained in the menu (or needs a special set of parameters for this particular
22invocation).
23
24Pressing ``Enter'' will close the window and execute the command in your present
25*$SHELL*. Pressing ``Esc'' will close the window and does not execute anything.
26
27Another way fbrun can be useful is to be called from the menu with a
28preloaded command line that you can edit and then execute. An example might be
29sshing to a very long host name with lots of options of which one changes all
30the time. In this case, you could add an entry for fbrun to your menu that
31contains all the options and the host name. When you use said entry, you
32could edit the line as necessary and execute it.
33
34OPTIONS
35-------
36*-title* 'title'::
37 Set title
38
39*-text* 'text'::
40 Text input
41
42*-w* 'width'::
43 Window width in pixels
44
45*-h* 'height'::
46 Window height in pixels
47
48*-display* 'display'::
49 Display name, defaults to *$DISPLAY*
50
51*-pos* 'x' 'y'::
52 Window position in pixels
53
54*-nearmouse*::
55 Position the window under the mouse cursor
56
57*-fg* 'color'::
58 Foreground text color. The default is *black*
59
60*-bg* 'color'::
61 Background color. The default is *white*
62
63*-font* 'name'::
64 Text font name
65
66*-na*::
67 Disable font antialias
68
69*-hf* 'filename'::
70 History file to load. The default is *~/.fluxbox/fbrun_history*.
71
72*-help*::
73 Show this help
74
75EXAMPLE
76-------
77....
78fbrun -fg black -bg white -text xterm -title "run xterm"
79....
80
81AUTHORS
82-------
83- This manpage was originally written by Bastian Kleineidam <calvin at
84 debian.org> for the Debian distribution of fluxbox (but may be used by
85 others).
86
87- It was then converted to asciidoc format by Jim Ramsay <i.am at jimramsay.com>
88 for fluxbox-1.1.2
89
90- The main author of fluxbox is Henrik Kinnunen <fluxgen at fluxbox.org>.
91
92SEE ALSO
93--------
94fluxbox(1)