MTERM(1)

NAME
mterm - dockable X11 command runner

SYNOPSIS
mterm [-a] [-d display] [-i] [-l length] [-n size] [-o] [-p [+|-]x[+|-]y] [-r] [-s] [-w]

DESCRIPTION
mterm is a small X11 application that lets a user enter commands and run them. It can be withdrawn into the dock/wharf/slit or run in windowed mode.

FEATURES
To use mterm, type the desired command into the text box and press the enter key. To run the command in the xterm program, press the enter key while holding down the Control key. The history (kept by default) can be accessed via the Up and Down arrow keys on the keyboard.

OPTIONS

-a  Kill the program after successful command execution. Useful for making a run dialog.

-d display
    Start the program on X display display.

-i  Run the program as an icon window. Useful for some window-managers.

-l num
    Set the length of the text box to a certain number of characters. This option is only applicable in windowed mode.

-n num
    Set the size of the history buffer to a certain number of commands. This option is only applicable if history is turned on.

-o  Disable the long command window. This is the default in windowed mode.

-p [+|-]x[+|-]y
    Set position of the program window. This option is only applicable in windowed mode and the window manager may disregard it.

-r  Allows the program to keep a history between sessions in the .mterm_hist file.

-s  Run the program in a shaped window. Useful in docked mode.

-w  Start the program in a separate window and out of the dock.

SAMPLE CONFIG FILE
#Move to $HOME/.mtermrc
#All values except textboxlength and historysize must be either 1 (true)
#or 0 (false). Nothing else will work.
shaped              1
textboxlength       30
historysize         10
longcommandwindow   1
iconwindow          0
windowmode          0
rememberhist        1

BUGS

o   X11 mouse selection pasting does not work very well.

o   Slight focus irregularities

FILES
$HOME/.mtermrc, $HOME/.mterm_hist

AUTHOR
Martin Robinson <gtg115a@prism.gatech.edu>