gtkshell(1)

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)