Content-type: text/html
Manpage of gtkshell
gtkshell
Section: User Commands (1)
Index
Return to Main Contents
NAME
gtkshell - invocation configurable GUI shell
SYNOPSIS
gtkshell
[[-a[[c[bl]
command
][e
file
][l
label
]PS[s
command
]T[t
command
]u[[l
command
][p
command
]]]] [-d[acDd[e
message
]Ff[i
message
]s[w
message
]]] [-f
file
] [-o[DEeFfghLln[r
rows
][T
title
][t[[w
width
][h
height
][f
font
][s
size
]]][u
miliseconds
]]]] [
command
] [
command
[,
image
][::
command
[,
image
][...]]] [...]
DESCRIPTION
gtkshell
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.
ACE
is such a script, defining the AntiRight environment and its core logic.
OPTIONS
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
command.
- -acl command
-
Add a label with its text being the result of
command.
- -ae file
-
Adds a text viewer widget, showing
file
in the text buffer.
- -al label
-
Adds a label with
label
as its text.
- -aP
-
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.
- -aS
-
Add a separator.
- -as command
-
Adds a terminal widget running
command.
- -aT
-
Adds an empty text area.
-at [command]
Adds a text field. Text entered is passed as an argument of
command.
If command is not specified and this is the last option specified,
echo
is used as the default command. If you wish to use the
echo
behavior while not having this as the last option, either pass the
echo
command or specify option
-oE.
If option
-oe
is passed,
gtkshell
exits on completion of text entry.
- -aul command
-
Adds an updating label.
command
is executed repeatedly, at a rate determined by the
-ou
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.
- -aw
-
Adds a new window. Widgets added after this option will be added to this
window.
- -da
-
Displays an output dialog. Note:
gtkshell
exits after dialogs are closed.
- -dc
-
Displays a color selection dialog. The selected color is printed to standard
output.
- -dD
-
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
operations.
- -dd
-
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
message
as its text.
- -dF
-
Displays a font selection dialog. The selected font is in fontconfig format,
and is displayed to standard output.
- -df
-
Displays a standard file selection dialog. The selected file is displayed to
standard output.
- -di message
-
Displays an information dialog, with
message
as its text.
- -ds
-
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
message
as its text.
- -f file
-
Parses a file in the GUIDL format. If
file
is
-
, the input file will be a standard input pipe.
- -oD
-
Do not use dummy argument
guidl
for GUIDL parsed input.
- -oE
-
Make a text entry only print the text to standard output, rather than executing
a command.
- -oe
-
Make command execution callbacks exit on activation. This includes buttons and
text fields.
- -oF
-
Do not use base frame.
- -of
-
Use framed labels.
- -og geometry
-
Specify
geometry
for primary application window.
- -oh
-
Use vertical labels, with a vertical horizontal base for text direction.
- -oL
-
Use expanded labels, which grow with window size changes.
- -ol
-
Do not use expanded labels.
- -on
-
Use undecorated main window.
- -or number
-
Use
number
rows in grid layout.
- -oT title
-
Set the window title to
title.
- -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.
-otw width
Set the width of the terminal widget.
- -ou miliseconds
-
Specify refresh frequency of updater widgets.
AUTHORS
gtkshell was written by Jeffrey Bedard <antiright@gmail.com>.
REPORTING BUGS
Report bugs to <antiright@gmail.com>
COPYRIGHT
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.
SEE ALSO
ACE (1) gshterm(1) system.antiright(5) X(7)
Index
- NAME
-
- SYNOPSIS
-
- DESCRIPTION
-
- OPTIONS
-
- AUTHORS
-
- REPORTING BUGS
-
- COPYRIGHT
-
- SEE ALSO
-
This document was created by
man2html,
using the manual pages.
Time: 15:48:47 GMT, May 24, 2007