aboutsummaryrefslogtreecommitdiff
path: root/doc/asciidoc/fbrun.txt
blob: cc790f9def9329f4c0d267d112d8823fca5fb0ea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
fbrun(1)
========
Jim Ramsay <i.am@jimramsay.com>
v1.3.7, 08 February 2015
: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

*-center*::
	Position the window on the screen center

*-fg* 'color'::
	Foreground text color. The default is *black*

*-bg* 'color'::
	Background color. The default is *white*

*-font* 'name'::
	Text font name

*-hf* 'filename'::
	History file to load. The default is *~/.fluxbox/fbrun_history*.

*-cf* 'filename'::
    Completion data to load. The default is empty. If no data can be loaded,
    completion defaults to executables in $PATH

*-preselect*::
    Select the preset text given by the *-text* parameter

*-autocomplete*::
    Complete on typing. You can also set the FBRUN_AUTOCOMPLETE environment (to any value)

*-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

SEE ALSO
--------
fluxbox(1)