shelltool(1)						      General Commands Manual						      shelltool(1)

NAME

       shelltool - run a shell (or other program) in an OpenWindows terminal window

SYNOPSIS

       shelltool [ -C ] [ -B boldstyle ] [ -I command ] [ generic-tool-arguments ] [ program [ arguments ] ]

AVAILABILITY

       This  command  is  available  with the OpenWindows user environment, For information about installing OpenWindows, refer to the OpenWindows
       Installation and Start-Up Guide.

DESCRIPTION

       shelltool is a standard OpenWindows facility for shells or other programs that use a standard tty-based interface.

       When invoked, shelltool runs a program, (usually a shell) in an interactive terminal emulator based on a tty subwindow.	Keyboard input	is
       passed  to  that  program.   In the OpenWindows version of shelltool, a restricted pop-up menu is available from the main display area that
       allows you to enable scrolling. Selecting the Enable Scrolling option from the restricted menu gives shelltool the  full  functionality	of
       the  cmdtool window, included a larger pop-up menu  from which to select options.  Selecting Disable Scrolling from the pop-up submenu will
       return Shelltool to its original state.

OPTIONS

       -C	      Redirect system console output to this shelltool.

       -B boldstyle   Set the style for displaying bold text to boldstyle.  boldstyle can be a string  specifying  one	of  the  choices  for  the
		      term.boldstyle  default,	see Defaults Options, below, or it may be a numerical value for one of those choices, from 0 to 8,
		      corresponding to the placement of the choice in the list.

       -I command     Pass command to the shell.  SPACE characters within the command must be escaped.

       generic-tool-arguments
		      shelltool accepts the generic tool arguments listed in xview(1).

USAGE

   .Xdefaults File Options
       You can specify a number of defaults using the options in the .Xdefaults file that effect the behavior of shelltool.  The ones of  interest
       are those that begin with text,term, or keyboard.  See .xview(1) for more detailed information.

   The Terminal Emulator
       The  tty  subwindow  is	a  terminal emulator.  Whenever a tty subwindow is created, the startup file ~/.ttyswrc is read for initialization
       parameters that are specific to the tty subwindow.

   The .ttyswrc File
       The command format for this file is:

	      # 		  Comment.
	      set variable	  Turn on the specified variable.
	      mapi key text	  When key is typed pretend text was input.
	      mapo key text	  When key is typed pretend text was output.

       The only currently defined variable is pagemode.  key is one of L1-L15, F1-F15, T1-T15, R1-R15, LEFT , or RIGHT (see note below).  text may
       contain	escapes  such as E, 
, ^X, etc.  (ESC, RETURN , and CTRL-X , respectively).  See termcap(5) for the format of the string escapes
       that are recognized.  Note: mapi and mapo may be replaced by another keymapping mechanism in the future.

       When using the default kernel keyboard tables, the keys L1, LEFT , RIGHT , BREAK , R8, R10, R12, and R14 cannot be mapped in this way; they
       send  special  values  to  the  tty  subwindow.	 Also,	when  using the default kernel keyboard tables, L1-L10 are now used by XView.  See
       input_from_defaults(1) and kbd(4S) for more information on how to change the behavior of the keyboard.

       It is possible to have terminal-based p special escape sequences.  These escape sequences may also be sent by typing  a	key  appropriately
       mapped  using  the  mapo function described above.  The following functions pertain to the tool in which the tty subwindow resides, not the
       tty subwindow itself.

	      E[1t		  - open
	      E[2t		  - close (become iconic)
	      E[3t		  - move, with interactive feedback
	      E[3;TOP;LEFTt	  - move, to TOP LEFT (pixel coordinates)
	      E[4t		  - stretch, with interactive feedback
	      E[4;HT;WIDTHt	  - stretch, to HT WIDTH size (in pixels)
	      E[5t		  - front
	      E[6t		  - back
	      E[7t		  - refresh
	      E[8;ROWS;COLSt	  - stretch, to ROWS COLS size (in characters)
	      E[11t		  - report if open or iconic by sending E[1t or E[2t
	      E[13t		  - report position by sending E[3;TOP;LEFTt
	      E[14t		  - report size in pixels by sending E[4;HT;WIDTHt
	      E[18t		  - report size in characters by sending E[8;ROWS;COLSt
	      E[20t		  - report icon label by sending E]LlabelE
	      E[21t		  - report tool header by sending E]llabelE
	      E]ltextE	  - set tool header to text
	      E]IfileE	  - set icon to the icon contained in file; file must be in iconedit output format
	      E]LlabelE	  - set icon label to label
	      E[>OPT;...h	  - turn SB OPT on (OPT = 1 => pagemode), for example, E[>1;3;4h
	      E[>OPT;...k	  - report OPT; sends E[>OPTl or E[>OPTh for each OPT
	      E[>OPT;...l	  - turn OPT off (OPT = 1 => pagemode), for .B E[>1;3;

       See EXAMPLES for an example of using this facility.

       shelltool Windows

       The window created by shelltool is based on the text facility that is described in the textedit man page.  The user is given  a	prompt	at
       which to type commands and pop-up menus from which to select command options.

       shelltool  windows support cursor motions, using an /etc/termcap entry called sun-cmd.  Command windows automatically set the TERM environ-
       ment variable to sun-cmd.  So, if you rlogin(1C) to a machine that does not have an entry for sun-cmd in its /etc/termcap file,	the  error
       message	`Type  sun-cmd	unknown'  results.   To  rectify  this, type the command `set TERM=sun'.  Programs written using the curses(3X) or
       curses(3V) library packages will work in a command window, but programs hard-coded for sun-type terminals may not.  When supporting a  pro-
       gram  that  performs  cursor motions, the command window automatically takes on the characteristics of a tty window (as with shelltool(1)).
       When that program terminates or sleeps, the full command window functionality is restored.

       cmdtool supports programs that use CBREAK and NO ECHO terminal modes.  This support is normally invisible to the user.	However,  programs
       that  use RAW mode, such as rlogin(1C) and script(1), inhibit command-line editing with the mouse.  In this case, however, tty-style ERASE,
       word-kill and line-kill characters can still be used to edit the current command line.

   The shelltool Menu
       The shelltool window menu is called the Term Pane menu and contains the following options and their submenus:

       Enable Page Mode
		 Enables page mode within shelltool .

       Copy	 Places the highlighted text on the clipboard.

       PastePuts the contents of
		 pointed to by the cusor.

       Scrolling Enables scrolling within shelltool .

EXAMPLES

       The following aliases can be put into your ~/.cshrc file:

	      alias header 'echo -n "E]l!*E"'

	      alias iheader 'echo -n "E]L!*E"'

	      alias icon 'echo -n "E]I!*E"'

FILES

       ~/.ttyswrc
       /usr/lib/ttyswrc
       /usr/bin/xview/shelltool
       /usr/demo

								   11 June 1990 						      shelltool(1)