Manpage of gtkshell
Section: User Commands (1)
Return to Main Contents
gtkshell - invocation configurable GUI shell
is a GUI shell that is defined at its invocation through command line
arguments. It was developed as the primary interface to the GUI toolkit in
the AntiRight project, as part of ACE, the AntiRight Configuration
Environment. A user interface is defined at invocation and gtkshell handles
user input and program output. It is very useful
for providing a user interface for shell scripts.
is such a script, defining the AntiRight environment and its core logic.
A non option argument in its most basic form creats a button which launches
the command passed. The last word is used as a label. Use the underscore (_)
character to indicate whitespace in the label. If a non option argument is
followed immediately by a comma, the text immediately following the comma is an
image specification. This specification can be either an image file name or the
name of a gtk stock icon. The second format for non option
arguments is for menu button specification. A menu button will be created for
the first item if followed by '::'. Menu items take the same form as command
buttons, and they are separated by '::'.
- -acb command
Add a button with its command and label initialized by the execution of
- -acl command
Add a label with its text being the result of
- -ae file
Adds a text viewer widget, showing
in the text buffer.
- -al label
Adds a label with
as its text.
Adds a text area with contents derived from a pipe. The output of a command
piped into gtkshell with this option will be shown in a text area.
Add a separator.
- -as command
Adds a terminal widget running
Adds an empty text area.
Adds a text field. Text entered is passed as an argument of
If command is not specified and this is the last option specified,
is used as the default command. If you wish to use the
behavior while not having this as the last option, either pass the
command or specify option
exits on completion of text entry.
- -aul command
Adds an updating label.
is executed repeatedly, at a rate determined by the
option. The standard output of the command is displayed in a label.
- -aup command
Adds an updating progress bar. The command must output a floating point value
between 0 and 1.
Adds a new window. Widgets added after this option will be added to this
Displays an output dialog. Note:
exits after dialogs are closed.
Displays a color selection dialog. The selected color is printed to standard
Displays a directory creation dialog, based on the GTK file chooser. Once the
user enters a directory name and presses the OK button, the directory will be
created if it does not exist and the name of the directory will be printed to
standard output. This should be used for explicit directory creation
Displays a directory selection dialog. The functionality of this dialog is the
same as the directory creation dialog, except that it is missing the 'Create in folder' combo box. This should be used when you are pretty sure that a directory will already exist.
- -de message
Displays an error dialog, with
as its text.
Displays a font selection dialog. The selected font is in fontconfig format,
and is displayed to standard output.
Displays a standard file selection dialog. The selected file is displayed to
- -di message
Displays an information dialog, with
as its text.
Displays a file save dialog. The selected file is displayed to standard output.
This is appropriate for saving a file which is already open to a different name
or for saving a file not yet saved.
- -dw message
Displays a warning dialog with
as its text.
- -f file
Parses a file in the GUIDL format. If
, the input file will be a standard input pipe.
Do not use dummy argument
for GUIDL parsed input.
Make a text entry only print the text to standard output, rather than executing
Make command execution callbacks exit on activation. This includes buttons and
Do not use base frame.
Use framed labels.
- -og geometry
for primary application window.
Use vertical labels, with a vertical horizontal base for text direction.
Use expanded labels, which grow with window size changes.
Do not use expanded labels.
Use undecorated main window.
- -or number
rows in grid layout.
- -oT title
Set the window title to
- -otf font
Set the font to use with the terminal widget.
- -oth height
Set the height of the terminal widget.
- -ots size
Set the font size of the terminal widget.
Set the width of the terminal widget.
- -ou miliseconds
Specify refresh frequency of updater widgets.
gtkshell was written by Jeffrey Bedard <firstname.lastname@example.org>.
Report bugs to <email@example.com>
Copyright 2002-2007, Jeffrey E. Bedard
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
ACE (1) gshterm(1) system.antiright(5) X(7)
- REPORTING BUGS
- SEE ALSO
This document was created by
using the manual pages.
Time: 15:48:47 GMT, May 24, 2007