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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
gExec
Version : 0.4
Author : Ferry Boender <f (DOT) boender (AT) electricmonk (DOT) nl> (please do not publish this email address)
License : General Public License
homepage : http://www.electricmonk.nl/index.php?page=GExec
gExec is a tool for running commands from a GUI. It presents the user with
an entry field into which they can type their command and some toggle
buttons for specifying how the command should be run. (I.e. in a terminal).
Table of contents
1. About gExec
2. Installation
2.1. Requirements
2.2. Compiling
2.3. Installation
2.4. Running
3. Configuration
4. Feedback / Contributing.
4.2. Known bugs
4.1. Credits
5. Legal stuff
6. Author
1. About gExec
gExec is a tool for running commands from a GUI. It presents the user with
an entry field into which they can type their command and some toggle
buttons for specifying how the command should be run. (I.e. in a terminal).
It features (normal, understandable, working) tab-completion, history list
and options for running commands in a terminal emulator and/or the root
user (via gksu).
gExec was created because I mainly use GTK programs, but I do not run
Gnome (or at least not the panel). Instead I use WindowMaker. WindowMaker
does have it's own run dialog, but it doesn't have tab-completion nor does
it have a history, which is quite annoying. There are a bunch of
third-party program lauchers available, but at the moment of writing none
of them do what I want. So came about gExec.
2. Installation
2.1. Requirements
In order to compile gExec, you will need:
* Gtk 2.0+ development headers
* Glib 2.0+ development headers
In order to run gExec, you will need:
* Gtk 2.0+ dynamically loadable libraries.
2.2. Compiling
Compiling gExec is easy. Just type 'make' at the command line in the
source directory.
2.3. Installation
gExec is composed of only a single binary. You can copy it to any
destination on your system. May I suggest some directory that is in your
path, like /usr/local/bin?
Typing 'make install' at the command line in the source directory will do
just that. It copies the binary to /usr/local/bin. That's it. Nothing more,
nothing less.
2.4. Running
From the --help output:
Usage:
gexec [OPTION...] - Interactive run dialog
Help Options:
-?, --help Show help options
--help-all Show all help options
--help-gtk Show GTK+ Options
Application Options:
-k, --keepopen Keep gExec open after executing a command
--display=DISPLAY X display to use
3. Configuration
gExec has a few configuration options which are stored in the file
$HOME/.gexec
This file will automically be created if not present the first time
gExec is run. It can contain three options:
cmd_termemu=STRING (default: xterm -e %s )
cmd_su=STRING (default: gksu "%s" )
history_max=INT (default: 20 )
These options should be self-evident. Including a %s in the command
will replace it with the command entered by the user in the program.
Please be careful about the construction of the commands for the
terminal emulator and the SU program. Not all programs will work
nicely together and some of the commands need to be carefully
crafted taking in account quotes and other stuff. Frankly, changing
any of these commands might open up a whole can of worms (which is
why there isn't a configuration display). Use at your own risk.
4. Feedback / Contributing.
Questions? Problems? Ideas?
Mail to: <f (DOT) boender (AT) electricmonk (DOT) nl>
or visit this gExec's project page, where you can submit bugs/feature
requests/questions, at:
http://projects.electricmonk.nl/
4.1. Known bugs
This program is full of known bugs. Here are some of them:
* Running a command in both a terminal and as root fails (depending
on the commands used).
* Usage of deprecated gtk_combo.
* Failure to execute a command via terminal or as root will go
unnoticed.
Most of these bugs have a reason for not being fixed (and not even
because I'm just a lazy bastard). Mostly the reason is that the
bugs don't really matter in such a small program, solving the
problem opens up new problems or the problem isn't gExec's in the
first place.
4.2. Credits
I'd like to thank the following people for their help on gExec:
* Me.
* Anonymous guy who was really Mafkees!
* Jose Oswaldo (--keepopen option suggestion)
* Corey Wringt (config file bugfixing patch)
* Johann Rudloff (Debian GNU/Linux package maintainer)
5. Legal stuff
gExec is Copyright by Ferry Boender, licensed under the General Public
License (GPL)
Copyright (C), 2004 by Ferry Boender
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
For more information, see the COPYING file supplied with this program.
6. Author
Exec created by:
Ferry Boender <f (DOT) boender (AT) electricmonk (DOT) nl> (Please do not publish this email address)
Homepage: http://www.electricmonk.nl
(for address information, please email me. I can't just put my home
address on the internet now, can I?)
|
