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

NAME

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

SYNOPSIS

       cmdtool [ -C ] [ -M bytes ] [ -P count ] [ -B boldstyle ] [ -I command ]
            [ generic-tool-arguments ] [ program [ program-arguments ] ]

AVAILABILITY

       This  command  is  available with the OpenWindows user environment.  For information about
       installing OpenWindows, refer to the Solaris installation documentation.

DESCRIPTION

       cmdtool is the standard OpenWindows support facility for shells and other programs.   When
       invoked,  cmdtool  runs  a  program  (usually  a  shell)  in  a text-based command window.
       Characters typed on the keyboard are inserted at the caret.  If the program  is  a  shell,
       that  shell accepts and runs commands in the usual manner.  cmdtool also supports programs
       that perform cursor motions directly, such as vi(1).

       The text of the current command line can be edited  using  normal  textedit(1)  functions.
       The  command window displays a log of the session, which can be scrolled through using the
       scrollbar (unless the escape command mode is in effect).  This  log  can  be  edited,  and
       saved by choosing the `Store as New File' item in the text facility's pop-up menu.

OPTIONS

       -C             Console  cmdtool.  Redirect system console output to this cmdtool.  Display
                      console  messages  in  this  cmdtool,  which  might  otherwise  appear   in
                      unexpected places on the workstation screen.  Since a cmdtool window can be
                      scrolled, console error messages can be recorded for later examination.

       -M bytes       Set the log to wrap-around after the indicated number of bytes.

       -P count       Checkpoint the log after every set of count editing operations.

       -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, 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
                      cmdtool accepts the generic tool arguments listed in xview(7).

       program [ program-arguments ]
                      If a program argument is present, cmdtool runs it and passes any  remaining
                      arguments  to  that  program.   If  no  program  is given, cmdtool runs the
                      program indicated by the SHELL environment variable, or /bin/sh by default.

USAGE

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

   cmdtool Windows
       The window created by cmdtool 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.

       cmdtool 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(1) 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 comman `set
       TERM=sun-cmd'.  Programs written using the curses(3X) 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(1)
       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 cmdtool Menu
       The cmdtool window menu is called the Term Pane menu and contains  the  following  options
       and their submenus:

       History   Creates a a list of commands used during the cmdtool session.
                 Mode
                           Editable  You can edit the contents of the window.
                           Read Only You can only read from the window.
                 Store Log as new file
                           Create a new file that contains the contents of the log.
                 Clear log Clears all entries from the log.
       Edit      Provides a set of editing functions for this window.
                 Again     Repeats the last action.
                 Undo
                           Undo Last Edit
                                     Undoes the last edit made in cmdtool .
                           Undo All Edits
                                     Undoes all edits made during this session of cmdtool .
                 Copy      Makes a copy of the selected text and places it on the clipboard.
                 Paste     Pastes  a  copy  of  the  text  stored  on the clipboard at the cursor
                           location.
                 Cut       Deletes the selected text.

       Find      Provides a set of find and replace functions.
                 Find and Replace
                           Brings up a pop-up menu containing text  fields  and  command  buttons
                           that  allow  you to search forward and backward through the file being
                           edited for specific text strings.  Allows you to specify  options  for
                           the replacement of text.
                 Find Selection
                           Forward   Searches forward to find a selected text string.
                           Backward  Searches backward to find a selected text string.
                 Find Marked Text
                           Brings  up a pop-up menu that allows you to find text that is included
                           between specified bracket pairs.  Also allows you to insert or  remove
                           bracket pairs around selected text.
                 Replace |>field<| >
                           Allows  you  to  replace selected text forward and backward throughout
                           the file.
       Extras    A user-definable pull-right menu controlled  by  the  /usr/lib/.text_extras_menu
                 file.  This can be overridden in two ways:
                 1)  Change  the value of the .Xdefaults parameter text.extrasMenuFilename to the
                 correct file path.
                 2) Set the environment variable EXTRASMENU to the file desired.
                 Note that option 1 overrides option 2 if both are used.   For  more  information
                 see the OpenWindows user documentation.
       File Editor
                 Enable    Allows you to edit files from within cmdtool.
                 Disable   Turns off the ability to edit files from within cmdtool.
       Scrolling
                 Enables Scrolling
                           Enables scrolling within cmdtool.
                 Disable Scrolling
                           Turns  off  the  ability  to scroll within cmdtool.  Once scrolling in
                           cmdtool is disabled, its functionality is identical to shelltool and a
                           more  restricted  menu  appears. Selecting the Enable Scrolling option
                           from the restricted menu restores the full menu and  functionality  of
                           cmdtool.

   User Defined Keyboard Remapping
       The  file  ~/.textswrc specifies filter programs that are assigned to (available) function
       keys.  These filters are applied to the contents of the primary selection.   Their  output
       is entered at the caret.

   Accelerators
       Text  facility  accelerators  that  are especially useful in command windows are described
       here.  See textedit(1) for more information.
       CTRL-RETURN       Position the caret at the bottom, and scroll it into view as  determined
                         by Text.LowerContext.
       CAPS-lock
       Toggle between all-upper-case keyboard input, and mixed-case.

FILES

       /tmp/tty.txt.pid    log file
       ~/.textswrc
       ~/.ttyswrc
       /usr/lib/.text_extras_menu
       $HOME/.TextExtraMenu
       /etc/termcap
       /usr/bin/sh

SEE ALSO

       rlogin(1), script(1), shelltool(1), textedit(1), vi(1), xview(7), curses(3X)

       OpenWindows user documentation

BUGS

       Typing  ahead  while  cmdtool  changes between its scrollable and cursor motion modes will
       sometimes freeze cmdtool.

       Full terminal emulation is not complete.  Some manifestations of this deficiency are:

       •  File completion in the C shell does not work.

       •  Enhanced display of text is not supported.

                                          18 March 1992                                cmdtool(1)