bionic (1) win.1.gz

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)