NAME

       win - Terminal emulator

SYNOPSIS

       win [-v] [-t name] [command [argument ...]]  address

OPTIONS

       -v     If the -v option is present, win prints its version number and date and exits.

       -tname If  the  -t  option is present, win uses +name as the final part of the tag name of
              its window.

DESCRIPTION

       win must be able to connect to a running wily(1).  win attaches to a window.   If  the  -t
       option  is  present,  the  final part of the tag name is name.  If command is present, the
       final part of the tag name is +command.  Otherwise, the final part  of  the  tag  name  is
       +win.  The first part of the tag name is the current working directory.

       win runs a program in a child process.  The child process is the leader of a process group
       and is connected to win by a pseudo-terminal.  If command is specified, the child  process
       runs

              $SHELL -c 'command argument ...'
              otherwise it runs

              $SHELL -i
              If SHELL is not found in the environment, /bin/sh is used.

       TERM=win is placed in the environment of the running program.

       Output  from  the  running command appears in the window.  The point after the last output
       from the running command is known as the output point.  Further output  from  the  running
       command appears just before the output point.  The output point is initially at the end of
       the window.

       Normal wily editing commands work in the window.  When a newline, interrupt character,  or
       end-of-file character is created after the output point, the text between the output point
       and the last  newline,  interrupt  character,  or  end-of-file  character  in  the  window
       (inclusive) is passed to the running program as input.

       The  interrupt  character  is  control-C  and the end-of-file character is control-D.  The
       pseudo-terminal initially is configured so that these are  recognized  with  their  normal
       meanings.

       The  B2  commands  beginning  with  the  |, <, or > characters or an upper case letter are
       executed normally by wily.  Other B2 are first terminated with a newline, if they are  not
       already,  and  are  then  appended  to  the  buffer  (and thereafter passed to the running
       program).

RETURNS

       win returns zero if it is able to successfully create  the  child  process,  otherwise  it
       returns non-zero.

EXAMPLES

       Run a terminal emulator within wily

              win

       Run FTP within wily

              win ftp

       Run rlogin within wily

              win -t host.domain rlogin -8 host.domain

SEE ALSO

       wily(1) Tag(1) Man(1)

BUGS

       win  doesn't follow changes to the terminal attributes.  In particular, there is no way to
       stop echoing or to change its concept of the interrupt and eof characters.

       rlogin seems to need -8 and, annoyingly, sets echo and onlcr.  The latter can be fixed  in
       your .rcrc:

              if ( ~ $TERM win ) {
                  stty -echo -onlcr
              }

       win  doesn't follow changes to the terminal attributes.  In particular, there is no way to
       stop echoing or to change its concept of the interrupt and eof characters.

       WEdestroy messages aren't yet passed by wily.  Thus, Del and Delcol can delete the  window
       yet leave win running.

       There  is a race condition; the user can press newline and then delete text before win has
       a chance to read it.

AUTHOR

       win  was  originally   written   by   Gary   Capell   (gary@cs.su.oz.au).    Alan   Watson
       (alan@oldp.nmsu.edu)  rewrote it and added support for arguments, pseudo-terminals instead
       of pipes, and execution of certain B2 commands by wily.  The  pseudo-terminal  support  in
       9term, written by Matty Farrow (matty@cs.su.oz.au), was a great help.

                                          1R1.1L1 of 1D1                                   win(1)