Provided by: xview-clients_3.2p1.4-28.1_amd64 bug


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


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


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


       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.


       -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

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

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


   .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

   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,  \n,  ^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]Llabel\E\
              \E[21t              - report tool header by sending \E]llabel\E\
              \E]ltext\E\         - set tool header to text
              \E]Ifile\E\         - set icon to the icon contained  in  file;  file  must  be  in
                                  iconedit output format
              \E]Llabel\E\        - 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 environment 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 program 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 .


       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\"'



                                           11 June 1990                              shelltool(1)